@compose-market/sdk 0.8.2 → 0.8.5

package/dist/resources/accounts.js

@@ -0,0 +1,128 @@
+import { BadRequestError } from "../errors.js";
+function user(input, fallback) {
+    const resolved = input.userAddress ?? fallback;
+    if (!resolved) {
+        throw new BadRequestError({ message: "userAddress is required. Attach a wallet or pass userAddress." });
+    }
+    return resolved;
+}
+function agent(input) {
+    if (!input.agentWallet) {
+        throw new BadRequestError({ message: "agentWallet is required." });
+    }
+    return input.agentWallet;
+}
+function account(input) {
+    if (!input.connectedAccountId) {
+        throw new BadRequestError({ message: "connectedAccountId is required." });
+    }
+    return input.connectedAccountId;
+}
+function headers(ctx, userAddress) {
+    const wallet = ctx.getWalletMaybe();
+    return {
+        key: ctx.getTokenMaybe() ?? undefined,
+        userAddress: userAddress ?? wallet.address ?? undefined,
+        chainId: wallet.chainId ?? undefined,
+    };
+}
+export class AccountToolkitsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    list(input = {}, options = {}) {
+        return this.client.request({
+            method: "GET",
+            path: "/accounts/toolkits",
+            query: { search: input.search, limit: input.limit },
+            signal: options.signal,
+            timeoutMs: options.timeoutMs,
+        });
+    }
+    actions(toolkit, input = {}, options = {}) {
+        return this.client.request({
+            method: "GET",
+            path: `/accounts/toolkits/${encodeURIComponent(toolkit)}/actions`,
+            query: { limit: input.limit },
+            signal: options.signal,
+            timeoutMs: options.timeoutMs,
+        });
+    }
+}
+export class AccountsResource {
+    client;
+    ctx;
+    toolkits;
+    constructor(client, ctx) {
+        this.client = client;
+        this.ctx = ctx;
+        this.toolkits = new AccountToolkitsResource(client);
+    }
+    connect(input, options = {}) {
+        const userAddress = user(input, this.ctx.getWalletMaybe().address);
+        const agentWallet = agent(input);
+        return this.client.request({
+            method: "POST",
+            path: "/accounts/connect",
+            body: { ...input, userAddress, agentWallet },
+            headers: headers(this.ctx, userAddress),
+            signal: options.signal,
+            timeoutMs: options.timeoutMs,
+        });
+    }
+    list(input, options = {}) {
+        const userAddress = user(input, this.ctx.getWalletMaybe().address);
+        const agentWallet = agent(input);
+        return this.client.request({
+            method: "GET",
+            path: "/accounts",
+            query: { userAddress, agentWallet, toolkit: input.toolkit },
+            headers: headers(this.ctx, userAddress),
+            signal: options.signal,
+            timeoutMs: options.timeoutMs,
+        });
+    }
+    status(input, options = {}) {
+        const userAddress = user(input, this.ctx.getWalletMaybe().address);
+        const agentWallet = agent(input);
+        const connectedAccountId = account(input);
+        return this.client.request({
+            method: "GET",
+            path: "/accounts/status",
+            query: { userAddress, agentWallet, toolkit: input.toolkit, connectedAccountId },
+            headers: headers(this.ctx, userAddress),
+            signal: options.signal,
+            timeoutMs: options.timeoutMs,
+        });
+    }
+    execute(input, options = {}) {
+        const userAddress = user(input, this.ctx.getWalletMaybe().address);
+        const agentWallet = agent(input);
+        const connectedAccountId = account(input);
+        return this.client.request({
+            method: "POST",
+            path: "/accounts/execute",
+            body: { ...input, userAddress, agentWallet, connectedAccountId },
+            headers: headers(this.ctx, userAddress),
+            signal: options.signal,
+            timeoutMs: options.timeoutMs,
+            doNotRetry: true,
+        });
+    }
+    disconnect(input, options = {}) {
+        const userAddress = user(input, this.ctx.getWalletMaybe().address);
+        const agentWallet = agent(input);
+        const connectedAccountId = account(input);
+        return this.client.request({
+            method: "DELETE",
+            path: "/accounts",
+            body: { ...input, userAddress, agentWallet, connectedAccountId },
+            headers: headers(this.ctx, userAddress),
+            signal: options.signal,
+            timeoutMs: options.timeoutMs,
+            doNotRetry: true,
+        });
+    }
+}
+//# sourceMappingURL=accounts.js.map

