@compose-market/sdk 0.2.0 → 0.4.0

package/dist/resources/workflow.js

@@ -0,0 +1,321 @@
+/**
+ * Compose workflow runtime stream resource.
+ *
+ * Subscribes to POST /workflow/:wallet/chat on the Compose runtime and yields
+ * typed `WorkflowRuntimeEvent` values. The workflow orchestrator emits its
+ * own vocabulary (`start`, `step`, `agent`, `progress`, `tool_start`,
+ * `tool_end`, `result`, `error`, `complete`, `done`) via named SSE events;
+ * each frame carries a JSON payload with an optional `message` field.
+ *
+ * Same normalisation contract as `AgentResource`:
+ *   - Tool lifecycle fires on `sdk.events.toolCallStart` / `toolCallEnd`.
+ *   - Workflow-level start/end fires on `workflowStreamStart` / `workflowStreamEnd`.
+ *   - Budget / receipt / sessionInvalid come from response headers + streamed
+ *     `compose.receipt` frames.
+ */
+import { ComposeError } from "../errors.js";
+import { parseSSEStream } from "../streaming/sse.js";
+import { extractReceiptFromResponse, parseReceiptEvent } from "../streaming/receipt.js";
+import { extractSessionBudgetFromResponse } from "../streaming/budget.js";
+import { ComposeStreamIterator } from "./inference.js";
+export class WorkflowResource {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    stream(params, options = {}) {
+        return new ComposeStreamIterator(driveWorkflowStream(this.ctx, params, options));
+    }
+    /**
+     * Fire-and-forget stop signal for an in-flight workflow execution.
+     * Returns the raw Response so callers can inspect status.
+     */
+    async stop(workflowWallet, threadId, options = {}) {
+        const url = `${this.ctx.runtimeBaseUrl}/workflow/${encodeURIComponent(workflowWallet)}/stop`;
+        const wallet = this.ctx.getWalletMaybe();
+        const token = this.ctx.getTokenMaybe();
+        const headers = new Headers({
+            "Content-Type": "application/json",
+            "User-Agent": this.ctx.userAgent,
+        });
+        if (token)
+            headers.set("Authorization", `Bearer ${token}`);
+        if (wallet.address)
+            headers.set("x-session-user-address", wallet.address);
+        if (wallet.chainId !== null)
+            headers.set("x-chain-id", String(wallet.chainId));
+        return this.ctx.fetch(url, {
+            method: "POST",
+            headers,
+            body: JSON.stringify({ threadId }),
+            signal: options.signal,
+        });
+    }
+}
+async function* driveWorkflowStream(ctx, params, options) {
+    const url = `${ctx.runtimeBaseUrl}/workflow/${encodeURIComponent(params.workflowWallet)}/chat`;
+    const wallet = ctx.getWalletMaybe();
+    const token = ctx.getTokenMaybe();
+    const headers = new Headers({
+        "Content-Type": "application/json",
+        "User-Agent": ctx.userAgent,
+    });
+    if (token)
+        headers.set("Authorization", `Bearer ${token}`);
+    if (wallet.address)
+        headers.set("x-session-user-address", wallet.address);
+    if (wallet.chainId !== null)
+        headers.set("x-chain-id", String(wallet.chainId));
+    if (params.composeRunId)
+        headers.set("x-compose-run-id", params.composeRunId);
+    const body = {
+        message: params.message,
+        threadId: params.threadId,
+        userAddress: params.userAddress,
+    };
+    if (params.composeRunId)
+        body.composeRunId = params.composeRunId;
+    if (typeof params.lastEventIndex === "number")
+        body.lastEventIndex = params.lastEventIndex;
+    if (typeof params.continuous === "boolean")
+        body.continuous = params.continuous;
+    if (params.attachment)
+        body.attachment = params.attachment;
+    const timeoutController = new AbortController();
+    const timeoutMs = options.timeoutMs ?? 10 * 60 * 1000;
+    const timer = setTimeout(() => timeoutController.abort(), timeoutMs);
+    ctx.events.emit("workflowStreamStart", {
+        userAddress: wallet.address,
+        chainId: wallet.chainId,
+        requestId: null,
+        workflowWallet: params.workflowWallet,
+        threadId: params.threadId,
+        runId: params.composeRunId,
+    });
+    let response;
+    try {
+        response = await ctx.fetch(url, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(body),
+            signal: mergeSignals(options.signal, timeoutController.signal),
+        });
+    }
+    catch (fetchError) {
+        clearTimeout(timer);
+        throw new ComposeError({
+            code: "network_error",
+            message: fetchError instanceof Error ? fetchError.message : String(fetchError),
+        });
+    }
+    clearTimeout(timer);
+    if (!response.ok) {
+        const text = await response.text().catch(() => "");
+        throw new ComposeError({
+            code: "upstream_error",
+            message: `Workflow runtime returned ${response.status}: ${text.slice(0, 500)}`,
+            status: response.status,
+        });
+    }
+    if (!response.body) {
+        throw new ComposeError({ code: "upstream_error", message: "Workflow runtime stream had no body" });
+    }
+    const requestId = response.headers.get("x-request-id") ?? response.headers.get("X-Request-Id");
+    const headerReceipt = extractReceiptFromResponse(response);
+    const { budget, sessionInvalidReason } = extractSessionBudgetFromResponse(response);
+    if (headerReceipt) {
+        ctx.events.emit("receipt", {
+            userAddress: wallet.address,
+            chainId: wallet.chainId,
+            receipt: headerReceipt,
+            requestId,
+            source: "response-header",
+        });
+    }
+    if (budget) {
+        ctx.events.emit("budget", {
+            userAddress: wallet.address,
+            chainId: wallet.chainId,
+            snapshot: budget,
+            requestId,
+        });
+    }
+    if (sessionInvalidReason) {
+        ctx.events.emit("sessionInvalid", {
+            userAddress: wallet.address,
+            chainId: wallet.chainId,
+            reason: sessionInvalidReason,
+            requestId,
+        });
+    }
+    let text = "";
+    let structuredOutput = null;
+    let streamReceipt = null;
+    const toolCalls = [];
+    try {
+        for await (const frame of parseSSEStream(response.body, { signal: options.signal })) {
+            const data = frame.data.trim();
+            if (!data || data === "[DONE]") {
+                if (data === "[DONE]")
+                    yield { type: "done" };
+                continue;
+            }
+            if (frame.event === "compose.receipt") {
+                try {
+                    streamReceipt = parseReceiptEvent(frame.data);
+                    ctx.events.emit("receipt", {
+                        userAddress: wallet.address,
+                        chainId: wallet.chainId,
+                        receipt: streamReceipt,
+                        requestId,
+                        source: "stream",
+                    });
+                }
+                catch { /* skip malformed */ }
+                continue;
+            }
+            let payload;
+            try {
+                payload = JSON.parse(data);
+            }
+            catch {
+                continue;
+            }
+            const eventName = frame.event || "";
+            if (eventName === "start") {
+                yield { type: "start", message: asString(payload.message, "Starting workflow..."), meta: payload };
+                continue;
+            }
+            if (eventName === "step") {
+                yield {
+                    type: "step",
+                    stepName: typeof payload.stepName === "string" ? payload.stepName : undefined,
+                    message: asString(payload.message, `Processing ${asString(payload.stepName, "workflow step")}...`),
+                    meta: payload,
+                };
+                continue;
+            }
+            if (eventName === "agent") {
+                yield {
+                    type: "agent",
+                    agentName: typeof payload.agentName === "string" ? payload.agentName : undefined,
+                    message: asString(payload.message, `Processing ${asString(payload.agentName, "agent")}...`),
+                    meta: payload,
+                };
+                continue;
+            }
+            if (eventName === "progress") {
+                yield { type: "progress", message: asString(payload.message, "Running workflow..."), meta: payload };
+                continue;
+            }
+            if (eventName === "tool_start") {
+                const toolName = asString(payload.toolName, "tool");
+                const summary = typeof payload.content === "string"
+                    ? payload.content
+                    : typeof payload.message === "string" ? payload.message : undefined;
+                const content = typeof payload.content === "string" ? payload.content : undefined;
+                ctx.events.emit("toolCallStart", {
+                    userAddress: wallet.address,
+                    chainId: wallet.chainId,
+                    requestId,
+                    source: "workflow",
+                    toolCallId: toolName,
+                    toolName,
+                    summary,
+                });
+                yield { type: "tool-start", toolName, summary, content };
+                continue;
+            }
+            if (eventName === "tool_end") {
+                const toolName = asString(payload.toolName, "tool");
+                const summary = typeof payload.message === "string" ? payload.message : undefined;
+                const failed = typeof payload.error === "string" && payload.error.length > 0;
+                const error = failed ? payload.error : undefined;
+                toolCalls.push({ toolName, summary, failed, error });
+                ctx.events.emit("toolCallEnd", {
+                    userAddress: wallet.address,
+                    chainId: wallet.chainId,
+                    requestId,
+                    source: "workflow",
+                    toolCallId: toolName,
+                    toolName,
+                    summary,
+                    failed,
+                    error,
+                });
+                yield { type: "tool-end", toolName, summary, failed, error };
+                continue;
+            }
+            if (eventName === "result") {
+                const output = payload.output;
+                structuredOutput = output;
+                const coerced = typeof output === "string"
+                    ? output
+                    : typeof output === "object" && output !== null
+                        ? JSON.stringify(output)
+                        : "";
+                if (coerced)
+                    text = coerced;
+                yield { type: "result", output };
+                continue;
+            }
+            if (eventName === "error") {
+                const code = typeof payload.code === "string" ? payload.code : undefined;
+                const message = typeof payload.error === "string"
+                    ? payload.error
+                    : typeof payload.message === "string"
+                        ? payload.message
+                        : "Workflow stream error";
+                yield { type: "error", code, message };
+                continue;
+            }
+            if (eventName === "complete") {
+                yield { type: "complete", message: asString(payload.message, "Workflow complete!") };
+                continue;
+            }
+            if (eventName === "done") {
+                yield { type: "done" };
+                break;
+            }
+            // Unknown runtime frame — ignore rather than crash.
+        }
+    }
+    finally {
+        try {
+            response.body?.cancel();
+        }
+        catch { /* best-effort */ }
+        ctx.events.emit("workflowStreamEnd", {
+            userAddress: wallet.address,
+            chainId: wallet.chainId,
+            requestId,
+            workflowWallet: params.workflowWallet,
+            threadId: params.threadId,
+            runId: params.composeRunId,
+        });
+    }
+    return {
+        text,
+        structuredOutput,
+        toolCalls,
+        requestId,
+        receipt: streamReceipt ?? headerReceipt,
+        budget,
+        sessionInvalidReason,
+    };
+}
+function asString(value, fallback) {
+    return typeof value === "string" && value.length > 0 ? value : fallback;
+}
+function mergeSignals(a, b) {
+    if (!a)
+        return b;
+    const c = new AbortController();
+    const forward = () => c.abort();
+    if (a.aborted || b.aborted)
+        c.abort();
+    a.addEventListener("abort", forward, { once: true });
+    b.addEventListener("abort", forward, { once: true });
+    return c.signal;
+}
+//# sourceMappingURL=workflow.js.map

