@xopcai/xopc 0.0.82 → 0.0.83

package/dist/src/agent/orchestration/agent-orchestrator.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-orchestrator.js","names":[],"sources":["../../../../src/agent/orchestration/agent-orchestrator.ts"],"sourcesContent":["/**\n * Agent Orchestrator - Coordinates Agent execution flow\n *\n * Manages the complete agent execution pipeline from message processing\n * to response generation.\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport type { Config } from '../../config/schema.js';\nimport type { InboundMessage } from '../../infra/bus/index.js';\nimport type { SessionConfigStore, SessionStore } from '../../session/index.js';\nimport { resolveEffectiveThinkingLevel } from '../../session/thinking-resolve.js';\nimport type { ThinkLevel } from '../transcript/thinking-types.js';\nimport type { ModelManager } from '../models/index.js';\nimport type { SessionContext } from '../session/session-context.js';\nimport type { AgentEventHandler } from './agent-event-handler.js';\nimport type { FeedbackCoordinator } from '../feedback/feedback-coordinator.js';\nimport type { AgentManager } from '../agent-manager.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { extractAgentUserPlainText } from '../memory/user-message-text.js';\nimport { abortEmbeddedRun } from '../embedded/runs.js';\nimport { runEmbeddedTurnForSession } from '../embedded/run-for-session.js';\nimport type { EmbeddedStreamEvent } from '../embedded/types.js';\nimport {\n  persistInboundAttachmentsToWorkspace,\n  formatInboundFileTextBlock,\n} from '../../channels/attachments/inbound-persist.js';\nimport { expandAtFileMentionsInPlainText } from '../context/expand-at-file-mentions.js';\nimport { resolveInboundImageContentParts } from '../image/inbound-image-handling.js';\nimport {\n  DREAMING_SWEEP_TOKEN,\n  DREAMING_LIGHT_SWEEP_TOKEN,\n  DREAMING_REM_SWEEP_TOKEN,\n} from '../memory/dreaming/constants.js';\nimport { resolveDreamingConfig } from '../memory/dreaming/config.js';\nimport { runDreamingDeepPromotion } from '../memory/dreaming/deep-promotion.js';\nimport { appendDreamingEvent, type DreamingEvent } from '../memory/dreaming/events.js';\nimport { runLightSweep } from '../memory/dreaming/light-sweep.js';\nimport { runRemPatterns } from '../memory/dreaming/rem-patterns.js';\n\nconst log = createLogger('AgentOrchestrator');\n\nexport interface AgentOrchestratorConfig {\n  agentManager: AgentManager;\n  sessionStore: SessionStore;\n  modelManager: ModelManager;\n  eventHandler: AgentEventHandler;\n  feedbackCoordinator: FeedbackCoordinator;\n  sessionConfigStore: SessionConfigStore;\n  /** Load per-session workspace override and mkdir before creating the agent. */\n  hydrateSessionWorkspaceFromStore?: (sessionKey: string) => Promise<void>;\n  getThinkingDefault: () => ThinkLevel | undefined;\n  /** Per-session default from merged `agents.list` / defaults (optional). */\n  getThinkingDefaultForSession?: (sessionKey: string) => ThinkLevel | undefined;\n  /** Default workspace root when no per-session resolver is set. */\n  workspaceRoot: string;\n  /** Per-agent workspace root for attachments (optional; defaults to `workspaceRoot`). */\n  getWorkspaceRootForSession?: (sessionKey: string) => string;\n  /** Agent home (`…/agents/<id>/`) for inbound/TTS files — keeps internal state out of the markdown workspace. */\n  getAgentInternalStorageRootForSession?: (sessionKey: string) => string;\n  /** Fire-and-forget after full session persist (e.g. LLM session title); not called from mid-turn snapshots. */\n  enqueueAutoTitle?: (sessionKey: string) => void;\n  /** For per-turn timeout via `agents.defaults.maxTaskDurationMs`. */\n  getConfig?: () => Config | undefined;\n  /** Channel streaming: token/tool events from pi embedded session. */\n  onEmbeddedStreamEvent?: (sessionKey: string, event: EmbeddedStreamEvent) => void;\n  /** Called after a successful embedded turn with assistant plain text. */\n  onEmbeddedTurnComplete?: (sessionKey: string, lastAssistantText?: string) => void;\n}\n\nexport class AgentOrchestrator {\n  private agentManager: AgentManager;\n  private sessionStore: SessionStore;\n  private modelManager: ModelManager;\n  private eventHandler: AgentEventHandler;\n  private feedbackCoordinator: FeedbackCoordinator;\n  private sessionConfigStore: SessionConfigStore;\n  private hydrateSessionWorkspaceFromStore?: (sessionKey: string) => Promise<void>;\n  private getThinkingDefault: () => ThinkLevel | undefined;\n  private getThinkingDefaultForSession?: (sessionKey: string) => ThinkLevel | undefined;\n  private workspaceRoot: string;\n  private getWorkspaceRootForSession?: (sessionKey: string) => string;\n  private getAgentInternalStorageRootForSession: (sessionKey: string) => string;\n  private enqueueAutoTitle?: (sessionKey: string) => void;\n  private getConfig?: () => Config | undefined;\n  private onEmbeddedStreamEvent?: (sessionKey: string, event: EmbeddedStreamEvent) => void;\n  private onEmbeddedTurnComplete?: (sessionKey: string, lastAssistantText?: string) => void;\n\n  constructor(config: AgentOrchestratorConfig) {\n    this.agentManager = config.agentManager;\n    this.sessionStore = config.sessionStore;\n    this.modelManager = config.modelManager;\n    this.eventHandler = config.eventHandler;\n    this.feedbackCoordinator = config.feedbackCoordinator;\n    this.sessionConfigStore = config.sessionConfigStore;\n    this.hydrateSessionWorkspaceFromStore = config.hydrateSessionWorkspaceFromStore;\n    this.getThinkingDefault = config.getThinkingDefault;\n    this.getThinkingDefaultForSession = config.getThinkingDefaultForSession;\n    this.workspaceRoot = config.workspaceRoot;\n    this.getWorkspaceRootForSession = config.getWorkspaceRootForSession;\n    this.getAgentInternalStorageRootForSession =\n      config.getAgentInternalStorageRootForSession ??\n      ((sk) => this.getWorkspaceRootForSession?.(sk) ?? this.workspaceRoot);\n    this.enqueueAutoTitle = config.enqueueAutoTitle;\n    this.getConfig = config.getConfig;\n    this.onEmbeddedStreamEvent = config.onEmbeddedStreamEvent;\n    this.onEmbeddedTurnComplete = config.onEmbeddedTurnComplete;\n  }\n\n  private async hydrateSessionModelFromStore(sessionKey: string): Promise<void> {\n    const cfg = await this.sessionConfigStore.get(sessionKey);\n    if (cfg?.modelOverride) {\n      await this.modelManager.switchModelForSession(sessionKey, cfg.modelOverride);\n    }\n  }\n\n  /**\n   * Process a message through the agent orchestration pipeline\n   */\n  async process(msg: InboundMessage, context: SessionContext): Promise<void> {\n    const { sessionKey } = context;\n\n    log.debug({ sessionKey }, 'Processing message through agent orchestrator');\n\n    await this.hydrateSessionWorkspaceFromStore?.(sessionKey);\n\n    // Dreaming: short-circuit cron-triggered sweep tokens into maintenance runs.\n    // This avoids spending LLM tokens for scheduled memory consolidation.\n    if (\n      typeof msg.content === 'string' &&\n      (sessionKey.startsWith('cron:') || context.channel === 'cron')\n    ) {\n      const content = msg.content;\n      const isDreamingSweep =\n        content.includes(DREAMING_SWEEP_TOKEN) ||\n        content.includes(DREAMING_LIGHT_SWEEP_TOKEN) ||\n        content.includes(DREAMING_REM_SWEEP_TOKEN);\n\n      if (isDreamingSweep) {\n        const workspaceDir = this.agentManager.getResolvedWorkspaceForSession(sessionKey);\n        const resolved = resolveDreamingConfig(this.getConfig?.());\n        const t0 = Date.now();\n\n        if (content.includes(DREAMING_LIGHT_SWEEP_TOKEN)) {\n          const result = await runLightSweep({ workspaceDir, config: resolved.phases.light });\n          const event: DreamingEvent = {\n            timestamp: new Date().toISOString(), phase: 'light',\n            ok: result.ok, reason: result.reason, durationMs: Date.now() - t0,\n            scannedEntries: result.scannedEntries, newSignals: result.newSignals, deduped: result.deduped,\n          };\n          await appendDreamingEvent(workspaceDir, event);\n        } else if (content.includes(DREAMING_REM_SWEEP_TOKEN)) {\n          const result = await runRemPatterns({ workspaceDir, config: resolved.phases.rem });\n          const event: DreamingEvent = {\n            timestamp: new Date().toISOString(), phase: 'rem',\n            ok: result.ok, reason: result.reason, durationMs: Date.now() - t0,\n            patternsDiscovered: result.patternsDiscovered, entriesAnalyzed: result.entriesAnalyzed,\n          };\n          await appendDreamingEvent(workspaceDir, event);\n        } else {\n          const result = await runDreamingDeepPromotion({ workspaceDir, config: resolved.phases.deep });\n          const event: DreamingEvent = {\n            timestamp: new Date().toISOString(), phase: 'deep',\n            ok: result.ok, reason: result.reason, durationMs: Date.now() - t0,\n            candidates: result.candidates, applied: result.applied,\n          };\n          await appendDreamingEvent(workspaceDir, event);\n        }\n        return;\n      }\n    }\n\n    try {\n      await this.hydrateSessionModelFromStore(sessionKey);\n\n      const thinkingDefault =\n        this.getThinkingDefaultForSession?.(sessionKey) ?? this.getThinkingDefault();\n      const thinkingLevel = await resolveEffectiveThinkingLevel(\n        this.sessionConfigStore,\n        sessionKey,\n        null,\n        thinkingDefault,\n      );\n      this.agentManager.setThinkingLevel(sessionKey, thinkingLevel);\n\n      // Persist inbound files (Telegram, etc.) under agent home, then build user message\n      const storageRoot = this.getAgentInternalStorageRootForSession(sessionKey);\n      const persistedAttachments = await persistInboundAttachmentsToWorkspace(\n        storageRoot,\n        sessionKey,\n        msg.attachments,\n      );\n      const userMessage = await this.buildUserMessage(\n        {\n          ...msg,\n          attachments: persistedAttachments ?? msg.attachments,\n        },\n        sessionKey,\n      );\n      const userPlainForMemory = extractAgentUserPlainText(userMessage);\n      const userMessageForModel = await this.agentManager.applyMemoryPrefetchToUserMessage(\n        userMessage,\n        sessionKey,\n      );\n\n      this.feedbackCoordinator.startTask();\n\n      const turnResult = await runEmbeddedTurnForSession({\n        sessionKey,\n        userMessage: userMessageForModel,\n        sessionStore: this.sessionStore,\n        agentManager: this.agentManager,\n        modelManager: this.modelManager,\n        thinkingOverride: thinkingLevel,\n        getConfig: this.getConfig,\n        beforeTurn: () => this.agentManager.beginBackgroundReviewUserTurn(sessionKey),\n        onEvent: (event) => this.onEmbeddedStreamEvent?.(sessionKey, event),\n      });\n\n      this.agentManager.afterAgentTurn(sessionKey, userPlainForMemory);\n      this.agentManager.scheduleBackgroundReviewAfterUserTurn(sessionKey);\n\n      if (turnResult.ok) {\n        this.onEmbeddedTurnComplete?.(sessionKey, turnResult.lastAssistantText);\n        this.enqueueAutoTitle?.(sessionKey);\n      } else if (turnResult.errorMessage) {\n        log.warn({ sessionKey, errorMessage: turnResult.errorMessage }, 'Embedded inbound turn failed');\n      }\n\n      this.feedbackCoordinator.endTask();\n\n    } catch (error) {\n      log.error({ err: error, sessionKey }, 'Error in agent orchestration');\n      this.feedbackCoordinator.endTask();\n      throw error;\n    }\n  }\n\n  /**\n   * Build an agent message from an inbound message\n   */\n  private async buildUserMessage(msg: InboundMessage, sessionKey: string): Promise<AgentMessage> {\n    const storageRootAbs = this.getAgentInternalStorageRootForSession(sessionKey);\n    let textBody = msg.content.trimStart().startsWith('/skill:')\n      ? this.agentManager.expandSkillUserText(msg.content)\n      : msg.content;\n\n    if (/@file:/.test(textBody)) {\n      const root = this.agentManager.getResolvedWorkspaceForSession(sessionKey);\n      textBody = await expandAtFileMentionsInPlainText(textBody, root);\n    }\n\n    if (!msg.attachments || msg.attachments.length === 0) {\n      return {\n        role: 'user',\n        content: textBody,\n        timestamp: Date.now(),\n      };\n    }\n\n    const modelRef = this.modelManager.getModelForSession(sessionKey);\n    const cfg = this.getConfig?.();\n\n    const messageContent: Array<\n      { type: 'text'; text: string } | { type: 'image'; data: string; mimeType: string }\n    > = [];\n\n    if (msg.content.trim()) {\n      messageContent.push({ type: 'text', text: textBody });\n    }\n\n    const attachments = msg.attachments;\n    let i = 0;\n    while (i < attachments.length) {\n      const att = attachments[i]!;\n      const isImage =\n        att.type === 'image' || att.type === 'photo' || Boolean(att.mimeType?.startsWith('image/'));\n\n      if (isImage) {\n        const group: Array<{ data: string; mimeType: string }> = [];\n        while (i < attachments.length) {\n          const a = attachments[i]!;\n          const img =\n            a.type === 'image' || a.type === 'photo' || Boolean(a.mimeType?.startsWith('image/'));\n          if (!img) {\n            break;\n          }\n          if (!a.data || a.data.length === 0) {\n            log.warn({ type: a.type, name: a.name }, 'Empty image data, skipping');\n            i += 1;\n            continue;\n          }\n          group.push({ data: a.data, mimeType: a.mimeType || 'image/jpeg' });\n          i += 1;\n        }\n        if (group.length > 0) {\n          const parts = await resolveInboundImageContentParts({\n            modelRef,\n            cfg,\n            userTextForContext: msg.content.trim() ? textBody : '',\n            images: group,\n          });\n          messageContent.push(...parts);\n        }\n      } else {\n        const fileBlock = formatInboundFileTextBlock(\n          {\n            type: att.type,\n            mimeType: att.mimeType,\n            name: att.name,\n            size: att.size,\n            workspaceRelativePath: att.workspaceRelativePath,\n          },\n          storageRootAbs,\n        );\n        messageContent.push({ type: 'text', text: fileBlock });\n        i += 1;\n      }\n    }\n\n    const hasText = messageContent.some((item) => item.type === 'text');\n    const hasImage = messageContent.some((item) => item.type === 'image');\n    if (hasImage && !hasText) {\n      messageContent.unshift({ type: 'text', text: 'Please analyze the image(s) I sent.' });\n    }\n\n    if (messageContent.length === 0) {\n      log.warn(\n        { attachmentCount: msg.attachments.length },\n        'All attachments were skipped, falling back to text message',\n      );\n      return {\n        role: 'user',\n        content: textBody || '[Image attachment could not be processed]',\n        timestamp: Date.now(),\n      };\n    }\n\n    return {\n      role: 'user',\n      content: messageContent,\n      timestamp: Date.now(),\n    };\n  }\n\n  /**\n   * Get the current agent model ID\n   */\n  getCurrentModel(): string {\n    return this.modelManager.getCurrentModel();\n  }\n\n  /**\n   * Check if agent is currently processing for a session\n   */\n  isProcessing(sessionKey: string): boolean {\n    const agent = this.agentManager.getAgent(sessionKey);\n    if (!agent) {\n      return false;\n    }\n    return agent.state.messages.length > 0;\n  }\n\n  /**\n   * Abort current agent execution for a session\n   */\n  abort(sessionKey: string): void {\n    void abortEmbeddedRun(sessionKey);\n    const agent = this.agentManager.getAgent(sessionKey);\n    agent?.abort();\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"agent-orchestrator.js","names":[],"sources":["../../../../src/agent/orchestration/agent-orchestrator.ts"],"sourcesContent":["/**\n * Agent Orchestrator - Coordinates Agent execution flow\n *\n * Manages the complete agent execution pipeline from message processing\n * to response generation.\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport type { Config } from '../../config/schema.js';\nimport type { InboundMessage } from '../../infra/bus/index.js';\nimport type { SessionConfigStore, SessionStore } from '../../session/index.js';\nimport type { SessionHydrator } from '../session/index.js';\nimport { resolveEffectiveThinkingLevel } from '../../session/thinking-resolve.js';\nimport type { ThinkLevel } from '../transcript/thinking-types.js';\nimport type { ModelManager } from '../models/index.js';\nimport type { SessionContext } from '../session/session-context.js';\nimport type { AgentEventHandler } from './agent-event-handler.js';\nimport type { FeedbackCoordinator } from '../feedback/feedback-coordinator.js';\nimport type { AgentManager } from '../agent-manager.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { extractAgentUserPlainText } from '../memory/user-message-text.js';\nimport { abortEmbeddedRun } from '../embedded/runs.js';\nimport { runEmbeddedTurnForSession } from '../embedded/run-for-session.js';\nimport type { EmbeddedStreamEvent } from '../embedded/types.js';\nimport {\n  persistInboundAttachmentsToWorkspace,\n  formatInboundFileTextBlock,\n} from '../../channels/attachments/inbound-persist.js';\nimport { expandAtFileMentionsInPlainText } from '../context/expand-at-file-mentions.js';\nimport { resolveInboundImageContentParts } from '../image/inbound-image-handling.js';\nimport {\n  DREAMING_SWEEP_TOKEN,\n  DREAMING_LIGHT_SWEEP_TOKEN,\n  DREAMING_REM_SWEEP_TOKEN,\n} from '../memory/dreaming/constants.js';\nimport { resolveDreamingConfig } from '../memory/dreaming/config.js';\nimport { runDreamingDeepPromotion } from '../memory/dreaming/deep-promotion.js';\nimport { appendDreamingEvent, type DreamingEvent } from '../memory/dreaming/events.js';\nimport { runLightSweep } from '../memory/dreaming/light-sweep.js';\nimport { runRemPatterns } from '../memory/dreaming/rem-patterns.js';\n\nconst log = createLogger('AgentOrchestrator');\n\nexport interface AgentOrchestratorConfig {\n  agentManager: AgentManager;\n  sessionStore: SessionStore;\n  modelManager: ModelManager;\n  eventHandler: AgentEventHandler;\n  feedbackCoordinator: FeedbackCoordinator;\n  sessionConfigStore: SessionConfigStore;\n  /** Per-session hydration (workspace override + model override) before the agent runs. */\n  sessionHydrator: SessionHydrator;\n  getThinkingDefault: () => ThinkLevel | undefined;\n  /** Per-session default from merged `agents.list` / defaults (optional). */\n  getThinkingDefaultForSession?: (sessionKey: string) => ThinkLevel | undefined;\n  /** Default workspace root when no per-session resolver is set. */\n  workspaceRoot: string;\n  /** Per-agent workspace root for attachments (optional; defaults to `workspaceRoot`). */\n  getWorkspaceRootForSession?: (sessionKey: string) => string;\n  /** Agent home (`…/agents/<id>/`) for inbound/TTS files — keeps internal state out of the markdown workspace. */\n  getAgentInternalStorageRootForSession?: (sessionKey: string) => string;\n  /** Fire-and-forget after full session persist (e.g. LLM session title); not called from mid-turn snapshots. */\n  enqueueAutoTitle?: (sessionKey: string) => void;\n  /** For per-turn timeout via `agents.defaults.maxTaskDurationMs`. */\n  getConfig?: () => Config | undefined;\n  /** Channel streaming: token/tool events from pi embedded session. */\n  onEmbeddedStreamEvent?: (sessionKey: string, event: EmbeddedStreamEvent) => void;\n  /** Called after a successful embedded turn with assistant plain text. */\n  onEmbeddedTurnComplete?: (sessionKey: string, lastAssistantText?: string) => void;\n}\n\nexport class AgentOrchestrator {\n  private agentManager: AgentManager;\n  private sessionStore: SessionStore;\n  private modelManager: ModelManager;\n  private eventHandler: AgentEventHandler;\n  private feedbackCoordinator: FeedbackCoordinator;\n  private sessionConfigStore: SessionConfigStore;\n  private sessionHydrator: SessionHydrator;\n  private getThinkingDefault: () => ThinkLevel | undefined;\n  private getThinkingDefaultForSession?: (sessionKey: string) => ThinkLevel | undefined;\n  private workspaceRoot: string;\n  private getWorkspaceRootForSession?: (sessionKey: string) => string;\n  private getAgentInternalStorageRootForSession: (sessionKey: string) => string;\n  private enqueueAutoTitle?: (sessionKey: string) => void;\n  private getConfig?: () => Config | undefined;\n  private onEmbeddedStreamEvent?: (sessionKey: string, event: EmbeddedStreamEvent) => void;\n  private onEmbeddedTurnComplete?: (sessionKey: string, lastAssistantText?: string) => void;\n\n  constructor(config: AgentOrchestratorConfig) {\n    this.agentManager = config.agentManager;\n    this.sessionStore = config.sessionStore;\n    this.modelManager = config.modelManager;\n    this.eventHandler = config.eventHandler;\n    this.feedbackCoordinator = config.feedbackCoordinator;\n    this.sessionConfigStore = config.sessionConfigStore;\n    this.sessionHydrator = config.sessionHydrator;\n    this.getThinkingDefault = config.getThinkingDefault;\n    this.getThinkingDefaultForSession = config.getThinkingDefaultForSession;\n    this.workspaceRoot = config.workspaceRoot;\n    this.getWorkspaceRootForSession = config.getWorkspaceRootForSession;\n    this.getAgentInternalStorageRootForSession =\n      config.getAgentInternalStorageRootForSession ??\n      ((sk) => this.getWorkspaceRootForSession?.(sk) ?? this.workspaceRoot);\n    this.enqueueAutoTitle = config.enqueueAutoTitle;\n    this.getConfig = config.getConfig;\n    this.onEmbeddedStreamEvent = config.onEmbeddedStreamEvent;\n    this.onEmbeddedTurnComplete = config.onEmbeddedTurnComplete;\n  }\n\n  /**\n   * Process a message through the agent orchestration pipeline\n   */\n  async process(msg: InboundMessage, context: SessionContext): Promise<void> {\n    const { sessionKey } = context;\n\n    log.debug({ sessionKey }, 'Processing message through agent orchestrator');\n\n    await this.sessionHydrator.workspace(sessionKey);\n\n    // Dreaming: short-circuit cron-triggered sweep tokens into maintenance runs.\n    // This avoids spending LLM tokens for scheduled memory consolidation.\n    if (\n      typeof msg.content === 'string' &&\n      (sessionKey.startsWith('cron:') || context.channel === 'cron')\n    ) {\n      const content = msg.content;\n      const isDreamingSweep =\n        content.includes(DREAMING_SWEEP_TOKEN) ||\n        content.includes(DREAMING_LIGHT_SWEEP_TOKEN) ||\n        content.includes(DREAMING_REM_SWEEP_TOKEN);\n\n      if (isDreamingSweep) {\n        const workspaceDir = this.agentManager.getResolvedWorkspaceForSession(sessionKey);\n        const resolved = resolveDreamingConfig(this.getConfig?.());\n        const t0 = Date.now();\n\n        if (content.includes(DREAMING_LIGHT_SWEEP_TOKEN)) {\n          const result = await runLightSweep({ workspaceDir, config: resolved.phases.light });\n          const event: DreamingEvent = {\n            timestamp: new Date().toISOString(), phase: 'light',\n            ok: result.ok, reason: result.reason, durationMs: Date.now() - t0,\n            scannedEntries: result.scannedEntries, newSignals: result.newSignals, deduped: result.deduped,\n          };\n          await appendDreamingEvent(workspaceDir, event);\n        } else if (content.includes(DREAMING_REM_SWEEP_TOKEN)) {\n          const result = await runRemPatterns({ workspaceDir, config: resolved.phases.rem });\n          const event: DreamingEvent = {\n            timestamp: new Date().toISOString(), phase: 'rem',\n            ok: result.ok, reason: result.reason, durationMs: Date.now() - t0,\n            patternsDiscovered: result.patternsDiscovered, entriesAnalyzed: result.entriesAnalyzed,\n          };\n          await appendDreamingEvent(workspaceDir, event);\n        } else {\n          const result = await runDreamingDeepPromotion({ workspaceDir, config: resolved.phases.deep });\n          const event: DreamingEvent = {\n            timestamp: new Date().toISOString(), phase: 'deep',\n            ok: result.ok, reason: result.reason, durationMs: Date.now() - t0,\n            candidates: result.candidates, applied: result.applied,\n          };\n          await appendDreamingEvent(workspaceDir, event);\n        }\n        return;\n      }\n    }\n\n    try {\n      await this.sessionHydrator.model(sessionKey);\n\n      const thinkingDefault =\n        this.getThinkingDefaultForSession?.(sessionKey) ?? this.getThinkingDefault();\n      const thinkingLevel = await resolveEffectiveThinkingLevel(\n        this.sessionConfigStore,\n        sessionKey,\n        null,\n        thinkingDefault,\n      );\n      this.agentManager.setThinkingLevel(sessionKey, thinkingLevel);\n\n      // Persist inbound files (Telegram, etc.) under agent home, then build user message\n      const storageRoot = this.getAgentInternalStorageRootForSession(sessionKey);\n      const persistedAttachments = await persistInboundAttachmentsToWorkspace(\n        storageRoot,\n        sessionKey,\n        msg.attachments,\n      );\n      const userMessage = await this.buildUserMessage(\n        {\n          ...msg,\n          attachments: persistedAttachments ?? msg.attachments,\n        },\n        sessionKey,\n      );\n      const userPlainForMemory = extractAgentUserPlainText(userMessage);\n      const userMessageForModel = await this.agentManager.applyMemoryPrefetchToUserMessage(\n        userMessage,\n        sessionKey,\n      );\n\n      this.feedbackCoordinator.startTask();\n\n      const turnResult = await runEmbeddedTurnForSession({\n        sessionKey,\n        userMessage: userMessageForModel,\n        sessionStore: this.sessionStore,\n        agentManager: this.agentManager,\n        modelManager: this.modelManager,\n        thinkingOverride: thinkingLevel,\n        getConfig: this.getConfig,\n        beforeTurn: () => this.agentManager.beginBackgroundReviewUserTurn(sessionKey),\n        onEvent: (event) => this.onEmbeddedStreamEvent?.(sessionKey, event),\n      });\n\n      this.agentManager.afterAgentTurn(sessionKey, userPlainForMemory);\n      this.agentManager.scheduleBackgroundReviewAfterUserTurn(sessionKey);\n\n      if (turnResult.ok) {\n        this.onEmbeddedTurnComplete?.(sessionKey, turnResult.lastAssistantText);\n        this.enqueueAutoTitle?.(sessionKey);\n      } else if (turnResult.errorMessage) {\n        log.warn({ sessionKey, errorMessage: turnResult.errorMessage }, 'Embedded inbound turn failed');\n      }\n\n      this.feedbackCoordinator.endTask();\n\n    } catch (error) {\n      log.error({ err: error, sessionKey }, 'Error in agent orchestration');\n      this.feedbackCoordinator.endTask();\n      throw error;\n    }\n  }\n\n  /**\n   * Build an agent message from an inbound message\n   */\n  private async buildUserMessage(msg: InboundMessage, sessionKey: string): Promise<AgentMessage> {\n    const storageRootAbs = this.getAgentInternalStorageRootForSession(sessionKey);\n    let textBody = msg.content.trimStart().startsWith('/skill:')\n      ? this.agentManager.expandSkillUserText(msg.content)\n      : msg.content;\n\n    if (/@file:/.test(textBody)) {\n      const root = this.agentManager.getResolvedWorkspaceForSession(sessionKey);\n      textBody = await expandAtFileMentionsInPlainText(textBody, root);\n    }\n\n    if (!msg.attachments || msg.attachments.length === 0) {\n      return {\n        role: 'user',\n        content: textBody,\n        timestamp: Date.now(),\n      };\n    }\n\n    const modelRef = this.modelManager.getModelForSession(sessionKey);\n    const cfg = this.getConfig?.();\n\n    const messageContent: Array<\n      { type: 'text'; text: string } | { type: 'image'; data: string; mimeType: string }\n    > = [];\n\n    if (msg.content.trim()) {\n      messageContent.push({ type: 'text', text: textBody });\n    }\n\n    const attachments = msg.attachments;\n    let i = 0;\n    while (i < attachments.length) {\n      const att = attachments[i]!;\n      const isImage =\n        att.type === 'image' || att.type === 'photo' || Boolean(att.mimeType?.startsWith('image/'));\n\n      if (isImage) {\n        const group: Array<{ data: string; mimeType: string }> = [];\n        while (i < attachments.length) {\n          const a = attachments[i]!;\n          const img =\n            a.type === 'image' || a.type === 'photo' || Boolean(a.mimeType?.startsWith('image/'));\n          if (!img) {\n            break;\n          }\n          if (!a.data || a.data.length === 0) {\n            log.warn({ type: a.type, name: a.name }, 'Empty image data, skipping');\n            i += 1;\n            continue;\n          }\n          group.push({ data: a.data, mimeType: a.mimeType || 'image/jpeg' });\n          i += 1;\n        }\n        if (group.length > 0) {\n          const parts = await resolveInboundImageContentParts({\n            modelRef,\n            cfg,\n            userTextForContext: msg.content.trim() ? textBody : '',\n            images: group,\n          });\n          messageContent.push(...parts);\n        }\n      } else {\n        const fileBlock = formatInboundFileTextBlock(\n          {\n            type: att.type,\n            mimeType: att.mimeType,\n            name: att.name,\n            size: att.size,\n            workspaceRelativePath: att.workspaceRelativePath,\n          },\n          storageRootAbs,\n        );\n        messageContent.push({ type: 'text', text: fileBlock });\n        i += 1;\n      }\n    }\n\n    const hasText = messageContent.some((item) => item.type === 'text');\n    const hasImage = messageContent.some((item) => item.type === 'image');\n    if (hasImage && !hasText) {\n      messageContent.unshift({ type: 'text', text: 'Please analyze the image(s) I sent.' });\n    }\n\n    if (messageContent.length === 0) {\n      log.warn(\n        { attachmentCount: msg.attachments.length },\n        'All attachments were skipped, falling back to text message',\n      );\n      return {\n        role: 'user',\n        content: textBody || '[Image attachment could not be processed]',\n        timestamp: Date.now(),\n      };\n    }\n\n    return {\n      role: 'user',\n      content: messageContent,\n      timestamp: Date.now(),\n    };\n  }\n\n  /**\n   * Get the current agent model ID\n   */\n  getCurrentModel(): string {\n    return this.modelManager.getCurrentModel();\n  }\n\n  /**\n   * Check if agent is currently processing for a session\n   */\n  isProcessing(sessionKey: string): boolean {\n    const agent = this.agentManager.getAgent(sessionKey);\n    if (!agent) {\n      return false;\n    }\n    return agent.state.messages.length > 0;\n  }\n\n  /**\n   * Abort current agent execution for a session\n   */\n  abort(sessionKey: string): void {\n    void abortEmbeddedRun(sessionKey);\n    const agent = this.agentManager.getAgent(sessionKey);\n    agent?.abort();\n  }\n}\n"],"mappings":"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"}

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

@@ -2,4 +2,4 @@
  * Orchestration Layer - Exports all orchestration-related modules
  */
 export { AgentOrchestrator, type AgentOrchestratorConfig } from './agent-orchestrator.js';
-export { AgentEventHandler, type AgentEventHandlerConfig } from './agent-event-handler.js';
+export { AgentEventHandler, SessionEventBus, type AgentEventHandlerConfig, type SessionEventListener, type SessionEventTypeFilter, } from './agent-event-handler.js';

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

@@ -1,3 +1,3 @@
 import { AgentOrchestrator } from "./agent-orchestrator.js";
-import { AgentEventHandler } from "./agent-event-handler.js";
-export { AgentEventHandler, AgentOrchestrator };
+import { AgentEventHandler, SessionEventBus } from "./agent-event-handler.js";
+export { AgentEventHandler, AgentOrchestrator, SessionEventBus };

package/dist/src/agent/prompt/service-prompt-builder.js

@@ -1,15 +1,15 @@
-import { resolveStateDir } from "../../config/paths-state.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { resolveStateDir } from "../../config/paths-state.js";
 import { init_paths } from "../../config/paths.js";
 import { DEFAULT_USER_FILENAME } from "../context/workspace.js";
 import { createSkillConfigManager } from "../skills/config.js";
+import { buildTtsSystemPromptHint } from "../../voice/tts/directives.js";
+import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 import { selectSkillsVisibleInPrompt } from "../skills/format-skills-prompt.js";
 import { buildSystemPrompt } from "./system-prompt.js";
-import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
-import { buildTtsSystemPromptHint } from "../../voice/tts/directives.js";
-import { join } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
 //#region src/agent/prompt/service-prompt-builder.ts
 /**
 * System Prompt Builder - Builds the complete system prompt

package/dist/src/agent/reply/post-compaction-context.js

@@ -1,7 +1,7 @@
 import { init_agent_scope, resolveAgentProfileDir } from "../agent-scope.js";
 import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
-import { join, resolve } from "node:path";
 import { readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
 //#region src/agent/reply/post-compaction-context.ts
 init_agent_scope();
 const MAX_CONTEXT_CHARS = 1800;

package/dist/src/agent/reply/workspace-boundary-read.js

@@ -1,5 +1,5 @@
-import { resolve } from "node:path";
 import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
 //#region src/agent/reply/workspace-boundary-read.ts
 /**
 * Read a file relative to workspace root with path traversal guard and byte cap.

package/dist/src/agent/sandbox/path-policy.js

@@ -1,6 +1,6 @@
+import { realpathSync } from "node:fs";
 import { isAbsolute, normalize, resolve, sep } from "node:path";
 import { homedir } from "node:os";
-import { realpathSync } from "node:fs";
 //#region src/agent/sandbox/path-policy.ts
 /**
 * Path safety validation for sandbox isolation.

package/dist/src/agent/service/async-queue.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Async FIFO queue with `for await` support.
+ *
+ * Replaces the ad-hoc `eventQueue + resolveWaiting` single-slot pattern that
+ * the streaming direct turn used to manage SSE events. The previous pattern was
+ * lossy if two pushes landed before the single waiter resumed; this queue keeps
+ * the buffer growing until consumed, and closes cleanly so the iterator drains.
+ */
+export declare class AsyncQueue<T> implements AsyncIterable<T> {
+    private readonly buffer;
+    private readonly waiters;
+    private closed;
+    /** Push a value to the queue. No-op when the queue is closed. */
+    push(value: T): void;
+    /** Close the queue. Pending iterators drain any buffered values and then complete. */
+    close(): void;
+    /** True if the queue is closed and the internal buffer is drained. */
+    get isDrained(): boolean;
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+}

package/dist/src/agent/service/async-queue.js

@@ -0,0 +1,53 @@
+//#region src/agent/service/async-queue.ts
+/**
+* Async FIFO queue with `for await` support.
+*
+* Replaces the ad-hoc `eventQueue + resolveWaiting` single-slot pattern that
+* the streaming direct turn used to manage SSE events. The previous pattern was
+* lossy if two pushes landed before the single waiter resumed; this queue keeps
+* the buffer growing until consumed, and closes cleanly so the iterator drains.
+*/
+var AsyncQueue = class {
+	buffer = [];
+	waiters = [];
+	closed = false;
+	/** Push a value to the queue. No-op when the queue is closed. */
+	push(value) {
+		if (this.closed) return;
+		const waiter = this.waiters.shift();
+		if (waiter) {
+			waiter(value);
+			return;
+		}
+		this.buffer.push(value);
+	}
+	/** Close the queue. Pending iterators drain any buffered values and then complete. */
+	close() {
+		if (this.closed) return;
+		this.closed = true;
+		while (this.waiters.length > 0) this.waiters.shift()(CLOSE_SENTINEL);
+	}
+	/** True if the queue is closed and the internal buffer is drained. */
+	get isDrained() {
+		return this.closed && this.buffer.length === 0;
+	}
+	async *[Symbol.asyncIterator]() {
+		while (true) {
+			if (this.buffer.length > 0) {
+				yield this.buffer.shift();
+				continue;
+			}
+			if (this.closed) return;
+			const next = await new Promise((resolve) => {
+				this.waiters.push(resolve);
+			});
+			if (next === CLOSE_SENTINEL) return;
+			yield next;
+		}
+	}
+};
+const CLOSE_SENTINEL = Symbol("AsyncQueue.close");
+//#endregion
+export { AsyncQueue };
+
+//# sourceMappingURL=async-queue.js.map

package/dist/src/agent/service/async-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-queue.js","names":[],"sources":["../../../../src/agent/service/async-queue.ts"],"sourcesContent":["/**\n * Async FIFO queue with `for await` support.\n *\n * Replaces the ad-hoc `eventQueue + resolveWaiting` single-slot pattern that\n * the streaming direct turn used to manage SSE events. The previous pattern was\n * lossy if two pushes landed before the single waiter resumed; this queue keeps\n * the buffer growing until consumed, and closes cleanly so the iterator drains.\n */\nexport class AsyncQueue<T> implements AsyncIterable<T> {\n  private readonly buffer: T[] = [];\n  private readonly waiters: Array<(value: T | typeof CLOSE_SENTINEL) => void> = [];\n  private closed = false;\n\n  /** Push a value to the queue. No-op when the queue is closed. */\n  push(value: T): void {\n    if (this.closed) {\n      return;\n    }\n    const waiter = this.waiters.shift();\n    if (waiter) {\n      waiter(value);\n      return;\n    }\n    this.buffer.push(value);\n  }\n\n  /** Close the queue. Pending iterators drain any buffered values and then complete. */\n  close(): void {\n    if (this.closed) return;\n    this.closed = true;\n    while (this.waiters.length > 0) {\n      this.waiters.shift()!(CLOSE_SENTINEL);\n    }\n  }\n\n  /** True if the queue is closed and the internal buffer is drained. */\n  get isDrained(): boolean {\n    return this.closed && this.buffer.length === 0;\n  }\n\n  async *[Symbol.asyncIterator](): AsyncIterator<T> {\n    while (true) {\n      if (this.buffer.length > 0) {\n        yield this.buffer.shift()!;\n        continue;\n      }\n      if (this.closed) {\n        return;\n      }\n      const next = await new Promise<T | typeof CLOSE_SENTINEL>((resolve) => {\n        this.waiters.push(resolve);\n      });\n      if (next === CLOSE_SENTINEL) {\n        return;\n      }\n      yield next;\n    }\n  }\n}\n\nconst CLOSE_SENTINEL = Symbol('AsyncQueue.close');\n"],"mappings":";;;;;;;;;AAQA,IAAa,aAAb,MAAuD;CACrD,SAA+B,EAAE;CACjC,UAA8E,EAAE;CAChF,SAAiB;;CAGjB,KAAK,OAAgB;AACnB,MAAI,KAAK,OACP;EAEF,MAAM,SAAS,KAAK,QAAQ,OAAO;AACnC,MAAI,QAAQ;AACV,UAAO,MAAM;AACb;;AAEF,OAAK,OAAO,KAAK,MAAM;;;CAIzB,QAAc;AACZ,MAAI,KAAK,OAAQ;AACjB,OAAK,SAAS;AACd,SAAO,KAAK,QAAQ,SAAS,EAC3B,MAAK,QAAQ,OAAO,CAAE,eAAe;;;CAKzC,IAAI,YAAqB;AACvB,SAAO,KAAK,UAAU,KAAK,OAAO,WAAW;;CAG/C,QAAQ,OAAO,iBAAmC;AAChD,SAAO,MAAM;AACX,OAAI,KAAK,OAAO,SAAS,GAAG;AAC1B,UAAM,KAAK,OAAO,OAAO;AACzB;;AAEF,OAAI,KAAK,OACP;GAEF,MAAM,OAAO,MAAM,IAAI,SAAoC,YAAY;AACrE,SAAK,QAAQ,KAAK,QAAQ;KAC1B;AACF,OAAI,SAAS,eACX;AAEF,SAAM;;;;AAKZ,MAAM,iBAAiB,OAAO,mBAAmB"}

package/dist/src/agent/service/build-direct-message-content.d.ts

@@ -1,5 +1,5 @@
 import type { Config } from '../../config/schema.js';
-import type { AgentManager } from '../agent-manager.js';
+import type { AgentInstanceGateway } from '../agent-instance-gateway.js';
 import type { ModelManager } from '../models/index.js';
 export type DirectInboundAttachment = {
     type: string;
@@ -25,6 +25,6 @@ export declare function buildDirectUserMessageContent(opts: {
     attachments?: DirectInboundAttachment[];
     sessionKey?: string;
     config: Config;
-    agentManager: AgentManager;
+    agentManager: AgentInstanceGateway;
     modelManager: ModelManager;
 }): Promise<DirectMessagePart[]>;

package/dist/src/agent/service/build-direct-message-content.js.map

@@ -1 +1 @@
-{"version":3,"file":"build-direct-message-content.js","names":[],"sources":["../../../../src/agent/service/build-direct-message-content.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport { getAgentDefaultModelRef } from '../../config/schema.js';\nimport { getDefaultModelSync } from '../../providers/index.js';\nimport { formatInboundFileTextBlock } from '../../channels/attachments/inbound-persist.js';\nimport { expandAtFileMentionsInPlainText } from '../context/expand-at-file-mentions.js';\nimport { resolveInboundImageContentParts } from '../image/inbound-image-handling.js';\nimport { resolveAgentHomeDir, resolveDefaultAgentId } from '../agent-scope.js';\nimport { extractProfileAgentId } from '../../config/agent-profile.js';\nimport type { AgentManager } from '../agent-manager.js';\nimport type { ModelManager } from '../models/index.js';\n\nexport type DirectInboundAttachment = {\n  type: string;\n  mimeType?: string;\n  data?: string;\n  name?: string;\n  size?: number;\n  workspaceRelativePath?: string;\n};\n\nexport type DirectMessagePart =\n  | { type: 'text'; text: string }\n  | { type: 'image'; data: string; mimeType: string };\n\n/**\n * Build user message parts (text + resolved images/files) for direct / webchat turns.\n */\nexport async function buildDirectUserMessageContent(opts: {\n  content: string;\n  attachments?: DirectInboundAttachment[];\n  sessionKey?: string;\n  config: Config;\n  agentManager: AgentManager;\n  modelManager: ModelManager;\n}): Promise<DirectMessagePart[]> {\n  const { content, attachments, sessionKey, config, agentManager, modelManager } = opts;\n  const messageContent: DirectMessagePart[] = [];\n  const sk = sessionKey ?? '';\n\n  if (content.trim()) {\n    let textPart = content;\n    if (/@file:/.test(textPart)) {\n      const wsKey = sk !== '' ? sk : 'cli:direct';\n      const root = agentManager.getResolvedWorkspaceForSession(wsKey);\n      textPart = await expandAtFileMentionsInPlainText(textPart, root);\n    }\n    messageContent.push({ type: 'text', text: textPart });\n  }\n\n  if (!attachments?.length) {\n    return messageContent;\n  }\n\n  const modelRef =\n    sk !== ''\n      ? modelManager.getModelForSession(sk)\n      : getAgentDefaultModelRef(config) ?? getDefaultModelSync(config);\n\n  const storageRoot =\n    sk !== ''\n      ? resolveAgentHomeDir(config, extractProfileAgentId(sk, config))\n      : resolveAgentHomeDir(config, resolveDefaultAgentId(config));\n\n  let i = 0;\n  while (i < attachments.length) {\n    const att = attachments[i]!;\n    const isImage =\n      att.type === 'image' ||\n      att.type === 'photo' ||\n      Boolean(att.mimeType?.startsWith('image/'));\n\n    if (isImage) {\n      const group: Array<{ data: string; mimeType: string }> = [];\n      while (i < attachments.length) {\n        const a = attachments[i]!;\n        const img = a.type === 'image' || a.type === 'photo' || Boolean(a.mimeType?.startsWith('image/'));\n        if (!img) {\n          break;\n        }\n        if (!a.data || a.data.length === 0) {\n          i += 1;\n          continue;\n        }\n        group.push({ data: a.data, mimeType: a.mimeType || 'image/png' });\n        i += 1;\n      }\n      if (group.length > 0) {\n        const parts = await resolveInboundImageContentParts({\n          modelRef: modelRef || getDefaultModelSync(config),\n          cfg: config,\n          userTextForContext: content.trim() ? content : '',\n          images: group,\n        });\n        messageContent.push(...parts);\n      }\n    } else {\n      const fileBlock = formatInboundFileTextBlock(att, storageRoot);\n      messageContent.push({ type: 'text', text: fileBlock });\n      i += 1;\n    }\n  }\n\n  return messageContent;\n}\n"],"mappings":";;;;;;;;aACiE;gBACF;kBAIgB;;;;AAqB/E,eAAsB,8BAA8B,MAOnB;CAC/B,MAAM,EAAE,SAAS,aAAa,YAAY,QAAQ,cAAc,iBAAiB;CACjF,MAAM,iBAAsC,EAAE;CAC9C,MAAM,KAAK,cAAc;AAEzB,KAAI,QAAQ,MAAM,EAAE;EAClB,IAAI,WAAW;AACf,MAAI,SAAS,KAAK,SAAS,EAAE;GAC3B,MAAM,QAAQ,OAAO,KAAK,KAAK;GAC/B,MAAM,OAAO,aAAa,+BAA+B,MAAM;AAC/D,cAAW,MAAM,gCAAgC,UAAU,KAAK;;AAElE,iBAAe,KAAK;GAAE,MAAM;GAAQ,MAAM;GAAU,CAAC;;AAGvD,KAAI,CAAC,aAAa,OAChB,QAAO;CAGT,MAAM,WACJ,OAAO,KACH,aAAa,mBAAmB,GAAG,GACnC,wBAAwB,OAAO,IAAI,oBAAoB,OAAO;CAEpE,MAAM,cACJ,OAAO,KACH,oBAAoB,QAAQ,sBAAsB,IAAI,OAAO,CAAC,GAC9D,oBAAoB,QAAQ,sBAAsB,OAAO,CAAC;CAEhE,IAAI,IAAI;AACR,QAAO,IAAI,YAAY,QAAQ;EAC7B,MAAM,MAAM,YAAY;AAMxB,MAJE,IAAI,SAAS,WACb,IAAI,SAAS,WACb,QAAQ,IAAI,UAAU,WAAW,SAAS,CAAC,EAEhC;GACX,MAAM,QAAmD,EAAE;AAC3D,UAAO,IAAI,YAAY,QAAQ;IAC7B,MAAM,IAAI,YAAY;AAEtB,QAAI,EADQ,EAAE,SAAS,WAAW,EAAE,SAAS,WAAW,QAAQ,EAAE,UAAU,WAAW,SAAS,CAAC,EAE/F;AAEF,QAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,WAAW,GAAG;AAClC,UAAK;AACL;;AAEF,UAAM,KAAK;KAAE,MAAM,EAAE;KAAM,UAAU,EAAE,YAAY;KAAa,CAAC;AACjE,SAAK;;AAEP,OAAI,MAAM,SAAS,GAAG;IACpB,MAAM,QAAQ,MAAM,gCAAgC;KAClD,UAAU,YAAY,oBAAoB,OAAO;KACjD,KAAK;KACL,oBAAoB,QAAQ,MAAM,GAAG,UAAU;KAC/C,QAAQ;KACT,CAAC;AACF,mBAAe,KAAK,GAAG,MAAM;;SAE1B;GACL,MAAM,YAAY,2BAA2B,KAAK,YAAY;AAC9D,kBAAe,KAAK;IAAE,MAAM;IAAQ,MAAM;IAAW,CAAC;AACtD,QAAK;;;AAIT,QAAO"}
+{"version":3,"file":"build-direct-message-content.js","names":[],"sources":["../../../../src/agent/service/build-direct-message-content.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport { getAgentDefaultModelRef } from '../../config/schema.js';\nimport { getDefaultModelSync } from '../../providers/index.js';\nimport { formatInboundFileTextBlock } from '../../channels/attachments/inbound-persist.js';\nimport { expandAtFileMentionsInPlainText } from '../context/expand-at-file-mentions.js';\nimport { resolveInboundImageContentParts } from '../image/inbound-image-handling.js';\nimport { resolveAgentHomeDir, resolveDefaultAgentId } from '../agent-scope.js';\nimport { extractProfileAgentId } from '../../config/agent-profile.js';\nimport type { AgentInstanceGateway } from '../agent-instance-gateway.js';\nimport type { ModelManager } from '../models/index.js';\n\nexport type DirectInboundAttachment = {\n  type: string;\n  mimeType?: string;\n  data?: string;\n  name?: string;\n  size?: number;\n  workspaceRelativePath?: string;\n};\n\nexport type DirectMessagePart =\n  | { type: 'text'; text: string }\n  | { type: 'image'; data: string; mimeType: string };\n\n/**\n * Build user message parts (text + resolved images/files) for direct / webchat turns.\n */\nexport async function buildDirectUserMessageContent(opts: {\n  content: string;\n  attachments?: DirectInboundAttachment[];\n  sessionKey?: string;\n  config: Config;\n  agentManager: AgentInstanceGateway;\n  modelManager: ModelManager;\n}): Promise<DirectMessagePart[]> {\n  const { content, attachments, sessionKey, config, agentManager, modelManager } = opts;\n  const messageContent: DirectMessagePart[] = [];\n  const sk = sessionKey ?? '';\n\n  if (content.trim()) {\n    let textPart = content;\n    if (/@file:/.test(textPart)) {\n      const wsKey = sk !== '' ? sk : 'cli:direct';\n      const root = agentManager.getResolvedWorkspaceForSession(wsKey);\n      textPart = await expandAtFileMentionsInPlainText(textPart, root);\n    }\n    messageContent.push({ type: 'text', text: textPart });\n  }\n\n  if (!attachments?.length) {\n    return messageContent;\n  }\n\n  const modelRef =\n    sk !== ''\n      ? modelManager.getModelForSession(sk)\n      : getAgentDefaultModelRef(config) ?? getDefaultModelSync(config);\n\n  const storageRoot =\n    sk !== ''\n      ? resolveAgentHomeDir(config, extractProfileAgentId(sk, config))\n      : resolveAgentHomeDir(config, resolveDefaultAgentId(config));\n\n  let i = 0;\n  while (i < attachments.length) {\n    const att = attachments[i]!;\n    const isImage =\n      att.type === 'image' ||\n      att.type === 'photo' ||\n      Boolean(att.mimeType?.startsWith('image/'));\n\n    if (isImage) {\n      const group: Array<{ data: string; mimeType: string }> = [];\n      while (i < attachments.length) {\n        const a = attachments[i]!;\n        const img = a.type === 'image' || a.type === 'photo' || Boolean(a.mimeType?.startsWith('image/'));\n        if (!img) {\n          break;\n        }\n        if (!a.data || a.data.length === 0) {\n          i += 1;\n          continue;\n        }\n        group.push({ data: a.data, mimeType: a.mimeType || 'image/png' });\n        i += 1;\n      }\n      if (group.length > 0) {\n        const parts = await resolveInboundImageContentParts({\n          modelRef: modelRef || getDefaultModelSync(config),\n          cfg: config,\n          userTextForContext: content.trim() ? content : '',\n          images: group,\n        });\n        messageContent.push(...parts);\n      }\n    } else {\n      const fileBlock = formatInboundFileTextBlock(att, storageRoot);\n      messageContent.push({ type: 'text', text: fileBlock });\n      i += 1;\n    }\n  }\n\n  return messageContent;\n}\n"],"mappings":";;;;;;;;aACiE;gBACF;kBAIgB;;;;AAqB/E,eAAsB,8BAA8B,MAOnB;CAC/B,MAAM,EAAE,SAAS,aAAa,YAAY,QAAQ,cAAc,iBAAiB;CACjF,MAAM,iBAAsC,EAAE;CAC9C,MAAM,KAAK,cAAc;AAEzB,KAAI,QAAQ,MAAM,EAAE;EAClB,IAAI,WAAW;AACf,MAAI,SAAS,KAAK,SAAS,EAAE;GAC3B,MAAM,QAAQ,OAAO,KAAK,KAAK;GAC/B,MAAM,OAAO,aAAa,+BAA+B,MAAM;AAC/D,cAAW,MAAM,gCAAgC,UAAU,KAAK;;AAElE,iBAAe,KAAK;GAAE,MAAM;GAAQ,MAAM;GAAU,CAAC;;AAGvD,KAAI,CAAC,aAAa,OAChB,QAAO;CAGT,MAAM,WACJ,OAAO,KACH,aAAa,mBAAmB,GAAG,GACnC,wBAAwB,OAAO,IAAI,oBAAoB,OAAO;CAEpE,MAAM,cACJ,OAAO,KACH,oBAAoB,QAAQ,sBAAsB,IAAI,OAAO,CAAC,GAC9D,oBAAoB,QAAQ,sBAAsB,OAAO,CAAC;CAEhE,IAAI,IAAI;AACR,QAAO,IAAI,YAAY,QAAQ;EAC7B,MAAM,MAAM,YAAY;AAMxB,MAJE,IAAI,SAAS,WACb,IAAI,SAAS,WACb,QAAQ,IAAI,UAAU,WAAW,SAAS,CAAC,EAEhC;GACX,MAAM,QAAmD,EAAE;AAC3D,UAAO,IAAI,YAAY,QAAQ;IAC7B,MAAM,IAAI,YAAY;AAEtB,QAAI,EADQ,EAAE,SAAS,WAAW,EAAE,SAAS,WAAW,QAAQ,EAAE,UAAU,WAAW,SAAS,CAAC,EAE/F;AAEF,QAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,WAAW,GAAG;AAClC,UAAK;AACL;;AAEF,UAAM,KAAK;KAAE,MAAM,EAAE;KAAM,UAAU,EAAE,YAAY;KAAa,CAAC;AACjE,SAAK;;AAEP,OAAI,MAAM,SAAS,GAAG;IACpB,MAAM,QAAQ,MAAM,gCAAgC;KAClD,UAAU,YAAY,oBAAoB,OAAO;KACjD,KAAK;KACL,oBAAoB,QAAQ,MAAM,GAAG,UAAU;KAC/C,QAAQ;KACT,CAAC;AACF,mBAAe,KAAK,GAAG,MAAM;;SAE1B;GACL,MAAM,YAAY,2BAA2B,KAAK,YAAY;AAC9D,kBAAe,KAAK;IAAE,MAAM;IAAQ,MAAM;IAAW,CAAC;AACtD,QAAK;;;AAIT,QAAO"}

package/dist/src/agent/service/direct-turn-helpers.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Shared building blocks for the two direct-turn entry points (streaming
+ * webchat SSE and one-shot CLI). Both flows do the same hydrate → maybe-slash
+ * → run-embedded-turn → after-turn dance; this module captures that core so
+ * the entry points only manage their I/O specifics (event sink, voice STT,
+ * TTS, transcript persistence).
+ */
+import type { CommandHandler } from '../messaging/command-handler.js';
+import type { SessionStore } from '../../session/index.js';
+import type { Config } from '../../config/schema.js';
+import type { AgentInstanceGateway } from '../agent-instance-gateway.js';
+import type { ModelManager } from '../models/index.js';
+import type { EmbeddedStreamEvent } from '../embedded/types.js';
+import type { AgentMessage } from '@earendil-works/pi-agent-core';
+export interface HydratePerTurnStateDeps {
+    hydrateSessionWorkspaceFromStore: (sessionKey: string) => Promise<void>;
+    hydrateSessionModelFromStore: (sessionKey: string) => Promise<void>;
+    applyResolvedThinkingLevel: (sessionKey: string, thinking?: string | null) => Promise<void>;
+}
+/** Workspace + model + thinking level — common prep before any direct turn. */
+export declare function hydratePerTurnState(deps: HydratePerTurnStateDeps, sessionKey: string, thinking?: string): Promise<void>;
+export interface SlashCommandOutcome {
+    /** True if the input parsed as a registered slash command (handled or not). */
+    matched: boolean;
+    /** Aggregated user-visible reply text (assistant view). */
+    aggregatedText: string;
+    /** The parsed command name when matched. */
+    command?: string;
+}
+export interface TryRunSlashCommandDeps {
+    commandHandler: Pick<CommandHandler, 'executeCommandAndAggregateReply'>;
+    log: {
+        warn: (obj: Record<string, unknown>, msg: string) => void;
+    };
+}
+/**
+ * Detect a slash command and, if registered, execute it and aggregate the reply
+ * text. Errors thrown inside the command surface as `aggregatedText` so callers
+ * can persist the receipt or stream it as a token.
+ */
+export declare function tryRunSlashCommand(deps: TryRunSlashCommandDeps, ctx: {
+    sessionKey: string;
+    channel: string;
+    chatId: string;
+    senderId?: string;
+    isGroup?: boolean;
+    inboundMetadata?: Record<string, unknown>;
+}, content: string): Promise<SlashCommandOutcome>;
+export interface RunDirectAgentTurnDeps {
+    sessionStore: SessionStore;
+    agentManager: AgentInstanceGateway;
+    modelManager: ModelManager;
+    config: Config | undefined;
+}
+export interface RunDirectAgentTurnInput {
+    sessionKey: string;
+    userMessage: AgentMessage;
+    abortSignal?: AbortSignal;
+    onEvent?: (event: EmbeddedStreamEvent) => void;
+}
+export interface RunDirectAgentTurnResult {
+    ok: boolean;
+    errorMessage?: string;
+    lastAssistantText?: string;
+}
+/**
+ * Convert a user message into an embedded turn, including the standard memory
+ * prefetch + background-review nudge wiring used by every direct entry point.
+ */
+export declare function runDirectAgentTurn(deps: RunDirectAgentTurnDeps, input: RunDirectAgentTurnInput): Promise<RunDirectAgentTurnResult>;

package/dist/src/agent/service/direct-turn-helpers.js

@@ -0,0 +1,90 @@
+import { extractAgentUserPlainText } from "../memory/user-message-text.js";
+import { parseSlashCommand } from "../../chat-commands/command-parse.js";
+import { commandRegistry } from "../../chat-commands/registry.js";
+import "../../chat-commands/index.js";
+import { runEmbeddedTurnForSession } from "../embedded/run-for-session.js";
+import crypto from "node:crypto";
+//#region src/agent/service/direct-turn-helpers.ts
+/**
+* Shared building blocks for the two direct-turn entry points (streaming
+* webchat SSE and one-shot CLI). Both flows do the same hydrate → maybe-slash
+* → run-embedded-turn → after-turn dance; this module captures that core so
+* the entry points only manage their I/O specifics (event sink, voice STT,
+* TTS, transcript persistence).
+*/
+/** Workspace + model + thinking level — common prep before any direct turn. */
+async function hydratePerTurnState(deps, sessionKey, thinking) {
+	await deps.hydrateSessionWorkspaceFromStore(sessionKey);
+	await deps.hydrateSessionModelFromStore(sessionKey);
+	await deps.applyResolvedThinkingLevel(sessionKey, thinking);
+}
+/**
+* Detect a slash command and, if registered, execute it and aggregate the reply
+* text. Errors thrown inside the command surface as `aggregatedText` so callers
+* can persist the receipt or stream it as a token.
+*/
+async function tryRunSlashCommand(deps, ctx, content) {
+	const parsed = parseSlashCommand(content);
+	if (!parsed) return {
+		matched: false,
+		aggregatedText: ""
+	};
+	if (!commandRegistry.has(parsed.command)) return {
+		matched: false,
+		aggregatedText: ""
+	};
+	try {
+		const { aggregatedText } = await deps.commandHandler.executeCommandAndAggregateReply(parsed.command, parsed.args, {
+			sessionKey: ctx.sessionKey,
+			channel: ctx.channel,
+			chatId: ctx.chatId,
+			senderId: ctx.senderId ?? "",
+			isGroup: ctx.isGroup ?? false,
+			inboundMetadata: ctx.inboundMetadata ?? {}
+		});
+		return {
+			matched: true,
+			aggregatedText: aggregatedText ?? "",
+			command: parsed.command
+		};
+	} catch (err) {
+		const em = err instanceof Error ? err.message : String(err);
+		deps.log.warn({
+			err,
+			sessionKey: ctx.sessionKey,
+			command: parsed.command
+		}, `Slash command failed: ${em}`);
+		return {
+			matched: true,
+			aggregatedText: `Command error: ${em}`,
+			command: parsed.command
+		};
+	}
+}
+/**
+* Convert a user message into an embedded turn, including the standard memory
+* prefetch + background-review nudge wiring used by every direct entry point.
+*/
+async function runDirectAgentTurn(deps, input) {
+	const userPlain = extractAgentUserPlainText(input.userMessage);
+	const userMessageForModel = await deps.agentManager.applyMemoryPrefetchToUserMessage(input.userMessage, input.sessionKey);
+	const result = await runEmbeddedTurnForSession({
+		sessionKey: input.sessionKey,
+		runId: crypto.randomUUID(),
+		userMessage: userMessageForModel,
+		sessionStore: deps.sessionStore,
+		agentManager: deps.agentManager,
+		modelManager: deps.modelManager,
+		getConfig: () => deps.config,
+		abortSignal: input.abortSignal,
+		beforeTurn: () => deps.agentManager.beginBackgroundReviewUserTurn(input.sessionKey),
+		onEvent: input.onEvent
+	});
+	deps.agentManager.afterAgentTurn(input.sessionKey, userPlain);
+	deps.agentManager.scheduleBackgroundReviewAfterUserTurn(input.sessionKey);
+	return result;
+}
+//#endregion
+export { hydratePerTurnState, runDirectAgentTurn, tryRunSlashCommand };
+
+//# sourceMappingURL=direct-turn-helpers.js.map

package/dist/src/agent/service/direct-turn-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-turn-helpers.js","names":[],"sources":["../../../../src/agent/service/direct-turn-helpers.ts"],"sourcesContent":["/**\n * Shared building blocks for the two direct-turn entry points (streaming\n * webchat SSE and one-shot CLI). Both flows do the same hydrate → maybe-slash\n * → run-embedded-turn → after-turn dance; this module captures that core so\n * the entry points only manage their I/O specifics (event sink, voice STT,\n * TTS, transcript persistence).\n */\n\nimport crypto from 'node:crypto';\n\nimport { commandRegistry } from '../../chat-commands/index.js';\nimport { parseSlashCommand } from '../../chat-commands/command-parse.js';\nimport type { CommandHandler } from '../messaging/command-handler.js';\nimport type { SessionStore } from '../../session/index.js';\nimport type { Config } from '../../config/schema.js';\nimport type { AgentInstanceGateway } from '../agent-instance-gateway.js';\nimport type { ModelManager } from '../models/index.js';\nimport { extractAgentUserPlainText } from '../memory/user-message-text.js';\nimport { runEmbeddedTurnForSession } from '../embedded/run-for-session.js';\nimport type { EmbeddedStreamEvent } from '../embedded/types.js';\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nexport interface HydratePerTurnStateDeps {\n  hydrateSessionWorkspaceFromStore: (sessionKey: string) => Promise<void>;\n  hydrateSessionModelFromStore: (sessionKey: string) => Promise<void>;\n  applyResolvedThinkingLevel: (sessionKey: string, thinking?: string | null) => Promise<void>;\n}\n\n/** Workspace + model + thinking level — common prep before any direct turn. */\nexport async function hydratePerTurnState(\n  deps: HydratePerTurnStateDeps,\n  sessionKey: string,\n  thinking?: string,\n): Promise<void> {\n  await deps.hydrateSessionWorkspaceFromStore(sessionKey);\n  await deps.hydrateSessionModelFromStore(sessionKey);\n  await deps.applyResolvedThinkingLevel(sessionKey, thinking);\n}\n\nexport interface SlashCommandOutcome {\n  /** True if the input parsed as a registered slash command (handled or not). */\n  matched: boolean;\n  /** Aggregated user-visible reply text (assistant view). */\n  aggregatedText: string;\n  /** The parsed command name when matched. */\n  command?: string;\n}\n\nexport interface TryRunSlashCommandDeps {\n  commandHandler: Pick<CommandHandler, 'executeCommandAndAggregateReply'>;\n  log: { warn: (obj: Record<string, unknown>, msg: string) => void };\n}\n\n/**\n * Detect a slash command and, if registered, execute it and aggregate the reply\n * text. Errors thrown inside the command surface as `aggregatedText` so callers\n * can persist the receipt or stream it as a token.\n */\nexport async function tryRunSlashCommand(\n  deps: TryRunSlashCommandDeps,\n  ctx: {\n    sessionKey: string;\n    channel: string;\n    chatId: string;\n    senderId?: string;\n    isGroup?: boolean;\n    inboundMetadata?: Record<string, unknown>;\n  },\n  content: string,\n): Promise<SlashCommandOutcome> {\n  const parsed = parseSlashCommand(content);\n  if (!parsed) {\n    return { matched: false, aggregatedText: '' };\n  }\n  if (!commandRegistry.has(parsed.command)) {\n    return { matched: false, aggregatedText: '' };\n  }\n  try {\n    const { aggregatedText } = await deps.commandHandler.executeCommandAndAggregateReply(\n      parsed.command,\n      parsed.args,\n      {\n        sessionKey: ctx.sessionKey,\n        channel: ctx.channel,\n        chatId: ctx.chatId,\n        senderId: ctx.senderId ?? '',\n        isGroup: ctx.isGroup ?? false,\n        inboundMetadata: ctx.inboundMetadata ?? {},\n      },\n    );\n    return { matched: true, aggregatedText: aggregatedText ?? '', command: parsed.command };\n  } catch (err) {\n    const em = err instanceof Error ? err.message : String(err);\n    deps.log.warn(\n      { err, sessionKey: ctx.sessionKey, command: parsed.command },\n      `Slash command failed: ${em}`,\n    );\n    return { matched: true, aggregatedText: `Command error: ${em}`, command: parsed.command };\n  }\n}\n\nexport interface RunDirectAgentTurnDeps {\n  sessionStore: SessionStore;\n  agentManager: AgentInstanceGateway;\n  modelManager: ModelManager;\n  config: Config | undefined;\n}\n\nexport interface RunDirectAgentTurnInput {\n  sessionKey: string;\n  userMessage: AgentMessage;\n  abortSignal?: AbortSignal;\n  onEvent?: (event: EmbeddedStreamEvent) => void;\n}\n\nexport interface RunDirectAgentTurnResult {\n  ok: boolean;\n  errorMessage?: string;\n  lastAssistantText?: string;\n}\n\n/**\n * Convert a user message into an embedded turn, including the standard memory\n * prefetch + background-review nudge wiring used by every direct entry point.\n */\nexport async function runDirectAgentTurn(\n  deps: RunDirectAgentTurnDeps,\n  input: RunDirectAgentTurnInput,\n): Promise<RunDirectAgentTurnResult> {\n  const userPlain = extractAgentUserPlainText(input.userMessage);\n  const userMessageForModel = await deps.agentManager.applyMemoryPrefetchToUserMessage(\n    input.userMessage,\n    input.sessionKey,\n  );\n\n  const result = await runEmbeddedTurnForSession({\n    sessionKey: input.sessionKey,\n    runId: crypto.randomUUID(),\n    userMessage: userMessageForModel,\n    sessionStore: deps.sessionStore,\n    agentManager: deps.agentManager,\n    modelManager: deps.modelManager,\n    getConfig: () => deps.config,\n    abortSignal: input.abortSignal,\n    beforeTurn: () => deps.agentManager.beginBackgroundReviewUserTurn(input.sessionKey),\n    onEvent: input.onEvent,\n  });\n\n  deps.agentManager.afterAgentTurn(input.sessionKey, userPlain);\n  deps.agentManager.scheduleBackgroundReviewAfterUserTurn(input.sessionKey);\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;AA6BA,eAAsB,oBACpB,MACA,YACA,UACe;AACf,OAAM,KAAK,iCAAiC,WAAW;AACvD,OAAM,KAAK,6BAA6B,WAAW;AACnD,OAAM,KAAK,2BAA2B,YAAY,SAAS;;;;;;;AAsB7D,eAAsB,mBACpB,MACA,KAQA,SAC8B;CAC9B,MAAM,SAAS,kBAAkB,QAAQ;AACzC,KAAI,CAAC,OACH,QAAO;EAAE,SAAS;EAAO,gBAAgB;EAAI;AAE/C,KAAI,CAAC,gBAAgB,IAAI,OAAO,QAAQ,CACtC,QAAO;EAAE,SAAS;EAAO,gBAAgB;EAAI;AAE/C,KAAI;EACF,MAAM,EAAE,mBAAmB,MAAM,KAAK,eAAe,gCACnD,OAAO,SACP,OAAO,MACP;GACE,YAAY,IAAI;GAChB,SAAS,IAAI;GACb,QAAQ,IAAI;GACZ,UAAU,IAAI,YAAY;GAC1B,SAAS,IAAI,WAAW;GACxB,iBAAiB,IAAI,mBAAmB,EAAE;GAC3C,CACF;AACD,SAAO;GAAE,SAAS;GAAM,gBAAgB,kBAAkB;GAAI,SAAS,OAAO;GAAS;UAChF,KAAK;EACZ,MAAM,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAC3D,OAAK,IAAI,KACP;GAAE;GAAK,YAAY,IAAI;GAAY,SAAS,OAAO;GAAS,EAC5D,yBAAyB,KAC1B;AACD,SAAO;GAAE,SAAS;GAAM,gBAAgB,kBAAkB;GAAM,SAAS,OAAO;GAAS;;;;;;;AA4B7F,eAAsB,mBACpB,MACA,OACmC;CACnC,MAAM,YAAY,0BAA0B,MAAM,YAAY;CAC9D,MAAM,sBAAsB,MAAM,KAAK,aAAa,iCAClD,MAAM,aACN,MAAM,WACP;CAED,MAAM,SAAS,MAAM,0BAA0B;EAC7C,YAAY,MAAM;EAClB,OAAO,OAAO,YAAY;EAC1B,aAAa;EACb,cAAc,KAAK;EACnB,cAAc,KAAK;EACnB,cAAc,KAAK;EACnB,iBAAiB,KAAK;EACtB,aAAa,MAAM;EACnB,kBAAkB,KAAK,aAAa,8BAA8B,MAAM,WAAW;EACnF,SAAS,MAAM;EAChB,CAAC;AAEF,MAAK,aAAa,eAAe,MAAM,YAAY,UAAU;AAC7D,MAAK,aAAa,sCAAsC,MAAM,WAAW;AAEzE,QAAO"}

package/dist/src/agent/service/process-direct-one-shot.d.ts

@@ -1,10 +1,10 @@
 import type { CommandHandler } from '../messaging/command-handler.js';
-import type { ProcessDirectStreamLog } from './process-direct-streaming.js';
-import type { AgentManager } from '../agent-manager.js';
+import type { AgentInstanceGateway } from '../agent-instance-gateway.js';
 import type { ModelManager } from '../models/index.js';
 import type { SessionStore } from '../../session/index.js';
 import type { Config } from '../../config/schema.js';
 import { type DirectInboundAttachment } from './build-direct-message-content.js';
+import type { ProcessDirectStreamLog } from './process-direct-streaming.js';
 export type RunProcessDirectDeps = {
     log: ProcessDirectStreamLog;
     config: Config;
@@ -15,7 +15,7 @@ export type RunProcessDirectDeps = {
     initSessionContext: (sessionKey: string, channel: string, chatId: string) => void;
     hydrateSessionWorkspaceFromStore: (sessionKey: string) => Promise<void>;
     hydrateSessionModelFromStore: (sessionKey: string) => Promise<void>;
-    agentManager: AgentManager;
+    agentManager: AgentInstanceGateway;
     sessionStore: SessionStore;
     modelManager: ModelManager;
     applyResolvedThinkingLevel: (sessionKey: string, thinking?: string | null) => Promise<void>;

package/dist/src/agent/service/process-direct-one-shot.js

@@ -1,31 +1,21 @@
 import { appendPiTranscriptMessage } from "../../session/parity/jsonl-transcript-io.js";
-import { extractAgentUserPlainText } from "../memory/user-message-text.js";
-import { parseSlashCommand } from "../../chat-commands/command-parse.js";
-import { commandRegistry } from "../../chat-commands/registry.js";
-import "../../chat-commands/index.js";
-import { runEmbeddedTurnForSession } from "../embedded/run-for-session.js";
 import { buildDirectUserMessageContent } from "./build-direct-message-content.js";
-import crypto from "node:crypto";
+import { hydratePerTurnState, runDirectAgentTurn, tryRunSlashCommand } from "./direct-turn-helpers.js";
 //#region src/agent/service/process-direct-one-shot.ts
 async function runProcessDirect(deps, input) {
 	const { channel, chatId } = deps.parseSessionKey(input.sessionKey);
 	deps.initSessionContext(input.sessionKey, channel, chatId);
 	try {
-		await deps.hydrateSessionWorkspaceFromStore(input.sessionKey);
-		await deps.hydrateSessionModelFromStore(input.sessionKey);
-		await deps.applyResolvedThinkingLevel(input.sessionKey, input.thinking);
+		await hydratePerTurnState(deps, input.sessionKey, input.thinking);
 		const prepared = await deps.prepareInboundAttachments(input.sessionKey, input.attachments);
-		const cmd = parseSlashCommand(input.content);
-		if (cmd && commandRegistry.has(cmd.command)) {
-			const { aggregatedText } = await deps.commandHandler.executeCommandAndAggregateReply(cmd.command, cmd.args, {
-				sessionKey: input.sessionKey,
-				channel,
-				chatId,
-				senderId: "",
-				isGroup: false,
-				inboundMetadata: {}
-			});
-			if (aggregatedText?.trim()) {
+		const slash = await tryRunSlashCommand(deps, {
+			sessionKey: input.sessionKey,
+			channel,
+			chatId
+		}, input.content);
+		if (slash.matched) {
+			const trimmed = slash.aggregatedText.trim();
+			if (trimmed) {
 				const { absPath } = await deps.sessionStore.resolveTranscriptPath(input.sessionKey);
 				await appendPiTranscriptMessage({
 					absPath,
@@ -34,14 +24,14 @@ async function runProcessDirect(deps, input) {
 						role: "assistant",
 						content: [{
 							type: "text",
-							text: aggregatedText.trim()
+							text: trimmed
 						}],
 						timestamp: Date.now()
 					},
 					sessionKey: input.sessionKey
 				});
 			}
-			return aggregatedText ?? "";
+			return slash.aggregatedText ?? "";
 		}
 		const userMessage = {
 			role: "user",
@@ -55,20 +45,13 @@ async function runProcessDirect(deps, input) {
 			}),
 			timestamp: Date.now()
 		};
-		const userPlain = extractAgentUserPlainText(userMessage);
-		const userMessageForModel = await deps.agentManager.applyMemoryPrefetchToUserMessage(userMessage, input.sessionKey);
-		const result = await runEmbeddedTurnForSession({
+		const result = await runDirectAgentTurn({
+			...deps,
+			config: deps.config
+		}, {
 			sessionKey: input.sessionKey,
-			runId: crypto.randomUUID(),
-			userMessage: userMessageForModel,
-			sessionStore: deps.sessionStore,
-			agentManager: deps.agentManager,
-			modelManager: deps.modelManager,
-			getConfig: () => deps.config,
-			beforeTurn: () => deps.agentManager.beginBackgroundReviewUserTurn(input.sessionKey)
+			userMessage
 		});
-		deps.agentManager.afterAgentTurn(input.sessionKey, userPlain);
-		deps.agentManager.scheduleBackgroundReviewAfterUserTurn(input.sessionKey);
 		if (result.lastAssistantText) deps.onTurnComplete?.(input.sessionKey, result.lastAssistantText);
 		return result.lastAssistantText ?? "";
 	} finally {

package/dist/src/agent/service/process-direct-one-shot.js.map

@@ -1 +1 @@
-{"version":3,"file":"process-direct-one-shot.js","names":[],"sources":["../../../../src/agent/service/process-direct-one-shot.ts"],"sourcesContent":["import crypto from 'node:crypto';\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport { parseSlashCommand } from '../../chat-commands/command-parse.js';\nimport { commandRegistry } from '../../chat-commands/index.js';\nimport type { CommandHandler } from '../messaging/command-handler.js';\nimport { extractAgentUserPlainText } from '../memory/user-message-text.js';\nimport { runEmbeddedTurnForSession } from '../embedded/run-for-session.js';\nimport type { ProcessDirectStreamLog } from './process-direct-streaming.js';\nimport type { AgentManager } from '../agent-manager.js';\nimport type { ModelManager } from '../models/index.js';\nimport type { SessionStore } from '../../session/index.js';\nimport type { Config } from '../../config/schema.js';\nimport { appendPiTranscriptMessage } from '../../session/parity/jsonl-transcript-io.js';\nimport { buildDirectUserMessageContent, type DirectInboundAttachment } from './build-direct-message-content.js';\n\nexport type RunProcessDirectDeps = {\n  log: ProcessDirectStreamLog;\n  config: Config;\n  parseSessionKey: (sessionKey: string) => { channel: string; chatId: string };\n  initSessionContext: (sessionKey: string, channel: string, chatId: string) => void;\n  hydrateSessionWorkspaceFromStore: (sessionKey: string) => Promise<void>;\n  hydrateSessionModelFromStore: (sessionKey: string) => Promise<void>;\n  agentManager: AgentManager;\n  sessionStore: SessionStore;\n  modelManager: ModelManager;\n  applyResolvedThinkingLevel: (sessionKey: string, thinking?: string | null) => Promise<void>;\n  prepareInboundAttachments: (\n    sessionKey: string,\n    attachments?: DirectInboundAttachment[],\n  ) => Promise<DirectInboundAttachment[] | undefined>;\n  commandHandler: Pick<CommandHandler, 'executeCommandAndAggregateReply'>;\n  onTurnComplete?: (sessionKey: string, lastAssistantText?: string) => void;\n  endDirectRequestContext: () => void;\n};\n\nexport async function runProcessDirect(\n  deps: RunProcessDirectDeps,\n  input: {\n    content: string;\n    sessionKey: string;\n    attachments?: DirectInboundAttachment[];\n    thinking?: string;\n  },\n): Promise<string> {\n  const { channel, chatId } = deps.parseSessionKey(input.sessionKey);\n  deps.initSessionContext(input.sessionKey, channel, chatId);\n\n  try {\n    await deps.hydrateSessionWorkspaceFromStore(input.sessionKey);\n    await deps.hydrateSessionModelFromStore(input.sessionKey);\n    await deps.applyResolvedThinkingLevel(input.sessionKey, input.thinking);\n\n    const prepared = await deps.prepareInboundAttachments(input.sessionKey, input.attachments);\n\n    const cmd = parseSlashCommand(input.content);\n    if (cmd && commandRegistry.has(cmd.command)) {\n      const { aggregatedText } = await deps.commandHandler.executeCommandAndAggregateReply(cmd.command, cmd.args, {\n        sessionKey: input.sessionKey,\n        channel,\n        chatId,\n        senderId: '',\n        isGroup: false,\n        inboundMetadata: {},\n      });\n      if (aggregatedText?.trim()) {\n        const { absPath } = await deps.sessionStore.resolveTranscriptPath(input.sessionKey);\n        const workspaceDir = deps.agentManager.getResolvedWorkspaceForSession(input.sessionKey);\n        await appendPiTranscriptMessage({\n          absPath,\n          cwd: workspaceDir,\n          message: {\n            role: 'assistant',\n            content: [{ type: 'text', text: aggregatedText.trim() }],\n            timestamp: Date.now(),\n          } as AgentMessage,\n          sessionKey: input.sessionKey,\n        });\n      }\n      return aggregatedText ?? '';\n    }\n\n    const textForDirect = input.content.trimStart().startsWith('/skill:')\n      ? deps.agentManager.expandSkillUserText(input.content)\n      : input.content;\n    const messageContent = await buildDirectUserMessageContent({\n      content: textForDirect,\n      attachments: prepared,\n      sessionKey: input.sessionKey,\n      config: deps.config,\n      agentManager: deps.agentManager,\n      modelManager: deps.modelManager,\n    });\n\n    const userMessage = {\n      role: 'user' as const,\n      content: messageContent,\n      timestamp: Date.now(),\n    };\n    const userPlain = extractAgentUserPlainText(userMessage);\n    const userMessageForModel = await deps.agentManager.applyMemoryPrefetchToUserMessage(\n      userMessage,\n      input.sessionKey,\n    );\n\n    const result = await runEmbeddedTurnForSession({\n      sessionKey: input.sessionKey,\n      runId: crypto.randomUUID(),\n      userMessage: userMessageForModel,\n      sessionStore: deps.sessionStore,\n      agentManager: deps.agentManager,\n      modelManager: deps.modelManager,\n      getConfig: () => deps.config,\n      beforeTurn: () => deps.agentManager.beginBackgroundReviewUserTurn(input.sessionKey),\n    });\n\n    deps.agentManager.afterAgentTurn(input.sessionKey, userPlain);\n    deps.agentManager.scheduleBackgroundReviewAfterUserTurn(input.sessionKey);\n\n    if (result.lastAssistantText) {\n      deps.onTurnComplete?.(input.sessionKey, result.lastAssistantText);\n    }\n\n    return result.lastAssistantText ?? '';\n  } finally {\n    deps.endDirectRequestContext();\n  }\n}\n"],"mappings":";;;;;;;;;AAoCA,eAAsB,iBACpB,MACA,OAMiB;CACjB,MAAM,EAAE,SAAS,WAAW,KAAK,gBAAgB,MAAM,WAAW;AAClE,MAAK,mBAAmB,MAAM,YAAY,SAAS,OAAO;AAE1D,KAAI;AACF,QAAM,KAAK,iCAAiC,MAAM,WAAW;AAC7D,QAAM,KAAK,6BAA6B,MAAM,WAAW;AACzD,QAAM,KAAK,2BAA2B,MAAM,YAAY,MAAM,SAAS;EAEvE,MAAM,WAAW,MAAM,KAAK,0BAA0B,MAAM,YAAY,MAAM,YAAY;EAE1F,MAAM,MAAM,kBAAkB,MAAM,QAAQ;AAC5C,MAAI,OAAO,gBAAgB,IAAI,IAAI,QAAQ,EAAE;GAC3C,MAAM,EAAE,mBAAmB,MAAM,KAAK,eAAe,gCAAgC,IAAI,SAAS,IAAI,MAAM;IAC1G,YAAY,MAAM;IAClB;IACA;IACA,UAAU;IACV,SAAS;IACT,iBAAiB,EAAE;IACpB,CAAC;AACF,OAAI,gBAAgB,MAAM,EAAE;IAC1B,MAAM,EAAE,YAAY,MAAM,KAAK,aAAa,sBAAsB,MAAM,WAAW;AAEnF,UAAM,0BAA0B;KAC9B;KACA,KAHmB,KAAK,aAAa,+BAA+B,MAAM,WAGzD;KACjB,SAAS;MACP,MAAM;MACN,SAAS,CAAC;OAAE,MAAM;OAAQ,MAAM,eAAe,MAAM;OAAE,CAAC;MACxD,WAAW,KAAK,KAAK;MACtB;KACD,YAAY,MAAM;KACnB,CAAC;;AAEJ,UAAO,kBAAkB;;EAe3B,MAAM,cAAc;GAClB,MAAM;GACN,SAAS,MAXkB,8BAA8B;IACzD,SAJoB,MAAM,QAAQ,WAAW,CAAC,WAAW,UAAU,GACjE,KAAK,aAAa,oBAAoB,MAAM,QAAQ,GACpD,MAAM;IAGR,aAAa;IACb,YAAY,MAAM;IAClB,QAAQ,KAAK;IACb,cAAc,KAAK;IACnB,cAAc,KAAK;IACpB,CAAC;GAKA,WAAW,KAAK,KAAK;GACtB;EACD,MAAM,YAAY,0BAA0B,YAAY;EACxD,MAAM,sBAAsB,MAAM,KAAK,aAAa,iCAClD,aACA,MAAM,WACP;EAED,MAAM,SAAS,MAAM,0BAA0B;GAC7C,YAAY,MAAM;GAClB,OAAO,OAAO,YAAY;GAC1B,aAAa;GACb,cAAc,KAAK;GACnB,cAAc,KAAK;GACnB,cAAc,KAAK;GACnB,iBAAiB,KAAK;GACtB,kBAAkB,KAAK,aAAa,8BAA8B,MAAM,WAAW;GACpF,CAAC;AAEF,OAAK,aAAa,eAAe,MAAM,YAAY,UAAU;AAC7D,OAAK,aAAa,sCAAsC,MAAM,WAAW;AAEzE,MAAI,OAAO,kBACT,MAAK,iBAAiB,MAAM,YAAY,OAAO,kBAAkB;AAGnE,SAAO,OAAO,qBAAqB;WAC3B;AACR,OAAK,yBAAyB"}
+{"version":3,"file":"process-direct-one-shot.js","names":[],"sources":["../../../../src/agent/service/process-direct-one-shot.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { CommandHandler } from '../messaging/command-handler.js';\nimport type { AgentInstanceGateway } from '../agent-instance-gateway.js';\nimport type { ModelManager } from '../models/index.js';\nimport type { SessionStore } from '../../session/index.js';\nimport type { Config } from '../../config/schema.js';\nimport { appendPiTranscriptMessage } from '../../session/parity/jsonl-transcript-io.js';\nimport { buildDirectUserMessageContent, type DirectInboundAttachment } from './build-direct-message-content.js';\nimport type { ProcessDirectStreamLog } from './process-direct-streaming.js';\nimport {\n  hydratePerTurnState,\n  runDirectAgentTurn,\n  tryRunSlashCommand,\n} from './direct-turn-helpers.js';\n\nexport type RunProcessDirectDeps = {\n  log: ProcessDirectStreamLog;\n  config: Config;\n  parseSessionKey: (sessionKey: string) => { channel: string; chatId: string };\n  initSessionContext: (sessionKey: string, channel: string, chatId: string) => void;\n  hydrateSessionWorkspaceFromStore: (sessionKey: string) => Promise<void>;\n  hydrateSessionModelFromStore: (sessionKey: string) => Promise<void>;\n  agentManager: AgentInstanceGateway;\n  sessionStore: SessionStore;\n  modelManager: ModelManager;\n  applyResolvedThinkingLevel: (sessionKey: string, thinking?: string | null) => Promise<void>;\n  prepareInboundAttachments: (\n    sessionKey: string,\n    attachments?: DirectInboundAttachment[],\n  ) => Promise<DirectInboundAttachment[] | undefined>;\n  commandHandler: Pick<CommandHandler, 'executeCommandAndAggregateReply'>;\n  onTurnComplete?: (sessionKey: string, lastAssistantText?: string) => void;\n  endDirectRequestContext: () => void;\n};\n\nexport async function runProcessDirect(\n  deps: RunProcessDirectDeps,\n  input: {\n    content: string;\n    sessionKey: string;\n    attachments?: DirectInboundAttachment[];\n    thinking?: string;\n  },\n): Promise<string> {\n  const { channel, chatId } = deps.parseSessionKey(input.sessionKey);\n  deps.initSessionContext(input.sessionKey, channel, chatId);\n\n  try {\n    await hydratePerTurnState(deps, input.sessionKey, input.thinking);\n    const prepared = await deps.prepareInboundAttachments(input.sessionKey, input.attachments);\n\n    const slash = await tryRunSlashCommand(\n      deps,\n      { sessionKey: input.sessionKey, channel, chatId },\n      input.content,\n    );\n    if (slash.matched) {\n      const trimmed = slash.aggregatedText.trim();\n      if (trimmed) {\n        const { absPath } = await deps.sessionStore.resolveTranscriptPath(input.sessionKey);\n        const workspaceDir = deps.agentManager.getResolvedWorkspaceForSession(input.sessionKey);\n        await appendPiTranscriptMessage({\n          absPath,\n          cwd: workspaceDir,\n          message: {\n            role: 'assistant',\n            content: [{ type: 'text', text: trimmed }],\n            timestamp: Date.now(),\n          } as AgentMessage,\n          sessionKey: input.sessionKey,\n        });\n      }\n      return slash.aggregatedText ?? '';\n    }\n\n    const textForDirect = input.content.trimStart().startsWith('/skill:')\n      ? deps.agentManager.expandSkillUserText(input.content)\n      : input.content;\n    const messageContent = await buildDirectUserMessageContent({\n      content: textForDirect,\n      attachments: prepared,\n      sessionKey: input.sessionKey,\n      config: deps.config,\n      agentManager: deps.agentManager,\n      modelManager: deps.modelManager,\n    });\n\n    const userMessage = {\n      role: 'user' as const,\n      content: messageContent,\n      timestamp: Date.now(),\n    };\n\n    const result = await runDirectAgentTurn(\n      { ...deps, config: deps.config },\n      { sessionKey: input.sessionKey, userMessage },\n    );\n\n    if (result.lastAssistantText) {\n      deps.onTurnComplete?.(input.sessionKey, result.lastAssistantText);\n    }\n\n    return result.lastAssistantText ?? '';\n  } finally {\n    deps.endDirectRequestContext();\n  }\n}\n"],"mappings":";;;;AAoCA,eAAsB,iBACpB,MACA,OAMiB;CACjB,MAAM,EAAE,SAAS,WAAW,KAAK,gBAAgB,MAAM,WAAW;AAClE,MAAK,mBAAmB,MAAM,YAAY,SAAS,OAAO;AAE1D,KAAI;AACF,QAAM,oBAAoB,MAAM,MAAM,YAAY,MAAM,SAAS;EACjE,MAAM,WAAW,MAAM,KAAK,0BAA0B,MAAM,YAAY,MAAM,YAAY;EAE1F,MAAM,QAAQ,MAAM,mBAClB,MACA;GAAE,YAAY,MAAM;GAAY;GAAS;GAAQ,EACjD,MAAM,QACP;AACD,MAAI,MAAM,SAAS;GACjB,MAAM,UAAU,MAAM,eAAe,MAAM;AAC3C,OAAI,SAAS;IACX,MAAM,EAAE,YAAY,MAAM,KAAK,aAAa,sBAAsB,MAAM,WAAW;AAEnF,UAAM,0BAA0B;KAC9B;KACA,KAHmB,KAAK,aAAa,+BAA+B,MAAM,WAGzD;KACjB,SAAS;MACP,MAAM;MACN,SAAS,CAAC;OAAE,MAAM;OAAQ,MAAM;OAAS,CAAC;MAC1C,WAAW,KAAK,KAAK;MACtB;KACD,YAAY,MAAM;KACnB,CAAC;;AAEJ,UAAO,MAAM,kBAAkB;;EAejC,MAAM,cAAc;GAClB,MAAM;GACN,SAAS,MAXkB,8BAA8B;IACzD,SAJoB,MAAM,QAAQ,WAAW,CAAC,WAAW,UAAU,GACjE,KAAK,aAAa,oBAAoB,MAAM,QAAQ,GACpD,MAAM;IAGR,aAAa;IACb,YAAY,MAAM;IAClB,QAAQ,KAAK;IACb,cAAc,KAAK;IACnB,cAAc,KAAK;IACpB,CAAC;GAKA,WAAW,KAAK,KAAK;GACtB;EAED,MAAM,SAAS,MAAM,mBACnB;GAAE,GAAG;GAAM,QAAQ,KAAK;GAAQ,EAChC;GAAE,YAAY,MAAM;GAAY;GAAa,CAC9C;AAED,MAAI,OAAO,kBACT,MAAK,iBAAiB,MAAM,YAAY,OAAO,kBAAkB;AAGnE,SAAO,OAAO,qBAAqB;WAC3B;AACR,OAAK,yBAAyB"}