@xopcai/xopc 0.0.82 → 0.0.83

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

@@ -0,0 +1,138 @@
+import { queueEmbeddedSteer } from "../embedded/runs.js";
+import { buildDirectUserMessageContent } from "../service/build-direct-message-content.js";
+import { runProcessDirectStreaming } from "../service/process-direct-streaming.js";
+import { runProcessDirect } from "../service/process-direct-one-shot.js";
+import { maybeEmitWebchatTts } from "../service/webchat-tts.js";
+//#region src/agent/inbound/turn-dispatcher.ts
+var TurnDispatcher = class {
+	cfg;
+	log;
+	constructor(cfg) {
+		this.cfg = cfg;
+		this.log = cfg.log;
+	}
+	/** One-shot direct turn (CLI / embedded TUI). */
+	processDirect(content, sessionKey = "cli:direct", attachments, thinking) {
+		return runProcessDirect(this.buildOneShotDeps(), {
+			content,
+			sessionKey,
+			attachments,
+			thinking
+		});
+	}
+	/** Streaming direct turn (webchat SSE / CLI streaming). */
+	async *processDirectStreaming(content, sessionKey = "cli:direct", attachments, thinking, options) {
+		yield* runProcessDirectStreaming(this.buildStreamingDeps(), {
+			content,
+			sessionKey,
+			attachments,
+			thinking,
+			signal: options?.signal
+		});
+	}
+	/** Push an out-of-band event into the live webchat stream for a session. */
+	enqueueWebchatSseEvent(sessionKey, event) {
+		const pub = this.cfg.sessionState.getWebchatPublisher(sessionKey);
+		if (pub) pub(event);
+	}
+	/** Stream assistant text to live webchat session + notify transcript listeners. */
+	notifyWebchatTranscriptAppend(sessionKey, assistantText) {
+		const trimmed = assistantText.trim();
+		if (trimmed) this.enqueueWebchatSseEvent(sessionKey, {
+			type: "token",
+			content: trimmed
+		});
+		this.cfg.onSessionTranscriptUpdated?.(sessionKey);
+	}
+	/**
+	* Queue a steering user message into pi-agent's in-flight run (delivered
+	* after current tool work, before the next LLM call). See `Agent.steer`
+	* in `@earendil-works/pi-agent-core`.
+	*/
+	async steerWebchatSession(sessionKey, text) {
+		const trimmed = text.trim();
+		if (!trimmed) return false;
+		try {
+			return await queueEmbeddedSteer(sessionKey, trimmed);
+		} catch (err) {
+			this.log.warn({
+				err,
+				sessionKey
+			}, "steerWebchatSession failed");
+			return false;
+		}
+	}
+	buildStreamingDeps() {
+		const c = this.cfg;
+		return {
+			log: this.log,
+			parseSessionKey: c.parseSessionKey,
+			initDirectStreamingSession: c.initSessionContext,
+			registerWebchatSsePublisher: (sk, publisher) => c.sessionState.registerWebchatPublisher(sk, publisher),
+			unregisterWebchatSsePublisher: (sk) => c.sessionState.unregisterWebchatPublisher(sk),
+			agentManager: c.agentManager,
+			hydrateSessionWorkspaceFromStore: (sk) => c.sessionHydrator.workspace(sk),
+			hydrateSessionModelFromStore: (sk) => c.sessionHydrator.model(sk),
+			sessionStore: c.sessionStore,
+			modelManager: c.modelManager,
+			applyResolvedThinkingLevel: (sk, t) => c.sessionHydrator.thinking(sk, t),
+			getConfig: c.getConfig,
+			sessionConfigStore: c.sessionConfigStore,
+			attachmentRootsForSession: c.attachmentRootsForSession,
+			commandHandler: c.commandHandler,
+			prepareInboundAttachments: c.prepareInboundAttachments,
+			buildMessageContent: (text, prepared, sk) => buildDirectUserMessageContent({
+				content: text,
+				attachments: prepared,
+				sessionKey: sk,
+				config: c.requireConfig(),
+				agentManager: c.agentManager,
+				modelManager: c.modelManager
+			}),
+			recordPersistentGoalStreamOutcome: (sk, o) => c.sessionState.recordPersistentGoalStreamOutcome(sk, o),
+			onTurnComplete: (sk, text) => {
+				if (text) c.sessionState.setLastAssistantText(sk, text);
+				c.enqueueMaybeAutoTitleAfterPersist(sk);
+			},
+			reloadWebchatTranscript: (sk) => {
+				c.onSessionTranscriptUpdated?.(sk);
+			},
+			maybeEmitWebchatTts: (sk, hadVoice) => maybeEmitWebchatTts({
+				config: c.getConfig(),
+				agentManager: c.agentManager,
+				sessionStore: c.sessionStore,
+				log: this.log
+			}, sk, hadVoice),
+			endDirectRequestContext: c.endDirectRequestContext
+		};
+	}
+	buildOneShotDeps() {
+		const c = this.cfg;
+		const cfg = c.requireConfig();
+		return {
+			log: this.log,
+			config: cfg,
+			parseSessionKey: c.parseSessionKey,
+			initSessionContext: (sk, channel, chatId) => {
+				c.initSessionContext(sk, channel, chatId);
+			},
+			hydrateSessionWorkspaceFromStore: (sk) => c.sessionHydrator.workspace(sk),
+			hydrateSessionModelFromStore: (sk) => c.sessionHydrator.model(sk),
+			agentManager: c.agentManager,
+			sessionStore: c.sessionStore,
+			modelManager: c.modelManager,
+			applyResolvedThinkingLevel: (sk, t) => c.sessionHydrator.thinking(sk, t),
+			prepareInboundAttachments: c.prepareInboundAttachments,
+			commandHandler: c.commandHandler,
+			onTurnComplete: (sk, text) => {
+				if (text) c.sessionState.setLastAssistantText(sk, text);
+				c.enqueueMaybeAutoTitleAfterPersist(sk);
+			},
+			endDirectRequestContext: c.endDirectRequestContext
+		};
+	}
+};
+//#endregion
+export { TurnDispatcher };
+
+//# sourceMappingURL=turn-dispatcher.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"turn-dispatcher.js","names":[],"sources":["../../../../src/agent/inbound/turn-dispatcher.ts"],"sourcesContent":["/**\n * TurnDispatcher — single entry point for direct (non-bus) agent turns.\n *\n * Wraps the two existing direct-turn runners (one-shot and streaming) so the\n * parent `AgentService` no longer carries a pair of huge `createXxxDeps()`\n * factories. The public surface — `processDirect`, `processDirectStreaming`,\n * `steerWebchatSession`, `enqueueWebchatSseEvent`,\n * `notifyWebchatTranscriptAppend` — matches what `AgentService` exposed\n * previously, so callers (gateway, CLI) are unchanged.\n *\n * Like `OutboundCoordinator` and `InboundLoop`, this class accepts a wide\n * dependency bag in its constructor (the direct-turn pipeline touches almost\n * every other subsystem). The win is that AgentService becomes the only place\n * that wires those dependencies together; individual responsibilities now live\n * in their own classes and are unit-testable.\n */\n\nimport type { Config } from '../../config/schema.js';\nimport type { ContextualLogger } from '../../utils/logger/types.js';\n\nimport type { AgentManager } from '../agent-manager.js';\nimport type { CommandHandler } from '../messaging/command-handler.js';\nimport type { ModelManager } from '../models/index.js';\nimport type { SessionConfigStore } from '../../session/index.js';\nimport type { SessionStore } from '../../session/store.js';\nimport type {\n  SessionContext,\n  SessionHydrator,\n  SessionStateBag,\n} from '../session/index.js';\nimport { queueEmbeddedSteer } from '../embedded/runs.js';\nimport type { InternalAttachmentRoots } from '../../channels/attachments/inbound-persist.js';\nimport {\n  buildDirectUserMessageContent,\n  type DirectInboundAttachment,\n} from '../service/build-direct-message-content.js';\nimport {\n  runProcessDirectStreaming,\n  type ProcessDirectStreamingDeps,\n  type ProcessDirectStreamingSseEvent,\n} from '../service/process-direct-streaming.js';\nimport {\n  runProcessDirect,\n  type RunProcessDirectDeps,\n} from '../service/process-direct-one-shot.js';\nimport { maybeEmitWebchatTts } from '../service/webchat-tts.js';\n\nexport interface TurnDispatcherConfig {\n  log: ContextualLogger;\n  agentManager: AgentManager;\n  sessionStore: SessionStore;\n  modelManager: ModelManager;\n  sessionConfigStore: SessionConfigStore;\n  sessionState: SessionStateBag;\n  commandHandler: CommandHandler;\n  getConfig: () => Config | undefined;\n  /** Strict accessor — required for direct-turn paths that must have a config. */\n  requireConfig: () => Config;\n  parseSessionKey: (sessionKey: string) => { channel: string; chatId: string };\n  /** Establish per-session context (also creates the Agent + subscribes to events). */\n  initSessionContext: (sessionKey: string, channel: string, chatId: string) => SessionContext;\n  /** Per-session config hydration: workspace, model, thinking. */\n  sessionHydrator: SessionHydrator;\n  attachmentRootsForSession: (sessionKey: string) => InternalAttachmentRoots;\n  prepareInboundAttachments: (\n    sessionKey: string,\n    attachments?: DirectInboundAttachment[],\n  ) => Promise<DirectInboundAttachment[] | undefined>;\n  enqueueMaybeAutoTitleAfterPersist: (sessionKey: string) => void;\n  endDirectRequestContext: () => void;\n  /** Gateway hook fired after assistant text lands on disk (UI refetch). */\n  onSessionTranscriptUpdated?: (sessionKey: string) => void;\n}\n\nexport type DirectAttachment = DirectInboundAttachment;\n\nexport class TurnDispatcher {\n  private readonly cfg: TurnDispatcherConfig;\n  private readonly log: ContextualLogger;\n\n  constructor(cfg: TurnDispatcherConfig) {\n    this.cfg = cfg;\n    this.log = cfg.log;\n  }\n\n  /** One-shot direct turn (CLI / embedded TUI). */\n  processDirect(\n    content: string,\n    sessionKey = 'cli:direct',\n    attachments?: DirectAttachment[],\n    thinking?: string,\n  ): Promise<string> {\n    return runProcessDirect(this.buildOneShotDeps(), {\n      content,\n      sessionKey,\n      attachments,\n      thinking,\n    });\n  }\n\n  /** Streaming direct turn (webchat SSE / CLI streaming). */\n  async *processDirectStreaming(\n    content: string,\n    sessionKey = 'cli:direct',\n    attachments?: DirectAttachment[],\n    thinking?: string,\n    options?: { signal?: AbortSignal },\n  ): AsyncGenerator<ProcessDirectStreamingSseEvent, void, unknown> {\n    yield* runProcessDirectStreaming(this.buildStreamingDeps(), {\n      content,\n      sessionKey,\n      attachments,\n      thinking,\n      signal: options?.signal,\n    });\n  }\n\n  /** Push an out-of-band event into the live webchat stream for a session. */\n  enqueueWebchatSseEvent(\n    sessionKey: string,\n    event: { type: string; [key: string]: unknown },\n  ): void {\n    const pub = this.cfg.sessionState.getWebchatPublisher(sessionKey);\n    if (pub) {\n      pub(event);\n    }\n  }\n\n  /** Stream assistant text to live webchat session + notify transcript listeners. */\n  notifyWebchatTranscriptAppend(sessionKey: string, assistantText: string): void {\n    const trimmed = assistantText.trim();\n    if (trimmed) {\n      this.enqueueWebchatSseEvent(sessionKey, { type: 'token', content: trimmed });\n    }\n    this.cfg.onSessionTranscriptUpdated?.(sessionKey);\n  }\n\n  /**\n   * Queue a steering user message into pi-agent's in-flight run (delivered\n   * after current tool work, before the next LLM call). See `Agent.steer`\n   * in `@earendil-works/pi-agent-core`.\n   */\n  async steerWebchatSession(sessionKey: string, text: string): Promise<boolean> {\n    const trimmed = text.trim();\n    if (!trimmed) return false;\n    try {\n      return await queueEmbeddedSteer(sessionKey, trimmed);\n    } catch (err) {\n      this.log.warn({ err, sessionKey }, 'steerWebchatSession failed');\n      return false;\n    }\n  }\n\n  private buildStreamingDeps(): ProcessDirectStreamingDeps {\n    const c = this.cfg;\n    return {\n      log: this.log,\n      parseSessionKey: c.parseSessionKey,\n      initDirectStreamingSession: c.initSessionContext,\n      registerWebchatSsePublisher: (sk, publisher) =>\n        c.sessionState.registerWebchatPublisher(sk, publisher),\n      unregisterWebchatSsePublisher: (sk) => c.sessionState.unregisterWebchatPublisher(sk),\n      agentManager: c.agentManager,\n      hydrateSessionWorkspaceFromStore: (sk) => c.sessionHydrator.workspace(sk),\n      hydrateSessionModelFromStore: (sk) => c.sessionHydrator.model(sk),\n      sessionStore: c.sessionStore,\n      modelManager: c.modelManager,\n      applyResolvedThinkingLevel: (sk, t) => c.sessionHydrator.thinking(sk, t),\n      getConfig: c.getConfig,\n      sessionConfigStore: c.sessionConfigStore,\n      attachmentRootsForSession: c.attachmentRootsForSession,\n      commandHandler: c.commandHandler,\n      prepareInboundAttachments: c.prepareInboundAttachments,\n      buildMessageContent: (text, prepared, sk) =>\n        buildDirectUserMessageContent({\n          content: text,\n          attachments: prepared,\n          sessionKey: sk,\n          config: c.requireConfig(),\n          agentManager: c.agentManager,\n          modelManager: c.modelManager,\n        }),\n      recordPersistentGoalStreamOutcome: (sk, o) =>\n        c.sessionState.recordPersistentGoalStreamOutcome(sk, o),\n      onTurnComplete: (sk, text) => {\n        if (text) {\n          c.sessionState.setLastAssistantText(sk, text);\n        }\n        c.enqueueMaybeAutoTitleAfterPersist(sk);\n      },\n      reloadWebchatTranscript: (sk) => {\n        c.onSessionTranscriptUpdated?.(sk);\n      },\n      maybeEmitWebchatTts: (sk, hadVoice) =>\n        maybeEmitWebchatTts(\n          {\n            config: c.getConfig(),\n            agentManager: c.agentManager,\n            sessionStore: c.sessionStore,\n            log: this.log,\n          },\n          sk,\n          hadVoice,\n        ),\n      endDirectRequestContext: c.endDirectRequestContext,\n    };\n  }\n\n  private buildOneShotDeps(): RunProcessDirectDeps {\n    const c = this.cfg;\n    const cfg = c.requireConfig();\n    return {\n      log: this.log,\n      config: cfg,\n      parseSessionKey: c.parseSessionKey,\n      initSessionContext: (sk, channel, chatId) => {\n        void c.initSessionContext(sk, channel, chatId);\n      },\n      hydrateSessionWorkspaceFromStore: (sk) => c.sessionHydrator.workspace(sk),\n      hydrateSessionModelFromStore: (sk) => c.sessionHydrator.model(sk),\n      agentManager: c.agentManager,\n      sessionStore: c.sessionStore,\n      modelManager: c.modelManager,\n      applyResolvedThinkingLevel: (sk, t) => c.sessionHydrator.thinking(sk, t),\n      prepareInboundAttachments: c.prepareInboundAttachments,\n      commandHandler: c.commandHandler,\n      onTurnComplete: (sk, text) => {\n        if (text) {\n          c.sessionState.setLastAssistantText(sk, text);\n        }\n        c.enqueueMaybeAutoTitleAfterPersist(sk);\n      },\n      endDirectRequestContext: c.endDirectRequestContext,\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/ipc/bus.js

