This page lists the curated Packages, the @submilli/* Packages maintained
in the submilli/submilli-runtime repository, under packages/<name>. All
are at version 0.1.0. How to add a Package to a Blueprint and bind its
secret is in Packages and
HTTP and credentials.
Missing an integration? Request a curated Package.
The Packages
Section titled “The Packages”| Package | For | Secret | Hosts |
|---|---|---|---|
@submilli/attio |
Attio CRM objects and attributes, typed record queries, people and company upserts by email and domain, record writes, status (deal stage) changes, and notes. | ATTIO_API_KEY |
api.attio.com |
@submilli/brave-search |
Web search, one page of results at a time, and extracted passages grouped by source URL. | BRAVE_SEARCH_API_KEY |
api.search.brave.com |
@submilli/browserbase-stagehand |
Hosted Stagehand act, extract, and observe on a cloud browser. |
BROWSERBASE_API_KEY |
api.browserbase.com, api.stagehand.browserbase.com, api.use1.stagehand.browserbase.com, api.euc1.stagehand.browserbase.com, api.apse1.stagehand.browserbase.com |
@submilli/cloudflare-clef |
Semantic judgments by Cloudflare’s Clef model on Workers AI: the same choice, yes/no, and rubric-scored questions as @submilli/typesafe. |
CLOUDFLARE_ACCOUNT_ID, CLOUDFLARE_API_TOKEN |
api.cloudflare.com |
@submilli/exa |
Web search with highlights, and extraction of known URLs with a status for each URL. | EXA_API_KEY |
api.exa.ai |
@submilli/firecrawl |
Firecrawl v2 web search, page scraping, site URL discovery, and explicit Batch Scrape and Crawl jobs. | FIRECRAWL_API_KEY |
api.firecrawl.dev |
@submilli/github |
GitHub.com repositories, file contents, commits, branches, issues, pull requests, teams, releases, and search. | GITHUB_TOKEN |
api.github.com |
@submilli/gmail |
Gmail profiles, thread search and triage, messages, drafts, sending and replying, labels, and attachment downloads. | GOOGLE_ACCESS_TOKEN |
gmail.googleapis.com |
@submilli/google-calendar |
Google Calendar calendars, events, agendas, free/busy queries, and bounded free-time searches. | GOOGLE_ACCESS_TOKEN |
www.googleapis.com |
@submilli/google-drive |
Google Drive files and folders in My Drive and Shared Drives: search, read, download, upload, organize, and share. | GOOGLE_ACCESS_TOKEN |
www.googleapis.com |
@submilli/jina |
Web pages and search results as Markdown or structured data, through Jina Reader and Search. | JINA_API_KEY |
r.jina.ai, s.jina.ai |
@submilli/linear |
Linear issues, comments, teams, projects, users, and agent sessions, through Linear’s GraphQL API. | LINEAR_API_KEY |
api.linear.app |
@submilli/notion |
Notion search, pages as enhanced Markdown, databases, data sources, views, comments, users, blocks, and file uploads. | NOTION_ACCESS_TOKEN |
api.notion.com |
@submilli/posthog |
PostHog Cloud (US) event reads in bounded, fully paged windows, event and property schema, cohort state, and event capture. | POSTHOG_PERSONAL_API_KEY, POSTHOG_PROJECT_API_KEY |
us.posthog.com, us.i.posthog.com |
@submilli/salesforce |
Salesforce records of any object, typed standard objects (accounts, contacts, leads, opportunities, cases and more), queries written from typed conditions, totals, search, Bulk API exports, activities, notes, files, Chatter, email, approvals, flows, lead conversion, reports, dashboards and metadata. | SALESFORCE_ACCESS_TOKEN |
The org’s My Domain host, chosen at install (--config orgUrl=…) |
@submilli/sentry |
Sentry Cloud organizations, projects, issues, and events, and issue triage. | SENTRY_AUTH_TOKEN |
sentry.io |
@submilli/slack-bot |
Slack as the app’s bot: bot messages, conversation history and threads, conversations and members, direct messages, users, and reactions. | SLACK_BOT_TOKEN |
slack.com |
@submilli/slack-user |
Slack as the authenticated user: search, messages and threads, channels, users, files, sending messages, and reactions. | SLACK_USER_TOKEN |
files.slack.com, slack.com |
@submilli/typesafe |
Semantic judgments by TypeSafe’s Jev model: choice, yes/no, and rubric-scored questions with typed answers and probabilities. | TYPESAFE_AI_KEY |
api.typesafe.ai |
Package entries
Section titled “Package entries”Each entry below has the same rows, taken from the Package’s
capabilities.yaml and source:
| Row | Holds |
|---|---|
| Secret | The name the Package reads with secrets.get. Its requires entry is secrets.get with name == "<secret>" |
| Credential | The value the secret must hold |
| Without the secret | What a call does when secrets.get returns undefined for the secret |
| HTTP | Each host the Package requires, with the http.<verb> capabilities for it. download is http.download. A path is the path == term of a requirement’s filter. |
| Filesystem | The fs.* capabilities the Package requires, all without a filter |
| Readme | The Package’s readme on GitHub, with its setup and development notes |
Each entry includes commands to install and grant access, run in the directory of a Blueprint:
| Command | Does |
|---|---|
submilli install submilli/submilli-runtime @submilli/<name> |
Fetches the repository, builds the Package, and installs it in the local Package store. @<ref> after the repository name pins a branch, tag, or commit. |
submilli blueprint add-package @submilli/<name> --no-capabilities |
Lists the Package in blueprint.yaml and writes the rules the Package needs for its own calls, and grants the program nothing |
submilli blueprint capability list @submilli/<name> |
Prints the Package’s capabilities, their fields, and the rules for them |
submilli blueprint capability add <capability> |
Allows the program one capability, here one that reads. --filter narrows it |
submilli docs @submilli/<name> prints an installed Package’s
declarations.
@submilli/attio
Section titled “@submilli/attio”Attio CRM objects and attributes, typed record queries, people and company upserts by email and domain, record writes, status (deal stage) changes, and notes.
| Secret | ATTIO_API_KEY |
| Credential | An Attio workspace API key with the scopes the operations need: object_configuration:read, record_permission:read-write, note:read-write, user_management:read |
| Without the secret | Throws AttioError with code missing_token |
| HTTP | api.attio.com: GET, PATCH, POST, PUT |
| Filesystem | None |
| Readme | packages/attio/readme.md |
submilli install submilli/submilli-runtime @submilli/attiosubmilli blueprint add-package @submilli/attio --no-capabilitiessubmilli blueprint capability list @submilli/attiosubmilli blueprint capability add attio.com/records.query@submilli/brave-search
Section titled “@submilli/brave-search”Web search, one page of results at a time, and extracted passages grouped by source URL.
| Secret | BRAVE_SEARCH_API_KEY |
| Credential | A Brave Search API key with access to the web search and LLM context endpoints |
| Without the secret | Throws BraveSearchError with code missing_credentials |
| HTTP | api.search.brave.com: GET |
| Filesystem | None |
| Readme | packages/brave-search/readme.md |
submilli install submilli/submilli-runtime @submilli/brave-searchsubmilli blueprint add-package @submilli/brave-search --no-capabilitiessubmilli blueprint capability list @submilli/brave-searchsubmilli blueprint capability add brave.com/search@submilli/browserbase-stagehand
Section titled “@submilli/browserbase-stagehand”Hosted Stagehand act, extract, and observe on a cloud browser.
| Secret | BROWSERBASE_API_KEY |
| Credential | A Browserbase API key. The key identifies the project; do not set a project id |
| Without the secret | Throws BrowserbaseError with code missing_credentials |
| HTTP | api.browserbase.com: GET; api.stagehand.browserbase.com, api.use1.stagehand.browserbase.com, api.euc1.stagehand.browserbase.com, api.apse1.stagehand.browserbase.com: POST |
| Filesystem | None |
| Readme | packages/browserbase-stagehand/readme.md |
submilli install submilli/submilli-runtime @submilli/browserbase-stagehandsubmilli blueprint add-package @submilli/browserbase-stagehand --no-capabilitiessubmilli blueprint capability list @submilli/browserbase-stagehandsubmilli blueprint capability add browserbase.com/stagehand.startsubmilli blueprint capability add browserbase.com/stagehandsubmilli blueprint capability add browserbase.com/navigatesubmilli blueprint capability add browserbase.com/liveViewbrowserbase.com/stagehand.start covers open and current. Act, extract,
observe, and end need browserbase.com/stagehand. session.goto needs
browserbase.com/navigate, which carries the submitted host, path, and
protocol, not the query and not redirects. session.liveView needs
browserbase.com/liveView. The browser id is not a grant field.
Proxies, Verified, and CAPTCHA solving default off. StagehandSession.open
registers cleanup. StagehandSession.current stores the id in the runtime
session under stagehand. Drive it with session.goto and session.act.
@submilli/cloudflare-clef
Section titled “@submilli/cloudflare-clef”Semantic judgments by Cloudflare’s Clef model on Workers AI: the same choice, yes/no, and rubric-scored questions as @submilli/typesafe.
| Secret | CLOUDFLARE_ACCOUNT_ID, CLOUDFLARE_API_TOKEN |
| Credential | A Cloudflare account ID and an API token with Workers AI Read and Edit permissions |
| Without the secret | Throws ClefError with code missing_credentials |
| HTTP | api.cloudflare.com: POST /client/v4/accounts/<id>/ai/run/@cf/cloudflare/clef and …/clef-flash |
| Filesystem | None |
| Readme | packages/cloudflare-clef/readme.md |
submilli install submilli/submilli-runtime @submilli/cloudflare-clefsubmilli blueprint add-package @submilli/cloudflare-clef --no-capabilitiessubmilli blueprint capability list @submilli/cloudflare-clefsubmilli blueprint capability add cloudflare.com/clef@submilli/exa
Section titled “@submilli/exa”Web search with highlights, and extraction of known URLs with a status for each URL.
| Secret | EXA_API_KEY |
| Credential | An Exa API key |
| Without the secret | Throws ExaError with code missing_credentials |
| HTTP | api.exa.ai: POST /contents, POST /search |
| Filesystem | None |
| Readme | packages/exa/readme.md |
submilli install submilli/submilli-runtime @submilli/exasubmilli blueprint add-package @submilli/exa --no-capabilitiessubmilli blueprint capability list @submilli/exasubmilli blueprint capability add exa.ai/search@submilli/firecrawl
Section titled “@submilli/firecrawl”Firecrawl v2 web search, page scraping, site URL discovery, and explicit Batch Scrape and Crawl jobs.
| Secret | FIRECRAWL_API_KEY |
| Credential | A Firecrawl API key |
| Without the secret | Throws FirecrawlError with code missing_credentials |
| HTTP | api.firecrawl.dev: DELETE, download, GET, POST /v2/batch/scrape, POST /v2/crawl, POST /v2/map, POST /v2/scrape, POST /v2/search |
| Filesystem | fs.write |
| Readme | packages/firecrawl/readme.md |
submilli install submilli/submilli-runtime @submilli/firecrawlsubmilli blueprint add-package @submilli/firecrawl --no-capabilitiessubmilli blueprint capability list @submilli/firecrawlsubmilli blueprint capability add firecrawl.dev/scrapesubmilli blueprint capability add firecrawl.dev/delegatedFetchBoth grants are required for scrape("https://example.com"). The
firecrawl.dev/scrape grant authorizes the submitted URL’s host. Use
--filter 'host == "example.com"' to restrict that input. As the
Package README’s Authority section
explains, firecrawl.dev/delegatedFetch also authorizes Firecrawl’s remote
redirects, subresources, discovery, and crawling. A submitted-host filter
does not constrain those downstream fetches. Do not grant delegation to a
role that requires strict downstream host isolation.
@submilli/github
Section titled “@submilli/github”GitHub.com repositories, file contents, commits, branches, issues, pull requests, teams, releases, and search.
| Secret | GITHUB_TOKEN |
| Credential | A GitHub personal access token, OAuth token, or GitHub App installation token |
| Without the secret | Throws GitHubError with code missing_token |
| HTTP | api.github.com: DELETE, GET, PATCH, POST, PUT |
| Filesystem | None |
| Readme | packages/github/readme.md |
submilli install submilli/submilli-runtime @submilli/githubsubmilli blueprint add-package @submilli/github --no-capabilitiessubmilli blueprint capability list @submilli/githubsubmilli blueprint capability add github.com/issues.list@submilli/gmail
Section titled “@submilli/gmail”Gmail profiles, thread search and triage, messages, drafts, sending and replying, labels, and attachment downloads.
| Secret | GOOGLE_ACCESS_TOKEN |
| Credential | A Google OAuth access token with a Gmail scope (gmail.modify covers every operation). The Package doesn’t refresh it |
| Without the secret | Throws GmailError with code missing_token |
| HTTP | gmail.googleapis.com: DELETE, GET, POST |
| Filesystem | fs.read, fs.stat, fs.write |
| Readme | packages/gmail/readme.md |
submilli install submilli/submilli-runtime @submilli/gmailsubmilli blueprint add-package @submilli/gmail --no-capabilitiessubmilli blueprint capability list @submilli/gmailsubmilli blueprint capability add submilli/gmail.searchThreads@submilli/google-calendar
Section titled “@submilli/google-calendar”Google Calendar calendars, events, agendas, free/busy queries, and bounded free-time searches.
| Secret | GOOGLE_ACCESS_TOKEN |
| Credential | A Google OAuth access token with a Calendar scope (calendar covers every operation). The Package doesn’t refresh it |
| Without the secret | Throws CalendarError with code missing_token |
| HTTP | www.googleapis.com: DELETE, GET, PATCH, POST |
| Filesystem | None |
| Readme | packages/google-calendar/readme.md |
submilli install submilli/submilli-runtime @submilli/google-calendarsubmilli blueprint add-package @submilli/google-calendar --no-capabilitiessubmilli blueprint capability list @submilli/google-calendarsubmilli blueprint capability add submilli/google-calendar.listEvents@submilli/google-drive
Section titled “@submilli/google-drive”Google Drive files and folders in My Drive and Shared Drives: search, read, download, upload, organize, and share.
| Secret | GOOGLE_ACCESS_TOKEN |
| Credential | A Google OAuth access token with a Drive scope (drive covers every operation). The Package doesn’t refresh it |
| Without the secret | Throws DriveError with code missing_token |
| HTTP | www.googleapis.com: DELETE, download, GET, PATCH, POST, PUT |
| Filesystem | fs.read, fs.stat, fs.write |
| Readme | packages/google-drive/readme.md |
submilli install submilli/submilli-runtime @submilli/google-drivesubmilli blueprint add-package @submilli/google-drive --no-capabilitiessubmilli blueprint capability list @submilli/google-drivesubmilli blueprint capability add submilli/google-drive.searchFiles@submilli/jina
Section titled “@submilli/jina”Web pages and search results as Markdown or structured data, through Jina Reader and Search.
| Secret | JINA_API_KEY |
| Credential | An optional Jina API key |
| Without the secret | Sends the request without an Authorization header |
| HTTP | r.jina.ai: download, POST /; s.jina.ai: download, POST / |
| Filesystem | fs.write |
| Readme | packages/jina/readme.md |
submilli install submilli/submilli-runtime @submilli/jinasubmilli blueprint add-package @submilli/jina --no-capabilitiessubmilli blueprint capability list @submilli/jinasubmilli blueprint capability add jina.ai/read@submilli/linear
Section titled “@submilli/linear”Linear issues, comments, teams, projects, users, and agent sessions, through Linear’s GraphQL API.
| Secret | LINEAR_API_KEY |
| Credential | A Linear personal API key, or an OAuth access token |
| Without the secret | Sends the request without an Authorization header |
| HTTP | api.linear.app: POST /graphql |
| Filesystem | None |
| Readme | packages/linear/readme.md |
submilli install submilli/submilli-runtime @submilli/linearsubmilli blueprint add-package @submilli/linear --no-capabilitiessubmilli blueprint capability list @submilli/linearsubmilli blueprint capability add linear.app/listIssues@submilli/notion
Section titled “@submilli/notion”Notion search, pages as enhanced Markdown, databases, data sources, views, comments, users, blocks, and file uploads.
| Secret | NOTION_ACCESS_TOKEN |
| Credential | The installation access token of a Notion connection that the pages and databases are shared with |
| Without the secret | Throws NotionError with code missing_token |
| HTTP | api.notion.com: GET, PATCH, POST |
| Filesystem | fs.read, fs.stat |
| Readme | packages/notion/readme.md |
submilli install submilli/submilli-runtime @submilli/notionsubmilli blueprint add-package @submilli/notion --no-capabilitiessubmilli blueprint capability list @submilli/notionsubmilli blueprint capability add submilli/notion.search@submilli/posthog
Section titled “@submilli/posthog”PostHog Cloud (US) event reads in bounded, fully paged windows, event and property schema, cohort state, and event capture.
| Secret | POSTHOG_PERSONAL_API_KEY for reads; POSTHOG_PROJECT_API_KEY for capture |
| Credential | A personal API key with Query Read, Event Definition Read, Property Definition Read and Cohort Read; the project API key (phc_…) for capture |
| Without the secret | Throws PostHogError with code missing_credentials |
| HTTP | us.posthog.com: GET, POST; us.i.posthog.com: POST, path /i/v0/e/ |
| Filesystem | None |
| Readme | packages/posthog/readme.md |
submilli install submilli/submilli-runtime @submilli/posthogsubmilli blueprint add-package @submilli/posthog --no-capabilitiessubmilli blueprint capability list @submilli/posthogsubmilli blueprint capability add posthog.com/schema.read@submilli/salesforce
Section titled “@submilli/salesforce”Salesforce records of any object, typed standard objects (accounts, contacts, leads, opportunities, cases and more), queries written from typed conditions, totals, search, Bulk API exports, activities, notes, files, Chatter, email, approvals, flows, lead conversion, reports, dashboards and metadata.
| Build setting | orgUrl (required): the org’s My Domain URL, such as https://acme.my.salesforce.com |
| Secret | SALESFORCE_ACCESS_TOKEN |
| Credential | An OAuth access token for that org with the api scope |
| Without the secret | Throws SalesforceError with code missing_token |
| HTTP | The org’s host: GET, POST, PATCH, DELETE, and download; convertLead uses the SOAP API on the same host |
| Filesystem | exportQuery and downloadFile write the file they are given; uploadFile reads one |
| Readme | packages/salesforce/readme.md |
submilli install submilli/submilli-runtime @submilli/salesforce --config orgUrl=https://acme.my.salesforce.comsubmilli blueprint add-package @submilli/salesforce --no-capabilitiessubmilli blueprint capability list @submilli/salesforcesubmilli blueprint capability add salesforce.com/opportunities.find@submilli/sentry
Section titled “@submilli/sentry”Sentry Cloud organizations, projects, issues, and events, and issue triage.
| Secret | SENTRY_AUTH_TOKEN |
| Credential | A Sentry user auth token with the scopes the operations need: org:read, project:read, event:read, event:write |
| Without the secret | Throws SentryError with code missing_token |
| HTTP | sentry.io: GET, PUT |
| Filesystem | None |
| Readme | packages/sentry/readme.md |
submilli install submilli/submilli-runtime @submilli/sentrysubmilli blueprint add-package @submilli/sentry --no-capabilitiessubmilli blueprint capability list @submilli/sentrysubmilli blueprint capability add sentry.io/issues.list@submilli/slack-bot
Section titled “@submilli/slack-bot”Slack as the app’s bot: bot messages, conversation history and threads, conversations and members, direct messages, users, and reactions.
| Secret | SLACK_BOT_TOKEN |
| Credential | A Slack bot OAuth token with the bot scopes the operations need |
| Without the secret | Throws SlackError with code missing_token |
| HTTP | slack.com: GET, POST |
| Filesystem | None |
| Readme | packages/slack-bot/readme.md |
submilli install submilli/submilli-runtime @submilli/slack-botsubmilli blueprint add-package @submilli/slack-bot --no-capabilitiessubmilli blueprint capability list @submilli/slack-botsubmilli blueprint capability add slack.com/bot/listMessages@submilli/slack-user
Section titled “@submilli/slack-user”Slack as the authenticated user: search, messages and threads, channels, users, files, sending messages, and reactions.
| Secret | SLACK_USER_TOKEN |
| Credential | A Slack user OAuth token with the user scopes the operations need |
| Without the secret | Throws SlackError with code missing_token |
| HTTP | files.slack.com: download; slack.com: GET, POST |
| Filesystem | fs.write |
| Readme | packages/slack-user/readme.md |
submilli install submilli/submilli-runtime @submilli/slack-usersubmilli blueprint add-package @submilli/slack-user --no-capabilitiessubmilli blueprint capability list @submilli/slack-usersubmilli blueprint capability add slack.com/user/search@submilli/typesafe
Section titled “@submilli/typesafe”Semantic judgments by TypeSafe’s Jev model: choice, yes/no, and rubric-scored questions with typed answers and probabilities.
| Secret | TYPESAFE_AI_KEY |
| Credential | A TypeSafe API key |
| Without the secret | Throws TypeSafeError with code missing_credentials |
| HTTP | api.typesafe.ai: POST /v1/systemone |
| Filesystem | None |
| Readme | packages/typesafe/readme.md |
submilli install submilli/submilli-runtime @submilli/typesafesubmilli blueprint add-package @submilli/typesafe --no-capabilitiessubmilli blueprint capability list @submilli/typesafesubmilli blueprint capability add typesafe.ai/systemone