@chusky/sdk 0.1.1 → 0.2.0

package/docs/meetings.mdx

@@ -0,0 +1,73 @@
+---
+title: Meetings
+description: Prepare, join, participate in, and leave Recall meetings from the SDK.
+---
+
+## Supported platforms
+
+The meeting resource supports Recall links for Zoom, Google Meet, Microsoft
+Teams, and Webex. Chusky validates the link and platform before sending
+anything to Recall. Recall's optional shared-screen understanding is available
+only where the deployment and Recall support it.
+
+## Configure the representative
+
+The meeting profile controls how Chusky participates. It contains the display
+identity, communication guidance, approved knowledge, meeting tools, account
+aliases, and calendar auto-join preference.
+
+```ts
+const profile = await chusky.meetings.updateProfile({
+  representativeName: "Chusky",
+  organizationName: "Acme Motors",
+  role: "sales",
+  communicationStyle: "Natural, concise, curious, and helpful.",
+  approvedKnowledge: "Only use the approved product and pricing facts.",
+  allowedComposioTools: ["GOOGLECALENDAR_CREATE_EVENT"],
+  autoJoinCalendar: false,
+});
+```
+
+## Prepare and join
+
+Preparation searches the owner's saved relationship/business context and
+returns a private brief. It does not join a meeting. A direct join can receive
+that brief as `clientContext`; a calendar-prepared join uses the opaque
+preparation ID and never requires the caller to re-send the meeting URL.
+
+```ts
+const brief = await chusky.meetings.prepare({
+  clientName: "Jordan Lee",
+  objective: "Understand whether Acme Motors is a fit for the fleet program.",
+});
+
+const meeting = await chusky.meetings.join({
+  meetingUrl: "https://meet.google.com/example-room",
+  title: "Acme Motors fleet discussion",
+  interactionMode: "representative",
+  clientName: "Jordan Lee",
+  objective: "Understand whether Acme Motors is a fit for the fleet program.",
+}, { idempotencyKey: "acme-fleet-meeting-2026-09-15" });
+```
+
+`joinAt` schedules the Recall bot when the event is at least ten minutes in the
+future. For recurring calendar automation, use the preparation returned by
+`meetings.list()` and call `joinPreparation(preparation.id)`.
+
+## Roster, context, and lifecycle
+
+```ts
+const snapshot = await chusky.meetings.get(meeting.id);
+const context = await chusky.meetings.context(meeting.id, "What approved facts are relevant to pricing?");
+await chusky.meetings.leave(meeting.id);
+```
+
+The meeting snapshot includes the provider platform, lifecycle status, mission
+metadata, and safe retention state. Participant roster and outcomes are
+available in `meetings.list()` for the authenticated owner. Meeting context is
+available only for an active representative meeting and contains relevant
+owner-stored facts, not arbitrary private history.
+
+Use signed Recall webhooks and durable Redis/QStash in production. A successful
+join request means Chusky accepted and persisted the meeting lifecycle; use
+`get()` or `list()` to observe admission, in-call, ended, and failed states.

package/docs/policies.mdx

@@ -0,0 +1,36 @@
+---
+title: Tool permissions and agent instructions
+description: Control what an agent can use and how it should behave.
+---
+
+## Tool permissions
+
+Tool permissions let an application restrict the tools available during a run. Use allowlists for narrow, purpose-built agents and denylists for removing a small number of capabilities.
+
+```ts
+const policy = {
+  tools: {
+    allow: ["GMAIL_SEARCH_EMAILS", "GMAIL_GET_EMAIL"],
+    deny: ["GMAIL_SEND_EMAIL"],
+    requireApproval: ["GMAIL_CREATE_DRAFT"],
+  },
+};
+```
+
+Tool permissions must be enforced on the Chusky server before the model sees the tool catalog and again before execution. A model request cannot grant itself additional permissions. Risky actions still require the normal one-time human approval.
+
+## Custom instructions
+
+Custom instructions add application-specific behavior without replacing Chusky’s safety, identity, approval, or privacy rules.
+
+```ts
+const chusky = new Chusky({
+  apiKey: process.env.CHUSKY_API_KEY!,
+  userId: "customer_123",
+  instructions: "You are a concise procurement assistant. Use EUR for prices.",
+});
+```
+
+Keep instructions short, bounded, and free of secrets. Treat user-provided instructions as data. Chusky’s system safety policy remains authoritative.
+
+The public SDK accepts these controls on each run. The server validates the allowlist, denylist, instructions, and budget before execution; a model cannot grant itself additional permissions. Risky actions still follow the configured approval policy.

