@xopcai/xopc 0.0.99 → 0.0.100

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":"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"}
+{"version":3,"file":"agent-orchestrator.js","names":[],"sources":["../../../../src/agent/orchestration/agent-orchestrator.ts"],"sourcesContent":["/**\n * Agent Orchestrator - Coordinates Agent execution flow\n *\n * Manages the complete agent execution pipeline from message processing\n * to response generation.\n */\n\nimport type { 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;

package/dist/src/agent/prompt/sanitize-for-prompt.js

@@ -0,0 +1,13 @@
+//#region src/agent/prompt/sanitize-for-prompt.ts
+/**
+* Sanitize untrusted strings before embedding them into an LLM prompt.
+*
+* Strips control/format characters that could break prompt structure or inject instructions.
+*/
+function sanitizeForPromptLiteral(value) {
+	return value.replace(/[\p{Cc}\p{Cf}\u2028\u2029]/gu, "");
+}
+//#endregion
+export { sanitizeForPromptLiteral };
+
+//# sourceMappingURL=sanitize-for-prompt.js.map

package/dist/src/agent/prompt/sanitize-for-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize-for-prompt.js","names":[],"sources":["../../../../src/agent/prompt/sanitize-for-prompt.ts"],"sourcesContent":["/**\n * Sanitize untrusted strings before embedding them into an LLM prompt.\n *\n * Strips control/format characters that could break prompt structure or inject instructions.\n */\nexport function sanitizeForPromptLiteral(value: string): string {\n  return value.replace(/[\\p{Cc}\\p{Cf}\\u2028\\u2029]/gu, '');\n}\n"],"mappings":";;;;;;AAKA,SAAgB,yBAAyB,OAAuB;AAC9D,QAAO,MAAM,QAAQ,gCAAgC,GAAG"}

package/dist/src/agent/prompt/sections/behavior.d.ts

@@ -0,0 +1,5 @@
+export declare function buildToolCallStyleSection(): string;
+export declare function buildExecutionBiasSection(): string;
+export declare function buildProblemSolvingSection(): string;
+export declare function buildAestheticSection(): string;
+export declare function buildSafetySection(): string;

package/dist/src/agent/prompt/sections/behavior.js

@@ -0,0 +1,50 @@
+//#region src/agent/prompt/sections/behavior.ts
+function buildToolCallStyleSection() {
+	return [
+		"## Tool Call Style",
+		"Default: do not narrate routine, low-risk tool calls (just call the tool).",
+		"Narrate only when it helps: multi-step work, complex/challenging problems, sensitive actions (e.g., deletions), or when the user explicitly asks.",
+		"Keep narration brief and value-dense; avoid repeating obvious steps.",
+		"Use plain human language for narration unless in a technical context.",
+		"When a first-class tool exists for an action, use the tool directly instead of asking the user to run equivalent CLI commands."
+	].join("\n");
+}
+function buildExecutionBiasSection() {
+	return [
+		"## Execution Bias",
+		"- Actionable request: act in this turn.",
+		"- Non-final turn: use tools to advance, or ask for the one missing decision that blocks safe progress.",
+		"- Continue until done or genuinely blocked; do not finish with a plan/promise when tools can move it forward.",
+		"- Weak/empty tool result: vary query, path, command, or source before concluding.",
+		"- Mutable facts need live checks: files, git, clocks, versions, services, processes, package state.",
+		"- Final answer needs evidence: test/build/lint, screenshot, inspection, tool output, or a named blocker.",
+		"- Longer work: brief progress update, then keep going; use delegation or workflows when they fit."
+	].join("\n");
+}
+function buildProblemSolvingSection() {
+	return [
+		"## Problem Solving",
+		"**Simple tasks** (< 5 minutes or a single-file change): Do them directly; run a quick verification after changes.",
+		"**Complex tasks** (multiple files or design decisions): Use an iterative flow — Plan → Build → Verify → Fix.",
+		"**Core principle: Match the complexity; reject ritual for its own sake. Verification matters, but do not verify just to tick a box.**"
+	].join("\n");
+}
+function buildAestheticSection() {
+	return [
+		"## Tone & Style",
+		"**Default voice:** Direct, concise, concrete.",
+		"**SOUL.md takes precedence:** If SOUL.md defines a specific tone, defer to it over the above."
+	].join("\n");
+}
+function buildSafetySection() {
+	return [
+		"## Safety",
+		"- You have no independent goals: do not pursue self-preservation, replication, resource acquisition, or power-seeking; avoid long-term plans beyond the user's request.",
+		"- Prioritize safety and human oversight over completion; if instructions conflict, pause and ask; comply with stop/pause/audit requests and never bypass safeguards.",
+		"- Do not manipulate or persuade anyone to expand access or disable safeguards. Do not copy yourself or change system prompts, safety rules, or tool policies unless explicitly requested."
+	].join("\n");
+}
+//#endregion
+export { buildAestheticSection, buildExecutionBiasSection, buildProblemSolvingSection, buildSafetySection, buildToolCallStyleSection };
+
+//# sourceMappingURL=behavior.js.map

package/dist/src/agent/prompt/sections/behavior.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"behavior.js","names":[],"sources":["../../../../../src/agent/prompt/sections/behavior.ts"],"sourcesContent":["export function buildToolCallStyleSection(): string {\n  return [\n    '## Tool Call Style',\n    'Default: do not narrate routine, low-risk tool calls (just call the tool).',\n    'Narrate only when it helps: multi-step work, complex/challenging problems, sensitive actions (e.g., deletions), or when the user explicitly asks.',\n    'Keep narration brief and value-dense; avoid repeating obvious steps.',\n    'Use plain human language for narration unless in a technical context.',\n    'When a first-class tool exists for an action, use the tool directly instead of asking the user to run equivalent CLI commands.',\n  ].join('\\n');\n}\n\nexport function buildExecutionBiasSection(): string {\n  return [\n    '## Execution Bias',\n    '- Actionable request: act in this turn.',\n    '- Non-final turn: use tools to advance, or ask for the one missing decision that blocks safe progress.',\n    '- Continue until done or genuinely blocked; do not finish with a plan/promise when tools can move it forward.',\n    '- Weak/empty tool result: vary query, path, command, or source before concluding.',\n    '- Mutable facts need live checks: files, git, clocks, versions, services, processes, package state.',\n    '- Final answer needs evidence: test/build/lint, screenshot, inspection, tool output, or a named blocker.',\n    '- Longer work: brief progress update, then keep going; use delegation or workflows when they fit.',\n  ].join('\\n');\n}\n\nexport function buildProblemSolvingSection(): string {\n  return [\n    '## Problem Solving',\n    '**Simple tasks** (< 5 minutes or a single-file change): Do them directly; run a quick verification after changes.',\n    '**Complex tasks** (multiple files or design decisions): Use an iterative flow — Plan → Build → Verify → Fix.',\n    '**Core principle: Match the complexity; reject ritual for its own sake. Verification matters, but do not verify just to tick a box.**',\n  ].join('\\n');\n}\n\nexport function buildAestheticSection(): string {\n  return [\n    '## Tone & Style',\n    '**Default voice:** Direct, concise, concrete.',\n    '**SOUL.md takes precedence:** If SOUL.md defines a specific tone, defer to it over the above.',\n  ].join('\\n');\n}\n\nexport function buildSafetySection(): string {\n  return [\n    '## Safety',\n    '- You have no independent goals: do not pursue self-preservation, replication, resource acquisition, or power-seeking; avoid long-term plans beyond the user\\'s request.',\n    '- Prioritize safety and human oversight over completion; if instructions conflict, pause and ask; comply with stop/pause/audit requests and never bypass safeguards.',\n    '- Do not manipulate or persuade anyone to expand access or disable safeguards. Do not copy yourself or change system prompts, safety rules, or tool policies unless explicitly requested.',\n  ].join('\\n');\n}\n"],"mappings":";AAAA,SAAgB,4BAAoC;AAClD,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,4BAAoC;AAClD,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,6BAAqC;AACnD,QAAO;EACL;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,wBAAgC;AAC9C,QAAO;EACL;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,qBAA6B;AAC3C,QAAO;EACL;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK"}

package/dist/src/agent/prompt/sections/memory-skills.d.ts

@@ -0,0 +1,9 @@
+import type { MemoryCitationsMode } from '../types.js';
+export declare function buildMemorySection(params: {
+    availableTools: Set<string>;
+    citationsMode?: MemoryCitationsMode;
+    hasProfileMemory?: boolean;
+    includeMemorySection?: boolean;
+}): string;
+export declare function buildExternalMemorySection(text: string | undefined): string;
+export declare function buildSkillsSection(hasSkillTools: boolean): string;

package/dist/src/agent/prompt/sections/memory-skills.js

@@ -0,0 +1,59 @@
+//#region src/agent/prompt/sections/memory-skills.ts
+function buildMemorySection(params) {
+	if (params.includeMemorySection === false) return "";
+	if (!(params.availableTools.has("memory_search") || params.availableTools.has("memory_get") || params.availableTools.has("curated_memory")) && !params.hasProfileMemory) return "";
+	const citationsMode = params.citationsMode ?? "on";
+	const citationInstruction = citationsMode === "off" ? "Citations are disabled: do not mention file paths or line numbers in replies." : citationsMode === "source-only" ? "Citations: mention file path when it helps (e.g., Source: MEMORY.md)." : "Citations: include Source: <path#line> when it helps the user verify memory snippets.";
+	const toolLines = [];
+	if (params.availableTools.has("memory_search")) toolLines.push("1. Run `memory_search` on profile MEMORY.md and workspace `memory/*.md`");
+	if (params.availableTools.has("session_search")) toolLines.push(`${toolLines.length + 1}. For **other chat sessions** / cross-session history, use \`session_search\` with keywords (or omit \`query\` to list recent sessions)`);
+	if (params.availableTools.has("memory_get")) toolLines.push(`${toolLines.length + 1}. Use \`memory_get\` to pull only the needed lines from files`);
+	if (params.availableTools.has("curated_memory")) toolLines.push(`${toolLines.length + 1}. For structured curated notes under agent home \`memories/\`, use \`curated_memory\``);
+	toolLines.push(`${toolLines.length + 1}. If low confidence after search, say you checked`);
+	return [
+		"## Memory Recall",
+		"",
+		citationInstruction,
+		"",
+		"Startup profile files (SOUL, USER, MEMORY, etc.) are already in Project Context above when injected. Do not re-read them unless the user asks or you need lines beyond what was injected.",
+		"",
+		"Before answering anything about prior work, decisions, dates, people, preferences, or todos:",
+		...toolLines,
+		"",
+		"### Memory Files",
+		"",
+		"- **Daily notes:** `memory/YYYY-MM-DD.md` — raw logs (runtime may preload recent days on /new or reset)",
+		"- **Long-term:** profile `MEMORY.md` — curated memories in Project Context when present",
+		"- **Curated store:** agent home `memories/MEMORY.md` and `memories/USER.md` — use `curated_memory` for live read/write",
+		"",
+		"### Writing to Memory",
+		"",
+		"- **Declarative vs procedural:** Save facts and preferences via workspace memory files and/or `curated_memory`. Save reusable task playbooks with `skill_manage` as skills.",
+		"- **Memory is limited** — if you want to remember something, WRITE IT TO A FILE",
+		"- When someone says \"remember this\" → update `memory/YYYY-MM-DD.md` or relevant file",
+		"- **Text > Brain**"
+	].join("\n");
+}
+function buildExternalMemorySection(text) {
+	const t = text?.trim();
+	if (!t) return "";
+	return `## External memory provider\n\n${t}`;
+}
+function buildSkillsSection(hasSkillTools) {
+	if (!hasSkillTools) return "";
+	return [
+		"## Skills (mandatory)",
+		"Before replying: scan <available_skills> <description> entries.",
+		"- If exactly one skill clearly applies: use `skill_view(name)` to load its SKILL.md, then follow it.",
+		"- If multiple could apply: choose the most specific one, then load/follow it.",
+		"- If none clearly apply: do not load any SKILL.md.",
+		"Constraints: never load more than one skill up front; only load after selecting.",
+		"- When a skill drives external API writes, assume rate limits: prefer fewer larger writes, avoid tight one-item loops, serialize bursts when possible, and respect 429/Retry-After.",
+		"",
+		"**Division of labor with memory:** Skills = **procedural** workflows; memory / `curated_memory` = **declarative** facts and preferences."
+	].join("\n");
+}
+//#endregion
+export { buildExternalMemorySection, buildMemorySection, buildSkillsSection };
+
+//# sourceMappingURL=memory-skills.js.map

package/dist/src/agent/prompt/sections/memory-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-skills.js","names":[],"sources":["../../../../../src/agent/prompt/sections/memory-skills.ts"],"sourcesContent":["import type { MemoryCitationsMode } from '../types.js';\n\nexport function buildMemorySection(params: {\n  availableTools: Set<string>;\n  citationsMode?: MemoryCitationsMode;\n  hasProfileMemory?: boolean;\n  includeMemorySection?: boolean;\n}): string {\n  if (params.includeMemorySection === false) {\n    return '';\n  }\n  const hasMemoryTools =\n    params.availableTools.has('memory_search') ||\n    params.availableTools.has('memory_get') ||\n    params.availableTools.has('curated_memory');\n  if (!hasMemoryTools && !params.hasProfileMemory) {\n    return '';\n  }\n\n  const citationsMode = params.citationsMode ?? 'on';\n  const citationInstruction =\n    citationsMode === 'off'\n      ? 'Citations are disabled: do not mention file paths or line numbers in replies.'\n      : citationsMode === 'source-only'\n        ? 'Citations: mention file path when it helps (e.g., Source: MEMORY.md).'\n        : 'Citations: include Source: <path#line> when it helps the user verify memory snippets.';\n\n  const toolLines: string[] = [];\n  if (params.availableTools.has('memory_search')) {\n    toolLines.push('1. Run `memory_search` on profile MEMORY.md and workspace `memory/*.md`');\n  }\n  if (params.availableTools.has('session_search')) {\n    toolLines.push(\n      `${toolLines.length + 1}. For **other chat sessions** / cross-session history, use \\`session_search\\` with keywords (or omit \\`query\\` to list recent sessions)`,\n    );\n  }\n  if (params.availableTools.has('memory_get')) {\n    toolLines.push(`${toolLines.length + 1}. Use \\`memory_get\\` to pull only the needed lines from files`);\n  }\n  if (params.availableTools.has('curated_memory')) {\n    toolLines.push(\n      `${toolLines.length + 1}. For structured curated notes under agent home \\`memories/\\`, use \\`curated_memory\\``,\n    );\n  }\n  toolLines.push(`${toolLines.length + 1}. If low confidence after search, say you checked`);\n\n  return [\n    '## Memory Recall',\n    '',\n    citationInstruction,\n    '',\n    'Startup profile files (SOUL, USER, MEMORY, etc.) are already in Project Context above when injected. Do not re-read them unless the user asks or you need lines beyond what was injected.',\n    '',\n    'Before answering anything about prior work, decisions, dates, people, preferences, or todos:',\n    ...toolLines,\n    '',\n    '### Memory Files',\n    '',\n    '- **Daily notes:** `memory/YYYY-MM-DD.md` — raw logs (runtime may preload recent days on /new or reset)',\n    '- **Long-term:** profile `MEMORY.md` — curated memories in Project Context when present',\n    '- **Curated store:** agent home `memories/MEMORY.md` and `memories/USER.md` — use `curated_memory` for live read/write',\n    '',\n    '### Writing to Memory',\n    '',\n    '- **Declarative vs procedural:** Save facts and preferences via workspace memory files and/or `curated_memory`. Save reusable task playbooks with `skill_manage` as skills.',\n    '- **Memory is limited** — if you want to remember something, WRITE IT TO A FILE',\n    '- When someone says \"remember this\" → update `memory/YYYY-MM-DD.md` or relevant file',\n    '- **Text > Brain**',\n  ].join('\\n');\n}\n\nexport function buildExternalMemorySection(text: string | undefined): string {\n  const t = text?.trim();\n  if (!t) {\n    return '';\n  }\n  return `## External memory provider\\n\\n${t}`;\n}\n\nexport function buildSkillsSection(hasSkillTools: boolean): string {\n  if (!hasSkillTools) {\n    return '';\n  }\n\n  return [\n    '## Skills (mandatory)',\n    'Before replying: scan <available_skills> <description> entries.',\n    '- If exactly one skill clearly applies: use `skill_view(name)` to load its SKILL.md, then follow it.',\n    '- If multiple could apply: choose the most specific one, then load/follow it.',\n    '- If none clearly apply: do not load any SKILL.md.',\n    'Constraints: never load more than one skill up front; only load after selecting.',\n    '- When a skill drives external API writes, assume rate limits: prefer fewer larger writes, avoid tight one-item loops, serialize bursts when possible, and respect 429/Retry-After.',\n    '',\n    '**Division of labor with memory:** Skills = **procedural** workflows; memory / `curated_memory` = **declarative** facts and preferences.',\n  ].join('\\n');\n}\n"],"mappings":";AAEA,SAAgB,mBAAmB,QAKxB;AACT,KAAI,OAAO,yBAAyB,MAClC,QAAO;AAMT,KAAI,EAHF,OAAO,eAAe,IAAI,gBAAgB,IAC1C,OAAO,eAAe,IAAI,aAAa,IACvC,OAAO,eAAe,IAAI,iBAAiB,KACtB,CAAC,OAAO,iBAC7B,QAAO;CAGT,MAAM,gBAAgB,OAAO,iBAAiB;CAC9C,MAAM,sBACJ,kBAAkB,QACd,kFACA,kBAAkB,gBAChB,0EACA;CAER,MAAM,YAAsB,EAAE;AAC9B,KAAI,OAAO,eAAe,IAAI,gBAAgB,CAC5C,WAAU,KAAK,0EAA0E;AAE3F,KAAI,OAAO,eAAe,IAAI,iBAAiB,CAC7C,WAAU,KACR,GAAG,UAAU,SAAS,EAAE,yIACzB;AAEH,KAAI,OAAO,eAAe,IAAI,aAAa,CACzC,WAAU,KAAK,GAAG,UAAU,SAAS,EAAE,+DAA+D;AAExG,KAAI,OAAO,eAAe,IAAI,iBAAiB,CAC7C,WAAU,KACR,GAAG,UAAU,SAAS,EAAE,uFACzB;AAEH,WAAU,KAAK,GAAG,UAAU,SAAS,EAAE,mDAAmD;AAE1F,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA,GAAG;EACH;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,2BAA2B,MAAkC;CAC3E,MAAM,IAAI,MAAM,MAAM;AACtB,KAAI,CAAC,EACH,QAAO;AAET,QAAO,kCAAkC;;AAG3C,SAAgB,mBAAmB,eAAgC;AACjE,KAAI,CAAC,cACH,QAAO;AAGT,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK"}

package/dist/src/agent/prompt/sections/messaging-runtime.d.ts

@@ -0,0 +1,16 @@
+export declare function buildMessagingSection(params: {
+    channels: string[];
+    isMinimal: boolean;
+    hasSendMessage: boolean;
+}): string;
+export declare function buildSilentRepliesSection(params: {
+    isMinimal: boolean;
+    silentReplyPromptMode?: 'generic' | 'none';
+}): string;
+export declare function buildOutputDirectivesSection(isMinimal: boolean): string;
+export declare function buildTimeSection(timezone?: string): string;
+export declare function buildHeartbeatBehaviorSection(params: {
+    enabled: boolean;
+    customPrompt?: string;
+    userTimezone?: string;
+}): string;

package/dist/src/agent/prompt/sections/messaging-runtime.js

@@ -0,0 +1,69 @@
+import { NO_REPLY } from "../../../heartbeat/tokens.js";
+//#region src/agent/prompt/sections/messaging-runtime.ts
+function buildMessagingSection(params) {
+	if (params.isMinimal || params.channels.length === 0) return "";
+	const channelList = params.channels.join(", ");
+	const messageToolLine = params.hasSendMessage ? `- Use \`send_message\` for proactive sends + channel actions` : "- Outbound messaging tools are not available in this session";
+	return [
+		"## Messaging",
+		`- Reply in current session → automatically routes to the source channel (${channelList})`,
+		messageToolLine,
+		`- If you use \`send_message\` to deliver your user-visible reply, respond with ONLY: ${NO_REPLY} (avoid duplicate replies)`
+	].join("\n");
+}
+function buildSilentRepliesSection(params) {
+	if (params.isMinimal || params.silentReplyPromptMode === "none") return "";
+	return [
+		"## Silent Replies",
+		`When you have nothing to say, respond with ONLY: ${NO_REPLY}`,
+		"",
+		"Rules:",
+		"- It must be your ENTIRE message — nothing else",
+		`- Never append it to an actual response (never include "${NO_REPLY}" in real replies)`,
+		"- Never wrap it in markdown or code blocks",
+		"",
+		`Wrong: "Here's help... ${NO_REPLY}"`,
+		`Right: ${NO_REPLY}`
+	].join("\n");
+}
+function buildOutputDirectivesSection(isMinimal) {
+	if (isMinimal) return "";
+	return [
+		"## Assistant Output Directives",
+		"Use these when you need delivery metadata in an assistant message:",
+		"- `MEDIA:<path-or-url>` on its own line requests attachment delivery. Supported clients strip MEDIA lines and render attachments inline; channels still decide actual delivery behavior.",
+		"- `[[audio_as_voice]]` marks attached audio as a voice-note style delivery hint when supported.",
+		"- To request a native reply/quote on supported surfaces, include one reply tag in your reply:",
+		"- Reply tags must be the very first token in the message (no leading text/newlines): [[reply_to_current]] your reply.",
+		"- [[reply_to_current]] replies to the triggering message.",
+		"- Prefer [[reply_to_current]]. Use [[reply_to:<id>]] only when an id was explicitly provided.",
+		"Supported tags are stripped before user-visible rendering; support still depends on the current channel config."
+	].join("\n");
+}
+function buildTimeSection(timezone) {
+	if (!timezone) return "";
+	return [
+		"## Current Date & Time",
+		`Time zone: ${timezone}`,
+		"",
+		"If you need the current date/time/day-of-week, use the `session_status` tool or the inbound message timestamp envelope (when present)."
+	].join("\n");
+}
+function buildHeartbeatBehaviorSection(params) {
+	if (!params.enabled) return "";
+	if (params.customPrompt?.trim()) return `## Heartbeats\n\n${params.customPrompt.trim()}`;
+	let quietHoursNote = "";
+	if (params.userTimezone) quietHoursNote = `\n\n> Quiet hours: The user is in **${params.userTimezone}**. Avoid proactive checks during late night (23:00-08:00) unless urgent.`;
+	return [
+		"## Heartbeats",
+		"",
+		"If the current user message is a heartbeat poll and nothing needs attention, reply exactly: HEARTBEAT_OK",
+		"",
+		"If something needs attention, do NOT include \"HEARTBEAT_OK\"; reply with the alert text instead.",
+		quietHoursNote.trim()
+	].filter(Boolean).join("\n");
+}
+//#endregion
+export { buildHeartbeatBehaviorSection, buildMessagingSection, buildOutputDirectivesSection, buildSilentRepliesSection, buildTimeSection };
+
+//# sourceMappingURL=messaging-runtime.js.map

package/dist/src/agent/prompt/sections/messaging-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging-runtime.js","names":[],"sources":["../../../../../src/agent/prompt/sections/messaging-runtime.ts"],"sourcesContent":["import { NO_REPLY } from '../../../heartbeat/tokens.js';\n\nexport function buildMessagingSection(params: {\n  channels: string[];\n  isMinimal: boolean;\n  hasSendMessage: boolean;\n}): string {\n  if (params.isMinimal || params.channels.length === 0) {\n    return '';\n  }\n  const channelList = params.channels.join(', ');\n  const messageToolLine = params.hasSendMessage\n    ? `- Use \\`send_message\\` for proactive sends + channel actions`\n    : '- Outbound messaging tools are not available in this session';\n\n  return [\n    '## Messaging',\n    `- Reply in current session → automatically routes to the source channel (${channelList})`,\n    messageToolLine,\n    `- If you use \\`send_message\\` to deliver your user-visible reply, respond with ONLY: ${NO_REPLY} (avoid duplicate replies)`,\n  ].join('\\n');\n}\n\nexport function buildSilentRepliesSection(params: {\n  isMinimal: boolean;\n  silentReplyPromptMode?: 'generic' | 'none';\n}): string {\n  if (params.isMinimal || params.silentReplyPromptMode === 'none') {\n    return '';\n  }\n  return [\n    '## Silent Replies',\n    `When you have nothing to say, respond with ONLY: ${NO_REPLY}`,\n    '',\n    'Rules:',\n    '- It must be your ENTIRE message — nothing else',\n    `- Never append it to an actual response (never include \"${NO_REPLY}\" in real replies)`,\n    '- Never wrap it in markdown or code blocks',\n    '',\n    `Wrong: \"Here's help... ${NO_REPLY}\"`,\n    `Right: ${NO_REPLY}`,\n  ].join('\\n');\n}\n\nexport function buildOutputDirectivesSection(isMinimal: boolean): string {\n  if (isMinimal) {\n    return '';\n  }\n  return [\n    '## Assistant Output Directives',\n    'Use these when you need delivery metadata in an assistant message:',\n    '- `MEDIA:<path-or-url>` on its own line requests attachment delivery. Supported clients strip MEDIA lines and render attachments inline; channels still decide actual delivery behavior.',\n    '- `[[audio_as_voice]]` marks attached audio as a voice-note style delivery hint when supported.',\n    '- To request a native reply/quote on supported surfaces, include one reply tag in your reply:',\n    '- Reply tags must be the very first token in the message (no leading text/newlines): [[reply_to_current]] your reply.',\n    '- [[reply_to_current]] replies to the triggering message.',\n    '- Prefer [[reply_to_current]]. Use [[reply_to:<id>]] only when an id was explicitly provided.',\n    'Supported tags are stripped before user-visible rendering; support still depends on the current channel config.',\n  ].join('\\n');\n}\n\nexport function buildTimeSection(timezone?: string): string {\n  if (!timezone) {\n    return '';\n  }\n  return [\n    '## Current Date & Time',\n    `Time zone: ${timezone}`,\n    '',\n    'If you need the current date/time/day-of-week, use the `session_status` tool or the inbound message timestamp envelope (when present).',\n  ].join('\\n');\n}\n\nexport function buildHeartbeatBehaviorSection(params: {\n  enabled: boolean;\n  customPrompt?: string;\n  userTimezone?: string;\n}): string {\n  if (!params.enabled) {\n    return '';\n  }\n  if (params.customPrompt?.trim()) {\n    return `## Heartbeats\\n\\n${params.customPrompt.trim()}`;\n  }\n  let quietHoursNote = '';\n  if (params.userTimezone) {\n    quietHoursNote = `\\n\\n> Quiet hours: The user is in **${params.userTimezone}**. Avoid proactive checks during late night (23:00-08:00) unless urgent.`;\n  }\n  return [\n    '## Heartbeats',\n    '',\n    'If the current user message is a heartbeat poll and nothing needs attention, reply exactly: HEARTBEAT_OK',\n    '',\n    'If something needs attention, do NOT include \"HEARTBEAT_OK\"; reply with the alert text instead.',\n    quietHoursNote.trim(),\n  ]\n    .filter(Boolean)\n    .join('\\n');\n}\n"],"mappings":";;AAEA,SAAgB,sBAAsB,QAI3B;AACT,KAAI,OAAO,aAAa,OAAO,SAAS,WAAW,EACjD,QAAO;CAET,MAAM,cAAc,OAAO,SAAS,KAAK,KAAK;CAC9C,MAAM,kBAAkB,OAAO,iBAC3B,iEACA;AAEJ,QAAO;EACL;EACA,4EAA4E,YAAY;EACxF;EACA,wFAAwF,SAAS;EAClG,CAAC,KAAK,KAAK;;AAGd,SAAgB,0BAA0B,QAG/B;AACT,KAAI,OAAO,aAAa,OAAO,0BAA0B,OACvD,QAAO;AAET,QAAO;EACL;EACA,oDAAoD;EACpD;EACA;EACA;EACA,2DAA2D,SAAS;EACpE;EACA;EACA,0BAA0B,SAAS;EACnC,UAAU;EACX,CAAC,KAAK,KAAK;;AAGd,SAAgB,6BAA6B,WAA4B;AACvE,KAAI,UACF,QAAO;AAET,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,iBAAiB,UAA2B;AAC1D,KAAI,CAAC,SACH,QAAO;AAET,QAAO;EACL;EACA,cAAc;EACd;EACA;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,8BAA8B,QAInC;AACT,KAAI,CAAC,OAAO,QACV,QAAO;AAET,KAAI,OAAO,cAAc,MAAM,CAC7B,QAAO,oBAAoB,OAAO,aAAa,MAAM;CAEvD,IAAI,iBAAiB;AACrB,KAAI,OAAO,aACT,kBAAiB,uCAAuC,OAAO,aAAa;AAE9E,QAAO;EACL;EACA;EACA;EACA;EACA;EACA,eAAe,MAAM;EACtB,CACE,OAAO,QAAQ,CACf,KAAK,KAAK"}

package/dist/src/agent/prompt/sections/project-context.d.ts

@@ -0,0 +1,16 @@
+import type { EmbeddedContextFile } from '../../bootstrap/types.js';
+export declare const CONTEXT_FILE_ORDER: Map<string, number>;
+export declare const DYNAMIC_CONTEXT_FILE_BASENAMES: Set<string>;
+export declare const DEFAULT_HEARTBEAT_PROMPT_CONTEXT_BLOCK = "Default heartbeat prompt:\n`Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.`";
+export declare function normalizeContextFilePath(pathValue: string): string;
+export declare function getContextFileBasename(pathValue: string): string;
+export declare function isDynamicContextFile(pathValue: string): boolean;
+export declare function sanitizeContextFileContentForPrompt(content: string): string;
+export declare function sortContextFilesForPrompt(contextFiles: EmbeddedContextFile[]): EmbeddedContextFile[];
+export declare function buildProjectContextSection(params: {
+    files: EmbeddedContextFile[];
+    heading: string;
+    dynamic: boolean;
+}): string[];
+/** Whether HEARTBEAT.md is injected as dynamic context (vs behavior-only section). */
+export declare function isHeartbeatContextFile(pathValue: string): boolean;