Skip to content

Reference

Curated Packages

Written by a human with AI assistance

The Packages Submilli maintains for common services: each Package, what it is for, the secret it reads, the hosts it reaches, its readme, and the commands that install it and grant one of its capabilities.

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.

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

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.

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
Terminal window
submilli install submilli/submilli-runtime @submilli/attio
submilli blueprint add-package @submilli/attio --no-capabilities
submilli blueprint capability list @submilli/attio
submilli blueprint capability add attio.com/records.query

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
Terminal window
submilli install submilli/submilli-runtime @submilli/brave-search
submilli blueprint add-package @submilli/brave-search --no-capabilities
submilli blueprint capability list @submilli/brave-search
submilli blueprint capability add brave.com/search

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
Terminal window
submilli install submilli/submilli-runtime @submilli/browserbase-stagehand
submilli blueprint add-package @submilli/browserbase-stagehand --no-capabilities
submilli blueprint capability list @submilli/browserbase-stagehand
submilli blueprint capability add browserbase.com/stagehand.start
submilli blueprint capability add browserbase.com/stagehand
submilli blueprint capability add browserbase.com/navigate
submilli blueprint capability add browserbase.com/liveView

browserbase.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.

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
Terminal window
submilli install submilli/submilli-runtime @submilli/cloudflare-clef
submilli blueprint add-package @submilli/cloudflare-clef --no-capabilities
submilli blueprint capability list @submilli/cloudflare-clef
submilli blueprint capability add cloudflare.com/clef

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
Terminal window
submilli install submilli/submilli-runtime @submilli/exa
submilli blueprint add-package @submilli/exa --no-capabilities
submilli blueprint capability list @submilli/exa
submilli blueprint capability add exa.ai/search

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
Terminal window
submilli install submilli/submilli-runtime @submilli/firecrawl
submilli blueprint add-package @submilli/firecrawl --no-capabilities
submilli blueprint capability list @submilli/firecrawl
submilli blueprint capability add firecrawl.dev/scrape
submilli blueprint capability add firecrawl.dev/delegatedFetch

Both 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.

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
Terminal window
submilli install submilli/submilli-runtime @submilli/github
submilli blueprint add-package @submilli/github --no-capabilities
submilli blueprint capability list @submilli/github
submilli blueprint capability add github.com/issues.list

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
Terminal window
submilli install submilli/submilli-runtime @submilli/gmail
submilli blueprint add-package @submilli/gmail --no-capabilities
submilli blueprint capability list @submilli/gmail
submilli blueprint capability add submilli/gmail.searchThreads

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
Terminal window
submilli install submilli/submilli-runtime @submilli/google-calendar
submilli blueprint add-package @submilli/google-calendar --no-capabilities
submilli blueprint capability list @submilli/google-calendar
submilli blueprint capability add submilli/google-calendar.listEvents

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
Terminal window
submilli install submilli/submilli-runtime @submilli/google-drive
submilli blueprint add-package @submilli/google-drive --no-capabilities
submilli blueprint capability list @submilli/google-drive
submilli blueprint capability add submilli/google-drive.searchFiles

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
Terminal window
submilli install submilli/submilli-runtime @submilli/jina
submilli blueprint add-package @submilli/jina --no-capabilities
submilli blueprint capability list @submilli/jina
submilli blueprint capability add jina.ai/read

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
Terminal window
submilli install submilli/submilli-runtime @submilli/linear
submilli blueprint add-package @submilli/linear --no-capabilities
submilli blueprint capability list @submilli/linear
submilli blueprint capability add linear.app/listIssues

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
Terminal window
submilli install submilli/submilli-runtime @submilli/notion
submilli blueprint add-package @submilli/notion --no-capabilities
submilli blueprint capability list @submilli/notion
submilli blueprint capability add submilli/notion.search

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
Terminal window
submilli install submilli/submilli-runtime @submilli/posthog
submilli blueprint add-package @submilli/posthog --no-capabilities
submilli blueprint capability list @submilli/posthog
submilli blueprint capability add posthog.com/schema.read

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
Terminal window
submilli install submilli/submilli-runtime @submilli/salesforce --config orgUrl=https://acme.my.salesforce.com
submilli blueprint add-package @submilli/salesforce --no-capabilities
submilli blueprint capability list @submilli/salesforce
submilli blueprint capability add salesforce.com/opportunities.find

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
Terminal window
submilli install submilli/submilli-runtime @submilli/sentry
submilli blueprint add-package @submilli/sentry --no-capabilities
submilli blueprint capability list @submilli/sentry
submilli blueprint capability add sentry.io/issues.list

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
Terminal window
submilli install submilli/submilli-runtime @submilli/slack-bot
submilli blueprint add-package @submilli/slack-bot --no-capabilities
submilli blueprint capability list @submilli/slack-bot
submilli blueprint capability add slack.com/bot/listMessages

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
Terminal window
submilli install submilli/submilli-runtime @submilli/slack-user
submilli blueprint add-package @submilli/slack-user --no-capabilities
submilli blueprint capability list @submilli/slack-user
submilli blueprint capability add slack.com/user/search

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
Terminal window
submilli install submilli/submilli-runtime @submilli/typesafe
submilli blueprint add-package @submilli/typesafe --no-capabilities
submilli blueprint capability list @submilli/typesafe
submilli blueprint capability add typesafe.ai/systemone