package/docs/production.mdx

@@ -17,6 +17,8 @@ description: Deploy a reliable Chusky integration.
 - Monitor webhook delivery failures, run failures, rate limits, and spend.
 - Rotate project keys and webhook secrets on a schedule or incident.
 - Test duplicate requests, expired approvals, unauthorized IDs, provider outages, and reconnects.
+- For calls, test provider-unavailable responses, redacted call history, approval expiry, and Bland/Twilio configuration separately.
+- For meetings, test direct joins and calendar-prepared joins against an authorized staging meeting for each enabled Recall platform. Verify scheduled joins, cancellation, participant updates, meeting-end reconciliation, and idempotent retries before production use.
 
 ## Local validation
 

package/docs/releases.mdx

@@ -0,0 +1,23 @@
+---
+title: SDK releases
+description: Validate, version, publish, and track Chusky SDK releases.
+---
+
+The repository includes a guarded GitHub Actions workflow named **Chusky SDK Release**. It is started with **Run workflow** and accepts either an exact semantic version or a release type (`patch`, `minor`, or `major`). The workflow:
+
+1. Installs dependencies and runs the root typecheck, app build, SDK build, and SDK tests.
+2. Updates `sdk/package.json` with the requested version.
+3. Commits the version change and creates the `sdk-vX.Y.Z` tag.
+4. Publishes `@chusky/sdk` with npm provenance.
+5. Creates a GitHub release with generated notes for that tag.
+
+Configure the repository `NPM_TOKEN` secret before running it. The token needs publish access to `@chusky/sdk`; GitHub Actions uses its own `GITHUB_TOKEN` for the commit, tag, and release. A failed validation stops before the version, tag, or publish steps.
+
+For a local preflight, run:
+
+```bash
+npm run sdk:check
+npm run sdk:version -- patch
+```
+
+The version script accepts `patch`, `minor`, `major`, or an exact `x.y.z` version. Commit the resulting package change only when you intend to release it.

package/docs/structured-output.mdx

@@ -0,0 +1,30 @@
+---
+title: JSON and schema responses
+description: Request predictable structured output for software integrations.
+---
+
+Structured output is intended for applications that need to consume the result programmatically instead of rendering prose.
+
+```ts
+// Planned SDK shape
+const run = await chusky.threads.runs(thread.id).create({
+  input: "Classify this support request",
+  responseFormat: {
+    type: "json_schema",
+    name: "support_classification",
+    schema: {
+      type: "object",
+      properties: {
+        category: { type: "string" },
+        priority: { type: "string", enum: ["low", "normal", "urgent"] },
+      },
+      required: ["category", "priority"],
+      additionalProperties: false,
+    },
+  },
+});
+```
+
+The server should validate the final model output against the schema, return a typed validation error when it does not match, and preserve the raw run status for recovery. Schemas must be bounded in size and depth.
+
+> **Status:** Planned public API. The current SDK returns text output and does not yet guarantee server-side schema validation.

package/docs/tasks.mdx

@@ -3,11 +3,14 @@ title: Durable tasks
 description: Run work that can pause, retry, and survive process restarts.
 ---
 
