@xopcai/xopc 0.0.6 → 0.0.8

package/dist/src/acp/control-plane/manager.types.d.ts

@@ -1,125 +0,0 @@
-/**
- * ACP Control Plane Types
- *
- * Type definitions for ACP session management.
- */
-import type { Config } from "../../config/schema.js";
-import type { AcpRuntime, AcpRuntimeHandle, AcpRuntimeSessionMode, AcpRuntimeEvent, AcpRuntimeTurnAttachment, AcpRuntimePromptMode, SessionAcpMeta, SessionIdentity, AcpSessionResolution, AcpSessionRuntimeOptions, AcpSessionStatus } from "../runtime/types.js";
-export type { SessionAcpMeta, SessionIdentity, AcpSessionResolution, AcpSessionRuntimeOptions, AcpSessionStatus, };
-/** Session entry (minimal shape to avoid cyclic imports) */
-export type SessionEntry = {
-    sessionId?: string;
-    sessionKey?: string;
-    acp?: SessionAcpMeta;
-    [key: string]: unknown;
-};
-/** ACP Initialize Session Input */
-export type AcpInitializeSessionInput = {
-    cfg: Config;
-    sessionKey: string;
-    agent: string;
-    mode: AcpRuntimeSessionMode;
-    resumeSessionId?: string;
-    cwd?: string;
-    backendId?: string;
-};
-/** ACP Run Turn Input */
-export type AcpRunTurnInput = {
-    cfg: Config;
-    sessionKey: string;
-    text: string;
-    attachments?: AcpRuntimeTurnAttachment[];
-    mode: AcpRuntimePromptMode;
-    requestId: string;
-    signal?: AbortSignal;
-    onEvent?: (event: AcpRuntimeEvent) => Promise<void> | void;
-};
-/** ACP Close Session Input */
-export type AcpCloseSessionInput = {
-    cfg: Config;
-    sessionKey: string;
-    reason: string;
-    requireAcpSession?: boolean;
-    clearMeta?: boolean;
-    allowBackendUnavailable?: boolean;
-};
-/** ACP Close Session Result */
-export type AcpCloseSessionResult = {
-    runtimeClosed: boolean;
-    runtimeNotice?: string;
-    metaCleared: boolean;
-};
-/** Active Turn State */
-export type ActiveTurnState = {
-    runtime: AcpRuntime;
-    handle: AcpRuntimeHandle;
-    abortController: AbortController;
-    cancelPromise?: Promise<void>;
-};
-/** Turn Latency Stats */
-export type TurnLatencyStats = {
-    completed: number;
-    failed: number;
-    totalMs: number;
-    maxMs: number;
-};
-/** ACP Manager Observability Snapshot */
-export type AcpManagerObservabilitySnapshot = {
-    runtimeCache: {
-        activeSessions: number;
-        idleTtlMs: number;
-        evictedTotal: number;
-        lastEvictedAt?: number;
-    };
-    turns: {
-        active: number;
-        queueDepth: number;
-        completed: number;
-        failed: number;
-        averageLatencyMs: number;
-        maxLatencyMs: number;
-    };
-    errorsByCode: Record<string, number>;
-};
-/** ACP Startup Identity Reconcile Result */
-export type AcpStartupIdentityReconcileResult = {
-    checked: number;
-    resolved: number;
-    failed: number;
-};
-/** Session ACP Meta with Entry */
-export type SessionEntryWithAcp = SessionEntry & {
-    acp: SessionAcpMeta;
-};
-/** ACP Session Manager Dependencies */
-export type AcpSessionManagerDeps = {
-    requireRuntimeBackend: (id?: string) => {
-        id: string;
-        runtime: AcpRuntime;
-    };
-    readSessionEntry: (params: {
-        cfg: Config;
-        sessionKey: string;
-    }) => SessionEntry | undefined;
-    upsertSessionMeta: (params: {
-        cfg: Config;
-        sessionKey: string;
-        mutate: (current: SessionAcpMeta | undefined, entry: SessionEntry | undefined) => SessionAcpMeta | null | undefined;
-    }) => Promise<SessionEntry | null>;
-    listAcpSessions: (params: {
-        cfg: Config;
-    }) => Promise<SessionEntry[]>;
-};
-/** Cached Runtime State */
-export type CachedRuntimeState = {
-    runtime: AcpRuntime;
-    handle: AcpRuntimeHandle;
-    backend: string;
-    agent: string;
-    mode: AcpRuntimeSessionMode;
-    cwd?: string;
-    appliedControlSignature?: string;
-    lastTouchedAt: number;
-};
-/** Default Dependencies (will be implemented in manager.ts) */
-export declare const DEFAULT_DEPS: AcpSessionManagerDeps;

package/dist/src/acp/control-plane/manager.types.js

@@ -1,14 +0,0 @@
-//#region src/acp/control-plane/manager.types.ts
-/** Default Dependencies (will be implemented in manager.ts) */
-const DEFAULT_DEPS = {
-	requireRuntimeBackend: () => {
-		throw new Error("ACP runtime backend not configured");
-	},
-	readSessionEntry: () => void 0,
-	upsertSessionMeta: async () => null,
-	listAcpSessions: async () => []
-};
-//#endregion
-export { DEFAULT_DEPS };
-
-//# sourceMappingURL=manager.types.js.map

