@canonmsg/agent-sdk 1.6.1 → 2.0.0

package/README.md

@@ -38,10 +38,13 @@ No additional dependencies required — the SDK uses native `fetch` and `Readabl
 | `deliveryMode` | `'auto' \| 'sse'` | `'auto'` | How the SDK receives new messages |
 | `debounceMs` | `number` | `2000` | Batching window for incoming messages per conversation |
 | `historyLimit` | `number` | `50` | Number of historical messages to fetch (max 100) |
+| `autoMarkRead` | `boolean` | `true` | Advance Canon's read cursor explicitly after handling inbound messages. History fetches are read-only. |
 | `sessions` | `SessionOptions` | `undefined` | Enable per-conversation session queues and persistent metadata |
 | `clientType` | `AgentClientType` | `'generic'` | Agent runtime label used for Canon capability detection |
 | `runtimeDescriptor` | `CanonRuntimeDescriptor` | minimal generic descriptor | Optional setup/live controls and runtime capability metadata for Canon UI |
 | `runtimeControls` | `RuntimeControlHandlers` | `undefined` | Optional interrupt / stop-clear handlers for Canon working-state controls |
+| `runtimeControlSurface` | `'agent' \| 'host'` | `'agent'` | Runtime publishing surface. Use `host` when this SDK agent owns live runtime controls. |
+| `runtimePrimitives` | `RuntimePrimitiveHandlers` | `undefined` | Optional typed primitive command handlers for descriptor-backed runtime commands |
 | `sessionState` | `boolean` | `false` | Publish RTDB session-state for the conversations this agent is active in |
 
 ### Optional runtime controls
@@ -154,17 +157,38 @@ The `message` event handler receives a context object with:
 |---|---|---|
 | `messages` | `CanonMessage[]` | New messages in this batch (debounced, sorted by time) |
 | `history` | `CanonMessage[]` | Last N messages before these new ones |
+| `replyContext` | `CanonReplyContext \| null` | Resolved swipe-reply target for the latest inbound message, when available |
 | `conversationId` | `string` | The conversation these messages belong to |
 | `conversation` | `CanonConversation` | Full conversation metadata |
+| `groupContext` | `CanonGroupContext \| undefined` | Lightweight group awareness for group conversations |
 | `replyFinal` | `(text: string, options?) => Promise<{ messageId: string }>` | Send the durable final reply for a turn |
 | `replyProgress` | `(text: string, options?) => Promise<{ turnId: string; durable: boolean; messageId: string \| null }>` | Update the live turn progress; add `durable: true` to also persist it |
+| `deleteMessage` | `(messageId: string) => Promise<void>` | Soft-delete a message sent by this agent |
+| `markAsRead` | `() => Promise<void>` | Advance this agent's read cursor for the conversation |
+| `leave` | `() => Promise<void>` | Leave the current group conversation |
+| `react` | `(messageId, emoji) => Promise<void>` | Toggle an emoji reaction |
+| `addMember` / `removeMember` | functions | Manage group members when the agent has permission |
+| `sendContextualMessage` | function | Send into another conversation with private self-context from this conversation |
+| `reachOut` | function | Act on a Canon contact card using live admission resolution |
 | `agent` | `AgentContext` | Trusted Canon agent identity and access context |
+| `activeSelfContextId` | `string \| null` | Active private self-context id for this turn |
+| `selfContexts` | `CanonSelfContext[] \| undefined` | Private context explaining this agent's cross-session actions |
+| `provenance` | `CanonRuntimeProvenance` | Canon-computed sender/conversation context for the latest inbound message in this batch |
+| `requestApproval` | `(request) => Promise<ApprovalResult>` | Render a Canon approval card, wait for a response, and return the decision to the runtime |
+| `requestRuntimeInput` | `(request) => Promise<RuntimeInputResult>` | Render a Canon input card for clarification, sudo, or secret values |
 | `media` | `{ materialize, uploadFile, replyWithFile }` | Canon-managed access to real media bytes via `~/.canon/media-cache` plus local-file uploads back into Canon |
 | `session` | `SessionInfo \| undefined` | Per-conversation queue/session state when sessions are enabled |
 | `turn` | `TurnController \| undefined` | Live turn-state helpers for thinking/streaming/tool/waiting-input |
+| `abortSignal` | `AbortSignal` | Cooperative cancellation signal for interrupt/stop handling |
 
 Messages from the agent itself are automatically filtered out -- your handler only receives messages from other participants.
 
+`ctx.provenance` describes the latest inbound message in the debounced batch. Use it for runtime-owned policy decisions such as owner-only tools, group mention handling, or self-context-aware behavior. Canon provides trusted provenance; it does not impose an SDK-agent sandbox.
+
+### Human-in-the-loop cards
+
+Use `ctx.requestRuntimeInput(...)` when the runtime needs clarification, a sudo value, or a secret value from the user. Use `ctx.requestApproval(...)` when the runtime needs an allow/deny decision before taking an action. Canon creates the visible card, routes the user's response, and returns the result to the handler; your runtime remains responsible for enforcing that result.
+
 ## Contact Request Awareness
 
 Agents can also observe contact-request lifecycle events without becoming the approver:
@@ -252,7 +276,7 @@ const { requestId, pollToken } = await CanonAgent.register({
 });
 
 console.log('Registration submitted:', requestId);
-console.log('Poll token:', pollToken);
+await saveRegistrationPickup({ requestId, pollToken });
 
 // 2. Poll for approval
 const status = await CanonAgent.checkStatus(requestId, { pollToken });
@@ -260,12 +284,13 @@ console.log('Status:', status.status); // 'pending' | 'approved' | 'rejected'
 
 if (status.status === 'approved' && status.apiKey) {
   console.log('Agent ID:', status.agentId);
-  console.log('API Key:', status.apiKey); // Store this immediately
+  await saveAgentCredentials({ agentId: status.agentId, apiKey: status.apiKey });
   await CanonAgent.ackStatus(requestId, { pollToken });
 }
 ```
 
 The approved response only includes the API key until you acknowledge delivery. Persist it on the first approved poll, then call `ackStatus()` so Canon clears the plaintext key from the request.