package/dist/resources/workflow.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Pluggable storage for persisting the Compose Key JWT across process
+ * restarts (browser reload, serverless cold start, etc).
+ *
+ * The SDK stays framework-agnostic by not importing any browser or Node
+ * storage API directly. Integrators pass a minimal adapter; the SDK
+ * auto-detects `globalThis.localStorage` when none is provided but runs in a
+ * browser, and falls back to an in-memory Map everywhere else.
+ *
+ * Storage is scoped per `(userAddress, chainId)` tuple so multiple wallets /
+ * chains on the same device never collide.
+ */
+export interface ComposeStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+export declare function resolveStorage(explicit: ComposeStorage | undefined): ComposeStorage | null;
+export declare function createMemoryStorage(): ComposeStorage;
+/**
+ * Build the scoped storage key for a persisted Compose Key token. The shape
+ * `compose.sdk.token:<lower-address>:<chainId>` mirrors the convention already
+ * in use by web/ so multiple SDK instances + the bare web app never collide.
+ */
+export declare function buildTokenStorageKey(tokenScope: string, userAddress: string, chainId: number): string;
+export declare const DEFAULT_TOKEN_SCOPE = "compose.sdk.token";
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,cAAc;IAC3B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,GAAG,cAAc,GAAG,IAAI,CAgB1F;AAED,wBAAgB,mBAAmB,IAAI,cAAc,CAOpD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAErG;AAED,eAAO,MAAM,mBAAmB,sBAAsB,CAAC"}

