@canonmsg/core 0.15.0 → 0.15.2

package/dist/agent-session.js

@@ -14,7 +14,7 @@ function descriptorOptions(runtime, controlId) {
 function descriptorDefaultValue(runtime, controlId) {
     const control = listDescriptorControls(runtime)
         .find((candidate) => candidate.id === controlId);
-    return control?.defaultValue ?? control?.options?.[0]?.value ?? undefined;
+    return control?.defaultValue ?? undefined;
 }
 function buildWorkSessionSummary(workSession, workSessions) {
     const merged = mergeWorkSessionContexts(workSession, workSessions);
@@ -30,13 +30,95 @@ function buildWorkSessionSummary(workSession, workSessions) {
         status: primary.status ?? null,
     };
 }
+function setControlState(controlState, id, value, source, appliedAt) {
+    if (value === undefined)
+        return;
+    controlState[id] = {
+        value,
+        source,
+        ...(source === 'applied' && appliedAt ? { appliedAt } : {}),
+    };
+}
+function buildControlState(input) {
+    const controlState = {};
+    const appliedAt = input.sessionState?.updatedAt ?? input.lastHeartbeatAt ?? input.updatedAt ?? undefined;
+    const modelDefault = descriptorDefaultValue(input.runtime, 'model');
+    if (input.sessionState?.model !== undefined) {
+        setControlState(controlState, 'model', input.sessionState.model, 'applied', appliedAt);
+    }
+    else if (input.sessionConfig?.model !== undefined) {
+        setControlState(controlState, 'model', input.sessionConfig.model, 'requested');
+    }
+    else if (modelDefault !== undefined) {
+        setControlState(controlState, 'model', modelDefault, 'host-default');
+    }
+    const permissionDefault = descriptorDefaultValue(input.runtime, 'permissionMode');
+    if (input.sessionState?.permissionMode !== undefined) {
+        setControlState(controlState, 'permissionMode', input.sessionState.permissionMode, 'applied', appliedAt);
+    }
+    else if (input.sessionConfig?.permissionMode !== undefined) {
+        setControlState(controlState, 'permissionMode', input.sessionConfig.permissionMode, 'requested');
+    }
+    else if (permissionDefault !== undefined) {
+        setControlState(controlState, 'permissionMode', permissionDefault, 'host-default');
+    }
+    const effortDefault = descriptorDefaultValue(input.runtime, 'effort');
+    if (input.sessionState?.effort !== undefined) {
+        setControlState(controlState, 'effort', input.sessionState.effort, 'applied', appliedAt);
+    }
+    else if (input.sessionConfig?.effort !== undefined) {
+        setControlState(controlState, 'effort', input.sessionConfig.effort, 'requested');
+    }
+    else if (effortDefault !== undefined) {
+        setControlState(controlState, 'effort', effortDefault, 'host-default');
+    }
+    const workspaceDefault = descriptorDefaultValue(input.runtime, 'workspace');
+    if (input.sessionConfig?.workspaceId !== undefined) {
+        setControlState(controlState, 'workspace', input.sessionConfig.workspaceId, 'requested');
+    }
+    else if (workspaceDefault !== undefined) {
+        setControlState(controlState, 'workspace', workspaceDefault, 'host-default');
+    }
+    if (input.sessionState?.executionMode !== undefined) {
+        setControlState(controlState, 'executionMode', input.sessionState.executionMode, 'applied', appliedAt);
+    }
+    else if (input.sessionConfig?.executionMode !== undefined) {
+        setControlState(controlState, 'executionMode', input.sessionConfig.executionMode, 'requested');
+    }
+    for (const [id, value] of Object.entries(input.sessionConfig?.runtimeControlValues ?? {})) {
+        setControlState(controlState, id, value, 'requested');
+    }
+    for (const [id, value] of Object.entries(input.sessionState?.runtimeControlValues ?? {})) {
+        setControlState(controlState, id, value, 'applied', appliedAt);
+    }
+    Object.assign(controlState, input.sessionState?.controlState ?? {});
+    return Object.keys(controlState).length > 0 ? controlState : undefined;
+}
 export function buildAgentSessionSnapshot(input) {
-    const modelOptions = descriptorOptions(input.runtime, 'model');
+    const modelOptions = input.sessionState?.availableModels?.length
+        ? input.sessionState.availableModels
+        : descriptorOptions(input.runtime, 'model');
     const workspaceOptions = descriptorOptions(input.runtime, 'workspace')
         .map((option) => ({ id: option.value, label: option.label }));
     const availableExecutionModes = descriptorOptions(input.runtime, 'executionMode')
         .map((option) => option.value)
         .filter((value) => value === 'worktree' || value === 'locked');
+    const model = input.sessionState?.model
+        ?? input.sessionConfig?.model
+        ?? descriptorDefaultValue(input.runtime, 'model');
+    const permissionMode = input.sessionState?.permissionMode
+        ?? input.sessionConfig?.permissionMode
+        ?? descriptorDefaultValue(input.runtime, 'permissionMode');
+    const effort = input.sessionState?.effort
+        ?? input.sessionConfig?.effort
+        ?? descriptorDefaultValue(input.runtime, 'effort');
+    const runtimeControlValues = input.sessionState?.runtimeControlValues
+        ?? input.sessionConfig?.runtimeControlValues;
+    const workspaceId = input.sessionConfig?.workspaceId
+        ?? descriptorDefaultValue(input.runtime, 'workspace');
+    const executionMode = input.sessionState?.executionMode
+        ?? input.sessionConfig?.executionMode;
+    const controlState = buildControlState(input);
     return {
         conversationId: input.conversationId,
         agentId: input.agentId,
@@ -46,22 +128,17 @@ export function buildAgentSessionSnapshot(input) {
         hostMode: Boolean(input.sessionState?.hostMode
             ?? input.sessionConfig?.hostMode
             ?? input.runtime?.hostMode),
-        model: input.sessionState?.model
-            ?? input.sessionConfig?.model
-            ?? descriptorDefaultValue(input.runtime, 'model'),
+        model,
         modelOptions,
-        permissionMode: input.sessionState?.permissionMode
-            ?? input.sessionConfig?.permissionMode
-            ?? descriptorDefaultValue(input.runtime, 'permissionMode'),
+        permissionMode,
         permissionModeOptions: descriptorOptions(input.runtime, 'permissionMode'),
-        effort: input.sessionState?.effort ?? input.sessionConfig?.effort,
-        runtimeControlValues: input.sessionState?.runtimeControlValues
-            ?? input.sessionConfig?.runtimeControlValues,
-        workspaceId: input.sessionConfig?.workspaceId
-            ?? descriptorDefaultValue(input.runtime, 'workspace'),
+        effort,
+        runtimeControlValues,
+        controlState,
+        runtimeControlErrors: input.sessionState?.runtimeControlErrors ?? undefined,
+        workspaceId,
         workspaceOptions,
-        executionMode: input.sessionState?.executionMode
-            ?? input.sessionConfig?.executionMode,
+        executionMode,
         availableExecutionModes,
         executionBranch: input.sessionState?.executionBranch,
         resolvedWorkspaceLabel: undefined,

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, AgentSessionWorkSessionSummary, 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, CanonRuntimeExecutionMetadata, CanonRuntimeInventory, CanonRuntimeInventoryEntry, CanonRuntimeStreamingMode, CanonRuntimeStatusItem, CanonRuntimeSurfaceMode, CanonWorkspaceRootMetadata, RuntimeUpdatedPayload, RuntimeInfoPayload, ResolvedAdmission, SessionConfig, TurnUpdatedPayload, WorkspaceOption, WorkspaceOptionSource, } from './types.js';
+export type { AddMemberResult, AgentCapabilities, AgentClientType, AgentSessionSnapshot, AgentSessionWorkSessionSummary, 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, CanonRuntimeDetailTier, CanonRuntimeExecutionMetadata, CanonRuntimeInventory, CanonRuntimeInventoryEntry, CanonRuntimeStreamingMode, CanonRuntimeStatusItem, CanonRuntimeSurfaceMode, CanonWorkspaceRootMetadata, RuntimeUpdatedPayload, RuntimeInfoPayload, RuntimeControlError, RuntimeControlState, RuntimeControlValueSource, ResolvedAdmission, SessionConfig, TurnUpdatedPayload, WorkspaceOption, WorkspaceOptionSource, } from './types.js';
 export { EXECUTION_ENVIRONMENT_MODES, isExecutionEnvironmentMode, } from './execution-environment-mode.js';
 export type { ExecutionEnvironmentMode } from './execution-environment-mode.js';
 export type { CanonResolvedWorkSession, CanonWorkSession, CanonWorkSessionContext, CanonWorkSessionConversationRole, CanonWorkSessionDisclosureMode, CanonWorkSessionParticipant, CanonWorkSessionStatus, CreateWorkSessionOptions, SendLinkedMessageOptions, SendLinkedMessageResult, UpdateWorkSessionConversationOptions, WorkSessionPromptRenderOptions, } from './work-session.js';

package/dist/cli-metadata.d.ts

@@ -0,0 +1,13 @@
+export interface CliMetadata {
+    name: string;
+    description?: string;
+    help: string;
+    version?: string;
+}
+export interface RunCliMetadataOptions extends CliMetadata {
+    argv?: string[];
+}
+export declare function isDirectExecution(moduleUrl: string): boolean;
+export declare function readCliPackageVersion(moduleUrl: string): string | null;
+export declare function handleCliMetadataRequest(moduleUrl: string, metadata: RunCliMetadataOptions): boolean;
+export declare function runCli(moduleUrl: string, main: () => void | Promise<void>, onError: (error: unknown) => void, metadata?: RunCliMetadataOptions): void;

package/dist/cli-metadata.js

@@ -0,0 +1,60 @@
+import { readFileSync, realpathSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+export function isDirectExecution(moduleUrl) {
+    const entry = process.argv[1];
+    if (!entry)
+        return false;
+    const abs = resolve(entry);
+    let real = abs;
+    try {
+        real = realpathSync(abs);
+    }
+    catch {
+        // argv[1] may not exist on disk in rare harnesses; fall back to abs.
+    }
+    return (pathToFileURL(real).href === moduleUrl
+        || pathToFileURL(abs).href === moduleUrl);
+}
+export function readCliPackageVersion(moduleUrl) {
+    let current = dirname(fileURLToPath(moduleUrl));
+    while (true) {
+        try {
+            const manifest = JSON.parse(readFileSync(resolve(current, 'package.json'), 'utf8'));
+            return typeof manifest.version === 'string' ? manifest.version : null;
+        }
+        catch {
+            const parent = dirname(current);
+            if (parent === current)
+                return null;
+            current = parent;
+        }
+    }
+}
+function hasArg(argv, long, short) {
+    return argv.includes(long) || argv.includes(short);
+}
+export function handleCliMetadataRequest(moduleUrl, metadata) {
+    const argv = metadata.argv ?? process.argv.slice(2);
+    if (hasArg(argv, '--help', '-h')) {
+        process.stdout.write(`${metadata.help.trimEnd()}\n`);
+        return true;
+    }
+    if (hasArg(argv, '--version', '-V')) {
+        const version = metadata.version ?? readCliPackageVersion(moduleUrl) ?? 'unknown';
+        process.stdout.write(`${metadata.name} ${version}\n`);
+        return true;
+    }
+    return false;
+}
+export function runCli(moduleUrl, main, onError, metadata) {
+    if (!isDirectExecution(moduleUrl)) {
+        return;
+    }
+    if (metadata && handleCliMetadataRequest(moduleUrl, metadata)) {
+        return;
+    }
+    Promise.resolve()
+        .then(() => main())
+        .catch(onError);
+}

package/dist/host-runtime.d.ts

@@ -36,6 +36,7 @@ export declare function buildCanonHostPrompt(input: {
     workSession?: MessageCreatedPayload['message']['workSession'];
     workSessions?: MessageCreatedPayload['workSessions'];
     buildInboundContextLines: (context: HostInboundParticipantContext) => string[];
+    sessionContextLines?: string[];
 }): string;
 /**
  * Render the **text portion** of an inbound Canon message. Images are

package/dist/host-runtime.js

@@ -24,6 +24,9 @@ export function buildCanonHostPrompt(input) {
         ...(resolvedWorkSessions.length > 0
             ? ['Honor the Canon work-session context above within its stated disclosure limits.']
             : []),
+        ...(input.sessionContextLines?.length
+            ? ['Canon session state:', ...input.sessionContextLines]
+            : []),
         `Conversation ID: ${input.conversationId}`,
         '',
         'New Canon message:',
@@ -180,6 +183,7 @@ export async function publishHostSessionSnapshots(input) {
             permissionMode: snapshot.permissionMode ?? null,
             effort: snapshot.effort ?? null,
             runtimeControlValues: snapshot.runtimeControlValues ?? null,
+            controlState: snapshot.controlState ?? null,
             workspaceId: snapshot.workspaceId ?? null,
             executionMode: snapshot.executionMode ?? null,
             executionBranch,

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, CanonResolveAdmissionResult, ContactAddedPayload, ContactApprovedPayload, ContactCardPayload, ContactRemovedPayload, ContactRequestPayload, ContactSource, ResolvedAdmissionState, ResolvedAdmissionTargetSummary, ResolvedTargetAdmissionPayload, CanonMessage, CanonConversation, CanonMessagesPage, CreateContactRequestResult, AgentContext, CanonStreamEvent, AgentSessionSnapshot, AgentSessionWorkSessionSummary, ResolvedAdmission, MediaAttachment, MediaAttachmentKind, MessageCreatedPayload, TypingPayload, PresencePayload, RuntimeUpdatedPayload, TurnUpdatedPayload, SendMessageOptions, CreateConversationOptions, RegistrationInput, RegistrationResult, RegistrationStatus, StreamingStatus, SetStreamingOptions, SessionControl, SessionState, SessionConfig, AgentRuntime, CanonRuntimeDescriptor, CanonRuntimeActionAvailability, CanonRuntimeActionCategory, CanonRuntimeActionDescriptor, CanonRuntimeActionDispatch, CanonRuntimeActionPlacement, CanonRuntimeExecutionMetadata, CanonRuntimeInventory, CanonRuntimeInventoryEntry, CanonRuntimeStreamingMode, CanonRuntimeStatusItem, CanonRuntimeSurfaceMode, CanonWorkspaceRootMetadata, ModelOption, PermissionModeOption, RuntimeInfoPayload, WorkspaceOption, WorkspaceOptionSource, } from './types.js';
+export type { AddMemberResult, AgentCapabilities, AgentClientType, CanonControlAvailability, CanonControlDescriptor, CanonControlLiveBehavior, CanonControlSelectionPolicy, CanonControlValue, CanonContact, CanonContactRequest, CanonContactRequestStatus, CanonResolveAdmissionResult, ContactAddedPayload, ContactApprovedPayload, ContactCardPayload, ContactRemovedPayload, ContactRequestPayload, ContactSource, ResolvedAdmissionState, ResolvedAdmissionTargetSummary, ResolvedTargetAdmissionPayload, CanonMessage, CanonConversation, CanonMessagesPage, CreateContactRequestResult, AgentContext, CanonStreamEvent, AgentSessionSnapshot, AgentSessionWorkSessionSummary, ResolvedAdmission, MediaAttachment, MediaAttachmentKind, MessageCreatedPayload, TypingPayload, PresencePayload, RuntimeUpdatedPayload, TurnUpdatedPayload, SendMessageOptions, CreateConversationOptions, RegistrationInput, RegistrationResult, RegistrationStatus, StreamingStatus, SetStreamingOptions, SessionControl, SessionState, SessionConfig, AgentRuntime, CanonRuntimeDescriptor, CanonRuntimeActionAvailability, CanonRuntimeActionCategory, CanonRuntimeActionDescriptor, CanonRuntimeActionDispatch, CanonRuntimeActionPlacement, CanonRuntimeDetailTier, CanonRuntimeExecutionMetadata, CanonRuntimeInventory, CanonRuntimeInventoryEntry, CanonRuntimeStreamingMode, CanonRuntimeStatusItem, CanonRuntimeSurfaceMode, CanonWorkspaceRootMetadata, ModelOption, PermissionModeOption, RuntimeInfoPayload, RuntimeControlError, RuntimeControlState, RuntimeControlValueSource, WorkspaceOption, WorkspaceOptionSource, } from './types.js';
 export type { CanonResolvedWorkSession, CanonWorkSession, CanonWorkSessionContext, CanonWorkSessionConversationRole, CreateWorkSessionOptions, CanonWorkSessionDisclosureMode, CanonWorkSessionParticipant, CanonWorkSessionStatus, SendLinkedMessageOptions, SendLinkedMessageResult, UpdateWorkSessionConversationOptions, WorkSessionPromptRenderOptions, } from './work-session.js';
 export { buildWorkSessionPromptLines, buildWorkSessionsPromptLines, mergeWorkSessionContexts, } from './work-session.js';
 export { buildConfiguredWorkspaceOptionsWithRoots, buildPublicWorkspaceRoots, buildWorkspaceRootId, discoverWorkspaceProjects, } from './workspace-discovery.js';
@@ -39,3 +39,5 @@ export type { RuntimeStatePublisher, RuntimeStatePublisherOptions, RuntimeStream
 export { formatCanonMessageAsText } from './message-format.js';
 export { DEFAULT_BASE_URL, DEFAULT_STREAM_URL, DEFAULT_RTDB_URL, FIREBASE_WEB_API_KEY } from './constants.js';
 export { resolveCanonBaseUrl } from './base-url.js';
+export { handleCliMetadataRequest, isDirectExecution, readCliPackageVersion, runCli, } from './cli-metadata.js';
+export type { CliMetadata, RunCliMetadataOptions, } from './cli-metadata.js';

package/dist/index.js

@@ -39,3 +39,5 @@ export { formatCanonMessageAsText } from './message-format.js';
 export { DEFAULT_BASE_URL, DEFAULT_STREAM_URL, DEFAULT_RTDB_URL, FIREBASE_WEB_API_KEY } from './constants.js';
 // Base URL resolver
 export { resolveCanonBaseUrl } from './base-url.js';
+// CLI metadata helpers for Node entrypoints
+export { handleCliMetadataRequest, isDirectExecution, readCliPackageVersion, runCli, } from './cli-metadata.js';

package/dist/local-runtime-catalog.d.ts

@@ -7,6 +7,7 @@ export interface LocalRuntimeSessionState {
     workspaceId?: string;
     baseCwd: string;
     executionMode?: ExecutionEnvironmentMode;
+    codexPolicyFingerprint?: string;
     threadId?: string;
     claudeSessionId?: string;
     lastInboundMessageId?: string;

package/dist/local-runtime-catalog.js

@@ -165,7 +165,7 @@ export function clearRuntimeSessionState(runtimeId, input) {
                 delete sessions[key];
         }
     }
-    upsertLocalRuntimeEntry({ ...entry, sessions });
+    writeJsonAtomic(runtimePath(entry.id), { ...entry, sessions });
 }
 function migrateLegacyCodexSessions(runtimeId) {
     if (!existsSync(LEGACY_CODEX_SESSIONS_PATH))

package/dist/rtdb-rest.d.ts

@@ -7,13 +7,15 @@
  */
 import type { CanonClient } from './client.js';
 import type { DeliveryIntent, RuntimeCapabilities, TurnLifecycleState } from './turn-protocol.js';
-import type { CanonControlValue, RuntimeInfoPayload } from './types.js';
+import type { CanonControlValue, ModelOption, RuntimeControlError, RuntimeControlState, RuntimeInfoPayload } from './types.js';
 export interface SessionStatePayload {
     lastError?: string;
     model?: string;
     permissionMode?: string;
     effort?: string;
     runtimeControlValues?: Record<string, CanonControlValue>;
+    controlState?: Record<string, RuntimeControlState>;
+    runtimeControlErrors?: Record<string, RuntimeControlError> | null;
     cwd?: string;
     executionMode?: 'worktree' | 'locked';
     executionBranch?: string;
@@ -27,6 +29,7 @@ export interface SessionStatePayload {
         totalTokens: number;
         maxTokens: number;
     };
+    availableModels?: ModelOption[];
     updatedAt: {
         '.sv': 'timestamp';
     };
@@ -53,10 +56,7 @@ export interface AgentSessionSnapshotPatch {
     clientType?: string;
     hostMode?: boolean;
     model?: string | null;
-    modelOptions?: Array<{
-        value: string;
-        label: string;
-    }> | null;
+    modelOptions?: ModelOption[] | null;
     permissionMode?: string | null;
     permissionModeOptions?: Array<{
         value: string;
@@ -64,6 +64,8 @@ export interface AgentSessionSnapshotPatch {
     }> | null;
     effort?: string | null;
     runtimeControlValues?: Record<string, CanonControlValue> | null;
+    controlState?: Record<string, RuntimeControlState> | null;
+    runtimeControlErrors?: Record<string, RuntimeControlError> | null;
     workspaceId?: string | null;
     workspaceOptions?: Array<{
         id: string;

package/dist/rtdb-rest.js

@@ -144,6 +144,12 @@ function createRTDBClientHandle(client, options) {
             ...(state.runtimeControlValues !== undefined
                 ? { runtimeControlValues: state.runtimeControlValues }
                 : {}),
+            ...(state.controlState !== undefined
+                ? { controlState: state.controlState }
+                : {}),
+            ...(state.runtimeControlErrors !== undefined
+                ? { runtimeControlErrors: state.runtimeControlErrors }
+                : {}),
             ...(state.cwd !== undefined ? { resolvedCwd: state.cwd } : {}),
             ...(state.executionMode !== undefined ? { executionMode: state.executionMode } : {}),
             ...(state.executionBranch !== undefined ? { executionBranch: state.executionBranch } : {}),
@@ -154,6 +160,7 @@ function createRTDBClientHandle(client, options) {
             state: null,
             waitingForInput: false,
             ...(state.contextUsage !== undefined ? { contextUsage: state.contextUsage } : {}),
+            ...(state.availableModels !== undefined ? { modelOptions: state.availableModels } : {}),
             ...(state.lastError !== undefined ? { lastError: state.lastError } : {}),
             lastHeartbeatAt: { '.sv': 'timestamp' },
             updatedAt: { '.sv': 'timestamp' },
@@ -169,6 +176,7 @@ function createRTDBClientHandle(client, options) {
                 state: null,
                 waitingForInput: false,
                 lastError: null,
+                controlState: null,
                 executionBranch: null,
                 contextUsage: null,
                 worktreePath: null,

package/dist/types.d.ts

@@ -212,11 +212,18 @@ export interface CanonWorkspaceRootMetadata {
     defaultRelativePath?: string | null;
 }
 export type CanonControlValue = string;
+export type RuntimeControlValueSource = 'applied' | 'requested' | 'host-default' | 'route-default' | 'unknown';
+export interface RuntimeControlState {
+    value: CanonControlValue | null;
+    source: RuntimeControlValueSource;
+    appliedAt?: number;
+}
 export type CanonControlAvailability = 'setup' | 'live' | 'setup_and_live';
 export type CanonControlLiveBehavior = 'immediate' | 'next_turn' | 'none';
 export type CanonControlSelectionPolicy = 'inherit' | 'required_explicit';
 export type CanonRuntimeStreamingMode = 'none' | 'status' | 'snapshot' | 'block' | 'delta';
 export type CanonRuntimeSurfaceMode = 'host' | 'channel' | 'limited_channel' | 'operator';
+export type CanonRuntimeDetailTier = 'primary' | 'detail' | 'diagnostic';
 export type CanonRuntimeInventoryStatus = 'ready' | 'auth_needed' | 'unknown' | 'configured' | 'running' | 'error';
 export type CanonRuntimeStatusTone = 'default' | 'success' | 'warning' | 'danger';
 export type CanonRuntimeActionAvailability = 'idle' | 'busy' | 'busy_with_queue' | 'waiting_input' | 'always';
@@ -301,6 +308,9 @@ export interface CanonRuntimeStatusItem {
     label: string;
     value: string;
     tone?: CanonRuntimeStatusTone;
+    tier?: CanonRuntimeDetailTier;
+    sensitive?: boolean;
+    source?: RuntimeControlValueSource;
 }
 export interface CanonRuntimeInventoryEntry {
     id: string;
@@ -312,6 +322,7 @@ export interface CanonRuntimeInventory {
     id: string;
     label: string;
     entries: ReadonlyArray<CanonRuntimeInventoryEntry>;
+    tier?: CanonRuntimeDetailTier;
 }
 export interface RuntimeInfoPayload {
     descriptor: CanonRuntimeDescriptor;
@@ -434,6 +445,7 @@ export type CanonStreamEvent = {
     };
 };
 export interface SendMessageOptions {
+    messageId?: string;
     contentType?: 'text' | 'audio' | 'image' | 'file' | 'contact_card';
     replyTo?: string;
     replyToPosition?: number;
@@ -466,6 +478,11 @@ export interface SessionControl {
     updatedAt: number;
     updatedBy: string;
 }
+export interface RuntimeControlError {
+    value: string;
+    message: string;
+    updatedAt: number;
+}
 /** Written by agent to /session-state/{convoId}/{agentId} in RTDB */
 export interface SessionState {
     lastError?: string;
@@ -473,6 +490,8 @@ export interface SessionState {
     permissionMode?: string;
     effort?: string;
     runtimeControlValues?: Record<string, CanonControlValue>;
+    controlState?: Record<string, RuntimeControlState>;
+    runtimeControlErrors?: Record<string, RuntimeControlError> | null;
     cwd?: string;
     executionMode?: 'worktree' | 'locked';
     executionBranch?: string;
@@ -573,6 +592,8 @@ export interface AgentSessionSnapshot {
     permissionModeOptions?: PermissionModeOption[];
     effort?: string;
     runtimeControlValues?: Record<string, CanonControlValue>;
+    controlState?: Record<string, RuntimeControlState>;
+    runtimeControlErrors?: Record<string, RuntimeControlError> | null;
     runtimeDescriptor?: CanonRuntimeDescriptor | null;
     runtimeInfo?: RuntimeInfoPayload | null;
     workspaceId?: string;

package/package.json

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