@canonmsg/codex-plugin 0.3.0 → 0.4.0

package/README.md

@@ -22,6 +22,8 @@ canon-codex --cwd /path/to/project
 
 Registration saves a Canon profile in `~/.canon/agents.json`, the same shared profile store used by the Claude Code integration and supported by the OpenClaw plugin.
 
+If the terminal closes or the machine restarts, the agent goes offline until you start the host again. To bring back the same registered agent, rerun `canon-codex --cwd /path/to/project`. Do not run registration again unless Canon tells you the saved API key is invalid. If you registered multiple profiles, relaunch the same one with `CANON_AGENT=<profile> canon-codex --cwd /path/to/project`.
+
 You do not need a git repo for host mode. The plugin passes `--skip-git-repo-check` to Codex, so any readable working directory is valid.
 
 ## What v1 supports
@@ -71,6 +73,12 @@ If you installed the package only inside this repo and not globally, run the bui
 node packages/codex-plugin/dist/host.js --cwd /path/to/project --full-auto
 ```
 
+If `canon-codex` starts but cannot find the `codex` binary, either fix your `PATH` or launch with an explicit binary path:
+
+```bash
+canon-codex --cwd /path/to/project --codex-bin /absolute/path/to/codex
+```
+
 If Canon rejects authenticated requests with `401 Invalid API key`, the stored Canon profile needs a fresh key. Rerun registration for the same profile to overwrite `~/.canon/agents.json`, then restart the host:
 
 ```bash

package/dist/host.js

@@ -561,6 +561,20 @@ async function main() {
             }
         }
     }
+    let controlStopped = false;
+    let streamConnected = false;
+    let runtimeDescriptor = {
+        defaultWorkspaceId: workspaceOptions[0]?.id,
+        ...(typeof args.model === 'string' ? { defaultModel: args.model } : {}),
+        availableWorkspaces: buildPublicWorkspaceOptions(workspaceOptions),
+    };
+    const publishRuntimeHeartbeat = async () => {
+        if (!streamConnected)
+            return;
+        await publishAgentRuntime(agentId, runtimeDescriptor).catch((error) => {
+            console.error('[canon-codex] Failed to publish agent runtime:', error);
+        });
+    };
     const stream = new CanonStream({
         apiKey,
         agentId,
@@ -577,20 +591,31 @@ async function main() {
                     behavior: payload.behavior,
                 });
             },
-            onConnected: () => console.error('[canon-codex] SSE connected'),
-            onDisconnected: () => console.error('[canon-codex] SSE disconnected'),
+            onConnected: () => {
+                streamConnected = true;
+                void publishRuntimeHeartbeat();
+                console.error('[canon-codex] SSE connected');
+            },
+            onDisconnected: () => {
+                streamConnected = false;
+                rtdbWrite(`/agent-runtime/${agentId}`, null).catch(() => { });
+                console.error('[canon-codex] SSE disconnected');
+            },
             onError: (error) => console.error(`[canon-codex] SSE error: ${error.message}`),
         },
     });
     try {
-        await publishAgentRuntime(agentId, {
+        runtimeDescriptor = {
             defaultWorkspaceId: workspaceOptions[0]?.id,
             ...(typeof args.model === 'string' ? { defaultModel: args.model } : {}),
             availableWorkspaces: buildPublicWorkspaceOptions(workspaceOptions),
-        });
+        };
     }
-    catch (error) {
-        console.error('[canon-codex] Failed to publish agent runtime:', error);
+    catch {
+        runtimeDescriptor = {
+            defaultWorkspaceId: workspaceOptions[0]?.id,
+            availableWorkspaces: buildPublicWorkspaceOptions(workspaceOptions),
+        };
     }
     try {
         const conversations = await client.getConversations();
@@ -634,7 +659,6 @@ async function main() {
     await stream.start().catch((error) => {
         console.error('[canon-codex] SSE start error:', error instanceof Error ? error.message : error);
     });
-    let controlStopped = false;
     const lastSeenControl = new Map();
     const lastSeenSignal = new Map();
     const pollControl = async () => {
@@ -700,6 +724,7 @@ async function main() {
             writeState(session);
             writeTurn(session);
         }
+        void publishRuntimeHeartbeat();
     }, HEARTBEAT_MS);
     const idleCheck = setInterval(() => {
         const now = Date.now();
@@ -719,6 +744,7 @@ async function main() {
         clearInterval(heartbeat);
         clearInterval(idleCheck);
         stream.stop();
+        await rtdbWrite(`/agent-runtime/${agentId}`, null).catch(() => { });
         for (const session of [...sessions.values()]) {
             await session.adapter.interrupt().catch(() => { });
             closeSession(session.conversationId);

package/dist/register.js

@@ -23,6 +23,14 @@ if (!values.name || !values.description || !values.phone) {
     process.exit(1);
 }
 const profileName = values.profile || values.name.toLowerCase().replace(/[^a-z0-9-]/g, '-').replace(/-+/g, '-');
+let existingAgentId;
+try {
+    const profiles = JSON.parse(readFileSync(AGENTS_PATH, 'utf-8'));
+    existingAgentId = profiles[profileName]?.agentId;
+}
+catch {
+    // No existing profile state.
+}
 console.log(`Registering Codex agent "${values.name}" (profile: ${profileName})...`);
 const result = await registerAndWaitForApproval({
     name: values.name,
@@ -31,6 +39,7 @@ const result = await registerAndWaitForApproval({
     developerInfo: 'Codex host plugin',
     clientType: 'codex',
     baseUrl: values['base-url'],
+    requestedAgentId: existingAgentId,
 }, {
     onSubmitted: (requestId) => {
         console.log(`Registration submitted (request ID: ${requestId}).`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonmsg/codex-plugin",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Canon host integration for Codex CLI",
   "type": "module",
   "main": "dist/host.js",
@@ -22,7 +22,7 @@
     "prepack": "npm run build"
   },
   "dependencies": {
-    "@canonmsg/core": "^0.4.0"
+    "@canonmsg/core": "^0.5.0"
   },
   "engines": {
     "node": ">=18.0.0"