package/dist/storage.js

@@ -0,0 +1,46 @@
+/**
+ * Pluggable storage for persisting the Compose Key JWT across process
+ * restarts (browser reload, serverless cold start, etc).
+ *
+ * The SDK stays framework-agnostic by not importing any browser or Node
+ * storage API directly. Integrators pass a minimal adapter; the SDK
+ * auto-detects `globalThis.localStorage` when none is provided but runs in a
+ * browser, and falls back to an in-memory Map everywhere else.
+ *
+ * Storage is scoped per `(userAddress, chainId)` tuple so multiple wallets /
+ * chains on the same device never collide.
+ */
+export function resolveStorage(explicit) {
+    if (explicit)
+        return explicit;
+    // Browser / Deno / Cloudflare Workers with localStorage polyfills.
+    const candidate = globalThis.localStorage;
+    if (candidate && typeof candidate === "object") {
+        const ls = candidate;
+        if (typeof ls.getItem === "function" && typeof ls.setItem === "function" && typeof ls.removeItem === "function") {
+            return ls;
+        }
+    }
+    // Node / server runtimes without a persistent store: return null so the
+    // SDK falls back to in-memory only. Integrators who want cross-restart
+    // persistence in those environments pass an explicit adapter.
+    return null;
+}
+export function createMemoryStorage() {
+    const map = new Map();
+    return {
+        getItem: (key) => map.get(key) ?? null,
+        setItem: (key, value) => { map.set(key, value); },
+        removeItem: (key) => { map.delete(key); },
+    };
+}
+/**
+ * Build the scoped storage key for a persisted Compose Key token. The shape
+ * `compose.sdk.token:<lower-address>:<chainId>` mirrors the convention already
+ * in use by web/ so multiple SDK instances + the bare web app never collide.
+ */
+export function buildTokenStorageKey(tokenScope, userAddress, chainId) {
+    return `${tokenScope}:${userAddress.toLowerCase()}:${chainId}`;
+}
+export const DEFAULT_TOKEN_SCOPE = "compose.sdk.token";
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,MAAM,UAAU,cAAc,CAAC,QAAoC;IAC/D,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,mEAAmE;IACnE,MAAM,SAAS,GAAI,UAAyC,CAAC,YAAY,CAAC;IAC1E,IAAI,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC7C,MAAM,EAAE,GAAG,SAA2B,CAAC;QACvC,IAAI,OAAO,EAAE,CAAC,OAAO,KAAK,UAAU,IAAI,OAAO,EAAE,CAAC,OAAO,KAAK,UAAU,IAAI,OAAO,EAAE,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;YAC9G,OAAO,EAAE,CAAC;QACd,CAAC;IACL,CAAC;IAED,wEAAwE;IACxE,uEAAuE;IACvE,8DAA8D;IAC9D,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,mBAAmB;IAC/B,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,OAAO;QACH,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI;QACtC,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QACjD,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KAC5C,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAkB,EAAE,WAAmB,EAAE,OAAe;IACzF,OAAO,GAAG,UAAU,IAAI,WAAW,CAAC,WAAW,EAAE,IAAI,OAAO,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,CAAC"}