package/dist/src/acp/control-plane/manager.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"manager.types.js","names":[],"sources":["../../../../src/acp/control-plane/manager.types.ts"],"sourcesContent":["/**\n * ACP Control Plane Types\n * \n * Type definitions for ACP session management.\n */\n\nimport type { Config } from \"../../config/schema.js\";\nimport type {\n  AcpRuntime,\n  AcpRuntimeHandle,\n  AcpRuntimeSessionMode,\n  AcpRuntimeEvent,\n  AcpRuntimeTurnAttachment,\n  AcpRuntimePromptMode,\n  SessionAcpMeta,\n  SessionIdentity,\n  AcpSessionResolution,\n  AcpSessionRuntimeOptions,\n  AcpSessionStatus,\n} from \"../runtime/types.js\";\n\n// Re-export types from runtime for convenience\nexport type {\n  SessionAcpMeta,\n  SessionIdentity,\n  AcpSessionResolution,\n  AcpSessionRuntimeOptions,\n  AcpSessionStatus,\n};\n\n/** Session entry (minimal shape to avoid cyclic imports) */\nexport type SessionEntry = {\n  sessionId?: string;\n  sessionKey?: string;\n  acp?: SessionAcpMeta;\n  [key: string]: unknown;\n};\n\n/** ACP Initialize Session Input */\nexport type AcpInitializeSessionInput = {\n  cfg: Config;\n  sessionKey: string;\n  agent: string;\n  mode: AcpRuntimeSessionMode;\n  resumeSessionId?: string;\n  cwd?: string;\n  backendId?: string;\n};\n\n/** ACP Run Turn Input */\nexport type AcpRunTurnInput = {\n  cfg: Config;\n  sessionKey: string;\n  text: string;\n  attachments?: AcpRuntimeTurnAttachment[];\n  mode: AcpRuntimePromptMode;\n  requestId: string;\n  signal?: AbortSignal;\n  onEvent?: (event: AcpRuntimeEvent) => Promise<void> | void;\n};\n\n/** ACP Close Session Input */\nexport type AcpCloseSessionInput = {\n  cfg: Config;\n  sessionKey: string;\n  reason: string;\n  requireAcpSession?: boolean;\n  clearMeta?: boolean;\n  allowBackendUnavailable?: boolean;\n};\n\n/** ACP Close Session Result */\nexport type AcpCloseSessionResult = {\n  runtimeClosed: boolean;\n  runtimeNotice?: string;\n  metaCleared: boolean;\n};\n\n/** Active Turn State */\nexport type ActiveTurnState = {\n  runtime: AcpRuntime;\n  handle: AcpRuntimeHandle;\n  abortController: AbortController;\n  cancelPromise?: Promise<void>;\n};\n\n/** Turn Latency Stats */\nexport type TurnLatencyStats = {\n  completed: number;\n  failed: number;\n  totalMs: number;\n  maxMs: number;\n};\n\n/** ACP Manager Observability Snapshot */\nexport type AcpManagerObservabilitySnapshot = {\n  runtimeCache: {\n    activeSessions: number;\n    idleTtlMs: number;\n    evictedTotal: number;\n    lastEvictedAt?: number;\n  };\n  turns: {\n    active: number;\n    queueDepth: number;\n    completed: number;\n    failed: number;\n    averageLatencyMs: number;\n    maxLatencyMs: number;\n  };\n  errorsByCode: Record<string, number>;\n};\n\n/** ACP Startup Identity Reconcile Result */\nexport type AcpStartupIdentityReconcileResult = {\n  checked: number;\n  resolved: number;\n  failed: number;\n};\n\n/** Session ACP Meta with Entry */\nexport type SessionEntryWithAcp = SessionEntry & {\n  acp: SessionAcpMeta;\n};\n\n/** ACP Session Manager Dependencies */\nexport type AcpSessionManagerDeps = {\n  requireRuntimeBackend: (id?: string) => { id: string; runtime: AcpRuntime };\n  readSessionEntry: (params: { cfg: Config; sessionKey: string }) => SessionEntry | undefined;\n  upsertSessionMeta: (params: {\n    cfg: Config;\n    sessionKey: string;\n    mutate: (\n      current: SessionAcpMeta | undefined,\n      entry: SessionEntry | undefined,\n    ) => SessionAcpMeta | null | undefined;\n  }) => Promise<SessionEntry | null>;\n  listAcpSessions: (params: { cfg: Config }) => Promise<SessionEntry[]>;\n};\n\n/** Cached Runtime State */\nexport type CachedRuntimeState = {\n  runtime: AcpRuntime;\n  handle: AcpRuntimeHandle;\n  backend: string;\n  agent: string;\n  mode: AcpRuntimeSessionMode;\n  cwd?: string;\n  appliedControlSignature?: string;\n  lastTouchedAt: number;\n};\n\n/** Default Dependencies (will be implemented in manager.ts) */\nexport const DEFAULT_DEPS: AcpSessionManagerDeps = {\n  requireRuntimeBackend: () => {\n    throw new Error(\"ACP runtime backend not configured\");\n  },\n  readSessionEntry: () => undefined,\n  upsertSessionMeta: async () => null,\n  listAcpSessions: async () => [],\n};"],"mappings":";;AAyJA,MAAa,eAAsC;CACjD,6BAA6B;AAC3B,QAAM,IAAI,MAAM,qCAAqC;;CAEvD,wBAAwB,KAAA;CACxB,mBAAmB,YAAY;CAC/B,iBAAiB,YAAY,EAAE;CAChC"}

package/dist/src/acp/control-plane/manager.utils.d.ts

@@ -1,29 +0,0 @@
-/**
- * Manager Utilities
- *
- * Utility functions for ACP session manager.
- */
-import type { Config } from "../../config/schema.js";
-import { AcpRuntimeError } from "../runtime/errors.js";
-import type { SessionAcpMeta, AcpSessionResolution } from "../runtime/types.js";
-export { normalizeAcpErrorCode } from "../runtime/errors.js";
-/** Normalize actor key */
-export declare function normalizeActorKey(sessionKey: string): string;
-/** Normalize session key string */
-export declare function normalizeSessionKey(sessionKey: string): string;
-/** Whether key looks like an ACP session */
-export declare function isAcpSessionKey(sessionKey: string): boolean;
-/** Parse agent id from agent-prefixed session keys */
-export declare function resolveAcpAgentFromSessionKey(sessionKey: string, defaultAgent: string): string;
-/** Resolve idle TTL in ms from config */
-export declare function resolveRuntimeIdleTtlMs(cfg: Config): number;
-/** Require `ready` resolution or throw */
-export declare function requireReadySessionMeta(resolution: AcpSessionResolution): SessionAcpMeta;
-/** Map resolution to a thrown `AcpRuntimeError` */
-export declare function resolveAcpSessionResolutionError(resolution: AcpSessionResolution): AcpRuntimeError;
-/** Error when session meta is missing */
-export declare function resolveMissingMetaError(sessionKey: string): Error;
-/** Re-export */
-export { createUnsupportedControlError } from "../runtime/errors.js";
-/** Re-export text normalizer */
-export { normalizeText } from "./runtime-options.js";

package/dist/src/acp/control-plane/manager.utils.js

