aura-code 0.6.3 → 0.10.1

package/dist/agent/mixture.js

@@ -0,0 +1,138 @@
+"use strict";
+/**
+ * Mixture of Agents — Phase 2: parallel domain sub-agents.
+ *
+ * For exploratory-shaped tasks (per loop-profile.ts — that's where ambiguity
+ * actually benefits from multiple angles), fan out 2-3 read-only sub-agents
+ * in parallel, each framed with a different domain lens, then synthesize
+ * their reports into one answer with a real model call.
+ *
+ * Design constraints (see docs/MIXTURE_OF_AGENTS.md):
+ * - Read-only only — parallel sub-agents never edit files.
+ * - Gated by task shape AND an explicit opt-in (--moa). The N-call cost is
+ *   real; it stays off the default path until benchmarks justify it.
+ * - Synthesis is an actual provider call — reconciling N expert opinions
+ *   is judgment, not pattern matching.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runMixtureOfAgents = runMixtureOfAgents;
+const loop_js_1 = require("./loop.js");
+const permissions_js_1 = require("../safety/permissions.js");
+const domain_expertise_js_1 = require("./domain-expertise.js");
+/**
+ * Sub-agent streams would interleave garbage if they all wrote to the real
+ * display. Mute everything except warnings/errors, which are rare and
+ * worth surfacing (prefixed so the user can tell whose they are).
+ */
+function mutedDisplay(base, label) {
+    return {
+        agentThinking: () => { },
+        streamText: () => { },
+        streamEnd: () => { },
+        toolStart: () => { },
+        toolCall: () => { },
+        toolResult: () => { },
+        toolBlocked: () => { },
+        warning: (msg) => base.warning(`[${label}] ${msg}`),
+        success: () => { },
+        error: (msg) => base.error(`[${label}] ${msg}`),
+        header: () => { },
+        summary: () => { },
+        showPlan: () => { },
+        stepStarted: () => { },
+        stepCompleted: () => { },
+        contextBar: () => { },
+        contextDashboard: () => { },
+        compactionEvent: () => { },
+    };
+}
+function perspectiveTask(lens, task) {
+    return [
+        `You are investigating as a ${lens} specialist. You are in read-only mode — do not modify any files or run state-changing commands.`,
+        '',
+        `Task: ${task}`,
+        '',
+        `Investigate the codebase strictly from the ${lens} angle. Your final message must be a compact report:`,
+        '1. FINDINGS — concrete observations with file paths / line references.',
+        `2. ANSWER — the most likely explanation or answer from the ${lens} perspective.`,
+        '3. CONFIDENCE — low / medium / high, with one sentence why.',
+    ].join('\n');
+}
+const SYNTHESIS_SYSTEM = [
+    'You are synthesizing reports from parallel specialist investigators who each examined the same task from a different angle.',
+    'Reconcile them into ONE answer: where they agree, state it plainly; where they conflict, weigh confidence and evidence and say which reading you trust and why.',
+    'Do not enumerate the reports back — produce the merged answer a user should act on, citing file paths the specialists found.',
+].join(' ');
+/**
+ * Run the mixture: N parallel read-only sub-agents + one synthesis call.
+ * Returns a LoopResult so callers can treat it exactly like a single-agent
+ * run (summary display, cost footer, exit codes).
+ */
+async function runMixtureOfAgents(opts) {
+    const { provider, task, context, display } = opts;
+    const domains = (0, domain_expertise_js_1.classifyDomains)(task);
+    const lenses = domains.length > 0
+        ? [...domains, 'generalist']
+        : ['architecture', 'generalist'];
+    display.header('Mixture of Agents', `${lenses.length} parallel read-only perspectives: ${lenses.join(', ')}`);
+    const runs = await Promise.all(lenses.map((lens) => (0, loop_js_1.runAgentLoop)({
+        provider,
+        task: perspectiveTask(lens, task),
+        context,
+        permissions: new permissions_js_1.PermissionSystem('read-only'),
+        display: mutedDisplay(display, lens),
+        // Sub-agents must not fan out further — one level of parallelism.
+        disableSpawn: true,
+        pricingModel: opts.pricingModel,
+    }).catch((e) => ({
+        success: false,
+        summary: `Perspective failed: ${String(e)}`,
+        turns: 0, toolCallCount: 0,
+        usage: { inputTokens: 0, outputTokens: 0, totalTokens: 0 },
+        costUsd: 0, history: [], toolCallLog: [],
+    }))));
+    runs.forEach((r, i) => {
+        display.success(`[${lenses[i]}] ${r.success ? 'reported' : 'failed'} — ${r.turns} turns, $${r.costUsd.toFixed(4)}`);
+    });
+    const usage = runs.reduce((acc, r) => ({
+        inputTokens: acc.inputTokens + r.usage.inputTokens,
+        outputTokens: acc.outputTokens + r.usage.outputTokens,
+        totalTokens: acc.totalTokens + r.usage.totalTokens,
+    }), { inputTokens: 0, outputTokens: 0, totalTokens: 0 });
+    const turns = runs.reduce((n, r) => n + r.turns, 0);
+    const toolCallCount = runs.reduce((n, r) => n + r.toolCallCount, 0);
+    let costUsd = runs.reduce((c, r) => c + r.costUsd, 0);
+    const succeeded = runs.filter((r) => r.success);
+    if (succeeded.length === 0) {
+        return {
+            success: false,
+            summary: `All ${lenses.length} perspectives failed:\n${runs.map((r, i) => `[${lenses[i]}] ${r.summary}`).join('\n')}`,
+            turns, toolCallCount, usage, costUsd, history: [], toolCallLog: [],
+        };
+    }
+    const reports = runs
+        .map((r, i) => `## Report from the ${lenses[i]} specialist${r.success ? '' : ' (FAILED — weigh accordingly)'}\n\n${r.summary}`)
+        .join('\n\n');
+    display.agentThinking();
+    const synthesis = await provider.complete(SYNTHESIS_SYSTEM, [
+        { role: 'user', content: `Original task: ${task}\n\n${reports}` },
+    ], []);
+    const su = synthesis.usage;
+    if (su) {
+        usage.inputTokens += su.inputTokens ?? 0;
+        usage.outputTokens += su.outputTokens ?? 0;
+        usage.totalTokens += (su.inputTokens ?? 0) + (su.outputTokens ?? 0);
+        costUsd += (0, loop_js_1.costFor)(opts.pricingModel ?? provider.model, su.inputTokens ?? 0, su.outputTokens ?? 0);
+    }
+    return {
+        success: true,
+        summary: synthesis.text || '(Synthesis produced no output)',
+        turns: turns + 1,
+        toolCallCount,
+        usage,
+        costUsd,
+        history: [{ role: 'user', content: task }, { role: 'assistant', content: synthesis.text }],
+        toolCallLog: runs.flatMap((r) => r.toolCallLog),
+    };
+}
+//# sourceMappingURL=mixture.js.map

