@xopcai/xopc 0.0.99 → 0.0.100

package/dist/src/agent/inbound/attachment-pipeline.js

@@ -0,0 +1,169 @@
+import { readAgentMessageContent } from "../memory/agent-message-access.js";
+import { readMediaReferenceBase64 } from "../../media/media-reference.js";
+import { isImageInboundAttachment } from "../../channels/attachments/attachment-classifiers.js";
+import "../../channels/attachments/inbound-persist.js";
+import { expandAtFileMentionsInPlainText } from "../context/expand-at-file-mentions.js";
+import { resolveImageHandlingStrategy } from "../image/vision-detection.js";
+import { resolveInboundImageContentParts } from "../image/inbound-image-handling.js";
+//#region src/agent/inbound/attachment-pipeline.ts
+const VISION_INLINE_MAX_BYTES = 2 * 1024 * 1024;
+function textBlocksFromContent(content) {
+	if (typeof content === "string") return content.trim() ? [content] : [];
+	if (!Array.isArray(content)) return [];
+	const out = [];
+	for (const block of content) if (block && typeof block === "object" && block.type === "text") {
+		const t = block.text;
+		if (typeof t === "string" && t.trim()) out.push(t);
+	}
+	return out;
+}
+function joinTextBlocks(parts) {
+	return parts.join("\n").trim();
+}
+function buildMediaPathFields(media) {
+	if (!media.length) return {};
+	return {
+		MediaPath: media[0].path,
+		MediaPaths: media.map((m) => m.path),
+		MediaTypes: media.map((m) => m.mimeType)
+	};
+}
+function assertUserContentHasNoInlineMedia(content) {
+	if (!Array.isArray(content)) return;
+	for (const block of content) {
+		if (!block || typeof block !== "object") continue;
+		if (block.type === "image") throw new Error("User transcript content must not contain image blocks");
+	}
+}
+function assertTranscriptUserMessage(message) {
+	if (message.role !== "user") return;
+	assertUserContentHasNoInlineMedia(message.content);
+	const media = message.media;
+	if (!media?.length) return;
+	for (const ref of media) {
+		if (!ref.uri?.trim()) throw new Error("User transcript media ref missing uri");
+		if ("data" in ref && typeof ref.data === "string") throw new Error("User transcript media ref must not include data");
+	}
+}
+async function readImageBase64FromRef(ref) {
+	const loaded = await readMediaReferenceBase64(ref.uri, VISION_INLINE_MAX_BYTES);
+	return {
+		data: loaded.data,
+		mimeType: ref.mimeType?.startsWith("image/") ? ref.mimeType : loaded.mimeType
+	};
+}
+function appendMediaAttachedLines(textParts, media) {
+	for (const ref of media) if (!isImageInboundAttachment(ref)) textParts.push([
+		`[media attached: ${ref.name} (${ref.mimeType}, ${ref.size} bytes)]`,
+		`xopc-media-uri:${ref.uri}`,
+		`xopc-media-path:${ref.path}`,
+		"Use the read_media tool with the xopc-media-uri value when you need to inspect this attachment."
+	].join("\n"));
+}
+async function expandUserText(text, sessionKey, agentManager) {
+	if (!text.trim()) return "";
+	let out = text;
+	if (/@file:/.test(out)) {
+		const wsKey = sessionKey || "agent:main:main";
+		const root = agentManager.getResolvedWorkspaceForSession(wsKey);
+		out = await expandAtFileMentionsInPlainText(out, root);
+	}
+	return out.trim();
+}
+/**
+* Build the transcript row for a user turn (text + media metadata only).
+*/
+async function buildTranscriptUserMessage(opts) {
+	const expandedText = await expandUserText(opts.text, opts.sessionKey, opts.agentManager);
+	const prepared = opts.prepared ?? [];
+	const imageRefs = prepared.filter(isImageInboundAttachment);
+	const textParts = [];
+	if (expandedText) textParts.push(expandedText);
+	const strategy = resolveImageHandlingStrategy(opts.modelRef);
+	if (strategy !== "native") appendMediaAttachedLines(textParts, prepared.filter((m) => !isImageInboundAttachment(m)));
+	if (imageRefs.length > 0 && strategy !== "native") {
+		const images = await Promise.all(imageRefs.map((ref) => readImageBase64FromRef(ref)));
+		const parts = await resolveInboundImageContentParts({
+			modelRef: opts.modelRef,
+			cfg: opts.config,
+			userTextForContext: expandedText,
+			images
+		});
+		for (const part of parts) if (part.type === "text" && part.text.trim()) textParts.push(part.text.trim());
+	}
+	if (textParts.length === 0 && prepared.length > 0) textParts.push("Please analyze the attachment(s) I sent.");
+	const message = {
+		role: "user",
+		content: joinTextBlocks(textParts),
+		timestamp: Date.now(),
+		...prepared.length > 0 ? {
+			media: prepared,
+			...buildMediaPathFields(prepared)
+		} : {}
+	};
+	assertTranscriptUserMessage(message);
+	return message;
+}
+/** Hydrate images from media store for the current LLM prompt. */
+async function hydrateUserTurnForLlm(opts) {
+	const text = joinTextBlocks(textBlocksFromContent(readAgentMessageContent(opts.message)));
+	const media = opts.message.media ?? [];
+	const images = [];
+	if (resolveImageHandlingStrategy(opts.modelRef) === "native") for (const ref of media.filter(isImageInboundAttachment)) {
+		const loaded = await readImageBase64FromRef(ref);
+		images.push({
+			type: "image",
+			data: loaded.data,
+			mimeType: loaded.mimeType
+		});
+	}
+	return {
+		text,
+		images
+	};
+}
+const pendingTranscriptBySession = /* @__PURE__ */ new Map();
+function messageTextForPendingCompare(message) {
+	return joinTextBlocks(textBlocksFromContent(readAgentMessageContent(message)));
+}
+function pendingMatchesMessage(pending, message) {
+	const pendingText = messageTextForPendingCompare(pending);
+	const actualText = messageTextForPendingCompare(message);
+	if (!pendingText) return true;
+	if (!actualText) return false;
+	return actualText.includes(pendingText) || pendingText.includes(actualText);
+}
+function setPendingTranscriptUserMessage(sessionKey, message) {
+	assertTranscriptUserMessage(message);
+	pendingTranscriptBySession.set(sessionKey, message);
+}
+function takePendingTranscriptUserMessage(sessionKey) {
+	const msg = pendingTranscriptBySession.get(sessionKey);
+	pendingTranscriptBySession.delete(sessionKey);
+	return msg;
+}
+function clearPendingTranscriptUserMessage(sessionKey, message) {
+	const existing = pendingTranscriptBySession.get(sessionKey);
+	if (!existing) return;
+	if (message && existing !== message) return;
+	pendingTranscriptBySession.delete(sessionKey);
+}
+function pendingTranscriptReferencesMediaUri(sessionKey, uri) {
+	return pendingTranscriptBySession.get(sessionKey)?.media?.some((ref) => ref.uri === uri.trim()) === true;
+}
+function transformUserMessageForPersistence(sessionKey, message) {
+	if (message.role !== "user") return message;
+	if (sessionKey) {
+		const pending = pendingTranscriptBySession.get(sessionKey);
+		if (pending && pendingMatchesMessage(pending, message)) {
+			pendingTranscriptBySession.delete(sessionKey);
+			return pending;
+		}
+	}
+	assertTranscriptUserMessage(message);
+	return message;
+}
+//#endregion
+export { assertTranscriptUserMessage, buildTranscriptUserMessage, clearPendingTranscriptUserMessage, hydrateUserTurnForLlm, pendingTranscriptReferencesMediaUri, setPendingTranscriptUserMessage, takePendingTranscriptUserMessage, transformUserMessageForPersistence };
+
+//# sourceMappingURL=attachment-pipeline.js.map