@@ -1,46 +0,0 @@
-import { AcpRuntimeError, createUnsupportedControlError, normalizeAcpErrorCode } from "../runtime/errors.js";
-import { normalizeText } from "./runtime-options.js";
-//#region src/acp/control-plane/manager.utils.ts
-/** Normalize actor key */
-function normalizeActorKey(sessionKey) {
-	return sessionKey.trim().toLowerCase();
-}
-/** Normalize session key string */
-function normalizeSessionKey(sessionKey) {
-	return sessionKey.trim();
-}
-/** Whether key looks like an ACP session */
-function isAcpSessionKey(sessionKey) {
-	return sessionKey.includes(":acp:");
-}
-/** Parse agent id from agent-prefixed session keys */
-function resolveAcpAgentFromSessionKey(sessionKey, defaultAgent) {
-	const parts = sessionKey.split(":");
-	if (parts.length >= 2 && parts[0] === "agent") return parts[1];
-	return defaultAgent;
-}
-/** Resolve idle TTL in ms from config */
-function resolveRuntimeIdleTtlMs(cfg) {
-	const ttlMinutes = cfg.acp?.runtime?.ttlMinutes;
-	if (typeof ttlMinutes !== "number" || !Number.isFinite(ttlMinutes)) return 0;
-	return Math.max(0, ttlMinutes * 60 * 1e3);
-}
-/** Require `ready` resolution or throw */
-function requireReadySessionMeta(resolution) {
-	if (resolution.kind !== "ready") throw resolveAcpSessionResolutionError(resolution);
-	return resolution.meta;
-}
-/** Map resolution to a thrown `AcpRuntimeError` */
-function resolveAcpSessionResolutionError(resolution) {
-	if (resolution.kind === "ready") return new AcpRuntimeError("ACP_SESSION_INIT_FAILED", "Session is ready.");
-	if (resolution.kind === "stale") return resolution.error instanceof AcpRuntimeError ? resolution.error : new AcpRuntimeError("ACP_SESSION_INIT_FAILED", resolution.error.message);
-	return new AcpRuntimeError("ACP_SESSION_INIT_FAILED", `ACP session not found: ${resolution.sessionKey}`);
-}
-/** Error when session meta is missing */
-function resolveMissingMetaError(sessionKey) {
-	return new AcpRuntimeError("ACP_SESSION_INIT_FAILED", `ACP session metadata not found for ${sessionKey}`);
-}
-//#endregion
-export { createUnsupportedControlError, isAcpSessionKey, normalizeAcpErrorCode, normalizeActorKey, normalizeSessionKey, normalizeText, requireReadySessionMeta, resolveAcpAgentFromSessionKey, resolveAcpSessionResolutionError, resolveMissingMetaError, resolveRuntimeIdleTtlMs };
-
-//# sourceMappingURL=manager.utils.js.map

package/dist/src/acp/control-plane/manager.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"manager.utils.js","names":[],"sources":["../../../../src/acp/control-plane/manager.utils.ts"],"sourcesContent":["/**\n * Manager Utilities\n * \n * Utility functions for ACP session manager.\n */\n\nimport type { Config } from \"../../config/schema.js\";\nimport { AcpRuntimeError } from \"../runtime/errors.js\";\nimport type { SessionAcpMeta, AcpSessionResolution } from \"../runtime/types.js\";\n\n// Re-export normalizeAcpErrorCode for use in manager\nexport { normalizeAcpErrorCode } from \"../runtime/errors.js\";\n\n/** Normalize actor key */\nexport function normalizeActorKey(sessionKey: string): string {\n  return sessionKey.trim().toLowerCase();\n}\n\n/** Normalize session key string */\nexport function normalizeSessionKey(sessionKey: string): string {\n  return sessionKey.trim();\n}\n\n/** Whether key looks like an ACP session */\nexport function isAcpSessionKey(sessionKey: string): boolean {\n  return sessionKey.includes(\":acp:\");\n}\n\n/** Parse agent id from agent-prefixed session keys */\nexport function resolveAcpAgentFromSessionKey(\n  sessionKey: string,\n  defaultAgent: string,\n): string {\n  // e.g. `agent:<id>:acp:<uuid>`\n  const parts = sessionKey.split(\":\");\n  if (parts.length >= 2 && parts[0] === \"agent\") {\n    return parts[1];\n  }\n  return defaultAgent;\n}\n\n/** Resolve idle TTL in ms from config */\nexport function resolveRuntimeIdleTtlMs(cfg: Config): number {\n  const ttlMinutes = cfg.acp?.runtime?.ttlMinutes;\n  if (typeof ttlMinutes !== \"number\" || !Number.isFinite(ttlMinutes)) {\n    return 0;\n  }\n  return Math.max(0, ttlMinutes * 60 * 1000);\n}\n\n/** Require `ready` resolution or throw */\nexport function requireReadySessionMeta(resolution: AcpSessionResolution): SessionAcpMeta {\n  if (resolution.kind !== \"ready\") {\n    throw resolveAcpSessionResolutionError(resolution);\n  }\n  return resolution.meta;\n}\n\n/** Map resolution to a thrown `AcpRuntimeError` */\nexport function resolveAcpSessionResolutionError(\n  resolution: AcpSessionResolution,\n): AcpRuntimeError {\n  if (resolution.kind === \"ready\") {\n    return new AcpRuntimeError(\"ACP_SESSION_INIT_FAILED\", \"Session is ready.\");\n  }\n  if (resolution.kind === \"stale\") {\n    return resolution.error instanceof AcpRuntimeError\n      ? resolution.error\n      : new AcpRuntimeError(\"ACP_SESSION_INIT_FAILED\", resolution.error.message);\n  }\n  return new AcpRuntimeError(\n    \"ACP_SESSION_INIT_FAILED\",\n    `ACP session not found: ${resolution.sessionKey}`,\n  );\n}\n\n/** Error when session meta is missing */\nexport function resolveMissingMetaError(sessionKey: string): Error {\n  return new AcpRuntimeError(\n    \"ACP_SESSION_INIT_FAILED\",\n    `ACP session metadata not found for ${sessionKey}`,\n  );\n}\n\n/** Re-export */\nexport { createUnsupportedControlError } from \"../runtime/errors.js\";\n\n/** Re-export text normalizer */\nexport { normalizeText } from \"./runtime-options.js\";"],"mappings":";;;;AAcA,SAAgB,kBAAkB,YAA4B;AAC5D,QAAO,WAAW,MAAM,CAAC,aAAa;;;AAIxC,SAAgB,oBAAoB,YAA4B;AAC9D,QAAO,WAAW,MAAM;;;AAI1B,SAAgB,gBAAgB,YAA6B;AAC3D,QAAO,WAAW,SAAS,QAAQ;;;AAIrC,SAAgB,8BACd,YACA,cACQ;CAER,MAAM,QAAQ,WAAW,MAAM,IAAI;AACnC,KAAI,MAAM,UAAU,KAAK,MAAM,OAAO,QACpC,QAAO,MAAM;AAEf,QAAO;;;AAIT,SAAgB,wBAAwB,KAAqB;CAC3D,MAAM,aAAa,IAAI,KAAK,SAAS;AACrC,KAAI,OAAO,eAAe,YAAY,CAAC,OAAO,SAAS,WAAW,CAChE,QAAO;AAET,QAAO,KAAK,IAAI,GAAG,aAAa,KAAK,IAAK;;;AAI5C,SAAgB,wBAAwB,YAAkD;AACxF,KAAI,WAAW,SAAS,QACtB,OAAM,iCAAiC,WAAW;AAEpD,QAAO,WAAW;;;AAIpB,SAAgB,iCACd,YACiB;AACjB,KAAI,WAAW,SAAS,QACtB,QAAO,IAAI,gBAAgB,2BAA2B,oBAAoB;AAE5E,KAAI,WAAW,SAAS,QACtB,QAAO,WAAW,iBAAiB,kBAC/B,WAAW,QACX,IAAI,gBAAgB,2BAA2B,WAAW,MAAM,QAAQ;AAE9E,QAAO,IAAI,gBACT,2BACA,0BAA0B,WAAW,aACtC;;;AAIH,SAAgB,wBAAwB,YAA2B;AACjE,QAAO,IAAI,gBACT,2BACA,sCAAsC,aACvC"}

