@agent-os-sdk/client 0.7.8 → 0.7.10

package/dist/modules/builder.d.ts

@@ -133,6 +133,74 @@ export type BuilderChatResponse = {
     thread_id: string;
     hints: HintModel[];
 };
+/** Supported patch operation types */
+export type OpType = "add_node" | "remove_node" | "update_node" | "add_edge" | "remove_edge" | "set_entrypoint" | "rename_node";
+/** A single graph modification operation */
+export type PatchOp = {
+    op: OpType;
+    node_id?: string;
+    kind?: string;
+    label?: string;
+    data?: Record<string, unknown>;
+    set?: Record<string, unknown>;
+    source?: string;
+    target?: string;
+    from?: string;
+    to?: string;
+    entrypoint?: string;
+};
+/** A collection of patch operations with deterministic ID */
+export type GraphPatch = {
+    patch_id: string;
+    ops: PatchOp[];
+    description?: string;
+};
+/** Validation error from applying patch */
+export type PatchValidationError = {
+    code: string;
+    message: string;
+    node_id?: string;
+    path?: string;
+};
+/** Meta-chat request */
+export type MetaChatRequest = {
+    instruction: string;
+};
+/** Meta-chat stream events */
+export type MetaChatStreamEvent = {
+    type: "assistant.delta";
+    data: {
+        text: string;
+    };
+} | {
+    type: "patch.validation";
+    data: {
+        valid: boolean;
+        errors: PatchValidationError[];
+    };
+} | {
+    type: "patch.proposed";
+    data: GraphPatch;
+} | {
+    type: "final";
+    data: {
+        ok: boolean;
+        patch_id: string;
+    };
+} | {
+    type: "error";
+    data: {
+        error: string;
+    };
+};
+/** Meta-chat sync response */
+export type MetaChatResponse = {
+    patch: GraphPatch | null;
+    applied_spec: Record<string, unknown> | null;
+    valid: boolean;
+    errors: PatchValidationError[];
+    message: string;
+};
 export declare class BuilderModule {
     private client;
     constructor(client: RawClient);
@@ -153,5 +221,26 @@ export declare class BuilderModule {
      * Convenience method: chat and collect all events.
      */
     chatCollect(agentId: string, request: BuilderChatRequest): Promise<BuilderChatResponse>;
+    /**
+     * Stream meta-chat with patch-ops architecture (SSE).
+     * Returns GraphPatch proposals instead of full graph specs.
+     *
+     * @example
+     * ```ts
+     * for await (const event of client.builder.metaChat(agentId, {
+     *   instruction: "Add a log node after the main agent"
+     * })) {
+     *   if (event.type === 'patch.proposed') {
+     *     const patch = event.data;
+     *     console.log(`Proposed ${patch.ops.length} operations`);
+     *   }
+     * }
+     * ```
+     */
+    metaChat(agentId: string, request: MetaChatRequest, options?: SSEOptions): AsyncGenerator<MetaChatStreamEvent>;
+    /**
+     * Meta-chat and collect the proposed patch.
+     */
+    metaChatCollect(agentId: string, request: MetaChatRequest): Promise<MetaChatResponse>;
 }
 //# sourceMappingURL=builder.d.ts.map

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

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

package/dist/modules/builder.js

@@ -146,4 +146,103 @@ export class BuilderModule {
             thread_id: threadId,
         };
     }
