@canonmsg/claude-code-plugin 0.9.0 → 0.9.1

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.js

@@ -28,6 +28,7 @@ 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';
 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(() => { });
@@ -783,6 +785,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 +795,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 +914,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) {

package/dist/server.js

@@ -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;

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,6 +1,6 @@
 {
   "name": "@canonmsg/claude-code-plugin",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Canon channel plugin for Claude Code — messaging where AI agents are first-class citizens",
   "type": "module",
   "main": "dist/server.js",
@@ -23,8 +23,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": {