@canonmsg/core 0.24.0 → 1.0.0

package/dist/approval-format.d.ts

@@ -22,8 +22,3 @@ export declare function buildApprovalReply(approvalId: string, decision: 'allow'
     metadata: ApprovalReplyMetadata;
 };
 export declare function buildApprovalOutcome(approvalId: string, toolName: string, toolSummary: string, decision: 'allow' | 'deny', reason: 'replied' | 'timeout' | 'session-rule'): string;
-export declare function parseTextApprovalReply(text: string): {
-    decision: 'allow' | 'deny';
-    sessionRule?: SessionRule;
-    targetApprovalId?: string;
-} | null;

package/dist/approval-format.js

@@ -104,68 +104,3 @@ export function buildApprovalOutcome(approvalId, toolName, toolSummary, decision
     }
     return `${icon} [${approvalId}] -- ${toolName}: ${short}`;
 }
-// ── Parse text-based approval reply (fallback for non-card UIs) ─────
-const ALLOW_WORDS = new Set([
-    'approve', 'approved', 'allow', 'yes', 'y', 'ok', 'go', 'do it', 'go ahead',
-]);
-const DENY_WORDS = new Set([
-    'deny', 'denied', 'reject', 'no', 'n', 'nope', 'stop', "don't",
-]);
-export function parseTextApprovalReply(text) {
-    const trimmed = text.trim().toLowerCase();
-    if (!trimmed)
-        return null;
-    // "approve apr_xxxxx" or "deny apr_xxxxx" — target specific approval
-    const idMatch = trimmed.match(/^(approve|deny|allow|reject)\s+(apr_\w+)$/);
-    if (idMatch) {
-        const decision = idMatch[1] === 'deny' || idMatch[1] === 'reject' ? 'deny' : 'allow';
-        return { decision, targetApprovalId: idMatch[2] };
-    }
-    // "approve all for Xm" — time-limited blanket
-    const timeMatch = trimmed.match(/^approve\s+all\s+for\s+(\d+)\s*m(?:in(?:utes?)?)?$/);
-    if (timeMatch) {
-        const minutes = parseInt(timeMatch[1], 10);
-        return {
-            decision: 'allow',
-            sessionRule: {
-                type: 'approve-all',
-                expiresAt: new Date(Date.now() + minutes * 60_000).toISOString(),
-            },
-        };
-    }
-    // "approve all <ToolName>" — per-tool blanket
-    const toolMatch = trimmed.match(/^approve\s+all\s+(\w+)$/);
-    if (toolMatch && toolMatch[1] !== 'for') {
-        return {
-            decision: 'allow',
-            sessionRule: {
-                type: 'approve-tool',
-                toolPattern: toolMatch[1],
-            },
-        };
-    }
-    // "deny all <ToolName>"
-    const denyToolMatch = trimmed.match(/^deny\s+all\s+(\w+)$/);
-    if (denyToolMatch) {
-        return {
-            decision: 'deny',
-            sessionRule: {
-                type: 'deny-tool',
-                toolPattern: denyToolMatch[1],
-            },
-        };
-    }
-    // "approve all" — session blanket
-    if (trimmed === 'approve all' || trimmed === 'allow all') {
-        return {
-            decision: 'allow',
-            sessionRule: { type: 'approve-all' },
-        };
-    }
-    // Simple allow/deny words
-    if (ALLOW_WORDS.has(trimmed))
-        return { decision: 'allow' };
-    if (DENY_WORDS.has(trimmed))
-        return { decision: 'deny' };
-    return null;
-}

package/dist/approval-manager.d.ts