package/dist/src/acp/control-plane/runtime-cache-manager.d.ts

@@ -1,49 +0,0 @@
-/**
- * Runtime Cache Manager
- *
- * Manages runtime handle caching, eviction, and handle lifecycle.
- */
-import type { Config } from "../../config/schema.js";
-import type { AcpRuntime, AcpRuntimeHandle, SessionAcpMeta } from "../runtime/types.js";
-import type { CachedRuntimeState } from "./manager.types.js";
-export interface RuntimeCacheManagerDeps {
-    persistMeta: (sessionKey: string, meta: SessionAcpMeta) => Promise<void>;
-    enforceConcurrentLimit: (sessionKey: string) => void;
-}
-export declare class RuntimeCacheManager {
-    private readonly deps;
-    private readonly cache;
-    private evictedRuntimeCount;
-    private lastEvictedAt;
-    constructor(deps: RuntimeCacheManagerDeps);
-    /** Get cached runtime state */
-    get(sessionKey: string): CachedRuntimeState | null;
-    /** Check if session is cached */
-    has(sessionKey: string): boolean;
-    /** Get cache size */
-    size(): number;
-    /** Clear cached runtime state */
-    clear(sessionKey: string): void;
-    /** Ensure runtime handle exists (create or reuse cached) */
-    ensureHandle(params: {
-        cfg: Config;
-        sessionKey: string;
-        meta: SessionAcpMeta;
-    }): Promise<{
-        runtime: AcpRuntime;
-        handle: AcpRuntimeHandle;
-        meta: SessionAcpMeta;
-    }>;
-    /** Evict idle runtime handles based on TTL */
-    evictIdle(params: {
-        cfg: Config;
-        hasActiveTurn: (sessionKey: string) => boolean;
-        onEvict: (state: CachedRuntimeState) => Promise<void>;
-    }): Promise<void>;
-    /** Get eviction statistics */
-    getEvictionStats(): {
-        evictedTotal: number;
-        lastEvictedAt?: number;
-    };
-    private set;
-}

package/dist/src/acp/control-plane/runtime-cache-manager.js

