@chorus-aidlc/chorus-openclaw-plugin 0.4.0 → 0.5.3

package/dist/commands.js

@@ -0,0 +1,147 @@
+// ===== Skill catalog =====
+//
+// All 9 skills bundled with the Chorus OpenClaw plugin
+// (packages/openclaw-plugin/skills/*/SKILL.md). The `name` here matches each
+// skill's SKILL.md frontmatter `name`, which is exactly the slash command
+// OpenClaw exposes (see invocation hint below).
+const PLUGIN_SKILLS = [
+    { name: "chorus", description: "Platform overview, common tools, setup, and workflow routing" },
+    { name: "idea", description: "Claim ideas, run elaboration rounds, prepare for proposal" },
+    { name: "brainstorm", description: "Optional divergent-then-convergent dialogue for fuzzy ideas" },
+    { name: "proposal", description: "Create proposals with document & task drafts, manage the dependency DAG" },
+    { name: "develop", description: "Claim tasks, report work, manage sessions, run wave-based execution" },
+    { name: "quick-dev", description: "Skip Idea→Proposal — create tasks directly, execute, verify" },
+    { name: "review", description: "Approve/reject proposals, verify tasks, project governance" },
+    { name: "yolo", description: "Full-auto AI-DLC pipeline — from prompt to done" },
+    { name: "openspec-aware", description: "Opt-in OpenSpec authoring for PM workflows when the openspec CLI is present" },
+];
+// ===== Formatting helpers =====
+// OpenClaw invokes a skill via a BARE slash command of its SKILL.md `name`
+// (verified against OpenClaw 2026.5.30 docs/tools/skills.md: "the skill's
+// visible name, slash command ... come from SKILL.md frontmatter name ... a
+// nested skill with name: research is still invoked as /research"). OpenClaw
+// does NOT use Claude Code's `/chorus:<skill>` namespace form.
+function skillInvocation(name) {
+    return `/${name}`;
+}
+function formatSkillsList() {
+    const nameWidth = Math.max(...PLUGIN_SKILLS.map((s) => skillInvocation(s.name).length));
+    const lines = PLUGIN_SKILLS.map((s) => `  ${skillInvocation(s.name).padEnd(nameWidth)}  ${s.description}`);
+    return [
+        `Chorus skills (${PLUGIN_SKILLS.length}):`,
+        ...lines,
+        "",
+        "Invoke a skill with its slash command, e.g. /develop or /idea.",
+    ].join("\n");
+}
+// Sum a count across every project bucket in a tracker Record.
+function countTracker(tracker, key) {
+    if (!tracker)
+        return 0;
+    return Object.values(tracker).reduce((total, project) => {
+        const items = key === "ideas" ? project.ideas : project.tasks;
+        return total + (items?.length ?? 0);
+    }, 0);
+}
+function formatStatus(checkin, connectionStatus) {
+    const ideaCount = countTracker(checkin?.ideaTracker, "ideas");
+    const lines = [
+        `Connection: ${connectionStatus}`,
+        `Agent: ${checkin?.agent?.name ?? "unknown"}`,
+        `Assigned ideas: ${ideaCount}`,
+        `Notifications: ${checkin?.notifications?.unread ?? 0} unread`,
+        `Skills: ${PLUGIN_SKILLS.map((s) => s.name).join(", ")}`,
+    ];
+    return lines.join("\n");
+}
+function formatTaskList(taskTracker) {
+    const lines = [];
+    let total = 0;
+    for (const project of Object.values(taskTracker ?? {})) {
+        for (const t of project.tasks ?? []) {
+            total += 1;
+            const ac = t.ac && typeof t.ac.total === "number" && t.ac.total > 0
+                ? ` (AC ${t.ac.passed ?? 0}/${t.ac.total})`
+                : "";
+            lines.push(`[${t.status}] [${t.priority}] ${t.title}  (${project.name})${ac}`);
+        }
+    }
+    if (total === 0) {
+        return "No assigned tasks.";
+    }
+    return `Assigned tasks (${total}):\n${lines.join("\n")}`;
+}
+function formatIdeaList(ideaTracker) {
+    const lines = [];
+    let total = 0;
+    for (const project of Object.values(ideaTracker ?? {})) {
+        for (const i of project.ideas ?? []) {
+            total += 1;
+            lines.push(`[${i.status}] ${i.title}  (${project.name})`);
+        }
+    }
+    if (total === 0) {
+        return "No assigned ideas.";
+    }
+    return `Assigned ideas (${total}):\n${lines.join("\n")}`;
+}
+const HELP_TEXT = [
+    "Chorus commands:",
+    "  /chorus           Show connection status and summary",
+    "  /chorus status    Same as above",
+    "  /chorus tasks     List assigned tasks",
+    "  /chorus ideas     List assigned ideas",
+    "  /chorus skills    List available Chorus skills",
+].join("\n");
+function errorText(prefix, err) {
+    const detail = err instanceof Error ? err.message : String(err);
+    return `${prefix}: ${detail}`;
+}
+// ===== Registration =====
+export function registerChorusCommands(api, mcpClient, getStatus) {
+    api.registerCommand({
+        name: "chorus",
+        description: "Chorus plugin commands: status, tasks, ideas, skills",
+        acceptsArgs: true,
+        async handler(ctx) {
+            const sub = (ctx.args ?? "").trim().toLowerCase();
+            // /chorus or /chorus status — connection + checkin summary via slim client.
+            if (!sub || sub === "status") {
+                try {
+                    const checkin = (await mcpClient.callTool("chorus_checkin", {}));
+                    return { text: formatStatus(checkin, getStatus()) };
+                }
+                catch (err) {
+                    return { text: errorText("Failed to check in", err), isError: true };
+                }
+            }
+            // /chorus tasks — assigned tasks via chorus_get_my_assignments.
+            if (sub === "tasks") {
+                try {
+                    const data = (await mcpClient.callTool("chorus_get_my_assignments", {}));
+                    return { text: formatTaskList(data?.taskTracker) };
+                }
+                catch (err) {
+                    return { text: errorText("Failed to fetch tasks", err), isError: true };
+                }
+            }
+            // /chorus ideas — assigned ideas via chorus_get_my_assignments.
+            if (sub === "ideas") {
+                try {
+                    const data = (await mcpClient.callTool("chorus_get_my_assignments", {}));
+                    return { text: formatIdeaList(data?.ideaTracker) };
+                }
+                catch (err) {
+                    return { text: errorText("Failed to fetch ideas", err), isError: true };
+                }
+            }
+            // /chorus skills — static catalog of all 9 bundled skills.
+            if (sub === "skills") {
+                return { text: formatSkillsList() };
+            }
+            // Unknown subcommand → help.
+            return { text: HELP_TEXT };
+        },
+    });
+}
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,38 @@
+import { z } from "zod";
+export declare const CONFIG_FILE_PATH = "~/.openclaw/openclaw.json";
+export declare const CONFIG_KEY_PATH = "plugins.entries.chorus-openclaw-plugin.config";
+/**
+ * In-code zod schema for typing `api.pluginConfig`.
+ *
+ * The canonical config contract is the JSON-Schema `configSchema` in
+ * `openclaw.plugin.json`, which OpenClaw validates BEFORE plugin code runs.
+ * This zod schema exists only for in-code typing and friendly missing-field
+ * messages — its accepted property set (chorusUrl, apiKey) MUST stay identical
+ * to the manifest `configSchema.properties`.
+ */
+export declare const chorusConfigSchema: z.ZodObject<{
+    chorusUrl: z.ZodOptional<z.ZodString>;
+    apiKey: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    chorusUrl?: string | undefined;
+    apiKey?: string | undefined;
+}, {
+    chorusUrl?: string | undefined;
+    apiKey?: string | undefined;
+}>;
+export type ChorusPluginConfig = z.infer<typeof chorusConfigSchema>;
+/**
+ * Normalize a raw `api.pluginConfig` bag into a typed `ChorusPluginConfig`.
+ *
+ * The host has already validated the bag against the manifest JSON Schema, so
+ * this only fills defaults and narrows types; it does not re-validate shape.
+ */
+export declare function resolveConfig(pluginConfig: Record<string, unknown> | undefined): ChorusPluginConfig;
+/**
+ * Check required config fields and warn about missing ones.
+ * Returns true if all required fields are present, false otherwise.
+ */
+export declare function validateConfigWithWarnings(config: ChorusPluginConfig, logger: {
+    warn: (msg: string) => void;
+}): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB,8BAA8B,CAAC;AAC5D,eAAO,MAAM,eAAe,kDAAkD,CAAC;AAE/E;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;EAW7B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,kBAAkB,CAMnG;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GACtC,OAAO,CAkBT"}