package/dist/src/agent/inbound/attachment-pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-pipeline.js","names":[],"sources":["../../../../src/agent/inbound/attachment-pipeline.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport type { ImageContent } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../config/schema.js';\nimport {\n  isImageInboundAttachment,\n  type MediaRef,\n} from '../../channels/attachments/inbound-persist.js';\nimport { readMediaReferenceBase64 } from '../../media/media-reference.js';\nimport { expandAtFileMentionsInPlainText } from '../context/expand-at-file-mentions.js';\nimport { readAgentMessageContent } from '../memory/agent-message-access.js';\nimport { resolveInboundImageContentParts } from '../image/inbound-image-handling.js';\nimport { resolveImageHandlingStrategy } from '../image/vision-detection.js';\nimport type { AgentInstanceGateway } from '../agent-instance-gateway.js';\n\nexport type TranscriptUserMessage = AgentMessage & {\n  media?: MediaRef[];\n  MediaPath?: string;\n  MediaPaths?: string[];\n  MediaTypes?: string[];\n};\n\nexport type LlmUserTurn = {\n  text: string;\n  images: ImageContent[];\n};\n\nconst VISION_INLINE_MAX_BYTES = 2 * 1024 * 1024;\n\nfunction textBlocksFromContent(content: unknown): string[] {\n  if (typeof content === 'string') {\n    return content.trim() ? [content] : [];\n  }\n  if (!Array.isArray(content)) {\n    return [];\n  }\n  const out: string[] = [];\n  for (const block of content) {\n    if (block && typeof block === 'object' && (block as { type?: string }).type === 'text') {\n      const t = (block as { text?: string }).text;\n      if (typeof t === 'string' && t.trim()) {\n        out.push(t);\n      }\n    }\n  }\n  return out;\n}\n\nfunction joinTextBlocks(parts: string[]): string {\n  return parts.join('\\n').trim();\n}\n\nfunction buildMediaPathFields(media: MediaRef[]): Pick<TranscriptUserMessage, 'MediaPath' | 'MediaPaths' | 'MediaTypes'> {\n  if (!media.length) return {};\n  return {\n    MediaPath: media[0]!.path,\n    MediaPaths: media.map((m) => m.path),\n    MediaTypes: media.map((m) => m.mimeType),\n  };\n}\n\nfunction assertUserContentHasNoInlineMedia(content: unknown): void {\n  if (!Array.isArray(content)) {\n    return;\n  }\n  for (const block of content) {\n    if (!block || typeof block !== 'object') {\n      continue;\n    }\n    const type = (block as { type?: string }).type;\n    if (type === 'image') {\n      throw new Error('User transcript content must not contain image blocks');\n    }\n  }\n}\n\nexport function assertTranscriptUserMessage(message: AgentMessage): void {\n  if ((message as { role?: string }).role !== 'user') {\n    return;\n  }\n  assertUserContentHasNoInlineMedia((message as { content?: unknown }).content);\n  const media = (message as TranscriptUserMessage).media;\n  if (!media?.length) {\n    return;\n  }\n  for (const ref of media) {\n    if (!ref.uri?.trim()) {\n      throw new Error('User transcript media ref missing uri');\n    }\n    if ('data' in ref && typeof (ref as { data?: unknown }).data === 'string') {\n      throw new Error('User transcript media ref must not include data');\n    }\n  }\n}\n\nasync function readImageBase64FromRef(ref: MediaRef): Promise<{ data: string; mimeType: string }> {\n  const loaded = await readMediaReferenceBase64(ref.uri, VISION_INLINE_MAX_BYTES);\n  return {\n    data: loaded.data,\n    mimeType: ref.mimeType?.startsWith('image/') ? ref.mimeType : loaded.mimeType,\n  };\n}\n\nfunction appendMediaAttachedLines(textParts: string[], media: MediaRef[]): void {\n  for (const ref of media) {\n    if (!isImageInboundAttachment(ref)) {\n      textParts.push(\n        [\n          `[media attached: ${ref.name} (${ref.mimeType}, ${ref.size} bytes)]`,\n          `xopc-media-uri:${ref.uri}`,\n          `xopc-media-path:${ref.path}`,\n          'Use the read_media tool with the xopc-media-uri value when you need to inspect this attachment.',\n        ].join('\\n'),\n      );\n    }\n  }\n}\n\nasync function expandUserText(\n  text: string,\n  sessionKey: string,\n  agentManager: AgentInstanceGateway,\n): Promise<string> {\n  if (!text.trim()) {\n    return '';\n  }\n  let out = text;\n  if (/@file:/.test(out)) {\n    const wsKey = sessionKey || 'agent:main:main';\n    const root = agentManager.getResolvedWorkspaceForSession(wsKey);\n    out = await expandAtFileMentionsInPlainText(out, root);\n  }\n  return out.trim();\n}\n\n/**\n * Build the transcript row for a user turn (text + media metadata only).\n */\nexport async function buildTranscriptUserMessage(opts: {\n  text: string;\n  prepared: MediaRef[] | undefined;\n  sessionKey: string;\n  modelRef: string;\n  config: Config | undefined;\n  agentManager: AgentInstanceGateway;\n}): Promise<TranscriptUserMessage> {\n  const expandedText = await expandUserText(opts.text, opts.sessionKey, opts.agentManager);\n  const prepared = opts.prepared ?? [];\n  const imageRefs = prepared.filter(isImageInboundAttachment);\n\n  const textParts: string[] = [];\n  if (expandedText) {\n    textParts.push(expandedText);\n  }\n\n  const strategy = resolveImageHandlingStrategy(opts.modelRef);\n\n  if (strategy !== 'native') {\n    appendMediaAttachedLines(textParts, prepared.filter((m) => !isImageInboundAttachment(m)));\n  }\n\n  if (imageRefs.length > 0 && strategy !== 'native') {\n    const images = await Promise.all(imageRefs.map((ref) => readImageBase64FromRef(ref)));\n    const parts = await resolveInboundImageContentParts({\n      modelRef: opts.modelRef,\n      cfg: opts.config,\n      userTextForContext: expandedText,\n      images,\n    });\n    for (const part of parts) {\n      if (part.type === 'text' && part.text.trim()) {\n        textParts.push(part.text.trim());\n      }\n    }\n  }\n\n  if (textParts.length === 0 && prepared.length > 0) {\n    textParts.push('Please analyze the attachment(s) I sent.');\n  }\n\n  const content = joinTextBlocks(textParts);\n  const message: TranscriptUserMessage = {\n    role: 'user',\n    content,\n    timestamp: Date.now(),\n    ...(prepared.length > 0 ? { media: prepared, ...buildMediaPathFields(prepared) } : {}),\n  };\n  assertTranscriptUserMessage(message);\n  return message;\n}\n\n/** Hydrate images from media store for the current LLM prompt. */\nexport async function hydrateUserTurnForLlm(opts: {\n  message: TranscriptUserMessage;\n  modelRef: string;\n}): Promise<LlmUserTurn> {\n  const text = joinTextBlocks(textBlocksFromContent(readAgentMessageContent(opts.message)));\n  const media = opts.message.media ?? [];\n  const images: ImageContent[] = [];\n\n  if (resolveImageHandlingStrategy(opts.modelRef) === 'native') {\n    for (const ref of media.filter(isImageInboundAttachment)) {\n      const loaded = await readImageBase64FromRef(ref);\n      images.push({ type: 'image', data: loaded.data, mimeType: loaded.mimeType });\n    }\n  }\n\n  return { text, images };\n}\n\nconst pendingTranscriptBySession = new Map<string, TranscriptUserMessage>();\n\nfunction messageTextForPendingCompare(message: AgentMessage): string {\n  return joinTextBlocks(textBlocksFromContent(readAgentMessageContent(message)));\n}\n\nfunction pendingMatchesMessage(pending: TranscriptUserMessage, message: AgentMessage): boolean {\n  const pendingText = messageTextForPendingCompare(pending);\n  const actualText = messageTextForPendingCompare(message);\n  if (!pendingText) {\n    return true;\n  }\n  if (!actualText) {\n    return false;\n  }\n  return actualText.includes(pendingText) || pendingText.includes(actualText);\n}\n\nexport function setPendingTranscriptUserMessage(sessionKey: string, message: TranscriptUserMessage): void {\n  assertTranscriptUserMessage(message);\n  pendingTranscriptBySession.set(sessionKey, message);\n}\n\nexport function takePendingTranscriptUserMessage(sessionKey: string): TranscriptUserMessage | undefined {\n  const msg = pendingTranscriptBySession.get(sessionKey);\n  pendingTranscriptBySession.delete(sessionKey);\n  return msg;\n}\n\nexport function clearPendingTranscriptUserMessage(sessionKey: string, message?: TranscriptUserMessage): void {\n  const existing = pendingTranscriptBySession.get(sessionKey);\n  if (!existing) {\n    return;\n  }\n  if (message && existing !== message) {\n    return;\n  }\n  pendingTranscriptBySession.delete(sessionKey);\n}\n\nexport function pendingTranscriptReferencesMediaUri(sessionKey: string, uri: string): boolean {\n  const pending = pendingTranscriptBySession.get(sessionKey);\n  return pending?.media?.some((ref) => ref.uri === uri.trim()) === true;\n}\n\nexport function transformUserMessageForPersistence(\n  sessionKey: string | undefined,\n  message: AgentMessage,\n): AgentMessage {\n  if ((message as { role?: string }).role !== 'user') {\n    return message;\n  }\n  if (sessionKey) {\n    const pending = pendingTranscriptBySession.get(sessionKey);\n    if (pending && pendingMatchesMessage(pending, message)) {\n      pendingTranscriptBySession.delete(sessionKey);\n      return pending;\n    }\n  }\n  assertTranscriptUserMessage(message);\n  return message;\n}\n"],"mappings":"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"}

package/dist/src/agent/inbound/turn-dispatcher.d.ts

@@ -22,8 +22,7 @@ import type { ModelManager } from '../models/index.js';
 import type { SessionConfigStore } from '../../session/index.js';
 import type { SessionStore } from '../../session/store.js';
 import type { SessionContext, SessionHydrator, SessionStateBag } from '../session/index.js';
