actoviq-agent-sdk 0.1.10 → 0.1.11

package/README-zh.md

@@ -1,14 +1,17 @@
-# Actoviq Agent SDK
+# Actoviq Agent SDK
 
 [![CI](https://github.com/DeconBear/actoviq-agent-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/DeconBear/actoviq-agent-sdk/actions/workflows/ci.yml)
 [![Publish npm Package](https://github.com/DeconBear/actoviq-agent-sdk/actions/workflows/publish-npm.yml/badge.svg)](https://github.com/DeconBear/actoviq-agent-sdk/actions/workflows/publish-npm.yml)
 [![npm version](https://img.shields.io/npm/v/actoviq-agent-sdk)](https://www.npmjs.com/package/actoviq-agent-sdk)
+[![Docs](https://img.shields.io/badge/docs-github%20pages-0f766e)](https://deconbear.github.io/actoviq-agent-sdk/)
 
 [English](./README.md) | [中文](./README-zh.md)
 
-Actoviq Agent SDK 是一个实验性的 TypeScript Agent SDK，面向多工具、多会话、多代理工作流。当前项目以 clean SDK 作为公开主路径，同时保留可选的兼容 bridge 路线。
+文档站地址：https://deconbear.github.io/actoviq-agent-sdk/
 
-项目仍在持续开发中，API 和运行行为后续还会继续打磨。非常欢迎提交 Issue 和 PR。
+Actoviq Agent SDK 是一个实验性的 TypeScript Agent SDK，面向多工具、多会话、多代理工作流。当前项目以 clean SDK 作为公开主路径，同时保留可选的兼容 bridge 路径。
+
+项目仍在持续开发中，API 和运行行为后续还会继续打磨。欢迎提交 Issue 和 PR。
 
 ## 安装
 
@@ -53,6 +56,10 @@ npm run example:actoviq-agent-helpers
 
 - English tutorial: [docs/en/README.md](./docs/en/README.md)
 - 中文教程: [docs/zh/README.md](./docs/zh/README.md)
+- GitHub Pages 文档站：
+  - https://deconbear.github.io/actoviq-agent-sdk/
+- 从 0 到 1 搭建完整 clean SDK 项目：
+  - [docs/zh/07-build-a-complete-clean-agent.md](./docs/zh/07-build-a-complete-clean-agent.md)
 
 如果你想直接运行一个带流式输出和工具调用的终端聊天程序，优先看：
 

package/README.md

@@ -1,10 +1,13 @@
-# Actoviq Agent SDK
+# Actoviq Agent SDK
 
 [![CI](https://github.com/DeconBear/actoviq-agent-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/DeconBear/actoviq-agent-sdk/actions/workflows/ci.yml)
 [![Publish npm Package](https://github.com/DeconBear/actoviq-agent-sdk/actions/workflows/publish-npm.yml/badge.svg)](https://github.com/DeconBear/actoviq-agent-sdk/actions/workflows/publish-npm.yml)
 [![npm version](https://img.shields.io/npm/v/actoviq-agent-sdk)](https://www.npmjs.com/package/actoviq-agent-sdk)
+[![Docs](https://img.shields.io/badge/docs-github%20pages-0f766e)](https://deconbear.github.io/actoviq-agent-sdk/)
 
-[English](./README.md) | [中文](./README-zh.md)
+[English](./README.md) | [Chinese](./README-zh.md)
+
+Documentation site: https://deconbear.github.io/actoviq-agent-sdk/
 
 Actoviq Agent SDK is an experimental TypeScript SDK for building multi-tool, multi-session agents with a clean-first public API, MCP integration, memory helpers, and an optional compatibility bridge path.
 
@@ -52,7 +55,9 @@ npm run example:actoviq-agent-helpers
 ## Tutorials
 
 - English tutorial: [docs/en/README.md](./docs/en/README.md)
-- 中文教程: [docs/zh/README.md](./docs/zh/README.md)
+- Chinese tutorial: [docs/zh/README.md](./docs/zh/README.md)
+- GitHub Pages docs site:
+  - https://deconbear.github.io/actoviq-agent-sdk/
 
 If you want a ready-to-run terminal chat program with streaming output and tool calls, start with:
 

package/dist/src/index.d.ts

@@ -1,6 +1,7 @@
 export { clearLoadedJsonConfig, getLoadedJsonConfig, loadJsonConfigFile, } from './config/loadJsonConfigFile.js';
 export { ActoviqBuddyApi, createActoviqBuddyApi, getActoviqBuddyIntroText, rollActoviqBuddy, rollActoviqBuddyWithSeed, } from './buddy/actoviqBuddy.js';
 export { ActoviqMemoryApi, createActoviqMemoryApi, getActoviqCompactBoundarySummary, getActoviqDefaultSessionMemoryCompactConfig, getActoviqDefaultSessionMemoryConfig, getActoviqDefaultSessionMemoryTemplate, getActoviqDefaultSettingsPath, formatActoviqMemoryManifest, getActoviqMemoryAge, getActoviqMemoryAgeDays, getActoviqMemoryFreshnessNote, getActoviqMemoryFreshnessText, getActoviqMemoryHeader, readActoviqMemoriesForSurfacing, scanActoviqMemoryFiles, selectActoviqRelevantMemories, } from './memory/actoviqMemory.js';
+export { ActoviqDreamApi, buildActoviqDreamPrompt, createActoviqDreamApi, ensureActoviqDreamLayout, isActoviqDreamEligibleSession, listActoviqSessionsTouchedSince, readActoviqLastConsolidatedAt, recordActoviqConsolidation, rollbackActoviqConsolidationLock, tryAcquireActoviqConsolidationLock, } from './memory/actoviqDream.js';
 export { ACTOVIQ_SESSION_MEMORY_STATE_KEY, createDefaultActoviqSessionMemoryRuntimeState, estimateActoviqConversationTokens, evaluateActoviqSessionMemoryProgress, filterActoviqMessagesForSessionMemory, hasActoviqToolCallsInLastAssistantTurn, parseActoviqSessionMemoryRuntimeState, sanitizeActoviqSessionMemoryOutput, serializeActoviqSessionMemoryRuntimeState, } from './memory/actoviqSessionMemoryState.js';
 export { loadDefaultActoviqSettings } from './config/loadDefaultActoviqSettings.js';
 export { loadActoviqSettings } from './config/loadActoviqSettings.js';
@@ -15,7 +16,7 @@ export { getActoviqBridgeCompactBoundaries, getActoviqBridgeLatestCompactBoundar
 export { createActoviqFileTools } from './parity/actoviqFileTools.js';
 export { createAgentSdk, ActoviqAgentClient, AgentSessionsApi } from './runtime/agentClient.js';
 export { ActoviqAgentHandle, ActoviqAgentsApi, createActoviqTaskTool, summarizeActoviqAgentDefinition, } from './runtime/actoviqAgents.js';
-export { ActoviqContextApi, ActoviqSlashCommandHandle, ActoviqSlashCommandsApi, formatActoviqAgents, formatActoviqCompactResult, formatActoviqContextOverview, formatActoviqMemoryState, formatActoviqSkills, formatActoviqTools, } from './runtime/actoviqSlashCommands.js';
+export { ActoviqContextApi, ActoviqSlashCommandHandle, ActoviqSlashCommandsApi, formatActoviqAgents, formatActoviqCompactResult, formatActoviqContextOverview, formatActoviqDreamResult, formatActoviqMemoryState, formatActoviqSkills, formatActoviqTools, } from './runtime/actoviqSlashCommands.js';
 export { ActoviqSkillHandle, ActoviqSkillsApi, getDefaultActoviqBundledSkills, loadActoviqSkillDefinitions, resolveActoviqSkillPrompt, skill, summarizeActoviqSkillDefinition, } from './runtime/actoviqSkills.js';
 export { decideActoviqToolPermission, isMutatingActoviqTool, isReadOnlyActoviqTool, } from './runtime/actoviqPermissions.js';
 export { ActoviqToolsApi, buildActoviqCleanToolCatalog, resolveActoviqCleanToolMetadata, summarizeActoviqResolvedTool, } from './runtime/actoviqToolCatalog.js';

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/index.js

@@ -1,6 +1,7 @@
 export { clearLoadedJsonConfig, getLoadedJsonConfig, loadJsonConfigFile, } from './config/loadJsonConfigFile.js';
 export { ActoviqBuddyApi, createActoviqBuddyApi, getActoviqBuddyIntroText, rollActoviqBuddy, rollActoviqBuddyWithSeed, } from './buddy/actoviqBuddy.js';
 export { ActoviqMemoryApi, createActoviqMemoryApi, getActoviqCompactBoundarySummary, getActoviqDefaultSessionMemoryCompactConfig, getActoviqDefaultSessionMemoryConfig, getActoviqDefaultSessionMemoryTemplate, getActoviqDefaultSettingsPath, formatActoviqMemoryManifest, getActoviqMemoryAge, getActoviqMemoryAgeDays, getActoviqMemoryFreshnessNote, getActoviqMemoryFreshnessText, getActoviqMemoryHeader, readActoviqMemoriesForSurfacing, scanActoviqMemoryFiles, selectActoviqRelevantMemories, } from './memory/actoviqMemory.js';
+export { ActoviqDreamApi, buildActoviqDreamPrompt, createActoviqDreamApi, ensureActoviqDreamLayout, isActoviqDreamEligibleSession, listActoviqSessionsTouchedSince, readActoviqLastConsolidatedAt, recordActoviqConsolidation, rollbackActoviqConsolidationLock, tryAcquireActoviqConsolidationLock, } from './memory/actoviqDream.js';
 export { ACTOVIQ_SESSION_MEMORY_STATE_KEY, createDefaultActoviqSessionMemoryRuntimeState, estimateActoviqConversationTokens, evaluateActoviqSessionMemoryProgress, filterActoviqMessagesForSessionMemory, hasActoviqToolCallsInLastAssistantTurn, parseActoviqSessionMemoryRuntimeState, sanitizeActoviqSessionMemoryOutput, serializeActoviqSessionMemoryRuntimeState, } from './memory/actoviqSessionMemoryState.js';
 export { loadDefaultActoviqSettings } from './config/loadDefaultActoviqSettings.js';
 export { loadActoviqSettings } from './config/loadActoviqSettings.js';
@@ -15,7 +16,7 @@ export { getActoviqBridgeCompactBoundaries, getActoviqBridgeLatestCompactBoundar
 export { createActoviqFileTools } from './parity/actoviqFileTools.js';
 export { createAgentSdk, ActoviqAgentClient, AgentSessionsApi } from './runtime/agentClient.js';
 export { ActoviqAgentHandle, ActoviqAgentsApi, createActoviqTaskTool, summarizeActoviqAgentDefinition, } from './runtime/actoviqAgents.js';
-export { ActoviqContextApi, ActoviqSlashCommandHandle, ActoviqSlashCommandsApi, formatActoviqAgents, formatActoviqCompactResult, formatActoviqContextOverview, formatActoviqMemoryState, formatActoviqSkills, formatActoviqTools, } from './runtime/actoviqSlashCommands.js';
+export { ActoviqContextApi, ActoviqSlashCommandHandle, ActoviqSlashCommandsApi, formatActoviqAgents, formatActoviqCompactResult, formatActoviqContextOverview, formatActoviqDreamResult, formatActoviqMemoryState, formatActoviqSkills, formatActoviqTools, } from './runtime/actoviqSlashCommands.js';
 export { ActoviqSkillHandle, ActoviqSkillsApi, getDefaultActoviqBundledSkills, loadActoviqSkillDefinitions, resolveActoviqSkillPrompt, skill, summarizeActoviqSkillDefinition, } from './runtime/actoviqSkills.js';
 export { decideActoviqToolPermission, isMutatingActoviqTool, isReadOnlyActoviqTool, } from './runtime/actoviqPermissions.js';
 export { ActoviqToolsApi, buildActoviqCleanToolCatalog, resolveActoviqCleanToolMetadata, summarizeActoviqResolvedTool, } from './runtime/actoviqToolCatalog.js';

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/memory/actoviqDream.d.ts

@@ -0,0 +1,61 @@
+import type { ActoviqBackgroundTaskRecord, ActoviqDreamConfig, ActoviqDreamPaths, ActoviqDreamRunOptions, ActoviqDreamRunResult, ActoviqDreamState, StoredSession } from '../types.js';
+import type { ActoviqMemoryApi } from './actoviqMemory.js';
+interface BuildActoviqDreamStateOptions {
+    currentSessionId?: string;
+}
+export interface PreparedActoviqDreamExecution {
+    prompt: string;
+    trigger: 'manual' | 'auto';
+    paths: ActoviqDreamPaths;
+    state: ActoviqDreamState;
+    touchedSessions: string[];
+    currentSessionId?: string;
+    priorMtime: number;
+    model?: string;
+    maxTokens?: number;
+    signal?: AbortSignal;
+}
+export interface ActoviqDreamBindings {
+    listSessions: () => Promise<StoredSession[]>;
+    runExecution: (request: PreparedActoviqDreamExecution) => Promise<ActoviqDreamRunResult>;
+    launchBackgroundExecution: (request: PreparedActoviqDreamExecution) => Promise<ActoviqBackgroundTaskRecord>;
+}
+export declare class ActoviqDreamApi {
+    private readonly memory;
+    private readonly bindings;
+    private readonly defaults;
+    private lastSessionScanAt;
+    constructor(memory: ActoviqMemoryApi, bindings: ActoviqDreamBindings, defaults: {
+        projectPath: string;
+        sessionDirectory: string;
+        config?: Partial<ActoviqDreamConfig>;
+    });
+    config(): ActoviqDreamConfig;
+    state(options?: BuildActoviqDreamStateOptions): Promise<ActoviqDreamState>;
+    run(options?: ActoviqDreamRunOptions): Promise<ActoviqDreamRunResult>;
+    maybeAutoDream(options?: ActoviqDreamRunOptions): Promise<ActoviqDreamRunResult>;
+    recordConsolidation(): Promise<void>;
+    private executeDream;
+}
+export declare function createActoviqDreamApi(memory: ActoviqMemoryApi, bindings: ActoviqDreamBindings, defaults: {
+    projectPath: string;
+    sessionDirectory: string;
+    config?: Partial<ActoviqDreamConfig>;
+}): ActoviqDreamApi;
+export declare function toDreamPaths(paths: {
+    autoMemoryDir: string;
+    teamMemoryDir: string;
+    autoMemoryEntrypoint: string;
+    teamMemoryEntrypoint: string;
+}, sessionDirectory: string): ActoviqDreamPaths;
+export declare function ensureActoviqDreamLayout(paths: ActoviqDreamPaths): Promise<void>;
+export declare function readActoviqLastConsolidatedAt(paths: ActoviqDreamPaths): Promise<number>;
+export declare function isActoviqDreamLockHeld(paths: ActoviqDreamPaths): Promise<boolean>;
+export declare function tryAcquireActoviqConsolidationLock(paths: ActoviqDreamPaths): Promise<number | null>;
+export declare function rollbackActoviqConsolidationLock(paths: ActoviqDreamPaths, priorMtime: number): Promise<void>;
+export declare function recordActoviqConsolidation(paths: ActoviqDreamPaths): Promise<void>;
+export declare function listActoviqSessionsTouchedSince(sessions: readonly StoredSession[], sinceMs: number, workDir: string, currentSessionId?: string): string[];
+export declare function buildActoviqDreamPrompt(paths: ActoviqDreamPaths, touchedSessions: readonly string[], extraContext?: string): string;
+export declare function isActoviqDreamEligibleSession(session: Pick<StoredSession, 'metadata'>): boolean;
+export {};
+//# sourceMappingURL=actoviqDream.d.ts.map

package/dist/src/memory/actoviqDream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actoviqDream.d.ts","sourceRoot":"","sources":["../../../src/memory/actoviqDream.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,2BAA2B,EAC3B,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EAEjB,aAAa,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAW3D,UAAU,6BAA6B;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC3B,KAAK,EAAE,iBAAiB,CAAC;IACzB,KAAK,EAAE,iBAAiB,CAAC;IACzB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC7C,YAAY,EAAE,CAAC,OAAO,EAAE,6BAA6B,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACzF,yBAAyB,EAAE,CACzB,OAAO,EAAE,6BAA6B,KACnC,OAAO,CAAC,2BAA2B,CAAC,CAAC;CAC3C;AAED,qBAAa,eAAe;IAIxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAL3B,OAAO,CAAC,iBAAiB,CAAK;gBAGX,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,EAAE;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,MAAM,CAAC;QACzB,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;KACtC;IAGH,MAAM,IAAI,kBAAkB;IAOtB,KAAK,CAAC,OAAO,GAAE,6BAAkC,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgD9E,GAAG,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAYzE,cAAc,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAYpF,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;YAO5B,YAAY;CAiF3B;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,EAAE;IACR,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACtC,GACA,eAAe,CAEjB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;CAC9B,EAAE,gBAAgB,EAAE,MAAM,GAAG,iBAAiB,CAS9C;AAED,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMtF;AAED,wBAAsB,6BAA6B,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAO7F;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAcvF;AAED,wBAAsB,kCAAkC,CACtD,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA6BxB;AAED,wBAAsB,gCAAgC,CACpD,KAAK,EAAE,iBAAiB,EACxB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAsB,0BAA0B,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxF;AAED,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,gBAAgB,CAAC,EAAE,MAAM,GACxB,MAAM,EAAE,CAOV;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,iBAAiB,EACxB,eAAe,EAAE,SAAS,MAAM,EAAE,EAClC,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAqDR;AA4BD,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,GACvC,OAAO,CAST"}

package/dist/src/memory/actoviqDream.js

@@ -0,0 +1,374 @@
+import { mkdir, readFile, stat, unlink, utimes, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { asError } from '../runtime/helpers.js';
+const DREAM_LOCK_FILE = '.consolidate-lock';
+const HOLDER_STALE_MS = 60 * 60 * 1000;
+const DEFAULT_DREAM_CONFIG = {
+    minHours: 24,
+    minSessions: 5,
+    scanIntervalMs: 10 * 60 * 1000,
+};
+export class ActoviqDreamApi {
+    memory;
+    bindings;
+    defaults;
+    lastSessionScanAt = 0;
+    constructor(memory, bindings, defaults) {
+        this.memory = memory;
+        this.bindings = bindings;
+        this.defaults = defaults;
+    }
+    config() {
+        return {
+            ...DEFAULT_DREAM_CONFIG,
+            ...(this.defaults.config ?? {}),
+        };
+    }
+    async state(options = {}) {
+        const [memoryState, sessions] = await Promise.all([
+            this.memory.state({
+                projectPath: this.defaults.projectPath,
+            }),
+            this.bindings.listSessions(),
+        ]);
+        const paths = toDreamPaths(memoryState.paths, this.defaults.sessionDirectory);
+        const lastConsolidatedAtMs = await readActoviqLastConsolidatedAt(paths);
+        const lockHeld = await isActoviqDreamLockHeld(paths);
+        const touchedSessions = listActoviqSessionsTouchedSince(sessions, lastConsolidatedAtMs, this.defaults.projectPath, options.currentSessionId);
+        const hoursSinceLastConsolidated = (Date.now() - lastConsolidatedAtMs) / 3_600_000;
+        const enabled = memoryState.enabled.autoDream;
+        const autoMemoryEnabled = memoryState.enabled.autoMemory;
+        let blockedReason;
+        if (!autoMemoryEnabled || !enabled) {
+            blockedReason = 'disabled';
+        }
+        else if (hoursSinceLastConsolidated < this.config().minHours) {
+            blockedReason = 'time_gate';
+        }
+        else if (touchedSessions.length < this.config().minSessions) {
+            blockedReason = 'session_gate';
+        }
+        else if (lockHeld) {
+            blockedReason = 'locked';
+        }
+        return {
+            enabled,
+            autoMemoryEnabled,
+            config: this.config(),
+            paths,
+            currentSessionId: options.currentSessionId,
+            lastConsolidatedAtMs,
+            lastConsolidatedAt: lastConsolidatedAtMs > 0 ? new Date(lastConsolidatedAtMs).toISOString() : undefined,
+            hoursSinceLastConsolidated,
+            sessionsSinceLastConsolidated: touchedSessions,
+            lockHeld,
+            canRun: blockedReason == null,
+            blockedReason,
+        };
+    }
+    async run(options = {}) {
+        return this.executeDream('manual', {
+            force: options.force ?? true,
+            background: false,
+            currentSessionId: options.currentSessionId,
+            extraContext: options.extraContext,
+            model: options.model,
+            maxTokens: options.maxTokens,
+            signal: options.signal,
+        });
+    }
+    async maybeAutoDream(options = {}) {
+        return this.executeDream('auto', {
+            force: options.force ?? false,
+            background: options.background ?? true,
+            currentSessionId: options.currentSessionId,
+            extraContext: options.extraContext,
+            model: options.model,
+            maxTokens: options.maxTokens,
+            signal: options.signal,
+        });
+    }
+    async recordConsolidation() {
+        const memoryPaths = await this.memory.paths({
+            projectPath: this.defaults.projectPath,
+        });
+        await recordActoviqConsolidation(toDreamPaths(memoryPaths, this.defaults.sessionDirectory));
+    }
+    async executeDream(trigger, options) {
+        const state = await this.state({
+            currentSessionId: options.currentSessionId,
+        });
+        if (trigger === 'auto' && !options.force) {
+            if (!state.autoMemoryEnabled || !state.enabled) {
+                return skippedDreamResult(trigger, state, state.blockedReason ?? 'disabled');
+            }
+            if (state.hoursSinceLastConsolidated < state.config.minHours) {
+                return skippedDreamResult(trigger, state, 'time_gate');
+            }
+            const sinceScanMs = Date.now() - this.lastSessionScanAt;
+            if (sinceScanMs < state.config.scanIntervalMs) {
+                return skippedDreamResult(trigger, state, 'scan_throttled');
+            }
+            this.lastSessionScanAt = Date.now();
+            if (state.sessionsSinceLastConsolidated.length < state.config.minSessions) {
+                return skippedDreamResult(trigger, state, 'session_gate');
+            }
+            if (state.lockHeld) {
+                return skippedDreamResult(trigger, state, 'locked');
+            }
+        }
+        if (!options.force && state.lockHeld) {
+            return skippedDreamResult(trigger, state, 'locked');
+        }
+        const priorMtime = await tryAcquireActoviqConsolidationLock(state.paths);
+        if (priorMtime == null) {
+            const lockedState = {
+                ...state,
+                lockHeld: true,
+                canRun: false,
+                blockedReason: 'locked',
+            };
+            return skippedDreamResult(trigger, lockedState, 'locked');
+        }
+        const execution = {
+            prompt: buildActoviqDreamPrompt(state.paths, state.sessionsSinceLastConsolidated, options.extraContext),
+            trigger,
+            paths: state.paths,
+            state,
+            touchedSessions: [...state.sessionsSinceLastConsolidated],
+            currentSessionId: options.currentSessionId,
+            priorMtime,
+            model: options.model,
+            maxTokens: options.maxTokens,
+            signal: options.signal,
+        };
+        if (options.background) {
+            try {
+                const task = await this.bindings.launchBackgroundExecution(execution);
+                return {
+                    success: true,
+                    skipped: false,
+                    trigger,
+                    state,
+                    touchedSessions: execution.touchedSessions,
+                    touchedFiles: [],
+                    task,
+                };
+            }
+            catch (error) {
+                await rollbackActoviqConsolidationLock(state.paths, priorMtime);
+                throw error;
+            }
+        }
+        return this.bindings.runExecution(execution);
+    }
+}
+export function createActoviqDreamApi(memory, bindings, defaults) {
+    return new ActoviqDreamApi(memory, bindings, defaults);
+}
+export function toDreamPaths(paths, sessionDirectory) {
+    return {
+        memoryDir: paths.autoMemoryDir,
+        teamMemoryDir: paths.teamMemoryDir,
+        memoryEntrypoint: paths.autoMemoryEntrypoint,
+        teamMemoryEntrypoint: paths.teamMemoryEntrypoint,
+        transcriptDir: path.join(sessionDirectory, 'sessions'),
+        lockPath: path.join(paths.autoMemoryDir, DREAM_LOCK_FILE),
+    };
+}
+export async function ensureActoviqDreamLayout(paths) {
+    await mkdir(paths.memoryDir, { recursive: true });
+    await mkdir(paths.teamMemoryDir, { recursive: true });
+    await mkdir(paths.transcriptDir, { recursive: true });
+    await ensureTextFile(paths.memoryEntrypoint);
+    await ensureTextFile(paths.teamMemoryEntrypoint);
+}
+export async function readActoviqLastConsolidatedAt(paths) {
+    try {
+        const stats = await stat(paths.lockPath);
+        return stats.mtimeMs;
+    }
+    catch {
+        return 0;
+    }
+}
+export async function isActoviqDreamLockHeld(paths) {
+    try {
+        const [stats, raw] = await Promise.all([
+            stat(paths.lockPath),
+            readFile(paths.lockPath, 'utf8').catch(() => ''),
+        ]);
+        if (Date.now() - stats.mtimeMs >= HOLDER_STALE_MS) {
+            return false;
+        }
+        const pid = Number.parseInt(raw.trim(), 10);
+        return Number.isFinite(pid) ? isProcessRunning(pid) : true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function tryAcquireActoviqConsolidationLock(paths) {
+    let previousMtime;
+    let holderPid;
+    try {
+        const [stats, raw] = await Promise.all([stat(paths.lockPath), readFile(paths.lockPath, 'utf8')]);
+        previousMtime = stats.mtimeMs;
+        const parsed = Number.parseInt(raw.trim(), 10);
+        holderPid = Number.isFinite(parsed) ? parsed : undefined;
+    }
+    catch {
+        previousMtime = undefined;
+    }
+    if (previousMtime != null &&
+        Date.now() - previousMtime < HOLDER_STALE_MS &&
+        holderPid != null &&
+        isProcessRunning(holderPid)) {
+        return null;
+    }
+    await mkdir(path.dirname(paths.lockPath), { recursive: true });
+    await writeFile(paths.lockPath, `${process.pid}\n`, 'utf8');
+    const verify = await readFile(paths.lockPath, 'utf8').catch(() => '');
+    if (Number.parseInt(verify.trim(), 10) !== process.pid) {
+        return null;
+    }
+    return previousMtime ?? 0;
+}
+export async function rollbackActoviqConsolidationLock(paths, priorMtime) {
+    try {
+        if (priorMtime === 0) {
+            await unlink(paths.lockPath);
+            return;
+        }
+        await writeFile(paths.lockPath, '', 'utf8');
+        const seconds = priorMtime / 1000;
+        await utimes(paths.lockPath, seconds, seconds);
+    }
+    catch {
+        // Best effort.
+    }
+}
+export async function recordActoviqConsolidation(paths) {
+    await mkdir(path.dirname(paths.lockPath), { recursive: true });
+    await writeFile(paths.lockPath, `${process.pid}\n`, 'utf8');
+}
+export function listActoviqSessionsTouchedSince(sessions, sinceMs, workDir, currentSessionId) {
+    return sessions
+        .filter((session) => session.id !== currentSessionId)
+        .filter(isActoviqDreamEligibleSession)
+        .filter((session) => isSessionInProject(session, workDir))
+        .filter((session) => getSessionTouchedAt(session) > sinceMs)
+        .map((session) => session.id);
+}
+export function buildActoviqDreamPrompt(paths, touchedSessions, extraContext) {
+    const additionalContext = [
+        touchedSessions.length > 0
+            ? `Sessions since last consolidation (${touchedSessions.length}):\n${touchedSessions.map(id => `- ${id}`).join('\n')}`
+            : undefined,
+        extraContext?.trim() ? extraContext.trim() : undefined,
+    ]
+        .filter((value) => typeof value === 'string' && value.trim().length > 0)
+        .join('\n\n');
+    return [
+        '# Dream: Memory Consolidation',
+        '',
+        'You are performing a reflective memory-consolidation pass.',
+        'Synthesize what has been learned recently into durable, well-organized memories so future sessions can orient quickly.',
+        '',
+        `Primary memory directory: \`${paths.memoryDir}\``,
+        `Team memory directory: \`${paths.teamMemoryDir}\``,
+        `Primary index: \`${paths.memoryEntrypoint}\``,
+        `Team index: \`${paths.teamMemoryEntrypoint}\``,
+        `Session store: \`${paths.transcriptDir}\``,
+        '',
+        'Use only the clean file tools available in this run: Read, Write, Edit, Glob, and Grep.',
+        'Always use absolute paths. Search narrowly. Do not read or rewrite large histories unless they are directly relevant.',
+        '',
+        '## Phase 1 - Orient',
+        '',
+        '- Inspect the memory directories and their indexes before making changes.',
+        '- Read existing memory files first so you improve them instead of creating duplicates.',
+        '',
+        '## Phase 2 - Gather recent signal',
+        '',
+        '- Search recent session files for durable facts, recurring workflow constraints, and corrected decisions.',
+        '- Prefer narrow Grep queries against the session store over broad full-file reads.',
+        '',
+        '## Phase 3 - Consolidate',
+        '',
+        '- Update existing memory files when possible.',
+        '- Create new memory files only when the information does not fit an existing topic.',
+        '- Convert relative dates to absolute dates.',
+        '- Remove or correct contradicted information instead of duplicating it.',
+        '',
+        '## Phase 4 - Prune and index',
+        '',
+        '- Keep each MEMORY.md file as a concise index rather than a content dump.',
+        '- Each index entry should be a short single-line pointer to a topic file.',
+        '- Remove stale or redundant index entries.',
+        '',
+        'Return a brief summary of what you consolidated, updated, or pruned. If nothing changed, say so clearly.',
+        additionalContext ? `\n## Additional context\n\n${additionalContext}` : '',
+    ]
+        .filter(Boolean)
+        .join('\n');
+}
+function skippedDreamResult(trigger, state, reason) {
+    return {
+        success: true,
+        skipped: true,
+        trigger,
+        reason,
+        state: {
+            ...state,
+            canRun: false,
+            blockedReason: reason,
+        },
+        touchedSessions: [...state.sessionsSinceLastConsolidated],
+        touchedFiles: [],
+    };
+}
+function getSessionTouchedAt(session) {
+    const raw = session.lastRunAt ?? session.updatedAt ?? session.createdAt;
+    const parsed = Date.parse(raw);
+    return Number.isFinite(parsed) ? parsed : 0;
+}
+export function isActoviqDreamEligibleSession(session) {
+    const metadata = session.metadata ?? {};
+    return (typeof metadata.__actoviqSwarmTeam !== 'string' &&
+        typeof metadata.__actoviqTeammateName !== 'string' &&
+        typeof metadata.__actoviqBackgroundParentRunId !== 'string' &&
+        typeof metadata.__actoviqBackgroundParentSessionId !== 'string' &&
+        typeof metadata.__actoviqSkillFork !== 'string');
+}
+function isSessionInProject(session, workDir) {
+    const sessionWorkDir = session.metadata?.__actoviqWorkDir;
+    if (typeof sessionWorkDir !== 'string' || sessionWorkDir.trim().length === 0) {
+        return true;
+    }
+    return normalizePathForCompare(sessionWorkDir) === normalizePathForCompare(workDir);
+}
+function normalizePathForCompare(value) {
+    const normalized = path.resolve(value);
+    return process.platform === 'win32' ? normalized.toLowerCase() : normalized;
+}
+function isProcessRunning(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        const normalized = asError(error);
+        return normalized.code === 'EPERM';
+    }
+}
+async function ensureTextFile(filePath) {
+    try {
+        await stat(filePath);
+    }
+    catch {
+        await mkdir(path.dirname(filePath), { recursive: true });
+        await writeFile(filePath, '', 'utf8');
+    }
+}
+//# sourceMappingURL=actoviqDream.js.map

package/dist/src/memory/actoviqDream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actoviqDream.js","sourceRoot":"","sources":["../../../src/memory/actoviqDream.ts"],"names":[],"mappings":"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"}

package/dist/src/runtime/actoviqSlashCommands.d.ts

@@ -1,8 +1,9 @@
-import type { ActoviqAgentDefinitionSummary, ActoviqCleanContextOverview, ActoviqCleanContextOverviewOptions, ActoviqCleanSlashCommandMetadata, ActoviqCleanSlashCommandName, ActoviqCleanToolLookupOptions, ActoviqCleanToolMetadata, ActoviqMemoryState, ActoviqRunSlashCommandOptions, ActoviqRunSlashCommandResult, ActoviqSessionCompactResult, ActoviqSkillDefinitionSummary, AgentSessionCompactOptions } from '../types.js';
+import type { ActoviqAgentDefinitionSummary, ActoviqCleanContextOverview, ActoviqCleanContextOverviewOptions, ActoviqCleanSlashCommandMetadata, ActoviqCleanSlashCommandName, ActoviqCleanToolLookupOptions, ActoviqCleanToolMetadata, ActoviqDreamRunResult, ActoviqMemoryState, ActoviqRunSlashCommandOptions, ActoviqRunSlashCommandResult, ActoviqSessionCompactResult, ActoviqSkillDefinitionSummary, AgentSessionCompactOptions } from '../types.js';
 interface ActoviqContextBindings {
     getOverview: (options?: ActoviqCleanContextOverviewOptions) => Promise<ActoviqCleanContextOverview>;
     compactSession: (sessionId: string, options?: AgentSessionCompactOptions) => Promise<ActoviqSessionCompactResult>;
     getMemoryState: (sessionId?: string, options?: ActoviqRunSlashCommandOptions['memory']) => Promise<ActoviqMemoryState>;
+    runDream: (sessionId?: string, options?: ActoviqRunSlashCommandOptions['dream']) => Promise<ActoviqDreamRunResult>;
     getToolMetadata: (options?: ActoviqCleanToolLookupOptions) => Promise<ActoviqCleanToolMetadata[]>;
     getSkillMetadata: () => ActoviqSkillDefinitionSummary[];
     getAgentMetadata: () => ActoviqAgentDefinitionSummary[];
@@ -14,6 +15,7 @@ export declare class ActoviqContextApi {
     describe(options?: ActoviqCleanContextOverviewOptions): Promise<string>;
     compact(sessionId: string, options?: AgentSessionCompactOptions): Promise<ActoviqSessionCompactResult>;
     memoryState(sessionId?: string, options?: ActoviqRunSlashCommandOptions['memory']): Promise<ActoviqMemoryState>;
+    dream(sessionId?: string, options?: ActoviqRunSlashCommandOptions['dream']): Promise<ActoviqDreamRunResult>;
     tools(options?: ActoviqCleanToolLookupOptions): Promise<ActoviqCleanToolMetadata[]>;
     skills(): ActoviqSkillDefinitionSummary[];
     agents(): ActoviqAgentDefinitionSummary[];
@@ -36,6 +38,7 @@ export declare class ActoviqSlashCommandsApi {
 export declare function formatActoviqContextOverview(overview: ActoviqCleanContextOverview): string;
 export declare function formatActoviqCompactResult(result: ActoviqSessionCompactResult): string;
 export declare function formatActoviqMemoryState(state: ActoviqMemoryState): string;
+export declare function formatActoviqDreamResult(result: ActoviqDreamRunResult): string;
 export declare function formatActoviqTools(tools: readonly ActoviqCleanToolMetadata[]): string;
 export declare function formatActoviqSkills(skills: readonly ActoviqSkillDefinitionSummary[]): string;
 export declare function formatActoviqAgents(agents: readonly ActoviqAgentDefinitionSummary[]): string;