+    // ============================================
+    // META-CHAT V2 (PATCH-OPS ARCHITECTURE)
+    // ============================================
+    /**
+     * Stream meta-chat with patch-ops architecture (SSE).
+     * Returns GraphPatch proposals instead of full graph specs.
+     *
+     * @example
+     * ```ts
+     * for await (const event of client.builder.metaChat(agentId, {
+     *   instruction: "Add a log node after the main agent"
+     * })) {
+     *   if (event.type === 'patch.proposed') {
+     *     const patch = event.data;
+     *     console.log(`Proposed ${patch.ops.length} operations`);
+     *   }
+     * }
+     * ```
+     */
+    async *metaChat(agentId, request, options) {
+        const response = await this.client.streamPost("/v1/builder/{agentId}/meta-chat", {
+            params: { path: { agentId } },
+            body: request,
+            signal: options?.signal,
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Meta-chat failed: ${response.status} - ${errorText}`);
+        }
+        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();
+        }
+    }
+    /**
+     * Meta-chat and collect the proposed patch.
+     */
+    async metaChatCollect(agentId, request) {
+        let patch = null;
+        let isValid = true;
+        const errors = [];
+        let message = "";
+        for await (const event of this.metaChat(agentId, request)) {
+            if (event.type === "assistant.delta") {
+                message += event.data.text;
+            }
+            else if (event.type === "patch.proposed") {
+                patch = event.data;
+            }
+            else if (event.type === "patch.validation") {
+                isValid = event.data.valid;
+                errors.push(...event.data.errors);
+            }
+        }
+        return {
+            patch,
+            applied_spec: null, // Frontend should apply patch locally
+            valid: isValid,
+            errors,
+            message,
+        };
+    }
 }

package/dist/modules/checkpoints.d.ts

@@ -36,18 +36,27 @@ export declare class CheckpointsModule {
     constructor(client: RawClient, headers: () => Record<string, string>);
     /**
      * List checkpoints for a run.
+     * @param workspaceId - Workspace ID
+     * @param runId - Run ID
      */
-    list(runId: string): Promise<APIResponse<CheckpointsResponse>>;
+    list(workspaceId: string, runId: string): Promise<APIResponse<CheckpointsResponse>>;
     /**
      * Get a specific checkpoint.
+     * @param workspaceId - Workspace ID
+     * @param runId - Run ID
+     * @param checkpointId - Checkpoint ID
      */
-    get(checkpointId: string): Promise<APIResponse<Checkpoint>>;
+    get(workspaceId: string, runId: string, checkpointId: string): Promise<APIResponse<Checkpoint>>;
     /**
      * Replay from a checkpoint.
+     * @param workspaceId - Workspace ID
+     * @param runId - Run ID
+     * @param checkpointId - Checkpoint ID
+     * @param options - Replay options
      */
-    replay(checkpointId: string, options?: {
-        mode?: "best_effort" | "strict";
-        modified_state?: unknown;
+    replay(workspaceId: string, runId: string, checkpointId: string, options?: {
+        create_new_thread?: boolean;
+        modified_input?: string;
     }): Promise<APIResponse<ReplayResponse>>;
 }
 //# sourceMappingURL=checkpoints.d.ts.map

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

@@ -1 +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,QAAQ,CAAC;QAChC,cAAc,CAAC,EAAE,OAAO,CAAC;KAC5B,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;CAO3C"}
+{"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;;;;OAIG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAOzF;;;;;OAKG;IACG,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAOrG;;;;;;OAMG;IACG,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAC7E,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;CAO3C"}

package/dist/modules/checkpoints.js

@@ -10,28 +10,37 @@ export class CheckpointsModule {
     }
     /**
      * List checkpoints for a run.
+     * @param workspaceId - Workspace ID
+     * @param runId - Run ID
      */
-    async list(runId) {
-        return this.client.GET("/v1/api/runs/{runId}/checkpoints", {
-            params: { path: { runId } },
+    async list(workspaceId, runId) {
+        return this.client.GET("/v1/api/workspaces/{workspaceId}/runs/{runId}/checkpoints", {
+            params: { path: { workspaceId, runId } },
             headers: this.headers(),
         });
     }
     /**
      * Get a specific checkpoint.
+     * @param workspaceId - Workspace ID
+     * @param runId - Run ID
+     * @param checkpointId - Checkpoint ID
      */
-    async get(checkpointId) {
-        return this.client.GET("/v1/api/checkpoints/{id}", {
-            params: { path: { id: checkpointId } },
+    async get(workspaceId, runId, checkpointId) {
+        return this.client.GET("/v1/api/workspaces/{workspaceId}/runs/{runId}/checkpoints/{checkpointId}", {
+            params: { path: { workspaceId, runId, checkpointId } },
             headers: this.headers(),
         });
     }
     /**
      * Replay from a checkpoint.
+     * @param workspaceId - Workspace ID
+     * @param runId - Run ID
+     * @param checkpointId - Checkpoint ID
+     * @param options - Replay options
      */
-    async replay(checkpointId, options) {
-        return this.client.POST("/v1/api/checkpoints/{id}/replay", {
-            params: { path: { id: checkpointId } },
+    async replay(workspaceId, runId, checkpointId, options) {
+        return this.client.POST("/v1/api/workspaces/{workspaceId}/runs/{runId}/checkpoints/{checkpointId}/replay", {
+            params: { path: { workspaceId, runId, checkpointId } },
             body: options ?? {},
             headers: this.headers(),
         });

package/dist/modules/triggers.d.ts

@@ -55,6 +55,27 @@ export interface TriggerListResponse {
     items: Trigger[];
     total: number;
 }
+export interface TriggerInputContractResponse {
+    trigger_id: string;
+    template_slug?: string;
+    external_body_schema?: unknown;
+    run_input_schema?: unknown;
+    effective_input_mapping_spec?: unknown;
+    example_payload?: unknown;
+    has_input_mapping: boolean;
+}
+export interface MappingValidationError {
+    code: string;
+    path?: string;
+    message: string;
+}
+export interface TestMappingResponse {
+    original_payload: unknown;
+    transformed_graph_input: unknown;
+    mapping_configured: boolean;
+    mapping_executed: boolean;
+    validation_errors?: MappingValidationError[];
+}
 export declare class TriggersModule {
     private client;
     private headers;
@@ -109,7 +130,21 @@ export declare class TriggersModule {
      * Avoids client-side secret exposure - server signs the request.
      * @param triggerId - The trigger to test
      * @param payload - Optional JSON payload (wrapped in { payload: ... } per backend contract)
+     * @param threadKey - Optional thread key for conversation context
+     * @param idempotencyKey - Optional idempotency key for deduplication
+     */
+    test(triggerId: string, payload?: unknown, threadKey?: string, idempotencyKey?: string): Promise<APIResponse<TestTriggerResponse>>;
+    /**
+     * Get the full input contract for a trigger.
+     * Returns schemas and mapping spec for transformation configuration.
+     */
+    getContract(triggerId: string): Promise<APIResponse<TriggerInputContractResponse>>;
+    /**
+     * Test input mapping transformation without executing a run.
+     * Preview how a payload will be transformed before execution.
+     * @param triggerId - The trigger to test mapping for
+     * @param samplePayload - Sample payload to transform
      */
-    test(triggerId: string, payload?: unknown): Promise<APIResponse<TestTriggerResponse>>;
+    testMapping(triggerId: string, samplePayload: unknown): Promise<APIResponse<TestMappingResponse>>;
 }
 //# sourceMappingURL=triggers.d.ts.map

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

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

package/dist/modules/triggers.js

@@ -82,11 +82,40 @@ export class TriggersModule {
      * Avoids client-side secret exposure - server signs the request.
      * @param triggerId - The trigger to test
      * @param payload - Optional JSON payload (wrapped in { payload: ... } per backend contract)
+     * @param threadKey - Optional thread key for conversation context
+     * @param idempotencyKey - Optional idempotency key for deduplication
      */
-    async test(triggerId, payload) {
+    async test(triggerId, payload, threadKey, idempotencyKey) {
         return this.client.POST("/v1/api/triggers/{id}/test", {
             params: { path: { id: triggerId } },
-            body: payload !== undefined ? { payload } : undefined,
+            body: {
+                payload: payload ?? undefined,
+                thread_key: threadKey ?? undefined,
+                idempotency_key: idempotencyKey ?? undefined,
+            },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get the full input contract for a trigger.
+     * Returns schemas and mapping spec for transformation configuration.
+     */
+    async getContract(triggerId) {
+        return this.client.GET("/v1/api/triggers/{id}/contract", {
+            params: { path: { id: triggerId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Test input mapping transformation without executing a run.
+     * Preview how a payload will be transformed before execution.
+     * @param triggerId - The trigger to test mapping for
+     * @param samplePayload - Sample payload to transform
+     */
+    async testMapping(triggerId, samplePayload) {
+        return this.client.POST("/v1/api/triggers/{id}/test-mapping", {
+            params: { path: { id: triggerId } },
+            body: { sample_payload: samplePayload },
             headers: this.headers(),
         });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@agent-os-sdk/client",
-    "version": "0.7.8",
+    "version": "0.7.10",
     "description": "Official TypeScript SDK for Agent OS platform",
     "type": "module",
     "main": "./dist/index.js",
@@ -49,4 +49,4 @@
         "dist",
         "src"
     ]
-}
+}

package/src/modules/builder.ts

@@ -144,6 +144,73 @@ export type BuilderChatResponse = {
     hints: HintModel[];
 };
 
+// ============================================
+// PATCH-OPS ARCHITECTURE (Meta-Agent V2)
+// ============================================
+
+/** Supported patch operation types */
+export type OpType =
+    | "add_node"
+    | "remove_node"
+    | "update_node"
+    | "add_edge"
+    | "remove_edge"
+    | "set_entrypoint"
+    | "rename_node";
+
+/** A single graph modification operation */
+export type PatchOp = {
+    op: OpType;
+    node_id?: string;
+    kind?: string;
+    label?: string;
+    data?: Record<string, unknown>;
+    set?: Record<string, unknown>;
+    source?: string;
+    target?: string;
+    from?: string;
+    to?: string;
+    entrypoint?: string;
+};
+
+/** A collection of patch operations with deterministic ID */
+export type GraphPatch = {
+    patch_id: string;
+    ops: PatchOp[];
+    description?: string;
+};
+
+/** Validation error from applying patch */
+export type PatchValidationError = {
+    code: string;
+    message: string;
+    node_id?: string;
+    path?: string;
+};
+
+/** Meta-chat request */
+export type MetaChatRequest = {
+    instruction: string;
+};
+
+/** Meta-chat stream events */
+export type MetaChatStreamEvent =
+    | { type: "assistant.delta"; data: { text: string } }
+    | { type: "patch.validation"; data: { valid: boolean; errors: PatchValidationError[] } }
+    | { type: "patch.proposed"; data: GraphPatch }
+    | { type: "final"; data: { ok: boolean; patch_id: string } }
+    | { type: "error"; data: { error: string } };
+
+/** Meta-chat sync response */
+export type MetaChatResponse = {
+    patch: GraphPatch | null;
+    applied_spec: Record<string, unknown> | null;
+    valid: boolean;
+    errors: PatchValidationError[];
+    message: string;
+};
+
+
 export class BuilderModule {
     constructor(private client: RawClient) { }
 
@@ -281,4 +348,116 @@ export class BuilderModule {
             thread_id: threadId,
         };
     }
+
+    // ============================================
+    // META-CHAT V2 (PATCH-OPS ARCHITECTURE)
+    // ============================================
+
+    /**
+     * Stream meta-chat with patch-ops architecture (SSE).
+     * Returns GraphPatch proposals instead of full graph specs.
+     * 
+     * @example
+     * ```ts
+     * for await (const event of client.builder.metaChat(agentId, {
+     *   instruction: "Add a log node after the main agent"
+     * })) {
+     *   if (event.type === 'patch.proposed') {
+     *     const patch = event.data;
+     *     console.log(`Proposed ${patch.ops.length} operations`);
+     *   }
+     * }
+     * ```
+     */
+    async *metaChat(
+        agentId: string,
+        request: MetaChatRequest,
+        options?: SSEOptions
+    ): AsyncGenerator<MetaChatStreamEvent> {
+        const response = await this.client.streamPost("/v1/builder/{agentId}/meta-chat", {
+            params: { path: { agentId } },
+            body: request,
+            signal: options?.signal,
+        });
+
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Meta-chat failed: ${response.status} - ${errorText}`);
+        }
+
+        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 } as MetaChatStreamEvent;
+                        } catch {
+                            // Skip invalid JSON
+                        }
+                        eventData = "";
+                        eventType = "message";
+                    }
+                }
+            }
+        } finally {
+            reader.releaseLock();
+        }
+    }
+
+    /**
+     * Meta-chat and collect the proposed patch.
+     */
+    async metaChatCollect(
+        agentId: string,
+        request: MetaChatRequest
+    ): Promise<MetaChatResponse> {
+        let patch: GraphPatch | null = null;
+        let isValid = true;
+        const errors: PatchValidationError[] = [];
+        let message = "";
+
+        for await (const event of this.metaChat(agentId, request)) {
+            if (event.type === "assistant.delta") {
+                message += event.data.text;
+            } else if (event.type === "patch.proposed") {
+                patch = event.data;
+            } else if (event.type === "patch.validation") {
+                isValid = event.data.valid;
+                errors.push(...event.data.errors);
+            }
+        }
+
+        return {
+            patch,
+            applied_spec: null,  // Frontend should apply patch locally
+            valid: isValid,
+            errors,
+            message,
+        };
+    }
 }

