@xopcai/xopc 0.0.94 → 0.0.96

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

@@ -1 +1 @@
-{"version":3,"file":"agent-manager.js","names":[],"sources":["../../../src/agent/agent-manager.ts"],"sourcesContent":["/**\n * Agent Manager - Manages Agent instances per session\n *\n * Each session gets its own Agent instance for true isolation\n * and concurrent processing across sessions.\n */\n\nimport {\n  Agent,\n  type AgentMessage,\n  type AgentEvent,\n  type ThinkingLevel,\n} from '@earendil-works/pi-agent-core';\nimport type { Model, Api } from '@earendil-works/pi-ai';\nimport type { AgentInstanceGateway } from './agent-instance-gateway.js';\nimport { type Config, getAgentDefaultModelRef } from '../config/schema.js';\nimport { applyConfigOverrides } from '../config/runtime-overrides.js';\nimport { resolveAgentProfileDir } from './agent-scope.js';\nimport {\n  type EffectiveAgentProfile,\n  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  /** Gateway: starts persisted workflow runs (dedicated chat session per run). */\n  getWorkflowRunService?: () => import('../workflows/service/workflow-run-service.types.js').WorkflowRunServiceLike | undefined;\n}\n\nexport interface AgentInstance {\n  agent: Agent;\n  sessionKey: string;\n  createdAt: number;\n  lastUsedAt: number;\n  effectiveProfile: EffectiveAgentProfile;\n  resolvedWorkspacePath: string;\n  /** Tool names registered on this agent (for skill indexing / tool gating). */\n  registeredToolNames: string[];\n  /** Declared env var names from skill_view; shell reads values from process.env at spawn time. */\n  skillEnvPassthroughKeys: Set<string>;\n}\n\n\nexport class AgentManager implements AgentInstanceGateway {\n  private agents = new Map<string, AgentInstance>();\n  private config: AgentManagerConfig;\n  private toolsFactory: AgentToolsFactory;\n\n  private mergedConfig(): Config | undefined {\n    const base = this.config.config;\n    return base ? applyConfigOverrides(base) : undefined;\n  }\n  /** Default agent workspace (effective profile for `getDefaultAgentId`). */\n  private baseWorkspacePath: string;\n  /** Per-session absolute markdown workspace when `SessionAgentConfig.workingDirectoryOverride` is set. */\n  private sessionWorkspaceOverrides = new Map<string, string>();\n  private defaultModel: string;\n  private credentialCache = new Map<string, string>();\n  private credentialResolver: CredentialResolver;\n  private workspaceRuntimes: WorkspaceRuntimeRegistry;\n  private memoryPrefetch: MemoryPrefetchCoordinator;\n  private backgroundReview: BackgroundReviewCoordinator;\n\n  constructor(config: AgentManagerConfig) {\n    this.config = config;\n    this.baseWorkspacePath = this.computeBaseWorkspacePath();\n    this.workspaceRuntimes = new WorkspaceRuntimeRegistry({\n      getConfig: () => this.config.config!,\n      bundledSkillsDir: resolveBundledSkillsDir(),\n    });\n    this.memoryPrefetch = new MemoryPrefetchCoordinator({\n      getConfig: () => this.config.config,\n      getMemoryManagerForSession: (sk) => this.getMemoryManagerForSession(sk),\n      getLastAssistantContent: (sk) => this.getLastAssistantContent(sk),\n    });\n    this.backgroundReview = new BackgroundReviewCoordinator({\n      getConfig: () => this.mergedConfig(),\n      onSkillsFilesystemMutate: () => this.refreshSkillsAfterDiskChange(),\n    });\n    this.toolsFactory = new AgentToolsFactory(this.buildToolsFactoryDeps());\n\n    this.defaultModel = config.model || getDefaultModelSync(config.config);\n\n    this.credentialResolver = new CredentialResolver();\n    this.warmCredentialCache().catch((err) => {\n      const em = err instanceof Error ? err.message : String(err);\n      log.warn({ err, errorMessage: em }, `Credential cache pre-warm failed: ${em}`);\n    });\n  }\n\n  private computeBaseWorkspacePath(): string {\n    const cfg = this.config.config;\n    if (!cfg) {\n      return expandWorkspacePathString(this.config.workspace);\n    }\n    return resolveEffectiveAgentProfileForSession(cfg, null).resolvedWorkspacePath;\n  }\n\n  /**\n   * Workspace root for inbound attachments / side effects for this session's agent id.\n   * Uses in-memory session workspace overrides when the session has a persisted `workingDirectoryOverride`.\n   */\n  getResolvedWorkspaceForSession(sessionKey: string): string {\n    const cfg = this.config.config!;\n    const fromMap = this.sessionWorkspaceOverrides.get(sessionKey);\n    if (fromMap !== undefined) {\n      return fromMap;\n    }\n    return resolveEffectiveAgentProfileForSession(cfg, sessionKey).resolvedWorkspacePath;\n  }\n\n  /**\n   * Sync in-memory workspace override from session config (after load or PATCH).\n   * Pass `null` to clear when the session has no `workingDirectoryOverride` on disk.\n   */\n  setSessionWorkspaceOverride(sessionKey: string, absolutePath: string | null): void {\n    if (absolutePath === null || absolutePath === '') {\n      this.sessionWorkspaceOverrides.delete(sessionKey);\n    } else {\n      this.sessionWorkspaceOverrides.set(sessionKey, absolutePath);\n    }\n  }\n\n  /** Merged `thinkingDefault` for this session's agent id (defaults + `agents.list`). */\n  getThinkingDefaultForSession(\n    sessionKey: string,\n  ): import('./transcript/thinking-types.js').ThinkLevel | undefined {\n    const cfg = this.mergedConfig();\n    if (!cfg) {\n      return undefined;\n    }\n    return resolveEffectiveAgentProfileForSession(cfg, sessionKey).thinkingDefault;\n  }\n\n  private pickDefaultModelRef(): string {\n    const cfg = this.mergedConfig();\n    const ref = getAgentDefaultModelRef(cfg);\n    return ref?.trim() || getDefaultModelSync(cfg);\n  }\n\n  private resolveModelStringToModel(modelRef: string): Model<Api> {\n    try {\n      return resolveModel(modelRef);\n    } catch {\n      const fallback = getDefaultModelSync(this.mergedConfig());\n      log.warn({ modelRef, fallback }, 'Model not found, using default');\n      return resolveModel(fallback);\n    }\n  }\n\n  /**\n   * Keep defaults in sync when config is hot-reloaded or saved from the UI.\n   *\n   * The previous implementation rebuilt the entire `AgentToolsFactory` (80+ lines\n   * of dependency wiring) on every reload. The factory's deps are now built from\n   * a single helper ({@link buildToolsFactoryDeps}) and read `this.*` through\n   * closures, so existing instances automatically see the new config without\n   * reconstruction. The browser is still shut down because its cached settings\n   * (headless mode, backend choice) come from the config snapshot at connect time.\n   */\n  updateAgentDefaults(config: Config): void {\n    this.config.config = config;\n    const ref = getAgentDefaultModelRef(config);\n    this.config.model = ref;\n    this.defaultModel = ref || getDefaultModelSync(config);\n    this.baseWorkspacePath = this.computeBaseWorkspacePath();\n    void this.toolsFactory.shutdownBrowser();\n    void this.workspaceRuntimes.clearAll();\n  }\n\n  /**\n   * Construct the dep bag passed to `AgentToolsFactory`. Closures reference\n   * `this.*` so they remain valid across hot reloads (no rebuild needed).\n   */\n  private buildToolsFactoryDeps(): ConstructorParameters<typeof AgentToolsFactory>[0] {\n    return {\n      workspace: this.baseWorkspacePath,\n      extensionRegistry: this.config.extensionRegistry,\n      getCurrentContext: this.config.getCurrentContext,\n      hookRunner: this.config.hookRunner,\n      bus: this.config.bus,\n      getConfig: () => this.mergedConfig(),\n      getPrimaryModel: () => this.resolveModelStringToModel(this.pickDefaultModelRef()),\n      getBuiltinMemoryStore: () =>\n        this.workspaceRuntimes.getOrCreate(this.baseWorkspacePath).builtinMemoryStore,\n      getMemoryManager: () =>\n        this.workspaceRuntimes.getOrCreate(this.baseWorkspacePath).memoryManager,\n      getSessionStore: this.config.getSessionStore,\n      gatewayClarify: this.config.gatewayClarify,\n      getCronService: this.config.getCronService,\n      getWorkflowRunService: this.config.getWorkflowRunService,\n      getSkillIndexingContext: () => {\n        const ctx = this.config.getCurrentContext?.();\n        if (!ctx?.sessionKey) return undefined;\n        const inst = this.agents.get(ctx.sessionKey);\n        if (!inst) return undefined;\n        return {\n          registeredToolNames: inst.registeredToolNames,\n          skillAllowlist: inst.effectiveProfile.skillsAllowlist,\n        };\n      },\n      onSkillsFilesystemMutate: () => {\n        this.refreshSkillsAfterDiskChange();\n      },\n      getSkillPassthroughEnvVarNames: () => {\n        const ctx = this.config.getCurrentContext?.();\n        if (!ctx?.sessionKey) return [];\n        return [...(this.agents.get(ctx.sessionKey)?.skillEnvPassthroughKeys ?? [])];\n      },\n      registerSkillEnvPassthrough: (names: string[]) => {\n        const ctx = this.config.getCurrentContext?.();\n        if (!ctx?.sessionKey) return;\n        const inst = this.agents.get(ctx.sessionKey);\n        if (!inst) return;\n        for (const n of names) {\n          if (isValidSkillEnvVarName(n)) {\n            inst.skillEnvPassthroughKeys.add(n.trim());\n          }\n        }\n      },\n    };\n  }\n\n  getMemoryManager(): MemoryManager {\n    return this.workspaceRuntimes.getOrCreate(this.baseWorkspacePath).memoryManager;\n  }\n\n  private getMemoryManagerForSession(sessionKey: string): MemoryManager {\n    const path = this.getResolvedWorkspaceForSession(sessionKey);\n    return this.workspaceRuntimes.getOrCreate(path).memoryManager;\n  }\n\n  /**\n   * Prefix the user turn with fenced prefetched memory (external providers).\n   * Delegates to {@link MemoryPrefetchCoordinator}.\n   */\n  applyMemoryPrefetchToUserMessage(\n    userMessage: AgentMessage,\n    sessionKey: string,\n  ): Promise<AgentMessage> {\n    return this.memoryPrefetch.applyToUserMessage(userMessage, sessionKey);\n  }\n\n  /**\n   * After a completed turn: sync external providers and queue next-turn prefetch.\n   * Delegates to {@link MemoryPrefetchCoordinator}.\n   */\n  afterAgentTurn(sessionKey: string, userPlainText: string): void {\n    this.memoryPrefetch.afterTurn(sessionKey, userPlainText);\n  }\n\n  /**\n   * Call once per user turn before the main `agent.prompt` (via {@link runAgentTurnWithModelFallbacks} `beforeUserPrompt`).\n   * Delegates to {@link BackgroundReviewCoordinator}.\n   */\n  beginBackgroundReviewUserTurn(sessionKey: string): void {\n    const inst = this.agents.get(sessionKey);\n    if (!inst) return;\n    this.backgroundReview.beginUserTurn(sessionKey, inst.registeredToolNames);\n  }\n\n  /**\n   * After a successful main turn (after memory sync via `afterAgentTurn`), may run a quiet follow-up for memory/skills.\n   * Delegates to {@link BackgroundReviewCoordinator}.\n   */\n  scheduleBackgroundReviewAfterUserTurn(sessionKey: string): void {\n    const inst = this.agents.get(sessionKey);\n    if (!inst) return;\n    this.backgroundReview.scheduleAfterUserTurn({\n      sessionKey,\n      agent: inst.agent,\n      registeredToolNames: inst.registeredToolNames,\n      skillAllowlist: inst.effectiveProfile.skillsAllowlist,\n      workspacePath: inst.resolvedWorkspacePath,\n      lastAssistantText: this.getLastAssistantContent(sessionKey),\n      workspaceRuntime: this.workspaceRuntimes.getOrCreate(inst.resolvedWorkspacePath),\n    });\n  }\n\n  /**\n   * Expand `/skill:name` user text into the full skill block for the current turn (WebChat, channels).\n   */\n  expandSkillUserText(text: string): string {\n    const ctx = this.config.getCurrentContext?.();\n    const 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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAe2E;kBAEjB;qBAKc;aAEtB;yBACwB;gBACe;kBAE7B;YACkB;AAkC9E,MAAM,MAAM,aAAa,eAAe;AAsDxC,IAAa,eAAb,MAA0D;CACxD,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;CACA;CACA;CAEA,YAAY,QAA4B;AACtC,OAAK,SAAS;AACd,OAAK,oBAAoB,KAAK,0BAA0B;AACxD,OAAK,oBAAoB,IAAI,yBAAyB;GACpD,iBAAiB,KAAK,OAAO;GAC7B,kBAAkB,yBAAyB;GAC5C,CAAC;AACF,OAAK,iBAAiB,IAAI,0BAA0B;GAClD,iBAAiB,KAAK,OAAO;GAC7B,6BAA6B,OAAO,KAAK,2BAA2B,GAAG;GACvE,0BAA0B,OAAO,KAAK,wBAAwB,GAAG;GAClE,CAAC;AACF,OAAK,mBAAmB,IAAI,4BAA4B;GACtD,iBAAiB,KAAK,cAAc;GACpC,gCAAgC,KAAK,8BAA8B;GACpE,CAAC;AACF,OAAK,eAAe,IAAI,kBAAkB,KAAK,uBAAuB,CAAC;AAEvE,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,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;;;;;;;;;;;;;CAcjC,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;AACnC,OAAK,kBAAkB,UAAU;;;;;;CAOxC,wBAAoF;AAClF,SAAO;GACL,WAAW,KAAK;GAChB,mBAAmB,KAAK,OAAO;GAC/B,mBAAmB,KAAK,OAAO;GAC/B,YAAY,KAAK,OAAO;GACxB,KAAK,KAAK,OAAO;GACjB,iBAAiB,KAAK,cAAc;GACpC,uBAAuB,KAAK,0BAA0B,KAAK,qBAAqB,CAAC;GACjF,6BACE,KAAK,kBAAkB,YAAY,KAAK,kBAAkB,CAAC;GAC7D,wBACE,KAAK,kBAAkB,YAAY,KAAK,kBAAkB,CAAC;GAC7D,iBAAiB,KAAK,OAAO;GAC7B,gBAAgB,KAAK,OAAO;GAC5B,gBAAgB,KAAK,OAAO;GAC5B,uBAAuB,KAAK,OAAO;GACnC,+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;;CAGH,mBAAkC;AAChC,SAAO,KAAK,kBAAkB,YAAY,KAAK,kBAAkB,CAAC;;CAGpE,2BAAmC,YAAmC;EACpE,MAAM,OAAO,KAAK,+BAA+B,WAAW;AAC5D,SAAO,KAAK,kBAAkB,YAAY,KAAK,CAAC;;;;;;CAOlD,iCACE,aACA,YACuB;AACvB,SAAO,KAAK,eAAe,mBAAmB,aAAa,WAAW;;;;;;CAOxE,eAAe,YAAoB,eAA6B;AAC9D,OAAK,eAAe,UAAU,YAAY,cAAc;;;;;;CAO1D,8BAA8B,YAA0B;EACtD,MAAM,OAAO,KAAK,OAAO,IAAI,WAAW;AACxC,MAAI,CAAC,KAAM;AACX,OAAK,iBAAiB,cAAc,YAAY,KAAK,oBAAoB;;;;;;CAO3E,sCAAsC,YAA0B;EAC9D,MAAM,OAAO,KAAK,OAAO,IAAI,WAAW;AACxC,MAAI,CAAC,KAAM;AACX,OAAK,iBAAiB,sBAAsB;GAC1C;GACA,OAAO,KAAK;GACZ,qBAAqB,KAAK;GAC1B,gBAAgB,KAAK,iBAAiB;GACtC,eAAe,KAAK;GACpB,mBAAmB,KAAK,wBAAwB,WAAW;GAC3D,kBAAkB,KAAK,kBAAkB,YAAY,KAAK,sBAAsB;GACjF,CAAC;;;;;CAMJ,oBAAoB,MAAsB;EACxC,MAAM,MAAM,KAAK,OAAO,qBAAqB;EAC7C,MAAM,OAAO,KAAK,aACd,KAAK,+BAA+B,IAAI,WAAW,GACnD,KAAK;AACT,SAAO,KAAK,kBAAkB,YAAY,KAAK,CAAC,aAAa,cAAc,KAAK;;;;;;CAOlF,uBAAuB,WAAmB,MAAmD;EAC3F,MAAM,QAAQ,KAAK,kBAAkB,YAAY,KAAK,kBAAkB,CAAC,aAAa,UAAU,UAAU;AAC1G,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,kBAAkB,YAAY,KAAK,kBAAkB,CAAC,aAAa,WAAW,CAAC,KAAK,MAAM;GACpG,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,kBAAkB,YAAY,SAAS,sBAAsB;AAC7E,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,kBAAkB,YAAY,SAAS,sBAAsB;AAC7E,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,MAAM,EAAE,YAAY,EAAE,kCAAkC;AAC5D,UAAO,SAAS;;EAIpB,MAAM,UAAU,uCAAuC,KAAK,WAAW;EACvE,MAAM,eAAe;EACrB,MAAM,KAAK,KAAK,kBAAkB,YAAY,aAAa;AAE3D,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;GAC3C,CAAC;AAEF,OAAK,iBAAiB,cAAc,YAAY,OAAO,oBAAoB;EAE3E,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,QAAK,iBAAiB,cAAc,WAAW;AAC1C,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,eAAe,cAAc,WAAW;AAC7C,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,iBAAiB,OAAO;AAC7B,OAAK,MAAM,YAAY,KAAK,OAAO,QAAQ,CACzC,UAAS,MAAM,OAAO;AAExB,OAAK,OAAO,OAAO;AACnB,OAAK,eAAe,OAAO;AAC3B,OAAK,0BAA0B,OAAO;AACjC,OAAK,kBAAkB,UAAU;AACtC,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, resolveWorkspaceStatePath } from '../config/paths.js';\nimport { loadProfileMarkdownFiles, extractTextContent } from './context/workspace.js';\nimport { clearBootstrapSnapshot, resolveBootstrapContextSync } from './bootstrap/bootstrap-files.js';\nimport type { EmbeddedContextFile } from './bootstrap/types.js';\nimport { AgentToolsFactory } from './tools/factory.js';\nimport { parseMcpToolName } from './mcp/bundle-mcp-policy.js';\nimport {\n  disposeAllSessionMcpRuntimes,\n  retireSessionMcpRuntimeForSessionKey,\n} from './mcp/bundle-mcp-tools.js';\nimport { evictAllEmbeddedSessionRunners, evictEmbeddedSessionRunner } from './embedded/session-runner.js';\nimport type { GatewayClarifyRequestFn } from './tools/clarify-tool.js';\nimport type { ExtensionRegistryImpl as ExtensionRegistry } from '../extensions/index.js';\nimport type { MessageBus } from '../infra/bus/index.js';\nimport type { CronService } from '../cron/index.js';\nimport type { SessionStore } from '../session/store.js';\nimport { isValidSkillEnvVarName } from './skills/required-env-vars.js';\nimport type { SessionContext } from './session/session-context.js';\nimport type { Skill, SkillMarkdownPreviewPayload } from './skills/types.js';\nimport { 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  /** Gateway: starts persisted workflow runs (dedicated chat session per run). */\n  getWorkflowRunService?: () => import('../workflows/service/workflow-run-service.types.js').WorkflowRunServiceLike | undefined;\n}\n\nexport interface AgentInstance {\n  agent: Agent;\n  sessionKey: string;\n  createdAt: number;\n  lastUsedAt: number;\n  effectiveProfile: EffectiveAgentProfile;\n  resolvedWorkspacePath: string;\n  /** Tool names registered on this agent (for skill indexing / tool gating). */\n  registeredToolNames: string[];\n  /** Declared env var names from skill_view; shell reads values from process.env at spawn time. */\n  skillEnvPassthroughKeys: Set<string>;\n}\n\n\nexport class AgentManager implements AgentInstanceGateway {\n  private agents = new Map<string, AgentInstance>();\n  private config: AgentManagerConfig;\n  private toolsFactory: AgentToolsFactory;\n\n  private mergedConfig(): Config | undefined {\n    const base = this.config.config;\n    return base ? applyConfigOverrides(base) : undefined;\n  }\n  /** Default agent workspace (effective profile for `getDefaultAgentId`). */\n  private baseWorkspacePath: string;\n  /** Per-session absolute markdown workspace when `SessionAgentConfig.workingDirectoryOverride` is set. */\n  private sessionWorkspaceOverrides = new Map<string, string>();\n  private defaultModel: string;\n  private credentialCache = new Map<string, string>();\n  private credentialResolver: CredentialResolver;\n  private workspaceRuntimes: WorkspaceRuntimeRegistry;\n  private memoryPrefetch: MemoryPrefetchCoordinator;\n  private backgroundReview: BackgroundReviewCoordinator;\n\n  constructor(config: AgentManagerConfig) {\n    this.config = config;\n    this.baseWorkspacePath = this.computeBaseWorkspacePath();\n    this.workspaceRuntimes = new WorkspaceRuntimeRegistry({\n      getConfig: () => this.config.config!,\n      bundledSkillsDir: resolveBundledSkillsDir(),\n    });\n    this.memoryPrefetch = new MemoryPrefetchCoordinator({\n      getConfig: () => this.config.config,\n      getMemoryManagerForSession: (sk) => this.getMemoryManagerForSession(sk),\n      getLastAssistantContent: (sk) => this.getLastAssistantContent(sk),\n    });\n    this.backgroundReview = new BackgroundReviewCoordinator({\n      getConfig: () => this.mergedConfig(),\n      onSkillsFilesystemMutate: () => this.refreshSkillsAfterDiskChange(),\n    });\n    this.toolsFactory = new AgentToolsFactory(this.buildToolsFactoryDeps());\n\n    this.defaultModel = config.model || getDefaultModelSync(config.config);\n\n    this.credentialResolver = new CredentialResolver();\n    this.warmCredentialCache().catch((err) => {\n      const em = err instanceof Error ? err.message : String(err);\n      log.warn({ err, errorMessage: em }, `Credential cache pre-warm failed: ${em}`);\n    });\n  }\n\n  private computeBaseWorkspacePath(): string {\n    const cfg = this.config.config;\n    if (!cfg) {\n      return expandWorkspacePathString(this.config.workspace);\n    }\n    return resolveEffectiveAgentProfileForSession(cfg, null).resolvedWorkspacePath;\n  }\n\n  /**\n   * Workspace root for inbound attachments / side effects for this session's agent id.\n   * Uses in-memory session workspace overrides when the session has a persisted `workingDirectoryOverride`.\n   */\n  getResolvedWorkspaceForSession(sessionKey: string): string {\n    const cfg = this.config.config!;\n    const fromMap = this.sessionWorkspaceOverrides.get(sessionKey);\n    if (fromMap !== undefined) {\n      return fromMap;\n    }\n    return resolveEffectiveAgentProfileForSession(cfg, sessionKey).resolvedWorkspacePath;\n  }\n\n  /**\n   * Sync in-memory workspace override from session config (after load or PATCH).\n   * Pass `null` to clear when the session has no `workingDirectoryOverride` on disk.\n   */\n  setSessionWorkspaceOverride(sessionKey: string, absolutePath: string | null): void {\n    if (absolutePath === null || absolutePath === '') {\n      this.sessionWorkspaceOverrides.delete(sessionKey);\n    } else {\n      this.sessionWorkspaceOverrides.set(sessionKey, absolutePath);\n    }\n  }\n\n  /** Merged `thinkingDefault` for this session's agent id (defaults + `agents.list`). */\n  getThinkingDefaultForSession(\n    sessionKey: string,\n  ): import('./transcript/thinking-types.js').ThinkLevel | undefined {\n    const cfg = this.mergedConfig();\n    if (!cfg) {\n      return undefined;\n    }\n    return resolveEffectiveAgentProfileForSession(cfg, sessionKey).thinkingDefault;\n  }\n\n  private pickDefaultModelRef(): string {\n    const cfg = this.mergedConfig();\n    const ref = getAgentDefaultModelRef(cfg);\n    return ref?.trim() || getDefaultModelSync(cfg);\n  }\n\n  private resolveModelStringToModel(modelRef: string): Model<Api> {\n    try {\n      return resolveModel(modelRef);\n    } catch {\n      const fallback = getDefaultModelSync(this.mergedConfig());\n      log.warn({ modelRef, fallback }, 'Model not found, using default');\n      return resolveModel(fallback);\n    }\n  }\n\n  /**\n   * Keep defaults in sync when config is hot-reloaded or saved from the UI.\n   *\n   * The previous implementation rebuilt the entire `AgentToolsFactory` (80+ lines\n   * of dependency wiring) on every reload. The factory's deps are now built from\n   * a single helper ({@link buildToolsFactoryDeps}) and read `this.*` through\n   * closures, so existing instances automatically see the new config without\n   * reconstruction. The browser is still shut down because its cached settings\n   * (headless mode, backend choice) come from the config snapshot at connect time.\n   */\n  updateAgentDefaults(config: Config): void {\n    this.config.config = config;\n    const ref = getAgentDefaultModelRef(config);\n    this.config.model = ref;\n    this.defaultModel = ref || getDefaultModelSync(config);\n    this.baseWorkspacePath = this.computeBaseWorkspacePath();\n    void this.toolsFactory.shutdownBrowser();\n    void this.workspaceRuntimes.clearAll();\n  }\n\n  /**\n   * Construct the dep bag passed to `AgentToolsFactory`. Closures reference\n   * `this.*` so they remain valid across hot reloads (no rebuild needed).\n   */\n  private buildToolsFactoryDeps(): ConstructorParameters<typeof AgentToolsFactory>[0] {\n    return {\n      workspace: this.baseWorkspacePath,\n      extensionRegistry: this.config.extensionRegistry,\n      getCurrentContext: this.config.getCurrentContext,\n      hookRunner: this.config.hookRunner,\n      bus: this.config.bus,\n      getConfig: () => this.mergedConfig(),\n      getPrimaryModel: () => this.resolveModelStringToModel(this.pickDefaultModelRef()),\n      getBuiltinMemoryStore: () =>\n        this.workspaceRuntimes.getOrCreate(this.baseWorkspacePath).builtinMemoryStore,\n      getMemoryManager: () =>\n        this.workspaceRuntimes.getOrCreate(this.baseWorkspacePath).memoryManager,\n      getSessionStore: this.config.getSessionStore,\n      gatewayClarify: this.config.gatewayClarify,\n      getCronService: this.config.getCronService,\n      getWorkflowRunService: this.config.getWorkflowRunService,\n      getSkillIndexingContext: () => {\n        const ctx = this.config.getCurrentContext?.();\n        if (!ctx?.sessionKey) return undefined;\n        const inst = this.agents.get(ctx.sessionKey);\n        if (!inst) return undefined;\n        return {\n          registeredToolNames: inst.registeredToolNames,\n          skillAllowlist: inst.effectiveProfile.skillsAllowlist,\n        };\n      },\n      onSkillsFilesystemMutate: () => {\n        this.refreshSkillsAfterDiskChange();\n      },\n      getSkillPassthroughEnvVarNames: () => {\n        const ctx = this.config.getCurrentContext?.();\n        if (!ctx?.sessionKey) return [];\n        return [...(this.agents.get(ctx.sessionKey)?.skillEnvPassthroughKeys ?? [])];\n      },\n      registerSkillEnvPassthrough: (names: string[]) => {\n        const ctx = this.config.getCurrentContext?.();\n        if (!ctx?.sessionKey) return;\n        const inst = this.agents.get(ctx.sessionKey);\n        if (!inst) return;\n        for (const n of names) {\n          if (isValidSkillEnvVarName(n)) {\n            inst.skillEnvPassthroughKeys.add(n.trim());\n          }\n        }\n      },\n    };\n  }\n\n  getMemoryManager(): MemoryManager {\n    return this.workspaceRuntimes.getOrCreate(this.baseWorkspacePath).memoryManager;\n  }\n\n  private getMemoryManagerForSession(sessionKey: string): MemoryManager {\n    const path = this.getResolvedWorkspaceForSession(sessionKey);\n    return this.workspaceRuntimes.getOrCreate(path).memoryManager;\n  }\n\n  /**\n   * Prefix the user turn with fenced prefetched memory (external providers).\n   * Delegates to {@link MemoryPrefetchCoordinator}.\n   */\n  applyMemoryPrefetchToUserMessage(\n    userMessage: AgentMessage,\n    sessionKey: string,\n  ): Promise<AgentMessage> {\n    return this.memoryPrefetch.applyToUserMessage(userMessage, sessionKey);\n  }\n\n  /**\n   * After a completed turn: sync external providers and queue next-turn prefetch.\n   * Delegates to {@link MemoryPrefetchCoordinator}.\n   */\n  afterAgentTurn(sessionKey: string, userPlainText: string): void {\n    this.memoryPrefetch.afterTurn(sessionKey, userPlainText);\n  }\n\n  /**\n   * Call once per user turn before the main `agent.prompt` (via {@link runAgentTurnWithModelFallbacks} `beforeUserPrompt`).\n   * Delegates to {@link BackgroundReviewCoordinator}.\n   */\n  beginBackgroundReviewUserTurn(sessionKey: string): void {\n    const inst = this.agents.get(sessionKey);\n    if (!inst) return;\n    this.backgroundReview.beginUserTurn(sessionKey, inst.registeredToolNames);\n  }\n\n  /**\n   * After a successful main turn (after memory sync via `afterAgentTurn`), may run a quiet follow-up for memory/skills.\n   * Delegates to {@link BackgroundReviewCoordinator}.\n   */\n  scheduleBackgroundReviewAfterUserTurn(sessionKey: string): void {\n    const inst = this.agents.get(sessionKey);\n    if (!inst) return;\n    this.backgroundReview.scheduleAfterUserTurn({\n      sessionKey,\n      agent: inst.agent,\n      registeredToolNames: inst.registeredToolNames,\n      skillAllowlist: inst.effectiveProfile.skillsAllowlist,\n      workspacePath: inst.resolvedWorkspacePath,\n      lastAssistantText: this.getLastAssistantContent(sessionKey),\n      workspaceRuntime: this.workspaceRuntimes.getOrCreate(inst.resolvedWorkspacePath),\n    });\n  }\n\n  /**\n   * Expand `/skill:name` user text into the full skill block for the current turn (WebChat, channels).\n   */\n  expandSkillUserText(text: string): string {\n    const ctx = this.config.getCurrentContext?.();\n    const 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 workspaceStatePath = resolveWorkspaceStatePath(cfg, profile.agentId);\n    const heartbeatEnabled = cfg.gateway?.heartbeat?.includeSystemPromptSection ?? false;\n    const contextInjection = cfg.agents?.defaults?.contextInjection ?? 'always';\n    const { contextFiles } = resolveBootstrapContextSync({\n      profileDir,\n      workspaceStatePath,\n      config: cfg,\n      sessionKey,\n      excludeHeartbeat: excludeHeartbeat ?? !heartbeatEnabled,\n      contextInjection,\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      clearBootstrapSnapshot(sessionKey);\n      this.config.getModelManager?.().clearSessionProfileDefault(sessionKey);\n      log.info({ sessionKey, totalAgents: this.agents.size }, 'Removed agent instance');\n      return true;\n    }\n    return false;\n  }\n\n  /**\n   * Get all active session keys\n   */\n  getActiveSessions(): string[] {\n    return Array.from(this.agents.keys());\n  }\n\n  /**\n   * Get agent count\n   */\n  getAgentCount(): number {\n    return this.agents.size;\n  }\n\n  /**\n   * 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/agent-scope.d.ts

@@ -38,7 +38,6 @@ export declare function resolveAgentHomeDir(cfg: Config, agentId: string): strin
 export declare function resolveAgentProfileDir(cfg: Config, agentId: string): string;
 /** Resolved path for a single profile Markdown basename (e.g. `SOUL.md`). */
 export declare function resolveAgentProfileMarkdownPath(cfg: Config, agentId: string, filename: string): string;
-export declare function resolveSessionsDir(cfg: Config, agentId: string): string;
 /** Agent ids whose workspace root contains `workspacePath` (longest match first). */
 export declare function resolveAgentIdsByWorkspacePath(cfg: Config, workspacePath: string): string[];
 /** Best-matching agent id for cwd, or `undefined` when no workspace contains the path. */

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

@@ -2,8 +2,8 @@ import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
 import { expandWorkspacePathString, init_workspace_path } from "../config/workspace-path.js";
 import { init_workspace_defaults, resolveDefaultAgentWorkspaceDir } from "../config/workspace-defaults.js";
-import { basename, isAbsolute, join, relative, resolve } from "node:path";
 import fs from "node:fs";
+import { basename, isAbsolute, join, relative, resolve } from "node:path";
 //#region src/agent/agent-scope.ts
 /**
 * Agent path and list resolution (config is the single source of truth).
@@ -119,9 +119,6 @@ function resolveAgentProfileMarkdownPath(cfg, agentId, filename) {
 	const base = basename(filename.trim().replace(/\\/g, "/"));
 	return join(resolveAgentProfileDir(cfg, agentId), base);
 }
-function resolveSessionsDir(cfg, agentId) {
-	return join(resolveAgentHomeDir(cfg, agentId), "sessions");
-}
 function normalizePathForComparison(input) {
 	const resolved = resolve(resolveUserPath(input));
 	let normalized = resolved;
@@ -219,6 +216,6 @@ var init_agent_scope = __esmMin((() => {
 }));
 //#endregion
 init_agent_scope();
-export { DEFAULT_AGENT_ID, STRICT_AGENT_ID_RE, getDefaultWorkspacePath, init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentDir, resolveAgentHomeDir, resolveAgentIdByWorkspacePath, resolveAgentIdForWorkspacePath, resolveAgentIdsByWorkspacePath, resolveAgentProfileDir, resolveAgentProfileMarkdownPath, resolveAgentWorkspaceDir, resolveDefaultAgentId, resolveSessionsDir, resolveUserPath, validateAgentIdForNewAgent };
+export { DEFAULT_AGENT_ID, STRICT_AGENT_ID_RE, getDefaultWorkspacePath, init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentDir, resolveAgentHomeDir, resolveAgentIdByWorkspacePath, resolveAgentIdForWorkspacePath, resolveAgentIdsByWorkspacePath, resolveAgentProfileDir, resolveAgentProfileMarkdownPath, resolveAgentWorkspaceDir, resolveDefaultAgentId, resolveUserPath, validateAgentIdForNewAgent };
 
 //# sourceMappingURL=agent-scope.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"agent-scope.js","names":[],"sources":["../../../src/agent/agent-scope.ts"],"sourcesContent":["/**\n * Agent path and list resolution (config is the single source of truth).\n */\n\nimport fs from 'node:fs';\nimport { basename, join, relative, resolve, isAbsolute } from 'node:path';\n\nimport type { Config } from '../config/schema.js';\nimport { resolveStateDir } from '../config/paths-state.js';\nimport { expandWorkspacePathString } from '../config/workspace-path.js';\nimport { resolveDefaultAgentWorkspaceDir } from '../config/workspace-defaults.js';\n\nexport const DEFAULT_AGENT_ID = 'main';\n\nconst VALID_ID_RE = /^[a-z0-9][a-z0-9_-]{0,63}$/i;\nconst INVALID_CHARS_RE = /[^a-z0-9_-]+/g;\nconst LEADING_DASH_RE = /^-+/;\nconst TRAILING_DASH_RE = /-+$/;\n\n/** Normalized id segment safe for directory names under `agents/<id>/`. */\nexport const STRICT_AGENT_ID_RE = /^[a-z0-9][a-z0-9_-]{0,63}$/;\n\nconst WINDOWS_RESERVED_AGENT_IDS = new Set<string>([\n  'con',\n  'prn',\n  'aux',\n  'nul',\n  'com1',\n  'com2',\n  'com3',\n  'com4',\n  'com5',\n  'com6',\n  'com7',\n  'com8',\n  'com9',\n  'lpt1',\n  'lpt2',\n  'lpt3',\n  'lpt4',\n  'lpt5',\n  'lpt6',\n  'lpt7',\n  'lpt8',\n  'lpt9',\n]);\n\nfunction normalizeLowercaseStringOrEmpty(s: string): string {\n  return s.trim().toLowerCase();\n}\n\n/** Path-safe agent id. */\nexport function normalizeAgentId(value: string | undefined | null): string {\n  const trimmed = (value ?? '').trim();\n  if (!trimmed) {\n    return DEFAULT_AGENT_ID;\n  }\n  const normalized = normalizeLowercaseStringOrEmpty(trimmed);\n  if (VALID_ID_RE.test(trimmed)) {\n    return normalized;\n  }\n  return (\n    normalized\n      .replace(INVALID_CHARS_RE, '-')\n      .replace(LEADING_DASH_RE, '')\n      .replace(TRAILING_DASH_RE, '')\n      .slice(0, 64) || DEFAULT_AGENT_ID\n  );\n}\n\n/**\n * Validate agent id for new agents (folder-safe path segment).\n * When `explicitId` is set, it must already match {@link STRICT_AGENT_ID_RE} (case-insensitive input, stored lowercase).\n * When omitted, id is derived from `displayNameForDerivation` via {@link normalizeAgentId}.\n */\nexport function validateAgentIdForNewAgent(\n  explicitId: string | undefined | null,\n  displayNameForDerivation: string,\n): { ok: true; agentId: string } | { ok: false; error: string } {\n  const explicit = explicitId?.trim();\n  if (explicit) {\n    const id = explicit.toLowerCase();\n    if (!STRICT_AGENT_ID_RE.test(id)) {\n      return {\n        ok: false,\n        error:\n          'Invalid agent id: use 1–64 characters; letters, digits, underscores, and hyphens only; start with a letter or digit.',\n      };\n    }\n    if (id === DEFAULT_AGENT_ID) {\n      return { ok: false, error: `\"${DEFAULT_AGENT_ID}\" is reserved` };\n    }\n    if (WINDOWS_RESERVED_AGENT_IDS.has(id)) {\n      return { ok: false, error: `Agent id \"${id}\" is reserved (Windows device name).` };\n    }\n    return { ok: true, agentId: id };\n  }\n\n  const agentId = normalizeAgentId(displayNameForDerivation.trim());\n  if (agentId === DEFAULT_AGENT_ID) {\n    return {\n      ok: false,\n      error:\n        'Display name cannot produce a valid agent folder id. Set an explicit Agent id (letters, digits, underscores, hyphens only).',\n    };\n  }\n  if (WINDOWS_RESERVED_AGENT_IDS.has(agentId)) {\n    return {\n      ok: false,\n      error: `That display name resolves to \"${agentId}\", which is reserved. Use a different display name or set an explicit Agent id.`,\n    };\n  }\n  if (!STRICT_AGENT_ID_RE.test(agentId)) {\n    return {\n      ok: false,\n      error:\n        'Could not derive a folder-safe agent id from the display name. Set an explicit Agent id (letters, digits, underscores, hyphens only).',\n    };\n  }\n  return { ok: true, agentId };\n}\n\n/** Expand `~` and resolve to an absolute path. */\nexport function resolveUserPath(raw: string): string {\n  const expanded = expandWorkspacePathString(raw.trim());\n  return resolve(expanded);\n}\n\ntype AgentEntry = NonNullable<NonNullable<Config['agents']>['list']>[number];\n\nexport function listAgentEntries(cfg: Config): AgentEntry[] {\n  const list = cfg.agents?.list;\n  if (!Array.isArray(list)) {\n    return [];\n  }\n  return list.filter((e): e is AgentEntry => Boolean(e && typeof e === 'object'));\n}\n\nexport function resolveDefaultAgentId(cfg: Config): string {\n  const explicit = cfg.agents?.default?.trim();\n  if (explicit) {\n    return normalizeAgentId(explicit);\n  }\n  const agents = listAgentEntries(cfg);\n  if (agents.length === 0) {\n    return DEFAULT_AGENT_ID;\n  }\n  const defaults = agents.filter((a) => a?.default === true);\n  const chosen = (defaults[0] ?? agents[0])?.id?.trim();\n  return chosen ? normalizeAgentId(chosen) : DEFAULT_AGENT_ID;\n}\n\nfunction resolveAgentEntry(cfg: Config, agentId: string): AgentEntry | undefined {\n  const id = normalizeAgentId(agentId);\n  return listAgentEntries(cfg).find((e) => normalizeAgentId(e.id) === id);\n}\n\n/**\n * Markdown workspace root for an agent.\n */\nexport function resolveAgentWorkspaceDir(cfg: Config, agentId: string): string {\n  const id = normalizeAgentId(agentId);\n  const configured = resolveAgentEntry(cfg, id)?.workspace?.trim();\n  if (configured) {\n    return resolveUserPath(configured);\n  }\n  const defaultAgentId = resolveDefaultAgentId(cfg);\n  const fallback = cfg.agents?.defaults?.workspace?.trim();\n  if (fallback) {\n    return join(resolveUserPath(fallback), id);\n  }\n  if (id === defaultAgentId) {\n    return resolveDefaultAgentWorkspaceDir(process.env);\n  }\n  const stateDir = resolveStateDir(process.env);\n  return join(stateDir, `workspace-${id}`);\n}\n\n/**\n * Internal agent state dir: credentials, `agent.json`, pid, inbox (`…/agent/`).\n */\nexport function resolveAgentDir(cfg: Config, agentId: string): string {\n  const id = normalizeAgentId(agentId);\n  const configured = resolveAgentEntry(cfg, id)?.agentDir?.trim();\n  if (configured) {\n    return resolveUserPath(configured);\n  }\n  const root = resolveStateDir(process.env);\n  return join(root, 'agents', id, 'agent');\n}\n\n/** Parent of `sessions/` and `agent/`: `<stateDir>/agents/<id>/`. */\nexport function resolveAgentHomeDir(cfg: Config, agentId: string): string {\n  return join(resolveStateDir(process.env), 'agents', normalizeAgentId(agentId));\n}\n\n/** Profile Markdown + gateway avatar files: `<stateDir>/agents/<id>/profile/`. */\nexport function resolveAgentProfileDir(cfg: Config, agentId: string): string {\n  return join(resolveAgentHomeDir(cfg, agentId), 'profile');\n}\n\n/** Resolved path for a single profile Markdown basename (e.g. `SOUL.md`). */\nexport function resolveAgentProfileMarkdownPath(cfg: Config, agentId: string, filename: string): string {\n  const base = basename(filename.trim().replace(/\\\\/g, '/'));\n  return join(resolveAgentProfileDir(cfg, agentId), base);\n}\n\nexport function resolveSessionsDir(cfg: Config, agentId: string): string {\n  return join(resolveAgentHomeDir(cfg, agentId), 'sessions');\n}\n\nfunction normalizePathForComparison(input: string): string {\n  const resolved = resolve(resolveUserPath(input));\n  let normalized = resolved;\n  try {\n    normalized = fs.realpathSync.native(resolved);\n  } catch {\n    // Keep lexical path for non-existent directories.\n  }\n  if (process.platform === 'win32') {\n    return normalized.toLowerCase();\n  }\n  return normalized;\n}\n\nfunction isPathWithinRoot(candidatePath: string, rootPath: string): boolean {\n  const rel = relative(rootPath, candidatePath);\n  return rel === '' || (!rel.startsWith('..') && !isAbsolute(rel));\n}\n\n/** Agent ids whose workspace root contains `workspacePath` (longest match first). */\nexport function resolveAgentIdsByWorkspacePath(cfg: Config, workspacePath: string): string[] {\n  const normalizedWorkspacePath = normalizePathForComparison(workspacePath);\n  const entries = listAgentEntries(cfg);\n  const matches: Array<{ id: string; workspaceDir: string; order: number }> = [];\n\n  for (let index = 0; index < entries.length; index += 1) {\n    const entry = entries[index]!;\n    const id = normalizeAgentId(entry.id);\n    const workspaceDir = normalizePathForComparison(resolveAgentWorkspaceDir(cfg, id));\n    if (!isPathWithinRoot(normalizedWorkspacePath, workspaceDir)) {\n      continue;\n    }\n    matches.push({ id, workspaceDir, order: index });\n  }\n\n  const defaultId = resolveDefaultAgentId(cfg);\n  if (!entries.some((e) => normalizeAgentId(e.id) === defaultId)) {\n    const workspaceDir = normalizePathForComparison(resolveAgentWorkspaceDir(cfg, defaultId));\n    if (isPathWithinRoot(normalizedWorkspacePath, workspaceDir)) {\n      matches.push({ id: defaultId, workspaceDir, order: entries.length });\n    }\n  }\n\n  matches.sort((left, right) => {\n    const workspaceLengthDelta = right.workspaceDir.length - left.workspaceDir.length;\n    if (workspaceLengthDelta !== 0) {\n      return workspaceLengthDelta;\n    }\n    return left.order - right.order;\n  });\n\n  return matches.map((entry) => entry.id);\n}\n\n/** Best-matching agent id for cwd, or `undefined` when no workspace contains the path. */\nexport function resolveAgentIdByWorkspacePath(\n  cfg: Config,\n  workspacePath: string,\n): string | undefined {\n  return resolveAgentIdsByWorkspacePath(cfg, workspacePath)[0];\n}\n\n/**\n * Find the agent id whose resolved markdown workspace matches `resolvedWorkspacePath`.\n * Falls back to {@link resolveDefaultAgentId} when no list entry matches.\n */\nexport function resolveAgentIdForWorkspacePath(cfg: Config, resolvedWorkspacePath: string): string {\n  return (\n    resolveAgentIdByWorkspacePath(cfg, resolvedWorkspacePath) ??\n    resolveDefaultAgentId(cfg)\n  );\n}\n\nexport function getDefaultWorkspacePath(cfg: Config): string {\n  return resolveAgentWorkspaceDir(cfg, resolveDefaultAgentId(cfg));\n}\n"],"mappings":"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"}
+{"version":3,"file":"agent-scope.js","names":[],"sources":["../../../src/agent/agent-scope.ts"],"sourcesContent":["/**\n * Agent path and list resolution (config is the single source of truth).\n */\n\nimport fs from 'node:fs';\nimport { basename, join, relative, resolve, isAbsolute } from 'node:path';\n\nimport type { Config } from '../config/schema.js';\nimport { resolveStateDir } from '../config/paths-state.js';\nimport { expandWorkspacePathString } from '../config/workspace-path.js';\nimport { resolveDefaultAgentWorkspaceDir } from '../config/workspace-defaults.js';\n\nexport const DEFAULT_AGENT_ID = 'main';\n\nconst VALID_ID_RE = /^[a-z0-9][a-z0-9_-]{0,63}$/i;\nconst INVALID_CHARS_RE = /[^a-z0-9_-]+/g;\nconst LEADING_DASH_RE = /^-+/;\nconst TRAILING_DASH_RE = /-+$/;\n\n/** Normalized id segment safe for directory names under `agents/<id>/`. */\nexport const STRICT_AGENT_ID_RE = /^[a-z0-9][a-z0-9_-]{0,63}$/;\n\nconst WINDOWS_RESERVED_AGENT_IDS = new Set<string>([\n  'con',\n  'prn',\n  'aux',\n  'nul',\n  'com1',\n  'com2',\n  'com3',\n  'com4',\n  'com5',\n  'com6',\n  'com7',\n  'com8',\n  'com9',\n  'lpt1',\n  'lpt2',\n  'lpt3',\n  'lpt4',\n  'lpt5',\n  'lpt6',\n  'lpt7',\n  'lpt8',\n  'lpt9',\n]);\n\nfunction normalizeLowercaseStringOrEmpty(s: string): string {\n  return s.trim().toLowerCase();\n}\n\n/** Path-safe agent id. */\nexport function normalizeAgentId(value: string | undefined | null): string {\n  const trimmed = (value ?? '').trim();\n  if (!trimmed) {\n    return DEFAULT_AGENT_ID;\n  }\n  const normalized = normalizeLowercaseStringOrEmpty(trimmed);\n  if (VALID_ID_RE.test(trimmed)) {\n    return normalized;\n  }\n  return (\n    normalized\n      .replace(INVALID_CHARS_RE, '-')\n      .replace(LEADING_DASH_RE, '')\n      .replace(TRAILING_DASH_RE, '')\n      .slice(0, 64) || DEFAULT_AGENT_ID\n  );\n}\n\n/**\n * Validate agent id for new agents (folder-safe path segment).\n * When `explicitId` is set, it must already match {@link STRICT_AGENT_ID_RE} (case-insensitive input, stored lowercase).\n * When omitted, id is derived from `displayNameForDerivation` via {@link normalizeAgentId}.\n */\nexport function validateAgentIdForNewAgent(\n  explicitId: string | undefined | null,\n  displayNameForDerivation: string,\n): { ok: true; agentId: string } | { ok: false; error: string } {\n  const explicit = explicitId?.trim();\n  if (explicit) {\n    const id = explicit.toLowerCase();\n    if (!STRICT_AGENT_ID_RE.test(id)) {\n      return {\n        ok: false,\n        error:\n          'Invalid agent id: use 1–64 characters; letters, digits, underscores, and hyphens only; start with a letter or digit.',\n      };\n    }\n    if (id === DEFAULT_AGENT_ID) {\n      return { ok: false, error: `\"${DEFAULT_AGENT_ID}\" is reserved` };\n    }\n    if (WINDOWS_RESERVED_AGENT_IDS.has(id)) {\n      return { ok: false, error: `Agent id \"${id}\" is reserved (Windows device name).` };\n    }\n    return { ok: true, agentId: id };\n  }\n\n  const agentId = normalizeAgentId(displayNameForDerivation.trim());\n  if (agentId === DEFAULT_AGENT_ID) {\n    return {\n      ok: false,\n      error:\n        'Display name cannot produce a valid agent folder id. Set an explicit Agent id (letters, digits, underscores, hyphens only).',\n    };\n  }\n  if (WINDOWS_RESERVED_AGENT_IDS.has(agentId)) {\n    return {\n      ok: false,\n      error: `That display name resolves to \"${agentId}\", which is reserved. Use a different display name or set an explicit Agent id.`,\n    };\n  }\n  if (!STRICT_AGENT_ID_RE.test(agentId)) {\n    return {\n      ok: false,\n      error:\n        'Could not derive a folder-safe agent id from the display name. Set an explicit Agent id (letters, digits, underscores, hyphens only).',\n    };\n  }\n  return { ok: true, agentId };\n}\n\n/** Expand `~` and resolve to an absolute path. */\nexport function resolveUserPath(raw: string): string {\n  const expanded = expandWorkspacePathString(raw.trim());\n  return resolve(expanded);\n}\n\ntype AgentEntry = NonNullable<NonNullable<Config['agents']>['list']>[number];\n\nexport function listAgentEntries(cfg: Config): AgentEntry[] {\n  const list = cfg.agents?.list;\n  if (!Array.isArray(list)) {\n    return [];\n  }\n  return list.filter((e): e is AgentEntry => Boolean(e && typeof e === 'object'));\n}\n\nexport function resolveDefaultAgentId(cfg: Config): string {\n  const explicit = cfg.agents?.default?.trim();\n  if (explicit) {\n    return normalizeAgentId(explicit);\n  }\n  const agents = listAgentEntries(cfg);\n  if (agents.length === 0) {\n    return DEFAULT_AGENT_ID;\n  }\n  const defaults = agents.filter((a) => a?.default === true);\n  const chosen = (defaults[0] ?? agents[0])?.id?.trim();\n  return chosen ? normalizeAgentId(chosen) : DEFAULT_AGENT_ID;\n}\n\nfunction resolveAgentEntry(cfg: Config, agentId: string): AgentEntry | undefined {\n  const id = normalizeAgentId(agentId);\n  return listAgentEntries(cfg).find((e) => normalizeAgentId(e.id) === id);\n}\n\n/**\n * Markdown workspace root for an agent.\n */\nexport function resolveAgentWorkspaceDir(cfg: Config, agentId: string): string {\n  const id = normalizeAgentId(agentId);\n  const configured = resolveAgentEntry(cfg, id)?.workspace?.trim();\n  if (configured) {\n    return resolveUserPath(configured);\n  }\n  const defaultAgentId = resolveDefaultAgentId(cfg);\n  const fallback = cfg.agents?.defaults?.workspace?.trim();\n  if (fallback) {\n    return join(resolveUserPath(fallback), id);\n  }\n  if (id === defaultAgentId) {\n    return resolveDefaultAgentWorkspaceDir(process.env);\n  }\n  const stateDir = resolveStateDir(process.env);\n  return join(stateDir, `workspace-${id}`);\n}\n\n/**\n * Internal agent state dir: credentials, `agent.json`, pid, inbox (`…/agent/`).\n */\nexport function resolveAgentDir(cfg: Config, agentId: string): string {\n  const id = normalizeAgentId(agentId);\n  const configured = resolveAgentEntry(cfg, id)?.agentDir?.trim();\n  if (configured) {\n    return resolveUserPath(configured);\n  }\n  const root = resolveStateDir(process.env);\n  return join(root, 'agents', id, 'agent');\n}\n\n/** Parent of `sessions/` and `agent/`: `<stateDir>/agents/<id>/`. */\nexport function resolveAgentHomeDir(cfg: Config, agentId: string): string {\n  return join(resolveStateDir(process.env), 'agents', normalizeAgentId(agentId));\n}\n\n/** Profile Markdown + gateway avatar files: `<stateDir>/agents/<id>/profile/`. */\nexport function resolveAgentProfileDir(cfg: Config, agentId: string): string {\n  return join(resolveAgentHomeDir(cfg, agentId), 'profile');\n}\n\n/** Resolved path for a single profile Markdown basename (e.g. `SOUL.md`). */\nexport function resolveAgentProfileMarkdownPath(cfg: Config, agentId: string, filename: string): string {\n  const base = basename(filename.trim().replace(/\\\\/g, '/'));\n  return join(resolveAgentProfileDir(cfg, agentId), base);\n}\n\nfunction normalizePathForComparison(input: string): string {\n  const resolved = resolve(resolveUserPath(input));\n  let normalized = resolved;\n  try {\n    normalized = fs.realpathSync.native(resolved);\n  } catch {\n    // Keep lexical path for non-existent directories.\n  }\n  if (process.platform === 'win32') {\n    return normalized.toLowerCase();\n  }\n  return normalized;\n}\n\nfunction isPathWithinRoot(candidatePath: string, rootPath: string): boolean {\n  const rel = relative(rootPath, candidatePath);\n  return rel === '' || (!rel.startsWith('..') && !isAbsolute(rel));\n}\n\n/** Agent ids whose workspace root contains `workspacePath` (longest match first). */\nexport function resolveAgentIdsByWorkspacePath(cfg: Config, workspacePath: string): string[] {\n  const normalizedWorkspacePath = normalizePathForComparison(workspacePath);\n  const entries = listAgentEntries(cfg);\n  const matches: Array<{ id: string; workspaceDir: string; order: number }> = [];\n\n  for (let index = 0; index < entries.length; index += 1) {\n    const entry = entries[index]!;\n    const id = normalizeAgentId(entry.id);\n    const workspaceDir = normalizePathForComparison(resolveAgentWorkspaceDir(cfg, id));\n    if (!isPathWithinRoot(normalizedWorkspacePath, workspaceDir)) {\n      continue;\n    }\n    matches.push({ id, workspaceDir, order: index });\n  }\n\n  const defaultId = resolveDefaultAgentId(cfg);\n  if (!entries.some((e) => normalizeAgentId(e.id) === defaultId)) {\n    const workspaceDir = normalizePathForComparison(resolveAgentWorkspaceDir(cfg, defaultId));\n    if (isPathWithinRoot(normalizedWorkspacePath, workspaceDir)) {\n      matches.push({ id: defaultId, workspaceDir, order: entries.length });\n    }\n  }\n\n  matches.sort((left, right) => {\n    const workspaceLengthDelta = right.workspaceDir.length - left.workspaceDir.length;\n    if (workspaceLengthDelta !== 0) {\n      return workspaceLengthDelta;\n    }\n    return left.order - right.order;\n  });\n\n  return matches.map((entry) => entry.id);\n}\n\n/** Best-matching agent id for cwd, or `undefined` when no workspace contains the path. */\nexport function resolveAgentIdByWorkspacePath(\n  cfg: Config,\n  workspacePath: string,\n): string | undefined {\n  return resolveAgentIdsByWorkspacePath(cfg, workspacePath)[0];\n}\n\n/**\n * Find the agent id whose resolved markdown workspace matches `resolvedWorkspacePath`.\n * Falls back to {@link resolveDefaultAgentId} when no list entry matches.\n */\nexport function resolveAgentIdForWorkspacePath(cfg: Config, resolvedWorkspacePath: string): string {\n  return (\n    resolveAgentIdByWorkspacePath(cfg, resolvedWorkspacePath) ??\n    resolveDefaultAgentId(cfg)\n  );\n}\n\nexport function getDefaultWorkspacePath(cfg: Config): string {\n  return resolveAgentWorkspaceDir(cfg, resolveDefaultAgentId(cfg));\n}\n"],"mappings":"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"}

package/dist/src/agent/bootstrap/bootstrap-cache.d.ts

@@ -1,6 +1,9 @@
 import type { WorkspaceBootstrapFile } from './types.js';
+export declare function wasBootstrapContextInjected(sessionKey: string): boolean;
+export declare function markBootstrapContextInjected(sessionKey: string): void;
 export declare function getOrLoadBootstrapFiles(params: {
     profileDir: string;
+    workspaceStatePath: string;
     sessionKey: string;
 }): Promise<WorkspaceBootstrapFile[]>;
 export declare function clearBootstrapSnapshot(sessionKey: string): void;

package/dist/src/agent/bootstrap/bootstrap-cache.js

@@ -1,6 +1,7 @@
 import { loadProfileBootstrapFiles } from "./load-bootstrap-files.js";
 //#region src/agent/bootstrap/bootstrap-cache.ts
 const cache = /* @__PURE__ */ new Map();
+const bootstrapContextInjected = /* @__PURE__ */ new Set();
 function bootstrapFilesEqual(previous, next) {
 	if (previous.length !== next.length) return false;
 	return previous.every((file, index) => {
@@ -8,23 +9,32 @@ function bootstrapFilesEqual(previous, next) {
 		return updated !== void 0 && file.name === updated.name && file.path === updated.path && file.content === updated.content && file.missing === updated.missing;
 	});
 }
+function wasBootstrapContextInjected(sessionKey) {
+	return bootstrapContextInjected.has(sessionKey);
+}
+function markBootstrapContextInjected(sessionKey) {
+	bootstrapContextInjected.add(sessionKey);
+}
 async function getOrLoadBootstrapFiles(params) {
 	const existing = cache.get(params.sessionKey);
-	const files = loadProfileBootstrapFiles(params.profileDir);
-	if (existing && existing.profileDir === params.profileDir && bootstrapFilesEqual(existing.files, files)) return existing.files;
+	const files = loadProfileBootstrapFiles(params.profileDir, params.workspaceStatePath);
+	if (existing && existing.profileDir === params.profileDir && existing.workspaceStatePath === params.workspaceStatePath && bootstrapFilesEqual(existing.files, files)) return existing.files;
 	cache.set(params.sessionKey, {
 		profileDir: params.profileDir,
+		workspaceStatePath: params.workspaceStatePath,
 		files
 	});
 	return files;
 }
 function clearBootstrapSnapshot(sessionKey) {
 	cache.delete(sessionKey);
+	bootstrapContextInjected.delete(sessionKey);
 }
 function clearAllBootstrapSnapshots() {
 	cache.clear();
+	bootstrapContextInjected.clear();
 }
 //#endregion
-export { clearAllBootstrapSnapshots, clearBootstrapSnapshot, getOrLoadBootstrapFiles };
+export { clearAllBootstrapSnapshots, clearBootstrapSnapshot, getOrLoadBootstrapFiles, markBootstrapContextInjected, wasBootstrapContextInjected };
 
 //# sourceMappingURL=bootstrap-cache.js.map

package/dist/src/agent/bootstrap/bootstrap-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap-cache.js","names":[],"sources":["../../../../src/agent/bootstrap/bootstrap-cache.ts"],"sourcesContent":["import { loadProfileBootstrapFiles } from './load-bootstrap-files.js';\nimport type { WorkspaceBootstrapFile } from './types.js';\n\ntype BootstrapSnapshot = {\n  profileDir: string;\n  files: WorkspaceBootstrapFile[];\n};\n\nconst cache = new Map<string, BootstrapSnapshot>();\n\nfunction bootstrapFilesEqual(\n  previous: WorkspaceBootstrapFile[],\n  next: WorkspaceBootstrapFile[],\n): boolean {\n  if (previous.length !== next.length) {\n    return false;\n  }\n  return previous.every((file, index) => {\n    const updated = next[index];\n    return (\n      updated !== undefined &&\n      file.name === updated.name &&\n      file.path === updated.path &&\n      file.content === updated.content &&\n      file.missing === updated.missing\n    );\n  });\n}\n\nexport async function getOrLoadBootstrapFiles(params: {\n  profileDir: string;\n  sessionKey: string;\n}): Promise<WorkspaceBootstrapFile[]> {\n  const existing = cache.get(params.sessionKey);\n  const files = loadProfileBootstrapFiles(params.profileDir);\n  if (\n    existing &&\n    existing.profileDir === params.profileDir &&\n    bootstrapFilesEqual(existing.files, files)\n  ) {\n    return existing.files;\n  }\n  cache.set(params.sessionKey, { profileDir: params.profileDir, files });\n  return files;\n}\n\nexport function clearBootstrapSnapshot(sessionKey: string): void {\n  cache.delete(sessionKey);\n}\n\nexport function clearAllBootstrapSnapshots(): void {\n  cache.clear();\n}\n"],"mappings":";;AAQA,MAAM,wBAAQ,IAAI,KAAgC;AAElD,SAAS,oBACP,UACA,MACS;AACT,KAAI,SAAS,WAAW,KAAK,OAC3B,QAAO;AAET,QAAO,SAAS,OAAO,MAAM,UAAU;EACrC,MAAM,UAAU,KAAK;AACrB,SACE,YAAY,KAAA,KACZ,KAAK,SAAS,QAAQ,QACtB,KAAK,SAAS,QAAQ,QACtB,KAAK,YAAY,QAAQ,WACzB,KAAK,YAAY,QAAQ;GAE3B;;AAGJ,eAAsB,wBAAwB,QAGR;CACpC,MAAM,WAAW,MAAM,IAAI,OAAO,WAAW;CAC7C,MAAM,QAAQ,0BAA0B,OAAO,WAAW;AAC1D,KACE,YACA,SAAS,eAAe,OAAO,cAC/B,oBAAoB,SAAS,OAAO,MAAM,CAE1C,QAAO,SAAS;AAElB,OAAM,IAAI,OAAO,YAAY;EAAE,YAAY,OAAO;EAAY;EAAO,CAAC;AACtE,QAAO;;AAGT,SAAgB,uBAAuB,YAA0B;AAC/D,OAAM,OAAO,WAAW;;AAG1B,SAAgB,6BAAmC;AACjD,OAAM,OAAO"}
+{"version":3,"file":"bootstrap-cache.js","names":[],"sources":["../../../../src/agent/bootstrap/bootstrap-cache.ts"],"sourcesContent":["import { loadProfileBootstrapFiles } from './load-bootstrap-files.js';\nimport type { WorkspaceBootstrapFile } from './types.js';\n\ntype BootstrapSnapshot = {\n  profileDir: string;\n  workspaceStatePath: string;\n  files: WorkspaceBootstrapFile[];\n};\n\nconst cache = new Map<string, BootstrapSnapshot>();\nconst bootstrapContextInjected = new Set<string>();\n\nfunction bootstrapFilesEqual(\n  previous: WorkspaceBootstrapFile[],\n  next: WorkspaceBootstrapFile[],\n): boolean {\n  if (previous.length !== next.length) {\n    return false;\n  }\n  return previous.every((file, index) => {\n    const updated = next[index];\n    return (\n      updated !== undefined &&\n      file.name === updated.name &&\n      file.path === updated.path &&\n      file.content === updated.content &&\n      file.missing === updated.missing\n    );\n  });\n}\n\nexport function wasBootstrapContextInjected(sessionKey: string): boolean {\n  return bootstrapContextInjected.has(sessionKey);\n}\n\nexport function markBootstrapContextInjected(sessionKey: string): void {\n  bootstrapContextInjected.add(sessionKey);\n}\n\nexport async function getOrLoadBootstrapFiles(params: {\n  profileDir: string;\n  workspaceStatePath: string;\n  sessionKey: string;\n}): Promise<WorkspaceBootstrapFile[]> {\n  const existing = cache.get(params.sessionKey);\n  const files = loadProfileBootstrapFiles(params.profileDir, params.workspaceStatePath);\n  if (\n    existing &&\n    existing.profileDir === params.profileDir &&\n    existing.workspaceStatePath === params.workspaceStatePath &&\n    bootstrapFilesEqual(existing.files, files)\n  ) {\n    return existing.files;\n  }\n  cache.set(params.sessionKey, {\n    profileDir: params.profileDir,\n    workspaceStatePath: params.workspaceStatePath,\n    files,\n  });\n  return files;\n}\n\nexport function clearBootstrapSnapshot(sessionKey: string): void {\n  cache.delete(sessionKey);\n  bootstrapContextInjected.delete(sessionKey);\n}\n\nexport function clearAllBootstrapSnapshots(): void {\n  cache.clear();\n  bootstrapContextInjected.clear();\n}\n"],"mappings":";;AASA,MAAM,wBAAQ,IAAI,KAAgC;AAClD,MAAM,2CAA2B,IAAI,KAAa;AAElD,SAAS,oBACP,UACA,MACS;AACT,KAAI,SAAS,WAAW,KAAK,OAC3B,QAAO;AAET,QAAO,SAAS,OAAO,MAAM,UAAU;EACrC,MAAM,UAAU,KAAK;AACrB,SACE,YAAY,KAAA,KACZ,KAAK,SAAS,QAAQ,QACtB,KAAK,SAAS,QAAQ,QACtB,KAAK,YAAY,QAAQ,WACzB,KAAK,YAAY,QAAQ;GAE3B;;AAGJ,SAAgB,4BAA4B,YAA6B;AACvE,QAAO,yBAAyB,IAAI,WAAW;;AAGjD,SAAgB,6BAA6B,YAA0B;AACrE,0BAAyB,IAAI,WAAW;;AAG1C,eAAsB,wBAAwB,QAIR;CACpC,MAAM,WAAW,MAAM,IAAI,OAAO,WAAW;CAC7C,MAAM,QAAQ,0BAA0B,OAAO,YAAY,OAAO,mBAAmB;AACrF,KACE,YACA,SAAS,eAAe,OAAO,cAC/B,SAAS,uBAAuB,OAAO,sBACvC,oBAAoB,SAAS,OAAO,MAAM,CAE1C,QAAO,SAAS;AAElB,OAAM,IAAI,OAAO,YAAY;EAC3B,YAAY,OAAO;EACnB,oBAAoB,OAAO;EAC3B;EACD,CAAC;AACF,QAAO;;AAGT,SAAgB,uBAAuB,YAA0B;AAC/D,OAAM,OAAO,WAAW;AACxB,0BAAyB,OAAO,WAAW;;AAG7C,SAAgB,6BAAmC;AACjD,OAAM,OAAO;AACb,0BAAyB,OAAO"}

package/dist/src/agent/bootstrap/bootstrap-files.d.ts

@@ -4,29 +4,35 @@ export { isProfileBootstrapPending } from './load-bootstrap-files.js';
 export { clearAllBootstrapSnapshots, clearBootstrapSnapshot } from './bootstrap-cache.js';
 export declare function resolveBootstrapFilesSync(params: {
     profileDir: string;
+    workspaceStatePath: string;
     sessionKey?: string;
     excludeHeartbeat?: boolean;
 }): WorkspaceBootstrapFile[];
 export declare function resolveBootstrapFilesForRun(params: {
     profileDir: string;
+    workspaceStatePath: string;
     sessionKey?: string;
     excludeHeartbeat?: boolean;
     warn?: (message: string) => void;
 }): Promise<WorkspaceBootstrapFile[]>;
 export declare function resolveBootstrapContextSync(params: {
     profileDir: string;
+    workspaceStatePath: string;
     config?: Config;
     sessionKey?: string;
     excludeHeartbeat?: boolean;
+    contextInjection?: 'always' | 'continuation-skip' | 'never';
 }): {
     bootstrapFiles: WorkspaceBootstrapFile[];
     contextFiles: EmbeddedContextFile[];
 };
 export declare function resolveBootstrapContextForRun(params: {
     profileDir: string;
+    workspaceStatePath: string;
     config?: Config;
     sessionKey?: string;
     excludeHeartbeat?: boolean;
+    contextInjection?: 'always' | 'continuation-skip' | 'never';
     warn?: (message: string) => void;
 }): Promise<{
     bootstrapFiles: WorkspaceBootstrapFile[];

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

@@ -1,6 +1,6 @@
 import { DEFAULT_HEARTBEAT_FILENAME } from "../context/workspace.js";
 import { isProfileBootstrapPending, loadProfileBootstrapFiles } from "./load-bootstrap-files.js";
-import { clearAllBootstrapSnapshots, clearBootstrapSnapshot, getOrLoadBootstrapFiles } from "./bootstrap-cache.js";
+import { clearAllBootstrapSnapshots, clearBootstrapSnapshot, getOrLoadBootstrapFiles, markBootstrapContextInjected, wasBootstrapContextInjected } from "./bootstrap-cache.js";
 import { buildBootstrapContextFiles, resolveBootstrapMaxChars, resolveBootstrapTotalMaxChars } from "./bootstrap-context.js";
 import { filterBootstrapFilesForSession } from "./filter-bootstrap-files.js";
 //#region src/agent/bootstrap/bootstrap-files.ts
@@ -9,34 +9,57 @@ function filterHeartbeatBootstrapFile(files, exclude) {
 	return files.filter((file) => file.name !== DEFAULT_HEARTBEAT_FILENAME);
 }
 function resolveBootstrapFilesSync(params) {
-	return filterHeartbeatBootstrapFile(filterBootstrapFilesForSession(loadProfileBootstrapFiles(params.profileDir), params.sessionKey), params.excludeHeartbeat ?? false);
+	return filterHeartbeatBootstrapFile(filterBootstrapFilesForSession(loadProfileBootstrapFiles(params.profileDir, params.workspaceStatePath), params.sessionKey), params.excludeHeartbeat ?? false);
 }
 async function resolveBootstrapFilesForRun(params) {
 	const sessionKey = params.sessionKey;
 	return filterHeartbeatBootstrapFile(filterBootstrapFilesForSession(sessionKey ? await getOrLoadBootstrapFiles({
 		profileDir: params.profileDir,
+		workspaceStatePath: params.workspaceStatePath,
 		sessionKey
-	}) : loadProfileBootstrapFiles(params.profileDir), sessionKey), params.excludeHeartbeat ?? false);
+	}) : loadProfileBootstrapFiles(params.profileDir, params.workspaceStatePath), sessionKey), params.excludeHeartbeat ?? false);
 }
 function resolveBootstrapContextSync(params) {
+	const mode = params.contextInjection ?? "always";
+	if (mode === "never") return {
+		bootstrapFiles: [],
+		contextFiles: []
+	};
+	if (mode === "continuation-skip" && params.sessionKey && wasBootstrapContextInjected(params.sessionKey)) return {
+		bootstrapFiles: [],
+		contextFiles: []
+	};
 	const bootstrapFiles = resolveBootstrapFilesSync(params);
+	const contextFiles = buildBootstrapContextFiles(bootstrapFiles, {
+		maxChars: resolveBootstrapMaxChars(params.config),
+		totalMaxChars: resolveBootstrapTotalMaxChars(params.config)
+	});
+	if (mode === "continuation-skip" && params.sessionKey && contextFiles.length > 0) markBootstrapContextInjected(params.sessionKey);
 	return {
 		bootstrapFiles,
-		contextFiles: buildBootstrapContextFiles(bootstrapFiles, {
-			maxChars: resolveBootstrapMaxChars(params.config),
-			totalMaxChars: resolveBootstrapTotalMaxChars(params.config)
-		})
+		contextFiles
 	};
 }
 async function resolveBootstrapContextForRun(params) {
+	const mode = params.contextInjection ?? "always";
+	if (mode === "never") return {
+		bootstrapFiles: [],
+		contextFiles: []
+	};
+	if (mode === "continuation-skip" && params.sessionKey && wasBootstrapContextInjected(params.sessionKey)) return {
+		bootstrapFiles: [],
+		contextFiles: []
+	};
 	const bootstrapFiles = await resolveBootstrapFilesForRun(params);
+	const contextFiles = buildBootstrapContextFiles(bootstrapFiles, {
+		maxChars: resolveBootstrapMaxChars(params.config),
+		totalMaxChars: resolveBootstrapTotalMaxChars(params.config),
+		warn: params.warn
+	});
+	if (mode === "continuation-skip" && params.sessionKey && contextFiles.length > 0) markBootstrapContextInjected(params.sessionKey);
 	return {
 		bootstrapFiles,
-		contextFiles: buildBootstrapContextFiles(bootstrapFiles, {
-			maxChars: resolveBootstrapMaxChars(params.config),
-			totalMaxChars: resolveBootstrapTotalMaxChars(params.config),
-			warn: params.warn
-		})
+		contextFiles
 	};
 }
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"bootstrap-files.js","names":[],"sources":["../../../../src/agent/bootstrap/bootstrap-files.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport { DEFAULT_HEARTBEAT_FILENAME } from '../context/workspace.js';\nimport { getOrLoadBootstrapFiles } from './bootstrap-cache.js';\nimport {\n  buildBootstrapContextFiles,\n  resolveBootstrapMaxChars,\n  resolveBootstrapTotalMaxChars,\n} from './bootstrap-context.js';\nimport { filterBootstrapFilesForSession } from './filter-bootstrap-files.js';\nimport { loadProfileBootstrapFiles } from './load-bootstrap-files.js';\nimport type { EmbeddedContextFile, WorkspaceBootstrapFile } from './types.js';\n\nexport { isProfileBootstrapPending } from './load-bootstrap-files.js';\nexport { clearAllBootstrapSnapshots, clearBootstrapSnapshot } from './bootstrap-cache.js';\n\nfunction filterHeartbeatBootstrapFile(\n  files: WorkspaceBootstrapFile[],\n  exclude: boolean,\n): WorkspaceBootstrapFile[] {\n  if (!exclude) {\n    return files;\n  }\n  return files.filter((file) => file.name !== DEFAULT_HEARTBEAT_FILENAME);\n}\n\nexport function resolveBootstrapFilesSync(params: {\n  profileDir: string;\n  sessionKey?: string;\n  excludeHeartbeat?: boolean;\n}): WorkspaceBootstrapFile[] {\n  const rawFiles = loadProfileBootstrapFiles(params.profileDir);\n  const filtered = filterBootstrapFilesForSession(rawFiles, params.sessionKey);\n  return filterHeartbeatBootstrapFile(filtered, params.excludeHeartbeat ?? false);\n}\n\nexport async function resolveBootstrapFilesForRun(params: {\n  profileDir: string;\n  sessionKey?: string;\n  excludeHeartbeat?: boolean;\n  warn?: (message: string) => void;\n}): Promise<WorkspaceBootstrapFile[]> {\n  const sessionKey = params.sessionKey;\n  const rawFiles = sessionKey\n    ? await getOrLoadBootstrapFiles({ profileDir: params.profileDir, sessionKey })\n    : loadProfileBootstrapFiles(params.profileDir);\n  const filtered = filterBootstrapFilesForSession(rawFiles, sessionKey);\n  return filterHeartbeatBootstrapFile(filtered, params.excludeHeartbeat ?? false);\n}\n\nexport function resolveBootstrapContextSync(params: {\n  profileDir: string;\n  config?: Config;\n  sessionKey?: string;\n  excludeHeartbeat?: boolean;\n}): {\n  bootstrapFiles: WorkspaceBootstrapFile[];\n  contextFiles: EmbeddedContextFile[];\n} {\n  const bootstrapFiles = resolveBootstrapFilesSync(params);\n  const contextFiles = buildBootstrapContextFiles(bootstrapFiles, {\n    maxChars: resolveBootstrapMaxChars(params.config),\n    totalMaxChars: resolveBootstrapTotalMaxChars(params.config),\n  });\n  return { bootstrapFiles, contextFiles };\n}\n\nexport async function resolveBootstrapContextForRun(params: {\n  profileDir: string;\n  config?: Config;\n  sessionKey?: string;\n  excludeHeartbeat?: boolean;\n  warn?: (message: string) => void;\n}): Promise<{\n  bootstrapFiles: WorkspaceBootstrapFile[];\n  contextFiles: EmbeddedContextFile[];\n}> {\n  const bootstrapFiles = await resolveBootstrapFilesForRun(params);\n  const contextFiles = buildBootstrapContextFiles(bootstrapFiles, {\n    maxChars: resolveBootstrapMaxChars(params.config),\n    totalMaxChars: resolveBootstrapTotalMaxChars(params.config),\n    warn: params.warn,\n  });\n  return { bootstrapFiles, contextFiles };\n}\n"],"mappings":";;;;;;AAeA,SAAS,6BACP,OACA,SAC0B;AAC1B,KAAI,CAAC,QACH,QAAO;AAET,QAAO,MAAM,QAAQ,SAAS,KAAK,SAAS,2BAA2B;;AAGzE,SAAgB,0BAA0B,QAIb;AAG3B,QAAO,6BADU,+BADA,0BAA0B,OAAO,WACM,EAAE,OAAO,WACrB,EAAE,OAAO,oBAAoB,MAAM;;AAGjF,eAAsB,4BAA4B,QAKZ;CACpC,MAAM,aAAa,OAAO;AAK1B,QAAO,6BADU,+BAHA,aACb,MAAM,wBAAwB;EAAE,YAAY,OAAO;EAAY;EAAY,CAAC,GAC5E,0BAA0B,OAAO,WAAW,EACU,WACd,EAAE,OAAO,oBAAoB,MAAM;;AAGjF,SAAgB,4BAA4B,QAQ1C;CACA,MAAM,iBAAiB,0BAA0B,OAAO;AAKxD,QAAO;EAAE;EAAgB,cAJJ,2BAA2B,gBAAgB;GAC9D,UAAU,yBAAyB,OAAO,OAAO;GACjD,eAAe,8BAA8B,OAAO,OAAO;GAC5D,CACoC;EAAE;;AAGzC,eAAsB,8BAA8B,QASjD;CACD,MAAM,iBAAiB,MAAM,4BAA4B,OAAO;AAMhE,QAAO;EAAE;EAAgB,cALJ,2BAA2B,gBAAgB;GAC9D,UAAU,yBAAyB,OAAO,OAAO;GACjD,eAAe,8BAA8B,OAAO,OAAO;GAC3D,MAAM,OAAO;GACd,CACoC;EAAE"}
+{"version":3,"file":"bootstrap-files.js","names":[],"sources":["../../../../src/agent/bootstrap/bootstrap-files.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport { DEFAULT_HEARTBEAT_FILENAME } from '../context/workspace.js';\nimport {\n  getOrLoadBootstrapFiles,\n  markBootstrapContextInjected,\n  wasBootstrapContextInjected,\n} from './bootstrap-cache.js';\nimport {\n  buildBootstrapContextFiles,\n  resolveBootstrapMaxChars,\n  resolveBootstrapTotalMaxChars,\n} from './bootstrap-context.js';\nimport { filterBootstrapFilesForSession } from './filter-bootstrap-files.js';\nimport { loadProfileBootstrapFiles } from './load-bootstrap-files.js';\nimport type { EmbeddedContextFile, WorkspaceBootstrapFile } from './types.js';\n\nexport { isProfileBootstrapPending } from './load-bootstrap-files.js';\nexport { clearAllBootstrapSnapshots, clearBootstrapSnapshot } from './bootstrap-cache.js';\n\nfunction filterHeartbeatBootstrapFile(\n  files: WorkspaceBootstrapFile[],\n  exclude: boolean,\n): WorkspaceBootstrapFile[] {\n  if (!exclude) {\n    return files;\n  }\n  return files.filter((file) => file.name !== DEFAULT_HEARTBEAT_FILENAME);\n}\n\nexport function resolveBootstrapFilesSync(params: {\n  profileDir: string;\n  workspaceStatePath: string;\n  sessionKey?: string;\n  excludeHeartbeat?: boolean;\n}): WorkspaceBootstrapFile[] {\n  const rawFiles = loadProfileBootstrapFiles(params.profileDir, params.workspaceStatePath);\n  const filtered = filterBootstrapFilesForSession(rawFiles, params.sessionKey);\n  return filterHeartbeatBootstrapFile(filtered, params.excludeHeartbeat ?? false);\n}\n\nexport async function resolveBootstrapFilesForRun(params: {\n  profileDir: string;\n  workspaceStatePath: string;\n  sessionKey?: string;\n  excludeHeartbeat?: boolean;\n  warn?: (message: string) => void;\n}): Promise<WorkspaceBootstrapFile[]> {\n  const sessionKey = params.sessionKey;\n  const rawFiles = sessionKey\n    ? await getOrLoadBootstrapFiles({\n        profileDir: params.profileDir,\n        workspaceStatePath: params.workspaceStatePath,\n        sessionKey,\n      })\n    : loadProfileBootstrapFiles(params.profileDir, params.workspaceStatePath);\n  const filtered = filterBootstrapFilesForSession(rawFiles, sessionKey);\n  return filterHeartbeatBootstrapFile(filtered, params.excludeHeartbeat ?? false);\n}\n\nexport function resolveBootstrapContextSync(params: {\n  profileDir: string;\n  workspaceStatePath: string;\n  config?: Config;\n  sessionKey?: string;\n  excludeHeartbeat?: boolean;\n  contextInjection?: 'always' | 'continuation-skip' | 'never';\n}): {\n  bootstrapFiles: WorkspaceBootstrapFile[];\n  contextFiles: EmbeddedContextFile[];\n} {\n  const mode = params.contextInjection ?? 'always';\n  if (mode === 'never') {\n    return { bootstrapFiles: [], contextFiles: [] };\n  }\n  if (\n    mode === 'continuation-skip' &&\n    params.sessionKey &&\n    wasBootstrapContextInjected(params.sessionKey)\n  ) {\n    return { bootstrapFiles: [], contextFiles: [] };\n  }\n  const bootstrapFiles = resolveBootstrapFilesSync(params);\n  const contextFiles = buildBootstrapContextFiles(bootstrapFiles, {\n    maxChars: resolveBootstrapMaxChars(params.config),\n    totalMaxChars: resolveBootstrapTotalMaxChars(params.config),\n  });\n  if (mode === 'continuation-skip' && params.sessionKey && contextFiles.length > 0) {\n    markBootstrapContextInjected(params.sessionKey);\n  }\n  return { bootstrapFiles, contextFiles };\n}\n\nexport async function resolveBootstrapContextForRun(params: {\n  profileDir: string;\n  workspaceStatePath: string;\n  config?: Config;\n  sessionKey?: string;\n  excludeHeartbeat?: boolean;\n  contextInjection?: 'always' | 'continuation-skip' | 'never';\n  warn?: (message: string) => void;\n}): Promise<{\n  bootstrapFiles: WorkspaceBootstrapFile[];\n  contextFiles: EmbeddedContextFile[];\n}> {\n  const mode = params.contextInjection ?? 'always';\n  if (mode === 'never') {\n    return { bootstrapFiles: [], contextFiles: [] };\n  }\n  if (\n    mode === 'continuation-skip' &&\n    params.sessionKey &&\n    wasBootstrapContextInjected(params.sessionKey)\n  ) {\n    return { bootstrapFiles: [], contextFiles: [] };\n  }\n  const bootstrapFiles = await resolveBootstrapFilesForRun(params);\n  const contextFiles = buildBootstrapContextFiles(bootstrapFiles, {\n    maxChars: resolveBootstrapMaxChars(params.config),\n    totalMaxChars: resolveBootstrapTotalMaxChars(params.config),\n    warn: params.warn,\n  });\n  if (mode === 'continuation-skip' && params.sessionKey && contextFiles.length > 0) {\n    markBootstrapContextInjected(params.sessionKey);\n  }\n  return { bootstrapFiles, contextFiles };\n}\n"],"mappings":";;;;;;AAmBA,SAAS,6BACP,OACA,SAC0B;AAC1B,KAAI,CAAC,QACH,QAAO;AAET,QAAO,MAAM,QAAQ,SAAS,KAAK,SAAS,2BAA2B;;AAGzE,SAAgB,0BAA0B,QAKb;AAG3B,QAAO,6BADU,+BADA,0BAA0B,OAAO,YAAY,OAAO,mBACb,EAAE,OAAO,WACrB,EAAE,OAAO,oBAAoB,MAAM;;AAGjF,eAAsB,4BAA4B,QAMZ;CACpC,MAAM,aAAa,OAAO;AAS1B,QAAO,6BADU,+BAPA,aACb,MAAM,wBAAwB;EAC5B,YAAY,OAAO;EACnB,oBAAoB,OAAO;EAC3B;EACD,CAAC,GACF,0BAA0B,OAAO,YAAY,OAAO,mBAAmB,EACjB,WACd,EAAE,OAAO,oBAAoB,MAAM;;AAGjF,SAAgB,4BAA4B,QAU1C;CACA,MAAM,OAAO,OAAO,oBAAoB;AACxC,KAAI,SAAS,QACX,QAAO;EAAE,gBAAgB,EAAE;EAAE,cAAc,EAAE;EAAE;AAEjD,KACE,SAAS,uBACT,OAAO,cACP,4BAA4B,OAAO,WAAW,CAE9C,QAAO;EAAE,gBAAgB,EAAE;EAAE,cAAc,EAAE;EAAE;CAEjD,MAAM,iBAAiB,0BAA0B,OAAO;CACxD,MAAM,eAAe,2BAA2B,gBAAgB;EAC9D,UAAU,yBAAyB,OAAO,OAAO;EACjD,eAAe,8BAA8B,OAAO,OAAO;EAC5D,CAAC;AACF,KAAI,SAAS,uBAAuB,OAAO,cAAc,aAAa,SAAS,EAC7E,8BAA6B,OAAO,WAAW;AAEjD,QAAO;EAAE;EAAgB;EAAc;;AAGzC,eAAsB,8BAA8B,QAWjD;CACD,MAAM,OAAO,OAAO,oBAAoB;AACxC,KAAI,SAAS,QACX,QAAO;EAAE,gBAAgB,EAAE;EAAE,cAAc,EAAE;EAAE;AAEjD,KACE,SAAS,uBACT,OAAO,cACP,4BAA4B,OAAO,WAAW,CAE9C,QAAO;EAAE,gBAAgB,EAAE;EAAE,cAAc,EAAE;EAAE;CAEjD,MAAM,iBAAiB,MAAM,4BAA4B,OAAO;CAChE,MAAM,eAAe,2BAA2B,gBAAgB;EAC9D,UAAU,yBAAyB,OAAO,OAAO;EACjD,eAAe,8BAA8B,OAAO,OAAO;EAC3D,MAAM,OAAO;EACd,CAAC;AACF,KAAI,SAAS,uBAAuB,OAAO,cAAc,aAAa,SAAS,EAC7E,8BAA6B,OAAO,WAAW;AAEjD,QAAO;EAAE;EAAgB;EAAc"}

package/dist/src/agent/bootstrap/load-bootstrap-files.d.ts

@@ -1,7 +1,10 @@
 import type { WorkspaceBootstrapFile } from './types.js';
-export declare function isProfileBootstrapPending(profileDir: string): boolean;
+export declare function isProfileBootstrapPending(profileDir: string, workspaceStatePath: string): boolean;
 /**
  * Load bootstrap profile Markdown from `agents/<id>/profile/`.
  * MEMORY.md and BOOTSTRAP.md are omitted when absent; other slots emit missing markers.
+ *
+ * BOOTSTRAP.md is also filtered out when `setupCompletedAt` is set in the workspace state,
+ * to prevent re-injection of the bootstrap script after setup is done.
  */
-export declare function loadProfileBootstrapFiles(profileDir: string): WorkspaceBootstrapFile[];
+export declare function loadProfileBootstrapFiles(profileDir: string, workspaceStatePath: string): WorkspaceBootstrapFile[];

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

@@ -1,7 +1,8 @@
 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 { isWorkspaceSetupCompleted, syncBootstrapSetupCompletion } from "../context/workspace-state.js";
 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 = [
@@ -22,18 +23,26 @@ function readProfileFile(filePath) {
 		return null;
 	}
 }
-function isProfileBootstrapPending(profileDir) {
+function isProfileBootstrapPending(profileDir, workspaceStatePath) {
+	syncBootstrapSetupCompletion(workspaceStatePath, profileDir);
+	if (isWorkspaceSetupCompleted(workspaceStatePath)) return false;
 	return existsSync(join(profileDir, WORKSPACE_FILES.BOOTSTRAP));
 }
 /**
 * Load bootstrap profile Markdown from `agents/<id>/profile/`.
 * MEMORY.md and BOOTSTRAP.md are omitted when absent; other slots emit missing markers.
+*
+* BOOTSTRAP.md is also filtered out when `setupCompletedAt` is set in the workspace state,
+* to prevent re-injection of the bootstrap script after setup is done.
 */
-function loadProfileBootstrapFiles(profileDir) {
+function loadProfileBootstrapFiles(profileDir, workspaceStatePath) {
+	syncBootstrapSetupCompletion(workspaceStatePath, profileDir);
 	const resolvedDir = resolve(profileDir);
 	const result = [];
+	const setupCompleted = isWorkspaceSetupCompleted(workspaceStatePath);
 	for (const name of BOOTSTRAP_LOAD_ORDER) {
 		const filePath = join(resolvedDir, name);
+		if (name === WORKSPACE_FILES.BOOTSTRAP && setupCompleted) continue;
 		if (name === "MEMORY.md" || name === WORKSPACE_FILES.BOOTSTRAP) {
 			const content = readProfileFile(filePath);
 			if (content === null) continue;

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

@@ -1 +1 @@
-{"version":3,"file":"load-bootstrap-files.js","names":[],"sources":["../../../../src/agent/bootstrap/load-bootstrap-files.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { join, resolve } from 'node:path';\n\nimport { WORKSPACE_FILES } from '../../config/paths.js';\nimport { stripFrontMatter } from '../context/workspace.js';\nimport {\n  DEFAULT_AGENTS_FILENAME,\n  DEFAULT_HEARTBEAT_FILENAME,\n  DEFAULT_IDENTITY_FILENAME,\n  DEFAULT_MEMORY_FILENAME,\n  DEFAULT_SOUL_FILENAME,\n  DEFAULT_TOOLS_FILENAME,\n  DEFAULT_USER_FILENAME,\n} from '../context/workspace.js';\nimport type { BootstrapFileName, WorkspaceBootstrapFile } from './types.js';\n\nconst BOOTSTRAP_LOAD_ORDER: BootstrapFileName[] = [\n  DEFAULT_AGENTS_FILENAME,\n  DEFAULT_SOUL_FILENAME,\n  DEFAULT_TOOLS_FILENAME,\n  DEFAULT_IDENTITY_FILENAME,\n  DEFAULT_USER_FILENAME,\n  DEFAULT_HEARTBEAT_FILENAME,\n  WORKSPACE_FILES.BOOTSTRAP,\n  DEFAULT_MEMORY_FILENAME,\n];\n\nfunction readProfileFile(filePath: string): string | null {\n  if (!existsSync(filePath)) {\n    return null;\n  }\n  try {\n    return stripFrontMatter(readFileSync(filePath, 'utf-8'));\n  } catch {\n    return null;\n  }\n}\n\nexport function isProfileBootstrapPending(profileDir: string): boolean {\n  return existsSync(join(profileDir, WORKSPACE_FILES.BOOTSTRAP));\n}\n\n/**\n * Load bootstrap profile Markdown from `agents/<id>/profile/`.\n * MEMORY.md and BOOTSTRAP.md are omitted when absent; other slots emit missing markers.\n */\nexport function loadProfileBootstrapFiles(profileDir: string): WorkspaceBootstrapFile[] {\n  const resolvedDir = resolve(profileDir);\n  const result: WorkspaceBootstrapFile[] = [];\n\n  for (const name of BOOTSTRAP_LOAD_ORDER) {\n    const filePath = join(resolvedDir, name);\n\n    if (name === DEFAULT_MEMORY_FILENAME || name === WORKSPACE_FILES.BOOTSTRAP) {\n      const content = readProfileFile(filePath);\n      if (content === null) {\n        continue;\n      }\n      result.push({ name, path: filePath, content, missing: false });\n      continue;\n    }\n\n    const content = readProfileFile(filePath);\n    if (content !== null) {\n      result.push({ name, path: filePath, content, missing: false });\n    } else {\n      result.push({ name, path: filePath, missing: true });\n    }\n  }\n\n  return result;\n}\n"],"mappings":";;;;;YAGwD;AAaxD,MAAM,uBAA4C;CAChD;CACA;CACA;CACA;CACA;CACA;CACA,gBAAgB;CAChB;CACD;AAED,SAAS,gBAAgB,UAAiC;AACxD,KAAI,CAAC,WAAW,SAAS,CACvB,QAAO;AAET,KAAI;AACF,SAAO,iBAAiB,aAAa,UAAU,QAAQ,CAAC;SAClD;AACN,SAAO;;;AAIX,SAAgB,0BAA0B,YAA6B;AACrE,QAAO,WAAW,KAAK,YAAY,gBAAgB,UAAU,CAAC;;;;;;AAOhE,SAAgB,0BAA0B,YAA8C;CACtF,MAAM,cAAc,QAAQ,WAAW;CACvC,MAAM,SAAmC,EAAE;AAE3C,MAAK,MAAM,QAAQ,sBAAsB;EACvC,MAAM,WAAW,KAAK,aAAa,KAAK;AAExC,MAAI,SAAA,eAAoC,SAAS,gBAAgB,WAAW;GAC1E,MAAM,UAAU,gBAAgB,SAAS;AACzC,OAAI,YAAY,KACd;AAEF,UAAO,KAAK;IAAE;IAAM,MAAM;IAAU;IAAS,SAAS;IAAO,CAAC;AAC9D;;EAGF,MAAM,UAAU,gBAAgB,SAAS;AACzC,MAAI,YAAY,KACd,QAAO,KAAK;GAAE;GAAM,MAAM;GAAU;GAAS,SAAS;GAAO,CAAC;MAE9D,QAAO,KAAK;GAAE;GAAM,MAAM;GAAU,SAAS;GAAM,CAAC;;AAIxD,QAAO"}
+{"version":3,"file":"load-bootstrap-files.js","names":[],"sources":["../../../../src/agent/bootstrap/load-bootstrap-files.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { join, resolve } from 'node:path';\n\nimport { WORKSPACE_FILES } from '../../config/paths.js';\nimport { stripFrontMatter } from '../context/workspace.js';\nimport {\n  isWorkspaceSetupCompleted,\n  syncBootstrapSetupCompletion,\n} from '../context/workspace-state.js';\nimport {\n  DEFAULT_AGENTS_FILENAME,\n  DEFAULT_HEARTBEAT_FILENAME,\n  DEFAULT_IDENTITY_FILENAME,\n  DEFAULT_MEMORY_FILENAME,\n  DEFAULT_SOUL_FILENAME,\n  DEFAULT_TOOLS_FILENAME,\n  DEFAULT_USER_FILENAME,\n} from '../context/workspace.js';\nimport type { BootstrapFileName, WorkspaceBootstrapFile } from './types.js';\n\nconst BOOTSTRAP_LOAD_ORDER: BootstrapFileName[] = [\n  DEFAULT_AGENTS_FILENAME,\n  DEFAULT_SOUL_FILENAME,\n  DEFAULT_TOOLS_FILENAME,\n  DEFAULT_IDENTITY_FILENAME,\n  DEFAULT_USER_FILENAME,\n  DEFAULT_HEARTBEAT_FILENAME,\n  WORKSPACE_FILES.BOOTSTRAP,\n  DEFAULT_MEMORY_FILENAME,\n];\n\nfunction readProfileFile(filePath: string): string | null {\n  if (!existsSync(filePath)) {\n    return null;\n  }\n  try {\n    return stripFrontMatter(readFileSync(filePath, 'utf-8'));\n  } catch {\n    return null;\n  }\n}\n\nexport function isProfileBootstrapPending(profileDir: string, workspaceStatePath: string): boolean {\n  syncBootstrapSetupCompletion(workspaceStatePath, profileDir);\n  if (isWorkspaceSetupCompleted(workspaceStatePath)) {\n    return false;\n  }\n  return existsSync(join(profileDir, WORKSPACE_FILES.BOOTSTRAP));\n}\n\n/**\n * Load bootstrap profile Markdown from `agents/<id>/profile/`.\n * MEMORY.md and BOOTSTRAP.md are omitted when absent; other slots emit missing markers.\n *\n * BOOTSTRAP.md is also filtered out when `setupCompletedAt` is set in the workspace state,\n * to prevent re-injection of the bootstrap script after setup is done.\n */\nexport function loadProfileBootstrapFiles(\n  profileDir: string,\n  workspaceStatePath: string,\n): WorkspaceBootstrapFile[] {\n  syncBootstrapSetupCompletion(workspaceStatePath, profileDir);\n  const resolvedDir = resolve(profileDir);\n  const result: WorkspaceBootstrapFile[] = [];\n  const setupCompleted = isWorkspaceSetupCompleted(workspaceStatePath);\n\n  for (const name of BOOTSTRAP_LOAD_ORDER) {\n    const filePath = join(resolvedDir, name);\n\n    // Skip BOOTSTRAP.md entirely when setup is already completed\n    if (name === WORKSPACE_FILES.BOOTSTRAP && setupCompleted) {\n      continue;\n    }\n\n    if (name === DEFAULT_MEMORY_FILENAME || name === WORKSPACE_FILES.BOOTSTRAP) {\n      const content = readProfileFile(filePath);\n      if (content === null) {\n        continue;\n      }\n      result.push({ name, path: filePath, content, missing: false });\n      continue;\n    }\n\n    const content = readProfileFile(filePath);\n    if (content !== null) {\n      result.push({ name, path: filePath, content, missing: false });\n    } else {\n      result.push({ name, path: filePath, missing: true });\n    }\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;YAGwD;AAiBxD,MAAM,uBAA4C;CAChD;CACA;CACA;CACA;CACA;CACA;CACA,gBAAgB;CAChB;CACD;AAED,SAAS,gBAAgB,UAAiC;AACxD,KAAI,CAAC,WAAW,SAAS,CACvB,QAAO;AAET,KAAI;AACF,SAAO,iBAAiB,aAAa,UAAU,QAAQ,CAAC;SAClD;AACN,SAAO;;;AAIX,SAAgB,0BAA0B,YAAoB,oBAAqC;AACjG,8BAA6B,oBAAoB,WAAW;AAC5D,KAAI,0BAA0B,mBAAmB,CAC/C,QAAO;AAET,QAAO,WAAW,KAAK,YAAY,gBAAgB,UAAU,CAAC;;;;;;;;;AAUhE,SAAgB,0BACd,YACA,oBAC0B;AAC1B,8BAA6B,oBAAoB,WAAW;CAC5D,MAAM,cAAc,QAAQ,WAAW;CACvC,MAAM,SAAmC,EAAE;CAC3C,MAAM,iBAAiB,0BAA0B,mBAAmB;AAEpE,MAAK,MAAM,QAAQ,sBAAsB;EACvC,MAAM,WAAW,KAAK,aAAa,KAAK;AAGxC,MAAI,SAAS,gBAAgB,aAAa,eACxC;AAGF,MAAI,SAAA,eAAoC,SAAS,gBAAgB,WAAW;GAC1E,MAAM,UAAU,gBAAgB,SAAS;AACzC,OAAI,YAAY,KACd;AAEF,UAAO,KAAK;IAAE;IAAM,MAAM;IAAU;IAAS,SAAS;IAAO,CAAC;AAC9D;;EAGF,MAAM,UAAU,gBAAgB,SAAS;AACzC,MAAI,YAAY,KACd,QAAO,KAAK;GAAE;GAAM,MAAM;GAAU;GAAS,SAAS;GAAO,CAAC;MAE9D,QAAO,KAAK;GAAE;GAAM,MAAM;GAAU,SAAS;GAAM,CAAC;;AAIxD,QAAO"}