package/dist/resources/accounts.js.map

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

package/dist/resources/agent.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Compose agent runtime stream resource.
+ *
+ * SDK responsibilities ONLY:
+ *   - HTTP request with payment/auth/abort
+ *   - Response header extraction (budget, receipt, session)
+ *   - EventBus emission (toolCallStart/End, childAgent*, planProposed, etc.)
+ *   - Text accumulation for final result
+ *   - Stream lifecycle (agentStreamStart/End)
+ *
+ * All SSE protocol, decoding, and event type routing is delegated to
+ * @compose-market/core/sse/stream — the single source of truth.
+ */
+import type { HttpClient } from "@compose-market/core/http";
+import { type RunEvent } from "@compose-market/core/sse/stream";
+import type { EventBus } from "../events.js";
+import type { AgentDecisionInput, AgentDecisionResult, AgentStreamCreateParams, AgentStreamFinalResult, SessionBudgetSnapshot, SessionInvalidReason, X402PaymentSigner } from "../types/index.js";
+import { type CallOptions, StreamIterator } from "./inference.js";
+export type { RunEvent } from "@compose-market/core/sse/stream";
+export interface AgentResourceContext {
+    baseUrl: string;
+    http: HttpClient;
+    getWalletMaybe: () => {
+        address: string | null;
+        chainId: number | null;
+    };
+    getTokenMaybe: () => string | null;
+    getX402SignerMaybe?: () => X402PaymentSigner | null;
+    events: EventBus;
+    userAgent: string;
+}
+export declare class AgentResource {
+    private readonly ctx;
+    constructor(ctx: AgentResourceContext);
+    stream(params: AgentStreamCreateParams, options?: CallOptions): StreamIterator<RunEvent, AgentStreamFinalResult>;
+    stop(params: {
+        agentWallet: string;
+        runId: string;
+        threadId?: string;
+    }): Promise<{
+        stopped: boolean;
+    }>;
+    decide(params: AgentDecisionInput): Promise<AgentDecisionResult>;
+}
+export type { AgentDecisionInput, AgentDecisionResult, AgentStreamCreateParams, AgentStreamFinalResult, SessionBudgetSnapshot, SessionInvalidReason, };
+//# sourceMappingURL=agent.d.ts.map

package/dist/resources/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/resources/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAM9E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EACR,kBAAkB,EAClB,mBAAmB,EAGnB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEH,KAAK,WAAW,EAChB,cAAc,EAEjB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAEhE,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;IACjB,cAAc,EAAE,MAAM;QAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACzE,aAAa,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACnC,kBAAkB,CAAC,EAAE,MAAM,iBAAiB,GAAG,IAAI,CAAC;IACpD,MAAM,EAAE,QAAQ,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,aAAa;IACV,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,oBAAoB;IAEtD,MAAM,CACF,MAAM,EAAE,uBAAuB,EAC/B,OAAO,GAAE,WAAgB,GAC1B,cAAc,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAI7C,IAAI,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAsBtG,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA4BzE;AAoaD,YAAY,EACR,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,GACvB,CAAC"}

package/dist/resources/agent.js

