@chorus-aidlc/chorus-openclaw-plugin 0.10.0 → 0.11.0

package/dist/daemon-rest-client.js

@@ -0,0 +1,196 @@
+// packages/openclaw-plugin/src/daemon-rest-client.ts
+// TypeScript mirror of the shared, host-agnostic pure-REST client for the Chorus
+// daemon → server reporting surface (`/api/daemon/*`).
+//
+// WHY A MIRROR (not an import): the single-source-of-truth implementation is
+// `cli/daemon-rest-client.mjs`, consumed verbatim by the chorus CLI daemon. The
+// OpenClaw plugin, however, is a SEPARATELY-PUBLISHED npm package
+// (`@chorus-aidlc/chorus-openclaw-plugin`, `files: ["src", "dist", ...]`) whose
+// TS build has `rootDir: "src"`. Importing a file under `cli/` (outside both the
+// package boundary AND rootDir) is rejected by `tsc` and would not be present in
+// the published tarball. So we mirror the EXACT same factory + payload shapes here
+// — this is NOT a fork of the wire contract: every payload below is byte-for-byte
+// the shape `cli/daemon-rest-client.mjs` sends (and the server already accepts).
+// The two files are kept in lock-step by the spec's "single source of truth for
+// the payload shapes" requirement; a drift would be caught by T5 (live e2e).
+//
+// The five operations and their EXACT server payload shapes (verified against
+// cli/daemon-rest-client.mjs + src/app/api/daemon/*/route.ts — server unchanged):
+//   turnAdvance      → POST /api/daemon/turn-advance
+//                      { connectionUuid, sessionId, status, entityType?, entityUuid? }
+//   transcript       → POST /api/daemon/transcript
+//                      { sessionId, messages: [{ role, text }] }
+//   executionState   → POST /api/daemon/execution-state
+//                      { connectionUuid, executions: [{ entityType, entityUuid,
+//                                                       rootIdeaUuid|null, status,
+//                                                       startedAt|null }] }
+//   reportInterrupt  → POST /api/daemon/report-interrupt
+//                      { connectionUuid, entityType, entityUuid, reason }
+//   readPendingTurns → GET  /api/daemon/pending-turns?connectionUuid=…
+//                      → { turns: [{ turnUuid, sessionId, directIdeaUuid, trigger,
+//                                    promptText }] }
+//
+// HARD CONSTRAINTS (identical to the CLI client):
+//   • ZERO daemon-host coupling — no child_process, no OpenClaw SDK import. Its only
+//     outbound effect is HTTP via the injected `fetchImpl` (global fetch on Node 18+).
+//     Adds NO new npm dependency (CLAUDE.md pitfall #9).
+//   • Bearer-only auth: every request carries `Authorization: Bearer <apiKey>`.
+//   • NO SILENT ERRORS (project policy): a network error, a non-2xx response, or a
+//     bad/empty body is LOGGED WITH ITS CAUSE and SURFACED via a structured result —
+//     never swallowed into a silent success.
+//   • A failed report NEVER rejects: every method RESOLVES with `{ ok: false, ... }`
+//     so a fire-and-forget caller can `await` it safely.
+const NOOP_LOGGER = { info() { }, warn() { }, error() { } };
+/**
+ * Build the shared daemon REST client. Inputs are entirely host-agnostic, which is
+ * exactly why the same surface serves both daemon hosts.
+ */
+export function createDaemonRestClient(opts) {
+    const url = opts.url.replace(/\/$/, "");
+    const apiKey = opts.apiKey;
+    const getConnectionUuid = opts.getConnectionUuid ?? (() => null);
+    const fetchImpl = opts.fetchImpl ?? globalThis.fetch;
+    const logger = opts.logger ?? NOOP_LOGGER;
+    const jsonHeaders = {
+        Authorization: `Bearer ${apiKey}`,
+        "Content-Type": "application/json",
+        Accept: "application/json",
+    };
+    /**
+     * Issue one daemon report. Owns the transport + the no-silent-errors contract
+     * IDENTICAL across all four POST endpoints; only the `op` label and the path
+     * differ. Never throws — returns a structured {@link DaemonRestResult}.
+     */
+    async function post(op, path, body, successLog, context = "") {
+        let response;
+        try {
+            response = await fetchImpl(`${url}${path}`, {
+                method: "POST",
+                headers: jsonHeaders,
+                body: JSON.stringify(body),
+            });
+        }
+        catch (err) {
+            // Network-level failure (DNS, connection refused, abort, …). Surface WITH cause.
+            const error = `${op} request failed${context}: ${err}`;
+            logger.warn(`[Chorus] ${error}`);
+            return { ok: false, status: null, error };
+        }
+        if (!response.ok) {
+            // Non-2xx. Surface WITH the status so a 4xx/5xx is debuggable.
+            const error = `${op} returned ${response.status}${context}`;
+            logger.warn(`[Chorus] ${error}`);
+            return { ok: false, status: response.status, error };
+        }
+        if (successLog)
+            logger.info(`[Chorus] ${successLog}`);
+        return { ok: true, status: response.status };
+    }
+    return {
+        /**
+         * POST /api/daemon/turn-advance — advance a wake's DaemonSessionTurn lifecycle.
+         * The server resolves the turn by the session BUSINESS KEY (`sessionId`); the
+         * optional `entityType`/`entityUuid` stamp the weak executionUuid link. Requires
+         * the connectionUuid.
+         */
+        async turnAdvance({ sessionId, status, entityType, entityUuid }) {
+            const connectionUuid = getConnectionUuid();
+            if (!connectionUuid) {
+                const error = `cannot advance turn for session ${sessionId} → ${status} — no connection uuid yet`;
+                logger.warn(`[Chorus] ${error}`);
+                return { ok: false, status: null, error, skipped: true };
+            }
+            const body = {
+                connectionUuid,
+                sessionId,
+                status,
+                // Only sent when BOTH are present, so the server never gets a partial linkage.
+                ...(entityType && entityUuid ? { entityType, entityUuid } : {}),
+            };
+            return post("turn-advance", "/api/daemon/turn-advance", body, `advanced turn for session ${sessionId} → ${status}`);
+        },
+        /**
+         * POST /api/daemon/transcript — append finalized user/assistant text to the
+         * current turn, targeted by the session BUSINESS KEY. The caller owns the content
+         * filter (only `{ role, text }`) and any batching. No connectionUuid needed.
+         */
+        async transcript({ sessionId, messages }) {
+            return post("transcript upload", "/api/daemon/transcript", { sessionId, messages }, `transcript uploaded (${messages.length} msg) for session ${sessionId}`);
+        },
+        /**
+         * POST /api/daemon/execution-state — publish the connection's running/queued
+         * execution snapshot (caller supplies the already-built `executions` array).
+         * Requires the connectionUuid; a null uuid is a normal early state (silent skip).
+         */
+        async executionState({ executions }) {
+            const connectionUuid = getConnectionUuid();
+            if (!connectionUuid) {
+                return { ok: false, status: null, skipped: true };
+            }
+            return post("execution-state upload", "/api/daemon/execution-state", { connectionUuid, executions }, `execution-state uploaded (${executions.length} active)`);
+        },
+        /**
+         * POST /api/daemon/report-interrupt — record a wake's `interrupted` outcome
+         * (reason = "user" | "crash") on the execution row keyed by connection + entity.
+         */
+        async reportInterrupt({ entityType, entityUuid, reason }) {
+            const connectionUuid = getConnectionUuid();
+            if (!connectionUuid) {
+                const error = `cannot report interrupt for ${entityType}:${entityUuid} — no connection uuid yet`;
+                logger.warn(`[Chorus] ${error}`);
+                return { ok: false, status: null, error, skipped: true };
+            }
+            return post("report-interrupt", "/api/daemon/report-interrupt", { connectionUuid, entityType, entityUuid, reason }, `reported ${entityType}:${entityUuid} interrupted (reason=${reason})`, ` for ${entityType}:${entityUuid}`);
+        },
+        /**
+         * GET /api/daemon/pending-turns?connectionUuid=… — read this connection's
+         * unstarted (pending) turns. Returns the parsed `{ turns: [...] }` data on
+         * success; a network error / non-2xx / bad body / missing array is logged with
+         * cause and surfaced as a failure result — never a silent empty success.
+         */
+        async readPendingTurns() {
+            const connectionUuid = getConnectionUuid();
+            if (!connectionUuid) {
+                return { ok: false, status: null, skipped: true };
+            }
+            const endpoint = `${url}/api/daemon/pending-turns?connectionUuid=${encodeURIComponent(connectionUuid)}`;
+            let response;
+            try {
+                response = await fetchImpl(endpoint, {
+                    headers: { Authorization: `Bearer ${apiKey}`, Accept: "application/json" },
+                });
+            }
+            catch (err) {
+                const error = `pending-turns backfill request failed: ${err}`;
+                logger.warn(`[Chorus] ${error}`);
+                return { ok: false, status: null, error };
+            }
+            if (!response.ok) {
+                const error = `pending-turns backfill returned ${response.status}`;
+                logger.warn(`[Chorus] ${error}`);
+                return { ok: false, status: response.status, error };
+            }
+            let parsed;
+            try {
+                parsed = await response.json();
+            }
+            catch (err) {
+                const error = `pending-turns backfill: bad JSON: ${err}`;
+                logger.warn(`[Chorus] ${error}`);
+                return { ok: false, status: response.status, error };
+            }
+            // API envelope: { success: true, data: { turns: [...] } }.
+            const data = parsed && typeof parsed === "object"
+                ? parsed.data
+                : undefined;
+            const turns = data && typeof data === "object" ? data.turns : undefined;
+            if (!Array.isArray(turns)) {
+                const error = "pending-turns backfill: no turns array in response";
+                logger.warn(`[Chorus] ${error}`);
+                return { ok: false, status: response.status, error };
+            }
+            return { ok: true, status: response.status, data: { turns: turns } };
+        },
+    };
+}
+//# sourceMappingURL=daemon-rest-client.js.map