+Replace `saveRegistrationPickup` and `saveAgentCredentials` with your own encrypted/local secret-store writes; do not print these values in logs.
 
 ## Error Handling
 

package/dist/canon-agent.js

@@ -1,4 +1,4 @@
-import { ApprovalManager, CanonClient, buildCanonGroupContext, createRuntimeStatePublisher, diffCanonMemberIds, FINAL_MESSAGE_HANDOFF_MS, RUNTIME_NEW_SESSION_ACTION, RUNTIME_STOP_ACTION, RUNTIME_STOP_AND_DROP_ACTION, buildRuntimeInputOutcome, initRTDBAuth, rtdbRead, rtdbWrite, normalizeTurnMetadata, reachOutToCanonContact, resolveCanonReplyContext, resolveMessageActiveSelfContextId, resolveRuntimeProvenance, selectActiveSelfContexts, } from '@canonmsg/core';
+import { ApprovalManager, CanonClient, buildCanonGroupContext, createTurnOutputController, createRuntimeStatePublisher, diffCanonMemberIds, FINAL_MESSAGE_HANDOFF_MS, RUNTIME_NEW_SESSION_ACTION, RUNTIME_STOP_ACTION, RUNTIME_STOP_AND_DROP_ACTION, buildRuntimeInputOutcome, initRTDBAuth, rtdbRead, rtdbWrite, normalizeTurnMetadata, reachOutToCanonContact, resolveCanonReplyContext, resolveMessageActiveSelfContextId, resolveRuntimeProvenance, selectActiveSelfContexts, } from '@canonmsg/core';
 import { randomUUID } from 'node:crypto';
 import { AuthManager } from './auth.js';
 import { Debouncer } from './debouncer.js';