@@ -0,0 +1,465 @@
+/**
+ * Compose agent runtime stream resource.
+ *
+ * SDK responsibilities ONLY:
+ *   - HTTP request with payment/auth/abort
+ *   - Response header extraction (budget, receipt, session)
+ *   - EventBus emission (toolCallStart/End, childAgent*, planProposed, etc.)
+ *   - Text accumulation for final result
+ *   - Stream lifecycle (agentStreamStart/End)
+ *
+ * All SSE protocol, decoding, and event type routing is delegated to
+ * @compose-market/core/sse/stream — the single source of truth.
+ */
+import { Error } from "../errors.js";
+import { streamEvents } from "@compose-market/core/sse/stream";
+import { extractReceiptFromResponse } from "@compose-market/core/sse/receipt";
+import { extractSessionBudgetFromResponse } from "@compose-market/core/sse/budget";
+import { buildCallHeaders, StreamIterator, requestResponseWithPayment, } from "./inference.js";
+export class AgentResource {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    stream(params, options = {}) {
+        return new StreamIterator(driveAgentStream(this.ctx, params, options));
+    }
+    async stop(params) {
+        const wallet = this.ctx.getWalletMaybe();
+        const token = this.ctx.getTokenMaybe();
+        const headers = {
+            "Content-Type": "application/json",
+            "User-Agent": this.ctx.userAgent,
+        };
+        if (token)
+            headers.Authorization = `Bearer ${token}`;
+        if (wallet.address)
+            headers["x-session-user-address"] = wallet.address;
+        if (wallet.chainId !== null)
+            headers["x-chain-id"] = String(wallet.chainId);
+        const path = `/agent/${encodeURIComponent(params.agentWallet)}/runs/${encodeURIComponent(params.runId)}/stop`;
+        const response = await this.ctx.http.request({
+            method: "POST",
+            path,
+            headers,
+            body: params.threadId ? { threadId: params.threadId } : {},
+        }).withResponse();
+        const data = response.data;
+        return { stopped: Boolean(data?.stopped) };
+    }
+    async decide(params) {
+        const wallet = this.ctx.getWalletMaybe();
+        const token = this.ctx.getTokenMaybe();
+        const headers = {
+            "Content-Type": "application/json",
+            "User-Agent": this.ctx.userAgent,
+        };
+        if (token)
+            headers.Authorization = `Bearer ${token}`;
+        if (wallet.address)
+            headers["x-session-user-address"] = wallet.address;
+        if (wallet.chainId !== null)
+            headers["x-chain-id"] = String(wallet.chainId);
+        const path = `/agent/${encodeURIComponent(params.agentWallet)}/runs/${encodeURIComponent(params.runId)}/approval`;
+        const response = await this.ctx.http.request({
+            method: "POST",
+            path,
+            headers,
+            body: {
+                proposalId: params.proposalId,
+                version: params.version,
+                decision: params.decision,
+                ...(params.approvalId ? { approvalId: params.approvalId } : {}),
+                ...(params.approver ? { approver: params.approver } : {}),
+                ...(params.feedback ? { feedback: params.feedback } : {}),
+                ...(params.reason ? { reason: params.reason } : {}),
+            },
+        }).withResponse();
+        return { approved: Boolean(response.data?.approved) };
+    }
+}
+// =============================================================================
+// Stream Driver — HTTP + EventBus + text accumulation only
+// =============================================================================
+async function* driveAgentStream(ctx, params, options) {
+    const path = `/agent/${encodeURIComponent(params.agentWallet)}/stream`;
+    const wallet = ctx.getWalletMaybe();
+    const token = ctx.getTokenMaybe();
+    const body = {
+        message: params.message,
+        threadId: params.threadId,
+        userAddress: params.userAddress,
+    };
+    if (params.agentCard)
+        body.agentCard = params.agentCard;
+    if (params.runId)
+        body.runId = params.runId;
+    if (params.cloudPermissions)
+        body.cloudPermissions = params.cloudPermissions;
+    if (params.attachment)
+        body.attachment = params.attachment;
+    if (params.attachments)
+        body.attachments = params.attachments;
+    if (params.mode)
+        body.mode = params.mode;
+    if (params.scope)
+        body.scope = params.scope;
+    if (params.action)
+        body.action = params.action;
+    if (params.plan !== undefined)
+        body.plan = params.plan;
+    if (params.sandbox !== undefined)
+        body.sandbox = params.sandbox;
+    if (params.proof !== undefined)
+        body.proof = params.proof;
+    if (params.constraints)
+        body.constraints = params.constraints;
+    const timeoutController = new AbortController();
+    const timeoutMs = options.timeoutMs ?? 10 * 60 * 1000;
+    const timer = setTimeout(() => timeoutController.abort(), timeoutMs);
+    ctx.events.emit("agentStreamStart", {
+        userAddress: wallet.address,
+        chainId: wallet.chainId,
+        requestId: null,
+        agentWallet: params.agentWallet,
+        threadId: params.threadId,
+        runId: params.runId,
+    });
+    const requestSignal = mergeSignals(options.signal, timeoutController.signal);
+    let response;
+    try {
+        response = await requestResponseWithPayment(ctx.http, ctx, {
+            method: "POST",
+            path,
+            body,
+            headers: {
+                ...buildCallHeaders(options, wallet, token),
+                runId: params.runId ?? options.runId,
+            },
+            signal: requestSignal.signal,
+            timeoutMs,
+            expectStream: true,
+        }, options);
+    }
+    catch (fetchError) {
+        requestSignal.cleanup();
+        clearTimeout(timer);
+        if (fetchError instanceof Error)
+            throw fetchError;
+        throw new Error({
+            code: "network_error",
+            message: fetchError instanceof Error ? fetchError.message : String(fetchError),
+        });
+    }
+    requestSignal.cleanup();
+    clearTimeout(timer);
+    if (!response.ok) {
+        const text = await response.text().catch(() => "");
+        throw new Error({
+            code: "upstream_error",
+            message: `Agent runtime returned ${response.status}: ${text.slice(0, 500)}`,
+            status: response.status,
+        });
+    }
+    if (!response.body) {
+        throw new Error({ code: "upstream_error", message: "Agent 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 streamReceipt = null;
+    const toolCalls = [];
+    const stream = streamEvents(response.body, {
+        runId: params.runId,
+        signal: options.signal,
+    });
+    try {
+        let result;
+        while (true) {
+            const next = await stream.next();
+            if (next.done) {
+                result = next.value;
+                break;
+            }
+            const event = next.value;
+            yield event;
+            handleEvent(event, ctx.events, wallet, requestId, { text, toolCalls });
+            if (event.domain === "model") {
+                const me = event;
+                if (me.type === "model.text.delta" && me.delta)
+                    text += me.delta;
+                if (me.type === "model.text.done" && me.text && !text)
+                    text = me.text;
+            }
+        }
+        if (result?.receipt)
+            streamReceipt = result.receipt;
+    }
+    finally {
+        try {
+            await response.body?.cancel();
+        }
+        catch { /* best-effort */ }
+        ctx.events.emit("agentStreamEnd", {
+            userAddress: wallet.address,
+            chainId: wallet.chainId,
+            requestId,
+            agentWallet: params.agentWallet,
+            threadId: params.threadId,
+            runId: params.runId,
+        });
+    }
+    return {
+        text,
+        toolCalls,
+        requestId,
+        receipt: streamReceipt ?? headerReceipt,
+        budget,
+        sessionInvalidReason,
+    };
+}
+function handleEvent(event, events, wallet, requestId, ctx) {
+    if (event.domain === "activity") {
+        handleActivityEvent(event, events, wallet, requestId, ctx);
+    }
+}
+function handleActivityEvent(event, events, wallet, requestId, ctx) {
+    const rawType = rawString(event.raw, "type") ?? "";
+    if (event.type === "activity.tool") {
+        handleToolEvent(event, events, wallet, requestId, ctx, rawType);
+        return;
+    }
+    if (event.type === "activity.child") {
+        handleChildEvent(event, events, wallet, requestId, rawType);
+        return;
+    }
+    if (event.type === "activity.plan") {
+        handlePlanEvent(event, events, wallet, requestId, rawType);
+        return;
+    }
+}
+function handleToolEvent(event, events, wallet, requestId, ctx, rawType) {
+    const isStart = rawType === "tool_start" || rawType === "tool-start" || event.status === "running";
+    const toolName = event.name ?? "tool";
+    const target = event.target;
+    const display = target ? {
+        kind: target.kind,
+        ...(target.id ? { id: target.id } : {}),
+        ...(target.name ? { name: target.name } : {}),
+        ...(target.target ? { target: target.target } : {}),
+        ...(target.summary ? { summary: target.summary } : {}),
+        ...(target.details ? { details: target.details } : {}),
+    } : undefined;
+    const summary = target?.summary ?? rawString(event.raw, "message") ?? rawString(event.raw, "content");
+    const failed = event.status === "failed";
+    const error = rawString(event.raw, "error");
+    if (isStart) {
+        events.emit("toolCallStart", {
+            userAddress: wallet.address,
+            chainId: wallet.chainId,
+            requestId,
+            source: "agent",
+            toolCallId: toolName,
+            toolName,
+            ...(display?.name ? { displayName: display.name } : {}),
+            ...(display ? { display, targetKind: display.kind } : {}),
+            ...(display?.target ? { target: display.target } : {}),
+            summary,
+        });
+    }
+    else {
+        ctx.toolCalls.push({
+            toolName,
+            ...(display?.name ? { displayName: display.name } : {}),
+            ...(display ? { display, targetKind: display.kind } : {}),
+            ...(display?.target ? { target: display.target } : {}),
+            summary,
+            failed,
+            ...(error ? { error } : {}),
+        });
+        events.emit("toolCallEnd", {
+            userAddress: wallet.address,
+            chainId: wallet.chainId,
+            requestId,
+            source: "agent",
+            toolCallId: toolName,
+            toolName,
+            ...(display?.name ? { displayName: display.name } : {}),
+            ...(display ? { display, targetKind: display.kind } : {}),
+            ...(display?.target ? { target: display.target } : {}),
+            summary,
+            failed,
+            ...(error ? { error } : {}),
+        });
+    }
+}
+function handleChildEvent(event, events, wallet, requestId, rawType) {
+    const childEvent = mapChildEventType(rawType);
+    if (!childEvent)
+        return;
+    const target = event.target;
+    const display = target ? {
+        kind: target.kind,
+        ...(target.id ? { id: target.id } : {}),
+        ...(target.name ? { name: target.name } : {}),
+        ...(target.target ? { target: target.target } : {}),
+        ...(target.summary ? { summary: target.summary } : {}),
+        ...(target.details ? { details: target.details } : {}),
+    } : undefined;
+    const details = target?.details;
+    const raw = event.raw;
+    const payload = {
+        userAddress: wallet.address,
+        chainId: wallet.chainId,
+        requestId,
+        source: "agent",
+        event: childEvent,
+        ...(rawString(raw, "rootRunId") ? { rootRunId: rawString(raw, "rootRunId") } : {}),
+        ...(rawString(raw, "parentRunId") ? { parentRunId: rawString(raw, "parentRunId") } : {}),
+        ...(rawString(raw, "subId") ? { subId: rawString(raw, "subId") } : {}),
+        ...(typeof details?.depth === "number" ? { depth: details.depth } : {}),
+        ...(rawString(raw, "agentWallet") ? { agentWallet: rawString(raw, "agentWallet") } : {}),
+        ...(rawString(raw, "runKey") ? { runKey: rawString(raw, "runKey") } : {}),
+        ...(Array.isArray(event.path) ? { runKeyChain: event.path } : {}),
+        ...(rawString(raw, "toolName") ? { toolName: rawString(raw, "toolName") } : {}),
+        ...(raw && "input" in raw ? { input: raw.input } : {}),
+        ...(raw && "output" in raw ? { output: raw.output } : {}),
+        ...(event.status === "failed" ? { failed: true } : {}),
+        ...(rawString(raw, "error") ? { error: rawString(raw, "error") } : {}),
+        ...(raw && typeof raw.usage === "object" && raw.usage ? { usage: raw.usage } : {}),
+        ...(typeof details?.toolBatches === "number" ? { toolBatches: details.toolBatches } : {}),
+        ...(rawString(raw, "stopReason") ? { stopReason: rawString(raw, "stopReason") } : {}),
+        ...(typeof details?.wallMs === "number" ? { wallMs: details.wallMs } : {}),
+        ...(display ? { display } : {}),
+        ...(typeof details?.ts === "number" ? { ts: details.ts } : {}),
+    };
+    switch (childEvent) {
+        case "start":
+            events.emit("childAgentStart", payload);
+            break;
+        case "tool-start":
+            events.emit("childAgentToolStart", payload);
+            break;
+        case "tool-end":
+            events.emit("childAgentToolEnd", payload);
+            break;
+        case "done":
+            events.emit("childAgentDone", payload);
+            break;
+        case "error":
+            events.emit("childAgentError", payload);
+            break;
+    }
+}
+function handlePlanEvent(event, events, wallet, requestId, rawType) {
+    const p = event.payload ?? {};
+    const display = event.target ? {
+        kind: event.target.kind,
+        ...(event.target.id ? { id: event.target.id } : {}),
+        ...(event.target.name ? { name: event.target.name } : {}),
+        ...(event.target.target ? { target: event.target.target } : {}),
+        ...(event.target.summary ? { summary: event.target.summary } : {}),
+        ...(event.target.details ? { details: event.target.details } : {}),
+    } : undefined;
+    const payload = {
+        type: rawType,
+        proposalId: String(p.proposalId ?? event.id),
+        version: Number(p.version ?? 1),
+        ...(typeof p.approvalId === "string" ? { approvalId: p.approvalId } : {}),
+        state: String(p.state ?? event.status ?? "pending"),
+        ...(p.decision ? { decision: p.decision } : {}),
+        ...(typeof p.rootRunId === "string" ? { rootRunId: p.rootRunId } : {}),
+        ...(event.runId ? { runId: event.runId } : {}),
+        ...(typeof p.requestedBy === "string" ? { requestedBy: p.requestedBy } : {}),
+        ...(p.proposal !== undefined ? { proposal: p.proposal } : {}),
+        ...(typeof p.markdown === "string" ? { markdown: p.markdown } : {}),
+        ...(typeof p.updatedAt === "number" ? { updatedAt: p.updatedAt } : {}),
+        ...(typeof p.approver === "string" ? { approver: p.approver } : {}),
+        ...(typeof p.reason === "string" ? { reason: p.reason } : {}),
+        ...(typeof p.feedback === "string" ? { feedback: p.feedback } : {}),
+        ...(display ? { display } : {}),
+        ...(event.target?.details ? { details: event.target.details } : {}),
+        userAddress: wallet.address,
+        chainId: wallet.chainId,
+        requestId,
+        source: "agent",
+    };
+    switch (rawType) {
+        case "plan.proposed":
+            events.emit("planProposed", payload);
+            break;
+        case "approval.requested":
+            events.emit("approvalRequested", payload);
+            break;
+        case "approval.decided":
+            events.emit("approvalDecided", payload);
+            break;
+        case "plan.feedback_requested":
+            events.emit("planFeedbackRequested", payload);
+            break;
+    }
+}
+// =============================================================================
+// Utilities
+// =============================================================================
+function rawString(value, key) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    const record = value;
+    const v = record[key];
+    return typeof v === "string" && v.length > 0 ? v : undefined;
+}
+function mapChildEventType(rawType) {
+    switch (rawType) {
+        case "swarm_child_start": return "start";
+        case "swarm_child_tool_start": return "tool-start";
+        case "swarm_child_tool_end": return "tool-end";
+        case "swarm_child_done": return "done";
+        case "swarm_child_error": return "error";
+        default: return null;
+    }
+}
+function mergeSignals(a, b) {
+    if (!a)
+        return { signal: b, cleanup: () => { } };
+    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 {
+        signal: c.signal,
+        cleanup: () => {
+            a.removeEventListener("abort", forward);
+            b.removeEventListener("abort", forward);
+        },
+    };
+}
+//# sourceMappingURL=agent.js.map