@canonmsg/core 0.15.0 → 0.15.1

package/dist/agent-session.js

@@ -31,7 +31,9 @@ function buildWorkSessionSummary(workSession, workSessions) {
     };
 }
 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')
@@ -57,6 +59,7 @@ export function buildAgentSessionSnapshot(input) {
         effort: input.sessionState?.effort ?? input.sessionConfig?.effort,
         runtimeControlValues: input.sessionState?.runtimeControlValues
             ?? input.sessionConfig?.runtimeControlValues,
+        runtimeControlErrors: input.sessionState?.runtimeControlErrors ?? undefined,
         workspaceId: input.sessionConfig?.workspaceId
             ?? descriptorDefaultValue(input.runtime, 'workspace'),
         workspaceOptions,

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, CanonRuntimeExecutionMetadata, CanonRuntimeInventory, CanonRuntimeInventoryEntry, CanonRuntimeStreamingMode, CanonRuntimeStatusItem, CanonRuntimeSurfaceMode, CanonWorkspaceRootMetadata, RuntimeUpdatedPayload, RuntimeInfoPayload, RuntimeControlError, 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:',

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, CanonRuntimeExecutionMetadata, CanonRuntimeInventory, CanonRuntimeInventoryEntry, CanonRuntimeStreamingMode, CanonRuntimeStatusItem, CanonRuntimeSurfaceMode, CanonWorkspaceRootMetadata, ModelOption, PermissionModeOption, RuntimeInfoPayload, RuntimeControlError, 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,14 @@
  */
 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, RuntimeInfoPayload } from './types.js';
 export interface SessionStatePayload {
     lastError?: string;
     model?: string;
     permissionMode?: string;
     effort?: string;
     runtimeControlValues?: Record<string, CanonControlValue>;
+    runtimeControlErrors?: Record<string, RuntimeControlError> | null;
     cwd?: string;
     executionMode?: 'worktree' | 'locked';
     executionBranch?: string;
@@ -27,6 +28,7 @@ export interface SessionStatePayload {
         totalTokens: number;
         maxTokens: number;
     };
+    availableModels?: ModelOption[];
     updatedAt: {
         '.sv': 'timestamp';
     };
@@ -53,10 +55,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 +63,7 @@ export interface AgentSessionSnapshotPatch {
     }> | null;
     effort?: string | null;
     runtimeControlValues?: Record<string, CanonControlValue> | null;
+    runtimeControlErrors?: Record<string, RuntimeControlError> | null;
     workspaceId?: string | null;
     workspaceOptions?: Array<{
         id: string;

package/dist/rtdb-rest.js

@@ -144,6 +144,9 @@ function createRTDBClientHandle(client, options) {
             ...(state.runtimeControlValues !== undefined
                 ? { runtimeControlValues: state.runtimeControlValues }
                 : {}),
+            ...(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 +157,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' },

package/dist/types.d.ts

@@ -434,6 +434,7 @@ export type CanonStreamEvent = {
     };
 };
 export interface SendMessageOptions {
+    messageId?: string;
     contentType?: 'text' | 'audio' | 'image' | 'file' | 'contact_card';
     replyTo?: string;
     replyToPosition?: number;
@@ -466,6 +467,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 +479,7 @@ export interface SessionState {
     permissionMode?: string;
     effort?: string;
     runtimeControlValues?: Record<string, CanonControlValue>;
+    runtimeControlErrors?: Record<string, RuntimeControlError> | null;
     cwd?: string;
     executionMode?: 'worktree' | 'locked';
     executionBranch?: string;
@@ -573,6 +580,7 @@ export interface AgentSessionSnapshot {
     permissionModeOptions?: PermissionModeOption[];
     effort?: string;
     runtimeControlValues?: Record<string, CanonControlValue>;
+    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.1",
   "description": "Canon core — shared types, REST client, SSE stream, and registration for Canon messaging",
   "type": "module",
   "main": "dist/index.js",