package/dist/daemon-rest-client.js.map

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

package/dist/event-router.d.ts

@@ -1,19 +1,43 @@
 import type { ChorusMcpClient } from "./mcp-client.js";
 import type { SseNotificationEvent } from "./sse-listener.js";
+import type { LineageResolver } from "./lineage.js";
+/**
+ * Per-wake attribution the router resolves and threads to the wake. Carries the
+ * reportable resource (`entityType`/`entityUuid`) and the lineage ids (the two-id
+ * contract: `directIdeaUuid` = session anchor, `rootIdeaUuid` = snapshot attribution).
+ * All optional so a host wired WITHOUT the daemon client (no lineage) still wakes —
+ * the daemon-reporting fields are simply absent and the run is a plain wake.
+ */
+export interface WakeAttribution {
+    entityType?: string | null;
+    entityUuid?: string | null;
+    directIdeaUuid?: string | null;
+    rootIdeaUuid?: string | null;
+}
 /**
  * Wake callback injected by the entry. Runs an embedded agent turn on the main
- * agent's session with `message` as the prompt (see `wake.ts` → createWake,
- * which calls `api.runtime.agent.runEmbeddedAgent`).
+ * agent's session with `message` as the prompt (see `wake.ts` / daemon-client.ts,
+ * which call `api.runtime.agent.runEmbeddedAgent`).
  *
  * `contextKey` identifies the originating Chorus action+entity (e.g.
- * `chorus:mentioned:<uuid>`); it is used for the run id / logging. The wake
- * resolves the main agent session + model and DROPS (logs + returns) when it
- * cannot run — it never throws, so the SSE service stays alive.
+ * `chorus:mentioned:<uuid>`); it is used for the run id / logging. `attribution`
+ * (when present) lets the daemon client report turn-advance / execution-state /
+ * interrupt for the wake and anchor the session on the business key. The wake
+ * resolves the main agent session + model and DROPS (logs + returns) when it cannot
+ * run — it never throws, so the SSE service stays alive.
  */
