@xopcai/xopc 0.0.81 → 0.0.83

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 Config, getAgentDefaultModelRef } from '../config/schema.js';\nimport { applyConfigOverrides } from '../config/runtime-overrides.js';\nimport { resolveAgentProfileDir } from './agent-scope.js';\nimport {\n  type EffectiveAgentProfile,\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 { resolveBootstrapContextSync } from './bootstrap/bootstrap-files.js';\nimport type { EmbeddedContextFile } from './bootstrap/types.js';\nimport { SkillManager } from './skills/index.js';\nimport { SystemPromptBuilder } from './prompt/service-prompt-builder.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 { resolveLocalizedSkillMarkdown, resolveLocalizedSkillMeta } from './skills/skill-view-path.js';\nimport { createSkillConfigManager } 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 { BuiltinMemoryStore } from './memory/builtin-memory-store.js';\nimport { createMemoryManagerFromConfig } from './memory/create-memory-manager.js';\nimport { injectPrefetchIntoUserMessage } from './memory/inject-prefetch.js';\nimport {\n  isMemorySubsystemEnabled,\n  resolveBuiltinMemoryStoreConfig,\n  shouldInjectMemoryPrefetchThisTurn,\n  shouldRegisterCuratedMemoryTool,\n} from './memory/memory-config.js';\nimport type { MemoryManager } from './memory/manager.js';\nimport { extractAgentUserPlainText } from './memory/user-message-text.js';\nimport { resolveBackgroundReviewSettings } from './background-review/settings.js';\nimport { runBackgroundReviewTurn } from './background-review/run-background-review.js';\nimport {\n  isAssistantTurnAborted,\n  isAssistantTurnFailed,\n} from './orchestration/llm-turn-retry.js';\n\nconst log = createLogger('AgentManager');\n\n/** Counters for optional post-turn memory/skill review (see `agents.defaults.backgroundReview`). */\nexport interface BackgroundNudgeState {\n  turnsSinceMemory: number;\n  itersSinceSkill: number;\n  pendingMemoryReview: boolean;\n  unsubscribe?: () => void;\n}\n\nexport interface SkillCatalogEntry {\n  directoryId: string;\n  name: string;\n  description: 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 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}\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  backgroundNudge: BackgroundNudgeState;\n}\n\ninterface WorkspaceRuntime {\n  skillManager: SkillManager;\n  systemPromptBuilder: SystemPromptBuilder;\n  builtinMemoryStore: BuiltinMemoryStore;\n  memoryManager: MemoryManager;\n}\n\nexport class AgentManager {\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 = new Map<string, WorkspaceRuntime>();\n  /** Per-session user-message index for prefetch injection cadence. */\n  private memoryPrefetchUserTurn = new Map<string, number>();\n\n  constructor(config: AgentManagerConfig) {\n    this.config = config;\n    this.baseWorkspacePath = this.computeBaseWorkspacePath();\n    const baseRt = this.getWorkspaceRuntime(this.baseWorkspacePath);\n\n    this.toolsFactory = new AgentToolsFactory({\n      workspace: this.baseWorkspacePath,\n      extensionRegistry: config.extensionRegistry,\n      getCurrentContext: config.getCurrentContext,\n      hookRunner: config.hookRunner,\n      bus: config.bus,\n      getConfig: () => this.mergedConfig(),\n      getPrimaryModel: () => this.resolveModelStringToModel(this.pickDefaultModelRef()),\n      getBuiltinMemoryStore: () => baseRt.builtinMemoryStore,\n      getMemoryManager: () => baseRt.memoryManager,\n      getSessionStore: config.getSessionStore,\n      gatewayClarify: config.gatewayClarify,\n      getCronService: config.getCronService,\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    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 getWorkspaceRuntime(resolvedPath: string): WorkspaceRuntime {\n    const existing = this.workspaceRuntimes.get(resolvedPath);\n    if (existing) {\n      return existing;\n    }\n\n    const builtinMemoryStore = new BuiltinMemoryStore(\n      resolveBuiltinMemoryStoreConfig(resolvedPath, this.config.config),\n    );\n    const memoryManager = createMemoryManagerFromConfig(\n      resolvedPath,\n      builtinMemoryStore,\n      this.config.config,\n    );\n    const skillManager = new SkillManager(resolvedPath, resolveBundledSkillsDir());\n    const systemPromptBuilder = new SystemPromptBuilder({\n      workspace: resolvedPath,\n      config: this.config.config!,\n      skillManager,\n    });\n\n    const rt: WorkspaceRuntime = {\n      skillManager,\n      systemPromptBuilder,\n      builtinMemoryStore,\n      memoryManager,\n    };\n    this.workspaceRuntimes.set(resolvedPath, rt);\n    return rt;\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  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    for (const rt of this.workspaceRuntimes.values()) {\n      void rt.memoryManager.shutdownAll().catch(() => {});\n    }\n    this.workspaceRuntimes.clear();\n    this.toolsFactory = new AgentToolsFactory({\n      workspace: this.baseWorkspacePath,\n      extensionRegistry: this.config.extensionRegistry,\n      getCurrentContext: this.config.getCurrentContext,\n      bus: this.config.bus,\n      getConfig: () => this.mergedConfig(),\n      getPrimaryModel: () => this.resolveModelStringToModel(this.pickDefaultModelRef()),\n      getBuiltinMemoryStore: () => this.getWorkspaceRuntime(this.baseWorkspacePath).builtinMemoryStore,\n      getMemoryManager: () => this.getWorkspaceRuntime(this.baseWorkspacePath).memoryManager,\n      getSessionStore: this.config.getSessionStore,\n      gatewayClarify: this.config.gatewayClarify,\n      getCronService: this.config.getCronService,\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.getWorkspaceRuntime(this.baseWorkspacePath).memoryManager;\n  }\n\n  private getMemoryManagerForSession(sessionKey: string): MemoryManager {\n    const path = this.getResolvedWorkspaceForSession(sessionKey);\n    return this.getWorkspaceRuntime(path).memoryManager;\n  }\n\n  /**\n   * Prefix the user turn with fenced prefetched memory (external providers).\n   */\n  async applyMemoryPrefetchToUserMessage(\n    userMessage: AgentMessage,\n    sessionKey: string,\n  ): Promise<AgentMessage> {\n    if (!isMemorySubsystemEnabled(this.config.config)) {\n      return userMessage;\n    }\n    const plain = extractAgentUserPlainText(userMessage);\n    const turn = (this.memoryPrefetchUserTurn.get(sessionKey) ?? 0) + 1;\n    this.memoryPrefetchUserTurn.set(sessionKey, turn);\n    if (!shouldInjectMemoryPrefetchThisTurn(this.config.config, turn)) {\n      return userMessage;\n    }\n    return injectPrefetchIntoUserMessage(\n      this.getMemoryManagerForSession(sessionKey),\n      sessionKey,\n      userMessage,\n      plain,\n    );\n  }\n\n  /**\n   * After a completed turn: sync external providers and queue next-turn prefetch.\n   */\n  afterAgentTurn(sessionKey: string, userPlainText: string): void {\n    if (!isMemorySubsystemEnabled(this.config.config)) {\n      return;\n    }\n    const assistant = this.getLastAssistantContent(sessionKey) ?? '';\n    const mm = this.getMemoryManagerForSession(sessionKey);\n    mm.syncAll(userPlainText, assistant, { sessionId: sessionKey });\n    mm.queuePrefetchAll(userPlainText, { sessionId: sessionKey });\n  }\n\n  /**\n   * Call once per user turn before the main `agent.prompt` (via {@link runAgentTurnWithModelFallbacks} `beforeUserPrompt`).\n   */\n  beginBackgroundReviewUserTurn(sessionKey: string): void {\n    const inst = this.agents.get(sessionKey);\n    if (!inst?.backgroundNudge) return;\n    const cfg = resolveBackgroundReviewSettings(this.config.config);\n    if (!cfg.enabled || cfg.memoryNudgeInterval <= 0) return;\n    if (!inst.registeredToolNames.includes('curated_memory')) return;\n    inst.backgroundNudge.turnsSinceMemory += 1;\n    if (inst.backgroundNudge.turnsSinceMemory >= cfg.memoryNudgeInterval) {\n      inst.backgroundNudge.pendingMemoryReview = true;\n      inst.backgroundNudge.turnsSinceMemory = 0;\n    }\n  }\n\n  /**\n   * After a successful main turn (after memory sync via `afterAgentTurn`), may run a quiet follow-up for memory/skills.\n   */\n  scheduleBackgroundReviewAfterUserTurn(sessionKey: string): void {\n    void this.runBackgroundReviewIfNeeded(sessionKey).catch((err) => {\n      log.warn({ err, sessionKey }, 'Background review failed');\n    });\n  }\n\n  private async runBackgroundReviewIfNeeded(sessionKey: string): Promise<void> {\n    const inst = this.agents.get(sessionKey);\n    if (!inst?.backgroundNudge) return;\n    const settings = resolveBackgroundReviewSettings(this.config.config);\n    if (!settings.enabled) return;\n    if (isAssistantTurnAborted(inst.agent) || isAssistantTurnFailed(inst.agent)) return;\n    const last = this.getLastAssistantContent(sessionKey);\n    if (!last?.trim()) return;\n\n    const reviewMemory = inst.backgroundNudge.pendingMemoryReview;\n    inst.backgroundNudge.pendingMemoryReview = false;\n\n    let reviewSkills = false;\n    if (settings.skillNudgeInterval > 0 && inst.registeredToolNames.includes('skill_manage')) {\n      if (inst.backgroundNudge.itersSinceSkill >= settings.skillNudgeInterval) {\n        reviewSkills = true;\n        inst.backgroundNudge.itersSinceSkill = 0;\n      }\n    }\n\n    if (!reviewMemory && !reviewSkills) return;\n\n    const rt = this.getWorkspaceRuntime(inst.resolvedWorkspacePath);\n    await runBackgroundReviewTurn({\n      sessionKey,\n      mainAgent: inst.agent,\n      settings,\n      reviewMemory,\n      reviewSkills,\n      registeredToolNames: inst.registeredToolNames,\n      skillAllowlist: inst.effectiveProfile.skillsAllowlist,\n      workspacePath: inst.resolvedWorkspacePath,\n      skillManager: rt.skillManager,\n      builtinMemoryStore: rt.builtinMemoryStore,\n      memoryManager: rt.memoryManager,\n      getConfig: () => this.mergedConfig(),\n      onSkillsFilesystemMutate: () => this.refreshSkillsAfterDiskChange(),\n    });\n  }\n\n  private attachBackgroundNudgeListeners(sessionKey: string): void {\n    const inst = this.agents.get(sessionKey);\n    if (!inst?.backgroundNudge) return;\n    inst.backgroundNudge.unsubscribe?.();\n    const unsub = inst.agent.subscribe((ev: AgentEvent) => {\n      const cfg = resolveBackgroundReviewSettings(this.config.config);\n      if (!cfg.enabled || cfg.skillNudgeInterval <= 0) return;\n      if (!inst.registeredToolNames.includes('skill_manage')) return;\n      if (ev.type === 'turn_start') {\n        inst.backgroundNudge.itersSinceSkill += 1;\n      }\n      if (ev.type === 'tool_execution_end') {\n        const te = ev as Extract<AgentEvent, { type: 'tool_execution_end' }>;\n        if (\n          !te.isError &&\n          typeof te.toolName === 'string' &&\n          te.toolName.trim() === 'skill_manage'\n        ) {\n          inst.backgroundNudge.itersSinceSkill = 0;\n        }\n      }\n    });\n    inst.backgroundNudge.unsubscribe = unsub;\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 path = ctx?.sessionKey\n      ? this.getResolvedWorkspaceForSession(ctx.sessionKey)\n      : this.baseWorkspacePath;\n    return this.getWorkspaceRuntime(path).skillManager.expandCommand(text);\n  }\n\n  /**\n   * Structured SKILL.md preview for the gateway console.\n   * When `lang` is provided (e.g. \"zh\"), tries SKILL-{lang}.md first; falls back to SKILL.md.\n   */\n  getSkillMarkdownSource(skillName: string, lang?: string): SkillMarkdownPreviewPayload | null {\n    const skill = this.getWorkspaceRuntime(this.baseWorkspacePath).skillManager.findSkill(skillName);\n    if (!skill) return null;\n\n    // Try localized file for display\n    if (lang) {\n      const localized = resolveLocalizedSkillMarkdown(skill, lang);\n      if (localized) return localized;\n    }\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 { contextFiles } = resolveBootstrapContextSync({\n      profileDir,\n      config: cfg,\n      sessionKey,\n      excludeHeartbeat: excludeHeartbeat ?? !heartbeatEnabled,\n    });\n    return contextFiles;\n  }\n\n  getSkillCatalog(lang?: string): SkillCatalogEntry[] {\n    const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n    const lock = loadSkillsLock();\n    return this.getWorkspaceRuntime(this.baseWorkspacePath).skillManager.getSkills().map((s) => {\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      // Attempt localized name/description for display\n      const localized = lang ? resolveLocalizedSkillMeta(s, lang) : null;\n\n      return {\n        directoryId,\n        name: localized?.name ?? s.name,\n        description: localized?.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\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.getWorkspaceRuntime(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      });\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.getWorkspaceRuntime(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      });\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        if (!existing.backgroundNudge) {\n          existing.backgroundNudge = {\n            turnsSinceMemory: 0,\n            itersSinceSkill: 0,\n            pendingMemoryReview: false,\n          };\n          this.attachBackgroundNudgeListeners(sessionKey);\n        }\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.getWorkspaceRuntime(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      backgroundNudge: {\n        turnsSinceMemory: 0,\n        itersSinceSkill: 0,\n        pendingMemoryReview: false,\n      },\n    });\n\n    this.attachBackgroundNudgeListeners(sessionKey);\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      instance.backgroundNudge?.unsubscribe?.();\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.memoryPrefetchUserTurn.delete(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   * 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    for (const instance of this.agents.values()) {\n      instance.backgroundNudge?.unsubscribe?.();\n      instance.agent.abort();\n    }\n    this.agents.clear();\n    this.memoryPrefetchUserTurn.clear();\n    this.sessionWorkspaceOverrides.clear();\n    for (const rt of this.workspaceRuntimes.values()) {\n      void rt.memoryManager.shutdownAll().catch(() => {});\n    }\n    this.workspaceRuntimes.clear();\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        }),\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        if (!this.config.hookRunner) {\n          return undefined;\n        }\n        const toolName = toolCall.name;\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      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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAc2E;kBAEjB;qBAKc;aAEtB;yBACwB;gBACe;kBAE7B;YACkB;AA6C9E,MAAM,MAAM,aAAa,eAAe;AAmExC,IAAa,eAAb,MAA0B;CACxB,yBAAiB,IAAI,KAA4B;CACjD;CACA;CAEA,eAA2C;EACzC,MAAM,OAAO,KAAK,OAAO;AACzB,SAAO,OAAO,qBAAqB,KAAK,GAAG,KAAA;;;CAG7C;;CAEA,4CAAoC,IAAI,KAAqB;CAC7D;CACA,kCAA0B,IAAI,KAAqB;CACnD;CACA,oCAA4B,IAAI,KAA+B;;CAE/D,yCAAiC,IAAI,KAAqB;CAE1D,YAAY,QAA4B;AACtC,OAAK,SAAS;AACd,OAAK,oBAAoB,KAAK,0BAA0B;EACxD,MAAM,SAAS,KAAK,oBAAoB,KAAK,kBAAkB;AAE/D,OAAK,eAAe,IAAI,kBAAkB;GACxC,WAAW,KAAK;GAChB,mBAAmB,OAAO;GAC1B,mBAAmB,OAAO;GAC1B,YAAY,OAAO;GACnB,KAAK,OAAO;GACZ,iBAAiB,KAAK,cAAc;GACpC,uBAAuB,KAAK,0BAA0B,KAAK,qBAAqB,CAAC;GACjF,6BAA6B,OAAO;GACpC,wBAAwB,OAAO;GAC/B,iBAAiB,OAAO;GACxB,gBAAgB,OAAO;GACvB,gBAAgB,OAAO;GACvB,+BAA+B;IAC7B,MAAM,MAAM,KAAK,OAAO,qBAAqB;AAC7C,QAAI,CAAC,KAAK,WAAY,QAAO,KAAA;IAC7B,MAAM,OAAO,KAAK,OAAO,IAAI,IAAI,WAAW;AAC5C,QAAI,CAAC,KAAM,QAAO,KAAA;AAClB,WAAO;KACL,qBAAqB,KAAK;KAC1B,gBAAgB,KAAK,iBAAiB;KACvC;;GAEH,gCAAgC;AAC9B,SAAK,8BAA8B;;GAErC,sCAAsC;IACpC,MAAM,MAAM,KAAK,OAAO,qBAAqB;AAC7C,QAAI,CAAC,KAAK,WAAY,QAAO,EAAE;AAC/B,WAAO,CAAC,GAAI,KAAK,OAAO,IAAI,IAAI,WAAW,EAAE,2BAA2B,EAAE,CAAE;;GAE9E,8BAA8B,UAAoB;IAChD,MAAM,MAAM,KAAK,OAAO,qBAAqB;AAC7C,QAAI,CAAC,KAAK,WAAY;IACtB,MAAM,OAAO,KAAK,OAAO,IAAI,IAAI,WAAW;AAC5C,QAAI,CAAC,KAAM;AACX,SAAK,MAAM,KAAK,MACd,KAAI,uBAAuB,EAAE,CAC3B,MAAK,wBAAwB,IAAI,EAAE,MAAM,CAAC;;GAIjD,CAAC;AAEF,OAAK,eAAe,OAAO,SAAS,oBAAoB,OAAO,OAAO;AAEtE,OAAK,qBAAqB,IAAI,oBAAoB;AAClD,OAAK,qBAAqB,CAAC,OAAO,QAAQ;GACxC,MAAM,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAC3D,OAAI,KAAK;IAAE;IAAK,cAAc;IAAI,EAAE,qCAAqC,KAAK;IAC9E;;CAGJ,2BAA2C;EACzC,MAAM,MAAM,KAAK,OAAO;AACxB,MAAI,CAAC,IACH,QAAO,0BAA0B,KAAK,OAAO,UAAU;AAEzD,SAAO,uCAAuC,KAAK,KAAK,CAAC;;;;;;CAO3D,+BAA+B,YAA4B;EACzD,MAAM,MAAM,KAAK,OAAO;EACxB,MAAM,UAAU,KAAK,0BAA0B,IAAI,WAAW;AAC9D,MAAI,YAAY,KAAA,EACd,QAAO;AAET,SAAO,uCAAuC,KAAK,WAAW,CAAC;;;;;;CAOjE,4BAA4B,YAAoB,cAAmC;AACjF,MAAI,iBAAiB,QAAQ,iBAAiB,GAC5C,MAAK,0BAA0B,OAAO,WAAW;MAEjD,MAAK,0BAA0B,IAAI,YAAY,aAAa;;;CAKhE,6BACE,YACiE;EACjE,MAAM,MAAM,KAAK,cAAc;AAC/B,MAAI,CAAC,IACH;AAEF,SAAO,uCAAuC,KAAK,WAAW,CAAC;;CAGjE,oBAA4B,cAAwC;EAClE,MAAM,WAAW,KAAK,kBAAkB,IAAI,aAAa;AACzD,MAAI,SACF,QAAO;EAGT,MAAM,qBAAqB,IAAI,mBAC7B,gCAAgC,cAAc,KAAK,OAAO,OAAO,CAClE;EACD,MAAM,gBAAgB,8BACpB,cACA,oBACA,KAAK,OAAO,OACb;EACD,MAAM,eAAe,IAAI,aAAa,cAAc,yBAAyB,CAAC;EAO9E,MAAM,KAAuB;GAC3B;GACA,qBAAA,IAR8B,oBAAoB;IAClD,WAAW;IACX,QAAQ,KAAK,OAAO;IACpB;IACD,CAIoB;GACnB;GACA;GACD;AACD,OAAK,kBAAkB,IAAI,cAAc,GAAG;AAC5C,SAAO;;CAGT,sBAAsC;EACpC,MAAM,MAAM,KAAK,cAAc;AAE/B,SADY,wBAAwB,IAC1B,EAAE,MAAM,IAAI,oBAAoB,IAAI;;CAGhD,0BAAkC,UAA8B;AAC9D,MAAI;AACF,UAAO,aAAa,SAAS;UACvB;GACN,MAAM,WAAW,oBAAoB,KAAK,cAAc,CAAC;AACzD,OAAI,KAAK;IAAE;IAAU;IAAU,EAAE,iCAAiC;AAClE,UAAO,aAAa,SAAS;;;;;;CAOjC,oBAAoB,QAAsB;AACxC,OAAK,OAAO,SAAS;EACrB,MAAM,MAAM,wBAAwB,OAAO;AAC3C,OAAK,OAAO,QAAQ;AACpB,OAAK,eAAe,OAAO,oBAAoB,OAAO;AACtD,OAAK,oBAAoB,KAAK,0BAA0B;AACnD,OAAK,aAAa,iBAAiB;AACxC,OAAK,MAAM,MAAM,KAAK,kBAAkB,QAAQ,CACzC,IAAG,cAAc,aAAa,CAAC,YAAY,GAAG;AAErD,OAAK,kBAAkB,OAAO;AAC9B,OAAK,eAAe,IAAI,kBAAkB;GACxC,WAAW,KAAK;GAChB,mBAAmB,KAAK,OAAO;GAC/B,mBAAmB,KAAK,OAAO;GAC/B,KAAK,KAAK,OAAO;GACjB,iBAAiB,KAAK,cAAc;GACpC,uBAAuB,KAAK,0BAA0B,KAAK,qBAAqB,CAAC;GACjF,6BAA6B,KAAK,oBAAoB,KAAK,kBAAkB,CAAC;GAC9E,wBAAwB,KAAK,oBAAoB,KAAK,kBAAkB,CAAC;GACzE,iBAAiB,KAAK,OAAO;GAC7B,gBAAgB,KAAK,OAAO;GAC5B,gBAAgB,KAAK,OAAO;GAC5B,+BAA+B;IAC7B,MAAM,MAAM,KAAK,OAAO,qBAAqB;AAC7C,QAAI,CAAC,KAAK,WAAY,QAAO,KAAA;IAC7B,MAAM,OAAO,KAAK,OAAO,IAAI,IAAI,WAAW;AAC5C,QAAI,CAAC,KAAM,QAAO,KAAA;AAClB,WAAO;KACL,qBAAqB,KAAK;KAC1B,gBAAgB,KAAK,iBAAiB;KACvC;;GAEH,gCAAgC;AAC9B,SAAK,8BAA8B;;GAErC,sCAAsC;IACpC,MAAM,MAAM,KAAK,OAAO,qBAAqB;AAC7C,QAAI,CAAC,KAAK,WAAY,QAAO,EAAE;AAC/B,WAAO,CAAC,GAAI,KAAK,OAAO,IAAI,IAAI,WAAW,EAAE,2BAA2B,EAAE,CAAE;;GAE9E,8BAA8B,UAAoB;IAChD,MAAM,MAAM,KAAK,OAAO,qBAAqB;AAC7C,QAAI,CAAC,KAAK,WAAY;IACtB,MAAM,OAAO,KAAK,OAAO,IAAI,IAAI,WAAW;AAC5C,QAAI,CAAC,KAAM;AACX,SAAK,MAAM,KAAK,MACd,KAAI,uBAAuB,EAAE,CAC3B,MAAK,wBAAwB,IAAI,EAAE,MAAM,CAAC;;GAIjD,CAAC;;CAGJ,mBAAkC;AAChC,SAAO,KAAK,oBAAoB,KAAK,kBAAkB,CAAC;;CAG1D,2BAAmC,YAAmC;EACpE,MAAM,OAAO,KAAK,+BAA+B,WAAW;AAC5D,SAAO,KAAK,oBAAoB,KAAK,CAAC;;;;;CAMxC,MAAM,iCACJ,aACA,YACuB;AACvB,MAAI,CAAC,yBAAyB,KAAK,OAAO,OAAO,CAC/C,QAAO;EAET,MAAM,QAAQ,0BAA0B,YAAY;EACpD,MAAM,QAAQ,KAAK,uBAAuB,IAAI,WAAW,IAAI,KAAK;AAClE,OAAK,uBAAuB,IAAI,YAAY,KAAK;AACjD,MAAI,CAAC,mCAAmC,KAAK,OAAO,QAAQ,KAAK,CAC/D,QAAO;AAET,SAAO,8BACL,KAAK,2BAA2B,WAAW,EAC3C,YACA,aACA,MACD;;;;;CAMH,eAAe,YAAoB,eAA6B;AAC9D,MAAI,CAAC,yBAAyB,KAAK,OAAO,OAAO,CAC/C;EAEF,MAAM,YAAY,KAAK,wBAAwB,WAAW,IAAI;EAC9D,MAAM,KAAK,KAAK,2BAA2B,WAAW;AACtD,KAAG,QAAQ,eAAe,WAAW,EAAE,WAAW,YAAY,CAAC;AAC/D,KAAG,iBAAiB,eAAe,EAAE,WAAW,YAAY,CAAC;;;;;CAM/D,8BAA8B,YAA0B;EACtD,MAAM,OAAO,KAAK,OAAO,IAAI,WAAW;AACxC,MAAI,CAAC,MAAM,gBAAiB;EAC5B,MAAM,MAAM,gCAAgC,KAAK,OAAO,OAAO;AAC/D,MAAI,CAAC,IAAI,WAAW,IAAI,uBAAuB,EAAG;AAClD,MAAI,CAAC,KAAK,oBAAoB,SAAS,iBAAiB,CAAE;AAC1D,OAAK,gBAAgB,oBAAoB;AACzC,MAAI,KAAK,gBAAgB,oBAAoB,IAAI,qBAAqB;AACpE,QAAK,gBAAgB,sBAAsB;AAC3C,QAAK,gBAAgB,mBAAmB;;;;;;CAO5C,sCAAsC,YAA0B;AACzD,OAAK,4BAA4B,WAAW,CAAC,OAAO,QAAQ;AAC/D,OAAI,KAAK;IAAE;IAAK;IAAY,EAAE,2BAA2B;IACzD;;CAGJ,MAAc,4BAA4B,YAAmC;EAC3E,MAAM,OAAO,KAAK,OAAO,IAAI,WAAW;AACxC,MAAI,CAAC,MAAM,gBAAiB;EAC5B,MAAM,WAAW,gCAAgC,KAAK,OAAO,OAAO;AACpE,MAAI,CAAC,SAAS,QAAS;AACvB,MAAI,uBAAuB,KAAK,MAAM,IAAI,sBAAsB,KAAK,MAAM,CAAE;AAE7E,MAAI,CADS,KAAK,wBAAwB,WACjC,EAAE,MAAM,CAAE;EAEnB,MAAM,eAAe,KAAK,gBAAgB;AAC1C,OAAK,gBAAgB,sBAAsB;EAE3C,IAAI,eAAe;AACnB,MAAI,SAAS,qBAAqB,KAAK,KAAK,oBAAoB,SAAS,eAAe;OAClF,KAAK,gBAAgB,mBAAmB,SAAS,oBAAoB;AACvE,mBAAe;AACf,SAAK,gBAAgB,kBAAkB;;;AAI3C,MAAI,CAAC,gBAAgB,CAAC,aAAc;EAEpC,MAAM,KAAK,KAAK,oBAAoB,KAAK,sBAAsB;AAC/D,QAAM,wBAAwB;GAC5B;GACA,WAAW,KAAK;GAChB;GACA;GACA;GACA,qBAAqB,KAAK;GAC1B,gBAAgB,KAAK,iBAAiB;GACtC,eAAe,KAAK;GACpB,cAAc,GAAG;GACjB,oBAAoB,GAAG;GACvB,eAAe,GAAG;GAClB,iBAAiB,KAAK,cAAc;GACpC,gCAAgC,KAAK,8BAA8B;GACpE,CAAC;;CAGJ,+BAAuC,YAA0B;EAC/D,MAAM,OAAO,KAAK,OAAO,IAAI,WAAW;AACxC,MAAI,CAAC,MAAM,gBAAiB;AAC5B,OAAK,gBAAgB,eAAe;EACpC,MAAM,QAAQ,KAAK,MAAM,WAAW,OAAmB;GACrD,MAAM,MAAM,gCAAgC,KAAK,OAAO,OAAO;AAC/D,OAAI,CAAC,IAAI,WAAW,IAAI,sBAAsB,EAAG;AACjD,OAAI,CAAC,KAAK,oBAAoB,SAAS,eAAe,CAAE;AACxD,OAAI,GAAG,SAAS,aACd,MAAK,gBAAgB,mBAAmB;AAE1C,OAAI,GAAG,SAAS,sBAAsB;IACpC,MAAM,KAAK;AACX,QACE,CAAC,GAAG,WACJ,OAAO,GAAG,aAAa,YACvB,GAAG,SAAS,MAAM,KAAK,eAEvB,MAAK,gBAAgB,kBAAkB;;IAG3C;AACF,OAAK,gBAAgB,cAAc;;;;;CAMrC,oBAAoB,MAAsB;EACxC,MAAM,MAAM,KAAK,OAAO,qBAAqB;EAC7C,MAAM,OAAO,KAAK,aACd,KAAK,+BAA+B,IAAI,WAAW,GACnD,KAAK;AACT,SAAO,KAAK,oBAAoB,KAAK,CAAC,aAAa,cAAc,KAAK;;;;;;CAOxE,uBAAuB,WAAmB,MAAmD;EAC3F,MAAM,QAAQ,KAAK,oBAAoB,KAAK,kBAAkB,CAAC,aAAa,UAAU,UAAU;AAChG,MAAI,CAAC,MAAO,QAAO;AAGnB,MAAI,MAAM;GACR,MAAM,YAAY,8BAA8B,OAAO,KAAK;AAC5D,OAAI,UAAW,QAAO;;AAGxB,SAAO;GACL,MAAM,MAAM;GACZ,aAAa,MAAM;GACnB,cAAc,MAAM;GACpB,wBAAwB,MAAM;GAC9B,UAAU,MAAM;GAChB,gBAAgB,MAAM;GACtB,qBAAqB,MAAM;GAC5B;;CAGH,8BAAsC,SAA6E;EACjH,MAAM,MAAM,KAAK,OAAO;AAExB,SAAO,yBADY,uBAAuB,KAAK,QAAQ,QACb,CAAC;;CAG7C,8BACE,YACA,SACA,kBACuB;EACvB,MAAM,MAAM,KAAK,OAAO;EACxB,MAAM,aAAa,uBAAuB,KAAK,QAAQ,QAAQ;EAC/D,MAAM,mBAAmB,IAAI,SAAS,WAAW,8BAA8B;EAC/E,MAAM,EAAE,iBAAiB,4BAA4B;GACnD;GACA,QAAQ;GACR;GACA,kBAAkB,oBAAoB,CAAC;GACxC,CAAC;AACF,SAAO;;CAGT,gBAAgB,MAAoC;EAClD,MAAM,eAAe,yBAAyB,iBAAiB,CAAC,CAAC,MAAM;EACvE,MAAM,OAAO,gBAAgB;AAC7B,SAAO,KAAK,oBAAoB,KAAK,kBAAkB,CAAC,aAAa,WAAW,CAAC,KAAK,MAAM;GAC1F,MAAM,OAAO,QAAQ,EAAE,QAAQ;GAC/B,MAAM,UAAU,wBAAwB,EAAE,QAAQ;GAClD,MAAM,cAAc,KAAK,MAAM,IAAI,CAAC,OAAO,QAAQ,CAAC,KAAK,IAAI,EAAE;GAC/D,MAAM,UAAU,EAAE,aAAa,UAAU,EAAE,OAAO,YAAY;GAC9D,MAAM,SAAS,UAAU,SAAS,KAAK,GAAG;GAC1C,MAAM,MAAM,WAAW,SAAS,KAAK,QAAQ,UAAU,KAAA;GAGvD,MAAM,YAAY,OAAO,0BAA0B,GAAG,KAAK,GAAG;AAE9D,UAAO;IACL;IACA,MAAM,WAAW,QAAQ,EAAE;IAC3B,aAAa,WAAW,eAAe,EAAE;IACzC,UAAU,EAAE;IACZ,QAAQ,EAAE;IACV,MAAM,EAAE;IACR;IACA;IACA,wBAAwB,EAAE;IAC1B,GAAI,MAAM,EAAE,KAAK,GAAG,EAAE;IACvB;IACD;;;;;CAMJ,sCAA4C;EAC1C,MAAM,MAAM,KAAK,OAAO;EACxB,MAAM,0BAAU,IAAI,KAAa;AACjC,OAAK,MAAM,YAAY,KAAK,OAAO,QAAQ,EAAE;GAC3C,MAAM,KAAK,KAAK,oBAAoB,SAAS,sBAAsB;AACnE,OAAI,CAAC,QAAQ,IAAI,SAAS,sBAAsB,EAAE;AAChD,OAAG,aAAa,yBAAyB;AACzC,YAAQ,IAAI,SAAS,sBAAsB;;GAE7C,MAAM,eAAe,KAAK,8BACxB,SAAS,YACT,SAAS,iBACV;GACD,MAAM,YAAY,GAAG,oBAAoB,MAAM,cAAc;IAC3D,4BAA4B,GAAG,cAAc,2BAA2B;IACxE,mBAAmB,SAAS;IAC5B,yBAAyB,uBAAuB,KAAK,SAAS,iBAAiB,QAAQ;IACvF,sBAAsB,SAAS,iBAAiB;IAChD,gBAAgB,SAAS,iBAAiB;IAC1C,qBAAqB,SAAS;IAC/B,CAAC;AACF,YAAS,MAAM,MAAM,eAAe;;AAEtC,MAAI,KAAK,EAAE,QAAQ,KAAK,OAAO,MAAM,EAAE,+CAA+C;;;;;CAMxF,+BAAqC;EACnC,MAAM,MAAM,KAAK,OAAO;AAIxB,OAAK,MAAM,MAAM,KAAK,kBAAkB,QAAQ,CAC9C,IAAG,aAAa,QAAQ;EAG1B,MAAM,0BAAU,IAAI,KAAa;AACjC,OAAK,MAAM,YAAY,KAAK,OAAO,QAAQ,EAAE;GAC3C,MAAM,KAAK,KAAK,oBAAoB,SAAS,sBAAsB;AACnE,OAAI,CAAC,QAAQ,IAAI,SAAS,sBAAsB,CAC9C,SAAQ,IAAI,SAAS,sBAAsB;GAE7C,MAAM,eAAe,KAAK,8BACxB,SAAS,YACT,SAAS,iBACV;GACD,MAAM,YAAY,GAAG,oBAAoB,QAAQ,cAAc;IAC7D,4BAA4B,GAAG,cAAc,2BAA2B;IACxE,mBAAmB,SAAS;IAC5B,yBAAyB,uBAAuB,KAAK,SAAS,iBAAiB,QAAQ;IACvF,sBAAsB,SAAS,iBAAiB;IAChD,gBAAgB,SAAS,iBAAiB;IAC1C,qBAAqB,SAAS;IAC/B,CAAC;AACF,YAAS,MAAM,MAAM,eAAe;;AAEtC,MAAI,KAAK,EAAE,QAAQ,KAAK,OAAO,MAAM,EAAE,0CAA0C;;;;;CAMnF,iBAAiB,YAA2B;EAC1C,MAAM,MAAM,KAAK,OAAO;EACxB,MAAM,aAAa,KAAK,+BAA+B,WAAW;EAClE,MAAM,WAAW,KAAK,OAAO,IAAI,WAAW;AAC5C,MAAI,SACF,KAAI,SAAS,0BAA0B,WACrC,MAAK,YAAY,WAAW;OACvB;AACL,YAAS,aAAa,KAAK,KAAK;AAChC,OAAI,CAAC,SAAS,iBAAiB;AAC7B,aAAS,kBAAkB;KACzB,kBAAkB;KAClB,iBAAiB;KACjB,qBAAqB;KACtB;AACD,SAAK,+BAA+B,WAAW;;AAEjD,OAAI,MAAM,EAAE,YAAY,EAAE,kCAAkC;AAC5D,UAAO,SAAS;;EAIpB,MAAM,UAAU,uCAAuC,KAAK,WAAW;EACvE,MAAM,eAAe;EACrB,MAAM,KAAK,KAAK,oBAAoB,aAAa;AAEjD,MAAI,yBAAyB,IAAI,CAC1B,IAAG,cACL,cAAc,YAAY,EAAE,WAAW,cAAc,CAAC,CACtD,OAAO,QAAQ,IAAI,KAAK;GAAE;GAAK;GAAY,EAAE,8BAA8B,CAAC;AAGjF,MAAI,yBAAyB,IAAI,IAAI,gCAAgC,IAAI,CACvE,IAAG,mBAAmB,kBAAkB;EAG1C,MAAM,EAAE,OAAO,wBAAwB,KAAK,sBAC1C,YACA,SACA,cACA,GACD;AAED,OAAK,OAAO,IAAI,YAAY;GAC1B;GACA;GACA,WAAW,KAAK,KAAK;GACrB,YAAY,KAAK,KAAK;GACtB,kBAAkB;GAClB,uBAAuB;GACvB;GACA,yCAAyB,IAAI,KAAa;GAC1C,iBAAiB;IACf,kBAAkB;IAClB,iBAAiB;IACjB,qBAAqB;IACtB;GACF,CAAC;AAEF,OAAK,+BAA+B,WAAW;EAE/C,MAAM,WAAW,QAAQ,iBAAiB,MAAM,IAAI,KAAK;AACzD,OAAK,OAAO,mBAAmB,CAAC,yBAAyB,YAAY,SAAS;AAE9E,MAAI,MAAM;GAAE;GAAY,aAAa,KAAK,OAAO;GAAM,SAAS,QAAQ;GAAS,EAAE,6BAA6B;AAChH,SAAO;;;;;CAMT,SAAS,YAAuC;AAC9C,SAAO,KAAK,OAAO,IAAI,WAAW,EAAE;;;;;CAMtC,SAAS,YAA6B;AACpC,SAAO,KAAK,OAAO,IAAI,WAAW;;;;;CAMpC,YAAY,YAA6B;EACvC,MAAM,WAAW,KAAK,OAAO,IAAI,WAAW;AAC5C,MAAI,UAAU;AACZ,YAAS,iBAAiB,eAAe;AACpC,QAAK,aAAa,2BAA2B,WAAW;AACxD,wCAAqC;IAAE;IAAY,QAAQ;IAAe,CAAC;AAChF,YAAS,MAAM,OAAO;AACtB,8BAA2B,YAAY,gBAAgB;AACvD,QAAK,OAAO,OAAO,WAAW;AAC9B,QAAK,uBAAuB,OAAO,WAAW;AAC9C,QAAK,OAAO,mBAAmB,CAAC,2BAA2B,WAAW;AACtE,OAAI,KAAK;IAAE;IAAY,aAAa,KAAK,OAAO;IAAM,EAAE,yBAAyB;AACjF,UAAO;;AAET,SAAO;;;;;CAMT,oBAA8B;AAC5B,SAAO,MAAM,KAAK,KAAK,OAAO,MAAM,CAAC;;;;;CAMvC,gBAAwB;AACtB,SAAO,KAAK,OAAO;;;;;CAMrB,iBAAiB,YAAoB,OAA4B;EAC/D,MAAM,WAAW,KAAK,OAAO,IAAI,WAAW;AAC5C,MAAI,UAAU;AACZ,YAAS,MAAM,MAAM,gBAAgB;AACrC,OAAI,MAAM;IAAE;IAAY,eAAe;IAAO,EAAE,+BAA+B;;;;;;CAOnF,UAAgB;AACT,OAAK,aAAa,iBAAiB;AACnC,gCAA8B,CAAC,YAAY,GAAG;AACnD,iCAA+B,wBAAwB;AACvD,OAAK,MAAM,YAAY,KAAK,OAAO,QAAQ,EAAE;AAC3C,YAAS,iBAAiB,eAAe;AACzC,YAAS,MAAM,OAAO;;AAExB,OAAK,OAAO,OAAO;AACnB,OAAK,uBAAuB,OAAO;AACnC,OAAK,0BAA0B,OAAO;AACtC,OAAK,MAAM,MAAM,KAAK,kBAAkB,QAAQ,CACzC,IAAG,cAAc,aAAa,CAAC,YAAY,GAAG;AAErD,OAAK,kBAAkB,OAAO;AAC9B,MAAI,MAAM,+BAA+B;;CAG3C,MAAM,sBAAqC;EACzC,MAAM,WAAW,MAAM,KAAK,mBAAmB,cAAc;AAC7D,OAAK,MAAM,WAAW,UAAU;GAC9B,MAAM,SAAS,QAAQ,KAAK,MAAM,GAC9B,QAAQ,IAAI,MAAM,GAClB,QAAQ,SACN,QAAQ,IAAI,QAAQ,SAAS,MAAM,GACnC,KAAA;AACN,OAAI,OACF,MAAK,gBAAgB,IAAI,QAAQ,SAAS,aAAa,EAAE,OAAO;;AAGpE,MAAI,MAAM,EAAE,OAAO,KAAK,gBAAgB,MAAM,EAAE,0BAA0B;;CAG5E,MAAM,qBAAoC;AACxC,OAAK,gBAAgB,OAAO;AAC5B,QAAM,KAAK,qBAAqB;;CAGlC,uBAA+B,UAAsC;EACnE,MAAM,MAAM,SAAS,aAAa;EAClC,MAAM,SAAS,KAAK,gBAAgB,IAAI,IAAI;AAC5C,MAAI,OAAQ,QAAO;EAEnB,MAAM,WAAW,0BAA0B,SAAS;AACpD,MAAI,UAAU;AACZ,QAAK,gBAAgB,IAAI,KAAK,SAAS;AACvC,UAAO;;EAGT,MAAM,oBAAoB,cAAc,SAAS;AACjD,MAAI,mBAAmB;AACrB,QAAK,gBAAgB,IAAI,KAAK,kBAAkB;AAChD,UAAO;;;CAKX,sBACE,YACA,SACA,uBACA,IACiD;EACjD,MAAM,WAAW,QAAQ,iBAAiB,MAAM,IAAI,KAAK;EACzD,MAAM,QAAQ,KAAK,0BAA0B,SAAS;EAEtD,MAAM,eAAe,KAAK,8BAA8B,YAAY,QAAQ;EAC5E,MAAM,QAAQ,KAAK,aAAa,eAAe;GAC7C,WAAW;GACX,qBAAqB,uBAAuB,KAAK,OAAO,QAAS,QAAQ,QAAQ;GACjF,eAAe,QAAQ,MAAM;GAC7B,uBAAuB,KAAK,0BAA0B,SAAS;GAC/D,6BAA6B,GAAG;GAChC,wBAAwB,GAAG;GAC3B,uBAAuB,GAAG;GAC3B,CAAC;EACF,MAAM,sBAAsB,MAAM,KAAK,MAAM,EAAE,KAAK;EAEpD,MAAM,gBACH,QAAQ,mBAAiD,KAAK,OAAO,iBAAiB;AAwCzF,SAAO;GAAE,OAAA,IAtCS,MAAM;IACtB,cAAc;KACZ,cAAc,GAAG,oBAAoB,MAAM,cAAc;MACvD,4BAA4B,GAAG,cAAc,2BAA2B;MACxE,mBAAmB;MACnB,yBAAyB,uBAAuB,KAAK,OAAO,QAAS,QAAQ,QAAQ;MACrF,sBAAsB,QAAQ;MAC9B,gBAAgB,QAAQ;MACxB;MACD,CAAC;KACF;KACA;KACA;KACA,UAAU,EAAE;KACb;IACD,UAAU,8BAA8B;IACxC,YAAY,aAAqB,KAAK,uBAAuB,SAAS;IACtE,gBAAgB,OAAO,EAAE,UAAU,WAAW;AAC5C,SAAI,CAAC,KAAK,OAAO,WACf;KAEF,MAAM,WAAW,SAAS;KAC1B,MAAM,SAAS,iBAAiB,SAAS;KACzC,MAAM,aAAa,MAAM,KAAK,OAAO,WAAW,kBAC9C,UACC,QAAQ,EAAE,EACX;MACE;MACA,WAAW,WAAW;MACtB,aAAa,QAAQ;MACtB,CACF;AACD,SAAI,CAAC,WAAW,QACd,QAAO;MAAE,OAAO;MAAM,QAAQ,WAAW,UAAU;MAAqC;;IAI7F,CACa;GAAE;GAAqB;;;;;CAMvC,mBAAmB,YAAoB,SAA0B;EAC/D,MAAM,WAAW,KAAK,OAAO,IAAI,WAAW;AAC5C,MAAI,CAAC,UAAU;AACb,OAAI,KACF;IAAE;IAAY;IAAS,oBAAoB,KAAK,OAAO;IAAM,EAC7D,gGAAgG,UACjG;AACD,UAAO;;AAGT,MAAI;GACF,MAAM,QAAQ,aAAa,QAAQ;AACnC,YAAS,MAAM,MAAM,QAAQ;AAC7B,OAAI,KAAK;IAAE;IAAY;IAAS,EAAE,wBAAwB;AAC1D,UAAO;WACA,KAAK;AACZ,OAAI,MAAM;IAAE;IAAK;IAAY;IAAS,EAAE,kCAAkC;AAC1E,UAAO;;;;;;CAOX,wBAAwB,YAAmC;EACzD,MAAM,WAAW,KAAK,OAAO,IAAI,WAAW;AAC5C,MAAI,CAAC,SACH,QAAO;EAGT,MAAM,WAAW,SAAS,MAAM,MAAM;AACtC,OAAK,IAAI,IAAI,SAAS,SAAS,GAAG,KAAK,GAAG,KAAK;GAC7C,MAAM,MAAM,SAAS;AACrB,OAAI,IAAI,SAAS,aAAa;IAC5B,MAAM,UAAU,IAAI;AACpB,QAAI,MAAM,QAAQ,QAAQ,CACxB,QAAO,mBAAmB,QAAkD;AAE9E,WAAO,OAAO,QAAQ;;;AAG1B,SAAO;;;;;CAMT,gBAAgB,YAAoB,UAAmC;EACrE,MAAM,WAAW,KAAK,OAAO,IAAI,WAAW;AAC5C,MAAI,CAAC,SACH,QAAO;AAGT,WAAS,MAAM,MAAM,WAAW;AAChC,SAAO;;;;;CAMT,YAAY,YAA2C;EACrD,MAAM,WAAW,KAAK,OAAO,IAAI,WAAW;AAC5C,MAAI,CAAC,SACH,QAAO;AAGT,SAAO,SAAS,MAAM,MAAM;;;;;CAM9B,mBAAmB,YAAoB,UAA4D;EACjG,MAAM,WAAW,KAAK,OAAO,IAAI,WAAW;AAC5C,MAAI,CAAC,SACH,QAAO;AAGT,SAAO,SAAS,MAAM,UAAU,SAAS"}
+{"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  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 { 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 { resolveLocalizedSkillMarkdown, resolveLocalizedSkillMeta } from './skills/skill-view-path.js';\nimport { createSkillConfigManager } 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';\n\nconst log = createLogger('AgentManager');\n\nexport interface SkillCatalogEntry {\n  directoryId: string;\n  name: string;\n  description: 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 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}\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      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 path = ctx?.sessionKey\n      ? this.getResolvedWorkspaceForSession(ctx.sessionKey)\n      : this.baseWorkspacePath;\n    return this.workspaceRuntimes.getOrCreate(path).skillManager.expandCommand(text);\n  }\n\n  /**\n   * Structured SKILL.md preview for the gateway console.\n   * When `lang` is provided (e.g. \"zh\"), tries SKILL-{lang}.md first; falls back to SKILL.md.\n   */\n  getSkillMarkdownSource(skillName: string, lang?: string): SkillMarkdownPreviewPayload | null {\n    const skill = this.workspaceRuntimes.getOrCreate(this.baseWorkspacePath).skillManager.findSkill(skillName);\n    if (!skill) return null;\n\n    // Try localized file for display\n    if (lang) {\n      const localized = resolveLocalizedSkillMarkdown(skill, lang);\n      if (localized) return localized;\n    }\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 { contextFiles } = resolveBootstrapContextSync({\n      profileDir,\n      config: cfg,\n      sessionKey,\n      excludeHeartbeat: excludeHeartbeat ?? !heartbeatEnabled,\n    });\n    return contextFiles;\n  }\n\n  getSkillCatalog(lang?: string): SkillCatalogEntry[] {\n    const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n    const lock = loadSkillsLock();\n    return this.workspaceRuntimes.getOrCreate(this.baseWorkspacePath).skillManager.getSkills().map((s) => {\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      // Attempt localized name/description for display\n      const localized = lang ? resolveLocalizedSkillMeta(s, lang) : null;\n\n      return {\n        directoryId,\n        name: localized?.name ?? s.name,\n        description: localized?.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\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      });\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      });\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      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   * 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        }),\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        if (!this.config.hookRunner) {\n          return undefined;\n        }\n        const toolName = toolCall.name;\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      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/background-review/coordinator.d.ts

@@ -0,0 +1,61 @@
+/**
+ * BackgroundReviewCoordinator — owns the per-session counters that decide when
+ * to nudge the model into running a quiet "review memory / review skills" follow-up
+ * after a normal user turn finishes.
+ *
+ * Previously the nudge state, the `agent.subscribe` plumbing for the skill counter,
+ * and the call to `runBackgroundReviewTurn` lived as private methods + a per-instance
+ * field on `AgentManager`. Extracted so:
+ *   - `AgentInstance` no longer carries an inline counter object.
+ *   - The agent-event subscription used to count `tool_execution_end` events is
+ *     owned by the coordinator; teardown is automatic on `forgetSession`.
+ *   - Future changes to the nudge cadence (per-agent intervals, per-tool counters,
+ *     etc.) only touch this file.
+ */
+import type { Agent } from '@earendil-works/pi-agent-core';
+import type { Config } from '../../config/schema.js';
+import type { WorkspaceRuntime } from '../workspace-runtime/registry.js';
+export interface BackgroundReviewCoordinatorOptions {
+    /** Effective config snapshot used to look up review-cadence settings. */
+    getConfig: () => Config | undefined;
+    /** Trigger after the review turn writes skill files (lets agents reload prompts). */
+    onSkillsFilesystemMutate: () => void;
+}
+export interface ScheduleReviewContext {
+    sessionKey: string;
+    agent: Agent;
+    registeredToolNames: readonly string[];
+    skillAllowlist?: readonly string[];
+    workspacePath: string;
+    /** Last assistant text — review is skipped when empty. */
+    lastAssistantText: string | null;
+    workspaceRuntime: WorkspaceRuntime;
+}
+export declare class BackgroundReviewCoordinator {
+    private readonly opts;
+    private readonly states;
+    constructor(opts: BackgroundReviewCoordinatorOptions);
+    /**
+     * Called before the main `agent.prompt` for a user turn — bumps the memory
+     * counter and arms `pendingMemoryReview` when the cadence interval is hit.
+     */
+    beginUserTurn(sessionKey: string, registeredToolNames: readonly string[]): void;
+    /**
+     * Subscribe to the agent's events to update the skill counter as the
+     * conversation progresses. Idempotent per session — the previous subscription
+     * is torn down before installing the new one.
+     */
+    attachToAgent(sessionKey: string, agent: Agent, registeredToolNames: readonly string[]): void;
+    /**
+     * Fire-and-forget review after the main user turn. Decides whether to run a
+     * memory and/or skills sweep based on the counter state + last assistant text,
+     * and delegates the actual review to {@link runBackgroundReviewTurn}.
+     */
+    scheduleAfterUserTurn(ctx: ScheduleReviewContext): void;
+    /** Tear down state for a session (called by `AgentManager.removeAgent`). */
+    forgetSession(sessionKey: string): void;
+    /** Tear down every subscription (`AgentManager.dispose` / hot reload). */
+    clear(): void;
+    private ensureState;
+    private runReviewIfNeeded;
+}

package/dist/src/agent/background-review/coordinator.js

@@ -0,0 +1,120 @@
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
+import { isAssistantTurnAborted, isAssistantTurnFailed } from "../orchestration/llm-turn-retry.js";
+import { resolveBackgroundReviewSettings } from "./settings.js";
+import { runBackgroundReviewTurn } from "./run-background-review.js";
+//#region src/agent/background-review/coordinator.ts
+init_logger();
+const log = createLogger("BackgroundReviewCoordinator");
+var BackgroundReviewCoordinator = class {
+	opts;
+	states = /* @__PURE__ */ new Map();
+	constructor(opts) {
+		this.opts = opts;
+	}
+	/**
+	* Called before the main `agent.prompt` for a user turn — bumps the memory
+	* counter and arms `pendingMemoryReview` when the cadence interval is hit.
+	*/
+	beginUserTurn(sessionKey, registeredToolNames) {
+		const cfg = resolveBackgroundReviewSettings(this.opts.getConfig());
+		if (!cfg.enabled || cfg.memoryNudgeInterval <= 0) return;
+		if (!registeredToolNames.includes("curated_memory")) return;
+		const state = this.ensureState(sessionKey);
+		state.turnsSinceMemory += 1;
+		if (state.turnsSinceMemory >= cfg.memoryNudgeInterval) {
+			state.pendingMemoryReview = true;
+			state.turnsSinceMemory = 0;
+		}
+	}
+	/**
+	* Subscribe to the agent's events to update the skill counter as the
+	* conversation progresses. Idempotent per session — the previous subscription
+	* is torn down before installing the new one.
+	*/
+	attachToAgent(sessionKey, agent, registeredToolNames) {
+		const state = this.ensureState(sessionKey);
+		state.unsubscribe?.();
+		state.unsubscribe = agent.subscribe((ev) => {
+			const cfg = resolveBackgroundReviewSettings(this.opts.getConfig());
+			if (!cfg.enabled || cfg.skillNudgeInterval <= 0) return;
+			if (!registeredToolNames.includes("skill_manage")) return;
+			if (ev.type === "turn_start") state.itersSinceSkill += 1;
+			if (ev.type === "tool_execution_end") {
+				const te = ev;
+				if (!te.isError && typeof te.toolName === "string" && te.toolName.trim() === "skill_manage") state.itersSinceSkill = 0;
+			}
+		});
+	}
+	/**
+	* Fire-and-forget review after the main user turn. Decides whether to run a
+	* memory and/or skills sweep based on the counter state + last assistant text,
+	* and delegates the actual review to {@link runBackgroundReviewTurn}.
+	*/
+	scheduleAfterUserTurn(ctx) {
+		this.runReviewIfNeeded(ctx).catch((err) => {
+			log.warn({
+				err,
+				sessionKey: ctx.sessionKey
+			}, "Background review failed");
+		});
+	}
+	/** Tear down state for a session (called by `AgentManager.removeAgent`). */
+	forgetSession(sessionKey) {
+		const state = this.states.get(sessionKey);
+		if (!state) return;
+		state.unsubscribe?.();
+		this.states.delete(sessionKey);
+	}
+	/** Tear down every subscription (`AgentManager.dispose` / hot reload). */
+	clear() {
+		for (const state of this.states.values()) state.unsubscribe?.();
+		this.states.clear();
+	}
+	ensureState(sessionKey) {
+		const existing = this.states.get(sessionKey);
+		if (existing) return existing;
+		const state = {
+			turnsSinceMemory: 0,
+			itersSinceSkill: 0,
+			pendingMemoryReview: false
+		};
+		this.states.set(sessionKey, state);
+		return state;
+	}
+	async runReviewIfNeeded(ctx) {
+		const state = this.states.get(ctx.sessionKey);
+		if (!state) return;
+		const settings = resolveBackgroundReviewSettings(this.opts.getConfig());
+		if (!settings.enabled) return;
+		if (isAssistantTurnAborted(ctx.agent) || isAssistantTurnFailed(ctx.agent)) return;
+		if (!ctx.lastAssistantText?.trim()) return;
+		const reviewMemory = state.pendingMemoryReview;
+		state.pendingMemoryReview = false;
+		let reviewSkills = false;
+		if (settings.skillNudgeInterval > 0 && ctx.registeredToolNames.includes("skill_manage") && state.itersSinceSkill >= settings.skillNudgeInterval) {
+			reviewSkills = true;
+			state.itersSinceSkill = 0;
+		}
+		if (!reviewMemory && !reviewSkills) return;
+		await runBackgroundReviewTurn({
+			sessionKey: ctx.sessionKey,
+			mainAgent: ctx.agent,
+			settings,
+			reviewMemory,
+			reviewSkills,
+			registeredToolNames: [...ctx.registeredToolNames],
+			skillAllowlist: ctx.skillAllowlist ? [...ctx.skillAllowlist] : void 0,
+			workspacePath: ctx.workspacePath,
+			skillManager: ctx.workspaceRuntime.skillManager,
+			builtinMemoryStore: ctx.workspaceRuntime.builtinMemoryStore,
+			memoryManager: ctx.workspaceRuntime.memoryManager,
+			getConfig: () => this.opts.getConfig(),
+			onSkillsFilesystemMutate: this.opts.onSkillsFilesystemMutate
+		});
+	}
+};
+//#endregion
+export { BackgroundReviewCoordinator };
+
+//# sourceMappingURL=coordinator.js.map

package/dist/src/agent/background-review/coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.js","names":[],"sources":["../../../../src/agent/background-review/coordinator.ts"],"sourcesContent":["/**\n * BackgroundReviewCoordinator — owns the per-session counters that decide when\n * to nudge the model into running a quiet \"review memory / review skills\" follow-up\n * after a normal user turn finishes.\n *\n * Previously the nudge state, the `agent.subscribe` plumbing for the skill counter,\n * and the call to `runBackgroundReviewTurn` lived as private methods + a per-instance\n * field on `AgentManager`. Extracted so:\n *   - `AgentInstance` no longer carries an inline counter object.\n *   - The agent-event subscription used to count `tool_execution_end` events is\n *     owned by the coordinator; teardown is automatic on `forgetSession`.\n *   - Future changes to the nudge cadence (per-agent intervals, per-tool counters,\n *     etc.) only touch this file.\n */\n\nimport type { Agent, AgentEvent } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../../config/schema.js';\nimport { createLogger } from '../../utils/logger.js';\nimport {\n  isAssistantTurnAborted,\n  isAssistantTurnFailed,\n} from '../orchestration/llm-turn-retry.js';\nimport type { WorkspaceRuntime } from '../workspace-runtime/registry.js';\nimport { resolveBackgroundReviewSettings } from './settings.js';\nimport { runBackgroundReviewTurn } from './run-background-review.js';\n\nconst log = createLogger('BackgroundReviewCoordinator');\n\ninterface NudgeState {\n  turnsSinceMemory: number;\n  itersSinceSkill: number;\n  pendingMemoryReview: boolean;\n  unsubscribe?: () => void;\n}\n\nexport interface BackgroundReviewCoordinatorOptions {\n  /** Effective config snapshot used to look up review-cadence settings. */\n  getConfig: () => Config | undefined;\n  /** Trigger after the review turn writes skill files (lets agents reload prompts). */\n  onSkillsFilesystemMutate: () => void;\n}\n\nexport interface ScheduleReviewContext {\n  sessionKey: string;\n  agent: Agent;\n  registeredToolNames: readonly string[];\n  skillAllowlist?: readonly string[];\n  workspacePath: string;\n  /** Last assistant text — review is skipped when empty. */\n  lastAssistantText: string | null;\n  workspaceRuntime: WorkspaceRuntime;\n}\n\nexport class BackgroundReviewCoordinator {\n  private readonly opts: BackgroundReviewCoordinatorOptions;\n  private readonly states = new Map<string, NudgeState>();\n\n  constructor(opts: BackgroundReviewCoordinatorOptions) {\n    this.opts = opts;\n  }\n\n  /**\n   * Called before the main `agent.prompt` for a user turn — bumps the memory\n   * counter and arms `pendingMemoryReview` when the cadence interval is hit.\n   */\n  beginUserTurn(sessionKey: string, registeredToolNames: readonly string[]): void {\n    const cfg = resolveBackgroundReviewSettings(this.opts.getConfig());\n    if (!cfg.enabled || cfg.memoryNudgeInterval <= 0) return;\n    if (!registeredToolNames.includes('curated_memory')) return;\n\n    const state = this.ensureState(sessionKey);\n    state.turnsSinceMemory += 1;\n    if (state.turnsSinceMemory >= cfg.memoryNudgeInterval) {\n      state.pendingMemoryReview = true;\n      state.turnsSinceMemory = 0;\n    }\n  }\n\n  /**\n   * Subscribe to the agent's events to update the skill counter as the\n   * conversation progresses. Idempotent per session — the previous subscription\n   * is torn down before installing the new one.\n   */\n  attachToAgent(\n    sessionKey: string,\n    agent: Agent,\n    registeredToolNames: readonly string[],\n  ): void {\n    const state = this.ensureState(sessionKey);\n    state.unsubscribe?.();\n    const unsub = agent.subscribe((ev: AgentEvent) => {\n      const cfg = resolveBackgroundReviewSettings(this.opts.getConfig());\n      if (!cfg.enabled || cfg.skillNudgeInterval <= 0) return;\n      if (!registeredToolNames.includes('skill_manage')) return;\n      if (ev.type === 'turn_start') {\n        state.itersSinceSkill += 1;\n      }\n      if (ev.type === 'tool_execution_end') {\n        const te = ev as Extract<AgentEvent, { type: 'tool_execution_end' }>;\n        if (!te.isError && typeof te.toolName === 'string' && te.toolName.trim() === 'skill_manage') {\n          state.itersSinceSkill = 0;\n        }\n      }\n    });\n    state.unsubscribe = unsub;\n  }\n\n  /**\n   * Fire-and-forget review after the main user turn. Decides whether to run a\n   * memory and/or skills sweep based on the counter state + last assistant text,\n   * and delegates the actual review to {@link runBackgroundReviewTurn}.\n   */\n  scheduleAfterUserTurn(ctx: ScheduleReviewContext): void {\n    void this.runReviewIfNeeded(ctx).catch((err) => {\n      log.warn({ err, sessionKey: ctx.sessionKey }, 'Background review failed');\n    });\n  }\n\n  /** Tear down state for a session (called by `AgentManager.removeAgent`). */\n  forgetSession(sessionKey: string): void {\n    const state = this.states.get(sessionKey);\n    if (!state) return;\n    state.unsubscribe?.();\n    this.states.delete(sessionKey);\n  }\n\n  /** Tear down every subscription (`AgentManager.dispose` / hot reload). */\n  clear(): void {\n    for (const state of this.states.values()) {\n      state.unsubscribe?.();\n    }\n    this.states.clear();\n  }\n\n  private ensureState(sessionKey: string): NudgeState {\n    const existing = this.states.get(sessionKey);\n    if (existing) return existing;\n    const state: NudgeState = {\n      turnsSinceMemory: 0,\n      itersSinceSkill: 0,\n      pendingMemoryReview: false,\n    };\n    this.states.set(sessionKey, state);\n    return state;\n  }\n\n  private async runReviewIfNeeded(ctx: ScheduleReviewContext): Promise<void> {\n    const state = this.states.get(ctx.sessionKey);\n    if (!state) return;\n    const settings = resolveBackgroundReviewSettings(this.opts.getConfig());\n    if (!settings.enabled) return;\n    if (isAssistantTurnAborted(ctx.agent) || isAssistantTurnFailed(ctx.agent)) return;\n    if (!ctx.lastAssistantText?.trim()) return;\n\n    const reviewMemory = state.pendingMemoryReview;\n    state.pendingMemoryReview = false;\n\n    let reviewSkills = false;\n    if (\n      settings.skillNudgeInterval > 0 &&\n      ctx.registeredToolNames.includes('skill_manage') &&\n      state.itersSinceSkill >= settings.skillNudgeInterval\n    ) {\n      reviewSkills = true;\n      state.itersSinceSkill = 0;\n    }\n\n    if (!reviewMemory && !reviewSkills) return;\n\n    await runBackgroundReviewTurn({\n      sessionKey: ctx.sessionKey,\n      mainAgent: ctx.agent,\n      settings,\n      reviewMemory,\n      reviewSkills,\n      registeredToolNames: [...ctx.registeredToolNames],\n      skillAllowlist: ctx.skillAllowlist ? [...ctx.skillAllowlist] : undefined,\n      workspacePath: ctx.workspacePath,\n      skillManager: ctx.workspaceRuntime.skillManager,\n      builtinMemoryStore: ctx.workspaceRuntime.builtinMemoryStore,\n      memoryManager: ctx.workspaceRuntime.memoryManager,\n      getConfig: () => this.opts.getConfig(),\n      onSkillsFilesystemMutate: this.opts.onSkillsFilesystemMutate,\n    });\n  }\n}\n"],"mappings":"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"}

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

@@ -1,7 +1,7 @@
 import { WORKSPACE_FILES, init_paths } from "../../config/paths.js";
 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
 init_paths();
 const BOOTSTRAP_LOAD_ORDER = [

package/dist/src/agent/child-agent-factory.d.ts

@@ -1,8 +1,16 @@
 import type { Api, Model } from '@earendil-works/pi-ai';
 import type { Config } from '../config/schema.js';
 import type { MessageBus } from '../infra/bus/index.js';
+import type { AgentTool } from '@earendil-works/pi-agent-core';
 import type { ToolExecutorConfig } from './tools/executor.js';
 export declare function buildChildSystemPrompt(goal: string, context?: string, workspace?: string): string;
+export interface BuildChildToolsOptions {
+    workspace: string;
+    bus: MessageBus;
+    model: Model<Api>;
+    getConfig: () => Config | undefined;
+    toolExecutorConfig?: Partial<ToolExecutorConfig>;
+}
 export interface DelegateChildHandleOptions {
     workspace: string;
     goal: string;
@@ -13,6 +21,12 @@ export interface DelegateChildHandleOptions {
     bus: MessageBus;
     getConfig: () => Config | undefined;
     toolExecutorConfig?: Partial<ToolExecutorConfig>;
+    /**
+     * Construct the child agent's tool set. Injected by the caller (delegate-tool)
+     * so this module does not import `tools/factory.js` (which would form a
+     * factory ↔ delegate-tool ↔ child-agent-factory cycle).
+     */
+    buildChildTools: (opts: BuildChildToolsOptions) => AgentTool<any, any>[];
 }
 export interface DelegateChildRunResult {
     summary: string;

package/dist/src/agent/child-agent-factory.js

@@ -5,7 +5,6 @@ import { getApiKeySync, init_providers } from "../providers/index.js";
 import { createExtensionAwareStreamFn } from "../providers/extension-stream-bridge.js";
 import { extractTextContent } from "./context/workspace.js";
 import { resolveAgentTurnTimeoutMs, runAgentTurnWithTimeout } from "./orchestration/run-agent-turn-with-timeout.js";
-import { AgentToolsFactory } from "./tools/factory.js";
 import { Agent } from "@earendil-works/pi-agent-core";
 //#region src/agent/child-agent-factory.ts
 init_sync_provider_auth();
@@ -27,17 +26,12 @@ function buildChildSystemPrompt(goal, context, workspace) {
 * Build an isolated tool factory (no extensions, no session memory hooks) and a child {@link Agent}.
 */
 function createDelegateChildHandle(options) {
-	const allTools = new AgentToolsFactory({
+	const allTools = options.buildChildTools({
 		workspace: options.workspace,
 		bus: options.bus,
-		getCurrentContext: () => null,
+		model: options.model,
 		getConfig: options.getConfig,
-		getPrimaryModel: () => options.model,
 		toolExecutorConfig: options.toolExecutorConfig
-	}).createAllTools({
-		workspace: options.workspace,
-		getPrimaryModel: () => options.model,
-		disabledTools: new Set(["extensions"])
 	});
 	const allow = new Set(options.allowedToolNames);
 	const filteredTools = allTools.filter((t) => allow.has(t.name));

package/dist/src/agent/child-agent-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"child-agent-factory.js","names":[],"sources":["../../../src/agent/child-agent-factory.ts"],"sourcesContent":["import { Agent, type ThinkingLevel } from '@earendil-works/pi-agent-core';\nimport type { Api, Model } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../config/schema.js';\nimport type { MessageBus } from '../infra/bus/index.js';\nimport { resolveProviderApiKeySync } from '../auth/sync-provider-auth.js';\nimport { getApiKeySync } from '../providers/index.js';\nimport { createExtensionAwareStreamFn } from '../providers/extension-stream-bridge.js';\nimport { createLogger } from '../utils/logger.js';\n\nimport { extractTextContent } from './context/workspace.js';\nimport {\n  resolveAgentTurnTimeoutMs,\n  runAgentTurnWithTimeout,\n} from './orchestration/run-agent-turn-with-timeout.js';\nimport type { ToolExecutorConfig } from './tools/executor.js';\nimport { AgentToolsFactory } from './tools/factory.js';\n\nconst log = createLogger('delegate-child');\n\nexport function buildChildSystemPrompt(goal: string, context?: string, workspace?: string): string {\n  const parts = [\n    'You are a focused sub-agent working on a specific delegated task.',\n    '',\n    `YOUR TASK:\\n${goal}`,\n  ];\n\n  if (context?.trim()) {\n    parts.push(`\\nCONTEXT:\\n${context.trim()}`);\n  }\n\n  if (workspace?.trim()) {\n    parts.push(`\\nWORKSPACE: ${workspace.trim()}`);\n  }\n\n  parts.push(\n    '\\nComplete this task using only the tools available to you. ' +\n      'When finished, reply with a clear, concise summary covering:\\n' +\n      '- What you did\\n' +\n      '- What you found or accomplished\\n' +\n      '- Files created or modified\\n' +\n      '- Issues encountered\\n\\n' +\n      'Your final reply is returned to the parent agent — be thorough but compact.',\n  );\n\n  return parts.join('\\n');\n}\n\nexport interface DelegateChildHandleOptions {\n  workspace: string;\n  goal: string;\n  context?: string;\n  allowedToolNames: string[];\n  maxIterations: number;\n  model: Model<Api>;\n  bus: MessageBus;\n  getConfig: () => Config | undefined;\n  toolExecutorConfig?: Partial<ToolExecutorConfig>;\n}\n\nexport interface DelegateChildRunResult {\n  summary: string;\n  toolIterations: number;\n}\n\nexport interface DelegateChildHandle {\n  run(): Promise<DelegateChildRunResult>;\n  abort(): void;\n}\n\n/**\n * Build an isolated tool factory (no extensions, no session memory hooks) and a child {@link Agent}.\n */\nexport function createDelegateChildHandle(options: DelegateChildHandleOptions): DelegateChildHandle {\n  const childFactory = new AgentToolsFactory({\n    workspace: options.workspace,\n    bus: options.bus,\n    getCurrentContext: () => null,\n    getConfig: options.getConfig,\n    getPrimaryModel: () => options.model,\n    toolExecutorConfig: options.toolExecutorConfig,\n  });\n\n  const allTools = childFactory.createAllTools({\n    workspace: options.workspace,\n    getPrimaryModel: () => options.model,\n    disabledTools: new Set(['extensions']),\n  });\n\n  const allow = new Set(options.allowedToolNames);\n  const filteredTools = allTools.filter((t) => allow.has(t.name));\n\n  if (filteredTools.length === 0) {\n    return {\n      async run() {\n        return {\n          summary: 'No tools matched the allowlist after factory registration.',\n          toolIterations: 0,\n        };\n      },\n      abort() {},\n    };\n  }\n\n  let toolIterations = 0;\n  let aborted = false;\n\n  const agent = new Agent({\n    initialState: {\n      systemPrompt: buildChildSystemPrompt(options.goal, options.context, options.workspace),\n      model: options.model,\n      thinkingLevel: 'low' as ThinkingLevel,\n      tools: filteredTools,\n      messages: [],\n    },\n    streamFn: createExtensionAwareStreamFn(),\n    getApiKey: (provider: string) =>\n      resolveProviderApiKeySync(provider) ?? getApiKeySync(provider) ?? '',\n    beforeToolCall: async () => {\n      if (aborted) {\n        return { block: true, reason: 'Sub-agent aborted.' };\n      }\n      if (toolIterations >= options.maxIterations) {\n        return {\n          block: true,\n          reason: `Sub-agent reached max tool iterations (${options.maxIterations}).`,\n        };\n      }\n      return undefined;\n    },\n    afterToolCall: async () => {\n      toolIterations += 1;\n      return undefined;\n    },\n  });\n\n  const userText = options.context?.trim()\n    ? `${options.goal}\\n\\nAdditional context:\\n${options.context.trim()}`\n    : options.goal;\n\n  return {\n    async run(): Promise<DelegateChildRunResult> {\n      toolIterations = 0;\n      aborted = false;\n      try {\n        await runAgentTurnWithTimeout(\n          agent,\n          async () => {\n            await agent.prompt(userText);\n            await agent.waitForIdle();\n          },\n          resolveAgentTurnTimeoutMs(options.getConfig()),\n        );\n\n        const messages = 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: unknown = msg.content;\n            if (typeof content === 'string') {\n              return { summary: content.trim() || '(empty assistant message)', toolIterations };\n            }\n            if (Array.isArray(content)) {\n              const text = extractTextContent(content as Array<{ type: string; text?: string }>);\n              return {\n                summary: text.trim() || '(empty assistant message)',\n                toolIterations,\n              };\n            }\n          }\n        }\n\n        return {\n          summary: aborted\n            ? 'Sub-agent was aborted before producing a result.'\n            : 'Sub-agent completed but produced no assistant text.',\n          toolIterations,\n        };\n      } catch (e) {\n        const msg = e instanceof Error ? e.message : String(e);\n        const m = options.model as { model?: string; id?: string };\n        const modelId = m?.model ?? m?.id;\n        log.warn(\n          {\n            err: e,\n            errorMessage: msg,\n            goalPreview: options.goal.slice(0, 120),\n            maxIterations: options.maxIterations,\n            allowedToolCount: options.allowedToolNames.length,\n            modelId,\n          },\n          `Delegate child run failed: ${msg}`,\n        );\n        return {\n          summary: `Sub-agent error: ${msg}`,\n          toolIterations,\n        };\n      }\n    },\n\n    abort(): void {\n      aborted = true;\n      agent.abort();\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"child-agent-factory.js","names":[],"sources":["../../../src/agent/child-agent-factory.ts"],"sourcesContent":["import { Agent, type ThinkingLevel } from '@earendil-works/pi-agent-core';\nimport type { Api, Model } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../config/schema.js';\nimport type { MessageBus } from '../infra/bus/index.js';\nimport { resolveProviderApiKeySync } from '../auth/sync-provider-auth.js';\nimport { getApiKeySync } from '../providers/index.js';\nimport { createExtensionAwareStreamFn } from '../providers/extension-stream-bridge.js';\nimport { createLogger } from '../utils/logger.js';\n\nimport { extractTextContent } from './context/workspace.js';\nimport {\n  resolveAgentTurnTimeoutMs,\n  runAgentTurnWithTimeout,\n} from './orchestration/run-agent-turn-with-timeout.js';\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { ToolExecutorConfig } from './tools/executor.js';\n// `AgentToolsFactory` is NOT imported here on purpose — `tools/factory.js`\n// constructs the delegate tool, which would create a factory ↔ delegate-tool\n// ↔ child-agent-factory cycle. Instead, the caller supplies a\n// `buildChildTools()` callback that produces the already-constructed child\n// tool set (see `DelegateChildHandleOptions.buildChildTools`).\n\nconst log = createLogger('delegate-child');\n\nexport function buildChildSystemPrompt(goal: string, context?: string, workspace?: string): string {\n  const parts = [\n    'You are a focused sub-agent working on a specific delegated task.',\n    '',\n    `YOUR TASK:\\n${goal}`,\n  ];\n\n  if (context?.trim()) {\n    parts.push(`\\nCONTEXT:\\n${context.trim()}`);\n  }\n\n  if (workspace?.trim()) {\n    parts.push(`\\nWORKSPACE: ${workspace.trim()}`);\n  }\n\n  parts.push(\n    '\\nComplete this task using only the tools available to you. ' +\n      'When finished, reply with a clear, concise summary covering:\\n' +\n      '- What you did\\n' +\n      '- What you found or accomplished\\n' +\n      '- Files created or modified\\n' +\n      '- Issues encountered\\n\\n' +\n      'Your final reply is returned to the parent agent — be thorough but compact.',\n  );\n\n  return parts.join('\\n');\n}\n\nexport interface BuildChildToolsOptions {\n  workspace: string;\n  bus: MessageBus;\n  model: Model<Api>;\n  getConfig: () => Config | undefined;\n  toolExecutorConfig?: Partial<ToolExecutorConfig>;\n}\n\nexport interface DelegateChildHandleOptions {\n  workspace: string;\n  goal: string;\n  context?: string;\n  allowedToolNames: string[];\n  maxIterations: number;\n  model: Model<Api>;\n  bus: MessageBus;\n  getConfig: () => Config | undefined;\n  toolExecutorConfig?: Partial<ToolExecutorConfig>;\n  /**\n   * Construct the child agent's tool set. Injected by the caller (delegate-tool)\n   * so this module does not import `tools/factory.js` (which would form a\n   * factory ↔ delegate-tool ↔ child-agent-factory cycle).\n   */\n  buildChildTools: (opts: BuildChildToolsOptions) => AgentTool<any, any>[];\n}\n\nexport interface DelegateChildRunResult {\n  summary: string;\n  toolIterations: number;\n}\n\nexport interface DelegateChildHandle {\n  run(): Promise<DelegateChildRunResult>;\n  abort(): void;\n}\n\n/**\n * Build an isolated tool factory (no extensions, no session memory hooks) and a child {@link Agent}.\n */\nexport function createDelegateChildHandle(options: DelegateChildHandleOptions): DelegateChildHandle {\n  const allTools = options.buildChildTools({\n    workspace: options.workspace,\n    bus: options.bus,\n    model: options.model,\n    getConfig: options.getConfig,\n    toolExecutorConfig: options.toolExecutorConfig,\n  });\n\n  const allow = new Set(options.allowedToolNames);\n  const filteredTools = allTools.filter((t) => allow.has(t.name));\n\n  if (filteredTools.length === 0) {\n    return {\n      async run() {\n        return {\n          summary: 'No tools matched the allowlist after factory registration.',\n          toolIterations: 0,\n        };\n      },\n      abort() {},\n    };\n  }\n\n  let toolIterations = 0;\n  let aborted = false;\n\n  const agent = new Agent({\n    initialState: {\n      systemPrompt: buildChildSystemPrompt(options.goal, options.context, options.workspace),\n      model: options.model,\n      thinkingLevel: 'low' as ThinkingLevel,\n      tools: filteredTools,\n      messages: [],\n    },\n    streamFn: createExtensionAwareStreamFn(),\n    getApiKey: (provider: string) =>\n      resolveProviderApiKeySync(provider) ?? getApiKeySync(provider) ?? '',\n    beforeToolCall: async () => {\n      if (aborted) {\n        return { block: true, reason: 'Sub-agent aborted.' };\n      }\n      if (toolIterations >= options.maxIterations) {\n        return {\n          block: true,\n          reason: `Sub-agent reached max tool iterations (${options.maxIterations}).`,\n        };\n      }\n      return undefined;\n    },\n    afterToolCall: async () => {\n      toolIterations += 1;\n      return undefined;\n    },\n  });\n\n  const userText = options.context?.trim()\n    ? `${options.goal}\\n\\nAdditional context:\\n${options.context.trim()}`\n    : options.goal;\n\n  return {\n    async run(): Promise<DelegateChildRunResult> {\n      toolIterations = 0;\n      aborted = false;\n      try {\n        await runAgentTurnWithTimeout(\n          agent,\n          async () => {\n            await agent.prompt(userText);\n            await agent.waitForIdle();\n          },\n          resolveAgentTurnTimeoutMs(options.getConfig()),\n        );\n\n        const messages = 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: unknown = msg.content;\n            if (typeof content === 'string') {\n              return { summary: content.trim() || '(empty assistant message)', toolIterations };\n            }\n            if (Array.isArray(content)) {\n              const text = extractTextContent(content as Array<{ type: string; text?: string }>);\n              return {\n                summary: text.trim() || '(empty assistant message)',\n                toolIterations,\n              };\n            }\n          }\n        }\n\n        return {\n          summary: aborted\n            ? 'Sub-agent was aborted before producing a result.'\n            : 'Sub-agent completed but produced no assistant text.',\n          toolIterations,\n        };\n      } catch (e) {\n        const msg = e instanceof Error ? e.message : String(e);\n        const m = options.model as { model?: string; id?: string };\n        const modelId = m?.model ?? m?.id;\n        log.warn(\n          {\n            err: e,\n            errorMessage: msg,\n            goalPreview: options.goal.slice(0, 120),\n            maxIterations: options.maxIterations,\n            allowedToolCount: options.allowedToolNames.length,\n            modelId,\n          },\n          `Delegate child run failed: ${msg}`,\n        );\n        return {\n          summary: `Sub-agent error: ${msg}`,\n          toolIterations,\n        };\n      }\n    },\n\n    abort(): void {\n      aborted = true;\n      agent.abort();\n    },\n  };\n}\n"],"mappings":";;;;;;;;;yBAK0E;gBACpB;aAEJ;AAelD,MAAM,MAAM,aAAa,iBAAiB;AAE1C,SAAgB,uBAAuB,MAAc,SAAkB,WAA4B;CACjG,MAAM,QAAQ;EACZ;EACA;EACA,eAAe;EAChB;AAED,KAAI,SAAS,MAAM,CACjB,OAAM,KAAK,eAAe,QAAQ,MAAM,GAAG;AAG7C,KAAI,WAAW,MAAM,CACnB,OAAM,KAAK,gBAAgB,UAAU,MAAM,GAAG;AAGhD,OAAM,KACJ,+SAOD;AAED,QAAO,MAAM,KAAK,KAAK;;;;;AA0CzB,SAAgB,0BAA0B,SAA0D;CAClG,MAAM,WAAW,QAAQ,gBAAgB;EACvC,WAAW,QAAQ;EACnB,KAAK,QAAQ;EACb,OAAO,QAAQ;EACf,WAAW,QAAQ;EACnB,oBAAoB,QAAQ;EAC7B,CAAC;CAEF,MAAM,QAAQ,IAAI,IAAI,QAAQ,iBAAiB;CAC/C,MAAM,gBAAgB,SAAS,QAAQ,MAAM,MAAM,IAAI,EAAE,KAAK,CAAC;AAE/D,KAAI,cAAc,WAAW,EAC3B,QAAO;EACL,MAAM,MAAM;AACV,UAAO;IACL,SAAS;IACT,gBAAgB;IACjB;;EAEH,QAAQ;EACT;CAGH,IAAI,iBAAiB;CACrB,IAAI,UAAU;CAEd,MAAM,QAAQ,IAAI,MAAM;EACtB,cAAc;GACZ,cAAc,uBAAuB,QAAQ,MAAM,QAAQ,SAAS,QAAQ,UAAU;GACtF,OAAO,QAAQ;GACf,eAAe;GACf,OAAO;GACP,UAAU,EAAE;GACb;EACD,UAAU,8BAA8B;EACxC,YAAY,aACV,0BAA0B,SAAS,IAAI,cAAc,SAAS,IAAI;EACpE,gBAAgB,YAAY;AAC1B,OAAI,QACF,QAAO;IAAE,OAAO;IAAM,QAAQ;IAAsB;AAEtD,OAAI,kBAAkB,QAAQ,cAC5B,QAAO;IACL,OAAO;IACP,QAAQ,0CAA0C,QAAQ,cAAc;IACzE;;EAIL,eAAe,YAAY;AACzB,qBAAkB;;EAGrB,CAAC;CAEF,MAAM,WAAW,QAAQ,SAAS,MAAM,GACpC,GAAG,QAAQ,KAAK,2BAA2B,QAAQ,QAAQ,MAAM,KACjE,QAAQ;AAEZ,QAAO;EACL,MAAM,MAAuC;AAC3C,oBAAiB;AACjB,aAAU;AACV,OAAI;AACF,UAAM,wBACJ,OACA,YAAY;AACV,WAAM,MAAM,OAAO,SAAS;AAC5B,WAAM,MAAM,aAAa;OAE3B,0BAA0B,QAAQ,WAAW,CAAC,CAC/C;IAED,MAAM,WAAW,MAAM,MAAM;AAC7B,SAAK,IAAI,IAAI,SAAS,SAAS,GAAG,KAAK,GAAG,KAAK;KAC7C,MAAM,MAAM,SAAS;AACrB,SAAI,IAAI,SAAS,aAAa;MAC5B,MAAM,UAAmB,IAAI;AAC7B,UAAI,OAAO,YAAY,SACrB,QAAO;OAAE,SAAS,QAAQ,MAAM,IAAI;OAA6B;OAAgB;AAEnF,UAAI,MAAM,QAAQ,QAAQ,CAExB,QAAO;OACL,SAFW,mBAAmB,QAEjB,CAAC,MAAM,IAAI;OACxB;OACD;;;AAKP,WAAO;KACL,SAAS,UACL,qDACA;KACJ;KACD;YACM,GAAG;IACV,MAAM,MAAM,aAAa,QAAQ,EAAE,UAAU,OAAO,EAAE;IACtD,MAAM,IAAI,QAAQ;IAClB,MAAM,UAAU,GAAG,SAAS,GAAG;AAC/B,QAAI,KACF;KACE,KAAK;KACL,cAAc;KACd,aAAa,QAAQ,KAAK,MAAM,GAAG,IAAI;KACvC,eAAe,QAAQ;KACvB,kBAAkB,QAAQ,iBAAiB;KAC3C;KACD,EACD,8BAA8B,MAC/B;AACD,WAAO;KACL,SAAS,oBAAoB;KAC7B;KACD;;;EAIL,QAAc;AACZ,aAAU;AACV,SAAM,OAAO;;EAEhB"}

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

@@ -1,12 +1,12 @@
-import { DEFAULT_AGENT_ID, init_agent_scope, resolveAgentProfileDir, resolveAgentWorkspaceDir } from "../agent-scope.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { DEFAULT_AGENT_ID, init_agent_scope, resolveAgentProfileDir, resolveAgentWorkspaceDir } from "../agent-scope.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 { execFileSync } from "node:child_process";
+import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
+import { execFileSync } from "node:child_process";
 //#region src/agent/context/workspace-seed.ts
 /**
 * Seed profile Markdown files into `agents/<agentId>/profile/` (and optionally `git init` the Markdown workspace).

package/dist/src/agent/embedded/index.d.ts

@@ -1,7 +1,6 @@
 export { PiTranscriptManager, CURRENT_SESSION_VERSION } from './pi-transcript.js';
 export type { SessionManager as PiTranscriptManagerType } from './pi-transcript.js';
-export { guardSessionManager, type GuardedPiTranscriptManager } from './session-tool-result-guard-wrapper.js';
-export { installSessionToolResultGuard } from './session-tool-result-guard.js';
+export { installSessionToolResultGuard, guardSessionManager, getRawSessionAppendMessage, type GuardedPiTranscriptManager, type ToolResultGuardOptions, } from './session-tool-result-guard.js';
 export { prepareSessionManagerForRun } from './session-manager-init.js';
 export { trackSessionManagerAccess, prewarmSessionFile, isSessionManagerCached, } from './session-manager-cache.js';
 export { acquireEmbeddedSessionRunner, buildEmbeddedRunnerFingerprint, evictAllEmbeddedSessionRunners, evictEmbeddedSessionRunner, getEmbeddedSessionRunnerIdleTtlMs, getEmbeddedSessionRunnerStats, isEmbeddedSessionRunnerEnabled, resetEmbeddedSessionRunnerForTest, resolveEmbeddedTranscriptInputs, } from './session-runner.js';

package/dist/src/agent/embedded/index.js

@@ -1,6 +1,5 @@
 import { DEFAULT_MAX_LIVE_TOOL_RESULT_CHARS, resolveLiveToolResultMaxChars, truncateToolResultMessage } from "./tool-result-truncation.js";
-import { installSessionToolResultGuard } from "./session-tool-result-guard.js";
-import { guardSessionManager } from "./session-tool-result-guard-wrapper.js";
+import { getRawSessionAppendMessage, guardSessionManager, installSessionToolResultGuard } from "./session-tool-result-guard.js";
 import { prepareSessionManagerForRun } from "./session-manager-init.js";
 import { isSessionManagerCached, prewarmSessionFile, trackSessionManagerAccess } from "./session-manager-cache.js";
 import { acquireEmbeddedSessionRunner, buildEmbeddedRunnerFingerprint, evictAllEmbeddedSessionRunners, evictEmbeddedSessionRunner, getEmbeddedSessionRunnerIdleTtlMs, getEmbeddedSessionRunnerStats, isEmbeddedSessionRunnerEnabled, resetEmbeddedSessionRunnerForTest, resolveEmbeddedTranscriptInputs } from "./session-runner.js";
@@ -8,4 +7,4 @@ import { abortEmbeddedRun, getEmbeddedRunBySessionKey, queueEmbeddedSteer, regis
 import { runXopcEmbeddedTurn } from "./run-turn.js";
 import { runEmbeddedTurnForSession } from "./run-for-session.js";
 import { CURRENT_SESSION_VERSION, PiTranscriptManager } from "./pi-transcript.js";
-export { CURRENT_SESSION_VERSION, DEFAULT_MAX_LIVE_TOOL_RESULT_CHARS, PiTranscriptManager, abortEmbeddedRun, acquireEmbeddedSessionRunner, buildEmbeddedRunnerFingerprint, evictAllEmbeddedSessionRunners, evictEmbeddedSessionRunner, getEmbeddedRunBySessionKey, getEmbeddedSessionRunnerIdleTtlMs, getEmbeddedSessionRunnerStats, guardSessionManager, installSessionToolResultGuard, isEmbeddedSessionRunnerEnabled, isSessionManagerCached, prepareSessionManagerForRun, prewarmSessionFile, queueEmbeddedSteer, registerEmbeddedRun, resetEmbeddedSessionRunnerForTest, resolveEmbeddedTranscriptInputs, resolveLiveToolResultMaxChars, runEmbeddedTurnForSession, runXopcEmbeddedTurn, trackSessionManagerAccess, truncateToolResultMessage };
+export { CURRENT_SESSION_VERSION, DEFAULT_MAX_LIVE_TOOL_RESULT_CHARS, PiTranscriptManager, abortEmbeddedRun, acquireEmbeddedSessionRunner, buildEmbeddedRunnerFingerprint, evictAllEmbeddedSessionRunners, evictEmbeddedSessionRunner, getEmbeddedRunBySessionKey, getEmbeddedSessionRunnerIdleTtlMs, getEmbeddedSessionRunnerStats, getRawSessionAppendMessage, guardSessionManager, installSessionToolResultGuard, isEmbeddedSessionRunnerEnabled, isSessionManagerCached, prepareSessionManagerForRun, prewarmSessionFile, queueEmbeddedSteer, registerEmbeddedRun, resetEmbeddedSessionRunnerForTest, resolveEmbeddedTranscriptInputs, resolveLiveToolResultMaxChars, runEmbeddedTurnForSession, runXopcEmbeddedTurn, trackSessionManagerAccess, truncateToolResultMessage };

package/dist/src/agent/embedded/run-for-session.d.ts

@@ -1,6 +1,6 @@
 import type { AgentMessage } from '@earendil-works/pi-agent-core';
 import type { Config } from '../../config/schema.js';
-import type { AgentManager } from '../agent-manager.js';
+import type { AgentInstanceGateway } from '../agent-instance-gateway.js';
 import type { ModelManager } from '../models/index.js';
 import type { SessionStore } from '../../session/store.js';
 import type { EmbeddedStreamEvent, RunXopcEmbeddedTurnResult } from './types.js';
@@ -9,7 +9,7 @@ export type RunEmbeddedForSessionParams = {
     runId?: string;
     userMessage: AgentMessage;
     sessionStore: SessionStore;
-    agentManager: AgentManager;
+    agentManager: AgentInstanceGateway;
     modelManager: ModelManager;
     thinkingOverride?: string | null;
     abortSignal?: AbortSignal;