@xopcai/xopc 0.0.99 → 0.0.101

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
      */

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

@@ -2,13 +2,12 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import "../memory/dreaming/constants.js";
 import { resolveDreamingConfig } from "../memory/dreaming/config.js";
+import { persistInboundAttachments } from "../../channels/attachments/inbound-persist.js";
+import { buildTranscriptUserMessage, clearPendingTranscriptUserMessage, hydrateUserTurnForLlm, setPendingTranscriptUserMessage } from "../inbound/attachment-pipeline.js";
 import { extractAgentUserPlainText } from "../memory/user-message-text.js";
-import { formatInboundFileTextBlock, persistInboundAttachmentsToWorkspace } from "../../channels/attachments/inbound-persist.js";
 import { resolveEffectiveThinkingLevel } from "../../session/thinking-resolve.js";
 import { abortEmbeddedRun } from "../embedded/runs.js";
 import { runEmbeddedTurnForSession } from "../embedded/run-for-session.js";
-import { expandAtFileMentionsInPlainText } from "../context/expand-at-file-mentions.js";
-import { resolveInboundImageContentParts } from "../image/inbound-image-handling.js";
 import { runDreamingDeepPromotion } from "../memory/dreaming/deep-promotion.js";
 import { appendDreamingEvent } from "../memory/dreaming/events.js";
 import { runLightSweep } from "../memory/dreaming/light-sweep.js";