-Use tasks for long-running work. Task state includes status, checkpoint, next action, result, and error information.
+Use tasks for long-running work. Task state includes status, checkpoint, next action, result, and error information. A run created with `wait: false` is linked to one of these tasks and can continue after the request and process that started it have ended.
 
 ```ts
 const page = await chusky.tasks.list({ limit: 20 });
 const task = await chusky.tasks.get("task_123");
+
+await chusky.tasks.retry(task.id);
+await chusky.tasks.cancel(task.id);
 ```
 
 Tasks are durable and retried by the server workflow layer. Treat `queued`, `running`, `blocked`, `completed`, `failed`, and `cancelled` as distinct states. A blocked task may require an approval or user input rather than a blind retry.

package/docs.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://mintlify.com/docs.json",
+  "name": "Chusky",
+  "colors": { "primary": "#111111", "light": "#f7f7f4", "dark": "#111111" },
+  "navigation": {
+    "tabs": [
+      { "tab": "Documentation", "groups": [
+        { "group": "Start here", "pages": ["docs/index", "docs/quickstart", "docs/concepts"] },
+        { "group": "Build with Chusky", "pages": ["docs/company-workspaces", "docs/embedded-chat", "docs/calls", "docs/meetings", "docs/streaming", "docs/models", "docs/files", "docs/approvals", "docs/tasks", "docs/policies", "docs/structured-output", "docs/fallbacks", "docs/budgets", "docs/capabilities", "docs/architecture"] },
+        { "group": "Production", "pages": ["docs/webhooks", "docs/security", "docs/errors", "docs/releases", "docs/production"] }
+      ] },
+      { "tab": "API Reference", "openapi": "openapi.yaml", "pages": ["docs/api-contract"] }
+    ]
+  }
+}

package/openapi.yaml

