@canonmsg/core 0.19.0 → 0.19.1

package/dist/runtime-state-publisher.js

@@ -1,4 +1,4 @@
-import { clearRuntimeInfo, clearRuntimeActivity, clearSessionState, clearTurnState, patchAgentSessionSnapshot, patchRuntimeInfo, readRuntimeActivity, removeRuntimeActivityItem, rtdbWrite, writeRuntimeActivity, writeRuntimeInfo, writeSessionState, writeTurnState, } from './rtdb-rest.js';
+import { clearRuntimeInfo, clearRuntimeActivity, clearSessionState, clearTurnState, patchAgentSessionSnapshot, patchRuntimeInfo, readRuntimeActivity, removeRuntimeActivityItem, rtdbRead, rtdbWrite, writeRuntimeActivity, writeRuntimeInfo, writeSessionState, writeTurnState, } from './rtdb-rest.js';
 const SERVER_TIMESTAMP = { '.sv': 'timestamp' };
 const MAX_RUNTIME_ACTIVITY_ITEMS = 50;
 const TERMINAL_RUNTIME_ACTIVITY_CLEAR_MS = 60_000;
@@ -6,9 +6,36 @@ const TERMINAL_RUNTIME_ACTIVITY_STATUSES = new Set(['completed', 'failed', 'bloc
 function isTerminalRuntimeActivity(item) {
     return TERMINAL_RUNTIME_ACTIVITY_STATUSES.has(item.status);
 }
+function hasNonEmptyArray(value) {
+    return Array.isArray(value) && value.length > 0;
+}
+function hasEnabledAdmissionActions(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    return Object.values(value).some((enabled) => enabled === true);
+}
+function hasPreservableRuntimeState(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const descriptor = value.runtimeDescriptor;
+    if (!descriptor || typeof descriptor !== 'object' || Array.isArray(descriptor))
+        return false;
+    const runtimeDescriptor = descriptor;
+    return hasNonEmptyArray(runtimeDescriptor.coreControls)
+        || hasNonEmptyArray(runtimeDescriptor.runtimeControls)
+        || hasNonEmptyArray(runtimeDescriptor.commands)
+        || hasNonEmptyArray(runtimeDescriptor.actions)
+        || hasNonEmptyArray(runtimeDescriptor.workspaceRoots)
+        || hasNonEmptyArray(runtimeDescriptor.writableRoots)
+        || hasEnabledAdmissionActions(runtimeDescriptor.admissionActions)
+        || runtimeDescriptor.streamingTextMode === 'delta'
+        || runtimeDescriptor.streamingTextMode === 'block';
+}
 export function createRuntimeStatePublisher(options) {
     const { agentId, clientType, hostMode, rtdb } = options;
     const writePath = (path, data) => (rtdb ? rtdb.write(path, data) : rtdbWrite(path, data));
+    const readPath = (path) => (rtdb ? rtdb.read(path) : rtdbRead(path));
+    let lastPublishedRuntime = null;
     const readRuntimeActivityPath = (conversationId) => (rtdb
         ? rtdb.readRuntimeActivity(conversationId, agentId)
         : readRuntimeActivity(conversationId, agentId));
@@ -36,15 +63,26 @@ export function createRuntimeStatePublisher(options) {
     }
     return {
         async publishAgentRuntime(runtime) {
-            await writePath(`/agent-runtime/${agentId}`, {
+            const payload = {
                 clientType,
                 hostMode,
                 ...runtime,
                 updatedAt: SERVER_TIMESTAMP,
-            });
+            };
+            lastPublishedRuntime = payload;
+            await writePath(`/agent-runtime/${agentId}`, payload);
         },
         async clearAgentRuntime() {
-            await writePath(`/agent-runtime/${agentId}`, null);
+            const path = `/agent-runtime/${agentId}`;
+            const current = lastPublishedRuntime ?? await readPath(path).catch(() => null);
+            if (hasPreservableRuntimeState(current)) {
+                await writePath(path, {
+                    ...current,
+                    updatedAt: 0,
+                });
+                return;
+            }
+            await writePath(path, null);
         },
         async writeSessionState(conversationId, state) {
             await (rtdb

package/dist/types.d.ts

@@ -216,6 +216,8 @@ export interface ModelOption {
     value: string;
     label: string;
     description?: string;
+    /** This option may only be selected by the agent owner or the agent itself. */
+    ownerOnly?: boolean;
     workspaceRootId?: string;
     workspaceRelativePath?: string;
     source?: WorkspaceOptionSource;
@@ -640,6 +642,8 @@ export interface PermissionModeOption {
     value: string;
     label: string;
     description?: string;
+    /** Runtime-owned risk marker; Canon enforces owner-only selection generically. */
+    ownerOnly?: boolean;
 }
 export declare const CLAUDE_PERMISSION_MODE_OPTIONS: readonly [{
     readonly value: "default";
@@ -653,12 +657,15 @@ export declare const CLAUDE_PERMISSION_MODE_OPTIONS: readonly [{
 }, {
     readonly value: "dontAsk";
     readonly label: "Don't ask";
+    readonly ownerOnly: true;
 }, {
     readonly value: "bypassPermissions";
     readonly label: "Bypass";
+    readonly ownerOnly: true;
 }, {
     readonly value: "auto";
     readonly label: "Auto";
+    readonly ownerOnly: true;
 }];
 export interface AgentRuntime {
     clientType?: AgentClientType;

package/dist/types.js

@@ -36,7 +36,7 @@ export const CLAUDE_PERMISSION_MODE_OPTIONS = [
     { value: 'default', label: 'Default' },
     { value: 'acceptEdits', label: 'Auto-edit' },
     { value: 'plan', label: 'Plan' },
-    { value: 'dontAsk', label: "Don't ask" },
-    { value: 'bypassPermissions', label: 'Bypass' },
-    { value: 'auto', label: 'Auto' },
+    { value: 'dontAsk', label: "Don't ask", ownerOnly: true },
+    { value: 'bypassPermissions', label: 'Bypass', ownerOnly: true },
+    { value: 'auto', label: 'Auto', ownerOnly: true },
 ];

package/package.json

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