@xopcai/xopc 0.0.110 → 0.0.112

package/dist/src/agent/agent-manager.js

@@ -1,16 +1,16 @@
-import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
-import { applyConfigOverrides } from "../config/runtime-overrides.js";
 import { resolveStateDir } from "../config/paths-state.js";
 import { expandWorkspacePathString, init_workspace_path } from "../config/workspace-path.js";
 import { init_agent_scope, resolveAgentProfileDir } from "./agent-scope.js";
-import { resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
+import { init_paths, resolveBundledSkillsDir } from "../config/paths.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_paths, resolveBundledSkillsDir } from "../config/paths.js";
-import { init_sync_provider_auth, resolveProviderApiKeySync } from "../auth/sync-provider-auth.js";
 import { CredentialResolver, init_credentials } from "../auth/credentials.js";
+import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
+import { init_sync_provider_auth, resolveProviderApiKeySync } from "../auth/sync-provider-auth.js";
 import { getApiKeySync, getDefaultModelSync, init_providers, resolveModel } from "../providers/index.js";
 import { createExtensionAwareStreamFn } from "../providers/extension-stream-bridge.js";
+import { applyConfigOverrides } from "../config/runtime-overrides.js";
+import { resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { extractTextContent, loadProfileMarkdownFiles } from "./context/workspace.js";
 import { clearBootstrapSnapshot } from "./bootstrap/bootstrap-cache.js";
 import { resolveBootstrapContextSync } from "./bootstrap/bootstrap-files.js";
@@ -28,8 +28,9 @@ import { MemoryPrefetchCoordinator } from "./memory/prefetch-coordinator.js";
 import { WorkspaceRuntimeRegistry } from "./workspace-runtime/registry.js";
 import { BackgroundReviewCoordinator } from "./background-review/coordinator.js";
 import { maybeRequestChannelExecApproval } from "../channels/exec-approval-runtime.js";
-import { Agent } from "@earendil-works/pi-agent-core";
+import { SkillFilesystemWatcher } from "./skills/filesystem-watcher.js";
 import { basename, resolve, sep } from "node:path";
+import { Agent } from "@earendil-works/pi-agent-core";
 //#region src/agent/agent-manager.ts
 /**
 * Agent Manager - Manages Agent instances per session
@@ -64,12 +65,26 @@ var AgentManager = class {
 	workspaceRuntimes;
 	memoryPrefetch;
 	backgroundReview;
+	skillFilesystemWatcher;
+	skillDiskRefreshInProgress = false;
+	skillDiskRefreshPending = false;
+	lastExplicitSkillDiskRefreshAt = 0;
+	skillsUpdatedTimer;
+	pendingSkillsUpdatedReason;
 	constructor(config) {
 		this.config = config;
 		this.baseWorkspacePath = this.computeBaseWorkspacePath();
+		this.skillFilesystemWatcher = new SkillFilesystemWatcher({ onChange: (event) => {
+			log.info({ changedPath: event.changedPath }, "Skill filesystem changed; refreshing skills");
+			this.refreshSkillsAfterDiskChange("watch");
+		} });
+		this.skillFilesystemWatcher.refreshPrimaryWorkspace(this.baseWorkspacePath);
 		this.workspaceRuntimes = new WorkspaceRuntimeRegistry({
 			getConfig: () => this.config.config,
-			bundledSkillsDir: resolveBundledSkillsDir()
+			bundledSkillsDir: resolveBundledSkillsDir(),
+			onRuntimeCreated: (resolvedPath) => {
+				this.skillFilesystemWatcher.watchWorkspace(resolvedPath);
+			}
 		});
 		this.memoryPrefetch = new MemoryPrefetchCoordinator({
 			getConfig: () => this.config.config,
@@ -78,7 +93,7 @@ var AgentManager = class {
 		});
 		this.backgroundReview = new BackgroundReviewCoordinator({
 			getConfig: () => this.mergedConfig(),
-			onSkillsFilesystemMutate: () => this.refreshSkillsAfterDiskChange()
+			onSkillsFilesystemMutate: () => this.refreshSkillsAfterDiskChange("explicit")
 		});
 		this.toolsFactory = new AgentToolsFactory(this.buildToolsFactoryDeps());
 		this.defaultModel = config.model || getDefaultModelSync(config.config);
@@ -152,6 +167,7 @@ var AgentManager = class {
 		this.config.model = ref;
 		this.defaultModel = ref || getDefaultModelSync(config);
 		this.baseWorkspacePath = this.computeBaseWorkspacePath();
+		this.skillFilesystemWatcher.refreshPrimaryWorkspace(this.baseWorkspacePath);
 		this.toolsFactory.shutdownBrowser();
 		this.workspaceRuntimes.clearAll();
 	}
@@ -185,7 +201,7 @@ var AgentManager = class {
 				};
 			},
 			onSkillsFilesystemMutate: () => {
-				this.refreshSkillsAfterDiskChange();
+				this.refreshSkillsAfterDiskChange("explicit");
 			},
 			getSkillPassthroughEnvVarNames: () => {
 				const ctx = this.config.getCurrentContext?.();
@@ -313,9 +329,19 @@ var AgentManager = class {
 		};
 	}
 	getSkillCatalog() {
+		return this.getSkillCatalogSnapshot().catalog;
+	}
+	getSkillCatalogSnapshot() {
 		const skillsConfig = createSkillConfigManager(resolveStateDir()).load();
 		const lock = loadSkillsLock();
-		return this.workspaceRuntimes.getOrCreate(this.baseWorkspacePath).skillManager.getSkills().map((s) => this.skillCatalogEntryFromSkill(s, skillsConfig, lock));
+		const rt = this.workspaceRuntimes.getOrCreate(this.baseWorkspacePath);
+		return {
+			catalog: rt.skillManager.getSkills().map((s) => this.skillCatalogEntryFromSkill(s, skillsConfig, lock)),
+			version: rt.skillManager.getVersion(),
+			loadedAt: rt.skillManager.getLoadedAt(),
+			diagnostics: rt.skillManager.getDiagnostics(),
+			status: rt.skillManager.getStatus()
+		};
 	}
 	getAgentSkillAvailability(agentId) {
 		const cfg = this.config.config;
@@ -340,6 +366,10 @@ var AgentManager = class {
 		});
 		return {
 			agentId: profile.agentId,
+			version: rt.skillManager.getVersion(),
+			loadedAt: rt.skillManager.getLoadedAt(),
+			diagnostics: rt.skillManager.getDiagnostics(),
+			status: rt.skillManager.getStatus(),
 			...defaultsAllowlist !== void 0 ? { defaultsAllowlist: [...defaultsAllowlist] } : {},
 			...entry?.skills !== void 0 ? { agentAllowlist: [...entry.skills] } : {},
 			...profile.skillsAllowlist !== void 0 ? { effectiveAllowlist: [...profile.skillsAllowlist] } : {},
@@ -352,6 +382,10 @@ var AgentManager = class {
 	refreshSkillsAfterSkillConfigChange() {
 		const cfg = this.config.config;
 		const touched = /* @__PURE__ */ new Set();
+		for (const [resolvedPath, rt] of this.workspaceRuntimes.entries()) {
+			rt.skillManager.refreshPromptFromConfig();
+			touched.add(resolvedPath);
+		}
 		for (const instance of this.agents.values()) {
 			const rt = this.workspaceRuntimes.getOrCreate(instance.resolvedWorkspacePath);
 			if (!touched.has(instance.resolvedWorkspacePath)) {
@@ -374,11 +408,46 @@ var AgentManager = class {
 			instance.agent.state.systemPrompt = newPrompt;
 		}
 		log.info({ agents: this.agents.size }, "Skill toggles applied; system prompt updated");
+		this.scheduleSkillsUpdated("config");
 	}
 	/**
 	* Reload skills from disk and refresh system prompt on all active Agent instances.
 	*/
-	refreshSkillsAfterDiskChange() {
+	refreshSkillsAfterDiskChange(source = "explicit") {
+		const now = Date.now();
+		if (source === "watch" && now - this.lastExplicitSkillDiskRefreshAt < 2500) {
+			log.debug({ changedWithinMs: now - this.lastExplicitSkillDiskRefreshAt }, "Ignoring skill watcher echo after explicit refresh");
+			return;
+		}
+		if (source === "explicit") this.lastExplicitSkillDiskRefreshAt = now;
+		if (this.skillDiskRefreshInProgress) {
+			this.skillDiskRefreshPending = true;
+			return;
+		}
+		this.skillDiskRefreshInProgress = true;
+		let refreshed = false;
+		try {
+			do {
+				this.skillDiskRefreshPending = false;
+				this.applySkillsAfterDiskChange();
+				refreshed = true;
+			} while (this.skillDiskRefreshPending);
+		} finally {
+			this.skillDiskRefreshInProgress = false;
+		}
+		if (refreshed) this.scheduleSkillsUpdated("disk");
+	}
+	scheduleSkillsUpdated(reason) {
+		this.pendingSkillsUpdatedReason = reason === "disk" ? "disk" : this.pendingSkillsUpdatedReason ?? "config";
+		if (this.skillsUpdatedTimer) clearTimeout(this.skillsUpdatedTimer);
+		this.skillsUpdatedTimer = setTimeout(() => {
+			const nextReason = this.pendingSkillsUpdatedReason ?? reason;
+			this.pendingSkillsUpdatedReason = void 0;
+			this.skillsUpdatedTimer = void 0;
+			this.config.onSkillsUpdated?.({ reason: nextReason });
+		}, 250);
+	}
+	applySkillsAfterDiskChange() {
 		const cfg = this.config.config;
 		for (const rt of this.workspaceRuntimes.values()) rt.skillManager.reload();
 		const touched = /* @__PURE__ */ new Set();
@@ -538,6 +607,8 @@ var AgentManager = class {
 	* Dispose all agents
 	*/
 	dispose() {
+		if (this.skillsUpdatedTimer) clearTimeout(this.skillsUpdatedTimer);
+		this.skillFilesystemWatcher.dispose();
 		this.toolsFactory.shutdownBrowser();
 		disposeAllSessionMcpRuntimes().catch(() => {});
 		evictAllEmbeddedSessionRunners("agent_manager_dispose");

package/dist/src/agent/agent-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-manager.js","names":[],"sources":["../../../src/agent/agent-manager.ts"],"sourcesContent":["/**\n * Agent Manager - Manages Agent instances per session\n *\n * Each session gets its own Agent instance for true isolation\n * and concurrent processing across sessions.\n */\n\nimport {\n  Agent,\n  type AgentMessage,\n  type AgentEvent,\n  type ThinkingLevel,\n} from '@earendil-works/pi-agent-core';\nimport type { Model, Api } from '@earendil-works/pi-ai';\nimport type { AgentInstanceGateway } from './agent-instance-gateway.js';\nimport { type Config, getAgentDefaultModelRef } from '../config/schema.js';\nimport { applyConfigOverrides } from '../config/runtime-overrides.js';\nimport { resolveAgentProfileDir } from './agent-scope.js';\nimport {\n  type EffectiveAgentProfile,\n  resolveEffectiveAgentProfile,\n  resolveEffectiveAgentProfileForSession,\n} from '../config/agent-profile.js';\nimport { expandWorkspacePathString } from '../config/workspace-path.js';\nimport type { ModelManager } from './models/manager.js';\nimport { createLogger } from '../utils/logger.js';\nimport { resolveProviderApiKeySync } from '../auth/sync-provider-auth.js';\nimport { resolveModel, getDefaultModelSync, getApiKeySync } from '../providers/index.js';\nimport { createExtensionAwareStreamFn } from '../providers/extension-stream-bridge.js';\nimport { CredentialResolver } from '../auth/credentials.js';\nimport { resolveBundledSkillsDir, resolveStateDir } from '../config/paths.js';\nimport { loadProfileMarkdownFiles, extractTextContent } from './context/workspace.js';\nimport { clearBootstrapSnapshot, resolveBootstrapContextSync } from './bootstrap/bootstrap-files.js';\nimport type { EmbeddedContextFile } from './bootstrap/types.js';\nimport { AgentToolsFactory } from './tools/factory.js';\nimport { parseMcpToolName } from './mcp/bundle-mcp-policy.js';\nimport {\n  disposeAllSessionMcpRuntimes,\n  retireSessionMcpRuntimeForSessionKey,\n} from './mcp/bundle-mcp-tools.js';\nimport { evictAllEmbeddedSessionRunners, evictEmbeddedSessionRunner } from './embedded/session-runner.js';\nimport type { GatewayClarifyRequestFn } from './tools/clarify-tool.js';\nimport type { ExtensionRegistryImpl as ExtensionRegistry } from '../extensions/index.js';\nimport type { MessageBus } from '../infra/bus/index.js';\nimport type { CronService } from '../cron/index.js';\nimport type { SessionStore } from '../session/store.js';\nimport { isValidSkillEnvVarName } from './skills/required-env-vars.js';\nimport type { SessionContext } from './session/session-context.js';\nimport type { Skill, SkillMarkdownPreviewPayload } from './skills/types.js';\nimport { createSkillConfigManager, isSkillEnabled, resolveSkillConfig } from './skills/config.js';\nimport { isUnderManagedSkillsDir } from './skills/managed-store.js';\nimport { loadSkillsLock, type SkillHubLockEntry } from './skills/hub-lock.js';\nimport { basename, resolve, sep } from 'node:path';\n\nimport {\n  isMemorySubsystemEnabled,\n  shouldRegisterCuratedMemoryTool,\n} from './memory/memory-config.js';\nimport type { MemoryManager } from './memory/manager.js';\nimport { MemoryPrefetchCoordinator } from './memory/prefetch-coordinator.js';\nimport { WorkspaceRuntimeRegistry, type WorkspaceRuntime } from './workspace-runtime/registry.js';\nimport { BackgroundReviewCoordinator } from './background-review/coordinator.js';\nimport { maybeRequestChannelExecApproval } from '../channels/exec-approval-runtime.js';\n\nconst log = createLogger('AgentManager');\n\nexport interface SkillCatalogEntry {\n  directoryId: string;\n  name: string;\n  description: string;\n  category?: string;\n  source: Skill['source'];\n  path: string;\n  managed: boolean;\n  /** User toggle in ~/.xopc/skills.json (`entries[name].enabled`). Default true. */\n  enabled: boolean;\n  /** When true, skill is never injected into `<available_skills>` (SKILL.md frontmatter). */\n  disableModelInvocation: boolean;\n  /** Hub install provenance when under ~/.xopc/skills and listed in skills-lock.json. */\n  hub?: SkillHubLockEntry;\n}\n\nexport type AgentSkillUnavailableReason = 'agent-denied' | 'disabled' | 'requirements-unmet' | 'model-invocation-disabled';\n\nexport interface AgentSkillAvailabilityEntry extends SkillCatalogEntry {\n  availableForCurrentAgent: boolean;\n  unavailableReason: AgentSkillUnavailableReason | null;\n}\n\nexport interface AgentSkillAvailabilityPayload {\n  agentId: string;\n  defaultsAllowlist?: string[];\n  agentAllowlist?: string[];\n  effectiveAllowlist?: string[];\n  skills: AgentSkillAvailabilityEntry[];\n}\n\nexport interface AgentManagerConfig {\n  workspace: string;\n  model?: string;\n  config?: Config;\n  extensionRegistry?: ExtensionRegistry;\n  hookRunner?: import('../extensions/index.js').ExtensionHookRunner;\n  bus: MessageBus;\n  getCurrentContext: () => SessionContext | null;\n  /** Session persistence (enables `session_search` when set). */\n  getSessionStore?: () => SessionStore;\n  /** Clears per-session profile default on teardown. */\n  getModelManager?: () => ModelManager;\n  // Thinking configuration\n  thinkingLevel?: ThinkingLevel;\n  reasoningLevel?: 'off' | 'on' | 'stream';\n  verboseLevel?: 'off' | 'on' | 'full';\n  gatewayClarify?: { requestClarification: GatewayClarifyRequestFn };\n  /** Gateway: exposes CronService for the `cronjob` tool. */\n  getCronService?: () => CronService | undefined;\n  /** Gateway: starts persisted workflow runs (dedicated chat session per run). */\n  getWorkflowRunService?: () => import('../workflows/service/workflow-run-service.types.js').WorkflowRunServiceLike | undefined;\n}\n\nexport interface AgentInstance {\n  agent: Agent;\n  sessionKey: string;\n  createdAt: number;\n  lastUsedAt: number;\n  effectiveProfile: EffectiveAgentProfile;\n  resolvedWorkspacePath: string;\n  /** Tool names registered on this agent (for skill indexing / tool gating). */\n  registeredToolNames: string[];\n  /** Declared env var names from skill_view; shell reads values from process.env at spawn time. */\n  skillEnvPassthroughKeys: Set<string>;\n}\n\n\nexport class AgentManager implements AgentInstanceGateway {\n  private agents = new Map<string, AgentInstance>();\n  private config: AgentManagerConfig;\n  private toolsFactory: AgentToolsFactory;\n\n  private mergedConfig(): Config | undefined {\n    const base = this.config.config;\n    return base ? applyConfigOverrides(base) : undefined;\n  }\n  /** Default agent workspace (effective profile for `getDefaultAgentId`). */\n  private baseWorkspacePath: string;\n  /** Per-session absolute markdown workspace when `SessionAgentConfig.workingDirectoryOverride` is set. */\n  private sessionWorkspaceOverrides = new Map<string, string>();\n  private defaultModel: string;\n  private credentialCache = new Map<string, string>();\n  private credentialResolver: CredentialResolver;\n  private workspaceRuntimes: WorkspaceRuntimeRegistry;\n  private memoryPrefetch: MemoryPrefetchCoordinator;\n  private backgroundReview: BackgroundReviewCoordinator;\n\n  constructor(config: AgentManagerConfig) {\n    this.config = config;\n    this.baseWorkspacePath = this.computeBaseWorkspacePath();\n    this.workspaceRuntimes = new WorkspaceRuntimeRegistry({\n      getConfig: () => this.config.config!,\n      bundledSkillsDir: resolveBundledSkillsDir(),\n    });\n    this.memoryPrefetch = new MemoryPrefetchCoordinator({\n      getConfig: () => this.config.config,\n      getMemoryManagerForSession: (sk) => this.getMemoryManagerForSession(sk),\n      getLastAssistantContent: (sk) => this.getLastAssistantContent(sk),\n    });\n    this.backgroundReview = new BackgroundReviewCoordinator({\n      getConfig: () => this.mergedConfig(),\n      onSkillsFilesystemMutate: () => this.refreshSkillsAfterDiskChange(),\n    });\n    this.toolsFactory = new AgentToolsFactory(this.buildToolsFactoryDeps());\n\n    this.defaultModel = config.model || getDefaultModelSync(config.config);\n\n    this.credentialResolver = new CredentialResolver();\n    this.warmCredentialCache().catch((err) => {\n      const em = err instanceof Error ? err.message : String(err);\n      log.warn({ err, errorMessage: em }, `Credential cache pre-warm failed: ${em}`);\n    });\n  }\n\n  private computeBaseWorkspacePath(): string {\n    const cfg = this.config.config;\n    if (!cfg) {\n      return expandWorkspacePathString(this.config.workspace);\n    }\n    return resolveEffectiveAgentProfileForSession(cfg, null).resolvedWorkspacePath;\n  }\n\n  /**\n   * Workspace root for inbound attachments / side effects for this session's agent id.\n   * Uses in-memory session workspace overrides when the session has a persisted `workingDirectoryOverride`.\n   */\n  getResolvedWorkspaceForSession(sessionKey: string): string {\n    const cfg = this.config.config!;\n    const fromMap = this.sessionWorkspaceOverrides.get(sessionKey);\n    if (fromMap !== undefined) {\n      return fromMap;\n    }\n    return resolveEffectiveAgentProfileForSession(cfg, sessionKey).resolvedWorkspacePath;\n  }\n\n  /**\n   * Sync in-memory workspace override from session config (after load or PATCH).\n   * Pass `null` to clear when the session has no `workingDirectoryOverride` on disk.\n   */\n  setSessionWorkspaceOverride(sessionKey: string, absolutePath: string | null): void {\n    if (absolutePath === null || absolutePath === '') {\n      this.sessionWorkspaceOverrides.delete(sessionKey);\n    } else {\n      this.sessionWorkspaceOverrides.set(sessionKey, absolutePath);\n    }\n  }\n\n  /** Merged `thinkingDefault` for this session's agent id (defaults + `agents.list`). */\n  getThinkingDefaultForSession(\n    sessionKey: string,\n  ): import('./transcript/thinking-types.js').ThinkLevel | undefined {\n    const cfg = this.mergedConfig();\n    if (!cfg) {\n      return undefined;\n    }\n    return resolveEffectiveAgentProfileForSession(cfg, sessionKey).thinkingDefault;\n  }\n\n  private pickDefaultModelRef(): string {\n    const cfg = this.mergedConfig();\n    const ref = getAgentDefaultModelRef(cfg);\n    return ref?.trim() || getDefaultModelSync(cfg);\n  }\n\n  private resolveModelStringToModel(modelRef: string): Model<Api> {\n    try {\n      return resolveModel(modelRef);\n    } catch {\n      const fallback = getDefaultModelSync(this.mergedConfig());\n      log.warn({ modelRef, fallback }, 'Model not found, using default');\n      return resolveModel(fallback);\n    }\n  }\n\n  /**\n   * Keep defaults in sync when config is hot-reloaded or saved from the UI.\n   *\n   * The previous implementation rebuilt the entire `AgentToolsFactory` (80+ lines\n   * of dependency wiring) on every reload. The factory's deps are now built from\n   * a single helper ({@link buildToolsFactoryDeps}) and read `this.*` through\n   * closures, so existing instances automatically see the new config without\n   * reconstruction. The browser is still shut down because its cached settings\n   * (headless mode, backend choice) come from the config snapshot at connect time.\n   */\n  updateAgentDefaults(config: Config): void {\n    this.config.config = config;\n    const ref = getAgentDefaultModelRef(config);\n    this.config.model = ref;\n    this.defaultModel = ref || getDefaultModelSync(config);\n    this.baseWorkspacePath = this.computeBaseWorkspacePath();\n    void this.toolsFactory.shutdownBrowser();\n    void this.workspaceRuntimes.clearAll();\n  }\n\n  /**\n   * Construct the dep bag passed to `AgentToolsFactory`. Closures reference\n   * `this.*` so they remain valid across hot reloads (no rebuild needed).\n   */\n  private buildToolsFactoryDeps(): ConstructorParameters<typeof AgentToolsFactory>[0] {\n    return {\n      workspace: this.baseWorkspacePath,\n      extensionRegistry: this.config.extensionRegistry,\n      getCurrentContext: this.config.getCurrentContext,\n      hookRunner: this.config.hookRunner,\n      bus: this.config.bus,\n      getConfig: () => this.mergedConfig(),\n      getPrimaryModel: () => this.resolveModelStringToModel(this.pickDefaultModelRef()),\n      getBuiltinMemoryStore: () =>\n        this.workspaceRuntimes.getOrCreate(this.baseWorkspacePath).builtinMemoryStore,\n      getMemoryManager: () =>\n        this.workspaceRuntimes.getOrCreate(this.baseWorkspacePath).memoryManager,\n      getSessionStore: this.config.getSessionStore,\n      gatewayClarify: this.config.gatewayClarify,\n      getCronService: this.config.getCronService,\n      getWorkflowRunService: this.config.getWorkflowRunService,\n      getSkillIndexingContext: () => {\n        const ctx = this.config.getCurrentContext?.();\n        if (!ctx?.sessionKey) return undefined;\n        const inst = this.agents.get(ctx.sessionKey);\n        if (!inst) return undefined;\n        return {\n          registeredToolNames: inst.registeredToolNames,\n          skillAllowlist: inst.effectiveProfile.skillsAllowlist,\n        };\n      },\n      onSkillsFilesystemMutate: () => {\n        this.refreshSkillsAfterDiskChange();\n      },\n      getSkillPassthroughEnvVarNames: () => {\n        const ctx = this.config.getCurrentContext?.();\n        if (!ctx?.sessionKey) return [];\n        return [...(this.agents.get(ctx.sessionKey)?.skillEnvPassthroughKeys ?? [])];\n      },\n      registerSkillEnvPassthrough: (names: string[]) => {\n        const ctx = this.config.getCurrentContext?.();\n        if (!ctx?.sessionKey) return;\n        const inst = this.agents.get(ctx.sessionKey);\n        if (!inst) return;\n        for (const n of names) {\n          if (isValidSkillEnvVarName(n)) {\n            inst.skillEnvPassthroughKeys.add(n.trim());\n          }\n        }\n      },\n    };\n  }\n\n  getMemoryManager(): MemoryManager {\n    return this.workspaceRuntimes.getOrCreate(this.baseWorkspacePath).memoryManager;\n  }\n\n  private getMemoryManagerForSession(sessionKey: string): MemoryManager {\n    const path = this.getResolvedWorkspaceForSession(sessionKey);\n    return this.workspaceRuntimes.getOrCreate(path).memoryManager;\n  }\n\n  /**\n   * Prefix the user turn with fenced prefetched memory (external providers).\n   * Delegates to {@link MemoryPrefetchCoordinator}.\n   */\n  applyMemoryPrefetchToUserMessage(\n    userMessage: AgentMessage,\n    sessionKey: string,\n  ): Promise<AgentMessage> {\n    return this.memoryPrefetch.applyToUserMessage(userMessage, sessionKey);\n  }\n\n  /**\n   * After a completed turn: sync external providers and queue next-turn prefetch.\n   * Delegates to {@link MemoryPrefetchCoordinator}.\n   */\n  afterAgentTurn(sessionKey: string, userPlainText: string): void {\n    this.memoryPrefetch.afterTurn(sessionKey, userPlainText);\n  }\n\n  /**\n   * Call once per user turn before the main `agent.prompt` (via {@link runAgentTurnWithModelFallbacks} `beforeUserPrompt`).\n   * Delegates to {@link BackgroundReviewCoordinator}.\n   */\n  beginBackgroundReviewUserTurn(sessionKey: string): void {\n    const inst = this.agents.get(sessionKey);\n    if (!inst) return;\n    this.backgroundReview.beginUserTurn(sessionKey, inst.registeredToolNames);\n  }\n\n  /**\n   * After a successful main turn (after memory sync via `afterAgentTurn`), may run a quiet follow-up for memory/skills.\n   * Delegates to {@link BackgroundReviewCoordinator}.\n   */\n  scheduleBackgroundReviewAfterUserTurn(sessionKey: string): void {\n    const inst = this.agents.get(sessionKey);\n    if (!inst) return;\n    this.backgroundReview.scheduleAfterUserTurn({\n      sessionKey,\n      agent: inst.agent,\n      registeredToolNames: inst.registeredToolNames,\n      skillAllowlist: inst.effectiveProfile.skillsAllowlist,\n      workspacePath: inst.resolvedWorkspacePath,\n      lastAssistantText: this.getLastAssistantContent(sessionKey),\n      workspaceRuntime: this.workspaceRuntimes.getOrCreate(inst.resolvedWorkspacePath),\n    });\n  }\n\n  /**\n   * Expand `/skill:name` user text into the full skill block for the current turn (WebChat, channels).\n   */\n  expandSkillUserText(text: string): string {\n    const ctx = this.config.getCurrentContext?.();\n    const sessionKey = ctx?.sessionKey;\n    const path = sessionKey\n      ? this.getResolvedWorkspaceForSession(sessionKey)\n      : this.baseWorkspacePath;\n    const inst = sessionKey ? this.agents.get(sessionKey) : undefined;\n    return this.workspaceRuntimes.getOrCreate(path).skillManager.expandCommand(text, {\n      skillAllowlist: inst?.effectiveProfile.skillsAllowlist,\n      registeredToolNames: inst?.registeredToolNames,\n    });\n  }\n\n  /** Structured SKILL.md preview for the gateway console. */\n  getSkillMarkdownSource(skillName: string): SkillMarkdownPreviewPayload | null {\n    const skill = this.workspaceRuntimes.getOrCreate(this.baseWorkspacePath).skillManager.findSkill(skillName);\n    if (!skill) return null;\n\n    return {\n      name: skill.name,\n      description: skill.description,\n      bodyMarkdown: skill.content,\n      disableModelInvocation: skill.disableModelInvocation,\n      metadata: skill.metadata,\n      toolConditions: skill.toolConditions,\n      requiredEnvVarNames: skill.requiredEnvVarNames,\n    };\n  }\n\n  private loadProfileMarkdownForProfile(profile: EffectiveAgentProfile): ReturnType<typeof loadProfileMarkdownFiles> {\n    const cfg = this.config.config!;\n    const profileDir = resolveAgentProfileDir(cfg, profile.agentId);\n    return loadProfileMarkdownFiles(profileDir);\n  }\n\n  private resolveContextFilesForSession(\n    sessionKey: string,\n    profile: EffectiveAgentProfile,\n    excludeHeartbeat?: boolean,\n  ): EmbeddedContextFile[] {\n    const cfg = this.config.config!;\n    const profileDir = resolveAgentProfileDir(cfg, profile.agentId);\n    const heartbeatEnabled = cfg.gateway?.heartbeat?.includeSystemPromptSection ?? false;\n    const contextInjection = cfg.agents?.defaults?.contextInjection ?? 'always';\n    const { contextFiles } = resolveBootstrapContextSync({\n      profileDir,\n      config: cfg,\n      sessionKey,\n      excludeHeartbeat: excludeHeartbeat ?? !heartbeatEnabled,\n      contextInjection,\n    });\n    return contextFiles;\n  }\n\n  private skillCatalogEntryFromSkill(s: Skill, skillsConfig = createSkillConfigManager(resolveStateDir()).load(), lock = loadSkillsLock()): SkillCatalogEntry {\n    const base = resolve(s.baseDir);\n    const managed = isUnderManagedSkillsDir(s.baseDir);\n    const directoryId = base.split(sep).filter(Boolean).pop() || s.name;\n    const enabled = !(skillsConfig.entries?.[s.name]?.enabled === false);\n    const hubKey = managed ? basename(base) : '';\n    const hub = managed && hubKey ? lock.entries[hubKey] : undefined;\n\n    return {\n      directoryId,\n      name: s.name,\n      description: s.description,\n      category: s.category,\n      source: s.source,\n      path: s.baseDir,\n      managed,\n      enabled,\n      disableModelInvocation: s.disableModelInvocation,\n      ...(hub ? { hub } : {}),\n    };\n  }\n\n  getSkillCatalog(): SkillCatalogEntry[] {\n    const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n    const lock = loadSkillsLock();\n    return this.workspaceRuntimes\n      .getOrCreate(this.baseWorkspacePath)\n      .skillManager.getSkills()\n      .map((s) => this.skillCatalogEntryFromSkill(s, skillsConfig, lock));\n  }\n\n  getAgentSkillAvailability(agentId: string): AgentSkillAvailabilityPayload {\n    const cfg = this.config.config!;\n    const defaultsAllowlist = cfg.agents?.defaults?.skills;\n    const entry = Array.isArray(cfg.agents?.list)\n      ? cfg.agents.list.find((a) => a && a.enabled !== false && a.id.toLowerCase() === agentId.toLowerCase())\n      : undefined;\n    const profile = resolveEffectiveAgentProfile(cfg, agentId);\n    const rt = this.workspaceRuntimes.getOrCreate(profile.resolvedWorkspacePath);\n    const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n    const lock = loadSkillsLock();\n    const allow = profile.skillsAllowlist === undefined ? undefined : new Set(profile.skillsAllowlist.map((s) => s.toLowerCase()));\n\n    const skills = rt.skillManager.getSkills().map((s) => {\n      let unavailableReason: AgentSkillUnavailableReason | null = null;\n      const skillConfig = resolveSkillConfig(s, skillsConfig);\n      if (skillConfig.enabled === false) {\n        unavailableReason = 'disabled';\n      } else if (s.disableModelInvocation) {\n        unavailableReason = 'model-invocation-disabled';\n      } else if (!isSkillEnabled(s, skillsConfig)) {\n        unavailableReason = 'requirements-unmet';\n      } else if (allow !== undefined && !allow.has(s.name.toLowerCase())) {\n        unavailableReason = 'agent-denied';\n      }\n\n      return {\n        ...this.skillCatalogEntryFromSkill(s, skillsConfig, lock),\n        availableForCurrentAgent: unavailableReason === null,\n        unavailableReason,\n      };\n    });\n\n    return {\n      agentId: profile.agentId,\n      ...(defaultsAllowlist !== undefined ? { defaultsAllowlist: [...defaultsAllowlist] } : {}),\n      ...(entry?.skills !== undefined ? { agentAllowlist: [...entry.skills] } : {}),\n      ...(profile.skillsAllowlist !== undefined ? { effectiveAllowlist: [...profile.skillsAllowlist] } : {}),\n      skills,\n    };\n  }\n\n  /**\n   * After ~/.xopc/skills.json changes (enable/disable), refresh `<available_skills>` on active agents.\n   */\n  refreshSkillsAfterSkillConfigChange(): void {\n    const cfg = this.config.config!;\n    const touched = new Set<string>();\n    for (const instance of this.agents.values()) {\n      const rt = this.workspaceRuntimes.getOrCreate(instance.resolvedWorkspacePath);\n      if (!touched.has(instance.resolvedWorkspacePath)) {\n        rt.skillManager.refreshPromptFromConfig();\n        touched.add(instance.resolvedWorkspacePath);\n      }\n      const contextFiles = this.resolveContextFilesForSession(\n        instance.sessionKey,\n        instance.effectiveProfile,\n      );\n      const newPrompt = rt.systemPromptBuilder.build(contextFiles, {\n        externalMemoryInstructions: rt.memoryManager.buildExternalSystemPrompt(),\n        workspaceOverride: instance.resolvedWorkspacePath,\n        profileMarkdownPathRoot: resolveAgentProfileDir(cfg, instance.effectiveProfile.agentId),\n        systemPromptOverride: instance.effectiveProfile.systemPromptOverride,\n        skillAllowlist: instance.effectiveProfile.skillsAllowlist,\n        registeredToolNames: instance.registeredToolNames,\n        sessionKey: instance.sessionKey,\n        modelRef: instance.effectiveProfile.primaryModelRef?.trim() || this.defaultModel,\n        agentId: instance.effectiveProfile.agentId,\n        thinkingLevel:\n          (instance.effectiveProfile.thinkingDefault as ThinkingLevel | undefined) ??\n          this.config.thinkingLevel ??\n          'medium',\n      });\n      instance.agent.state.systemPrompt = newPrompt;\n    }\n    log.info({ agents: this.agents.size }, 'Skill toggles applied; system prompt updated');\n  }\n\n  /**\n   * Reload skills from disk and refresh system prompt on all active Agent instances.\n   */\n  refreshSkillsAfterDiskChange(): void {\n    const cfg = this.config.config!;\n    // Reload every workspace SkillManager first. When there are no active agent sessions\n    // (e.g. gateway UI only), the loop below runs zero times — without this, `getSkillCatalog()`\n    // and delete flows still see stale in-memory skills after ~/.xopc/skills changes.\n    for (const rt of this.workspaceRuntimes.values()) {\n      rt.skillManager.reload();\n    }\n\n    const touched = new Set<string>();\n    for (const instance of this.agents.values()) {\n      const rt = this.workspaceRuntimes.getOrCreate(instance.resolvedWorkspacePath);\n      if (!touched.has(instance.resolvedWorkspacePath)) {\n        touched.add(instance.resolvedWorkspacePath);\n      }\n      const contextFiles = this.resolveContextFilesForSession(\n        instance.sessionKey,\n        instance.effectiveProfile,\n      );\n      const newPrompt = rt.systemPromptBuilder.rebuild(contextFiles, {\n        externalMemoryInstructions: rt.memoryManager.buildExternalSystemPrompt(),\n        workspaceOverride: instance.resolvedWorkspacePath,\n        profileMarkdownPathRoot: resolveAgentProfileDir(cfg, instance.effectiveProfile.agentId),\n        systemPromptOverride: instance.effectiveProfile.systemPromptOverride,\n        skillAllowlist: instance.effectiveProfile.skillsAllowlist,\n        registeredToolNames: instance.registeredToolNames,\n        sessionKey: instance.sessionKey,\n        modelRef: instance.effectiveProfile.primaryModelRef?.trim() || this.defaultModel,\n        agentId: instance.effectiveProfile.agentId,\n        thinkingLevel:\n          (instance.effectiveProfile.thinkingDefault as ThinkingLevel | undefined) ??\n          this.config.thinkingLevel ??\n          'medium',\n      });\n      instance.agent.state.systemPrompt = newPrompt;\n    }\n    log.info({ agents: this.agents.size }, 'Skills refreshed; system prompt updated');\n  }\n\n  /**\n   * Get or create an Agent instance for a session\n   */\n  getOrCreateAgent(sessionKey: string): Agent {\n    const cfg = this.config.config!;\n    const targetPath = this.getResolvedWorkspaceForSession(sessionKey);\n    const existing = this.agents.get(sessionKey);\n    if (existing) {\n      if (existing.resolvedWorkspacePath !== targetPath) {\n        this.removeAgent(sessionKey);\n      } else {\n        existing.lastUsedAt = Date.now();\n        log.debug({ sessionKey }, 'Reusing existing agent instance');\n        return existing.agent;\n      }\n    }\n\n    const profile = resolveEffectiveAgentProfileForSession(cfg, sessionKey);\n    const resolvedPath = targetPath;\n    const rt = this.workspaceRuntimes.getOrCreate(resolvedPath);\n\n    if (isMemorySubsystemEnabled(cfg)) {\n      void rt.memoryManager\n        .initializeAll(sessionKey, { workspace: resolvedPath })\n        .catch((err) => log.warn({ err, sessionKey }, 'memory initializeAll failed'));\n    }\n\n    if (isMemorySubsystemEnabled(cfg) && shouldRegisterCuratedMemoryTool(cfg)) {\n      rt.builtinMemoryStore.loadFromDiskSync();\n    }\n\n    const { agent, registeredToolNames } = this.createAgentForProfile(\n      sessionKey,\n      profile,\n      resolvedPath,\n      rt,\n    );\n\n    this.agents.set(sessionKey, {\n      agent,\n      sessionKey,\n      createdAt: Date.now(),\n      lastUsedAt: Date.now(),\n      effectiveProfile: profile,\n      resolvedWorkspacePath: resolvedPath,\n      registeredToolNames,\n      skillEnvPassthroughKeys: new Set<string>(),\n    });\n\n    this.backgroundReview.attachToAgent(sessionKey, agent, registeredToolNames);\n\n    const modelRef = profile.primaryModelRef?.trim() || this.defaultModel;\n    this.config.getModelManager?.().setSessionProfileDefault(sessionKey, modelRef);\n\n    log.debug({ sessionKey, totalAgents: this.agents.size, agentId: profile.agentId }, 'Created new agent instance');\n    return agent;\n  }\n\n  /**\n   * Get existing agent for a session (if any)\n   */\n  getAgent(sessionKey: string): Agent | undefined {\n    return this.agents.get(sessionKey)?.agent;\n  }\n\n  /**\n   * Check if an agent exists for a session\n   */\n  hasAgent(sessionKey: string): boolean {\n    return this.agents.has(sessionKey);\n  }\n\n  /**\n   * Remove an agent instance\n   */\n  removeAgent(sessionKey: string): boolean {\n    const instance = this.agents.get(sessionKey);\n    if (instance) {\n      this.backgroundReview.forgetSession(sessionKey);\n      void this.toolsFactory.closeBrowserPageForSession(sessionKey);\n      void retireSessionMcpRuntimeForSessionKey({ sessionKey, reason: 'agent-evict' });\n      instance.agent.abort();\n      evictEmbeddedSessionRunner(sessionKey, 'agent_removed');\n      this.agents.delete(sessionKey);\n      this.memoryPrefetch.forgetSession(sessionKey);\n      clearBootstrapSnapshot(sessionKey);\n      this.config.getModelManager?.().clearSessionProfileDefault(sessionKey);\n      log.info({ sessionKey, totalAgents: this.agents.size }, 'Removed agent instance');\n      return true;\n    }\n    return false;\n  }\n\n  /**\n   * Get all active session keys\n   */\n  getActiveSessions(): string[] {\n    return Array.from(this.agents.keys());\n  }\n\n  /**\n   * Get agent count\n   */\n  getAgentCount(): number {\n    return this.agents.size;\n  }\n\n  /**\n   * Merge per-turn channel system prompt (e.g. Telegram group/topic override) into the agent.\n   */\n  applyTurnChannelSystemPrompt(sessionKey: string, channelSystemPrompt: string): void {\n    const trimmed = channelSystemPrompt.trim();\n    if (!trimmed) return;\n\n    const instance = this.agents.get(sessionKey);\n    if (!instance) return;\n\n    const cfg = this.config.config!;\n    const rt = this.workspaceRuntimes.getOrCreate(instance.resolvedWorkspacePath);\n    const contextFiles = this.resolveContextFilesForSession(sessionKey, instance.effectiveProfile);\n    const modelRef = instance.effectiveProfile.primaryModelRef?.trim() || this.defaultModel;\n    const thinkingLevel =\n      (instance.effectiveProfile.thinkingDefault as ThinkingLevel | undefined) ??\n      this.config.thinkingLevel ??\n      'medium';\n\n    instance.agent.state.systemPrompt = rt.systemPromptBuilder.build(contextFiles, {\n      externalMemoryInstructions: rt.memoryManager.buildExternalSystemPrompt(),\n      workspaceOverride: instance.resolvedWorkspacePath,\n      profileMarkdownPathRoot: resolveAgentProfileDir(cfg, instance.effectiveProfile.agentId),\n      systemPromptOverride: instance.effectiveProfile.systemPromptOverride,\n      skillAllowlist: instance.effectiveProfile.skillsAllowlist,\n      registeredToolNames: instance.registeredToolNames,\n      sessionKey,\n      modelRef,\n      agentId: instance.effectiveProfile.agentId,\n      thinkingLevel,\n      extraSystemPrompt: trimmed,\n    });\n  }\n\n  /**\n   * Set thinking level for a session's agent\n   */\n  setThinkingLevel(sessionKey: string, level: ThinkingLevel): void {\n    const instance = this.agents.get(sessionKey);\n    if (instance) {\n      instance.agent.state.thinkingLevel = level;\n      log.debug({ sessionKey, thinkingLevel: level }, 'Set thinking level for agent');\n    }\n  }\n\n  /**\n   * Dispose all agents\n   */\n  dispose(): void {\n    void this.toolsFactory.shutdownBrowser();\n    void disposeAllSessionMcpRuntimes().catch(() => {});\n    evictAllEmbeddedSessionRunners('agent_manager_dispose');\n    this.backgroundReview.clear();\n    for (const instance of this.agents.values()) {\n      instance.agent.abort();\n    }\n    this.agents.clear();\n    this.memoryPrefetch.clear();\n    this.sessionWorkspaceOverrides.clear();\n    void this.workspaceRuntimes.clearAll();\n    log.debug('All agent instances disposed');\n  }\n\n  async warmCredentialCache(): Promise<void> {\n    const profiles = await this.credentialResolver.listProfiles();\n    for (const profile of profiles) {\n      const secret = profile.key?.trim()\n        ? profile.key.trim()\n        : profile.envVar\n          ? process.env[profile.envVar]?.trim()\n          : undefined;\n      if (secret) {\n        this.credentialCache.set(profile.provider.toLowerCase(), secret);\n      }\n    }\n    log.debug({ count: this.credentialCache.size }, 'Credential cache warmed');\n  }\n\n  async refreshCredentials(): Promise<void> {\n    this.credentialCache.clear();\n    await this.warmCredentialCache();\n  }\n\n  private resolveApiKeyWithCache(provider: string): string | undefined {\n    const key = provider.toLowerCase();\n    const cached = this.credentialCache.get(key);\n    if (cached) return cached;\n\n    const fromDisk = resolveProviderApiKeySync(provider);\n    if (fromDisk) {\n      this.credentialCache.set(key, fromDisk);\n      return fromDisk;\n    }\n\n    const fromRegistryOrEnv = getApiKeySync(provider);\n    if (fromRegistryOrEnv) {\n      this.credentialCache.set(key, fromRegistryOrEnv);\n      return fromRegistryOrEnv;\n    }\n    return undefined;\n  }\n\n  private createAgentForProfile(\n    sessionKey: string,\n    profile: EffectiveAgentProfile,\n    resolvedWorkspacePath: string,\n    rt: WorkspaceRuntime,\n  ): { agent: Agent; registeredToolNames: string[] } {\n    const modelRef = profile.primaryModelRef?.trim() || this.defaultModel;\n    const model = this.resolveModelStringToModel(modelRef);\n\n    const contextFiles = this.resolveContextFilesForSession(sessionKey, profile);\n    const tools = this.toolsFactory.createAllTools({\n      workspace: resolvedWorkspacePath,\n      profileMarkdownRoot: resolveAgentProfileDir(this.config.config!, profile.agentId),\n      disabledTools: profile.tools.disable,\n      getPrimaryModel: () => this.resolveModelStringToModel(modelRef),\n      getBuiltinMemoryStore: () => rt.builtinMemoryStore,\n      getMemoryManager: () => rt.memoryManager,\n      getSkillManager: () => rt.skillManager,\n    });\n    const registeredToolNames = tools.map((t) => t.name);\n\n    const thinkingLevel =\n      (profile.thinkingDefault as ThinkingLevel | undefined) ?? this.config.thinkingLevel ?? 'medium';\n\n    const agent = new Agent({\n      initialState: {\n        systemPrompt: rt.systemPromptBuilder.build(contextFiles, {\n          externalMemoryInstructions: rt.memoryManager.buildExternalSystemPrompt(),\n          workspaceOverride: resolvedWorkspacePath,\n          profileMarkdownPathRoot: resolveAgentProfileDir(this.config.config!, profile.agentId),\n          systemPromptOverride: profile.systemPromptOverride,\n          skillAllowlist: profile.skillsAllowlist,\n          registeredToolNames,\n          sessionKey,\n          modelRef,\n          agentId: profile.agentId,\n          thinkingLevel,\n        }),\n        model,\n        thinkingLevel,\n        tools,\n        messages: [],\n      },\n      streamFn: createExtensionAwareStreamFn(),\n      getApiKey: (provider: string) => this.resolveApiKeyWithCache(provider),\n      beforeToolCall: async ({ toolCall, args }) => {\n        const toolName = toolCall.name;\n\n        if (toolName === 'shell') {\n          const ctx = this.config.getCurrentContext();\n          const cfg = this.mergedConfig();\n          if (ctx && cfg) {\n            const command =\n              typeof (args as { command?: unknown })?.command === 'string'\n                ? (args as { command: string }).command\n                : JSON.stringify(args ?? {});\n            const accountId =\n              typeof ctx.metadata?.accountId === 'string' ? ctx.metadata.accountId : undefined;\n            const approval = await maybeRequestChannelExecApproval({\n              cfg,\n              payload: {\n                sessionKey: ctx.sessionKey,\n                channel: ctx.channel,\n                chatId: ctx.chatId,\n                accountId,\n                toolName,\n                summary: command.slice(0, 500),\n                details: { command: command.slice(0, 2000) },\n              },\n            });\n            if (approval.required && !approval.approved) {\n              return {\n                block: true,\n                reason: approval.reason ?? 'Exec approval denied or timed out.',\n              };\n            }\n          }\n        }\n\n        if (!this.config.hookRunner) {\n          return undefined;\n        }\n        const parsed = parseMcpToolName(toolName);\n        const hookResult = await this.config.hookRunner.runBeforeToolCall(\n          toolName,\n          (args ?? {}) as Record<string, unknown>,\n          {\n            sessionKey,\n            isMcpTool: parsed !== null,\n            mcpServerId: parsed?.serverId,\n          },\n        );\n        if (!hookResult.allowed) {\n          return { block: true, reason: hookResult.reason ?? 'Tool call blocked by policy hook.' };\n        }\n        return undefined;\n      },\n    });\n    return { agent, registeredToolNames };\n  }\n\n  /**\n   * Set model for a specific session\n   */\n  setModelForSession(sessionKey: string, modelId: string): boolean {\n    const instance = this.agents.get(sessionKey);\n    if (!instance) {\n      log.warn(\n        { sessionKey, modelId, activeSessionCount: this.agents.size },\n        `setModelForSession: no agent instance for session (create session / run turn first); modelId=${modelId}`,\n      );\n      return false;\n    }\n\n    try {\n      const model = resolveModel(modelId);\n      instance.agent.state.model = model;\n\n      const cfg = this.config.config!;\n      const rt = this.workspaceRuntimes.getOrCreate(instance.resolvedWorkspacePath);\n      const contextFiles = this.resolveContextFilesForSession(\n        sessionKey,\n        instance.effectiveProfile,\n      );\n      const thinkingLevel =\n        (instance.agent.state.thinkingLevel as ThinkingLevel | undefined) ??\n        (instance.effectiveProfile.thinkingDefault as ThinkingLevel | undefined) ??\n        this.config.thinkingLevel ??\n        'medium';\n\n      instance.agent.state.systemPrompt = rt.systemPromptBuilder.build(contextFiles, {\n        externalMemoryInstructions: rt.memoryManager.buildExternalSystemPrompt(),\n        workspaceOverride: instance.resolvedWorkspacePath,\n        profileMarkdownPathRoot: resolveAgentProfileDir(cfg, instance.effectiveProfile.agentId),\n        systemPromptOverride: instance.effectiveProfile.systemPromptOverride,\n        skillAllowlist: instance.effectiveProfile.skillsAllowlist,\n        registeredToolNames: instance.registeredToolNames,\n        sessionKey,\n        modelRef: modelId,\n        agentId: instance.effectiveProfile.agentId,\n        thinkingLevel,\n      });\n\n      log.info({ sessionKey, modelId }, 'Model set for session');\n      return true;\n    } catch (err) {\n      log.error({ err, sessionKey, modelId }, 'Failed to set model for session');\n      return false;\n    }\n  }\n\n  /**\n   * Get last assistant content from a session's agent\n   */\n  getLastAssistantContent(sessionKey: string): string | null {\n    const instance = this.agents.get(sessionKey);\n    if (!instance) {\n      return null;\n    }\n\n    const messages = instance.agent.state.messages;\n    for (let i = messages.length - 1; i >= 0; i--) {\n      const msg = messages[i];\n      if (msg.role === 'assistant') {\n        const content = msg.content;\n        if (Array.isArray(content)) {\n          return extractTextContent(content as Array<{ type: string; text?: string }>);\n        }\n        return String(content);\n      }\n    }\n    return null;\n  }\n\n  /**\n   * Replace messages for a session's agent\n   */\n  replaceMessages(sessionKey: string, messages: AgentMessage[]): boolean {\n    const instance = this.agents.get(sessionKey);\n    if (!instance) {\n      return false;\n    }\n\n    instance.agent.state.messages = messages;\n    return true;\n  }\n\n  /**\n   * Get messages for a session's agent\n   */\n  getMessages(sessionKey: string): AgentMessage[] | null {\n    const instance = this.agents.get(sessionKey);\n    if (!instance) {\n      return null;\n    }\n\n    return instance.agent.state.messages;\n  }\n\n  /**\n   * Subscribe to agent events for a session\n   */\n  subscribeToSession(sessionKey: string, callback: (event: AgentEvent) => void): (() => void) | null {\n    const instance = this.agents.get(sessionKey);\n    if (!instance) {\n      return null;\n    }\n\n    return instance.agent.subscribe(callback);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"agent-manager.js","names":[],"sources":["../../../src/agent/agent-manager.ts"],"sourcesContent":["/**\n * Agent Manager - Manages Agent instances per session\n *\n * Each session gets its own Agent instance for true isolation\n * and concurrent processing across sessions.\n */\n\nimport {\n  Agent,\n  type AgentMessage,\n  type AgentEvent,\n  type ThinkingLevel,\n} from '@earendil-works/pi-agent-core';\nimport type { Model, Api } from '@earendil-works/pi-ai';\nimport type { AgentInstanceGateway } from './agent-instance-gateway.js';\nimport { type Config, getAgentDefaultModelRef } from '../config/schema.js';\nimport { applyConfigOverrides } from '../config/runtime-overrides.js';\nimport { resolveAgentProfileDir } from './agent-scope.js';\nimport {\n  type EffectiveAgentProfile,\n  resolveEffectiveAgentProfile,\n  resolveEffectiveAgentProfileForSession,\n} from '../config/agent-profile.js';\nimport { expandWorkspacePathString } from '../config/workspace-path.js';\nimport type { ModelManager } from './models/manager.js';\nimport { createLogger } from '../utils/logger.js';\nimport { resolveProviderApiKeySync } from '../auth/sync-provider-auth.js';\nimport { resolveModel, getDefaultModelSync, getApiKeySync } from '../providers/index.js';\nimport { createExtensionAwareStreamFn } from '../providers/extension-stream-bridge.js';\nimport { CredentialResolver } from '../auth/credentials.js';\nimport { resolveBundledSkillsDir, resolveStateDir } from '../config/paths.js';\nimport { loadProfileMarkdownFiles, extractTextContent } from './context/workspace.js';\nimport { clearBootstrapSnapshot, resolveBootstrapContextSync } from './bootstrap/bootstrap-files.js';\nimport type { EmbeddedContextFile } from './bootstrap/types.js';\nimport { AgentToolsFactory } from './tools/factory.js';\nimport { parseMcpToolName } from './mcp/bundle-mcp-policy.js';\nimport {\n  disposeAllSessionMcpRuntimes,\n  retireSessionMcpRuntimeForSessionKey,\n} from './mcp/bundle-mcp-tools.js';\nimport { evictAllEmbeddedSessionRunners, evictEmbeddedSessionRunner } from './embedded/session-runner.js';\nimport type { GatewayClarifyRequestFn } from './tools/clarify-tool.js';\nimport type { ExtensionRegistryImpl as ExtensionRegistry } from '../extensions/index.js';\nimport type { MessageBus } from '../infra/bus/index.js';\nimport type { CronService } from '../cron/index.js';\nimport type { SessionStore } from '../session/store.js';\nimport { isValidSkillEnvVarName } from './skills/required-env-vars.js';\nimport type { SessionContext } from './session/session-context.js';\nimport type {\n  Skill,\n  SkillDiagnostic,\n  SkillMarkdownPreviewPayload,\n  SkillRuntimeStatus,\n} from './skills/types.js';\nimport { createSkillConfigManager, isSkillEnabled, resolveSkillConfig } from './skills/config.js';\nimport { isUnderManagedSkillsDir } from './skills/managed-store.js';\nimport { loadSkillsLock, type SkillHubLockEntry } from './skills/hub-lock.js';\nimport { basename, resolve, sep } from 'node:path';\n\nimport {\n  isMemorySubsystemEnabled,\n  shouldRegisterCuratedMemoryTool,\n} from './memory/memory-config.js';\nimport type { MemoryManager } from './memory/manager.js';\nimport { MemoryPrefetchCoordinator } from './memory/prefetch-coordinator.js';\nimport { WorkspaceRuntimeRegistry, type WorkspaceRuntime } from './workspace-runtime/registry.js';\nimport { BackgroundReviewCoordinator } from './background-review/coordinator.js';\nimport { maybeRequestChannelExecApproval } from '../channels/exec-approval-runtime.js';\nimport { SkillFilesystemWatcher } from './skills/filesystem-watcher.js';\n\nconst log = createLogger('AgentManager');\n\nexport interface SkillCatalogEntry {\n  directoryId: string;\n  name: string;\n  description: string;\n  category?: string;\n  source: Skill['source'];\n  path: string;\n  managed: boolean;\n  /** User toggle in ~/.xopc/skills.json (`entries[name].enabled`). Default true. */\n  enabled: boolean;\n  /** When true, skill is never injected into `<available_skills>` (SKILL.md frontmatter). */\n  disableModelInvocation: boolean;\n  /** Hub install provenance when under ~/.xopc/skills and listed in skills-lock.json. */\n  hub?: SkillHubLockEntry;\n}\n\nexport interface SkillCatalogRuntimeMeta {\n  version: string;\n  loadedAt: number;\n  diagnostics: SkillDiagnostic[];\n  status: SkillRuntimeStatus;\n}\n\nexport interface SkillCatalogSnapshot extends SkillCatalogRuntimeMeta {\n  catalog: SkillCatalogEntry[];\n}\n\nexport type AgentSkillUnavailableReason = 'agent-denied' | 'disabled' | 'requirements-unmet' | 'model-invocation-disabled';\n\nexport interface AgentSkillAvailabilityEntry extends SkillCatalogEntry {\n  availableForCurrentAgent: boolean;\n  unavailableReason: AgentSkillUnavailableReason | null;\n}\n\nexport interface AgentSkillAvailabilityPayload {\n  agentId: string;\n  version: string;\n  loadedAt: number;\n  diagnostics: SkillDiagnostic[];\n  status: SkillRuntimeStatus;\n  defaultsAllowlist?: string[];\n  agentAllowlist?: string[];\n  effectiveAllowlist?: string[];\n  skills: AgentSkillAvailabilityEntry[];\n}\n\nexport interface AgentManagerConfig {\n  workspace: string;\n  model?: string;\n  config?: Config;\n  extensionRegistry?: ExtensionRegistry;\n  hookRunner?: import('../extensions/index.js').ExtensionHookRunner;\n  bus: MessageBus;\n  getCurrentContext: () => SessionContext | null;\n  /** Session persistence (enables `session_search` when set). */\n  getSessionStore?: () => SessionStore;\n  /** Clears per-session profile default on teardown. */\n  getModelManager?: () => ModelManager;\n  // Thinking configuration\n  thinkingLevel?: ThinkingLevel;\n  reasoningLevel?: 'off' | 'on' | 'stream';\n  verboseLevel?: 'off' | 'on' | 'full';\n  gatewayClarify?: { requestClarification: GatewayClarifyRequestFn };\n  /** Gateway: exposes CronService for the `cronjob` tool. */\n  getCronService?: () => CronService | undefined;\n  /** Gateway: starts persisted workflow runs (dedicated chat session per run). */\n  getWorkflowRunService?: () => import('../workflows/service/workflow-run-service.types.js').WorkflowRunServiceLike | undefined;\n  /** Runtime notification for UI/CLI shells that cache skill catalogs. */\n  onSkillsUpdated?: (payload: { reason: 'disk' | 'config' }) => void;\n}\n\nexport interface AgentInstance {\n  agent: Agent;\n  sessionKey: string;\n  createdAt: number;\n  lastUsedAt: number;\n  effectiveProfile: EffectiveAgentProfile;\n  resolvedWorkspacePath: string;\n  /** Tool names registered on this agent (for skill indexing / tool gating). */\n  registeredToolNames: string[];\n  /** Declared env var names from skill_view; shell reads values from process.env at spawn time. */\n  skillEnvPassthroughKeys: Set<string>;\n}\n\n\nexport class AgentManager implements AgentInstanceGateway {\n  private agents = new Map<string, AgentInstance>();\n  private config: AgentManagerConfig;\n  private toolsFactory: AgentToolsFactory;\n\n  private mergedConfig(): Config | undefined {\n    const base = this.config.config;\n    return base ? applyConfigOverrides(base) : undefined;\n  }\n  /** Default agent workspace (effective profile for `getDefaultAgentId`). */\n  private baseWorkspacePath: string;\n  /** Per-session absolute markdown workspace when `SessionAgentConfig.workingDirectoryOverride` is set. */\n  private sessionWorkspaceOverrides = new Map<string, string>();\n  private defaultModel: string;\n  private credentialCache = new Map<string, string>();\n  private credentialResolver: CredentialResolver;\n  private workspaceRuntimes: WorkspaceRuntimeRegistry;\n  private memoryPrefetch: MemoryPrefetchCoordinator;\n  private backgroundReview: BackgroundReviewCoordinator;\n  private skillFilesystemWatcher: SkillFilesystemWatcher;\n  private skillDiskRefreshInProgress = false;\n  private skillDiskRefreshPending = false;\n  private lastExplicitSkillDiskRefreshAt = 0;\n  private skillsUpdatedTimer: NodeJS.Timeout | undefined;\n  private pendingSkillsUpdatedReason: 'disk' | 'config' | undefined;\n\n  constructor(config: AgentManagerConfig) {\n    this.config = config;\n    this.baseWorkspacePath = this.computeBaseWorkspacePath();\n    this.skillFilesystemWatcher = new SkillFilesystemWatcher({\n      onChange: (event) => {\n        log.info({ changedPath: event.changedPath }, 'Skill filesystem changed; refreshing skills');\n        this.refreshSkillsAfterDiskChange('watch');\n      },\n    });\n    this.skillFilesystemWatcher.refreshPrimaryWorkspace(this.baseWorkspacePath);\n    this.workspaceRuntimes = new WorkspaceRuntimeRegistry({\n      getConfig: () => this.config.config!,\n      bundledSkillsDir: resolveBundledSkillsDir(),\n      onRuntimeCreated: (resolvedPath) => {\n        this.skillFilesystemWatcher.watchWorkspace(resolvedPath);\n      },\n    });\n    this.memoryPrefetch = new MemoryPrefetchCoordinator({\n      getConfig: () => this.config.config,\n      getMemoryManagerForSession: (sk) => this.getMemoryManagerForSession(sk),\n      getLastAssistantContent: (sk) => this.getLastAssistantContent(sk),\n    });\n    this.backgroundReview = new BackgroundReviewCoordinator({\n      getConfig: () => this.mergedConfig(),\n      onSkillsFilesystemMutate: () => this.refreshSkillsAfterDiskChange('explicit'),\n    });\n    this.toolsFactory = new AgentToolsFactory(this.buildToolsFactoryDeps());\n\n    this.defaultModel = config.model || getDefaultModelSync(config.config);\n\n    this.credentialResolver = new CredentialResolver();\n    this.warmCredentialCache().catch((err) => {\n      const em = err instanceof Error ? err.message : String(err);\n      log.warn({ err, errorMessage: em }, `Credential cache pre-warm failed: ${em}`);\n    });\n  }\n\n  private computeBaseWorkspacePath(): string {\n    const cfg = this.config.config;\n    if (!cfg) {\n      return expandWorkspacePathString(this.config.workspace);\n    }\n    return resolveEffectiveAgentProfileForSession(cfg, null).resolvedWorkspacePath;\n  }\n\n  /**\n   * Workspace root for inbound attachments / side effects for this session's agent id.\n   * Uses in-memory session workspace overrides when the session has a persisted `workingDirectoryOverride`.\n   */\n  getResolvedWorkspaceForSession(sessionKey: string): string {\n    const cfg = this.config.config!;\n    const fromMap = this.sessionWorkspaceOverrides.get(sessionKey);\n    if (fromMap !== undefined) {\n      return fromMap;\n    }\n    return resolveEffectiveAgentProfileForSession(cfg, sessionKey).resolvedWorkspacePath;\n  }\n\n  /**\n   * Sync in-memory workspace override from session config (after load or PATCH).\n   * Pass `null` to clear when the session has no `workingDirectoryOverride` on disk.\n   */\n  setSessionWorkspaceOverride(sessionKey: string, absolutePath: string | null): void {\n    if (absolutePath === null || absolutePath === '') {\n      this.sessionWorkspaceOverrides.delete(sessionKey);\n    } else {\n      this.sessionWorkspaceOverrides.set(sessionKey, absolutePath);\n    }\n  }\n\n  /** Merged `thinkingDefault` for this session's agent id (defaults + `agents.list`). */\n  getThinkingDefaultForSession(\n    sessionKey: string,\n  ): import('./transcript/thinking-types.js').ThinkLevel | undefined {\n    const cfg = this.mergedConfig();\n    if (!cfg) {\n      return undefined;\n    }\n    return resolveEffectiveAgentProfileForSession(cfg, sessionKey).thinkingDefault;\n  }\n\n  private pickDefaultModelRef(): string {\n    const cfg = this.mergedConfig();\n    const ref = getAgentDefaultModelRef(cfg);\n    return ref?.trim() || getDefaultModelSync(cfg);\n  }\n\n  private resolveModelStringToModel(modelRef: string): Model<Api> {\n    try {\n      return resolveModel(modelRef);\n    } catch {\n      const fallback = getDefaultModelSync(this.mergedConfig());\n      log.warn({ modelRef, fallback }, 'Model not found, using default');\n      return resolveModel(fallback);\n    }\n  }\n\n  /**\n   * Keep defaults in sync when config is hot-reloaded or saved from the UI.\n   *\n   * The previous implementation rebuilt the entire `AgentToolsFactory` (80+ lines\n   * of dependency wiring) on every reload. The factory's deps are now built from\n   * a single helper ({@link buildToolsFactoryDeps}) and read `this.*` through\n   * closures, so existing instances automatically see the new config without\n   * reconstruction. The browser is still shut down because its cached settings\n   * (headless mode, backend choice) come from the config snapshot at connect time.\n   */\n  updateAgentDefaults(config: Config): void {\n    this.config.config = config;\n    const ref = getAgentDefaultModelRef(config);\n    this.config.model = ref;\n    this.defaultModel = ref || getDefaultModelSync(config);\n    this.baseWorkspacePath = this.computeBaseWorkspacePath();\n    this.skillFilesystemWatcher.refreshPrimaryWorkspace(this.baseWorkspacePath);\n    void this.toolsFactory.shutdownBrowser();\n    void this.workspaceRuntimes.clearAll();\n  }\n\n  /**\n   * Construct the dep bag passed to `AgentToolsFactory`. Closures reference\n   * `this.*` so they remain valid across hot reloads (no rebuild needed).\n   */\n  private buildToolsFactoryDeps(): ConstructorParameters<typeof AgentToolsFactory>[0] {\n    return {\n      workspace: this.baseWorkspacePath,\n      extensionRegistry: this.config.extensionRegistry,\n      getCurrentContext: this.config.getCurrentContext,\n      hookRunner: this.config.hookRunner,\n      bus: this.config.bus,\n      getConfig: () => this.mergedConfig(),\n      getPrimaryModel: () => this.resolveModelStringToModel(this.pickDefaultModelRef()),\n      getBuiltinMemoryStore: () =>\n        this.workspaceRuntimes.getOrCreate(this.baseWorkspacePath).builtinMemoryStore,\n      getMemoryManager: () =>\n        this.workspaceRuntimes.getOrCreate(this.baseWorkspacePath).memoryManager,\n      getSessionStore: this.config.getSessionStore,\n      gatewayClarify: this.config.gatewayClarify,\n      getCronService: this.config.getCronService,\n      getWorkflowRunService: this.config.getWorkflowRunService,\n      getSkillIndexingContext: () => {\n        const ctx = this.config.getCurrentContext?.();\n        if (!ctx?.sessionKey) return undefined;\n        const inst = this.agents.get(ctx.sessionKey);\n        if (!inst) return undefined;\n        return {\n          registeredToolNames: inst.registeredToolNames,\n          skillAllowlist: inst.effectiveProfile.skillsAllowlist,\n        };\n      },\n      onSkillsFilesystemMutate: () => {\n        this.refreshSkillsAfterDiskChange('explicit');\n      },\n      getSkillPassthroughEnvVarNames: () => {\n        const ctx = this.config.getCurrentContext?.();\n        if (!ctx?.sessionKey) return [];\n        return [...(this.agents.get(ctx.sessionKey)?.skillEnvPassthroughKeys ?? [])];\n      },\n      registerSkillEnvPassthrough: (names: string[]) => {\n        const ctx = this.config.getCurrentContext?.();\n        if (!ctx?.sessionKey) return;\n        const inst = this.agents.get(ctx.sessionKey);\n        if (!inst) return;\n        for (const n of names) {\n          if (isValidSkillEnvVarName(n)) {\n            inst.skillEnvPassthroughKeys.add(n.trim());\n          }\n        }\n      },\n    };\n  }\n\n  getMemoryManager(): MemoryManager {\n    return this.workspaceRuntimes.getOrCreate(this.baseWorkspacePath).memoryManager;\n  }\n\n  private getMemoryManagerForSession(sessionKey: string): MemoryManager {\n    const path = this.getResolvedWorkspaceForSession(sessionKey);\n    return this.workspaceRuntimes.getOrCreate(path).memoryManager;\n  }\n\n  /**\n   * Prefix the user turn with fenced prefetched memory (external providers).\n   * Delegates to {@link MemoryPrefetchCoordinator}.\n   */\n  applyMemoryPrefetchToUserMessage(\n    userMessage: AgentMessage,\n    sessionKey: string,\n  ): Promise<AgentMessage> {\n    return this.memoryPrefetch.applyToUserMessage(userMessage, sessionKey);\n  }\n\n  /**\n   * After a completed turn: sync external providers and queue next-turn prefetch.\n   * Delegates to {@link MemoryPrefetchCoordinator}.\n   */\n  afterAgentTurn(sessionKey: string, userPlainText: string): void {\n    this.memoryPrefetch.afterTurn(sessionKey, userPlainText);\n  }\n\n  /**\n   * Call once per user turn before the main `agent.prompt` (via {@link runAgentTurnWithModelFallbacks} `beforeUserPrompt`).\n   * Delegates to {@link BackgroundReviewCoordinator}.\n   */\n  beginBackgroundReviewUserTurn(sessionKey: string): void {\n    const inst = this.agents.get(sessionKey);\n    if (!inst) return;\n    this.backgroundReview.beginUserTurn(sessionKey, inst.registeredToolNames);\n  }\n\n  /**\n   * After a successful main turn (after memory sync via `afterAgentTurn`), may run a quiet follow-up for memory/skills.\n   * Delegates to {@link BackgroundReviewCoordinator}.\n   */\n  scheduleBackgroundReviewAfterUserTurn(sessionKey: string): void {\n    const inst = this.agents.get(sessionKey);\n    if (!inst) return;\n    this.backgroundReview.scheduleAfterUserTurn({\n      sessionKey,\n      agent: inst.agent,\n      registeredToolNames: inst.registeredToolNames,\n      skillAllowlist: inst.effectiveProfile.skillsAllowlist,\n      workspacePath: inst.resolvedWorkspacePath,\n      lastAssistantText: this.getLastAssistantContent(sessionKey),\n      workspaceRuntime: this.workspaceRuntimes.getOrCreate(inst.resolvedWorkspacePath),\n    });\n  }\n\n  /**\n   * Expand `/skill:name` user text into the full skill block for the current turn (WebChat, channels).\n   */\n  expandSkillUserText(text: string): string {\n    const ctx = this.config.getCurrentContext?.();\n    const sessionKey = ctx?.sessionKey;\n    const path = sessionKey\n      ? this.getResolvedWorkspaceForSession(sessionKey)\n      : this.baseWorkspacePath;\n    const inst = sessionKey ? this.agents.get(sessionKey) : undefined;\n    return this.workspaceRuntimes.getOrCreate(path).skillManager.expandCommand(text, {\n      skillAllowlist: inst?.effectiveProfile.skillsAllowlist,\n      registeredToolNames: inst?.registeredToolNames,\n    });\n  }\n\n  /** Structured SKILL.md preview for the gateway console. */\n  getSkillMarkdownSource(skillName: string): SkillMarkdownPreviewPayload | null {\n    const skill = this.workspaceRuntimes.getOrCreate(this.baseWorkspacePath).skillManager.findSkill(skillName);\n    if (!skill) return null;\n\n    return {\n      name: skill.name,\n      description: skill.description,\n      bodyMarkdown: skill.content,\n      disableModelInvocation: skill.disableModelInvocation,\n      metadata: skill.metadata,\n      toolConditions: skill.toolConditions,\n      requiredEnvVarNames: skill.requiredEnvVarNames,\n    };\n  }\n\n  private loadProfileMarkdownForProfile(profile: EffectiveAgentProfile): ReturnType<typeof loadProfileMarkdownFiles> {\n    const cfg = this.config.config!;\n    const profileDir = resolveAgentProfileDir(cfg, profile.agentId);\n    return loadProfileMarkdownFiles(profileDir);\n  }\n\n  private resolveContextFilesForSession(\n    sessionKey: string,\n    profile: EffectiveAgentProfile,\n    excludeHeartbeat?: boolean,\n  ): EmbeddedContextFile[] {\n    const cfg = this.config.config!;\n    const profileDir = resolveAgentProfileDir(cfg, profile.agentId);\n    const heartbeatEnabled = cfg.gateway?.heartbeat?.includeSystemPromptSection ?? false;\n    const contextInjection = cfg.agents?.defaults?.contextInjection ?? 'always';\n    const { contextFiles } = resolveBootstrapContextSync({\n      profileDir,\n      config: cfg,\n      sessionKey,\n      excludeHeartbeat: excludeHeartbeat ?? !heartbeatEnabled,\n      contextInjection,\n    });\n    return contextFiles;\n  }\n\n  private skillCatalogEntryFromSkill(s: Skill, skillsConfig = createSkillConfigManager(resolveStateDir()).load(), lock = loadSkillsLock()): SkillCatalogEntry {\n    const base = resolve(s.baseDir);\n    const managed = isUnderManagedSkillsDir(s.baseDir);\n    const directoryId = base.split(sep).filter(Boolean).pop() || s.name;\n    const enabled = !(skillsConfig.entries?.[s.name]?.enabled === false);\n    const hubKey = managed ? basename(base) : '';\n    const hub = managed && hubKey ? lock.entries[hubKey] : undefined;\n\n    return {\n      directoryId,\n      name: s.name,\n      description: s.description,\n      category: s.category,\n      source: s.source,\n      path: s.baseDir,\n      managed,\n      enabled,\n      disableModelInvocation: s.disableModelInvocation,\n      ...(hub ? { hub } : {}),\n    };\n  }\n\n  getSkillCatalog(): SkillCatalogEntry[] {\n    return this.getSkillCatalogSnapshot().catalog;\n  }\n\n  getSkillCatalogSnapshot(): SkillCatalogSnapshot {\n    const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n    const lock = loadSkillsLock();\n    const rt = this.workspaceRuntimes.getOrCreate(this.baseWorkspacePath);\n    return {\n      catalog: rt.skillManager\n        .getSkills()\n        .map((s) => this.skillCatalogEntryFromSkill(s, skillsConfig, lock)),\n      version: rt.skillManager.getVersion(),\n      loadedAt: rt.skillManager.getLoadedAt(),\n      diagnostics: rt.skillManager.getDiagnostics(),\n      status: rt.skillManager.getStatus(),\n    };\n  }\n\n  getAgentSkillAvailability(agentId: string): AgentSkillAvailabilityPayload {\n    const cfg = this.config.config!;\n    const defaultsAllowlist = cfg.agents?.defaults?.skills;\n    const entry = Array.isArray(cfg.agents?.list)\n      ? cfg.agents.list.find((a) => a && a.enabled !== false && a.id.toLowerCase() === agentId.toLowerCase())\n      : undefined;\n    const profile = resolveEffectiveAgentProfile(cfg, agentId);\n    const rt = this.workspaceRuntimes.getOrCreate(profile.resolvedWorkspacePath);\n    const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n    const lock = loadSkillsLock();\n    const allow = profile.skillsAllowlist === undefined ? undefined : new Set(profile.skillsAllowlist.map((s) => s.toLowerCase()));\n\n    const skills = rt.skillManager.getSkills().map((s) => {\n      let unavailableReason: AgentSkillUnavailableReason | null = null;\n      const skillConfig = resolveSkillConfig(s, skillsConfig);\n      if (skillConfig.enabled === false) {\n        unavailableReason = 'disabled';\n      } else if (s.disableModelInvocation) {\n        unavailableReason = 'model-invocation-disabled';\n      } else if (!isSkillEnabled(s, skillsConfig)) {\n        unavailableReason = 'requirements-unmet';\n      } else if (allow !== undefined && !allow.has(s.name.toLowerCase())) {\n        unavailableReason = 'agent-denied';\n      }\n\n      return {\n        ...this.skillCatalogEntryFromSkill(s, skillsConfig, lock),\n        availableForCurrentAgent: unavailableReason === null,\n        unavailableReason,\n      };\n    });\n\n    return {\n      agentId: profile.agentId,\n      version: rt.skillManager.getVersion(),\n      loadedAt: rt.skillManager.getLoadedAt(),\n      diagnostics: rt.skillManager.getDiagnostics(),\n      status: rt.skillManager.getStatus(),\n      ...(defaultsAllowlist !== undefined ? { defaultsAllowlist: [...defaultsAllowlist] } : {}),\n      ...(entry?.skills !== undefined ? { agentAllowlist: [...entry.skills] } : {}),\n      ...(profile.skillsAllowlist !== undefined ? { effectiveAllowlist: [...profile.skillsAllowlist] } : {}),\n      skills,\n    };\n  }\n\n  /**\n   * After ~/.xopc/skills.json changes (enable/disable), refresh `<available_skills>` on active agents.\n   */\n  refreshSkillsAfterSkillConfigChange(): void {\n    const cfg = this.config.config!;\n    const touched = new Set<string>();\n    for (const [resolvedPath, rt] of this.workspaceRuntimes.entries()) {\n      rt.skillManager.refreshPromptFromConfig();\n      touched.add(resolvedPath);\n    }\n    for (const instance of this.agents.values()) {\n      const rt = this.workspaceRuntimes.getOrCreate(instance.resolvedWorkspacePath);\n      if (!touched.has(instance.resolvedWorkspacePath)) {\n        rt.skillManager.refreshPromptFromConfig();\n        touched.add(instance.resolvedWorkspacePath);\n      }\n      const contextFiles = this.resolveContextFilesForSession(\n        instance.sessionKey,\n        instance.effectiveProfile,\n      );\n      const newPrompt = rt.systemPromptBuilder.build(contextFiles, {\n        externalMemoryInstructions: rt.memoryManager.buildExternalSystemPrompt(),\n        workspaceOverride: instance.resolvedWorkspacePath,\n        profileMarkdownPathRoot: resolveAgentProfileDir(cfg, instance.effectiveProfile.agentId),\n        systemPromptOverride: instance.effectiveProfile.systemPromptOverride,\n        skillAllowlist: instance.effectiveProfile.skillsAllowlist,\n        registeredToolNames: instance.registeredToolNames,\n        sessionKey: instance.sessionKey,\n        modelRef: instance.effectiveProfile.primaryModelRef?.trim() || this.defaultModel,\n        agentId: instance.effectiveProfile.agentId,\n        thinkingLevel:\n          (instance.effectiveProfile.thinkingDefault as ThinkingLevel | undefined) ??\n          this.config.thinkingLevel ??\n          'medium',\n      });\n      instance.agent.state.systemPrompt = newPrompt;\n    }\n    log.info({ agents: this.agents.size }, 'Skill toggles applied; system prompt updated');\n    this.scheduleSkillsUpdated('config');\n  }\n\n  /**\n   * Reload skills from disk and refresh system prompt on all active Agent instances.\n   */\n  refreshSkillsAfterDiskChange(source: 'explicit' | 'watch' = 'explicit'): void {\n    const now = Date.now();\n    if (source === 'watch' && now - this.lastExplicitSkillDiskRefreshAt < 2500) {\n      log.debug({ changedWithinMs: now - this.lastExplicitSkillDiskRefreshAt }, 'Ignoring skill watcher echo after explicit refresh');\n      return;\n    }\n    if (source === 'explicit') {\n      this.lastExplicitSkillDiskRefreshAt = now;\n    }\n\n    if (this.skillDiskRefreshInProgress) {\n      this.skillDiskRefreshPending = true;\n      return;\n    }\n\n    this.skillDiskRefreshInProgress = true;\n    let refreshed = false;\n    try {\n      do {\n        this.skillDiskRefreshPending = false;\n        this.applySkillsAfterDiskChange();\n        refreshed = true;\n      } while (this.skillDiskRefreshPending);\n    } finally {\n      this.skillDiskRefreshInProgress = false;\n    }\n\n    if (refreshed) {\n      this.scheduleSkillsUpdated('disk');\n    }\n  }\n\n  private scheduleSkillsUpdated(reason: 'disk' | 'config'): void {\n    this.pendingSkillsUpdatedReason = reason === 'disk' ? 'disk' : this.pendingSkillsUpdatedReason ?? 'config';\n    if (this.skillsUpdatedTimer) clearTimeout(this.skillsUpdatedTimer);\n    this.skillsUpdatedTimer = setTimeout(() => {\n      const nextReason = this.pendingSkillsUpdatedReason ?? reason;\n      this.pendingSkillsUpdatedReason = undefined;\n      this.skillsUpdatedTimer = undefined;\n      this.config.onSkillsUpdated?.({ reason: nextReason });\n    }, 250);\n  }\n\n  private applySkillsAfterDiskChange(): void {\n    const cfg = this.config.config!;\n    // Reload every workspace SkillManager first. When there are no active agent sessions\n    // (e.g. gateway UI only), the loop below runs zero times — without this, `getSkillCatalog()`\n    // and delete flows still see stale in-memory skills after ~/.xopc/skills changes.\n    for (const rt of this.workspaceRuntimes.values()) {\n      rt.skillManager.reload();\n    }\n\n    const touched = new Set<string>();\n    for (const instance of this.agents.values()) {\n      const rt = this.workspaceRuntimes.getOrCreate(instance.resolvedWorkspacePath);\n      if (!touched.has(instance.resolvedWorkspacePath)) {\n        touched.add(instance.resolvedWorkspacePath);\n      }\n      const contextFiles = this.resolveContextFilesForSession(\n        instance.sessionKey,\n        instance.effectiveProfile,\n      );\n      const newPrompt = rt.systemPromptBuilder.rebuild(contextFiles, {\n        externalMemoryInstructions: rt.memoryManager.buildExternalSystemPrompt(),\n        workspaceOverride: instance.resolvedWorkspacePath,\n        profileMarkdownPathRoot: resolveAgentProfileDir(cfg, instance.effectiveProfile.agentId),\n        systemPromptOverride: instance.effectiveProfile.systemPromptOverride,\n        skillAllowlist: instance.effectiveProfile.skillsAllowlist,\n        registeredToolNames: instance.registeredToolNames,\n        sessionKey: instance.sessionKey,\n        modelRef: instance.effectiveProfile.primaryModelRef?.trim() || this.defaultModel,\n        agentId: instance.effectiveProfile.agentId,\n        thinkingLevel:\n          (instance.effectiveProfile.thinkingDefault as ThinkingLevel | undefined) ??\n          this.config.thinkingLevel ??\n          'medium',\n      });\n      instance.agent.state.systemPrompt = newPrompt;\n    }\n    log.info({ agents: this.agents.size }, 'Skills refreshed; system prompt updated');\n  }\n\n  /**\n   * Get or create an Agent instance for a session\n   */\n  getOrCreateAgent(sessionKey: string): Agent {\n    const cfg = this.config.config!;\n    const targetPath = this.getResolvedWorkspaceForSession(sessionKey);\n    const existing = this.agents.get(sessionKey);\n    if (existing) {\n      if (existing.resolvedWorkspacePath !== targetPath) {\n        this.removeAgent(sessionKey);\n      } else {\n        existing.lastUsedAt = Date.now();\n        log.debug({ sessionKey }, 'Reusing existing agent instance');\n        return existing.agent;\n      }\n    }\n\n    const profile = resolveEffectiveAgentProfileForSession(cfg, sessionKey);\n    const resolvedPath = targetPath;\n    const rt = this.workspaceRuntimes.getOrCreate(resolvedPath);\n\n    if (isMemorySubsystemEnabled(cfg)) {\n      void rt.memoryManager\n        .initializeAll(sessionKey, { workspace: resolvedPath })\n        .catch((err) => log.warn({ err, sessionKey }, 'memory initializeAll failed'));\n    }\n\n    if (isMemorySubsystemEnabled(cfg) && shouldRegisterCuratedMemoryTool(cfg)) {\n      rt.builtinMemoryStore.loadFromDiskSync();\n    }\n\n    const { agent, registeredToolNames } = this.createAgentForProfile(\n      sessionKey,\n      profile,\n      resolvedPath,\n      rt,\n    );\n\n    this.agents.set(sessionKey, {\n      agent,\n      sessionKey,\n      createdAt: Date.now(),\n      lastUsedAt: Date.now(),\n      effectiveProfile: profile,\n      resolvedWorkspacePath: resolvedPath,\n      registeredToolNames,\n      skillEnvPassthroughKeys: new Set<string>(),\n    });\n\n    this.backgroundReview.attachToAgent(sessionKey, agent, registeredToolNames);\n\n    const modelRef = profile.primaryModelRef?.trim() || this.defaultModel;\n    this.config.getModelManager?.().setSessionProfileDefault(sessionKey, modelRef);\n\n    log.debug({ sessionKey, totalAgents: this.agents.size, agentId: profile.agentId }, 'Created new agent instance');\n    return agent;\n  }\n\n  /**\n   * Get existing agent for a session (if any)\n   */\n  getAgent(sessionKey: string): Agent | undefined {\n    return this.agents.get(sessionKey)?.agent;\n  }\n\n  /**\n   * Check if an agent exists for a session\n   */\n  hasAgent(sessionKey: string): boolean {\n    return this.agents.has(sessionKey);\n  }\n\n  /**\n   * Remove an agent instance\n   */\n  removeAgent(sessionKey: string): boolean {\n    const instance = this.agents.get(sessionKey);\n    if (instance) {\n      this.backgroundReview.forgetSession(sessionKey);\n      void this.toolsFactory.closeBrowserPageForSession(sessionKey);\n      void retireSessionMcpRuntimeForSessionKey({ sessionKey, reason: 'agent-evict' });\n      instance.agent.abort();\n      evictEmbeddedSessionRunner(sessionKey, 'agent_removed');\n      this.agents.delete(sessionKey);\n      this.memoryPrefetch.forgetSession(sessionKey);\n      clearBootstrapSnapshot(sessionKey);\n      this.config.getModelManager?.().clearSessionProfileDefault(sessionKey);\n      log.info({ sessionKey, totalAgents: this.agents.size }, 'Removed agent instance');\n      return true;\n    }\n    return false;\n  }\n\n  /**\n   * Get all active session keys\n   */\n  getActiveSessions(): string[] {\n    return Array.from(this.agents.keys());\n  }\n\n  /**\n   * Get agent count\n   */\n  getAgentCount(): number {\n    return this.agents.size;\n  }\n\n  /**\n   * Merge per-turn channel system prompt (e.g. Telegram group/topic override) into the agent.\n   */\n  applyTurnChannelSystemPrompt(sessionKey: string, channelSystemPrompt: string): void {\n    const trimmed = channelSystemPrompt.trim();\n    if (!trimmed) return;\n\n    const instance = this.agents.get(sessionKey);\n    if (!instance) return;\n\n    const cfg = this.config.config!;\n    const rt = this.workspaceRuntimes.getOrCreate(instance.resolvedWorkspacePath);\n    const contextFiles = this.resolveContextFilesForSession(sessionKey, instance.effectiveProfile);\n    const modelRef = instance.effectiveProfile.primaryModelRef?.trim() || this.defaultModel;\n    const thinkingLevel =\n      (instance.effectiveProfile.thinkingDefault as ThinkingLevel | undefined) ??\n      this.config.thinkingLevel ??\n      'medium';\n\n    instance.agent.state.systemPrompt = rt.systemPromptBuilder.build(contextFiles, {\n      externalMemoryInstructions: rt.memoryManager.buildExternalSystemPrompt(),\n      workspaceOverride: instance.resolvedWorkspacePath,\n      profileMarkdownPathRoot: resolveAgentProfileDir(cfg, instance.effectiveProfile.agentId),\n      systemPromptOverride: instance.effectiveProfile.systemPromptOverride,\n      skillAllowlist: instance.effectiveProfile.skillsAllowlist,\n      registeredToolNames: instance.registeredToolNames,\n      sessionKey,\n      modelRef,\n      agentId: instance.effectiveProfile.agentId,\n      thinkingLevel,\n      extraSystemPrompt: trimmed,\n    });\n  }\n\n  /**\n   * Set thinking level for a session's agent\n   */\n  setThinkingLevel(sessionKey: string, level: ThinkingLevel): void {\n    const instance = this.agents.get(sessionKey);\n    if (instance) {\n      instance.agent.state.thinkingLevel = level;\n      log.debug({ sessionKey, thinkingLevel: level }, 'Set thinking level for agent');\n    }\n  }\n\n  /**\n   * Dispose all agents\n   */\n  dispose(): void {\n    if (this.skillsUpdatedTimer) clearTimeout(this.skillsUpdatedTimer);\n    this.skillFilesystemWatcher.dispose();\n    void this.toolsFactory.shutdownBrowser();\n    void disposeAllSessionMcpRuntimes().catch(() => {});\n    evictAllEmbeddedSessionRunners('agent_manager_dispose');\n    this.backgroundReview.clear();\n    for (const instance of this.agents.values()) {\n      instance.agent.abort();\n    }\n    this.agents.clear();\n    this.memoryPrefetch.clear();\n    this.sessionWorkspaceOverrides.clear();\n    void this.workspaceRuntimes.clearAll();\n    log.debug('All agent instances disposed');\n  }\n\n  async warmCredentialCache(): Promise<void> {\n    const profiles = await this.credentialResolver.listProfiles();\n    for (const profile of profiles) {\n      const secret = profile.key?.trim()\n        ? profile.key.trim()\n        : profile.envVar\n          ? process.env[profile.envVar]?.trim()\n          : undefined;\n      if (secret) {\n        this.credentialCache.set(profile.provider.toLowerCase(), secret);\n      }\n    }\n    log.debug({ count: this.credentialCache.size }, 'Credential cache warmed');\n  }\n\n  async refreshCredentials(): Promise<void> {\n    this.credentialCache.clear();\n    await this.warmCredentialCache();\n  }\n\n  private resolveApiKeyWithCache(provider: string): string | undefined {\n    const key = provider.toLowerCase();\n    const cached = this.credentialCache.get(key);\n    if (cached) return cached;\n\n    const fromDisk = resolveProviderApiKeySync(provider);\n    if (fromDisk) {\n      this.credentialCache.set(key, fromDisk);\n      return fromDisk;\n    }\n\n    const fromRegistryOrEnv = getApiKeySync(provider);\n    if (fromRegistryOrEnv) {\n      this.credentialCache.set(key, fromRegistryOrEnv);\n      return fromRegistryOrEnv;\n    }\n    return undefined;\n  }\n\n  private createAgentForProfile(\n    sessionKey: string,\n    profile: EffectiveAgentProfile,\n    resolvedWorkspacePath: string,\n    rt: WorkspaceRuntime,\n  ): { agent: Agent; registeredToolNames: string[] } {\n    const modelRef = profile.primaryModelRef?.trim() || this.defaultModel;\n    const model = this.resolveModelStringToModel(modelRef);\n\n    const contextFiles = this.resolveContextFilesForSession(sessionKey, profile);\n    const tools = this.toolsFactory.createAllTools({\n      workspace: resolvedWorkspacePath,\n      profileMarkdownRoot: resolveAgentProfileDir(this.config.config!, profile.agentId),\n      disabledTools: profile.tools.disable,\n      getPrimaryModel: () => this.resolveModelStringToModel(modelRef),\n      getBuiltinMemoryStore: () => rt.builtinMemoryStore,\n      getMemoryManager: () => rt.memoryManager,\n      getSkillManager: () => rt.skillManager,\n    });\n    const registeredToolNames = tools.map((t) => t.name);\n\n    const thinkingLevel =\n      (profile.thinkingDefault as ThinkingLevel | undefined) ?? this.config.thinkingLevel ?? 'medium';\n\n    const agent = new Agent({\n      initialState: {\n        systemPrompt: rt.systemPromptBuilder.build(contextFiles, {\n          externalMemoryInstructions: rt.memoryManager.buildExternalSystemPrompt(),\n          workspaceOverride: resolvedWorkspacePath,\n          profileMarkdownPathRoot: resolveAgentProfileDir(this.config.config!, profile.agentId),\n          systemPromptOverride: profile.systemPromptOverride,\n          skillAllowlist: profile.skillsAllowlist,\n          registeredToolNames,\n          sessionKey,\n          modelRef,\n          agentId: profile.agentId,\n          thinkingLevel,\n        }),\n        model,\n        thinkingLevel,\n        tools,\n        messages: [],\n      },\n      streamFn: createExtensionAwareStreamFn(),\n      getApiKey: (provider: string) => this.resolveApiKeyWithCache(provider),\n      beforeToolCall: async ({ toolCall, args }) => {\n        const toolName = toolCall.name;\n\n        if (toolName === 'shell') {\n          const ctx = this.config.getCurrentContext();\n          const cfg = this.mergedConfig();\n          if (ctx && cfg) {\n            const command =\n              typeof (args as { command?: unknown })?.command === 'string'\n                ? (args as { command: string }).command\n                : JSON.stringify(args ?? {});\n            const accountId =\n              typeof ctx.metadata?.accountId === 'string' ? ctx.metadata.accountId : undefined;\n            const approval = await maybeRequestChannelExecApproval({\n              cfg,\n              payload: {\n                sessionKey: ctx.sessionKey,\n                channel: ctx.channel,\n                chatId: ctx.chatId,\n                accountId,\n                toolName,\n                summary: command.slice(0, 500),\n                details: { command: command.slice(0, 2000) },\n              },\n            });\n            if (approval.required && !approval.approved) {\n              return {\n                block: true,\n                reason: approval.reason ?? 'Exec approval denied or timed out.',\n              };\n            }\n          }\n        }\n\n        if (!this.config.hookRunner) {\n          return undefined;\n        }\n        const parsed = parseMcpToolName(toolName);\n        const hookResult = await this.config.hookRunner.runBeforeToolCall(\n          toolName,\n          (args ?? {}) as Record<string, unknown>,\n          {\n            sessionKey,\n            isMcpTool: parsed !== null,\n            mcpServerId: parsed?.serverId,\n          },\n        );\n        if (!hookResult.allowed) {\n          return { block: true, reason: hookResult.reason ?? 'Tool call blocked by policy hook.' };\n        }\n        return undefined;\n      },\n    });\n    return { agent, registeredToolNames };\n  }\n\n  /**\n   * Set model for a specific session\n   */\n  setModelForSession(sessionKey: string, modelId: string): boolean {\n    const instance = this.agents.get(sessionKey);\n    if (!instance) {\n      log.warn(\n        { sessionKey, modelId, activeSessionCount: this.agents.size },\n        `setModelForSession: no agent instance for session (create session / run turn first); modelId=${modelId}`,\n      );\n      return false;\n    }\n\n    try {\n      const model = resolveModel(modelId);\n      instance.agent.state.model = model;\n\n      const cfg = this.config.config!;\n      const rt = this.workspaceRuntimes.getOrCreate(instance.resolvedWorkspacePath);\n      const contextFiles = this.resolveContextFilesForSession(\n        sessionKey,\n        instance.effectiveProfile,\n      );\n      const thinkingLevel =\n        (instance.agent.state.thinkingLevel as ThinkingLevel | undefined) ??\n        (instance.effectiveProfile.thinkingDefault as ThinkingLevel | undefined) ??\n        this.config.thinkingLevel ??\n        'medium';\n\n      instance.agent.state.systemPrompt = rt.systemPromptBuilder.build(contextFiles, {\n        externalMemoryInstructions: rt.memoryManager.buildExternalSystemPrompt(),\n        workspaceOverride: instance.resolvedWorkspacePath,\n        profileMarkdownPathRoot: resolveAgentProfileDir(cfg, instance.effectiveProfile.agentId),\n        systemPromptOverride: instance.effectiveProfile.systemPromptOverride,\n        skillAllowlist: instance.effectiveProfile.skillsAllowlist,\n        registeredToolNames: instance.registeredToolNames,\n        sessionKey,\n        modelRef: modelId,\n        agentId: instance.effectiveProfile.agentId,\n        thinkingLevel,\n      });\n\n      log.info({ sessionKey, modelId }, 'Model set for session');\n      return true;\n    } catch (err) {\n      log.error({ err, sessionKey, modelId }, 'Failed to set model for session');\n      return false;\n    }\n  }\n\n  /**\n   * Get last assistant content from a session's agent\n   */\n  getLastAssistantContent(sessionKey: string): string | null {\n    const instance = this.agents.get(sessionKey);\n    if (!instance) {\n      return null;\n    }\n\n    const messages = instance.agent.state.messages;\n    for (let i = messages.length - 1; i >= 0; i--) {\n      const msg = messages[i];\n      if (msg.role === 'assistant') {\n        const content = msg.content;\n        if (Array.isArray(content)) {\n          return extractTextContent(content as Array<{ type: string; text?: string }>);\n        }\n        return String(content);\n      }\n    }\n    return null;\n  }\n\n  /**\n   * Replace messages for a session's agent\n   */\n  replaceMessages(sessionKey: string, messages: AgentMessage[]): boolean {\n    const instance = this.agents.get(sessionKey);\n    if (!instance) {\n      return false;\n    }\n\n    instance.agent.state.messages = messages;\n    return true;\n  }\n\n  /**\n   * Get messages for a session's agent\n   */\n  getMessages(sessionKey: string): AgentMessage[] | null {\n    const instance = this.agents.get(sessionKey);\n    if (!instance) {\n      return null;\n    }\n\n    return instance.agent.state.messages;\n  }\n\n  /**\n   * Subscribe to agent events for a session\n   */\n  subscribeToSession(sessionKey: string, callback: (event: AgentEvent) => void): (() => void) | null {\n    const instance = this.agents.get(sessionKey);\n    if (!instance) {\n      return null;\n    }\n\n    return instance.agent.subscribe(callback);\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/agent-scope.js

@@ -2,8 +2,8 @@ import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
 import { expandWorkspacePathString, init_workspace_path } from "../config/workspace-path.js";
 import { init_workspace_defaults, resolveDefaultAgentWorkspaceDir } from "../config/workspace-defaults.js";
-import { basename, isAbsolute, join, relative, resolve } from "node:path";
 import fs from "node:fs";
+import { basename, isAbsolute, join, relative, resolve } from "node:path";
 //#region src/agent/agent-scope.ts
 /**
 * Agent path and list resolution (config is the single source of truth).

package/dist/src/agent/bootstrap/load-bootstrap-files.js

@@ -1,6 +1,6 @@
 import { DEFAULT_AGENTS_FILENAME, DEFAULT_HEARTBEAT_FILENAME, DEFAULT_IDENTITY_FILENAME, DEFAULT_MEMORY_FILENAME, DEFAULT_SOUL_FILENAME, DEFAULT_TOOLS_FILENAME, DEFAULT_USER_FILENAME, stripFrontMatter } from "../context/workspace.js";
-import { join, resolve } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
 //#region src/agent/bootstrap/load-bootstrap-files.ts
 const PROFILE_LOAD_ORDER = [
 	DEFAULT_AGENTS_FILENAME,

package/dist/src/agent/context/workspace-seed.js

@@ -1,10 +1,10 @@
 import { init_agent_scope, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../agent-scope.js";
+import { WORKSPACE_FILES, init_paths } from "../../config/paths.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { WORKSPACE_FILES, init_paths } from "../../config/paths.js";
 import { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES } from "./workspace.js";
-import { dirname, join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { execFileSync } from "node:child_process";
 //#region src/agent/context/workspace-seed.ts

package/dist/src/agent/context/workspace-state.js

@@ -1,6 +1,6 @@
 import { FILENAMES, init_paths, resolveWorkspaceStatePath } from "../../config/paths.js";
-import { dirname, join } from "node:path";
 import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
 //#region src/agent/context/workspace-state.ts
 /**
 * Workspace setup metadata in `<markdownWorkspace>/.xopc/workspace.json`

package/dist/src/agent/context/workspace.js

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { parseFrontmatter } from "../../markdown/frontmatter.js";
-import { join, resolve } from "path";
 import { existsSync, readFileSync } from "fs";
+import { join, resolve } from "path";
 //#region src/agent/context/workspace.ts
 /**
 * Agent profile Markdown (filenames, load order, system prompt assembly) and

package/dist/src/agent/goals/checklist-judge.d.ts

@@ -19,11 +19,16 @@ export type ChecklistJudgeUpdate = {
     evidence?: string | null;
 };
 export type ChecklistEvaluateParsed = {
+    verdict: 'continue' | 'done' | 'blocked' | 'needs_input';
+    confidence: number;
     updates: ChecklistJudgeUpdate[];
     newItems: {
         text: string;
     }[];
     reason: string;
+    nextAction?: string;
+    missingEvidence?: string[];
+    userQuestion?: string;
 };
 export type EvaluateChecklistResult = {
     parsed: ChecklistEvaluateParsed;

package/dist/src/agent/goals/checklist-judge.js

@@ -10,7 +10,7 @@ const RESPONSE_SNIPPET = 4e3;
 const HISTORY_TRUNC = 24e3;
 const DECOMPOSE_SYSTEM = "You break a user goal into an EXTREMELY detailed checklist of concrete, verifiable completion criteria. Bias toward more items. Each item is one factual statement about finished work.\n\nReply ONLY with a single JSON object on one line:\n{\"items\":[{\"text\":\"...\"},...]}\nUse at least 3 items when the goal warrants it.";
 const DECOMPOSE_USER = "Goal:\n{goal}\n\nReturn JSON only.";
-const EVALUATE_CHECKLIST_SYSTEM = "You evaluate an autonomous agent's progress on a goal with a numbered checklist.\nFor each pending item, decide if evidence in the agent snippet and/or history excerpt shows it is satisfied.\nFlip pending→completed only with clear evidence; pending→impossible only if truly unachievable here.\nDo not regress completed/impossible items — omit them from updates.\n\nReply ONLY with one JSON object on one line. Field \"updates\" is an array of {\"index\": <1-based number>, \"status\": \"completed\" or \"impossible\", \"evidence\": \"short citation\"}. Field \"new_items\" is an array of {\"text\": \"...\"} for missing criteria. Field \"reason\" is one sentence. updates and new_items may be empty arrays.";
+const EVALUATE_CHECKLIST_SYSTEM = "You evaluate an autonomous agent's progress on a goal with a numbered checklist.\nFor each pending item, decide if evidence in the agent snippet and/or history excerpt shows it is satisfied.\nFlip pending→completed only with clear evidence; pending→impossible only if truly unachievable here.\nDo not regress completed/impossible items — omit them from updates.\n\nReply ONLY with one JSON object on one line:\n{\"verdict\":\"continue|done|blocked|needs_input\",\"confidence\":0.0,\"reason\":\"...\",\"nextAction\":\"...\",\"missingEvidence\":[\"...\"],\"userQuestion\":\"...\",\"updates\":[{\"index\":1,\"status\":\"completed|impossible\",\"evidence\":\"short citation\"}],\"new_items\":[{\"text\":\"...\"}]}\nUse verdict=done only when all checklist criteria are complete/impossible. Use needs_input when the next step requires user input. Use blocked when external progress is impossible.";
 function extractJsonObject(raw) {
 	if (!raw?.trim()) return null;
 	const text = stripCodeFences(raw);
@@ -116,6 +116,8 @@ async function evaluateGoalChecklistJudge(opts) {
 	} catch {
 		return {
 			parsed: {
+				verdict: "continue",
+				confidence: 0,
 				updates: [],
 				newItems: [],
 				reason: judgeReasonText("judge_model_not_configured", locale)
@@ -143,6 +145,8 @@ async function evaluateGoalChecklistJudge(opts) {
 		});
 		if (getAssistantMessageErrorReason(result)) return {
 			parsed: {
+				verdict: "continue",
+				confidence: 0,
 				updates: [],
 				newItems: [],
 				reason: judgeReasonText("judge_call_failed", locale)
@@ -152,6 +156,8 @@ async function evaluateGoalChecklistJudge(opts) {
 		const data = extractJsonObject(extractAssistantText(result.content));
 		if (!data) return {
 			parsed: {
+				verdict: "continue",
+				confidence: 0,
 				updates: [],
 				newItems: [],
 				reason: judgeReasonText("judge_reply_not_json", locale)
@@ -160,6 +166,13 @@ async function evaluateGoalChecklistJudge(opts) {
 		};
 		const updatesRaw = data.updates;
 		const newRaw = data.new_items ?? data.newItems;
+		const verdictRaw = String(data.verdict ?? "").trim().toLowerCase();
+		const verdict = verdictRaw === "done" || verdictRaw === "blocked" || verdictRaw === "needs_input" ? verdictRaw : "continue";
+		const confidenceRaw = Number(data.confidence);
+		const confidence = Number.isFinite(confidenceRaw) ? Math.max(0, Math.min(1, confidenceRaw)) : 0;
+		const nextAction = typeof data.nextAction === "string" ? data.nextAction.trim() : void 0;
+		const userQuestion = typeof data.userQuestion === "string" ? data.userQuestion.trim() : void 0;
+		const missingEvidenceRaw = data.missingEvidence ?? data.missing_evidence;
 		const reason = localizeJudgeReasonText((typeof data.reason === "string" ? data.reason.trim() : "") || JUDGE_REASON_EN.no_reason_provided, locale);
 		const updates = [];
 		if (Array.isArray(updatesRaw)) for (const u of updatesRaw) {
@@ -187,17 +200,28 @@ async function evaluateGoalChecklistJudge(opts) {
 				if (t) newItems.push({ text: t });
 			}
 		}
+		const missingEvidence = [];
+		if (Array.isArray(missingEvidenceRaw)) {
+			for (const item of missingEvidenceRaw) if (typeof item === "string" && item.trim()) missingEvidence.push(item.trim());
+		}
 		return {
 			parsed: {
+				verdict,
+				confidence,
 				updates,
 				newItems,
-				reason: reason || judgeReasonText("no_reason_provided", locale)
+				reason: reason || judgeReasonText("no_reason_provided", locale),
+				...nextAction ? { nextAction } : {},
+				...missingEvidence.length ? { missingEvidence } : {},
+				...userQuestion ? { userQuestion } : {}
 			},
 			parseFailed: false
 		};
 	} catch {
 		return {
 			parsed: {
+				verdict: "continue",
+				confidence: 0,
 				updates: [],
 				newItems: [],
 				reason: judgeReasonText("judge_call_failed", locale)