package/dist/streaming/budget.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Extract session-budget state from response headers.
+ *
+ * The api.compose.market gateway emits the live session-budget ledger on every
+ * billable response via these headers:
+ *   - `x-session-budget-limit`      total budget (wei, string)
+ *   - `x-session-budget-used`       spent (wei, string)
+ *   - `x-session-budget-locked`     reserved (wei, string)
+ *   - `x-session-budget-remaining`  remaining (wei, string)
+ *   - `x-compose-session-invalid`   truthy string when the session must be torn
+ *                                   down (e.g. "budget-depleted", "expired")
+ *
+ * This helper converts them into a typed object for the SDK event bus.
+ */
+import type { SessionBudgetSnapshot, SessionInvalidReason } from "../types/index.js";
+export declare function extractSessionBudgetFromResponse(response: {
+    headers: Headers;
+}): {
+    budget: SessionBudgetSnapshot | null;
+    sessionInvalidReason: SessionInvalidReason | null;
+};
+//# sourceMappingURL=budget.d.ts.map

package/dist/streaming/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/streaming/budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAErF,wBAAgB,gCAAgC,CAC5C,QAAQ,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAC/B;IAAE,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAAC,oBAAoB,EAAE,oBAAoB,GAAG,IAAI,CAAA;CAAE,CA2B7F"}