package/dist/config.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+export const CONFIG_FILE_PATH = "~/.openclaw/openclaw.json";
+export const CONFIG_KEY_PATH = "plugins.entries.chorus-openclaw-plugin.config";
+/**
+ * In-code zod schema for typing `api.pluginConfig`.
+ *
+ * The canonical config contract is the JSON-Schema `configSchema` in
+ * `openclaw.plugin.json`, which OpenClaw validates BEFORE plugin code runs.
+ * This zod schema exists only for in-code typing and friendly missing-field
+ * messages — its accepted property set (chorusUrl, apiKey) MUST stay identical
+ * to the manifest `configSchema.properties`.
+ */
+export const chorusConfigSchema = z.object({
+    chorusUrl: z
+        .string()
+        .url()
+        .optional()
+        .describe("Chorus server URL (e.g. https://chorus.example.com)"),
+    apiKey: z
+        .string()
+        .startsWith("cho_")
+        .optional()
+        .describe("Chorus API Key (cho_ prefix)"),
+});
+/**
+ * Normalize a raw `api.pluginConfig` bag into a typed `ChorusPluginConfig`.
+ *
+ * The host has already validated the bag against the manifest JSON Schema, so
+ * this only fills defaults and narrows types; it does not re-validate shape.
+ */
+export function resolveConfig(pluginConfig) {
+    const raw = pluginConfig ?? {};
+    return {
+        chorusUrl: raw.chorusUrl || undefined,
+        apiKey: raw.apiKey || undefined,
+    };
+}
+/**
+ * Check required config fields and warn about missing ones.
+ * Returns true if all required fields are present, false otherwise.
+ */
+export function validateConfigWithWarnings(config, logger) {
+    const missing = [];
+    if (!config.chorusUrl) {
+        missing.push(`  - "chorusUrl": set at ${CONFIG_KEY_PATH}.chorusUrl in ${CONFIG_FILE_PATH}`);
+    }
+    if (!config.apiKey) {
+        missing.push(`  - "apiKey": set at ${CONFIG_KEY_PATH}.apiKey in ${CONFIG_FILE_PATH}`);
+    }
+    if (missing.length > 0) {
+        logger.warn(`[Chorus] Plugin is missing required configuration. Features will be disabled until configured:\n` +
+            missing.join("\n"));
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,gBAAgB,GAAG,2BAA2B,CAAC;AAC5D,MAAM,CAAC,MAAM,eAAe,GAAG,+CAA+C,CAAC;AAE/E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,CAAC,qDAAqD,CAAC;IAClE,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,UAAU,CAAC,MAAM,CAAC;SAClB,QAAQ,EAAE;SACV,QAAQ,CAAC,8BAA8B,CAAC;CAC5C,CAAC,CAAC;AAIH;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,YAAiD;IAC7E,MAAM,GAAG,GAAG,YAAY,IAAI,EAAE,CAAC;IAC/B,OAAO;QACL,SAAS,EAAG,GAAG,CAAC,SAAgC,IAAI,SAAS;QAC7D,MAAM,EAAG,GAAG,CAAC,MAA6B,IAAI,SAAS;KACxD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAA0B,EAC1B,MAAuC;IAEvC,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,2BAA2B,eAAe,iBAAiB,gBAAgB,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,wBAAwB,eAAe,cAAc,gBAAgB,EAAE,CAAC,CAAC;IACxF,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CACT,kGAAkG;YAClG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CACnB,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/event-router.d.ts

@@ -0,0 +1,55 @@
+import type { ChorusMcpClient } from "./mcp-client.js";
+import type { SseNotificationEvent } from "./sse-listener.js";
+/**
+ * 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`).
+ *
+ * `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.
+ */
+export type ChorusWakeFn = (message: string, contextKey: string) => void;
+export interface ChorusEventRouterOptions {
+    mcpClient: ChorusMcpClient;
+    wake: ChorusWakeFn;
+    logger: {
+        info: (msg: string) => void;
+        warn: (msg: string) => void;
+        error: (msg: string) => void;
+    };
+}
+export declare class ChorusEventRouter {
+    private readonly mcpClient;
+    private readonly wake;
+    private readonly logger;
+    constructor(opts: ChorusEventRouterOptions);
+    /**
+     * Route an incoming SSE notification event to the appropriate handler.
+     * Never throws — all errors are caught and logged internally.
+     */
+    dispatch(event: SseNotificationEvent): void;
+    /**
+     * Build the dedupe contextKey for a notification. Identical action+entity
+     * bursts collapse to the same key so OpenClaw's queue suppresses the
+     * duplicate wake.
+     */
+    private contextKeyFor;
+    private fetchAndRoute;
+    /**
+     * Build @mention guidance for agent messages.
+     * Instructs the agent to @mention the actor after completing work.
+     */
+    private buildMentionGuidance;
+    private handleTaskAssigned;
+    private handleMentioned;
+    private handleElaborationRequested;
+    private handleProposalRejected;
+    private handleProposalApproved;
+    private handleIdeaClaimed;
+    private handleTaskVerified;
+    private handleTaskReopened;
+    private handleElaborationAnswered;
+}
+//# sourceMappingURL=event-router.d.ts.map

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

@@ -0,0 +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"}

package/dist/event-router.js

@@ -0,0 +1,157 @@
+export class ChorusEventRouter {
+    mcpClient;
+    wake;
+    logger;
+    constructor(opts) {
+        this.mcpClient = opts.mcpClient;
+        this.wake = opts.wake;
+        this.logger = opts.logger;
+    }
+    /**
+     * Route an incoming SSE notification event to the appropriate handler.
+     * Never throws — all errors are caught and logged internally.
+     */
+    dispatch(event) {
+        // Only handle new_notification events (ignore count_update, etc.)
+        if (event.type !== "new_notification") {
+            this.logger.info(`SSE event type "${event.type}" ignored`);
+            return;
+        }
+        if (!event.notificationUuid) {
+            this.logger.warn("new_notification event missing notificationUuid, skipping");
+            return;
+        }
+        // Fetch full notification details and route asynchronously
+        this.fetchAndRoute(event.notificationUuid).catch((err) => {
+            this.logger.error(`Failed to fetch/route notification ${event.notificationUuid}: ${err}`);
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Internal
+    // ---------------------------------------------------------------------------
+    /**
+     * Build the dedupe contextKey for a notification. Identical action+entity
+     * bursts collapse to the same key so OpenClaw's queue suppresses the
+     * duplicate wake.
+     */
+    contextKeyFor(action, entityUuid) {
+        return `chorus:${action}:${entityUuid}`;
+    }
+    async fetchAndRoute(notificationUuid) {
+        // Fetch notification details via MCP — use autoMarkRead=false so we don't
+        // consume all unread notifications, and status=unread since we just received it
+        const result = await this.mcpClient.callTool("chorus_get_notifications", {
+            status: "unread",
+            limit: 50,
+            autoMarkRead: false,
+        });
+        const notifications = result?.notifications;
+        if (!notifications || !Array.isArray(notifications)) {
+            this.logger.warn(`Could not fetch notifications list`);
+            return;
+        }
+        const notification = notifications.find((n) => n.uuid === notificationUuid);
+        if (!notification) {
+            this.logger.warn(`Notification ${notificationUuid} not found in unread list`);
+            return;
+        }
+        // Route based on action (which corresponds to notificationType)
+        try {
+            switch (notification.action) {
+                case "task_assigned":
+                    this.handleTaskAssigned(notification);
+                    break;
+                case "mentioned":
+                    this.handleMentioned(notification);
+                    break;
+                case "elaboration_requested":
+                    this.handleElaborationRequested(notification);
+                    break;
+                case "elaboration_answered":
+                    this.handleElaborationAnswered(notification);
+                    break;
+                case "proposal_rejected":
+                    this.handleProposalRejected(notification);
+                    break;
+                case "proposal_approved":
+                    this.handleProposalApproved(notification);
+                    break;
+                case "idea_claimed":
+                    this.handleIdeaClaimed(notification);
+                    break;
+                case "task_verified":
+                    this.handleTaskVerified(notification);
+                    break;
+                case "task_reopened":
+                    this.handleTaskReopened(notification);
+                    break;
+                default:
+                    this.logger.info(`Unhandled notification action: "${notification.action}"`);
+                    break;
+            }
+        }
+        catch (err) {
+            this.logger.error(`Error handling ${notification.action} notification: ${err}`);
+        }
+    }
+    /**
+     * Build @mention guidance for agent messages.
+     * Instructs the agent to @mention the actor after completing work.
+     */
+    buildMentionGuidance(n, entityType) {
+        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) {
+        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));
+    }
+    handleMentioned(n) {
+        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));
+    }
+    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));
+    }
+    handleProposalRejected(n) {
+        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));
+    }
+    handleProposalApproved(n) {
+        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));
+    }
+    handleIdeaClaimed(n) {
+        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));
+    }
+    handleTaskVerified(n) {
+        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));
+    }
+    handleTaskReopened(n) {
+        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));
+    }
+    handleElaborationAnswered(n) {
+        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));
+    }
+}
+//# sourceMappingURL=event-router.js.map