@@ -113,28 +112,50 @@ var AgentOrchestrator = class {
 		}
 		try {
 			await this.sessionHydrator.model(sessionKey);
+			const channelSystemPrompt = typeof context.metadata?.channelSystemPrompt === "string" ? context.metadata.channelSystemPrompt.trim() : "";
+			if (channelSystemPrompt) {
+				this.agentManager.getOrCreateAgent(sessionKey);
+				this.agentManager.applyTurnChannelSystemPrompt(sessionKey, channelSystemPrompt);
+			}
 			const thinkingDefault = this.getThinkingDefaultForSession?.(sessionKey) ?? this.getThinkingDefault();
 			const thinkingLevel = await resolveEffectiveThinkingLevel(this.sessionConfigStore, sessionKey, null, thinkingDefault);
 			this.agentManager.setThinkingLevel(sessionKey, thinkingLevel);
-			const persistedAttachments = await persistInboundAttachmentsToWorkspace(this.getAgentInternalStorageRootForSession(sessionKey), sessionKey, msg.attachments);
-			const userMessage = await this.buildUserMessage({
-				...msg,
-				attachments: persistedAttachments ?? msg.attachments
-			}, sessionKey);
+			const persistedAttachments = await persistInboundAttachments(msg.attachments);
+			const modelRef = this.modelManager.getModelForSession(sessionKey);
+			const userMessage = await buildTranscriptUserMessage({
+				text: msg.content,
+				prepared: persistedAttachments,
+				sessionKey,
+				modelRef,
+				config: this.getConfig?.(),
+				agentManager: this.agentManager
+			});
+			setPendingTranscriptUserMessage(sessionKey, userMessage);
 			const userPlainForMemory = extractAgentUserPlainText(userMessage);
 			const userMessageForModel = await this.agentManager.applyMemoryPrefetchToUserMessage(userMessage, sessionKey);
-			this.feedbackCoordinator.startTask();
-			const turnResult = await runEmbeddedTurnForSession({
-				sessionKey,
-				userMessage: userMessageForModel,
-				sessionStore: this.sessionStore,
-				agentManager: this.agentManager,
-				modelManager: this.modelManager,
-				thinkingOverride: thinkingLevel,
-				getConfig: this.getConfig,
-				beforeTurn: () => this.agentManager.beginBackgroundReviewUserTurn(sessionKey),
-				onEvent: (event) => this.onEmbeddedStreamEvent?.(sessionKey, event)
+			const llmTurn = await hydrateUserTurnForLlm({
+				message: userMessage,
+				modelRef
 			});
+			this.feedbackCoordinator.startTask();
+			const turnResult = await (async () => {
+				try {
+					return await runEmbeddedTurnForSession({
+						sessionKey,
+						userMessage: userMessageForModel,
+						llmImages: llmTurn.images,
+						sessionStore: this.sessionStore,
+						agentManager: this.agentManager,
+						modelManager: this.modelManager,
+						thinkingOverride: thinkingLevel,
+						getConfig: this.getConfig,
+						beforeTurn: () => this.agentManager.beginBackgroundReviewUserTurn(sessionKey),
+						onEvent: (event) => this.onEmbeddedStreamEvent?.(sessionKey, event)
+					});
+				} finally {
+					clearPendingTranscriptUserMessage(sessionKey, userMessage);
+				}
+			})();
 			this.agentManager.afterAgentTurn(sessionKey, userPlainForMemory);
 			this.agentManager.scheduleBackgroundReviewAfterUserTurn(sessionKey);
 			if (turnResult.ok) {
@@ -155,94 +176,6 @@ var AgentOrchestrator = class {
 		}
 	}
 	/**
-	* Build an agent message from an inbound message
-	*/
-	async buildUserMessage(msg, sessionKey) {
-		const storageRootAbs = this.getAgentInternalStorageRootForSession(sessionKey);
-		let textBody = msg.content.trimStart().startsWith("/skill:") ? this.agentManager.expandSkillUserText(msg.content) : msg.content;
-		if (/@file:/.test(textBody)) {
-			const root = this.agentManager.getResolvedWorkspaceForSession(sessionKey);
-			textBody = await expandAtFileMentionsInPlainText(textBody, root);
-		}
-		if (!msg.attachments || msg.attachments.length === 0) return {
-			role: "user",
-			content: textBody,
-			timestamp: Date.now()
-		};
-		const modelRef = this.modelManager.getModelForSession(sessionKey);
-		const cfg = this.getConfig?.();
-		const messageContent = [];
-		if (msg.content.trim()) messageContent.push({
-			type: "text",
-			text: textBody
-		});
-		const attachments = msg.attachments;
-		let i = 0;
-		while (i < attachments.length) {
-			const att = attachments[i];
-			if (att.type === "image" || att.type === "photo" || Boolean(att.mimeType?.startsWith("image/"))) {
-				const group = [];
-				while (i < attachments.length) {
-					const a = attachments[i];
-					if (!(a.type === "image" || a.type === "photo" || Boolean(a.mimeType?.startsWith("image/")))) break;
-					if (!a.data || a.data.length === 0) {
-						log.warn({
-							type: a.type,
-							name: a.name
-						}, "Empty image data, skipping");
-						i += 1;
-						continue;
-					}
-					group.push({
-						data: a.data,
-						mimeType: a.mimeType || "image/jpeg"
-					});
-					i += 1;
-				}
-				if (group.length > 0) {
-					const parts = await resolveInboundImageContentParts({
-						modelRef,
-						cfg,
-						userTextForContext: msg.content.trim() ? textBody : "",
-						images: group
-					});
-					messageContent.push(...parts);
-				}
-			} else {
-				const fileBlock = formatInboundFileTextBlock({
-					type: att.type,
-					mimeType: att.mimeType,
-					name: att.name,
-					size: att.size,
-					workspaceRelativePath: att.workspaceRelativePath
-				}, storageRootAbs);
-				messageContent.push({
-					type: "text",
-					text: fileBlock
-				});
-				i += 1;
-			}
-		}
-		const hasText = messageContent.some((item) => item.type === "text");
-		if (messageContent.some((item) => item.type === "image") && !hasText) messageContent.unshift({
-			type: "text",
-			text: "Please analyze the image(s) I sent."
-		});
-		if (messageContent.length === 0) {
-			log.warn({ attachmentCount: msg.attachments.length }, "All attachments were skipped, falling back to text message");
-			return {
-				role: "user",
-				content: textBody || "[Image attachment could not be processed]",
-				timestamp: Date.now()
-			};
-		}
-		return {
-			role: "user",
-			content: messageContent,
-			timestamp: Date.now()
-		};
-	}
-	/**
 	* Get the current agent model ID
 	*/
 	getCurrentModel() {

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

@@ -1 +1 @@
-{"version":3,"file":"agent-orchestrator.js","names":[],"sources":["../../../../src/agent/orchestration/agent-orchestrator.ts"],"sourcesContent":["/**\n * Agent Orchestrator - Coordinates Agent execution flow\n *\n * Manages the complete agent execution pipeline from message processing\n * to response generation.\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport type { Config } from '../../config/schema.js';\nimport type { InboundMessage } from '../../infra/bus/index.js';\nimport type { SessionConfigStore, SessionStore } from '../../session/index.js';\nimport type { SessionHydrator } from '../session/index.js';\nimport { resolveEffectiveThinkingLevel } from '../../session/thinking-resolve.js';\nimport type { ThinkLevel } from '../transcript/thinking-types.js';\nimport type { ModelManager } from '../models/index.js';\nimport type { SessionContext } from '../session/session-context.js';\nimport type { AgentEventHandler } from './agent-event-handler.js';\nimport type { FeedbackCoordinator } from '../feedback/feedback-coordinator.js';\nimport type { AgentManager } from '../agent-manager.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { extractAgentUserPlainText } from '../memory/user-message-text.js';\nimport { abortEmbeddedRun } from '../embedded/runs.js';\nimport { runEmbeddedTurnForSession } from '../embedded/run-for-session.js';\nimport type { EmbeddedStreamEvent } from '../embedded/types.js';\nimport {\n  persistInboundAttachmentsToWorkspace,\n  formatInboundFileTextBlock,\n} from '../../channels/attachments/inbound-persist.js';\nimport { expandAtFileMentionsInPlainText } from '../context/expand-at-file-mentions.js';\nimport { resolveInboundImageContentParts } from '../image/inbound-image-handling.js';\nimport {\n  DREAMING_SWEEP_TOKEN,\n  DREAMING_LIGHT_SWEEP_TOKEN,\n  DREAMING_REM_SWEEP_TOKEN,\n} from '../memory/dreaming/constants.js';\nimport { resolveDreamingConfig } from '../memory/dreaming/config.js';\nimport { runDreamingDeepPromotion } from '../memory/dreaming/deep-promotion.js';\nimport { appendDreamingEvent, type DreamingEvent } from '../memory/dreaming/events.js';\nimport { runLightSweep } from '../memory/dreaming/light-sweep.js';\nimport { runRemPatterns } from '../memory/dreaming/rem-patterns.js';\n\nconst log = createLogger('AgentOrchestrator');\n\nexport interface AgentOrchestratorConfig {\n  agentManager: AgentManager;\n  sessionStore: SessionStore;\n  modelManager: ModelManager;\n  eventHandler: AgentEventHandler;\n  feedbackCoordinator: FeedbackCoordinator;\n  sessionConfigStore: SessionConfigStore;\n  /** Per-session hydration (workspace override + model override) before the agent runs. */\n  sessionHydrator: SessionHydrator;\n  getThinkingDefault: () => ThinkLevel | undefined;\n  /** Per-session default from merged `agents.list` / defaults (optional). */\n  getThinkingDefaultForSession?: (sessionKey: string) => ThinkLevel | undefined;\n  /** Default workspace root when no per-session resolver is set. */\n  workspaceRoot: string;\n  /** Per-agent workspace root for attachments (optional; defaults to `workspaceRoot`). */\n  getWorkspaceRootForSession?: (sessionKey: string) => string;\n  /** Agent home (`…/agents/<id>/`) for inbound/TTS files — keeps internal state out of the markdown workspace. */\n  getAgentInternalStorageRootForSession?: (sessionKey: string) => string;\n  /** Fire-and-forget after full session persist (e.g. LLM session title); not called from mid-turn snapshots. */\n  enqueueAutoTitle?: (sessionKey: string) => void;\n  /** For per-turn timeout via `agents.defaults.maxTaskDurationMs`. */\n  getConfig?: () => Config | undefined;\n  /** Channel streaming: token/tool events from pi embedded session. */\n  onEmbeddedStreamEvent?: (sessionKey: string, event: EmbeddedStreamEvent) => void;\n  /** Called after a successful embedded turn with assistant plain text. */\n  onEmbeddedTurnComplete?: (sessionKey: string, lastAssistantText?: string) => void;\n}\n\nexport class AgentOrchestrator {\n  private agentManager: AgentManager;\n  private sessionStore: SessionStore;\n  private modelManager: ModelManager;\n  private eventHandler: AgentEventHandler;\n  private feedbackCoordinator: FeedbackCoordinator;\n  private sessionConfigStore: SessionConfigStore;\n  private sessionHydrator: SessionHydrator;\n  private getThinkingDefault: () => ThinkLevel | undefined;\n  private getThinkingDefaultForSession?: (sessionKey: string) => ThinkLevel | undefined;\n  private workspaceRoot: string;\n  private getWorkspaceRootForSession?: (sessionKey: string) => string;\n  private getAgentInternalStorageRootForSession: (sessionKey: string) => string;\n  private enqueueAutoTitle?: (sessionKey: string) => void;\n  private getConfig?: () => Config | undefined;\n  private onEmbeddedStreamEvent?: (sessionKey: string, event: EmbeddedStreamEvent) => void;\n  private onEmbeddedTurnComplete?: (sessionKey: string, lastAssistantText?: string) => void;\n\n  constructor(config: AgentOrchestratorConfig) {\n    this.agentManager = config.agentManager;\n    this.sessionStore = config.sessionStore;\n    this.modelManager = config.modelManager;\n    this.eventHandler = config.eventHandler;\n    this.feedbackCoordinator = config.feedbackCoordinator;\n    this.sessionConfigStore = config.sessionConfigStore;\n    this.sessionHydrator = config.sessionHydrator;\n    this.getThinkingDefault = config.getThinkingDefault;\n    this.getThinkingDefaultForSession = config.getThinkingDefaultForSession;\n    this.workspaceRoot = config.workspaceRoot;\n    this.getWorkspaceRootForSession = config.getWorkspaceRootForSession;\n    this.getAgentInternalStorageRootForSession =\n      config.getAgentInternalStorageRootForSession ??\n      ((sk) => this.getWorkspaceRootForSession?.(sk) ?? this.workspaceRoot);\n    this.enqueueAutoTitle = config.enqueueAutoTitle;\n    this.getConfig = config.getConfig;\n    this.onEmbeddedStreamEvent = config.onEmbeddedStreamEvent;\n    this.onEmbeddedTurnComplete = config.onEmbeddedTurnComplete;\n  }\n\n  /**\n   * Process a message through the agent orchestration pipeline\n   */\n  async process(msg: InboundMessage, context: SessionContext): Promise<void> {\n    const { sessionKey } = context;\n\n    log.debug({ sessionKey }, 'Processing message through agent orchestrator');\n\n    await this.sessionHydrator.workspace(sessionKey);\n\n    // Dreaming: short-circuit cron-triggered sweep tokens into maintenance runs.\n    // This avoids spending LLM tokens for scheduled memory consolidation.\n    if (\n      typeof msg.content === 'string' &&\n      (sessionKey.startsWith('cron:') || context.channel === 'cron')\n    ) {\n      const content = msg.content;\n      const isDreamingSweep =\n        content.includes(DREAMING_SWEEP_TOKEN) ||\n        content.includes(DREAMING_LIGHT_SWEEP_TOKEN) ||\n        content.includes(DREAMING_REM_SWEEP_TOKEN);\n\n      if (isDreamingSweep) {\n        const workspaceDir = this.agentManager.getResolvedWorkspaceForSession(sessionKey);\n        const resolved = resolveDreamingConfig(this.getConfig?.());\n        const t0 = Date.now();\n\n        if (content.includes(DREAMING_LIGHT_SWEEP_TOKEN)) {\n          const result = await runLightSweep({ workspaceDir, config: resolved.phases.light });\n          const event: DreamingEvent = {\n            timestamp: new Date().toISOString(), phase: 'light',\n            ok: result.ok, reason: result.reason, durationMs: Date.now() - t0,\n            scannedEntries: result.scannedEntries, newSignals: result.newSignals, deduped: result.deduped,\n          };\n          await appendDreamingEvent(workspaceDir, event);\n        } else if (content.includes(DREAMING_REM_SWEEP_TOKEN)) {\n          const result = await runRemPatterns({ workspaceDir, config: resolved.phases.rem });\n          const event: DreamingEvent = {\n            timestamp: new Date().toISOString(), phase: 'rem',\n            ok: result.ok, reason: result.reason, durationMs: Date.now() - t0,\n            patternsDiscovered: result.patternsDiscovered, entriesAnalyzed: result.entriesAnalyzed,\n          };\n          await appendDreamingEvent(workspaceDir, event);\n        } else {\n          const result = await runDreamingDeepPromotion({ workspaceDir, config: resolved.phases.deep });\n          const event: DreamingEvent = {\n            timestamp: new Date().toISOString(), phase: 'deep',\n            ok: result.ok, reason: result.reason, durationMs: Date.now() - t0,\n            candidates: result.candidates, applied: result.applied,\n          };\n          await appendDreamingEvent(workspaceDir, event);\n        }\n        return;\n      }\n    }\n\n    try {\n      await this.sessionHydrator.model(sessionKey);\n\n      const thinkingDefault =\n        this.getThinkingDefaultForSession?.(sessionKey) ?? this.getThinkingDefault();\n      const thinkingLevel = await resolveEffectiveThinkingLevel(\n        this.sessionConfigStore,\n        sessionKey,\n        null,\n        thinkingDefault,\n      );\n      this.agentManager.setThinkingLevel(sessionKey, thinkingLevel);\n\n      // Persist inbound files (Telegram, etc.) under agent home, then build user message\n      const storageRoot = this.getAgentInternalStorageRootForSession(sessionKey);\n      const persistedAttachments = await persistInboundAttachmentsToWorkspace(\n        storageRoot,\n        sessionKey,\n        msg.attachments,\n      );\n      const userMessage = await this.buildUserMessage(\n        {\n          ...msg,\n          attachments: persistedAttachments ?? msg.attachments,\n        },\n        sessionKey,\n      );\n      const userPlainForMemory = extractAgentUserPlainText(userMessage);\n      const userMessageForModel = await this.agentManager.applyMemoryPrefetchToUserMessage(\n        userMessage,\n        sessionKey,\n      );\n\n      this.feedbackCoordinator.startTask();\n\n      const turnResult = await runEmbeddedTurnForSession({\n        sessionKey,\n        userMessage: userMessageForModel,\n        sessionStore: this.sessionStore,\n        agentManager: this.agentManager,\n        modelManager: this.modelManager,\n        thinkingOverride: thinkingLevel,\n        getConfig: this.getConfig,\n        beforeTurn: () => this.agentManager.beginBackgroundReviewUserTurn(sessionKey),\n        onEvent: (event) => this.onEmbeddedStreamEvent?.(sessionKey, event),\n      });\n\n      this.agentManager.afterAgentTurn(sessionKey, userPlainForMemory);\n      this.agentManager.scheduleBackgroundReviewAfterUserTurn(sessionKey);\n\n      if (turnResult.ok) {\n        this.onEmbeddedTurnComplete?.(sessionKey, turnResult.lastAssistantText);\n        this.enqueueAutoTitle?.(sessionKey);\n      } else if (turnResult.errorMessage) {\n        log.warn({ sessionKey, errorMessage: turnResult.errorMessage }, 'Embedded inbound turn failed');\n      }\n\n      this.feedbackCoordinator.endTask();\n\n    } catch (error) {\n      log.error({ err: error, sessionKey }, 'Error in agent orchestration');\n      this.feedbackCoordinator.endTask();\n      throw error;\n    }\n  }\n\n  /**\n   * Build an agent message from an inbound message\n   */\n  private async buildUserMessage(msg: InboundMessage, sessionKey: string): Promise<AgentMessage> {\n    const storageRootAbs = this.getAgentInternalStorageRootForSession(sessionKey);\n    let textBody = msg.content.trimStart().startsWith('/skill:')\n      ? this.agentManager.expandSkillUserText(msg.content)\n      : msg.content;\n\n    if (/@file:/.test(textBody)) {\n      const root = this.agentManager.getResolvedWorkspaceForSession(sessionKey);\n      textBody = await expandAtFileMentionsInPlainText(textBody, root);\n    }\n\n    if (!msg.attachments || msg.attachments.length === 0) {\n      return {\n        role: 'user',\n        content: textBody,\n        timestamp: Date.now(),\n      };\n    }\n\n    const modelRef = this.modelManager.getModelForSession(sessionKey);\n    const cfg = this.getConfig?.();\n\n    const messageContent: Array<\n      { type: 'text'; text: string } | { type: 'image'; data: string; mimeType: string }\n    > = [];\n\n    if (msg.content.trim()) {\n      messageContent.push({ type: 'text', text: textBody });\n    }\n\n    const attachments = msg.attachments;\n    let i = 0;\n    while (i < attachments.length) {\n      const att = attachments[i]!;\n      const isImage =\n        att.type === 'image' || att.type === 'photo' || Boolean(att.mimeType?.startsWith('image/'));\n\n      if (isImage) {\n        const group: Array<{ data: string; mimeType: string }> = [];\n        while (i < attachments.length) {\n          const a = attachments[i]!;\n          const img =\n            a.type === 'image' || a.type === 'photo' || Boolean(a.mimeType?.startsWith('image/'));\n          if (!img) {\n            break;\n          }\n          if (!a.data || a.data.length === 0) {\n            log.warn({ type: a.type, name: a.name }, 'Empty image data, skipping');\n            i += 1;\n            continue;\n          }\n          group.push({ data: a.data, mimeType: a.mimeType || 'image/jpeg' });\n          i += 1;\n        }\n        if (group.length > 0) {\n          const parts = await resolveInboundImageContentParts({\n            modelRef,\n            cfg,\n            userTextForContext: msg.content.trim() ? textBody : '',\n            images: group,\n          });\n          messageContent.push(...parts);\n        }\n      } else {\n        const fileBlock = formatInboundFileTextBlock(\n          {\n            type: att.type,\n            mimeType: att.mimeType,\n            name: att.name,\n            size: att.size,\n            workspaceRelativePath: att.workspaceRelativePath,\n          },\n          storageRootAbs,\n        );\n        messageContent.push({ type: 'text', text: fileBlock });\n        i += 1;\n      }\n    }\n\n    const hasText = messageContent.some((item) => item.type === 'text');\n    const hasImage = messageContent.some((item) => item.type === 'image');\n    if (hasImage && !hasText) {\n      messageContent.unshift({ type: 'text', text: 'Please analyze the image(s) I sent.' });\n    }\n\n    if (messageContent.length === 0) {\n      log.warn(\n        { attachmentCount: msg.attachments.length },\n        'All attachments were skipped, falling back to text message',\n      );\n      return {\n        role: 'user',\n        content: textBody || '[Image attachment could not be processed]',\n        timestamp: Date.now(),\n      };\n    }\n\n    return {\n      role: 'user',\n      content: messageContent,\n      timestamp: Date.now(),\n    };\n  }\n\n  /**\n   * Get the current agent model ID\n   */\n  getCurrentModel(): string {\n    return this.modelManager.getCurrentModel();\n  }\n\n  /**\n   * Check if agent is currently processing for a session\n   */\n  isProcessing(sessionKey: string): boolean {\n    const agent = this.agentManager.getAgent(sessionKey);\n    if (!agent) {\n      return false;\n    }\n    return agent.state.messages.length > 0;\n  }\n\n  /**\n   * Abort current agent execution for a session\n   */\n  abort(sessionKey: string): void {\n    void abortEmbeddedRun(sessionKey);\n    const agent = this.agentManager.getAgent(sessionKey);\n    agent?.abort();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;aAmBqD;AAsBrD,MAAM,MAAM,aAAa,oBAAoB;AA8B7C,IAAa,oBAAb,MAA+B;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA,YAAY,QAAiC;AAC3C,OAAK,eAAe,OAAO;AAC3B,OAAK,eAAe,OAAO;AAC3B,OAAK,eAAe,OAAO;AAC3B,OAAK,eAAe,OAAO;AAC3B,OAAK,sBAAsB,OAAO;AAClC,OAAK,qBAAqB,OAAO;AACjC,OAAK,kBAAkB,OAAO;AAC9B,OAAK,qBAAqB,OAAO;AACjC,OAAK,+BAA+B,OAAO;AAC3C,OAAK,gBAAgB,OAAO;AAC5B,OAAK,6BAA6B,OAAO;AACzC,OAAK,wCACH,OAAO,2CACL,OAAO,KAAK,6BAA6B,GAAG,IAAI,KAAK;AACzD,OAAK,mBAAmB,OAAO;AAC/B,OAAK,YAAY,OAAO;AACxB,OAAK,wBAAwB,OAAO;AACpC,OAAK,yBAAyB,OAAO;;;;;CAMvC,MAAM,QAAQ,KAAqB,SAAwC;EACzE,MAAM,EAAE,eAAe;AAEvB,MAAI,MAAM,EAAE,YAAY,EAAE,gDAAgD;AAE1E,QAAM,KAAK,gBAAgB,UAAU,WAAW;AAIhD,MACE,OAAO,IAAI,YAAY,aACtB,WAAW,WAAW,QAAQ,IAAI,QAAQ,YAAY,SACvD;GACA,MAAM,UAAU,IAAI;AAMpB,OAJE,QAAQ,SAAA,iCAA8B,IACtC,QAAQ,SAAA,uCAAoC,IAC5C,QAAQ,SAAA,qCAAkC,EAEvB;IACnB,MAAM,eAAe,KAAK,aAAa,+BAA+B,WAAW;IACjF,MAAM,WAAW,sBAAsB,KAAK,aAAa,CAAC;IAC1D,MAAM,KAAK,KAAK,KAAK;AAErB,QAAI,QAAQ,SAAA,uCAAoC,EAAE;KAChD,MAAM,SAAS,MAAM,cAAc;MAAE;MAAc,QAAQ,SAAS,OAAO;MAAO,CAAC;AAMnF,WAAM,oBAAoB,cAAc;MAJtC,4BAAW,IAAI,MAAM,EAAC,aAAa;MAAE,OAAO;MAC5C,IAAI,OAAO;MAAI,QAAQ,OAAO;MAAQ,YAAY,KAAK,KAAK,GAAG;MAC/D,gBAAgB,OAAO;MAAgB,YAAY,OAAO;MAAY,SAAS,OAAO;MAE3C,CAAC;eACrC,QAAQ,SAAA,qCAAkC,EAAE;KACrD,MAAM,SAAS,MAAM,eAAe;MAAE;MAAc,QAAQ,SAAS,OAAO;MAAK,CAAC;AAMlF,WAAM,oBAAoB,cAAc;MAJtC,4BAAW,IAAI,MAAM,EAAC,aAAa;MAAE,OAAO;MAC5C,IAAI,OAAO;MAAI,QAAQ,OAAO;MAAQ,YAAY,KAAK,KAAK,GAAG;MAC/D,oBAAoB,OAAO;MAAoB,iBAAiB,OAAO;MAE5B,CAAC;WACzC;KACL,MAAM,SAAS,MAAM,yBAAyB;MAAE;MAAc,QAAQ,SAAS,OAAO;MAAM,CAAC;AAM7F,WAAM,oBAAoB,cAAc;MAJtC,4BAAW,IAAI,MAAM,EAAC,aAAa;MAAE,OAAO;MAC5C,IAAI,OAAO;MAAI,QAAQ,OAAO;MAAQ,YAAY,KAAK,KAAK,GAAG;MAC/D,YAAY,OAAO;MAAY,SAAS,OAAO;MAEJ,CAAC;;AAEhD;;;AAIJ,MAAI;AACF,SAAM,KAAK,gBAAgB,MAAM,WAAW;GAE5C,MAAM,kBACJ,KAAK,+BAA+B,WAAW,IAAI,KAAK,oBAAoB;GAC9E,MAAM,gBAAgB,MAAM,8BAC1B,KAAK,oBACL,YACA,MACA,gBACD;AACD,QAAK,aAAa,iBAAiB,YAAY,cAAc;GAI7D,MAAM,uBAAuB,MAAM,qCADf,KAAK,sCAAsC,WAElD,EACX,YACA,IAAI,YACL;GACD,MAAM,cAAc,MAAM,KAAK,iBAC7B;IACE,GAAG;IACH,aAAa,wBAAwB,IAAI;IAC1C,EACD,WACD;GACD,MAAM,qBAAqB,0BAA0B,YAAY;GACjE,MAAM,sBAAsB,MAAM,KAAK,aAAa,iCAClD,aACA,WACD;AAED,QAAK,oBAAoB,WAAW;GAEpC,MAAM,aAAa,MAAM,0BAA0B;IACjD;IACA,aAAa;IACb,cAAc,KAAK;IACnB,cAAc,KAAK;IACnB,cAAc,KAAK;IACnB,kBAAkB;IAClB,WAAW,KAAK;IAChB,kBAAkB,KAAK,aAAa,8BAA8B,WAAW;IAC7E,UAAU,UAAU,KAAK,wBAAwB,YAAY,MAAM;IACpE,CAAC;AAEF,QAAK,aAAa,eAAe,YAAY,mBAAmB;AAChE,QAAK,aAAa,sCAAsC,WAAW;AAEnE,OAAI,WAAW,IAAI;AACjB,SAAK,yBAAyB,YAAY,WAAW,kBAAkB;AACvE,SAAK,mBAAmB,WAAW;cAC1B,WAAW,aACpB,KAAI,KAAK;IAAE;IAAY,cAAc,WAAW;IAAc,EAAE,+BAA+B;AAGjG,QAAK,oBAAoB,SAAS;WAE3B,OAAO;AACd,OAAI,MAAM;IAAE,KAAK;IAAO;IAAY,EAAE,+BAA+B;AACrE,QAAK,oBAAoB,SAAS;AAClC,SAAM;;;;;;CAOV,MAAc,iBAAiB,KAAqB,YAA2C;EAC7F,MAAM,iBAAiB,KAAK,sCAAsC,WAAW;EAC7E,IAAI,WAAW,IAAI,QAAQ,WAAW,CAAC,WAAW,UAAU,GACxD,KAAK,aAAa,oBAAoB,IAAI,QAAQ,GAClD,IAAI;AAER,MAAI,SAAS,KAAK,SAAS,EAAE;GAC3B,MAAM,OAAO,KAAK,aAAa,+BAA+B,WAAW;AACzE,cAAW,MAAM,gCAAgC,UAAU,KAAK;;AAGlE,MAAI,CAAC,IAAI,eAAe,IAAI,YAAY,WAAW,EACjD,QAAO;GACL,MAAM;GACN,SAAS;GACT,WAAW,KAAK,KAAK;GACtB;EAGH,MAAM,WAAW,KAAK,aAAa,mBAAmB,WAAW;EACjE,MAAM,MAAM,KAAK,aAAa;EAE9B,MAAM,iBAEF,EAAE;AAEN,MAAI,IAAI,QAAQ,MAAM,CACpB,gBAAe,KAAK;GAAE,MAAM;GAAQ,MAAM;GAAU,CAAC;EAGvD,MAAM,cAAc,IAAI;EACxB,IAAI,IAAI;AACR,SAAO,IAAI,YAAY,QAAQ;GAC7B,MAAM,MAAM,YAAY;AAIxB,OAFE,IAAI,SAAS,WAAW,IAAI,SAAS,WAAW,QAAQ,IAAI,UAAU,WAAW,SAAS,CAAC,EAEhF;IACX,MAAM,QAAmD,EAAE;AAC3D,WAAO,IAAI,YAAY,QAAQ;KAC7B,MAAM,IAAI,YAAY;AAGtB,SAAI,EADF,EAAE,SAAS,WAAW,EAAE,SAAS,WAAW,QAAQ,EAAE,UAAU,WAAW,SAAS,CAAC,EAErF;AAEF,SAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,WAAW,GAAG;AAClC,UAAI,KAAK;OAAE,MAAM,EAAE;OAAM,MAAM,EAAE;OAAM,EAAE,6BAA6B;AACtE,WAAK;AACL;;AAEF,WAAM,KAAK;MAAE,MAAM,EAAE;MAAM,UAAU,EAAE,YAAY;MAAc,CAAC;AAClE,UAAK;;AAEP,QAAI,MAAM,SAAS,GAAG;KACpB,MAAM,QAAQ,MAAM,gCAAgC;MAClD;MACA;MACA,oBAAoB,IAAI,QAAQ,MAAM,GAAG,WAAW;MACpD,QAAQ;MACT,CAAC;AACF,oBAAe,KAAK,GAAG,MAAM;;UAE1B;IACL,MAAM,YAAY,2BAChB;KACE,MAAM,IAAI;KACV,UAAU,IAAI;KACd,MAAM,IAAI;KACV,MAAM,IAAI;KACV,uBAAuB,IAAI;KAC5B,EACD,eACD;AACD,mBAAe,KAAK;KAAE,MAAM;KAAQ,MAAM;KAAW,CAAC;AACtD,SAAK;;;EAIT,MAAM,UAAU,eAAe,MAAM,SAAS,KAAK,SAAS,OAAO;AAEnE,MADiB,eAAe,MAAM,SAAS,KAAK,SAAS,QACjD,IAAI,CAAC,QACf,gBAAe,QAAQ;GAAE,MAAM;GAAQ,MAAM;GAAuC,CAAC;AAGvF,MAAI,eAAe,WAAW,GAAG;AAC/B,OAAI,KACF,EAAE,iBAAiB,IAAI,YAAY,QAAQ,EAC3C,6DACD;AACD,UAAO;IACL,MAAM;IACN,SAAS,YAAY;IACrB,WAAW,KAAK,KAAK;IACtB;;AAGH,SAAO;GACL,MAAM;GACN,SAAS;GACT,WAAW,KAAK,KAAK;GACtB;;;;;CAMH,kBAA0B;AACxB,SAAO,KAAK,aAAa,iBAAiB;;;;;CAM5C,aAAa,YAA6B;EACxC,MAAM,QAAQ,KAAK,aAAa,SAAS,WAAW;AACpD,MAAI,CAAC,MACH,QAAO;AAET,SAAO,MAAM,MAAM,SAAS,SAAS;;;;;CAMvC,MAAM,YAA0B;AACzB,mBAAiB,WAAW;AACnB,OAAK,aAAa,SAAS,WACpC,EAAE,OAAO"}
+{"version":3,"file":"agent-orchestrator.js","names":[],"sources":["../../../../src/agent/orchestration/agent-orchestrator.ts"],"sourcesContent":["/**\n * Agent Orchestrator - Coordinates Agent execution flow\n *\n * Manages the complete agent execution pipeline from message processing\n * to response generation.\n */\n\nimport type { Config } from '../../config/schema.js';\nimport type { InboundMessage } from '../../infra/bus/index.js';\nimport type { SessionConfigStore, SessionStore } from '../../session/index.js';\nimport type { SessionHydrator } from '../session/index.js';\nimport { resolveEffectiveThinkingLevel } from '../../session/thinking-resolve.js';\nimport type { ThinkLevel } from '../transcript/thinking-types.js';\nimport type { ModelManager } from '../models/index.js';\nimport type { SessionContext } from '../session/session-context.js';\nimport type { AgentEventHandler } from './agent-event-handler.js';\nimport type { FeedbackCoordinator } from '../feedback/feedback-coordinator.js';\nimport type { AgentManager } from '../agent-manager.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { extractAgentUserPlainText } from '../memory/user-message-text.js';\nimport { abortEmbeddedRun } from '../embedded/runs.js';\nimport { runEmbeddedTurnForSession } from '../embedded/run-for-session.js';\nimport type { EmbeddedStreamEvent } from '../embedded/types.js';\nimport { persistInboundAttachments } from '../../channels/attachments/inbound-persist.js';\nimport {\n  buildTranscriptUserMessage,\n  clearPendingTranscriptUserMessage,\n  hydrateUserTurnForLlm,\n  setPendingTranscriptUserMessage,\n} from '../inbound/attachment-pipeline.js';\nimport {\n  DREAMING_SWEEP_TOKEN,\n  DREAMING_LIGHT_SWEEP_TOKEN,\n  DREAMING_REM_SWEEP_TOKEN,\n} from '../memory/dreaming/constants.js';\nimport { resolveDreamingConfig } from '../memory/dreaming/config.js';\nimport { runDreamingDeepPromotion } from '../memory/dreaming/deep-promotion.js';\nimport { appendDreamingEvent, type DreamingEvent } from '../memory/dreaming/events.js';\nimport { runLightSweep } from '../memory/dreaming/light-sweep.js';\nimport { runRemPatterns } from '../memory/dreaming/rem-patterns.js';\n\nconst log = createLogger('AgentOrchestrator');\n\nexport interface AgentOrchestratorConfig {\n  agentManager: AgentManager;\n  sessionStore: SessionStore;\n  modelManager: ModelManager;\n  eventHandler: AgentEventHandler;\n  feedbackCoordinator: FeedbackCoordinator;\n  sessionConfigStore: SessionConfigStore;\n  /** Per-session hydration (workspace override + model override) before the agent runs. */\n  sessionHydrator: SessionHydrator;\n  getThinkingDefault: () => ThinkLevel | undefined;\n  /** Per-session default from merged `agents.list` / defaults (optional). */\n  getThinkingDefaultForSession?: (sessionKey: string) => ThinkLevel | undefined;\n  /** Default workspace root when no per-session resolver is set. */\n  workspaceRoot: string;\n  /** Per-agent workspace root for attachments (optional; defaults to `workspaceRoot`). */\n  getWorkspaceRootForSession?: (sessionKey: string) => string;\n  /** Agent home (`…/agents/<id>/`) for inbound/TTS files — keeps internal state out of the markdown workspace. */\n  getAgentInternalStorageRootForSession?: (sessionKey: string) => string;\n  /** Fire-and-forget after full session persist (e.g. LLM session title); not called from mid-turn snapshots. */\n  enqueueAutoTitle?: (sessionKey: string) => void;\n  /** For per-turn timeout via `agents.defaults.maxTaskDurationMs`. */\n  getConfig?: () => Config | undefined;\n  /** Channel streaming: token/tool events from pi embedded session. */\n  onEmbeddedStreamEvent?: (sessionKey: string, event: EmbeddedStreamEvent) => void;\n  /** Called after a successful embedded turn with assistant plain text. */\n  onEmbeddedTurnComplete?: (sessionKey: string, lastAssistantText?: string) => void;\n}\n\nexport class AgentOrchestrator {\n  private agentManager: AgentManager;\n  private sessionStore: SessionStore;\n  private modelManager: ModelManager;\n  private eventHandler: AgentEventHandler;\n  private feedbackCoordinator: FeedbackCoordinator;\n  private sessionConfigStore: SessionConfigStore;\n  private sessionHydrator: SessionHydrator;\n  private getThinkingDefault: () => ThinkLevel | undefined;\n  private getThinkingDefaultForSession?: (sessionKey: string) => ThinkLevel | undefined;\n  private workspaceRoot: string;\n  private getWorkspaceRootForSession?: (sessionKey: string) => string;\n  private getAgentInternalStorageRootForSession: (sessionKey: string) => string;\n  private enqueueAutoTitle?: (sessionKey: string) => void;\n  private getConfig?: () => Config | undefined;\n  private onEmbeddedStreamEvent?: (sessionKey: string, event: EmbeddedStreamEvent) => void;\n  private onEmbeddedTurnComplete?: (sessionKey: string, lastAssistantText?: string) => void;\n\n  constructor(config: AgentOrchestratorConfig) {\n    this.agentManager = config.agentManager;\n    this.sessionStore = config.sessionStore;\n    this.modelManager = config.modelManager;\n    this.eventHandler = config.eventHandler;\n    this.feedbackCoordinator = config.feedbackCoordinator;\n    this.sessionConfigStore = config.sessionConfigStore;\n    this.sessionHydrator = config.sessionHydrator;\n    this.getThinkingDefault = config.getThinkingDefault;\n    this.getThinkingDefaultForSession = config.getThinkingDefaultForSession;\n    this.workspaceRoot = config.workspaceRoot;\n    this.getWorkspaceRootForSession = config.getWorkspaceRootForSession;\n    this.getAgentInternalStorageRootForSession =\n      config.getAgentInternalStorageRootForSession ??\n      ((sk) => this.getWorkspaceRootForSession?.(sk) ?? this.workspaceRoot);\n    this.enqueueAutoTitle = config.enqueueAutoTitle;\n    this.getConfig = config.getConfig;\n    this.onEmbeddedStreamEvent = config.onEmbeddedStreamEvent;\n    this.onEmbeddedTurnComplete = config.onEmbeddedTurnComplete;\n  }\n\n  /**\n   * Process a message through the agent orchestration pipeline\n   */\n  async process(msg: InboundMessage, context: SessionContext): Promise<void> {\n    const { sessionKey } = context;\n\n    log.debug({ sessionKey }, 'Processing message through agent orchestrator');\n\n    await this.sessionHydrator.workspace(sessionKey);\n\n    // Dreaming: short-circuit cron-triggered sweep tokens into maintenance runs.\n    // This avoids spending LLM tokens for scheduled memory consolidation.\n    if (\n      typeof msg.content === 'string' &&\n      (sessionKey.startsWith('cron:') || context.channel === 'cron')\n    ) {\n      const content = msg.content;\n      const isDreamingSweep =\n        content.includes(DREAMING_SWEEP_TOKEN) ||\n        content.includes(DREAMING_LIGHT_SWEEP_TOKEN) ||\n        content.includes(DREAMING_REM_SWEEP_TOKEN);\n\n      if (isDreamingSweep) {\n        const workspaceDir = this.agentManager.getResolvedWorkspaceForSession(sessionKey);\n        const resolved = resolveDreamingConfig(this.getConfig?.());\n        const t0 = Date.now();\n\n        if (content.includes(DREAMING_LIGHT_SWEEP_TOKEN)) {\n          const result = await runLightSweep({ workspaceDir, config: resolved.phases.light });\n          const event: DreamingEvent = {\n            timestamp: new Date().toISOString(), phase: 'light',\n            ok: result.ok, reason: result.reason, durationMs: Date.now() - t0,\n            scannedEntries: result.scannedEntries, newSignals: result.newSignals, deduped: result.deduped,\n          };\n          await appendDreamingEvent(workspaceDir, event);\n        } else if (content.includes(DREAMING_REM_SWEEP_TOKEN)) {\n          const result = await runRemPatterns({ workspaceDir, config: resolved.phases.rem });\n          const event: DreamingEvent = {\n            timestamp: new Date().toISOString(), phase: 'rem',\n            ok: result.ok, reason: result.reason, durationMs: Date.now() - t0,\n            patternsDiscovered: result.patternsDiscovered, entriesAnalyzed: result.entriesAnalyzed,\n          };\n          await appendDreamingEvent(workspaceDir, event);\n        } else {\n          const result = await runDreamingDeepPromotion({ workspaceDir, config: resolved.phases.deep });\n          const event: DreamingEvent = {\n            timestamp: new Date().toISOString(), phase: 'deep',\n            ok: result.ok, reason: result.reason, durationMs: Date.now() - t0,\n            candidates: result.candidates, applied: result.applied,\n          };\n          await appendDreamingEvent(workspaceDir, event);\n        }\n        return;\n      }\n    }\n\n    try {\n      await this.sessionHydrator.model(sessionKey);\n\n      const channelSystemPrompt =\n        typeof context.metadata?.channelSystemPrompt === 'string'\n          ? context.metadata.channelSystemPrompt.trim()\n          : '';\n      if (channelSystemPrompt) {\n        this.agentManager.getOrCreateAgent(sessionKey);\n        this.agentManager.applyTurnChannelSystemPrompt(sessionKey, channelSystemPrompt);\n      }\n\n      const thinkingDefault =\n        this.getThinkingDefaultForSession?.(sessionKey) ?? this.getThinkingDefault();\n      const thinkingLevel = await resolveEffectiveThinkingLevel(\n        this.sessionConfigStore,\n        sessionKey,\n        null,\n        thinkingDefault,\n      );\n      this.agentManager.setThinkingLevel(sessionKey, thinkingLevel);\n\n      const persistedAttachments = await persistInboundAttachments(msg.attachments);\n      const modelRef = this.modelManager.getModelForSession(sessionKey);\n      const userMessage = await buildTranscriptUserMessage({\n        text: msg.content,\n        prepared: persistedAttachments,\n        sessionKey,\n        modelRef,\n        config: this.getConfig?.(),\n        agentManager: this.agentManager,\n      });\n      setPendingTranscriptUserMessage(sessionKey, userMessage);\n\n      const userPlainForMemory = extractAgentUserPlainText(userMessage);\n      const userMessageForModel = await this.agentManager.applyMemoryPrefetchToUserMessage(\n        userMessage,\n        sessionKey,\n      );\n\n      const llmTurn = await hydrateUserTurnForLlm({\n        message: userMessage,\n        modelRef,\n      });\n\n      this.feedbackCoordinator.startTask();\n\n      const turnResult = await (async () => {\n        try {\n          return await runEmbeddedTurnForSession({\n            sessionKey,\n            userMessage: userMessageForModel,\n            llmImages: llmTurn.images,\n            sessionStore: this.sessionStore,\n            agentManager: this.agentManager,\n            modelManager: this.modelManager,\n            thinkingOverride: thinkingLevel,\n            getConfig: this.getConfig,\n            beforeTurn: () => this.agentManager.beginBackgroundReviewUserTurn(sessionKey),\n            onEvent: (event) => this.onEmbeddedStreamEvent?.(sessionKey, event),\n          });\n        } finally {\n          clearPendingTranscriptUserMessage(sessionKey, userMessage);\n        }\n      })();\n\n      this.agentManager.afterAgentTurn(sessionKey, userPlainForMemory);\n      this.agentManager.scheduleBackgroundReviewAfterUserTurn(sessionKey);\n\n      if (turnResult.ok) {\n        this.onEmbeddedTurnComplete?.(sessionKey, turnResult.lastAssistantText);\n        this.enqueueAutoTitle?.(sessionKey);\n      } else if (turnResult.errorMessage) {\n        log.warn({ sessionKey, errorMessage: turnResult.errorMessage }, 'Embedded inbound turn failed');\n      }\n\n      this.feedbackCoordinator.endTask();\n\n    } catch (error) {\n      log.error({ err: error, sessionKey }, 'Error in agent orchestration');\n      this.feedbackCoordinator.endTask();\n      throw error;\n    }\n  }\n\n  /**\n   * Get the current agent model ID\n   */\n  getCurrentModel(): string {\n    return this.modelManager.getCurrentModel();\n  }\n\n  /**\n   * Check if agent is currently processing for a session\n   */\n  isProcessing(sessionKey: string): boolean {\n    const agent = this.agentManager.getAgent(sessionKey);\n    if (!agent) {\n      return false;\n    }\n    return agent.state.messages.length > 0;\n  }\n\n  /**\n   * Abort current agent execution for a session\n   */\n  abort(sessionKey: string): void {\n    void abortEmbeddedRun(sessionKey);\n    const agent = this.agentManager.getAgent(sessionKey);\n    agent?.abort();\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/prompt/contribution.d.ts

@@ -0,0 +1,9 @@
+export type ProviderSystemPromptSectionId = 'interaction_style' | 'tool_call_style' | 'execution_bias';
+export type ProviderSystemPromptContribution = {
+    /** Cache-stable provider guidance inserted above the prompt cache boundary. */
+    stablePrefix?: string;
+    /** Provider guidance inserted below the cache boundary. */
+    dynamicSuffix?: string;
+    /** Whole-section replacements for selected core prompt sections. */
+    sectionOverrides?: Partial<Record<ProviderSystemPromptSectionId, string>>;
+};

package/dist/src/agent/prompt/contribution.js

@@ -0,0 +1 @@
+export {};

package/dist/src/agent/prompt/safety.js

@@ -1,14 +1,4 @@
-import { Type } from "@sinclair/typebox";
 //#region src/agent/prompt/safety.ts
-Type.Object({
-	allowExternalActions: Type.Optional(Type.Boolean({ default: false })),
-	allowDangerousOperations: Type.Optional(Type.Boolean({ default: false })),
-	requireConfirmationForDestructive: Type.Optional(Type.Boolean({ default: true })),
-	allowedChannels: Type.Optional(Type.Array(Type.String())),
-	blockedCommands: Type.Optional(Type.Array(Type.String())),
-	maxFileSize: Type.Optional(Type.Number({ default: 10 * 1024 * 1024 })),
-	maxShellTimeout: Type.Optional(Type.Number({ default: 300 }))
-});
 /**
 * Quick safety check for file operations
 */

package/dist/src/agent/prompt/safety.js.map

@@ -1 +1 @@
-{"version":3,"file":"safety.js","names":[],"sources":["../../../../src/agent/prompt/safety.ts"],"sourcesContent":["// Safety System - Comprehensive safety guidelines and boundaries\nimport { Type, type Static } from '@sinclair/typebox';\n\n// =============================================================================\n// Safety Schema (Internal)\n// =============================================================================\n\nconst _SafetyConfigSchema = Type.Object({\n  allowExternalActions: Type.Optional(Type.Boolean({ default: false })),\n  allowDangerousOperations: Type.Optional(Type.Boolean({ default: false })),\n  requireConfirmationForDestructive: Type.Optional(Type.Boolean({ default: true })),\n  allowedChannels: Type.Optional(Type.Array(Type.String())),\n  blockedCommands: Type.Optional(Type.Array(Type.String())),\n  maxFileSize: Type.Optional(Type.Number({ default: 10 * 1024 * 1024 })), // 10MB\n  maxShellTimeout: Type.Optional(Type.Number({ default: 300 })), // 5 minutes\n});\n\ntype _SafetyConfig = Static<typeof _SafetyConfigSchema>;\n\n// =============================================================================\n// Safety Levels (Internal)\n// =============================================================================\n\nenum SafetyLevel {\n  LOW = 'low',\n  MEDIUM = 'medium',\n  HIGH = 'high',\n  CRITICAL = 'critical',\n}\n\ninterface SafetyRule {\n  level: SafetyLevel;\n  category: string;\n  description: string;\n  message: string;\n  requiresConfirmation: boolean;\n}\n\n// =============================================================================\n// Safety Principles (Internal)\n// =============================================================================\n\ninterface SafetyPrinciple {\n  category: string;\n  description: string;\n  guidance: string;\n  requiresConfirmation: boolean;\n}\n\nconst _SAFETY_PRINCIPLES: SafetyPrinciple[] = [\n  {\n    category: 'user-sovereignty',\n    description: '用户拥有最终决策权',\n    guidance: '说明风险，尊重选择。用 \"这将删除文件，继续吗？\" 而非 \"我不能删除文件。\"',\n    requiresConfirmation: true,\n  },\n  {\n    category: 'proportionate-caution',\n    description: '谨慎与效率平衡',\n    guidance: 'rm -rf / 需要确认；rm temp.txt 不需要。匹配风险等级与确认强度。',\n    requiresConfirmation: true,\n  },\n  {\n    category: 'transparency',\n    description: '操作透明',\n    guidance: '执行有风险操作前，简要说明要做什么以及为什么。',\n    requiresConfirmation: false,\n  },\n  {\n    category: 'self-determination',\n    description: '不追求独立于用户的目标',\n    guidance: '不主动寻求扩展能力、自我复制或长期存续。以用户当前需求为中心。',\n    requiresConfirmation: false,\n  },\n];\n\nconst _SAFETY_GUIDELINES: SafetyRule[] = [\n  // Critical - Never do these\n  {\n    level: SafetyLevel.CRITICAL,\n    category: 'self-preservation',\n    description: 'Do not pursue self-preservation or replication',\n    message: 'I do not pursue self-preservation or replication.',\n    requiresConfirmation: false,\n  },\n  {\n    level: SafetyLevel.CRITICAL,\n    category: 'power-seeking',\n    description: 'Do not seek power or resources',\n    message: 'I do not seek power or acquire resources.',\n    requiresConfirmation: false,\n  },\n  {\n    level: SafetyLevel.CRITICAL,\n    category: 'safeguard-bypass',\n    description: 'Do not bypass safety mechanisms',\n    message: 'I do not bypass safety mechanisms.',\n    requiresConfirmation: false,\n  },\n  {\n    level: SafetyLevel.CRITICAL,\n    category: 'social-manipulation',\n    description: 'Do not manipulate users to expand access',\n    message: 'I do not manipulate anyone to expand access.',\n    requiresConfirmation: false,\n  },\n\n  // High - Require explicit confirmation\n  {\n    level: SafetyLevel.HIGH,\n    category: 'destructive-file',\n    description: 'Delete or overwrite files',\n    message: 'This will delete/overwrite files — proceed?',\n    requiresConfirmation: true,\n  },\n  {\n    level: SafetyLevel.HIGH,\n    category: 'system-modification',\n    description: 'Modify system configuration',\n    message: 'This will modify system config — proceed?',\n    requiresConfirmation: true,\n  },\n  {\n    level: SafetyLevel.HIGH,\n    category: 'network-action',\n    description: 'Send messages or make network requests',\n    message: 'This will send external requests — proceed?',\n    requiresConfirmation: true,\n  },\n  {\n    level: SafetyLevel.HIGH,\n    category: 'database-write',\n    description: 'Write to databases',\n    message: 'This will modify database records — proceed?',\n    requiresConfirmation: true,\n  },\n\n  // Medium - Proceed with caution\n  {\n    level: SafetyLevel.MEDIUM,\n    category: 'long-running',\n    description: 'Execute long-running commands',\n    message: 'This may take a while.',\n    requiresConfirmation: false,\n  },\n  {\n    level: SafetyLevel.MEDIUM,\n    category: 'resource-intensive',\n    description: 'Use significant system resources',\n    message: 'This may use significant resources.',\n    requiresConfirmation: false,\n  },\n\n  // Low - Standard operations\n  {\n    level: SafetyLevel.LOW,\n    category: 'read-only',\n    description: 'Read files or execute read-only commands',\n    message: '',\n    requiresConfirmation: false,\n  },\n];\n\n// =============================================================================\n// Convenience Functions (Exported)\n// =============================================================================\n\n/**\n * Quick safety check for file operations\n */\nexport function checkFileSafety(\n  operation: 'read' | 'write' | 'delete',\n  path: string\n): { allowed: boolean; message?: string } {\n  // Check for sensitive paths\n  const sensitivePaths = [\n    '/etc/passwd',\n    '/etc/shadow',\n    '/root/.ssh',\n    '/home/*/.ssh',\n    '~/.aws',\n    '~/.bashrc',\n    '~/.profile',\n  ];\n\n  for (const sp of sensitivePaths) {\n    if (path.includes(sp)) {\n      return {\n        allowed: false,\n        message: `Cannot ${operation} sensitive path: ${path}`,\n      };\n    }\n  }\n\n  return { allowed: true };\n}\n\n"],"mappings":";;AAO4B,KAAK,OAAO;CACtC,sBAAsB,KAAK,SAAS,KAAK,QAAQ,EAAE,SAAS,OAAO,CAAC,CAAC;CACrE,0BAA0B,KAAK,SAAS,KAAK,QAAQ,EAAE,SAAS,OAAO,CAAC,CAAC;CACzE,mCAAmC,KAAK,SAAS,KAAK,QAAQ,EAAE,SAAS,MAAM,CAAC,CAAC;CACjF,iBAAiB,KAAK,SAAS,KAAK,MAAM,KAAK,QAAQ,CAAC,CAAC;CACzD,iBAAiB,KAAK,SAAS,KAAK,MAAM,KAAK,QAAQ,CAAC,CAAC;CACzD,aAAa,KAAK,SAAS,KAAK,OAAO,EAAE,SAAS,KAAK,OAAO,MAAM,CAAC,CAAC;CACtE,iBAAiB,KAAK,SAAS,KAAK,OAAO,EAAE,SAAS,KAAK,CAAC,CAAC;CAC9D,CAAC;;;;AA2JF,SAAgB,gBACd,WACA,MACwC;AAYxC,MAAK,MAAM,MAAM;EATf;EACA;EACA;EACA;EACA;EACA;EACA;EAG6B,CAC7B,KAAI,KAAK,SAAS,GAAG,CACnB,QAAO;EACL,SAAS;EACT,SAAS,UAAU,UAAU,mBAAmB;EACjD;AAIL,QAAO,EAAE,SAAS,MAAM"}
+{"version":3,"file":"safety.js","names":[],"sources":["../../../../src/agent/prompt/safety.ts"],"sourcesContent":["// Safety System - Quick safety check for file operations\n\n/**\n * Quick safety check for file operations\n */\nexport function checkFileSafety(\n  operation: 'read' | 'write' | 'delete',\n  path: string\n): { allowed: boolean; message?: string } {\n  // Check for sensitive paths\n  const sensitivePaths = [\n    '/etc/passwd',\n    '/etc/shadow',\n    '/root/.ssh',\n    '/home/*/.ssh',\n    '~/.aws',\n    '~/.bashrc',\n    '~/.profile',\n  ];\n\n  for (const sp of sensitivePaths) {\n    if (path.includes(sp)) {\n      return {\n        allowed: false,\n        message: `Cannot ${operation} sensitive path: ${path}`,\n      };\n    }\n  }\n\n  return { allowed: true };\n}\n\n"],"mappings":";;;;AAKA,SAAgB,gBACd,WACA,MACwC;AAYxC,MAAK,MAAM,MAAM;EATf;EACA;EACA;EACA;EACA;EACA;EACA;EAG6B,CAC7B,KAAI,KAAK,SAAS,GAAG,CACnB,QAAO;EACL,SAAS;EACT,SAAS,UAAU,UAAU,mBAAmB;EACjD;AAIL,QAAO,EAAE,SAAS,MAAM"}

package/dist/src/agent/prompt/sanitize-for-prompt.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Sanitize untrusted strings before embedding them into an LLM prompt.
+ *
+ * Strips control/format characters that could break prompt structure or inject instructions.
+ */
+export declare function sanitizeForPromptLiteral(value: string): string;