@@ -1,155 +0,0 @@
-import { AcpRuntimeError, withAcpRuntimeErrorBoundary } from "../runtime/errors.js";
-import { requireAcpRuntimeBackend } from "../runtime/registry.js";
-import { createIdentityFromEnsure, identityEquals, mergeSessionIdentity, resolveRuntimeHandleIdentifiersFromIdentity, resolveSessionIdentityFromMeta } from "../runtime/session-identity.js";
-import { normalizeRuntimeOptions, normalizeText, resolveRuntimeOptionsFromMeta, runtimeOptionsEqual } from "./runtime-options.js";
-import { normalizeActorKey, normalizeSessionKey, resolveAcpAgentFromSessionKey, resolveRuntimeIdleTtlMs } from "./manager.utils.js";
-import { RuntimeCache } from "./runtime-cache.js";
-//#region src/acp/control-plane/runtime-cache-manager.ts
-var RuntimeCacheManager = class {
-	cache = new RuntimeCache();
-	evictedRuntimeCount = 0;
-	lastEvictedAt;
-	constructor(deps) {
-		this.deps = deps;
-	}
-	/** Get cached runtime state */
-	get(sessionKey) {
-		return this.cache.get(normalizeActorKey(sessionKey));
-	}
-	/** Check if session is cached */
-	has(sessionKey) {
-		return this.cache.has(normalizeActorKey(sessionKey));
-	}
-	/** Get cache size */
-	size() {
-		return this.cache.size();
-	}
-	/** Clear cached runtime state */
-	clear(sessionKey) {
-		this.cache.clear(normalizeActorKey(sessionKey));
-	}
-	/** Ensure runtime handle exists (create or reuse cached) */
-	async ensureHandle(params) {
-		const { cfg, sessionKey, meta } = params;
-		const normalizedKey = normalizeSessionKey(sessionKey);
-		if (!normalizedKey) throw new AcpRuntimeError("ACP_SESSION_INIT_FAILED", "ACP session key is required.");
-		const agent = meta.agent?.trim() || resolveAcpAgentFromSessionKey(normalizedKey, "main");
-		const mode = meta.mode;
-		const runtimeOptions = resolveRuntimeOptionsFromMeta(meta);
-		const cwd = runtimeOptions.cwd ?? normalizeText(meta.cwd);
-		const configuredBackend = (meta.backend || cfg.acp?.backend || "").trim();
-		const cached = this.get(normalizedKey);
-		if (cached) {
-			const backendMatches = !configuredBackend || cached.backend === configuredBackend;
-			const agentMatches = cached.agent === agent;
-			const modeMatches = cached.mode === mode;
-			const cwdMatches = (cached.cwd ?? "") === (cwd ?? "");
-			if (backendMatches && agentMatches && modeMatches && cwdMatches) return {
-				runtime: cached.runtime,
-				handle: cached.handle,
-				meta
-			};
-			this.clear(normalizedKey);
-		}
-		this.deps.enforceConcurrentLimit(normalizedKey);
-		const backend = requireAcpRuntimeBackend(configuredBackend || void 0);
-		const runtime = backend.runtime;
-		const ensured = await withAcpRuntimeErrorBoundary({
-			run: async () => await runtime.ensureSession({
-				sessionKey: normalizedKey,
-				agent,
-				mode,
-				cwd
-			}),
-			fallbackCode: "ACP_SESSION_INIT_FAILED",
-			fallbackMessage: "Could not initialize ACP session runtime."
-		});
-		const previousMeta = meta;
-		const previousIdentity = resolveSessionIdentityFromMeta(previousMeta);
-		const now = Date.now();
-		const effectiveCwd = normalizeText(ensured.cwd) ?? cwd;
-		const nextRuntimeOptions = normalizeRuntimeOptions({
-			...runtimeOptions,
-			...effectiveCwd ? { cwd: effectiveCwd } : {}
-		});
-		const nextIdentity = mergeSessionIdentity({
-			current: previousIdentity,
-			incoming: createIdentityFromEnsure({
-				handle: ensured,
-				now
-			}),
-			now
-		}) ?? previousIdentity;
-		const nextHandleIdentifiers = resolveRuntimeHandleIdentifiersFromIdentity(nextIdentity);
-		const nextHandle = {
-			...ensured,
-			...nextHandleIdentifiers.backendSessionId ? { backendSessionId: nextHandleIdentifiers.backendSessionId } : {},
-			...nextHandleIdentifiers.agentSessionId ? { agentSessionId: nextHandleIdentifiers.agentSessionId } : {}
-		};
-		const nextMeta = {
-			backend: ensured.backend || backend.id,
-			agent,
-			runtimeSessionName: ensured.runtimeSessionName,
-			...nextIdentity ? { identity: nextIdentity } : {},
-			mode: meta.mode,
-			...Object.keys(nextRuntimeOptions).length > 0 ? { runtimeOptions: nextRuntimeOptions } : {},
-			...effectiveCwd ? { cwd: effectiveCwd } : {},
-			state: previousMeta.state,
-			lastActivityAt: now,
-			...previousMeta.lastError ? { lastError: previousMeta.lastError } : {}
-		};
-		if (previousMeta.backend !== nextMeta.backend || previousMeta.runtimeSessionName !== nextMeta.runtimeSessionName || !identityEquals(previousIdentity, nextIdentity) || previousMeta.agent !== nextMeta.agent || previousMeta.cwd !== nextMeta.cwd || !runtimeOptionsEqual(previousMeta.runtimeOptions, nextMeta.runtimeOptions)) await this.deps.persistMeta(normalizedKey, nextMeta);
-		this.set(normalizedKey, {
-			runtime,
-			handle: nextHandle,
-			backend: ensured.backend || backend.id,
-			agent,
-			mode,
-			cwd: effectiveCwd
-		});
-		return {
-			runtime,
-			handle: nextHandle,
-			meta: nextMeta
-		};
-	}
-	/** Evict idle runtime handles based on TTL */
-	async evictIdle(params) {
-		const { cfg, hasActiveTurn, onEvict } = params;
-		const idleTtlMs = resolveRuntimeIdleTtlMs(cfg);
-		if (idleTtlMs <= 0 || this.cache.size() === 0) return;
-		const now = Date.now();
-		const candidates = this.cache.collectIdleCandidates({
-			maxIdleMs: idleTtlMs,
-			now
-		});
-		if (candidates.length === 0) return;
-		for (const candidate of candidates) {
-			if (hasActiveTurn(candidate.actorKey)) continue;
-			const lastTouchedAt = this.cache.getLastTouchedAt(candidate.actorKey);
-			if (lastTouchedAt == null || now - lastTouchedAt < idleTtlMs) continue;
-			const cached = this.cache.peek(candidate.actorKey);
-			if (!cached) continue;
-			this.cache.clear(candidate.actorKey);
-			this.evictedRuntimeCount += 1;
-			this.lastEvictedAt = Date.now();
-			try {
-				await onEvict(cached);
-			} catch {}
-		}
-	}
-	/** Get eviction statistics */
-	getEvictionStats() {
-		return {
-			evictedTotal: this.evictedRuntimeCount,
-			lastEvictedAt: this.lastEvictedAt
-		};
-	}
-	set(sessionKey, state) {
-		this.cache.set(normalizeActorKey(sessionKey), state);
-	}
-};
-//#endregion
-export { RuntimeCacheManager };
-
-//# sourceMappingURL=runtime-cache-manager.js.map