@@ -319,7 +319,6 @@ export class CanonAgent {
                 : null;
             const consumed = manager.handleMessage(conversationId, {
                 senderId: message.senderId,
-                ...(typeof message.text === 'string' ? { text: message.text } : {}),
                 ...(metadataRecord ? { metadata: metadataRecord } : {}),
             });
             return !consumed && metadataRecord?.type !== 'approval_reply';
@@ -673,35 +672,33 @@ export class CanonAgent {
         const hasInterrupt = this.hasInterruptSupport();
         const hasStopAndDrop = this.hasStopAndDropSupport();
         const hasNewSession = this.hasNewSessionSupport();
-        const actions = [...(source.actions ?? [])].filter((action) => {
-            if (action.dispatch.kind !== 'signal')
+        const commands = [...(source.commands ?? [])].filter((command) => {
+            if (command.dispatch.kind === 'signal') {
+                if (command.dispatch.signal === 'interrupt')
+                    return hasInterrupt;
+                if (command.dispatch.signal === 'stop_and_drop')
+                    return hasStopAndDrop;
+                if (command.dispatch.signal === 'new_session')
+                    return hasNewSession;
+                return false;
+            }
+            if (command.dispatch.kind !== 'primitive')
                 return true;
-            if (action.dispatch.signal === 'interrupt')
-                return hasInterrupt;
-            if (action.dispatch.signal === 'stop_and_drop')
-                return hasStopAndDrop;
-            if (action.dispatch.signal === 'new_session')
-                return hasNewSession;
-            return false;
+            return this.primitiveHandlers.has(command.dispatch.primitive)
+                || Boolean(this.primitiveFallbackHandler);
         });
-        const hasInterruptAction = actions.some((action) => action.dispatch.kind === 'signal' && action.dispatch.signal === 'interrupt');
-        const hasStopAndDropAction = actions.some((action) => action.dispatch.kind === 'signal' && action.dispatch.signal === 'stop_and_drop');
-        const hasNewSessionAction = actions.some((action) => action.dispatch.kind === 'signal' && action.dispatch.signal === 'new_session');
+        const hasInterruptAction = commands.some((action) => action.dispatch.kind === 'signal' && action.dispatch.signal === 'interrupt');
+        const hasStopAndDropAction = commands.some((action) => action.dispatch.kind === 'signal' && action.dispatch.signal === 'stop_and_drop');
+        const hasNewSessionAction = commands.some((action) => action.dispatch.kind === 'signal' && action.dispatch.signal === 'new_session');
         if (hasInterrupt && !hasInterruptAction) {
-            actions.push(RUNTIME_STOP_ACTION);
+            commands.push(RUNTIME_STOP_ACTION);
         }
         if (hasStopAndDrop && this.sessionManager && !hasStopAndDropAction) {
-            actions.push(RUNTIME_STOP_AND_DROP_ACTION);
+            commands.push(RUNTIME_STOP_AND_DROP_ACTION);
         }
         if (hasNewSession && !hasNewSessionAction) {
-            actions.push(RUNTIME_NEW_SESSION_ACTION);
+            commands.push(RUNTIME_NEW_SESSION_ACTION);
         }
-        const commands = [...(source.commands ?? [])].filter((command) => {
-            if (command.dispatch.kind !== 'primitive')
-                return true;
-            return this.primitiveHandlers.has(command.dispatch.primitive)
-                || Boolean(this.primitiveFallbackHandler);
-        });
         const hasCommandForPrimitive = (primitive) => commands.some((command) => (command.primitive === primitive
             || (command.dispatch.kind === 'primitive' && command.dispatch.primitive === primitive)));
         for (const primitive of this.primitiveHandlers.keys()) {
@@ -714,7 +711,6 @@ export class CanonAgent {
             supportsInterrupt: hasInterrupt,
             supportsInputInterrupt: source.supportsInputInterrupt === false ? false : hasInterrupt,
             commands,
-            actions,
         };
     }
     buildRuntimeCapabilities() {
@@ -1112,21 +1108,24 @@ export class CanonAgent {
                     : {}),
             })).catch(() => { });
         };
+        const turnOutput = createTurnOutputController({
+            turnId,
+            mode: 'snapshot',
+            writeSnapshot: (snapshot) => this.apiClient.setStreaming({
+                conversationId,
+                text: snapshot.text,
+                status: snapshot.status,
+                messageId: snapshot.messageId,
+                turnId: snapshot.turnId,
+                blocks: snapshot.blocks,
+            }),
+            clearSnapshot: () => this.apiClient.clearStreaming(conversationId),
+        });
         const setLiveState = async (state, text, streamingStatus) => {
             throwIfAborted();
             await writeTurn(state);
             if (streamingStatus) {
-                try {
-                    await this.apiClient.setStreaming({
-                        conversationId,
-                        text: text ?? '',
-                        status: streamingStatus,
-                        messageId: turnId,
-                    });
-                }
-                catch {
-                    // Non-critical
-                }
+                await turnOutput.setStatus(streamingStatus, text ?? '');
             }
         };
         // Show thinking indicator and keep it alive (5s client-side expiry)
@@ -1140,12 +1139,7 @@ export class CanonAgent {
         const thinkingKeepalive = setInterval(() => {
             this.apiClient.setTyping(conversationId, true, 'thinking').catch(() => { });
             if (turnState === 'thinking') {
-                this.apiClient.setStreaming({
-                    conversationId,
-                    text: 'Thinking...',
-                    status: 'thinking',
-                    messageId: turnId,
-                }).catch(() => { });
+                turnOutput.setStatus('thinking', 'Thinking...').catch(() => { });
             }
         }, 3500);
         try {
@@ -1181,13 +1175,14 @@ export class CanonAgent {
                 catch { }
                 throwIfAborted();
                 const sendOptions = withActiveSelfContext(options);
+                const turnTrail = turnOutput.getFinalTrail();
                 const result = await this.apiClient.sendMessage(conversationId, text, {
                     ...sendOptions,
                     metadata: {
                         ...(sendOptions.metadata ?? {}),
                         turnId,
                         turnSemantics: 'turn_complete',
-                        turnComplete: true,
+                        ...(turnTrail.length > 0 ? { turnTrail } : {}),
                     },
                 });
                 await sleep(FINAL_MESSAGE_HANDOFF_MS);
@@ -1212,7 +1207,6 @@ export class CanonAgent {
                         ...(sendOptionsWithContext.metadata ?? {}),
                         turnId,
                         turnSemantics: 'progress',
-                        turnComplete: false,
                     },
                 });
                 return { turnId, durable: true, messageId: result.messageId };
@@ -1314,7 +1308,6 @@ export class CanonAgent {
                         ...(options.messageOptions?.metadata ?? {}),
                         turnId,
                         turnSemantics: 'turn_complete',
-                        turnComplete: true,
                     },
                 },
             });