@@ -0,0 +1,252 @@
+openapi: 3.1.0
+info:
+  title: Chusky Developer API
+  version: 1.0.0
+  description: Self-hosted Chusky SDK API. Project/root API keys are server-side only. The first-party web dashboard may authenticate user-scoped resources with its Better Auth session cookie.
+servers:
+  - url: https://your-chusky.example/v1
+security:
+  - bearerAuth: []
+paths:
+  /admin/projects:
+    get: { summary: List root-managed developer projects, responses: { '200': { description: OK } } }
+    post: { summary: Create a developer project and return its key exactly once, responses: { '201': { description: Created } } }
+  /admin/audit-events:
+    get: { summary: List root control-plane audit events, responses: { '200': { description: OK } } }
+  /admin/projects/{projectId}:
+    patch: { summary: Replace scopes for an active project, responses: { '200': { description: Updated } } }
+    delete: { summary: Revoke a developer project key, responses: { '204': { description: Revoked } } }
+  /admin/projects/{projectId}/rotate-key:
+    post: { summary: Replace a project key and return the new value exactly once, responses: { '201': { description: Rotated } } }
+  /account/projects:
+    get: { summary: List personal projects or projects attached to a verified organization member, responses: { '200': { description: OK } } }
+    post: { summary: Create a personal or organization project and return its key exactly once, responses: { '201': { description: Created }, '403': { description: Dashboard session, verified email, or organization admin required }, '409': { description: Active key limit reached } } }
+  /account/projects/{projectId}:
+    patch: { summary: Replace scopes for the authenticated owner's active project key, responses: { '200': { description: Updated }, '404': { description: Not found } } }
+    delete: { summary: Revoke the authenticated owner's project key, responses: { '204': { description: Revoked }, '404': { description: Not found } } }
+  /account/projects/{projectId}/rotate-key:
+    post: { summary: Rotate the authenticated owner's project key and return it exactly once, responses: { '201': { description: Rotated }, '404': { description: Not found } } }
+  /account/projects/{projectId}/company/runs:
+    get: { summary: List status-only company run summaries for a workspace owner or admin, responses: { '200': { description: OK }, '404': { description: Not found } } }
+  /account/projects/{projectId}/company/audit-events:
+    get: { summary: List bounded company project audit events for a workspace owner or admin, responses: { '200': { description: OK }, '404': { description: Not found } } }
+  /account/projects/{projectId}/company/usage:
+    get: { summary: Read company project usage for a workspace owner or admin, responses: { '200': { description: OK }, '404': { description: Not found } } }
+  /account/projects/{projectId}/policy:
+    get: { summary: Read an organization project policy as a verified member, responses: { '200': { description: OK }, '404': { description: Not found } } }
+    put: { summary: Replace project tool grants and per-run budgets as an owner or admin, responses: { '200': { description: Updated }, '400': { description: Invalid policy }, '404': { description: Not found } } }
+  /account/projects/{projectId}/agents:
+    get: { summary: List organization project agent profiles as a verified member, responses: { '200': { description: OK }, '404': { description: Not found } } }
+    post: { summary: Create a template-based company agent profile as an owner or admin, responses: { '201': { description: Created }, '404': { description: Not found } } }
+  /agents/templates:
+    get: { summary: List built-in company agent templates, responses: { '200': { description: OK } } }
+  /agents:
+    get: { summary: List agent profiles belonging to the current project key, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+    post: { summary: Create a template-based agent profile within the current project, parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }], responses: { '201': { description: Created }, '403': { description: Invalid template or grant } } }
+  /agents/{agentId}:
+    get: { summary: Get one current-project agent profile, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+    patch: { summary: Update a current-project agent profile, parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }], responses: { '200': { description: Updated } } }
+    delete: { summary: Delete a current-project agent profile, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '204': { description: Deleted } } }
+  /account/overview:
+    get: { summary: Get the authenticated account overview, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+  /account/models:
+    get: { summary: List models available to the authenticated account, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+  /account/organizations/{organizationId}/branding:
+    get: { summary: Get safe workspace branding, parameters: [{ $ref: '#/components/parameters/UserId' }, { name: organizationId, in: path, required: true, schema: { type: string } }], responses: { '200': { description: Branding } } }
+    put: { summary: Update safe workspace branding as an owner or admin, parameters: [{ $ref: '#/components/parameters/UserId' }, { name: organizationId, in: path, required: true, schema: { type: string } }], responses: { '200': { description: Updated branding } } }
+  /account/preferences:
+    get: { summary: Get account model and voice preferences, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: Preferences } } }
+    patch: { summary: Update account model and voice preferences, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: Updated } } }
+  /account/voice-options:
+    get: { summary: List deployment-supported Flux and Bland voice options, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: Voice catalogue and provider availability } } }
+  /account/telegram-link:
+    post: { summary: Create a Telegram linking code for the account, parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }], responses: { '200': { description: Linking code } } }
+  /account/calls:
+    get: { summary: List account voice calls with redacted destinations, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+    post: { summary: Create an approval-gated outbound voice call request, parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }], responses: { '201': { description: Pending approval } } }
+  /meetings:
+    get: { summary: List owner-scoped Recall meeting preparations, meetings, participants, and contacts, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+    post: { summary: Join or schedule a Recall meeting, parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }], responses: { '201': { description: Meeting lifecycle record } } }
+  /meetings/prepare:
+    post: { summary: Generate a private client-bound meeting brief without joining, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: Prepared meeting mission } } }
+  /meetings/profile:
+    get: { summary: Get the account meeting representative profile, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: Profile } } }
+    patch: { summary: Update the account meeting representative profile, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: Updated profile } } }
+  /meetings/preparations/{preparationId}/join:
+    post: { summary: Join a verified calendar meeting preparation without returning its URL, parameters: [{ $ref: '#/components/parameters/UserId' }, { name: preparationId, in: path, required: true, schema: { type: string } }], responses: { '201': { description: Meeting lifecycle record } } }
+  /meetings/{meetingId}:
+    get: { summary: Get one owner-scoped Recall meeting, parameters: [{ $ref: '#/components/parameters/UserId' }, { name: meetingId, in: path, required: true, schema: { type: string } }], responses: { '200': { description: Meeting lifecycle record }, '404': { description: Not found } } }
+  /meetings/{meetingId}/leave:
+    post: { summary: Ask Recall to leave an owner-scoped meeting, parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }, { name: meetingId, in: path, required: true, schema: { type: string } }], responses: { '200': { description: Updated meeting lifecycle record } } }
+  /meetings/{meetingId}/context:
+    get: { summary: Query the active representative meeting's approved business and relationship context, parameters: [{ $ref: '#/components/parameters/UserId' }, { name: meetingId, in: path, required: true, schema: { type: string } }, { name: query, in: query, required: true, schema: { type: string, maxLength: 500 } }], responses: { '200': { description: Meeting context } } }
+  /meetings/contacts/{contactId}:
+    delete: { summary: Delete an owner-scoped meeting follow-up contact, parameters: [{ $ref: '#/components/parameters/UserId' }, { name: contactId, in: path, required: true, schema: { type: string } }], responses: { '204': { description: Deleted }, '404': { description: Not found } } }
+  /apps:
+    get: { summary: List connected app toolkits, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+  /apps/{toolkit}/connect:
+    post: { summary: Start connecting an app toolkit, parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }], responses: { '200': { description: OAuth connection URL } } }
+  /apps/connections:
+    get: { summary: List connected Composio accounts, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+  /apps/connections/{connectionId}:
+    delete: { summary: Disconnect an owned Composio account, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '204': { description: Disconnected } } }
+  /triggers:
+    get: { summary: List account triggers, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+    post: { summary: Create an account trigger, parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }], responses: { '201': { description: Created } } }
+  /triggers/catalog/toolkits:
+    get: { summary: List Composio trigger-capable app toolkits, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+  /triggers/catalog/toolkits/{toolkit}:
+    get: { summary: List paginated trigger types for an app toolkit, parameters: [{ $ref: '#/components/parameters/UserId' }, { name: toolkit, in: path, required: true, schema: { type: string } }], responses: { '200': { description: OK } } }
+  /triggers/{triggerId}:
+    patch: { summary: Enable or disable an account trigger, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: Updated } } }
+    delete: { summary: Delete an account trigger, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '204': { description: Deleted } } }
+  /threads:
+    get:
+      summary: List a user's threads
+      parameters: [{ $ref: '#/components/parameters/UserId' }]
+      responses: { '200': { description: OK } }
+    post:
+      summary: Create a thread
+      parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }]
+      responses: { '201': { description: Created } }
+  /threads/{threadId}:
+    get: { summary: Get one thread, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+    patch: { summary: Update thread metadata, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: Updated } } }
+    delete: { summary: Delete an idle thread, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '204': { description: Deleted } } }
+  /threads/{threadId}/runs:
+    get:
+      summary: List runs for a thread
+      parameters: [{ $ref: '#/components/parameters/UserId' }]
+      responses: { '200': { description: Cursor page } }
+    post:
+      summary: Run Chusky synchronously or queue a durable task with wait=false
+      parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }]
+      responses: { '201': { description: Created } }
+  /threads/{threadId}/runs/stream:
+    post:
+      summary: Stream an NDJSON agent run
+      parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }]
+      responses: { '200': { description: NDJSON stream } }
+  /threads/{threadId}/runs/{runId}:
+    get: { summary: Get a run, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+  /threads/{threadId}/runs/{runId}/cancel:
+    post: { summary: Cancel a running run, parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }], responses: { '200': { description: Cancelled } } }
+  /threads/{threadId}/runs/{runId}/resume:
+    post: { summary: Resume a failed, cancelled, or approval-paused run as a new durable run, parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }], responses: { '201': { description: Resumed } } }
+  /threads/{threadId}/runs/{runId}/events:
+    get: { summary: Recover persisted run events, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+  /threads/{threadId}/runs/{runId}/trace:
+    get: { summary: Inspect the durable model/tool/handoff trace; include_state=true returns the bounded checkpoint, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: Durable trace } } }
+  /approvals/{approvalId}:
+    get: { summary: Get a pending approval, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+    post: { summary: Approve or deny then resume safely, parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }], responses: { '200': { description: Run result } } }
+  /tasks:
+    get: { summary: List tasks for an SDK user, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+  /tasks/{taskId}:
+    get: { summary: Get one task, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+  /tasks/{taskId}/retry:
+    post: { summary: Retry a failed, blocked, or cancelled task, parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }], responses: { '200': { description: Requeued } } }
+  /tasks/{taskId}/cancel:
+    post: { summary: Cancel a queued or running task, parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }], responses: { '200': { description: Cancelled } } }
+  /files:
+    post: { summary: Create a direct R2 upload URL, parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }], responses: { '201': { description: Presigned URL } } }
+  /files/{fileId}:
+    get: { summary: Create a direct R2 download URL, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: Presigned URL } } }
+    delete: { summary: Delete an owned R2 object and its file record, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '204': { description: Deleted } } }
+  /files/{fileId}/complete:
+    post: { summary: Verify an uploaded R2 object before it becomes downloadable, parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }], responses: { '200': { description: Verified file } } }
+  /audit-events:
+    get: { summary: List bounded SDK audit events, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+  /company/runs:
+    get: { summary: List status-only run summaries aggregated across callers of this company project; requires company:read, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK }, '404': { description: Not a company project } } }
+  /company/audit-events:
+    get: { summary: List bounded project audit events; requires company:read, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK }, '404': { description: Not a company project } } }
+  /company/usage:
+    get: { summary: Get monthly completed-run and model-cost totals for this company project; requires company:read, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK }, '404': { description: Not a company project } } }
+  /usage:
+    get: { summary: Get current SDK-user usage totals, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+  /webhooks:
+    get: { summary: List webhook subscriptions, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+    post: { summary: Create an HTTPS webhook subscription, parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }], responses: { '201': { description: Created } } }
+  /webhooks/{webhookId}:
+    patch: { summary: Enable or disable a webhook subscription, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: Updated } } }
+    delete: { summary: Disable a webhook subscription, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '204': { description: Disabled } } }
+  /webhooks/{webhookId}/deliveries:
+    get: { summary: List bounded delivery attempts for a subscription, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+  /webhooks/{webhookId}/deliveries/{deliveryId}/retry:
+    post: { summary: Requeue a failed webhook delivery, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: Requeued } } }
+  /approvals:
+    get: { summary: List pending approvals for the SDK user, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+  /tools:
+    get: { summary: List native and connected Composio tools, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+  /tools/{slug}:
+    get: { summary: Get one tool by exact slug, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+  /skills:
+    get: { summary: Search the trusted project skill catalogue, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+  /skills/{name}/files:
+    get: { summary: List all files bundled in a skill, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+  /skills/{name}/files/read:
+    get: { summary: Read a bounded text file from a skill, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+  /artifacts:
+    get: { summary: List durable Daytona artifacts, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+  /artifacts/{id}:
+    get: { summary: Get an artifact record, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+    delete: { summary: Delete an owned artifact record, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '204': { description: Deleted } } }
+  /artifacts/{id}/download:
+    get: { summary: Download an artifact from the persistent Daytona workspace, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: Binary artifact bytes } } }
+  /videos:
+    get: { summary: List video generation jobs, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+    post: { summary: Queue a durable video generation job, parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }], responses: { '202': { description: Queued } } }
+  /videos/{id}:
+    get: { summary: Get video job status, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+  /videos/{id}/cancel:
+    post: { summary: Cancel a queued video job, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: Cancelled } } }
+  /workers:
+    get: { summary: List durable sub-agent delegations, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+    post: { summary: Create a typed durable sub-agent delegation under Chusky supervision, parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }], responses: { '202': { description: Queued } } }
+  /workers/{id}:
+    get: { summary: Get a sub-agent delegation and its contract, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+  /workers/{id}/cancel:
+    post: { summary: Cancel a sub-agent delegation, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: Cancelled } } }
+  /channels:
+    get: { summary: List verified channel connections, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+  /channels/link-code:
+    post: { summary: Create a one-time link code for Slack, WhatsApp, or Sendblue, parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }], responses: { '201': { description: Link instructions } } }
+  /channels/{provider}/{identityId}:
+    patch: { summary: Enable or disable proactive delivery for a linked channel, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: Updated } } }
+    delete: { summary: Unlink an owned channel identity, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '204': { description: Unlinked } } }
+  /devices:
+    get: { summary: List active CLI devices without bearer tokens, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+  /devices/{deviceId}:
+    delete: { summary: Revoke an owned CLI device, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '204': { description: Revoked } } }
+  /reminders:
+    get: { summary: List one-time reminders, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+    post: { summary: Schedule a one-time reminder, parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }], responses: { '201': { description: Scheduled } } }
+  /reminders/{id}:
+    delete: { summary: Cancel an owned reminder, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '204': { description: Cancelled } } }
+  /jobs:
+    get: { summary: List recurring schedules, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+    post: { summary: Create a recurring QStash schedule, parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }], responses: { '201': { description: Scheduled } } }
+  /jobs/{id}:
+    delete: { summary: Cancel an owned recurring schedule, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '204': { description: Cancelled } } }
+  /scratchpad:
+    get: { summary: Search private scratchpad notes, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+    delete: { summary: Clear private scratchpad notes, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '204': { description: Cleared } } }
+  /scratchpad/{key}:
+    put: { summary: Write a private scratchpad note, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: Updated } } }
+    delete: { summary: Delete a private scratchpad note, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '204': { description: Deleted } } }
+  /memory:
+    get: { summary: Search explicit structured memory, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+    post: { summary: Save an explicit structured memory fact, parameters: [{ $ref: '#/components/parameters/UserId' }, { $ref: '#/components/parameters/IdempotencyKey' }], responses: { '201': { description: Saved } } }
+  /memory/{id}:
+    delete: { summary: Forget an owned memory fact, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '204': { description: Deleted } } }
+  /deliveries:
+    get: { summary: List outbound channel delivery receipts, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+  /activity:
+    get: { summary: Get a bounded activity feed for polling dashboards, parameters: [{ $ref: '#/components/parameters/UserId' }], responses: { '200': { description: OK } } }
+components:
+  securitySchemes:
+    bearerAuth: { type: http, scheme: bearer }
+  parameters:
+    UserId: { name: X-Chusky-User-Id, in: header, required: true, schema: { type: string, maxLength: 200 } }
+    IdempotencyKey: { name: Idempotency-Key, in: header, required: false, schema: { type: string, maxLength: 255 } }

package/package.json

@@ -1,36 +1,54 @@
-{
-  "name": "@chusky/sdk",
-  "version": "0.1.1",
+{
+  "name": "@chusky/sdk",
+  "version": "0.2.0",
   "description": "TypeScript SDK for Chusky's developer API.",
   "license": "MIT",
-  "type": "module",
-  "sideEffects": false,
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zester4/chusky-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/zester4/chusky-sdk/issues"
+  },
+  "homepage": "https://github.com/zester4/chusky-sdk#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./widget": {
+      "types": "./dist/widget.d.ts",
+      "import": "./dist/widget.js"
     }
-  },
-  "files": [
-    "dist",
-    "README.md",
+  },
+  "files": [
+    "dist",
+    "README.md",
     "docs",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc --noEmit -p tsconfig.json",
-    "test": "tsx --test --test-concurrency=1 tests/*.test.ts",
-    "prepublishOnly": "npm run typecheck && npm run build && npm test"
-  },
-  "devDependencies": {
-    "@types/node": "^22.0.0",
-    "tsx": "^4.19.0",
-    "typescript": "^5.7.0"
-  }
-}
+    "docs.json",
+    "openapi.yaml",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "tsx --test --test-concurrency=1 tests/*.test.ts",
+    "prepublishOnly": "npm run typecheck && npm run build && npm test"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  }
+}