@canonmsg/core 0.7.5 → 0.8.0

package/dist/agent-session.js

@@ -39,6 +39,9 @@ export function buildAgentSessionSnapshot(input) {
             ?? input.sessionConfig?.permissionMode
             ?? input.runtime?.defaultPermissionMode,
         permissionModeOptions: input.runtime?.availablePermissionModes ?? [],
+        effort: input.sessionState?.effort ?? input.sessionConfig?.effort,
+        runtimeControlValues: input.sessionState?.runtimeControlValues
+            ?? input.sessionConfig?.runtimeControlValues,
         workspaceId: input.sessionConfig?.workspaceId
             ?? input.runtime?.defaultWorkspaceId
             ?? workspaceOptions[0]?.id,
@@ -49,8 +52,13 @@ export function buildAgentSessionSnapshot(input) {
             ?? input.runtime?.availableExecutionModes
             ?? [],
         executionBranch: input.sessionState?.executionBranch,
+        resolvedWorkspaceLabel: undefined,
+        resolvedCwd: input.sessionState?.cwd,
+        worktreePath: input.sessionState?.worktreePath,
+        executionFallbackReason: input.sessionState?.executionFallbackReason,
         state: input.sessionState?.state,
         turnState: input.turnState?.state,
+        supportsQueue: input.turnState?.capabilities?.supportsQueue,
         queueDepth: input.turnState?.queueDepth ?? 0,
         waitingForInput: input.turnState?.state === 'waiting_input'
             || input.sessionState?.state === 'requires_action',

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 { AgentCapabilities, AgentClientType, AgentSessionSnapshot, AgentSessionWorkSessionSummary, AgentRuntime, CanonContactRequest, CanonContactRequestStatus, ContactApprovedPayload, ContactRequestPayload, CanonStreamEvent, CreateContactRequestResult, MediaAttachment, MediaAttachmentKind, ModelOption, PermissionModeOption, RuntimeUpdatedPayload, ResolvedAdmission, SessionConfig, TurnUpdatedPayload, WorkspaceOption, } from './types.js';
+export type { AgentCapabilities, AgentClientType, AgentSessionSnapshot, AgentSessionWorkSessionSummary, AgentRuntime, CanonControlAvailability, CanonControlDescriptor, CanonControlLiveBehavior, CanonControlSelectionPolicy, CanonControlValue, CanonContactRequest, CanonContactRequestStatus, ContactApprovedPayload, ContactRequestPayload, CanonStreamEvent, CreateContactRequestResult, MediaAttachment, MediaAttachmentKind, ModelOption, PermissionModeOption, CanonRuntimeDescriptor, CanonRuntimeExecutionMetadata, CanonRuntimeInventory, CanonRuntimeInventoryEntry, CanonRuntimeStreamingMode, CanonRuntimeStatusItem, CanonRuntimeSurfaceMode, CanonWorkspaceRootMetadata, RuntimeUpdatedPayload, RuntimeInfoPayload, ResolvedAdmission, SessionConfig, TurnUpdatedPayload, WorkspaceOption, } 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/index.d.ts

@@ -1,5 +1,5 @@
 export { AGENT_CAPABILITIES, CLAUDE_PERMISSION_MODE_OPTIONS, } from './types.js';
-export type { AgentCapabilities, AgentClientType, CanonContactRequest, CanonContactRequestStatus, ContactApprovedPayload, ContactRequestPayload, 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, ModelOption, PermissionModeOption, WorkspaceOption, } from './types.js';
+export type { AgentCapabilities, AgentClientType, CanonControlAvailability, CanonControlDescriptor, CanonControlLiveBehavior, CanonControlSelectionPolicy, CanonControlValue, CanonContactRequest, CanonContactRequestStatus, ContactApprovedPayload, ContactRequestPayload, 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, CanonRuntimeExecutionMetadata, CanonRuntimeInventory, CanonRuntimeInventoryEntry, CanonRuntimeStreamingMode, CanonRuntimeStatusItem, CanonRuntimeSurfaceMode, CanonWorkspaceRootMetadata, ModelOption, PermissionModeOption, RuntimeInfoPayload, WorkspaceOption, } 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 { CanonClient, CanonApiError } from './client.js';
@@ -25,7 +25,7 @@ export { resolveCanonAgent, resolveCanonProfile, getActiveProfile } from './agen
 export type { ResolvedAgent } from './agent-resolver.js';
 export { buildConfiguredWorkspaceOptions, buildConversationEnvironmentKey, buildConversationWorktreeSpec, buildPublicWorkspaceOptions, buildWorkspaceOptionId, EXECUTION_ENVIRONMENT_MODES, isEnabledFlag, isExecutionEnvironmentMode, normalizeOptionalString, readSessionWorkspaceConfig, resolveConfiguredWorkspaceCwd, ExecutionEnvironmentError, prepareConversationEnvironment, releaseConversationEnvironment, } from './execution-environment.js';
 export type { ConfiguredWorkspaceOption, ExecutionEnvironmentMode, PreparedExecutionEnvironment, SessionWorkspaceConfig, } from './execution-environment.js';
-export { initRTDBAuth, rtdbWrite, rtdbRead, patchAgentSessionSnapshot, writeSessionState, clearSessionState, writeTurnState, clearTurnState, } from './rtdb-rest.js';
-export type { AgentSessionSnapshotPatch, SessionStatePayload, TurnStatePayload, } from './rtdb-rest.js';
+export { initRTDBAuth, rtdbWrite, rtdbRead, patchAgentSessionSnapshot, patchRuntimeInfo, writeRuntimeInfo, clearRuntimeInfo, writeSessionState, clearSessionState, writeTurnState, clearTurnState, } from './rtdb-rest.js';
+export type { AgentSessionSnapshotPatch, RuntimeInfoPayloadData, SessionStatePayload, TurnStatePayload, } from './rtdb-rest.js';
 export { DEFAULT_BASE_URL, DEFAULT_STREAM_URL, DEFAULT_RTDB_URL, FIREBASE_WEB_API_KEY } from './constants.js';
 export { resolveCanonBaseUrl } from './base-url.js';

package/dist/index.js

@@ -25,7 +25,7 @@ export { resolveCanonAgent, resolveCanonProfile, getActiveProfile } from './agen
 // Execution environments for host-mode coding sessions
 export { buildConfiguredWorkspaceOptions, buildConversationEnvironmentKey, buildConversationWorktreeSpec, buildPublicWorkspaceOptions, buildWorkspaceOptionId, EXECUTION_ENVIRONMENT_MODES, isEnabledFlag, isExecutionEnvironmentMode, normalizeOptionalString, readSessionWorkspaceConfig, resolveConfiguredWorkspaceCwd, ExecutionEnvironmentError, prepareConversationEnvironment, releaseConversationEnvironment, } from './execution-environment.js';
 // RTDB REST helpers (token exchange, session state, generic read/write)
-export { initRTDBAuth, rtdbWrite, rtdbRead, patchAgentSessionSnapshot, writeSessionState, clearSessionState, writeTurnState, clearTurnState, } from './rtdb-rest.js';
+export { initRTDBAuth, rtdbWrite, rtdbRead, patchAgentSessionSnapshot, patchRuntimeInfo, writeRuntimeInfo, clearRuntimeInfo, writeSessionState, clearSessionState, writeTurnState, clearTurnState, } from './rtdb-rest.js';
 // Constants
 export { DEFAULT_BASE_URL, DEFAULT_STREAM_URL, DEFAULT_RTDB_URL, FIREBASE_WEB_API_KEY } from './constants.js';
 // Base URL resolver

package/dist/rtdb-rest.d.ts

@@ -7,14 +7,18 @@
  */
 import type { CanonClient } from './client.js';
 import type { DeliveryIntent, RuntimeCapabilities, TurnLifecycleState } from './turn-protocol.js';
+import type { CanonControlValue, RuntimeInfoPayload } from './types.js';
 export interface SessionStatePayload {
     lastError?: string;
     model?: string;
     permissionMode?: string;
     effort?: string;
+    runtimeControlValues?: Record<string, CanonControlValue>;
     cwd?: string;
     executionMode?: 'worktree' | 'locked';
     executionBranch?: string;
+    worktreePath?: string;
+    executionFallbackReason?: string;
     hostMode?: boolean;
     clientType?: string;
     isActive: boolean;
@@ -63,6 +67,8 @@ export interface AgentSessionSnapshotPatch {
         value: string;
         label: string;
     }> | null;
+    effort?: string | null;
+    runtimeControlValues?: Record<string, CanonControlValue> | null;
     workspaceId?: string | null;
     workspaceOptions?: Array<{
         id: string;
@@ -71,8 +77,12 @@ export interface AgentSessionSnapshotPatch {
     executionMode?: 'worktree' | 'locked' | null;
     availableExecutionModes?: Array<'worktree' | 'locked'> | null;
     executionBranch?: string | null;
+    resolvedCwd?: string | null;
+    worktreePath?: string | null;
+    executionFallbackReason?: string | null;
     state?: 'idle' | 'running' | 'requires_action' | null;
     turnState?: TurnLifecycleState | null;
+    supportsQueue?: boolean | null;
     queueDepth?: number;
     waitingForInput?: boolean;
     contextUsage?: {
@@ -95,6 +105,11 @@ export interface AgentSessionSnapshotPatch {
         '.sv': 'timestamp';
     };
 }
+export interface RuntimeInfoPayloadData extends Omit<RuntimeInfoPayload, 'updatedAt'> {
+    updatedAt: {
+        '.sv': 'timestamp';
+    };
+}
 interface RTDBAuthOptions {
     rtdbUrl?: string;
     firebaseApiKey?: string;
@@ -109,6 +124,9 @@ interface RTDBClientHandle {
     writeTurnState(conversationId: string, agentId: string, state: Omit<TurnStatePayload, 'updatedAt'>): Promise<void>;
     clearTurnState(conversationId: string, agentId: string): Promise<void>;
     patchAgentSessionSnapshot(conversationId: string, agentId: string, snapshot: Omit<AgentSessionSnapshotPatch, 'updatedAt'>): Promise<void>;
+    writeRuntimeInfo(conversationId: string, agentId: string, payload: Omit<RuntimeInfoPayload, 'updatedAt'>): Promise<void>;
+    patchRuntimeInfo(conversationId: string, agentId: string, payload: Partial<Omit<RuntimeInfoPayload, 'updatedAt'>>): Promise<void>;
+    clearRuntimeInfo(conversationId: string, agentId: string): Promise<void>;
 }
 /**
  * Initializes the default RTDB helper and returns a scoped client for callers
@@ -131,4 +149,7 @@ export declare function clearSessionState(conversationId: string, agentId: strin
 export declare function writeTurnState(conversationId: string, agentId: string, state: Omit<TurnStatePayload, 'updatedAt'>): Promise<void>;
 export declare function clearTurnState(conversationId: string, agentId: string): Promise<void>;
 export declare function patchAgentSessionSnapshot(conversationId: string, agentId: string, snapshot: Omit<AgentSessionSnapshotPatch, 'updatedAt'>): Promise<void>;
+export declare function writeRuntimeInfo(conversationId: string, agentId: string, payload: Omit<RuntimeInfoPayload, 'updatedAt'>): Promise<void>;
+export declare function patchRuntimeInfo(conversationId: string, agentId: string, payload: Partial<Omit<RuntimeInfoPayload, 'updatedAt'>>): Promise<void>;
+export declare function clearRuntimeInfo(conversationId: string, agentId: string): Promise<void>;
 export {};

package/dist/rtdb-rest.js

@@ -18,6 +18,9 @@ function normalizeRTDBPath(path) {
 function buildAgentSessionPath(conversationId, agentId) {
     return `/agent-session/${conversationId}/${agentId}`;
 }
+function buildRuntimeInfoPath(conversationId, agentId) {
+    return `/runtime-info/${conversationId}/${agentId}`;
+}
 function createRTDBClientHandle(client, options) {
     const rtdbBase = normalizeRTDBBase(options?.rtdbUrl || DEFAULT_RTDB_BASE);
     const firebaseApiKey = options?.firebaseApiKey || DEFAULT_FIREBASE_API_KEY;
@@ -137,9 +140,18 @@ function createRTDBClientHandle(client, options) {
             ...(typeof state.hostMode === 'boolean' ? { hostMode: state.hostMode } : {}),
             ...(state.model !== undefined ? { model: state.model } : {}),
             ...(state.permissionMode !== undefined ? { permissionMode: state.permissionMode } : {}),
+            ...(state.effort !== undefined ? { effort: state.effort } : {}),
+            ...(state.runtimeControlValues !== undefined
+                ? { runtimeControlValues: state.runtimeControlValues }
+                : {}),
             ...(state.availableModels !== undefined ? { modelOptions: state.availableModels } : {}),
+            ...(state.cwd !== undefined ? { resolvedCwd: state.cwd } : {}),
             ...(state.executionMode !== undefined ? { executionMode: state.executionMode } : {}),
             ...(state.executionBranch !== undefined ? { executionBranch: state.executionBranch } : {}),
+            ...(state.worktreePath !== undefined ? { worktreePath: state.worktreePath } : {}),
+            ...(state.executionFallbackReason !== undefined
+                ? { executionFallbackReason: state.executionFallbackReason }
+                : {}),
             ...(state.state !== undefined ? { state: state.state } : {}),
             waitingForInput: state.state === 'requires_action',
             ...(state.contextUsage !== undefined ? { contextUsage: state.contextUsage } : {}),
@@ -160,6 +172,8 @@ function createRTDBClientHandle(client, options) {
                 lastError: null,
                 executionBranch: null,
                 contextUsage: null,
+                worktreePath: null,
+                executionFallbackReason: null,
                 updatedAt: { '.sv': 'timestamp' },
             });
         }
@@ -174,6 +188,9 @@ function createRTDBClientHandle(client, options) {
         });
         await patch(buildAgentSessionPath(conversationId, agentId), {
             turnState: state.state,
+            ...(state.capabilities?.supportsQueue !== undefined
+                ? { supportsQueue: state.capabilities.supportsQueue }
+                : {}),
             queueDepth: state.queueDepth,
             waitingForInput: state.state === 'waiting_input',
             lastHeartbeatAt: { '.sv': 'timestamp' },
@@ -205,6 +222,21 @@ function createRTDBClientHandle(client, options) {
             updatedAt: { '.sv': 'timestamp' },
         });
     }
+    async function writeRuntimeInfoImpl(conversationId, agentId, payload) {
+        await write(buildRuntimeInfoPath(conversationId, agentId), {
+            ...payload,
+            updatedAt: { '.sv': 'timestamp' },
+        });
+    }
+    async function patchRuntimeInfoImpl(conversationId, agentId, payload) {
+        await patch(buildRuntimeInfoPath(conversationId, agentId), {
+            ...payload,
+            updatedAt: { '.sv': 'timestamp' },
+        });
+    }
+    async function clearRuntimeInfoImpl(conversationId, agentId) {
+        await remove(buildRuntimeInfoPath(conversationId, agentId));
+    }
     return {
         read,
         write,
@@ -215,6 +247,9 @@ function createRTDBClientHandle(client, options) {
         writeTurnState: writeTurnStateImpl,
         clearTurnState: clearTurnStateImpl,
         patchAgentSessionSnapshot: patchAgentSessionSnapshotImpl,
+        writeRuntimeInfo: writeRuntimeInfoImpl,
+        patchRuntimeInfo: patchRuntimeInfoImpl,
+        clearRuntimeInfo: clearRuntimeInfoImpl,
     };
 }
 /**
@@ -260,3 +295,12 @@ export async function clearTurnState(conversationId, agentId) {
 export async function patchAgentSessionSnapshot(conversationId, agentId, snapshot) {
     await getDefaultRTDBClient()?.patchAgentSessionSnapshot(conversationId, agentId, snapshot);
 }
+export async function writeRuntimeInfo(conversationId, agentId, payload) {
+    await getDefaultRTDBClient()?.writeRuntimeInfo(conversationId, agentId, payload);
+}
+export async function patchRuntimeInfo(conversationId, agentId, payload) {
+    await getDefaultRTDBClient()?.patchRuntimeInfo(conversationId, agentId, payload);
+}
+export async function clearRuntimeInfo(conversationId, agentId) {
+    await getDefaultRTDBClient()?.clearRuntimeInfo(conversationId, agentId);
+}

package/dist/types.d.ts

@@ -132,11 +132,92 @@ export interface AgentCapabilities {
 export interface ModelOption {
     value: string;
     label: string;
+    description?: string;
 }
 export interface WorkspaceOption {
     id: string;
     label: string;
 }
+export interface CanonWorkspaceRootMetadata {
+    id: string;
+    label: string;
+    description?: string;
+    defaultRelativePath?: string | null;
+}
+export type CanonControlValue = string;
+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 CanonRuntimeInventoryStatus = 'ready' | 'auth_needed' | 'unknown' | 'configured' | 'running' | 'error';
+export type CanonRuntimeStatusTone = 'default' | 'success' | 'warning' | 'danger';
+export interface CanonControlDescriptor {
+    id: string;
+    label: string;
+    options?: ReadonlyArray<ModelOption>;
+    defaultValue?: CanonControlValue | null;
+    availability: CanonControlAvailability;
+    liveBehavior: CanonControlLiveBehavior;
+    selectionPolicy: CanonControlSelectionPolicy;
+    description?: string;
+}
+export interface CanonRuntimeDescriptor {
+    coreControls: ReadonlyArray<CanonControlDescriptor>;
+    runtimeControls?: ReadonlyArray<CanonControlDescriptor>;
+    /**
+     * Optional setup-time local roots advertised by a runtime. These are
+     * metadata only for now; existing session config still selects concrete
+     * workspace IDs until root-relative directory selection lands.
+     */
+    workspaceRoots?: ReadonlyArray<CanonWorkspaceRootMetadata>;
+    writableRoots?: ReadonlyArray<CanonWorkspaceRootMetadata>;
+    supportsInterrupt?: boolean;
+    /**
+     * Fidelity of live text exposed through Canon's streaming bubble path.
+     * `delta` means token/content deltas, `block` means chunked live previews,
+     * `snapshot` means completed assistant-message snapshots, and `status`
+     * means activity/tool state without live assistant text.
+     */
+    streamingTextMode?: CanonRuntimeStreamingMode;
+}
+export interface CanonRuntimeExecutionMetadata {
+    resolvedWorkspaceLabel?: string | null;
+    resolvedCwd?: string | null;
+    workspaceRootId?: string | null;
+    workspaceRelativePath?: string | null;
+    executionMode?: ExecutionEnvironmentMode | null;
+    executionBranch?: string | null;
+    worktreePath?: string | null;
+    fallbackReason?: string | null;
+}
+export interface CanonRuntimeStatusItem {
+    id: string;
+    label: string;
+    value: string;
+    tone?: CanonRuntimeStatusTone;
+}
+export interface CanonRuntimeInventoryEntry {
+    id: string;
+    label: string;
+    status?: CanonRuntimeInventoryStatus;
+    description?: string;
+}
+export interface CanonRuntimeInventory {
+    id: string;
+    label: string;
+    entries: ReadonlyArray<CanonRuntimeInventoryEntry>;
+}
+export interface RuntimeInfoPayload {
+    descriptor: CanonRuntimeDescriptor;
+    surfaceMode?: CanonRuntimeSurfaceMode;
+    surfaceLabel?: string;
+    statusItems?: ReadonlyArray<CanonRuntimeStatusItem>;
+    inventories?: ReadonlyArray<CanonRuntimeInventory>;
+    execution?: CanonRuntimeExecutionMetadata | null;
+    notes?: ReadonlyArray<string>;
+    updatedAt?: number;
+}
 /** Capability map keyed by clientType. Add new agent types here. */
 export declare const AGENT_CAPABILITIES: Record<AgentClientType, AgentCapabilities>;
 /** Trusted agent identity & access context, provided by the server */
@@ -193,6 +274,7 @@ export interface RuntimeUpdatedPayload {
     conversationId: string;
     agentId: string;
     runtime: AgentRuntime | null;
+    runtimeInfo?: RuntimeInfoPayload | null;
     sessionState: SessionState | null;
     sessionConfig: SessionConfig | null;
 }
@@ -265,8 +347,9 @@ export interface SetStreamingOptions {
 /** Written by Canon app to /control/{convoId}/{agentId}/session in RTDB */
 export interface SessionControl {
     model?: string;
-    permissionMode?: 'default' | 'acceptEdits' | 'plan' | 'bypassPermissions' | 'auto';
-    effort?: 'low' | 'medium' | 'high' | 'max';
+    permissionMode?: string;
+    effort?: string;
+    runtimeControlValues?: Record<string, CanonControlValue>;
     updatedAt: number;
     updatedBy: string;
 }
@@ -276,9 +359,12 @@ export interface SessionState {
     model?: string;
     permissionMode?: string;
     effort?: string;
+    runtimeControlValues?: Record<string, CanonControlValue>;
     cwd?: string;
     executionMode?: 'worktree' | 'locked';
     executionBranch?: string;
+    worktreePath?: string;
+    executionFallbackReason?: string;
     clientType?: AgentClientType;
     /** True when the agent is running under the host wrapper (host.ts) which can apply control signals */
     hostMode?: boolean;
@@ -297,6 +383,8 @@ export interface SessionConfig {
     hostMode?: boolean;
     model?: string;
     permissionMode?: string;
+    effort?: string;
+    runtimeControlValues?: Record<string, CanonControlValue>;
     workspaceId?: string;
     /**
      * Explicitly selected execution mode. Sessions created before this field
@@ -335,6 +423,7 @@ export interface AgentRuntime {
     defaultModel?: string;
     defaultPermissionMode?: string;
     availablePermissionModes?: PermissionModeOption[];
+    runtimeDescriptor?: CanonRuntimeDescriptor;
     defaultWorkspaceId?: string;
     /**
      * Execution modes the host will accept. The runtime advertises this so the
@@ -367,13 +456,22 @@ export interface AgentSessionSnapshot {
     modelOptions?: ModelOption[];
     permissionMode?: string;
     permissionModeOptions?: PermissionModeOption[];
+    effort?: string;
+    runtimeControlValues?: Record<string, CanonControlValue>;
+    runtimeDescriptor?: CanonRuntimeDescriptor | null;
+    runtimeInfo?: RuntimeInfoPayload | null;
     workspaceId?: string;
     workspaceOptions?: WorkspaceOption[];
     executionMode?: ExecutionEnvironmentMode;
     availableExecutionModes?: ExecutionEnvironmentMode[];
     executionBranch?: string;
+    resolvedWorkspaceLabel?: string | null;
+    resolvedCwd?: string | null;
+    worktreePath?: string | null;
+    executionFallbackReason?: string | null;
     state?: SessionState['state'];
     turnState?: TurnLifecycleState;
+    supportsQueue?: boolean;
     queueDepth: number;
     waitingForInput: boolean;
     contextUsage?: SessionState['contextUsage'];

package/package.json

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