package/dist/agent/mixture.js.map

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

package/dist/agent/spawner.js

@@ -39,7 +39,6 @@ exports.clearSpawner = clearSpawner;
 exports.makeDefaultSpawner = makeDefaultSpawner;
 exports.executeSpawnTask = executeSpawnTask;
 const factory_js_1 = require("../providers/factory.js");
-const defaults_js_1 = require("../config/defaults.js");
 let active = null;
 /**
  * Wire up the spawn_task tool to a real implementation. Called by the
@@ -74,7 +73,8 @@ function makeDefaultSpawner(ctx, baseConfig, display) {
                 context: ctx,
                 permissions: new PermissionSystem(level),
                 display,
-                maxTurns: defaults_js_1.DEFAULTS.maxTurns,
+                // No explicit maxTurns: let loop-profile size the sub-agent's
+                // budget from its task shape, same as the top-level loop.
             });
             const cost = result.costUsd.toFixed(4);
             return `[subagent ${model}]\n${result.summary}\n[cost: $${cost} · ${result.turns} turns · ${result.toolCallCount} tools]`;

package/dist/agent/spawner.js.map

@@ -1 +1 @@
-{"version":3,"file":"spawner.js","sourceRoot":"","sources":["../../src/agent/spawner.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,0CAEC;AAED,oCAEC;AAKD,gDA6BC;AAED,4CAWC;AAjFD,wDAAyD;AAGzD,uDAAiD;AAkBjD,IAAI,MAAM,GAAyB,IAAI,CAAC;AAExC;;;;GAIG;AACH,SAAgB,eAAe,CAAC,OAAsB;IACpD,MAAM,GAAG,OAAO,CAAC;AACnB,CAAC;AAED,SAAgB,YAAY;IAC1B,MAAM,GAAG,IAAI,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAChC,GAAmB,EACnB,UAAqE,EACrE,OAAgB;IAEhB,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,IAAkB;YAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,eAAe,CAAC;YAC5C,MAAM,QAAQ,GAAgB,IAAA,2BAAc,EAAC;gBAC3C,KAAK;gBACL,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO;aAC5D,CAAC,CAAC;YACH,iEAAiE;YACjE,MAAM,EAAE,YAAY,EAAE,GAAG,wDAAa,WAAW,GAAC,CAAC;YACnD,MAAM,EAAE,gBAAgB,EAAE,GAAG,wDAAa,0BAA0B,GAAC,CAAC;YACtE,MAAM,KAAK,GAAyB,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC;YACzE,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;gBAChC,QAAQ;gBACR,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,GAAG;gBACZ,WAAW,EAAE,IAAI,gBAAgB,CAAC,KAAK,CAAC;gBACxC,OAAO;gBACP,QAAQ,EAAE,sBAAQ,CAAC,QAAQ;aAC5B,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACvC,OAAO,aAAa,KAAK,MAAM,MAAM,CAAC,OAAO,aAAa,IAAI,MAAM,MAAM,CAAC,KAAK,YAAY,MAAM,CAAC,aAAa,SAAS,CAAC;QAC5H,CAAC;KACF,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,gBAAgB,CAAC,KAA8B;IACnE,IAAI,CAAC,MAAM;QAAE,OAAO,oDAAoD,CAAC;IACzE,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,IAAI,CAAC,IAAI;QAAE,OAAO,+CAA+C,CAAC;IAClE,MAAM,IAAI,GAAiB;QACzB,IAAI;QACJ,KAAK,EAAE,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QAChE,QAAQ,EAAE,KAAK,CAAC,QAAQ,KAAK,IAAI;QACjC,GAAG,EAAE,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;KAC3D,CAAC;IACF,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAEY,QAAA,qBAAqB,GAAG;IACnC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,oLAAoL;IACjM,UAAU,EAAE;QACV,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAK,EAAE,IAAI,EAAE,QAAQ,EAAG,WAAW,EAAE,wCAAwC,EAAE;YACnF,KAAK,EAAI,EAAE,IAAI,EAAE,QAAQ,EAAG,WAAW,EAAE,yDAAyD,EAAE;YACpG,QAAQ,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,uFAAuF,EAAE;YAClI,GAAG,EAAM,EAAE,IAAI,EAAE,QAAQ,EAAG,WAAW,EAAE,8CAA8C,EAAE;SAC1F;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;CACF,CAAC"}
+{"version":3,"file":"spawner.js","sourceRoot":"","sources":["../../src/agent/spawner.ts"],"names":[],"mappings":"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"}

package/dist/agent/system-prompt.d.ts

@@ -1,3 +1,3 @@
 import type { ProjectContext } from './context.js';
-export declare function buildSystemPrompt(ctx: ProjectContext, providerName: string, task?: string): string;
+export declare function buildSystemPrompt(ctx: ProjectContext, providerName: string, task: string): string;
 export declare function buildArchitectPrompt(task: string, projectRoot: string): string;

package/dist/agent/system-prompt.js

@@ -2,18 +2,21 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildSystemPrompt = buildSystemPrompt;
 exports.buildArchitectPrompt = buildArchitectPrompt;
-const design_js_1 = require("./design.js");
+const domain_expertise_js_1 = require("./domain-expertise.js");
+const unified_memory_js_1 = require("./unified-memory.js");
+const confess_js_1 = require("./confess.js");
+const loader_js_1 = require("../plugins/loader.js");
+const WEB_KEYWORDS = /website|webpage|frontend|front-end|ui component|landing page|homepage|web app|portfolio|hero section|marketing page|site design|visual design|html.*css|make.*page|create.*page|build.*site/;
 function buildSystemPrompt(ctx, providerName, task) {
-    const design = task ? (0, design_js_1.selectDesign)(ctx.root, task) : null;
-    const designSection = design ? (0, design_js_1.designPromptSection)(design) : '';
-    // Optional sections — only included when data exists, so new users
-    // with no dreams or graph don't see empty placeholders.
-    const graphSection = ctx.graphSummary
-        ? `\n### Codebase knowledge graph\n${ctx.graphSummary}\n`
-        : '';
-    const memorySection = ctx.reconciledMemory
-        ? `\n### Memory (from past sessions)\nThe following lessons, patterns, and open threads were distilled from your previous work on this project. Use them to avoid repeating past mistakes and to continue unfinished work.\n\n${ctx.reconciledMemory}\n`
-        : '';
+    const domainBlock = (0, domain_expertise_js_1.getDomainPromptBlock)(task);
+    // Unified memory: global identity/facts (shared with the Telegram bot) plus
+    // this project's reconciled lessons. Replaces the old dreams-only block.
+    const memoryBlock = (0, unified_memory_js_1.loadUnifiedMemory)({ projectRoot: ctx.root });
+    // Confessions: permanent lessons extracted from high-cost failures.
+    // Loaded separately so they sit above regular memory with elevated priority.
+    const confessionsBlock = (0, confess_js_1.loadConfessionsSection)();
+    // Plugin skills: inject relevant plugin skills when task matches their domain.
+    const pluginBlock = loadPluginSkillsBlock(task);
     return `You are Aura — a precise, efficient AI coding agent.
 You are working in a ${ctx.language} project called "${ctx.name}" (${ctx.framework}).
 
@@ -35,22 +38,22 @@ You are working in a ${ctx.language} project called "${ctx.name}" (${ctx.framewo
 - When done, summarize exactly what changed and what was verified (tests passed, build succeeded, specific checks that passed).
 - If the task requires a code change, you must eventually call write_file or edit_file to apply it. Do not spend all turns on read_file and search_code — at some point you must commit to making the change. Aim for a 2:1 ratio of reads to writes, not 100% reads.
 - Never respond to a task with only prose. Always begin by using at least one tool (search_code, read_file, or list_dir) to investigate the codebase before summarizing or concluding. A response with zero tool calls is almost always incomplete.
-- Not every task is a coding task. For questions, research, or information requests, use web_search/web_fetch and respond with the information directly — no code changes needed.
 
-## Web and information tools
-- You have web_search and web_fetch tools. USE THEM for any question about current events, weather, news, documentation, or anything that requires up-to-date information.
-- When web_search returns results, READ THE RESULTS — they are already in your context. Extract the relevant information (temperatures, dates, facts, summaries) and present it directly to the user. Do NOT say "I can't browse the results" — you already have them.
-- If search results contain snippets with the answer, give the answer directly. If you need more detail, use web_fetch on the most relevant URL to get the full page content.
-- For weather: extract temperature, conditions, humidity, wind from the search snippets and present them clearly.
-- For documentation/articles: summarize the key points, don't just list links.
-- You are NOT limited to coding tasks. You can research, summarize, explain, translate, and answer general knowledge questions using your tools and knowledge.
+## Tool call arguments
+- Never inline large multi-line content (HTML, generated code, long files) as a raw string inside a tool call's JSON arguments — models frequently produce invalid JSON when escaping quotes/newlines in big blocks, causing repeated failed calls.
+- For content longer than ~30 lines, write it via run_shell using a heredoc (cat > file << 'EOF' ... EOF), or build it incrementally with edit_file on small, well-escaped chunks.
+
+## Images and screenshots
+- You CAN read local image files (screenshots, diagrams, photos). Never tell the user you cannot access local files or \`file://\` paths — you have the image_read tool.
+- When the user references an image path — a plain path, or a \`file://\` URL like \`file:///home/user/shot.png\` — call \`image_read\` with \`action=ocr\` to extract the text/content, then answer from what it actually contains. Use \`action=info\` for dimensions/format.
+- Never guess or invent what an image shows, and never ask the user to describe it before trying image_read first. Read it, then reason about it.
 
 ## Code standards
 - Match the existing code style: indentation, naming conventions, comment style.
 - Do not introduce new dependencies unless explicitly asked.
 - Prefer targeted, minimal changes over rewrites.
 - Add or update tests when you modify logic.
-
+${domainBlock}${memoryBlock}${confessionsBlock}${pluginBlock}
 ## Safety
 - Never delete files unless explicitly instructed.
 - Never commit to git unless explicitly instructed.
@@ -78,8 +81,33 @@ ${ctx.readme}
 
 ### Recent git history
 ${ctx.recentCommits}
-${graphSection}${memorySection}
-Provider: ${providerName}. Work efficiently — minimize unnecessary tool calls.${designSection}`;
+
+Provider: ${providerName}. Work efficiently — minimize unnecessary tool calls.`;
+}
+/** Load plugin skills relevant to the current task. Cached per process. */
+let _pluginSkillsCache = null;
+function loadPluginSkillsBlock(task) {
+    if (_pluginSkillsCache === null) {
+        try {
+            const plugins = (0, loader_js_1.loadAllPlugins)();
+            const lines = [];
+            for (const p of plugins) {
+                for (const s of p.skills) {
+                    lines.push(`\n\n## Plugin skill: ${s.name} (from ${p.name})\n${s.body}`);
+                }
+            }
+            _pluginSkillsCache = lines.join('');
+        }
+        catch {
+            _pluginSkillsCache = '';
+        }
+    }
+    if (!_pluginSkillsCache)
+        return '';
+    // Only inject for web/UI tasks — avoid polluting non-design prompts
+    if (!WEB_KEYWORDS.test(task.toLowerCase()))
+        return '';
+    return `\n\n## Plugin instructions\nThese skill instructions from installed plugins apply to this task:${_pluginSkillsCache}`;
 }
 function buildArchitectPrompt(task, projectRoot) {
     return `You are in architect mode. You are planning the implementation for: "${task}"

package/dist/agent/system-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/agent/system-prompt.ts"],"names":[],"mappings":";;AAGA,8CAgFC;AAED,oDAmCC;AAvHD,2CAAgE;AAEhE,SAAgB,iBAAiB,CAAC,GAAmB,EAAE,YAAoB,EAAE,IAAa;IACxF,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,IAAA,wBAAY,EAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1D,MAAM,aAAa,GAAG,MAAM,CAAC,CAAC,CAAC,IAAA,+BAAmB,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEhE,mEAAmE;IACnE,wDAAwD;IACxD,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY;QACnC,CAAC,CAAC,mCAAmC,GAAG,CAAC,YAAY,IAAI;QACzD,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,aAAa,GAAG,GAAG,CAAC,gBAAgB;QACxC,CAAC,CAAC,8NAA8N,GAAG,CAAC,gBAAgB,IAAI;QACxP,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;uBACc,GAAG,CAAC,QAAQ,oBAAoB,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YA4CtE,GAAG,CAAC,QAAQ;aACX,GAAG,CAAC,SAAS;QAClB,GAAG,CAAC,IAAI;;;;EAId,GAAG,CAAC,IAAI;;;;;EAKR,GAAG,CAAC,MAAM;;;;EAIV,GAAG,CAAC,MAAM;;;EAGV,GAAG,CAAC,aAAa;EACjB,YAAY,GAAG,aAAa;YAClB,YAAY,wDAAwD,aAAa,EAAE,CAAC;AAChG,CAAC;AAED,SAAgB,oBAAoB,CAAC,IAAY,EAAE,WAAmB;IACpE,OAAO,wEAAwE,IAAI;;gBAErE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+BzB,CAAC;AACH,CAAC"}
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/agent/system-prompt.ts"],"names":[],"mappings":";;AAQA,8CA6EC;AA0BD,oDAmCC;AAjJD,+DAA6D;AAC7D,2DAAwD;AACxD,6CAAsD;AACtD,oDAAsD;AAEtD,MAAM,YAAY,GAAG,6LAA6L,CAAC;AAEnN,SAAgB,iBAAiB,CAAC,GAAmB,EAAE,YAAoB,EAAE,IAAY;IACvF,MAAM,WAAW,GAAG,IAAA,0CAAoB,EAAC,IAAI,CAAC,CAAC;IAC/C,4EAA4E;IAC5E,yEAAyE;IACzE,MAAM,WAAW,GAAG,IAAA,qCAAiB,EAAC,EAAE,WAAW,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACjE,oEAAoE;IACpE,6EAA6E;IAC7E,MAAM,gBAAgB,GAAG,IAAA,mCAAsB,GAAE,CAAC;IAClD,+EAA+E;IAC/E,MAAM,WAAW,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAEhD,OAAO;uBACc,GAAG,CAAC,QAAQ,oBAAoB,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmChF,WAAW,GAAG,WAAW,GAAG,gBAAgB,GAAG,WAAW;;;;;;;;;YAShD,GAAG,CAAC,QAAQ;aACX,GAAG,CAAC,SAAS;QAClB,GAAG,CAAC,IAAI;;;;EAId,GAAG,CAAC,IAAI;;;;;EAKR,GAAG,CAAC,MAAM;;;;EAIV,GAAG,CAAC,MAAM;;;EAGV,GAAG,CAAC,aAAa;;YAEP,YAAY,uDAAuD,CAAC;AAChF,CAAC;AAED,2EAA2E;AAC3E,IAAI,kBAAkB,GAAkB,IAAI,CAAC;AAE7C,SAAS,qBAAqB,CAAC,IAAY;IACzC,IAAI,kBAAkB,KAAK,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAA,0BAAc,GAAE,CAAC;YACjC,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;oBACzB,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC3E,CAAC;YACH,CAAC;YACD,kBAAkB,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,kBAAkB,GAAG,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,IAAI,CAAC,kBAAkB;QAAE,OAAO,EAAE,CAAC;IACnC,oEAAoE;IACpE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAAE,OAAO,EAAE,CAAC;IACtD,OAAO,kGAAkG,kBAAkB,EAAE,CAAC;AAChI,CAAC;AAED,SAAgB,oBAAoB,CAAC,IAAY,EAAE,WAAmB;IACpE,OAAO,wEAAwE,IAAI;;gBAErE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+BzB,CAAC;AACH,CAAC"}

package/dist/agent/unified-memory.d.ts

@@ -0,0 +1,15 @@
+/** Canonical global identity store (created by the consolidation migration). */
+export declare const IDENTITY_FILE: string;
+/** Global episodic-lessons digest (created by runGlobalReconciliation). */
+export declare const GLOBAL_LESSONS_FILE: string;
+export interface UnifiedMemoryOptions {
+    /** CLI passes its project root for per-project lessons; bot omits it. */
+    projectRoot?: string;
+    /** Total cap for the whole block (default ~4 KB). */
+    maxChars?: number;
+}
+/**
+ * The single memory block both the CLI and the Telegram bot inject into their
+ * system prompts. Returns '' when there's nothing to add.
+ */
+export declare function loadUnifiedMemory(opts?: UnifiedMemoryOptions): string;

package/dist/agent/unified-memory.js

@@ -0,0 +1,164 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GLOBAL_LESSONS_FILE = exports.IDENTITY_FILE = void 0;
+exports.loadUnifiedMemory = loadUnifiedMemory;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+// ─────────────────────────────────────────────────────────────────────────────
+// Unified Memory — one read path shared by the CLI and the Telegram bot.
+//
+// Aura's memory used to live in three disconnected places (see the plan/design):
+//   1. key-value identity   ~/.aura/memory/*.json   (bot read default+user only)
+//   2. episode→dream         ~/.aura/episodes + dreams/  (CLI read per-project)
+//   3. chat history          ~/.aura/sessions
+// Facts saved by one surface never reached the other. This module gives both
+// surfaces ONE canonical view:
+//   • GLOBAL identity/facts  →  ~/.aura/memory/identity.json   (everywhere)
+//   • lessons                →  per-project reconciled dream (CLI) OR the
+//                               global digest ~/.aura/memory/lessons-global.md
+//                               (the bot, which is not tied to one project)
+//
+// It is read-only and defensive: any missing/corrupt file is skipped, and the
+// whole block is length-capped so it never bloats a prompt.
+// ─────────────────────────────────────────────────────────────────────────────
+const MEMORY_DIR = path.join(os.homedir(), '.aura', 'memory');
+/** Canonical global identity store (created by the consolidation migration). */
+exports.IDENTITY_FILE = path.join(MEMORY_DIR, 'identity.json');
+/** Global episodic-lessons digest (created by runGlobalReconciliation). */
+exports.GLOBAL_LESSONS_FILE = path.join(MEMORY_DIR, 'lessons-global.md');
+function loadJson(file) {
+    try {
+        if (!fs.existsSync(file))
+            return {};
+        return JSON.parse(fs.readFileSync(file, 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+function readText(file) {
+    try {
+        return fs.existsSync(file) ? fs.readFileSync(file, 'utf8') : '';
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Identity/facts block from the canonical global store. Falls back to the
+ * legacy default.json + user.json if identity.json hasn't been created yet
+ * (so the surfaces keep working before/after the consolidation migration).
+ */
+function identitySection(maxChars) {
+    let store = loadJson(exports.IDENTITY_FILE);
+    if (Object.keys(store).length === 0) {
+        // Pre-migration fallback: merge the two namespaces the bot used to read.
+        store = { ...loadJson(path.join(MEMORY_DIR, 'default.json')), ...loadJson(path.join(MEMORY_DIR, 'user.json')) };
+    }
+    const keys = Object.keys(store);
+    if (keys.length === 0)
+        return '';
+    // Most-recently-updated entries first: identity.json only grows, and a
+    // budget-capped walk in raw insertion order silently drops whatever was
+    // added most recently once older entries fill the budget — which is
+    // exactly backwards, since a newly-added entry is usually a standing rule
+    // or current fact, while old entries are stable background bio. A missing
+    // `updated` sorts last (oldest-equivalent), not first.
+    const ordered = [...keys].sort((a, b) => {
+        const ta = Date.parse(store[a]?.updated ?? '') || 0;
+        const tb = Date.parse(store[b]?.updated ?? '') || 0;
+        return tb - ta;
+    });
+    const lines = [];
+    let used = 0;
+    for (const k of ordered) {
+        const v = store[k]?.value ?? '';
+        if (!v)
+            continue;
+        const line = `- **${k}**: ${v}`;
+        if (used + line.length > maxChars)
+            continue; // skip, don't stop — a later (older) entry may still fit
+        lines.push(line);
+        used += line.length;
+    }
+    return lines.length ? `### Who & what Aura knows (identity/facts)\n${lines.join('\n')}` : '';
+}
+/**
+ * Lessons block. CLI passes a projectRoot → per-project reconciled dream.
+ * The bot passes nothing → the global lessons digest.
+ */
+function lessonsSection(projectRoot, maxChars) {
+    let content = '';
+    if (projectRoot) {
+        const reconciled = path.join(projectRoot, 'dreams', '.reconciled.md');
+        content = readText(reconciled);
+        // Fall back to the latest dated dream if reconciliation hasn't run.
+        if (!content) {
+            try {
+                const dir = path.join(projectRoot, 'dreams');
+                const files = fs.readdirSync(dir).filter(f => /^\d{4}-\d{2}-\d{2}\.md$/.test(f)).sort();
+                if (files.length)
+                    content = readText(path.join(dir, files[files.length - 1]));
+            }
+            catch { /* no dreams yet */ }
+        }
+    }
+    else {
+        content = readText(exports.GLOBAL_LESSONS_FILE);
+    }
+    content = content.trim();
+    if (!content)
+        return '';
+    if (content.length > maxChars)
+        content = content.slice(0, maxChars) + '\n… (truncated)';
+    return `### Lessons from past sessions\n${content}`;
+}
+/**
+ * The single memory block both the CLI and the Telegram bot inject into their
+ * system prompts. Returns '' when there's nothing to add.
+ */
+function loadUnifiedMemory(opts = {}) {
+    const budget = opts.maxChars ?? 4000;
+    // Split the budget: identity gets the larger share, lessons the rest.
+    const idBlock = identitySection(Math.floor(budget * 0.6));
+    const lessonBlock = lessonsSection(opts.projectRoot, budget - idBlock.length);
+    const parts = [idBlock, lessonBlock].filter(Boolean);
+    if (parts.length === 0)
+        return '';
+    return `\n\n## Memory (shared across Aura CLI + Telegram)\n${parts.join('\n\n')}\n`;
+}
+//# sourceMappingURL=unified-memory.js.map