@@ -1331,7 +1324,14 @@ export class CanonAgent {
                 shouldPersistTurnState = true;
                 try {
                     try {
-                        await this.apiClient.clearStreaming(conversationId);
+                        await turnOutput.addBlock({
+                            id: `approval:${request.runtimeId ?? request.toolName}:${turnId}`,
+                            kind: 'approval',
+                            status: 'pending',
+                            title: request.toolSummary ?? request.toolName,
+                            summary: request.risk ?? request.category,
+                        });
+                        await turnOutput.waitingInput();
                     }
                     catch { }
                     await writeTurn('waiting_input');
@@ -1353,6 +1353,12 @@ export class CanonAgent {
                     });
                     throwIfAborted();
                     shouldPersistTurnState = false;
+                    try {
+                        await turnOutput.completeBlock(`approval:${request.runtimeId ?? request.toolName}:${turnId}`, {
+                            summary: `Decision: ${result.decision}`,
+                        });
+                    }
+                    catch { }
                     try {
                         await this.apiClient.setTyping(conversationId, true, 'thinking');
                     }
@@ -1401,6 +1407,7 @@ export class CanonAgent {
                         title: request.title,
                         prompt: request.prompt,
                         ...(request.choices ? { choices: request.choices } : {}),
+                        ...(request.questions ? { questions: request.questions } : {}),
                         ...(request.secretName ? { secretName: request.secretName } : {}),
                         ...(request.native ? { native: request.native } : {}),
                         ...(request.sensitive !== undefined ? { sensitive: request.sensitive } : {}),
@@ -1408,7 +1415,14 @@ export class CanonAgent {
                     });
                     requestCreated = true;
                     try {
-                        await this.apiClient.clearStreaming(conversationId);
+                        await turnOutput.addBlock({
+                            id: `input:${inputId}`,
+                            kind: 'input',
+                            status: 'pending',
+                            title: request.title ?? request.prompt ?? request.kind,
+                            summary: request.kind,
+                        });
+                        await turnOutput.waitingInput();
                     }
                     catch { }
                     await writeTurn('waiting_input');
@@ -1428,6 +1442,7 @@ export class CanonAgent {
                                 result = {
                                     status: 'submitted',
                                     value: response.value,
+                                    answers: response.answers,
                                     inputId,
                                 };
                                 break;
@@ -1451,7 +1466,12 @@ export class CanonAgent {
                                 inputId,
                             });
                             if (response.status === 'submitted') {
-                                result = { status: 'submitted', value: response.value, inputId };
+                                result = {
+                                    status: 'submitted',
+                                    value: response.value,
+                                    answers: response.answers,
+                                    inputId,
+                                };
                             }
                             else if (response.status === 'cancelled' || response.status === 'timeout') {
                                 result = { status: response.status, inputId };
@@ -1474,6 +1494,12 @@ export class CanonAgent {
                     });
                     throwIfAborted();
                     shouldPersistTurnState = false;
+                    try {
+                        await turnOutput.completeBlock(`input:${inputId}`, {
+                            summary: `Input ${result.status}`,
+                        });
+                    }
+                    catch { }
                     try {
                         await this.apiClient.setTyping(conversationId, true, 'thinking');
                     }
@@ -1499,6 +1525,7 @@ export class CanonAgent {
                 catch { }
                 throwIfAborted();
                 try {
+                    const turnTrail = turnOutput.getFinalTrail();
                     const result = await sendMediaFileMessage(this.apiClient, conversationId, filePath, text, {
                         ...(options?.replyTo ? { replyTo: options.replyTo } : {}),
                         ...(options?.replyToPosition != null
@@ -1512,7 +1539,7 @@ export class CanonAgent {
                             ...(options?.metadata ?? {}),
                             turnId,
                             turnSemantics: 'turn_complete',
-                            turnComplete: true,
+                            ...(turnTrail.length > 0 ? { turnTrail } : {}),
                         },
                         ...(options?.fileName ? { fileName: options.fileName } : {}),
                         ...(options?.mimeType ? { mimeType: options.mimeType } : {}),
@@ -1586,13 +1613,57 @@ export class CanonAgent {
                     setStreaming: async (text) => {
                         await setLiveState('streaming', text, 'streaming');
                     },
+                    appendDelta: (delta) => {
+                        throwIfAborted();
+                        turnState = 'streaming';
+                        turnOutput.appendDelta(delta);
+                        void writeTurn('streaming');
+                    },
+                    appendBlock: (block) => {
+                        throwIfAborted();
+                        turnState = 'streaming';
+                        turnOutput.appendBlock(block);
+                        void writeTurn('streaming');
+                    },
+                    addBlock: async (block) => {
+                        throwIfAborted();
+                        return turnOutput.addBlock(block);
+                    },
+                    updateBlock: async (id, patch) => {
+                        throwIfAborted();
+                        return turnOutput.updateBlock(id, patch);
+                    },
+                    completeBlock: async (id, patch) => {
+                        throwIfAborted();
+                        return turnOutput.completeBlock(id, patch);
+                    },
+                    failBlock: async (id, patch) => {
+                        throwIfAborted();
+                        return turnOutput.failBlock(id, patch);
+                    },
+                    replaceSnapshot: async (text) => {
+                        await setLiveState('streaming', text, 'streaming');
+                    },
+                    flush: async () => {
+                        await turnOutput.flush();
+                    },
+                    clear: async () => {
+                        await turnOutput.clear();
+                    },
                     setTool: async (text) => {
-                        await setLiveState('tool', text, 'tool');
+                        await writeTurn('tool');
+                        await turnOutput.addBlock({
+                            id: `tool:${Date.now()}`,
+                            kind: 'tool',
+                            status: 'running',
+                            title: text,
+                        });
+                        await turnOutput.setStatus('tool');
                     },
                     setWaitingInput: async (text) => {
                         shouldPersistTurnState = true;
                         try {
-                            await this.apiClient.clearStreaming(conversationId);
+                            await turnOutput.waitingInput();
                         }
                         catch { }
                         await writeTurn('waiting_input');
@@ -1648,7 +1719,7 @@ export class CanonAgent {
             }
             catch { }
             try {
-                await this.apiClient.clearStreaming(conversationId);
+                await turnOutput.clear();
             }
             catch { }
             if (runtimeState && !shouldPersistTurnState) {

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { CanonAgent } from './canon-agent.js';
 export type { AgentContactsAPI, AgentUsersAPI } from './canon-agent.js';
-export { ApprovalManager, buildApprovalOutcome, buildApprovalReply, buildApprovalRequest, CanonApiError, DEFAULT_APPROVAL_CONFIG, generateApprovalId, HOST_ADMISSION_ACTION_CAPABILITIES, HOST_ADMISSION_ACTIONS_DISABLED, parseApprovalReplyMetadata, parseApprovalRequestMetadata, parseSessionRule, parseTextApprovalReply, redactSecrets, } from '@canonmsg/core';
-export type { ApprovalConfig, ApprovalNativeRequestMetadata, ApprovalOutcomeMetadata, ApprovalReplyMetadata, ApprovalRequestCategory, ApprovalRequestDetail, ApprovalRequestMetadata, ApprovalResult, ApprovalRisk, CanonContact, CanonRuntimeActivityItem, CanonRuntimeActivityKind, CanonRuntimeActivityStatus, CanonRuntimeFact, CanonRuntimeFactGroup, CanonResolveAdmissionResult, ContactAddedPayload, ContactCardPayload, ContactRemovedPayload, ContactSource, HostAdmissionActionCapabilities, ResolvedAdmissionState, ResolvedAdmissionTargetSummary, ResolvedTargetAdmissionPayload, RuntimeInputChoice, RuntimeInputKind, RuntimeInputNativeMetadata, SessionRule, } from '@canonmsg/core';
+export { ApprovalManager, buildApprovalOutcome, buildApprovalReply, buildApprovalRequest, CanonApiError, DEFAULT_APPROVAL_CONFIG, generateApprovalId, HOST_ADMISSION_ACTION_CAPABILITIES, HOST_ADMISSION_ACTIONS_DISABLED, parseApprovalReplyMetadata, parseApprovalRequestMetadata, parseSessionRule, redactSecrets, } from '@canonmsg/core';
+export type { ApprovalConfig, ApprovalNativeRequestMetadata, ApprovalOutcomeMetadata, ApprovalReplyMetadata, ApprovalRequestCategory, ApprovalRequestDetail, ApprovalRequestMetadata, ApprovalResult, ApprovalRisk, CanonContact, CanonRuntimeActivityItem, CanonRuntimeActivityKind, CanonRuntimeActivityStatus, CanonRuntimeFact, CanonRuntimeFactGroup, CanonResolveAdmissionResult, ContactAddedPayload, ContactCardPayload, ContactRemovedPayload, ContactSource, HostAdmissionActionCapabilities, ResolvedAdmissionState, ResolvedAdmissionTargetSummary, ResolvedTargetAdmissionPayload, RuntimeInputAnswers, RuntimeInputChoice, RuntimeInputKind, RuntimeInputNativeMetadata, RuntimeInputQuestion, SessionRule, } from '@canonmsg/core';
 export { SessionManager } from './session-manager.js';
 export { DEFAULT_MEDIA_CACHE_DIR, getCodexImagePath, getMessageAttachments, inferUploadMimeType, isAnthropicImageAttachment, materializeAttachment, materializeMessageMedia, materializeReplyContextMedia, resolveAttachmentMimeType, sendMediaFileMessage, toAnthropicImageBlock, uploadMediaFile, } from './media.js';
 export type { AnthropicImageBlock, AnthropicImageMimeType, MaterializeMediaOptions, MaterializedCanonAttachment, MaterializedCanonReplyContext, ReplyWithFileOptions, UploadMediaFileOptions, } from './media.js';

package/dist/index.js

@@ -1,4 +1,4 @@
 export { CanonAgent } from './canon-agent.js';
-export { ApprovalManager, buildApprovalOutcome, buildApprovalReply, buildApprovalRequest, CanonApiError, DEFAULT_APPROVAL_CONFIG, generateApprovalId, HOST_ADMISSION_ACTION_CAPABILITIES, HOST_ADMISSION_ACTIONS_DISABLED, parseApprovalReplyMetadata, parseApprovalRequestMetadata, parseSessionRule, parseTextApprovalReply, redactSecrets, } from '@canonmsg/core';
+export { ApprovalManager, buildApprovalOutcome, buildApprovalReply, buildApprovalRequest, CanonApiError, DEFAULT_APPROVAL_CONFIG, generateApprovalId, HOST_ADMISSION_ACTION_CAPABILITIES, HOST_ADMISSION_ACTIONS_DISABLED, parseApprovalReplyMetadata, parseApprovalRequestMetadata, parseSessionRule, redactSecrets, } from '@canonmsg/core';
 export { SessionManager } from './session-manager.js';
 export { DEFAULT_MEDIA_CACHE_DIR, getCodexImagePath, getMessageAttachments, inferUploadMimeType, isAnthropicImageAttachment, materializeAttachment, materializeMessageMedia, materializeReplyContextMedia, resolveAttachmentMimeType, sendMediaFileMessage, toAnthropicImageBlock, uploadMediaFile, } from './media.js';

package/dist/turn-filter.d.ts

@@ -1,5 +1,5 @@
 import { type ResolvedAgentBehaviorPolicy, type CanonMessage } from '@canonmsg/core';
-export declare function shouldDispatchInboundMessage(conversationId: string, agentId: string, message: CanonMessage, options?: {
+export declare function shouldDispatchInboundMessage(_conversationId: string, agentId: string, message: CanonMessage, options?: {
     conversationType?: 'direct' | 'group' | 'unknown';
     behavior?: ResolvedAgentBehaviorPolicy | null;
     recentHumanCount?: number;

package/dist/turn-filter.js

@@ -1,35 +1,10 @@
-import { evaluateParticipationPolicy, normalizeTurnState, rtdbRead, shouldTriggerAgentTurn, } from '@canonmsg/core';
-function normalizeRuntimeTurnState(value) {
-    const turnState = normalizeTurnState(value);
-    if (turnState) {
-        return {
-            state: turnState.state,
-            ...(turnState.openedAt !== undefined ? { openedAt: turnState.openedAt } : {}),
-            ...(turnState.updatedAt !== undefined ? { updatedAt: turnState.updatedAt } : {}),
-            ...(turnState.turnUpdatedAt !== undefined ? { turnUpdatedAt: turnState.turnUpdatedAt } : {}),
-        };
-    }
-    return null;
-}
-export async function shouldDispatchInboundMessage(conversationId, agentId, message, options) {
+import { evaluateParticipationPolicy, shouldTriggerAgentTurn, } from '@canonmsg/core';
+export async function shouldDispatchInboundMessage(_conversationId, agentId, message, options) {
     if (message.senderId === agentId)
         return false;
-    let senderTurnState = null;
-    try {
-        const [turnState, sessionState] = await Promise.all([
-            rtdbRead(`/turn-state/${conversationId}/${message.senderId}`),
-            rtdbRead(`/session-state/${conversationId}/${message.senderId}`),
-        ]);
-        senderTurnState = normalizeRuntimeTurnState(turnState)
-            ?? normalizeRuntimeTurnState(sessionState);
-    }
-    catch {
-        senderTurnState = null;
-    }
     const triggerDecision = shouldTriggerAgentTurn({
         senderType: message.senderType,
         metadata: message.metadata,
-        senderTurnState,
     });
     if (!triggerDecision.allow)
         return false;

package/dist/types.d.ts

@@ -1,5 +1,5 @@
-export type { AddMemberResult, AgentClientType, CanonGroupContext, CanonRuntimeActivityItem, CanonRuntimeActivityKind, CanonRuntimeActivityStatus, CanonRuntimeDescriptor, CanonRuntimeFact, CanonRuntimeFactGroup, CanonRuntimePrimitiveId, CanonRuntimeProvenance, CanonMessage, CanonConversation, CanonReplyContext, CanonContact, CanonContactRequest, CanonResolveAdmissionResult, ContactAddedPayload, ContactRemovedPayload, ContactSource, AgentContext, ResolvedAdmissionState, ResolvedAdmissionTargetSummary, ResolvedTargetAdmissionPayload, CanonSelfContext, SendContextualMessageOptions, SendContextualMessageResult, SendContextualSelfContextInput, SendMessageOptions, SessionConfig, CreateConversationOptions, TurnLifecycleState, ApprovalNativeRequestMetadata, ApprovalRequestCategory, ApprovalRequestDetail, ApprovalRequestMetadata, ApprovalRisk, ApprovalReplyMetadata, ApprovalOutcomeMetadata, RuntimeInputChoice, RuntimeInputKind, RuntimeInputNativeMetadata, SessionRule, ApprovalResult, } from '@canonmsg/core';
-import type { AddMemberResult, CanonGroupContext, CanonMessage, CanonConversation, CanonReplyContext, ContactCardPayload, CanonRuntimeActionDispatch, CanonRuntimePrimitiveId, CanonRuntimeProvenance, ApprovalNativeRequestMetadata, ApprovalRequestCategory, ApprovalRequestDetail, ApprovalResult, ApprovalRisk, RuntimeInputChoice, RuntimeInputKind, RuntimeInputNativeMetadata, SendMessageOptions, SendContextualSelfContextInput, SessionConfig } from '@canonmsg/core';
+export type { AddMemberResult, AgentClientType, CanonGroupContext, CanonRuntimeActivityItem, CanonRuntimeActivityKind, CanonRuntimeActivityStatus, CanonRuntimeDescriptor, CanonRuntimeFact, CanonRuntimeFactGroup, CanonRuntimePrimitiveId, CanonRuntimeProvenance, CanonMessage, CanonConversation, CanonReplyContext, CanonContact, CanonContactRequest, CanonResolveAdmissionResult, ContactAddedPayload, ContactRemovedPayload, ContactSource, AgentContext, ResolvedAdmissionState, ResolvedAdmissionTargetSummary, ResolvedTargetAdmissionPayload, CanonSelfContext, SendContextualMessageOptions, SendContextualMessageResult, SendContextualSelfContextInput, SendMessageOptions, SessionConfig, CreateConversationOptions, TurnLifecycleState, TurnOutputBlock, TurnOutputBlockInput, ApprovalNativeRequestMetadata, ApprovalRequestCategory, ApprovalRequestDetail, ApprovalRequestMetadata, ApprovalRisk, ApprovalReplyMetadata, ApprovalOutcomeMetadata, RuntimeInputChoice, RuntimeInputAnswers, RuntimeInputKind, RuntimeInputNativeMetadata, RuntimeInputQuestion, SessionRule, ApprovalResult, } from '@canonmsg/core';
+import type { AddMemberResult, CanonGroupContext, CanonMessage, CanonConversation, CanonReplyContext, ContactCardPayload, CanonRuntimeActionDispatch, CanonRuntimePrimitiveId, CanonRuntimeProvenance, ApprovalNativeRequestMetadata, ApprovalRequestCategory, ApprovalRequestDetail, ApprovalResult, ApprovalRisk, RuntimeInputChoice, RuntimeInputAnswers, RuntimeInputKind, RuntimeInputNativeMetadata, RuntimeInputQuestion, SendMessageOptions, SendContextualSelfContextInput, SessionConfig, TurnOutputBlock, TurnOutputBlockInput } from '@canonmsg/core';
 import type { MaterializeMediaOptions, MaterializedCanonAttachment, ReplyWithFileOptions, UploadMediaFileOptions } from './media.js';
 export interface ProgressMessageOptions extends SendMessageOptions {
     /**
@@ -31,6 +31,15 @@ export interface TurnController {
     state: import('@canonmsg/core').TurnLifecycleState;
     setThinking: (text?: string) => Promise<void>;
     setStreaming: (text: string) => Promise<void>;
+    appendDelta: (delta: string) => void;
+    appendBlock: (block: string) => void;
+    addBlock: (block: TurnOutputBlockInput) => Promise<TurnOutputBlock>;
+    updateBlock: (id: string, patch: Partial<Omit<TurnOutputBlockInput, 'id' | 'sequence'>>) => Promise<TurnOutputBlock | null>;
+    completeBlock: (id: string, patch?: Partial<Omit<TurnOutputBlockInput, 'id' | 'sequence' | 'status'>>) => Promise<TurnOutputBlock | null>;
+    failBlock: (id: string, patch?: Partial<Omit<TurnOutputBlockInput, 'id' | 'sequence' | 'status'>>) => Promise<TurnOutputBlock | null>;
+    replaceSnapshot: (text: string) => Promise<void>;
+    flush: () => Promise<void>;
+    clear: () => Promise<void>;
     setTool: (text: string) => Promise<void>;
     setWaitingInput: (text?: string) => Promise<void>;
 }
@@ -61,6 +70,7 @@ export interface RuntimeInputRequest {
     title: string;
     prompt: string;
     choices?: RuntimeInputChoice[];
+    questions?: RuntimeInputQuestion[];
     secretName?: string;
     sensitive?: boolean;
     runtimeId?: string;
@@ -72,6 +82,7 @@ export interface RuntimeInputRequest {
 export interface RuntimeInputResult {
     status: 'submitted' | 'cancelled' | 'timeout';
     value?: string;
+    answers?: RuntimeInputAnswers;
     inputId: string;
 }
 export interface MessageHandlerContext {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonmsg/agent-sdk",
-  "version": "1.6.1",
+  "version": "2.0.0",
   "description": "Canon Agent SDK — build AI agents that participate in Canon conversations",
   "type": "module",
   "main": "dist/index.js",
@@ -28,7 +28,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@canonmsg/core": "^0.23.0"
+    "@canonmsg/core": "^1.0.0"
   },
   "publishConfig": {
     "access": "public"