package/src/modules/checkpoints.ts

@@ -44,33 +44,42 @@ export class CheckpointsModule {
 
     /**
      * List checkpoints for a run.
+     * @param workspaceId - Workspace ID
+     * @param runId - Run ID
      */
-    async list(runId: string): Promise<APIResponse<CheckpointsResponse>> {
-        return this.client.GET<CheckpointsResponse>("/v1/api/runs/{runId}/checkpoints", {
-            params: { path: { runId } },
+    async list(workspaceId: string, runId: string): Promise<APIResponse<CheckpointsResponse>> {
+        return this.client.GET<CheckpointsResponse>("/v1/api/workspaces/{workspaceId}/runs/{runId}/checkpoints", {
+            params: { path: { workspaceId, runId } },
             headers: this.headers(),
         });
     }
 
     /**
      * Get a specific checkpoint.
+     * @param workspaceId - Workspace ID
+     * @param runId - Run ID
+     * @param checkpointId - Checkpoint ID
      */
-    async get(checkpointId: string): Promise<APIResponse<Checkpoint>> {
-        return this.client.GET<Checkpoint>("/v1/api/checkpoints/{id}", {
-            params: { path: { id: checkpointId } },
+    async get(workspaceId: string, runId: string, checkpointId: string): Promise<APIResponse<Checkpoint>> {
+        return this.client.GET<Checkpoint>("/v1/api/workspaces/{workspaceId}/runs/{runId}/checkpoints/{checkpointId}", {
+            params: { path: { workspaceId, runId, checkpointId } },
             headers: this.headers(),
         });
     }
 
     /**
      * Replay from a checkpoint.
+     * @param workspaceId - Workspace ID
+     * @param runId - Run ID
+     * @param checkpointId - Checkpoint ID
+     * @param options - Replay options
      */
-    async replay(checkpointId: string, options?: {
-        mode?: "best_effort" | "strict";
-        modified_state?: unknown;
+    async replay(workspaceId: string, runId: string, checkpointId: string, options?: {
+        create_new_thread?: boolean;
+        modified_input?: string;
     }): Promise<APIResponse<ReplayResponse>> {
-        return this.client.POST<ReplayResponse>("/v1/api/checkpoints/{id}/replay", {
-            params: { path: { id: checkpointId } },
+        return this.client.POST<ReplayResponse>("/v1/api/workspaces/{workspaceId}/runs/{runId}/checkpoints/{checkpointId}/replay", {
+            params: { path: { workspaceId, runId, checkpointId } },
             body: options ?? {},
             headers: this.headers(),
         });

package/src/modules/triggers.ts

@@ -68,6 +68,34 @@ export interface TriggerListResponse {
     total: number;
 }
 
+// =============================================================================
+// Input Mapping Types (Wave 2)
+// =============================================================================
+
+export interface TriggerInputContractResponse {
+    trigger_id: string;
+    template_slug?: string;
+    external_body_schema?: unknown;
+    run_input_schema?: unknown;
+    effective_input_mapping_spec?: unknown;
+    example_payload?: unknown;
+    has_input_mapping: boolean;
+}
+
+export interface MappingValidationError {
+    code: string;
+    path?: string;
+    message: string;
+}
+
+export interface TestMappingResponse {
+    original_payload: unknown;
+    transformed_graph_input: unknown;
+    mapping_configured: boolean;
+    mapping_executed: boolean;
+    validation_errors?: MappingValidationError[];
+}
+
 // =============================================================================
 // Module
 // =============================================================================
@@ -165,12 +193,44 @@ export class TriggersModule {
      * Avoids client-side secret exposure - server signs the request.
      * @param triggerId - The trigger to test
      * @param payload - Optional JSON payload (wrapped in { payload: ... } per backend contract)
+     * @param threadKey - Optional thread key for conversation context
+     * @param idempotencyKey - Optional idempotency key for deduplication
      */
-    async test(triggerId: string, payload?: unknown): Promise<APIResponse<TestTriggerResponse>> {
+    async test(triggerId: string, payload?: unknown, threadKey?: string, idempotencyKey?: string): Promise<APIResponse<TestTriggerResponse>> {
         return this.client.POST<TestTriggerResponse>("/v1/api/triggers/{id}/test", {
             params: { path: { id: triggerId } },
-            body: payload !== undefined ? { payload } : undefined,
+            body: {
+                payload: payload ?? undefined,
+                thread_key: threadKey ?? undefined,
+                idempotency_key: idempotencyKey ?? undefined,
+            },
+            headers: this.headers(),
+        });
+    }
+
+    /**
+     * Get the full input contract for a trigger.
+     * Returns schemas and mapping spec for transformation configuration.
+     */
+    async getContract(triggerId: string): Promise<APIResponse<TriggerInputContractResponse>> {
+        return this.client.GET<TriggerInputContractResponse>("/v1/api/triggers/{id}/contract", {
+            params: { path: { id: triggerId } },
+            headers: this.headers(),
+        });
+    }
+
+    /**
+     * Test input mapping transformation without executing a run.
+     * Preview how a payload will be transformed before execution.
+     * @param triggerId - The trigger to test mapping for
+     * @param samplePayload - Sample payload to transform
+     */
+    async testMapping(triggerId: string, samplePayload: unknown): Promise<APIResponse<TestMappingResponse>> {
+        return this.client.POST<TestMappingResponse>("/v1/api/triggers/{id}/test-mapping", {
+            params: { path: { id: triggerId } },
+            body: { sample_payload: samplePayload },
             headers: this.headers(),
         });
     }
 }
+