@chorus-aidlc/chorus-openclaw-plugin 0.3.1 → 0.5.0

package/dist/mcp-client.d.ts

@@ -0,0 +1,37 @@
+export type McpClientStatus = "disconnected" | "connecting" | "connected" | "reconnecting";
+export interface ChorusMcpClientOptions {
+    chorusUrl: string;
+    apiKey: string;
+    logger: {
+        info: (msg: string) => void;
+        warn: (msg: string) => void;
+        error: (msg: string) => void;
+    };
+}
+/**
+ * Wraps @modelcontextprotocol/sdk Client with:
+ * - Lazy connection (connect on first callTool)
+ * - Auto-reconnect on session expiry (404)
+ * - Status tracking
+ * - Graceful disconnect
+ */
+export declare class ChorusMcpClient {
+    private client;
+    private transport;
+    private _status;
+    private readonly opts;
+    constructor(opts: ChorusMcpClientOptions);
+    get status(): McpClientStatus;
+    /** Establish MCP connection. Called lazily on first callTool. */
+    connect(): Promise<void>;
+    /**
+     * Call a Chorus MCP tool. Handles lazy connection and auto-reconnect.
+     * Returns parsed JSON from the first text content block.
+     */
+    callTool(name: string, args?: Record<string, unknown>): Promise<unknown>;
+    /** Graceful disconnect. */
+    disconnect(): Promise<void>;
+    private _doCallTool;
+    private isSessionExpiredError;
+}
+//# sourceMappingURL=mcp-client.d.ts.map

package/dist/mcp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.d.ts","sourceRoot":"","sources":["../src/mcp-client.ts"],"names":[],"mappings":"AAoBA,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,CAAC;AAE3F,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;CACpG;AAED;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyB;gBAElC,IAAI,EAAE,sBAAsB;IAIxC,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED,iEAAiE;IAC3D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC9B;;;OAGG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBlF,2BAA2B;IACrB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAcnB,WAAW;IA2BzB,OAAO,CAAC,qBAAqB;CAO9B"}

package/dist/mcp-client.js