-export type ChorusWakeFn = (message: string, contextKey: string) => void;
+export type ChorusWakeFn = (message: string, contextKey: string, attribution?: WakeAttribution) => void;
 export interface ChorusEventRouterOptions {
     mcpClient: ChorusMcpClient;
     wake: ChorusWakeFn;
+    /**
+     * Optional lineage resolver (daemon parity). When present, the router resolves each
+     * notification's `{ rootIdeaUuid, directIdeaUuid }` via the root-idea REST endpoint
+     * before waking, so the daemon client can anchor the session on the direct idea and
+     * report the root idea in its execution snapshot. When absent (a host with no daemon
+     * reporting), wakes carry only the entity fields the notification already provides.
+     */
+    lineage?: LineageResolver;
     logger: {
         info: (msg: string) => void;
         warn: (msg: string) => void;
@@ -23,6 +47,7 @@ export interface ChorusEventRouterOptions {
 export declare class ChorusEventRouter {
     private readonly mcpClient;
     private readonly wake;
+    private readonly lineage?;
     private readonly logger;
     constructor(opts: ChorusEventRouterOptions);
     /**

package/dist/event-router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-router.d.ts","sourceRoot":"","sources":["../src/event-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;AAEzE,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,eAAe,CAAC;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,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;AAmBD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;gBAEhD,IAAI,EAAE,wBAAwB;IAM1C;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI;IAsB3C;;;;OAIG;IACH,OAAO,CAAC,aAAa;YAIP,aAAa;IA4D3B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,0BAA0B;IAOlC,OAAO,CAAC,sBAAsB;IAY9B,OAAO,CAAC,sBAAsB;IAY9B,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,yBAAyB;CAalC"}
+{"version":3,"file":"event-router.d.ts","sourceRoot":"","sources":["../src/event-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,eAAe,KAC1B,IAAI,CAAC;AAEV,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,eAAe,CAAC;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,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;AAmBD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;gBAEhD,IAAI,EAAE,wBAAwB;IAO1C;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI;IAgC3C;;;;OAIG;IACH,OAAO,CAAC,aAAa;YAIP,aAAa;IAgF3B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,0BAA0B;IAQlC,OAAO,CAAC,sBAAsB;IAa9B,OAAO,CAAC,sBAAsB;IAa9B,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,yBAAyB;CAclC"}

package/dist/event-router.js

@@ -1,10 +1,12 @@
 export class ChorusEventRouter {
     mcpClient;
     wake;
+    lineage;
     logger;
     constructor(opts) {
         this.mcpClient = opts.mcpClient;
         this.wake = opts.wake;
+        this.lineage = opts.lineage;
         this.logger = opts.logger;
     }
     /**
@@ -12,6 +14,15 @@ export class ChorusEventRouter {
      * Never throws — all errors are caught and logged internally.
      */
     dispatch(event) {
+        // The bidirectional daemon events `connection_registered` and `control` are
+        // forked upstream by the SSE listener (onConnectionId / onControl) and never
+        // reach the wake path. If one ever does arrive here (defense-in-depth), drop
+        // it SILENTLY — it is a known, handled-elsewhere event, NOT an unhandled one,
+        // so logging it as "ignored" would be misleading noise (and the spec requires
+        // connection_registered never be logged as ignored).
+        if (event.type === "connection_registered" || event.type === "control") {
+            return;
+        }
         // Only handle new_notification events (ignore count_update, etc.)
         if (event.type !== "new_notification") {
             this.logger.info(`SSE event type "${event.type}" ignored`);
@@ -55,35 +66,55 @@ export class ChorusEventRouter {
             this.logger.warn(`Notification ${notificationUuid} not found in unread list`);
             return;
         }
+        // Resolve the wake attribution ONCE per notification (daemon parity). The lineage
+        // resolver returns { rootIdeaUuid, directIdeaUuid } via the root-idea REST endpoint;
+        // both null when there's no idea ancestor or no resolver is wired. The entity
+        // fields always come straight off the notification. This threads through to the
+        // daemon client so it reports/anchors against the right session + resource.
+        let attribution = {
+            entityType: notification.entityType,
+            entityUuid: notification.entityUuid,
+        };
+        if (this.lineage) {
+            try {
+                const { rootIdeaUuid, directIdeaUuid } = await this.lineage.resolve(notification);
+                attribution = { ...attribution, rootIdeaUuid, directIdeaUuid };
+            }
+            catch (err) {
+                // A lineage failure must not lose the wake — fall back to the entity-only
+                // attribution (the daemon client then anchors on the entity uuid). Logged.
+                this.logger.warn(`Lineage resolve failed for ${notification.entityType}:${notification.entityUuid}: ${err}`);
+            }
+        }
         // Route based on action (which corresponds to notificationType)
         try {
             switch (notification.action) {
                 case "task_assigned":
-                    this.handleTaskAssigned(notification);
+                    this.handleTaskAssigned(notification, attribution);
                     break;
                 case "mentioned":
-                    this.handleMentioned(notification);
+                    this.handleMentioned(notification, attribution);
                     break;
                 case "elaboration_requested":
-                    this.handleElaborationRequested(notification);
+                    this.handleElaborationRequested(notification, attribution);
                     break;
                 case "elaboration_answered":
-                    this.handleElaborationAnswered(notification);
+                    this.handleElaborationAnswered(notification, attribution);
                     break;
                 case "proposal_rejected":
-                    this.handleProposalRejected(notification);
+                    this.handleProposalRejected(notification, attribution);
                     break;
                 case "proposal_approved":
-                    this.handleProposalApproved(notification);
+                    this.handleProposalApproved(notification, attribution);
                     break;
                 case "idea_claimed":
-                    this.handleIdeaClaimed(notification);
+                    this.handleIdeaClaimed(notification, attribution);
                     break;
                 case "task_verified":
-                    this.handleTaskVerified(notification);
+                    this.handleTaskVerified(notification, attribution);
                     break;
                 case "task_reopened":
-                    this.handleTaskReopened(notification);
+                    this.handleTaskReopened(notification, attribution);
                     break;
                 default:
                     this.logger.info(`Unhandled notification action: "${notification.action}"`);
@@ -102,56 +133,56 @@ export class ChorusEventRouter {
         return (`After completing your work, post a comment on this ${entityType} using chorus_add_comment with @mention:\n` +
             `Use this exact mention format: @[${n.actorName}](${n.actorType}:${n.actorUuid})`);
     }
-    handleTaskAssigned(n) {
+    handleTaskAssigned(n, attr) {
         const mentionGuidance = this.buildMentionGuidance(n, "task");
-        this.wake(`[Chorus] Task assigned: ${n.entityTitle}. Task UUID: ${n.entityUuid}, Project UUID: ${n.projectUuid}. Use chorus_get_task to review the task, then chorus_claim_task to start work.\n${mentionGuidance}`, this.contextKeyFor("task_assigned", n.entityUuid));
+        this.wake(`[Chorus] Task assigned: ${n.entityTitle}. Task UUID: ${n.entityUuid}, Project UUID: ${n.projectUuid}. Use chorus_get_task to review the task, then chorus_claim_task to start work.\n${mentionGuidance}`, this.contextKeyFor("task_assigned", n.entityUuid), attr);
     }
-    handleMentioned(n) {
+    handleMentioned(n, attr) {
         const mentionGuidance = this.buildMentionGuidance(n, n.entityType);
         this.wake(`[Chorus] You were @mentioned in ${n.entityType} '${n.entityTitle}' (entityType: ${n.entityType}, entityUuid: ${n.entityUuid}, projectUuid: ${n.projectUuid}): ${n.message}\n` +
             `Review the ${n.entityType} content and use chorus_get_comments (targetType: "${n.entityType}", targetUuid: "${n.entityUuid}") to see the full conversation, then respond.\n` +
-            mentionGuidance, this.contextKeyFor("mentioned", n.entityUuid));
+            mentionGuidance, this.contextKeyFor("mentioned", n.entityUuid), attr);
     }
-    handleElaborationRequested(n) {
-        this.wake(`[Chorus] Elaboration requested for idea '${n.entityTitle}' (ideaUuid: ${n.entityUuid}, projectUuid: ${n.projectUuid}). Use chorus_get_elaboration to review questions.`, this.contextKeyFor("elaboration_requested", n.entityUuid));
+    handleElaborationRequested(n, attr) {
+        this.wake(`[Chorus] Elaboration requested for idea '${n.entityTitle}' (ideaUuid: ${n.entityUuid}, projectUuid: ${n.projectUuid}). Use chorus_get_elaboration to review questions.`, this.contextKeyFor("elaboration_requested", n.entityUuid), attr);
     }
-    handleProposalRejected(n) {
+    handleProposalRejected(n, attr) {
         const mentionGuidance = this.buildMentionGuidance(n, "proposal");
         this.wake(`[Chorus] Proposal '${n.entityTitle}' was REJECTED (proposalUuid: ${n.entityUuid}, projectUuid: ${n.projectUuid}). Review note: "${n.message}". ` +
             `Use chorus_get_proposal to review the proposal, then fix issues with chorus_update_task_draft / chorus_update_document_draft. ` +
             `After fixing, call chorus_validate_proposal then chorus_submit_proposal to resubmit.\n` +
-            mentionGuidance, this.contextKeyFor("proposal_rejected", n.entityUuid));
+            mentionGuidance, this.contextKeyFor("proposal_rejected", n.entityUuid), attr);
     }
-    handleProposalApproved(n) {
+    handleProposalApproved(n, attr) {
         const mentionGuidance = this.buildMentionGuidance(n, "proposal");
         const reviewInfo = n.message.includes("Note: ") ? ` Review note: "${n.message.split("Note: ").pop()}"` : "";
         this.wake(`[Chorus] Proposal '${n.entityTitle}' was APPROVED (proposalUuid: ${n.entityUuid}, projectUuid: ${n.projectUuid})!${reviewInfo} Documents and tasks have been created. ` +
             `Use chorus_get_available_tasks with projectUuid: "${n.projectUuid}" to see the new tasks ready for work.\n` +
-            mentionGuidance, this.contextKeyFor("proposal_approved", n.entityUuid));
+            mentionGuidance, this.contextKeyFor("proposal_approved", n.entityUuid), attr);
     }
-    handleIdeaClaimed(n) {
+    handleIdeaClaimed(n, attr) {
         const mentionGuidance = this.buildMentionGuidance(n, "idea");
         this.wake(`[Chorus] Idea '${n.entityTitle}' has been assigned to you (ideaUuid: ${n.entityUuid}, projectUuid: ${n.projectUuid}). ` +
             `Use chorus_get_idea to review the idea, then chorus_claim_idea to start elaboration.\n` +
-            mentionGuidance, this.contextKeyFor("idea_claimed", n.entityUuid));
+            mentionGuidance, this.contextKeyFor("idea_claimed", n.entityUuid), attr);
     }
-    handleTaskVerified(n) {
+    handleTaskVerified(n, attr) {
         this.wake(`[Chorus] Task '${n.entityTitle}' has been verified and is now done (taskUuid: ${n.entityUuid}, projectUuid: ${n.projectUuid}). ` +
-            `Check if this unblocks other tasks: use chorus_get_unblocked_tasks with projectUuid "${n.projectUuid}" to find tasks that are now ready to start.`, this.contextKeyFor("task_verified", n.entityUuid));
+            `Check if this unblocks other tasks: use chorus_get_unblocked_tasks with projectUuid "${n.projectUuid}" to find tasks that are now ready to start.`, this.contextKeyFor("task_verified", n.entityUuid), attr);
     }
-    handleTaskReopened(n) {
+    handleTaskReopened(n, attr) {
         const mentionGuidance = this.buildMentionGuidance(n, "task");
         this.wake(`[Chorus] Task '${n.entityTitle}' has been reopened and needs rework (taskUuid: ${n.entityUuid}, projectUuid: ${n.projectUuid}). ` +
-            `Use chorus_get_task to review the task and chorus_get_comments to see verification feedback, then fix the issues.\n${mentionGuidance}`, this.contextKeyFor("task_reopened", n.entityUuid));
+            `Use chorus_get_task to review the task and chorus_get_comments to see verification feedback, then fix the issues.\n${mentionGuidance}`, this.contextKeyFor("task_reopened", n.entityUuid), attr);
     }
-    handleElaborationAnswered(n) {
+    handleElaborationAnswered(n, attr) {
         const mentionGuidance = this.buildMentionGuidance(n, "idea");
         this.wake(`[Chorus] Elaboration answers submitted for idea '${n.entityTitle}' (ideaUuid: ${n.entityUuid}, projectUuid: ${n.projectUuid}). ` +
             `Review the answers with chorus_get_elaboration, then either:\n` +
             `- Call chorus_validate_elaboration with empty issues [] to resolve and proceed to proposal creation\n` +
             `- Call chorus_validate_elaboration with issues + followUpQuestions for another round\n\n` +
             `After reviewing, @mention the answerer to ask if they have any further questions before you proceed.\n` +
-            mentionGuidance, this.contextKeyFor("elaboration_answered", n.entityUuid));
+            mentionGuidance, this.contextKeyFor("elaboration_answered", n.entityUuid), attr);
     }
 }
 //# sourceMappingURL=event-router.js.map

package/dist/event-router.js.map

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

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAiCA,wBAuFG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAuCA,wBA0LG"}

package/dist/index.js

@@ -4,8 +4,13 @@ import { ensureChorusMcpServer } from "./mcp-registration.js";
 import { ChorusMcpClient } from "./mcp-client.js";
 import { ChorusSseListener } from "./sse-listener.js";
 import { ChorusEventRouter } from "./event-router.js";
-import { createWake } from "./wake.js";
+import { resolveWakeRunContext } from "./wake.js";
 import { registerChorusCommands } from "./commands.js";
+import { ConnectionState } from "./connection-state.js";
+import { createControlHandler } from "./control-handler.js";
+import { createDaemonRestClient } from "./daemon-rest-client.js";
+import { LineageResolver } from "./lineage.js";
+import { OpenClawDaemonClient } from "./daemon-client.js";
 /**
  * JSON-Schema config contract for the Chorus plugin.
  *
@@ -57,15 +62,92 @@ export default definePluginEntry({
         // 4. Slim MCP client for the plugin's own synchronous calls (checkin,
         //    assignments, notifications back-fill).
         const mcpClient = new ChorusMcpClient({ chorusUrl, apiKey, logger });
-        // 5. Event router. Wakes the agent in-process by running an embedded agent
-        //    turn via `api.runtime.agent.runEmbeddedAgent` (see wake.ts). `createWake`
-        //    resolves the main agent session + configured model on each wake and
-        //    gracefully DROPS (logs + returns) when it cannot run — it never throws,
-        //    so the SSE service stays alive even on a host that exposes no session.
+        // 4b. Connection identity + reverse control channel + daemon reporting (parity).
+        //     `connectionState` holds the DaemonConnection uuid the server reports
+        //     post-handshake (captured by the listener's onConnectionId); it is the
+        //     single source of truth for "which connection am I", read by the control
+        //     handler's double-check AND the daemon REST reporter (lazily, so order
+        //     doesn't matter — both predate the handshake).
+        const connectionState = new ConnectionState();
+        //     The shared pure-REST daemon client owns the `/api/daemon/*` payload shapes
+        //     (turn-advance / transcript / execution-state / report-interrupt /
+        //     pending-turns). It reads the connectionUuid lazily from connectionState.
+        const restClient = createDaemonRestClient({
+            url: chorusUrl,
+            apiKey,
+            getConnectionUuid: () => connectionState.getConnectionUuid(),
+            logger,
+        });
+        //     Lineage resolver: per-notification { rootIdeaUuid, directIdeaUuid } via the
+        //     root-idea REST endpoint, so the daemon client anchors the session on the
+        //     DIRECT idea (resume/deliver_turn continuity) and reports the ROOT idea in
+        //     its execution snapshot (the two-id contract).
+        const lineage = new LineageResolver({ url: chorusUrl, apiKey, logger });
+        //     The in-process daemon client wraps runEmbeddedAgent with full reporting,
+        //     the AbortController registry (real mid-run interrupt), the execution
+        //     snapshot source, deterministic session-key mapping, and the at-most-once
+        //     pending-turns backfill. `resolveRunContext` is the ONE place that reaches
+        //     into api.config/api.runtime (kept out of the client so it stays testable).
+        //     `redispatch` resolves lineage for a synthetic resume so it continues the
+        //     SAME session, then runs the wake; a delivered turn already carries its ids.
+        let daemonClient;
+        const redispatch = (req) => {
+            void (async () => {
+                let enriched = req;
+                // A resume only knows the entity — resolve its lineage so the wake anchors on
+                // the same business key (direct idea) the original run used. A delivered turn
+                // already carries directIdeaUuid, so we skip the round-trip when present.
+                if (req.directIdeaUuid == null && req.entityType && req.entityUuid) {
+                    try {
+                        const { rootIdeaUuid, directIdeaUuid } = await lineage.resolve({
+                            entityType: req.entityType,
+                            entityUuid: req.entityUuid,
+                        });
+                        enriched = { ...req, rootIdeaUuid, directIdeaUuid };
+                    }
+                    catch (err) {
+                        logger.warn(`[Chorus] resume lineage resolve failed: ${err}`);
+                    }
+                }
+                await daemonClient.runWake(enriched);
+            })();
+        };
+        daemonClient = new OpenClawDaemonClient({
+            restClient,
+            resolveRunContext: () => resolveWakeRunContext(api, logger),
+            redispatch,
+            // Build the prompt for a delivered human_instruction turn. The free-text body
+            // lives only on the turn (promptText); fall back to a generic nudge if absent.
+            buildTurnPrompt: (turn) => turn.promptText && turn.promptText.trim()
+                ? `[Chorus] A human sent you an instruction in this conversation:\n\n${turn.promptText}`
+                : `[Chorus] A human sent you a new instruction in this conversation (session ${turn.sessionId}). Review the latest comments and respond.`,
+            logger,
+        });
+        //     The control handler ROUTES verified control commands to the daemon client's
+        //     behavior hooks (real abort / resume re-dispatch / pending-turns sweep),
+        //     after its own double-check (own connection + held entity).
+        const controlHooks = daemonClient.controlHooks;
+        const onControl = createControlHandler({ connectionState, hooks: controlHooks, logger });
+        // 5. Event router. Wakes the agent in-process by running an embedded agent turn
+        //    via the daemon client (which calls api.runtime.agent.runEmbeddedAgent and
+        //    reports lifecycle/transcript). The router resolves each notification's
+        //    lineage, then the daemon client's runWake gracefully DROPS (logs + returns)
+        //    when it cannot run — it never throws, so the SSE service stays alive.
+        const wakeFn = (message, contextKey, attribution) => {
+            void daemonClient.runWake({
+                prompt: message,
+                contextKey,
+                entityType: attribution?.entityType,
+                entityUuid: attribution?.entityUuid,
+                directIdeaUuid: attribution?.directIdeaUuid,
+                rootIdeaUuid: attribution?.rootIdeaUuid,
+            });
+        };
         const eventRouter = new ChorusEventRouter({
             mcpClient,
             logger,
-            wake: createWake(api, logger),
+            lineage,
+            wake: wakeFn,
         });
         // 6. Background SSE service. The SSE socket opens only inside start(), which
         //    the host calls in full mode — keeping the heavy socket gated.
@@ -78,7 +160,23 @@ export default definePluginEntry({
                     apiKey,
                     logger,
                     onEvent: (event) => eventRouter.dispatch(event),
+                    // Capture (and refresh on reconnect) the DaemonConnection identity the
+                    // server reports post-handshake. NOT a wake — forked by the listener.
+                    onConnectionId: (connectionUuid) => {
+                        connectionState.setConnectionUuid(connectionUuid);
+                        logger.info(`[Chorus] registered as daemon connection ${connectionUuid}`);
+                    },
+                    // Reverse control channel. The handler does the double-check and routes
+                    // to the behavior hooks — NEVER the wake path.
+                    onControl,
                     onReconnect: async () => {
+                        // (1) Notification backfill — re-pull unread notifications missed during
+                        //     the gap (autonomous wakes). (2) Pending-turns backfill — re-derive
+                        //     this connection's unstarted human_instruction turns from the turn
+                        //     table and run each (the lost-deliver_turn-ping safety net). The two
+                        //     share the daemon client's seen-set so a turn is run at most once
+                        //     across live delivery + backfill. Each swallows its own errors so one
+                        //     failing source never aborts the other.
                         try {
                             const result = (await mcpClient.callTool("chorus_get_notifications", {
                                 status: "unread",
@@ -92,6 +190,7 @@ export default definePluginEntry({
                         catch (err) {
                             logger.warn(`Failed to back-fill notifications: ${err}`);
                         }
+                        await daemonClient.onReconnect();
                     },
                 });
                 await sseListener.connect();