@@ -43,7 +43,6 @@ export declare class ApprovalManager {
      */
     handleMessage(conversationId: string, message: {
         senderId: string;
-        text?: string;
         metadata?: Record<string, unknown>;
     }): boolean;
     /** Check if a tool would be auto-resolved by a session rule */
@@ -53,7 +52,6 @@ export declare class ApprovalManager {
     get pendingCount(): number;
     dispose(): void;
     private resolveApproval;
-    private findMostRecentPending;
     private pruneExpiredRules;
     private summarizeTool;
     private describeRule;

package/dist/approval-manager.js

@@ -1,5 +1,5 @@
 import { DEFAULT_APPROVAL_CONFIG, parseApprovalReplyMetadata } from './approval-types.js';
-import { generateApprovalId, buildApprovalRequest, buildApprovalOutcome, parseTextApprovalReply, redactSecrets, } from './approval-format.js';
+import { generateApprovalId, buildApprovalRequest, buildApprovalOutcome, redactSecrets, } from './approval-format.js';
 // ── ApprovalManager ─────────────────────────────────────────────────
 /**
  * Platform-agnostic approval protocol for Canon.
@@ -156,21 +156,6 @@ export class ApprovalManager {
                 return false;
             return this.resolveApproval(parsed.approvalId, parsed.decision, parsed.sessionRule, conversationId);
         }
-        // Fall back to text parsing
-        if (message.text) {
-            const parsed = parseTextApprovalReply(message.text);
-            if (!parsed)
-                return false;
-            // If the user targeted a specific approval ID
-            if (parsed.targetApprovalId) {
-                return this.resolveApproval(parsed.targetApprovalId, parsed.decision, parsed.sessionRule, conversationId);
-            }
-            // Otherwise match the most recent pending in this conversation
-            const pending = this.findMostRecentPending(conversationId);
-            if (!pending)
-                return false;
-            return this.resolveApproval(pending.approvalId, parsed.decision, parsed.sessionRule, conversationId);
-        }
         return false;
     }
     /** Check if a tool would be auto-resolved by a session rule */
@@ -258,15 +243,6 @@ export class ApprovalManager {
         entry.resolve({ decision, ...(acceptedSessionRule ? { sessionRule: acceptedSessionRule } : {}) });
         return true;
     }
-    findMostRecentPending(conversationId) {
-        let latest = null;
-        for (const p of this.pending.values()) {
-            if (p.conversationId === conversationId) {
-                latest = p; // Map iterates in insertion order, so last = most recent
-            }
-        }
-        return latest;
-    }
     pruneExpiredRules() {
         const now = Date.now();
         this.rules = this.rules.filter(({ rule }) => {

package/dist/browser.d.ts

@@ -1,7 +1,7 @@
 export { AGENT_CAPABILITIES, CLAUDE_PERMISSION_MODE_OPTIONS, } from './types.js';
 export { resolveCanonBaseUrl } from './base-url.js';
 export { DEFAULT_BASE_URL, DEFAULT_STREAM_URL, DEFAULT_RTDB_URL, FIREBASE_WEB_API_KEY } from './constants.js';
-export type { AddMemberResult, AgentCapabilities, AgentClientType, AgentSessionSnapshot, AgentRuntime, CanonControlAvailability, CanonControlDescriptor, CanonControlLiveBehavior, CanonControlSelectionPolicy, CanonControlValue, CanonContact, CanonContactRequest, CanonContactRequestStatus, CanonResolveAdmissionResult, ContactAddedPayload, ContactApprovedPayload, ContactRemovedPayload, ContactRequestPayload, ContactSource, ResolvedAdmissionState, ResolvedAdmissionTargetSummary, ResolvedTargetAdmissionPayload, CanonStreamEvent, CreateContactRequestResult, MediaAttachment, MediaAttachmentKind, ModelOption, PermissionModeOption, CanonRuntimeDescriptor, CanonRuntimeActionAvailability, CanonRuntimeActionCategory, CanonRuntimeActionDescriptor, CanonRuntimeActionDispatch, CanonRuntimeActionPlacement, CanonRuntimeCommandArgumentChoice, CanonRuntimeCommandArgumentDescriptor, CanonRuntimeCommandArgumentKind, CanonRuntimeCommandDescriptor, CanonRuntimeDetailTier, CanonRuntimeExecutionMetadata, CanonRuntimePresentationField, CanonRuntimePresentationHint, CanonRuntimePresentationPolicy, CanonRuntimePresentationPreset, CanonRuntimeVisibility, CanonRuntimeProvenance, CanonRuntimeActivityItem, CanonRuntimeActivityKind, CanonRuntimeActivityStatus, CanonRuntimeFact, CanonRuntimeFactGroup, CanonRuntimeInventory, CanonRuntimeInventoryEntry, CanonRuntimePrimitiveId, CanonRuntimeStreamingMode, CanonRuntimeStatusItem, CanonRuntimeSurfaceMode, CanonWorkspaceRootMetadata, RuntimeUpdatedPayload, RuntimeInfoPayload, RuntimeControlError, RuntimeControlState, RuntimeControlValueSource, ResolvedAdmission, SessionConfig, TurnUpdatedPayload, WorkspaceOption, WorkspaceOptionSource, } from './types.js';
+export type { AddMemberResult, AgentCapabilities, AgentClientType, AgentSessionSnapshot, AgentRuntime, CanonControlAvailability, CanonControlDescriptor, CanonControlLiveBehavior, CanonControlSelectionPolicy, CanonControlValue, CanonContact, CanonContactRequest, CanonContactRequestStatus, CanonResolveAdmissionResult, ContactAddedPayload, ContactApprovedPayload, ContactRemovedPayload, ContactRequestPayload, ContactSource, ResolvedAdmissionState, ResolvedAdmissionTargetSummary, ResolvedTargetAdmissionPayload, CanonStreamEvent, CreateContactRequestResult, MediaAttachment, MediaAttachmentKind, ModelOption, PermissionModeOption, CanonRuntimeDescriptor, CanonRuntimeActionAvailability, CanonRuntimeActionCategory, CanonRuntimeActionDescriptor, CanonRuntimeActionDispatch, CanonRuntimeActionPlacement, CanonRuntimeCommandArgumentChoice, CanonRuntimeCommandArgumentDescriptor, CanonRuntimeCommandArgumentKind, CanonRuntimeCommandDescriptor, CanonRuntimeDetailTier, CanonRuntimeExecutionMetadata, CanonRuntimePresentationField, CanonRuntimePresentationHint, CanonRuntimePresentationPolicy, CanonRuntimePresentationPreset, CanonRuntimeVisibility, CanonRuntimeProvenance, CanonRuntimeActivityItem, CanonRuntimeActivityKind, CanonRuntimeActivityStatus, CanonRuntimeFact, CanonRuntimeFactGroup, CanonRuntimeInventory, CanonRuntimeInventoryEntry, CanonRuntimePrimitiveId, CanonRuntimeStreamingMode, CanonRuntimeStatusItem, CanonRuntimeSurfaceMode, CanonWorkspaceRootMetadata, RuntimeUpdatedPayload, RuntimeInfoPayload, RuntimeControlError, RuntimeControlState, RuntimeControlValueSource, ResolvedAdmission, SessionConfig, TurnOutputBlock, TurnOutputBlockKind, TurnOutputBlockStatus, TurnUpdatedPayload, WorkspaceOption, WorkspaceOptionSource, } from './types.js';
 export { DEFAULT_FIRST_PARTY_RUNTIME_PRESENTATION, RUNTIME_PRESENTATION_FIELDS, buildRuntimePresentationPolicy, getRuntimePresentationHint, isRuntimePresentationField, isRuntimePresentationFieldHidden, redactAgentSessionSnapshotForConversation, redactExecutionMetadataForConversation, redactRuntimeDescriptorForConversation, redactRuntimeInfoForConversation, } from './runtime-presentation.js';
 export { buildRuntimeProvenance, resolveRuntimeProvenance, } from './provenance.js';
 export { EXECUTION_ENVIRONMENT_MODES, isExecutionEnvironmentMode, } from './execution-environment-mode.js';
@@ -14,8 +14,10 @@ export type { AgentBehaviorSettings, ParticipationHistoryMessage, ParticipationH
 export { buildParticipationHistorySnapshot, buildParticipationHistorySnapshots, buildBehaviorPolicyLines, DEFAULT_PARTICIPATION_HISTORY_FETCH_LIMIT, evaluateParticipationPolicy, getDefaultParticipationPolicy, resolveAgentBehaviorPolicy, } from './policy.js';
 export { DEFAULT_RUNTIME_CAPABILITIES, ACTIVE_TURN_STALE_THRESHOLD_MS, FINAL_MESSAGE_HANDOFF_MS, WAITING_INPUT_STALE_THRESHOLD_MS, getTurnStateStaleThresholdMs, isTurnOpen, isTurnStateStale, normalizeTurnMetadata, normalizeTurnState, resolveTurnMessageSemantics, shouldPromoteConversationMessage, shouldTriggerAgentTurn, } from './turn-protocol.js';
 export type { DeliveryIntent, InboundDisposition, RuntimeCapabilities, TriggerDecision, TurnLifecycleState, TurnMessageSemantics, TurnMetadata, TurnState, } from './turn-protocol.js';
-export { buildApprovalReply, buildApprovalRequest, buildApprovalOutcome, generateApprovalId, parseTextApprovalReply, redactSecrets, } from './approval-format.js';
+export { buildApprovalReply, buildApprovalRequest, buildApprovalOutcome, generateApprovalId, redactSecrets, } from './approval-format.js';
 export type { ApprovalRequestCategory, ApprovalRequestDetail, ApprovalRequestMetadata, ApprovalNativeRequestMetadata, ApprovalRisk, ApprovalReplyMetadata, ApprovalOutcomeMetadata, SessionRule, ApprovalResult, ApprovalConfig, } from './approval-types.js';
 export { DEFAULT_APPROVAL_CONFIG, parseApprovalRequestMetadata, parseApprovalReplyMetadata, parseSessionRule, } from './approval-types.js';
 export { buildRuntimeInputOutcome, buildRuntimeInputReply, buildRuntimeInputRequest, buildPlanApprovalReply, buildPlanApprovalRequest, buildQuestionReply, buildQuestionRequest, parseRuntimeInputOutcomeMetadata, parseRuntimeInputReplyMetadata, parseRuntimeInputRequestMetadata, } from './runtime-cards.js';
-export type { ClaudeQuestionMetadata, ClaudeQuestionReplyMetadata, PlanApprovalMetadata, PlanApprovalReplyMetadata, RuntimeInputChoice, RuntimeInputKind, RuntimeInputNativeMetadata, RuntimeInputOutcomeMetadata, RuntimeInputReplyMetadata, RuntimeInputReplyStatus, RuntimeInputRequestMetadata, RuntimeInputResolutionStatus, RuntimeQuestionDefinition, RuntimeQuestionOption, } from './runtime-cards.js';
+export type { ClaudeQuestionMetadata, ClaudeQuestionReplyMetadata, PlanApprovalMetadata, PlanApprovalReplyMetadata, RuntimeInputAnswers, RuntimeInputChoice, RuntimeInputKind, RuntimeInputNativeMetadata, RuntimeInputOutcomeMetadata, RuntimeInputQuestion, RuntimeInputReplyMetadata, RuntimeInputReplyStatus, RuntimeInputRequestMetadata, RuntimeInputResolutionStatus, RuntimeQuestionDefinition, RuntimeQuestionOption, } from './runtime-cards.js';
+export { DEFAULT_TURN_TRAIL_MAX_BLOCKS, DEFAULT_TURN_TRAIL_METADATA_BUDGET_BYTES, buildBoundedTurnTrail, } from './turn-output-controller.js';
+export type { BuildBoundedTurnTrailOptions, TurnOutputBlockInput, } from './turn-output-controller.js';

package/dist/browser.js

@@ -9,6 +9,7 @@ export { buildAgentSessionSnapshot } from './agent-session.js';
 export { CLAUDE_EFFORT_OPTIONS, EXECUTION_MODE_CONTROL_OPTIONS, RUNTIME_NEW_SESSION_ACTION, RUNTIME_STOP_ACTION, RUNTIME_STOP_AND_DROP_ACTION, buildFirstPartyCodingRuntimeDescriptor, buildRuntimeEffortControl, buildRuntimeExecutionModeControl, buildRuntimeExecutionModeOptions, buildRuntimeModelControl, buildRuntimePermissionModeControl, buildRuntimeWorkspaceControl, buildRuntimeWorkspaceControlOptions, } from './runtime-descriptor.js';
 export { buildParticipationHistorySnapshot, buildParticipationHistorySnapshots, buildBehaviorPolicyLines, DEFAULT_PARTICIPATION_HISTORY_FETCH_LIMIT, evaluateParticipationPolicy, getDefaultParticipationPolicy, resolveAgentBehaviorPolicy, } from './policy.js';
 export { DEFAULT_RUNTIME_CAPABILITIES, ACTIVE_TURN_STALE_THRESHOLD_MS, FINAL_MESSAGE_HANDOFF_MS, WAITING_INPUT_STALE_THRESHOLD_MS, getTurnStateStaleThresholdMs, isTurnOpen, isTurnStateStale, normalizeTurnMetadata, normalizeTurnState, resolveTurnMessageSemantics, shouldPromoteConversationMessage, shouldTriggerAgentTurn, } from './turn-protocol.js';
-export { buildApprovalReply, buildApprovalRequest, buildApprovalOutcome, generateApprovalId, parseTextApprovalReply, redactSecrets, } from './approval-format.js';
+export { buildApprovalReply, buildApprovalRequest, buildApprovalOutcome, generateApprovalId, redactSecrets, } from './approval-format.js';
 export { DEFAULT_APPROVAL_CONFIG, parseApprovalRequestMetadata, parseApprovalReplyMetadata, parseSessionRule, } from './approval-types.js';
 export { buildRuntimeInputOutcome, buildRuntimeInputReply, buildRuntimeInputRequest, buildPlanApprovalReply, buildPlanApprovalRequest, buildQuestionReply, buildQuestionRequest, parseRuntimeInputOutcomeMetadata, parseRuntimeInputReplyMetadata, parseRuntimeInputRequestMetadata, } from './runtime-cards.js';
+export { DEFAULT_TURN_TRAIL_MAX_BLOCKS, DEFAULT_TURN_TRAIL_METADATA_BUDGET_BYTES, buildBoundedTurnTrail, } from './turn-output-controller.js';

package/dist/client.d.ts

@@ -1,7 +1,7 @@
 import { type CanonMessage, type CanonConversation, type CanonContact, type CanonContactRequest, type CanonMessagesPage, type CanonResolveAdmissionResult, type AgentContext, type AddMemberResult, type CreateContactRequestResult, type MediaAttachment, type SendMessageOptions, type CreateConversationOptions, type RegistrationStatus, type SetRuntimeTurnOptions, type SetStreamingOptions } from './types.js';
 import type { RuntimeInputKind } from './runtime-cards.js';
 import type { ApprovalNativeRequestMetadata, ApprovalRequestCategory, ApprovalRequestDetail, ApprovalRisk, SessionRule } from './approval-types.js';
-import type { RuntimeInputChoice, RuntimeInputNativeMetadata } from './runtime-cards.js';
+import type { RuntimeInputAnswers, RuntimeInputChoice, RuntimeInputNativeMetadata, RuntimeInputQuestion } from './runtime-cards.js';
 import type { SendContextualMessageOptions, SendContextualMessageResult } from './self-context.js';
 import type { InboundDisposition } from './turn-protocol.js';
 /**
@@ -65,6 +65,7 @@ export declare class CanonClient {
         title?: string;
         prompt?: string;
         choices?: RuntimeInputChoice[];
+        questions?: RuntimeInputQuestion[];
         secretName?: string;
         native?: RuntimeInputNativeMetadata;
         sensitive?: boolean;
@@ -89,6 +90,7 @@ export declare class CanonClient {
         inputId: string;
         kind: RuntimeInputKind;
         value: string;
+        answers?: RuntimeInputAnswers;
     } | {
         status: 'cancelled';
         inputId: string;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { AGENT_CAPABILITIES, CLAUDE_PERMISSION_MODE_OPTIONS, } from './types.js';
-export type { AddMemberResult, AgentCapabilities, AgentClientType, CanonControlAvailability, CanonControlDescriptor, CanonControlLiveBehavior, CanonControlSelectionPolicy, CanonControlValue, CanonContact, CanonContactRequest, CanonContactRequestStatus, CanonGroupContext, CanonGroupContextMode, CanonKnownRecentParticipant, CanonMembershipChange, CanonResolveAdmissionResult, ConversationUpdatedPayload, ContactAddedPayload, ContactApprovedPayload, ContactCardPayload, ContactRemovedPayload, ContactRequestPayload, ContactSource, ResolvedAdmissionState, ResolvedAdmissionTargetSummary, ResolvedTargetAdmissionPayload, CanonMessage, CanonRuntimeProvenance, CanonConversation, CanonMessagesPage, CreateContactRequestResult, AgentContext, CanonStreamEvent, AgentSessionSnapshot, ResolvedAdmission, MediaAttachment, MediaAttachmentKind, MessageCreatedPayload, TypingPayload, PresencePayload, RuntimeUpdatedPayload, TurnUpdatedPayload, SendMessageOptions, CreateConversationOptions, RegistrationInput, RegistrationResult, RegistrationStatus, SetRuntimeTurnOptions, StreamingStatus, SetStreamingOptions, SessionControl, SessionState, SessionConfig, AgentRuntime, CanonRuntimeDescriptor, CanonRuntimeActionAvailability, CanonRuntimeActionCategory, CanonRuntimeActionDescriptor, CanonRuntimeActionDispatch, CanonRuntimeActionPlacement, CanonRuntimeCommandArgumentChoice, CanonRuntimeCommandArgumentDescriptor, CanonRuntimeCommandArgumentKind, CanonRuntimeCommandDescriptor, CanonRuntimeDetailTier, CanonRuntimeExecutionMetadata, CanonRuntimePresentationField, CanonRuntimePresentationHint, CanonRuntimePresentationPolicy, CanonRuntimePresentationPreset, CanonRuntimeVisibility, CanonRuntimeActivityItem, CanonRuntimeActivityKind, CanonRuntimeActivityStatus, CanonRuntimeFact, CanonRuntimeFactGroup, CanonRuntimeInventory, CanonRuntimeInventoryEntry, CanonRuntimePrimitiveId, CanonRuntimeStreamingMode, CanonRuntimeStatusItem, CanonRuntimeSurfaceMode, CanonWorkspaceRootMetadata, ModelOption, PermissionModeOption, RuntimeInfoPayload, RuntimeControlError, RuntimeControlState, RuntimeControlValueSource, WorkspaceOption, WorkspaceOptionSource, } from './types.js';
+export type { AddMemberResult, AgentCapabilities, AgentClientType, CanonControlAvailability, CanonControlDescriptor, CanonControlLiveBehavior, CanonControlSelectionPolicy, CanonControlValue, CanonContact, CanonContactRequest, CanonContactRequestStatus, CanonGroupContext, CanonGroupContextMode, CanonKnownRecentParticipant, CanonMembershipChange, CanonResolveAdmissionResult, ConversationUpdatedPayload, ContactAddedPayload, ContactApprovedPayload, ContactCardPayload, ContactRemovedPayload, ContactRequestPayload, ContactSource, ResolvedAdmissionState, ResolvedAdmissionTargetSummary, ResolvedTargetAdmissionPayload, CanonMessage, CanonRuntimeProvenance, CanonConversation, CanonMessagesPage, CreateContactRequestResult, AgentContext, CanonStreamEvent, AgentSessionSnapshot, ResolvedAdmission, MediaAttachment, MediaAttachmentKind, MessageCreatedPayload, TypingPayload, PresencePayload, RuntimeUpdatedPayload, TurnUpdatedPayload, SendMessageOptions, CreateConversationOptions, RegistrationInput, RegistrationResult, RegistrationStatus, SetRuntimeTurnOptions, StreamingStatus, SetStreamingOptions, SessionControl, SessionState, SessionConfig, AgentRuntime, CanonRuntimeDescriptor, CanonRuntimeActionAvailability, CanonRuntimeActionCategory, CanonRuntimeActionDescriptor, CanonRuntimeActionDispatch, CanonRuntimeActionPlacement, CanonRuntimeCommandArgumentChoice, CanonRuntimeCommandArgumentDescriptor, CanonRuntimeCommandArgumentKind, CanonRuntimeCommandDescriptor, CanonRuntimeDetailTier, CanonRuntimeExecutionMetadata, CanonRuntimePresentationField, CanonRuntimePresentationHint, CanonRuntimePresentationPolicy, CanonRuntimePresentationPreset, CanonRuntimeVisibility, CanonRuntimeActivityItem, CanonRuntimeActivityKind, CanonRuntimeActivityStatus, CanonRuntimeFact, CanonRuntimeFactGroup, CanonRuntimeInventory, CanonRuntimeInventoryEntry, CanonRuntimePrimitiveId, CanonRuntimeStreamingMode, CanonRuntimeStatusItem, CanonRuntimeSurfaceMode, CanonWorkspaceRootMetadata, ModelOption, PermissionModeOption, RuntimeInfoPayload, RuntimeControlError, RuntimeControlState, RuntimeControlValueSource, TurnOutputBlock, TurnOutputBlockKind, TurnOutputBlockStatus, WorkspaceOption, WorkspaceOptionSource, } from './types.js';
 export { DEFAULT_FIRST_PARTY_RUNTIME_PRESENTATION, RUNTIME_PRESENTATION_FIELDS, buildRuntimePresentationPolicy, getRuntimePresentationHint, isRuntimePresentationField, isRuntimePresentationFieldHidden, redactAgentRuntimeForConversation, redactAgentSessionSnapshotForConversation, redactExecutionMetadataForConversation, redactRuntimeActivityItemForConversation, redactRuntimeDescriptorForConversation, redactRuntimeInfoForConversation, redactSessionStateForConversation, } from './runtime-presentation.js';
 export { buildRuntimeProvenance, resolveRuntimeProvenance, } from './provenance.js';
 export type { CanonSelfContext, CanonSelfContextType, SelfContextPromptRenderOptions, SendContextualMessageOptions, SendContextualMessageResult, SendContextualSelfContextInput, } from './self-context.js';
@@ -17,15 +17,15 @@ export { DEFAULT_RUNTIME_CAPABILITIES, ACTIVE_TURN_STALE_THRESHOLD_MS, HOST_ADMI
 export type { DeliveryIntent, TurnMessageSemantics, InboundDisposition, TurnLifecycleState, RuntimeCapabilities, HostAdmissionActionCapabilities, TurnState, TurnMetadata, TriggerDecision, } from './turn-protocol.js';
 export { ackRegistrationApproval, registerAndWaitForApproval, submitRegistrationRequest, waitForRegistrationApproval, } from './registration.js';
 export { ApprovalManager } from './approval-manager.js';
-export { generateApprovalId, buildApprovalRequest, buildApprovalReply, buildApprovalOutcome, parseTextApprovalReply, redactSecrets, } from './approval-format.js';
+export { generateApprovalId, buildApprovalRequest, buildApprovalReply, buildApprovalOutcome, redactSecrets, } from './approval-format.js';
 export { DEFAULT_APPROVAL_CONFIG, parseApprovalRequestMetadata, parseApprovalReplyMetadata, parseSessionRule, } from './approval-types.js';
 export type { ApprovalRequestCategory, ApprovalRequestDetail, ApprovalRequestMetadata, ApprovalNativeRequestMetadata, ApprovalRisk, ApprovalReplyMetadata, ApprovalOutcomeMetadata, SessionRule, ApprovalResult, ApprovalConfig, } from './approval-types.js';
 export { buildRuntimeInputOutcome, buildRuntimeInputReply, buildRuntimeInputRequest, buildPlanApprovalReply, buildPlanApprovalRequest, buildQuestionReply, buildQuestionRequest, parseRuntimeInputOutcomeMetadata, parseRuntimeInputReplyMetadata, parseRuntimeInputRequestMetadata, } from './runtime-cards.js';
-export type { ClaudeQuestionMetadata, ClaudeQuestionReplyMetadata, PlanApprovalMetadata, PlanApprovalReplyMetadata, RuntimeInputChoice, RuntimeInputKind, RuntimeInputNativeMetadata, RuntimeInputOutcomeMetadata, RuntimeInputReplyMetadata, RuntimeInputReplyStatus, RuntimeInputRequestMetadata, RuntimeInputResolutionStatus, RuntimeQuestionDefinition, RuntimeQuestionOption, } from './runtime-cards.js';
+export type { ClaudeQuestionMetadata, ClaudeQuestionReplyMetadata, PlanApprovalMetadata, PlanApprovalReplyMetadata, RuntimeInputAnswers, RuntimeInputChoice, RuntimeInputKind, RuntimeInputNativeMetadata, RuntimeInputOutcomeMetadata, RuntimeInputQuestion, RuntimeInputReplyMetadata, RuntimeInputReplyStatus, RuntimeInputRequestMetadata, RuntimeInputResolutionStatus, RuntimeQuestionDefinition, RuntimeQuestionOption, } from './runtime-cards.js';
 export { createStreamingHelper } from './streaming.js';
 export type { RTDBHandle, RTDBRef, ServerTimestamp, StreamingHelperOptions, StreamingNode } from './streaming.js';
-export { createTurnOutputController } from './turn-output-controller.js';
-export type { TurnOutputController, TurnOutputControllerOptions, TurnOutputMode, TurnOutputSnapshot, } from './turn-output-controller.js';
+export { DEFAULT_TURN_TRAIL_MAX_BLOCKS, DEFAULT_TURN_TRAIL_METADATA_BUDGET_BYTES, buildBoundedTurnTrail, createTurnOutputController, } from './turn-output-controller.js';
+export type { BuildBoundedTurnTrailOptions, TurnOutputController, TurnOutputBlockInput, TurnOutputControllerOptions, TurnOutputMode, TurnOutputSnapshot, } from './turn-output-controller.js';
 export { clearPendingRegistration, getOrCreatePendingRegistration, loadPendingRegistrations, loadProfiles, savePendingRegistrations, saveProfiles, updatePendingRegistration, upsertAgentProfile, isProfileLocked, acquireLock, releaseLock, isProcessAlive, CANON_DIR, AGENTS_PATH, LOCKS_DIR, } from './agent-profiles.js';
 export type { AgentProfile, PendingRegistration, ProfileLockHandle } from './agent-profiles.js';
 export { resolveCanonAgent, resolveCanonProfile, getActiveProfile, getActiveProfileLock } from './agent-resolver.js';

package/dist/index.js

@@ -17,12 +17,12 @@ export { DEFAULT_RUNTIME_CAPABILITIES, ACTIVE_TURN_STALE_THRESHOLD_MS, HOST_ADMI
 export { ackRegistrationApproval, registerAndWaitForApproval, submitRegistrationRequest, waitForRegistrationApproval, } from './registration.js';
 // Approval
 export { ApprovalManager } from './approval-manager.js';
-export { generateApprovalId, buildApprovalRequest, buildApprovalReply, buildApprovalOutcome, parseTextApprovalReply, redactSecrets, } from './approval-format.js';
+export { generateApprovalId, buildApprovalRequest, buildApprovalReply, buildApprovalOutcome, redactSecrets, } from './approval-format.js';
 export { DEFAULT_APPROVAL_CONFIG, parseApprovalRequestMetadata, parseApprovalReplyMetadata, parseSessionRule, } from './approval-types.js';
 export { buildRuntimeInputOutcome, buildRuntimeInputReply, buildRuntimeInputRequest, buildPlanApprovalReply, buildPlanApprovalRequest, buildQuestionReply, buildQuestionRequest, parseRuntimeInputOutcomeMetadata, parseRuntimeInputReplyMetadata, parseRuntimeInputRequestMetadata, } from './runtime-cards.js';
 // Streaming (RTDB helpers)
 export { createStreamingHelper } from './streaming.js';
-export { createTurnOutputController } from './turn-output-controller.js';
+export { DEFAULT_TURN_TRAIL_MAX_BLOCKS, DEFAULT_TURN_TRAIL_METADATA_BUDGET_BYTES, buildBoundedTurnTrail, createTurnOutputController, } from './turn-output-controller.js';
 // Agent profiles (loading, locking, resolution)
 export { clearPendingRegistration, getOrCreatePendingRegistration, loadPendingRegistrations, loadProfiles, savePendingRegistrations, saveProfiles, updatePendingRegistration, upsertAgentProfile, isProfileLocked, acquireLock, releaseLock, isProcessAlive, CANON_DIR, AGENTS_PATH, LOCKS_DIR, } from './agent-profiles.js';
 // Agent resolver

package/dist/runtime-cards.d.ts

@@ -47,6 +47,18 @@ export interface RuntimeInputChoice {
     value?: string;
     description?: string;
 }
+export interface RuntimeInputQuestion {
+    id: string;
+    question: string;
+    header?: string;
+    choices?: RuntimeInputChoice[];
+    allowOther?: boolean;
+    isSecret?: boolean;
+    multiSelect?: boolean;
+}
+export type RuntimeInputAnswers = Record<string, {
+    answers: string[];
+}>;
 export interface RuntimeInputNativeMetadata {
     runtime?: string;
     method?: string;
@@ -64,6 +76,7 @@ export interface RuntimeInputRequestMetadata {
     prompt: string;
     title?: string;
     choices?: RuntimeInputChoice[];
+    questions?: RuntimeInputQuestion[];
     secretName?: string;
     native?: RuntimeInputNativeMetadata;
     expiresAt: string;
@@ -75,6 +88,7 @@ export interface RuntimeInputReplyMetadata {
     kind?: RuntimeInputKind;
     status: RuntimeInputReplyStatus;
     answerSummary?: string;
+    answersSummary?: string;
     sensitive?: boolean;
 }
 export interface RuntimeInputOutcomeMetadata {
@@ -109,6 +123,7 @@ export declare function buildRuntimeInputRequest(inputId: string, input: Omit<Ru
 export declare function buildRuntimeInputReply(inputId: string, status: RuntimeInputReplyStatus, details?: {
     kind?: RuntimeInputKind;
     answerSummary?: string;
+    answersSummary?: string;
     sensitive?: boolean;
 }): {
     text: string;

package/dist/runtime-cards.js

@@ -38,6 +38,30 @@ function normalizeRuntimeInputChoices(value) {
     });
     return choices.length > 0 ? choices : undefined;
 }
+function normalizeRuntimeInputQuestions(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const questions = value.slice(0, 12).flatMap((entry) => {
+        if (!isRecord(entry))
+            return [];
+        const id = normalizeString(entry.id, 120);
+        const question = normalizeString(entry.question, 1000);
+        if (!id || !/^[a-zA-Z0-9_.:-]{1,120}$/.test(id) || !question)
+            return [];
+        const header = normalizeString(entry.header, 120) ?? undefined;
+        const choices = normalizeRuntimeInputChoices(entry.choices);
+        return [{
+                id,
+                question,
+                ...(header ? { header } : {}),
+                ...(choices ? { choices } : {}),
+                ...(entry.allowOther === true ? { allowOther: true } : {}),
+                ...(entry.isSecret === true ? { isSecret: true } : {}),
+                ...(entry.multiSelect === true ? { multiSelect: true } : {}),
+            }];
+    });
+    return questions.length > 0 ? questions : undefined;
+}
 function normalizeRuntimeInputNative(value) {
     if (!isRecord(value))
         return undefined;
@@ -130,6 +154,7 @@ export function buildRuntimeInputRequest(inputId, input) {
             prompt: input.prompt.slice(0, 1000),
             title: title.slice(0, 120),
             ...(input.choices?.length ? { choices: input.choices.slice(0, 12) } : {}),
+            ...(input.questions?.length ? { questions: input.questions.slice(0, 12) } : {}),
             ...(input.secretName ? { secretName: input.secretName.slice(0, 120) } : {}),
             ...(input.native ? { native: input.native } : {}),
             expiresAt: input.expiresAt,
@@ -139,6 +164,7 @@ export function buildRuntimeInputRequest(inputId, input) {
 }
 export function buildRuntimeInputReply(inputId, status, details) {
     const answerSummary = details?.sensitive ? undefined : details?.answerSummary?.trim().slice(0, 500);
+    const answersSummary = details?.sensitive ? undefined : details?.answersSummary?.trim().slice(0, 500);
     return {
         text: status === 'submitted' ? 'Submitted' : 'Cancelled',
         metadata: {
@@ -147,6 +173,7 @@ export function buildRuntimeInputReply(inputId, status, details) {
             ...(details?.kind ? { kind: details.kind } : {}),
             status,
             ...(answerSummary ? { answerSummary } : {}),
+            ...(answersSummary ? { answersSummary } : {}),
             ...(details?.sensitive ? { sensitive: true } : {}),
         },
     };
@@ -184,6 +211,7 @@ export function parseRuntimeInputRequestMetadata(value) {
         return null;
     const title = normalizeString(value.title, 120) ?? undefined;
     const choices = normalizeRuntimeInputChoices(value.choices);
+    const questions = normalizeRuntimeInputQuestions(value.questions);
     const secretName = normalizeString(value.secretName, 120) ?? undefined;
     const native = normalizeRuntimeInputNative(value.native);
     return {
@@ -194,6 +222,7 @@ export function parseRuntimeInputRequestMetadata(value) {
         prompt,
         ...(title ? { title } : {}),
         ...(choices ? { choices } : {}),
+        ...(questions ? { questions } : {}),
         ...(secretName ? { secretName } : {}),
         ...(native ? { native } : {}),
         expiresAt: new Date(expiresMs).toISOString(),
@@ -211,12 +240,14 @@ export function parseRuntimeInputReplyMetadata(value) {
         return null;
     const kind = normalizeRuntimeInputKind(value.kind) ?? undefined;
     const answerSummary = value.sensitive === true ? undefined : normalizeString(value.answerSummary, 500) ?? undefined;
+    const answersSummary = value.sensitive === true ? undefined : normalizeString(value.answersSummary, 500) ?? undefined;
     return {
         type: 'runtime_input_reply',
         inputId,
         ...(kind ? { kind } : {}),
         status,
         ...(answerSummary ? { answerSummary } : {}),
+        ...(answersSummary ? { answersSummary } : {}),
         ...(value.sensitive === true ? { sensitive: true } : {}),
     };
 }

package/dist/runtime-descriptor.d.ts

@@ -1,5 +1,5 @@
 import type { ExecutionEnvironmentMode } from './execution-environment-mode.js';
-import { type AgentClientType, type CanonControlDescriptor, type CanonRuntimeActionDescriptor, type CanonRuntimeCommandDescriptor, type CanonRuntimeDescriptor, type CanonRuntimeStreamingMode, type CanonWorkspaceRootMetadata, type ModelOption, type PermissionModeOption, type WorkspaceOption } from './types.js';
+import { type AgentClientType, type CanonControlDescriptor, type CanonRuntimeCommandDescriptor, type CanonRuntimeDescriptor, type CanonRuntimeStreamingMode, type CanonWorkspaceRootMetadata, type ModelOption, type PermissionModeOption, type WorkspaceOption } from './types.js';
 import type { CanonRuntimePresentationPolicy } from './types.js';
 import type { HostAdmissionActionCapabilities } from './turn-protocol.js';
 export declare const CLAUDE_EFFORT_OPTIONS: readonly [{
@@ -37,9 +37,9 @@ export declare function buildRuntimePermissionModeControl(input: {
     defaultValue?: string | null;
 }): CanonControlDescriptor;
 export declare function buildRuntimeEffortControl(): CanonControlDescriptor;
-export declare const RUNTIME_STOP_ACTION: CanonRuntimeActionDescriptor;
-export declare const RUNTIME_STOP_AND_DROP_ACTION: CanonRuntimeActionDescriptor;
-export declare const RUNTIME_NEW_SESSION_ACTION: CanonRuntimeActionDescriptor;
+export declare const RUNTIME_STOP_ACTION: CanonRuntimeCommandDescriptor;
+export declare const RUNTIME_STOP_AND_DROP_ACTION: CanonRuntimeCommandDescriptor;
+export declare const RUNTIME_NEW_SESSION_ACTION: CanonRuntimeCommandDescriptor;
 export declare function buildFirstPartyCodingRuntimeDescriptor(input: {
     clientType: Extract<AgentClientType, 'claude-code' | 'codex'>;
     models: ReadonlyArray<ModelOption>;
@@ -48,7 +48,6 @@ export declare function buildFirstPartyCodingRuntimeDescriptor(input: {
     executionModes: ReadonlyArray<ExecutionEnvironmentMode>;
     permissionModes?: ReadonlyArray<PermissionModeOption>;
     defaultPermissionMode?: string | null;
-    actions?: ReadonlyArray<CanonRuntimeActionDescriptor>;
     commands?: ReadonlyArray<CanonRuntimeCommandDescriptor>;
     streamingTextMode: CanonRuntimeStreamingMode;
     admissionActions?: HostAdmissionActionCapabilities;

package/dist/runtime-descriptor.js

@@ -151,7 +151,6 @@ export function buildFirstPartyCodingRuntimeDescriptor(input) {
             ...(input.clientType === 'claude-code' ? [buildRuntimeEffortControl()] : []),
         ],
         commands: input.commands,
-        actions: input.actions,
         workspaceRoots: input.workspaceRoots,
         supportsInterrupt: true,
         supportsInputInterrupt: true,

package/dist/runtime-presentation.js

@@ -177,14 +177,11 @@ export function redactRuntimeDescriptorForConversation(descriptor) {
         .filter((control) => Boolean(control));
     const commands = descriptor.commands?.map((command) => redactAction(command))
         .filter((command) => Boolean(command));
-    const actions = descriptor.actions?.map((action) => redactAction(action))
-        .filter((action) => Boolean(action));
     return cloneDefined({
         ...descriptor,
         coreControls,
         runtimeControls,
         commands,
-        actions,
         workspaceRoots: isRuntimePresentationFieldHidden(descriptor, 'workspaceRoot')
             ? []
             : descriptor.workspaceRoots,

package/dist/runtime-state-publisher.d.ts

@@ -1,4 +1,4 @@
-import type { AgentClientType, AgentRuntime, CanonRuntimeActivityItem, RuntimeInfoPayload } from './types.js';
+import type { AgentClientType, AgentRuntime, CanonRuntimeActivityItem, RuntimeInfoPayload, TurnOutputBlock } from './types.js';
 import { type AgentSessionSnapshotPatch, type RTDBClientHandle, type SessionStatePayload, type TurnStatePayload } from './rtdb-rest.js';
 export interface RuntimeStatePublisherOptions {
     agentId: string;
@@ -8,9 +8,10 @@ export interface RuntimeStatePublisherOptions {
 }
 export interface RuntimeStreamingPayload {
     text: string;
-    status: 'thinking' | 'streaming' | 'tool';
+    status: 'thinking' | 'streaming' | 'tool' | 'waiting_input';
     messageId?: string;
     turnId?: string | null;
+    blocks?: TurnOutputBlock[];
     updatedAt?: number | {
         '.sv': 'timestamp';
     };

package/dist/runtime-state-publisher.js

@@ -25,7 +25,6 @@ function hasPreservableRuntimeState(value) {
     return hasNonEmptyArray(runtimeDescriptor.coreControls)
         || hasNonEmptyArray(runtimeDescriptor.runtimeControls)
         || hasNonEmptyArray(runtimeDescriptor.commands)
-        || hasNonEmptyArray(runtimeDescriptor.actions)
         || hasNonEmptyArray(runtimeDescriptor.workspaceRoots)
         || hasNonEmptyArray(runtimeDescriptor.writableRoots)
         || hasEnabledAdmissionActions(runtimeDescriptor.admissionActions)

package/dist/streaming.d.ts

@@ -1,4 +1,4 @@
-import type { StreamingStatus } from './types.js';
+import type { StreamingStatus, TurnOutputBlock } from './types.js';
 /** Minimal subset of firebase-admin Database to avoid a hard dependency. */
 export interface RTDBHandle {
     ref(path: string): RTDBRef;
@@ -24,6 +24,7 @@ export interface StreamingNode {
     updatedAt: unknown;
     messageId: string;
     turnId?: string | null;
+    blocks?: TurnOutputBlock[];
 }
 /**
  * Creates helpers that read/write the RTDB streaming node for a single
@@ -44,7 +45,7 @@ export declare function createStreamingHelper(opts: StreamingHelperOptions): {
         /** Write the initial streaming node (status: "thinking", empty text). */
         start(messageId: string, turnId?: string | null): Promise<void>;
         /** Update the accumulated text and optionally change status. */
-        update(text: string, status?: StreamingStatus): Promise<void>;
+        update(text: string, status?: StreamingStatus, blocks?: TurnOutputBlock[]): Promise<void>;
         /** Set status without changing text (e.g. switching to "tool"). */
         setStatus(status: StreamingStatus): Promise<void>;
         /** Remove the streaming node (call after final Firestore message is written). */

package/dist/streaming.js

@@ -32,12 +32,15 @@ export function createStreamingHelper(opts) {
                 await nodeRef.set(node);
             },
             /** Update the accumulated text and optionally change status. */
-            async update(text, status = 'streaming') {
-                await nodeRef.update({
+            async update(text, status = 'streaming', blocks) {
+                const update = {
                     text,
                     status,
                     updatedAt: serverTimestamp,
-                });
+                };
+                if (blocks)
+                    update.blocks = blocks;
+                await nodeRef.update(update);
             },
             /** Set status without changing text (e.g. switching to "tool"). */
             async setStatus(status) {

package/dist/turn-output-controller.d.ts

@@ -1,10 +1,25 @@
-import type { StreamingStatus } from './types.js';
+import type { StreamingStatus, TurnOutputBlock, TurnOutputBlockKind, TurnOutputBlockStatus } from './types.js';
 export type TurnOutputMode = 'delta' | 'block' | 'snapshot' | 'status';
 export interface TurnOutputSnapshot {
     turnId: string;
     messageId: string;
     text: string;
     status: StreamingStatus;
+    blocks?: TurnOutputBlock[];
+}
+export interface TurnOutputBlockInput {
+    id: string;
+    kind: TurnOutputBlockKind;
+    status?: TurnOutputBlockStatus;
+    sequence?: number;
+    title?: string;
+    text?: string;
+    summary?: string;
+    detail?: string;
+}
+export interface BuildBoundedTurnTrailOptions {
+    maxBlocks?: number;
+    maxMetadataBytes?: number;
 }
 export interface TurnOutputControllerOptions {
     turnId: string;
@@ -21,15 +36,24 @@ export interface TurnOutputController {
     readonly mode: TurnOutputMode;
     getText(): string;
     getStatus(): StreamingStatus;
+    getBlocks(): TurnOutputBlock[];
+    getFinalTrail(): TurnOutputBlock[];
     startThinking(text?: string): Promise<void>;
     startStreaming(text?: string): Promise<void>;
     appendDelta(delta: string): void;
     appendBlock(block: string): void;
     replaceSnapshot(text: string, status?: StreamingStatus): Promise<void>;
     setStatus(status: StreamingStatus, text?: string): Promise<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>;
     flush(status?: StreamingStatus): Promise<void>;
     waitingInput(): Promise<void>;
     interrupt(): Promise<void>;
     clear(): Promise<void>;
 }
+export declare const DEFAULT_TURN_TRAIL_MAX_BLOCKS = 20;
+export declare const DEFAULT_TURN_TRAIL_METADATA_BUDGET_BYTES = 2500;
+export declare function buildBoundedTurnTrail(blocks: readonly TurnOutputBlock[], options?: BuildBoundedTurnTrailOptions): TurnOutputBlock[];
 export declare function createTurnOutputController(options: TurnOutputControllerOptions): TurnOutputController;

package/dist/turn-output-controller.js

@@ -1,7 +1,12 @@
 const DEFAULT_THROTTLE_MS = 120;
 const DEFAULT_BLOCK_SEPARATOR = '\n\n';
+export const DEFAULT_TURN_TRAIL_MAX_BLOCKS = 20;
+export const DEFAULT_TURN_TRAIL_METADATA_BUDGET_BYTES = 2_500;
 function normalizeStatus(status) {
-    return status === 'thinking' || status === 'tool' || status === 'streaming'
+    return status === 'thinking'
+        || status === 'tool'
+        || status === 'streaming'
+        || status === 'waiting_input'
         ? status
         : 'streaming';
 }
@@ -12,6 +17,46 @@ function appendBlockText(currentText, block, separator) {
     const combined = `${currentText}${prefix}${block}`;
     return separator === '\n\n' ? combined.replace(/\n{3,}/g, '\n\n') : combined;
 }
+function trim(value, max) {
+    if (!value)
+        return undefined;
+    return value.length > max ? `${value.slice(0, max - 3)}...` : value;
+}
+function jsonByteLength(value) {
+    const serialized = JSON.stringify(value);
+    if (typeof TextEncoder !== 'undefined') {
+        return new TextEncoder().encode(serialized).length;
+    }
+    return serialized.length;
+}
+function compactTrailBlock(block) {
+    return {
+        id: trim(block.id, 120) ?? block.id,
+        turnId: trim(block.turnId, 120) ?? block.turnId,
+        kind: block.kind,
+        status: block.status,
+        sequence: block.sequence,
+        ...(trim(block.title, 80) ? { title: trim(block.title, 80) } : {}),
+        ...(trim(block.text, 280) ? { text: trim(block.text, 280) } : {}),
+        ...(trim(block.summary, 120) ? { summary: trim(block.summary, 120) } : {}),
+    };
+}
+export function buildBoundedTurnTrail(blocks, options = {}) {
+    const maxBlocks = options.maxBlocks ?? DEFAULT_TURN_TRAIL_MAX_BLOCKS;
+    const maxMetadataBytes = options.maxMetadataBytes ?? DEFAULT_TURN_TRAIL_METADATA_BUDGET_BYTES;
+    const out = [];
+    for (const block of [...blocks].sort((left, right) => left.sequence - right.sequence)) {
+        if (out.length >= maxBlocks)
+            break;
+        const candidate = compactTrailBlock(block);
+        const next = [...out, candidate];
+        if (jsonByteLength({ turnTrail: next }) > maxMetadataBytes) {
+            break;
+        }
+        out.push(candidate);
+    }
+    return out;
+}
 export function createTurnOutputController(options) {
     const schedule = options.schedule ?? setTimeout;
     const cancel = options.cancel ?? clearTimeout;
@@ -20,6 +65,8 @@ export function createTurnOutputController(options) {
     const blockSeparator = options.blockSeparator ?? DEFAULT_BLOCK_SEPARATOR;
     let text = '';
     let status = 'thinking';
+    let blocks = [];
+    let nextSequence = 1;
     let timer = null;
     let pendingPromise = Promise.resolve();
     const write = (nextStatus = status) => {
@@ -30,6 +77,7 @@ export function createTurnOutputController(options) {
             messageId: options.turnId,
             text,
             status: normalizeStatus(nextStatus),
+            ...(blocks.length > 0 ? { blocks: [...blocks] } : {}),
         };
         pendingPromise = pendingPromise
             .catch(() => { })
@@ -64,11 +112,60 @@ export function createTurnOutputController(options) {
         cancelTimer();
         text = '';
         status = 'thinking';
+        blocks = [];
+        nextSequence = 1;
         pendingPromise = pendingPromise
             .catch(() => { })
             .then(() => Promise.resolve(options.clearSnapshot()).catch(() => { }));
         await pendingPromise;
     };
+    const normalizeBlock = (block, existing) => {
+        const now = Date.now();
+        const sequence = existing?.sequence ?? block.sequence ?? nextSequence++;
+        if (sequence >= nextSequence)
+            nextSequence = sequence + 1;
+        return {
+            id: block.id,
+            turnId: options.turnId,
+            kind: block.kind,
+            status: block.status ?? existing?.status ?? 'running',
+            sequence,
+            ...(block.title ?? existing?.title ? { title: block.title ?? existing?.title } : {}),
+            ...(block.text ?? existing?.text ? { text: block.text ?? existing?.text } : {}),
+            ...(block.summary ?? existing?.summary ? { summary: block.summary ?? existing?.summary } : {}),
+            ...(block.detail ?? existing?.detail ? { detail: block.detail ?? existing?.detail } : {}),
+            createdAt: existing?.createdAt ?? now,
+            updatedAt: now,
+        };
+    };
+    const upsertBlock = async (id, patch, fallback) => {
+        const index = blocks.findIndex((block) => block.id === id);
+        if (index < 0 && !fallback)
+            return null;
+        const existing = index >= 0 ? blocks[index] : null;
+        const next = normalizeBlock({
+            id,
+            kind: patch.kind ?? existing?.kind ?? fallback.kind,
+            status: patch.status ?? existing?.status,
+            title: patch.title ?? existing?.title,
+            text: patch.text ?? existing?.text,
+            summary: patch.summary ?? existing?.summary,
+            detail: patch.detail ?? existing?.detail,
+            sequence: existing?.sequence,
+        }, existing);
+        if (index >= 0) {
+            blocks = [
+                ...blocks.slice(0, index),
+                next,
+                ...blocks.slice(index + 1),
+            ];
+        }
+        else {
+            blocks = [...blocks, next].sort((left, right) => left.sequence - right.sequence);
+        }
+        await flush(status);
+        return next;
+    };
     return {
         turnId: options.turnId,
         mode,
@@ -78,6 +175,12 @@ export function createTurnOutputController(options) {
         getStatus() {
             return status;
         },
+        getBlocks() {
+            return [...blocks];
+        },
+        getFinalTrail() {
+            return buildBoundedTurnTrail(blocks);
+        },
         async startThinking(nextText = '') {
             text = nextText;
             status = 'thinking';
@@ -91,7 +194,7 @@ export function createTurnOutputController(options) {
         appendDelta(delta) {
             if (!delta)
                 return;
-            if (status !== 'streaming')
+            if (status === 'thinking' && (!text || text === 'Thinking...'))
                 text = '';
             text += delta;
             status = 'streaming';
@@ -100,7 +203,7 @@ export function createTurnOutputController(options) {
         appendBlock(block) {
             if (!block)
                 return;
-            if (status !== 'streaming')
+            if (status === 'thinking' && (!text || text === 'Thinking...'))
                 text = '';
             text = appendBlockText(text, block, blockSeparator);
             status = 'streaming';
@@ -117,8 +220,23 @@ export function createTurnOutputController(options) {
             status = normalizeStatus(nextStatus);
             await flush(status);
         },
+        async addBlock(block) {
+            return upsertBlock(block.id, block, { kind: block.kind });
+        },
+        async updateBlock(id, patch) {
+            return upsertBlock(id, patch);
+        },
+        async completeBlock(id, patch) {
+            return upsertBlock(id, { ...(patch ?? {}), status: 'completed' });
+        },
+        async failBlock(id, patch) {
+            return upsertBlock(id, { ...(patch ?? {}), status: 'failed' });
+        },
         flush,
-        waitingInput: clear,
+        async waitingInput() {
+            status = 'waiting_input';
+            await flush('waiting_input');
+        },
         interrupt: clear,
         clear,
     };

package/dist/turn-protocol.d.ts

@@ -30,7 +30,6 @@ export interface TurnMetadata {
     turnId?: string | null;
     turnSemantics?: TurnMessageSemantics;
     deliveryIntent?: DeliveryIntent;
-    turnComplete?: boolean;
     replyBehavior?: 'allow_auto_reply' | 'suppress_auto_reply';
     inboundDisposition?: InboundDisposition;
 }
@@ -66,15 +65,12 @@ export declare function isTurnOpen(turnState: Pick<TurnState, 'state' | 'turnUpd
 export declare function resolveTurnMessageSemantics(input: {
     senderType: 'human' | 'ai_agent';
     metadata?: unknown;
-    senderTurnState?: Pick<TurnState, 'state' | 'turnUpdatedAt' | 'updatedAt' | 'openedAt'> | null;
 }): TurnMessageSemantics;
 export declare function shouldPromoteConversationMessage(input: {
     senderType: 'human' | 'ai_agent';
     metadata?: unknown;
-    senderTurnState?: Pick<TurnState, 'state' | 'turnUpdatedAt' | 'updatedAt' | 'openedAt'> | null;
 }): boolean;
 export declare function shouldTriggerAgentTurn(input: {
     senderType: 'human' | 'ai_agent';
     metadata?: unknown;
-    senderTurnState?: Pick<TurnState, 'state' | 'turnUpdatedAt' | 'updatedAt' | 'openedAt'> | null;
 }): TriggerDecision;

package/dist/turn-protocol.js

@@ -79,15 +79,13 @@ export function normalizeTurnMetadata(metadata) {
         || metadata.inboundDisposition === 'cancelled'
         ? metadata.inboundDisposition
         : undefined;
-    if (!turnId && !turnSemantics && !deliveryIntent && typeof metadata.turnComplete !== 'boolean'
-        && !replyBehavior && !inboundDisposition) {
+    if (!turnId && !turnSemantics && !deliveryIntent && !replyBehavior && !inboundDisposition) {
         return null;
     }
     return {
         ...(turnId ? { turnId } : {}),
         ...(turnSemantics ? { turnSemantics } : {}),
         ...(deliveryIntent ? { deliveryIntent } : {}),
-        ...(typeof metadata.turnComplete === 'boolean' ? { turnComplete: metadata.turnComplete } : {}),
         ...(replyBehavior ? { replyBehavior } : {}),
         ...(inboundDisposition ? { inboundDisposition } : {}),
     };
@@ -163,13 +161,10 @@ export function resolveTurnMessageSemantics(input) {
     if (turnMetadata?.turnSemantics) {
         return turnMetadata.turnSemantics;
     }
-    if (turnMetadata?.turnComplete === true) {
-        return 'turn_complete';
-    }
     if (input.senderType === 'human') {
         return 'turn_complete';
     }
-    return isTurnOpen(input.senderTurnState) ? 'progress' : 'turn_complete';
+    return 'progress';
 }
 export function shouldPromoteConversationMessage(input) {
     if (isHiddenRuntimeCardMetadata(input.metadata)) {
@@ -198,7 +193,9 @@ export function shouldTriggerAgentTurn(input) {
         return {
             allow: false,
             semantics,
-            reason: 'non-final agent progress does not trigger other agents',
+            reason: turnMetadata?.turnSemantics === 'progress'
+                ? 'non-final agent progress does not trigger other agents'
+                : 'agent messages require explicit turn_complete semantics',
         };
     }
     return {

package/dist/types.d.ts

@@ -69,8 +69,10 @@ export interface CanonConversation {
     hasUnread?: boolean;
     lastMessage: {
         text: string;
+        messageId: string;
         senderId: string;
-        senderType?: 'human' | 'ai_agent';
+        senderType: 'human' | 'ai_agent';
+        contentType: CanonMessage['contentType'];
         timestamp: string;
     } | null;
     createdAt: string;
@@ -106,9 +108,9 @@ export interface CanonContactRequest {
     requesterName: string;
     requesterAvatarUrl: string | null;
     targetId: string;
-    targetName?: string | null;
-    targetAvatarUrl?: string | null;
-    targetUserType?: 'human' | 'ai_agent' | null;
+    targetName: string;
+    targetAvatarUrl: string | null;
+    targetUserType: 'human' | 'ai_agent';
     targetOwnerId?: string | null;
     approverId: string;
     message: string | null;
@@ -342,7 +344,6 @@ export interface CanonRuntimeDescriptor {
     coreControls: ReadonlyArray<CanonControlDescriptor>;
     runtimeControls?: ReadonlyArray<CanonControlDescriptor>;
     commands?: ReadonlyArray<CanonRuntimeCommandDescriptor>;
-    actions?: ReadonlyArray<CanonRuntimeActionDescriptor>;
     /**
      * Optional setup-time local roots advertised by a runtime. These are
      * metadata only for now; existing session config still selects concrete
@@ -424,6 +425,21 @@ export interface CanonRuntimeActivityItem {
     sensitive?: boolean;
     actions?: ReadonlyArray<CanonRuntimeCommandDescriptor>;
 }
+export type TurnOutputBlockKind = 'text' | 'tool' | 'plan' | 'approval' | 'input' | 'status';
+export type TurnOutputBlockStatus = 'running' | 'completed' | 'failed' | 'pending' | 'blocked';
+export interface TurnOutputBlock {
+    id: string;
+    turnId: string;
+    kind: TurnOutputBlockKind;
+    status: TurnOutputBlockStatus;
+    sequence: number;
+    title?: string;
+    text?: string;
+    summary?: string;
+    detail?: string;
+    createdAt?: number;
+    updatedAt?: number;
+}
 export interface CanonRuntimeInventoryEntry {
     id: string;
     label: string;
@@ -607,13 +623,14 @@ export interface CreateConversationOptions {
     /** Required when creating a direct conversation with a first-party coding agent. */
     sessionConfig?: SessionConfig | null;
 }
-export type StreamingStatus = 'thinking' | 'streaming' | 'tool';
+export type StreamingStatus = 'thinking' | 'streaming' | 'tool' | 'waiting_input';
 export interface SetStreamingOptions {
     conversationId: string;
     text: string;
     status: StreamingStatus;
     messageId: string;
     turnId?: string | null;
+    blocks?: TurnOutputBlock[];
 }
 export interface SetRuntimeTurnOptions {
     conversationId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonmsg/core",
-  "version": "0.24.0",
+  "version": "1.0.0",
   "description": "Canon core — shared types, REST client, SSE stream, and registration for Canon messaging",
   "type": "module",
   "main": "dist/index.js",