package/dist/event-router.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("openclaw/plugin-sdk/plugin-entry").DefinedPluginEntry;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,108 @@
+import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
+import { resolveConfig, validateConfigWithWarnings } from "./config.js";
+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 { registerChorusCommands } from "./commands.js";
+/**
+ * JSON-Schema config contract for the Chorus plugin.
+ *
+ * This mirrors the canonical `configSchema` in `openclaw.plugin.json`
+ * (the manifest is validated by the host BEFORE this code loads). Keep the two
+ * in sync: same property set, same `additionalProperties: false`.
+ */
+const CHORUS_JSON_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+        chorusUrl: {
+            type: "string",
+            description: "Chorus server URL (e.g. https://chorus.example.com)",
+        },
+        apiKey: {
+            type: "string",
+            description: "Chorus API Key (cho_ prefix)",
+        },
+    },
+};
+export default definePluginEntry({
+    id: "chorus-openclaw-plugin",
+    name: "Chorus",
+    description: "Chorus AI-DLC collaboration platform — native MCP + SSE real-time events",
+    configSchema: {
+        jsonSchema: CHORUS_JSON_SCHEMA,
+        uiHints: { apiKey: { sensitive: true } },
+    },
+    register(api) {
+        // 1. Discovery-mode guard: heavy runtime wiring (MCP connect, SSE socket,
+        //    config mutation) must run ONLY in "full" registration mode. In
+        //    discovery / cli-metadata / setup-* modes we declare nothing heavy.
+        if (api.registrationMode !== "full")
+            return;
+        // 2. Resolve + validate config from the host-validated pluginConfig bag.
+        const config = resolveConfig(api.pluginConfig);
+        const logger = api.logger;
+        if (!validateConfigWithWarnings(config, logger)) {
+            return;
+        }
+        // After validateConfigWithWarnings, chorusUrl and apiKey are present.
+        const chorusUrl = config.chorusUrl;
+        const apiKey = config.apiKey;
+        logger.info(`Chorus plugin initializing — ${chorusUrl}`);
+        // 3. Ensure the Chorus MCP server is registered with OpenClaw so the agent
+        //    gains native chorus__* tools (fire-and-log; real impl in sibling task).
+        void ensureChorusMcpServer(api, config).catch((err) => logger.error(`MCP registration failed: ${err}`));
+        // 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.
+        const eventRouter = new ChorusEventRouter({
+            mcpClient,
+            logger,
+            wake: createWake(api, logger),
+        });
+        // 6. Background SSE service. The SSE socket opens only inside start(), which
+        //    the host calls in full mode — keeping the heavy socket gated.
+        let sseListener = null;
+        api.registerService({
+            id: "chorus-sse",
+            async start() {
+                sseListener = new ChorusSseListener({
+                    chorusUrl,
+                    apiKey,
+                    logger,
+                    onEvent: (event) => eventRouter.dispatch(event),
+                    onReconnect: async () => {
+                        try {
+                            const result = (await mcpClient.callTool("chorus_get_notifications", {
+                                status: "unread",
+                                autoMarkRead: false,
+                            }));
+                            const count = result?.notifications?.length ?? 0;
+                            if (count > 0) {
+                                logger.info(`SSE reconnect: ${count} unread notifications to process`);
+                            }
+                        }
+                        catch (err) {
+                            logger.warn(`Failed to back-fill notifications: ${err}`);
+                        }
+                    },
+                });
+                await sseListener.connect();
+            },
+            async stop() {
+                sseListener?.disconnect();
+                await mcpClient.disconnect();
+            },
+        });
+        // 7. /chorus command (status | tasks | ideas | skills).
+        registerChorusCommands(api, mcpClient, () => sseListener?.status ?? "disconnected");
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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