@@ -1,6 +1,6 @@
-import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
 import { createResponseMessage, createSignalMessage, createTaskMessage } from "./types.js";
 import { AgentInbox } from "./inbox.js";
 //#region src/agent/ipc/bus.ts

package/dist/src/agent/ipc/inbox.js

@@ -1,10 +1,10 @@
+import { init_write_file_atomic, writeTextAtomic } from "../../infra/write-file-atomic.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_paths, resolveAgentDir } from "../../config/paths.js";
-import { init_write_file_atomic, writeTextAtomic } from "../../infra/write-file-atomic.js";
+import { mkdir, readFile, readdir, rename } from "fs/promises";
 import { join } from "path";
 import { existsSync, watch } from "fs";
-import { mkdir, readFile, readdir, rename } from "fs/promises";
 //#region src/agent/ipc/inbox.ts
 init_write_file_atomic();
 init_logger();

package/dist/src/agent/ipc/socket.js

@@ -2,8 +2,8 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_paths, resolveSocketPath } from "../../config/paths.js";
 import { isValidIPCMessage } from "./types.js";
-import { dirname } from "path";
 import { mkdir } from "fs/promises";
+import { dirname } from "path";
 import { Socket, createServer } from "net";
 //#region src/agent/ipc/socket.ts
 init_logger();

package/dist/src/agent/lifecycle/handlers/compaction.d.ts

