@airstore/sdk 0.1.4 → 0.1.6

package/dist/types/resources/access-log.d.ts

@@ -6,67 +6,15 @@ import type { AccessLogListParams, AccessLogListResponse, AccessLogSummaryParams
  * Every file read through the virtual filesystem is recorded with token
  * counts, compression outcome, timing, and a `source_uri` that pins
  * the content back to its upstream origin.
- *
- * @example List recent reads
- * ```ts
- * const page = await airstore.accessLog.list("ws-abc", {
- *   start: Date.now() - 3600_000, // last hour
- *   limit: 50,
- * });
- * for (const r of page.reads) {
- *   console.log(r.source_uri, r.original_tokens, "->", r.compressed_tokens);
- * }
- * ```
- *
- * @example Get a summary
- * ```ts
- * const s = await airstore.accessLog.summary("ws-abc", {
- *   start: Date.now() - 86400_000,
- * });
- * console.log(`${s.total_reads} reads, ${s.compression_ratio} ratio`);
- * ```
- *
- * @example Replay a read by source URI
- * ```ts
- * const content = await airstore.accessLog.read("ws-abc", "github://abc123");
- * ```
  */
 export declare class AccessLog {
     private readonly client;
     constructor(client: CoreClient);
-    /**
-     * List access log reads for a workspace.
-     *
-     * Supports cursor-based pagination and optional time-window filtering.
-     *
-     * @param workspaceId - Workspace external ID (UUID).
-     * @param params - Filtering and pagination options.
-     * @param options - Per-request overrides.
-     */
+    /** List access log reads with optional time-window and cursor pagination. */
     list(workspaceId: string, params?: AccessLogListParams, options?: RequestOptions): Promise<AccessLogListResponse>;
-    /**
-     * Get an aggregated summary of access log reads.
-     *
-     * Returns totals, compression ratio, per-integration breakdown,
-     * outcome distribution, and top paths by token consumption.
-     *
-     * @param workspaceId - Workspace external ID (UUID).
-     * @param params - Time window and session options.
-     * @param options - Per-request overrides.
-     */
+    /** Get an aggregated summary: totals, compression ratio, per-integration breakdown. */
     summary(workspaceId: string, params?: AccessLogSummaryParams, options?: RequestOptions): Promise<AccessLogSummary>;
-    /**
-     * Read content directly from an upstream source using a `source_uri`.
-     *
-     * This bypasses the source-view/query layer entirely. Even if the
-     * materialized view has changed, the source_uri lets you pull the
-     * exact content that was originally read.
-     *
-     * @param workspaceId - Workspace external ID (UUID).
-     * @param sourceUri - Source URI from an access log entry (e.g., "github://abc123").
-     * @param options - Per-request overrides.
-     * @returns The raw content as an ArrayBuffer.
-     */
+    /** Read content directly from an upstream source using a `source_uri`. */
     read(workspaceId: string, sourceUri: string, options?: RequestOptions): Promise<ArrayBuffer>;
 }
 //# sourceMappingURL=access-log.d.ts.map

package/dist/types/resources/access-log.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"access-log.d.ts","sourceRoot":"","sources":["../../../src/resources/access-log.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EACV,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C;;;;;;;;OAQG;IACG,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,qBAAqB,CAAC;IAiBjC;;;;;;;;;OASG;IACG,OAAO,CACX,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,sBAAsB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,gBAAgB,CAAC;IAe5B;;;;;;;;;;;OAWG;IACG,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC;CAQxB"}
+{"version":3,"file":"access-log.d.ts","sourceRoot":"","sources":["../../../src/resources/access-log.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EACV,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;GAMG;AACH,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,6EAA6E;IACvE,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,qBAAqB,CAAC;IAiBjC,uFAAuF;IACjF,OAAO,CACX,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,sBAAsB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,gBAAgB,CAAC;IAe5B,0EAA0E;IACpE,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC;CAQxB"}

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

@@ -1,13 +1,25 @@
 import type { CoreClient, RequestOptions } from '../client.js';
-import type { AgentCreateParams, AgentProfile } from '../types/agents.js';
+import type { AgentConfig, AgentCreateParams, AgentProfile, AgentUpdateParams } from '../types/agents.js';
 /**
- * Manage agent profiles in a workspace.
+ * CRUD operations for agent profiles within a workspace.
+ *
+ * An agent profile defines the runner, model, system prompt, and other
+ * configuration used when a task is dispatched to that agent.
  */
 export declare class Agents {
     private readonly client;
     constructor(client: CoreClient);
+    /** Retrieve the default agent config (system prompt, workspace dir) for a runner key. */
+    defaults(workspaceId: string, agentKey?: string, options?: RequestOptions): Promise<AgentConfig>;
+    /** Create a new agent profile. Returns the created profile with its server-assigned `id`. */
     create(workspaceId: string, params: AgentCreateParams, options?: RequestOptions): Promise<AgentProfile>;
+    /** List all agent profiles in a workspace. */
     list(workspaceId: string, options?: RequestOptions): Promise<AgentProfile[]>;
+    /** Retrieve a single agent profile by ID. */
     retrieve(workspaceId: string, agentId: string, options?: RequestOptions): Promise<AgentProfile>;
+    /** Update an agent profile. Only provided fields are changed (merge semantics for config). */
+    update(workspaceId: string, agentId: string, params: AgentUpdateParams, options?: RequestOptions): Promise<AgentProfile>;
+    /** Delete an agent profile and any hooks bound to it. */
+    delete(workspaceId: string, agentId: string, options?: RequestOptions): Promise<void>;
 }
 //# sourceMappingURL=agents.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/resources/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE1E;;GAEG;AACH,qBAAa,MAAM;IACL,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEzC,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,CAAC;IAelB,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,EAAE,CAAC;IAUpB,QAAQ,CACZ,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,CAAC;CASzB"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/resources/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAI1G;;;;;GAKG;AACH,qBAAa,MAAM;IACL,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,yFAAyF;IACnF,QAAQ,CACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC;IAWvB,6FAA6F;IACvF,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,CAAC;IAoBxB,8CAA8C;IACxC,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,EAAE,CAAC;IAU1B,6CAA6C;IACvC,QAAQ,CACZ,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,CAAC;IAUxB,8FAA8F;IACxF,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,CAAC;IAcxB,yDAAyD;IACnD,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;CASjB"}

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

@@ -0,0 +1,21 @@
+import type { CoreClient, RequestOptions } from '../client.js';
+import type { SendDirectAgentMessageParams, SendDirectAgentMessageResponse, SendDirectRunMessageParams, SendDirectRunMessageResponse } from '../types/channels.js';
+/**
+ * Send direct messages to agents and runs via named channels.
+ *
+ * Use `sendDirectAgentMessage` to start a new task by messaging an agent, and
+ * `sendDirectRunMessage` to send follow-up input to an existing run (e.g.
+ * follow-up, steer, or interrupt).
+ */
+export declare class Channels {
+    private readonly client;
+    constructor(client: CoreClient);
+    /** Send a message to an agent, creating a new task. Equivalent to tasks.create via the direct channel. */
+    sendDirectAgentMessage(workspaceId: string, agentId: string, params: SendDirectAgentMessageParams, options?: RequestOptions): Promise<SendDirectAgentMessageResponse>;
+    /**
+     * Send a follow-up message to an active run. The `queueMode` controls
+     * delivery: `followup`, `steer`, `interrupt`, or `queue`.
+     */
+    sendDirectRunMessage(workspaceId: string, runId: string, params: SendDirectRunMessageParams, options?: RequestOptions): Promise<SendDirectRunMessageResponse>;
+}
+//# sourceMappingURL=channels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../../src/resources/channels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EACV,4BAA4B,EAC5B,8BAA8B,EAC9B,0BAA0B,EAC1B,4BAA4B,EAC7B,MAAM,sBAAsB,CAAC;AAG9B;;;;;;GAMG;AACH,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,0GAA0G;IACpG,sBAAsB,CAC1B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,4BAA4B,EACpC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,8BAA8B,CAAC;IAyB1C;;;OAGG;IACG,oBAAoB,CACxB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,0BAA0B,EAClC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,4BAA4B,CAAC;CAczC"}

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

@@ -1,50 +1,19 @@
 import type { CoreClient, RequestOptions } from '../client.js';
 import type { Connection, ConnectionCreateParams } from '../types/connections.js';
 /**
- * Manage connections (integrations) within a workspace.
+ * Manage integration connections within a workspace.
  *
- * Connections store OAuth tokens or API keys for external services like
- * Gmail, GitHub, Notion, etc. Pass existing tokens directly to avoid
- * requiring users to re-authenticate.
- *
- * @example
- * ```ts
- * await airstore.connections.create("ws_abc", {
- *   integrationType: "gmail",
- *   accessToken: existingAccessToken,
- *   refreshToken: existingRefreshToken,
- * });
- * ```
+ * Connections store OAuth tokens or API keys for external services
+ * (Gmail, GitHub, Notion, etc.).
  */
 export declare class Connections {
     private readonly client;
     constructor(client: CoreClient);
-    /**
-     * Create a connection by passing existing OAuth credentials or API keys.
-     *
-     * @param workspaceId - Workspace external ID.
-     * @param params - Connection creation parameters.
-     * @param options - Per-request overrides.
-     * @returns The created connection.
-     */
+    /** Create a connection by passing existing OAuth credentials or an API key. */
     create(workspaceId: string, params: ConnectionCreateParams, options?: RequestOptions): Promise<Connection>;
-    /**
-     * List all connections in a workspace.
-     *
-     * @param workspaceId - Workspace external ID.
-     * @param options - Per-request overrides.
-     * @returns Array of connections.
-     */
+    /** List all connections in a workspace. */
     list(workspaceId: string, options?: RequestOptions): Promise<Connection[]>;
-    /**
-     * Delete a connection.
-     *
-     * @param workspaceId - Workspace external ID.
-     * @param connectionId - Connection external ID.
-     * @param options - Per-request overrides.
-     *
-     * @throws {NotFoundError} If the connection doesn't exist.
-     */
+    /** Delete a connection. */
     del(workspaceId: string, connectionId: string, options?: RequestOptions): Promise<void>;
 }
 //# sourceMappingURL=connections.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"connections.d.ts","sourceRoot":"","sources":["../../../src/resources/connections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAElF;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C;;;;;;;OAOG;IACG,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC;IAmBtB;;;;;;OAMG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAWhF;;;;;;;;OAQG;IACG,GAAG,CACP,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;CASjB"}
+{"version":3,"file":"connections.d.ts","sourceRoot":"","sources":["../../../src/resources/connections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAElF;;;;;GAKG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,+EAA+E;IACzE,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC;IAmBtB,2CAA2C;IACrC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAWhF,2BAA2B;IACrB,GAAG,CACP,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;CASjB"}

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

@@ -5,43 +5,17 @@ import type { VirtualFile, TreeListing } from '../types/filesystem.js';
  *
  * The filesystem provides a unified view of all connected integrations,
  * source views, tools, and user-uploaded files.
- *
- * @example
- * ```ts
- * const listing = await airstore.fs.list("ws_abc", { path: "/" });
- * const content = await airstore.fs.read("ws_abc", {
- *   path: "/sources/gmail/inbox/email.txt",
- * });
- * ```
  */
 export declare class Filesystem {
     private readonly client;
     constructor(client: CoreClient);
-    /**
-     * List directory contents.
-     *
-     * @param workspaceId - Workspace external ID.
-     * @param opts - Listing options.
-     * @param opts.path - Directory path to list. Defaults to root.
-     * @param options - Per-request overrides.
-     * @returns Array of files and directories.
-     */
+    /** List directory contents at the given path (defaults to root). */
     list(workspaceId: string, opts?: {
         path?: string;
     }, options?: RequestOptions): Promise<VirtualFile[]>;
     /**
-     * Read file contents as a string.
-     *
-     * @param workspaceId - Workspace external ID.
-     * @param opts - Read options.
-     * @param opts.path - File path to read.
-     * @param opts.offset - Byte offset to start reading from.
-     * @param opts.length - Number of bytes to read.
-     * @param opts.compression - Compression strategy: 'strip', 'distill', or 'chain'. Omit to disable.
-     * @param options - Per-request overrides.
-     * @returns File contents as a string.
-     *
-     * @throws {NotFoundError} If the file doesn't exist.
+     * Read file contents as a string. Supports byte-range reads
+     * (`offset`/`length`) and server-side compression strategies.
      */
     read(workspaceId: string, opts: {
         path: string;
@@ -49,35 +23,13 @@ export declare class Filesystem {
         length?: number;
         compression?: 'strip' | 'distill' | 'chain';
     }, options?: RequestOptions): Promise<string>;
-    /**
-     * Get a directory tree for efficient prefetching.
-     *
-     * Returns a flat list of all entries under the given path. Supports
-     * pagination via `continuationToken` for large directories.
-     *
-     * @param workspaceId - Workspace external ID.
-     * @param opts - Tree options.
-     * @param opts.path - Root path for the tree. Defaults to root.
-     * @param opts.maxKeys - Maximum number of entries to return.
-     * @param opts.continuationToken - Token from a previous truncated response.
-     * @param options - Per-request overrides.
-     * @returns Tree listing with entries and pagination info.
-     */
+    /** Get a flat directory tree. Supports pagination via `continuationToken`. */
     tree(workspaceId: string, opts?: {
         path?: string;
         maxKeys?: number;
         continuationToken?: string;
     }, options?: RequestOptions): Promise<TreeListing>;
-    /**
-     * Get file or directory metadata.
-     *
-     * @param workspaceId - Workspace external ID.
-     * @param path - Absolute path to stat.
-     * @param options - Per-request overrides.
-     * @returns File metadata.
-     *
-     * @throws {NotFoundError} If the path doesn't exist.
-     */
+    /** Get file or directory metadata. */
     stat(workspaceId: string, path: string, options?: RequestOptions): Promise<VirtualFile>;
 }
 //# sourceMappingURL=filesystem.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../../src/resources/filesystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAoB,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEzF;;;;;;;;;;;;;GAaG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C;;;;;;;;OAQG;IACG,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,EAAE,CAAC;IAczB;;;;;;;;;;;;;OAaG;IACG,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;KAC7C,EACD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC;IAclB;;;;;;;;;;;;;OAaG;IACG,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAO,EAC1E,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC;IAiBvB;;;;;;;;;OASG;IACG,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC;CASxB"}
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../../src/resources/filesystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAoB,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEzF;;;;;GAKG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,oEAAoE;IAC9D,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,EAAE,CAAC;IAczB;;;OAGG;IACG,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;KAC7C,EACD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC;IAclB,8EAA8E;IACxE,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAO,EAC1E,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC;IAiBvB,sCAAsC;IAChC,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC;CASxB"}

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

@@ -0,0 +1,5 @@
+import type { InputProvenance, RoutingContext, RunExecutionPolicy } from '../types/tasks.js';
+export declare function toRoutingBody(routing: RoutingContext | undefined): Record<string, unknown>;
+export declare function toInputProvenanceBody(provenance: InputProvenance | undefined): Record<string, unknown> | undefined;
+export declare function toPolicyBody(policy: RunExecutionPolicy | undefined): Record<string, unknown> | undefined;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/resources/helpers.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE7F,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAc1F;AAED,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,eAAe,GAAG,SAAS,GACtC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CASrC;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,kBAAkB,GAAG,SAAS,GACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAgBrC"}

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

@@ -0,0 +1,23 @@
+import type { CoreClient, RequestOptions } from '../client.js';
+import type { Hook, HookCreateParams, HookUpdateParams } from '../types/hooks.js';
+/**
+ * CRUD operations for file-system hooks within a workspace.
+ *
+ * A hook watches a source view folder for file events (create, write, delete)
+ * and automatically submits a task to an agent with the configured prompt.
+ */
+export declare class Hooks {
+    private readonly client;
+    constructor(client: CoreClient);
+    /** Create a hook on a source view folder path. */
+    create(workspaceId: string, params: HookCreateParams, options?: RequestOptions): Promise<Hook>;
+    /** List all hooks in a workspace. */
+    list(workspaceId: string, options?: RequestOptions): Promise<Hook[]>;
+    /** Retrieve a single hook by ID. */
+    retrieve(workspaceId: string, hookId: string, options?: RequestOptions): Promise<Hook>;
+    /** Update a hook. Only provided fields are changed. Set `active: false` to disable. */
+    update(workspaceId: string, hookId: string, params: HookUpdateParams, options?: RequestOptions): Promise<Hook>;
+    /** Delete a hook permanently. */
+    delete(workspaceId: string, hookId: string, options?: RequestOptions): Promise<void>;
+}
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/resources/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAElF;;;;;GAKG;AACH,qBAAa,KAAK;IACJ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,kDAAkD;IAC5C,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;IAmChB,qCAAqC;IAC/B,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,EAAE,CAAC;IAUlB,oCAAoC;IAC9B,QAAQ,CACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;IAUhB,uFAAuF;IACjF,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;IA8BhB,iCAAiC;IAC3B,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;CASjB"}

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

@@ -8,4 +8,6 @@ export { Filesystem } from './filesystem.js';
 export { Agents } from './agents.js';
 export { Tasks } from './tasks.js';
 export { Runs } from './runs.js';
+export { Channels } from './channels.js';
+export { Hooks } from './hooks.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

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

@@ -5,45 +5,15 @@ import type { Member, MemberCreateParams } from '../types/members.js';
  *
  * Members are users with roles (admin, member, viewer) in a workspace.
  * Tokens are always associated with a member.
- *
- * @example
- * ```ts
- * const member = await airstore.members.create("ws_abc", {
- *   email: "agent@internal",
- *   name: "Agent",
- *   role: "member",
- * });
- * ```
  */
 export declare class Members {
     private readonly client;
     constructor(client: CoreClient);
-    /**
-     * Add a member to a workspace.
-     *
-     * @param workspaceId - Workspace external ID.
-     * @param params - Member creation parameters.
-     * @param options - Per-request overrides.
-     * @returns The created member.
-     */
+    /** Add a member to a workspace. */
     create(workspaceId: string, params: MemberCreateParams, options?: RequestOptions): Promise<Member>;
-    /**
-     * List members of a workspace.
-     *
-     * @param workspaceId - Workspace external ID.
-     * @param options - Per-request overrides.
-     * @returns Array of members.
-     */
+    /** List members of a workspace. */
     list(workspaceId: string, options?: RequestOptions): Promise<Member[]>;
-    /**
-     * Remove a member from a workspace.
-     *
-     * @param workspaceId - Workspace external ID.
-     * @param memberId - Member external ID.
-     * @param options - Per-request overrides.
-     *
-     * @throws {NotFoundError} If the member doesn't exist.
-     */
+    /** Remove a member from a workspace. */
     del(workspaceId: string, memberId: string, options?: RequestOptions): Promise<void>;
 }
 //# sourceMappingURL=members.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"members.d.ts","sourceRoot":"","sources":["../../../src/resources/members.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEtE;;;;;;;;;;;;;;GAcG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C;;;;;;;OAOG;IACG,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC;IAclB;;;;;;OAMG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAU5E;;;;;;;;OAQG;IACG,GAAG,CACP,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;CASjB"}
+{"version":3,"file":"members.d.ts","sourceRoot":"","sources":["../../../src/resources/members.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEtE;;;;;GAKG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,mCAAmC;IAC7B,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC;IAclB,mCAAmC;IAC7B,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAU5E,wCAAwC;IAClC,GAAG,CACP,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;CASjB"}

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,46 @@
 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, TaskLogListParams, TaskLogListResponse, TaskEventStreamParams, TaskEventBatch, Schedule, ScheduleCreateParams, ScheduleUpdateParams } 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 an idle or terminal task so it no longer appears in active listings. */
+    archive(workspaceId: string, taskId: string, options?: RequestOptions): Promise<TaskArchiveResponse>;
+    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>;
 }
 //# 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":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EACV,wBAAwB,EACxB,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,QAAQ,EACR,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAG3B;;;;;;GAMG;AACH,qBAAa,KAAK;IACJ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C;;;;OAIG;IACG,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,oBAAoB,CAAC;IA0BhC,oCAAoC;IAC9B,QAAQ,CACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IAUrB,yFAAyF;IACnF,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,gBAAgB,CAAC;IAkB5B,4EAA4E;IACtE,QAAQ,CACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,mBAAmB,CAAC;IAU/B;;;OAGG;IACG,YAAY,CAChB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,qBAAqB,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,cAAc,CAAC;IAU1B,gDAAgD;IAC1C,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,kBAAkB,CAAC;IAU9B,mFAAmF;IAC7E,OAAO,CACX,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,mBAAmB,CAAC;IAY/B,OAAO,CAAC,YAAY;IAKpB,2EAA2E;IACrE,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQpH,8CAA8C;IACxC,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAIvF,wCAAwC;IAClC,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI5G,yFAAyF;IACnF,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAUxI,qCAAqC;IAC/B,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAGvG"}