vaan-ai 0.1.0

package/dist/src/agent.js

@@ -0,0 +1,151 @@
+// The loop. Read this first.
+//
+// A language model can't do anything. It only produces text. When it "reads a
+// file" it emits a request saying *please run read_file on agent.ts*. This
+// function runs the read, hands the result back, and asks again.
+//
+// Five things it guards, marked GUARD below. Each one is a bug you only find in
+// production: reasoning must round-trip, tool calls arrive in parallel, tool
+// errors are data, not every stop is a stop, and a refused permission is an
+// answer rather than a crash.
+//
+// What the loop does *not* do is decide anything about safety. It doesn't know
+// what a workspace is, whether a path is allowed, or who approves a command.
+// Tools ask the gate; the gate asks a human. Keeping that out of here is why
+// this file stays readable.
+import { PermissionDenied } from "./permissions/approval.js";
+const DEFAULT_MAX_STEPS = 12;
+const DEFAULT_MAX_TOKENS = 4096;
+/** Answer one prompt. */
+export function runAgent(prompt, opts) {
+    const first = { role: "user", parts: [{ type: "text", text: prompt }] };
+    return continueAgent([first], opts);
+}
+/** The same loop, resuming a transcript. The REPL uses this from turn two on. */
+export async function continueAgent(messages, opts) {
+    const { model, system, tools, ctx, signal, trace } = opts;
+    const usedTools = [];
+    const maxSteps = opts.maxSteps ?? DEFAULT_MAX_STEPS;
+    let maxTokens = opts.maxTokens ?? DEFAULT_MAX_TOKENS;
+    let raisedCap = false;
+    let usage;
+    let steps = 0;
+    for (let step = 0; step < maxSteps; step++) {
+        steps = step + 1;
+        const request = { model, system, tools, messages, maxTokens, ...(signal ? { signal } : {}) };
+        const reply = opts.stream
+            ? await consume(opts.provider.stream(request), opts.onEvent)
+            : await opts.provider.generate(request);
+        if (reply.usage) {
+            usage = {
+                input: (usage?.input ?? 0) + reply.usage.input,
+                output: (usage?.output ?? 0) + reply.usage.output,
+            };
+        }
+        trace?.record({
+            kind: "model_call",
+            provider: opts.provider.name,
+            model,
+            ...(reply.usage ? { tokensIn: reply.usage.input, tokensOut: reply.usage.output } : {}),
+        });
+        // GUARD 4a. Truncated mid-turn. Whatever we got is half-written — a tool
+        // call with an unparseable input, a sentence that stops dead — so throw it
+        // away rather than append it, raise the cap, and ask again unchanged.
+        if (reply.stop === "max_tokens" && !raisedCap) {
+            raisedCap = true;
+            maxTokens *= 2;
+            continue;
+        }
+        // GUARD 1. Push the provider's own message object, never one we rebuilt
+        // from `parts`. `raw` rides along inside it, so signed reasoning blocks go
+        // back byte-for-byte on the next request instead of being dropped.
+        messages.push(reply.message);
+        // GUARD 4b. `pause_turn` is neither an answer nor an error. The provider
+        // is asking for the same history back so it can pick up where it stopped.
+        if (reply.stop === "pause")
+            continue;
+        const text = textOf(reply.message);
+        if (text && !opts.stream)
+            opts.onEvent?.({ type: "text", text });
+        const calls = reply.message.parts.filter(isToolCall);
+        if (calls.length === 0)
+            return { text, messages, usedTools, steps, ...(usage ? { usage } : {}) };
+        // GUARD 2. One turn can carry several calls. Run them together, then put
+        // every result in the *single* next message, each keyed by its call id.
+        // Split them across two messages and the provider rejects the turn.
+        const results = await Promise.all(calls.map(async (call) => {
+            // Recorded before it runs: the trajectory grader asks what the model
+            // reached for, and a tool that failed was still a tool it reached for.
+            usedTools.push(call.name);
+            opts.onEvent?.({ type: "tool_call", name: call.name, input: call.input });
+            trace?.record({ kind: "tool_call", tool: call.name, input: call.input });
+            const part = await runTool(call, tools, ctx);
+            const { output, isError } = part;
+            opts.onEvent?.({ type: "tool_result", name: call.name, output, isError });
+            trace?.record({
+                kind: "tool_result",
+                tool: call.name,
+                ok: !isError,
+                summary: output.split("\n")[0] ?? "",
+            });
+            return part;
+        }));
+        messages.push({ role: "user", parts: results });
+    }
+    const text = `Stopped after ${maxSteps} steps without reaching an answer.`;
+    trace?.record({ kind: "error", where: "agent", message: text });
+    return { text, messages, usedTools, steps, ...(usage ? { usage } : {}) };
+}
+/** Drain a streamed turn, forwarding deltas, and hand back the assembled reply. */
+async function consume(events, onEvent) {
+    let reply;
+    for await (const event of events) {
+        if (event.type === "text")
+            onEvent?.({ type: "delta", text: event.text });
+        else if (event.type === "done")
+            reply = event.reply;
+    }
+    if (!reply)
+        throw new Error("The provider's stream ended without finishing the turn.");
+    return reply;
+}
+/**
+ * GUARD 3. A tool that throws is information, not a crash. The failure goes
+ * back to the model flagged as an error so it can recover — a missing file
+ * usually means it should try a different path, not that the run is over.
+ *
+ * GUARD 5. A refused permission is the same kind of information, and the
+ * wording matters: the model has to understand that the answer was no and that
+ * asking again the same way will get the same no. It is not a transient error
+ * to retry, and it is not a reason to look for another route to the same place.
+ */
+async function runTool(call, tools, ctx) {
+    const tool = tools.find((candidate) => candidate.name === call.name);
+    if (!tool)
+        return toolResult(call.id, `No tool named "${call.name}".`, true);
+    try {
+        return toolResult(call.id, await tool.run(asRecord(call.input), ctx), false);
+    }
+    catch (err) {
+        if (err instanceof PermissionDenied) {
+            return toolResult(call.id, `${err.message}. The user was asked and the answer was no — don't retry this or ` +
+                `look for another way to do it. Tell them what you needed and why.`, true);
+        }
+        return toolResult(call.id, `${call.name} failed: ${describe(err)}`, true);
+    }
+}
+const toolResult = (id, output, isError) => ({
+    type: "tool_result",
+    id,
+    output,
+    isError,
+});
+const isToolCall = (part) => part.type === "tool_call";
+const textOf = (message) => message.parts
+    .filter((part) => part.type === "text")
+    .map((part) => part.text)
+    .join("")
+    .trim();
+const asRecord = (input) => input !== null && typeof input === "object" ? input : {};
+const describe = (err) => (err instanceof Error ? err.message : String(err));
+//# sourceMappingURL=agent.js.map