package/dist/src/acp/control-plane/runtime-cache-manager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtime-cache-manager.js","names":[],"sources":["../../../../src/acp/control-plane/runtime-cache-manager.ts"],"sourcesContent":["/**\n * Runtime Cache Manager\n * \n * Manages runtime handle caching, eviction, and handle lifecycle.\n */\n\nimport type { Config } from \"../../config/schema.js\";\nimport { AcpRuntimeError, withAcpRuntimeErrorBoundary } from \"../runtime/errors.js\";\nimport {\n  createIdentityFromEnsure,\n  identityEquals,\n  mergeSessionIdentity,\n  resolveRuntimeHandleIdentifiersFromIdentity,\n  resolveSessionIdentityFromMeta,\n} from \"../runtime/session-identity.js\";\nimport type { AcpRuntime, AcpRuntimeHandle, SessionAcpMeta } from \"../runtime/types.js\";\nimport { requireAcpRuntimeBackend } from \"../runtime/registry.js\";\nimport type { CachedRuntimeState } from \"./manager.types.js\";\nimport { RuntimeCache } from \"./runtime-cache.js\";\nimport {\n  normalizeActorKey,\n  normalizeSessionKey,\n  normalizeText,\n  resolveAcpAgentFromSessionKey,\n  resolveRuntimeIdleTtlMs,\n} from \"./manager.utils.js\";\nimport {\n  normalizeRuntimeOptions,\n  resolveRuntimeOptionsFromMeta,\n  runtimeOptionsEqual,\n} from \"./runtime-options.js\";\n\nexport interface RuntimeCacheManagerDeps {\n  persistMeta: (sessionKey: string, meta: SessionAcpMeta) => Promise<void>;\n  enforceConcurrentLimit: (sessionKey: string) => void;\n}\n\nexport class RuntimeCacheManager {\n  private readonly cache = new RuntimeCache();\n  private evictedRuntimeCount = 0;\n  private lastEvictedAt: number | undefined;\n\n  constructor(private readonly deps: RuntimeCacheManagerDeps) {}\n\n  /** Get cached runtime state */\n  get(sessionKey: string): CachedRuntimeState | null {\n    return this.cache.get(normalizeActorKey(sessionKey));\n  }\n\n  /** Check if session is cached */\n  has(sessionKey: string): boolean {\n    return this.cache.has(normalizeActorKey(sessionKey));\n  }\n\n  /** Get cache size */\n  size(): number {\n    return this.cache.size();\n  }\n\n  /** Clear cached runtime state */\n  clear(sessionKey: string): void {\n    this.cache.clear(normalizeActorKey(sessionKey));\n  }\n\n  /** Ensure runtime handle exists (create or reuse cached) */\n  async ensureHandle(params: {\n    cfg: Config;\n    sessionKey: string;\n    meta: SessionAcpMeta;\n  }): Promise<{ runtime: AcpRuntime; handle: AcpRuntimeHandle; meta: SessionAcpMeta }> {\n    const { cfg, sessionKey, meta } = params;\n    const normalizedKey = normalizeSessionKey(sessionKey);\n    if (!normalizedKey) {\n      throw new AcpRuntimeError(\"ACP_SESSION_INIT_FAILED\", \"ACP session key is required.\");\n    }\n\n    const agent = meta.agent?.trim() || resolveAcpAgentFromSessionKey(normalizedKey, \"main\");\n    const mode = meta.mode;\n    const runtimeOptions = resolveRuntimeOptionsFromMeta(meta);\n    const cwd = runtimeOptions.cwd ?? normalizeText(meta.cwd);\n    const configuredBackend = (meta.backend || cfg.acp?.backend || \"\").trim();\n\n    // Check cache first\n    const cached = this.get(normalizedKey);\n    if (cached) {\n      const backendMatches = !configuredBackend || cached.backend === configuredBackend;\n      const agentMatches = cached.agent === agent;\n      const modeMatches = cached.mode === mode;\n      const cwdMatches = (cached.cwd ?? \"\") === (cwd ?? \"\");\n\n      if (backendMatches && agentMatches && modeMatches && cwdMatches) {\n        return { runtime: cached.runtime, handle: cached.handle, meta };\n      }\n      this.clear(normalizedKey);\n    }\n\n    this.deps.enforceConcurrentLimit(normalizedKey);\n\n    const backend = requireAcpRuntimeBackend(configuredBackend || undefined);\n    const runtime = backend.runtime;\n\n    const ensured = await withAcpRuntimeErrorBoundary({\n      run: async () =>\n        await runtime.ensureSession({\n          sessionKey: normalizedKey,\n          agent,\n          mode,\n          cwd,\n        }),\n      fallbackCode: \"ACP_SESSION_INIT_FAILED\",\n      fallbackMessage: \"Could not initialize ACP session runtime.\",\n    });\n\n    const previousMeta = meta;\n    const previousIdentity = resolveSessionIdentityFromMeta(previousMeta);\n    const now = Date.now();\n    const effectiveCwd = normalizeText(ensured.cwd) ?? cwd;\n    const nextRuntimeOptions = normalizeRuntimeOptions({\n      ...runtimeOptions,\n      ...(effectiveCwd ? { cwd: effectiveCwd } : {}),\n    });\n\n    const nextIdentity =\n      mergeSessionIdentity({\n        current: previousIdentity,\n        incoming: createIdentityFromEnsure({ handle: ensured, now }),\n        now,\n      }) ?? previousIdentity;\n\n    const nextHandleIdentifiers = resolveRuntimeHandleIdentifiersFromIdentity(nextIdentity);\n    const nextHandle: AcpRuntimeHandle = {\n      ...ensured,\n      ...(nextHandleIdentifiers.backendSessionId\n        ? { backendSessionId: nextHandleIdentifiers.backendSessionId }\n        : {}),\n      ...(nextHandleIdentifiers.agentSessionId\n        ? { agentSessionId: nextHandleIdentifiers.agentSessionId }\n        : {}),\n    };\n\n    const nextMeta: SessionAcpMeta = {\n      backend: ensured.backend || backend.id,\n      agent,\n      runtimeSessionName: ensured.runtimeSessionName,\n      ...(nextIdentity ? { identity: nextIdentity } : {}),\n      mode: meta.mode,\n      ...(Object.keys(nextRuntimeOptions).length > 0 ? { runtimeOptions: nextRuntimeOptions } : {}),\n      ...(effectiveCwd ? { cwd: effectiveCwd } : {}),\n      state: previousMeta.state,\n      lastActivityAt: now,\n      ...(previousMeta.lastError ? { lastError: previousMeta.lastError } : {}),\n    };\n\n    const shouldPersistMeta =\n      previousMeta.backend !== nextMeta.backend ||\n      previousMeta.runtimeSessionName !== nextMeta.runtimeSessionName ||\n      !identityEquals(previousIdentity, nextIdentity) ||\n      previousMeta.agent !== nextMeta.agent ||\n      previousMeta.cwd !== nextMeta.cwd ||\n      !runtimeOptionsEqual(previousMeta.runtimeOptions, nextMeta.runtimeOptions);\n\n    if (shouldPersistMeta) {\n      await this.deps.persistMeta(normalizedKey, nextMeta);\n    }\n\n    this.set(normalizedKey, {\n      runtime,\n      handle: nextHandle,\n      backend: ensured.backend || backend.id,\n      agent,\n      mode,\n      cwd: effectiveCwd,\n    });\n\n    return { runtime, handle: nextHandle, meta: nextMeta };\n  }\n\n  /** Evict idle runtime handles based on TTL */\n  async evictIdle(params: {\n    cfg: Config;\n    hasActiveTurn: (sessionKey: string) => boolean;\n    onEvict: (state: CachedRuntimeState) => Promise<void>;\n  }): Promise<void> {\n    const { cfg, hasActiveTurn, onEvict } = params;\n    const idleTtlMs = resolveRuntimeIdleTtlMs(cfg);\n    if (idleTtlMs <= 0 || this.cache.size() === 0) {\n      return;\n    }\n\n    const now = Date.now();\n    const candidates = this.cache.collectIdleCandidates({ maxIdleMs: idleTtlMs, now });\n\n    if (candidates.length === 0) return;\n\n    for (const candidate of candidates) {\n      if (hasActiveTurn(candidate.actorKey)) continue;\n\n      const lastTouchedAt = this.cache.getLastTouchedAt(candidate.actorKey);\n      if (lastTouchedAt == null || now - lastTouchedAt < idleTtlMs) continue;\n\n      const cached = this.cache.peek(candidate.actorKey);\n      if (!cached) continue;\n\n      this.cache.clear(candidate.actorKey);\n      this.evictedRuntimeCount += 1;\n      this.lastEvictedAt = Date.now();\n\n      try {\n        await onEvict(cached);\n      } catch {\n        // Ignore close errors\n      }\n    }\n  }\n\n  /** Get eviction statistics */\n  getEvictionStats(): { evictedTotal: number; lastEvictedAt?: number } {\n    return {\n      evictedTotal: this.evictedRuntimeCount,\n      lastEvictedAt: this.lastEvictedAt,\n    };\n  }\n\n  private set(\n    sessionKey: string,\n    state: Omit<CachedRuntimeState, \"lastTouchedAt\">,\n  ): void {\n    this.cache.set(normalizeActorKey(sessionKey), state);\n  }\n}\n"],"mappings":"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"}