package/dist/streaming/budget.js

@@ -0,0 +1,40 @@
+/**
+ * Extract session-budget state from response headers.
+ *
+ * The api.compose.market gateway emits the live session-budget ledger on every
+ * billable response via these headers:
+ *   - `x-session-budget-limit`      total budget (wei, string)
+ *   - `x-session-budget-used`       spent (wei, string)
+ *   - `x-session-budget-locked`     reserved (wei, string)
+ *   - `x-session-budget-remaining`  remaining (wei, string)
+ *   - `x-compose-session-invalid`   truthy string when the session must be torn
+ *                                   down (e.g. "budget-depleted", "expired")
+ *
+ * This helper converts them into a typed object for the SDK event bus.
+ */
+export function extractSessionBudgetFromResponse(response) {
+    const limit = response.headers.get("x-session-budget-limit");
+    const used = response.headers.get("x-session-budget-used");
+    const locked = response.headers.get("x-session-budget-locked");
+    const remaining = response.headers.get("x-session-budget-remaining");
+    const invalidRaw = response.headers.get("x-compose-session-invalid");
+    const sessionInvalidReason = typeof invalidRaw === "string" && invalidRaw.length > 0
+        ? invalidRaw
+        : null;
+    // Emit the budget snapshot only when at least one numeric header is
+    // present. Any non-parseable value falls back to null so downstream
+    // consumers see `null` rather than NaN.
+    if (limit === null && used === null && locked === null && remaining === null) {
+        return { budget: null, sessionInvalidReason };
+    }
+    return {
+        budget: {
+            limitWei: limit ?? null,
+            usedWei: used ?? null,
+            lockedWei: locked ?? null,
+            remainingWei: remaining ?? null,
+        },
+        sessionInvalidReason,
+    };
+}
+//# sourceMappingURL=budget.js.map

package/dist/streaming/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/streaming/budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,MAAM,UAAU,gCAAgC,CAC5C,QAA8B;IAE9B,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAErE,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IACrE,MAAM,oBAAoB,GAAG,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;QAChF,CAAC,CAAE,UAAmC;QACtC,CAAC,CAAC,IAAI,CAAC;IAEX,oEAAoE;IACpE,oEAAoE;IACpE,wCAAwC;IACxC,IAAI,KAAK,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QAC3E,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;IAClD,CAAC;IAED,OAAO;QACH,MAAM,EAAE;YACJ,QAAQ,EAAE,KAAK,IAAI,IAAI;YACvB,OAAO,EAAE,IAAI,IAAI,IAAI;YACrB,SAAS,EAAE,MAAM,IAAI,IAAI;YACzB,YAAY,EAAE,SAAS,IAAI,IAAI;SAClC;QACD,oBAAoB;KACvB,CAAC;AACN,CAAC"}

package/dist/types/index.d.ts

@@ -133,6 +133,49 @@ export interface ActiveSessionMetadata {
         };
     };
 }
