@airstore/sdk 0.1.4 → 0.1.7

package/dist/types/resources/oauth.d.ts

@@ -5,53 +5,18 @@ import type { OAuthSession, OAuthSessionCreateParams, OAuthSessionStatus, OAuthP
  *
  * Use this when you want users to authorize via browser redirect
  * rather than passing tokens directly.
- *
- * @example
- * ```ts
- * const session = await airstore.oauth.createSession({
- *   integrationType: "gmail",
- *   returnTo: "https://myapp.com/callback",
- * });
- * console.log(session.authorize_url); // redirect user here
- * const completed = await airstore.oauth.poll(session.session_id);
- * ```
  */
 export declare class OAuth {
     private readonly client;
     constructor(client: CoreClient);
     /**
-     * Create an OAuth session to initiate the authorization flow.
-     *
-     * Returns a session with an `authorize_url` that the user should be
-     * redirected to. Once they complete authorization, poll the session
-     * for the resulting connection ID.
-     *
-     * @param params - Session creation parameters.
-     * @param options - Per-request overrides.
-     * @returns The session with authorize_url to redirect the user to.
+     * Create an OAuth session. Returns a session with an `authorize_url`
+     * that the user should be redirected to.
      */
     createSession(params: OAuthSessionCreateParams, options?: RequestOptions): Promise<OAuthSession>;
-    /**
-     * Get the current status of an OAuth session.
-     *
-     * @param sessionId - Session ID from createSession.
-     * @param options - Per-request overrides.
-     * @returns The session status.
-     */
+    /** Get the current status of an OAuth session. */
     getSession(sessionId: string, options?: RequestOptions): Promise<OAuthSessionStatus>;
-    /**
-     * Poll an OAuth session until completion or timeout.
-     *
-     * Repeatedly checks session status at the specified interval until
-     * the session completes, errors, or the timeout is reached.
-     *
-     * @param sessionId - Session ID from createSession.
-     * @param pollOpts - Polling configuration (timeout, interval).
-     * @param options - Per-request overrides.
-     * @returns The completed session status with connection_id.
-     *
-     * @throws {AirstoreError} If the session errors or times out.
-     */
+    /** Poll an OAuth session until completion, error, or timeout. */
     poll(sessionId: string, pollOpts?: OAuthPollOptions, options?: RequestOptions): Promise<OAuthSessionStatus>;
 }
 //# sourceMappingURL=oauth.d.ts.map

package/dist/types/resources/oauth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../../../src/resources/oauth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EACV,YAAY,EACZ,wBAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAG3B;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,KAAK;IACJ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C;;;;;;;;;;OAUG;IACG,aAAa,CACjB,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,CAAC;IAgBxB;;;;;;OAMG;IACG,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,kBAAkB,CAAC;IAU9B;;;;;;;;;;;;OAYG;IACG,IAAI,CACR,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,gBAAgB,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,kBAAkB,CAAC;CAoB/B"}
+{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../../../src/resources/oauth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EACV,YAAY,EACZ,wBAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAG3B;;;;;GAKG;AACH,qBAAa,KAAK;IACJ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C;;;OAGG;IACG,aAAa,CACjB,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,CAAC;IAgBxB,kDAAkD;IAC5C,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,kBAAkB,CAAC;IAU9B,iEAAiE;IAC3D,IAAI,CACR,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,gBAAgB,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,kBAAkB,CAAC;CAoB/B"}

package/dist/types/resources/runs.d.ts

@@ -1,17 +1,25 @@
-import type { CoreClient, RequestOptions } from '../client.js';
-import type { AgentRun, AgentRunSnapshot, RunCancelResponse, RunInputParams } from '../types/runs.js';
-import type { TaskAcceptedResponse } from '../types/tasks.js';
+import { type CoreClient, type RequestOptions } from '../client.js';
+import type { AgentRun, RunListParams, RunListResponse, AgentRunSnapshot, RunCancelResponse } from '../types/runs.js';
 /**
- * Read and control run lifecycle state (snapshots, events).
+ * Read and manage the lifecycle of agent runs.
+ *
+ * A run is the actual execution instance spawned by a task. Use this resource
+ * to inspect run status, list snapshots (intermediate state), retrieve
+ * execution events, or cancel a running execution.
  */
 export declare class Runs {
     private readonly client;
     constructor(client: CoreClient);
-    list(workspaceId: string, options?: RequestOptions): Promise<AgentRun[]>;
+    /** List runs with optional filters (agent, status, session, date range) and cursor pagination. */
+    list(workspaceId: string, options?: RequestOptions): Promise<RunListResponse>;
+    list(workspaceId: string, params?: RunListParams, options?: RequestOptions): Promise<RunListResponse>;
+    /** Retrieve a single run by ID. */
     retrieve(workspaceId: string, runId: string, options?: RequestOptions): Promise<AgentRun>;
+    /** List snapshots (intermediate state captures) for a run, ordered by sequence number. */
     listSnapshots(workspaceId: string, runId: string, options?: RequestOptions): Promise<AgentRunSnapshot[]>;
+    /** List execution events emitted during a run. */
     listEvents(workspaceId: string, runId: string, options?: RequestOptions): Promise<Array<Record<string, unknown>>>;
-    input(workspaceId: string, runId: string, params: RunInputParams, options?: RequestOptions): Promise<TaskAcceptedResponse>;
+    /** Cancel an active run. */
     cancel(workspaceId: string, runId: string, options?: RequestOptions): Promise<RunCancelResponse>;
 }
 //# sourceMappingURL=runs.d.ts.map

package/dist/types/resources/runs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../../src/resources/runs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EACV,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D;;GAEG;AACH,qBAAa,IAAI;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEzC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAUxE,QAAQ,CACZ,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,QAAQ,CAAC;IAUd,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAUxB,UAAU,CACd,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAUpC,KAAK,CACT,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,oBAAoB,CAAC;IAc1B,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,iBAAiB,CAAC;CAS9B"}
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../../src/resources/runs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,KAAK,EACV,QAAQ,EACR,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAE1B;;;;;;GAMG;AACH,qBAAa,IAAI;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,kGAAkG;IAC5F,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAC7E,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,eAAe,CAAC;IAqC3B,mCAAmC;IAC7B,QAAQ,CACZ,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,QAAQ,CAAC;IAUpB,0FAA0F;IACpF,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAU9B,kDAAkD;IAC5C,UAAU,CACd,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAU1C,4BAA4B;IACtB,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,iBAAiB,CAAC;CAS9B"}

package/dist/types/resources/tasks.d.ts

@@ -1,12 +1,72 @@
 import type { CoreClient, RequestOptions } from '../client.js';
-import type { AgentCommandCreateParams, AgentTask, TaskAcceptedResponse } from '../types/tasks.js';
+import type { AgentCommandCreateParams, AgentTask, TaskCancelResponse, TaskAcceptedResponse, TaskArchiveResponse, TaskListParams, TaskListResponse, TaskUpdateParams, TaskLogListParams, TaskLogListResponse, TaskEventStreamParams, TaskEventBatch, Schedule, ScheduleCreateParams, ScheduleUpdateParams, TaskOutput, TaskOutputListParams, TaskOutputListResponse, CreateTaskOutputParams, AppendRowsParams, SubmitTaskInputParams, SubmitTaskInputResponse } from '../types/tasks.js';
 /**
- * Task APIs for agents.
+ * Create, list, and manage agent tasks and their cron schedules.
+ *
+ * A task is a unit of intent sent to an agent. Creating a task triggers the
+ * orchestrator to dispatch a run. Tasks support idempotency, cancellation,
+ * archival, log streaming, and cron-based scheduling.
  */
 export declare class Tasks {
     private readonly client;
     constructor(client: CoreClient);
+    /**
+     * Submit a new task to an agent. Returns an accepted response containing the
+     * task and, when immediately dispatched, a `run_id`. Duplicate submissions
+     * with the same `idempotencyKey` return the original task.
+     */
     create(workspaceId: string, params: AgentCommandCreateParams, options?: RequestOptions): Promise<TaskAcceptedResponse>;
+    /** Retrieve a single task by ID. */
     retrieve(workspaceId: string, taskId: string, options?: RequestOptions): Promise<AgentTask>;
+    /** List tasks with optional filters (state, agent, date range) and cursor pagination. */
+    list(workspaceId: string, params?: TaskListParams, options?: RequestOptions): Promise<TaskListResponse>;
+    /** Fetch execution logs for a task. Pass `cursor` for incremental reads. */
+    listLogs(workspaceId: string, taskId: string, params?: TaskLogListParams, options?: RequestOptions): Promise<TaskLogListResponse>;
+    /**
+     * Poll a composite event stream for a task: the current task/run state,
+     * new log entries, run events, and pending inputs in a single batch.
+     */
+    streamEvents(workspaceId: string, taskId: string, params?: TaskEventStreamParams, options?: RequestOptions): Promise<TaskEventBatch>;
+    /** Cancel a running task and its active run. */
+    cancel(workspaceId: string, taskId: string, options?: RequestOptions): Promise<TaskCancelResponse>;
+    /** Archive a terminal task so it no longer appears in active listings. */
+    archive(workspaceId: string, taskId: string, options?: RequestOptions): Promise<TaskArchiveResponse>;
+    /**
+     * Submit follow-up input to a task. The backend durably stores the input
+     * and delivers it to whichever run is active for the task.
+     */
+    submitInput(workspaceId: string, taskId: string, params: SubmitTaskInputParams, options?: RequestOptions): Promise<SubmitTaskInputResponse>;
+    /** Update metadata on an existing task. */
+    update(workspaceId: string, taskId: string, params: TaskUpdateParams, options?: RequestOptions): Promise<AgentTask>;
+    private schedulePath;
+    /** Create a cron schedule that periodically submits a task to an agent. */
+    createSchedule(workspaceId: string, params: ScheduleCreateParams, options?: RequestOptions): Promise<Schedule>;
+    /** List all cron schedules in a workspace. */
+    listSchedules(workspaceId: string, options?: RequestOptions): Promise<Schedule[]>;
+    /** Retrieve a single schedule by ID. */
+    retrieveSchedule(workspaceId: string, scheduleId: string, options?: RequestOptions): Promise<Schedule>;
+    /** Update a schedule. Only provided fields are changed. Set `active: false` to pause. */
+    updateSchedule(workspaceId: string, scheduleId: string, params: ScheduleUpdateParams, options?: RequestOptions): Promise<Schedule>;
+    /** Permanently delete a schedule. */
+    deleteSchedule(workspaceId: string, scheduleId: string, options?: RequestOptions): Promise<void>;
+    private outputPath;
+    /** List all outputs for a task. */
+    listOutputs(workspaceId: string, taskId: string, options?: RequestOptions): Promise<TaskOutput[]>;
+    /** List recent outputs across a workspace. */
+    listWorkspaceOutputs(workspaceId: string, params?: TaskOutputListParams, options?: RequestOptions): Promise<TaskOutputListResponse>;
+    /** Create a structured output for a task. */
+    createOutput(workspaceId: string, taskId: string, params: CreateTaskOutputParams, options?: RequestOptions): Promise<TaskOutput>;
+    /** Retrieve a single output by ID (includes full data). */
+    getOutput(workspaceId: string, taskId: string, outputId: string, options?: RequestOptions): Promise<TaskOutput>;
+    /** Append rows to a table output. */
+    appendOutputRows(workspaceId: string, taskId: string, outputId: string, params: AppendRowsParams, options?: RequestOptions): Promise<void>;
+    /** Delete an output. */
+    deleteOutput(workspaceId: string, taskId: string, outputId: string, options?: RequestOptions): Promise<void>;
+    /** Archive (dismiss) a single output. */
+    archiveOutput(workspaceId: string, outputId: string, options?: RequestOptions): Promise<void>;
+    /** Archive all unarchived outputs in the workspace. */
+    archiveAllOutputs(workspaceId: string, options?: RequestOptions): Promise<{
+        archived: number;
+    }>;
 }
 //# sourceMappingURL=tasks.d.ts.map

package/dist/types/resources/tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../src/resources/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAU/D,OAAO,KAAK,EACV,wBAAwB,EACxB,SAAS,EAET,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,qBAAa,KAAK;IACJ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEzC,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,oBAAoB,CAAC;IA0B1B,QAAQ,CACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;CAStB"}
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../src/resources/tasks.ts"],"names":[],"mappings":"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"}

package/dist/types/resources/tokens.d.ts

@@ -5,50 +5,19 @@ import type { Token, TokenCreateParams, TokenCreated } from '../types/tokens.js'
  *
  * Tokens are used for CLI mounting (`airstore start --token <token>`)
  * and per-workspace programmatic access.
- *
- * @example
- * ```ts
- * const token = await airstore.tokens.create("ws_abc", {
- *   email: "agent@internal",
- *   name: "vm-mount",
- * });
- * // token.token -> pass to: airstore start --token <this>
- * ```
  */
 export declare class Tokens {
     private readonly client;
     constructor(client: CoreClient);
     /**
-     * Create a workspace-scoped token.
-     *
-     * Either `memberId` or `email` must be provided. If `email` is given
-     * and no member with that email exists, one is auto-created.
-     *
-     * @param workspaceId - Workspace external ID.
-     * @param params - Token creation parameters.
-     * @param options - Per-request overrides.
-     * @returns The created token with raw value (shown once — store it safely).
+     * Create a workspace-scoped token. Either `memberId` or `email` must be
+     * provided. If `email` is given and no member exists, one is auto-created.
+     * The raw token value is only returned once -- store it safely.
      */
     create(workspaceId: string, params: TokenCreateParams, options?: RequestOptions): Promise<TokenCreated>;
-    /**
-     * List tokens in a workspace.
-     *
-     * Raw token values are never returned — only metadata.
-     *
-     * @param workspaceId - Workspace external ID.
-     * @param options - Per-request overrides.
-     * @returns Array of token metadata.
-     */
+    /** List tokens in a workspace. Raw token values are never returned. */
     list(workspaceId: string, options?: RequestOptions): Promise<Token[]>;
-    /**
-     * Revoke (delete) a token. Once revoked, the token can no longer be used.
-     *
-     * @param workspaceId - Workspace external ID.
-     * @param tokenId - Token external ID.
-     * @param options - Per-request overrides.
-     *
-     * @throws {NotFoundError} If the token doesn't exist.
-     */
+    /** Revoke (delete) a token. Once revoked it can no longer be used. */
     revoke(workspaceId: string, tokenId: string, options?: RequestOptions): Promise<void>;
 }
 //# sourceMappingURL=tokens.d.ts.map

package/dist/types/resources/tokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../src/resources/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEjF;;;;;;;;;;;;;;GAcG;AACH,qBAAa,MAAM;IACL,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C;;;;;;;;;;OAUG;IACG,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,CAAC;IAgBxB;;;;;;;;OAQG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAU3E;;;;;;;;OAQG;IACG,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;CASjB"}
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../src/resources/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEjF;;;;;GAKG;AACH,qBAAa,MAAM;IACL,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C;;;;OAIG;IACG,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,CAAC;IAgBxB,uEAAuE;IACjE,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAU3E,sEAAsE;IAChE,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;CASjB"}

package/dist/types/resources/views.d.ts

@@ -6,61 +6,26 @@ import type { SourceView, ViewCreateParams, ViewUpdateParams, SyncResult, Integr
  * Source views are materialized queries over connected data sources.
  * In **smart** mode the query is LLM-inferred from natural language guidance;
  * in **query** mode the query is built from a structured per-integration filter.
- *
- * @example Smart mode (LLM-inferred)
- * ```ts
- * await airstore.views.create("ws_abc", {
- *   integration: "gmail",
- *   name: "Recent Emails",
- *   guidance: "Last 7 days of emails",
- * });
- * ```
- *
- * @example Query mode (structured filter)
- * ```ts
- * await airstore.views.create("ws_abc", {
- *   integration: "gmail",
- *   name: "Unread from boss",
- *   filter: { from: "boss@company.com", is_unread: true },
- * });
- * ```
  */
 export declare class Views {
     private readonly client;
     constructor(client: CoreClient);
     /**
-     * Create a new source view.
-     *
-     * If `filter` is provided the view is created in query mode;
-     * otherwise it uses smart mode with LLM inference from `guidance`.
+     * Create a new source view. If `filter` is provided the view is created
+     * in query mode; otherwise it uses smart mode with LLM inference from `guidance`.
      */
     create(workspaceId: string, params: ViewCreateParams, options?: RequestOptions): Promise<SourceView>;
     /** List all source views in a workspace. */
     list(workspaceId: string, options?: RequestOptions): Promise<SourceView[]>;
     /** Retrieve a source view by its virtual filesystem path. */
     retrieve(workspaceId: string, viewPath: string, options?: RequestOptions): Promise<SourceView>;
-    /** Update an existing source view. */
+    /** Update an existing source view. Only provided fields are changed. */
     update(workspaceId: string, viewId: string, params: ViewUpdateParams, options?: RequestOptions): Promise<SourceView>;
     /** Delete a source view. */
     del(workspaceId: string, viewId: string, options?: RequestOptions): Promise<void>;
-    /**
-     * Sync a source view — re-execute its query and refresh cached metadata.
-     *
-     * Idempotent and safe to call repeatedly. Returns the count of total
-     * and newly discovered results.
-     */
+    /** Sync a source view -- re-execute its query and refresh cached metadata. */
     sync(workspaceId: string, viewId: string, options?: RequestOptions): Promise<SyncResult>;
-    /**
-     * List available resources for an integration (repos, channels, etc.).
-     *
-     * Used to populate filter dropdowns with real data from connected sources.
-     *
-     * @example
-     * ```ts
-     * const repos = await airstore.views.listResources("ws_abc", "github");
-     * // [{ id: "owner/repo", name: "owner/repo" }, ...]
-     * ```
-     */
+    /** List available resources for an integration (repos, channels, etc.). */
     listResources(workspaceId: string, integration: string, resourceType?: string, options?: RequestOptions): Promise<IntegrationResource[]>;
 }
 //# sourceMappingURL=views.d.ts.map

package/dist/types/resources/views.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"views.d.ts","sourceRoot":"","sources":["../../../src/resources/views.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,KAAK;IACJ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C;;;;;OAKG;IACG,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC;IAmBtB,4CAA4C;IACtC,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,EAAE,CAAC;IAWxB,6DAA6D;IACvD,QAAQ,CACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC;IAUtB,sCAAsC;IAChC,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC;IAetB,4BAA4B;IACtB,GAAG,CACP,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;IAUhB;;;;;OAKG;IACG,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC;IAUtB;;;;;;;;;;OAUG;IACG,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,mBAAmB,EAAE,CAAC;CAalC"}
+{"version":3,"file":"views.d.ts","sourceRoot":"","sources":["../../../src/resources/views.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;GAMG;AACH,qBAAa,KAAK;IACJ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C;;;OAGG;IACG,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC;IAmBtB,4CAA4C;IACtC,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,EAAE,CAAC;IAWxB,6DAA6D;IACvD,QAAQ,CACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC;IAUtB,wEAAwE;IAClE,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC;IAetB,4BAA4B;IACtB,GAAG,CACP,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;IAUhB,8EAA8E;IACxE,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC;IAUtB,2EAA2E;IACrE,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,mBAAmB,EAAE,CAAC;CAalC"}

package/dist/types/resources/workspaces.d.ts

@@ -1,63 +1,28 @@
 import type { CoreClient, RequestOptions } from '../client.js';
 import type { Workspace, WorkspaceCreateParams } from '../types/workspaces.js';
+import type { ChannelBinding, UpdateChannelsParams } from '../types/agents.js';
 /**
- * Manage workspaces.
+ * Create, list, retrieve, and delete workspaces.
  *
  * Workspaces are the top-level container for connections, source views,
- * members, and the virtual filesystem. When using an organization token,
- * workspaces are automatically scoped to the token's tenant.
- *
- * @example
- * ```ts
- * const ws = await airstore.workspaces.create({ name: "user-123" });
- * console.log(ws.external_id);
- * ```
+ * agents, members, and the virtual filesystem.
  */
 export declare class Workspaces {
     private readonly client;
     constructor(client: CoreClient);
-    /**
-     * Create a new workspace.
-     *
-     * When called with an organization token, the workspace is automatically
-     * tagged with the token's `tenant_id`.
-     *
-     * @param params - Workspace creation parameters.
-     * @param options - Per-request overrides.
-     * @returns The newly created workspace.
-     *
-     * @throws {AuthenticationError} If the API key is invalid or missing.
-     * @throws {PermissionDeniedError} If the token lacks workspace creation rights.
-     */
+    /** Create a new workspace scoped to the token's tenant. */
     create(params: WorkspaceCreateParams, options?: RequestOptions): Promise<Workspace>;
-    /**
-     * List all workspaces accessible to the authenticated token.
-     *
-     * Organization tokens only see workspaces belonging to their tenant.
-     * Cluster admin tokens see all workspaces.
-     *
-     * @param options - Per-request overrides.
-     * @returns Array of workspaces.
-     */
+    /** List all workspaces accessible to the authenticated token. */
     list(options?: RequestOptions): Promise<Workspace[]>;
-    /**
-     * Retrieve a workspace by its external ID.
-     *
-     * @param id - Workspace external ID (UUID).
-     * @param options - Per-request overrides.
-     * @returns The workspace.
-     *
-     * @throws {NotFoundError} If the workspace doesn't exist.
-     */
+    /** Retrieve a workspace by external ID. */
     retrieve(id: string, options?: RequestOptions): Promise<Workspace>;
-    /**
-     * Delete a workspace and all associated data.
-     *
-     * @param id - Workspace external ID (UUID).
-     * @param options - Per-request overrides.
-     *
-     * @throws {NotFoundError} If the workspace doesn't exist.
-     */
+    /** Delete a workspace and all associated data. */
     del(id: string, options?: RequestOptions): Promise<void>;
+    /** List workspace-level channel bindings. */
+    listChannels(workspaceId: string, options?: RequestOptions): Promise<ChannelBinding[]>;
+    /** Upsert workspace-level channel bindings. */
+    updateChannels(workspaceId: string, params: UpdateChannelsParams, options?: RequestOptions): Promise<ChannelBinding[]>;
+    /** Remove a workspace-level channel binding by type. */
+    deleteChannel(workspaceId: string, channelType: string, options?: RequestOptions): Promise<void>;
 }
 //# sourceMappingURL=workspaces.d.ts.map

package/dist/types/resources/workspaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../../../src/resources/workspaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE/E;;;;;;;;;;;;GAYG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C;;;;;;;;;;;;OAYG;IACG,MAAM,CACV,MAAM,EAAE,qBAAqB,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IAUrB;;;;;;;;OAQG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAU1D;;;;;;;;OAQG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAUxE;;;;;;;OAOG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAS/D"}
+{"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../../../src/resources/workspaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAE5B;;;;;GAKG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,2DAA2D;IACrD,MAAM,CACV,MAAM,EAAE,qBAAqB,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IAUrB,iEAAiE;IAC3D,IAAI,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAU1D,2CAA2C;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAUxE,kDAAkD;IAC5C,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9D,6CAA6C;IACvC,YAAY,CAChB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,cAAc,EAAE,CAAC;IAU5B,+CAA+C;IACzC,cAAc,CAClB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,cAAc,EAAE,CAAC;IAU5B,wDAAwD;IAClD,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;CASjB"}

package/dist/types/types/agents.d.ts

@@ -1,17 +1,89 @@
+/** Runner implementation that executes the agent. */
+export type AgentRunner = 'claude_code';
+/** LLM provider backing the runner. Inferred from the runner (e.g. claude_code -> claude). */
+export type AgentProvider = 'claude';
+/** Agent configuration: runner, model, system prompt, and workspace settings. */
+export interface AgentConfig {
+    runner?: AgentRunner;
+    provider?: AgentProvider;
+    model?: string;
+    system_prompt?: string;
+    system_prompt_mode?: string;
+    workspace_dir?: string;
+    skills?: string[];
+    [key: string]: unknown;
+}
+/** A registered agent profile within a workspace. */
 export interface AgentProfile {
     id: string;
     workspace_id: number;
     agent_key: string;
     name: string;
-    config_json: Record<string, unknown>;
+    role: string;
+    memory_scope: string;
+    quality_score?: number;
+    cost_budget_usd?: number;
+    config_json: AgentConfig;
     active: boolean;
     created_at: string;
     updated_at: string;
 }
+/** Parameters for creating a new agent profile. */
 export interface AgentCreateParams {
     agentKey: string;
     name: string;
-    config?: Record<string, unknown>;
+    runner?: AgentRunner;
+    config?: AgentConfig;
+    active?: boolean;
+}
+/** Parameters for updating an existing agent profile. All fields are optional. */
+export interface AgentUpdateParams {
+    name?: string;
+    role?: string;
+    memoryScope?: string;
+    qualityScore?: number;
+    costBudgetUsd?: number;
+    config?: AgentConfig;
     active?: boolean;
 }
+/**
+ * A channel binding that routes inbound messages (email, SMS) to an agent or workspace.
+ *
+ * When `agent_id` is set, the binding is scoped to that specific agent —
+ * inbound messages go directly to that agent as tasks.
+ *
+ * When `agent_id` is null, the binding is workspace-level — inbound
+ * messages are routed to agents automatically via BAML classification.
+ */
+export interface ChannelBinding {
+    id: number;
+    workspace_id: number;
+    agent_id: string | null;
+    channel_type: 'email' | 'sms';
+    address: string;
+    config_json: Record<string, unknown>;
+    active: boolean;
+    created_at: string;
+    updated_at: string;
+}
+/** Aggregated task metrics for an agent. */
+export interface AgentStats {
+    total: number;
+    by_state: Record<string, number>;
+    avg_run_sec?: number;
+    quality_score?: number;
+    total_cost_usd: number;
+    running_count: number;
+    completed_count: number;
+    failed_count: number;
+}
+/** Parameters for upserting channel bindings. */
+export interface UpdateChannelsParams {
+    channels: Array<{
+        channel_type: string;
+        address: string;
+        active?: boolean;
+        config_json?: Record<string, unknown>;
+    }>;
+}
 //# sourceMappingURL=agents.d.ts.map

package/dist/types/types/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/types/agents.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/types/agents.ts"],"names":[],"mappings":"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"}

package/dist/types/types/channels.d.ts

@@ -0,0 +1,20 @@
+import type { AgentCommandCreateParams, QueueMode, TaskAcceptedResponse } from './tasks.js';
+export type ChannelType = 'direct';
+/**
+ * Payload for sending a direct message to an agent.
+ * This creates a new task for the target agent.
+ */
+export interface SendDirectAgentMessageParams extends Omit<AgentCommandCreateParams, 'agentId'> {
+}
+/**
+ * Payload for sending direct follow-up input to an existing run.
+ */
+export interface SendDirectRunMessageParams {
+    message: string;
+    taskId: string;
+    queueMode?: QueueMode;
+    idempotencyKey?: string;
+}
+export type SendDirectAgentMessageResponse = TaskAcceptedResponse;
+export type SendDirectRunMessageResponse = TaskAcceptedResponse;
+//# sourceMappingURL=channels.d.ts.map

package/dist/types/types/channels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../../src/types/channels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE5F,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;AAEnC;;;GAGG;AACH,MAAM,WAAW,4BACf,SAAQ,IAAI,CAAC,wBAAwB,EAAE,SAAS,CAAC;CAAG;AAEtD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,8BAA8B,GAAG,oBAAoB,CAAC;AAClE,MAAM,MAAM,4BAA4B,GAAG,oBAAoB,CAAC"}

package/dist/types/types/filesystem.d.ts

@@ -36,4 +36,24 @@ export interface TreeListing {
     truncated: boolean;
     continuation_token?: string;
 }
+/**
+ * Search result.
+ */
+export interface SearchResult {
+    query: string;
+    results: VirtualFile[];
+}
+/**
+ * Presigned upload URL response.
+ */
+export interface UploadUrlResponse {
+    upload_url: string;
+    key: string;
+}
+/**
+ * Presigned download URL response.
+ */
+export interface DownloadUrlResponse {
+    download_url: string;
+}
 //# sourceMappingURL=filesystem.d.ts.map

package/dist/types/types/filesystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../../src/types/filesystem.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B"}
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../../src/types/filesystem.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/types/types/hooks.d.ts

@@ -0,0 +1,57 @@
+/** A file-system hook that auto-triggers agent tasks on source view changes. */
+export interface Hook {
+    external_id: string;
+    workspace_id: string;
+    path: string;
+    prompt: string;
+    skill_path: string;
+    skill_paths: string[];
+    event_types: string[];
+    agent_id?: string;
+    agent_key?: string;
+    agent_name?: string;
+    agent_config?: Record<string, unknown>;
+    active: boolean;
+    created_at: string;
+    updated_at: string;
+}
+/** Parameters for creating a hook on a source view folder. */
+export interface HookCreateParams {
+    /** Source view folder path to watch (e.g. `/sources/gmail/Recent Emails`). */
+    path: string;
+    /** Prompt sent to the agent when an event fires. */
+    prompt: string;
+    /** Single skill path (prefer `skillPaths`). */
+    skillPath?: string;
+    /** Skill paths the agent can use when handling hook events. */
+    skillPaths?: string[];
+    /** File event types to listen for (e.g. `['create', 'write']`). Defaults to all. */
+    eventTypes?: string[];
+    /** Display name for the auto-created agent. */
+    agentName?: string;
+    /** Agent configuration overrides. */
+    agentConfig?: {
+        runner?: string;
+        model?: string;
+        systemPrompt?: string;
+        systemPromptMode?: string;
+        workspaceDir?: string;
+    };
+}
+/** Parameters for updating a hook. All fields are optional. */
+export interface HookUpdateParams {
+    prompt?: string;
+    active?: boolean;
+    skillPath?: string;
+    skillPaths?: string[];
+    eventTypes?: string[];
+    agentName?: string;
+    agentConfig?: {
+        runner?: string;
+        model?: string;
+        systemPrompt?: string;
+        systemPromptMode?: string;
+        workspaceDir?: string;
+    };
+}
+//# sourceMappingURL=hooks.d.ts.map