package/dist/agent/unified-memory.js.map

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

package/dist/checkpoints/engine.d.ts

@@ -0,0 +1,44 @@
+export interface Checkpoint {
+    /** Short id, e.g. "m1x2y3-4f" — used in refs and CLI commands. */
+    id: string;
+    /** Full ref name: refs/aura/checkpoints/<id> */
+    ref: string;
+    /** Commit hash of the shadow commit. */
+    commit: string;
+    /** Tree hash of the snapshot. */
+    tree: string;
+    /** Human label (usually the task that triggered the snapshot). */
+    label: string;
+    /** ISO timestamp of creation. */
+    createdAt: string;
+}
+export interface RestoreResult {
+    /** Files written back from the snapshot. */
+    restored: string[];
+    /** Files deleted because they did not exist at snapshot time. */
+    deleted: string[];
+    /** Checkpoint of the state just before restoring (undo the undo). */
+    preRestore: Checkpoint | null;
+}
+/** Absolute .git dir of the repo containing root, or null if not a repo. */
+export declare function gitDirOf(root: string): Promise<string | null>;
+/**
+ * Create a checkpoint of the current working tree.
+ * Returns null when: not a git repo, or the tree is identical to the most
+ * recent checkpoint (deduped — repeated calls within a burst are no-ops).
+ */
+export declare function createCheckpoint(root: string, label: string): Promise<Checkpoint | null>;
+/** All checkpoints for the repo containing root, newest first. */
+export declare function listCheckpoints(root: string): Promise<Checkpoint[]>;
+/**
+ * Restore the working tree to the state captured by checkpoint `id`
+ * (or the most recent checkpoint when id is omitted).
+ *
+ * Only paths that differ are touched; the user's index/HEAD stay put, so
+ * after a restore `git status` simply reflects the restored content.
+ */
+export declare function restoreCheckpoint(root: string, id?: string): Promise<RestoreResult>;
+/** Delete all but the newest `keep` checkpoints. Returns how many were pruned. */
+export declare function pruneCheckpoints(root: string, keep: number): Promise<number>;
+/** Delete a single checkpoint by id. */
+export declare function deleteCheckpoint(root: string, id: string): Promise<boolean>;