package/dist/src/agent.js.map

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

package/dist/src/cli/args.js

@@ -0,0 +1,38 @@
+// Argument parsing, extracted so it can be tested.
+//
+// It lived inline in main.ts and had a bug that every unit test missed: with
+// no `--model` flag, `indexOf` returns -1, so `argv[index + 1]` read argv[0]
+// and swallowed the command. `vaan memory` silently became `vaan`. Hence this
+// file, and test/cli.test.ts.
+/** Flags that take a value, so the value is never mistaken for the command. */
+const VALUED = ["--model", "--workspace"];
+export function parseArgs(argv) {
+    const flags = new Set(argv.filter((arg) => arg.startsWith("-")));
+    // Track each valued flag's *position*, not just its value: -1 means the flag
+    // is absent, and index 0 is a perfectly good place for a command to be.
+    const consumed = new Set();
+    const values = {};
+    for (const flag of VALUED) {
+        const at = argv.indexOf(flag);
+        if (at === -1)
+            continue;
+        consumed.add(at + 1);
+        values[flag] = argv[at + 1];
+    }
+    const positionals = argv.filter((arg, index) => !arg.startsWith("-") && !consumed.has(index));
+    const [command = "repl", ...rest] = positionals;
+    const model = values["--model"];
+    const workspace = values["--workspace"];
+    return {
+        command,
+        rest,
+        ...(model ? { model } : {}),
+        ...(workspace ? { workspace } : {}),
+        yes: flags.has("--yes") || flags.has("-y"),
+        memory: !flags.has("--no-memory"),
+        trace: !flags.has("--no-trace"),
+        help: flags.has("--help") || flags.has("-h") || command === "help",
+        version: flags.has("--version") || flags.has("-v"),
+    };
+}
+//# sourceMappingURL=args.js.map