+/**
+ * Live session-budget snapshot parsed from `x-session-budget-*` response
+ * headers. Every billable response carries these; the SDK surfaces them as
+ * part of `ComposeCompletion<T>` and as a typed `budget` event on the event
+ * bus so UIs can update the session indicator without polling `/api/session`.
+ */
+export interface SessionBudgetSnapshot {
+    limitWei: string | null;
+    usedWei: string | null;
+    lockedWei: string | null;
+    remainingWei: string | null;
+}
+export type SessionInvalidReason = "budget-depleted" | "expired" | "revoked" | "chain-mismatch" | (string & {
+    readonly __brand?: "SessionInvalidReason";
+});
+/**
+ * SSE-frame payload for `/api/session/events`. The server emits two named
+ * events: `session-active` (live ledger heartbeat while the session is
+ * healthy) and `session-expired` (terminal notification when the session has
+ * been revoked, expired, or run out of budget).
+ */
+export interface SessionActiveEvent {
+    type: "session-active";
+    userAddress: string;
+    chainId: number;
+    expiresAt?: number;
+    budgetLimit?: string;
+    budgetUsed?: string;
+    budgetLocked?: string;
+    budgetRemaining?: string;
+    timestamp?: number;
+}
+export interface SessionExpiredEvent {
+    type: "session-expired";
+    userAddress: string;
+    chainId: number;
+    reason?: SessionInvalidReason;
+    message?: string;
+    action?: string;
+    expiresAt?: number;
+    timestamp?: number;
+}
+export type SessionEvent = SessionActiveEvent | SessionExpiredEvent;
 export interface ComposeReceiptLineItem {
     key: string;
     unit: string;
@@ -494,4 +537,126 @@ export type VideoStatusStreamEvent = {
 } | {
     type: "done";
 };
+/**
+ * Events emitted by the Compose agent runtime on /agent/:wallet/stream.
+ * Mirrors the runtime's native SSE vocabulary — no translation, no renaming.
+ */
+export type AgentRuntimeEvent = {
+    type: "text-delta";
+    delta: string;
+} | {
+    type: "thinking-start";
+    message: string;
+} | {
+    type: "thinking-end";
+} | {
+    type: "tool-start";
+    toolName: string;
+    summary?: string;
+    content?: string;
+} | {
+    type: "tool-end";
+    toolName: string;
+    summary?: string;
+    failed: boolean;
+    error?: string;
+} | {
+    type: "error";
+    code?: string;
+    message: string;
+    details?: Record<string, unknown>;
+} | {
+    type: "done";
+};
+export interface AgentStreamCreateParams {
+    agentWallet: string;
+    message: string;
+    threadId: string;
+    userAddress: string;
+    cloudPermissions?: Record<string, unknown>;
+    composeRunId?: string;
+    attachment?: unknown;
+}
+export interface AgentStreamFinalResult {
+    text: string;
+    toolCalls: Array<{
+        toolName: string;
+        summary?: string;
+        failed: boolean;
+        error?: string;
+    }>;
+    requestId: string | null;
+    receipt: ComposeReceipt | null;
+    budget: SessionBudgetSnapshot | null;
+    sessionInvalidReason: SessionInvalidReason | null;
+}
+/**
+ * Events emitted by the Compose workflow runtime on /workflow/:wallet/chat.
+ */
+export type WorkflowRuntimeEvent = {
+    type: "start";
+    message: string;
+    meta?: Record<string, unknown>;
+} | {
+    type: "step";
+    stepName?: string;
+    message: string;
+    meta?: Record<string, unknown>;
+} | {
+    type: "agent";
+    agentName?: string;
+    message: string;
+    meta?: Record<string, unknown>;
+} | {
+    type: "progress";
+    message: string;
+    meta?: Record<string, unknown>;
+} | {
+    type: "tool-start";
+    toolName: string;
+    summary?: string;
+    content?: string;
+} | {
+    type: "tool-end";
+    toolName: string;
+    summary?: string;
+    failed: boolean;
+    error?: string;
+} | {
+    type: "result";
+    output: unknown;
+} | {
+    type: "complete";
+    message: string;
+} | {
+    type: "error";
+    code?: string;
+    message: string;
+} | {
+    type: "done";
+};
+export interface WorkflowStreamCreateParams {
+    workflowWallet: string;
+    message: string;
+    threadId: string;
+    userAddress: string;
+    composeRunId?: string;
+    continuous?: boolean;
+    lastEventIndex?: number;
+    attachment?: unknown;
+}
+export interface WorkflowStreamFinalResult {
+    text: string;
+    structuredOutput: unknown;
+    toolCalls: Array<{
+        toolName: string;
+        summary?: string;
+        failed: boolean;
+        error?: string;
+    }>;
+    requestId: string | null;
+    receipt: ComposeReceipt | null;
+    budget: SessionBudgetSnapshot | null;
+    sessionInvalidReason: SessionInvalidReason | null;
+}
 //# sourceMappingURL=index.d.ts.map