@@ -1,4 +1,4 @@
-import type { AgentContext } from '../../service.js';
+import type { AgentContext } from '../../service.types.js';
 import type { LifecycleHandler, LifecycleEventData, LLMResponsePayload } from '../types.js';
 export interface CompactionHandlerConfig {
     minMessages: number;

package/dist/src/agent/lifecycle/handlers/compaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"compaction.js","names":[],"sources":["../../../../../src/agent/lifecycle/handlers/compaction.ts"],"sourcesContent":["import { createLogger } from '../../../utils/logger.js';\nimport type { AgentContext } from '../../service.js';\nimport type {\n  LifecycleHandler,\n  LifecycleEventData,\n  LLMResponsePayload,\n} from '../types.js';\n\nconst logger = createLogger('lifecycle-compaction');\n\nexport interface CompactionHandlerConfig {\n  minMessages: number;\n  maxTokens: number;\n  preserveReasoning: boolean;\n  accumulateUsage: boolean;\n}\n\nconst DEFAULT_CONFIG: CompactionHandlerConfig = {\n  minMessages: 20,\n  maxTokens: 8000,\n  preserveReasoning: true,\n  accumulateUsage: true,\n};\n\nexport class CompactionLifecycleHandler\n  implements LifecycleHandler<LLMResponsePayload>\n{\n  readonly name = 'CompactionLifecycleHandler';\n  private config: CompactionHandlerConfig;\n\n  constructor(config?: Partial<CompactionHandlerConfig>) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n  }\n\n  async handle(\n    event: LifecycleEventData<LLMResponsePayload>,\n    _context: AgentContext\n  ): Promise<void> {\n    const { sessionKey } = event;\n\n    // Compaction logic is handled by SessionStore, this handler just logs for now\n    logger.debug({ sessionKey, messageCount: event.payload?.usage?.total }, 'Compaction lifecycle event received');\n  }\n\n  private shouldCompact(messageCount: number): boolean {\n    return messageCount >= this.config.minMessages;\n  }\n}\n"],"mappings":";;;aAAwD;AAQxD,MAAM,SAAS,aAAa,uBAAuB;AASnD,MAAM,iBAA0C;CAC9C,aAAa;CACb,WAAW;CACX,mBAAmB;CACnB,iBAAiB;CAClB;AAED,IAAa,6BAAb,MAEA;CACE,OAAgB;CAChB;CAEA,YAAY,QAA2C;AACrD,OAAK,SAAS;GAAE,GAAG;GAAgB,GAAG;GAAQ;;CAGhD,MAAM,OACJ,OACA,UACe;EACf,MAAM,EAAE,eAAe;AAGvB,SAAO,MAAM;GAAE;GAAY,cAAc,MAAM,SAAS,OAAO;GAAO,EAAE,sCAAsC;;CAGhH,cAAsB,cAA+B;AACnD,SAAO,gBAAgB,KAAK,OAAO"}
+{"version":3,"file":"compaction.js","names":[],"sources":["../../../../../src/agent/lifecycle/handlers/compaction.ts"],"sourcesContent":["import { createLogger } from '../../../utils/logger.js';\nimport type { AgentContext } from '../../service.types.js';\nimport type {\n  LifecycleHandler,\n  LifecycleEventData,\n  LLMResponsePayload,\n} from '../types.js';\n\nconst logger = createLogger('lifecycle-compaction');\n\nexport interface CompactionHandlerConfig {\n  minMessages: number;\n  maxTokens: number;\n  preserveReasoning: boolean;\n  accumulateUsage: boolean;\n}\n\nconst DEFAULT_CONFIG: CompactionHandlerConfig = {\n  minMessages: 20,\n  maxTokens: 8000,\n  preserveReasoning: true,\n  accumulateUsage: true,\n};\n\nexport class CompactionLifecycleHandler\n  implements LifecycleHandler<LLMResponsePayload>\n{\n  readonly name = 'CompactionLifecycleHandler';\n  private config: CompactionHandlerConfig;\n\n  constructor(config?: Partial<CompactionHandlerConfig>) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n  }\n\n  async handle(\n    event: LifecycleEventData<LLMResponsePayload>,\n    _context: AgentContext\n  ): Promise<void> {\n    const { sessionKey } = event;\n\n    // Compaction logic is handled by SessionStore, this handler just logs for now\n    logger.debug({ sessionKey, messageCount: event.payload?.usage?.total }, 'Compaction lifecycle event received');\n  }\n\n  private shouldCompact(messageCount: number): boolean {\n    return messageCount >= this.config.minMessages;\n  }\n}\n"],"mappings":";;;aAAwD;AAQxD,MAAM,SAAS,aAAa,uBAAuB;AASnD,MAAM,iBAA0C;CAC9C,aAAa;CACb,WAAW;CACX,mBAAmB;CACnB,iBAAiB;CAClB;AAED,IAAa,6BAAb,MAEA;CACE,OAAgB;CAChB;CAEA,YAAY,QAA2C;AACrD,OAAK,SAAS;GAAE,GAAG;GAAgB,GAAG;GAAQ;;CAGhD,MAAM,OACJ,OACA,UACe;EACf,MAAM,EAAE,eAAe;AAGvB,SAAO,MAAM;GAAE;GAAY,cAAc,MAAM,SAAS,OAAO;GAAO,EAAE,sCAAsC;;CAGhH,cAAsB,cAA+B;AACnD,SAAO,gBAAgB,KAAK,OAAO"}

package/dist/src/agent/lifecycle/manager.d.ts