-import type { InternalAttachmentRoots } from '../../channels/attachments/inbound-persist.js';
-import { type DirectInboundAttachment } from '../service/build-direct-message-content.js';
+import type { InboundAttachmentInput, MediaRef } from '../../channels/attachments/inbound-persist.js';
 import { type ProcessDirectStreamingSseEvent } from '../service/process-direct-streaming.js';
 export interface TurnDispatcherConfig {
     log: ContextualLogger;
@@ -44,8 +43,7 @@ export interface TurnDispatcherConfig {
     initSessionContext: (sessionKey: string, channel: string, chatId: string) => SessionContext;
     /** Per-session config hydration: workspace, model, thinking. */
     sessionHydrator: SessionHydrator;
-    attachmentRootsForSession: (sessionKey: string) => InternalAttachmentRoots;
-    prepareInboundAttachments: (sessionKey: string, attachments?: DirectInboundAttachment[]) => Promise<DirectInboundAttachment[] | undefined>;
+    prepareInboundAttachments: (sessionKey: string, attachments?: InboundAttachmentInput[]) => Promise<MediaRef[] | undefined>;
     enqueueMaybeAutoTitleAfterPersist: (sessionKey: string) => void;
     enqueueProvisionalSessionTitle?: (sessionKey: string, userText: string) => void;
     endDirectRequestContext: () => void;
@@ -56,7 +54,7 @@ export interface TurnDispatcherConfig {
         previousSessionId: string;
     } | null>;
 }
-export type DirectAttachment = DirectInboundAttachment;
+export type DirectAttachment = InboundAttachmentInput;
 export declare class TurnDispatcher {
     private readonly cfg;
     private readonly log;

package/dist/src/agent/inbound/turn-dispatcher.js

@@ -78,10 +78,9 @@ var TurnDispatcher = class {
 			applyResolvedThinkingLevel: (sk, t) => c.sessionHydrator.thinking(sk, t),
 			getConfig: c.getConfig,
 			sessionConfigStore: c.sessionConfigStore,
-			attachmentRootsForSession: c.attachmentRootsForSession,
 			commandHandler: c.commandHandler,
 			prepareInboundAttachments: c.prepareInboundAttachments,
-			buildMessageContent: (text, prepared, sk) => buildDirectUserMessageContent({
+			buildTranscriptUserMessage: async (text, prepared, sk) => buildDirectUserMessageContent({
 				content: text,
 				attachments: prepared,
 				sessionKey: sk,

package/dist/src/agent/inbound/turn-dispatcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"turn-dispatcher.js","names":[],"sources":["../../../../src/agent/inbound/turn-dispatcher.ts"],"sourcesContent":["/**\n * TurnDispatcher — single entry point for direct (non-bus) agent turns.\n *\n * Wraps the two existing direct-turn runners (one-shot and streaming) so the\n * parent `AgentService` no longer carries a pair of huge `createXxxDeps()`\n * factories. The public surface — `processDirect`, `processDirectStreaming`,\n * `steerWebchatSession`, `enqueueWebchatSseEvent`,\n * `notifyWebchatTranscriptAppend` — matches what `AgentService` exposed\n * previously, so callers (gateway, CLI) are unchanged.\n *\n * Like `OutboundCoordinator` and `InboundLoop`, this class accepts a wide\n * dependency bag in its constructor (the direct-turn pipeline touches almost\n * every other subsystem). The win is that AgentService becomes the only place\n * that wires those dependencies together; individual responsibilities now live\n * in their own classes and are unit-testable.\n */\n\nimport type { Config } from '../../config/schema.js';\nimport type { ContextualLogger } from '../../utils/logger/types.js';\n\nimport type { AgentManager } from '../agent-manager.js';\nimport type { CommandHandler } from '../messaging/command-handler.js';\nimport type { ModelManager } from '../models/index.js';\nimport type { SessionConfigStore } from '../../session/index.js';\nimport type { SessionStore } from '../../session/store.js';\nimport type {\n  SessionContext,\n  SessionHydrator,\n  SessionStateBag,\n} from '../session/index.js';\nimport { queueEmbeddedSteer } from '../embedded/runs.js';\nimport type { InternalAttachmentRoots } from '../../channels/attachments/inbound-persist.js';\nimport {\n  buildDirectUserMessageContent,\n  type DirectInboundAttachment,\n} from '../service/build-direct-message-content.js';\nimport {\n  runProcessDirectStreaming,\n  type ProcessDirectStreamingDeps,\n  type ProcessDirectStreamingSseEvent,\n} from '../service/process-direct-streaming.js';\nimport {\n  runProcessDirect,\n  type RunProcessDirectDeps,\n} from '../service/process-direct-one-shot.js';\nimport { maybeEmitWebchatTts } from '../service/webchat-tts.js';\n\nexport interface TurnDispatcherConfig {\n  log: ContextualLogger;\n  agentManager: AgentManager;\n  sessionStore: SessionStore;\n  modelManager: ModelManager;\n  sessionConfigStore: SessionConfigStore;\n  sessionState: SessionStateBag;\n  commandHandler: CommandHandler;\n  getConfig: () => Config | undefined;\n  /** Strict accessor — required for direct-turn paths that must have a config. */\n  requireConfig: () => Config;\n  parseSessionKey: (sessionKey: string) => { channel: string; chatId: string };\n  /** Establish per-session context (also creates the Agent + subscribes to events). */\n  initSessionContext: (sessionKey: string, channel: string, chatId: string) => SessionContext;\n  /** Per-session config hydration: workspace, model, thinking. */\n  sessionHydrator: SessionHydrator;\n  attachmentRootsForSession: (sessionKey: string) => InternalAttachmentRoots;\n  prepareInboundAttachments: (\n    sessionKey: string,\n    attachments?: DirectInboundAttachment[],\n  ) => Promise<DirectInboundAttachment[] | undefined>;\n  enqueueMaybeAutoTitleAfterPersist: (sessionKey: string) => void;\n  enqueueProvisionalSessionTitle?: (sessionKey: string, userText: string) => void;\n  endDirectRequestContext: () => void;\n  /** Gateway hook fired after assistant text lands on disk (UI refetch). */\n  onSessionTranscriptUpdated?: (sessionKey: string) => void;\n  resetSession: (sessionKey: string) => Promise<{ sessionId: string; previousSessionId: string } | null>;\n}\n\nexport type DirectAttachment = DirectInboundAttachment;\n\nexport class TurnDispatcher {\n  private readonly cfg: TurnDispatcherConfig;\n  private readonly log: ContextualLogger;\n\n  constructor(cfg: TurnDispatcherConfig) {\n    this.cfg = cfg;\n    this.log = cfg.log;\n  }\n\n  /** One-shot direct turn (CLI / embedded TUI). */\n  processDirect(\n    content: string,\n    sessionKey = 'agent:main:main',\n    attachments?: DirectAttachment[],\n    thinking?: string,\n  ): Promise<string> {\n    return runProcessDirect(this.buildOneShotDeps(), {\n      content,\n      sessionKey,\n      attachments,\n      thinking,\n    });\n  }\n\n  /** Streaming direct turn (webchat SSE / CLI streaming). */\n  async *processDirectStreaming(\n    content: string,\n    sessionKey = 'agent:main:main',\n    attachments?: DirectAttachment[],\n    thinking?: string,\n    options?: { signal?: AbortSignal },\n  ): AsyncGenerator<ProcessDirectStreamingSseEvent, void, unknown> {\n    yield* runProcessDirectStreaming(this.buildStreamingDeps(), {\n      content,\n      sessionKey,\n      attachments,\n      thinking,\n      signal: options?.signal,\n    });\n  }\n\n  /** Push an out-of-band event into the live webchat stream for a session. */\n  enqueueWebchatSseEvent(\n    sessionKey: string,\n    event: { type: string; [key: string]: unknown },\n  ): void {\n    const pub = this.cfg.sessionState.getWebchatPublisher(sessionKey);\n    if (pub) {\n      pub(event);\n    }\n  }\n\n  /** Stream assistant text to live webchat session + notify transcript listeners. */\n  notifyWebchatTranscriptAppend(sessionKey: string, assistantText: string): void {\n    const trimmed = assistantText.trim();\n    if (trimmed) {\n      this.enqueueWebchatSseEvent(sessionKey, { type: 'token', content: trimmed });\n    }\n    this.cfg.onSessionTranscriptUpdated?.(sessionKey);\n  }\n\n  /**\n   * Queue a steering user message into pi-agent's in-flight run (delivered\n   * after current tool work, before the next LLM call). See `Agent.steer`\n   * in `@earendil-works/pi-agent-core`.\n   */\n  async steerWebchatSession(sessionKey: string, text: string): Promise<boolean> {\n    const trimmed = text.trim();\n    if (!trimmed) return false;\n    try {\n      return await queueEmbeddedSteer(sessionKey, trimmed);\n    } catch (err) {\n      this.log.warn({ err, sessionKey }, 'steerWebchatSession failed');\n      return false;\n    }\n  }\n\n  private buildStreamingDeps(): ProcessDirectStreamingDeps {\n    const c = this.cfg;\n    return {\n      log: this.log,\n      parseSessionKey: c.parseSessionKey,\n      initDirectStreamingSession: c.initSessionContext,\n      registerWebchatSsePublisher: (sk, publisher) =>\n        c.sessionState.registerWebchatPublisher(sk, publisher),\n      unregisterWebchatSsePublisher: (sk) => c.sessionState.unregisterWebchatPublisher(sk),\n      agentManager: c.agentManager,\n      hydrateSessionWorkspaceFromStore: (sk) => c.sessionHydrator.workspace(sk),\n      hydrateSessionModelFromStore: (sk) => c.sessionHydrator.model(sk),\n      sessionStore: c.sessionStore,\n      modelManager: c.modelManager,\n      applyResolvedThinkingLevel: (sk, t) => c.sessionHydrator.thinking(sk, t),\n      getConfig: c.getConfig,\n      sessionConfigStore: c.sessionConfigStore,\n      attachmentRootsForSession: c.attachmentRootsForSession,\n      commandHandler: c.commandHandler,\n      prepareInboundAttachments: c.prepareInboundAttachments,\n      buildMessageContent: (text, prepared, sk) =>\n        buildDirectUserMessageContent({\n          content: text,\n          attachments: prepared,\n          sessionKey: sk,\n          config: c.requireConfig(),\n          agentManager: c.agentManager,\n          modelManager: c.modelManager,\n        }),\n      recordPersistentGoalStreamOutcome: (sk, o) =>\n        c.sessionState.recordPersistentGoalStreamOutcome(sk, o),\n      enqueueProvisionalSessionTitle: (sk, userText) => {\n        c.enqueueProvisionalSessionTitle?.(sk, userText);\n      },\n      onTurnComplete: (sk, text) => {\n        if (text) {\n          c.sessionState.setLastAssistantText(sk, text);\n        }\n        c.enqueueMaybeAutoTitleAfterPersist(sk);\n      },\n      reloadWebchatTranscript: (sk) => {\n        c.onSessionTranscriptUpdated?.(sk);\n      },\n      maybeEmitWebchatTts: (sk, hadVoice) =>\n        maybeEmitWebchatTts(\n          {\n            config: c.getConfig(),\n            sessionStore: c.sessionStore,\n            getLastAssistantPlainText: (sessionKey) =>\n              c.sessionState.getLastAssistantText(sessionKey) ??\n              c.agentManager.getLastAssistantContent(sessionKey) ??\n              '',\n            log: this.log,\n          },\n          sk,\n          hadVoice,\n        ),\n      endDirectRequestContext: c.endDirectRequestContext,\n      resetSession: c.resetSession,\n    };\n  }\n\n  private buildOneShotDeps(): RunProcessDirectDeps {\n    const c = this.cfg;\n    const cfg = c.requireConfig();\n    return {\n      log: this.log,\n      config: cfg,\n      parseSessionKey: c.parseSessionKey,\n      initSessionContext: (sk, channel, chatId) => {\n        void c.initSessionContext(sk, channel, chatId);\n      },\n      hydrateSessionWorkspaceFromStore: (sk) => c.sessionHydrator.workspace(sk),\n      hydrateSessionModelFromStore: (sk) => c.sessionHydrator.model(sk),\n      agentManager: c.agentManager,\n      sessionStore: c.sessionStore,\n      modelManager: c.modelManager,\n      applyResolvedThinkingLevel: (sk, t) => c.sessionHydrator.thinking(sk, t),\n      prepareInboundAttachments: c.prepareInboundAttachments,\n      commandHandler: c.commandHandler,\n      onTurnComplete: (sk, text) => {\n        if (text) {\n          c.sessionState.setLastAssistantText(sk, text);\n        }\n        c.enqueueMaybeAutoTitleAfterPersist(sk);\n      },\n      endDirectRequestContext: c.endDirectRequestContext,\n      resetSession: c.resetSession,\n    };\n  }\n}\n"],"mappings":";;;;;;AA8EA,IAAa,iBAAb,MAA4B;CAC1B;CACA;CAEA,YAAY,KAA2B;AACrC,OAAK,MAAM;AACX,OAAK,MAAM,IAAI;;;CAIjB,cACE,SACA,aAAa,mBACb,aACA,UACiB;AACjB,SAAO,iBAAiB,KAAK,kBAAkB,EAAE;GAC/C;GACA;GACA;GACA;GACD,CAAC;;;CAIJ,OAAO,uBACL,SACA,aAAa,mBACb,aACA,UACA,SAC+D;AAC/D,SAAO,0BAA0B,KAAK,oBAAoB,EAAE;GAC1D;GACA;GACA;GACA;GACA,QAAQ,SAAS;GAClB,CAAC;;;CAIJ,uBACE,YACA,OACM;EACN,MAAM,MAAM,KAAK,IAAI,aAAa,oBAAoB,WAAW;AACjE,MAAI,IACF,KAAI,MAAM;;;CAKd,8BAA8B,YAAoB,eAA6B;EAC7E,MAAM,UAAU,cAAc,MAAM;AACpC,MAAI,QACF,MAAK,uBAAuB,YAAY;GAAE,MAAM;GAAS,SAAS;GAAS,CAAC;AAE9E,OAAK,IAAI,6BAA6B,WAAW;;;;;;;CAQnD,MAAM,oBAAoB,YAAoB,MAAgC;EAC5E,MAAM,UAAU,KAAK,MAAM;AAC3B,MAAI,CAAC,QAAS,QAAO;AACrB,MAAI;AACF,UAAO,MAAM,mBAAmB,YAAY,QAAQ;WAC7C,KAAK;AACZ,QAAK,IAAI,KAAK;IAAE;IAAK;IAAY,EAAE,6BAA6B;AAChE,UAAO;;;CAIX,qBAAyD;EACvD,MAAM,IAAI,KAAK;AACf,SAAO;GACL,KAAK,KAAK;GACV,iBAAiB,EAAE;GACnB,4BAA4B,EAAE;GAC9B,8BAA8B,IAAI,cAChC,EAAE,aAAa,yBAAyB,IAAI,UAAU;GACxD,gCAAgC,OAAO,EAAE,aAAa,2BAA2B,GAAG;GACpF,cAAc,EAAE;GAChB,mCAAmC,OAAO,EAAE,gBAAgB,UAAU,GAAG;GACzE,+BAA+B,OAAO,EAAE,gBAAgB,MAAM,GAAG;GACjE,cAAc,EAAE;GAChB,cAAc,EAAE;GAChB,6BAA6B,IAAI,MAAM,EAAE,gBAAgB,SAAS,IAAI,EAAE;GACxE,WAAW,EAAE;GACb,oBAAoB,EAAE;GACtB,2BAA2B,EAAE;GAC7B,gBAAgB,EAAE;GAClB,2BAA2B,EAAE;GAC7B,sBAAsB,MAAM,UAAU,OACpC,8BAA8B;IAC5B,SAAS;IACT,aAAa;IACb,YAAY;IACZ,QAAQ,EAAE,eAAe;IACzB,cAAc,EAAE;IAChB,cAAc,EAAE;IACjB,CAAC;GACJ,oCAAoC,IAAI,MACtC,EAAE,aAAa,kCAAkC,IAAI,EAAE;GACzD,iCAAiC,IAAI,aAAa;AAChD,MAAE,iCAAiC,IAAI,SAAS;;GAElD,iBAAiB,IAAI,SAAS;AAC5B,QAAI,KACF,GAAE,aAAa,qBAAqB,IAAI,KAAK;AAE/C,MAAE,kCAAkC,GAAG;;GAEzC,0BAA0B,OAAO;AAC/B,MAAE,6BAA6B,GAAG;;GAEpC,sBAAsB,IAAI,aACxB,oBACE;IACE,QAAQ,EAAE,WAAW;IACrB,cAAc,EAAE;IAChB,4BAA4B,eAC1B,EAAE,aAAa,qBAAqB,WAAW,IAC/C,EAAE,aAAa,wBAAwB,WAAW,IAClD;IACF,KAAK,KAAK;IACX,EACD,IACA,SACD;GACH,yBAAyB,EAAE;GAC3B,cAAc,EAAE;GACjB;;CAGH,mBAAiD;EAC/C,MAAM,IAAI,KAAK;EACf,MAAM,MAAM,EAAE,eAAe;AAC7B,SAAO;GACL,KAAK,KAAK;GACV,QAAQ;GACR,iBAAiB,EAAE;GACnB,qBAAqB,IAAI,SAAS,WAAW;AACtC,MAAE,mBAAmB,IAAI,SAAS,OAAO;;GAEhD,mCAAmC,OAAO,EAAE,gBAAgB,UAAU,GAAG;GACzE,+BAA+B,OAAO,EAAE,gBAAgB,MAAM,GAAG;GACjE,cAAc,EAAE;GAChB,cAAc,EAAE;GAChB,cAAc,EAAE;GAChB,6BAA6B,IAAI,MAAM,EAAE,gBAAgB,SAAS,IAAI,EAAE;GACxE,2BAA2B,EAAE;GAC7B,gBAAgB,EAAE;GAClB,iBAAiB,IAAI,SAAS;AAC5B,QAAI,KACF,GAAE,aAAa,qBAAqB,IAAI,KAAK;AAE/C,MAAE,kCAAkC,GAAG;;GAEzC,yBAAyB,EAAE;GAC3B,cAAc,EAAE;GACjB"}
+{"version":3,"file":"turn-dispatcher.js","names":[],"sources":["../../../../src/agent/inbound/turn-dispatcher.ts"],"sourcesContent":["/**\n * TurnDispatcher — single entry point for direct (non-bus) agent turns.\n *\n * Wraps the two existing direct-turn runners (one-shot and streaming) so the\n * parent `AgentService` no longer carries a pair of huge `createXxxDeps()`\n * factories. The public surface — `processDirect`, `processDirectStreaming`,\n * `steerWebchatSession`, `enqueueWebchatSseEvent`,\n * `notifyWebchatTranscriptAppend` — matches what `AgentService` exposed\n * previously, so callers (gateway, CLI) are unchanged.\n *\n * Like `OutboundCoordinator` and `InboundLoop`, this class accepts a wide\n * dependency bag in its constructor (the direct-turn pipeline touches almost\n * every other subsystem). The win is that AgentService becomes the only place\n * that wires those dependencies together; individual responsibilities now live\n * in their own classes and are unit-testable.\n */\n\nimport type { Config } from '../../config/schema.js';\nimport type { ContextualLogger } from '../../utils/logger/types.js';\n\nimport type { AgentManager } from '../agent-manager.js';\nimport type { CommandHandler } from '../messaging/command-handler.js';\nimport type { ModelManager } from '../models/index.js';\nimport type { SessionConfigStore } from '../../session/index.js';\nimport type { SessionStore } from '../../session/store.js';\nimport type {\n  SessionContext,\n  SessionHydrator,\n  SessionStateBag,\n} from '../session/index.js';\nimport { queueEmbeddedSteer } from '../embedded/runs.js';\nimport type {\n  InboundAttachmentInput,\n  MediaRef,\n} from '../../channels/attachments/inbound-persist.js';\nimport {\n  buildDirectUserMessageContent,\n} from '../service/build-direct-message-content.js';\nimport {\n  runProcessDirectStreaming,\n  type ProcessDirectStreamingDeps,\n  type ProcessDirectStreamingSseEvent,\n} from '../service/process-direct-streaming.js';\nimport {\n  runProcessDirect,\n  type RunProcessDirectDeps,\n} from '../service/process-direct-one-shot.js';\nimport { maybeEmitWebchatTts } from '../service/webchat-tts.js';\n\nexport interface TurnDispatcherConfig {\n  log: ContextualLogger;\n  agentManager: AgentManager;\n  sessionStore: SessionStore;\n  modelManager: ModelManager;\n  sessionConfigStore: SessionConfigStore;\n  sessionState: SessionStateBag;\n  commandHandler: CommandHandler;\n  getConfig: () => Config | undefined;\n  /** Strict accessor — required for direct-turn paths that must have a config. */\n  requireConfig: () => Config;\n  parseSessionKey: (sessionKey: string) => { channel: string; chatId: string };\n  /** Establish per-session context (also creates the Agent + subscribes to events). */\n  initSessionContext: (sessionKey: string, channel: string, chatId: string) => SessionContext;\n  /** Per-session config hydration: workspace, model, thinking. */\n  sessionHydrator: SessionHydrator;\n  prepareInboundAttachments: (\n    sessionKey: string,\n    attachments?: InboundAttachmentInput[],\n  ) => Promise<MediaRef[] | undefined>;\n  enqueueMaybeAutoTitleAfterPersist: (sessionKey: string) => void;\n  enqueueProvisionalSessionTitle?: (sessionKey: string, userText: string) => void;\n  endDirectRequestContext: () => void;\n  /** Gateway hook fired after assistant text lands on disk (UI refetch). */\n  onSessionTranscriptUpdated?: (sessionKey: string) => void;\n  resetSession: (sessionKey: string) => Promise<{ sessionId: string; previousSessionId: string } | null>;\n}\n\nexport type DirectAttachment = InboundAttachmentInput;\n\nexport class TurnDispatcher {\n  private readonly cfg: TurnDispatcherConfig;\n  private readonly log: ContextualLogger;\n\n  constructor(cfg: TurnDispatcherConfig) {\n    this.cfg = cfg;\n    this.log = cfg.log;\n  }\n\n  /** One-shot direct turn (CLI / embedded TUI). */\n  processDirect(\n    content: string,\n    sessionKey = 'agent:main:main',\n    attachments?: DirectAttachment[],\n    thinking?: string,\n  ): Promise<string> {\n    return runProcessDirect(this.buildOneShotDeps(), {\n      content,\n      sessionKey,\n      attachments,\n      thinking,\n    });\n  }\n\n  /** Streaming direct turn (webchat SSE / CLI streaming). */\n  async *processDirectStreaming(\n    content: string,\n    sessionKey = 'agent:main:main',\n    attachments?: DirectAttachment[],\n    thinking?: string,\n    options?: { signal?: AbortSignal },\n  ): AsyncGenerator<ProcessDirectStreamingSseEvent, void, unknown> {\n    yield* runProcessDirectStreaming(this.buildStreamingDeps(), {\n      content,\n      sessionKey,\n      attachments,\n      thinking,\n      signal: options?.signal,\n    });\n  }\n\n  /** Push an out-of-band event into the live webchat stream for a session. */\n  enqueueWebchatSseEvent(\n    sessionKey: string,\n    event: { type: string; [key: string]: unknown },\n  ): void {\n    const pub = this.cfg.sessionState.getWebchatPublisher(sessionKey);\n    if (pub) {\n      pub(event);\n    }\n  }\n\n  /** Stream assistant text to live webchat session + notify transcript listeners. */\n  notifyWebchatTranscriptAppend(sessionKey: string, assistantText: string): void {\n    const trimmed = assistantText.trim();\n    if (trimmed) {\n      this.enqueueWebchatSseEvent(sessionKey, { type: 'token', content: trimmed });\n    }\n    this.cfg.onSessionTranscriptUpdated?.(sessionKey);\n  }\n\n  /**\n   * Queue a steering user message into pi-agent's in-flight run (delivered\n   * after current tool work, before the next LLM call). See `Agent.steer`\n   * in `@earendil-works/pi-agent-core`.\n   */\n  async steerWebchatSession(sessionKey: string, text: string): Promise<boolean> {\n    const trimmed = text.trim();\n    if (!trimmed) return false;\n    try {\n      return await queueEmbeddedSteer(sessionKey, trimmed);\n    } catch (err) {\n      this.log.warn({ err, sessionKey }, 'steerWebchatSession failed');\n      return false;\n    }\n  }\n\n  private buildStreamingDeps(): ProcessDirectStreamingDeps {\n    const c = this.cfg;\n    return {\n      log: this.log,\n      parseSessionKey: c.parseSessionKey,\n      initDirectStreamingSession: c.initSessionContext,\n      registerWebchatSsePublisher: (sk, publisher) =>\n        c.sessionState.registerWebchatPublisher(sk, publisher),\n      unregisterWebchatSsePublisher: (sk) => c.sessionState.unregisterWebchatPublisher(sk),\n      agentManager: c.agentManager,\n      hydrateSessionWorkspaceFromStore: (sk) => c.sessionHydrator.workspace(sk),\n      hydrateSessionModelFromStore: (sk) => c.sessionHydrator.model(sk),\n      sessionStore: c.sessionStore,\n      modelManager: c.modelManager,\n      applyResolvedThinkingLevel: (sk, t) => c.sessionHydrator.thinking(sk, t),\n      getConfig: c.getConfig,\n      sessionConfigStore: c.sessionConfigStore,\n      commandHandler: c.commandHandler,\n      prepareInboundAttachments: c.prepareInboundAttachments,\n      buildTranscriptUserMessage: async (text, prepared, sk) =>\n        buildDirectUserMessageContent({\n          content: text,\n          attachments: prepared,\n          sessionKey: sk,\n          config: c.requireConfig(),\n          agentManager: c.agentManager,\n          modelManager: c.modelManager,\n        }),\n      recordPersistentGoalStreamOutcome: (sk, o) =>\n        c.sessionState.recordPersistentGoalStreamOutcome(sk, o),\n      enqueueProvisionalSessionTitle: (sk, userText) => {\n        c.enqueueProvisionalSessionTitle?.(sk, userText);\n      },\n      onTurnComplete: (sk, text) => {\n        if (text) {\n          c.sessionState.setLastAssistantText(sk, text);\n        }\n        c.enqueueMaybeAutoTitleAfterPersist(sk);\n      },\n      reloadWebchatTranscript: (sk) => {\n        c.onSessionTranscriptUpdated?.(sk);\n      },\n      maybeEmitWebchatTts: (sk, hadVoice) =>\n        maybeEmitWebchatTts(\n          {\n            config: c.getConfig(),\n            sessionStore: c.sessionStore,\n            getLastAssistantPlainText: (sessionKey) =>\n              c.sessionState.getLastAssistantText(sessionKey) ??\n              c.agentManager.getLastAssistantContent(sessionKey) ??\n              '',\n            log: this.log,\n          },\n          sk,\n          hadVoice,\n        ),\n      endDirectRequestContext: c.endDirectRequestContext,\n      resetSession: c.resetSession,\n    };\n  }\n\n  private buildOneShotDeps(): RunProcessDirectDeps {\n    const c = this.cfg;\n    const cfg = c.requireConfig();\n    return {\n      log: this.log,\n      config: cfg,\n      parseSessionKey: c.parseSessionKey,\n      initSessionContext: (sk, channel, chatId) => {\n        void c.initSessionContext(sk, channel, chatId);\n      },\n      hydrateSessionWorkspaceFromStore: (sk) => c.sessionHydrator.workspace(sk),\n      hydrateSessionModelFromStore: (sk) => c.sessionHydrator.model(sk),\n      agentManager: c.agentManager,\n      sessionStore: c.sessionStore,\n      modelManager: c.modelManager,\n      applyResolvedThinkingLevel: (sk, t) => c.sessionHydrator.thinking(sk, t),\n      prepareInboundAttachments: c.prepareInboundAttachments,\n      commandHandler: c.commandHandler,\n      onTurnComplete: (sk, text) => {\n        if (text) {\n          c.sessionState.setLastAssistantText(sk, text);\n        }\n        c.enqueueMaybeAutoTitleAfterPersist(sk);\n      },\n      endDirectRequestContext: c.endDirectRequestContext,\n      resetSession: c.resetSession,\n    };\n  }\n}\n"],"mappings":"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"}

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

@@ -11,3 +11,5 @@ export type { MemoryProvider, MemoryProviderInitOptions } from './provider.js';
 export { StubMemoryProvider } from './stub-memory-provider.js';
 export type { MemorySnapshot, MemoryStoreConfig } from './types.js';
 export { extractAgentUserPlainText } from './user-message-text.js';
+export { MemoryFlushService } from './memory-flush.js';
+export type { MemoryFlushConfig, MemoryFlushOptions, MemoryFlushResult } from './memory-flush.js';

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

@@ -7,5 +7,6 @@ import { BuiltinMemoryProvider } from "./builtin-provider.js";
 import { MemoryManager } from "./manager.js";
 import { StubMemoryProvider } from "./stub-memory-provider.js";
 import { createMemoryManagerFromConfig } from "./create-memory-manager.js";
+import { MemoryFlushService } from "./memory-flush.js";
 import { discoverMemoryPlugins } from "./plugin-discovery.js";
-export { BuiltinMemoryProvider, BuiltinMemoryStore, MEMORY_ENTRY_DELIMITER, MemoryManager, StubMemoryProvider, buildMemoryContextBlock, createMemoryManagerFromConfig, discoverMemoryPlugins, extractAgentUserPlainText, injectPrefetchIntoUserMessage, isCuratedMemoryInPrompt, isMemorySubsystemEnabled, resolveBuiltinMemoryStoreConfig, sanitizeMemoryContextFenceEscapes, scanForThreats, shouldInjectMemoryPrefetchThisTurn, shouldRegisterCuratedMemoryTool };
+export { BuiltinMemoryProvider, BuiltinMemoryStore, MEMORY_ENTRY_DELIMITER, MemoryFlushService, MemoryManager, StubMemoryProvider, buildMemoryContextBlock, createMemoryManagerFromConfig, discoverMemoryPlugins, extractAgentUserPlainText, injectPrefetchIntoUserMessage, isCuratedMemoryInPrompt, isMemorySubsystemEnabled, resolveBuiltinMemoryStoreConfig, sanitizeMemoryContextFenceEscapes, scanForThreats, shouldInjectMemoryPrefetchThisTurn, shouldRegisterCuratedMemoryTool };

package/dist/src/agent/memory/memory-flush.d.ts

@@ -0,0 +1,27 @@
+import type { CompactionResult } from './compaction.js';
+export interface MemoryFlushConfig {
+    enabled: boolean;
+    threshold: number;
+    softThresholdTokens: number;
+    afterCompactions: number;
+    maxEntryChars: number;
+    includeToolHistory: boolean;
+}
+export interface MemoryFlushOptions {
+    workspaceDir: string;
+    sessionKey: string;
+    compactionResult: CompactionResult;
+    config: MemoryFlushConfig;
+}
+export interface MemoryFlushResult {
+    flushed: boolean;
+    entryPath: string;
+    entryLength: number;
+    reason?: string;
+}
+export declare class MemoryFlushService {
+    flush(options: MemoryFlushOptions): Promise<MemoryFlushResult>;
+    private buildEntry;
+    /** YYYY-MM-DD in local time (for daily `memory/YYYY-MM-DD.md` names). */
+    private isoDay;
+}

package/dist/src/agent/memory/memory-flush.js

@@ -0,0 +1,124 @@
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+import { appendFile, mkdir, readFile, writeFile } from "node:fs/promises";
+//#region src/agent/memory/memory-flush.ts
+init_logger();
+const log = createLogger("MemoryFlush");
+var MemoryFlushService = class {
+	async flush(options) {
+		const { workspaceDir, sessionKey, compactionResult, config } = options;
+		if (!config.enabled) return {
+			flushed: false,
+			entryPath: "",
+			entryLength: 0,
+			reason: "disabled"
+		};
+		const now = /* @__PURE__ */ new Date();
+		const day = this.isoDay(now);
+		const memoryDir = join(workspaceDir, "memory");
+		const filePath = join(memoryDir, `${day}.md`);
+		const entryPath = `memory/${day}.md`;
+		await mkdir(memoryDir, { recursive: true });
+		const entryText = this.buildEntry(sessionKey, compactionResult, now, config).text;
+		const entryLength = entryText.length;
+		if (entryLength > config.maxEntryChars) log.warn({
+			sessionKey,
+			entryLength,
+			maxEntryChars: config.maxEntryChars
+		}, "Flush entry exceeds maxEntryChars; truncating");
+		try {
+			if (!existsSync(filePath)) await writeFile(filePath, `# Daily Notes — ${day}\n\n` + entryText, "utf-8");
+			else {
+				const existing = await readFile(filePath, "utf-8");
+				if (existing.length > 5e4) log.warn({
+					sessionKey,
+					filePath,
+					size: existing.length
+				}, "Daily notes file is large; continuing append");
+				await appendFile(filePath, "\n" + entryText, "utf-8");
+			}
+			log.info({
+				sessionKey,
+				entryPath,
+				entryLength
+			}, "Memory flushed to daily notes");
+			return {
+				flushed: true,
+				entryPath,
+				entryLength
+			};
+		} catch (err) {
+			const em = err instanceof Error ? err.message : String(err);
+			log.error({
+				sessionKey,
+				err,
+				filePath
+			}, `Memory flush failed: ${em}`);
+			return {
+				flushed: false,
+				entryPath,
+				entryLength: 0,
+				reason: `write_error: ${em}`
+			};
+		}
+	}
+	buildEntry(sessionKey, result, now, config) {
+		const iso = now.toISOString();
+		const lines = [];
+		lines.push(`## Session Flush [${sessionKey}] ${iso}`);
+		lines.push("");
+		const summary = result.summary || "";
+		lines.push(`**Summary:** ${summary}`);
+		lines.push("");
+		const structured = result.structuredSummary;
+		if (structured) {
+			if (structured.userRequests && structured.userRequests.length > 0) {
+				lines.push("**User Requests:**");
+				for (const req of structured.userRequests) lines.push(`- ${req}`);
+				lines.push("");
+			}
+			if (structured.keyDecisions && structured.keyDecisions.length > 0) {
+				lines.push("**Key Decisions:**");
+				for (const decision of structured.keyDecisions) lines.push(`- ${decision}`);
+				lines.push("");
+			}
+			if (structured.filesModified && structured.filesModified.length > 0) {
+				lines.push("**Files Modified:**");
+				for (const file of structured.filesModified) lines.push(`- ${file}`);
+				lines.push("");
+			}
+			if (config.includeToolHistory && structured.toolCalls && structured.toolCalls.length > 0) {
+				lines.push("**Tool Calls:**");
+				for (const call of structured.toolCalls) {
+					const filePart = call.filePath ? ` (${call.filePath})` : "";
+					const status = call.success ? "success" : "failed";
+					lines.push(`- \`${call.toolName}\`${filePart} — ${status}`);
+				}
+				lines.push("");
+			}
+		} else if (summary) {
+			lines.push("**Summary (text only):**");
+			lines.push(summary);
+			lines.push("");
+		}
+		lines.push("---");
+		let text = lines.join("\n");
+		if (text.length > config.maxEntryChars) {
+			const headerEnd = text.indexOf("\n\n") + 2;
+			const header = text.slice(0, headerEnd);
+			const remainingBudget = config.maxEntryChars - header.length - 60;
+			text = header + text.slice(headerEnd).slice(0, Math.max(0, remainingBudget)) + "\n\n*(Entry truncated due to length limit)*\n---";
+		}
+		return { text };
+	}
+	/** YYYY-MM-DD in local time (for daily `memory/YYYY-MM-DD.md` names). */
+	isoDay(d) {
+		return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+	}
+};
+//#endregion
+export { MemoryFlushService };
+
+//# sourceMappingURL=memory-flush.js.map

package/dist/src/agent/memory/memory-flush.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-flush.js","names":[],"sources":["../../../../src/agent/memory/memory-flush.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { mkdir, readFile, writeFile, appendFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { createLogger } from '../../utils/logger.js';\nimport type { CompactionResult } from './compaction.js';\n\nconst log = createLogger('MemoryFlush');\n\nexport interface MemoryFlushConfig {\n  enabled: boolean;\n  threshold: number;\n  softThresholdTokens: number;\n  afterCompactions: number;\n  maxEntryChars: number;\n  includeToolHistory: boolean;\n}\n\nexport interface MemoryFlushOptions {\n  workspaceDir: string;\n  sessionKey: string;\n  compactionResult: CompactionResult;\n  config: MemoryFlushConfig;\n}\n\nexport interface MemoryFlushResult {\n  flushed: boolean;\n  entryPath: string;\n  entryLength: number;\n  reason?: string;\n}\n\nexport class MemoryFlushService {\n  async flush(options: MemoryFlushOptions): Promise<MemoryFlushResult> {\n    const { workspaceDir, sessionKey, compactionResult, config } = options;\n\n    if (!config.enabled) {\n      return { flushed: false, entryPath: '', entryLength: 0, reason: 'disabled' };\n    }\n\n    const now = new Date();\n    const day = this.isoDay(now);\n    const memoryDir = join(workspaceDir, 'memory');\n    const filePath = join(memoryDir, `${day}.md`);\n    const entryPath = `memory/${day}.md`;\n\n    await mkdir(memoryDir, { recursive: true });\n\n    const entry = this.buildEntry(sessionKey, compactionResult, now, config);\n    const entryText = entry.text;\n    const entryLength = entryText.length;\n\n    if (entryLength > config.maxEntryChars) {\n      log.warn({ sessionKey, entryLength, maxEntryChars: config.maxEntryChars }, 'Flush entry exceeds maxEntryChars; truncating');\n    }\n\n    try {\n      const fileExists = existsSync(filePath);\n      if (!fileExists) {\n        const frontmatter = `# Daily Notes — ${day}\\n\\n`;\n        await writeFile(filePath, frontmatter + entryText, 'utf-8');\n      } else {\n        const existing = await readFile(filePath, 'utf-8');\n        // Warn if file is getting large (>50KB) but still append\n        if (existing.length > 50_000) {\n          log.warn({ sessionKey, filePath, size: existing.length }, 'Daily notes file is large; continuing append');\n        }\n        await appendFile(filePath, '\\n' + entryText, 'utf-8');\n      }\n\n      log.info({ sessionKey, entryPath, entryLength }, 'Memory flushed to daily notes');\n      return { flushed: true, entryPath, entryLength };\n    } catch (err) {\n      const em = err instanceof Error ? err.message : String(err);\n      log.error({ sessionKey, err, filePath }, `Memory flush failed: ${em}`);\n      return { flushed: false, entryPath, entryLength: 0, reason: `write_error: ${em}` };\n    }\n  }\n\n  private buildEntry(\n    sessionKey: string,\n    result: CompactionResult,\n    now: Date,\n    config: MemoryFlushConfig,\n  ): { text: string } {\n    const iso = now.toISOString();\n    const lines: string[] = [];\n\n    lines.push(`## Session Flush [${sessionKey}] ${iso}`);\n    lines.push('');\n\n    const summary = result.summary || '';\n    lines.push(`**Summary:** ${summary}`);\n    lines.push('');\n\n    const structured = result.structuredSummary;\n    if (structured) {\n      if (structured.userRequests && structured.userRequests.length > 0) {\n        lines.push('**User Requests:**');\n        for (const req of structured.userRequests) {\n          lines.push(`- ${req}`);\n        }\n        lines.push('');\n      }\n\n      if (structured.keyDecisions && structured.keyDecisions.length > 0) {\n        lines.push('**Key Decisions:**');\n        for (const decision of structured.keyDecisions) {\n          lines.push(`- ${decision}`);\n        }\n        lines.push('');\n      }\n\n      if (structured.filesModified && structured.filesModified.length > 0) {\n        lines.push('**Files Modified:**');\n        for (const file of structured.filesModified) {\n          lines.push(`- ${file}`);\n        }\n        lines.push('');\n      }\n\n      if (config.includeToolHistory && structured.toolCalls && structured.toolCalls.length > 0) {\n        lines.push('**Tool Calls:**');\n        for (const call of structured.toolCalls) {\n          const filePart = call.filePath ? ` (${call.filePath})` : '';\n          const status = call.success ? 'success' : 'failed';\n          lines.push(`- \\`${call.toolName}\\`${filePart} — ${status}`);\n        }\n        lines.push('');\n      }\n    } else if (summary) {\n      // Fallback when structuredSummary is absent\n      lines.push('**Summary (text only):**');\n      lines.push(summary);\n      lines.push('');\n    }\n\n    lines.push('---');\n\n    let text = lines.join('\\n');\n\n    // Respect maxEntryChars by truncating from the end if needed\n    if (text.length > config.maxEntryChars) {\n      // Keep the header and a truncation notice\n      const headerEnd = text.indexOf('\\n\\n') + 2;\n      const header = text.slice(0, headerEnd);\n      const remainingBudget = config.maxEntryChars - header.length - 60;\n      const body = text.slice(headerEnd);\n      const truncatedBody = body.slice(0, Math.max(0, remainingBudget));\n      text = header + truncatedBody + '\\n\\n*(Entry truncated due to length limit)*\\n---';\n    }\n\n    return { text };\n  }\n\n  /** YYYY-MM-DD in local time (for daily `memory/YYYY-MM-DD.md` names). */\n  private isoDay(d: Date): string {\n    const y = d.getFullYear();\n    const m = String(d.getMonth() + 1).padStart(2, '0');\n    const day = String(d.getDate()).padStart(2, '0');\n    return `${y}-${m}-${day}`;\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/messaging/outbound-coordinator.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { createTypingController } from "../lifecycle/typing.js";
 import { shouldSilence } from "../../heartbeat/tokens.js";
+import { createTypingController } from "../lifecycle/typing.js";
 //#region src/agent/messaging/outbound-coordinator.ts
 init_logger();
 const log = createLogger("OutboundCoordinator");
@@ -84,6 +84,7 @@ var OutboundCoordinator = class {
 			metadata: {
 				accountId: msg.metadata?.accountId,
 				threadId: msg.metadata?.threadId,
+				inboundMessageId: msg.metadata?.messageId,
 				transcribedVoice: sessionContext.metadata?.transcribedVoice,
 				sessionWebhook: msg.metadata?.sessionWebhook,
 				conversationId: msg.metadata?.conversationId

package/dist/src/agent/messaging/outbound-coordinator.js.map

@@ -1 +1 @@
-{"version":3,"file":"outbound-coordinator.js","names":[],"sources":["../../../../src/agent/messaging/outbound-coordinator.ts"],"sourcesContent":["/**\n * OutboundCoordinator — owns the post-turn outbound pipeline.\n *\n * Concentrates the responsibilities that used to be scattered across\n * `AgentService`:\n *  - typing-on / typing-off lifecycle for channels that surface \"is typing…\"\n *  - final assistant response delivery (silence guard + hook + bus publish)\n *  - cross-cutting `webchat_turn_complete` hook + `/goal` post-turn\n *  - thin pass-through for extension `message_sending` / `message_sent` hooks\n *\n * The class is intentionally framework-agnostic: it pulls everything it needs\n * via the constructor config (no direct AgentService reference), so it is\n * unit-testable and lets the parent `AgentService` shrink to a coordinator.\n */\n\nimport type { MessageBus, InboundMessage } from '../../infra/bus/index.js';\nimport type { Config } from '../../config/schema.js';\nimport type { HookHandler } from '../lifecycle/hook-handler.js';\nimport type { SessionContext } from '../session/index.js';\nimport { createTypingController, type TypingController } from '../lifecycle/typing.js';\nimport { DEFAULT_ACK_MAX_CHARS, NO_REPLY, shouldSilence } from '../../heartbeat/tokens.js';\nimport { createLogger } from '../../utils/logger.js';\nimport type { StreamManager } from './stream-manager.js';\n\nconst log = createLogger('OutboundCoordinator');\n\nexport interface OutboundCoordinatorConfig {\n  bus: MessageBus;\n  hookHandler: HookHandler;\n  streamManager: StreamManager;\n  /** Reads the effective config snapshot (honours runtime overrides). */\n  getConfig: () => Config | undefined;\n  /** Resolves the last visible assistant text for a session (in-memory + agent fallback). */\n  getLastAssistantPlainText: (sessionKey: string) => string;\n  /**\n   * Run the `/goal` post-turn verdict for a completed user turn. Owned by\n   * `PersistentGoalService`; OutboundCoordinator only forwards.\n   */\n  runPersistentGoalPostTurn: (payload: SessionTurnCompletePayload) => Promise<void>;\n}\n\nexport interface SessionTurnCompletePayload {\n  sessionKey: string;\n  channel: string;\n  chatId: string;\n  inboundUserText: string;\n  assistantPlainText: string;\n  aborted: boolean;\n  streamError?: string;\n  skipPersistentGoalPostTurn?: boolean;\n  outboundMetadata?: Record<string, unknown>;\n}\n\nexport class OutboundCoordinator {\n  private readonly bus: MessageBus;\n  private readonly hookHandler: HookHandler;\n  private readonly streamManager: StreamManager;\n  private readonly getConfig: () => Config | undefined;\n  private readonly getLastAssistantPlainText: (sessionKey: string) => string;\n  private readonly runPersistentGoalPostTurn: OutboundCoordinatorConfig['runPersistentGoalPostTurn'];\n\n  constructor(config: OutboundCoordinatorConfig) {\n    this.bus = config.bus;\n    this.hookHandler = config.hookHandler;\n    this.streamManager = config.streamManager;\n    this.getConfig = config.getConfig;\n    this.getLastAssistantPlainText = config.getLastAssistantPlainText;\n    this.runPersistentGoalPostTurn = config.runPersistentGoalPostTurn;\n  }\n\n  /**\n   * Build the typing indicator controller for an inbound message. Returns\n   * `null` for the CLI channel (no typing UI). Caller is responsible for\n   * `start()` and `stop()` (`stop()` should run AFTER the final outbound so\n   * Telegram/Weixin see `typing_off` only once the message is delivered).\n   */\n  createTypingControllerForInbound(msg: InboundMessage): TypingController | null {\n    if (msg.channel === 'cli') {\n      return null;\n    }\n    const meta = msg.metadata as Record<string, unknown> | undefined;\n    return createTypingController({\n      intervalSeconds: 5,\n      onStart: async () => {\n        await this.bus.publishOutbound({\n          channel: msg.channel,\n          chat_id: msg.chat_id,\n          content: '',\n          type: 'typing_on',\n          metadata: {\n            accountId: meta?.accountId,\n            threadId: meta?.threadId,\n            sessionWebhook: meta?.sessionWebhook,\n            conversationId: meta?.conversationId,\n          },\n        });\n      },\n      onStop: async () => {\n        await this.bus.publishOutbound({\n          channel: msg.channel,\n          chat_id: msg.chat_id,\n          content: '',\n          type: 'typing_off',\n          metadata: {\n            accountId: meta?.accountId,\n            threadId: meta?.threadId,\n            sessionWebhook: meta?.sessionWebhook,\n            conversationId: meta?.conversationId,\n          },\n        });\n      },\n    });\n  }\n\n  /**\n   * Publish the assistant's visible text as the final bus message. Honours the\n   * stream-manager \"channel already streamed the final text\" hint, the heartbeat\n   * silence guard, and the extension `message_sending` hook.\n   */\n  async sendFinalResponse(msg: InboundMessage, sessionContext: SessionContext): Promise<void> {\n    if (this.streamManager.consumeSkipFinalOutbound()) {\n      return;\n    }\n\n    const finalContent = this.getLastAssistantPlainText(sessionContext.sessionKey);\n    if (!finalContent?.trim()) {\n      return;\n    }\n\n    const ackMax = this.getConfig()?.gateway?.heartbeat?.ackMaxChars ?? DEFAULT_ACK_MAX_CHARS;\n    if (shouldSilence(finalContent, ackMax) || finalContent.trim() === NO_REPLY) {\n      log.debug({ sessionKey: sessionContext.sessionKey }, 'Silent reply — skipping outbound');\n      return;\n    }\n\n    const hookResult = await this.hookHandler.runMessageSending(\n      sessionContext.chatId,\n      finalContent,\n      sessionContext.channel,\n    );\n    if (!hookResult.send) {\n      return;\n    }\n\n    await this.bus.publishOutbound({\n      channel: sessionContext.channel,\n      chat_id: sessionContext.chatId,\n      content: hookResult.content || finalContent,\n      type: 'message',\n      metadata: {\n        accountId: msg.metadata?.accountId,\n        threadId: msg.metadata?.threadId,\n        transcribedVoice: sessionContext.metadata?.transcribedVoice,\n        sessionWebhook: msg.metadata?.sessionWebhook,\n        conversationId: msg.metadata?.conversationId,\n      },\n    });\n  }\n\n  /**\n   * Post-turn hook + `/goal` checklist evaluation. Wired into both the bus-driven\n   * inbound finally block and the webchat direct-stream finally. The goal verdict\n   * itself lives in `PersistentGoalService`; we just trigger the extension hook\n   * here and delegate the `/goal` work.\n   */\n  async emitSessionTurnComplete(payload: SessionTurnCompletePayload): Promise<void> {\n    await this.hookHandler.triggerWithSessionKey(payload.sessionKey, 'webchat_turn_complete', {\n      sessionKey: payload.sessionKey,\n      channel: payload.channel,\n      chatId: payload.chatId,\n      inboundUserText: payload.inboundUserText,\n      assistantPlainText: payload.assistantPlainText,\n      aborted: payload.aborted,\n      ...(payload.streamError !== undefined ? { streamError: payload.streamError } : {}),\n    });\n\n    await this.runPersistentGoalPostTurn(payload);\n  }\n\n  /** Extension hook pass-through (Gateway ChannelManager). */\n  invokeOutboundMessageSending(\n    to: string,\n    content: string,\n    channel: string,\n  ): Promise<{ send: boolean; content?: string; reason?: string }> {\n    return this.hookHandler.runMessageSending(to, content, channel);\n  }\n\n  /** Extension hook pass-through (Gateway ChannelManager). */\n  invokeOutboundMessageSent(\n    to: string,\n    content: string,\n    success: boolean,\n    error: string | undefined,\n    channel: string,\n  ): Promise<void> {\n    return this.hookHandler.runMessageSent(to, content, success, error, channel);\n  }\n}\n"],"mappings":";;;;;aAqBqD;AAGrD,MAAM,MAAM,aAAa,sBAAsB;AA6B/C,IAAa,sBAAb,MAAiC;CAC/B;CACA;CACA;CACA;CACA;CACA;CAEA,YAAY,QAAmC;AAC7C,OAAK,MAAM,OAAO;AAClB,OAAK,cAAc,OAAO;AAC1B,OAAK,gBAAgB,OAAO;AAC5B,OAAK,YAAY,OAAO;AACxB,OAAK,4BAA4B,OAAO;AACxC,OAAK,4BAA4B,OAAO;;;;;;;;CAS1C,iCAAiC,KAA8C;AAC7E,MAAI,IAAI,YAAY,MAClB,QAAO;EAET,MAAM,OAAO,IAAI;AACjB,SAAO,uBAAuB;GAC5B,iBAAiB;GACjB,SAAS,YAAY;AACnB,UAAM,KAAK,IAAI,gBAAgB;KAC7B,SAAS,IAAI;KACb,SAAS,IAAI;KACb,SAAS;KACT,MAAM;KACN,UAAU;MACR,WAAW,MAAM;MACjB,UAAU,MAAM;MAChB,gBAAgB,MAAM;MACtB,gBAAgB,MAAM;MACvB;KACF,CAAC;;GAEJ,QAAQ,YAAY;AAClB,UAAM,KAAK,IAAI,gBAAgB;KAC7B,SAAS,IAAI;KACb,SAAS,IAAI;KACb,SAAS;KACT,MAAM;KACN,UAAU;MACR,WAAW,MAAM;MACjB,UAAU,MAAM;MAChB,gBAAgB,MAAM;MACtB,gBAAgB,MAAM;MACvB;KACF,CAAC;;GAEL,CAAC;;;;;;;CAQJ,MAAM,kBAAkB,KAAqB,gBAA+C;AAC1F,MAAI,KAAK,cAAc,0BAA0B,CAC/C;EAGF,MAAM,eAAe,KAAK,0BAA0B,eAAe,WAAW;AAC9E,MAAI,CAAC,cAAc,MAAM,CACvB;AAIF,MAAI,cAAc,cADH,KAAK,WAAW,EAAE,SAAS,WAAW,eAAA,IACd,IAAI,aAAa,MAAM,KAAA,YAAe;AAC3E,OAAI,MAAM,EAAE,YAAY,eAAe,YAAY,EAAE,mCAAmC;AACxF;;EAGF,MAAM,aAAa,MAAM,KAAK,YAAY,kBACxC,eAAe,QACf,cACA,eAAe,QAChB;AACD,MAAI,CAAC,WAAW,KACd;AAGF,QAAM,KAAK,IAAI,gBAAgB;GAC7B,SAAS,eAAe;GACxB,SAAS,eAAe;GACxB,SAAS,WAAW,WAAW;GAC/B,MAAM;GACN,UAAU;IACR,WAAW,IAAI,UAAU;IACzB,UAAU,IAAI,UAAU;IACxB,kBAAkB,eAAe,UAAU;IAC3C,gBAAgB,IAAI,UAAU;IAC9B,gBAAgB,IAAI,UAAU;IAC/B;GACF,CAAC;;;;;;;;CASJ,MAAM,wBAAwB,SAAoD;AAChF,QAAM,KAAK,YAAY,sBAAsB,QAAQ,YAAY,yBAAyB;GACxF,YAAY,QAAQ;GACpB,SAAS,QAAQ;GACjB,QAAQ,QAAQ;GAChB,iBAAiB,QAAQ;GACzB,oBAAoB,QAAQ;GAC5B,SAAS,QAAQ;GACjB,GAAI,QAAQ,gBAAgB,KAAA,IAAY,EAAE,aAAa,QAAQ,aAAa,GAAG,EAAE;GAClF,CAAC;AAEF,QAAM,KAAK,0BAA0B,QAAQ;;;CAI/C,6BACE,IACA,SACA,SAC+D;AAC/D,SAAO,KAAK,YAAY,kBAAkB,IAAI,SAAS,QAAQ;;;CAIjE,0BACE,IACA,SACA,SACA,OACA,SACe;AACf,SAAO,KAAK,YAAY,eAAe,IAAI,SAAS,SAAS,OAAO,QAAQ"}
+{"version":3,"file":"outbound-coordinator.js","names":[],"sources":["../../../../src/agent/messaging/outbound-coordinator.ts"],"sourcesContent":["/**\n * OutboundCoordinator — owns the post-turn outbound pipeline.\n *\n * Concentrates the responsibilities that used to be scattered across\n * `AgentService`:\n *  - typing-on / typing-off lifecycle for channels that surface \"is typing…\"\n *  - final assistant response delivery (silence guard + hook + bus publish)\n *  - cross-cutting `webchat_turn_complete` hook + `/goal` post-turn\n *  - thin pass-through for extension `message_sending` / `message_sent` hooks\n *\n * The class is intentionally framework-agnostic: it pulls everything it needs\n * via the constructor config (no direct AgentService reference), so it is\n * unit-testable and lets the parent `AgentService` shrink to a coordinator.\n */\n\nimport type { MessageBus, InboundMessage } from '../../infra/bus/index.js';\nimport type { Config } from '../../config/schema.js';\nimport type { HookHandler } from '../lifecycle/hook-handler.js';\nimport type { SessionContext } from '../session/index.js';\nimport { createTypingController, type TypingController } from '../lifecycle/typing.js';\nimport { DEFAULT_ACK_MAX_CHARS, NO_REPLY, shouldSilence } from '../../heartbeat/tokens.js';\nimport { createLogger } from '../../utils/logger.js';\nimport type { StreamManager } from './stream-manager.js';\n\nconst log = createLogger('OutboundCoordinator');\n\nexport interface OutboundCoordinatorConfig {\n  bus: MessageBus;\n  hookHandler: HookHandler;\n  streamManager: StreamManager;\n  /** Reads the effective config snapshot (honours runtime overrides). */\n  getConfig: () => Config | undefined;\n  /** Resolves the last visible assistant text for a session (in-memory + agent fallback). */\n  getLastAssistantPlainText: (sessionKey: string) => string;\n  /**\n   * Run the `/goal` post-turn verdict for a completed user turn. Owned by\n   * `PersistentGoalService`; OutboundCoordinator only forwards.\n   */\n  runPersistentGoalPostTurn: (payload: SessionTurnCompletePayload) => Promise<void>;\n}\n\nexport interface SessionTurnCompletePayload {\n  sessionKey: string;\n  channel: string;\n  chatId: string;\n  inboundUserText: string;\n  assistantPlainText: string;\n  aborted: boolean;\n  streamError?: string;\n  skipPersistentGoalPostTurn?: boolean;\n  outboundMetadata?: Record<string, unknown>;\n}\n\nexport class OutboundCoordinator {\n  private readonly bus: MessageBus;\n  private readonly hookHandler: HookHandler;\n  private readonly streamManager: StreamManager;\n  private readonly getConfig: () => Config | undefined;\n  private readonly getLastAssistantPlainText: (sessionKey: string) => string;\n  private readonly runPersistentGoalPostTurn: OutboundCoordinatorConfig['runPersistentGoalPostTurn'];\n\n  constructor(config: OutboundCoordinatorConfig) {\n    this.bus = config.bus;\n    this.hookHandler = config.hookHandler;\n    this.streamManager = config.streamManager;\n    this.getConfig = config.getConfig;\n    this.getLastAssistantPlainText = config.getLastAssistantPlainText;\n    this.runPersistentGoalPostTurn = config.runPersistentGoalPostTurn;\n  }\n\n  /**\n   * Build the typing indicator controller for an inbound message. Returns\n   * `null` for the CLI channel (no typing UI). Caller is responsible for\n   * `start()` and `stop()` (`stop()` should run AFTER the final outbound so\n   * Telegram/Weixin see `typing_off` only once the message is delivered).\n   */\n  createTypingControllerForInbound(msg: InboundMessage): TypingController | null {\n    if (msg.channel === 'cli') {\n      return null;\n    }\n    const meta = msg.metadata as Record<string, unknown> | undefined;\n    return createTypingController({\n      intervalSeconds: 5,\n      onStart: async () => {\n        await this.bus.publishOutbound({\n          channel: msg.channel,\n          chat_id: msg.chat_id,\n          content: '',\n          type: 'typing_on',\n          metadata: {\n            accountId: meta?.accountId,\n            threadId: meta?.threadId,\n            sessionWebhook: meta?.sessionWebhook,\n            conversationId: meta?.conversationId,\n          },\n        });\n      },\n      onStop: async () => {\n        await this.bus.publishOutbound({\n          channel: msg.channel,\n          chat_id: msg.chat_id,\n          content: '',\n          type: 'typing_off',\n          metadata: {\n            accountId: meta?.accountId,\n            threadId: meta?.threadId,\n            sessionWebhook: meta?.sessionWebhook,\n            conversationId: meta?.conversationId,\n          },\n        });\n      },\n    });\n  }\n\n  /**\n   * Publish the assistant's visible text as the final bus message. Honours the\n   * stream-manager \"channel already streamed the final text\" hint, the heartbeat\n   * silence guard, and the extension `message_sending` hook.\n   */\n  async sendFinalResponse(msg: InboundMessage, sessionContext: SessionContext): Promise<void> {\n    if (this.streamManager.consumeSkipFinalOutbound()) {\n      return;\n    }\n\n    const finalContent = this.getLastAssistantPlainText(sessionContext.sessionKey);\n    if (!finalContent?.trim()) {\n      return;\n    }\n\n    const ackMax = this.getConfig()?.gateway?.heartbeat?.ackMaxChars ?? DEFAULT_ACK_MAX_CHARS;\n    if (shouldSilence(finalContent, ackMax) || finalContent.trim() === NO_REPLY) {\n      log.debug({ sessionKey: sessionContext.sessionKey }, 'Silent reply — skipping outbound');\n      return;\n    }\n\n    const hookResult = await this.hookHandler.runMessageSending(\n      sessionContext.chatId,\n      finalContent,\n      sessionContext.channel,\n    );\n    if (!hookResult.send) {\n      return;\n    }\n\n    await this.bus.publishOutbound({\n      channel: sessionContext.channel,\n      chat_id: sessionContext.chatId,\n      content: hookResult.content || finalContent,\n      type: 'message',\n      metadata: {\n        accountId: msg.metadata?.accountId,\n        threadId: msg.metadata?.threadId,\n        inboundMessageId: msg.metadata?.messageId,\n        transcribedVoice: sessionContext.metadata?.transcribedVoice,\n        sessionWebhook: msg.metadata?.sessionWebhook,\n        conversationId: msg.metadata?.conversationId,\n      },\n    });\n  }\n\n  /**\n   * Post-turn hook + `/goal` checklist evaluation. Wired into both the bus-driven\n   * inbound finally block and the webchat direct-stream finally. The goal verdict\n   * itself lives in `PersistentGoalService`; we just trigger the extension hook\n   * here and delegate the `/goal` work.\n   */\n  async emitSessionTurnComplete(payload: SessionTurnCompletePayload): Promise<void> {\n    await this.hookHandler.triggerWithSessionKey(payload.sessionKey, 'webchat_turn_complete', {\n      sessionKey: payload.sessionKey,\n      channel: payload.channel,\n      chatId: payload.chatId,\n      inboundUserText: payload.inboundUserText,\n      assistantPlainText: payload.assistantPlainText,\n      aborted: payload.aborted,\n      ...(payload.streamError !== undefined ? { streamError: payload.streamError } : {}),\n    });\n\n    await this.runPersistentGoalPostTurn(payload);\n  }\n\n  /** Extension hook pass-through (Gateway ChannelManager). */\n  invokeOutboundMessageSending(\n    to: string,\n    content: string,\n    channel: string,\n  ): Promise<{ send: boolean; content?: string; reason?: string }> {\n    return this.hookHandler.runMessageSending(to, content, channel);\n  }\n\n  /** Extension hook pass-through (Gateway ChannelManager). */\n  invokeOutboundMessageSent(\n    to: string,\n    content: string,\n    success: boolean,\n    error: string | undefined,\n    channel: string,\n  ): Promise<void> {\n    return this.hookHandler.runMessageSent(to, content, success, error, channel);\n  }\n}\n"],"mappings":";;;;;aAqBqD;AAGrD,MAAM,MAAM,aAAa,sBAAsB;AA6B/C,IAAa,sBAAb,MAAiC;CAC/B;CACA;CACA;CACA;CACA;CACA;CAEA,YAAY,QAAmC;AAC7C,OAAK,MAAM,OAAO;AAClB,OAAK,cAAc,OAAO;AAC1B,OAAK,gBAAgB,OAAO;AAC5B,OAAK,YAAY,OAAO;AACxB,OAAK,4BAA4B,OAAO;AACxC,OAAK,4BAA4B,OAAO;;;;;;;;CAS1C,iCAAiC,KAA8C;AAC7E,MAAI,IAAI,YAAY,MAClB,QAAO;EAET,MAAM,OAAO,IAAI;AACjB,SAAO,uBAAuB;GAC5B,iBAAiB;GACjB,SAAS,YAAY;AACnB,UAAM,KAAK,IAAI,gBAAgB;KAC7B,SAAS,IAAI;KACb,SAAS,IAAI;KACb,SAAS;KACT,MAAM;KACN,UAAU;MACR,WAAW,MAAM;MACjB,UAAU,MAAM;MAChB,gBAAgB,MAAM;MACtB,gBAAgB,MAAM;MACvB;KACF,CAAC;;GAEJ,QAAQ,YAAY;AAClB,UAAM,KAAK,IAAI,gBAAgB;KAC7B,SAAS,IAAI;KACb,SAAS,IAAI;KACb,SAAS;KACT,MAAM;KACN,UAAU;MACR,WAAW,MAAM;MACjB,UAAU,MAAM;MAChB,gBAAgB,MAAM;MACtB,gBAAgB,MAAM;MACvB;KACF,CAAC;;GAEL,CAAC;;;;;;;CAQJ,MAAM,kBAAkB,KAAqB,gBAA+C;AAC1F,MAAI,KAAK,cAAc,0BAA0B,CAC/C;EAGF,MAAM,eAAe,KAAK,0BAA0B,eAAe,WAAW;AAC9E,MAAI,CAAC,cAAc,MAAM,CACvB;AAIF,MAAI,cAAc,cADH,KAAK,WAAW,EAAE,SAAS,WAAW,eAAA,IACd,IAAI,aAAa,MAAM,KAAA,YAAe;AAC3E,OAAI,MAAM,EAAE,YAAY,eAAe,YAAY,EAAE,mCAAmC;AACxF;;EAGF,MAAM,aAAa,MAAM,KAAK,YAAY,kBACxC,eAAe,QACf,cACA,eAAe,QAChB;AACD,MAAI,CAAC,WAAW,KACd;AAGF,QAAM,KAAK,IAAI,gBAAgB;GAC7B,SAAS,eAAe;GACxB,SAAS,eAAe;GACxB,SAAS,WAAW,WAAW;GAC/B,MAAM;GACN,UAAU;IACR,WAAW,IAAI,UAAU;IACzB,UAAU,IAAI,UAAU;IACxB,kBAAkB,IAAI,UAAU;IAChC,kBAAkB,eAAe,UAAU;IAC3C,gBAAgB,IAAI,UAAU;IAC9B,gBAAgB,IAAI,UAAU;IAC/B;GACF,CAAC;;;;;;;;CASJ,MAAM,wBAAwB,SAAoD;AAChF,QAAM,KAAK,YAAY,sBAAsB,QAAQ,YAAY,yBAAyB;GACxF,YAAY,QAAQ;GACpB,SAAS,QAAQ;GACjB,QAAQ,QAAQ;GAChB,iBAAiB,QAAQ;GACzB,oBAAoB,QAAQ;GAC5B,SAAS,QAAQ;GACjB,GAAI,QAAQ,gBAAgB,KAAA,IAAY,EAAE,aAAa,QAAQ,aAAa,GAAG,EAAE;GAClF,CAAC;AAEF,QAAM,KAAK,0BAA0B,QAAQ;;;CAI/C,6BACE,IACA,SACA,SAC+D;AAC/D,SAAO,KAAK,YAAY,kBAAkB,IAAI,SAAS,QAAQ;;;CAIjE,0BACE,IACA,SACA,SACA,OACA,SACe;AACf,SAAO,KAAK,YAAY,eAAe,IAAI,SAAS,SAAS,OAAO,QAAQ"}

package/dist/src/agent/messaging/stream-manager.d.ts

@@ -7,6 +7,7 @@
 import type { ProgressStage } from '../lifecycle/progress.js';
 export interface StreamHandle {
     update: (text: string) => void;
+    updateReasoning?: (text: string) => void;
     updateProgress?: (text: string, stage: ProgressStage, detail?: string) => void;
     setProgress?: (stage: ProgressStage, detail?: string) => void;
     end: () => Promise<void>;
@@ -37,6 +38,7 @@ export declare class StreamManager {
      * Update the stream with text content
      */
     update(text: string): void;
+    updateReasoning(text: string): void;
     /**
      * End the stream and clear the handle
      */

package/dist/src/agent/messaging/stream-manager.js

@@ -32,6 +32,9 @@ var StreamManager = class {
 	update(text) {
 		this.currentHandle?.update(text);
 	}
+	updateReasoning(text) {
+		this.currentHandle?.updateReasoning?.(text);
+	}
 	/**
 	* End the stream and clear the handle
 	*/

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

@@ -1 +1 @@
-{"version":3,"file":"stream-manager.js","names":[],"sources":["../../../../src/agent/messaging/stream-manager.ts"],"sourcesContent":["/**\n * Stream Manager - Manages stream handles for progress updates\n *\n * Handles creation and lifecycle of stream handles for sending progress updates\n * and streaming responses.\n */\n\nimport type { ProgressStage } from '../lifecycle/progress.js';\n\nexport interface StreamHandle {\n  update: (text: string) => void;\n  updateProgress?: (text: string, stage: ProgressStage, detail?: string) => void;\n  setProgress?: (stage: ProgressStage, detail?: string) => void;\n  end: () => Promise<void>;\n  abort: () => Promise<void>;\n  messageId: () => number | undefined;\n  skipFinalOutbound?: () => boolean;\n}\n\nexport class StreamManager {\n  private currentHandle: StreamHandle | null = null;\n  private skipFinalOutboundPending = false;\n\n  /**\n   * Set the current stream handle\n   */\n  setHandle(handle: StreamHandle): void {\n    this.currentHandle = handle;\n  }\n\n  /**\n   * Get the current stream handle\n   */\n  getHandle(): StreamHandle | null {\n    return this.currentHandle;\n  }\n\n  /**\n   * Clear the current stream handle\n   */\n  clearHandle(): void {\n    this.currentHandle = null;\n  }\n\n  /**\n   * Check if a stream handle is currently active\n   */\n  hasActiveHandle(): boolean {\n    return this.currentHandle !== null;\n  }\n\n  /**\n   * Update the stream with text content\n   */\n  update(text: string): void {\n    this.currentHandle?.update(text);\n  }\n\n  /**\n   * End the stream and clear the handle\n   */\n  async end(): Promise<void> {\n    if (this.currentHandle) {\n      const handle = this.currentHandle;\n      await handle.end();\n      this.skipFinalOutboundPending = handle.skipFinalOutbound?.() ?? false;\n      this.clearHandle();\n    } else {\n      this.skipFinalOutboundPending = false;\n    }\n  }\n\n  /**\n   * Abort the stream and clear the handle\n   */\n  async abort(): Promise<void> {\n    if (this.currentHandle) {\n      await this.currentHandle.abort();\n      this.skipFinalOutboundPending = false;\n      this.clearHandle();\n    }\n  }\n\n  /**\n   * Whether the channel already delivered the final assistant text (e.g. Telegram streaming).\n   * Consumes the flag for one outbound decision.\n   */\n  consumeSkipFinalOutbound(): boolean {\n    const v = this.skipFinalOutboundPending;\n    this.skipFinalOutboundPending = false;\n    return v;\n  }\n\n  /**\n   * Get the current message ID from the stream handle\n   */\n  getMessageId(): number | undefined {\n    return this.currentHandle?.messageId();\n  }\n\n  /**\n   * Update progress via the stream handle\n   */\n  updateProgress(text: string, stage: ProgressStage, detail?: string): void {\n    if (this.currentHandle?.updateProgress) {\n      this.currentHandle.updateProgress(text, stage, detail);\n    }\n  }\n\n  /**\n   * Set progress stage via the stream handle\n   */\n  setProgress(stage: ProgressStage, detail?: string): void {\n    if (this.currentHandle?.setProgress) {\n      this.currentHandle.setProgress(stage, detail);\n    }\n  }\n}\n"],"mappings":";AAmBA,IAAa,gBAAb,MAA2B;CACzB,gBAA6C;CAC7C,2BAAmC;;;;CAKnC,UAAU,QAA4B;AACpC,OAAK,gBAAgB;;;;;CAMvB,YAAiC;AAC/B,SAAO,KAAK;;;;;CAMd,cAAoB;AAClB,OAAK,gBAAgB;;;;;CAMvB,kBAA2B;AACzB,SAAO,KAAK,kBAAkB;;;;;CAMhC,OAAO,MAAoB;AACzB,OAAK,eAAe,OAAO,KAAK;;;;;CAMlC,MAAM,MAAqB;AACzB,MAAI,KAAK,eAAe;GACtB,MAAM,SAAS,KAAK;AACpB,SAAM,OAAO,KAAK;AAClB,QAAK,2BAA2B,OAAO,qBAAqB,IAAI;AAChE,QAAK,aAAa;QAElB,MAAK,2BAA2B;;;;;CAOpC,MAAM,QAAuB;AAC3B,MAAI,KAAK,eAAe;AACtB,SAAM,KAAK,cAAc,OAAO;AAChC,QAAK,2BAA2B;AAChC,QAAK,aAAa;;;;;;;CAQtB,2BAAoC;EAClC,MAAM,IAAI,KAAK;AACf,OAAK,2BAA2B;AAChC,SAAO;;;;;CAMT,eAAmC;AACjC,SAAO,KAAK,eAAe,WAAW;;;;;CAMxC,eAAe,MAAc,OAAsB,QAAuB;AACxE,MAAI,KAAK,eAAe,eACtB,MAAK,cAAc,eAAe,MAAM,OAAO,OAAO;;;;;CAO1D,YAAY,OAAsB,QAAuB;AACvD,MAAI,KAAK,eAAe,YACtB,MAAK,cAAc,YAAY,OAAO,OAAO"}
+{"version":3,"file":"stream-manager.js","names":[],"sources":["../../../../src/agent/messaging/stream-manager.ts"],"sourcesContent":["/**\n * Stream Manager - Manages stream handles for progress updates\n *\n * Handles creation and lifecycle of stream handles for sending progress updates\n * and streaming responses.\n */\n\nimport type { ProgressStage } from '../lifecycle/progress.js';\n\nexport interface StreamHandle {\n  update: (text: string) => void;\n  updateReasoning?: (text: string) => void;\n  updateProgress?: (text: string, stage: ProgressStage, detail?: string) => void;\n  setProgress?: (stage: ProgressStage, detail?: string) => void;\n  end: () => Promise<void>;\n  abort: () => Promise<void>;\n  messageId: () => number | undefined;\n  skipFinalOutbound?: () => boolean;\n}\n\nexport class StreamManager {\n  private currentHandle: StreamHandle | null = null;\n  private skipFinalOutboundPending = false;\n\n  /**\n   * Set the current stream handle\n   */\n  setHandle(handle: StreamHandle): void {\n    this.currentHandle = handle;\n  }\n\n  /**\n   * Get the current stream handle\n   */\n  getHandle(): StreamHandle | null {\n    return this.currentHandle;\n  }\n\n  /**\n   * Clear the current stream handle\n   */\n  clearHandle(): void {\n    this.currentHandle = null;\n  }\n\n  /**\n   * Check if a stream handle is currently active\n   */\n  hasActiveHandle(): boolean {\n    return this.currentHandle !== null;\n  }\n\n  /**\n   * Update the stream with text content\n   */\n  update(text: string): void {\n    this.currentHandle?.update(text);\n  }\n\n  updateReasoning(text: string): void {\n    this.currentHandle?.updateReasoning?.(text);\n  }\n\n  /**\n   * End the stream and clear the handle\n   */\n  async end(): Promise<void> {\n    if (this.currentHandle) {\n      const handle = this.currentHandle;\n      await handle.end();\n      this.skipFinalOutboundPending = handle.skipFinalOutbound?.() ?? false;\n      this.clearHandle();\n    } else {\n      this.skipFinalOutboundPending = false;\n    }\n  }\n\n  /**\n   * Abort the stream and clear the handle\n   */\n  async abort(): Promise<void> {\n    if (this.currentHandle) {\n      await this.currentHandle.abort();\n      this.skipFinalOutboundPending = false;\n      this.clearHandle();\n    }\n  }\n\n  /**\n   * Whether the channel already delivered the final assistant text (e.g. Telegram streaming).\n   * Consumes the flag for one outbound decision.\n   */\n  consumeSkipFinalOutbound(): boolean {\n    const v = this.skipFinalOutboundPending;\n    this.skipFinalOutboundPending = false;\n    return v;\n  }\n\n  /**\n   * Get the current message ID from the stream handle\n   */\n  getMessageId(): number | undefined {\n    return this.currentHandle?.messageId();\n  }\n\n  /**\n   * Update progress via the stream handle\n   */\n  updateProgress(text: string, stage: ProgressStage, detail?: string): void {\n    if (this.currentHandle?.updateProgress) {\n      this.currentHandle.updateProgress(text, stage, detail);\n    }\n  }\n\n  /**\n   * Set progress stage via the stream handle\n   */\n  setProgress(stage: ProgressStage, detail?: string): void {\n    if (this.currentHandle?.setProgress) {\n      this.currentHandle.setProgress(stage, detail);\n    }\n  }\n}\n"],"mappings":";AAoBA,IAAa,gBAAb,MAA2B;CACzB,gBAA6C;CAC7C,2BAAmC;;;;CAKnC,UAAU,QAA4B;AACpC,OAAK,gBAAgB;;;;;CAMvB,YAAiC;AAC/B,SAAO,KAAK;;;;;CAMd,cAAoB;AAClB,OAAK,gBAAgB;;;;;CAMvB,kBAA2B;AACzB,SAAO,KAAK,kBAAkB;;;;;CAMhC,OAAO,MAAoB;AACzB,OAAK,eAAe,OAAO,KAAK;;CAGlC,gBAAgB,MAAoB;AAClC,OAAK,eAAe,kBAAkB,KAAK;;;;;CAM7C,MAAM,MAAqB;AACzB,MAAI,KAAK,eAAe;GACtB,MAAM,SAAS,KAAK;AACpB,SAAM,OAAO,KAAK;AAClB,QAAK,2BAA2B,OAAO,qBAAqB,IAAI;AAChE,QAAK,aAAa;QAElB,MAAK,2BAA2B;;;;;CAOpC,MAAM,QAAuB;AAC3B,MAAI,KAAK,eAAe;AACtB,SAAM,KAAK,cAAc,OAAO;AAChC,QAAK,2BAA2B;AAChC,QAAK,aAAa;;;;;;;CAQtB,2BAAoC;EAClC,MAAM,IAAI,KAAK;AACf,OAAK,2BAA2B;AAChC,SAAO;;;;;CAMT,eAAmC;AACjC,SAAO,KAAK,eAAe,WAAW;;;;;CAMxC,eAAe,MAAc,OAAsB,QAAuB;AACxE,MAAI,KAAK,eAAe,eACtB,MAAK,cAAc,eAAe,MAAM,OAAO,OAAO;;;;;CAO1D,YAAY,OAAsB,QAAuB;AACvD,MAAI,KAAK,eAAe,YACtB,MAAK,cAAc,YAAY,OAAO,OAAO"}

package/dist/src/agent/orchestration/agent-orchestrator.d.ts

@@ -64,10 +64,6 @@ export declare class AgentOrchestrator {
      * Process a message through the agent orchestration pipeline
      */
     process(msg: InboundMessage, context: SessionContext): Promise<void>;
-    /**
-     * Build an agent message from an inbound message
-     */
-    private buildUserMessage;
     /**
      * Get the current agent model ID
      */