agent-working-memory 0.6.0 → 0.7.0

package/README.md

@@ -65,7 +65,9 @@ Most "memory for AI" projects are vector databases with a retrieval wrapper. AWM
 | **Over time** | Grows forever, gets noisier | Consolidation: diameter-enforced clustering, cross-topic bridges, synaptic-tagged decay |
 | **Forgetting** | Manual cleanup | Cognitive forgetting: unused memories fade, reinforced knowledge persists (access-count modulated) |
 | **Feedback** | None | Useful/not-useful signals tune confidence and retrieval rank |
-| **Correction** | Delete and re-insert | Retraction: wrong memories invalidated, corrections linked, penalties propagate |
+| **Correction** | Delete and re-insert | Retraction: wrong memories invalidated, corrections linked, penalties propagate (depth 2, decaying) |
+| **Graph** | None or single graph | Multi-graph: semantic, temporal, causal, entity — independent traversal with fused scoring |
+| **Learning** | Unconditional co-activation | Validation-gated: edges strengthen only on positive feedback (Kairos-inspired) |
 | **Noise rejection** | None | Multi-channel agreement gate: requires 2+ retrieval channels to agree before returning results |
 | **Duplicates** | Stored repeatedly | Reinforce-on-duplicate: near-exact matches boost existing memory instead of creating copies |
 
@@ -394,22 +396,30 @@ npm run test:locomo   # LoCoMo industry benchmark (28.2%)
 
 All three ML models run locally via ONNX. No external API calls for retrieval. The entire system is a single SQLite file + a Node.js process.
 
-## What's New in v0.6.0
+## What's New in v0.7.0
+
+- **Workspace-scoped recall** — `memory_recall` can now search across all agents in a workspace. Essential for hive workflows where decisions and discoveries need to be instantly available to all agents. Set `AWM_WORKSPACE` env var or pass `workspace` parameter. Standalone agents unaffected.
+- **Validation-gated Hebbian learning** (Kairos-inspired) — associations only strengthen when `memory_feedback(useful=true)` confirms the retrieval was valuable. Prevents hub toxicity from noisy co-retrieval. No feedback = neutral. Negative feedback = slight weakening.
+- **Multi-graph traversal** (MAGMA-inspired) — graph walk decomposed into four orthogonal sub-graphs (semantic, temporal, causal, entity), each with independent beam search and specialized scoring. Boosts fused across sub-graphs. Inspired by MAGMA's 45.5% accuracy gains.
+- **Power-law edge decay** (DASH model) — edges decay via power law instead of exponential. Retains valuable old associations ~5x longer at 30 days. Matches empirical human forgetting curves.
+
+### v0.6.1
+
+- Embedding version tracking, batch backfill, deeper retraction propagation, retrieval timeouts, channel push delivery.
+
+### v0.6.0
 
 - **Memory taxonomy** — memories classified as `episodic`, `semantic`, `procedural`, or `unclassified`. Auto-classified on write. Filter by type on recall.
-- **Query-adaptive retrieval** — pipeline adapts to query type: `targeted` (boost exact matches), `exploratory` (wider graph walk, more semantic), `balanced` (default).
-- **Decision propagation** — decisions automatically broadcast to coordination layer for cross-agent discovery. Peer decisions shown on `memory_restore`.
-- **Completion verification** — workers must provide proof of work (result summary, optional commit SHA) when completing assignments.
-- **Task priority & dependencies** — priority field (0-10) and `blocked_by` for task ordering.
-- **Eval harness** — `npm run eval` benchmarks retrieval, associative, redundancy, and temporal performance with ablation mode.
+- **Query-adaptive retrieval** — pipeline adapts to query type: `targeted` | `exploratory` | `balanced` | `auto`.
+- **Decision propagation** — decisions broadcast to coordination layer for cross-agent discovery.
+- **Eval harness** — `npm run eval` benchmarks retrieval, associative, redundancy, and temporal performance.
 - **DB hardening** — busy_timeout, integrity check on startup, hot backups every 10 min, WAL checkpoint on shutdown.
-- **Consolidation recall fix** — redundancy pruning transfers associations and tags to survivor memory.
 
 See [CHANGELOG.md](CHANGELOG.md) for full details.
 
 ## Project Status
 