@@ -1,4 +1,4 @@
-import type { AgentContext } from '../service.js';
+import type { AgentContext } from '../service.types.js';
 import type { LifecycleEventType, LifecycleHandler } from './types.js';
 export declare class LifecycleManager {
     private handlers;

package/dist/src/agent/lifecycle/manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"manager.js","names":[],"sources":["../../../../src/agent/lifecycle/manager.ts"],"sourcesContent":["import { createLogger } from '../../utils/logger.js';\nimport type { AgentContext } from '../service.js';\nimport type {\n  LifecycleEventType,\n  LifecycleEventData,\n  LifecycleHandler,\n} from './types.js';\n\nconst logger = createLogger('lifecycle-manager');\n\nexport class LifecycleManager {\n  private handlers = new Map<LifecycleEventType, LifecycleHandler<unknown>[]>();\n\n  on<T>(eventType: LifecycleEventType, handler: LifecycleHandler<T>): this {\n    const existing = this.handlers.get(eventType) || [];\n    existing.push(handler as LifecycleHandler<unknown>);\n    this.handlers.set(eventType, existing);\n    \n    logger.debug({ eventType, handlerName: handler.name }, 'Registered lifecycle handler');\n    return this;\n  }\n\n  async emit<T>(\n    eventType: LifecycleEventType,\n    sessionKey: string,\n    payload: T,\n    context: AgentContext\n  ): Promise<void> {\n    const handlers = this.handlers.get(eventType) || [];\n    \n    if (handlers.length === 0) {\n      logger.debug({ eventType, sessionKey }, 'No handlers registered for event');\n      return;\n    }\n\n    const event: LifecycleEventData<T> = {\n      type: eventType,\n      sessionKey,\n      payload,\n      timestamp: Date.now(),\n    };\n\n    logger.debug({ eventType, sessionKey, handlerCount: handlers.length }, 'Emitting lifecycle event');\n\n    const results = await Promise.allSettled(\n      handlers.map(async (handler) => {\n        try {\n          await handler.handle(event as LifecycleEventData<unknown>, context);\n          logger.debug({ handler: handler.name, eventType }, 'Lifecycle handler completed');\n        } catch (error) {\n          logger.warn({ handler: handler.name, eventType, error }, 'Lifecycle handler failed');\n          throw error;\n        }\n      })\n    );\n\n    const succeeded = results.filter((r) => r.status === 'fulfilled').length;\n    const failed = results.filter((r) => r.status === 'rejected').length;\n\n    if (failed > 0) {\n      logger.warn({ eventType, succeeded, failed, total: handlers.length }, 'Some lifecycle handlers failed');\n    } else {\n      logger.debug({ eventType, succeeded, total: handlers.length }, 'All lifecycle handlers completed');\n    }\n  }\n\n  getRegisteredHandlers(): Record<LifecycleEventType, string[]> {\n    const result: Record<string, string[]> = {};\n    for (const [eventType, handlers] of this.handlers.entries()) {\n      result[eventType] = handlers.map((h) => h.name);\n    }\n    return result;\n  }\n\n  clear(): void {\n    this.handlers.clear();\n    logger.debug('All lifecycle handlers cleared');\n  }\n}\n"],"mappings":";;;aAAqD;AAQrD,MAAM,SAAS,aAAa,oBAAoB;AAEhD,IAAa,mBAAb,MAA8B;CAC5B,2BAAmB,IAAI,KAAsD;CAE7E,GAAM,WAA+B,SAAoC;EACvE,MAAM,WAAW,KAAK,SAAS,IAAI,UAAU,IAAI,EAAE;AACnD,WAAS,KAAK,QAAqC;AACnD,OAAK,SAAS,IAAI,WAAW,SAAS;AAEtC,SAAO,MAAM;GAAE;GAAW,aAAa,QAAQ;GAAM,EAAE,+BAA+B;AACtF,SAAO;;CAGT,MAAM,KACJ,WACA,YACA,SACA,SACe;EACf,MAAM,WAAW,KAAK,SAAS,IAAI,UAAU,IAAI,EAAE;AAEnD,MAAI,SAAS,WAAW,GAAG;AACzB,UAAO,MAAM;IAAE;IAAW;IAAY,EAAE,mCAAmC;AAC3E;;EAGF,MAAM,QAA+B;GACnC,MAAM;GACN;GACA;GACA,WAAW,KAAK,KAAK;GACtB;AAED,SAAO,MAAM;GAAE;GAAW;GAAY,cAAc,SAAS;GAAQ,EAAE,2BAA2B;EAElG,MAAM,UAAU,MAAM,QAAQ,WAC5B,SAAS,IAAI,OAAO,YAAY;AAC9B,OAAI;AACF,UAAM,QAAQ,OAAO,OAAsC,QAAQ;AACnE,WAAO,MAAM;KAAE,SAAS,QAAQ;KAAM;KAAW,EAAE,8BAA8B;YAC1E,OAAO;AACd,WAAO,KAAK;KAAE,SAAS,QAAQ;KAAM;KAAW;KAAO,EAAE,2BAA2B;AACpF,UAAM;;IAER,CACH;EAED,MAAM,YAAY,QAAQ,QAAQ,MAAM,EAAE,WAAW,YAAY,CAAC;EAClE,MAAM,SAAS,QAAQ,QAAQ,MAAM,EAAE,WAAW,WAAW,CAAC;AAE9D,MAAI,SAAS,EACX,QAAO,KAAK;GAAE;GAAW;GAAW;GAAQ,OAAO,SAAS;GAAQ,EAAE,iCAAiC;MAEvG,QAAO,MAAM;GAAE;GAAW;GAAW,OAAO,SAAS;GAAQ,EAAE,mCAAmC;;CAItG,wBAA8D;EAC5D,MAAM,SAAmC,EAAE;AAC3C,OAAK,MAAM,CAAC,WAAW,aAAa,KAAK,SAAS,SAAS,CACzD,QAAO,aAAa,SAAS,KAAK,MAAM,EAAE,KAAK;AAEjD,SAAO;;CAGT,QAAc;AACZ,OAAK,SAAS,OAAO;AACrB,SAAO,MAAM,iCAAiC"}
+{"version":3,"file":"manager.js","names":[],"sources":["../../../../src/agent/lifecycle/manager.ts"],"sourcesContent":["import { createLogger } from '../../utils/logger.js';\nimport type { AgentContext } from '../service.types.js';\nimport type {\n  LifecycleEventType,\n  LifecycleEventData,\n  LifecycleHandler,\n} from './types.js';\n\nconst logger = createLogger('lifecycle-manager');\n\nexport class LifecycleManager {\n  private handlers = new Map<LifecycleEventType, LifecycleHandler<unknown>[]>();\n\n  on<T>(eventType: LifecycleEventType, handler: LifecycleHandler<T>): this {\n    const existing = this.handlers.get(eventType) || [];\n    existing.push(handler as LifecycleHandler<unknown>);\n    this.handlers.set(eventType, existing);\n    \n    logger.debug({ eventType, handlerName: handler.name }, 'Registered lifecycle handler');\n    return this;\n  }\n\n  async emit<T>(\n    eventType: LifecycleEventType,\n    sessionKey: string,\n    payload: T,\n    context: AgentContext\n  ): Promise<void> {\n    const handlers = this.handlers.get(eventType) || [];\n    \n    if (handlers.length === 0) {\n      logger.debug({ eventType, sessionKey }, 'No handlers registered for event');\n      return;\n    }\n\n    const event: LifecycleEventData<T> = {\n      type: eventType,\n      sessionKey,\n      payload,\n      timestamp: Date.now(),\n    };\n\n    logger.debug({ eventType, sessionKey, handlerCount: handlers.length }, 'Emitting lifecycle event');\n\n    const results = await Promise.allSettled(\n      handlers.map(async (handler) => {\n        try {\n          await handler.handle(event as LifecycleEventData<unknown>, context);\n          logger.debug({ handler: handler.name, eventType }, 'Lifecycle handler completed');\n        } catch (error) {\n          logger.warn({ handler: handler.name, eventType, error }, 'Lifecycle handler failed');\n          throw error;\n        }\n      })\n    );\n\n    const succeeded = results.filter((r) => r.status === 'fulfilled').length;\n    const failed = results.filter((r) => r.status === 'rejected').length;\n\n    if (failed > 0) {\n      logger.warn({ eventType, succeeded, failed, total: handlers.length }, 'Some lifecycle handlers failed');\n    } else {\n      logger.debug({ eventType, succeeded, total: handlers.length }, 'All lifecycle handlers completed');\n    }\n  }\n\n  getRegisteredHandlers(): Record<LifecycleEventType, string[]> {\n    const result: Record<string, string[]> = {};\n    for (const [eventType, handlers] of this.handlers.entries()) {\n      result[eventType] = handlers.map((h) => h.name);\n    }\n    return result;\n  }\n\n  clear(): void {\n    this.handlers.clear();\n    logger.debug('All lifecycle handlers cleared');\n  }\n}\n"],"mappings":";;;aAAqD;AAQrD,MAAM,SAAS,aAAa,oBAAoB;AAEhD,IAAa,mBAAb,MAA8B;CAC5B,2BAAmB,IAAI,KAAsD;CAE7E,GAAM,WAA+B,SAAoC;EACvE,MAAM,WAAW,KAAK,SAAS,IAAI,UAAU,IAAI,EAAE;AACnD,WAAS,KAAK,QAAqC;AACnD,OAAK,SAAS,IAAI,WAAW,SAAS;AAEtC,SAAO,MAAM;GAAE;GAAW,aAAa,QAAQ;GAAM,EAAE,+BAA+B;AACtF,SAAO;;CAGT,MAAM,KACJ,WACA,YACA,SACA,SACe;EACf,MAAM,WAAW,KAAK,SAAS,IAAI,UAAU,IAAI,EAAE;AAEnD,MAAI,SAAS,WAAW,GAAG;AACzB,UAAO,MAAM;IAAE;IAAW;IAAY,EAAE,mCAAmC;AAC3E;;EAGF,MAAM,QAA+B;GACnC,MAAM;GACN;GACA;GACA,WAAW,KAAK,KAAK;GACtB;AAED,SAAO,MAAM;GAAE;GAAW;GAAY,cAAc,SAAS;GAAQ,EAAE,2BAA2B;EAElG,MAAM,UAAU,MAAM,QAAQ,WAC5B,SAAS,IAAI,OAAO,YAAY;AAC9B,OAAI;AACF,UAAM,QAAQ,OAAO,OAAsC,QAAQ;AACnE,WAAO,MAAM;KAAE,SAAS,QAAQ;KAAM;KAAW,EAAE,8BAA8B;YAC1E,OAAO;AACd,WAAO,KAAK;KAAE,SAAS,QAAQ;KAAM;KAAW;KAAO,EAAE,2BAA2B;AACpF,UAAM;;IAER,CACH;EAED,MAAM,YAAY,QAAQ,QAAQ,MAAM,EAAE,WAAW,YAAY,CAAC;EAClE,MAAM,SAAS,QAAQ,QAAQ,MAAM,EAAE,WAAW,WAAW,CAAC;AAE9D,MAAI,SAAS,EACX,QAAO,KAAK;GAAE;GAAW;GAAW;GAAQ,OAAO,SAAS;GAAQ,EAAE,iCAAiC;MAEvG,QAAO,MAAM;GAAE;GAAW;GAAW,OAAO,SAAS;GAAQ,EAAE,mCAAmC;;CAItG,wBAA8D;EAC5D,MAAM,SAAmC,EAAE;AAC3C,OAAK,MAAM,CAAC,WAAW,aAAa,KAAK,SAAS,SAAS,CACzD,QAAO,aAAa,SAAS,KAAK,MAAM,EAAE,KAAK;AAEjD,SAAO;;CAGT,QAAc;AACZ,OAAK,SAAS,OAAO;AACrB,SAAO,MAAM,iCAAiC"}

package/dist/src/agent/lifecycle/types.d.ts

