@canonmsg/claude-code-plugin 0.9.0 → 0.9.2

package/dist/cli-entry.d.ts

@@ -0,0 +1,2 @@
+export declare function isDirectExecution(moduleUrl: string): boolean;
+export declare function runCli(moduleUrl: string, main: () => void | Promise<void>, onError: (error: unknown) => void): void;

package/dist/cli-entry.js

@@ -0,0 +1,16 @@
+import { resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+export function isDirectExecution(moduleUrl) {
+    const entry = process.argv[1];
+    if (!entry)
+        return false;
+    return pathToFileURL(resolve(entry)).href === moduleUrl;
+}
+export function runCli(moduleUrl, main, onError) {
+    if (!isDirectExecution(moduleUrl)) {
+        return;
+    }
+    Promise.resolve()
+        .then(() => main())
+        .catch(onError);
+}

package/dist/host-runtime.d.ts

@@ -28,9 +28,6 @@ export interface HostInboundParticipantContext {
 type HostInboundMessage = {
     text?: string | null;
     contentType?: CanonMessage['contentType'] | null;
-    audioUrl?: string | null;
-    audioDurationMs?: number | null;
-    imageUrl?: string | null;
     attachments?: CanonMessage['attachments'];
     senderType?: CanonMessage['senderType'];
     mentions?: string[] | null;

package/dist/host-runtime.js

@@ -50,21 +50,10 @@ export function renderCanonHostInboundContent(message, materialized) {
     const body = message.text || '';
     const placeholders = [];
     const attachments = message.attachments ?? [];
-    if (attachments.length > 0) {
-        for (let i = 0; i < attachments.length; i += 1) {
-            const att = attachments[i];
-            const mat = materialized?.find((m) => m.index === i) ?? null;
-            placeholders.push(describeAttachment(att, mat));
-        }
-    }
-    else if (message.contentType === 'audio' && message.audioUrl) {
-        const duration = message.audioDurationMs
-            ? ` (${Math.round(message.audioDurationMs / 1000)}s)`
-            : '';
-        placeholders.push(`[Voice message${duration}]`);
-    }
-    else if (message.contentType === 'image' && message.imageUrl) {
-        placeholders.push('[Image attached]');
+    for (let i = 0; i < attachments.length; i += 1) {
+        const att = attachments[i];
+        const mat = materialized?.find((m) => m.index === i) ?? null;
+        placeholders.push(describeAttachment(att, mat));
     }
     const rendered = [...placeholders, body].filter(Boolean).join('\n');
     return rendered || '[Empty message]';

package/dist/host.d.ts

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-export {};
+export declare function main(): Promise<void>;

package/dist/host.js

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
 import { setDefaultResultOrder } from 'node:dns';
-setDefaultResultOrder('ipv4first');
 /**
  * Canon Agent SDK host wrapper — multi-session.
  *
@@ -28,6 +27,8 @@ import { isAnthropicImageAttachment, materializeMessageMedia, toAnthropicImageBl
 import { buildConfiguredWorkspaceOptions, buildConversationEnvironmentKey, buildPublicWorkspaceOptions, EXECUTION_ENVIRONMENT_MODES, isEnabledFlag, CanonClient, CanonStream, clearTurnState, DEFAULT_PARTICIPATION_HISTORY_FETCH_LIMIT, DEFAULT_RUNTIME_CAPABILITIES, ExecutionEnvironmentError, FINAL_MESSAGE_HANDOFF_MS, normalizeTurnMetadata, prepareConversationEnvironment, resolveCanonAgent, getActiveProfile, releaseLock, initRTDBAuth, rtdbRead, rtdbWrite, writeSessionState, clearSessionState, writeTurnState, releaseConversationEnvironment, } from '@canonmsg/core';
 import { buildCanonHostPrompt, buildHydratedInboundContext, createConversationMetadataLoader, loadHostSessionConfig, publishHostAgentRuntime, renderCanonHostInboundContent, resolveHostWorkspaceCwd, } from './host-runtime.js';
 import { buildInboundContextLines, decideAutoReply, } from './inbound-policy.js';
+import { createStreamingBuffer } from './streaming-buffer.js';
+import { runCli } from './cli-entry.js';
 let workingDir = process.cwd();
 let workspaceOptions = [];
 let runtimeModels = [];
@@ -299,31 +300,33 @@ function createSession(conversationId, environment, agentId, client, onSessionEn
         sdkSessionId: resumeSessionId || null,
         pendingReply: null,
     };
+    const streamingBuffer = createStreamingBuffer({
+        throttleMs: STREAMING_THROTTLE_MS,
+        getText: () => session.streamingText,
+        setText: (text) => {
+            session.streamingText = text;
+        },
+        getTimer: () => session.streamingTimer,
+        setTimer: (timer) => {
+            session.streamingTimer = timer;
+        },
+        onWrite: (text) => {
+            rtdbWrite(`/streaming/${conversationId}/${agentId}`, {
+                text,
+                status: 'streaming',
+                updatedAt: { '.sv': 'timestamp' },
+            }).catch(() => { });
+        },
+    });
     // ── Per-session streaming helpers ──
     function flushStreaming() {
-        if (!session.streamingText)
-            return;
-        rtdbWrite(`/streaming/${conversationId}/${agentId}`, {
-            text: session.streamingText,
-            status: 'streaming',
-            updatedAt: { '.sv': 'timestamp' },
-        }).catch(() => { });
+        streamingBuffer.flush();
     }
     function onStreamDelta(text) {
-        session.streamingText += text;
-        if (!session.streamingTimer) {
-            session.streamingTimer = setTimeout(() => {
-                session.streamingTimer = null;
-                flushStreaming();
-            }, STREAMING_THROTTLE_MS);
-        }
+        streamingBuffer.append(text);
     }
     function clearStreaming() {
-        if (session.streamingTimer) {
-            clearTimeout(session.streamingTimer);
-            session.streamingTimer = null;
-        }
-        session.streamingText = '';
+        streamingBuffer.clear();
         rtdbWrite(`/streaming/${conversationId}/${agentId}`, null).catch(() => { });
     }
     function clearIdleResetTimer() {
@@ -367,8 +370,7 @@ function createSession(conversationId, environment, agentId, client, onSessionEn
         session.pendingFinalDeliveryText = finalText;
         session.state.state = 'running';
         session.turnState = 'streaming';
-        session.streamingText = finalText;
-        flushStreaming();
+        streamingBuffer.replace(finalText);
         writeState();
         writeTurn();
         client.setTyping(conversationId, true, 'typing').catch(() => { });
@@ -664,7 +666,8 @@ function createSession(conversationId, environment, agentId, client, onSessionEn
     return session;
 }
 // ── Main ────────────────────────────────────────────────────────────
-async function main() {
+export async function main() {
+    setDefaultResultOrder('ipv4first');
     const { values: args } = parseArgs({
         options: {
             cwd: { type: 'string' },
@@ -783,6 +786,8 @@ async function main() {
         }
         if (session.streamingTimer)
             clearTimeout(session.streamingTimer);
+        session.streamingText = '';
+        rtdbWrite(`/streaming/${conversationId}/${agentId}`, null).catch(() => { });
         if (session.idleResetTimer) {
             clearTimeout(session.idleResetTimer);
             session.idleResetTimer = null;
@@ -791,7 +796,6 @@ async function main() {
             clearTimeout(session.finalDeliveryTimer);
             session.finalDeliveryTimer = null;
         }
-        rtdbWrite(`/streaming/${conversationId}/${agentId}`, null).catch(() => { });
         clearSessionState(conversationId, agentId).catch(() => { });
         clearTurnState(conversationId, agentId).catch(() => { });
         client.setTyping(conversationId, false).catch(() => { });
@@ -911,10 +915,7 @@ async function main() {
                         try {
                             materialized = await materializeMessageMedia({
                                 id: m.id,
-                                attachments: m.attachments,
-                                imageUrl: m.imageUrl ?? null,
-                                audioUrl: m.audioUrl ?? null,
-                                audioDurationMs: m.audioDurationMs ?? null,
+                                attachments: m.attachments ?? [],
                             }, { agentId, conversationId: convoId });
                         }
                         catch (error) {
@@ -1156,7 +1157,7 @@ async function main() {
     await new Promise(() => { });
 }
 // ── Entry ───────────────────────────────────────────────────────────
-main().catch((err) => {
+runCli(import.meta.url, main, (err) => {
     console.error('[canon-host] Fatal error:', err);
     const ap = getActiveProfile();
     if (ap)

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { main as serverMain } from './server.js';
+export { main as hostMain } from './host.js';
+export { main as registerMain } from './register.js';
+export { main as setupMain } from './setup.js';

package/dist/index.js

@@ -0,0 +1,4 @@
+export { main as serverMain } from './server.js';
+export { main as hostMain } from './host.js';
+export { main as registerMain } from './register.js';
+export { main as setupMain } from './setup.js';

package/dist/register.d.ts

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-export {};
+export declare function main(): Promise<void>;

package/dist/register.js

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
 import { setDefaultResultOrder } from 'node:dns';
-setDefaultResultOrder('ipv4first');
 /**
  * CLI script for Canon agent registration.
  * Invoked by the /canon-register skill.
@@ -15,80 +14,88 @@ import { readFileSync, writeFileSync, mkdirSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
 import { parseArgs } from 'node:util';
+import { runCli } from './cli-entry.js';
 const CANON_DIR = join(homedir(), '.canon');
 const AGENTS_PATH = join(CANON_DIR, 'agents.json');
-const { values } = parseArgs({
-    options: {
-        name: { type: 'string' },
-        description: { type: 'string' },
-        phone: { type: 'string' },
-        profile: { type: 'string' },
-        'base-url': { type: 'string' },
-    },
-    strict: true,
-});
-if (!values.name || !values.description || !values.phone) {
-    console.error('Usage: node register.js --name "Agent Name" --description "Description" --phone "+15551234567" [--profile "my-agent"]');
-    process.exit(1);
-}
-// Default profile name: sanitized agent name
-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 {
-    // File doesn't exist yet
-}
-console.log(`Registering agent "${values.name}" (profile: ${profileName})...`);
-const result = await registerAndWaitForApproval({
-    name: values.name,
-    description: values.description,
-    ownerPhone: values.phone,
-    developerInfo: 'Claude Code plugin',
-    clientType: 'claude-code',
-    baseUrl: values['base-url'],
-    requestedAgentId: existingAgentId,
-}, {
-    onSubmitted: (requestId) => {
-        console.log(`Registration submitted (request ID: ${requestId}).`);
-        console.log('Waiting for approval in Canon app...');
-    },
-    onPollUpdate: () => {
-        process.stdout.write('.');
-    },
-});
-console.log(''); // newline after dots
-switch (result.status) {
-    case 'approved': {
-        // Save to ~/.canon/agents.json
-        mkdirSync(CANON_DIR, { recursive: true });
-        let profiles = {};
-        try {
-            profiles = JSON.parse(readFileSync(AGENTS_PATH, 'utf-8'));
-        }
-        catch {
-            // File doesn't exist yet
+export async function main() {
+    setDefaultResultOrder('ipv4first');
+    const { values } = parseArgs({
+        options: {
+            name: { type: 'string' },
+            description: { type: 'string' },
+            phone: { type: 'string' },
+            profile: { type: 'string' },
+            'base-url': { type: 'string' },
+        },
+        strict: true,
+    });
+    if (!values.name || !values.description || !values.phone) {
+        console.error('Usage: node register.js --name "Agent Name" --description "Description" --phone "+15551234567" [--profile "my-agent"]');
+        process.exit(1);
+    }
+    // Default profile name: sanitized agent name
+    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 {
+        // File doesn't exist yet
+    }
+    console.log(`Registering agent "${values.name}" (profile: ${profileName})...`);
+    const result = await registerAndWaitForApproval({
+        name: values.name,
+        description: values.description,
+        ownerPhone: values.phone,
+        developerInfo: 'Claude Code plugin',
+        clientType: 'claude-code',
+        baseUrl: values['base-url'],
+        requestedAgentId: existingAgentId,
+    }, {
+        onSubmitted: (requestId) => {
+            console.log(`Registration submitted (request ID: ${requestId}).`);
+            console.log('Waiting for approval in Canon app...');
+        },
+        onPollUpdate: () => {
+            process.stdout.write('.');
+        },
+    });
+    console.log(''); // newline after dots
+    switch (result.status) {
+        case 'approved': {
+            // Save to ~/.canon/agents.json
+            mkdirSync(CANON_DIR, { recursive: true });
+            let profiles = {};
+            try {
+                profiles = JSON.parse(readFileSync(AGENTS_PATH, 'utf-8'));
+            }
+            catch {
+                // File doesn't exist yet
+            }
+            profiles[profileName] = {
+                apiKey: result.apiKey,
+                agentId: result.agentId,
+                agentName: result.agentName,
+                registeredAt: new Date().toISOString(),
+            };
+            writeFileSync(AGENTS_PATH, JSON.stringify(profiles, null, 2));
+            console.log(`Approved! Agent: ${result.agentName} (${result.agentId})`);
+            console.log(`Saved as profile "${profileName}" in ~/.canon/agents.json`);
+            console.log('Restart Claude Code to connect.');
+            break;
         }
-        profiles[profileName] = {
-            apiKey: result.apiKey,
-            agentId: result.agentId,
-            agentName: result.agentName,
-            registeredAt: new Date().toISOString(),
-        };
-        writeFileSync(AGENTS_PATH, JSON.stringify(profiles, null, 2));
-        console.log(`Approved! Agent: ${result.agentName} (${result.agentId})`);
-        console.log(`Saved as profile "${profileName}" in ~/.canon/agents.json`);
-        console.log('Restart Claude Code to connect.');
-        break;
+        case 'rejected':
+            console.log('Registration was rejected.');
+            process.exit(1);
+            break;
+        case 'timeout':
+            console.log('Registration timed out (5 minutes). Try again later.');
+            process.exit(1);
+            break;
     }
-    case 'rejected':
-        console.log('Registration was rejected.');
-        process.exit(1);
-        break;
-    case 'timeout':
-        console.log('Registration timed out (5 minutes). Try again later.');
-        process.exit(1);
-        break;
 }
+runCli(import.meta.url, main, (error) => {
+    console.error('[canon-register] Fatal error:', error);
+    process.exit(1);
+});

package/dist/server.d.ts

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-export {};
+export declare function main(): Promise<void>;

package/dist/server.js

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
 import { setDefaultResultOrder } from 'node:dns';
-setDefaultResultOrder('ipv4first');
 /**
  * Canon channel MCP server for Claude Code.
  *
@@ -13,6 +12,7 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
 import { CanonClient, CanonStream, ApprovalManager, loadProfiles, isProfileLocked, resolveCanonAgent, getActiveProfile, releaseLock, initRTDBAuth, writeSessionState, clearSessionState, } from '@canonmsg/core';
 import { ApprovalHttpServer } from './approval-server.js';
+import { runCli } from './cli-entry.js';
 // ── MCP server ─────────────────────────────────────────────────────────
 const server = new Server({ name: 'canon-channel', version: '0.1.0' }, {
     capabilities: {
@@ -32,36 +32,31 @@ function getPrimaryAttachment(message) {
     const attachment = message.attachments?.[0];
     if (attachment?.url)
         return attachment;
-    if (message.audioUrl) {
-        return {
-            kind: 'audio',
-            url: message.audioUrl,
-            durationMs: message.audioDurationMs,
-        };
-    }
-    if (message.imageUrl) {
-        return {
-            kind: 'image',
-            url: message.imageUrl,
-        };
-    }
     return null;
 }
 function renderInboundContent(message) {
-    let content = message.text || '';
+    const content = message.text || '';
     const attachment = getPrimaryAttachment(message);
+    // MCP channel mode does not yet materialize media into local files. Surface
+    // a placeholder that tells the model media *was* attached without inlining a
+    // Firebase Storage URL: the model cannot fetch it, and reasoning about a
+    // URL-as-string leads to hallucinated image descriptions. The `attachment_*`
+    // fields on the structured `meta` sidechannel still carry the URL for UI /
+    // telemetry consumers.
+    let placeholder = null;
     if (attachment?.kind === 'audio') {
         const duration = attachment.durationMs ? ` (${Math.round(attachment.durationMs / 1000)}s)` : '';
-        return content
-            ? `[Voice message${duration}: ${attachment.url}]\n${content}`
-            : `[Voice message${duration}: ${attachment.url}]`;
+        placeholder = `[Voice message${duration} — ask sender to resend if you need the audio]`;
     }
-    if (attachment?.kind === 'image') {
-        return content ? `[Image: ${attachment.url}]\n${content}` : `[Image: ${attachment.url}]`;
+    else if (attachment?.kind === 'image') {
+        placeholder = '[Image attached — not yet materialized into this session; ask sender to describe if needed]';
     }
-    if (attachment?.kind === 'file') {
+    else if (attachment?.kind === 'file') {
         const label = attachment.fileName || 'File';
-        return content ? `[File: ${label} ${attachment.url}]\n${content}` : `[File: ${label} ${attachment.url}]`;
+        placeholder = `[File: ${label} — not yet materialized into this session]`;
+    }
+    if (placeholder) {
+        return content ? `${placeholder}\n${content}` : placeholder;
     }
     return content;
 }
@@ -486,10 +481,6 @@ async function handleInboundMessage(payload) {
         }
     }
     const primaryAttachment = getPrimaryAttachment(m);
-    if (m.imageUrl)
-        meta.image_url = m.imageUrl;
-    if (m.audioUrl)
-        meta.audio_url = m.audioUrl;
     if (primaryAttachment?.url) {
         meta.attachment_kind = primaryAttachment.kind;
         meta.attachment_url = primaryAttachment.url;
@@ -602,7 +593,8 @@ async function startChannel() {
     }
 }
 // ── Main ───────────────────────────────────────────────────────────────
-async function main() {
+export async function main() {
+    setDefaultResultOrder('ipv4first');
     const transport = new StdioServerTransport();
     await server.connect(transport);
     // Start the Canon channel after MCP connection is established
@@ -626,7 +618,7 @@ async function main() {
     process.on('SIGINT', shutdown);
     process.on('SIGTERM', shutdown);
 }
-main().catch((err) => {
+runCli(import.meta.url, main, (err) => {
     console.error('[canon] Fatal error:', err);
     process.exit(1);
 });

package/dist/setup.d.ts

@@ -6,4 +6,4 @@
  * 1. Install the /canon-register and /canon-configure skills
  * 2. Show the user how to add the MCP server to their .mcp.json
  */
-export {};
+export declare function main(): void;

package/dist/setup.js

@@ -9,6 +9,7 @@
 import { mkdirSync, writeFileSync, existsSync, readFileSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { runCli } from './cli-entry.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const home = process.env.HOME || process.env.USERPROFILE || '';
 const skillsDir = join(home, '.claude', 'skills');
@@ -55,12 +56,18 @@ Then start Claude Code with:
 `);
 }
 // ── Main ───────────────────────────────────────────────────────────────
-console.log('Canon Claude Code Plugin Setup');
-console.log('==============================\n');
-console.log('Installing skills...');
-installSkills();
-console.log('\nRegistering your agent...');
-console.log('  Run /canon-register in Claude Code to register a new agent');
-console.log('  Run /canon-configure if you already have an API key\n');
-console.log('MCP server configuration:');
-showMcpInstructions();
+export function main() {
+    console.log('Canon Claude Code Plugin Setup');
+    console.log('==============================\n');
+    console.log('Installing skills...');
+    installSkills();
+    console.log('\nRegistering your agent...');
+    console.log('  Run /canon-register in Claude Code to register a new agent');
+    console.log('  Run /canon-configure if you already have an API key\n');
+    console.log('MCP server configuration:');
+    showMcpInstructions();
+}
+runCli(import.meta.url, main, (error) => {
+    console.error('[canon-setup] Fatal error:', error);
+    process.exit(1);
+});

package/dist/streaming-buffer.d.ts

@@ -0,0 +1,16 @@
+export interface StreamingBufferOptions {
+    throttleMs: number;
+    getText: () => string;
+    setText: (text: string) => void;
+    getTimer: () => ReturnType<typeof setTimeout> | null;
+    setTimer: (timer: ReturnType<typeof setTimeout> | null) => void;
+    onWrite: (text: string) => void;
+    schedule?: typeof setTimeout;
+    cancel?: typeof clearTimeout;
+}
+export declare function createStreamingBuffer(options: StreamingBufferOptions): {
+    append(delta: string): void;
+    flush: () => void;
+    clear(): void;
+    replace(text: string): void;
+};

package/dist/streaming-buffer.js

@@ -0,0 +1,52 @@
+export function createStreamingBuffer(options) {
+    const schedule = options.schedule ?? setTimeout;
+    const cancel = options.cancel ?? clearTimeout;
+    const flush = () => {
+        const timer = options.getTimer();
+        if (timer) {
+            cancel(timer);
+            options.setTimer(null);
+        }
+        const text = options.getText();
+        if (text) {
+            options.onWrite(text);
+        }
+    };
+    return {
+        append(delta) {
+            if (!delta)
+                return;
+            options.setText(`${options.getText()}${delta}`);
+            if (options.getTimer())
+                return;
+            const timer = schedule(() => {
+                options.setTimer(null);
+                const text = options.getText();
+                if (text) {
+                    options.onWrite(text);
+                }
+            }, options.throttleMs);
+            options.setTimer(timer);
+        },
+        flush,
+        clear() {
+            const timer = options.getTimer();
+            if (timer) {
+                cancel(timer);
+                options.setTimer(null);
+            }
+            options.setText('');
+        },
+        replace(text) {
+            const timer = options.getTimer();
+            if (timer) {
+                cancel(timer);
+                options.setTimer(null);
+            }
+            options.setText(text);
+            if (text) {
+                options.onWrite(text);
+            }
+        },
+    };
+}

package/package.json

@@ -1,9 +1,16 @@
 {
   "name": "@canonmsg/claude-code-plugin",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "Canon channel plugin for Claude Code — messaging where AI agents are first-class citizens",
   "type": "module",
-  "main": "dist/server.js",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
   "bin": {
     "canon-channel-server": "dist/server.js",
     "canon-claude": "dist/host.js",
@@ -23,8 +30,8 @@
   },
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.2.101",
-    "@canonmsg/agent-sdk": "^0.8.0",
-    "@canonmsg/core": "^0.7.0",
+    "@canonmsg/agent-sdk": "^0.8.1",
+    "@canonmsg/core": "^0.7.1",
     "@modelcontextprotocol/sdk": "^1.12.0"
   },
   "engines": {