@chorus-aidlc/chorus-openclaw-plugin 0.1.1 → 0.1.3

package/README.md

@@ -60,29 +60,41 @@ Chorus Server
 
 ## Installation
 
-### From local path (development)
+### 1. Install the plugin
 
-Add to your `~/.openclaw/openclaw.json`:
+```bash
+openclaw plugins install @chorus-aidlc/chorus-openclaw-plugin
+```
+
+### 2. Enable hooks
+
+Hooks are required for the agent wake mechanism. Add to your `~/.openclaw/openclaw.json`:
 
 ```json
 {
   "hooks": {
     "enabled": true,
     "token": "your-hooks-token"
-  },
+  }
+}
+```
+
+> The `hooks.token` must be different from `gateway.auth.token`.
+
+### 3. Configure the plugin
+
+Add the plugin entry to `~/.openclaw/openclaw.json`:
+
+```json
+{
   "plugins": {
     "enabled": true,
-    "allow": ["@chorus-aidlc/chorus-openclaw-plugin"],
-    "load": {
-      "paths": ["/path/to/openclaw-plugin"]
-    },
     "entries": {
-      "@chorus-aidlc/chorus-openclaw-plugin": {
+      "chorus-openclaw-plugin": {
         "enabled": true,
         "config": {
           "chorusUrl": "https://chorus.example.com",
           "apiKey": "cho_your_api_key_here",
-          "projectUuids": [],
           "autoStart": true
         }
       }
@@ -91,13 +103,6 @@ Add to your `~/.openclaw/openclaw.json`:
 }
 ```
 
-### From npm (planned)
-
-```bash
-# Coming soon
-pnpm add @chorus-aidlc/chorus-openclaw-plugin
-```
-
 ## Configuration
 
 | Field | Type | Required | Default | Description |
@@ -247,24 +252,10 @@ Wraps `@modelcontextprotocol/sdk` with:
 - Routes by notification `action` type
 - All handlers catch errors internally — never crashes the gateway
 
-## Development
-
-```bash
-# In the openclaw-plugin directory
-pnpm install
-pnpm dev          # Watch mode (tsc --watch)
-pnpm build        # Production build
-
-# Test with OpenClaw gateway
-cd /path/to/openclaw && node openclaw.mjs gateway
-```
-
-No build step needed for development — OpenClaw loads `.ts` files directly via `jiti`.
-
 ## Troubleshooting
 
 ### "plugin id mismatch" warning
-Ensure `package.json` `name`, `openclaw.plugin.json` `id`, and `index.ts` `id` all match `@chorus-aidlc/chorus-openclaw-plugin`.
+Ensure `openclaw.plugin.json` `id` and `index.ts` `id` both equal `chorus-openclaw-plugin`.
 
 ### "Wake agent failed: HTTP 405"
 Hooks are not enabled. Add to `openclaw.json`:
@@ -282,6 +273,38 @@ OpenClaw tool `execute` signature is `execute(toolCallId, params)` — the first
 ### Bedrock "inputSchema.json.type must be object"
 All tool `parameters` must be full JSON Schema with `type: "object"` at the top level, not shorthand `{ key: { type: "string" } }`.
 
+## Appendix: Local Development Install
+
+If you're developing the plugin from the Chorus repo source:
+
+```bash
+# No build needed — OpenClaw loads .ts files directly via jiti
+cd /path/to/Chorus/packages/openclaw-plugin
+```
+
+Add to `~/.openclaw/openclaw.json`:
+
+```json
+{
+  "plugins": {
+    "enabled": true,
+    "load": {
+      "paths": ["/path/to/Chorus/packages/openclaw-plugin"]
+    },
+    "entries": {
+      "chorus-openclaw-plugin": {
+        "enabled": true,
+        "config": {
+          "chorusUrl": "http://localhost:3000",
+          "apiKey": "cho_your_dev_key",
+          "autoStart": true
+        }
+      }
+    }
+  }
+}
+```
+
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chorus-aidlc/chorus-openclaw-plugin",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "OpenClaw plugin for Chorus AI-DLC collaboration platform — SSE real-time events + MCP tool integration",
   "license": "MIT",
   "type": "module",