@@ -1,4 +1,4 @@
-import type { AgentContext } from '../service.js';
+import type { AgentContext } from '../service.types.js';
 export type LifecycleEventType = 'conversation_start' | 'llm_request' | 'llm_response' | 'tool_call_start' | 'tool_call_end' | 'conversation_end' | 'session_start' | 'session_end';
 export interface LifecycleEventData<T = unknown> {
     type: LifecycleEventType;

package/dist/src/agent/memory/builtin-memory-store.js

@@ -1,6 +1,6 @@
-import { join } from "node:path";
 import { existsSync, mkdirSync, readFileSync } from "node:fs";
 import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { join } from "node:path";
 import lockfile from "proper-lockfile";
 //#region src/agent/memory/builtin-memory-store.ts
 /**

package/dist/src/agent/memory/dreaming/deep-promotion.js

@@ -4,8 +4,8 @@ import { MEMORY_MD_FILENAME } from "./constants.js";
 import { clamp01, compareCandidatesByScore, computeCandidateScore, extractPromotionMarkers, isContaminatedSnippet, isExpiredEntry, isoDay, readFileLines, resolveDeepDefaults, sliceRange, snippetHash } from "./utils.js";
 import { loadDreamingStore, saveDreamingStore, withDreamingPromotionLock } from "./short-term-store.js";
 import { emptyDeepPhaseSkipped, writeDreamingDeepLastRun } from "./last-run.js";
-import path from "node:path";
 import fs from "node:fs/promises";
+import path from "node:path";
 //#region src/agent/memory/dreaming/deep-promotion.ts
 init_logger();
 const log = createLogger("Dreaming:Deep");

package/dist/src/agent/memory/dreaming/events.js

@@ -1,6 +1,6 @@
 import { DREAMING_DIR_RELATIVE, DREAMING_EVENTS_LOG_RELATIVE } from "./constants.js";
-import path from "node:path";
 import fs from "node:fs/promises";
+import path from "node:path";
 //#region src/agent/memory/dreaming/events.ts
 /**
 * Append a single event line to `memory/.dreams/events.jsonl`.

package/dist/src/agent/memory/dreaming/last-run.js

@@ -1,6 +1,6 @@
 import { DREAMING_LAST_RUN_RELATIVE } from "./constants.js";
-import path from "node:path";
 import fs from "node:fs/promises";
+import path from "node:path";
 //#region src/agent/memory/dreaming/last-run.ts
 const DREAMING_LAST_RUN_FORMAT_VERSION = 2;
 function isRecord(v) {

package/dist/src/agent/memory/dreaming/light-sweep.js

@@ -4,8 +4,8 @@ import { DREAMING_DIR_RELATIVE } from "./constants.js";
 import { buildEntryKey, isoDay, normalizeMemoryPath, normalizeSnippetForHash, snippetHash } from "./utils.js";
 import { bumpEntryPhaseSignal, loadDreamingStore, saveDreamingStore } from "./short-term-store.js";
 import "./last-run.js";
-import path from "node:path";
 import fs from "node:fs/promises";
+import path from "node:path";
 //#region src/agent/memory/dreaming/light-sweep.ts
 init_logger();
 const log = createLogger("Dreaming:Light");

package/dist/src/agent/memory/dreaming/preview.js

@@ -1,8 +1,8 @@
 import { MEMORY_MD_FILENAME } from "./constants.js";
 import { clamp01, compareCandidatesByScore, computeCandidateScore, extractPromotionMarkers, isContaminatedSnippet, isExpiredEntry, readFileLines, resolveDeepDefaults, sliceRange, snippetHash } from "./utils.js";
 import { loadDreamingStore } from "./short-term-store.js";
-import path from "node:path";
 import fs from "node:fs/promises";
+import path from "node:path";
 //#region src/agent/memory/dreaming/preview.ts
 async function previewDreamingDeepPromotion(params) {
 	const cfg = resolveDeepDefaults(params.config);

package/dist/src/agent/memory/dreaming/rem-patterns.js

@@ -4,8 +4,8 @@ import { DREAMING_DIR_RELATIVE, DREAMS_MD_FILENAME, MS_PER_DAY } from "./constan
 import { isoDay } from "./utils.js";
 import { bumpEntryPhaseSignal, loadDreamingStore, saveDreamingStore } from "./short-term-store.js";
 import "./last-run.js";
-import path from "node:path";
 import fs from "node:fs/promises";
+import path from "node:path";
 //#region src/agent/memory/dreaming/rem-patterns.ts
 init_logger();
 const log = createLogger("Dreaming:REM");

package/dist/src/agent/memory/dreaming/short-term-store.js

@@ -2,9 +2,9 @@ import { createLogger } from "../../../utils/logger/index.js";
 import { init_logger } from "../../../utils/logger.js";
 import { SHORT_TERM_PROMOTION_LOCK_RELATIVE, SHORT_TERM_RECALL_STORE_RELATIVE } from "./constants.js";
 import { buildEntryKey, clamp01, isoDay, normalizeMemoryPath } from "./utils.js";
-import path from "node:path";
 import { createHash, randomUUID } from "node:crypto";
 import fs from "node:fs/promises";
+import path from "node:path";
 //#region src/agent/memory/dreaming/short-term-store.ts
 init_logger();
 const log = createLogger("Dreaming:Store");

package/dist/src/agent/memory/dreaming/utils.d.ts

@@ -1,5 +1,14 @@
 import type { DreamingDeepConfig } from './config.js';
-import type { DreamingStoreEntry } from './short-term-store.js';
+type DreamingStoreEntryScoringView = {
+    recallCount: number;
+    totalScore: number;
+    lastRecalledAt?: string;
+    queryHashes?: readonly string[];
+    dailyCount: number;
+    groundedCount: number;
+    lightHits: number;
+    remHits: number;
+};
 /** Normalize a workspace-relative memory path: forward slashes, no odd ../ escapes at start. */
 export declare function normalizeMemoryPath(rel: string): string;
 /**
@@ -16,7 +25,7 @@ export declare function isoDay(d: Date): string;
 export declare function clamp01(value: number): number;
 /** Fills in deep-phase defaults; mirrors `resolveDreamingConfig` deep object when only partial overrides are given. */
 export declare function resolveDeepDefaults(overrides?: Partial<DreamingDeepConfig>): DreamingDeepConfig;
-export declare function computeCandidateScore(entry: DreamingStoreEntry, nowMs: number, recencyHalfLifeDays: number): {
+export declare function computeCandidateScore(entry: DreamingStoreEntryScoringView, nowMs: number, recencyHalfLifeDays: number): {
     avgScore: number;
     score: number;
     recencyDecay: number;
@@ -40,3 +49,4 @@ export declare function extractPromotionMarkers(markdown: string): {
     keys: Set<string>;
     hashes: Set<string>;
 };
+export {};

package/dist/src/agent/memory/dreaming/utils.js

@@ -1,7 +1,7 @@
 import { DEFAULT_DEEP_CRON, DIVERSITY_WEIGHT, MS_PER_DAY, REINFORCEMENT_WEIGHT } from "./constants.js";
-import path from "node:path";
 import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
+import path from "node:path";
 //#region src/agent/memory/dreaming/utils.ts
 /** Normalize a workspace-relative memory path: forward slashes, no odd ../ escapes at start. */
 function normalizeMemoryPath(rel) {

package/dist/src/agent/memory/dreaming/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/utils.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\nimport { createHash } from 'node:crypto';\n\nimport type { DreamingDeepConfig } from './config.js';\nimport {\n  DEFAULT_DEEP_CRON,\n  DEFAULT_MAX_AGE_DAYS,\n  DEFAULT_RECENCY_HALF_LIFE_DAYS,\n  DIVERSITY_DIMENSION_COUNT,\n  DIVERSITY_WEIGHT,\n  MS_PER_DAY,\n  REINFORCEMENT_WEIGHT,\n} from './constants.js';\nimport type { DreamingStoreEntry } from './short-term-store.js';\n\n// ── Path + keying ─────────────────────────────────────────────────────\n\n/** Normalize a workspace-relative memory path: forward slashes, no odd ../ escapes at start. */\nexport function normalizeMemoryPath(rel: string): string {\n  if (typeof rel !== 'string' || !rel.trim()) return '';\n  const s = rel.trim().replace(/\\\\/g, '/');\n  return path.posix\n    .normalize(s)\n    .replace(/^(\\.\\/)+/, '')\n    .replace(/\\/+/g, '/');\n}\n\n/**\n * Stable id for a short-term store entry (path + line range).\n * Format: `{normalizedPath}#{start}-{end}` (1-based, inclusive end).\n */\nexport function buildEntryKey(parts: { path: string; startLine: number; endLine: number }): string {\n  const p = normalizeMemoryPath(parts.path);\n  const a = Math.max(1, Math.floor(parts.startLine));\n  const b = Math.max(a, Math.floor(parts.endLine));\n  return `${p}#${a}-${b}`;\n}\n\n/** YYYY-MM-DD in local time (for daily `memory/YYYY-MM-DD.md` names). */\nexport function 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// ── Numbers + deep config defaults ────────────────────────────────────\n\nexport function clamp01(value: number): number {\n  if (!Number.isFinite(value)) return 0;\n  return Math.max(0, Math.min(1, value));\n}\n\nfunction toPositiveInt(value: unknown, fallback: number): number {\n  const num = typeof value === 'string' ? Number(value) : Number(value);\n  if (!Number.isFinite(num)) return fallback;\n  const floored = Math.floor(num);\n  return floored > 0 ? floored : fallback;\n}\n\nfunction toNonNegInt(value: unknown, fallback: number): number {\n  const num = typeof value === 'string' ? Number(value) : Number(value);\n  if (!Number.isFinite(num)) return fallback;\n  const floored = Math.floor(num);\n  return floored >= 0 ? floored : fallback;\n}\n\nfunction clampScore(value: number, fallback: number): number {\n  if (!Number.isFinite(value)) return fallback;\n  return Math.max(0, Math.min(1, value));\n}\n\nfunction trimmedCron(value: unknown, fallback: string): string {\n  return typeof value === 'string' && value.trim() ? value.trim() : fallback;\n}\n\n/** Fills in deep-phase defaults; mirrors `resolveDreamingConfig` deep object when only partial overrides are given. */\nexport function resolveDeepDefaults(overrides?: Partial<DreamingDeepConfig>): DreamingDeepConfig {\n  return {\n    enabled: overrides?.enabled !== false,\n    cron: trimmedCron(overrides?.cron, DEFAULT_DEEP_CRON),\n    minScore: clampScore(Number(overrides?.minScore), 0.8),\n    minRecallCount: toPositiveInt(overrides?.minRecallCount, 3),\n    minUniqueQueries: toPositiveInt(overrides?.minUniqueQueries, 3),\n    limit: toNonNegInt(overrides?.limit, 10),\n    recencyHalfLifeDays: toPositiveInt(overrides?.recencyHalfLifeDays, DEFAULT_RECENCY_HALF_LIFE_DAYS),\n    maxAgeDays: toPositiveInt(overrides?.maxAgeDays, DEFAULT_MAX_AGE_DAYS),\n  };\n}\n\n// ── Scoring (deep promotion) ─────────────────────────────────────────\n\nexport function computeCandidateScore(\n  entry: DreamingStoreEntry,\n  nowMs: number,\n  recencyHalfLifeDays: number,\n): { avgScore: number; score: number; recencyDecay: number } {\n  const recall = Math.max(0, entry.recallCount);\n  const avgRaw = recall > 0 ? entry.totalScore / recall : 0;\n  const avgScore = clamp01(avgRaw);\n\n  let recencyDecay = 1;\n  if (entry.lastRecalledAt) {\n    const last = Date.parse(entry.lastRecalledAt);\n    if (Number.isFinite(last)) {\n      const days = Math.max(0, (nowMs - last) / MS_PER_DAY);\n      const hl = Math.max(0.1, recencyHalfLifeDays);\n      recencyDecay = 0.5 ** (days / hl);\n    }\n  }\n\n  const logRecall = Math.log(1 + recall);\n  const reinforcement = REINFORCEMENT_WEIGHT * Math.min(logRecall, 3);\n\n  const qCount = entry.queryHashes?.length ?? 0;\n  const uniqueQueryTerm = Math.min(1, qCount / 6) * DIVERSITY_WEIGHT;\n\n  const dims = [entry.dailyCount, entry.groundedCount, entry.lightHits, entry.remHits].filter(\n    (n) => n > 0,\n  ).length;\n  const signalDiversity = ((dims / DIVERSITY_DIMENSION_COUNT) * DIVERSITY_WEIGHT) / 2;\n\n  const score = clamp01(avgScore * recencyDecay + reinforcement * 0.25 + uniqueQueryTerm + signalDiversity);\n\n  return { avgScore, score, recencyDecay };\n}\n\nexport function compareCandidatesByScore(\n  a: { score: number; key: string },\n  b: { score: number; key: string },\n): number {\n  if (b.score !== a.score) return b.score - a.score;\n  return a.key.localeCompare(b.key);\n}\n\n// ── File slices + integrity ─────────────────────────────────────────\n\nexport async function readFileLines(fullPath: string): Promise<string[] | null> {\n  try {\n    const raw = await fs.readFile(fullPath, 'utf-8');\n    return raw.split(/\\r?\\n/);\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException | undefined)?.code === 'ENOENT') return null;\n    throw err;\n  }\n}\n\n/** 1-based inclusive line range. Joins with newlines. */\nexport function sliceRange(lines: string[], startLine: number, endLine: number): string {\n  const a = Math.max(1, Math.floor(startLine));\n  const b = Math.max(a, Math.floor(endLine));\n  const out = lines.slice(a - 1, b);\n  return out.join('\\n').trimEnd();\n}\n\nexport function isExpiredEntry(\n  lastRecalledAt: string | undefined,\n  nowMs: number,\n  maxAgeDays: number,\n): boolean {\n  if (!lastRecalledAt) return true;\n  const t = Date.parse(lastRecalledAt);\n  if (!Number.isFinite(t)) return true;\n  return (nowMs - t) / MS_PER_DAY > maxAgeDays;\n}\n\n/** Reject empty, tiny, or absurdly long snippets; blocks obvious “tool error” text. */\nexport function isContaminatedSnippet(snippet: string): boolean {\n  const s = snippet.trim();\n  if (s.length < 3) return true;\n  if (s.length > 12_000) return true;\n  if (!/\\p{L}/u.test(s) && !/\\d/.test(s)) return true;\n  return false;\n}\n\nexport function normalizeSnippetForHash(text: string): string {\n  return text\n    .toLowerCase()\n    .replace(/\\s+/g, ' ')\n    .replace(/['\"`]/g, '')\n    .trim();\n}\n\nexport function snippetHash(text: string): string {\n  const n = normalizeSnippetForHash(text);\n  return createHash('sha1').update(n, 'utf8').digest('hex').slice(0, 20);\n}\n\nexport function extractPromotionMarkers(markdown: string): { keys: Set<string>; hashes: Set<string> } {\n  const keys = new Set<string>();\n  const hashes = new Set<string>();\n  let m: RegExpExecArray | null;\n  const re = /<!--\\s*xopc-memory-promotion\\s+key=\"([^\"]*)\"\\s+hash=\"([^\"]*)\"\\s*-->/g;\n  while ((m = re.exec(markdown)) !== null) {\n    if (m[1]) keys.add(m[1]);\n    if (m[2]) hashes.add(m[2]);\n  }\n  return { keys, hashes };\n}\n"],"mappings":"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"}
+{"version":3,"file":"utils.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/utils.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\nimport { createHash } from 'node:crypto';\n\nimport type { DreamingDeepConfig } from './config.js';\nimport {\n  DEFAULT_DEEP_CRON,\n  DEFAULT_MAX_AGE_DAYS,\n  DEFAULT_RECENCY_HALF_LIFE_DAYS,\n  DIVERSITY_DIMENSION_COUNT,\n  DIVERSITY_WEIGHT,\n  MS_PER_DAY,\n  REINFORCEMENT_WEIGHT,\n} from './constants.js';\n// `DreamingStoreEntry` lives in `./short-term-store.js`, which imports value\n// helpers from THIS file — so importing it back creates a circular cycle.\n// `computeCandidateScore` only reads three numeric/string fields; declaring a\n// narrow structural type keeps the helper decoupled.\ntype DreamingStoreEntryScoringView = {\n  recallCount: number;\n  totalScore: number;\n  lastRecalledAt?: string;\n  queryHashes?: readonly string[];\n  dailyCount: number;\n  groundedCount: number;\n  lightHits: number;\n  remHits: number;\n};\n\n// ── Path + keying ─────────────────────────────────────────────────────\n\n/** Normalize a workspace-relative memory path: forward slashes, no odd ../ escapes at start. */\nexport function normalizeMemoryPath(rel: string): string {\n  if (typeof rel !== 'string' || !rel.trim()) return '';\n  const s = rel.trim().replace(/\\\\/g, '/');\n  return path.posix\n    .normalize(s)\n    .replace(/^(\\.\\/)+/, '')\n    .replace(/\\/+/g, '/');\n}\n\n/**\n * Stable id for a short-term store entry (path + line range).\n * Format: `{normalizedPath}#{start}-{end}` (1-based, inclusive end).\n */\nexport function buildEntryKey(parts: { path: string; startLine: number; endLine: number }): string {\n  const p = normalizeMemoryPath(parts.path);\n  const a = Math.max(1, Math.floor(parts.startLine));\n  const b = Math.max(a, Math.floor(parts.endLine));\n  return `${p}#${a}-${b}`;\n}\n\n/** YYYY-MM-DD in local time (for daily `memory/YYYY-MM-DD.md` names). */\nexport function 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// ── Numbers + deep config defaults ────────────────────────────────────\n\nexport function clamp01(value: number): number {\n  if (!Number.isFinite(value)) return 0;\n  return Math.max(0, Math.min(1, value));\n}\n\nfunction toPositiveInt(value: unknown, fallback: number): number {\n  const num = typeof value === 'string' ? Number(value) : Number(value);\n  if (!Number.isFinite(num)) return fallback;\n  const floored = Math.floor(num);\n  return floored > 0 ? floored : fallback;\n}\n\nfunction toNonNegInt(value: unknown, fallback: number): number {\n  const num = typeof value === 'string' ? Number(value) : Number(value);\n  if (!Number.isFinite(num)) return fallback;\n  const floored = Math.floor(num);\n  return floored >= 0 ? floored : fallback;\n}\n\nfunction clampScore(value: number, fallback: number): number {\n  if (!Number.isFinite(value)) return fallback;\n  return Math.max(0, Math.min(1, value));\n}\n\nfunction trimmedCron(value: unknown, fallback: string): string {\n  return typeof value === 'string' && value.trim() ? value.trim() : fallback;\n}\n\n/** Fills in deep-phase defaults; mirrors `resolveDreamingConfig` deep object when only partial overrides are given. */\nexport function resolveDeepDefaults(overrides?: Partial<DreamingDeepConfig>): DreamingDeepConfig {\n  return {\n    enabled: overrides?.enabled !== false,\n    cron: trimmedCron(overrides?.cron, DEFAULT_DEEP_CRON),\n    minScore: clampScore(Number(overrides?.minScore), 0.8),\n    minRecallCount: toPositiveInt(overrides?.minRecallCount, 3),\n    minUniqueQueries: toPositiveInt(overrides?.minUniqueQueries, 3),\n    limit: toNonNegInt(overrides?.limit, 10),\n    recencyHalfLifeDays: toPositiveInt(overrides?.recencyHalfLifeDays, DEFAULT_RECENCY_HALF_LIFE_DAYS),\n    maxAgeDays: toPositiveInt(overrides?.maxAgeDays, DEFAULT_MAX_AGE_DAYS),\n  };\n}\n\n// ── Scoring (deep promotion) ─────────────────────────────────────────\n\nexport function computeCandidateScore(\n  entry: DreamingStoreEntryScoringView,\n  nowMs: number,\n  recencyHalfLifeDays: number,\n): { avgScore: number; score: number; recencyDecay: number } {\n  const recall = Math.max(0, entry.recallCount);\n  const avgRaw = recall > 0 ? entry.totalScore / recall : 0;\n  const avgScore = clamp01(avgRaw);\n\n  let recencyDecay = 1;\n  if (entry.lastRecalledAt) {\n    const last = Date.parse(entry.lastRecalledAt);\n    if (Number.isFinite(last)) {\n      const days = Math.max(0, (nowMs - last) / MS_PER_DAY);\n      const hl = Math.max(0.1, recencyHalfLifeDays);\n      recencyDecay = 0.5 ** (days / hl);\n    }\n  }\n\n  const logRecall = Math.log(1 + recall);\n  const reinforcement = REINFORCEMENT_WEIGHT * Math.min(logRecall, 3);\n\n  const qCount = entry.queryHashes?.length ?? 0;\n  const uniqueQueryTerm = Math.min(1, qCount / 6) * DIVERSITY_WEIGHT;\n\n  const dims = [entry.dailyCount, entry.groundedCount, entry.lightHits, entry.remHits].filter(\n    (n) => n > 0,\n  ).length;\n  const signalDiversity = ((dims / DIVERSITY_DIMENSION_COUNT) * DIVERSITY_WEIGHT) / 2;\n\n  const score = clamp01(avgScore * recencyDecay + reinforcement * 0.25 + uniqueQueryTerm + signalDiversity);\n\n  return { avgScore, score, recencyDecay };\n}\n\nexport function compareCandidatesByScore(\n  a: { score: number; key: string },\n  b: { score: number; key: string },\n): number {\n  if (b.score !== a.score) return b.score - a.score;\n  return a.key.localeCompare(b.key);\n}\n\n// ── File slices + integrity ─────────────────────────────────────────\n\nexport async function readFileLines(fullPath: string): Promise<string[] | null> {\n  try {\n    const raw = await fs.readFile(fullPath, 'utf-8');\n    return raw.split(/\\r?\\n/);\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException | undefined)?.code === 'ENOENT') return null;\n    throw err;\n  }\n}\n\n/** 1-based inclusive line range. Joins with newlines. */\nexport function sliceRange(lines: string[], startLine: number, endLine: number): string {\n  const a = Math.max(1, Math.floor(startLine));\n  const b = Math.max(a, Math.floor(endLine));\n  const out = lines.slice(a - 1, b);\n  return out.join('\\n').trimEnd();\n}\n\nexport function isExpiredEntry(\n  lastRecalledAt: string | undefined,\n  nowMs: number,\n  maxAgeDays: number,\n): boolean {\n  if (!lastRecalledAt) return true;\n  const t = Date.parse(lastRecalledAt);\n  if (!Number.isFinite(t)) return true;\n  return (nowMs - t) / MS_PER_DAY > maxAgeDays;\n}\n\n/** Reject empty, tiny, or absurdly long snippets; blocks obvious “tool error” text. */\nexport function isContaminatedSnippet(snippet: string): boolean {\n  const s = snippet.trim();\n  if (s.length < 3) return true;\n  if (s.length > 12_000) return true;\n  if (!/\\p{L}/u.test(s) && !/\\d/.test(s)) return true;\n  return false;\n}\n\nexport function normalizeSnippetForHash(text: string): string {\n  return text\n    .toLowerCase()\n    .replace(/\\s+/g, ' ')\n    .replace(/['\"`]/g, '')\n    .trim();\n}\n\nexport function snippetHash(text: string): string {\n  const n = normalizeSnippetForHash(text);\n  return createHash('sha1').update(n, 'utf8').digest('hex').slice(0, 20);\n}\n\nexport function extractPromotionMarkers(markdown: string): { keys: Set<string>; hashes: Set<string> } {\n  const keys = new Set<string>();\n  const hashes = new Set<string>();\n  let m: RegExpExecArray | null;\n  const re = /<!--\\s*xopc-memory-promotion\\s+key=\"([^\"]*)\"\\s+hash=\"([^\"]*)\"\\s*-->/g;\n  while ((m = re.exec(markdown)) !== null) {\n    if (m[1]) keys.add(m[1]);\n    if (m[2]) hashes.add(m[2]);\n  }\n  return { keys, hashes };\n}\n"],"mappings":"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"}

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

@@ -1,11 +1,11 @@
 import { isCuratedMemoryInPrompt, isMemorySubsystemEnabled, resolveBuiltinMemoryStoreConfig, shouldInjectMemoryPrefetchThisTurn, shouldRegisterCuratedMemoryTool } from "./memory-config.js";
+import { extractAgentUserPlainText } from "./user-message-text.js";
+import { buildMemoryContextBlock, sanitizeMemoryContextFenceEscapes } from "./context-fence.js";
+import { injectPrefetchIntoUserMessage } from "./inject-prefetch.js";
 import { BuiltinMemoryStore, MEMORY_ENTRY_DELIMITER, scanForThreats } from "./builtin-memory-store.js";
 import { BuiltinMemoryProvider } from "./builtin-provider.js";
 import { MemoryManager } from "./manager.js";
 import { StubMemoryProvider } from "./stub-memory-provider.js";
 import { createMemoryManagerFromConfig } from "./create-memory-manager.js";
-import { buildMemoryContextBlock, sanitizeMemoryContextFenceEscapes } from "./context-fence.js";
-import { injectPrefetchIntoUserMessage } from "./inject-prefetch.js";
-import { extractAgentUserPlainText } from "./user-message-text.js";
 import { discoverMemoryPlugins } from "./plugin-discovery.js";
 export { BuiltinMemoryProvider, BuiltinMemoryStore, MEMORY_ENTRY_DELIMITER, MemoryManager, StubMemoryProvider, buildMemoryContextBlock, createMemoryManagerFromConfig, discoverMemoryPlugins, extractAgentUserPlainText, injectPrefetchIntoUserMessage, isCuratedMemoryInPrompt, isMemorySubsystemEnabled, resolveBuiltinMemoryStoreConfig, sanitizeMemoryContextFenceEscapes, scanForThreats, shouldInjectMemoryPrefetchThisTurn, shouldRegisterCuratedMemoryTool };

package/dist/src/agent/memory/plugin-discovery.js

@@ -1,5 +1,5 @@
-import { dirname, join } from "node:path";
 import { readdir, stat } from "node:fs/promises";
+import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 //#region src/agent/memory/plugin-discovery.ts
 async function discoverMemoryPlugins() {

package/dist/src/agent/memory/prefetch-coordinator.d.ts

@@ -0,0 +1,37 @@
+/**
+ * MemoryPrefetchCoordinator — owns the per-session memory prefetch cadence and
+ * the post-turn sync hand-off to external memory providers.
+ *
+ * Previously these lived as two methods + a private `Map<sessionKey, turn>` on
+ * `AgentManager`. Moving them out makes the memory layer a stand-alone concern
+ * with a single owner that handles both "what to prefix on the user turn" and
+ * "what to sync after the turn ends".
+ */
+import type { AgentMessage } from '@earendil-works/pi-agent-core';
+import type { Config } from '../../config/schema.js';
+import type { MemoryManager } from './manager.js';
+export interface MemoryPrefetchCoordinatorOptions {
+    /** Effective config snapshot accessor; tested against `isMemorySubsystemEnabled`. */
+    getConfig: () => Config | undefined;
+    /** Resolve the per-session memory manager (workspace runtime lookup lives in AgentManager). */
+    getMemoryManagerForSession: (sessionKey: string) => MemoryManager;
+    /** Return the last assistant text for a session — fed into external `syncAll`. */
+    getLastAssistantContent: (sessionKey: string) => string | null;
+}
+export declare class MemoryPrefetchCoordinator {
+    private readonly opts;
+    /** Per-session user-message index, incremented before each `applyPrefetch` call. */
+    private readonly prefetchUserTurn;
+    constructor(opts: MemoryPrefetchCoordinatorOptions);
+    /** Forget a session entirely (called when AgentManager removes the agent). */
+    forgetSession(sessionKey: string): void;
+    /** Tear down all per-session state (process stop / hot reload). */
+    clear(): void;
+    /**
+     * Prepend the prefetched memory fence to the user turn when the cadence
+     * config says we should. Returns the original message untouched otherwise.
+     */
+    applyToUserMessage(userMessage: AgentMessage, sessionKey: string): Promise<AgentMessage>;
+    /** Post-turn: push the latest exchange to external providers + warm next prefetch. */
+    afterTurn(sessionKey: string, userPlainText: string): void;
+}

package/dist/src/agent/memory/prefetch-coordinator.js

@@ -0,0 +1,45 @@
+import { isMemorySubsystemEnabled, shouldInjectMemoryPrefetchThisTurn } from "./memory-config.js";
+import { extractAgentUserPlainText } from "./user-message-text.js";
+import { injectPrefetchIntoUserMessage } from "./inject-prefetch.js";
+//#region src/agent/memory/prefetch-coordinator.ts
+var MemoryPrefetchCoordinator = class {
+	opts;
+	/** Per-session user-message index, incremented before each `applyPrefetch` call. */
+	prefetchUserTurn = /* @__PURE__ */ new Map();
+	constructor(opts) {
+		this.opts = opts;
+	}
+	/** Forget a session entirely (called when AgentManager removes the agent). */
+	forgetSession(sessionKey) {
+		this.prefetchUserTurn.delete(sessionKey);
+	}
+	/** Tear down all per-session state (process stop / hot reload). */
+	clear() {
+		this.prefetchUserTurn.clear();
+	}
+	/**
+	* Prepend the prefetched memory fence to the user turn when the cadence
+	* config says we should. Returns the original message untouched otherwise.
+	*/
+	async applyToUserMessage(userMessage, sessionKey) {
+		const cfg = this.opts.getConfig();
+		if (!isMemorySubsystemEnabled(cfg)) return userMessage;
+		const plain = extractAgentUserPlainText(userMessage);
+		const turn = (this.prefetchUserTurn.get(sessionKey) ?? 0) + 1;
+		this.prefetchUserTurn.set(sessionKey, turn);
+		if (!shouldInjectMemoryPrefetchThisTurn(cfg, turn)) return userMessage;
+		return injectPrefetchIntoUserMessage(this.opts.getMemoryManagerForSession(sessionKey), sessionKey, userMessage, plain);
+	}
+	/** Post-turn: push the latest exchange to external providers + warm next prefetch. */
+	afterTurn(sessionKey, userPlainText) {
+		if (!isMemorySubsystemEnabled(this.opts.getConfig())) return;
+		const assistant = this.opts.getLastAssistantContent(sessionKey) ?? "";
+		const mm = this.opts.getMemoryManagerForSession(sessionKey);
+		mm.syncAll(userPlainText, assistant, { sessionId: sessionKey });
+		mm.queuePrefetchAll(userPlainText, { sessionId: sessionKey });
+	}
+};
+//#endregion
+export { MemoryPrefetchCoordinator };
+
+//# sourceMappingURL=prefetch-coordinator.js.map

package/dist/src/agent/memory/prefetch-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefetch-coordinator.js","names":[],"sources":["../../../../src/agent/memory/prefetch-coordinator.ts"],"sourcesContent":["/**\n * MemoryPrefetchCoordinator — owns the per-session memory prefetch cadence and\n * the post-turn sync hand-off to external memory providers.\n *\n * Previously these lived as two methods + a private `Map<sessionKey, turn>` on\n * `AgentManager`. Moving them out makes the memory layer a stand-alone concern\n * with a single owner that handles both \"what to prefix on the user turn\" and\n * \"what to sync after the turn ends\".\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../../config/schema.js';\nimport type { MemoryManager } from './manager.js';\nimport { extractAgentUserPlainText } from './user-message-text.js';\nimport { injectPrefetchIntoUserMessage } from './inject-prefetch.js';\nimport {\n  isMemorySubsystemEnabled,\n  shouldInjectMemoryPrefetchThisTurn,\n} from './memory-config.js';\n\nexport interface MemoryPrefetchCoordinatorOptions {\n  /** Effective config snapshot accessor; tested against `isMemorySubsystemEnabled`. */\n  getConfig: () => Config | undefined;\n  /** Resolve the per-session memory manager (workspace runtime lookup lives in AgentManager). */\n  getMemoryManagerForSession: (sessionKey: string) => MemoryManager;\n  /** Return the last assistant text for a session — fed into external `syncAll`. */\n  getLastAssistantContent: (sessionKey: string) => string | null;\n}\n\nexport class MemoryPrefetchCoordinator {\n  private readonly opts: MemoryPrefetchCoordinatorOptions;\n  /** Per-session user-message index, incremented before each `applyPrefetch` call. */\n  private readonly prefetchUserTurn = new Map<string, number>();\n\n  constructor(opts: MemoryPrefetchCoordinatorOptions) {\n    this.opts = opts;\n  }\n\n  /** Forget a session entirely (called when AgentManager removes the agent). */\n  forgetSession(sessionKey: string): void {\n    this.prefetchUserTurn.delete(sessionKey);\n  }\n\n  /** Tear down all per-session state (process stop / hot reload). */\n  clear(): void {\n    this.prefetchUserTurn.clear();\n  }\n\n  /**\n   * Prepend the prefetched memory fence to the user turn when the cadence\n   * config says we should. Returns the original message untouched otherwise.\n   */\n  async applyToUserMessage(\n    userMessage: AgentMessage,\n    sessionKey: string,\n  ): Promise<AgentMessage> {\n    const cfg = this.opts.getConfig();\n    if (!isMemorySubsystemEnabled(cfg)) {\n      return userMessage;\n    }\n    const plain = extractAgentUserPlainText(userMessage);\n    const turn = (this.prefetchUserTurn.get(sessionKey) ?? 0) + 1;\n    this.prefetchUserTurn.set(sessionKey, turn);\n    if (!shouldInjectMemoryPrefetchThisTurn(cfg, turn)) {\n      return userMessage;\n    }\n    return injectPrefetchIntoUserMessage(\n      this.opts.getMemoryManagerForSession(sessionKey),\n      sessionKey,\n      userMessage,\n      plain,\n    );\n  }\n\n  /** Post-turn: push the latest exchange to external providers + warm next prefetch. */\n  afterTurn(sessionKey: string, userPlainText: string): void {\n    const cfg = this.opts.getConfig();\n    if (!isMemorySubsystemEnabled(cfg)) {\n      return;\n    }\n    const assistant = this.opts.getLastAssistantContent(sessionKey) ?? '';\n    const mm = this.opts.getMemoryManagerForSession(sessionKey);\n    mm.syncAll(userPlainText, assistant, { sessionId: sessionKey });\n    mm.queuePrefetchAll(userPlainText, { sessionId: sessionKey });\n  }\n}\n"],"mappings":";;;;AA8BA,IAAa,4BAAb,MAAuC;CACrC;;CAEA,mCAAoC,IAAI,KAAqB;CAE7D,YAAY,MAAwC;AAClD,OAAK,OAAO;;;CAId,cAAc,YAA0B;AACtC,OAAK,iBAAiB,OAAO,WAAW;;;CAI1C,QAAc;AACZ,OAAK,iBAAiB,OAAO;;;;;;CAO/B,MAAM,mBACJ,aACA,YACuB;EACvB,MAAM,MAAM,KAAK,KAAK,WAAW;AACjC,MAAI,CAAC,yBAAyB,IAAI,CAChC,QAAO;EAET,MAAM,QAAQ,0BAA0B,YAAY;EACpD,MAAM,QAAQ,KAAK,iBAAiB,IAAI,WAAW,IAAI,KAAK;AAC5D,OAAK,iBAAiB,IAAI,YAAY,KAAK;AAC3C,MAAI,CAAC,mCAAmC,KAAK,KAAK,CAChD,QAAO;AAET,SAAO,8BACL,KAAK,KAAK,2BAA2B,WAAW,EAChD,YACA,aACA,MACD;;;CAIH,UAAU,YAAoB,eAA6B;AAEzD,MAAI,CAAC,yBADO,KAAK,KAAK,WACW,CAAC,CAChC;EAEF,MAAM,YAAY,KAAK,KAAK,wBAAwB,WAAW,IAAI;EACnE,MAAM,KAAK,KAAK,KAAK,2BAA2B,WAAW;AAC3D,KAAG,QAAQ,eAAe,WAAW,EAAE,WAAW,YAAY,CAAC;AAC/D,KAAG,iBAAiB,eAAe,EAAE,WAAW,YAAY,CAAC"}

package/dist/src/agent/messaging/command-handler.d.ts

@@ -64,6 +64,11 @@ export declare class CommandHandler {
     constructor(handlerConfig: CommandHandlerConfig);
     /** Replace config reference after hot reload or gateway PATCH so commands see current defaults. */
     updateAgentConfig(config: Config): void;
+    /**
+     * Build the unified command context shared by all execute paths.
+     * When `recorder` is set, every reply text is also captured (for SSE / CLI aggregation).
+     */
+    private buildCommandContext;
     /**
      * Execute a command using the unified command system
      */
@@ -76,5 +81,4 @@ export declare class CommandHandler {
         handled: boolean;
         aggregatedText: string;
     }>;
-    private runRegistryExecuteWithCapture;
 }