@xopcai/xopc 0.0.29 → 0.0.31

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

@@ -1 +1 @@
-{"version":3,"file":"process-direct-streaming.js","names":["msgEvent"],"sources":["../../../../src/agent/service/process-direct-streaming.ts"],"sourcesContent":["import type { AgentEvent, AgentMessage } from '@mariozechner/pi-agent-core';\n\nimport type { Config } from '../../config/schema.js';\nimport type { InternalAttachmentRoots } from '../../channels/attachments/inbound-persist.js';\nimport { commandRegistry } from '../../chat-commands/index.js';\nimport { parseSlashCommand } from '../../chat-commands/command-parse.js';\nimport {\n  mergeVoiceTranscriptsIntoUserText,\n  mergeSttConfigFromAppConfig,\n} from '../../channels/attachments/voice-stt-webchat.js';\nimport {\n  resolveEffectiveReasoningLevel,\n  type SessionConfigStore,\n  type SessionStore,\n} from '../../session/index.js';\nimport type { SessionContext } from '../session/index.js';\nimport {\n  extractTextContent,\n  extractThinkingContent,\n  extractThinkingFromAssistantMessage,\n} from '../context/workspace.js';\nimport { extractAgentUserPlainText } from '../memory/user-message-text.js';\nimport { runAgentTurnWithModelFallbacks } from '../orchestration/run-agent-turn-with-fallbacks.js';\nimport { applyReasoningVisibilityToSseEvent } from '../streaming/reasoning-visibility-sse.js';\nimport type { ReasoningLevel } from '../transcript/thinking-types.js';\nimport { serializeAgentToolResultForSse } from '../service-inbound-utils.js';\nimport type { AgentManager } from '../agent-manager.js';\nimport type { AgentEventHandler } from '../orchestration/agent-event-handler.js';\nimport type { AgentOrchestrator } from '../orchestration/agent-orchestrator.js';\nimport type { CommandHandler } from '../messaging/command-handler.js';\nimport type { ModelManager } from '../models/index.js';\n\nexport type DirectStreamInboundAttachment = {\n  type: string;\n  mimeType?: string;\n  data?: string;\n  name?: string;\n  size?: number;\n  workspaceRelativePath?: string;\n};\n\n/** Logger shape expected by {@link runAgentTurnWithModelFallbacks}. */\nexport type ProcessDirectStreamLog = {\n  info: (obj: Record<string, unknown>, msg: string) => void;\n  warn: (obj: Record<string, unknown>, msg: string) => void;\n  debug?: (obj: Record<string, unknown>, msg: string) => void;\n};\n\n/**\n * Explicit collaborators for {@link runProcessDirectStreaming} (gateway webchat / CLI direct stream).\n * Bound by `AgentService` from its private fields and methods.\n */\nexport interface ProcessDirectStreamingDeps {\n  log: ProcessDirectStreamLog;\n  parseSessionKey: (sessionKey: string) => { channel: string; chatId: string };\n  initDirectStreamingSession: (\n    sessionKey: string,\n    channel: string,\n    chatId: string,\n  ) => SessionContext;\n  registerWebchatSsePublisher: (\n    sessionKey: string,\n    publisher: (event: { type: string; [key: string]: unknown }) => void,\n  ) => void;\n  unregisterWebchatSsePublisher: (sessionKey: string) => void;\n  agentManager: AgentManager;\n  hydrateSessionWorkspaceFromStore: (sessionKey: string) => Promise<void>;\n  hydrateSessionModelFromStore: (sessionKey: string) => Promise<void>;\n  agentEventHandler: AgentEventHandler;\n  sessionStore: SessionStore;\n  prepareLoadedSessionMessages: (sessionKey: string, messages: AgentMessage[]) => AgentMessage[];\n  modelManager: ModelManager;\n  applyResolvedThinkingLevel: (sessionKey: string, thinking?: string | null) => Promise<void>;\n  getConfig: () => Config | undefined;\n  sessionConfigStore: SessionConfigStore;\n  attachmentRootsForSession: (sessionKey: string) => InternalAttachmentRoots;\n  agentOrchestrator: Pick<AgentOrchestrator, 'abort'>;\n  commandHandler: Pick<CommandHandler, 'executeCommandAndAggregateReply'>;\n  prepareInboundAttachments: (\n    sessionKey: string,\n    attachments?: DirectStreamInboundAttachment[],\n  ) => Promise<DirectStreamInboundAttachment[] | undefined>;\n  buildMessageContent: (\n    content: string,\n    attachments: DirectStreamInboundAttachment[] | undefined,\n    sessionKey: string,\n  ) => Promise<Array<{ type: 'text'; text: string } | { type: 'image'; data: string; mimeType: string }>>;\n  persistAgentSessionMessages: (sessionKey: string) => Promise<void>;\n  maybeEmitWebchatTts: (\n    sessionKey: string,\n    hadInboundVoice: boolean,\n  ) => Promise<{ type: 'tts_audio'; workspaceRelativePath: string; mimeType: string; name: string } | null>;\n  endDirectRequestContext: () => void;\n}\n\nexport interface ProcessDirectStreamingInput {\n  content: string;\n  sessionKey?: string;\n  attachments?: DirectStreamInboundAttachment[];\n  thinking?: string;\n  signal?: AbortSignal;\n}\n\nexport type ProcessDirectStreamingSseEvent = { type: string; [key: string]: unknown };\n\nexport async function* runProcessDirectStreaming(\n  deps: ProcessDirectStreamingDeps,\n  input: ProcessDirectStreamingInput,\n): AsyncGenerator<ProcessDirectStreamingSseEvent, void, unknown> {\n  const {\n    log,\n    parseSessionKey,\n    initDirectStreamingSession,\n    registerWebchatSsePublisher,\n    unregisterWebchatSsePublisher,\n    agentManager,\n    hydrateSessionWorkspaceFromStore,\n    hydrateSessionModelFromStore,\n    agentEventHandler,\n    sessionStore,\n    prepareLoadedSessionMessages,\n    modelManager,\n    applyResolvedThinkingLevel,\n    getConfig,\n    sessionConfigStore,\n    attachmentRootsForSession,\n    agentOrchestrator,\n    commandHandler,\n    prepareInboundAttachments,\n    buildMessageContent,\n    persistAgentSessionMessages,\n    maybeEmitWebchatTts,\n    endDirectRequestContext,\n  } = deps;\n\n  const sessionKey = input.sessionKey ?? 'cli:direct';\n  const { channel, chatId } = parseSessionKey(sessionKey);\n  const context = initDirectStreamingSession(sessionKey, channel, chatId);\n\n  const eventQueue: ProcessDirectStreamingSseEvent[] = [];\n  let resolveWaiting: (() => void) | null = null;\n  let agentDone = false;\n\n  let lastSentContent = '';\n  let lastSentThinking = '';\n  let reasoningLevel: ReasoningLevel = 'stream';\n\n  const enqueueSseEvent = (event: ProcessDirectStreamingSseEvent) => {\n    eventQueue.push(event);\n    if (resolveWaiting) {\n      resolveWaiting();\n      resolveWaiting = null;\n    }\n  };\n\n  const pushEvent = (event: ProcessDirectStreamingSseEvent) => {\n    const visible = applyReasoningVisibilityToSseEvent(event, reasoningLevel);\n    if (visible !== null) {\n      enqueueSseEvent(visible);\n    }\n  };\n\n  if (channel === 'webchat') {\n    registerWebchatSsePublisher(sessionKey, (e) => pushEvent(e));\n  }\n\n  const signal = input.signal;\n  let userAborted = false;\n  let abortHandled = false;\n\n  await hydrateSessionWorkspaceFromStore(sessionKey);\n  const agent = agentManager.getOrCreateAgent(sessionKey);\n  await hydrateSessionModelFromStore(sessionKey);\n  const unsubscribeStreaming = agent.subscribe((event: AgentEvent) => {\n    agentEventHandler.handle(event, context);\n\n    switch (event.type) {\n      case 'tool_execution_start': {\n        const toolEvent = event as Extract<AgentEvent, { type: 'tool_execution_start' }>;\n        const toolName =\n          typeof toolEvent.toolName === 'string' && toolEvent.toolName.trim()\n            ? toolEvent.toolName.trim()\n            : 'unknown';\n        pushEvent({\n          type: 'tool_start',\n          toolCallId: toolEvent.toolCallId,\n          toolName,\n          args: toolEvent.args,\n        });\n        break;\n      }\n      case 'tool_execution_end': {\n        const toolEvent = event as Extract<AgentEvent, { type: 'tool_execution_end' }>;\n        const toolName =\n          typeof toolEvent.toolName === 'string' && toolEvent.toolName.trim()\n            ? toolEvent.toolName.trim()\n            : 'unknown';\n        pushEvent({\n          type: 'tool_end',\n          toolCallId: toolEvent.toolCallId,\n          toolName,\n          isError: toolEvent.isError,\n          result: serializeAgentToolResultForSse(toolEvent.result),\n        });\n        break;\n      }\n      case 'message_update': {\n        const msgEvent = event as Extract<AgentEvent, { type: 'message_update' }>;\n        if (msgEvent.message?.role === 'assistant') {\n          const msgContent = msgEvent.message.content;\n          const blocks = Array.isArray(msgContent)\n            ? (msgContent as Array<{ type: string; text?: string }>)\n            : undefined;\n          const fullText = blocks ? extractTextContent(blocks) : String(msgContent);\n          const thinkingFromBlocks = blocks ? extractThinkingContent(blocks) : '';\n          const thinkingFromReasoning = extractThinkingFromAssistantMessage(msgEvent.message);\n          const thinkingText =\n            thinkingFromReasoning.length >= thinkingFromBlocks.length\n              ? thinkingFromReasoning\n              : thinkingFromBlocks;\n\n          if (fullText.length > lastSentContent.length) {\n            const delta = fullText.slice(lastSentContent.length);\n            if (delta) {\n              pushEvent({ type: 'token', content: delta });\n              lastSentContent = fullText;\n            }\n          } else if (fullText.length < lastSentContent.length) {\n            pushEvent({ type: 'token', content: fullText });\n            lastSentContent = fullText;\n          }\n\n          if (thinkingText.length > lastSentThinking.length) {\n            const thDelta = thinkingText.slice(lastSentThinking.length);\n            if (thDelta) {\n              pushEvent({ type: 'thinking', content: thDelta, delta: true });\n              lastSentThinking = thinkingText;\n            }\n          } else if (thinkingText.length < lastSentThinking.length) {\n            pushEvent({ type: 'thinking', content: thinkingText, delta: false });\n            lastSentThinking = thinkingText;\n          }\n        }\n        break;\n      }\n      case 'message_start': {\n        const msgEvent = event as Extract<AgentEvent, { type: 'message_start' }>;\n        if (msgEvent.message?.role === 'assistant') {\n          lastSentContent = '';\n          lastSentThinking = '';\n          pushEvent({ type: 'thinking', status: 'started' });\n        }\n        break;\n      }\n      case 'message_end': {\n        pushEvent({ type: 'message_end' });\n        break;\n      }\n      case 'agent_start': {\n        pushEvent({ type: 'progress', stage: 'thinking', message: 'Thinking...' });\n        break;\n      }\n      case 'agent_end': {\n        pushEvent({ type: 'progress', stage: 'idle', message: 'Done' });\n        break;\n      }\n      default:\n        break;\n    }\n  });\n\n  try {\n    const prepared = await prepareInboundAttachments(sessionKey, input.attachments);\n    let loaded = await sessionStore.load(sessionKey);\n    const lastMsg = loaded[loaded.length - 1] as { role?: string; webchatEarlySave?: boolean } | undefined;\n    if (lastMsg?.role === 'user' && lastMsg.webchatEarlySave === true) {\n      loaded = loaded.slice(0, -1);\n    }\n    agent.state.messages = prepareLoadedSessionMessages(sessionKey, loaded);\n\n    await modelManager.applyModelForSession(agent, sessionKey);\n    await applyResolvedThinkingLevel(sessionKey, input.thinking);\n    {\n      const defReason = (getConfig()?.agents?.defaults?.reasoningDefault ?? 'stream') as ReasoningLevel;\n      reasoningLevel = await resolveEffectiveReasoningLevel(sessionConfigStore, sessionKey, defReason);\n    }\n\n    const sttCfg = mergeSttConfigFromAppConfig(getConfig()?.stt);\n    const { text: mergedUserText, inboundVoice } = await mergeVoiceTranscriptsIntoUserText(\n      attachmentRootsForSession(sessionKey),\n      prepared,\n      input.content,\n      sttCfg,\n    );\n\n    const armAbort = () => {\n      if (abortHandled) {\n        return;\n      }\n      abortHandled = true;\n      userAborted = true;\n      agentOrchestrator.abort(sessionKey);\n      agentDone = true;\n      pushEvent({ type: '__done__' });\n    };\n    if (signal) {\n      if (signal.aborted) {\n        armAbort();\n      } else {\n        signal.addEventListener('abort', armAbort, { once: true });\n      }\n    }\n\n    const commandInfo = parseSlashCommand(mergedUserText);\n    let ranSlashCommand = false;\n    /** Plain text to persist for webchat slash turns (SSE can be dropped by the UI; disk is source of truth). */\n    let webchatSlashReceipt: string | undefined;\n    if (!abortHandled && commandInfo) {\n      if (commandRegistry.has(commandInfo.command)) {\n        ranSlashCommand = true;\n        try {\n          const { aggregatedText } = await commandHandler.executeCommandAndAggregateReply(\n            commandInfo.command,\n            commandInfo.args,\n            {\n              sessionKey,\n              channel,\n              chatId,\n              senderId: context.senderId,\n              isGroup: context.isGroup,\n            },\n          );\n          if (aggregatedText?.trim()) {\n            webchatSlashReceipt = aggregatedText.trim();\n            pushEvent({ type: 'token', content: webchatSlashReceipt });\n          } else if (channel === 'webchat') {\n            webchatSlashReceipt =\n              'Command finished with no assistant text. For `/goal`, that usually means the goal was saved; the assistant will not run until your next normal message (or an auto-continuation after an assistant reply).';\n            pushEvent({ type: 'token', content: webchatSlashReceipt });\n          }\n        } catch (cmdErr) {\n          const em = cmdErr instanceof Error ? cmdErr.message : String(cmdErr);\n          log.warn({ err: cmdErr, sessionKey, command: commandInfo.command }, `Slash command failed: ${em}`);\n          webchatSlashReceipt = `Command error: ${em}`;\n          pushEvent({ type: 'token', content: webchatSlashReceipt });\n        }\n        pushEvent({ type: '__done__' });\n        agentDone = true;\n      } else if (commandInfo.command === 'goal') {\n        // `/goal` is provided by the `standing-goal` bundled extension; avoid silent LLM fallback.\n        ranSlashCommand = true;\n        webchatSlashReceipt =\n          'The /goal command is not available: the `standing-goal` extension is not loaded.\\n\\n' +\n          'Fix: add `\"standing-goal\"` to `extensions.enabled` in your xopc config (or remove it from `extensions.disabled`), then restart the gateway. ' +\n          'If you use a strict allowlist, include `standing-goal` in `extensions.enabled`.';\n        pushEvent({\n          type: 'token',\n          content: webchatSlashReceipt,\n        });\n        pushEvent({ type: '__done__' });\n        agentDone = true;\n      }\n    }\n\n    let messageContent:\n      | Array<{ type: 'text'; text: string } | { type: 'image'; data: string; mimeType: string }>\n      | undefined;\n    if (!abortHandled && !ranSlashCommand) {\n      const textForAgent = mergedUserText.trimStart().startsWith('/skill:')\n        ? agentManager.expandSkillUserText(mergedUserText)\n        : mergedUserText;\n      messageContent = await buildMessageContent(textForAgent, prepared, sessionKey);\n    }\n\n    if (!abortHandled && !ranSlashCommand && messageContent !== undefined) {\n      const agentPromise = (async () => {\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 agentManager.applyMemoryPrefetchToUserMessage(\n          userMessage,\n          sessionKey,\n        );\n        await runAgentTurnWithModelFallbacks({\n          agent,\n          sessionKey,\n          modelManager,\n          userMessage: userMessageForModel,\n          log,\n          getConfig,\n          beforeUserPrompt: () => agentManager.beginBackgroundReviewUserTurn(sessionKey),\n        });\n        agentManager.afterAgentTurn(sessionKey, userPlain);\n        agentManager.scheduleBackgroundReviewAfterUserTurn(sessionKey);\n      })();\n\n      agentPromise\n        .then(() => {\n          if (abortHandled) {\n            return;\n          }\n          agentDone = true;\n          pushEvent({ type: '__done__' });\n        })\n        .catch((err) => {\n          if (abortHandled) {\n            return;\n          }\n          agentDone = true;\n          pushEvent({ type: 'error', content: err instanceof Error ? err.message : String(err) });\n          pushEvent({ type: '__done__' });\n        });\n    }\n\n    while (true) {\n      if (eventQueue.length > 0) {\n        const event = eventQueue.shift()!;\n        if (event.type === '__done__') break;\n        yield event;\n      } else if (agentDone) {\n        break;\n      } else {\n        await new Promise<void>((resolve) => {\n          resolveWaiting = resolve;\n        });\n      }\n    }\n\n    while (eventQueue.length > 0) {\n      const event = eventQueue.shift()!;\n      if (event.type === '__done__') continue;\n      yield event;\n    }\n\n    // Persist slash command text to the session file so the gateway console can show a receipt even when\n    // the browser drops SSE tokens (e.g. session key mismatch during hydration).\n    if (channel === 'webchat' && ranSlashCommand && webchatSlashReceipt?.trim()) {\n      try {\n        const loaded = await sessionStore.load(sessionKey);\n        const text = webchatSlashReceipt.trim();\n        // Minimal assistant row for session JSON; full AssistantMessage metadata is LLM-turn specific.\n        const assistantMsg = {\n          role: 'assistant' as const,\n          content: [{ type: 'text' as const, text }],\n          timestamp: Date.now(),\n        } as AgentMessage;\n        await sessionStore.save(sessionKey, [...loaded, assistantMsg]);\n      } catch (err) {\n        log.warn({ err, sessionKey }, 'Failed to persist webchat slash command receipt');\n      }\n    }\n\n    // Slash-only turns never hydrate the early-saved user row into pi-agent state; persisting here would\n    // write an empty/stale transcript over the gateway `SessionManager` copy (and break e.g. `/goal`).\n    if (!ranSlashCommand) {\n      await persistAgentSessionMessages(sessionKey);\n    }\n\n    if (!userAborted) {\n      const ttsAudioEvent = await maybeEmitWebchatTts(sessionKey, inboundVoice);\n      if (ttsAudioEvent) {\n        yield ttsAudioEvent;\n      }\n    }\n  } finally {\n    if (channel === 'webchat') {\n      unregisterWebchatSsePublisher(sessionKey);\n    }\n    unsubscribeStreaming();\n    endDirectRequestContext();\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"process-direct-streaming.js","names":["msgEvent"],"sources":["../../../../src/agent/service/process-direct-streaming.ts"],"sourcesContent":["import type { AgentEvent, AgentMessage } from '@mariozechner/pi-agent-core';\n\nimport type { Config } from '../../config/schema.js';\nimport type { InternalAttachmentRoots } from '../../channels/attachments/inbound-persist.js';\nimport { commandRegistry } from '../../chat-commands/index.js';\nimport { parseSlashCommand } from '../../chat-commands/command-parse.js';\nimport {\n  mergeVoiceTranscriptsIntoUserText,\n  mergeSttConfigFromAppConfig,\n} from '../../channels/attachments/voice-stt-webchat.js';\nimport {\n  resolveEffectiveReasoningLevel,\n  stripTrailingWebchatEarlySaveUserIfPresent,\n  type SessionConfigStore,\n  type SessionStore,\n} from '../../session/index.js';\nimport type { SessionContext } from '../session/index.js';\nimport {\n  extractTextContent,\n  extractThinkingContent,\n  extractThinkingFromAssistantMessage,\n} from '../context/workspace.js';\nimport { extractAgentUserPlainText } from '../memory/user-message-text.js';\nimport { runAgentTurnWithModelFallbacks } from '../orchestration/run-agent-turn-with-fallbacks.js';\nimport { applyReasoningVisibilityToSseEvent } from '../streaming/reasoning-visibility-sse.js';\nimport type { ReasoningLevel } from '../transcript/thinking-types.js';\nimport { serializeAgentToolResultForSse } from '../service-inbound-utils.js';\nimport type { AgentManager } from '../agent-manager.js';\nimport type { AgentEventHandler } from '../orchestration/agent-event-handler.js';\nimport type { AgentOrchestrator } from '../orchestration/agent-orchestrator.js';\nimport type { CommandHandler } from '../messaging/command-handler.js';\nimport type { ModelManager } from '../models/index.js';\n\nexport type DirectStreamInboundAttachment = {\n  type: string;\n  mimeType?: string;\n  data?: string;\n  name?: string;\n  size?: number;\n  workspaceRelativePath?: string;\n};\n\n/** Logger shape expected by {@link runAgentTurnWithModelFallbacks}. */\nexport type ProcessDirectStreamLog = {\n  info: (obj: Record<string, unknown>, msg: string) => void;\n  warn: (obj: Record<string, unknown>, msg: string) => void;\n  debug?: (obj: Record<string, unknown>, msg: string) => void;\n};\n\n/**\n * Explicit collaborators for {@link runProcessDirectStreaming} (gateway webchat / CLI direct stream).\n * Bound by `AgentService` from its private fields and methods.\n */\nexport interface ProcessDirectStreamingDeps {\n  log: ProcessDirectStreamLog;\n  parseSessionKey: (sessionKey: string) => { channel: string; chatId: string };\n  initDirectStreamingSession: (\n    sessionKey: string,\n    channel: string,\n    chatId: string,\n  ) => SessionContext;\n  registerWebchatSsePublisher: (\n    sessionKey: string,\n    publisher: (event: { type: string; [key: string]: unknown }) => void,\n  ) => void;\n  unregisterWebchatSsePublisher: (sessionKey: string) => void;\n  agentManager: AgentManager;\n  hydrateSessionWorkspaceFromStore: (sessionKey: string) => Promise<void>;\n  hydrateSessionModelFromStore: (sessionKey: string) => Promise<void>;\n  agentEventHandler: AgentEventHandler;\n  sessionStore: SessionStore;\n  prepareLoadedSessionMessages: (sessionKey: string, messages: AgentMessage[]) => AgentMessage[];\n  modelManager: ModelManager;\n  applyResolvedThinkingLevel: (sessionKey: string, thinking?: string | null) => Promise<void>;\n  getConfig: () => Config | undefined;\n  sessionConfigStore: SessionConfigStore;\n  attachmentRootsForSession: (sessionKey: string) => InternalAttachmentRoots;\n  agentOrchestrator: Pick<AgentOrchestrator, 'abort'>;\n  commandHandler: Pick<CommandHandler, 'executeCommandAndAggregateReply'>;\n  prepareInboundAttachments: (\n    sessionKey: string,\n    attachments?: DirectStreamInboundAttachment[],\n  ) => Promise<DirectStreamInboundAttachment[] | undefined>;\n  buildMessageContent: (\n    content: string,\n    attachments: DirectStreamInboundAttachment[] | undefined,\n    sessionKey: string,\n  ) => Promise<Array<{ type: 'text'; text: string } | { type: 'image'; data: string; mimeType: string }>>;\n  persistAgentSessionMessages: (sessionKey: string) => Promise<void>;\n  maybeEmitWebchatTts: (\n    sessionKey: string,\n    hadInboundVoice: boolean,\n  ) => Promise<{ type: 'tts_audio'; workspaceRelativePath: string; mimeType: string; name: string } | null>;\n  endDirectRequestContext: () => void;\n}\n\nexport interface ProcessDirectStreamingInput {\n  content: string;\n  sessionKey?: string;\n  attachments?: DirectStreamInboundAttachment[];\n  thinking?: string;\n  signal?: AbortSignal;\n}\n\nexport type ProcessDirectStreamingSseEvent = { type: string; [key: string]: unknown };\n\nexport async function* runProcessDirectStreaming(\n  deps: ProcessDirectStreamingDeps,\n  input: ProcessDirectStreamingInput,\n): AsyncGenerator<ProcessDirectStreamingSseEvent, void, unknown> {\n  const {\n    log,\n    parseSessionKey,\n    initDirectStreamingSession,\n    registerWebchatSsePublisher,\n    unregisterWebchatSsePublisher,\n    agentManager,\n    hydrateSessionWorkspaceFromStore,\n    hydrateSessionModelFromStore,\n    agentEventHandler,\n    sessionStore,\n    prepareLoadedSessionMessages,\n    modelManager,\n    applyResolvedThinkingLevel,\n    getConfig,\n    sessionConfigStore,\n    attachmentRootsForSession,\n    agentOrchestrator,\n    commandHandler,\n    prepareInboundAttachments,\n    buildMessageContent,\n    persistAgentSessionMessages,\n    maybeEmitWebchatTts,\n    endDirectRequestContext,\n  } = deps;\n\n  const sessionKey = input.sessionKey ?? 'cli:direct';\n  const { channel, chatId } = parseSessionKey(sessionKey);\n  const context = initDirectStreamingSession(sessionKey, channel, chatId);\n\n  const eventQueue: ProcessDirectStreamingSseEvent[] = [];\n  let resolveWaiting: (() => void) | null = null;\n  let agentDone = false;\n\n  let lastSentContent = '';\n  let lastSentThinking = '';\n  let reasoningLevel: ReasoningLevel = 'stream';\n\n  const enqueueSseEvent = (event: ProcessDirectStreamingSseEvent) => {\n    eventQueue.push(event);\n    if (resolveWaiting) {\n      resolveWaiting();\n      resolveWaiting = null;\n    }\n  };\n\n  const pushEvent = (event: ProcessDirectStreamingSseEvent) => {\n    const visible = applyReasoningVisibilityToSseEvent(event, reasoningLevel);\n    if (visible !== null) {\n      enqueueSseEvent(visible);\n    }\n  };\n\n  if (channel === 'webchat') {\n    registerWebchatSsePublisher(sessionKey, (e) => pushEvent(e));\n  }\n\n  const signal = input.signal;\n  let userAborted = false;\n  let abortHandled = false;\n\n  await hydrateSessionWorkspaceFromStore(sessionKey);\n  const agent = agentManager.getOrCreateAgent(sessionKey);\n  await hydrateSessionModelFromStore(sessionKey);\n  const unsubscribeStreaming = agent.subscribe((event: AgentEvent) => {\n    agentEventHandler.handle(event, context);\n\n    switch (event.type) {\n      case 'tool_execution_start': {\n        const toolEvent = event as Extract<AgentEvent, { type: 'tool_execution_start' }>;\n        const toolName =\n          typeof toolEvent.toolName === 'string' && toolEvent.toolName.trim()\n            ? toolEvent.toolName.trim()\n            : 'unknown';\n        pushEvent({\n          type: 'tool_start',\n          toolCallId: toolEvent.toolCallId,\n          toolName,\n          args: toolEvent.args,\n        });\n        break;\n      }\n      case 'tool_execution_end': {\n        const toolEvent = event as Extract<AgentEvent, { type: 'tool_execution_end' }>;\n        const toolName =\n          typeof toolEvent.toolName === 'string' && toolEvent.toolName.trim()\n            ? toolEvent.toolName.trim()\n            : 'unknown';\n        pushEvent({\n          type: 'tool_end',\n          toolCallId: toolEvent.toolCallId,\n          toolName,\n          isError: toolEvent.isError,\n          result: serializeAgentToolResultForSse(toolEvent.result),\n        });\n        break;\n      }\n      case 'message_update': {\n        const msgEvent = event as Extract<AgentEvent, { type: 'message_update' }>;\n        if (msgEvent.message?.role === 'assistant') {\n          const msgContent = msgEvent.message.content;\n          const blocks = Array.isArray(msgContent)\n            ? (msgContent as Array<{ type: string; text?: string }>)\n            : undefined;\n          const fullText = blocks ? extractTextContent(blocks) : String(msgContent);\n          const thinkingFromBlocks = blocks ? extractThinkingContent(blocks) : '';\n          const thinkingFromReasoning = extractThinkingFromAssistantMessage(msgEvent.message);\n          const thinkingText =\n            thinkingFromReasoning.length >= thinkingFromBlocks.length\n              ? thinkingFromReasoning\n              : thinkingFromBlocks;\n\n          if (fullText.length > lastSentContent.length) {\n            const delta = fullText.slice(lastSentContent.length);\n            if (delta) {\n              pushEvent({ type: 'token', content: delta });\n              lastSentContent = fullText;\n            }\n          } else if (fullText.length < lastSentContent.length) {\n            pushEvent({ type: 'token', content: fullText });\n            lastSentContent = fullText;\n          }\n\n          if (thinkingText.length > lastSentThinking.length) {\n            const thDelta = thinkingText.slice(lastSentThinking.length);\n            if (thDelta) {\n              pushEvent({ type: 'thinking', content: thDelta, delta: true });\n              lastSentThinking = thinkingText;\n            }\n          } else if (thinkingText.length < lastSentThinking.length) {\n            pushEvent({ type: 'thinking', content: thinkingText, delta: false });\n            lastSentThinking = thinkingText;\n          }\n        }\n        break;\n      }\n      case 'message_start': {\n        const msgEvent = event as Extract<AgentEvent, { type: 'message_start' }>;\n        if (msgEvent.message?.role === 'assistant') {\n          lastSentContent = '';\n          lastSentThinking = '';\n          pushEvent({ type: 'thinking', status: 'started' });\n        }\n        break;\n      }\n      case 'message_end': {\n        pushEvent({ type: 'message_end' });\n        break;\n      }\n      case 'agent_start': {\n        pushEvent({ type: 'progress', stage: 'thinking', message: 'Thinking...' });\n        break;\n      }\n      case 'agent_end': {\n        pushEvent({ type: 'progress', stage: 'idle', message: 'Done' });\n        break;\n      }\n      default:\n        break;\n    }\n  });\n\n  try {\n    const prepared = await prepareInboundAttachments(sessionKey, input.attachments);\n    let loaded = await sessionStore.load(sessionKey);\n    const lastMsg = loaded[loaded.length - 1] as { role?: string; webchatEarlySave?: boolean } | undefined;\n    if (lastMsg?.role === 'user' && lastMsg.webchatEarlySave === true) {\n      loaded = loaded.slice(0, -1);\n    }\n    agent.state.messages = prepareLoadedSessionMessages(sessionKey, loaded);\n\n    await modelManager.applyModelForSession(agent, sessionKey);\n    await applyResolvedThinkingLevel(sessionKey, input.thinking);\n    {\n      const defReason = (getConfig()?.agents?.defaults?.reasoningDefault ?? 'stream') as ReasoningLevel;\n      reasoningLevel = await resolveEffectiveReasoningLevel(sessionConfigStore, sessionKey, defReason);\n    }\n\n    const sttCfg = mergeSttConfigFromAppConfig(getConfig()?.stt);\n    const { text: mergedUserText, inboundVoice } = await mergeVoiceTranscriptsIntoUserText(\n      attachmentRootsForSession(sessionKey),\n      prepared,\n      input.content,\n      sttCfg,\n    );\n\n    const armAbort = () => {\n      if (abortHandled) {\n        return;\n      }\n      abortHandled = true;\n      userAborted = true;\n      agentOrchestrator.abort(sessionKey);\n      agentDone = true;\n      pushEvent({ type: '__done__' });\n    };\n    if (signal) {\n      if (signal.aborted) {\n        armAbort();\n      } else {\n        signal.addEventListener('abort', armAbort, { once: true });\n      }\n    }\n\n    const commandInfo = parseSlashCommand(mergedUserText);\n    let ranSlashCommand = false;\n    /** Plain text to persist for webchat slash turns (SSE can be dropped by the UI; disk is source of truth). */\n    let webchatSlashReceipt: string | undefined;\n    if (!abortHandled && commandInfo) {\n      if (commandRegistry.has(commandInfo.command)) {\n        ranSlashCommand = true;\n        try {\n          const { aggregatedText } = await commandHandler.executeCommandAndAggregateReply(\n            commandInfo.command,\n            commandInfo.args,\n            {\n              sessionKey,\n              channel,\n              chatId,\n              senderId: context.senderId,\n              isGroup: context.isGroup,\n            },\n          );\n          if (aggregatedText?.trim()) {\n            webchatSlashReceipt = aggregatedText.trim();\n            pushEvent({ type: 'token', content: webchatSlashReceipt });\n          } else if (channel === 'webchat') {\n            webchatSlashReceipt =\n              'Command finished with no assistant text. For `/goal`, that usually means the goal was saved; the assistant will not run until your next normal message (or an auto-continuation after an assistant reply).';\n            pushEvent({ type: 'token', content: webchatSlashReceipt });\n          }\n        } catch (cmdErr) {\n          const em = cmdErr instanceof Error ? cmdErr.message : String(cmdErr);\n          log.warn({ err: cmdErr, sessionKey, command: commandInfo.command }, `Slash command failed: ${em}`);\n          webchatSlashReceipt = `Command error: ${em}`;\n          pushEvent({ type: 'token', content: webchatSlashReceipt });\n        }\n        pushEvent({ type: '__done__' });\n        agentDone = true;\n      } else if (commandInfo.command === 'goal') {\n        // `/goal` is provided by the `standing-goal` bundled extension; avoid silent LLM fallback.\n        ranSlashCommand = true;\n        webchatSlashReceipt =\n          'The /goal command is not available: the `standing-goal` extension is not loaded.\\n\\n' +\n          'Fix: add `\"standing-goal\"` to `extensions.enabled` in your xopc config (or remove it from `extensions.disabled`), then restart the gateway. ' +\n          'If you use a strict allowlist, include `standing-goal` in `extensions.enabled`.';\n        pushEvent({\n          type: 'token',\n          content: webchatSlashReceipt,\n        });\n        pushEvent({ type: '__done__' });\n        agentDone = true;\n      }\n    }\n\n    let messageContent:\n      | Array<{ type: 'text'; text: string } | { type: 'image'; data: string; mimeType: string }>\n      | undefined;\n    if (!abortHandled && !ranSlashCommand) {\n      const textForAgent = mergedUserText.trimStart().startsWith('/skill:')\n        ? agentManager.expandSkillUserText(mergedUserText)\n        : mergedUserText;\n      messageContent = await buildMessageContent(textForAgent, prepared, sessionKey);\n    }\n\n    if (!abortHandled && !ranSlashCommand && messageContent !== undefined) {\n      const agentPromise = (async () => {\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 agentManager.applyMemoryPrefetchToUserMessage(\n          userMessage,\n          sessionKey,\n        );\n        await runAgentTurnWithModelFallbacks({\n          agent,\n          sessionKey,\n          modelManager,\n          userMessage: userMessageForModel,\n          log,\n          getConfig,\n          beforeUserPrompt: () => agentManager.beginBackgroundReviewUserTurn(sessionKey),\n        });\n        agentManager.afterAgentTurn(sessionKey, userPlain);\n        agentManager.scheduleBackgroundReviewAfterUserTurn(sessionKey);\n      })();\n\n      agentPromise\n        .then(() => {\n          if (abortHandled) {\n            return;\n          }\n          agentDone = true;\n          pushEvent({ type: '__done__' });\n        })\n        .catch((err) => {\n          if (abortHandled) {\n            return;\n          }\n          agentDone = true;\n          pushEvent({ type: 'error', content: err instanceof Error ? err.message : String(err) });\n          pushEvent({ type: '__done__' });\n        });\n    }\n\n    while (true) {\n      if (eventQueue.length > 0) {\n        const event = eventQueue.shift()!;\n        if (event.type === '__done__') break;\n        yield event;\n      } else if (agentDone) {\n        break;\n      } else {\n        await new Promise<void>((resolve) => {\n          resolveWaiting = resolve;\n        });\n      }\n    }\n\n    while (eventQueue.length > 0) {\n      const event = eventQueue.shift()!;\n      if (event.type === '__done__') continue;\n      yield event;\n    }\n\n    // Persist slash command text to the session file so the gateway console can show a receipt even when\n    // the browser drops SSE tokens (e.g. session key mismatch during hydration).\n    if (channel === 'webchat' && ranSlashCommand && webchatSlashReceipt?.trim()) {\n      try {\n        const loaded = await sessionStore.load(sessionKey);\n        const text = webchatSlashReceipt.trim();\n        // Minimal assistant row for session JSON; full AssistantMessage metadata is LLM-turn specific.\n        const assistantMsg = {\n          role: 'assistant' as const,\n          content: [{ type: 'text' as const, text }],\n          timestamp: Date.now(),\n        } as AgentMessage;\n        await sessionStore.save(sessionKey, [...loaded, assistantMsg]);\n      } catch (err) {\n        log.warn({ err, sessionKey }, 'Failed to persist webchat slash command receipt');\n      }\n    }\n\n    // Slash-only turns never hydrate the early-saved user row into pi-agent state; persisting here would\n    // write an empty/stale transcript over the gateway `SessionManager` copy (and break e.g. `/goal`).\n    if (!ranSlashCommand) {\n      if (userAborted && channel === 'webchat') {\n        try {\n          await stripTrailingWebchatEarlySaveUserIfPresent(sessionStore, sessionKey);\n        } catch (stripErr) {\n          log.warn({ err: stripErr, sessionKey }, 'Failed to strip trailing webchat early-save after abort');\n        }\n      }\n      await persistAgentSessionMessages(sessionKey);\n    }\n\n    if (!userAborted) {\n      const ttsAudioEvent = await maybeEmitWebchatTts(sessionKey, inboundVoice);\n      if (ttsAudioEvent) {\n        yield ttsAudioEvent;\n      }\n    }\n  } finally {\n    if (channel === 'webchat') {\n      unregisterWebchatSsePublisher(sessionKey);\n    }\n    unsubscribeStreaming();\n    endDirectRequestContext();\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/service/reconcile-dreaming-cron.d.ts

@@ -0,0 +1,6 @@
+import type { Config } from '../../config/schema.js';
+import type { CronService } from '../../cron/index.js';
+/**
+ * Reconcile managed Dreaming cron jobs against the current effective config.
+ */
+export declare function reconcileManagedDreamingCronJobs(cron: CronService, effectiveConfig: Config | undefined): Promise<void>;

package/dist/src/agent/service/reconcile-dreaming-cron.js

@@ -0,0 +1,70 @@
+import { DREAMING_CRON_NAME, DREAMING_LIGHT_CRON_NAME, DREAMING_LIGHT_SWEEP_TOKEN, DREAMING_REM_CRON_NAME, DREAMING_REM_SWEEP_TOKEN, DREAMING_SWEEP_TOKEN } from "../memory/dreaming/constants.js";
+import { resolveDreamingConfig } from "../memory/dreaming/config.js";
+//#region src/agent/service/reconcile-dreaming-cron.ts
+/**
+* Reconcile managed Dreaming cron jobs against the current effective config.
+*/
+async function reconcileManagedDreamingCronJobs(cron, effectiveConfig) {
+	const dreaming = resolveDreamingConfig(effectiveConfig);
+	const managed = (await cron.listJobs()).filter((job) => job.name?.includes?.("[managed-by=xopc.memory.dreaming]") ?? false);
+	const phaseSpecs = [
+		{
+			cronName: DREAMING_LIGHT_CRON_NAME,
+			token: DREAMING_LIGHT_SWEEP_TOKEN,
+			schedule: dreaming.phases.light.cron,
+			phaseEnabled: dreaming.phases.light.enabled
+		},
+		{
+			cronName: DREAMING_CRON_NAME,
+			token: DREAMING_SWEEP_TOKEN,
+			schedule: dreaming.phases.deep.cron,
+			phaseEnabled: dreaming.phases.deep.enabled
+		},
+		{
+			cronName: DREAMING_REM_CRON_NAME,
+			token: DREAMING_REM_SWEEP_TOKEN,
+			schedule: dreaming.phases.rem.cron,
+			phaseEnabled: dreaming.phases.rem.enabled
+		}
+	];
+	if (!dreaming.enabled) {
+		for (const job of managed) await cron.removeJob(job.id).catch(() => {});
+		return;
+	}
+	for (const spec of phaseSpecs) {
+		const phaseJobs = managed.filter((job) => job.name === spec.cronName);
+		if (!spec.phaseEnabled) {
+			for (const job of phaseJobs) await cron.removeJob(job.id).catch(() => {});
+			continue;
+		}
+		const desiredPayload = {
+			kind: "agentTurn",
+			message: spec.token
+		};
+		if (phaseJobs.length === 0) {
+			await cron.addJob(spec.schedule, {
+				name: spec.cronName,
+				timezone: dreaming.timezone,
+				sessionTarget: "isolated",
+				payload: desiredPayload,
+				enabled: true
+			});
+			continue;
+		}
+		const primary = phaseJobs[0];
+		for (const dup of phaseJobs.slice(1)) await cron.removeJob(dup.id).catch(() => {});
+		const payloadMessage = primary.payload?.kind === "agentTurn" ? primary.payload.message : primary.payload?.text;
+		if (primary.schedule !== spec.schedule || (dreaming.timezone ?? null) !== (primary.timezone ?? null) || primary.sessionTarget !== "isolated" || payloadMessage !== spec.token || primary.enabled !== true || primary.name !== spec.cronName) await cron.updateJob(primary.id, {
+			schedule: spec.schedule,
+			timezone: dreaming.timezone ?? void 0,
+			sessionTarget: "isolated",
+			name: spec.cronName,
+			payload: desiredPayload,
+			enabled: true
+		});
+	}
+}
+//#endregion
+export { reconcileManagedDreamingCronJobs };
+
+//# sourceMappingURL=reconcile-dreaming-cron.js.map

package/dist/src/agent/service/reconcile-dreaming-cron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile-dreaming-cron.js","names":[],"sources":["../../../../src/agent/service/reconcile-dreaming-cron.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport type { CronService } from '../../cron/index.js';\nimport {\n  DREAMING_CRON_TAG,\n  DREAMING_SWEEP_TOKEN,\n  DREAMING_LIGHT_CRON_NAME,\n  DREAMING_LIGHT_SWEEP_TOKEN,\n  DREAMING_CRON_NAME,\n  DREAMING_REM_CRON_NAME,\n  DREAMING_REM_SWEEP_TOKEN,\n} from '../memory/dreaming/constants.js';\nimport { resolveDreamingConfig } from '../memory/dreaming/config.js';\n\n/**\n * Reconcile managed Dreaming cron jobs against the current effective config.\n */\nexport async function reconcileManagedDreamingCronJobs(\n  cron: CronService,\n  effectiveConfig: Config | undefined,\n): Promise<void> {\n  const dreaming = resolveDreamingConfig(effectiveConfig);\n  const jobs = await cron.listJobs();\n  const managed = jobs.filter((job) => job.name?.includes?.(DREAMING_CRON_TAG) ?? false);\n\n  const phaseSpecs: Array<{\n    cronName: string;\n    token: string;\n    schedule: string;\n    phaseEnabled: boolean;\n  }> = [\n    {\n      cronName: DREAMING_LIGHT_CRON_NAME,\n      token: DREAMING_LIGHT_SWEEP_TOKEN,\n      schedule: dreaming.phases.light.cron,\n      phaseEnabled: dreaming.phases.light.enabled,\n    },\n    {\n      cronName: DREAMING_CRON_NAME,\n      token: DREAMING_SWEEP_TOKEN,\n      schedule: dreaming.phases.deep.cron,\n      phaseEnabled: dreaming.phases.deep.enabled,\n    },\n    {\n      cronName: DREAMING_REM_CRON_NAME,\n      token: DREAMING_REM_SWEEP_TOKEN,\n      schedule: dreaming.phases.rem.cron,\n      phaseEnabled: dreaming.phases.rem.enabled,\n    },\n  ];\n\n  if (!dreaming.enabled) {\n    for (const job of managed) {\n      await cron.removeJob(job.id).catch(() => {});\n    }\n    return;\n  }\n\n  for (const spec of phaseSpecs) {\n    const phaseJobs = managed.filter((job) => job.name === spec.cronName);\n\n    if (!spec.phaseEnabled) {\n      for (const job of phaseJobs) {\n        await cron.removeJob(job.id).catch(() => {});\n      }\n      continue;\n    }\n\n    const desiredPayload = { kind: 'agentTurn' as const, message: spec.token };\n\n    if (phaseJobs.length === 0) {\n      await cron.addJob(spec.schedule, {\n        name: spec.cronName,\n        timezone: dreaming.timezone,\n        sessionTarget: 'isolated' as const,\n        payload: desiredPayload,\n        enabled: true,\n      } as any);\n      continue;\n    }\n\n    const primary = phaseJobs[0]!;\n    for (const dup of phaseJobs.slice(1)) {\n      await cron.removeJob(dup.id).catch(() => {});\n    }\n\n    const payloadMessage =\n      primary.payload?.kind === 'agentTurn'\n        ? primary.payload.message\n        : (primary.payload as any)?.text;\n    const needsUpdate =\n      primary.schedule !== spec.schedule ||\n      (dreaming.timezone ?? null) !== (primary.timezone ?? null) ||\n      primary.sessionTarget !== 'isolated' ||\n      payloadMessage !== spec.token ||\n      primary.enabled !== true ||\n      primary.name !== spec.cronName;\n\n    if (needsUpdate) {\n      await cron.updateJob(primary.id, {\n        schedule: spec.schedule,\n        timezone: dreaming.timezone ?? undefined,\n        sessionTarget: 'isolated',\n        name: spec.cronName,\n        payload: desiredPayload,\n        enabled: true,\n      } as any);\n    }\n  }\n}\n"],"mappings":";;;;;;AAgBA,eAAsB,iCACpB,MACA,iBACe;CACf,MAAM,WAAW,sBAAsB,gBAAgB;CAEvD,MAAM,WAAU,MADG,KAAK,UAAU,EACb,QAAQ,QAAQ,IAAI,MAAM,WAAA,oCAA6B,IAAI,MAAM;CAEtF,MAAM,aAKD;EACH;GACE,UAAU;GACV,OAAO;GACP,UAAU,SAAS,OAAO,MAAM;GAChC,cAAc,SAAS,OAAO,MAAM;GACrC;EACD;GACE,UAAU;GACV,OAAO;GACP,UAAU,SAAS,OAAO,KAAK;GAC/B,cAAc,SAAS,OAAO,KAAK;GACpC;EACD;GACE,UAAU;GACV,OAAO;GACP,UAAU,SAAS,OAAO,IAAI;GAC9B,cAAc,SAAS,OAAO,IAAI;GACnC;EACF;AAED,KAAI,CAAC,SAAS,SAAS;AACrB,OAAK,MAAM,OAAO,QAChB,OAAM,KAAK,UAAU,IAAI,GAAG,CAAC,YAAY,GAAG;AAE9C;;AAGF,MAAK,MAAM,QAAQ,YAAY;EAC7B,MAAM,YAAY,QAAQ,QAAQ,QAAQ,IAAI,SAAS,KAAK,SAAS;AAErE,MAAI,CAAC,KAAK,cAAc;AACtB,QAAK,MAAM,OAAO,UAChB,OAAM,KAAK,UAAU,IAAI,GAAG,CAAC,YAAY,GAAG;AAE9C;;EAGF,MAAM,iBAAiB;GAAE,MAAM;GAAsB,SAAS,KAAK;GAAO;AAE1E,MAAI,UAAU,WAAW,GAAG;AAC1B,SAAM,KAAK,OAAO,KAAK,UAAU;IAC/B,MAAM,KAAK;IACX,UAAU,SAAS;IACnB,eAAe;IACf,SAAS;IACT,SAAS;IACV,CAAQ;AACT;;EAGF,MAAM,UAAU,UAAU;AAC1B,OAAK,MAAM,OAAO,UAAU,MAAM,EAAE,CAClC,OAAM,KAAK,UAAU,IAAI,GAAG,CAAC,YAAY,GAAG;EAG9C,MAAM,iBACJ,QAAQ,SAAS,SAAS,cACtB,QAAQ,QAAQ,UACf,QAAQ,SAAiB;AAShC,MAPE,QAAQ,aAAa,KAAK,aACzB,SAAS,YAAY,WAAW,QAAQ,YAAY,SACrD,QAAQ,kBAAkB,cAC1B,mBAAmB,KAAK,SACxB,QAAQ,YAAY,QACpB,QAAQ,SAAS,KAAK,SAGtB,OAAM,KAAK,UAAU,QAAQ,IAAI;GAC/B,UAAU,KAAK;GACf,UAAU,SAAS,YAAY,KAAA;GAC/B,eAAe;GACf,MAAM,KAAK;GACX,SAAS;GACT,SAAS;GACV,CAAQ"}

package/dist/src/agent/service/session-context-report.d.ts

@@ -0,0 +1,19 @@
+/** Assembled snapshot for `/context` (list, detail markdown, or JSON). */
+export type SessionContextReportInput = {
+    sessionKey: string;
+    mode: 'list' | 'detail' | 'json';
+    model: string;
+    workspacePath: string;
+    agentId: string;
+    messageCount: number;
+    contextWindowNominal: number;
+    estimatedTranscriptTokens: number;
+    thinkingDefault?: string;
+    reasoningDefault?: string;
+    verboseDefault?: string;
+    compaction: unknown;
+    toolsFlagsSummary: string;
+    windowStats: unknown;
+    compactionRunStats: unknown;
+};
+export declare function formatSessionContextReport(input: SessionContextReportInput): string;

package/dist/src/agent/service/session-context-report.js

@@ -0,0 +1,47 @@
+//#region src/agent/service/session-context-report.ts
+function formatSessionContextReport(input) {
+	const { sessionKey, mode, model, workspacePath, agentId, messageCount, contextWindowNominal: cw, estimatedTranscriptTokens: estTokens, thinkingDefault, reasoningDefault, verboseDefault, compaction, toolsFlagsSummary, windowStats, compactionRunStats } = input;
+	const payload = {
+		sessionKey,
+		model,
+		workspacePath,
+		agentId,
+		messageCount,
+		contextWindowNominal: cw,
+		estimatedTranscriptTokens: estTokens,
+		approxWindowUsage: cw > 0 ? estTokens / cw : null,
+		thinkingDefault,
+		reasoningDefault,
+		verboseDefault,
+		compaction,
+		toolsFlagsOn: toolsFlagsSummary,
+		windowStats,
+		compactionRunStats
+	};
+	if (mode === "json") return JSON.stringify(payload, null, 2);
+	const lines = [
+		"📎 *Context overview*",
+		"",
+		`• Session: \`${sessionKey}\``,
+		`• Model: \`${model}\``,
+		`• Agent profile: \`${agentId}\``,
+		`• Workspace: \`${workspacePath}\``,
+		`• Messages: ${messageCount}`,
+		`• Est. transcript tokens (rough): ${estTokens}`,
+		`• Nominal context budget (4× maxTokens): ${cw}`
+	];
+	if (cw > 0) lines.push(`• Approx. usage vs budget: ${(estTokens / cw * 100).toFixed(1)}%`);
+	lines.push(`• Thinking / reasoning / verbose defaults: ${thinkingDefault ?? "—"} / ${reasoningDefault ?? "—"} / ${verboseDefault ?? "—"}`, `• Tools (true flags): ${toolsFlagsSummary}`, "", "_Full system prompt, skills, and memory blocks are assembled at agent runtime; use Web settings or logs for deep inspection._");
+	if (mode === "detail") {
+		lines.push("", "*Compaction config (agents.defaults.compaction):*", "```json");
+		lines.push(JSON.stringify(compaction ?? {}, null, 2));
+		lines.push("```", "", "*Window stats:*", "```json");
+		lines.push(JSON.stringify(windowStats ?? {}, null, 2));
+		lines.push("```");
+	}
+	return lines.join("\n");
+}
+//#endregion
+export { formatSessionContextReport };
+
+//# sourceMappingURL=session-context-report.js.map

package/dist/src/agent/service/session-context-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-context-report.js","names":[],"sources":["../../../../src/agent/service/session-context-report.ts"],"sourcesContent":["/** Assembled snapshot for `/context` (list, detail markdown, or JSON). */\nexport type SessionContextReportInput = {\n  sessionKey: string;\n  mode: 'list' | 'detail' | 'json';\n  model: string;\n  workspacePath: string;\n  agentId: string;\n  messageCount: number;\n  contextWindowNominal: number;\n  estimatedTranscriptTokens: number;\n  thinkingDefault?: string;\n  reasoningDefault?: string;\n  verboseDefault?: string;\n  compaction: unknown;\n  toolsFlagsSummary: string;\n  windowStats: unknown;\n  compactionRunStats: unknown;\n};\n\nexport function formatSessionContextReport(input: SessionContextReportInput): string {\n  const {\n    sessionKey,\n    mode,\n    model,\n    workspacePath,\n    agentId,\n    messageCount,\n    contextWindowNominal: cw,\n    estimatedTranscriptTokens: estTokens,\n    thinkingDefault,\n    reasoningDefault,\n    verboseDefault,\n    compaction,\n    toolsFlagsSummary,\n    windowStats,\n    compactionRunStats,\n  } = input;\n\n  const payload: Record<string, unknown> = {\n    sessionKey,\n    model,\n    workspacePath,\n    agentId,\n    messageCount,\n    contextWindowNominal: cw,\n    estimatedTranscriptTokens: estTokens,\n    approxWindowUsage: cw > 0 ? estTokens / cw : null,\n    thinkingDefault,\n    reasoningDefault,\n    verboseDefault,\n    compaction,\n    toolsFlagsOn: toolsFlagsSummary,\n    windowStats,\n    compactionRunStats: compactionRunStats,\n  };\n\n  if (mode === 'json') {\n    return JSON.stringify(payload, null, 2);\n  }\n\n  const lines: string[] = [\n    '📎 *Context overview*',\n    '',\n    `• Session: \\`${sessionKey}\\``,\n    `• Model: \\`${model}\\``,\n    `• Agent profile: \\`${agentId}\\``,\n    `• Workspace: \\`${workspacePath}\\``,\n    `• Messages: ${messageCount}`,\n    `• Est. transcript tokens (rough): ${estTokens}`,\n    `• Nominal context budget (4× maxTokens): ${cw}`,\n  ];\n  if (cw > 0) {\n    lines.push(`• Approx. usage vs budget: ${((estTokens / cw) * 100).toFixed(1)}%`);\n  }\n  lines.push(\n    `• Thinking / reasoning / verbose defaults: ${thinkingDefault ?? '—'} / ${reasoningDefault ?? '—'} / ${verboseDefault ?? '—'}`,\n    `• Tools (true flags): ${toolsFlagsSummary}`,\n    '',\n    '_Full system prompt, skills, and memory blocks are assembled at agent runtime; use Web settings or logs for deep inspection._',\n  );\n\n  if (mode === 'detail') {\n    lines.push('', '*Compaction config (agents.defaults.compaction):*', '```json');\n    lines.push(JSON.stringify(compaction ?? {}, null, 2));\n    lines.push('```', '', '*Window stats:*', '```json');\n    lines.push(JSON.stringify(windowStats ?? {}, null, 2));\n    lines.push('```');\n  }\n\n  return lines.join('\\n');\n}\n"],"mappings":";AAmBA,SAAgB,2BAA2B,OAA0C;CACnF,MAAM,EACJ,YACA,MACA,OACA,eACA,SACA,cACA,sBAAsB,IACtB,2BAA2B,WAC3B,iBACA,kBACA,gBACA,YACA,mBACA,aACA,uBACE;CAEJ,MAAM,UAAmC;EACvC;EACA;EACA;EACA;EACA;EACA,sBAAsB;EACtB,2BAA2B;EAC3B,mBAAmB,KAAK,IAAI,YAAY,KAAK;EAC7C;EACA;EACA;EACA;EACA,cAAc;EACd;EACoB;EACrB;AAED,KAAI,SAAS,OACX,QAAO,KAAK,UAAU,SAAS,MAAM,EAAE;CAGzC,MAAM,QAAkB;EACtB;EACA;EACA,gBAAgB,WAAW;EAC3B,cAAc,MAAM;EACpB,sBAAsB,QAAQ;EAC9B,kBAAkB,cAAc;EAChC,eAAe;EACf,qCAAqC;EACrC,4CAA4C;EAC7C;AACD,KAAI,KAAK,EACP,OAAM,KAAK,+BAAgC,YAAY,KAAM,KAAK,QAAQ,EAAE,CAAC,GAAG;AAElF,OAAM,KACJ,8CAA8C,mBAAmB,IAAI,KAAK,oBAAoB,IAAI,KAAK,kBAAkB,OACzH,yBAAyB,qBACzB,IACA,gIACD;AAED,KAAI,SAAS,UAAU;AACrB,QAAM,KAAK,IAAI,qDAAqD,UAAU;AAC9E,QAAM,KAAK,KAAK,UAAU,cAAc,EAAE,EAAE,MAAM,EAAE,CAAC;AACrD,QAAM,KAAK,OAAO,IAAI,mBAAmB,UAAU;AACnD,QAAM,KAAK,KAAK,UAAU,eAAe,EAAE,EAAE,MAAM,EAAE,CAAC;AACtD,QAAM,KAAK,MAAM;;AAGnB,QAAO,MAAM,KAAK,KAAK"}

package/dist/src/agent/service/webchat-tts.d.ts

@@ -0,0 +1,28 @@
+import type { Config } from '../../config/schema.js';
+import type { AgentManager } from '../agent-manager.js';
+import type { SessionStore } from '../../session/index.js';
+export type WebchatTtsResult = {
+    type: 'tts_audio';
+    workspaceRelativePath: string;
+    mimeType: string;
+    name: string;
+};
+export type WebchatTtsDeps = {
+    config: Config | undefined;
+    agentManager: AgentManager;
+    sessionStore: SessionStore;
+    log: {
+        warn: (obj: Record<string, unknown>, msg: string) => void;
+    };
+};
+/**
+ * Generate TTS for webchat when config allows; persist under agent home `tts/`.
+ */
+export declare function maybeEmitWebchatTts(deps: WebchatTtsDeps, sessionKey: string, hadInboundVoice: boolean): Promise<WebchatTtsResult | null>;
+export declare function appendAttachmentToLastAssistant(sessionStore: SessionStore, sessionKey: string, att: {
+    type: string;
+    mimeType: string;
+    name: string;
+    size: number;
+    workspaceRelativePath: string;
+}): Promise<void>;

package/dist/src/agent/service/webchat-tts.js

@@ -0,0 +1,73 @@
+import { init_agent_scope, resolveAgentHomeDir } from "../agent-scope.js";
+import { extractProfileAgentId } from "../../config/agent-profile.js";
+import { isTTSAvailable } from "../../voice/tts/factory.js";
+import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
+import { speak } from "../../voice/tts/speak-core.js";
+import { getChannelOutputFormat, shouldUseTTS } from "../../voice/tts/service.js";
+import { compressAudio } from "../../voice/tts/audio.js";
+import "../../voice/tts/index.js";
+import { persistOutboundTtsAudio } from "../../channels/attachments/outbound-tts-persist.js";
+//#region src/agent/service/webchat-tts.ts
+init_agent_scope();
+/**
+* Generate TTS for webchat when config allows; persist under agent home `tts/`.
+*/
+async function maybeEmitWebchatTts(deps, sessionKey, hadInboundVoice) {
+	const ttsConfig = mergeTtsConfigFromAppConfig(deps.config?.tts);
+	if (!isTTSAvailable(ttsConfig)) return null;
+	if (!shouldUseTTS(ttsConfig, hadInboundVoice).useTTS) return null;
+	const text = deps.agentManager.getLastAssistantContent(sessionKey)?.trim();
+	if (!text) return null;
+	try {
+		const webOut = getChannelOutputFormat("webchat");
+		const fmt = webOut.format;
+		const ttsResult = await speak(text, ttsConfig, {
+			appConfig: deps.config,
+			tts: { format: fmt }
+		});
+		const { buffer, format } = await compressAudio(Buffer.from(ttsResult.audio), ttsResult.format, webOut.format === "mp3" ? "mp3" : "opus");
+		const normalizedMime = format === "opus" || format === "ogg" ? "audio/ogg" : format === "mp3" || format === "mpeg" ? "audio/mpeg" : format === "wav" ? "audio/wav" : `audio/${format}`;
+		const cfg = deps.config;
+		const persisted = await persistOutboundTtsAudio(resolveAgentHomeDir(cfg, extractProfileAgentId(sessionKey, cfg)), sessionKey, buffer, format);
+		await appendAttachmentToLastAssistant(deps.sessionStore, sessionKey, {
+			type: "audio",
+			mimeType: normalizedMime,
+			name: persisted.name,
+			size: persisted.size,
+			workspaceRelativePath: persisted.workspaceRelativePath
+		});
+		return {
+			type: "tts_audio",
+			workspaceRelativePath: persisted.workspaceRelativePath,
+			mimeType: normalizedMime,
+			name: persisted.name
+		};
+	} catch (err) {
+		deps.log.warn({
+			err,
+			sessionKey
+		}, "Webchat TTS failed");
+		return null;
+	}
+}
+async function appendAttachmentToLastAssistant(sessionStore, sessionKey, att) {
+	const loaded = await sessionStore.load(sessionKey);
+	for (let i = loaded.length - 1; i >= 0; i--) {
+		const m = loaded[i];
+		if (m.role === "assistant") {
+			const prev = m.attachments ?? [];
+			if (prev.some((x) => x.workspaceRelativePath === att.workspaceRelativePath)) return;
+			const next = [...prev, att];
+			loaded[i] = {
+				...m,
+				attachments: next
+			};
+			await sessionStore.save(sessionKey, loaded);
+			return;
+		}
+	}
+}
+//#endregion
+export { appendAttachmentToLastAssistant, maybeEmitWebchatTts };
+
+//# sourceMappingURL=webchat-tts.js.map

package/dist/src/agent/service/webchat-tts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webchat-tts.js","names":[],"sources":["../../../../src/agent/service/webchat-tts.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport { persistOutboundTtsAudio } from '../../channels/attachments/outbound-tts-persist.js';\nimport { compressAudio } from '../../voice/tts/audio.js';\nimport { speak } from '../../voice/tts/index.js';\nimport { mergeTtsConfigFromAppConfig } from '../../voice/tts/merge-config.js';\nimport { shouldUseTTS, getChannelOutputFormat } from '../../voice/tts/service.js';\nimport { isTTSAvailable } from '../../voice/tts/factory.js';\nimport { resolveAgentHomeDir } from '../agent-scope.js';\nimport { extractProfileAgentId } from '../../config/agent-profile.js';\nimport type { AgentManager } from '../agent-manager.js';\nimport type { SessionStore } from '../../session/index.js';\nimport type { AgentMessage } from '@mariozechner/pi-agent-core';\n\nexport type WebchatTtsResult = {\n  type: 'tts_audio';\n  workspaceRelativePath: string;\n  mimeType: string;\n  name: string;\n};\n\nexport type WebchatTtsDeps = {\n  config: Config | undefined;\n  agentManager: AgentManager;\n  sessionStore: SessionStore;\n  log: { warn: (obj: Record<string, unknown>, msg: string) => void };\n};\n\n/**\n * Generate TTS for webchat when config allows; persist under agent home `tts/`.\n */\nexport async function maybeEmitWebchatTts(\n  deps: WebchatTtsDeps,\n  sessionKey: string,\n  hadInboundVoice: boolean,\n): Promise<WebchatTtsResult | null> {\n  const ttsConfig = mergeTtsConfigFromAppConfig(deps.config?.tts);\n  if (!isTTSAvailable(ttsConfig)) {\n    return null;\n  }\n  const decision = shouldUseTTS(ttsConfig, hadInboundVoice);\n  if (!decision.useTTS) {\n    return null;\n  }\n  const text = deps.agentManager.getLastAssistantContent(sessionKey)?.trim();\n  if (!text) {\n    return null;\n  }\n  try {\n    const webOut = getChannelOutputFormat('webchat');\n    const fmt = webOut.format as 'opus' | 'mp3' | 'wav';\n    const ttsResult = await speak(text, ttsConfig, {\n      appConfig: deps.config,\n      tts: { format: fmt },\n    });\n    const { buffer, format } = await compressAudio(\n      Buffer.from(ttsResult.audio),\n      ttsResult.format,\n      webOut.format === 'mp3' ? 'mp3' : 'opus',\n    );\n    const normalizedMime =\n      format === 'opus' || format === 'ogg'\n        ? 'audio/ogg'\n        : format === 'mp3' || format === 'mpeg'\n          ? 'audio/mpeg'\n          : format === 'wav'\n            ? 'audio/wav'\n            : `audio/${format}`;\n    const cfg = deps.config!;\n    const persisted = await persistOutboundTtsAudio(\n      resolveAgentHomeDir(cfg, extractProfileAgentId(sessionKey, cfg)),\n      sessionKey,\n      buffer,\n      format,\n    );\n    await appendAttachmentToLastAssistant(deps.sessionStore, sessionKey, {\n      type: 'audio',\n      mimeType: normalizedMime,\n      name: persisted.name,\n      size: persisted.size,\n      workspaceRelativePath: persisted.workspaceRelativePath,\n    });\n    return {\n      type: 'tts_audio',\n      workspaceRelativePath: persisted.workspaceRelativePath,\n      mimeType: normalizedMime,\n      name: persisted.name,\n    };\n  } catch (err) {\n    deps.log.warn({ err, sessionKey }, 'Webchat TTS failed');\n    return null;\n  }\n}\n\nexport async function appendAttachmentToLastAssistant(\n  sessionStore: SessionStore,\n  sessionKey: string,\n  att: {\n    type: string;\n    mimeType: string;\n    name: string;\n    size: number;\n    workspaceRelativePath: string;\n  },\n): Promise<void> {\n  const loaded = await sessionStore.load(sessionKey);\n  for (let i = loaded.length - 1; i >= 0; i--) {\n    const m = loaded[i] as { role?: string; attachments?: unknown[] };\n    if (m.role === 'assistant') {\n      const prev = (m.attachments ?? []) as Array<{ workspaceRelativePath?: string }>;\n      if (prev.some((x) => x.workspaceRelativePath === att.workspaceRelativePath)) {\n        return;\n      }\n      const next = [...prev, att];\n      loaded[i] = { ...m, attachments: next } as unknown as AgentMessage;\n      await sessionStore.save(sessionKey, loaded);\n      return;\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;kBAOwD;;;;AAuBxD,eAAsB,oBACpB,MACA,YACA,iBACkC;CAClC,MAAM,YAAY,4BAA4B,KAAK,QAAQ,IAAI;AAC/D,KAAI,CAAC,eAAe,UAAU,CAC5B,QAAO;AAGT,KAAI,CADa,aAAa,WAAW,gBAC5B,CAAC,OACZ,QAAO;CAET,MAAM,OAAO,KAAK,aAAa,wBAAwB,WAAW,EAAE,MAAM;AAC1E,KAAI,CAAC,KACH,QAAO;AAET,KAAI;EACF,MAAM,SAAS,uBAAuB,UAAU;EAChD,MAAM,MAAM,OAAO;EACnB,MAAM,YAAY,MAAM,MAAM,MAAM,WAAW;GAC7C,WAAW,KAAK;GAChB,KAAK,EAAE,QAAQ,KAAK;GACrB,CAAC;EACF,MAAM,EAAE,QAAQ,WAAW,MAAM,cAC/B,OAAO,KAAK,UAAU,MAAM,EAC5B,UAAU,QACV,OAAO,WAAW,QAAQ,QAAQ,OACnC;EACD,MAAM,iBACJ,WAAW,UAAU,WAAW,QAC5B,cACA,WAAW,SAAS,WAAW,SAC7B,eACA,WAAW,QACT,cACA,SAAS;EACnB,MAAM,MAAM,KAAK;EACjB,MAAM,YAAY,MAAM,wBACtB,oBAAoB,KAAK,sBAAsB,YAAY,IAAI,CAAC,EAChE,YACA,QACA,OACD;AACD,QAAM,gCAAgC,KAAK,cAAc,YAAY;GACnE,MAAM;GACN,UAAU;GACV,MAAM,UAAU;GAChB,MAAM,UAAU;GAChB,uBAAuB,UAAU;GAClC,CAAC;AACF,SAAO;GACL,MAAM;GACN,uBAAuB,UAAU;GACjC,UAAU;GACV,MAAM,UAAU;GACjB;UACM,KAAK;AACZ,OAAK,IAAI,KAAK;GAAE;GAAK;GAAY,EAAE,qBAAqB;AACxD,SAAO;;;AAIX,eAAsB,gCACpB,cACA,YACA,KAOe;CACf,MAAM,SAAS,MAAM,aAAa,KAAK,WAAW;AAClD,MAAK,IAAI,IAAI,OAAO,SAAS,GAAG,KAAK,GAAG,KAAK;EAC3C,MAAM,IAAI,OAAO;AACjB,MAAI,EAAE,SAAS,aAAa;GAC1B,MAAM,OAAQ,EAAE,eAAe,EAAE;AACjC,OAAI,KAAK,MAAM,MAAM,EAAE,0BAA0B,IAAI,sBAAsB,CACzE;GAEF,MAAM,OAAO,CAAC,GAAG,MAAM,IAAI;AAC3B,UAAO,KAAK;IAAE,GAAG;IAAG,aAAa;IAAM;AACvC,SAAM,aAAa,KAAK,YAAY,OAAO;AAC3C"}

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

@@ -5,6 +5,7 @@ import type { ChannelManager } from '../channels/manager.js';
 import type { SessionDetail } from '../session/types.js';
 import { type ReasoningLevel } from './transcript/thinking-types.js';
 import { type SkillCatalogEntry } from './agent-manager.js';
+import type { SkillMarkdownPreviewPayload } from './skills/types.js';
 import type { AgentServiceConfig, StreamHandle } from './service.types.js';
 import type { CompactionResult } from './memory/compaction.js';
 export type { AgentServiceConfig, AgentContext, StreamHandle } from './service.types.js';
@@ -57,11 +58,8 @@ export declare class AgentService {
      * Apply config after save or hot reload so the default model updates without restarting the gateway.
      */
     applyAgentDefaultsFromConfig(config: Config): void;
-    getSkillCatalog(): SkillCatalogEntry[];
-    getSkillMarkdownSource(skillName: string): {
-        name: string;
-        markdown: string;
-    } | null;
+    getSkillCatalog(lang?: string): SkillCatalogEntry[];
+    getSkillMarkdownSource(skillName: string, lang?: string): SkillMarkdownPreviewPayload | null;
     refreshSkillsAfterDiskChange(): void;
     refreshSkillsAfterSkillConfigChange(): void;
     getModelForSession(sessionKey: string): string;
@@ -108,7 +106,6 @@ export declare class AgentService {
     private prepareLoadedSessionMessages;
     private parseSessionKey;
     private initSessionContext;
-    private buildMessageContent;
     /**
      * Persist inbound file attachments under agent home `inbound/` (non-images with data).
      * Idempotent if `workspaceRelativePath` is already set on an attachment.
@@ -135,6 +132,10 @@ export declare class AgentService {
         instructions?: string;
         force?: boolean;
     }): Promise<CompactionResult>;
+    /**
+     * Drop in-memory agent so the next turn reloads transcript from disk (e.g. after checkpoint restore).
+     */
+    evictSessionAgent(sessionKey: string): void;
     /**
      * One-shot LLM answer for /btw: uses transcript as background only; does not persist to session.
      */
@@ -142,7 +143,6 @@ export declare class AgentService {
         text: string;
         error?: string;
     }>;
-    private formatMessagesForBtw;
     /** Markdown or JSON summary for /context (prompt assembly is approximated from config + transcript stats). */
     getSessionContextReport(sessionKey: string, mode: 'list' | 'detail' | 'json'): Promise<string>;
     getSessionStats(sessionKey: string, messages: AgentMessage[]): {
@@ -224,11 +224,7 @@ export declare class AgentService {
      * See `Agent.steer` in `@mariozechner/pi-agent-core`.
      */
     steerWebchatSession(sessionKey: string, text: string): Promise<boolean>;
-    /**
-     * Generate TTS for webchat when config allows, persist under agent home `tts/`, attach to last assistant turn.
-     */
-    private maybeEmitWebchatTts;
-    private appendAttachmentToLastAssistant;
+    private createRunProcessDirectDeps;
     processDirect(content: string, sessionKey?: string, attachments?: Array<{
         type: string;
         mimeType?: string;