-AWM is in active development (v0.6.0). The core memory pipeline, consolidation system, multi-agent coordination, and MCP integration are stable and used daily in production coding workflows.
+AWM is in active development (v0.7.0). The core memory pipeline, consolidation system, multi-agent coordination, and MCP integration are stable and used daily in production coding workflows.
 
 - Core retrieval and consolidation: **stable**
 - MCP tools and Claude Code integration: **stable**

package/dist/adapters/claude-code.d.ts

@@ -0,0 +1,4 @@
+import type { CLIAdapter } from './types.js';
+declare const adapter: CLIAdapter;
+export default adapter;
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/adapters/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../src/adapters/claude-code.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAkC,MAAM,YAAY,CAAC;AAG7E,QAAA,MAAM,OAAO,EAAE,UAwNd,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/adapters/claude-code.js

@@ -0,0 +1,218 @@
+// Copyright 2026 Robert Winter / Complete Ideas
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Claude Code adapter — writes .mcp.json, CLAUDE.md, and hooks.
+ *
+ * This is a direct extraction of the original setup() behavior.
+ * Zero behavioral change from the monolithic version.
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join, dirname, basename } from 'node:path';
+import { resolveMcpCommand, homedir, AWM_INSTRUCTION_CONTENT } from './common.js';
+const adapter = {
+    id: 'claude-code',
+    name: 'Claude Code',
+    supportsProjectScope: true,
+    supportsGlobalScope: true,
+    writeMcpConfig(ctx) {
+        const mcpCmd = resolveMcpCommand(ctx);
+        const mcpConfig = { ...mcpCmd, env: ctx.envVars };
+        // Global: ~/.mcp.json (standard MCP location, all projects)
+        // Project: .claude/mcp.json (Claude Code's native project scope)
+        const mcpJsonPath = ctx.isGlobal
+            ? join(homedir(), '.mcp.json')
+            : join(ctx.cwd, '.claude', 'mcp.json');
+        const mcpDir = dirname(mcpJsonPath);
+        if (!existsSync(mcpDir)) {
+            mkdirSync(mcpDir, { recursive: true });
+        }
+        let existing = {};
+        if (existsSync(mcpJsonPath)) {
+            try {
+                existing = JSON.parse(readFileSync(mcpJsonPath, 'utf-8'));
+            }
+            catch {
+                existing = {};
+            }
+        }
+        if (!existing.mcpServers)
+            existing.mcpServers = {};
+        existing.mcpServers['agent-working-memory'] = mcpConfig;
+        writeFileSync(mcpJsonPath, JSON.stringify(existing, null, 2) + '\n');
+        return `MCP config: ${mcpJsonPath}`;
+    },
+    writeInstructions(ctx, skip) {
+        const claudeMdPath = ctx.isGlobal
+            ? join(homedir(), '.claude', 'CLAUDE.md')
+            : join(ctx.cwd, 'CLAUDE.md');
+        if (skip)
+            return 'CLAUDE.md: skipped (--no-instructions)';
+        // Ensure parent directory exists
+        const dir = dirname(claudeMdPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        if (existsSync(claudeMdPath)) {
+            const content = readFileSync(claudeMdPath, 'utf-8');
+            if (content.includes('## Memory (AWM)')) {
+                return 'CLAUDE.md: already has AWM section (skipped)';
+            }
+            writeFileSync(claudeMdPath, content.trimEnd() + '\n\n' + AWM_INSTRUCTION_CONTENT);
+            return 'CLAUDE.md: appended AWM workflow section';
+        }
+        const title = ctx.isGlobal ? '# Global Instructions' : `# ${basename(ctx.cwd)}`;
+        writeFileSync(claudeMdPath, `${title}\n\n${AWM_INSTRUCTION_CONTENT}`);
+        return 'CLAUDE.md: created with AWM workflow section';
+    },
+    writeHooks(ctx, skip) {
+        if (skip)
+            return 'Hooks: skipped (--no-hooks)';
+        const settingsPath = join(homedir(), '.claude', 'settings.json');
+        let settings = {};
+        if (existsSync(settingsPath)) {
+            try {
+                settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+            }
+            catch {
+                settings = {};
+            }
+        }
+        if (!settings.hooks)
+            settings.hooks = {};
+        const hookUrl = `http://127.0.0.1:${ctx.hookPort}/hooks/checkpoint`;
+        // Stop — remind Claude to write/recall/switch tasks
+        settings.hooks.Stop = [{
+                matcher: '',
+                hooks: [{
+                        type: 'command',
+                        command: 'echo "MEMORY: (1) Did you learn anything new? Call memory_write. (2) Are you about to work on a topic you might have prior knowledge about? Call memory_recall. (3) Switching tasks? Call memory_task_begin."',
+                        timeout: 5,
+                        async: true,
+                    }],
+            }];
+        // Multi-port fallback for separate memory pools
+        const altPort = ctx.hookPort === '8401' ? '8402' : '8401';
+        const hookUrlAlt = `http://127.0.0.1:${altPort}/hooks/checkpoint`;
+        const buildHookCmd = (event, maxTime) => {
+            const primary = `curl -sf -X POST ${hookUrl} -H "Content-Type: application/json" -H "Authorization: Bearer ${ctx.hookSecret}" -d "{\\"hook_event_name\\":\\"${event}\\"}" --max-time ${maxTime}`;
+            const fallback = `curl -sf -X POST ${hookUrlAlt} -H "Content-Type: application/json" -H "Authorization: Bearer ${ctx.hookSecret}" -d "{\\"hook_event_name\\":\\"${event}\\"}" --max-time ${maxTime}`;
+            return `${primary} || ${fallback}`;
+        };
+        // PreCompact — auto-checkpoint before context compaction
+        settings.hooks.PreCompact = [{
+                matcher: '',
+                hooks: [{
+                        type: 'command',
+                        command: buildHookCmd('PreCompact', 5),
+                        timeout: 10,
+                    }],
+            }];
+        // SessionEnd — auto-checkpoint on session close
+        settings.hooks.SessionEnd = [{
+                matcher: '',
+                hooks: [{
+                        type: 'command',
+                        command: buildHookCmd('SessionEnd', 2),
+                        timeout: 5,
+                    }],
+            }];
+        const settingsDir = dirname(settingsPath);
+        if (!existsSync(settingsDir)) {
+            mkdirSync(settingsDir, { recursive: true });
+        }
+        writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
+        return `Hooks: Stop + PreCompact + SessionEnd (port ${ctx.hookPort})`;
+    },
+    diagnose(ctx) {
+        const results = [];
+        // Check MCP config — Claude Code reads from both locations, check all
+        const globalPath = join(homedir(), '.mcp.json');
+        const projectPath = join(ctx.cwd, '.claude', 'mcp.json');
+        const candidates = [projectPath, globalPath];
+        let foundConfig = false;
+        for (const mcpJsonPath of candidates) {
+            if (!existsSync(mcpJsonPath))
+                continue;
+            try {
+                const config = JSON.parse(readFileSync(mcpJsonPath, 'utf-8'));
+                if (config.mcpServers?.['agent-working-memory']) {
+                    results.push({ check: 'MCP config', status: 'ok', message: `AWM registered in ${mcpJsonPath}` });
+                    foundConfig = true;
+                    break;
+                }
+            }
+            catch { /* not valid JSON, skip */ }
+        }
+        if (!foundConfig) {
+            results.push({
+                check: 'MCP config',
+                status: 'fail',
+                message: 'No AWM MCP config found',
+                fix: `Run: awm setup claude-code${ctx.isGlobal ? ' --global' : ''}`,
+            });
+        }
+        // Check MCP entrypoint
+        if (ctx.hasDist) {
+            results.push({ check: 'MCP entrypoint', status: 'ok', message: `dist/mcp.js exists` });
+        }
+        else {
+            results.push({
+                check: 'MCP entrypoint',
+                status: 'warn',
+                message: 'dist/mcp.js not found — using dev mode (npx tsx)',
+                fix: 'Run: npm run build',
+            });
+        }
+        // Check database
+        if (existsSync(ctx.dbPath)) {
+            results.push({ check: 'Database', status: 'ok', message: ctx.dbPath });
+        }
+        else {
+            results.push({ check: 'Database', status: 'warn', message: `${ctx.dbPath} not found (will be created on first use)` });
+        }
+        // Check CLAUDE.md
+        const claudeMdPath = ctx.isGlobal
+            ? join(homedir(), '.claude', 'CLAUDE.md')
+            : join(ctx.cwd, 'CLAUDE.md');
+        if (existsSync(claudeMdPath)) {
+            const content = readFileSync(claudeMdPath, 'utf-8');
+            if (content.includes('## Memory (AWM)')) {
+                results.push({ check: 'Instructions', status: 'ok', message: `CLAUDE.md has AWM section` });
+            }
+            else {
+                results.push({
+                    check: 'Instructions',
+                    status: 'warn',
+                    message: `CLAUDE.md exists but missing AWM section`,
+                    fix: `Run: awm setup claude-code${ctx.isGlobal ? ' --global' : ''}`,
+                });
+            }
+        }
+        else {
+            results.push({ check: 'Instructions', status: 'warn', message: `CLAUDE.md not found` });
+        }
+        // Check hooks
+        const settingsPath = join(homedir(), '.claude', 'settings.json');
+        if (existsSync(settingsPath)) {
+            try {
+                const settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+                const hasHooks = settings.hooks?.PreCompact && settings.hooks?.SessionEnd;
+                if (hasHooks) {
+                    results.push({ check: 'Hooks', status: 'ok', message: 'PreCompact + SessionEnd configured' });
+                }
+                else {
+                    results.push({ check: 'Hooks', status: 'warn', message: 'Hooks partially configured' });
+                }
+            }
+            catch {
+                results.push({ check: 'Hooks', status: 'warn', message: 'settings.json is not valid JSON' });
+            }
+        }
+        else {
+            results.push({ check: 'Hooks', status: 'warn', message: 'No hooks configured (auto-checkpoint disabled)' });
+        }
+        return results;
+    },
+};
+export default adapter;
+//# sourceMappingURL=claude-code.js.map

package/dist/adapters/claude-code.js.map

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

package/dist/adapters/codex.d.ts

@@ -0,0 +1,4 @@
+import type { CLIAdapter } from './types.js';
+declare const adapter: CLIAdapter;
+export default adapter;
+//# sourceMappingURL=codex.d.ts.map

package/dist/adapters/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/adapters/codex.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAkC,MAAM,YAAY,CAAC;AA4G7E,QAAA,MAAM,OAAO,EAAE,UA2Id,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/adapters/codex.js

@@ -0,0 +1,226 @@
+// Copyright 2026 Robert Winter / Complete Ideas
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Codex CLI adapter — writes TOML config, AGENTS.md instructions.
+ *
+ * Codex stores MCP config in ~/.codex/config.toml (global only).
+ * Uses snake_case [mcp_servers.name] sections.
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join, dirname, basename } from 'node:path';
+import { resolveMcpCommand, homedir, AWM_INSTRUCTION_CONTENT } from './common.js';
+function parseTOML(content) {
+    const doc = { sections: new Map(), preamble: [] };
+    let currentSection = '';
+    const lines = content.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Section header
+        const sectionMatch = trimmed.match(/^\[([^\]]+)\]$/);
+        if (sectionMatch) {
+            currentSection = sectionMatch[1];
+            if (!doc.sections.has(currentSection)) {
+                doc.sections.set(currentSection, {});
+            }
+            continue;
+        }
+        // Skip comments and empty lines
+        if (!trimmed || trimmed.startsWith('#')) {
+            if (!currentSection)
+                doc.preamble.push(line);
+            continue;
+        }
+        // Key = value
+        const eqIdx = trimmed.indexOf('=');
+        if (eqIdx === -1) {
+            if (!currentSection)
+                doc.preamble.push(line);
+            continue;
+        }
+        const key = trimmed.slice(0, eqIdx).trim();
+        const rawVal = trimmed.slice(eqIdx + 1).trim();
+        if (!currentSection) {
+            if (!doc.sections.has(''))
+                doc.sections.set('', {});
+            doc.sections.get('')[key] = parseTomlValue(rawVal);
+            continue;
+        }
+        if (!doc.sections.has(currentSection)) {
+            doc.sections.set(currentSection, {});
+        }
+        doc.sections.get(currentSection)[key] = parseTomlValue(rawVal);
+    }
+    return doc;
+}
+function parseTomlValue(raw) {
+    // Array: ["a", "b"]
+    if (raw.startsWith('[')) {
+        const inner = raw.slice(1, raw.lastIndexOf(']'));
+        return inner.split(',')
+            .map(s => s.trim().replace(/^["']|["']$/g, ''))
+            .filter(s => s.length > 0);
+    }
+    // Quoted string
+    return raw.replace(/^["']|["']$/g, '');
+}
+function serializeTOML(doc) {
+    const lines = [];
+    // Preamble (top-level content before any section)
+    if (doc.preamble.length > 0) {
+        lines.push(...doc.preamble);
+        if (lines.length > 0 && lines[lines.length - 1].trim() !== '') {
+            lines.push('');
+        }
+    }
+    for (const [section, values] of doc.sections) {
+        if (section === '')
+            continue; // already in preamble
+        lines.push(`[${section}]`);
+        for (const [key, val] of Object.entries(values)) {
+            if (Array.isArray(val)) {
+                const items = val.map(v => `"${v}"`).join(', ');
+                lines.push(`${key} = [${items}]`);
+            }
+            else {
+                lines.push(`${key} = "${val}"`);
+            }
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+// ─── Adapter ──────────────────────────────────────────
+const adapter = {
+    id: 'codex',
+    name: 'Codex',
+    supportsProjectScope: false,
+    supportsGlobalScope: true,
+    writeMcpConfig(ctx) {
+        if (!ctx.isGlobal) {
+            console.log('  Note: Codex only supports global MCP config. Using --global automatically.');
+        }
+        const configPath = join(homedir(), '.codex', 'config.toml');
+        const mcpCmd = resolveMcpCommand(ctx);
+        // Read existing config or start fresh
+        let doc;
+        if (existsSync(configPath)) {
+            doc = parseTOML(readFileSync(configPath, 'utf-8'));
+        }
+        else {
+            doc = { sections: new Map(), preamble: [] };
+            mkdirSync(dirname(configPath), { recursive: true });
+        }
+        // Write the MCP server section
+        const sectionName = 'mcp_servers.agent-working-memory';
+        doc.sections.set(sectionName, {
+            command: mcpCmd.command,
+            args: mcpCmd.args,
+        });
+        // Write env vars in a sub-section
+        const envSection = `${sectionName}.env`;
+        const envEntries = {};
+        for (const [key, val] of Object.entries(ctx.envVars)) {
+            envEntries[key] = val;
+        }
+        doc.sections.set(envSection, envEntries);
+        writeFileSync(configPath, serializeTOML(doc));
+        return `MCP config: ${configPath}`;
+    },
+    writeInstructions(ctx, skip) {
+        const agentsMdPath = join(ctx.cwd, 'AGENTS.md');
+        if (skip)
+            return 'AGENTS.md: skipped (--no-instructions)';
+        if (existsSync(agentsMdPath)) {
+            const content = readFileSync(agentsMdPath, 'utf-8');
+            if (content.includes('## Memory (AWM)')) {
+                return 'AGENTS.md: already has AWM section (skipped)';
+            }
+            writeFileSync(agentsMdPath, content.trimEnd() + '\n\n' + AWM_INSTRUCTION_CONTENT);
+            return 'AGENTS.md: appended AWM workflow section';
+        }
+        const title = `# ${basename(ctx.cwd)} — Agent Instructions`;
+        writeFileSync(agentsMdPath, `${title}\n\n${AWM_INSTRUCTION_CONTENT}`);
+        return 'AGENTS.md: created with AWM workflow section';
+    },
+    writeHooks(_ctx, _skip) {
+        return 'Hooks: not supported by Codex (auto-checkpoint unavailable)';
+    },
+    diagnose(ctx) {
+        const results = [];
+        // Check TOML config
+        const configPath = join(homedir(), '.codex', 'config.toml');
+        if (!existsSync(configPath)) {
+            results.push({
+                check: 'MCP config',
+                status: 'fail',
+                message: `${configPath} not found`,
+                fix: 'Run: awm setup codex',
+            });
+        }
+        else {
+            try {
+                const doc = parseTOML(readFileSync(configPath, 'utf-8'));
+                if (doc.sections.has('mcp_servers.agent-working-memory')) {
+                    results.push({ check: 'MCP config', status: 'ok', message: `AWM registered in ${configPath}` });
+                    // Verify the command points to a real file
+                    const section = doc.sections.get('mcp_servers.agent-working-memory');
+                    const args = section.args;
+                    if (Array.isArray(args) && args.length > 0) {
+                        const entrypoint = args[args.length - 1];
+                        if (existsSync(entrypoint)) {
+                            results.push({ check: 'MCP entrypoint', status: 'ok', message: entrypoint });
+                        }
+                        else {
+                            results.push({
+                                check: 'MCP entrypoint',
+                                status: 'fail',
+                                message: `Configured entrypoint not found: ${entrypoint}`,
+                                fix: 'Run: npm run build (in AWM package) then awm setup codex',
+                            });
+                        }
+                    }
+                }
+                else {
+                    results.push({
+                        check: 'MCP config',
+                        status: 'fail',
+                        message: 'config.toml exists but missing agent-working-memory section',
+                        fix: 'Run: awm setup codex',
+                    });
+                }
+            }
+            catch {
+                results.push({ check: 'MCP config', status: 'fail', message: `${configPath} could not be parsed` });
+            }
+        }
+        // Check database
+        if (existsSync(ctx.dbPath)) {
+            results.push({ check: 'Database', status: 'ok', message: ctx.dbPath });
+        }
+        else {
+            results.push({ check: 'Database', status: 'warn', message: `${ctx.dbPath} not found (will be created on first use)` });
+        }
+        // Check AGENTS.md
+        const agentsMdPath = join(ctx.cwd, 'AGENTS.md');
+        if (existsSync(agentsMdPath)) {
+            const content = readFileSync(agentsMdPath, 'utf-8');
+            if (content.includes('## Memory (AWM)')) {
+                results.push({ check: 'Instructions', status: 'ok', message: 'AGENTS.md has AWM section' });
+            }
+            else {
+                results.push({
+                    check: 'Instructions',
+                    status: 'warn',
+                    message: 'AGENTS.md exists but missing AWM section',
+                    fix: 'Run: awm setup codex',
+                });
+            }
+        }
+        else {
+            results.push({ check: 'Instructions', status: 'warn', message: 'AGENTS.md not found' });
+        }
+        return results;
+    },
+};
+export default adapter;
+//# sourceMappingURL=codex.js.map

package/dist/adapters/codex.js.map

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

package/dist/adapters/common.d.ts

@@ -0,0 +1,34 @@
+import type { SetupContext } from './types.js';
+/** Resolve the AWM package root (where src/ and dist/ live). */
+export declare function resolvePackageRoot(): string;
+/** Resolve the database path — default to <packageRoot>/data/memory.db. */
+export declare function resolveDbPath(packageRoot: string, explicit?: string | null): string;
+/** Read or generate the hook secret token. */
+export declare function resolveHookSecret(dbPath: string): string;
+/** Build environment variables for the MCP server process. */
+export declare function buildEnvVars(dbPath: string, agentId: string, hookPort: string, hookSecret: string, isWindows: boolean): Record<string, string>;
+/**
+ * Resolve the MCP server command + args.
+ *
+ * Prefers absolute path to dist/mcp.js (works from any cwd).
+ * Falls back to npx tsx src/mcp.ts for dev mode.
+ */
+export declare function resolveMcpCommand(ctx: SetupContext): {
+    command: string;
+    args: string[];
+};
+/** Build a full SetupContext from parsed CLI flags. */
+export declare function buildSetupContext(opts: {
+    agentId?: string;
+    dbPath?: string | null;
+    isGlobal: boolean;
+    hookPort: string;
+}): SetupContext;
+/** Home directory. */
+export declare function homedir(): string;
+/**
+ * Core AWM instruction snippet — shared across all adapters.
+ * Each adapter wraps this in the appropriate file format.
+ */
+export declare const AWM_INSTRUCTION_CONTENT: string;
+//# sourceMappingURL=common.d.ts.map

package/dist/adapters/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/adapters/common.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/C,gEAAgE;AAChE,wBAAgB,kBAAkB,IAAI,MAAM,CAG3C;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAOnF;AAED,8CAA8C;AAC9C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAUxD;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,OAAO,GACjB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAkBA;AAED,uDAAuD;AACvD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,YAAY,CA6Bf;AAED,sBAAsB;AACtB,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAID;;;GAGG;AACH,eAAO,MAAM,uBAAuB,QA6BvB,CAAC"}