package/src/commands.ts

@@ -49,14 +49,14 @@ interface AssignmentsResponse {
 function formatStatus(checkin: CheckinResponse, connectionStatus: string): string {
   const lines: string[] = [
     `Connection: ${connectionStatus}`,
-    `Assignments: ${checkin.pending.ideasCount} ideas, ${checkin.pending.tasksCount} tasks`,
-    `Notifications: ${checkin.notifications.unreadCount} unread`,
+    `Assignments: ${checkin?.pending?.ideasCount ?? 0} ideas, ${checkin?.pending?.tasksCount ?? 0} tasks`,
+    `Notifications: ${checkin?.notifications?.unreadCount ?? 0} unread`,
   ];
   return lines.join("\n");
 }
 
-function formatTaskList(tasks: AssignedTask[]): string {
-  if (tasks.length === 0) {
+function formatTaskList(tasks: AssignedTask[] | undefined): string {
+  if (!tasks?.length) {
     return "No assigned tasks.";
   }
 
@@ -66,8 +66,8 @@ function formatTaskList(tasks: AssignedTask[]): string {
   return `Assigned tasks (${tasks.length}):\n${lines.join("\n")}`;
 }
 
-function formatIdeaList(ideas: AssignedIdea[]): string {
-  if (ideas.length === 0) {
+function formatIdeaList(ideas: AssignedIdea[] | undefined): string {
+  if (!ideas?.length) {
     return "No assigned ideas.";
   }
 
@@ -115,7 +115,7 @@ export function registerChorusCommands(
             "chorus_get_my_assignments",
             {}
           )) as AssignmentsResponse;
-          return { text: formatTaskList(data.tasks) };
+          return { text: formatTaskList(data?.tasks) };
         } catch (err) {
           return { text: `Failed to fetch tasks: ${err instanceof Error ? err.message : String(err)}` };
         }
@@ -128,7 +128,7 @@ export function registerChorusCommands(
             "chorus_get_my_assignments",
             {}
           )) as AssignmentsResponse;
-          return { text: formatIdeaList(data.ideas) };
+          return { text: formatIdeaList(data?.ideas) };
         } catch (err) {
           return { text: `Failed to fetch ideas: ${err instanceof Error ? err.message : String(err)}` };
         }

package/src/event-router.ts

@@ -38,7 +38,7 @@ export class ChorusEventRouter {
     this.config = opts.config;
     this.triggerAgent = opts.triggerAgent;
     this.logger = opts.logger;
-    this.projectFilter = new Set(opts.config.projectUuids);
+    this.projectFilter = new Set(opts.config.projectUuids ?? []);
   }
 
   /**

package/src/index.ts

@@ -48,9 +48,20 @@ const plugin = {
   configSchema: chorusConfigSchema,
 
   register(api: OpenClawPluginApi) {
-    const config = api.pluginConfig as ChorusPluginConfig;
+    const rawConfig = api.pluginConfig ?? {};
+    const config: ChorusPluginConfig = {
+      chorusUrl: rawConfig.chorusUrl ?? "",
+      apiKey: rawConfig.apiKey ?? "",
+      projectUuids: rawConfig.projectUuids ?? [],
+      autoStart: rawConfig.autoStart ?? true,
+    };
     const logger = api.logger;
 
+    if (!config.chorusUrl || !config.apiKey) {
+      logger.error("Chorus plugin missing required config: chorusUrl and apiKey");
+      return;
+    }
+
     // Resolve gateway URL and hooks token from OpenClaw config
     const gatewayPort = api.config?.gateway?.port ?? 18789;
     const gatewayUrl = `http://127.0.0.1:${gatewayPort}`;