package/dist/src/cli/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../../src/cli/args.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,8EAA8E;AAC9E,8BAA8B;AAE9B,+EAA+E;AAC/E,MAAM,MAAM,GAAG,CAAC,SAAS,EAAE,aAAa,CAAU,CAAC;AAgBnD,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEjE,6EAA6E;IAC7E,wEAAwE;IACxE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,MAAM,GAAuC,EAAE,CAAC;IACtD,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,EAAE,KAAK,CAAC,CAAC;YAAE,SAAS;QACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAC7B,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAC7D,CAAC;IACF,MAAM,CAAC,OAAO,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,WAAW,CAAC;IAEhD,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;IAExC,OAAO;QACL,OAAO;QACP,IAAI;QACJ,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3B,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;QAC1C,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC;QACjC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC;QAC/B,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,OAAO,KAAK,MAAM;QAClE,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;KACnD,CAAC;AACJ,CAAC"}

package/dist/src/cli/doctor.js

@@ -0,0 +1,98 @@
+// `vaan doctor` — is this install actually going to work.
+//
+// Every check answers a question a user would otherwise discover three turns
+// into a conversation: is FTS5 there, is a key set, does the config parse, are
+// the two groups that ship empty actually empty. It never calls a model: a
+// diagnostic that costs money and needs the network is one people won't run.
+import { existsSync } from "node:fs";
+import { defaultConfig, describeConfig, loadConfig } from "../config.js";
+import { probeFts5 } from "../memory/store.js";
+import { describeRules } from "../permissions/policy.js";
+import { defaultRules } from "../permissions/rules.js";
+import { configFile, databaseFile, home, skillsDir } from "../paths.js";
+import { statuses } from "../providers/index.js";
+import { loadSkills } from "../skills.js";
+import { GROUPS } from "../tools/index.js";
+import { listTraces } from "../observability/trace.js";
+/** Returns the exit code: non-zero when something is actually broken. */
+export function runDoctor(out, opts) {
+    const problems = [];
+    const line = (ok, text) => {
+        out.write(`    ${ok === undefined ? " " : ok ? "✓" : "✗"}  ${text}\n`);
+    };
+    out.write("\n  environment\n\n");
+    line(true, `node ${process.version} on ${process.platform}`);
+    line(true, `workspace ${opts.workspace}`);
+    out.write("\n  memory\n\n");
+    const fts = probeFts5();
+    if (fts) {
+        problems.push("SQLite has no FTS5");
+        line(false, `SQLite is missing FTS5 — ${fts}`);
+        line(undefined, "fix: npm install better-sqlite3 --build-from-source");
+    }
+    else {
+        line(true, "SQLite with FTS5");
+    }
+    line(existsSync(databaseFile(opts.workspace)) || undefined, existsSync(databaseFile(opts.workspace))
+        ? `database at ${databaseFile(opts.workspace)}`
+        : "no database yet — it's created on the first turn");
+    out.write("\n  providers\n\n");
+    const ready = statuses(opts.env);
+    for (const spec of ready) {
+        const key = spec.envKey ? `${spec.envKey} ${spec.ready ? "set" : "missing"}` : "no key needed";
+        line(spec.ready, `${spec.name.padEnd(12)} ${key}`);
+    }
+    if (!ready.some((spec) => spec.ready)) {
+        problems.push("no provider is usable");
+    }
+    out.write("\n  configuration\n\n");
+    const config = loadConfig(opts.workspace);
+    if (!config) {
+        line(false, `no config at ${configFile(opts.workspace)} — run \`vaan init\``);
+        problems.push("not configured");
+    }
+    else {
+        line(true, "config parses");
+        for (const entry of describeConfig(config))
+            line(undefined, entry);
+    }
+    out.write("\n  permissions\n\n");
+    for (const entry of describeRules(config ? defaultRules(config.approvals) : defaultRules())) {
+        line(undefined, entry);
+    }
+    line(undefined, "credentials and system changes are denied by fixed policy, always");
+    out.write("\n  tools\n\n");
+    // With no config yet, report what would actually run rather than "off":
+    // an unconfigured install still has defaults, and saying otherwise sends
+    // people looking for a problem that isn't there.
+    const enabled = new Set(config?.tools ?? defaultConfig(opts.workspace).tools);
+    for (const group of GROUPS) {
+        const state = !group.available
+            ? "not configured in this build"
+            : enabled.has(group.group)
+                ? "on"
+                : "off";
+        line(group.available && enabled.has(group.group), `${group.label.padEnd(22)} ${state}`);
+    }
+    const { skills, warnings } = loadSkills(opts.workspace);
+    out.write("\n  skills\n\n");
+    if (skills.length === 0) {
+        line(undefined, `none — drop a SKILL.md in ${skillsDir(opts.workspace)}`);
+    }
+    else {
+        for (const skill of skills)
+            line(true, `${skill.name.padEnd(22)} ${skill.path}`);
+    }
+    for (const warning of warnings)
+        line(false, warning);
+    out.write("\n  traces\n\n");
+    const traces = listTraces(home(opts.workspace), 1);
+    line(undefined, traces.length === 0
+        ? "none yet — written to .vaan/traces after each request"
+        : `most recent ${traces[0]?.at ?? ""}`);
+    out.write(problems.length === 0
+        ? "\n  all clear\n\n"
+        : `\n  ${problems.length} problem${problems.length === 1 ? "" : "s"}: ${problems.join(", ")}\n\n`);
+    return problems.length === 0 ? 0 : 1;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/src/cli/doctor.js.map

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

package/dist/src/cli/dotenv.js

@@ -0,0 +1,58 @@
+// A very small .env reader. Node has --env-file, but that only helps if the
+// user remembers to pass it, and `npx vaan` gives them nowhere to put it.
+//
+// Values already in the real environment win, so an exported key always beats
+// a stale one in the file.
+import { readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+export function loadEnv(cwd, env = process.env) {
+    for (const [key, value] of Object.entries(parseEnv(read(join(cwd, ".env"))))) {
+        if (env[key] === undefined)
+            env[key] = value;
+    }
+}
+export function parseEnv(text) {
+    const out = {};
+    for (const raw of text.split("\n")) {
+        const line = raw.trim();
+        if (!line || line.startsWith("#"))
+            continue;
+        const eq = line.indexOf("=");
+        if (eq <= 0)
+            continue;
+        const key = line.slice(0, eq).trim();
+        const value = line.slice(eq + 1).trim();
+        out[key] = /^(".*"|'.*')$/s.test(value) ? value.slice(1, -1) : value;
+    }
+    return out;
+}
+/** Add or replace keys in .env, leaving comments and unrelated keys alone. */
+export function updateEnvFile(cwd, updates) {
+    const path = join(cwd, ".env");
+    const lines = read(path).split("\n");
+    const remaining = { ...updates };
+    const merged = lines.map((line) => {
+        const eq = line.indexOf("=");
+        if (line.trim().startsWith("#") || eq <= 0)
+            return line;
+        const key = line.slice(0, eq).trim();
+        if (!(key in remaining))
+            return line;
+        const value = remaining[key];
+        delete remaining[key];
+        return `${key}=${value}`;
+    });
+    const added = Object.entries(remaining).map(([key, value]) => `${key}=${value}`);
+    const body = [...merged, ...added].join("\n").replace(/\n{3,}/g, "\n\n").trimEnd();
+    writeFileSync(path, `${body}\n`, "utf8");
+    return path;
+}
+function read(path) {
+    try {
+        return readFileSync(path, "utf8");
+    }
+    catch {
+        return "";
+    }
+}
+//# sourceMappingURL=dotenv.js.map

package/dist/src/cli/dotenv.js.map

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

package/dist/src/cli/main.js

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+// Entry point. Seven commands, and the bare one is the REPL.
+import { resolve } from "node:path";
+import { defaultConfig, loadConfig } from "../config.js";
+import { printReport } from "../eval/report.js";
+import { runEvals } from "../eval/runner.js";
+import { openMemory } from "../memory/store.js";
+import { parseArgs } from "./args.js";
+import { runDoctor } from "./doctor.js";
+import { loadEnv } from "./dotenv.js";
+import { printMemory } from "./memory-cmd.js";
+import { runRepl } from "./repl.js";
+import { addSchedule, printSchedules, removeSchedule, runSchedule } from "./schedule.js";
+import { printTrace, printTraceList } from "./trace-cmd.js";
+import { runWizard, VERSION } from "./wizard.js";
+const HELP = `
+  Vaan ${VERSION}
+
+    vaan                 start the REPL
+    vaan init            run setup again
+    vaan memory          print facts and recent turns
+    vaan trace [id]      list requests, or show one in full
+    vaan doctor          check this install
+    vaan eval            run the suites, exit non-zero if they fail
+    vaan schedule        list, add, remove or run a scheduled task
+
+  options
+
+    --model <spec>       provider/model for this run, e.g. anthropic/claude-opus-5
+    --workspace <path>   work somewhere other than the current directory
+    --no-memory          don't read or write memory this session
+    --no-trace           don't write a trace file this session
+    --yes                grant every permission without asking
+    --help, --version
+
+  In the REPL:  /model  /new  /memory  /forget  /inbox  /status  /trace  /settings  /exit
+`;
+async function main(argv) {
+    const out = process.stdout;
+    const args = parseArgs(argv);
+    const workspace = resolve(args.workspace ?? process.cwd());
+    loadEnv(workspace);
+    if (args.help) {
+        out.write(HELP);
+        return 0;
+    }
+    if (args.version) {
+        out.write(`${VERSION}\n`);
+        return 0;
+    }
+    const stored = loadConfig(workspace);
+    // Precedence: the flag, then the environment, then what setup decided.
+    const model = args.model ?? process.env.VAAN_MODEL ?? stored?.model;
+    switch (args.command) {
+        case "memory": {
+            const store = openMemory({ dir: workspace, turnLimit: 10 });
+            printMemory(out, await store.recall(workspace, ""));
+            store.close?.();
+            return 0;
+        }
+        case "trace":
+            return args.rest[0]
+                ? printTrace(out, workspace, args.rest[0])
+                : printTraceList(out, workspace);
+        case "doctor":
+            return runDoctor(out, {
+                workspace,
+                env: process.env,
+                ...(model ? { model } : {}),
+            });
+        case "eval": {
+            if (!model)
+                return unconfigured(out);
+            const report = await runEvals({ workspace, model, env: process.env });
+            printReport(out, report);
+            return report.passed ? 0 : 1;
+        }
+        case "schedule": {
+            const [sub, id] = args.rest;
+            if (!sub)
+                return printSchedules(out, workspace);
+            if (sub === "add")
+                return addSchedule(out, workspace);
+            if (sub === "remove" && id)
+                return removeSchedule(out, workspace, id);
+            if (sub === "run" && id) {
+                if (!model)
+                    return unconfigured(out);
+                return runSchedule(out, id, { workspace, env: process.env, model, yes: args.yes });
+            }
+            out.write("\n  vaan schedule [add | run <id> | remove <id>]\n\n");
+            return 1;
+        }
+        case "repl":
+        case "init":
+            break;
+        default:
+            out.write(`\n  Unknown command "${args.command}".\n${HELP}`);
+            return 1;
+    }
+    // Setup needs a person at the keyboard. Say so and leave, rather than
+    // blocking forever on a prompt that nothing is going to answer.
+    const needsSetup = args.command === "init" || !model;
+    if (!process.stdin.isTTY && (needsSetup ? !args.yes : true)) {
+        out.write(needsSetup
+            ? "\n  Vaan needs a terminal to set up. Run it interactively, or pass --yes with\n" +
+                "  VAAN_MODEL and an API key already in the environment.\n\n"
+            : "\n  Vaan is a REPL and needs a terminal. It doesn't read piped input.\n\n");
+        return 1;
+    }
+    let config = stored ?? defaultConfig(workspace, model ?? "");
+    if (needsSetup) {
+        const result = await runWizard({ cwd: workspace, yes: args.yes, env: process.env });
+        if (!result)
+            return 1;
+        config = result.config;
+        if (args.command === "init")
+            return 0;
+    }
+    return runRepl({
+        workspace: config.workspace,
+        model: args.model ?? config.model,
+        config,
+        memory: args.memory && config.memory,
+        yes: args.yes,
+        trace: args.trace,
+        env: process.env,
+    });
+}
+function unconfigured(out) {
+    out.write("\n  No model configured. Run `vaan init` first.\n\n");
+    return 1;
+}
+main(process.argv.slice(2)).then((code) => process.exit(code), (err) => {
+    process.stderr.write(`\n  ${err instanceof Error ? err.message : String(err)}\n\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=main.js.map

package/dist/src/cli/main.js.map

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

package/dist/src/cli/memory-cmd.js

@@ -0,0 +1,31 @@
+// `vaan memory`, and the /memory slash command. Both print the same thing:
+// what's injected on every turn, then what's sitting in the searchable tier.
+export function printMemory(out, recall) {
+    out.write("\n  facts — sent with every message\n\n");
+    if (recall.facts.length === 0) {
+        out.write("    (none yet)\n");
+    }
+    else {
+        for (const fact of recall.facts) {
+            out.write(`    ${String(fact.id).padStart(3)}  ${fact.text}\n`);
+        }
+    }
+    out.write("\n  recent turns — searched, not injected\n\n");
+    if (recall.turns.length === 0) {
+        out.write("    (none yet)\n");
+    }
+    else {
+        for (const turn of recall.turns) {
+            const tools = turn.tools.length > 0 ? `  [${turn.tools.join(", ")}]` : "";
+            out.write(`    ${turn.ts.slice(0, 16).replace("T", " ")}${tools}\n`);
+            out.write(`      ${clip(turn.userText)}\n`);
+            out.write(`      ${clip(turn.replyText)}\n\n`);
+        }
+    }
+    out.write("\n");
+}
+const clip = (text) => {
+    const line = text.replace(/\s+/g, " ").trim();
+    return line.length <= 96 ? line : `${line.slice(0, 96)}…`;
+};
+//# sourceMappingURL=memory-cmd.js.map

package/dist/src/cli/memory-cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-cmd.js","sourceRoot":"","sources":["../../../src/cli/memory-cmd.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,6EAA6E;AAI7E,MAAM,UAAU,WAAW,CAAC,GAAuB,EAAE,MAAc;IACjE,GAAG,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACrD,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAChC,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,GAAG,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,GAAG,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAC3D,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAChC,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1E,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC;YACrE,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC5C,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IACD,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,IAAI,GAAG,CAAC,IAAY,EAAU,EAAE;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,OAAO,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC;AAC5D,CAAC,CAAC"}