@@ -0,0 +1,137 @@
+/**
+ * Plugin-INTERNAL MCP client.
+ *
+ * This is NOT how the agent gets Chorus tools — those are exposed natively by
+ * OpenClaw connecting to the `mcp.servers.chorus` entry written by
+ * `ensureChorusMcpServer` (see mcp-registration.ts). The plugin no longer
+ * hand-wraps any Chorus tool with `api.registerTool`.
+ *
+ * This client exists only for the plugin's OWN synchronous calls into Chorus:
+ *   - `/chorus` command: chorus_checkin, chorus_get_my_assignments,
+ *     chorus_get_available_ideas (see commands.ts)
+ *   - SSE reconnect back-fill: chorus_get_notifications (see index.ts)
+ *
+ * No agent-facing tool depends on it. Keep it a generic StreamableHTTP
+ * `callTool` client (lazy connect + 404 reconnect); do not grow it into a tool
+ * surface.
+ */
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+/**
+ * Wraps @modelcontextprotocol/sdk Client with:
+ * - Lazy connection (connect on first callTool)
+ * - Auto-reconnect on session expiry (404)
+ * - Status tracking
+ * - Graceful disconnect
+ */
+export class ChorusMcpClient {
+    client = null;
+    transport = null;
+    _status = "disconnected";
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    get status() {
+        return this._status;
+    }
+    /** Establish MCP connection. Called lazily on first callTool. */
+    async connect() {
+        if (this._status === "connected" && this.client)
+            return;
+        this._status = "connecting";
+        try {
+            this.transport = new StreamableHTTPClientTransport(new URL("/api/mcp", this.opts.chorusUrl), {
+                requestInit: {
+                    headers: {
+                        Authorization: `Bearer ${this.opts.apiKey}`,
+                    },
+                },
+            });
+            this.client = new Client({
+                name: "openclaw-chorus",
+                version: "0.1.0",
+            });
+            await this.client.connect(this.transport);
+            this._status = "connected";
+            this.opts.logger.info("MCP connection established");
+        }
+        catch (err) {
+            this._status = "disconnected";
+            this.client = null;
+            this.transport = null;
+            throw err;
+        }
+    }
+    /**
+     * Call a Chorus MCP tool. Handles lazy connection and auto-reconnect.
+     * Returns parsed JSON from the first text content block.
+     */
+    async callTool(name, args = {}) {
+        // Lazy connect
+        if (!this.client || this._status !== "connected") {
+            await this.connect();
+        }
+        try {
+            return await this._doCallTool(name, args);
+        }
+        catch (err) {
+            // Session expired (404) or connection lost — reconnect and retry once
+            if (this.isSessionExpiredError(err)) {
+                this.opts.logger.warn("MCP session expired, reconnecting...");
+                this._status = "reconnecting";
+                this.client = null;
+                this.transport = null;
+                await this.connect();
+                return await this._doCallTool(name, args);
+            }
+            throw err;
+        }
+    }
+    /** Graceful disconnect. */
+    async disconnect() {
+        if (this.client) {
+            try {
+                await this.client.close();
+            }
+            catch {
+                // Ignore close errors
+            }
+        }
+        this.client = null;
+        this.transport = null;
+        this._status = "disconnected";
+        this.opts.logger.info("MCP connection closed");
+    }
+    async _doCallTool(name, args) {
+        if (!this.client)
+            throw new Error("MCP client not connected");
+        const result = await this.client.callTool({ name, arguments: args });
+        if (result.isError) {
+            const errorText = result.content
+                .filter((c) => c.type === "text")
+                .map((c) => c.text)
+                .join("\n");
+            throw new Error(`Chorus MCP tool error (${name}): ${errorText}`);
+        }
+        // Parse first text content block as JSON
+        const textContent = result.content.find((c) => c.type === "text");
+        if (!textContent?.text)
+            return null;
+        try {
+            return JSON.parse(textContent.text);
+        }
+        catch {
+            // Return raw text if not valid JSON
+            return textContent.text;
+        }
+    }
+    isSessionExpiredError(err) {
+        if (err instanceof Error) {
+            const msg = err.message.toLowerCase();
+            return msg.includes("404") || msg.includes("session") || msg.includes("not found");
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=mcp-client.js.map

package/dist/mcp-client.js.map

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

package/dist/mcp-registration.d.ts

@@ -0,0 +1,25 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-entry";
+import type { ChorusPluginConfig } from "./config.js";
+/**
+ * Ensure the Chorus MCP server is registered with OpenClaw so the agent gains
+ * the native `chorus__*` tools.
+ *
+ * Writes (idempotently) an `mcp.servers.chorus` entry into the OpenClaw config
+ * via `api.runtime.config.mutateConfigFile` — a remote streamable-http MCP
+ * server with Bearer auth. OpenClaw then connects to the remote Chorus MCP
+ * server on (re)load and auto-exposes its tools under the `chorus__` prefix; we
+ * never re-declare those tools with `api.registerTool`.
+ *
+ * Behavior:
+ * - Missing `chorusUrl`/`apiKey`: do NOT write; warn naming the missing field(s).
+ * - Existing entry already equals the desired entry: return without writing
+ *   (idempotent — no config reload triggered).
+ * - Otherwise: `mutateConfigFile({ afterWrite: { mode: "auto" }, mutate })`,
+ *   mutating the draft in place (OpenClaw's `mutate` callback receives a
+ *   structuredClone draft and persists the in-place mutation).
+ * - Any rejection from `mutateConfigFile` (or the runtime API being absent) is
+ *   logged at error level and swallowed — registration failure must never crash
+ *   the gateway, so the SSE service and `/chorus` command still register.
+ */
+export declare function ensureChorusMcpServer(api: OpenClawPluginApi, cfg: ChorusPluginConfig): Promise<void>;
+//# sourceMappingURL=mcp-registration.d.ts.map

package/dist/mcp-registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-registration.d.ts","sourceRoot":"","sources":["../src/mcp-registration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AA8CtD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,iBAAiB,EACtB,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,IAAI,CAAC,CAsEf"}

package/dist/mcp-registration.js

@@ -0,0 +1,93 @@
+/**
+ * Build the desired `mcp.servers.chorus` entry for the current config.
+ */
+function buildDesiredEntry(chorusUrl, apiKey) {
+    return {
+        url: new URL("/api/mcp", chorusUrl).toString(),
+        transport: "streamable-http",
+        headers: { Authorization: `Bearer ${apiKey}` },
+    };
+}
+/**
+ * Shallow-equal the fields that define the desired entry. We only compare the
+ * three load-bearing fields (url, transport, Authorization header) so an
+ * operator-added extra field — e.g. `connectionTimeoutMs` — does not force a
+ * rewrite-and-reload on every activation.
+ */
+function entryMatches(existing, desired) {
+    if (!existing || typeof existing !== "object")
+        return false;
+    const e = existing;
+    return (e.url === desired.url &&
+        e.transport === desired.transport &&
+        e.headers?.Authorization === desired.headers.Authorization);
+}
+/**
+ * Ensure the Chorus MCP server is registered with OpenClaw so the agent gains
+ * the native `chorus__*` tools.
+ *
+ * Writes (idempotently) an `mcp.servers.chorus` entry into the OpenClaw config
+ * via `api.runtime.config.mutateConfigFile` — a remote streamable-http MCP
+ * server with Bearer auth. OpenClaw then connects to the remote Chorus MCP
+ * server on (re)load and auto-exposes its tools under the `chorus__` prefix; we
+ * never re-declare those tools with `api.registerTool`.
+ *
+ * Behavior:
+ * - Missing `chorusUrl`/`apiKey`: do NOT write; warn naming the missing field(s).
+ * - Existing entry already equals the desired entry: return without writing
+ *   (idempotent — no config reload triggered).
+ * - Otherwise: `mutateConfigFile({ afterWrite: { mode: "auto" }, mutate })`,
+ *   mutating the draft in place (OpenClaw's `mutate` callback receives a
+ *   structuredClone draft and persists the in-place mutation).
+ * - Any rejection from `mutateConfigFile` (or the runtime API being absent) is
+ *   logged at error level and swallowed — registration failure must never crash
+ *   the gateway, so the SSE service and `/chorus` command still register.
+ */
+export async function ensureChorusMcpServer(api, cfg) {
+    const logger = api.logger;
+    // 1. Required-config guard: do not write a half-formed entry.
+    const missing = [];
+    if (!cfg.chorusUrl)
+        missing.push("chorusUrl");
+    if (!cfg.apiKey)
+        missing.push("apiKey");
+    if (missing.length > 0) {
+        logger.warn(`[Chorus] Skipping MCP server registration — missing required config: ${missing.join(", ")}`);
+        return;
+    }
+    const desired = buildDesiredEntry(cfg.chorusUrl, cfg.apiKey);
+    try {
+        // `api.runtime` is permissively typed via the SDK shim; narrow to the
+        // config surface we use (current() + mutateConfigFile). At runtime the host
+        // provides the real `PluginRuntimeCore.config` API
+        // (../openclaw/src/plugins/runtime/types-core.ts:145).
+        const runtimeConfig = api.runtime?.config;
+        if (!runtimeConfig?.mutateConfigFile) {
+            logger.error("[Chorus] MCP server registration failed — runtime.config.mutateConfigFile is unavailable on this host");
+            return;
+        }
+        // 2. Idempotency: skip the write (and the reload it triggers) when the
+        //    existing entry already matches.
+        const existing = runtimeConfig.current?.()?.mcp?.servers?.chorus;
+        if (entryMatches(existing, desired)) {
+            logger.info("[Chorus] MCP server entry already up to date — no config change");
+            return;
+        }
+        // 3. Write the entry, mutating the draft in place.
+        await runtimeConfig.mutateConfigFile({
+            afterWrite: { mode: "auto" },
+            mutate: (draft) => {
+                const mcp = (draft.mcp ??= {});
+                const servers = (mcp.servers ??= {});
+                servers.chorus = desired;
+            },
+        });
+        logger.info(`[Chorus] Registered MCP server entry — ${desired.url}`);
+    }
+    catch (err) {
+        // 4. Never crash the gateway: log at error level and continue so the SSE
+        //    service and /chorus command still register.
+        logger.error(`[Chorus] MCP server registration failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+//# sourceMappingURL=mcp-registration.js.map

package/dist/mcp-registration.js.map

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

package/dist/sse-listener.d.ts

@@ -0,0 +1,37 @@
+export type SseListenerStatus = "connected" | "disconnected" | "reconnecting";
+export interface SseNotificationEvent {
+    type: string;
+    notificationUuid?: string;
+    notificationType?: string;
+    unreadCount?: number;
+    [key: string]: unknown;
+}
+export interface ChorusSseListenerOptions {
+    chorusUrl: string;
+    apiKey: string;
+    onEvent: (event: SseNotificationEvent) => void;
+    onReconnect: () => Promise<void>;
+    logger: {
+        info: (msg: string) => void;
+        warn: (msg: string) => void;
+        error: (msg: string) => void;
+    };
+}
+export declare class ChorusSseListener {
+    private readonly opts;
+    private _status;
+    private abortController;
+    private reconnectTimer;
+    private reconnectDelay;
+    constructor(opts: ChorusSseListenerOptions);
+    get status(): SseListenerStatus;
+    /** Start the SSE connection. Resolves once the first bytes arrive (or rejects on immediate failure). */
+    connect(): Promise<void>;
+    /** Gracefully close the SSE connection. */
+    disconnect(): void;
+    private consumeStream;
+    private processMessage;
+    private scheduleReconnect;
+    private clearReconnectTimer;
+}
+//# sourceMappingURL=sse-listener.d.ts.map

package/dist/sse-listener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-listener.d.ts","sourceRoot":"","sources":["../src/sse-listener.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,cAAc,GAAG,cAAc,CAAC;AAE9E,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC/C,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;CACpG;AAKD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;IAChD,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,cAAc,CAAoB;gBAE9B,IAAI,EAAE,wBAAwB;IAI1C,IAAI,MAAM,IAAI,iBAAiB,CAE9B;IAED,wGAAwG;IAClG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAuD9B,2CAA2C;IAC3C,UAAU,IAAI,IAAI;YAcJ,aAAa;IAsC3B,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,mBAAmB;CAM5B"}

package/dist/sse-listener.js

@@ -0,0 +1,152 @@
+const INITIAL_DELAY_MS = 1_000;
+const MAX_DELAY_MS = 30_000;
+export class ChorusSseListener {
+    opts;
+    _status = "disconnected";
+    abortController = null;
+    reconnectTimer = null;
+    reconnectDelay = INITIAL_DELAY_MS;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    get status() {
+        return this._status;
+    }
+    /** Start the SSE connection. Resolves once the first bytes arrive (or rejects on immediate failure). */
+    async connect() {
+        this.clearReconnectTimer();
+        const abortController = new AbortController();
+        this.abortController = abortController;
+        const url = `${this.opts.chorusUrl.replace(/\/$/, "")}/api/events/notifications`;
+        let response;
+        try {
+            response = await fetch(url, {
+                headers: {
+                    Authorization: `Bearer ${this.opts.apiKey}`,
+                    Accept: "text/event-stream",
+                },
+                signal: abortController.signal,
+            });
+        }
+        catch (err) {
+            if (abortController.signal.aborted)
+                return; // intentional disconnect
+            this.opts.logger.error(`SSE connection failed: ${err}`);
+            this.scheduleReconnect();
+            return;
+        }
+        if (!response.ok) {
+            this.opts.logger.error(`SSE endpoint returned ${response.status}`);
+            this.scheduleReconnect();
+            return;
+        }
+        if (!response.body) {
+            this.opts.logger.error("SSE response has no body");
+            this.scheduleReconnect();
+            return;
+        }
+        // Connection succeeded — reset backoff
+        const isReconnect = this._status === "reconnecting";
+        this._status = "connected";
+        this.reconnectDelay = INITIAL_DELAY_MS;
+        this.opts.logger.info("[Chorus] SSE connection established");
+        if (isReconnect) {
+            // Fire onReconnect callback so the caller can back-fill missed notifications
+            try {
+                await this.opts.onReconnect();
+            }
+            catch (err) {
+                this.opts.logger.warn(`onReconnect callback error: ${err}`);
+            }
+        }
+        // Read the stream
+        this.consumeStream(response.body, abortController.signal);
+    }
+    /** Gracefully close the SSE connection. */
+    disconnect() {
+        this.clearReconnectTimer();
+        if (this.abortController) {
+            this.abortController.abort();
+            this.abortController = null;
+        }
+        this._status = "disconnected";
+        this.opts.logger.info("SSE connection closed");
+    }
+    // ---------------------------------------------------------------------------
+    // Internal
+    // ---------------------------------------------------------------------------
+    async consumeStream(body, signal) {
+        const decoder = new TextDecoder();
+        const reader = body.getReader();
+        let buffer = "";
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done || signal.aborted)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                // SSE messages are delimited by double newlines
+                let boundary;
+                while ((boundary = buffer.indexOf("\n\n")) !== -1) {
+                    const raw = buffer.slice(0, boundary);
+                    buffer = buffer.slice(boundary + 2);
+                    this.processMessage(raw);
+                }
+            }
+        }
+        catch (err) {
+            if (signal.aborted)
+                return; // intentional disconnect
+            this.opts.logger.warn(`SSE stream error: ${err}`);
+        }
+        finally {
+            try {
+                reader.releaseLock();
+            }
+            catch {
+                // already released
+            }
+        }
+        // Stream ended unexpectedly — reconnect unless we were intentionally disconnected
+        if (!signal.aborted) {
+            this.opts.logger.warn("SSE stream ended, scheduling reconnect");
+            this.scheduleReconnect();
+        }
+    }
+    processMessage(raw) {
+        for (const line of raw.split("\n")) {
+            // Comment lines (heartbeats) — ignore
+            if (line.startsWith(":"))
+                continue;
+            // Data lines
+            if (line.startsWith("data: ")) {
+                const jsonStr = line.slice(6);
+                try {
+                    const event = JSON.parse(jsonStr);
+                    this.opts.onEvent(event);
+                }
+                catch (err) {
+                    this.opts.logger.warn(`SSE JSON parse error: ${err} — raw: ${jsonStr}`);
+                }
+            }
+        }
+    }
+    scheduleReconnect() {
+        this.clearReconnectTimer();
+        this._status = "reconnecting";
+        this.opts.logger.info(`SSE reconnecting in ${this.reconnectDelay}ms`);
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            this.connect();
+        }, this.reconnectDelay);
+        // Exponential backoff: 1s → 2s → 4s → 8s → 16s → 30s
+        this.reconnectDelay = Math.min(this.reconnectDelay * 2, MAX_DELAY_MS);
+    }
+    clearReconnectTimer() {
+        if (this.reconnectTimer !== null) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+    }
+}
+//# sourceMappingURL=sse-listener.js.map

package/dist/sse-listener.js.map

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

package/dist/wake.d.ts

@@ -0,0 +1,67 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-entry";
+/**
+ * Resolve the main agent session key from the host config.
+ *
+ * This faithfully replicates OpenClaw's `resolveMainSessionKey(cfg)`
+ * (`../openclaw/src/config/sessions/main-session.ts:14`): a background plugin
+ * has no inbound message route to derive a session key from, so the wake must
+ * target the main agent's session. We cannot import the OpenClaw internal here
+ * (the resolvable `openclaw` peer is an older build), so we re-derive the key
+ * from `api.config` (the live `OpenClawConfig` snapshot) using the same rules:
+ *
+ *   - `session.scope === "global"`  → the literal `"global"` queue
+ *   - otherwise → `agent:<defaultAgentId>:<mainKey>`, where defaultAgentId is
+ *     the agent flagged `default`, else the first listed agent, else "main".
+ *
+ * Returns `null` when no session key can be resolved. The design's no-session
+ * fallback (graceful drop) then applies — we never fabricate a session.
+ */
+export declare function resolveSessionKey(api: OpenClawPluginApi): string | null;
+/**
+ * Resolve the default agent id (matches OpenClaw's `resolveDefaultAgentId`):
+ * the agent flagged `default`, else the first listed agent, else "main".
+ * runEmbeddedAgent and the session/workspace resolvers are all agent-scoped.
+ */
+export declare function resolveAgentId(api: OpenClawPluginApi): string;
+/**
+ * Resolve the configured default model into `{ provider, model }` so we can pass
+ * them explicitly to runEmbeddedAgent. WHY THIS IS REQUIRED: runEmbeddedAgent
+ * does NOT auto-resolve the model from config when `provider`/`model` are
+ * omitted — it falls back to the built-in `DEFAULT_MODEL` ("gpt-5.5",
+ * `../openclaw/src/agents/defaults.ts:4`), which fails with "Unknown model"
+ * unless that happens to be configured. The host's own resolver
+ * (`resolveConfiguredModelRef`, `../openclaw/src/agents/model-selection-shared.ts`)
+ * is NOT exposed to plugins, so we mirror its primary-ref read: `agents.defaults.model`
+ * is either a bare `"provider/model"` string or `{ primary: "provider/model" }`
+ * (`resolvePrimaryStringValue`), split on the first "/".
+ *
+ * Returns null when no default model is configured (then we omit the overrides
+ * and let the host fall back — same as before, but at least we tried).
+ */
+export declare function resolveModelRef(api: OpenClawPluginApi): {
+    provider: string;
+    model: string;
+} | null;
+/**
+ * Build a `wake(message, contextKey)` callback bound to the host runtime.
+ *
+ * Each wake resolves the main agent's session + workspace and runs an agent
+ * turn IN-PROCESS with `message` as the prompt (via runEmbeddedAgent). The turn
+ * has the agent's normal tool set (including the `chorus__*` MCP tools), so the
+ * agent can read the entity, the comment thread, and post back to Chorus.
+ *
+ * Failure modes (never throw — the SSE service must stay alive):
+ *   - no resolvable session key / agent runtime unavailable → log + drop;
+ *   - no existing session entry → run with a fresh sessionId (the runner
+ *     creates the transcript); the agent starts a new conversation;
+ *   - runEmbeddedAgent rejects (e.g. a turn is already in flight) → log + drop
+ *     (the next SSE event re-triggers).
+ *
+ * Runs are fire-and-forget (the SSE dispatch path is sync); we log completion.
+ */
+export declare function createWake(api: OpenClawPluginApi, logger: {
+    info: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+}): (message: string, contextKey: string) => void;
+//# sourceMappingURL=wake.d.ts.map

package/dist/wake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wake.d.ts","sourceRoot":"","sources":["../src/wake.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAwD1E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAoBvE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,CAO7D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,iBAAiB,GACrB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAe5C;AAoDD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GACjG,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAgG/C"}