@keystrokehq/skills 0.0.1

package/keystroke-agent-authoring/references/prebuilt-integrations.md

@@ -0,0 +1,879 @@
+# Prebuilt Integration Operations For Agents
+
+Before writing a custom `Tool`, inspect the current integration packages first.
+
+Use this rule:
+
+- most integration packages export shared `Operation` instances
+- in agent code, pass those operations directly in the agent's `tools` array
+- only write a custom `Tool` when no current integration export fits
+- `Step`, `Tool`, and `Operation` are aliases for the same class from `@keystrokehq/core`
+
+Important distinction:
+
+- integration packages such as Slack, Apollo, Attio, Google, HubSpot, Kalshi, Linear, Perplexity, Polymarket, and Scrapin export real `Operation` instances that work in `tools: [...]`
+
+## Agent install, import, and usage pattern
+
+Install the package that exports the operation:
+
+```sh
+pnpm add @keystroke/integration-slack
+```
+
+Import the named operation you want:
+
+```ts
+import { sendMessage } from '@keystroke/integration-slack/platform/messages';
+import { anthropic } from '@keystroke/integration-ai';
+import { Agent } from '@keystrokehq/core';
+```
+
+Pass the operation to the agent:
+
+```ts
+const notifierAgent = new Agent({
+  id: 'notifier-agent',
+  name: 'Notifier Agent',
+  systemPrompt: 'Send the requested Slack message.',
+  model: 'anthropic/claude-sonnet-4-20250514',
+  credentialSets: [anthropic],
+  tools: [sendMessage],
+});
+```
+
+Replace `sendMessage` with any of the integration operation exports listed below.
+
+## `@keystroke/integration-ai`
+
+Install:
+
+```sh
+pnpm add @keystroke/integration-ai
+```
+
+### Generated operations
+
+Prefer subpath imports from `@keystroke/integration-ai/generate`.
+
+Import and use:
+
+```ts
+import { anthropic } from '@keystroke/integration-ai';
+import { Agent } from '@keystrokehq/core';
+import { generateObject, generateText } from '@keystroke/integration-ai/generate';
+
+const researchAgent = new Agent({
+  id: 'research-agent',
+  name: 'Research Agent',
+  systemPrompt: 'Research the prompt and return a concise answer.',
+  model: 'anthropic/claude-sonnet-4-20250514',
+  credentialSets: [anthropic],
+  tools: [generateText, generateObject],
+});
+```
+
+- `generateObject`: Operation that generates structured object output from a model prompt.
+- `generateText`: Operation that generates plain-text output from a model prompt.
+
+### Agent helpers
+
+- `ai`: Shared AI credential set.
+- `anthropic`: Anthropic credential set.
+- `openai`: OpenAI credential set.
+
+## `@keystroke/integration-apollo`
+
+Install:
+
+```sh
+pnpm add @keystroke/integration-apollo
+```
+
+Prefer domain subpath imports such as `@keystroke/integration-apollo/accounts` or `@keystroke/integration-apollo/contacts`.
+
+Import and use:
+
+```ts
+import { anthropic } from '@keystroke/integration-ai';
+import { Agent } from '@keystrokehq/core';
+import { createAccount } from '@keystroke/integration-apollo/accounts';
+import { searchContacts } from '@keystroke/integration-apollo/contacts';
+
+const salesAgent = new Agent({
+  id: 'sales-agent',
+  name: 'Sales Agent',
+  systemPrompt: 'Look up Apollo contacts and create accounts when needed.',
+  model: 'anthropic/claude-sonnet-4-20250514',
+  credentialSets: [anthropic],
+  tools: [searchContacts, createAccount],
+});
+```
+
+### Accounts
+
+- `bulkCreateAccounts`: Create many Apollo accounts in one call.
+- `createAccount`: Create a single Apollo account.
+- `searchAccounts`: Search Apollo accounts.
+- `updateAccount`: Update an Apollo account.
+- `updateAccountOwner`: Change the owner of an Apollo account.
+- `updateAccountStage`: Change the stage of an Apollo account.
+
+### Contacts
+
+- `bulkCreateContacts`: Create many Apollo contacts in one call.
+- `createContact`: Create a single Apollo contact.
+- `listContactStages`: List Apollo contact stages.
+- `searchContacts`: Search Apollo contacts.
+- `updateContact`: Update an Apollo contact.
+- `updateContactStage`: Change the stage of an Apollo contact.
+
+### Deals
+
+- `createDeal`: Create an Apollo deal.
+- `getDeal`: Fetch an Apollo deal by ID.
+- `listDeals`: List Apollo deals.
+- `updateDeal`: Update an Apollo deal.
+
+### Enrichment
+
+- `bulkEnrichOrganizations`: Enrich many organizations with Apollo data.
+- `bulkEnrichPeople`: Enrich many people with Apollo data.
+- `enrichOrganization`: Enrich one organization with Apollo data.
+- `enrichPerson`: Enrich one person with Apollo data.
+
+### Search
+
+- `searchOrganizations`: Search organizations in Apollo.
+- `searchPeople`: Search people in Apollo.
+
+### Sequences
+
+- `addContactsToSequence`: Add contacts to an Apollo sequence.
+- `searchSequences`: Search Apollo sequences.
+- `updateSequenceContactStatus`: Update a contact's status in an Apollo sequence.
+
+### Tasks
+
+- `createTasks`: Create Apollo tasks.
+- `searchTasks`: Search Apollo tasks.
+
+## `@keystroke/integration-attio`
+
+Install:
+
+```sh
+pnpm add @keystroke/integration-attio
+```
+
+Prefer domain subpath imports such as `@keystroke/integration-attio/records` or `@keystroke/integration-attio/lists`.
+
+Import and use:
+
+```ts
+import { anthropic } from '@keystroke/integration-ai';
+import { Agent } from '@keystrokehq/core';
+import { createRecord, queryRecords } from '@keystroke/integration-attio/records';
+
+const crmAgent = new Agent({
+  id: 'crm-agent',
+  name: 'CRM Agent',
+  systemPrompt: 'Update Attio records and summarize what changed.',
+  model: 'anthropic/claude-sonnet-4-20250514',
+  credentialSets: [anthropic],
+  tools: [queryRecords, createRecord],
+});
+```
+
+### Lists
+
+- `addListEntry`: Add an entry to an Attio list.
+- `deleteListEntry`: Remove an entry from an Attio list.
+- `getList`: Fetch an Attio list by ID.
+- `listLists`: List Attio lists.
+- `queryListEntries`: Query entries in an Attio list.
+- `updateListEntry`: Update an Attio list entry.
+- `upsertListEntry`: Create or update an Attio list entry.
+
+### Notes
+
+- `createNote`: Create an Attio note.
+- `deleteNote`: Delete an Attio note.
+- `getNote`: Fetch an Attio note by ID.
+- `listNotes`: List Attio notes.
+
+### Objects
+
+- `getObject`: Fetch an Attio object definition.
+- `listAttributes`: List attributes for an Attio object.
+- `listObjects`: List Attio objects.
+
+### Records
+
+- `createRecord`: Create an Attio record.
+- `deleteRecord`: Delete an Attio record.
+- `getRecord`: Fetch an Attio record by ID.
+- `queryRecords`: Query Attio records.
+- `updateRecord`: Update an Attio record.
+- `upsertRecord`: Create or update an Attio record.
+
+### Tasks
+
+- `createTask`: Create an Attio task.
+- `deleteTask`: Delete an Attio task.
+- `getTask`: Fetch an Attio task by ID.
+- `listTasks`: List Attio tasks.
+- `updateTask`: Update an Attio task.
+
+## `@keystroke/integration-daytona`
+
+Install:
+
+```sh
+pnpm add @keystroke/integration-daytona
+```
+
+Import example:
+
+```ts
+import { DaytonaSandbox } from '@keystroke/integration-daytona';
+```
+
+This package does not currently export agent operations.
+
+It exports sandbox helpers instead:
+
+- `cloneFiles`: Copy files into or out of a Daytona-backed sandbox.
+- `DaytonaSandbox`: Create a Daytona-backed sandbox for agents.
+- `DaytonaSandboxProvider`: Configure the Daytona sandbox provider.
+
+## `@keystroke/integration-github`
+
+Install:
+
+```sh
+pnpm add @keystroke/integration-github
+```
+
+Prefer domain subpath imports such as `@keystroke/integration-github/issues`, `@keystroke/integration-github/pull-requests`, or `@keystroke/integration-github/repos`.
+
+Import and use:
+
+```ts
+import { anthropic } from '@keystroke/integration-ai';
+import { Agent } from '@keystrokehq/core';
+import { getIssue } from '@keystroke/integration-github/issues';
+import { listPullRequests } from '@keystroke/integration-github/pull-requests';
+
+const githubAgent = new Agent({
+  id: 'github-agent',
+  name: 'GitHub Agent',
+  systemPrompt: 'Inspect GitHub state and answer with evidence from tools.',
+  model: 'anthropic/claude-sonnet-4-20250514',
+  credentialSets: [anthropic],
+  tools: [getIssue, listPullRequests],
+});
+```
+
+Common operation groups:
+
+- actions: `listWorkflows`, `listWorkflowRuns`, `getWorkflowRun`, `triggerWorkflow`, `rerunWorkflowRun`, `cancelWorkflowRun`
+- contents: `getFileContent`, `createOrUpdateFile`, `deleteFile`
+- git: `compareBranches`, `createBranch`, `deleteBranch`
+- issues: `getIssue`, `listIssues`, `createIssue`, `updateIssue`, `addIssueComment`
+- pull requests: `getPullRequest`, `listPullRequests`, `createPullRequest`, `mergePullRequest`, `requestPullRequestReview`
+- releases: `getRelease`, `listReleases`, `createRelease`, `deleteRelease`
+- repos: `getRepository`, `listRepositories`, `listBranches`, `listTags`
+- search: `searchCode`, `searchIssues`, `searchRepositories`
+- users and orgs: `getAuthenticatedUser`, `getUser`, `listOrganizations`, `listOrgMembers`
+
+The package also exposes `connection`, `client`, and `schemas` support surfaces on explicit subpaths. Keep internal provider-app wiring off agent-facing imports.
+
+## `@keystroke/integration-google`
+
+Install:
+
+```sh
+pnpm add @keystroke/integration-google
+```
+
+Prefer domain subpath imports such as `@keystroke/integration-google/gmail`, `@keystroke/integration-google/sheets`, or `@keystroke/integration-google/calendar`.
+
+Import and use:
+
+```ts
+import { anthropic } from '@keystroke/integration-ai';
+import { Agent } from '@keystrokehq/core';
+import { listCalendarEventsTool, createCalendarEventTool } from '@keystroke/integration-google/calendar';
+import { getEmailTool, sendEmailTool } from '@keystroke/integration-google/gmail';
+import { readSpreadsheetTabTool } from '@keystroke/integration-google/sheets';
+
+const googleAgent = new Agent({
+  id: 'google-agent',
+  name: 'Google Agent',
+  systemPrompt: 'Read emails, send replies, manage calendar events, and look up spreadsheet data.',
+  model: 'anthropic/claude-sonnet-4-20250514',
+  credentialSets: [anthropic],
+  tools: [getEmailTool, sendEmailTool, listCalendarEventsTool, createCalendarEventTool, readSpreadsheetTabTool],
+});
+```
+
+### Calendar
+
+- `listCalendarsTool`: List all calendars accessible by the authenticated user.
+- `listCalendarEventsTool`: List events from a Google Calendar with optional time range and search filters.
+- `getCalendarEventTool`: Retrieve a single event by ID from a Google Calendar.
+- `createCalendarEventTool`: Create a new event in a Google Calendar. Requires approval.
+- `updateCalendarEventTool`: Update an existing event in a Google Calendar. Requires approval.
+- `deleteCalendarEventTool`: Delete an event from a Google Calendar. Requires approval.
+
+### Gmail
+
+- `sendEmailTool`: Send an email through Gmail. Requires approval.
+- `getEmailTool`: Retrieve a single email message by ID from Gmail.
+- `listEmailsTool`: List email messages from Gmail with optional filters.
+- `labelEmailTool`: Add or remove labels on a Gmail message. Requires approval.
+
+### Sheets
+
+- `createSpreadsheetTool`: Create a new Google Sheets spreadsheet. Requires approval.
+- `addSpreadsheetTabTool`: Add a new tab (sheet) to an existing spreadsheet. Requires approval.
+- `readSpreadsheetTabTool`: Read values from a spreadsheet range or tab.
+- `writeSpreadsheetRangeTool`: Write or update values in a spreadsheet range. Requires approval.
+
+This package also exports polling triggers (`gmailNewUnreadInboxEmails`, `calendarNewOrUpdatedEvents`) and non-Tool workflow step variants (`sendEmail`, `getEmail`, `listEmails`, `labelEmail`, `createSpreadsheet`, `addSpreadsheetTab`, `readSpreadsheetTab`, `writeSpreadsheetRange`, `listCalendars`, `listCalendarEvents`, `getCalendarEvent`, `createCalendarEvent`, `updateCalendarEvent`, `deleteCalendarEvent`). Those step variants are not agent tools.
+
+## `@keystroke/integration-hubspot`
+
+Install:
+
+```sh
+pnpm add @keystroke/integration-hubspot
+```
+
+Prefer explicit subpaths such as `@keystroke/integration-hubspot/connection`,
+`@keystroke/integration-hubspot/triggers`, and domain paths like
+`@keystroke/integration-hubspot/companies` or `@keystroke/integration-hubspot/contacts`.
+
+Import and use:
+
+```ts
+import { anthropic } from '@keystroke/integration-ai';
+import { Agent } from '@keystrokehq/core';
+import { createCompany } from '@keystroke/integration-hubspot/companies';
+import { searchContacts } from '@keystroke/integration-hubspot/contacts';
+
+const hubspotAgent = new Agent({
+  id: 'hubspot-agent',
+  name: 'HubSpot Agent',
+  systemPrompt: 'Look up HubSpot contacts and create companies when asked.',
+  model: 'anthropic/claude-sonnet-4-20250514',
+  credentialSets: [anthropic],
+  tools: [searchContacts, createCompany],
+});
+```
+
+### Companies
+
+- `archiveCompany`: Archive a HubSpot company.
+- `createCompany`: Create a HubSpot company.
+- `getCompany`: Fetch a HubSpot company by ID.
+- `listCompanies`: List HubSpot companies.
+- `searchCompanies`: Search HubSpot companies.
+- `updateCompany`: Update a HubSpot company.
+
+### Contacts
+
+- `archiveContact`: Archive a HubSpot contact.
+- `createContact`: Create a HubSpot contact.
+- `getContact`: Fetch a HubSpot contact by ID.
+- `listContacts`: List HubSpot contacts.
+- `searchContacts`: Search HubSpot contacts.
+- `updateContact`: Update a HubSpot contact.
+
+### Deals
+
+- `archiveDeal`: Archive a HubSpot deal.
+- `createDeal`: Create a HubSpot deal.
+- `getDeal`: Fetch a HubSpot deal by ID.
+- `listDeals`: List HubSpot deals.
+- `searchDeals`: Search HubSpot deals.
+- `updateDeal`: Update a HubSpot deal.
+
+### Tickets
+
+- `archiveTicket`: Archive a HubSpot ticket.
+- `createTicket`: Create a HubSpot ticket.
+- `getTicket`: Fetch a HubSpot ticket by ID.
+- `listTickets`: List HubSpot tickets.
+- `searchTickets`: Search HubSpot tickets.
+- `updateTicket`: Update a HubSpot ticket.
+
+This package also exports triggers, verification helpers, and example workflows from its root entrypoint. Those are not agent tools.
+
+## `@keystroke/integration-kalshi`
+
+Install:
+
+```sh
+pnpm add @keystroke/integration-kalshi
+```
+
+Prefer domain subpath imports such as `@keystroke/integration-kalshi/markets` or `@keystroke/integration-kalshi/portfolio`.
+
+Import and use:
+
+```ts
+import { anthropic } from '@keystroke/integration-ai';
+import { Agent } from '@keystrokehq/core';
+import { getMarkets } from '@keystroke/integration-kalshi/markets';
+import { createOrder } from '@keystroke/integration-kalshi/portfolio';
+
+const traderAgent = new Agent({
+  id: 'trader-agent',
+  name: 'Trader Agent',
+  systemPrompt: 'Inspect Kalshi markets and place orders only when instructed.',
+  model: 'anthropic/claude-sonnet-4-20250514',
+  credentialSets: [anthropic],
+  tools: [getMarkets, createOrder],
+});
+```
+
+### API keys
+
+- `getApiKeys`: List Kalshi API keys.
+- `createApiKey`: Create a Kalshi API key.
+- `generateApiKey`: Generate a new Kalshi API key secret.
+- `deleteApiKey`: Delete a Kalshi API key.
+
+### Communications
+
+- `getRFQs`: List Kalshi RFQs.
+- `getRFQ`: Fetch a Kalshi RFQ by ID.
+- `createRFQ`: Create a Kalshi RFQ.
+- `deleteRFQ`: Delete a Kalshi RFQ.
+- `getQuotes`: List Kalshi quotes.
+- `getQuote`: Fetch a Kalshi quote by ID.
+- `createQuote`: Create a Kalshi quote.
+- `acceptQuote`: Accept a Kalshi quote.
+- `confirmQuote`: Confirm a Kalshi quote.
+- `deleteQuote`: Delete a Kalshi quote.
+- `getCommunicationsID`: Fetch a Kalshi communication object by ID.
+
+### Events
+
+- `getEvents`: List Kalshi events.
+- `getEvent`: Fetch a Kalshi event by ID.
+- `getEventMetadata`: Fetch metadata for a Kalshi event.
+- `getMultivariateEvents`: List Kalshi multivariate events.
+- `getEventForecastPercentilesHistory`: Get forecast percentile history for an event.
+- `getMarketCandlesticksByEvent`: Get market candlestick data for an event.
+
+### Exchange
+
+- `getExchangeStatus`: Get the current Kalshi exchange status.
+- `getExchangeAnnouncements`: List Kalshi exchange announcements.
+- `getExchangeSchedule`: Get the Kalshi exchange schedule.
+- `getSeriesFeeChanges`: List Kalshi series fee changes.
+
+### Incentive programs
+
+- `getIncentivePrograms`: List Kalshi incentive programs.
+
+### Live data
+
+- `getLiveData`: Fetch one Kalshi live-data feed.
+- `getLiveDatas`: List Kalshi live-data feeds.
+
+### Market lifecycle
+
+- `getHistoricalMarkets`: List historical Kalshi markets.
+- `getHistoricalMarket`: Fetch a historical Kalshi market by ID.
+- `getHistoricalOrders`: List historical Kalshi orders.
+- `getFillsHistorical`: List historical Kalshi fills.
+- `getMarketCandlesticksHistorical`: Get historical candlestick data for a market.
+- `getHistoricalCutoff`: Get Kalshi's historical-data cutoff details.
+
+### Markets
+
+- `getMarkets`: List Kalshi markets.
+- `getMarket`: Fetch a Kalshi market by ID.
+- `getMarketOrderbook`: Get the order book for a Kalshi market.
+- `getMarketCandlesticks`: Get candlestick data for a Kalshi market.
+- `batchGetMarketCandlesticks`: Get candlestick data for many Kalshi markets.
+- `getTrades`: List Kalshi trades.
+
+### Milestones
+
+- `getMilestones`: List Kalshi milestones.
+- `getMilestone`: Fetch a Kalshi milestone by ID.
+
+### Multivariate collections
+
+- `getMultivariateEventCollections`: List Kalshi multivariate event collections.
+- `getMultivariateEventCollection`: Fetch a Kalshi multivariate event collection by ID.
+- `getMultivariateEventCollectionLookupHistory`: Get lookup history for a multivariate event collection.
+- `lookupTickersForMarketInMultivariateEventCollection`: Look up tickers for a market in a multivariate collection.
+- `createMarketInMultivariateEventCollection`: Create a market inside a multivariate event collection.
+
+### Portfolio
+
+- `getBalance`: Get Kalshi account balance.
+- `getFills`: List Kalshi fills.
+- `getPositions`: List Kalshi positions.
+- `getSettlements`: List Kalshi settlements.
+- `getSubaccountBalances`: List balances for Kalshi subaccounts.
+- `getSubaccountTransfers`: List Kalshi subaccount transfers.
+- `createSubaccount`: Create a Kalshi subaccount.
+- `applySubaccountTransfer`: Move funds between Kalshi subaccounts.
+- `getPortfolioRestingOrderTotalValue`: Get the total value of resting portfolio orders.
+- `getOrders`: List Kalshi orders.
+- `getOrder`: Fetch a Kalshi order by ID.
+- `createOrder`: Create a Kalshi order.
+- `cancelOrder`: Cancel a Kalshi order.
+- `amendOrder`: Amend a Kalshi order.
+- `decreaseOrder`: Reduce the remaining size of a Kalshi order.
+- `batchCreateOrders`: Create many Kalshi orders in one call.
+- `batchCancelOrders`: Cancel many Kalshi orders in one call.
+- `getOrderQueuePosition`: Get the queue position of one order.
+- `getOrderQueuePositions`: Get queue positions for multiple orders.
+- `getOrderGroups`: List Kalshi order groups.
+- `getOrderGroup`: Fetch a Kalshi order group by ID.
+- `createOrderGroup`: Create a Kalshi order group.
+- `deleteOrderGroup`: Delete a Kalshi order group.
+- `resetOrderGroup`: Reset a Kalshi order group.
+- `triggerOrderGroup`: Trigger a Kalshi order group.
+- `updateOrderGroupLimit`: Update a Kalshi order-group limit.
+
+### Primary markets
+
+- `getFCMOrders`: List primary-market FCM orders.
+- `getFCMPositions`: List primary-market FCM positions.
+
+### Rate limits
+
+- `getAccountApiLimits`: Fetch account API rate-limit information.
+
+### Series
+
+- `getSeries`: Fetch a Kalshi series by ID.
+- `getSeriesList`: List Kalshi series.
+- `getTagsForSeriesCategories`: List tags for Kalshi series categories.
+
+### Structured targets
+
+- `getStructuredTargets`: List Kalshi structured targets.
+- `getStructuredTarget`: Fetch a Kalshi structured target by ID.
+
+### User data
+
+- `getUserDataTimestamp`: Get the latest Kalshi user-data timestamp.
+
+This package also exports triggers and plain helper functions such as `getTopOfBook` and `listActiveMarkets`. Those helpers are not agent operations unless you wrap them yourself.
+
+## `@keystroke/integration-linear`
+
+Install:
+
+```sh
+pnpm add @keystroke/integration-linear
+```
+
+Prefer domain subpath imports such as `@keystroke/integration-linear/issues` or `@keystroke/integration-linear/users`.
+
+Import and use:
+
+```ts
+import { anthropic } from '@keystroke/integration-ai';
+import { Agent } from '@keystrokehq/core';
+import { createIssue, searchIssues } from '@keystroke/integration-linear/issues';
+
+const triageAgent = new Agent({
+  id: 'triage-agent',
+  name: 'Triage Agent',
+  systemPrompt: 'Search Linear issues and create new ones when needed.',
+  model: 'anthropic/claude-sonnet-4-20250514',
+  credentialSets: [anthropic],
+  tools: [searchIssues, createIssue],
+});
+```
+
+### Comments
+
+- `createComment`: Create a Linear comment.
+- `getComment`: Fetch a Linear comment by ID.
+- `listComments`: List Linear comments.
+
+### Initiatives
+
+- `createInitiative`: Create a Linear initiative.
+- `listInitiatives`: List Linear initiatives.
+- `updateInitiative`: Update a Linear initiative.
+
+### Issues
+
+- `createIssue`: Create a Linear issue.
+- `getIssue`: Fetch a Linear issue by ID.
+- `removeLabelFromIssue`: Remove a label from a Linear issue.
+- `searchIssues`: Search Linear issues.
+- `updateIssue`: Update a Linear issue.
+
+### Projects
+
+- `createProject`: Create a Linear project.
+- `getProject`: Fetch a Linear project by ID.
+- `getProjectUpdate`: Fetch a Linear project update by ID.
+- `listProjects`: List Linear projects.
+- `listProjectUpdates`: List updates for a Linear project.
+
+### Teams and workflow state
+
+- `getTeam`: Fetch a Linear team by ID.
+- `getWorkflowState`: Fetch a Linear workflow state by ID.
+- `listIssueLabels`: List Linear issue labels.
+- `listProjectLabels`: List Linear project labels.
+- `listProjectStatuses`: List Linear project statuses.
+- `listTeams`: List Linear teams.
+- `listWorkflowStates`: List Linear workflow states.
+
+### Users
+
+- `getUser`: Fetch a Linear user by ID.
+- `listUsers`: List Linear users.
+
+### Views
+
+- `getCustomView`: Fetch a Linear custom view by ID.
+- `getViewIssues`: List issues from a Linear view.
+- `listViews`: List Linear views.
+
+### Webhooks
+
+- `createWebhook`: Create a Linear webhook.
+- `deleteWebhook`: Delete a Linear webhook.
+- `listWebhooks`: List Linear webhooks.
+
+## `@keystroke/integration-perplexity`
+
+Install:
+
+```sh
+pnpm add @keystroke/integration-perplexity
+```
+
+Prefer subpath imports such as `@keystroke/integration-perplexity/search`, `@keystroke/integration-perplexity/stream`, and `@keystroke/integration-perplexity/generate`.
+
+Import and use:
+
+```ts
+import { anthropic } from '@keystroke/integration-ai';
+import { Agent } from '@keystrokehq/core';
+import { generateText } from '@keystroke/integration-perplexity/generate';
+import { research, search } from '@keystroke/integration-perplexity/search';
+
+const researchAgent = new Agent({
+  id: 'perplexity-research-agent',
+  name: 'Perplexity Research Agent',
+  systemPrompt: 'Research the topic and cite the strongest findings.',
+  model: 'anthropic/claude-sonnet-4-20250514',
+  credentialSets: [anthropic],
+  tools: [search, research, generateText],
+});
+```
+
+- `generateText`: Generate text with Perplexity.
+- `research`: Run a deeper Perplexity research task.
+- `search`: Run a Perplexity search query.
+- `streamSearch`: Stream Perplexity search results.
+
+## `@keystroke/integration-polymarket`
+
+Install:
+
+```sh
+pnpm add @keystroke/integration-polymarket
+```
+
+Prefer domain subpath imports such as `@keystroke/integration-polymarket/markets` or `@keystroke/integration-polymarket/discovery`.
+
+Import and use:
+
+```ts
+import { anthropic } from '@keystroke/integration-ai';
+import { Agent } from '@keystrokehq/core';
+import { getMarket } from '@keystroke/integration-polymarket/markets';
+import { search } from '@keystroke/integration-polymarket/discovery';
+
+const marketAgent = new Agent({
+  id: 'market-agent',
+  name: 'Market Agent',
+  systemPrompt: 'Search Polymarket and summarize the most relevant market.',
+  model: 'anthropic/claude-sonnet-4-20250514',
+  credentialSets: [anthropic],
+  tools: [search, getMarket],
+});
+```
+
+### Data
+
+- `getLiveVolume`: Get live trading volume for a market.
+- `getMarketHolders`: List holders for a market.
+- `getOpenInterest`: Get open interest for a market.
+- `getUserPositions`: List positions for a user.
+- `listTrades`: List trades.
+
+### Discovery
+
+- `getProfile`: Fetch a Polymarket profile.
+- `getSeries`: Fetch a Polymarket series by ID.
+- `getSportsMarketTypes`: List sports market types.
+- `getSportsMetadata`: Fetch sports metadata.
+- `getSportsTeams`: List sports teams.
+- `listSeries`: List Polymarket series.
+- `listTags`: List Polymarket tags.
+- `search`: Search Polymarket markets and entities.
+
+### Events
+
+- `getEvent`: Fetch a Polymarket event by ID.
+- `getEventBySlug`: Fetch a Polymarket event by slug.
+- `getEventTags`: List tags for a Polymarket event.
+- `listEvents`: List Polymarket events.
+
+### Markets
+
+- `getMarket`: Fetch a Polymarket market by ID.
+- `getMarketBySlug`: Fetch a Polymarket market by slug.
+- `getMarketTags`: List tags for a Polymarket market.
+- `listMarkets`: List Polymarket markets.
+
+### Order book
+
+- `batchGetOrderBooks`: Fetch order books for many markets.
+- `batchGetSpreads`: Fetch spreads for many markets.
+- `getOrderBook`: Fetch an order book for one market.
+
+### Pricing
+
+- `batchGetPrices`: Fetch prices for many markets.
+- `getMidpoint`: Fetch the midpoint price for a market.
+- `getPrice`: Fetch the current price for a market.
+- `getPriceHistory`: Fetch historical price data for a market.
+- `listPrices`: List prices across markets.
+
+## `@keystroke/integration-scrapin`
+
+Install:
+
+```sh
+pnpm add @keystroke/integration-scrapin
+```
+
+Prefer domain subpath imports such as `@keystroke/integration-scrapin/persons` or `@keystroke/integration-scrapin/companies`.
+
+Import and use:
+
+```ts
+import { anthropic } from '@keystroke/integration-ai';
+import { Agent } from '@keystrokehq/core';
+import { getCompanyProfile } from '@keystroke/integration-scrapin/companies';
+import { searchPersons } from '@keystroke/integration-scrapin/persons';
+
+const prospectingAgent = new Agent({
+  id: 'prospecting-agent',
+  name: 'Prospecting Agent',
+  systemPrompt: 'Research the company and find the most relevant people.',
+  model: 'anthropic/claude-sonnet-4-20250514',
+  credentialSets: [anthropic],
+  tools: [getCompanyProfile, searchPersons],
+});
+```
+
+### Companies
+
+- `getCompanyProfile`: Fetch a company profile.
+- `searchCompanyByDomain`: Find a company by domain.
+
+### Company activities
+
+- `getCompanyPost`: Fetch one company post.
+- `getCompanyPosts`: List company posts.
+- `getPostComments`: List comments for a post.
+- `getPostReactions`: List reactions for a post.
+- `getPostReposts`: List reposts for a post.
+
+### Jobs
+
+- `searchJobs`: Search jobs.
+
+### Person activities
+
+- `getPersonComments`: List comments for a person's content.
+- `getPersonPost`: Fetch one person post.
+- `getPersonPosts`: List person posts.
+- `getPersonReactions`: List reactions for a person's content.
+
+### Persons
+
+- `getPersonProfile`: Fetch a person profile.
+- `matchPerson`: Match a person from partial identifying data.
+- `resolvePersonByEmail`: Resolve a person from an email address.
+- `searchPersons`: Search people.
+
+## `@keystroke/integration-slack`
+
+Install:
+
+```sh
+pnpm add @keystroke/integration-slack
+```
+
+Prefer mode/domain imports such as `@keystroke/integration-slack/platform/messages` or `@keystroke/integration-slack/platform/users`.
+
+Import and use:
+
+```ts
+import { anthropic } from '@keystroke/integration-ai';
+import { Agent } from '@keystrokehq/core';
+import { sendMessage } from '@keystroke/integration-slack/platform/messages';
+import { listUsers } from '@keystroke/integration-slack/platform/users';
+
+const slackAgent = new Agent({
+  id: 'slack-agent',
+  name: 'Slack Agent',
+  systemPrompt: 'Look up the right Slack user and send the requested message.',
+  model: 'anthropic/claude-sonnet-4-20250514',
+  credentialSets: [anthropic],
+  tools: [listUsers, sendMessage],
+});
+```
+
+### Channels
+
+- `archiveChannel`: Archive a Slack channel.
+- `createChannel`: Create a Slack channel.
+- `getChannelInfo`: Fetch Slack channel metadata.
+- `inviteToChannel`: Invite users to a Slack channel.
+- `listChannels`: List Slack channels.
+- `setChannelTopic`: Set a Slack channel topic.
+
+### Messages
+
+- `deleteMessage`: Delete a Slack message.
+- `getPermalink`: Get a permalink for a Slack message.
+- `sendEphemeral`: Send an ephemeral Slack message.
+- `sendMessage`: Send a Slack message.
+- `updateMessage`: Update a Slack message.
+
+### Reactions
+
+- `addReaction`: Add a reaction to a Slack message.
+- `removeReaction`: Remove a reaction to a Slack message.
+
+### Users
+
+- `getUserInfo`: Fetch Slack user details.
+- `listUsers`: List Slack users.
+- `lookupUserByEmail`: Find a Slack user by email address.
+
+This package also exports Slack triggers and verification helpers from its root entrypoint. Those are not agent tools.