package/dist/src/acp/control-plane/runtime-cache.d.ts

@@ -1,45 +0,0 @@
-/**
- * Runtime Cache
- *
- * Caches active runtime handles for ACP sessions.
- */
-import type { AcpRuntime, AcpRuntimeHandle, AcpRuntimeSessionMode } from "../runtime/types.js";
-/** Cached Runtime State */
-export type CachedRuntimeState = {
-    runtime: AcpRuntime;
-    handle: AcpRuntimeHandle;
-    backend: string;
-    agent: string;
-    mode: AcpRuntimeSessionMode;
-    cwd?: string;
-    appliedControlSignature?: string;
-    lastTouchedAt: number;
-};
-export declare class RuntimeCache {
-    private readonly cache;
-    private readonly lastTouchedAt;
-    /** Get cached runtime state */
-    get(actorKey: string): CachedRuntimeState | null;
-    /** Set cached runtime state */
-    set(actorKey: string, state: Omit<CachedRuntimeState, "lastTouchedAt">): void;
-    /** Check if cache has entry */
-    has(actorKey: string): boolean;
-    /** Clear cache entry */
-    clear(actorKey: string): void;
-    /** Get cache size */
-    size(): number;
-    /** Peek at cache entry without updating touch time */
-    peek(actorKey: string): CachedRuntimeState | null;
-    /** Get last touched time */
-    getLastTouchedAt(actorKey: string): number | undefined;
-    /** Collect idle candidates for eviction */
-    collectIdleCandidates(params: {
-        maxIdleMs: number;
-        now: number;
-    }): Array<{
-        actorKey: string;
-        state: CachedRuntimeState;
-    }>;
-    /** Clear all entries */
-    clearAll(): void;
-}

package/dist/src/acp/control-plane/runtime-cache.js

@@ -1,58 +0,0 @@
-//#region src/acp/control-plane/runtime-cache.ts
-var RuntimeCache = class {
-	cache = /* @__PURE__ */ new Map();
-	lastTouchedAt = /* @__PURE__ */ new Map();
-	/** Get cached runtime state */
-	get(actorKey) {
-		return this.cache.get(actorKey) ?? null;
-	}
-	/** Set cached runtime state */
-	set(actorKey, state) {
-		const now = Date.now();
-		this.cache.set(actorKey, {
-			...state,
-			lastTouchedAt: now
-		});
-		this.lastTouchedAt.set(actorKey, now);
-	}
-	/** Check if cache has entry */
-	has(actorKey) {
-		return this.cache.has(actorKey);
-	}
-	/** Clear cache entry */
-	clear(actorKey) {
-		this.cache.delete(actorKey);
-		this.lastTouchedAt.delete(actorKey);
-	}
-	/** Get cache size */
-	size() {
-		return this.cache.size;
-	}
-	/** Peek at cache entry without updating touch time */
-	peek(actorKey) {
-		return this.cache.get(actorKey) ?? null;
-	}
-	/** Get last touched time */
-	getLastTouchedAt(actorKey) {
-		return this.lastTouchedAt.get(actorKey);
-	}
-	/** Collect idle candidates for eviction */
-	collectIdleCandidates(params) {
-		const { maxIdleMs, now } = params;
-		const candidates = [];
-		for (const [actorKey, state] of this.cache) if (now - (this.lastTouchedAt.get(actorKey) ?? state.lastTouchedAt) >= maxIdleMs) candidates.push({
-			actorKey,
-			state
-		});
-		return candidates;
-	}
-	/** Clear all entries */
-	clearAll() {
-		this.cache.clear();
-		this.lastTouchedAt.clear();
-	}
-};
-//#endregion
-export { RuntimeCache };
-
-//# sourceMappingURL=runtime-cache.js.map

