@agent-os-sdk/client 0.1.0

package/dist/modules/a2a.js

@@ -0,0 +1,37 @@
+/**
+ * A2A Module - Fully Typed (Agent-to-Agent Protocol)
+ */
+export class A2aModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    /**
+     * Send a JSON-RPC request to an agent.
+     */
+    async call(request) {
+        return this.client.POST("/v1/api/a2a", {
+            body: request,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get agent card (discovery).
+     */
+    async getAgentCard(agentId) {
+        return this.client.GET("/v1/api/a2a/agents/{id}/card", {
+            params: { path: { id: agentId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * List available A2A agents.
+     */
+    async listAgents() {
+        return this.client.GET("/v1/api/a2a/agents", {
+            headers: this.headers(),
+        });
+    }
+}

package/dist/modules/agents.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Agents Module - Fully Typed
+ *
+ * Naming conventions:
+ * - get* for singular items: getAgent(id)
+ * - list* for collections: listAgents()
+ * - create*, update*, delete* for mutations
+ */
+import type { RawClient, APIResponse, components } from "../client/raw.js";
+import type { PaginationParams, PaginatedResponse } from "../client/helpers.js";
+type AgentBundle = components["schemas"]["AgentBundle"];
+export interface Agent {
+    id: string;
+    name: string;
+    description?: string;
+    workspace_id: string;
+    tenant_id: string;
+    created_at: string;
+    updated_at: string;
+    live_version_id?: string | null;
+}
+export interface AgentVersion {
+    id: string;
+    agent_id: string;
+    version_tag: string;
+    artifact_uri?: string;
+    artifact_hash?: string;
+    format?: string;
+    graph_spec?: unknown;
+    created_at: string;
+}
+export interface AgentGraphResponse {
+    mermaid?: string;
+    json?: unknown;
+}
+export interface GraphValidationResponse {
+    valid: boolean;
+    errors?: string[];
+    warnings?: string[];
+}
+export type AgentListResponse = PaginatedResponse<Agent>;
+export type AgentVersionListResponse = PaginatedResponse<AgentVersion>;
+export declare class AgentsModule {
+    private client;
+    private headers;
+    constructor(client: RawClient, headers: () => Record<string, string>);
+    /**
+     * List all agents in the workspace.
+     * @example
+     * ```ts
+     * const { data } = await client.agents.list({ limit: 10 });
+     * data?.items.forEach(agent => console.log(agent.name));
+     * ```
+     */
+    list(params?: PaginationParams & {
+        workspace_id?: string;
+    }): Promise<APIResponse<AgentListResponse>>;
+    /**
+     * Get a single agent by ID.
+     * @example
+     * ```ts
+     * const { data: agent } = await client.agents.get("agent-uuid");
+     * ```
+     */
+    get(agentId: string): Promise<APIResponse<Agent>>;
+    /**
+     * Create a new agent.
+     * @example
+     * ```ts
+     * const { data: agent } = await client.agents.create({
+     *   name: "My Agent",
+     *   description: "Does cool stuff"
+     * });
+     * ```
+     */
+    create(body: {
+        name: string;
+        description?: string;
+        graph_json?: unknown;
+    }): Promise<APIResponse<Agent>>;
+    /**
+     * Update an existing agent.
+     */
+    update(agentId: string, body: {
+        name?: string;
+        description?: string;
+        live_version_id?: string;
+    }): Promise<APIResponse<Agent>>;
+    /**
+     * Delete an agent.
+     */
+    delete(agentId: string): Promise<APIResponse<void>>;
+    /**
+     * List all versions of an agent.
+     * @example
+     * ```ts
+     * const { data } = await client.agents.listVersions("agent-uuid");
+     * ```
+     */
+    listVersions(agentId: string): Promise<APIResponse<AgentVersion[]>>;
+    /** Alias for listVersions (convenience) */
+    versions: (agentId: string) => Promise<APIResponse<AgentVersion[]>>;
+    /**
+     * Create a new version of an agent.
+     */
+    createVersion(agentId: string, body: {
+        version_tag: string;
+        artifact_uri?: string;
+        artifact_hash?: string;
+        format?: string;
+        graph_spec?: unknown;
+    }): Promise<APIResponse<AgentVersion>>;
+    /**
+     * Get a specific version of an agent.
+     */
+    getVersion(agentId: string, versionId: string): Promise<APIResponse<AgentVersion>>;
+    /**
+     * Get the graph for an agent (Mermaid or JSON).
+     */
+    getGraph(agentId: string, format?: "mermaid" | "json"): Promise<APIResponse<AgentGraphResponse>>;
+    /** Alias for getGraph (convenience) */
+    graph: (agentId: string, format?: "mermaid" | "json") => Promise<APIResponse<AgentGraphResponse>>;
+    /**
+     * Validate the graph configuration.
+     */
+    validateGraph(agentId: string): Promise<APIResponse<GraphValidationResponse>>;
+    /**
+     * Export an agent with all its versions.
+     */
+    export(agentId: string): Promise<APIResponse<AgentBundle>>;
+    /**
+     * Import an agent bundle.
+     */
+    import(bundle: AgentBundle): Promise<APIResponse<Agent>>;
+}
+export {};
+//# sourceMappingURL=agents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/modules/agents.ts"],"names":[],"mappings":"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"}

package/dist/modules/agents.js

@@ -0,0 +1,154 @@
+/**
+ * Agents Module - Fully Typed
+ *
+ * Naming conventions:
+ * - get* for singular items: getAgent(id)
+ * - list* for collections: listAgents()
+ * - create*, update*, delete* for mutations
+ */
+export class AgentsModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    // ======================== CRUD ========================
+    /**
+     * List all agents in the workspace.
+     * @example
+     * ```ts
+     * const { data } = await client.agents.list({ limit: 10 });
+     * data?.items.forEach(agent => console.log(agent.name));
+     * ```
+     */
+    async list(params) {
+        return this.client.GET("/v1/api/agents", {
+            params: { query: params },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get a single agent by ID.
+     * @example
+     * ```ts
+     * const { data: agent } = await client.agents.get("agent-uuid");
+     * ```
+     */
+    async get(agentId) {
+        return this.client.GET("/v1/api/agents/{agentId}", {
+            params: { path: { agentId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Create a new agent.
+     * @example
+     * ```ts
+     * const { data: agent } = await client.agents.create({
+     *   name: "My Agent",
+     *   description: "Does cool stuff"
+     * });
+     * ```
+     */
+    async create(body) {
+        return this.client.POST("/v1/api/agents", {
+            body,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Update an existing agent.
+     */
+    async update(agentId, body) {
+        return this.client.PUT("/v1/api/agents/{agentId}", {
+            params: { path: { agentId } },
+            body,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Delete an agent.
+     */
+    async delete(agentId) {
+        return this.client.DELETE("/v1/api/agents/{agentId}", {
+            params: { path: { agentId } },
+            headers: this.headers(),
+        });
+    }
+    // ======================== Versions ========================
+    /**
+     * List all versions of an agent.
+     * @example
+     * ```ts
+     * const { data } = await client.agents.listVersions("agent-uuid");
+     * ```
+     */
+    async listVersions(agentId) {
+        return this.client.GET("/v1/api/agents/{agentId}/versions", {
+            params: { path: { agentId } },
+            headers: this.headers(),
+        });
+    }
+    /** Alias for listVersions (convenience) */
+    versions = (agentId) => this.listVersions(agentId);
+    /**
+     * Create a new version of an agent.
+     */
+    async createVersion(agentId, body) {
+        return this.client.POST("/v1/api/agents/{agentId}/versions", {
+            params: { path: { agentId } },
+            body,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get a specific version of an agent.
+     */
+    async getVersion(agentId, versionId) {
+        return this.client.GET("/v1/api/agents/{agentId}/versions/{versionId}", {
+            params: { path: { agentId, versionId } },
+            headers: this.headers(),
+        });
+    }
+    // ======================== Graph ========================
+    /**
+     * Get the graph for an agent (Mermaid or JSON).
+     */
+    async getGraph(agentId, format) {
+        return this.client.GET("/v1/api/agents/{agentId}/graph", {
+            params: { path: { agentId }, query: { format } },
+            headers: this.headers(),
+        });
+    }
+    /** Alias for getGraph (convenience) */
+    graph = (agentId, format) => this.getGraph(agentId, format);
+    /**
+     * Validate the graph configuration.
+     */
+    async validateGraph(agentId) {
+        return this.client.POST("/v1/api/agents/{agentId}/graph/validate", {
+            params: { path: { agentId } },
+            headers: this.headers(),
+        });
+    }
+    // ======================== Import/Export ========================
+    /**
+     * Export an agent with all its versions.
+     */
+    async export(agentId) {
+        return this.client.GET("/v1/api/agents/{id}/export", {
+            params: { path: { id: agentId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Import an agent bundle.
+     */
+    async import(bundle) {
+        return this.client.POST("/v1/api/agents/import", {
+            body: bundle,
+            headers: this.headers(),
+        });
+    }
+}

package/dist/modules/audit.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Audit Module - Fully Typed
+ */
+import type { RawClient, APIResponse } from "../client/raw.js";
+export interface AuditLogEntry {
+    id: string;
+    tenant_id: string;
+    workspace_id?: string;
+    actor: string;
+    actor_type: "user" | "system" | "api_token";
+    action: string;
+    resource: string;
+    resource_id?: string;
+    metadata?: Record<string, unknown>;
+    ip_address?: string;
+    user_agent?: string;
+    created_at: string;
+}
+export interface AuditListResponse {
+    items: AuditLogEntry[];
+    total: number;
+}
+export declare class AuditModule {
+    private client;
+    private headers;
+    constructor(client: RawClient, headers: () => Record<string, string>);
+    /**
+     * List audit log entries.
+     */
+    list(params?: {
+        actor?: string;
+        action?: string;
+        resource?: string;
+        workspace_id?: string;
+        from?: string;
+        to?: string;
+        skip?: number;
+        take?: number;
+    }): Promise<APIResponse<AuditListResponse>>;
+    /**
+     * Get a specific audit log entry.
+     */
+    get(auditId: string): Promise<APIResponse<AuditLogEntry>>;
+    /**
+     * Search audit logs by action pattern.
+     */
+    search(params?: {
+        query?: string;
+        from?: string;
+        to?: string;
+        skip?: number;
+        take?: number;
+    }): Promise<APIResponse<AuditListResponse>>;
+}
+//# sourceMappingURL=audit.d.ts.map

package/dist/modules/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/modules/audit.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,WAAW;IACR,OAAO,CAAC,MAAM;IAAa,OAAO,CAAC,OAAO;gBAAlC,MAAM,EAAE,SAAS,EAAU,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAEpF;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAO3C;;OAEG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IAO/D;;OAEG;IACG,MAAM,CAAC,MAAM,CAAC,EAAE;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;CAM9C"}

package/dist/modules/audit.js

@@ -0,0 +1,38 @@
+/**
+ * Audit Module - Fully Typed
+ */
+export class AuditModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    /**
+     * List audit log entries.
+     */
+    async list(params) {
+        return this.client.GET("/v1/api/audit", {
+            params: { query: params },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get a specific audit log entry.
+     */
+    async get(auditId) {
+        return this.client.GET("/v1/api/audit/{id}", {
+            params: { path: { id: auditId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Search audit logs by action pattern.
+     */
+    async search(params) {
+        return this.client.GET("/v1/api/audit/search", {
+            params: { query: params },
+            headers: this.headers(),
+        });
+    }
+}

package/dist/modules/builder.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Builder Module - Meta-Agent for Agent Building
+ *
+ * Connects to the kernel's meta-agent for AI-assisted agent creation.
+ * Uses SSE streaming for real-time responses and graph updates.
+ */
+import { type SSEOptions } from "../sse/client.js";
+export type BuilderChatRequest = {
+    message: string;
+    current_graph_spec?: Record<string, unknown>;
+    thread_id?: string;
+};
+export type GraphUpdateAction = {
+    action: string;
+    node_name?: string;
+    node_type?: string;
+    properties?: Record<string, unknown>;
+    edge_from?: string;
+    edge_to?: string;
+};
+export type BuilderStreamEvent = {
+    type: "message";
+    data: {
+        text: string;
+    };
+} | {
+    type: "graph_update";
+    data: GraphUpdateAction;
+} | {
+    type: "done";
+    data: {
+        response: string;
+        actions: GraphUpdateAction[];
+        thread_id: string;
+    };
+} | {
+    type: "error";
+    data: {
+        error: string;
+    };
+};
+export type BuilderChatResponse = {
+    response: string;
+    actions: GraphUpdateAction[];
+    thread_id: string;
+};
+export declare class BuilderModule {
+    private kernelBaseUrl;
+    private headers;
+    constructor(kernelBaseUrl: string, headers: () => Record<string, string>);
+    /**
+     * Stream chat with meta-agent (SSE).
+     * Returns async generator of events.
+     */
+    chat(agentId: string, request: BuilderChatRequest, options?: SSEOptions): AsyncGenerator<BuilderStreamEvent>;
+    /**
+     * Sync chat with meta-agent (no streaming).
+     */
+    chatSync(agentId: string, request: BuilderChatRequest): Promise<BuilderChatResponse>;
+    /**
+     * Convenience method: chat and collect all events.
+     */
+    chatCollect(agentId: string, request: BuilderChatRequest): Promise<BuilderChatResponse>;
+}
+//# sourceMappingURL=builder.d.ts.map

package/dist/modules/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/modules/builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAA4B,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE7E,MAAM,MAAM,kBAAkB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GACxB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,iBAAiB,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC7F;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEjD,MAAM,MAAM,mBAAmB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,qBAAa,aAAa;IAElB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,OAAO;gBADP,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAGjD;;;OAGG;IACI,IAAI,CACP,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,UAAU,GACrB,cAAc,CAAC,kBAAkB,CAAC;IA8DrC;;OAEG;IACG,QAAQ,CACV,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;IAoB/B;;OAEG;IACG,WAAW,CACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;CAqBlC"}

package/dist/modules/builder.js

@@ -0,0 +1,119 @@
+/**
+ * Builder Module - Meta-Agent for Agent Building
+ *
+ * Connects to the kernel's meta-agent for AI-assisted agent creation.
+ * Uses SSE streaming for real-time responses and graph updates.
+ */
+import { streamSSE } from "../sse/client.js";
+export class BuilderModule {
+    kernelBaseUrl;
+    headers;
+    constructor(kernelBaseUrl, headers) {
+        this.kernelBaseUrl = kernelBaseUrl;
+        this.headers = headers;
+    }
+    /**
+     * Stream chat with meta-agent (SSE).
+     * Returns async generator of events.
+     */
+    async *chat(agentId, request, options) {
+        const url = `${this.kernelBaseUrl}/v1/internal/builder/${agentId}/chat`;
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Accept: "text/event-stream",
+                ...this.headers(),
+            },
+            body: JSON.stringify(request),
+            signal: options?.signal,
+        });
+        if (!response.ok) {
+            throw new Error(`Builder chat failed: ${response.status}`);
+        }
+        if (!response.body) {
+            throw new Error("No response body");
+        }
+        options?.onOpen?.();
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split("\n");
+                buffer = lines.pop() ?? "";
+                let eventType = "message";
+                let eventData = "";
+                for (const line of lines) {
+                    if (line.startsWith("event:")) {
+                        eventType = line.slice(6).trim();
+                    }
+                    else if (line.startsWith("data:")) {
+                        eventData = line.slice(5).trim();
+                    }
+                    else if (line === "" && eventData) {
+                        try {
+                            const parsed = JSON.parse(eventData);
+                            yield { type: eventType, data: parsed };
+                        }
+                        catch {
+                            // Skip invalid JSON
+                        }
+                        eventData = "";
+                        eventType = "message";
+                    }
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    /**
+     * Sync chat with meta-agent (no streaming).
+     */
+    async chatSync(agentId, request) {
+        const url = `${this.kernelBaseUrl}/v1/internal/builder/${agentId}/chat/sync`;
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                ...this.headers(),
+            },
+            body: JSON.stringify(request),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Builder chat failed: ${response.status} - ${error}`);
+        }
+        return response.json();
+    }
+    /**
+     * Convenience method: chat and collect all events.
+     */
+    async chatCollect(agentId, request) {
+        let fullResponse = "";
+        const allActions = [];
+        let threadId = request.thread_id ?? "";
+        for await (const event of this.chat(agentId, request)) {
+            if (event.type === "message") {
+                fullResponse += event.data.text;
+            }
+            else if (event.type === "graph_update") {
+                allActions.push(event.data);
+            }
+            else if (event.type === "done") {
+                threadId = event.data.thread_id;
+            }
+        }
+        return {
+            response: fullResponse,
+            actions: allActions,
+            thread_id: threadId,
+        };
+    }
+}

package/dist/modules/checkpoints.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Checkpoints Module - Fully Typed
+ */
+import type { RawClient, APIResponse } from "../client/raw.js";
+export interface Checkpoint {
+    id: string;
+    run_id: string;
+    thread_id: string;
+    step_name: string;
+    checkpoint_id: string;
+    parent_checkpoint_id?: string;
+    has_state_snapshot: boolean;
+    created_at: string;
+}
+export interface CheckpointNode {
+    id: string;
+    step_name: string;
+    checkpoint_id: string;
+    parent_checkpoint_id?: string;
+    created_at: string;
+    children?: CheckpointNode[];
+}
+export interface CheckpointsResponse {
+    run_id: string;
+    total_checkpoints: number;
+    checkpoints: CheckpointNode[];
+}
+export interface ReplayResponse {
+    run_id: string;
+    status: string;
+    replayed_from_checkpoint_id: string;
+}
+export declare class CheckpointsModule {
+    private client;
+    private headers;
+    constructor(client: RawClient, headers: () => Record<string, string>);
+    /**
+     * List checkpoints for a run.
+     */
+    list(runId: string): Promise<APIResponse<CheckpointsResponse>>;
+    /**
+     * Get a specific checkpoint.
+     */
+    get(checkpointId: string): Promise<APIResponse<Checkpoint>>;
+    /**
+     * Replay from a checkpoint.
+     */
+    replay(checkpointId: string, options?: {
+        mode?: "best_effort" | "deterministic";
+        modified_state?: unknown;
+    }): Promise<APIResponse<ReplayResponse>>;
+}
+//# sourceMappingURL=checkpoints.d.ts.map

package/dist/modules/checkpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoints.d.ts","sourceRoot":"","sources":["../../src/modules/checkpoints.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAc,MAAM,kBAAkB,CAAC;AAK3E,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,cAAc,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B,EAAE,MAAM,CAAC;CACvC;AAED,qBAAa,iBAAiB;IACd,OAAO,CAAC,MAAM;IAAa,OAAO,CAAC,OAAO;gBAAlC,MAAM,EAAE,SAAS,EAAU,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAEpF;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAOpE;;OAEG;IACG,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAOjE;;OAEG;IACG,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QACzC,IAAI,CAAC,EAAE,aAAa,GAAG,eAAe,CAAC;QACvC,cAAc,CAAC,EAAE,OAAO,CAAC;KAC5B,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;CAO3C"}