@pellux/goodvibes-sdk 0.30.3 → 0.33.1

package/dist/platform/runtime/bootstrap-services.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap-services.d.ts","sourceRoot":"","sources":["../../../src/platform/runtime/bootstrap-services.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bootstrap-services.d.ts","sourceRoot":"","sources":["../../../src/platform/runtime/bootstrap-services.ts"],"names":[],"mappings":"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"}

package/dist/platform/runtime/bootstrap-services.js

@@ -1,8 +1,72 @@
+import { ConfigurationError } from '@pellux/goodvibes-errors';
 import { logger } from '../utils/logger.js';
 import net from 'node:net';
 import { summarizeError } from '../utils/error-display.js';
 const DEFAULT_SERVICE_START_TIMEOUT_MS = 1500;
-async function isTcpPortInUse(host, port, timeoutMs = 250) {
+const TCP_PORT_PROBE_TIMEOUT_MS = 250;
+const DAEMON_IDENTITY_PROBE_TIMEOUT_MS = 750;
+function readBooleanSetting(config, key) {
+    const value = config.get(key);
+    if (typeof value !== 'boolean') {
+        throw new ConfigurationError(`Expected ${key} to be a boolean, got ${typeof value}.`);
+    }
+    return value;
+}
+function readHostSetting(config, key, fallback) {
+    const value = config.get(key);
+    if (value === undefined || value === null)
+        return fallback;
+    if (typeof value !== 'string') {
+        throw new ConfigurationError(`Expected ${key} to be a host string, got ${typeof value}.`);
+    }
+    const trimmed = value.trim();
+    if (!trimmed) {
+        throw new ConfigurationError(`Expected ${key} to be a non-empty host string.`);
+    }
+    return trimmed;
+}
+function readPortSetting(config, key, fallback) {
+    const value = config.get(key);
+    if (value === undefined || value === null)
+        return fallback;
+    const port = typeof value === 'number'
+        ? value
+        : typeof value === 'string' && value.trim() !== ''
+            ? Number(value)
+            : NaN;
+    if (!Number.isInteger(port) || port < 1 || port > 65535) {
+        throw new ConfigurationError(`Expected ${key} to be an integer TCP port between 1 and 65535.`);
+    }
+    return port;
+}
+function isBindConflictMessage(message) {
+    return message.includes('EADDRINUSE') || message.includes('Address already in use');
+}
+async function stopAfterFailedStart(label, service) {
+    try {
+        await service.stop();
+    }
+    catch (error) {
+        logger.warn(`${label} cleanup after failed startup failed`, { error: summarizeError(error) });
+    }
+}
+async function startGuardedService(options) {
+    try {
+        const result = await startWithTimeout(options.label, () => options.service.start(), options.timeoutMs, () => options.service.stop());
+        if (result === 'timed_out') {
+            return { service: null, status: options.timedOutStatus() };
+        }
+        return { service: options.service, status: options.startedStatus() };
+    }
+    catch (error) {
+        const message = summarizeError(error);
+        if (!isBindConflictMessage(message))
+            throw error;
+        await stopAfterFailedStart(options.label, options.service);
+        return { service: null, status: await options.bindConflictStatus(message) };
+    }
+}
+async function isTcpPortInUse(host, port, timeoutMs = TCP_PORT_PROBE_TIMEOUT_MS) {
     return await new Promise((resolve) => {
         const socket = new net.Socket();
         let settled = false;
@@ -41,7 +105,7 @@ function createServiceStatus(mode, host, port, details = {}) {
 }
 async function probeGoodVibesDaemonIdentity(host, port, token) {
     const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), 750);
+    const timeout = setTimeout(() => controller.abort(), DAEMON_IDENTITY_PROBE_TIMEOUT_MS);
     timeout.unref?.();
     try {
         const headers = new Headers();
@@ -128,23 +192,23 @@ async function createDefaultHttpListener(hookDispatcher, userAuth, configManager
     const { HttpListener } = await import('../daemon/http-listener.js');
     return new HttpListener({ hookDispatcher, userAuth, configManager });
 }
-export async function startHostServices(config, runtimeBus, hookDispatcher, factories = {}, runtimeServices) {
+export async function startHostServices(config, runtimeBus, hookDispatcher, runtimeServices, factories = {}) {
     const sharedUserAuth = runtimeServices.localUserAuthManager;
     const startupTimeoutMs = factories.startupTimeoutMs ?? DEFAULT_SERVICE_START_TIMEOUT_MS;
-    const daemonHost = String(config.get('controlPlane.host') ?? '127.0.0.1');
-    const daemonPort = Number(config.get('controlPlane.port') ?? 3421);
-    const httpListenerHost = String(config.get('httpListener.host') ?? '127.0.0.1');
-    const httpListenerPort = Number(config.get('httpListener.port') ?? 3422);
+    const daemonHost = readHostSetting(config, 'controlPlane.host', '127.0.0.1');
+    const daemonPort = readPortSetting(config, 'controlPlane.port', 3421);
+    const httpListenerHost = readHostSetting(config, 'httpListener.host', '127.0.0.1');
+    const httpListenerPort = readPortSetting(config, 'httpListener.port', 3422);
     const probeDaemonPortInUse = factories.probeDaemonPortInUse ?? ((host, port) => isTcpPortInUse(host, port));
     const probeDaemonIdentity = factories.probeDaemonIdentity ?? probeGoodVibesDaemonIdentity;
     const probeHttpListenerPortInUse = factories.probeHttpListenerPortInUse ?? ((host, port) => isTcpPortInUse(host, port));
-    let daemonServer = null;
-    let httpListener = null;
+    let embeddedDaemonServer = null;
+    let embeddedHttpListener = null;
     let daemonStatus = createServiceStatus('disabled', daemonHost, daemonPort, { reason: 'danger.daemon is disabled' });
     let httpListenerStatus = createServiceStatus('disabled', httpListenerHost, httpListenerPort, {
         reason: 'danger.httpListener is disabled',
     });
-    if (config.get('danger.daemon')) {
+    if (readBooleanSetting(config, 'danger.daemon')) {
         if (await probeDaemonPortInUse(daemonHost, daemonPort)) {
             const identity = await probeDaemonIdentity(daemonHost, daemonPort, factories.sharedDaemonToken);
             if (identity.kind === 'goodvibes') {
@@ -173,28 +237,22 @@ export async function startHostServices(config, runtimeBus, hookDispatcher, fact
             }
         }
         else {
-            daemonServer = factories.createDaemonServer
+            const pendingDaemonServer = factories.createDaemonServer
                 ? factories.createDaemonServer(runtimeBus, sharedUserAuth, runtimeServices)
                 : await createDefaultDaemonServer(runtimeBus, sharedUserAuth, runtimeServices);
-            daemonServer.enable({ daemon: true }, factories.sharedDaemonToken);
-            try {
-                const service = daemonServer;
-                const result = await startWithTimeout('Daemon server', () => service.start(), startupTimeoutMs, () => service.stop());
-                if (result === 'timed_out') {
-                    daemonStatus = createServiceStatus('unavailable', daemonHost, daemonPort, {
-                        reason: 'Daemon server startup timed out',
-                    });
-                    daemonServer = null;
-                }
-                else {
-                    daemonStatus = createServiceStatus('embedded', daemonHost, daemonPort, {
-                        reason: 'Embedded daemon started in this host instance',
-                    });
-                }
-            }
-            catch (error) {
-                const message = summarizeError(error);
-                if (message.includes('EADDRINUSE') || message.includes('Address already in use')) {
+            const service = pendingDaemonServer;
+            service.enable({ daemon: true }, factories.sharedDaemonToken);
+            const started = await startGuardedService({
+                label: 'Daemon server',
+                service,
+                timeoutMs: startupTimeoutMs,
+                timedOutStatus: () => createServiceStatus('unavailable', daemonHost, daemonPort, {
+                    reason: 'Daemon server startup timed out',
+                }),
+                startedStatus: () => createServiceStatus('embedded', daemonHost, daemonPort, {
+                    reason: 'Embedded daemon started in this host instance',
+                }),
+                bindConflictStatus: async (message) => {
                     const identity = await probeDaemonIdentity(daemonHost, daemonPort, factories.sharedDaemonToken);
                     if (identity.kind === 'goodvibes') {
                         logger.info('Existing GoodVibes daemon detected after bind conflict; continuing without embedded daemon in this host instance', {
@@ -202,29 +260,25 @@ export async function startHostServices(config, runtimeBus, hookDispatcher, fact
                             port: daemonPort,
                             version: identity.version,
                         });
-                        daemonStatus = createServiceStatus('external', daemonHost, daemonPort, {
+                        return createServiceStatus('external', daemonHost, daemonPort, {
                             authenticated: true,
                             status: identity.status,
                             version: identity.version,
                             reason: 'Existing GoodVibes daemon verified after bind conflict',
                         });
                     }
-                    else {
-                        logger.warn('Daemon server port already in use; continuing without local daemon in this host instance', { error: message });
-                        daemonStatus = createServiceStatus('blocked', daemonHost, daemonPort, {
-                            authenticated: identity.kind !== 'unauthorized' ? undefined : false,
-                            reason: identity.reason ?? message,
-                        });
-                    }
-                    daemonServer = null;
-                }
-                else {
-                    throw error;
-                }
-            }
+                    logger.warn('Daemon server port already in use; continuing without local daemon in this host instance', { error: message });
+                    return createServiceStatus('blocked', daemonHost, daemonPort, {
+                        authenticated: identity.kind !== 'unauthorized' ? undefined : false,
+                        reason: identity.reason ?? message,
+                    });
+                },
+            });
+            embeddedDaemonServer = started.service;
+            daemonStatus = started.status;
         }
     }
-    if (config.get('danger.httpListener')) {
+    if (readBooleanSetting(config, 'danger.httpListener')) {
         if (await probeHttpListenerPortInUse(httpListenerHost, httpListenerPort)) {
             httpListenerStatus = createServiceStatus('blocked', httpListenerHost, httpListenerPort, {
                 reason: 'Configured HTTP listener port is already in use',
@@ -235,50 +289,42 @@ export async function startHostServices(config, runtimeBus, hookDispatcher, fact
             });
         }
         else {
-            httpListener = factories.createHttpListener
+            const pendingHttpListener = factories.createHttpListener
                 ? factories.createHttpListener(hookDispatcher, sharedUserAuth, runtimeServices.configManager)
                 : await createDefaultHttpListener(hookDispatcher, sharedUserAuth, runtimeServices.configManager);
-            httpListener.enable({ httpListener: true }, factories.sharedHttpListenerToken);
-            try {
-                const service = httpListener;
-                const result = await startWithTimeout('HTTP listener', () => service.start(), startupTimeoutMs, () => service.stop());
-                if (result === 'timed_out') {
-                    httpListenerStatus = createServiceStatus('unavailable', httpListenerHost, httpListenerPort, {
-                        reason: 'HTTP listener startup timed out',
-                    });
-                    httpListener = null;
-                }
-                else {
-                    httpListenerStatus = createServiceStatus('embedded', httpListenerHost, httpListenerPort, {
-                        reason: 'Embedded HTTP listener started in this host instance',
-                    });
-                }
-            }
-            catch (error) {
-                const message = summarizeError(error);
-                if (message.includes('EADDRINUSE') || message.includes('Address already in use')) {
+            const service = pendingHttpListener;
+            service.enable({ httpListener: true }, factories.sharedHttpListenerToken);
+            const started = await startGuardedService({
+                label: 'HTTP listener',
+                service,
+                timeoutMs: startupTimeoutMs,
+                timedOutStatus: () => createServiceStatus('unavailable', httpListenerHost, httpListenerPort, {
+                    reason: 'HTTP listener startup timed out',
+                }),
+                startedStatus: () => createServiceStatus('embedded', httpListenerHost, httpListenerPort, {
+                    reason: 'Embedded HTTP listener started in this host instance',
+                }),
+                bindConflictStatus: (message) => {
                     logger.warn('HTTP listener port already in use; continuing without local listener in this host instance', { error: message });
-                    httpListenerStatus = createServiceStatus('blocked', httpListenerHost, httpListenerPort, { reason: message });
-                    httpListener = null;
-                }
-                else {
-                    throw error;
-                }
-            }
+                    return createServiceStatus('blocked', httpListenerHost, httpListenerPort, { reason: message });
+                },
+            });
+            embeddedHttpListener = started.service;
+            httpListenerStatus = started.status;
         }
     }
     return {
-        daemonServer,
-        httpListener,
+        daemonServer: embeddedDaemonServer,
+        httpListener: embeddedHttpListener,
         daemonStatus,
         httpListenerStatus,
         listRecentControlPlaneEvents(limit) {
-            return daemonServer?.listRecentControlPlaneEvents(limit) ?? [];
+            return embeddedDaemonServer?.listRecentControlPlaneEvents(limit) ?? [];
         },
         async stop() {
             await Promise.allSettled([
-                daemonServer?.stop(),
-                httpListener?.stop(),
+                embeddedDaemonServer?.stop(),
+                embeddedHttpListener?.stop(),
             ]);
         },
     };

package/dist/platform/runtime/bootstrap.d.ts

@@ -0,0 +1,28 @@
+export { scheduleBackgroundMcpDiscovery, startBackgroundProviderDiscovery, } from './bootstrap-background.js';
+export type { BackgroundRuntimeTaskHandle, BackgroundMcpDiscoveryOptions, BackgroundProviderDiscoveryOptions, HostSystemMessageSink, RuntimeSelectionState, } from './bootstrap-background.js';
+export { loadRuntimeSystemPrompt, restoreRuntimeModel, synchronizeConfiguredServices, } from './bootstrap-helpers.js';
+export type { RuntimeModelSelectionState } from './bootstrap-helpers.js';
+export { registerBootstrapRuntimeEvents, registerHostRuntimeEvents } from './bootstrap-runtime-events.js';
+export type { BootstrapRuntimeEventBridgeOptions, HostRuntimeEventBridgeOptions, HostRuntimeMessageRouter, } from './bootstrap-runtime-events.js';
+export { startHostServices } from './bootstrap-services.js';
+export type { HostServiceMode, HostServicesConfig, HostServicesHandle, HostServiceStatus, } from './bootstrap-services.js';
+export { registerBootstrapHookBridge } from './bootstrap-hook-bridge.js';
+export type { HookBridgeRegistrationOptions } from './bootstrap-hook-bridge.js';
+export { createDeferredStartupCoordinator } from './deferred-startup.js';
+export type { DeferredStartupCoordinator, DeferredStartupTask } from './deferred-startup.js';
+export { shutdownRuntime, saveSession, fireSessionStart } from './lifecycle.js';
+export { createDirectTransportServices, createOperatorClientServices, createPeerClientDependencies, } from './foundation-services.js';
+export type { DirectTransportServicesOptions, DirectTransportServices, OperatorClientServicesOptions, OperatorClientServices, OperatorClientReadModels, } from './foundation-services.js';
+export { createRuntimeFoundationClients } from './foundation-clients.js';
+export type { RuntimeFoundationClients, RuntimeFoundationClientsOptions, } from './foundation-clients.js';
+export { createOperatorClient } from './operator-client.js';
+export type { OperatorClient } from './operator-client.js';
+export { createPeerClient } from './peer-client.js';
+export type { PeerClient } from './peer-client.js';
+export { createRuntimeProviderApi } from './runtime-provider-api.js';
+export { createRuntimeKnowledgeApi } from './runtime-knowledge-api.js';
+export { createRuntimeHookApi } from './runtime-hook-api.js';
+export { createRuntimeMcpApi } from './runtime-mcp-api.js';
+export { createRuntimeOpsApi } from './runtime-ops-api.js';
+export type { OpsApi } from './ops-api.js';
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/platform/runtime/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../../src/platform/runtime/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,gCAAgC,GACjC,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,2BAA2B,EAC3B,6BAA6B,EAC7B,kCAAkC,EAClC,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,8BAA8B,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1G,YAAY,EACV,kCAAkC,EAClC,6BAA6B,EAC7B,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,YAAY,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,gCAAgC,EAAE,MAAM,uBAAuB,CAAC;AACzE,YAAY,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC7F,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,8BAA8B,EAC9B,uBAAuB,EACvB,6BAA6B,EAC7B,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AACzE,YAAY,EACV,wBAAwB,EACxB,+BAA+B,GAChC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC"}

package/dist/platform/runtime/bootstrap.js

@@ -0,0 +1,16 @@
+export { scheduleBackgroundMcpDiscovery, startBackgroundProviderDiscovery, } from './bootstrap-background.js';
+export { loadRuntimeSystemPrompt, restoreRuntimeModel, synchronizeConfiguredServices, } from './bootstrap-helpers.js';
+export { registerBootstrapRuntimeEvents, registerHostRuntimeEvents } from './bootstrap-runtime-events.js';
+export { startHostServices } from './bootstrap-services.js';
+export { registerBootstrapHookBridge } from './bootstrap-hook-bridge.js';
+export { createDeferredStartupCoordinator } from './deferred-startup.js';
+export { shutdownRuntime, saveSession, fireSessionStart } from './lifecycle.js';
+export { createDirectTransportServices, createOperatorClientServices, createPeerClientDependencies, } from './foundation-services.js';
+export { createRuntimeFoundationClients } from './foundation-clients.js';
+export { createOperatorClient } from './operator-client.js';
+export { createPeerClient } from './peer-client.js';
+export { createRuntimeProviderApi } from './runtime-provider-api.js';
+export { createRuntimeKnowledgeApi } from './runtime-knowledge-api.js';
+export { createRuntimeHookApi } from './runtime-hook-api.js';
+export { createRuntimeMcpApi } from './runtime-mcp-api.js';
+export { createRuntimeOpsApi } from './runtime-ops-api.js';

package/dist/platform/runtime/compaction/lifecycle.d.ts

@@ -44,7 +44,7 @@ export interface StrategySelectionParams {
     /** Model context window size. */
     contextWindow: number;
     /** Whether a prompt-too-long error was the immediate cause. */
-    isPromptTooLong?: boolean;
+    isPromptTooLong?: boolean | undefined;
 }
 /**
  * Selects the appropriate compaction strategy based on trigger and token pressure.

package/dist/platform/runtime/compaction/lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/compaction/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA+BlG;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,wBAAwB,EAC9B,EAAE,EAAE,wBAAwB,GAC3B,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,wBAAwB,GAC7B,WAAW,CAAC,wBAAwB,CAAC,CAEvC;AAED,iDAAiD;AACjD,MAAM,MAAM,gBAAgB,GACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAE,KAAK,EAAE,wBAAwB,CAAA;CAAE,GAC9C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,wBAAwB,EACjC,MAAM,EAAE,wBAAwB,GAC/B,gBAAgB,CAQlB;AAMD,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAEnE;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAQrE;AAMD,sDAAsD;AACtD,MAAM,WAAW,uBAAuB;IACtC,iCAAiC;IACjC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,uBAAuB,GAC9B,kBAAkB,CAiBpB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,kBAAkB,GAC3B,wBAAwB,CAW1B"}
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/compaction/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA+BlG;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,wBAAwB,EAC9B,EAAE,EAAE,wBAAwB,GAC3B,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,wBAAwB,GAC7B,WAAW,CAAC,wBAAwB,CAAC,CAEvC;AAED,iDAAiD;AACjD,MAAM,MAAM,gBAAgB,GACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAE,KAAK,EAAE,wBAAwB,CAAA;CAAE,GAC9C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,wBAAwB,EACjC,MAAM,EAAE,wBAAwB,GAC/B,gBAAgB,CAQlB;AAMD,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAEnE;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAQrE;AAMD,sDAAsD;AACtD,MAAM,WAAW,uBAAuB;IACtC,iCAAiC;IACjC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,uBAAuB,GAC9B,kBAAkB,CAiBpB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,kBAAkB,GAC3B,wBAAwB,CAW1B"}

package/dist/platform/runtime/compaction/manager.d.ts

@@ -27,7 +27,7 @@ export interface CompactionManagerOptions {
     /** Model context window size (tokens). */
     contextWindow: number;
     /** Threshold fraction at which compaction is triggered (default: 0.75). */
-    thresholdFraction?: number;
+    thresholdFraction?: number | undefined;
 }
 /**
  * CompactionManager — manages the full lifecycle of session context compaction.
@@ -75,7 +75,7 @@ export declare class CompactionManager {
         messages: ProviderMessage[];
         tokenCount: number;
         trigger: CompactionTrigger;
-        isPromptTooLong?: boolean;
+        isPromptTooLong?: boolean | undefined;
     }): Promise<CompactionLifecycleResult | null>;
     /**
      * Runs the session resume repair pipeline on the last boundary commit.

package/dist/platform/runtime/compaction/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/compaction/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAgBtE,OAAO,KAAK,EACV,cAAc,EACd,yBAAyB,EACzB,wBAAwB,EAExB,iBAAiB,EAGlB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAerD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAOpE,oDAAoD;AACpD,MAAM,WAAW,wBAAwB;IACvC,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,GAAG,EAAE,eAAe,CAAC;IACrB,mEAAmE;IACnE,KAAK,EAAE,kBAAkB,CAAC;IAC1B,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAMD;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAE5C,mCAAmC;IACnC,OAAO,CAAC,MAAM,CAAoC;IAElD,4EAA4E;IAC5E,OAAO,CAAC,WAAW,CAA+B;IAElD,oDAAoD;IACpD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiB;gBAE1B,IAAI,EAAE,wBAAwB;IAe1C,2CAA2C;IAC3C,IAAI,KAAK,IAAI,wBAAwB,CAEpC;IAED,wDAAwD;IACxD,IAAI,UAAU,IAAI,cAAc,GAAG,IAAI,CAEtC;IAED;;OAEG;IAEH;;;;;;;;OAQG;IACG,OAAO,CAAC,IAAI,EAAE;QAClB,QAAQ,EAAE,eAAe,EAAE,CAAC;QAC5B,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,iBAAiB,CAAC;QAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,GAAG,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC;IAqN7C;;;;;;;;OAQG;IACH,MAAM,CACJ,cAAc,CAAC,EAAE,cAAc,GAC9B,kBAAkB;IAuBrB;;OAEG;YACW,YAAY;IAmD1B;;;OAGG;IACH,OAAO,CAAC,WAAW;CAepB"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/compaction/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAgBtE,OAAO,KAAK,EACV,cAAc,EACd,yBAAyB,EACzB,wBAAwB,EAExB,iBAAiB,EAGlB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAerD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAOpE,oDAAoD;AACpD,MAAM,WAAW,wBAAwB;IACvC,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,GAAG,EAAE,eAAe,CAAC;IACrB,mEAAmE;IACnE,KAAK,EAAE,kBAAkB,CAAC;IAC1B,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAMD;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAE5C,mCAAmC;IACnC,OAAO,CAAC,MAAM,CAAoC;IAElD,4EAA4E;IAC5E,OAAO,CAAC,WAAW,CAA+B;IAElD,oDAAoD;IACpD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiB;gBAE1B,IAAI,EAAE,wBAAwB;IAe1C,2CAA2C;IAC3C,IAAI,KAAK,IAAI,wBAAwB,CAEpC;IAED,wDAAwD;IACxD,IAAI,UAAU,IAAI,cAAc,GAAG,IAAI,CAEtC;IAED;;OAEG;IAEH;;;;;;;;OAQG;IACG,OAAO,CAAC,IAAI,EAAE;QAClB,QAAQ,EAAE,eAAe,EAAE,CAAC;QAC5B,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,iBAAiB,CAAC;QAC3B,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;KACvC,GAAG,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC;IAqN7C;;;;;;;;OAQG;IACH,MAAM,CACJ,cAAc,CAAC,EAAE,cAAc,GAC9B,kBAAkB;IAuBrB;;OAEG;YACW,YAAY;IAmD1B;;;OAGG;IACH,OAAO,CAAC,WAAW;CAepB"}

package/dist/platform/runtime/compaction/resume-repair.d.ts

@@ -24,7 +24,7 @@ export interface ResumeRepairOptions {
     /** The boundary commit being resumed. */
     commit: BoundaryCommit;
     /** Maximum tokens allowed in the resumed session (default: RESUME_MAX_TOKENS). */
-    maxTokens?: number;
+    maxTokens?: number | undefined;
 }
 /**
  * Runs the session resume repair pipeline on a boundary commit.

package/dist/platform/runtime/compaction/resume-repair.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resume-repair.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/compaction/resume-repair.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAgB,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAgBnE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,MAAM,EAAE,cAAc,CAAC;IACvB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB,CA8FhF"}
+{"version":3,"file":"resume-repair.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/compaction/resume-repair.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAgB,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAgBnE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,MAAM,EAAE,cAAc,CAAC;IACvB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB,CA8FhF"}

package/dist/platform/runtime/compaction/resume-repair.js

@@ -64,12 +64,12 @@ export function runResumeRepair(options) {
         ];
     }
     // ── Check 2: First message must be from 'user' ────────────────────────────
-    if (messages[0].role !== 'user') {
+    if (messages[0]?.role !== 'user') {
         actions.push({
             kind: 'prepend_user_message',
-            description: `First message had role '${messages[0].role}'; prepended synthetic user message.`,
+            description: `First message had role '${messages[0]?.role ?? 'unknown'}'; prepended synthetic user message.`,
             severity: 'warn',
-            meta: { originalFirstRole: messages[0].role },
+            meta: { originalFirstRole: messages[0]?.role ?? 'unknown' },
         });
         const synthetic = {
             role: 'user',

package/dist/platform/runtime/compaction/types.d.ts

@@ -47,7 +47,7 @@ export interface StrategyInput {
     /** Which strategy is being applied (for self-identification in results). */
     strategy: CompactionStrategy;
     /** Optional additional metadata from the trigger. */
-    meta?: Record<string, unknown>;
+    meta?: Record<string, unknown> | undefined;
 }
 /** Output produced by every compaction strategy. */
 export interface StrategyOutput {
@@ -61,7 +61,7 @@ export interface StrategyOutput {
     strategy: CompactionStrategy;
     /** Wall-clock duration for this strategy's execution. */
     durationMs: number;
-    /** Any warnings or non-fatal issues encountered. */
+    /** Any warnings encountered while compacting. */
     warnings: string[];
 }
 /**
@@ -149,7 +149,7 @@ export interface RepairAction {
     /** Severity classification. */
     severity: RepairSeverity;
     /** Optional metadata about what was changed. */
-    meta?: Record<string, unknown>;
+    meta?: Record<string, unknown> | undefined;
 }
 /** Result of the session resume repair pipeline. */
 export interface ResumeRepairResult {
@@ -164,6 +164,6 @@ export interface ResumeRepairResult {
     /** Whether the session is safe to resume after repair. */
     safeToResume: boolean;
     /** Human-readable reason if not safe to resume. */
-    failReason?: string;
+    failReason?: string | undefined;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/platform/runtime/compaction/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/compaction/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/compaction/types.ts"],"names":[],"mappings":"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"}

package/dist/platform/runtime/correlation.d.ts

@@ -1,5 +1,5 @@
 /**
- * OBS-15: AsyncLocalStorage-based correlation context for request/session/turn/run scoping.
+ * AsyncLocalStorage-based correlation context for request/session/turn/run scoping.
  *
  * Seed at HTTP entry points and session/turn creation so downstream events can
  * automatically attach the correct IDs without explicit threading.
@@ -17,13 +17,13 @@ import { AsyncLocalStorage } from 'node:async_hooks';
 /** Correlation identifiers propagated via AsyncLocalStorage. */
 export interface CorrelationContext {
     /** HTTP request ID — seeded by the HTTP listener on every inbound request. */
-    readonly requestId?: string;
+    readonly requestId?: string | undefined;
     /** Session ID — seeded when a session starts or resumes. */
-    readonly sessionId?: string;
+    readonly sessionId?: string | undefined;
     /** Run ID — seeded when a run (multi-turn conversation) begins. */
-    readonly runId?: string;
+    readonly runId?: string | undefined;
     /** Turn ID — seeded when a turn starts within a run. */
-    readonly turnId?: string;
+    readonly turnId?: string | undefined;
 }
 /** The singleton AsyncLocalStorage instance for correlation context. */
 export declare const correlationCtx: AsyncLocalStorage<CorrelationContext>;

package/dist/platform/runtime/correlation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"correlation.d.ts","sourceRoot":"","sources":["../../../src/platform/runtime/correlation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wEAAwE;AACxE,eAAO,MAAM,cAAc,uCAA8C,CAAC;AAE1E;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,QAAQ,CAAC,kBAAkB,CAAC,CAEpE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,SAAS,EAAE,OAAO,CAAC,kBAAkB,CAAC,EACtC,EAAE,EAAE,MAAM,CAAC,GACV,CAAC,CAGH;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,SAAS,EAAE,OAAO,CAAC,kBAAkB,CAAC,EACtC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAGZ"}
+{"version":3,"file":"correlation.d.ts","sourceRoot":"","sources":["../../../src/platform/runtime/correlation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,mEAAmE;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,wDAAwD;IACxD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,wEAAwE;AACxE,eAAO,MAAM,cAAc,uCAA8C,CAAC;AAE1E;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,QAAQ,CAAC,kBAAkB,CAAC,CAEpE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,SAAS,EAAE,OAAO,CAAC,kBAAkB,CAAC,EACtC,EAAE,EAAE,MAAM,CAAC,GACV,CAAC,CAGH;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,SAAS,EAAE,OAAO,CAAC,kBAAkB,CAAC,EACtC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAGZ"}

package/dist/platform/runtime/correlation.js

@@ -1,5 +1,5 @@
 /**
- * OBS-15: AsyncLocalStorage-based correlation context for request/session/turn/run scoping.
+ * AsyncLocalStorage-based correlation context for request/session/turn/run scoping.
  *
  * Seed at HTTP entry points and session/turn creation so downstream events can
  * automatically attach the correct IDs without explicit threading.

package/dist/platform/runtime/deferred-startup.d.ts

@@ -2,7 +2,7 @@
 export interface DeferredStartupTask {
     readonly label: string;
     readonly run: () => void | Promise<void>;
-    readonly onError?: (error: unknown) => void;
+    readonly onError?: ((error: unknown) => void) | undefined;
 }
 export interface DeferredStartupCoordinator {
     schedule(task: DeferredStartupTask): Promise<void>;

package/dist/platform/runtime/deferred-startup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deferred-startup.d.ts","sourceRoot":"","sources":["../../../src/platform/runtime/deferred-startup.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAED,wBAAgB,gCAAgC,CAC9C,SAAS,GAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAGpC,GACA,0BAA0B,CAwC5B"}
+{"version":3,"file":"deferred-startup.d.ts","sourceRoot":"","sources":["../../../src/platform/runtime/deferred-startup.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC3D;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAED,wBAAgB,gCAAgC,CAC9C,SAAS,GAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAGpC,GACA,0BAA0B,CAwC5B"}

package/dist/platform/runtime/diagnostics/actions.d.ts

@@ -32,15 +32,15 @@ export interface JumpToToolCallPayload {
 }
 export interface RetryTaskPayload {
     readonly taskId: string;
-    readonly note?: string;
+    readonly note?: string | undefined;
 }
 export interface CancelTaskPayload {
     readonly taskId: string;
-    readonly note?: string;
+    readonly note?: string | undefined;
 }
 export interface CancelAgentPayload {
     readonly agentId: string;
-    readonly note?: string;
+    readonly note?: string | undefined;
 }
 export type DiagnosticActionPayload = LoadReplayPayload | RunPolicySimulationPayload | JumpToTaskPayload | JumpToAgentPayload | JumpToToolCallPayload | RetryTaskPayload | CancelTaskPayload | CancelAgentPayload;
 /** Load-replay action. */
@@ -145,7 +145,7 @@ export interface ActionResult {
      * Whether the failure was due to a permission check (as opposed to a
      * runtime error in the handler).
      */
-    readonly permissionDenied?: boolean;
+    readonly permissionDenied?: boolean | undefined;
 }
 /**
  * Navigation callback invoked when a jump action targets a panel entry.
@@ -172,27 +172,27 @@ export interface DiagnosticActionDispatcherConfig {
      * Replay engine for 'load-replay' actions.
      * When absent, load-replay actions return an error result.
      */
-    readonly replayEngine?: DeterministicReplayEngine;
+    readonly replayEngine?: DeterministicReplayEngine | undefined;
     /**
      * Permission simulator for 'run-policy-simulation' actions.
      * When absent, policy simulation actions return an error result.
      */
-    readonly simulator?: PermissionSimulator;
+    readonly simulator?: PermissionSimulator | undefined;
     /**
      * Ops control plane for 'retry-task', 'cancel-task', 'cancel-agent'.
      * When absent, those actions return an error result.
      */
-    readonly controlPlane?: OpsControlPlane;
+    readonly controlPlane?: OpsControlPlane | undefined;
     /**
      * Navigation callback for 'jump-to-*' actions.
      * When absent, jump actions return a success result with a warning note.
      */
-    readonly navigateTo?: NavigateToEntryCallback;
+    readonly navigateTo?: NavigateToEntryCallback | undefined;
     /**
      * Permission checker invoked before dispatching each action.
      * Defaults to: read=allow, operator=allow, admin=deny.
      */
-    readonly checkPermission?: PermissionChecker;
+    readonly checkPermission?: PermissionChecker | undefined;
 }
 /**
  * DiagnosticActionDispatcher — executes diagnostic entry actions.
@@ -309,7 +309,7 @@ export declare function diagnosticFromAgentFailure(opts: {
 export declare function diagnosticFromToolContractViolation(opts: {
     toolName: string;
     message: string;
-    callId?: string;
+    callId?: string | undefined;
     sessionId: string;
     traceId: string;
     ts: number;