@xopcai/xopc 0.0.92 → 0.0.94

package/dist/src/agent/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","names":[],"sources":["../../../src/agent/service.ts"],"sourcesContent":["import type { AgentEvent, AgentMessage, ThinkingLevel } from '@earendil-works/pi-agent-core';\nimport type { MessageBus } from '../infra/bus/index.js';\nimport { type Config, getAgentDefaultModelRef } from '../config/schema.js';\nimport { maybeAutoTitleSessionStore } from '../session/session-title.js';\nimport type { ChannelManager } from '../channels/manager.js';\nimport { existsSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport {\n  SessionStore,\n  SessionConfigStore,\n  onSessionTranscriptUpdate,\n  effectiveWorkspacePathForSession,\n  type CompactionConfig,\n  type WindowConfig,\n} from '../session/index.js';\nimport { type ThinkLevel } from './transcript/thinking-types.js';\nimport { createLogger } from '../utils/logger.js';\nimport { ExtensionHookRunner } from '../extensions/index.js';\nimport { extractTextContent } from './context/workspace.js';\nimport { SessionTracker } from './session/tracker.js';\nimport { ModelManager } from './models/index.js';\nimport { initializeCommands } from '../chat-commands/index.js';\nimport { ProgressFeedbackManager } from './lifecycle/progress.js';\nimport { HookHandler } from './lifecycle/hook-handler.js';\nimport { ToolErrorTracker } from './tools/error-tracker.js';\nimport { RequestLimiter } from './models/request-limiter.js';\nimport { SystemReminder } from './prompt/system-reminder.js';\nimport { ToolUsageAnalyzer } from './tools/usage-analyzer.js';\nimport { ToolChainTracker } from './tools/chain-tracker.js';\nimport { ErrorPatternMatcher } from './tools/error-pattern-matcher.js';\nimport { ContextMiddleware, SelfVerifyMiddleware } from './middleware/index.js';\nimport { LifecycleManager } from './lifecycle/index.js';\nimport { CompactionLifecycleHandler } from './lifecycle/handlers/compaction.js';\n\nimport {\n  MessageRouter,\n  CommandHandler,\n  StreamManager,\n  OutboundCoordinator,\n} from './messaging/index.js';\nimport { InboundLoop } from './inbound/inbound-loop.js';\nimport { TurnDispatcher } from './inbound/turn-dispatcher.js';\nimport {\n  SessionContextManager,\n  SessionLifecycleManager,\n  SessionStateBag,\n  SessionConfigService,\n  SessionHydrator,\n  SessionInspector,\n  type SessionContext,\n} from './session/index.js';\nimport { AgentOrchestrator, AgentEventHandler } from './orchestration/index.js';\nimport {\n  getWorkflowProgressBroker,\n  type BrokerListenerHandle,\n} from './workflow/index.js';\nimport { FeedbackCoordinator } from './feedback/index.js';\nimport { AgentManager, type SkillCatalogEntry } from './agent-manager.js';\nimport type { SkillMarkdownPreviewPayload } from './skills/types.js';\nimport type { AgentServiceConfig, StreamHandle } from './service.types.js';\nimport { PersistentGoalService } from './goals/persistent-goal-service.js';\nimport { reconcileManagedDreamingCronJobs } from './service/reconcile-dreaming-cron.js';\nimport { parseOutboundSessionKey } from './service/parse-outbound-session-key.js';\n\nimport {\n  resolveAgentHomeDir,\n  resolveAgentProfileDir,\n  resolveDefaultAgentId,\n} from './agent-scope.js';\nimport {\n  extractProfileAgentId,\n  resolveEffectiveAgentProfileForSession,\n} from '../config/agent-profile.js';\nimport { cleanTrailingErrors } from './memory/message-sanitizer.js';\nimport { tryApplySessionTranscriptHygiene } from './transcript/transcript-hygiene.js';\nimport {\n  persistInboundAttachmentsToWorkspace,\n  type InternalAttachmentRoots,\n} from '../channels/attachments/inbound-persist.js';\nimport { applyConfigOverrides } from '../config/runtime-overrides.js';\n\nexport type { AgentServiceConfig, AgentContext, StreamHandle } from './service.types.js';\n\nconst log = createLogger('AgentService');\n\nexport class AgentService {\n  /**\n   * Persistent transcript + session-metadata store. Public so the gateway/TUI\n   * can read sessions, delete them, etc. without forcing every CRUD-style\n   * operation through a delegation method on `AgentService`.\n   */\n  readonly sessionStore: SessionStore;\n  private sessionConfigStore: SessionConfigStore;\n  private hookRunner?: ExtensionHookRunner;\n  private agentId: string;\n  private workspaceDir: string;\n  private channelManagerRef: ChannelManager | null = null;\n  private bus: MessageBus;\n  private config: AgentServiceConfig;\n\n  private sessionTracker: SessionTracker;\n  private modelManager: ModelManager;\n  private progressManager: ProgressFeedbackManager;\n  private hookHandler: HookHandler;\n  private lifecycleManager: LifecycleManager;\n  private errorTracker: ToolErrorTracker;\n  private requestLimiter: RequestLimiter;\n  private systemReminder: SystemReminder;\n  private toolUsageAnalyzer: ToolUsageAnalyzer;\n  private toolChainTracker: ToolChainTracker;\n  private errorPatternMatcher: ErrorPatternMatcher;\n  private selfVerifyMiddleware: SelfVerifyMiddleware;\n  private contextMiddleware: ContextMiddleware;\n\n  private messageRouter: MessageRouter;\n  private commandHandler: CommandHandler;\n  private streamManager: StreamManager;\n  /**\n   * Outbound pipeline: typing controller, silence guard, final response publish,\n   * extension `message_sending`/`message_sent` hooks, post-turn `webchat_turn_complete`\n   * event. Public so the gateway / channels can drive it directly.\n   */\n  readonly outboundCoordinator: OutboundCoordinator;\n  private inboundLoop: InboundLoop;\n  /**\n   * Direct-turn entry points: `processDirect` (one-shot), `processDirectStreaming`\n   * (SSE generator), webchat steering and SSE injection. Public so the gateway,\n   * TUI, CLI, and cron jobs do not need to thread every call through `AgentService`.\n   */\n  readonly turnDispatcher: TurnDispatcher;\n  /**\n   * `/goal` runtime: continuation scheduling, persistent-goal API factory,\n   * stream-outcome state, post-turn verdict. Public so the gateway can wire\n   * the webchat continuation scheduler and read stream outcomes directly.\n   */\n  readonly persistentGoals: PersistentGoalService;\n  /**\n   * Per-session config writes (model / thinking / reasoning / working directory).\n   * Public so REST endpoints and CLI flows can hit it without going through a\n   * monolithic patch entrypoint on `AgentService`.\n   */\n  readonly sessionConfig: SessionConfigService;\n  /**\n   * Hydration — read persisted per-session config and apply it to the runtime\n   * (AgentManager / ModelManager). The mirror image of `sessionConfig`: writes\n   * go through `sessionConfig`, reads-into-runtime go through `sessionHydrator`.\n   */\n  readonly sessionHydrator: SessionHydrator;\n  /**\n   * Read-only introspection (compaction, /context report, /btw, contextUsage,\n   * agentConfig view). Public so REST endpoints and CLI flows can query a\n   * session's view without going through delegating methods on `AgentService`.\n   */\n  readonly sessionInspector: SessionInspector;\n  private sessionContextManager: SessionContextManager;\n  private sessionLifecycleManager: SessionLifecycleManager;\n  private agentOrchestrator: AgentOrchestrator;\n  private agentEventHandler: AgentEventHandler;\n  private workflowProgressBrokerHandle: BrokerListenerHandle | null = null;\n  private feedbackCoordinator: FeedbackCoordinator;\n  private agentManager: AgentManager;\n\n  /**\n   * Unified per-session state container (replaces six ad-hoc Maps). Owns webchat\n   * publishers, last assistant text, embedded stream buffer, persistent-goal stream\n   * outcomes, concurrent-turn depth, and event-listener unsubscribers; runs a TTL\n   * sweep for slots that have no explicit owner.\n   */\n  private sessionState = new SessionStateBag();\n\n  /** Gateway: notify UI after direct `SessionStore.updateMetadata` (no SessionManager emit). */\n  private onSessionMetadataUpdated?: (sessionKey: string) => void;\n  private onSessionTranscriptUpdated?: (sessionKey: string) => void;\n\n  private effectiveAppConfig(): Config | undefined {\n    const base = this.config.config;\n    return base ? applyConfigOverrides(base) : undefined;\n  }\n\n  constructor(bus: MessageBus, config: AgentServiceConfig) {\n    this.bus = bus;\n    this.config = config;\n    this.onSessionMetadataUpdated = config.onSessionMetadataUpdated;\n    this.onSessionTranscriptUpdated = config.onSessionTranscriptUpdated;\n    this.agentId = `agent-${Date.now()}`;\n    this.workspaceDir = config.workspace;\n\n    this.sessionTracker = new SessionTracker();\n    this.modelManager = new ModelManager({\n      defaultModel: config.model,\n      config: config.config,\n    });\n\n    initializeCommands();\n    log.debug('Command system initialized');\n\n    this.sessionStore = config.sessionStore ?? this.createSessionStore();\n    onSessionTranscriptUpdate((update) => {\n      void this.sessionStore.syncSessionsJsonFromTranscriptUpdate(update).catch((err) => {\n        log.warn(\n          { err, sessionFile: update.sessionFile, sessionKey: update.sessionKey },\n          'Transcript index sync failed',\n        );\n      });\n      const sk = update.sessionKey?.trim();\n      if (sk) {\n        this.onSessionTranscriptUpdated?.(sk);\n      }\n    });\n    const appCfgForPaths = this.config.config;\n    if (!appCfgForPaths) {\n      throw new Error('AgentService requires config.config for session paths');\n    }\n    const defaultAid = resolveDefaultAgentId(appCfgForPaths);\n    const defaultAgentHome = resolveAgentHomeDir(appCfgForPaths, defaultAid);\n    this.sessionConfigStore = new SessionConfigStore(defaultAgentHome);\n\n    this.hookRunner = this.createHookRunner();\n    this.hookHandler = new HookHandler({\n      hookRunner: this.hookRunner,\n      agentId: this.agentId,\n      get sessionKey() { return this.currentContext?.sessionKey; },\n    });\n\n    this.progressManager = this.createProgressManager();\n    this.initializeReliabilityModules();\n\n    this.lifecycleManager = new LifecycleManager();\n    this.initializeLifecycleHandlers();\n\n    this.streamManager = new StreamManager();\n    this.sessionContextManager = new SessionContextManager();\n    this.feedbackCoordinator = new FeedbackCoordinator({\n      progressManager: this.progressManager,\n      bus,\n    });\n\n    // Initialize AgentManager\n    this.agentManager = new AgentManager({\n      workspace: config.workspace,\n      model: config.model,\n      config: config.config,\n      extensionRegistry: config.extensionRegistry,\n      hookRunner: this.hookRunner,\n      bus,\n      getCurrentContext: () => this.sessionContextManager.getContext(),\n      getSessionStore: () => this.sessionStore,\n      getModelManager: () => this.modelManager,\n      thinkingLevel: config.thinkingLevel,\n      reasoningLevel: config.reasoningLevel,\n      verboseLevel: config.verboseLevel,\n      gatewayClarify: config.gatewayClarify,\n      getCronService: config.getCronService,\n      getWorkflowRunService: config.getWorkflowRunService,\n    });\n\n    this.agentEventHandler = new AgentEventHandler({\n      progressManager: this.progressManager,\n      errorTracker: this.errorTracker,\n      requestLimiter: this.requestLimiter,\n      lifecycleManager: this.lifecycleManager,\n      toolChainTracker: this.toolChainTracker,\n      selfVerifyMiddleware: this.selfVerifyMiddleware,\n      systemReminder: this.systemReminder,\n      toolUsageAnalyzer: this.toolUsageAnalyzer,\n      errorPatternMatcher: this.errorPatternMatcher,\n    });\n\n    // Wire the workflow progress broker into the session event bus. Channel\n    // extensions self-register their capability against the singleton at\n    // boot; the broker only forwards updates to whatever has registered, so\n    // this is safe even when no channel is configured.\n    this.workflowProgressBrokerHandle = getWorkflowProgressBroker().attachTo(\n      this.agentEventHandler,\n    );\n\n    // sessionHydrator is constructed early because AgentOrchestrator + InboundLoop +\n    // TurnDispatcher all need it; the SessionConfigService instance below also\n    // shares the same constructor parameters.\n    this.sessionHydrator = new SessionHydrator({\n      sessionConfigStore: this.sessionConfigStore,\n      agentManager: this.agentManager,\n      modelManager: this.modelManager,\n      getConfig: () => this.effectiveAppConfig(),\n    });\n\n    this.agentOrchestrator = new AgentOrchestrator({\n      agentManager: this.agentManager,\n      sessionStore: this.sessionStore,\n      modelManager: this.modelManager,\n      eventHandler: this.agentEventHandler,\n      feedbackCoordinator: this.feedbackCoordinator,\n      sessionConfigStore: this.sessionConfigStore,\n      sessionHydrator: this.sessionHydrator,\n      getConfig: () => this.effectiveAppConfig(),\n      getThinkingDefault: () => this.effectiveAppConfig()?.agents?.defaults?.thinkingDefault,\n      getThinkingDefaultForSession: (sessionKey: string) =>\n        this.agentManager.getThinkingDefaultForSession(sessionKey),\n      workspaceRoot: this.workspaceDir,\n      getWorkspaceRootForSession: (sessionKey: string) =>\n        this.agentManager.getResolvedWorkspaceForSession(sessionKey),\n      getAgentInternalStorageRootForSession: (sessionKey: string) =>\n        resolveAgentHomeDir(this.config.config!, extractProfileAgentId(sessionKey, this.config.config!)),\n      enqueueAutoTitle: (sessionKey: string) => this.enqueueMaybeAutoTitleAfterPersist(sessionKey),\n      onEmbeddedStreamEvent: (sessionKey, event) => {\n        const ctx = this.sessionContextManager.getContext();\n        if (!ctx || ctx.sessionKey !== sessionKey) {\n          return;\n        }\n        if (event.type === 'token') {\n          const next = this.sessionState.appendEmbeddedStreamText(sessionKey, event.content);\n          this.streamManager.update(next);\n        }\n      },\n      onEmbeddedTurnComplete: (sessionKey, text) => {\n        if (text) {\n          this.sessionState.setLastAssistantText(sessionKey, text);\n        }\n        this.sessionState.clearEmbeddedStreamText(sessionKey);\n      },\n    });\n\n    this.messageRouter = new MessageRouter();\n    this.commandHandler = new CommandHandler({\n      config: config.config!,\n      bus,\n      sessionStore: this.sessionStore,\n      sessionConfigStore: this.sessionConfigStore,\n      getPersistentGoalApisForCommand: (routing) => this.persistentGoals.buildApisForRouting(routing),\n      applySessionThinkingLevel: (sessionKey: string, level: ThinkLevel) => {\n        this.agentManager.setThinkingLevel(sessionKey, level as ThinkingLevel);\n      },\n      getCurrentModel: () => this.agentOrchestrator.getCurrentModel(),\n      switchModelForSession: (sessionKey: string, modelId: string) =>\n        this.switchModelForSession(sessionKey, modelId),\n      invalidateAgentSession: (sessionKey: string) => {\n        this.agentManager.removeAgent(sessionKey);\n      },\n      resetSession: (sessionKey: string) => this.resetSession(sessionKey),\n      abortSessionTurn: async (sessionKey: string) => {\n        await this.streamManager.abort();\n        this.agentOrchestrator.abort(sessionKey);\n      },\n      compactSession: (sessionKey, options) => this.sessionInspector.compact(sessionKey, options),\n      btwQuery: (sessionKey, question) => this.sessionInspector.btwQuery(sessionKey, question),\n      getSessionContextReport: (sessionKey, mode) => this.sessionInspector.report(sessionKey, mode),\n    });\n\n    this.sessionLifecycleManager = new SessionLifecycleManager(\n      this.sessionStore,\n      this.sessionTracker,\n      this.lifecycleManager\n    );\n\n    this.persistentGoals = new PersistentGoalService({\n      bus,\n      sessionStore: this.sessionStore,\n      modelManager: this.modelManager,\n      sessionState: this.sessionState,\n      getConfig: () => this.effectiveAppConfig(),\n      getResolvedWorkspaceForSession: (sk) => this.agentManager.getResolvedWorkspaceForSession(sk),\n      onSessionMetadataUpdated: this.onSessionMetadataUpdated,\n      notifyWebchatTranscriptAppend: (sk, text) => this.turnDispatcher.notifyWebchatTranscriptAppend(sk, text),\n    });\n\n    this.sessionConfig = new SessionConfigService({\n      sessionStore: this.sessionStore,\n      sessionConfigStore: this.sessionConfigStore,\n      modelManager: this.modelManager,\n      agentManager: this.agentManager,\n      getConfig: () => this.effectiveAppConfig(),\n    });\n\n    this.sessionInspector = new SessionInspector({\n      sessionStore: this.sessionStore,\n      sessionConfigStore: this.sessionConfigStore,\n      modelManager: this.modelManager,\n      agentManager: this.agentManager,\n      sessionHydrator: this.sessionHydrator,\n      getConfig: () => this.effectiveAppConfig(),\n      getContextWindow: () => this.getContextWindow(),\n    });\n\n    this.outboundCoordinator = new OutboundCoordinator({\n      bus,\n      hookHandler: this.hookHandler,\n      streamManager: this.streamManager,\n      getConfig: () => this.effectiveAppConfig(),\n      getLastAssistantPlainText: (sk) => this.getLastAssistantPlainText(sk),\n      runPersistentGoalPostTurn: (payload) => this.persistentGoals.runPostTurn(payload),\n    });\n\n    this.turnDispatcher = new TurnDispatcher({\n      log,\n      agentManager: this.agentManager,\n      sessionStore: this.sessionStore,\n      modelManager: this.modelManager,\n      sessionConfigStore: this.sessionConfigStore,\n      sessionState: this.sessionState,\n      commandHandler: this.commandHandler,\n      getConfig: () => this.effectiveAppConfig(),\n      requireConfig: () => {\n        const c = this.config.config;\n        if (!c) throw new Error('AgentService requires config.config');\n        return c;\n      },\n      parseSessionKey: (sk) => this.parseSessionKey(sk),\n      initSessionContext: (sk, channel, chatId) => this.initSessionContext(sk, channel, chatId),\n      sessionHydrator: this.sessionHydrator,\n      attachmentRootsForSession: (sk) => this.attachmentRootsForSession(sk),\n      prepareInboundAttachments: (sk, att) => this.prepareInboundAttachments(sk, att),\n      enqueueMaybeAutoTitleAfterPersist: (sk) => this.enqueueMaybeAutoTitleAfterPersist(sk),\n      endDirectRequestContext: () => this.endDirectRequestContext(),\n      onSessionTranscriptUpdated: this.onSessionTranscriptUpdated,\n      resetSession: (sk) => this.resetSession(sk),\n    });\n\n    this.inboundLoop = new InboundLoop({\n      log,\n      agentId: this.agentId,\n      bus,\n      hookHandler: this.hookHandler,\n      messageRouter: this.messageRouter,\n      commandHandler: this.commandHandler,\n      sessionContextManager: this.sessionContextManager,\n      feedbackCoordinator: this.feedbackCoordinator,\n      agentManager: this.agentManager,\n      sessionLifecycleManager: this.sessionLifecycleManager,\n      agentOrchestrator: this.agentOrchestrator,\n      outboundCoordinator: this.outboundCoordinator,\n      streamManager: this.streamManager,\n      sessionState: this.sessionState,\n      sessionStore: this.sessionStore,\n      modelManager: this.modelManager,\n      setupSessionEventHandling: (sk) => this.setupSessionEventHandling(sk),\n      sessionHydrator: this.sessionHydrator,\n      getLastAssistantPlainText: (sk) => this.getLastAssistantPlainText(sk),\n      checkAndCompact: (sk, msgs) => this.checkAndCompact(sk, msgs),\n      enqueueMaybeAutoTitleAfterPersist: (sk) => this.enqueueMaybeAutoTitleAfterPersist(sk),\n      getConfig: () => this.effectiveAppConfig(),\n      resetSession: (sk) => this.resetSession(sk),\n      setStreamHandle: (handle) => this.setStreamHandle(handle),\n    });\n\n    // Register signal handlers only if not running as an Electron subprocess.\n    // In Electron, the parent process manages the lifecycle and signals should not trigger disposal.\n    const isElectronSubprocess = !!process.env.ELECTRON_RUN_AS_NODE;\n    if (!isElectronSubprocess) {\n      process.on('SIGINT', () => this.dispose());\n      process.on('SIGTERM', () => this.dispose());\n    }\n\n    log.info('AgentService initialized');\n  }\n\n  private attachmentRootsForSession(sessionKey: string): InternalAttachmentRoots {\n    const cfg = this.config.config!;\n    return {\n      agentHome: resolveAgentHomeDir(cfg, extractProfileAgentId(sessionKey, cfg)),\n    };\n  }\n\n  private createSessionStore(): SessionStore {\n    const sessionStoreDefaults = this.config.agentDefaults || this.config.config?.agents?.defaults;\n    const windowConfig: Partial<WindowConfig> = {\n      maxMessages: 100,\n      keepRecentMessages: sessionStoreDefaults?.maxToolIterations || 20,\n      preserveSystemMessages: true,\n    };\n    const compactionConfig: Partial<CompactionConfig> = {\n      enabled: sessionStoreDefaults?.compaction?.enabled ?? true,\n      mode: (sessionStoreDefaults?.compaction?.mode as 'extractive' | 'abstractive' | 'structured') || 'abstractive',\n      reserveTokens: sessionStoreDefaults?.compaction?.reserveTokens || 8000,\n      triggerThreshold: sessionStoreDefaults?.compaction?.triggerThreshold || 0.8,\n      minMessagesBeforeCompact: sessionStoreDefaults?.compaction?.minMessagesBeforeCompact || 10,\n      keepRecentMessages: sessionStoreDefaults?.compaction?.keepRecentMessages || 10,\n      evictionWindow: sessionStoreDefaults?.compaction?.evictionWindow || 0.2,\n      retentionWindow: sessionStoreDefaults?.compaction?.retentionWindow || 6,\n    };\n    const appCfg = this.config.config;\n    if (!appCfg) {\n      throw new Error('AgentService requires config.config for session store paths');\n    }\n    return new SessionStore(\n      {\n        config: appCfg,\n        agentId: resolveDefaultAgentId(appCfg),\n      },\n      windowConfig,\n      compactionConfig,\n    );\n  }\n\n  private createHookRunner(): ExtensionHookRunner | undefined {\n    if (!this.config.extensionRegistry) return undefined;\n\n    return new ExtensionHookRunner(this.config.extensionRegistry, {\n      catchErrors: true,\n      logger: {\n        info: (msg: string) => log.info({ hook: true }, msg),\n        warn: (msg: string) => log.warn({ hook: true }, msg),\n        error: (msg: string) => log.error({ hook: true }, msg),\n      },\n    });\n  }\n\n  private createProgressManager(): ProgressFeedbackManager {\n    return new ProgressFeedbackManager({\n      level: 'normal',\n      showThinking: true,\n      streamToolProgress: true,\n      heartbeatEnabled: true,\n      heartbeatIntervalMs: 20000,\n      longTaskThresholdMs: 30000,\n    });\n  }\n\n  private initializeReliabilityModules(): void {\n    const defaults = this.config.agentDefaults || this.config.config?.agents?.defaults;\n\n    this.errorTracker = new ToolErrorTracker({\n      maxFailuresPerTool: defaults?.maxToolFailuresPerTurn || 3,\n      maxTotalFailures: defaults?.maxToolFailuresPerTurn ? defaults.maxToolFailuresPerTurn + 2 : 5,\n      resetOnTurnEnd: true,\n    });\n\n    this.selfVerifyMiddleware = new SelfVerifyMiddleware({\n      maxEditsPerFile: 5,\n      enablePreCompletionCheck: true,\n      minTurnsForVerification: 4,\n      resetOnVerification: true,\n    });\n\n    this.requestLimiter = new RequestLimiter({\n      maxRequestsPerTurn: defaults?.maxRequestsPerTurn || 50,\n      warnThreshold: 0.8,\n      softLimit: false,\n    });\n\n    this.systemReminder = new SystemReminder({\n      enabled: true,\n      appendToToolResults: true,\n      maxRemindersPerTurn: 3,\n    });\n\n    this.toolUsageAnalyzer = new ToolUsageAnalyzer({\n      enabled: true,\n      lowUsageThreshold: 5,\n      veryLowUsageThreshold: 1,\n      minCallsForAnalysis: 100,\n      reportIntervalMs: 60 * 60 * 1000,\n    });\n\n    this.toolChainTracker = new ToolChainTracker({\n      enabled: true,\n      maxChainsPerSession: 10,\n      maxNodesPerChain: 100,\n      trackParams: true,\n      trackResults: true,\n      autoPrune: true,\n    });\n\n    this.errorPatternMatcher = new ErrorPatternMatcher({\n      enabled: true,\n      defaultMaxRetries: 1,\n      logMatches: true,\n    });\n\n    // Initialize context middleware for automatic request tracking\n    this.contextMiddleware = new ContextMiddleware();\n  }\n\n  private initializeLifecycleHandlers(): void {\n    this.lifecycleManager.on('llm_response', new CompactionLifecycleHandler({\n      minMessages: 20,\n      maxTokens: 8000,\n      preserveReasoning: true,\n      accumulateUsage: true,\n    }));\n\n    log.debug(\n      { handlers: this.lifecycleManager.getRegisteredHandlers() },\n      'Lifecycle handlers initialized'\n    );\n  }\n\n  setChannelManager(channelManager: ChannelManager): void {\n    this.modelManager.setChannelManager(channelManager);\n    this.channelManagerRef = channelManager;\n    this.inboundLoop.setChannelManager(channelManager);\n  }\n\n  /**\n   * Apply config after save or hot reload so the default model updates without restarting the gateway.\n   */\n  applyAgentDefaultsFromConfig(config: Config): void {\n    this.config.config = config;\n    const ref = getAgentDefaultModelRef(config);\n    this.config.model = ref;\n    this.modelManager.updateFromConfig(config);\n    this.agentManager.updateAgentDefaults(config);\n    this.commandHandler.updateAgentConfig(config);\n  }\n\n  getSkillCatalog(lang?: string): SkillCatalogEntry[] {\n    return this.agentManager.getSkillCatalog(lang);\n  }\n\n  getSkillMarkdownSource(skillName: string, lang?: string): SkillMarkdownPreviewPayload | null {\n    return this.agentManager.getSkillMarkdownSource(skillName, lang);\n  }\n\n  refreshSkillsAfterDiskChange(): void {\n    this.agentManager.refreshSkillsAfterDiskChange();\n  }\n\n  refreshSkillsAfterSkillConfigChange(): void {\n    this.agentManager.refreshSkillsAfterSkillConfigChange();\n  }\n\n  getModelForSession(sessionKey: string): string {\n    return this.modelManager.getModelForSession(sessionKey);\n  }\n\n  async switchModelForSession(sessionKey: string, modelId: string): Promise<boolean> {\n    const ok = await this.modelManager.switchModelForSession(sessionKey, modelId);\n    if (!ok) return false;\n    await this.sessionConfigStore.update(sessionKey, { modelOverride: modelId });\n    const result = this.agentManager.setModelForSession(sessionKey, modelId);\n    if (result) {\n      this.sessionTracker.touchSession(sessionKey);\n    }\n    return true;\n  }\n\n  /**\n   * Clears per-session model override so the next turn uses the configured agent default\n   * (e.g. cron isolated job with no explicit model).\n   */\n  async resetSessionModelToAgentDefault(sessionKey: string): Promise<void> {\n    await this.sessionConfig.clearModelOverride(sessionKey);\n  }\n\n  setStreamHandle(handle: StreamHandle): void {\n    this.streamManager.setHandle(handle);\n    this.feedbackCoordinator.setStreamHandle(handle);\n  }\n\n  clearStreamHandle(): void {\n    this.streamManager.clearHandle();\n    this.feedbackCoordinator.endTask();\n  }\n\n  /** Last assistant visible plain text for a session (e.g. after a webchat stream). */\n  getLastAssistantPlainText(sessionKey: string): string {\n    return (\n      this.sessionState.getLastAssistantText(sessionKey) ??\n      this.agentManager.getLastAssistantContent(sessionKey) ??\n      ''\n    );\n  }\n\n  beginInboundTurn(sessionKey: string): void {\n    this.sessionState.beginInboundTurn(sessionKey);\n  }\n\n  endInboundTurn(sessionKey: string): void {\n    this.sessionState.endInboundTurn(sessionKey);\n  }\n\n  getInboundTurnDepth(sessionKey: string): number {\n    return this.sessionState.getInboundTurnDepth(sessionKey);\n  }\n\n  async start(): Promise<void> {\n    await this.sessionConfigStore.initialize();\n    await this.hookHandler.trigger('gateway_start', { port: 0, host: 'cli' });\n    await this.reconcileDreamingCronJob().catch((err) => {\n      const em = err instanceof Error ? err.message : String(err);\n      log.warn({ err, errorMessage: em }, `Dreaming cron reconcile failed: ${em}`);\n    });\n    log.debug('Agent service started');\n    await this.inboundLoop.start();\n  }\n\n  stop(): Promise<void> {\n    this.inboundLoop.stop();\n    this.agentManager.dispose();\n    this.dispose();\n\n    this.hookHandler.trigger('gateway_stop', { reason: 'stopped' });\n    log.debug('Agent service stopped');\n    return Promise.resolve();\n  }\n\n  /**\n   * Reconcile managed Dreaming cron job against the current effective config.\n   * Safe to call after config saves to apply changes without restarting the process.\n   */\n  async reconcileDreamingNow(): Promise<void> {\n    await this.reconcileDreamingCronJob();\n  }\n\n  private async reconcileDreamingCronJob(): Promise<void> {\n    const cron = this.config.getCronService?.();\n    if (!cron) {\n      return;\n    }\n    await reconcileManagedDreamingCronJobs(cron, this.effectiveAppConfig());\n  }\n\n  /**\n   * Persist agent messages with the same sanitizer + transcript hygiene as AgentOrchestrator.\n   * Uses persistence hygiene so `thinking` blocks remain on disk for the web UI (LLM load path still drops them).\n   */\n  /**\n   * Fire-and-forget: `maybeAutoTitleSessionStore` no-ops for cron/heartbeat keys.\n   * Runs after persist so the store has the latest transcript; does not block SSE / callers.\n   */\n  private enqueueMaybeAutoTitleAfterPersist(sessionKey: string): void {\n    void (async () => {\n      try {\n        let modelRef =\n          getAgentDefaultModelRef(this.config.config ?? ({} as Config)) ?? this.config.model;\n        if (!modelRef?.trim()) {\n          try {\n            modelRef = this.modelManager.getModelForSession(sessionKey);\n          } catch {\n            modelRef = undefined;\n          }\n        }\n        await maybeAutoTitleSessionStore(this.sessionStore, sessionKey, modelRef?.trim() || undefined);\n      } catch (err) {\n        log.warn({ err, sessionKey }, 'Auto session title failed');\n      }\n    })();\n  }\n\n  private prepareLoadedSessionMessages(sessionKey: string, messages: AgentMessage[]): AgentMessage[] {\n    let out = cleanTrailingErrors(messages);\n    try {\n      const model = this.modelManager.getResolvedModelForSession(sessionKey);\n      out = tryApplySessionTranscriptHygiene(out, model);\n    } catch (err) {\n      log.warn({ err, sessionKey }, 'Transcript hygiene on load skipped');\n    }\n    return out;\n  }\n\n  private parseSessionKey(sessionKey: string): { channel: string; chatId: string } {\n    return parseOutboundSessionKey(sessionKey, this.config.config);\n  }\n\n  private initSessionContext(\n    sessionKey: string,\n    channel: string,\n    chatId: string,\n    senderId = '',\n  ): SessionContext {\n    const context: SessionContext = {\n      sessionKey,\n      channel,\n      chatId,\n      senderId,\n      isGroup: false,\n    };\n\n    this.contextMiddleware.onRequest({\n      sessionKey,\n      userId: context.senderId,\n      channel,\n      chatId,\n    });\n\n    // Direct turn entry points (one-shot + streaming generator) cannot wrap their\n    // body in `sessionContextManager.runWith(ctx, fn)` cleanly — the streaming\n    // path is an async generator, and both flows already use a try/finally for\n    // side-effect cleanup. We use `enter` so the context is visible via ALS for\n    // every async resource launched after this call returns. The context is\n    // overwritten or cleared by the next direct turn (each direct turn calls\n    // `initSessionContext` first), so there is no cross-session leak in practice.\n    this.sessionContextManager.enter(context);\n    this.feedbackCoordinator.setContext(context);\n    this.agentManager.getOrCreateAgent(sessionKey);\n    this.setupSessionEventHandling(sessionKey);\n\n    return context;\n  }\n\n  /**\n   * Persist inbound file attachments under agent home `inbound/` (non-images with data).\n   * Idempotent if `workspaceRelativePath` is already set on an attachment.\n   */\n  async prepareInboundAttachments(\n    sessionKey: string,\n    attachments?: Array<{\n      type: string;\n      mimeType?: string;\n      data?: string;\n      name?: string;\n      size?: number;\n      workspaceRelativePath?: string;\n    }>,\n  ): Promise<\n    | Array<{\n        type: string;\n        mimeType?: string;\n        data?: string;\n        name?: string;\n        size?: number;\n        workspaceRelativePath?: string;\n      }>\n    | undefined\n  > {\n    const cfg = this.config.config!;\n    const storageRoot = resolveAgentHomeDir(cfg, extractProfileAgentId(sessionKey, cfg));\n    return persistInboundAttachmentsToWorkspace(storageRoot, sessionKey, attachments);\n  }\n\n  private endDirectRequestContext(): void {\n    // `sessionContextManager` is ALS-backed: the context for the current async\n    // chain drops automatically when the chain unwinds. The feedback\n    // coordinator + context middleware still use singleton state, so clear\n    // them explicitly here.\n    this.feedbackCoordinator.clearContext();\n    this.contextMiddleware.onResponse();\n  }\n\n  /**\n   * Reset a session's transcript and drop the in-memory agent so the next turn\n   * reloads from disk. Combines two collaborators (sessionStore + agentManager)\n   * so it stays on `AgentService`; pure sessionStore reads should use\n   * `agentService.sessionStore.*` directly.\n   */\n  async clearSessionMessages(key: string): Promise<void> {\n    await this.sessionStore.saveMessages(key, []);\n    this.agentManager.removeAgent(key);\n  }\n\n  /**\n   * Reset session transcript (archive + new session id) and evict in-memory agent state.\n   * Preserves the session key and persisted per-session overrides.\n   */\n  async resetSession(\n    key: string,\n  ): Promise<{ sessionId: string; previousSessionId: string } | null> {\n    const { abortEmbeddedRun } = await import('./embedded/runs.js');\n    const { retireSessionMcpRuntimeForSessionKey } = await import('./mcp/bundle-mcp-tools.js');\n    await abortEmbeddedRun(key);\n    const outcome = await this.sessionStore.reset(key);\n    if (!outcome) {\n      return null;\n    }\n    this.agentManager.removeAgent(key);\n    await retireSessionMcpRuntimeForSessionKey({ sessionKey: key, reason: 'session-reset' });\n    return outcome;\n  }\n\n  /**\n   * Drop in-memory agent so the next turn reloads transcript from disk (e.g. after checkpoint restore).\n   */\n  evictSessionAgent(sessionKey: string): void {\n    this.agentManager.removeAgent(sessionKey);\n  }\n\n  /**\n   * Load session working directory override into AgentManager, ensure directory exists.\n   * Call before AgentManager.getOrCreateAgent for this session.\n   */\n  /** Workspace root for UI file tree / editor (same as agent tools after hydration). */\n  async getEffectiveWorkspacePathForSession(sessionKey: string): Promise<string> {\n    await this.sessionHydrator.workspace(sessionKey);\n    const cfg = this.config.config!;\n    const sc = await this.sessionConfigStore.get(sessionKey);\n    return effectiveWorkspacePathForSession(cfg, sessionKey, sc);\n  }\n\n  /**\n   * Best-effort timezone resolution for webchat envelope timestamps.\n   * Reads `USER.md` under the agent `profile/` directory and extracts a `Timezone:` line.\n   */\n  resolveUserTimezoneForSession(sessionKey: string): string | undefined {\n    try {\n      const cfg = this.effectiveAppConfig();\n      if (!cfg) return undefined;\n      const { agentId } = resolveEffectiveAgentProfileForSession(cfg, sessionKey);\n      const userPath = join(resolveAgentProfileDir(cfg, agentId), 'USER.md');\n      if (!existsSync(userPath)) return undefined;\n      const raw = readFileSync(userPath, 'utf-8');\n      const match = raw.match(/Timezone:\\s*(.+)/i);\n      const tz = match?.[1]?.trim();\n      return tz || undefined;\n    } catch {\n      return undefined;\n    }\n  }\n\n  /**\n   * Setup event handling for a specific session\n   */\n  private setupSessionEventHandling(sessionKey: string): void {\n    if (this.sessionState.hasSessionEventUnsubscriber(sessionKey)) {\n      return;\n    }\n\n    const unsubscribe = this.agentManager.subscribeToSession(sessionKey, (event) => {\n      this.handleSessionEvent(sessionKey, event);\n    });\n\n    if (unsubscribe) {\n      this.sessionState.setSessionEventUnsubscriber(sessionKey, unsubscribe);\n    }\n  }\n\n  /**\n   * Handle events from a specific session's agent\n   */\n  private handleSessionEvent(sessionKey: string, event: AgentEvent): void {\n    const currentContext = this.sessionContextManager.getContext();\n    if (!currentContext) {\n      // Inbound `finally` clears context before trailing agent `message_update` events finish — ignore (not a bug).\n      return;\n    }\n\n    if (currentContext.sessionKey !== sessionKey) {\n      // Event from a different session — still process with current context where applicable\n      this.agentEventHandler.handle(event, currentContext);\n      return;\n    }\n\n    // Handle streaming updates for the current session\n    if (event.type === 'message_update') {\n      const msgEvent = event as Extract<AgentEvent, { type: 'message_update' }>;\n      if (msgEvent.message?.role === 'assistant') {\n        const content = msgEvent.message.content;\n        const text = Array.isArray(content)\n          ? extractTextContent(content as Array<{ type: string; text?: string }>)\n          : String(content);\n\n        this.streamManager.update(text);\n      }\n    }\n\n    this.agentEventHandler.handle(event, currentContext);\n  }\n\n  private async checkAndCompact(sessionKey: string, messages: AgentMessage[]): Promise<void> {\n    const contextWindow = this.getContextWindow();\n    const prep = this.sessionStore.prepareCompaction(sessionKey, messages, contextWindow);\n    if (!prep.needsCompaction) return;\n\n    log.info({ sessionKey, reason: prep.stats?.reason, usagePercent: prep.stats?.usagePercent }, 'Session needs compaction');\n\n    const result = await this.sessionStore.compact(sessionKey, messages, contextWindow, undefined, false);\n    await this.hookHandler.trigger('after_compaction', {\n      messageCount: messages.length,\n      tokenCount: result.tokensBefore,\n      compactedCount: messages.length - result.firstKeptIndex,\n    });\n    log.info({ sessionKey, tokensBefore: result.tokensBefore, tokensAfter: result.tokensAfter }, 'Session compacted');\n  }\n\n  private getContextWindow(): number {\n    const defaults = this.config.agentDefaults || this.config.config?.agents?.defaults;\n    return defaults?.maxTokens ? defaults.maxTokens * 4 : 128000;\n  }\n\n  private dispose(): void {\n    this.sessionTracker.dispose();\n    this.sessionState.disposeAll();\n    this.agentManager.dispose();\n    this.workflowProgressBrokerHandle?.dispose();\n    this.workflowProgressBrokerHandle = null;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"service.js","names":[],"sources":["../../../src/agent/service.ts"],"sourcesContent":["import type { AgentEvent, AgentMessage, ThinkingLevel } from '@earendil-works/pi-agent-core';\nimport type { MessageBus } from '../infra/bus/index.js';\nimport { type Config, getAgentDefaultModelRef } from '../config/schema.js';\nimport {\n  maybeRefineSessionTitleWithLlm,\n  maybeSetProvisionalSessionTitle,\n} from '../session/session-title.js';\nimport type { ChannelManager } from '../channels/manager.js';\nimport { existsSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport {\n  SessionStore,\n  SessionConfigStore,\n  onSessionTranscriptUpdate,\n  effectiveWorkspacePathForSession,\n  type CompactionConfig,\n  type WindowConfig,\n} from '../session/index.js';\nimport { type ThinkLevel } from './transcript/thinking-types.js';\nimport { createLogger } from '../utils/logger.js';\nimport { ExtensionHookRunner } from '../extensions/index.js';\nimport { extractTextContent } from './context/workspace.js';\nimport { SessionTracker } from './session/tracker.js';\nimport { ModelManager } from './models/index.js';\nimport { initializeCommands } from '../chat-commands/index.js';\nimport { ProgressFeedbackManager } from './lifecycle/progress.js';\nimport { HookHandler } from './lifecycle/hook-handler.js';\nimport { ToolErrorTracker } from './tools/error-tracker.js';\nimport { RequestLimiter } from './models/request-limiter.js';\nimport { SystemReminder } from './prompt/system-reminder.js';\nimport { ToolUsageAnalyzer } from './tools/usage-analyzer.js';\nimport { ToolChainTracker } from './tools/chain-tracker.js';\nimport { ErrorPatternMatcher } from './tools/error-pattern-matcher.js';\nimport { ContextMiddleware, SelfVerifyMiddleware } from './middleware/index.js';\nimport { LifecycleManager } from './lifecycle/index.js';\nimport { CompactionLifecycleHandler } from './lifecycle/handlers/compaction.js';\n\nimport {\n  MessageRouter,\n  CommandHandler,\n  StreamManager,\n  OutboundCoordinator,\n} from './messaging/index.js';\nimport { InboundLoop } from './inbound/inbound-loop.js';\nimport { TurnDispatcher } from './inbound/turn-dispatcher.js';\nimport {\n  SessionContextManager,\n  SessionLifecycleManager,\n  SessionStateBag,\n  SessionConfigService,\n  SessionHydrator,\n  SessionInspector,\n  type SessionContext,\n} from './session/index.js';\nimport { AgentOrchestrator, AgentEventHandler } from './orchestration/index.js';\nimport {\n  getWorkflowProgressBroker,\n  type BrokerListenerHandle,\n} from './workflow/index.js';\nimport { FeedbackCoordinator } from './feedback/index.js';\nimport { AgentManager, type SkillCatalogEntry } from './agent-manager.js';\nimport type { SkillMarkdownPreviewPayload } from './skills/types.js';\nimport type { AgentServiceConfig, StreamHandle } from './service.types.js';\nimport { PersistentGoalService } from './goals/persistent-goal-service.js';\nimport { reconcileManagedDreamingCronJobs } from './service/reconcile-dreaming-cron.js';\nimport { parseOutboundSessionKey } from './service/parse-outbound-session-key.js';\n\nimport {\n  resolveAgentHomeDir,\n  resolveAgentProfileDir,\n  resolveDefaultAgentId,\n} from './agent-scope.js';\nimport {\n  extractProfileAgentId,\n  resolveEffectiveAgentProfileForSession,\n} from '../config/agent-profile.js';\nimport { cleanTrailingErrors } from './memory/message-sanitizer.js';\nimport { tryApplySessionTranscriptHygiene } from './transcript/transcript-hygiene.js';\nimport {\n  persistInboundAttachmentsToWorkspace,\n  type InternalAttachmentRoots,\n} from '../channels/attachments/inbound-persist.js';\nimport { applyConfigOverrides } from '../config/runtime-overrides.js';\n\nexport type { AgentServiceConfig, AgentContext, StreamHandle } from './service.types.js';\n\nconst log = createLogger('AgentService');\n\nexport class AgentService {\n  /**\n   * Persistent transcript + session-metadata store. Public so the gateway/TUI\n   * can read sessions, delete them, etc. without forcing every CRUD-style\n   * operation through a delegation method on `AgentService`.\n   */\n  readonly sessionStore: SessionStore;\n  private sessionConfigStore: SessionConfigStore;\n  private hookRunner?: ExtensionHookRunner;\n  private agentId: string;\n  private workspaceDir: string;\n  private channelManagerRef: ChannelManager | null = null;\n  private bus: MessageBus;\n  private config: AgentServiceConfig;\n\n  private sessionTracker: SessionTracker;\n  private modelManager: ModelManager;\n  private progressManager: ProgressFeedbackManager;\n  private hookHandler: HookHandler;\n  private lifecycleManager: LifecycleManager;\n  private errorTracker: ToolErrorTracker;\n  private requestLimiter: RequestLimiter;\n  private systemReminder: SystemReminder;\n  private toolUsageAnalyzer: ToolUsageAnalyzer;\n  private toolChainTracker: ToolChainTracker;\n  private errorPatternMatcher: ErrorPatternMatcher;\n  private selfVerifyMiddleware: SelfVerifyMiddleware;\n  private contextMiddleware: ContextMiddleware;\n\n  private messageRouter: MessageRouter;\n  private commandHandler: CommandHandler;\n  private streamManager: StreamManager;\n  /**\n   * Outbound pipeline: typing controller, silence guard, final response publish,\n   * extension `message_sending`/`message_sent` hooks, post-turn `webchat_turn_complete`\n   * event. Public so the gateway / channels can drive it directly.\n   */\n  readonly outboundCoordinator: OutboundCoordinator;\n  private inboundLoop: InboundLoop;\n  /**\n   * Direct-turn entry points: `processDirect` (one-shot), `processDirectStreaming`\n   * (SSE generator), webchat steering and SSE injection. Public so the gateway,\n   * TUI, CLI, and cron jobs do not need to thread every call through `AgentService`.\n   */\n  readonly turnDispatcher: TurnDispatcher;\n  /**\n   * `/goal` runtime: continuation scheduling, persistent-goal API factory,\n   * stream-outcome state, post-turn verdict. Public so the gateway can wire\n   * the webchat continuation scheduler and read stream outcomes directly.\n   */\n  readonly persistentGoals: PersistentGoalService;\n  /**\n   * Per-session config writes (model / thinking / reasoning / working directory).\n   * Public so REST endpoints and CLI flows can hit it without going through a\n   * monolithic patch entrypoint on `AgentService`.\n   */\n  readonly sessionConfig: SessionConfigService;\n  /**\n   * Hydration — read persisted per-session config and apply it to the runtime\n   * (AgentManager / ModelManager). The mirror image of `sessionConfig`: writes\n   * go through `sessionConfig`, reads-into-runtime go through `sessionHydrator`.\n   */\n  readonly sessionHydrator: SessionHydrator;\n  /**\n   * Read-only introspection (compaction, /context report, /btw, contextUsage,\n   * agentConfig view). Public so REST endpoints and CLI flows can query a\n   * session's view without going through delegating methods on `AgentService`.\n   */\n  readonly sessionInspector: SessionInspector;\n  private sessionContextManager: SessionContextManager;\n  private sessionLifecycleManager: SessionLifecycleManager;\n  private agentOrchestrator: AgentOrchestrator;\n  private agentEventHandler: AgentEventHandler;\n  private workflowProgressBrokerHandle: BrokerListenerHandle | null = null;\n  private feedbackCoordinator: FeedbackCoordinator;\n  private agentManager: AgentManager;\n\n  /**\n   * Unified per-session state container (replaces six ad-hoc Maps). Owns webchat\n   * publishers, last assistant text, embedded stream buffer, persistent-goal stream\n   * outcomes, concurrent-turn depth, and event-listener unsubscribers; runs a TTL\n   * sweep for slots that have no explicit owner.\n   */\n  private sessionState = new SessionStateBag();\n\n  /** Gateway: notify UI after direct `SessionStore.updateMetadata` (no SessionManager emit). */\n  private onSessionMetadataUpdated?: (sessionKey: string, patch?: { name?: string }) => void;\n  private onSessionTranscriptUpdated?: (sessionKey: string) => void;\n\n  private effectiveAppConfig(): Config | undefined {\n    const base = this.config.config;\n    return base ? applyConfigOverrides(base) : undefined;\n  }\n\n  constructor(bus: MessageBus, config: AgentServiceConfig) {\n    this.bus = bus;\n    this.config = config;\n    this.onSessionMetadataUpdated = config.onSessionMetadataUpdated;\n    this.onSessionTranscriptUpdated = config.onSessionTranscriptUpdated;\n    this.agentId = `agent-${Date.now()}`;\n    this.workspaceDir = config.workspace;\n\n    this.sessionTracker = new SessionTracker();\n    this.modelManager = new ModelManager({\n      defaultModel: config.model,\n      config: config.config,\n    });\n\n    initializeCommands();\n    log.debug('Command system initialized');\n\n    this.sessionStore = config.sessionStore ?? this.createSessionStore();\n    onSessionTranscriptUpdate((update) => {\n      void this.sessionStore.syncSessionsJsonFromTranscriptUpdate(update).catch((err) => {\n        log.warn(\n          { err, sessionFile: update.sessionFile, sessionKey: update.sessionKey },\n          'Transcript index sync failed',\n        );\n      });\n      const sk = update.sessionKey?.trim();\n      if (sk) {\n        this.onSessionTranscriptUpdated?.(sk);\n      }\n    });\n    const appCfgForPaths = this.config.config;\n    if (!appCfgForPaths) {\n      throw new Error('AgentService requires config.config for session paths');\n    }\n    const defaultAid = resolveDefaultAgentId(appCfgForPaths);\n    const defaultAgentHome = resolveAgentHomeDir(appCfgForPaths, defaultAid);\n    this.sessionConfigStore = new SessionConfigStore(defaultAgentHome);\n\n    this.hookRunner = this.createHookRunner();\n    this.hookHandler = new HookHandler({\n      hookRunner: this.hookRunner,\n      agentId: this.agentId,\n      get sessionKey() { return this.currentContext?.sessionKey; },\n    });\n\n    this.progressManager = this.createProgressManager();\n    this.initializeReliabilityModules();\n\n    this.lifecycleManager = new LifecycleManager();\n    this.initializeLifecycleHandlers();\n\n    this.streamManager = new StreamManager();\n    this.sessionContextManager = new SessionContextManager();\n    this.feedbackCoordinator = new FeedbackCoordinator({\n      progressManager: this.progressManager,\n      bus,\n    });\n\n    // Initialize AgentManager\n    this.agentManager = new AgentManager({\n      workspace: config.workspace,\n      model: config.model,\n      config: config.config,\n      extensionRegistry: config.extensionRegistry,\n      hookRunner: this.hookRunner,\n      bus,\n      getCurrentContext: () => this.sessionContextManager.getContext(),\n      getSessionStore: () => this.sessionStore,\n      getModelManager: () => this.modelManager,\n      thinkingLevel: config.thinkingLevel,\n      reasoningLevel: config.reasoningLevel,\n      verboseLevel: config.verboseLevel,\n      gatewayClarify: config.gatewayClarify,\n      getCronService: config.getCronService,\n      getWorkflowRunService: config.getWorkflowRunService,\n    });\n\n    this.agentEventHandler = new AgentEventHandler({\n      progressManager: this.progressManager,\n      errorTracker: this.errorTracker,\n      requestLimiter: this.requestLimiter,\n      lifecycleManager: this.lifecycleManager,\n      toolChainTracker: this.toolChainTracker,\n      selfVerifyMiddleware: this.selfVerifyMiddleware,\n      systemReminder: this.systemReminder,\n      toolUsageAnalyzer: this.toolUsageAnalyzer,\n      errorPatternMatcher: this.errorPatternMatcher,\n    });\n\n    // Wire the workflow progress broker into the session event bus. Channel\n    // extensions self-register their capability against the singleton at\n    // boot; the broker only forwards updates to whatever has registered, so\n    // this is safe even when no channel is configured.\n    this.workflowProgressBrokerHandle = getWorkflowProgressBroker().attachTo(\n      this.agentEventHandler,\n    );\n\n    // sessionHydrator is constructed early because AgentOrchestrator + InboundLoop +\n    // TurnDispatcher all need it; the SessionConfigService instance below also\n    // shares the same constructor parameters.\n    this.sessionHydrator = new SessionHydrator({\n      sessionConfigStore: this.sessionConfigStore,\n      agentManager: this.agentManager,\n      modelManager: this.modelManager,\n      getConfig: () => this.effectiveAppConfig(),\n    });\n\n    this.agentOrchestrator = new AgentOrchestrator({\n      agentManager: this.agentManager,\n      sessionStore: this.sessionStore,\n      modelManager: this.modelManager,\n      eventHandler: this.agentEventHandler,\n      feedbackCoordinator: this.feedbackCoordinator,\n      sessionConfigStore: this.sessionConfigStore,\n      sessionHydrator: this.sessionHydrator,\n      getConfig: () => this.effectiveAppConfig(),\n      getThinkingDefault: () => this.effectiveAppConfig()?.agents?.defaults?.thinkingDefault,\n      getThinkingDefaultForSession: (sessionKey: string) =>\n        this.agentManager.getThinkingDefaultForSession(sessionKey),\n      workspaceRoot: this.workspaceDir,\n      getWorkspaceRootForSession: (sessionKey: string) =>\n        this.agentManager.getResolvedWorkspaceForSession(sessionKey),\n      getAgentInternalStorageRootForSession: (sessionKey: string) =>\n        resolveAgentHomeDir(this.config.config!, extractProfileAgentId(sessionKey, this.config.config!)),\n      enqueueAutoTitle: (sessionKey: string) => this.enqueueMaybeAutoTitleAfterPersist(sessionKey),\n      onEmbeddedStreamEvent: (sessionKey, event) => {\n        const ctx = this.sessionContextManager.getContext();\n        if (!ctx || ctx.sessionKey !== sessionKey) {\n          return;\n        }\n        if (event.type === 'token') {\n          const next = this.sessionState.appendEmbeddedStreamText(sessionKey, event.content);\n          this.streamManager.update(next);\n        }\n      },\n      onEmbeddedTurnComplete: (sessionKey, text) => {\n        if (text) {\n          this.sessionState.setLastAssistantText(sessionKey, text);\n        }\n        this.sessionState.clearEmbeddedStreamText(sessionKey);\n      },\n    });\n\n    this.messageRouter = new MessageRouter();\n    this.commandHandler = new CommandHandler({\n      config: config.config!,\n      bus,\n      sessionStore: this.sessionStore,\n      sessionConfigStore: this.sessionConfigStore,\n      getPersistentGoalApisForCommand: (routing) => this.persistentGoals.buildApisForRouting(routing),\n      applySessionThinkingLevel: (sessionKey: string, level: ThinkLevel) => {\n        this.agentManager.setThinkingLevel(sessionKey, level as ThinkingLevel);\n      },\n      getCurrentModel: () => this.agentOrchestrator.getCurrentModel(),\n      switchModelForSession: (sessionKey: string, modelId: string) =>\n        this.switchModelForSession(sessionKey, modelId),\n      invalidateAgentSession: (sessionKey: string) => {\n        this.agentManager.removeAgent(sessionKey);\n      },\n      resetSession: (sessionKey: string) => this.resetSession(sessionKey),\n      abortSessionTurn: async (sessionKey: string) => {\n        await this.streamManager.abort();\n        this.agentOrchestrator.abort(sessionKey);\n      },\n      compactSession: (sessionKey, options) => this.sessionInspector.compact(sessionKey, options),\n      btwQuery: (sessionKey, question) => this.sessionInspector.btwQuery(sessionKey, question),\n      getSessionContextReport: (sessionKey, mode) => this.sessionInspector.report(sessionKey, mode),\n    });\n\n    this.sessionLifecycleManager = new SessionLifecycleManager(\n      this.sessionStore,\n      this.sessionTracker,\n      this.lifecycleManager\n    );\n\n    this.persistentGoals = new PersistentGoalService({\n      bus,\n      sessionStore: this.sessionStore,\n      modelManager: this.modelManager,\n      sessionState: this.sessionState,\n      getConfig: () => this.effectiveAppConfig(),\n      getResolvedWorkspaceForSession: (sk) => this.agentManager.getResolvedWorkspaceForSession(sk),\n      onSessionMetadataUpdated: this.onSessionMetadataUpdated,\n      notifyWebchatTranscriptAppend: (sk, text) => this.turnDispatcher.notifyWebchatTranscriptAppend(sk, text),\n    });\n\n    this.sessionConfig = new SessionConfigService({\n      sessionStore: this.sessionStore,\n      sessionConfigStore: this.sessionConfigStore,\n      modelManager: this.modelManager,\n      agentManager: this.agentManager,\n      getConfig: () => this.effectiveAppConfig(),\n    });\n\n    this.sessionInspector = new SessionInspector({\n      sessionStore: this.sessionStore,\n      sessionConfigStore: this.sessionConfigStore,\n      modelManager: this.modelManager,\n      agentManager: this.agentManager,\n      sessionHydrator: this.sessionHydrator,\n      getConfig: () => this.effectiveAppConfig(),\n      getContextWindow: () => this.getContextWindow(),\n    });\n\n    this.outboundCoordinator = new OutboundCoordinator({\n      bus,\n      hookHandler: this.hookHandler,\n      streamManager: this.streamManager,\n      getConfig: () => this.effectiveAppConfig(),\n      getLastAssistantPlainText: (sk) => this.getLastAssistantPlainText(sk),\n      runPersistentGoalPostTurn: (payload) => this.persistentGoals.runPostTurn(payload),\n    });\n\n    this.turnDispatcher = new TurnDispatcher({\n      log,\n      agentManager: this.agentManager,\n      sessionStore: this.sessionStore,\n      modelManager: this.modelManager,\n      sessionConfigStore: this.sessionConfigStore,\n      sessionState: this.sessionState,\n      commandHandler: this.commandHandler,\n      getConfig: () => this.effectiveAppConfig(),\n      requireConfig: () => {\n        const c = this.config.config;\n        if (!c) throw new Error('AgentService requires config.config');\n        return c;\n      },\n      parseSessionKey: (sk) => this.parseSessionKey(sk),\n      initSessionContext: (sk, channel, chatId) => this.initSessionContext(sk, channel, chatId),\n      sessionHydrator: this.sessionHydrator,\n      attachmentRootsForSession: (sk) => this.attachmentRootsForSession(sk),\n      prepareInboundAttachments: (sk, att) => this.prepareInboundAttachments(sk, att),\n      enqueueMaybeAutoTitleAfterPersist: (sk) => this.enqueueMaybeAutoTitleAfterPersist(sk),\n      enqueueProvisionalSessionTitle: (sk, text) => this.enqueueProvisionalSessionTitle(sk, text),\n      endDirectRequestContext: () => this.endDirectRequestContext(),\n      onSessionTranscriptUpdated: this.onSessionTranscriptUpdated,\n      resetSession: (sk) => this.resetSession(sk),\n    });\n\n    this.inboundLoop = new InboundLoop({\n      log,\n      agentId: this.agentId,\n      bus,\n      hookHandler: this.hookHandler,\n      messageRouter: this.messageRouter,\n      commandHandler: this.commandHandler,\n      sessionContextManager: this.sessionContextManager,\n      feedbackCoordinator: this.feedbackCoordinator,\n      agentManager: this.agentManager,\n      sessionLifecycleManager: this.sessionLifecycleManager,\n      agentOrchestrator: this.agentOrchestrator,\n      outboundCoordinator: this.outboundCoordinator,\n      streamManager: this.streamManager,\n      sessionState: this.sessionState,\n      sessionStore: this.sessionStore,\n      modelManager: this.modelManager,\n      setupSessionEventHandling: (sk) => this.setupSessionEventHandling(sk),\n      sessionHydrator: this.sessionHydrator,\n      getLastAssistantPlainText: (sk) => this.getLastAssistantPlainText(sk),\n      checkAndCompact: (sk, msgs) => this.checkAndCompact(sk, msgs),\n      enqueueMaybeAutoTitleAfterPersist: (sk) => this.enqueueMaybeAutoTitleAfterPersist(sk),\n      getConfig: () => this.effectiveAppConfig(),\n      resetSession: (sk) => this.resetSession(sk),\n      setStreamHandle: (handle) => this.setStreamHandle(handle),\n    });\n\n    // Register signal handlers only if not running as an Electron subprocess.\n    // In Electron, the parent process manages the lifecycle and signals should not trigger disposal.\n    const isElectronSubprocess = !!process.env.ELECTRON_RUN_AS_NODE;\n    if (!isElectronSubprocess) {\n      process.on('SIGINT', () => this.dispose());\n      process.on('SIGTERM', () => this.dispose());\n    }\n\n    log.info('AgentService initialized');\n  }\n\n  private attachmentRootsForSession(sessionKey: string): InternalAttachmentRoots {\n    const cfg = this.config.config!;\n    return {\n      agentHome: resolveAgentHomeDir(cfg, extractProfileAgentId(sessionKey, cfg)),\n    };\n  }\n\n  private createSessionStore(): SessionStore {\n    const sessionStoreDefaults = this.config.agentDefaults || this.config.config?.agents?.defaults;\n    const windowConfig: Partial<WindowConfig> = {\n      maxMessages: 100,\n      keepRecentMessages: sessionStoreDefaults?.maxToolIterations || 20,\n      preserveSystemMessages: true,\n    };\n    const compactionConfig: Partial<CompactionConfig> = {\n      enabled: sessionStoreDefaults?.compaction?.enabled ?? true,\n      mode: (sessionStoreDefaults?.compaction?.mode as 'extractive' | 'abstractive' | 'structured') || 'abstractive',\n      reserveTokens: sessionStoreDefaults?.compaction?.reserveTokens || 8000,\n      triggerThreshold: sessionStoreDefaults?.compaction?.triggerThreshold || 0.8,\n      minMessagesBeforeCompact: sessionStoreDefaults?.compaction?.minMessagesBeforeCompact || 10,\n      keepRecentMessages: sessionStoreDefaults?.compaction?.keepRecentMessages || 10,\n      evictionWindow: sessionStoreDefaults?.compaction?.evictionWindow || 0.2,\n      retentionWindow: sessionStoreDefaults?.compaction?.retentionWindow || 6,\n    };\n    const appCfg = this.config.config;\n    if (!appCfg) {\n      throw new Error('AgentService requires config.config for session store paths');\n    }\n    return new SessionStore(\n      {\n        config: appCfg,\n        agentId: resolveDefaultAgentId(appCfg),\n      },\n      windowConfig,\n      compactionConfig,\n    );\n  }\n\n  private createHookRunner(): ExtensionHookRunner | undefined {\n    if (!this.config.extensionRegistry) return undefined;\n\n    return new ExtensionHookRunner(this.config.extensionRegistry, {\n      catchErrors: true,\n      logger: {\n        info: (msg: string) => log.info({ hook: true }, msg),\n        warn: (msg: string) => log.warn({ hook: true }, msg),\n        error: (msg: string) => log.error({ hook: true }, msg),\n      },\n    });\n  }\n\n  private createProgressManager(): ProgressFeedbackManager {\n    return new ProgressFeedbackManager({\n      level: 'normal',\n      showThinking: true,\n      streamToolProgress: true,\n      heartbeatEnabled: true,\n      heartbeatIntervalMs: 20000,\n      longTaskThresholdMs: 30000,\n    });\n  }\n\n  private initializeReliabilityModules(): void {\n    const defaults = this.config.agentDefaults || this.config.config?.agents?.defaults;\n\n    this.errorTracker = new ToolErrorTracker({\n      maxFailuresPerTool: defaults?.maxToolFailuresPerTurn || 3,\n      maxTotalFailures: defaults?.maxToolFailuresPerTurn ? defaults.maxToolFailuresPerTurn + 2 : 5,\n      resetOnTurnEnd: true,\n    });\n\n    this.selfVerifyMiddleware = new SelfVerifyMiddleware({\n      maxEditsPerFile: 5,\n      enablePreCompletionCheck: true,\n      minTurnsForVerification: 4,\n      resetOnVerification: true,\n    });\n\n    this.requestLimiter = new RequestLimiter({\n      maxRequestsPerTurn: defaults?.maxRequestsPerTurn || 50,\n      warnThreshold: 0.8,\n      softLimit: false,\n    });\n\n    this.systemReminder = new SystemReminder({\n      enabled: true,\n      appendToToolResults: true,\n      maxRemindersPerTurn: 3,\n    });\n\n    this.toolUsageAnalyzer = new ToolUsageAnalyzer({\n      enabled: true,\n      lowUsageThreshold: 5,\n      veryLowUsageThreshold: 1,\n      minCallsForAnalysis: 100,\n      reportIntervalMs: 60 * 60 * 1000,\n    });\n\n    this.toolChainTracker = new ToolChainTracker({\n      enabled: true,\n      maxChainsPerSession: 10,\n      maxNodesPerChain: 100,\n      trackParams: true,\n      trackResults: true,\n      autoPrune: true,\n    });\n\n    this.errorPatternMatcher = new ErrorPatternMatcher({\n      enabled: true,\n      defaultMaxRetries: 1,\n      logMatches: true,\n    });\n\n    // Initialize context middleware for automatic request tracking\n    this.contextMiddleware = new ContextMiddleware();\n  }\n\n  private initializeLifecycleHandlers(): void {\n    this.lifecycleManager.on('llm_response', new CompactionLifecycleHandler({\n      minMessages: 20,\n      maxTokens: 8000,\n      preserveReasoning: true,\n      accumulateUsage: true,\n    }));\n\n    log.debug(\n      { handlers: this.lifecycleManager.getRegisteredHandlers() },\n      'Lifecycle handlers initialized'\n    );\n  }\n\n  setChannelManager(channelManager: ChannelManager): void {\n    this.modelManager.setChannelManager(channelManager);\n    this.channelManagerRef = channelManager;\n    this.inboundLoop.setChannelManager(channelManager);\n  }\n\n  /**\n   * Apply config after save or hot reload so the default model updates without restarting the gateway.\n   */\n  applyAgentDefaultsFromConfig(config: Config): void {\n    this.config.config = config;\n    const ref = getAgentDefaultModelRef(config);\n    this.config.model = ref;\n    this.modelManager.updateFromConfig(config);\n    this.agentManager.updateAgentDefaults(config);\n    this.commandHandler.updateAgentConfig(config);\n  }\n\n  getSkillCatalog(lang?: string): SkillCatalogEntry[] {\n    return this.agentManager.getSkillCatalog(lang);\n  }\n\n  getSkillMarkdownSource(skillName: string, lang?: string): SkillMarkdownPreviewPayload | null {\n    return this.agentManager.getSkillMarkdownSource(skillName, lang);\n  }\n\n  refreshSkillsAfterDiskChange(): void {\n    this.agentManager.refreshSkillsAfterDiskChange();\n  }\n\n  refreshSkillsAfterSkillConfigChange(): void {\n    this.agentManager.refreshSkillsAfterSkillConfigChange();\n  }\n\n  getModelForSession(sessionKey: string): string {\n    return this.modelManager.getModelForSession(sessionKey);\n  }\n\n  async switchModelForSession(sessionKey: string, modelId: string): Promise<boolean> {\n    const ok = await this.modelManager.switchModelForSession(sessionKey, modelId);\n    if (!ok) return false;\n    await this.sessionConfigStore.update(sessionKey, { modelOverride: modelId });\n    const result = this.agentManager.setModelForSession(sessionKey, modelId);\n    if (result) {\n      this.sessionTracker.touchSession(sessionKey);\n    }\n    return true;\n  }\n\n  /**\n   * Clears per-session model override so the next turn uses the configured agent default\n   * (e.g. cron isolated job with no explicit model).\n   */\n  async resetSessionModelToAgentDefault(sessionKey: string): Promise<void> {\n    await this.sessionConfig.clearModelOverride(sessionKey);\n  }\n\n  setStreamHandle(handle: StreamHandle): void {\n    this.streamManager.setHandle(handle);\n    this.feedbackCoordinator.setStreamHandle(handle);\n  }\n\n  clearStreamHandle(): void {\n    this.streamManager.clearHandle();\n    this.feedbackCoordinator.endTask();\n  }\n\n  /** Last assistant visible plain text for a session (e.g. after a webchat stream). */\n  getLastAssistantPlainText(sessionKey: string): string {\n    return (\n      this.sessionState.getLastAssistantText(sessionKey) ??\n      this.agentManager.getLastAssistantContent(sessionKey) ??\n      ''\n    );\n  }\n\n  beginInboundTurn(sessionKey: string): void {\n    this.sessionState.beginInboundTurn(sessionKey);\n  }\n\n  endInboundTurn(sessionKey: string): void {\n    this.sessionState.endInboundTurn(sessionKey);\n  }\n\n  getInboundTurnDepth(sessionKey: string): number {\n    return this.sessionState.getInboundTurnDepth(sessionKey);\n  }\n\n  async start(): Promise<void> {\n    await this.sessionConfigStore.initialize();\n    await this.hookHandler.trigger('gateway_start', { port: 0, host: 'cli' });\n    await this.reconcileDreamingCronJob().catch((err) => {\n      const em = err instanceof Error ? err.message : String(err);\n      log.warn({ err, errorMessage: em }, `Dreaming cron reconcile failed: ${em}`);\n    });\n    log.debug('Agent service started');\n    await this.inboundLoop.start();\n  }\n\n  stop(): Promise<void> {\n    this.inboundLoop.stop();\n    this.agentManager.dispose();\n    this.dispose();\n\n    this.hookHandler.trigger('gateway_stop', { reason: 'stopped' });\n    log.debug('Agent service stopped');\n    return Promise.resolve();\n  }\n\n  /**\n   * Reconcile managed Dreaming cron job against the current effective config.\n   * Safe to call after config saves to apply changes without restarting the process.\n   */\n  async reconcileDreamingNow(): Promise<void> {\n    await this.reconcileDreamingCronJob();\n  }\n\n  private async reconcileDreamingCronJob(): Promise<void> {\n    const cron = this.config.getCronService?.();\n    if (!cron) {\n      return;\n    }\n    await reconcileManagedDreamingCronJobs(cron, this.effectiveAppConfig());\n  }\n\n  /**\n   * Persist agent messages with the same sanitizer + transcript hygiene as AgentOrchestrator.\n   * Uses persistence hygiene so `thinking` blocks remain on disk for the web UI (LLM load path still drops them).\n   */\n  private notifySessionTitleUpdated(sessionKey: string, name: string): void {\n    this.onSessionMetadataUpdated?.(sessionKey, { name });\n  }\n\n  /** Fire-and-forget provisional title from first user text (webchat sidebar). */\n  enqueueProvisionalSessionTitle(sessionKey: string, userText: string): void {\n    void (async () => {\n      try {\n        await maybeSetProvisionalSessionTitle(\n          this.sessionStore,\n          sessionKey,\n          userText,\n          (sk, name) => this.notifySessionTitleUpdated(sk, name),\n        );\n      } catch (err) {\n        log.warn({ err, sessionKey }, 'Provisional session title failed');\n      }\n    })();\n  }\n\n  /**\n   * Fire-and-forget LLM refine after turn persist; skips user-locked and finalized LLM titles.\n   */\n  private enqueueMaybeAutoTitleAfterPersist(sessionKey: string): void {\n    void (async () => {\n      try {\n        let modelRef =\n          getAgentDefaultModelRef(this.config.config ?? ({} as Config)) ?? this.config.model;\n        if (!modelRef?.trim()) {\n          try {\n            modelRef = this.modelManager.getModelForSession(sessionKey);\n          } catch {\n            modelRef = undefined;\n          }\n        }\n        await maybeRefineSessionTitleWithLlm(\n          this.sessionStore,\n          sessionKey,\n          modelRef?.trim() || undefined,\n          (sk, name) => this.notifySessionTitleUpdated(sk, name),\n        );\n      } catch (err) {\n        log.warn({ err, sessionKey }, 'Auto session title failed');\n      }\n    })();\n  }\n\n  private prepareLoadedSessionMessages(sessionKey: string, messages: AgentMessage[]): AgentMessage[] {\n    let out = cleanTrailingErrors(messages);\n    try {\n      const model = this.modelManager.getResolvedModelForSession(sessionKey);\n      out = tryApplySessionTranscriptHygiene(out, model);\n    } catch (err) {\n      log.warn({ err, sessionKey }, 'Transcript hygiene on load skipped');\n    }\n    return out;\n  }\n\n  private parseSessionKey(sessionKey: string): { channel: string; chatId: string } {\n    return parseOutboundSessionKey(sessionKey, this.config.config);\n  }\n\n  private initSessionContext(\n    sessionKey: string,\n    channel: string,\n    chatId: string,\n    senderId = '',\n  ): SessionContext {\n    const context: SessionContext = {\n      sessionKey,\n      channel,\n      chatId,\n      senderId,\n      isGroup: false,\n    };\n\n    this.contextMiddleware.onRequest({\n      sessionKey,\n      userId: context.senderId,\n      channel,\n      chatId,\n    });\n\n    // Direct turn entry points (one-shot + streaming generator) cannot wrap their\n    // body in `sessionContextManager.runWith(ctx, fn)` cleanly — the streaming\n    // path is an async generator, and both flows already use a try/finally for\n    // side-effect cleanup. We use `enter` so the context is visible via ALS for\n    // every async resource launched after this call returns. The context is\n    // overwritten or cleared by the next direct turn (each direct turn calls\n    // `initSessionContext` first), so there is no cross-session leak in practice.\n    this.sessionContextManager.enter(context);\n    this.feedbackCoordinator.setContext(context);\n    this.agentManager.getOrCreateAgent(sessionKey);\n    this.setupSessionEventHandling(sessionKey);\n\n    return context;\n  }\n\n  /**\n   * Persist inbound file attachments under agent home `inbound/` (non-images with data).\n   * Idempotent if `workspaceRelativePath` is already set on an attachment.\n   */\n  async prepareInboundAttachments(\n    sessionKey: string,\n    attachments?: Array<{\n      type: string;\n      mimeType?: string;\n      data?: string;\n      name?: string;\n      size?: number;\n      workspaceRelativePath?: string;\n    }>,\n  ): Promise<\n    | Array<{\n        type: string;\n        mimeType?: string;\n        data?: string;\n        name?: string;\n        size?: number;\n        workspaceRelativePath?: string;\n      }>\n    | undefined\n  > {\n    const cfg = this.config.config!;\n    const storageRoot = resolveAgentHomeDir(cfg, extractProfileAgentId(sessionKey, cfg));\n    return persistInboundAttachmentsToWorkspace(storageRoot, sessionKey, attachments);\n  }\n\n  private endDirectRequestContext(): void {\n    // `sessionContextManager` is ALS-backed: the context for the current async\n    // chain drops automatically when the chain unwinds. The feedback\n    // coordinator + context middleware still use singleton state, so clear\n    // them explicitly here.\n    this.feedbackCoordinator.clearContext();\n    this.contextMiddleware.onResponse();\n  }\n\n  /**\n   * Reset a session's transcript and drop the in-memory agent so the next turn\n   * reloads from disk. Combines two collaborators (sessionStore + agentManager)\n   * so it stays on `AgentService`; pure sessionStore reads should use\n   * `agentService.sessionStore.*` directly.\n   */\n  async clearSessionMessages(key: string): Promise<void> {\n    await this.sessionStore.saveMessages(key, []);\n    this.agentManager.removeAgent(key);\n  }\n\n  /**\n   * Reset session transcript (archive + new session id) and evict in-memory agent state.\n   * Preserves the session key and persisted per-session overrides.\n   */\n  async resetSession(\n    key: string,\n  ): Promise<{ sessionId: string; previousSessionId: string } | null> {\n    const { abortEmbeddedRun } = await import('./embedded/runs.js');\n    const { retireSessionMcpRuntimeForSessionKey } = await import('./mcp/bundle-mcp-tools.js');\n    await abortEmbeddedRun(key);\n    const outcome = await this.sessionStore.reset(key);\n    if (!outcome) {\n      return null;\n    }\n    this.agentManager.removeAgent(key);\n    await retireSessionMcpRuntimeForSessionKey({ sessionKey: key, reason: 'session-reset' });\n    return outcome;\n  }\n\n  /**\n   * Drop in-memory agent so the next turn reloads transcript from disk (e.g. after checkpoint restore).\n   */\n  evictSessionAgent(sessionKey: string): void {\n    this.agentManager.removeAgent(sessionKey);\n  }\n\n  /**\n   * Load session working directory override into AgentManager, ensure directory exists.\n   * Call before AgentManager.getOrCreateAgent for this session.\n   */\n  /** Workspace root for UI file tree / editor (same as agent tools after hydration). */\n  async getEffectiveWorkspacePathForSession(sessionKey: string): Promise<string> {\n    await this.sessionHydrator.workspace(sessionKey);\n    const cfg = this.config.config!;\n    const sc = await this.sessionConfigStore.get(sessionKey);\n    return effectiveWorkspacePathForSession(cfg, sessionKey, sc);\n  }\n\n  /**\n   * Best-effort timezone resolution for webchat envelope timestamps.\n   * Reads `USER.md` under the agent `profile/` directory and extracts a `Timezone:` line.\n   */\n  resolveUserTimezoneForSession(sessionKey: string): string | undefined {\n    try {\n      const cfg = this.effectiveAppConfig();\n      if (!cfg) return undefined;\n      const { agentId } = resolveEffectiveAgentProfileForSession(cfg, sessionKey);\n      const userPath = join(resolveAgentProfileDir(cfg, agentId), 'USER.md');\n      if (!existsSync(userPath)) return undefined;\n      const raw = readFileSync(userPath, 'utf-8');\n      const match = raw.match(/Timezone:\\s*(.+)/i);\n      const tz = match?.[1]?.trim();\n      return tz || undefined;\n    } catch {\n      return undefined;\n    }\n  }\n\n  /**\n   * Setup event handling for a specific session\n   */\n  private setupSessionEventHandling(sessionKey: string): void {\n    if (this.sessionState.hasSessionEventUnsubscriber(sessionKey)) {\n      return;\n    }\n\n    const unsubscribe = this.agentManager.subscribeToSession(sessionKey, (event) => {\n      this.handleSessionEvent(sessionKey, event);\n    });\n\n    if (unsubscribe) {\n      this.sessionState.setSessionEventUnsubscriber(sessionKey, unsubscribe);\n    }\n  }\n\n  /**\n   * Handle events from a specific session's agent\n   */\n  private handleSessionEvent(sessionKey: string, event: AgentEvent): void {\n    const currentContext = this.sessionContextManager.getContext();\n    if (!currentContext) {\n      // Inbound `finally` clears context before trailing agent `message_update` events finish — ignore (not a bug).\n      return;\n    }\n\n    if (currentContext.sessionKey !== sessionKey) {\n      // Event from a different session — still process with current context where applicable\n      this.agentEventHandler.handle(event, currentContext);\n      return;\n    }\n\n    // Handle streaming updates for the current session\n    if (event.type === 'message_update') {\n      const msgEvent = event as Extract<AgentEvent, { type: 'message_update' }>;\n      if (msgEvent.message?.role === 'assistant') {\n        const content = msgEvent.message.content;\n        const text = Array.isArray(content)\n          ? extractTextContent(content as Array<{ type: string; text?: string }>)\n          : String(content);\n\n        this.streamManager.update(text);\n      }\n    }\n\n    this.agentEventHandler.handle(event, currentContext);\n  }\n\n  private async checkAndCompact(sessionKey: string, messages: AgentMessage[]): Promise<void> {\n    const contextWindow = this.getContextWindow();\n    const prep = this.sessionStore.prepareCompaction(sessionKey, messages, contextWindow);\n    if (!prep.needsCompaction) return;\n\n    log.info({ sessionKey, reason: prep.stats?.reason, usagePercent: prep.stats?.usagePercent }, 'Session needs compaction');\n\n    const result = await this.sessionStore.compact(sessionKey, messages, contextWindow, undefined, false);\n    await this.hookHandler.trigger('after_compaction', {\n      messageCount: messages.length,\n      tokenCount: result.tokensBefore,\n      compactedCount: messages.length - result.firstKeptIndex,\n    });\n    log.info({ sessionKey, tokensBefore: result.tokensBefore, tokensAfter: result.tokensAfter }, 'Session compacted');\n  }\n\n  private getContextWindow(): number {\n    const defaults = this.config.agentDefaults || this.config.config?.agents?.defaults;\n    return defaults?.maxTokens ? defaults.maxTokens * 4 : 128000;\n  }\n\n  private dispose(): void {\n    this.sessionTracker.dispose();\n    this.sessionState.disposeAll();\n    this.agentManager.dispose();\n    this.workflowProgressBrokerHandle?.dispose();\n    this.workflowProgressBrokerHandle = null;\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/service.types.d.ts

@@ -33,7 +33,9 @@ export interface AgentServiceConfig {
      * Gateway: invoked after `sessionStore.updateMetadata` from built-in `/goal` APIs (store does not emit).
      * Wire to `sessionManager.emit('sessionUpdated', { key })` so the console refetches.
      */
-    onSessionMetadataUpdated?: (sessionKey: string) => void;
+    onSessionMetadataUpdated?: (sessionKey: string, patch?: {
+        name?: string;
+    }) => void;
     /** Gateway: transcript JSONL append (goal verdict, slash receipt, background turns). */
     onSessionTranscriptUpdated?: (sessionKey: string) => void;
     /** Gateway: persisted workflow runs. */

package/dist/src/agent/tools/browser/tool/browser-use-tool.js

@@ -5,7 +5,7 @@ import { loadBrowserPipelineSource } from "../../../../browser/pipeline/source.j
 import { BrowserUseSchema } from "./schemas.js";
 //#region src/agent/tools/browser/tool/browser-use-tool.ts
 init_logger();
-const log = createLogger("browser_use");
+const log = createLogger("Agent:BrowserUse");
 function createBrowserUseTool(deps) {
 	const registry = createBrowserActionRegistry();
 	function buildContext(page, signal) {

package/dist/src/agent/tools/browser/tool/browser-use-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser-use-tool.js","names":[],"sources":["../../../../../../src/agent/tools/browser/tool/browser-use-tool.ts"],"sourcesContent":["/**\n * browser_use — unified browser AgentTool.\n *\n * Modes: command | pipeline | inspect | close.\n * Replaces the 14 fine-grained browser_* tools with a single entry point.\n */\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\n\nimport { createLogger } from '../../../../utils/logger.js';\nimport type { Config } from '../../../../config/schema.js';\nimport type { BrowserManager } from '../../../../browser/manager.js';\nimport type { CdpSupervisor } from '../../../../browser/cdp-supervisor.js';\nimport type { Page } from 'playwright-core';\n\nimport { BrowserUseSchema } from './schemas.js';\nimport { createBrowserActionRegistry } from '../../../../browser/actions/registry.js';\nimport type { BrowserActionContext, BrowserActionResult } from '../../../../browser/actions/types.js';\nimport { loadBrowserPipelineSource } from '../../../../browser/pipeline/source.js';\nimport type { BrowserNotReadyError, BrowserSetupHint } from '../../../../browser/readiness.js';\n\nconst log = createLogger('browser_use');\n\nexport interface CreateBrowserUseToolDeps {\n  getManager: () => BrowserManager;\n  getPageForTask: () => Promise<Page>;\n  getTaskId: () => string;\n  getConfig: () => Config | undefined;\n  getSupervisor?: () => CdpSupervisor | undefined;\n  notifyBrowserPageClosed?: (taskId: string) => void;\n  /**\n   * Preflight readiness check. Returns `null` when the configured backend is\n   * usable, otherwise a structured hint the chat surface renders as a setup\n   * card. Cache the result upstream (~30s) so back-to-back calls don't reprobe.\n   */\n  getReadiness?: () => Promise<BrowserNotReadyError | null>;\n  /** Pipeline runner (injected to avoid circular deps; lazy-loaded if not provided). */\n  runPipeline?: (yaml: string, args: Record<string, unknown>, ctx: BrowserActionContext, dryRun: boolean) => Promise<BrowserActionResult>;\n}\n\nexport function createBrowserUseTool(deps: CreateBrowserUseToolDeps): AgentTool<any, any> {\n  const registry = createBrowserActionRegistry();\n\n  function buildContext(page: Page, signal?: AbortSignal): BrowserActionContext {\n    return {\n      page,\n      manager: deps.getManager(),\n      config: deps.getConfig(),\n      taskId: deps.getTaskId(),\n      supervisor: deps.getSupervisor?.(),\n      signal,\n    };\n  }\n\n  /**\n   * Render a {@link BrowserSetupHint} as a tool result. The text body is a\n   * JSON envelope (`kind: 'browser_setup_required'`) so the chat surface can\n   * detect it and render a Setup card; the embedded `message` keeps the\n   * payload human-readable for the LLM so it stops the browser attempt and\n   * tells the user to finish setup.\n   */\n  function formatNotReady(hint: BrowserSetupHint): { content: { type: 'text'; text: string }[]; details: Record<string, unknown> } {\n    const message =\n      `⚠ Browser is not ready (backend=${hint.backend}, reason=${hint.reason}). ` +\n      `Do NOT retry. Tell the user to open Settings → Browser to finish setup, ` +\n      `then ask them to confirm before running any browser action again.`;\n    const payload = {\n      kind: 'browser_setup_required' as const,\n      backend: hint.backend,\n      reason: hint.reason,\n      deepLink: hint.deepLink,\n      detail: hint.detail,\n      message,\n    };\n    return {\n      content: [{ type: 'text', text: JSON.stringify(payload) }],\n      details: {\n        ok: false,\n        kind: 'browser_setup_required',\n        backend: hint.backend,\n        reason: hint.reason,\n        deepLink: hint.deepLink,\n      },\n    };\n  }\n\n  function formatResult(result: BrowserActionResult): { content: { type: 'text'; text: string }[]; details: Record<string, unknown> } {\n    if (result.ok) {\n      const parts: string[] = [];\n      if (result.text) parts.push(result.text);\n      if (result.data && !result.text) parts.push(JSON.stringify(result.data, null, 2));\n      return {\n        content: [{ type: 'text', text: parts.join('\\n') || 'OK' }],\n        details: { ok: true, action: result.action, ...(result.artifacts?.length ? { artifacts: result.artifacts.length } : {}) },\n      };\n    }\n    const parts: string[] = [];\n    if (result.error) parts.push(`[${result.error.code}] ${result.error.message}`);\n    if (result.diagnostics?.url) parts.push(`URL: ${result.diagnostics.url}`);\n    if (result.diagnostics?.snapshot) parts.push(`Snapshot: ${result.diagnostics.snapshot.slice(0, 2000)}`);\n    return {\n      content: [{ type: 'text', text: parts.join('\\n') || 'Failed' }],\n      details: { ok: false, action: result.action, error: result.error },\n    };\n  }\n\n  const tool: any = {\n    name: 'browser_use',\n    label: '🌐 Browser',\n    description:\n      'Use a persistent browser for web navigation, page inspection, interaction, screenshots, network capture, and scripted browser pipelines. For non-trivial browser tasks, load the \"browser\" skill first with skill_view.',\n    parameters: BrowserUseSchema,\n\n    async execute(_toolCallId, params: any, signal, _onUpdate) {\n      const { mode, command, args: cmdArgs, pipeline: pipelineParams, options: _options } = params as {\n        mode: string;\n        command?: string;\n        args?: Record<string, unknown>;\n        pipeline?: { yaml?: string; script?: string; path?: string; args?: Record<string, unknown>; dryRun?: boolean };\n        options?: { timeout?: number; headless?: boolean };\n      };\n\n      // ─── readiness preflight ────────────────────────────────────────────\n      // Probes the configured backend (doctor + WS bridge / CDP / cloud key)\n      // before any launch attempt. On failure we short-circuit with a setup\n      // hint the chat renders as a card — the agent should stop and ask the\n      // user to finish setup instead of looping on launch errors.\n      if (deps.getReadiness) {\n        try {\n          const notReady = await deps.getReadiness();\n          if (notReady) {\n            return formatNotReady(notReady.hint);\n          }\n        } catch (e) {\n          log.warn({ err: e }, 'Readiness preflight threw; continuing with launch attempt');\n        }\n      }\n\n      // ─── inspect ────────────────────────────────────────────────────────\n      if (mode === 'inspect') {\n        const mgr = deps.getManager();\n        await mgr.ensureConnected();\n        const ext = mgr.getExtensionProvider();\n        if (ext) {\n          const timeout = deps.getConfig?.()?.agents?.defaults?.browser?.commandTimeout;\n          const timeoutMs =\n            typeof timeout === 'number' && Number.isFinite(timeout) && timeout > 0\n              ? Math.floor(timeout * 1000)\n              : 30_000;\n          const urlRes = await ext.sendCommand('get_url', {}, { timeout: timeoutMs });\n          const titleRes = await ext.sendCommand('get_title', {}, { timeout: timeoutMs });\n          const snapRes = await ext.sendCommand('snapshot', {}, { timeout: timeoutMs });\n          const url = urlRes.ok && urlRes.data ? String((urlRes.data as { url?: string }).url ?? '') : '';\n          const title =\n            titleRes.ok && titleRes.data ? String((titleRes.data as { title?: string }).title ?? '') : '';\n          let snapText = '';\n          if (snapRes.ok && snapRes.data) {\n            const nodes = (snapRes.data as { nodes?: Array<{ role?: string; name?: string }> }).nodes ?? [];\n            snapText = nodes.map((n) => `${n.role ?? '?'}: ${n.name ?? ''}`).join('\\n');\n            if (snapText.length > 8000) snapText = `${snapText.slice(0, 8000)}\\n... (truncated)`;\n          }\n          const text = `URL: ${url}\\nTitle: ${title}\\n${snapText ? `--- Page Snapshot ---\\n${snapText}` : ''}`;\n          return {\n            content: [{ type: 'text', text }],\n            details: { ok: true, mode: 'inspect', url, title },\n          };\n        }\n        const page = await deps.getPageForTask();\n        const ctx = buildContext(page, signal);\n        const result = await registry.execute('state', ctx, {});\n        // Augment with URL / title\n        const url = page.url();\n        const title = await page.title().catch(() => '');\n        const text = `URL: ${url}\\nTitle: ${title}\\n${result.text ?? ''}`;\n        return {\n          content: [{ type: 'text', text }],\n          details: { ok: true, mode: 'inspect', url, title },\n        };\n      }\n\n      // ─── close ──────────────────────────────────────────────────────────\n      if (mode === 'close') {\n        const taskId = deps.getTaskId();\n        await deps.getManager().ensureConnected();\n        await deps.getManager().closePage(taskId);\n        deps.notifyBrowserPageClosed?.(taskId);\n        return {\n          content: [{ type: 'text', text: 'Browser page closed.' }],\n          details: { ok: true, mode: 'close' },\n        };\n      }\n\n      // ─── command ────────────────────────────────────────────────────────\n      if (mode === 'command') {\n        if (!command) {\n          return {\n            content: [{ type: 'text', text: 'Missing `command` parameter for command mode.' }],\n            details: { ok: false, mode: 'command' },\n          };\n        }\n        const page = await deps.getPageForTask();\n        const ctx = buildContext(page, signal);\n        const args = cmdArgs ?? {};\n        const result = await registry.execute(command, ctx, args);\n        return formatResult(result);\n      }\n\n      // ─── pipeline ──────────────────────────────────────────────────────\n      if (mode === 'pipeline') {\n        if (!pipelineParams) {\n          return {\n            content: [{ type: 'text', text: 'Missing `pipeline` parameter for pipeline mode.' }],\n            details: { ok: false, mode: 'pipeline' },\n          };\n        }\n\n        // Resolve YAML source\n        let yamlSource = pipelineParams.yaml ?? pipelineParams.script ?? '';\n\n        if (!yamlSource && pipelineParams.path) {\n          try {\n            yamlSource = (await loadBrowserPipelineSource(pipelineParams.path)).source;\n          } catch (e) {\n            const msg = e instanceof Error ? e.message : String(e);\n            return {\n              content: [{ type: 'text', text: `Failed to read pipeline source: ${msg}` }],\n              details: { ok: false, mode: 'pipeline', error: msg },\n            };\n          }\n        }\n\n        if (!yamlSource) {\n          return {\n            content: [{ type: 'text', text: 'Pipeline mode requires `yaml`, `script`, or `path`.' }],\n            details: { ok: false, mode: 'pipeline' },\n          };\n        }\n\n        const pipelineArgs = (pipelineParams.args as Record<string, unknown>) ?? {};\n        const dryRun = pipelineParams.dryRun === true;\n        const page = await deps.getPageForTask();\n        const ctx = buildContext(page, signal);\n\n        // Use injected runner or lazy-load\n        if (deps.runPipeline) {\n          const result = await deps.runPipeline(yamlSource, pipelineArgs, ctx, dryRun);\n          return formatResult(result);\n        }\n\n        // Lazy import pipeline runner\n        try {\n          const { runBrowserPipeline } = await import('../../../../browser/pipeline/runner.js');\n          const result = await runBrowserPipeline(yamlSource, pipelineArgs, ctx, registry, dryRun);\n          return formatResult(result);\n        } catch (e) {\n          const msg = e instanceof Error ? e.message : String(e);\n          log.error({ err: e }, `Pipeline execution failed: ${msg}`);\n          return {\n            content: [{ type: 'text', text: `Pipeline failed: ${msg}` }],\n            details: { ok: false, mode: 'pipeline', error: msg },\n          };\n        }\n      }\n\n      return {\n        content: [{ type: 'text', text: `Unknown mode: ${mode}` }],\n        details: { ok: false },\n      };\n    },\n  };\n  return tool;\n}\n"],"mappings":"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"}
+{"version":3,"file":"browser-use-tool.js","names":[],"sources":["../../../../../../src/agent/tools/browser/tool/browser-use-tool.ts"],"sourcesContent":["/**\n * browser_use — unified browser AgentTool.\n *\n * Modes: command | pipeline | inspect | close.\n * Replaces the 14 fine-grained browser_* tools with a single entry point.\n */\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\n\nimport { createLogger } from '../../../../utils/logger.js';\nimport type { Config } from '../../../../config/schema.js';\nimport type { BrowserManager } from '../../../../browser/manager.js';\nimport type { CdpSupervisor } from '../../../../browser/cdp-supervisor.js';\nimport type { Page } from 'playwright-core';\n\nimport { BrowserUseSchema } from './schemas.js';\nimport { createBrowserActionRegistry } from '../../../../browser/actions/registry.js';\nimport type { BrowserActionContext, BrowserActionResult } from '../../../../browser/actions/types.js';\nimport { loadBrowserPipelineSource } from '../../../../browser/pipeline/source.js';\nimport type { BrowserNotReadyError, BrowserSetupHint } from '../../../../browser/readiness.js';\n\nconst log = createLogger('Agent:BrowserUse');\n\nexport interface CreateBrowserUseToolDeps {\n  getManager: () => BrowserManager;\n  getPageForTask: () => Promise<Page>;\n  getTaskId: () => string;\n  getConfig: () => Config | undefined;\n  getSupervisor?: () => CdpSupervisor | undefined;\n  notifyBrowserPageClosed?: (taskId: string) => void;\n  /**\n   * Preflight readiness check. Returns `null` when the configured backend is\n   * usable, otherwise a structured hint the chat surface renders as a setup\n   * card. Cache the result upstream (~30s) so back-to-back calls don't reprobe.\n   */\n  getReadiness?: () => Promise<BrowserNotReadyError | null>;\n  /** Pipeline runner (injected to avoid circular deps; lazy-loaded if not provided). */\n  runPipeline?: (yaml: string, args: Record<string, unknown>, ctx: BrowserActionContext, dryRun: boolean) => Promise<BrowserActionResult>;\n}\n\nexport function createBrowserUseTool(deps: CreateBrowserUseToolDeps): AgentTool<any, any> {\n  const registry = createBrowserActionRegistry();\n\n  function buildContext(page: Page, signal?: AbortSignal): BrowserActionContext {\n    return {\n      page,\n      manager: deps.getManager(),\n      config: deps.getConfig(),\n      taskId: deps.getTaskId(),\n      supervisor: deps.getSupervisor?.(),\n      signal,\n    };\n  }\n\n  /**\n   * Render a {@link BrowserSetupHint} as a tool result. The text body is a\n   * JSON envelope (`kind: 'browser_setup_required'`) so the chat surface can\n   * detect it and render a Setup card; the embedded `message` keeps the\n   * payload human-readable for the LLM so it stops the browser attempt and\n   * tells the user to finish setup.\n   */\n  function formatNotReady(hint: BrowserSetupHint): { content: { type: 'text'; text: string }[]; details: Record<string, unknown> } {\n    const message =\n      `⚠ Browser is not ready (backend=${hint.backend}, reason=${hint.reason}). ` +\n      `Do NOT retry. Tell the user to open Settings → Browser to finish setup, ` +\n      `then ask them to confirm before running any browser action again.`;\n    const payload = {\n      kind: 'browser_setup_required' as const,\n      backend: hint.backend,\n      reason: hint.reason,\n      deepLink: hint.deepLink,\n      detail: hint.detail,\n      message,\n    };\n    return {\n      content: [{ type: 'text', text: JSON.stringify(payload) }],\n      details: {\n        ok: false,\n        kind: 'browser_setup_required',\n        backend: hint.backend,\n        reason: hint.reason,\n        deepLink: hint.deepLink,\n      },\n    };\n  }\n\n  function formatResult(result: BrowserActionResult): { content: { type: 'text'; text: string }[]; details: Record<string, unknown> } {\n    if (result.ok) {\n      const parts: string[] = [];\n      if (result.text) parts.push(result.text);\n      if (result.data && !result.text) parts.push(JSON.stringify(result.data, null, 2));\n      return {\n        content: [{ type: 'text', text: parts.join('\\n') || 'OK' }],\n        details: { ok: true, action: result.action, ...(result.artifacts?.length ? { artifacts: result.artifacts.length } : {}) },\n      };\n    }\n    const parts: string[] = [];\n    if (result.error) parts.push(`[${result.error.code}] ${result.error.message}`);\n    if (result.diagnostics?.url) parts.push(`URL: ${result.diagnostics.url}`);\n    if (result.diagnostics?.snapshot) parts.push(`Snapshot: ${result.diagnostics.snapshot.slice(0, 2000)}`);\n    return {\n      content: [{ type: 'text', text: parts.join('\\n') || 'Failed' }],\n      details: { ok: false, action: result.action, error: result.error },\n    };\n  }\n\n  const tool: any = {\n    name: 'browser_use',\n    label: '🌐 Browser',\n    description:\n      'Use a persistent browser for web navigation, page inspection, interaction, screenshots, network capture, and scripted browser pipelines. For non-trivial browser tasks, load the \"browser\" skill first with skill_view.',\n    parameters: BrowserUseSchema,\n\n    async execute(_toolCallId, params: any, signal, _onUpdate) {\n      const { mode, command, args: cmdArgs, pipeline: pipelineParams, options: _options } = params as {\n        mode: string;\n        command?: string;\n        args?: Record<string, unknown>;\n        pipeline?: { yaml?: string; script?: string; path?: string; args?: Record<string, unknown>; dryRun?: boolean };\n        options?: { timeout?: number; headless?: boolean };\n      };\n\n      // ─── readiness preflight ────────────────────────────────────────────\n      // Probes the configured backend (doctor + WS bridge / CDP / cloud key)\n      // before any launch attempt. On failure we short-circuit with a setup\n      // hint the chat renders as a card — the agent should stop and ask the\n      // user to finish setup instead of looping on launch errors.\n      if (deps.getReadiness) {\n        try {\n          const notReady = await deps.getReadiness();\n          if (notReady) {\n            return formatNotReady(notReady.hint);\n          }\n        } catch (e) {\n          log.warn({ err: e }, 'Readiness preflight threw; continuing with launch attempt');\n        }\n      }\n\n      // ─── inspect ────────────────────────────────────────────────────────\n      if (mode === 'inspect') {\n        const mgr = deps.getManager();\n        await mgr.ensureConnected();\n        const ext = mgr.getExtensionProvider();\n        if (ext) {\n          const timeout = deps.getConfig?.()?.agents?.defaults?.browser?.commandTimeout;\n          const timeoutMs =\n            typeof timeout === 'number' && Number.isFinite(timeout) && timeout > 0\n              ? Math.floor(timeout * 1000)\n              : 30_000;\n          const urlRes = await ext.sendCommand('get_url', {}, { timeout: timeoutMs });\n          const titleRes = await ext.sendCommand('get_title', {}, { timeout: timeoutMs });\n          const snapRes = await ext.sendCommand('snapshot', {}, { timeout: timeoutMs });\n          const url = urlRes.ok && urlRes.data ? String((urlRes.data as { url?: string }).url ?? '') : '';\n          const title =\n            titleRes.ok && titleRes.data ? String((titleRes.data as { title?: string }).title ?? '') : '';\n          let snapText = '';\n          if (snapRes.ok && snapRes.data) {\n            const nodes = (snapRes.data as { nodes?: Array<{ role?: string; name?: string }> }).nodes ?? [];\n            snapText = nodes.map((n) => `${n.role ?? '?'}: ${n.name ?? ''}`).join('\\n');\n            if (snapText.length > 8000) snapText = `${snapText.slice(0, 8000)}\\n... (truncated)`;\n          }\n          const text = `URL: ${url}\\nTitle: ${title}\\n${snapText ? `--- Page Snapshot ---\\n${snapText}` : ''}`;\n          return {\n            content: [{ type: 'text', text }],\n            details: { ok: true, mode: 'inspect', url, title },\n          };\n        }\n        const page = await deps.getPageForTask();\n        const ctx = buildContext(page, signal);\n        const result = await registry.execute('state', ctx, {});\n        // Augment with URL / title\n        const url = page.url();\n        const title = await page.title().catch(() => '');\n        const text = `URL: ${url}\\nTitle: ${title}\\n${result.text ?? ''}`;\n        return {\n          content: [{ type: 'text', text }],\n          details: { ok: true, mode: 'inspect', url, title },\n        };\n      }\n\n      // ─── close ──────────────────────────────────────────────────────────\n      if (mode === 'close') {\n        const taskId = deps.getTaskId();\n        await deps.getManager().ensureConnected();\n        await deps.getManager().closePage(taskId);\n        deps.notifyBrowserPageClosed?.(taskId);\n        return {\n          content: [{ type: 'text', text: 'Browser page closed.' }],\n          details: { ok: true, mode: 'close' },\n        };\n      }\n\n      // ─── command ────────────────────────────────────────────────────────\n      if (mode === 'command') {\n        if (!command) {\n          return {\n            content: [{ type: 'text', text: 'Missing `command` parameter for command mode.' }],\n            details: { ok: false, mode: 'command' },\n          };\n        }\n        const page = await deps.getPageForTask();\n        const ctx = buildContext(page, signal);\n        const args = cmdArgs ?? {};\n        const result = await registry.execute(command, ctx, args);\n        return formatResult(result);\n      }\n\n      // ─── pipeline ──────────────────────────────────────────────────────\n      if (mode === 'pipeline') {\n        if (!pipelineParams) {\n          return {\n            content: [{ type: 'text', text: 'Missing `pipeline` parameter for pipeline mode.' }],\n            details: { ok: false, mode: 'pipeline' },\n          };\n        }\n\n        // Resolve YAML source\n        let yamlSource = pipelineParams.yaml ?? pipelineParams.script ?? '';\n\n        if (!yamlSource && pipelineParams.path) {\n          try {\n            yamlSource = (await loadBrowserPipelineSource(pipelineParams.path)).source;\n          } catch (e) {\n            const msg = e instanceof Error ? e.message : String(e);\n            return {\n              content: [{ type: 'text', text: `Failed to read pipeline source: ${msg}` }],\n              details: { ok: false, mode: 'pipeline', error: msg },\n            };\n          }\n        }\n\n        if (!yamlSource) {\n          return {\n            content: [{ type: 'text', text: 'Pipeline mode requires `yaml`, `script`, or `path`.' }],\n            details: { ok: false, mode: 'pipeline' },\n          };\n        }\n\n        const pipelineArgs = (pipelineParams.args as Record<string, unknown>) ?? {};\n        const dryRun = pipelineParams.dryRun === true;\n        const page = await deps.getPageForTask();\n        const ctx = buildContext(page, signal);\n\n        // Use injected runner or lazy-load\n        if (deps.runPipeline) {\n          const result = await deps.runPipeline(yamlSource, pipelineArgs, ctx, dryRun);\n          return formatResult(result);\n        }\n\n        // Lazy import pipeline runner\n        try {\n          const { runBrowserPipeline } = await import('../../../../browser/pipeline/runner.js');\n          const result = await runBrowserPipeline(yamlSource, pipelineArgs, ctx, registry, dryRun);\n          return formatResult(result);\n        } catch (e) {\n          const msg = e instanceof Error ? e.message : String(e);\n          log.error({ err: e }, `Pipeline execution failed: ${msg}`);\n          return {\n            content: [{ type: 'text', text: `Pipeline failed: ${msg}` }],\n            details: { ok: false, mode: 'pipeline', error: msg },\n          };\n        }\n      }\n\n      return {\n        content: [{ type: 'text', text: `Unknown mode: ${mode}` }],\n        details: { ok: false },\n      };\n    },\n  };\n  return tool;\n}\n"],"mappings":"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"}

package/dist/src/agent/tools/search/registry.js

@@ -8,7 +8,7 @@ import { DuckDuckGoHtmlProvider } from "./providers/duckduckgo-html.js";
 import { SearXNGProvider } from "./providers/searxng.js";
 //#region src/agent/tools/search/registry.ts
 init_logger();
-const log = createLogger("web-search");
+const log = createLogger("Agent:WebSearch");
 var SearchProviderRegistry = class {
 	providers;
 	fallbackProvider;

package/dist/src/agent/tools/search/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","names":[],"sources":["../../../../../src/agent/tools/search/registry.ts"],"sourcesContent":["import { createLogger } from '../../../utils/logger.js';\nimport type { ResolvedWebSearchConfig, SearchProvider, SearchResult } from './types.js';\nimport { BraveProvider } from './providers/brave.js';\nimport { TavilyProvider } from './providers/tavily.js';\nimport { BingApiProvider } from './providers/bing-api.js';\nimport { BingHtmlProvider } from './providers/bing-html.js';\nimport { DuckDuckGoHtmlProvider } from './providers/duckduckgo-html.js';\nimport { SearXNGProvider } from './providers/searxng.js';\n\nconst log = createLogger('web-search');\n\nexport class SearchProviderRegistry {\n  private readonly providers: SearchProvider[];\n  private readonly fallbackProvider: SearchProvider;\n\n  constructor(config: ResolvedWebSearchConfig) {\n    this.providers = this.buildProviders(config);\n    this.fallbackProvider =\n      config.region === 'cn' ? new BingHtmlProvider() : new DuckDuckGoHtmlProvider();\n    log.debug(\n      { region: config.region, configuredCount: this.providers.filter((p) => p.isAvailable()).length },\n      'Web search registry ready',\n    );\n  }\n\n  private buildProviders(config: ResolvedWebSearchConfig): SearchProvider[] {\n    const list: SearchProvider[] = [];\n\n    for (const p of config.providers) {\n      if (p.disabled) continue;\n      switch (p.type) {\n        case 'brave':\n          list.push(new BraveProvider(p.apiKey ?? ''));\n          break;\n        case 'tavily':\n          list.push(new TavilyProvider(p.apiKey ?? ''));\n          break;\n        case 'bing':\n          list.push(new BingApiProvider(p.apiKey ?? ''));\n          break;\n        case 'searxng':\n          list.push(new SearXNGProvider(p.url ?? ''));\n          break;\n        default:\n          break;\n      }\n    }\n\n    return list;\n  }\n\n  hasConfiguredApiProvider(): boolean {\n    return this.providers.some((p) => p.isAvailable());\n  }\n\n  async search(\n    query: string,\n    count: number,\n    signal?: AbortSignal,\n  ): Promise<{ results: SearchResult[]; provider: string }> {\n    for (const provider of this.providers) {\n      if (!provider.isAvailable()) continue;\n      try {\n        const results = await provider.search(query, count, signal);\n        return { results, provider: provider.name };\n      } catch (err) {\n        log.debug({ provider: provider.name, err }, 'Search provider failed, trying next');\n      }\n    }\n\n    try {\n      const results = await this.fallbackProvider.search(query, count, signal);\n      return { results, provider: this.fallbackProvider.name };\n    } catch (err) {\n      log.warn({ err }, 'HTML fallback search failed');\n      return { results: [], provider: 'none' };\n    }\n  }\n}\n"],"mappings":";;;;;;;;;aAAwD;AASxD,MAAM,MAAM,aAAa,aAAa;AAEtC,IAAa,yBAAb,MAAoC;CAClC;CACA;CAEA,YAAY,QAAiC;AAC3C,OAAK,YAAY,KAAK,eAAe,OAAO;AAC5C,OAAK,mBACH,OAAO,WAAW,OAAO,IAAI,kBAAkB,GAAG,IAAI,wBAAwB;AAChF,MAAI,MACF;GAAE,QAAQ,OAAO;GAAQ,iBAAiB,KAAK,UAAU,QAAQ,MAAM,EAAE,aAAa,CAAC,CAAC;GAAQ,EAChG,4BACD;;CAGH,eAAuB,QAAmD;EACxE,MAAM,OAAyB,EAAE;AAEjC,OAAK,MAAM,KAAK,OAAO,WAAW;AAChC,OAAI,EAAE,SAAU;AAChB,WAAQ,EAAE,MAAV;IACE,KAAK;AACH,UAAK,KAAK,IAAI,cAAc,EAAE,UAAU,GAAG,CAAC;AAC5C;IACF,KAAK;AACH,UAAK,KAAK,IAAI,eAAe,EAAE,UAAU,GAAG,CAAC;AAC7C;IACF,KAAK;AACH,UAAK,KAAK,IAAI,gBAAgB,EAAE,UAAU,GAAG,CAAC;AAC9C;IACF,KAAK;AACH,UAAK,KAAK,IAAI,gBAAgB,EAAE,OAAO,GAAG,CAAC;AAC3C;IACF,QACE;;;AAIN,SAAO;;CAGT,2BAAoC;AAClC,SAAO,KAAK,UAAU,MAAM,MAAM,EAAE,aAAa,CAAC;;CAGpD,MAAM,OACJ,OACA,OACA,QACwD;AACxD,OAAK,MAAM,YAAY,KAAK,WAAW;AACrC,OAAI,CAAC,SAAS,aAAa,CAAE;AAC7B,OAAI;AAEF,WAAO;KAAE,SAAA,MADa,SAAS,OAAO,OAAO,OAAO,OAAO;KACzC,UAAU,SAAS;KAAM;YACpC,KAAK;AACZ,QAAI,MAAM;KAAE,UAAU,SAAS;KAAM;KAAK,EAAE,sCAAsC;;;AAItF,MAAI;AAEF,UAAO;IAAE,SAAA,MADa,KAAK,iBAAiB,OAAO,OAAO,OAAO,OAAO;IACtD,UAAU,KAAK,iBAAiB;IAAM;WACjD,KAAK;AACZ,OAAI,KAAK,EAAE,KAAK,EAAE,8BAA8B;AAChD,UAAO;IAAE,SAAS,EAAE;IAAE,UAAU;IAAQ"}
+{"version":3,"file":"registry.js","names":[],"sources":["../../../../../src/agent/tools/search/registry.ts"],"sourcesContent":["import { createLogger } from '../../../utils/logger.js';\nimport type { ResolvedWebSearchConfig, SearchProvider, SearchResult } from './types.js';\nimport { BraveProvider } from './providers/brave.js';\nimport { TavilyProvider } from './providers/tavily.js';\nimport { BingApiProvider } from './providers/bing-api.js';\nimport { BingHtmlProvider } from './providers/bing-html.js';\nimport { DuckDuckGoHtmlProvider } from './providers/duckduckgo-html.js';\nimport { SearXNGProvider } from './providers/searxng.js';\n\nconst log = createLogger('Agent:WebSearch');\n\nexport class SearchProviderRegistry {\n  private readonly providers: SearchProvider[];\n  private readonly fallbackProvider: SearchProvider;\n\n  constructor(config: ResolvedWebSearchConfig) {\n    this.providers = this.buildProviders(config);\n    this.fallbackProvider =\n      config.region === 'cn' ? new BingHtmlProvider() : new DuckDuckGoHtmlProvider();\n    log.debug(\n      { region: config.region, configuredCount: this.providers.filter((p) => p.isAvailable()).length },\n      'Web search registry ready',\n    );\n  }\n\n  private buildProviders(config: ResolvedWebSearchConfig): SearchProvider[] {\n    const list: SearchProvider[] = [];\n\n    for (const p of config.providers) {\n      if (p.disabled) continue;\n      switch (p.type) {\n        case 'brave':\n          list.push(new BraveProvider(p.apiKey ?? ''));\n          break;\n        case 'tavily':\n          list.push(new TavilyProvider(p.apiKey ?? ''));\n          break;\n        case 'bing':\n          list.push(new BingApiProvider(p.apiKey ?? ''));\n          break;\n        case 'searxng':\n          list.push(new SearXNGProvider(p.url ?? ''));\n          break;\n        default:\n          break;\n      }\n    }\n\n    return list;\n  }\n\n  hasConfiguredApiProvider(): boolean {\n    return this.providers.some((p) => p.isAvailable());\n  }\n\n  async search(\n    query: string,\n    count: number,\n    signal?: AbortSignal,\n  ): Promise<{ results: SearchResult[]; provider: string }> {\n    for (const provider of this.providers) {\n      if (!provider.isAvailable()) continue;\n      try {\n        const results = await provider.search(query, count, signal);\n        return { results, provider: provider.name };\n      } catch (err) {\n        log.debug({ provider: provider.name, err }, 'Search provider failed, trying next');\n      }\n    }\n\n    try {\n      const results = await this.fallbackProvider.search(query, count, signal);\n      return { results, provider: this.fallbackProvider.name };\n    } catch (err) {\n      log.warn({ err }, 'HTML fallback search failed');\n      return { results: [], provider: 'none' };\n    }\n  }\n}\n"],"mappings":";;;;;;;;;aAAwD;AASxD,MAAM,MAAM,aAAa,kBAAkB;AAE3C,IAAa,yBAAb,MAAoC;CAClC;CACA;CAEA,YAAY,QAAiC;AAC3C,OAAK,YAAY,KAAK,eAAe,OAAO;AAC5C,OAAK,mBACH,OAAO,WAAW,OAAO,IAAI,kBAAkB,GAAG,IAAI,wBAAwB;AAChF,MAAI,MACF;GAAE,QAAQ,OAAO;GAAQ,iBAAiB,KAAK,UAAU,QAAQ,MAAM,EAAE,aAAa,CAAC,CAAC;GAAQ,EAChG,4BACD;;CAGH,eAAuB,QAAmD;EACxE,MAAM,OAAyB,EAAE;AAEjC,OAAK,MAAM,KAAK,OAAO,WAAW;AAChC,OAAI,EAAE,SAAU;AAChB,WAAQ,EAAE,MAAV;IACE,KAAK;AACH,UAAK,KAAK,IAAI,cAAc,EAAE,UAAU,GAAG,CAAC;AAC5C;IACF,KAAK;AACH,UAAK,KAAK,IAAI,eAAe,EAAE,UAAU,GAAG,CAAC;AAC7C;IACF,KAAK;AACH,UAAK,KAAK,IAAI,gBAAgB,EAAE,UAAU,GAAG,CAAC;AAC9C;IACF,KAAK;AACH,UAAK,KAAK,IAAI,gBAAgB,EAAE,OAAO,GAAG,CAAC;AAC3C;IACF,QACE;;;AAIN,SAAO;;CAGT,2BAAoC;AAClC,SAAO,KAAK,UAAU,MAAM,MAAM,EAAE,aAAa,CAAC;;CAGpD,MAAM,OACJ,OACA,OACA,QACwD;AACxD,OAAK,MAAM,YAAY,KAAK,WAAW;AACrC,OAAI,CAAC,SAAS,aAAa,CAAE;AAC7B,OAAI;AAEF,WAAO;KAAE,SAAA,MADa,SAAS,OAAO,OAAO,OAAO,OAAO;KACzC,UAAU,SAAS;KAAM;YACpC,KAAK;AACZ,QAAI,MAAM;KAAE,UAAU,SAAS;KAAM;KAAK,EAAE,sCAAsC;;;AAItF,MAAI;AAEF,UAAO;IAAE,SAAA,MADa,KAAK,iBAAiB,OAAO,OAAO,OAAO,OAAO;IACtD,UAAU,KAAK,iBAAiB;IAAM;WACjD,KAAK;AACZ,OAAI,KAAK,EAAE,KAAK,EAAE,8BAA8B;AAChD,UAAO;IAAE,SAAS,EAAE;IAAE,UAAU;IAAQ"}

package/dist/src/agent/tools/session-search-tool.js

@@ -8,7 +8,7 @@ import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/session-search-tool.ts
 init_providers();
 init_logger();
-const log = createLogger("session-search-tool");
+const log = createLogger("Agent:SessionSearch");
 const MAX_SUMMARY_CHARS = 2e4;
 function resolveSummaryModel(getConfig) {
 	const envRef = process.env.XOPC_SESSION_SEARCH_MODEL?.trim();

package/dist/src/agent/tools/session-search-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-search-tool.js","names":[],"sources":["../../../../src/agent/tools/session-search-tool.ts"],"sourcesContent":["// Cross-session transcript search + optional LLM summaries\nimport { Type } from '@sinclair/typebox';\nimport type { AgentMessage, AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { complete, type UserMessage } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../config/schema.js';\nimport { getDefaultModelSync, resolveModel } from '../../providers/index.js';\nimport { getOrLoadSessionSearchIndex } from '../../session/search-index-cache.js';\nimport type { SessionStore } from '../../session/store.js';\nimport { readAgentMessageContent } from '../memory/agent-message-access.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('session-search-tool');\n\nconst MAX_SUMMARY_CHARS = 20_000;\n\nexport { invalidateSessionSearchIndexCache } from '../../session/search-index-cache.js';\n\nfunction resolveSummaryModel(getConfig?: () => Config | undefined) {\n  const envRef = process.env.XOPC_SESSION_SEARCH_MODEL?.trim();\n  const configRef = getConfig?.()?.agents?.defaults?.sessionSearch?.summaryModel?.trim();\n  const ref = envRef || configRef;\n  if (ref) {\n    try {\n      return resolveModel(ref);\n    } catch (err) {\n      log.warn({ err, ref }, 'session_search: summary model resolve failed, using fallback');\n    }\n  }\n  try {\n    return resolveModel('openai/gpt-4o-mini');\n  } catch {\n    const d = getDefaultModelSync(getConfig?.());\n    return resolveModel(d);\n  }\n}\n\nfunction extractTextFromContent(content: unknown): string {\n  if (typeof content === 'string') {\n    return content;\n  }\n  if (!Array.isArray(content)) {\n    return '';\n  }\n  const parts: string[] = [];\n  for (const item of content) {\n    if (typeof item !== 'object' || item === null || !('type' in item)) {\n      continue;\n    }\n    const c = item as { type?: string; text?: string };\n    if (c.type === 'text' && typeof c.text === 'string') {\n      parts.push(c.text);\n    }\n  }\n  return parts.join(' ');\n}\n\nfunction formatMessagesForSummary(messages: AgentMessage[]): string {\n  const lines: string[] = [];\n  let total = 0;\n  for (const msg of messages) {\n    const role = String(msg.role || 'unknown').toUpperCase();\n    const text = extractTextFromContent(readAgentMessageContent(msg));\n    const line = `${role}: ${text}`;\n    if (total + line.length > MAX_SUMMARY_CHARS) {\n      lines.push('… [truncated]');\n      break;\n    }\n    lines.push(line);\n    total += line.length + 1;\n  }\n  return lines.join('\\n\\n');\n}\n\nasync function summarizeSession(\n  messages: AgentMessage[],\n  query: string,\n  getConfig: (() => Config | undefined) | undefined,\n  signal: AbortSignal | undefined,\n  logMeta?: { summarizingSessionKey: string },\n): Promise<string> {\n  if (messages.length === 0) {\n    return 'No messages in session.';\n  }\n\n  const formatted = formatMessagesForSummary(messages);\n  const prompt = `Summarize this conversation for someone searching with: \"${query}\". Focus on facts, decisions, and names. Max 200 words. Use the same language as the conversation when possible.\n\nConversation:\n${formatted}`;\n\n  const userMsg: UserMessage = { role: 'user', content: prompt, timestamp: Date.now() };\n  const model = resolveSummaryModel(getConfig);\n\n  try {\n    const result = await complete(\n      model,\n      { messages: [userMsg] },\n      {\n        maxTokens: 400,\n        temperature: 0.15,\n        signal: signal as AbortSignal,\n      },\n    );\n\n    let text = '';\n    if (Array.isArray(result.content)) {\n      for (const c of result.content) {\n        if (c && typeof c === 'object' && (c as { type?: string }).type === 'text') {\n          text += String((c as { text?: string }).text || '');\n        }\n      }\n    }\n    return text.trim() || '[Empty summary]';\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    log.warn(\n      {\n        err,\n        summarizingSessionKey: logMeta?.summarizingSessionKey,\n        queryLength: query.length,\n        messageCount: messages.length,\n      },\n      `session_search LLM summarization failed${logMeta?.summarizingSessionKey ? ` (session ${logMeta.summarizingSessionKey})` : ''}: ${msg}`,\n    );\n    return `[Summarization failed: ${msg}]`;\n  }\n}\n\nconst SessionSearchSchema = Type.Object({\n  query: Type.Optional(\n    Type.String({ description: 'Keyword search over past sessions. Omit to list recent sessions.' }),\n  ),\n  roleFilter: Type.Optional(\n    Type.Union([\n      Type.Literal('user'),\n      Type.Literal('assistant'),\n      Type.Literal('system'),\n      Type.Literal('tool'),\n      Type.Literal('toolResult'),\n    ]),\n  ),\n  limit: Type.Optional(Type.Number({ minimum: 1, maximum: 15 })),\n  excludeSessionKey: Type.Optional(\n    Type.String({ description: 'Exclude this session key from keyword results (default: current chat).' }),\n  ),\n});\n\nexport interface SessionSearchToolDeps {\n  getSessionStore: () => SessionStore;\n  getConfig?: () => Config | undefined;\n  getCurrentSessionKey?: () => string | undefined;\n}\n\ntype SessionSearchParams = {\n  query?: string;\n  roleFilter?: 'user' | 'assistant' | 'system' | 'tool' | 'toolResult';\n  limit?: number;\n  excludeSessionKey?: string;\n};\n\nexport function createSessionSearchTool(deps: SessionSearchToolDeps): AgentTool {\n  return {\n    name: 'session_search',\n    label: 'Session search',\n    description:\n      'Search other chat sessions by keywords and get short summaries, or omit `query` to list recent sessions (no LLM cost). Uses the same session store as the gateway. Narrow with roleFilter if needed.',\n    parameters: SessionSearchSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      const p = params as SessionSearchParams;\n      const store = deps.getSessionStore();\n      const limit = Math.min(15, Math.max(1, p.limit ?? 5));\n      const query = p.query?.trim() ?? '';\n\n      try {\n        if (!query) {\n          const listed = await store.list({\n            limit: limit + 5,\n            sortBy: 'updatedAt',\n            sortOrder: 'desc',\n          });\n          const items = listed.items.slice(0, limit).map((s) => ({\n            key: s.key,\n            name: s.name,\n            updatedAt: s.updatedAt,\n            messageCount: s.messageCount,\n            sourceChannel: s.sourceChannel,\n          }));\n\n          return {\n            content: [\n              {\n                type: 'text',\n                text: JSON.stringify(\n                  { success: true, mode: 'recent', results: items, total: listed.total },\n                  null,\n                  2,\n                ),\n              },\n            ],\n            details: { mode: 'recent', items },\n          };\n        }\n\n        const sessionsRoot = store.getSessionsRoot();\n        const index = await getOrLoadSessionSearchIndex(sessionsRoot);\n        let matches = index.search(query, 80);\n\n        const exclude = p.excludeSessionKey?.trim() || deps.getCurrentSessionKey?.() || '';\n        if (exclude) {\n          matches = matches.filter((m) => m.key !== exclude);\n        }\n\n        const top = matches.slice(0, limit);\n\n        const summaries = await Promise.all(\n          top.map(async ({ key, score }) => {\n            let messages = index.getSessionMessages(key);\n            if (messages.length === 0) {\n              messages = await store.load(key);\n            }\n\n            if (p.roleFilter) {\n              messages = messages.filter((m) => m.role === p.roleFilter);\n            }\n\n            const summary = await summarizeSession(messages, query, deps.getConfig, signal, {\n              summarizingSessionKey: key,\n            });\n            return { sessionKey: key, score, summary };\n          }),\n        );\n\n        return {\n          content: [\n            {\n              type: 'text',\n              text: JSON.stringify(\n                {\n                  success: true,\n                  mode: 'keyword',\n                  query,\n                  results: summaries,\n                  count: summaries.length,\n                },\n                null,\n                2,\n              ),\n            },\n          ],\n          details: { query, summaries },\n        };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `session_search error: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as any;\n}\n"],"mappings":";;;;;;;;gBAM6E;aAIxB;AAErD,MAAM,MAAM,aAAa,sBAAsB;AAE/C,MAAM,oBAAoB;AAI1B,SAAS,oBAAoB,WAAsC;CACjE,MAAM,SAAS,QAAQ,IAAI,2BAA2B,MAAM;CAC5D,MAAM,YAAY,aAAa,EAAE,QAAQ,UAAU,eAAe,cAAc,MAAM;CACtF,MAAM,MAAM,UAAU;AACtB,KAAI,IACF,KAAI;AACF,SAAO,aAAa,IAAI;UACjB,KAAK;AACZ,MAAI,KAAK;GAAE;GAAK;GAAK,EAAE,+DAA+D;;AAG1F,KAAI;AACF,SAAO,aAAa,qBAAqB;SACnC;AAEN,SAAO,aADG,oBAAoB,aAAa,CACtB,CAAC;;;AAI1B,SAAS,uBAAuB,SAA0B;AACxD,KAAI,OAAO,YAAY,SACrB,QAAO;AAET,KAAI,CAAC,MAAM,QAAQ,QAAQ,CACzB,QAAO;CAET,MAAM,QAAkB,EAAE;AAC1B,MAAK,MAAM,QAAQ,SAAS;AAC1B,MAAI,OAAO,SAAS,YAAY,SAAS,QAAQ,EAAE,UAAU,MAC3D;EAEF,MAAM,IAAI;AACV,MAAI,EAAE,SAAS,UAAU,OAAO,EAAE,SAAS,SACzC,OAAM,KAAK,EAAE,KAAK;;AAGtB,QAAO,MAAM,KAAK,IAAI;;AAGxB,SAAS,yBAAyB,UAAkC;CAClE,MAAM,QAAkB,EAAE;CAC1B,IAAI,QAAQ;AACZ,MAAK,MAAM,OAAO,UAAU;EAG1B,MAAM,OAAO,GAFA,OAAO,IAAI,QAAQ,UAAU,CAAC,aAEvB,CAAC,IADR,uBAAuB,wBAAwB,IAAI,CACnC;AAC7B,MAAI,QAAQ,KAAK,SAAS,mBAAmB;AAC3C,SAAM,KAAK,gBAAgB;AAC3B;;AAEF,QAAM,KAAK,KAAK;AAChB,WAAS,KAAK,SAAS;;AAEzB,QAAO,MAAM,KAAK,OAAO;;AAG3B,eAAe,iBACb,UACA,OACA,WACA,QACA,SACiB;AACjB,KAAI,SAAS,WAAW,EACtB,QAAO;CAST,MAAM,UAAuB;EAAE,MAAM;EAAQ,SAAS,4DALqB,MAAM;;;EAD/D,yBAAyB,SAIlC;EAEqD,WAAW,KAAK,KAAK;EAAE;CACrF,MAAM,QAAQ,oBAAoB,UAAU;AAE5C,KAAI;EACF,MAAM,SAAS,MAAM,SACnB,OACA,EAAE,UAAU,CAAC,QAAQ,EAAE,EACvB;GACE,WAAW;GACX,aAAa;GACL;GACT,CACF;EAED,IAAI,OAAO;AACX,MAAI,MAAM,QAAQ,OAAO,QAAQ;QAC1B,MAAM,KAAK,OAAO,QACrB,KAAI,KAAK,OAAO,MAAM,YAAa,EAAwB,SAAS,OAClE,SAAQ,OAAQ,EAAwB,QAAQ,GAAG;;AAIzD,SAAO,KAAK,MAAM,IAAI;UACf,KAAK;EACZ,MAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAC5D,MAAI,KACF;GACE;GACA,uBAAuB,SAAS;GAChC,aAAa,MAAM;GACnB,cAAc,SAAS;GACxB,EACD,0CAA0C,SAAS,wBAAwB,aAAa,QAAQ,sBAAsB,KAAK,GAAG,IAAI,MACnI;AACD,SAAO,0BAA0B,IAAI;;;AAIzC,MAAM,sBAAsB,KAAK,OAAO;CACtC,OAAO,KAAK,SACV,KAAK,OAAO,EAAE,aAAa,oEAAoE,CAAC,CACjG;CACD,YAAY,KAAK,SACf,KAAK,MAAM;EACT,KAAK,QAAQ,OAAO;EACpB,KAAK,QAAQ,YAAY;EACzB,KAAK,QAAQ,SAAS;EACtB,KAAK,QAAQ,OAAO;EACpB,KAAK,QAAQ,aAAa;EAC3B,CAAC,CACH;CACD,OAAO,KAAK,SAAS,KAAK,OAAO;EAAE,SAAS;EAAG,SAAS;EAAI,CAAC,CAAC;CAC9D,mBAAmB,KAAK,SACtB,KAAK,OAAO,EAAE,aAAa,0EAA0E,CAAC,CACvG;CACF,CAAC;AAeF,SAAgB,wBAAwB,MAAwC;AAC9E,QAAO;EACL,MAAM;EACN,OAAO;EACP,aACE;EACF,YAAY;EAEZ,MAAM,QACJ,aACA,QACA,QAC8B;GAC9B,MAAM,IAAI;GACV,MAAM,QAAQ,KAAK,iBAAiB;GACpC,MAAM,QAAQ,KAAK,IAAI,IAAI,KAAK,IAAI,GAAG,EAAE,SAAS,EAAE,CAAC;GACrD,MAAM,QAAQ,EAAE,OAAO,MAAM,IAAI;AAEjC,OAAI;AACF,QAAI,CAAC,OAAO;KACV,MAAM,SAAS,MAAM,MAAM,KAAK;MAC9B,OAAO,QAAQ;MACf,QAAQ;MACR,WAAW;MACZ,CAAC;KACF,MAAM,QAAQ,OAAO,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,OAAO;MACrD,KAAK,EAAE;MACP,MAAM,EAAE;MACR,WAAW,EAAE;MACb,cAAc,EAAE;MAChB,eAAe,EAAE;MAClB,EAAE;AAEH,YAAO;MACL,SAAS,CACP;OACE,MAAM;OACN,MAAM,KAAK,UACT;QAAE,SAAS;QAAM,MAAM;QAAU,SAAS;QAAO,OAAO,OAAO;QAAO,EACtE,MACA,EACD;OACF,CACF;MACD,SAAS;OAAE,MAAM;OAAU;OAAO;MACnC;;IAIH,MAAM,QAAQ,MAAM,4BADC,MAAM,iBACiC,CAAC;IAC7D,IAAI,UAAU,MAAM,OAAO,OAAO,GAAG;IAErC,MAAM,UAAU,EAAE,mBAAmB,MAAM,IAAI,KAAK,wBAAwB,IAAI;AAChF,QAAI,QACF,WAAU,QAAQ,QAAQ,MAAM,EAAE,QAAQ,QAAQ;IAGpD,MAAM,MAAM,QAAQ,MAAM,GAAG,MAAM;IAEnC,MAAM,YAAY,MAAM,QAAQ,IAC9B,IAAI,IAAI,OAAO,EAAE,KAAK,YAAY;KAChC,IAAI,WAAW,MAAM,mBAAmB,IAAI;AAC5C,SAAI,SAAS,WAAW,EACtB,YAAW,MAAM,MAAM,KAAK,IAAI;AAGlC,SAAI,EAAE,WACJ,YAAW,SAAS,QAAQ,MAAM,EAAE,SAAS,EAAE,WAAW;AAM5D,YAAO;MAAE,YAAY;MAAK;MAAO,SAAA,MAHX,iBAAiB,UAAU,OAAO,KAAK,WAAW,QAAQ,EAC9E,uBAAuB,KACxB,CAAC;MACwC;MAC1C,CACH;AAED,WAAO;KACL,SAAS,CACP;MACE,MAAM;MACN,MAAM,KAAK,UACT;OACE,SAAS;OACT,MAAM;OACN;OACA,SAAS;OACT,OAAO,UAAU;OAClB,EACD,MACA,EACD;MACF,CACF;KACD,SAAS;MAAE;MAAO;MAAW;KAC9B;YACM,KAAK;IACZ,MAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAChE,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,yBAAyB;MAAW,CAAC;KACrE,SAAS,EAAE,OAAO,SAAS;KAC5B;;;EAGN"}
+{"version":3,"file":"session-search-tool.js","names":[],"sources":["../../../../src/agent/tools/session-search-tool.ts"],"sourcesContent":["// Cross-session transcript search + optional LLM summaries\nimport { Type } from '@sinclair/typebox';\nimport type { AgentMessage, AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { complete, type UserMessage } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../config/schema.js';\nimport { getDefaultModelSync, resolveModel } from '../../providers/index.js';\nimport { getOrLoadSessionSearchIndex } from '../../session/search-index-cache.js';\nimport type { SessionStore } from '../../session/store.js';\nimport { readAgentMessageContent } from '../memory/agent-message-access.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('Agent:SessionSearch');\n\nconst MAX_SUMMARY_CHARS = 20_000;\n\nexport { invalidateSessionSearchIndexCache } from '../../session/search-index-cache.js';\n\nfunction resolveSummaryModel(getConfig?: () => Config | undefined) {\n  const envRef = process.env.XOPC_SESSION_SEARCH_MODEL?.trim();\n  const configRef = getConfig?.()?.agents?.defaults?.sessionSearch?.summaryModel?.trim();\n  const ref = envRef || configRef;\n  if (ref) {\n    try {\n      return resolveModel(ref);\n    } catch (err) {\n      log.warn({ err, ref }, 'session_search: summary model resolve failed, using fallback');\n    }\n  }\n  try {\n    return resolveModel('openai/gpt-4o-mini');\n  } catch {\n    const d = getDefaultModelSync(getConfig?.());\n    return resolveModel(d);\n  }\n}\n\nfunction extractTextFromContent(content: unknown): string {\n  if (typeof content === 'string') {\n    return content;\n  }\n  if (!Array.isArray(content)) {\n    return '';\n  }\n  const parts: string[] = [];\n  for (const item of content) {\n    if (typeof item !== 'object' || item === null || !('type' in item)) {\n      continue;\n    }\n    const c = item as { type?: string; text?: string };\n    if (c.type === 'text' && typeof c.text === 'string') {\n      parts.push(c.text);\n    }\n  }\n  return parts.join(' ');\n}\n\nfunction formatMessagesForSummary(messages: AgentMessage[]): string {\n  const lines: string[] = [];\n  let total = 0;\n  for (const msg of messages) {\n    const role = String(msg.role || 'unknown').toUpperCase();\n    const text = extractTextFromContent(readAgentMessageContent(msg));\n    const line = `${role}: ${text}`;\n    if (total + line.length > MAX_SUMMARY_CHARS) {\n      lines.push('… [truncated]');\n      break;\n    }\n    lines.push(line);\n    total += line.length + 1;\n  }\n  return lines.join('\\n\\n');\n}\n\nasync function summarizeSession(\n  messages: AgentMessage[],\n  query: string,\n  getConfig: (() => Config | undefined) | undefined,\n  signal: AbortSignal | undefined,\n  logMeta?: { summarizingSessionKey: string },\n): Promise<string> {\n  if (messages.length === 0) {\n    return 'No messages in session.';\n  }\n\n  const formatted = formatMessagesForSummary(messages);\n  const prompt = `Summarize this conversation for someone searching with: \"${query}\". Focus on facts, decisions, and names. Max 200 words. Use the same language as the conversation when possible.\n\nConversation:\n${formatted}`;\n\n  const userMsg: UserMessage = { role: 'user', content: prompt, timestamp: Date.now() };\n  const model = resolveSummaryModel(getConfig);\n\n  try {\n    const result = await complete(\n      model,\n      { messages: [userMsg] },\n      {\n        maxTokens: 400,\n        temperature: 0.15,\n        signal: signal as AbortSignal,\n      },\n    );\n\n    let text = '';\n    if (Array.isArray(result.content)) {\n      for (const c of result.content) {\n        if (c && typeof c === 'object' && (c as { type?: string }).type === 'text') {\n          text += String((c as { text?: string }).text || '');\n        }\n      }\n    }\n    return text.trim() || '[Empty summary]';\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    log.warn(\n      {\n        err,\n        summarizingSessionKey: logMeta?.summarizingSessionKey,\n        queryLength: query.length,\n        messageCount: messages.length,\n      },\n      `session_search LLM summarization failed${logMeta?.summarizingSessionKey ? ` (session ${logMeta.summarizingSessionKey})` : ''}: ${msg}`,\n    );\n    return `[Summarization failed: ${msg}]`;\n  }\n}\n\nconst SessionSearchSchema = Type.Object({\n  query: Type.Optional(\n    Type.String({ description: 'Keyword search over past sessions. Omit to list recent sessions.' }),\n  ),\n  roleFilter: Type.Optional(\n    Type.Union([\n      Type.Literal('user'),\n      Type.Literal('assistant'),\n      Type.Literal('system'),\n      Type.Literal('tool'),\n      Type.Literal('toolResult'),\n    ]),\n  ),\n  limit: Type.Optional(Type.Number({ minimum: 1, maximum: 15 })),\n  excludeSessionKey: Type.Optional(\n    Type.String({ description: 'Exclude this session key from keyword results (default: current chat).' }),\n  ),\n});\n\nexport interface SessionSearchToolDeps {\n  getSessionStore: () => SessionStore;\n  getConfig?: () => Config | undefined;\n  getCurrentSessionKey?: () => string | undefined;\n}\n\ntype SessionSearchParams = {\n  query?: string;\n  roleFilter?: 'user' | 'assistant' | 'system' | 'tool' | 'toolResult';\n  limit?: number;\n  excludeSessionKey?: string;\n};\n\nexport function createSessionSearchTool(deps: SessionSearchToolDeps): AgentTool {\n  return {\n    name: 'session_search',\n    label: 'Session search',\n    description:\n      'Search other chat sessions by keywords and get short summaries, or omit `query` to list recent sessions (no LLM cost). Uses the same session store as the gateway. Narrow with roleFilter if needed.',\n    parameters: SessionSearchSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      const p = params as SessionSearchParams;\n      const store = deps.getSessionStore();\n      const limit = Math.min(15, Math.max(1, p.limit ?? 5));\n      const query = p.query?.trim() ?? '';\n\n      try {\n        if (!query) {\n          const listed = await store.list({\n            limit: limit + 5,\n            sortBy: 'updatedAt',\n            sortOrder: 'desc',\n          });\n          const items = listed.items.slice(0, limit).map((s) => ({\n            key: s.key,\n            name: s.name,\n            updatedAt: s.updatedAt,\n            messageCount: s.messageCount,\n            sourceChannel: s.sourceChannel,\n          }));\n\n          return {\n            content: [\n              {\n                type: 'text',\n                text: JSON.stringify(\n                  { success: true, mode: 'recent', results: items, total: listed.total },\n                  null,\n                  2,\n                ),\n              },\n            ],\n            details: { mode: 'recent', items },\n          };\n        }\n\n        const sessionsRoot = store.getSessionsRoot();\n        const index = await getOrLoadSessionSearchIndex(sessionsRoot);\n        let matches = index.search(query, 80);\n\n        const exclude = p.excludeSessionKey?.trim() || deps.getCurrentSessionKey?.() || '';\n        if (exclude) {\n          matches = matches.filter((m) => m.key !== exclude);\n        }\n\n        const top = matches.slice(0, limit);\n\n        const summaries = await Promise.all(\n          top.map(async ({ key, score }) => {\n            let messages = index.getSessionMessages(key);\n            if (messages.length === 0) {\n              messages = await store.load(key);\n            }\n\n            if (p.roleFilter) {\n              messages = messages.filter((m) => m.role === p.roleFilter);\n            }\n\n            const summary = await summarizeSession(messages, query, deps.getConfig, signal, {\n              summarizingSessionKey: key,\n            });\n            return { sessionKey: key, score, summary };\n          }),\n        );\n\n        return {\n          content: [\n            {\n              type: 'text',\n              text: JSON.stringify(\n                {\n                  success: true,\n                  mode: 'keyword',\n                  query,\n                  results: summaries,\n                  count: summaries.length,\n                },\n                null,\n                2,\n              ),\n            },\n          ],\n          details: { query, summaries },\n        };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `session_search error: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as any;\n}\n"],"mappings":"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"}

package/dist/src/agent/tools/workflow-tool.js

@@ -9,7 +9,7 @@ import { Type } from "@sinclair/typebox";
 * `workflow` — starts a persisted workflow run in a dedicated chat session.
 */
 init_logger();
-const log = createLogger("workflow-tool");
+const log = createLogger("Agent:WorkflowTool");
 const WorkflowToolSchema = Type.Object({
 	name: Type.Optional(Type.String({ description: "Name of a saved workflow to run. Either `name` or `script` is required. Use `name` whenever the user references a known workflow (built-in or in ~/.xopc/workflows/)." })),
 	script: Type.Optional(Type.String({ description: ["Raw JavaScript workflow script (no Markdown fences, no TypeScript syntax). Ignored when `name` is set.", "First statement: export const meta = { name: 'snake_case', description: 'short, human-readable' }."].join(" ") })),

package/dist/src/agent/tools/workflow-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-tool.js","names":[],"sources":["../../../../src/agent/tools/workflow-tool.ts"],"sourcesContent":["/**\n * `workflow` — starts a persisted workflow run in a dedicated chat session.\n */\n\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\n\nimport { extractProfileAgentId } from '../../config/agent-profile.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { parseWorkflowScript } from '../workflow/index.js';\nimport type { WorkflowCatalog } from '../workflow/catalog.js';\nimport type {\n  StartWorkflowRunServiceParams,\n  WorkflowRunServiceResult,\n} from '../../workflows/service/workflow-run-service.types.js';\n\nconst log = createLogger('workflow-tool');\n\nconst WorkflowToolSchema = Type.Object({\n  name: Type.Optional(\n    Type.String({\n      description:\n        'Name of a saved workflow to run. Either `name` or `script` is required. ' +\n        'Use `name` whenever the user references a known workflow (built-in or in ~/.xopc/workflows/).',\n    }),\n  ),\n  script: Type.Optional(\n    Type.String({\n      description: [\n        'Raw JavaScript workflow script (no Markdown fences, no TypeScript syntax). Ignored when `name` is set.',\n        \"First statement: export const meta = { name: 'snake_case', description: 'short, human-readable' }.\",\n      ].join(' '),\n    }),\n  ),\n  args: Type.Optional(\n    Type.Any({\n      description: 'Optional JSON value passed as workflow input payload.',\n    }),\n  ),\n  goal: Type.Optional(\n    Type.String({\n      description: 'Optional goal or task description for this workflow run (defaults to user intent in chat).',\n    }),\n  ),\n});\n\nexport type WorkflowToolInput = {\n  name?: string;\n  script?: string;\n  args?: unknown;\n  goal?: string;\n};\n\nexport interface WorkflowToolDeps {\n  catalog: WorkflowCatalog;\n  getCurrentSessionKey?: () => string | undefined;\n  getConfig: () => import('../../config/schema.js').Config | undefined;\n  startWorkflowRun?: (params: StartWorkflowRunServiceParams) => Promise<WorkflowRunServiceResult>;\n}\n\nexport function createWorkflowTool(deps: WorkflowToolDeps): AgentTool {\n  return {\n    name: 'workflow',\n    label: '◆ Workflow',\n    description: [\n      'Start a multi-agent workflow run in its own chat session.',\n      'Use `name` for catalog workflows, or `script` for an inline workflow (saved under meta.name before run).',\n      'Returns immediately with runId + sessionKey — track progress in the linked chat session.',\n    ].join(' '),\n    parameters: WorkflowToolSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: WorkflowToolInput,\n    ): Promise<AgentToolResult<{ runId: string; sessionKey: string } | { error: string }>> {\n      if (!deps.startWorkflowRun) {\n        return {\n          content: [{ type: 'text', text: 'workflow: gateway workflow runs are not available in this context' }],\n          details: { error: 'workflow_run_unavailable' },\n        };\n      }\n\n      let definitionId: string;\n      try {\n        definitionId = resolveDefinitionId(params, deps.catalog);\n      } catch (e) {\n        const message = e instanceof Error ? e.message : String(e);\n        return {\n          content: [{ type: 'text', text: `workflow: ${message}` }],\n          details: { error: message },\n        };\n      }\n\n      const config = deps.getConfig();\n      const parentSessionKey = deps.getCurrentSessionKey?.()?.trim();\n      const agentId = extractProfileAgentId(parentSessionKey, config);\n\n      const goal = params.goal?.trim() || '';\n      const source = parentSessionKey\n        ? ({ kind: 'chat' as const, sessionKey: parentSessionKey })\n        : ({ kind: 'api' as const });\n\n      try {\n        const result = await deps.startWorkflowRun({\n          agentId,\n          definitionId,\n          goal,\n          input: params.args,\n          parentSessionKey,\n          source,\n        });\n\n        if (result.ok === false) {\n          return {\n            content: [{ type: 'text', text: `workflow: ${result.message}` }],\n            details: { error: result.message },\n          };\n        }\n\n        const summary = goal\n          ? `Started workflow \\`${definitionId}\\` (run ${result.runId}). Open chat session to track progress and continue.`\n          : `Started workflow \\`${definitionId}\\` (run ${result.runId}). Open the workflow chat session to track progress.`;\n\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `${summary}\\n\\nsessionKey: ${result.sessionKey}`,\n            },\n          ],\n          details: {\n            runId: result.runId,\n            sessionKey: result.sessionKey,\n            definitionId,\n            parentSessionKey: parentSessionKey ?? null,\n          } as { runId: string; sessionKey: string },\n        };\n      } catch (e) {\n        const message = e instanceof Error ? e.message : String(e);\n        log.warn({ err: e, errorMessage: message, workflow: definitionId }, `workflow start failed: ${message}`);\n        return {\n          content: [{ type: 'text', text: `workflow: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as unknown as AgentTool;\n}\n\nfunction resolveDefinitionId(params: WorkflowToolInput, catalog: WorkflowCatalog): string {\n  const name = params.name?.trim();\n  if (name) {\n    catalog.load(name);\n    return name;\n  }\n  if (!params.script?.trim()) {\n    throw new Error('either `name` or `script` is required.');\n  }\n  const script = normalizeScript(params.script);\n  const meta = parseWorkflowScript(script).meta;\n  catalog.save(meta.name, script);\n  return meta.name;\n}\n\nfunction normalizeScript(script: string): string {\n  let text = script.trim();\n  const fence = text.match(/^```(?:js|javascript)?\\s*\\n([\\s\\S]*?)\\n```$/i);\n  if (fence) text = fence[1].trim();\n  return text;\n}\n"],"mappings":"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"}
+{"version":3,"file":"workflow-tool.js","names":[],"sources":["../../../../src/agent/tools/workflow-tool.ts"],"sourcesContent":["/**\n * `workflow` — starts a persisted workflow run in a dedicated chat session.\n */\n\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\n\nimport { extractProfileAgentId } from '../../config/agent-profile.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { parseWorkflowScript } from '../workflow/index.js';\nimport type { WorkflowCatalog } from '../workflow/catalog.js';\nimport type {\n  StartWorkflowRunServiceParams,\n  WorkflowRunServiceResult,\n} from '../../workflows/service/workflow-run-service.types.js';\n\nconst log = createLogger('Agent:WorkflowTool');\n\nconst WorkflowToolSchema = Type.Object({\n  name: Type.Optional(\n    Type.String({\n      description:\n        'Name of a saved workflow to run. Either `name` or `script` is required. ' +\n        'Use `name` whenever the user references a known workflow (built-in or in ~/.xopc/workflows/).',\n    }),\n  ),\n  script: Type.Optional(\n    Type.String({\n      description: [\n        'Raw JavaScript workflow script (no Markdown fences, no TypeScript syntax). Ignored when `name` is set.',\n        \"First statement: export const meta = { name: 'snake_case', description: 'short, human-readable' }.\",\n      ].join(' '),\n    }),\n  ),\n  args: Type.Optional(\n    Type.Any({\n      description: 'Optional JSON value passed as workflow input payload.',\n    }),\n  ),\n  goal: Type.Optional(\n    Type.String({\n      description: 'Optional goal or task description for this workflow run (defaults to user intent in chat).',\n    }),\n  ),\n});\n\nexport type WorkflowToolInput = {\n  name?: string;\n  script?: string;\n  args?: unknown;\n  goal?: string;\n};\n\nexport interface WorkflowToolDeps {\n  catalog: WorkflowCatalog;\n  getCurrentSessionKey?: () => string | undefined;\n  getConfig: () => import('../../config/schema.js').Config | undefined;\n  startWorkflowRun?: (params: StartWorkflowRunServiceParams) => Promise<WorkflowRunServiceResult>;\n}\n\nexport function createWorkflowTool(deps: WorkflowToolDeps): AgentTool {\n  return {\n    name: 'workflow',\n    label: '◆ Workflow',\n    description: [\n      'Start a multi-agent workflow run in its own chat session.',\n      'Use `name` for catalog workflows, or `script` for an inline workflow (saved under meta.name before run).',\n      'Returns immediately with runId + sessionKey — track progress in the linked chat session.',\n    ].join(' '),\n    parameters: WorkflowToolSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: WorkflowToolInput,\n    ): Promise<AgentToolResult<{ runId: string; sessionKey: string } | { error: string }>> {\n      if (!deps.startWorkflowRun) {\n        return {\n          content: [{ type: 'text', text: 'workflow: gateway workflow runs are not available in this context' }],\n          details: { error: 'workflow_run_unavailable' },\n        };\n      }\n\n      let definitionId: string;\n      try {\n        definitionId = resolveDefinitionId(params, deps.catalog);\n      } catch (e) {\n        const message = e instanceof Error ? e.message : String(e);\n        return {\n          content: [{ type: 'text', text: `workflow: ${message}` }],\n          details: { error: message },\n        };\n      }\n\n      const config = deps.getConfig();\n      const parentSessionKey = deps.getCurrentSessionKey?.()?.trim();\n      const agentId = extractProfileAgentId(parentSessionKey, config);\n\n      const goal = params.goal?.trim() || '';\n      const source = parentSessionKey\n        ? ({ kind: 'chat' as const, sessionKey: parentSessionKey })\n        : ({ kind: 'api' as const });\n\n      try {\n        const result = await deps.startWorkflowRun({\n          agentId,\n          definitionId,\n          goal,\n          input: params.args,\n          parentSessionKey,\n          source,\n        });\n\n        if (result.ok === false) {\n          return {\n            content: [{ type: 'text', text: `workflow: ${result.message}` }],\n            details: { error: result.message },\n          };\n        }\n\n        const summary = goal\n          ? `Started workflow \\`${definitionId}\\` (run ${result.runId}). Open chat session to track progress and continue.`\n          : `Started workflow \\`${definitionId}\\` (run ${result.runId}). Open the workflow chat session to track progress.`;\n\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `${summary}\\n\\nsessionKey: ${result.sessionKey}`,\n            },\n          ],\n          details: {\n            runId: result.runId,\n            sessionKey: result.sessionKey,\n            definitionId,\n            parentSessionKey: parentSessionKey ?? null,\n          } as { runId: string; sessionKey: string },\n        };\n      } catch (e) {\n        const message = e instanceof Error ? e.message : String(e);\n        log.warn({ err: e, errorMessage: message, workflow: definitionId }, `workflow start failed: ${message}`);\n        return {\n          content: [{ type: 'text', text: `workflow: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as unknown as AgentTool;\n}\n\nfunction resolveDefinitionId(params: WorkflowToolInput, catalog: WorkflowCatalog): string {\n  const name = params.name?.trim();\n  if (name) {\n    catalog.load(name);\n    return name;\n  }\n  if (!params.script?.trim()) {\n    throw new Error('either `name` or `script` is required.');\n  }\n  const script = normalizeScript(params.script);\n  const meta = parseWorkflowScript(script).meta;\n  catalog.save(meta.name, script);\n  return meta.name;\n}\n\nfunction normalizeScript(script: string): string {\n  let text = script.trim();\n  const fence = text.match(/^```(?:js|javascript)?\\s*\\n([\\s\\S]*?)\\n```$/i);\n  if (fence) text = fence[1].trim();\n  return text;\n}\n"],"mappings":"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"}

package/dist/src/agent/workflow/progress-broker.js

@@ -3,7 +3,7 @@ import { init_logger } from "../../utils/logger.js";
 import { renderWorkflowText } from "./snapshot.js";
 //#region src/agent/workflow/progress-broker.ts
 init_logger();
-const log = createLogger("workflow-progress-broker");
+const log = createLogger("Agent:WorkflowProgress");
 const WORKFLOW_TOOL_NAME = "workflow";
 const RENDER_MAX_AGENTS_PER_PHASE = 4;
 const RENDER_MAX_LOGS = 2;