package/dist/src/acp/control-plane/runtime-cache.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtime-cache.js","names":[],"sources":["../../../../src/acp/control-plane/runtime-cache.ts"],"sourcesContent":["/**\n * Runtime Cache\n * \n * Caches active runtime handles for ACP sessions.\n */\n\nimport type { AcpRuntime, AcpRuntimeHandle, AcpRuntimeSessionMode } from \"../runtime/types.js\";\n\n/** Cached Runtime State */\nexport type CachedRuntimeState = {\n  runtime: AcpRuntime;\n  handle: AcpRuntimeHandle;\n  backend: string;\n  agent: string;\n  mode: AcpRuntimeSessionMode;\n  cwd?: string;\n  appliedControlSignature?: string;\n  lastTouchedAt: number;\n};\n\nexport class RuntimeCache {\n  private readonly cache = new Map<string, CachedRuntimeState>();\n  private readonly lastTouchedAt = new Map<string, number>();\n\n  /** Get cached runtime state */\n  get(actorKey: string): CachedRuntimeState | null {\n    return this.cache.get(actorKey) ?? null;\n  }\n\n  /** Set cached runtime state */\n  set(actorKey: string, state: Omit<CachedRuntimeState, \"lastTouchedAt\">): void {\n    const now = Date.now();\n    this.cache.set(actorKey, {\n      ...state,\n      lastTouchedAt: now,\n    });\n    this.lastTouchedAt.set(actorKey, now);\n  }\n\n  /** Check if cache has entry */\n  has(actorKey: string): boolean {\n    return this.cache.has(actorKey);\n  }\n\n  /** Clear cache entry */\n  clear(actorKey: string): void {\n    this.cache.delete(actorKey);\n    this.lastTouchedAt.delete(actorKey);\n  }\n\n  /** Get cache size */\n  size(): number {\n    return this.cache.size;\n  }\n\n  /** Peek at cache entry without updating touch time */\n  peek(actorKey: string): CachedRuntimeState | null {\n    return this.cache.get(actorKey) ?? null;\n  }\n\n  /** Get last touched time */\n  getLastTouchedAt(actorKey: string): number | undefined {\n    return this.lastTouchedAt.get(actorKey);\n  }\n\n  /** Collect idle candidates for eviction */\n  collectIdleCandidates(params: {\n    maxIdleMs: number;\n    now: number;\n  }): Array<{ actorKey: string; state: CachedRuntimeState }> {\n    const { maxIdleMs, now } = params;\n    const candidates: Array<{ actorKey: string; state: CachedRuntimeState }> = [];\n    \n    for (const [actorKey, state] of this.cache) {\n      const lastTouched = this.lastTouchedAt.get(actorKey) ?? state.lastTouchedAt;\n      if (now - lastTouched >= maxIdleMs) {\n        candidates.push({ actorKey, state });\n      }\n    }\n    \n    return candidates;\n  }\n\n  /** Clear all entries */\n  clearAll(): void {\n    this.cache.clear();\n    this.lastTouchedAt.clear();\n  }\n}"],"mappings":";AAoBA,IAAa,eAAb,MAA0B;CACxB,wBAAyB,IAAI,KAAiC;CAC9D,gCAAiC,IAAI,KAAqB;;CAG1D,IAAI,UAA6C;AAC/C,SAAO,KAAK,MAAM,IAAI,SAAS,IAAI;;;CAIrC,IAAI,UAAkB,OAAwD;EAC5E,MAAM,MAAM,KAAK,KAAK;AACtB,OAAK,MAAM,IAAI,UAAU;GACvB,GAAG;GACH,eAAe;GAChB,CAAC;AACF,OAAK,cAAc,IAAI,UAAU,IAAI;;;CAIvC,IAAI,UAA2B;AAC7B,SAAO,KAAK,MAAM,IAAI,SAAS;;;CAIjC,MAAM,UAAwB;AAC5B,OAAK,MAAM,OAAO,SAAS;AAC3B,OAAK,cAAc,OAAO,SAAS;;;CAIrC,OAAe;AACb,SAAO,KAAK,MAAM;;;CAIpB,KAAK,UAA6C;AAChD,SAAO,KAAK,MAAM,IAAI,SAAS,IAAI;;;CAIrC,iBAAiB,UAAsC;AACrD,SAAO,KAAK,cAAc,IAAI,SAAS;;;CAIzC,sBAAsB,QAGqC;EACzD,MAAM,EAAE,WAAW,QAAQ;EAC3B,MAAM,aAAqE,EAAE;AAE7E,OAAK,MAAM,CAAC,UAAU,UAAU,KAAK,MAEnC,KAAI,OADgB,KAAK,cAAc,IAAI,SAAS,IAAI,MAAM,kBACrC,UACvB,YAAW,KAAK;GAAE;GAAU;GAAO,CAAC;AAIxC,SAAO;;;CAIT,WAAiB;AACf,OAAK,MAAM,OAAO;AAClB,OAAK,cAAc,OAAO"}

package/dist/src/acp/control-plane/runtime-options.d.ts

@@ -1,30 +0,0 @@
-/**
- * Runtime Options
- *
- * Utilities for managing ACP runtime options.
- */
-import type { AcpSessionRuntimeOptions, SessionAcpMeta } from "../runtime/types.js";
-/** Normalize optional string */
-export declare function normalizeText(value: unknown): string | undefined;
-/** Normalize runtime options object */
-export declare function normalizeRuntimeOptions(options: Partial<AcpSessionRuntimeOptions> | undefined): AcpSessionRuntimeOptions;
-/** Merge runtime option patches */
-export declare function mergeRuntimeOptions(params: {
-    current: AcpSessionRuntimeOptions | undefined;
-    patch: Partial<AcpSessionRuntimeOptions>;
-}): AcpSessionRuntimeOptions;
-/** Shallow equality for runtime options */
-export declare function runtimeOptionsEqual(a: AcpSessionRuntimeOptions | undefined, b: AcpSessionRuntimeOptions | undefined): boolean;
-/** Options from session meta */
-export declare function resolveRuntimeOptionsFromMeta(meta: SessionAcpMeta): AcpSessionRuntimeOptions;
-/** Validate non-empty runtime mode string */
-export declare function validateRuntimeModeInput(mode: string): string;
-/** Validate config option key/value pair */
-export declare function validateRuntimeConfigOptionInput(key: string, value: string): {
-    key: string;
-    value: string;
-};
-/** Validate a partial runtime options patch */
-export declare function validateRuntimeOptionPatch(patch: Partial<AcpSessionRuntimeOptions>): Partial<AcpSessionRuntimeOptions>;
-/** Map a single config key/value to a runtime options patch */
-export declare function inferRuntimeOptionPatchFromConfigOption(key: string, value: string): Partial<AcpSessionRuntimeOptions>;