@chances-ai/engine 24.0.0

package/dist/memory/store.js

@@ -0,0 +1,237 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync, } from "node:fs";
+import { join } from "node:path";
+import { formatMemoryFile, parseMemoryFile } from "./frontmatter.js";
+import { MEMORY_SCOPES, MEMORY_TYPES, } from "./types.js";
+const MEMORY_DIR = "memory";
+const INDEX_FILE = "MEMORY.md";
+/** Per-scope cap on the system-prompt injection. Keeps a runaway memory dir
+ *  from blowing the context window; truncation is announced in the output. */
+const SCOPE_BUDGET_BYTES = 25_000;
+const SLUG_MAX_LENGTH = 64;
+/**
+ * Concurrency note (v1): mutations are sync-per-process but not locked across
+ * parallel CLI processes. Two simultaneous saves can interleave such that the
+ * last MEMORY.md index rewrite reflects a stale `list()`. At v1 scale (single
+ * interactive CLI, occasional `-p` invocation) the worst case is a stale
+ * index until the next mutation — not data loss, since each entry file write
+ * is atomic and slugs collision-suffix. A per-scope lock file is queued for
+ * v2 alongside the relevance ranker (when memory becomes hot-path enough to
+ * race on).
+ */
+export class MemoryStore {
+    dirs;
+    constructor(opts) {
+        this.dirs = {
+            global: join(opts.homeDir, ".chances", MEMORY_DIR),
+            project: join(opts.workspaceRoot, ".chances", MEMORY_DIR),
+        };
+    }
+    /** Resolved on-disk directory for the given scope. Public so tools can show paths. */
+    dirFor(scope) {
+        return this.dirs[scope];
+    }
+    list(scope) {
+        const scopes = scope ? [scope] : [...MEMORY_SCOPES];
+        const out = [];
+        for (const s of scopes) {
+            const dir = this.dirs[s];
+            if (!existsSync(dir))
+                continue;
+            for (const file of readdirSync(dir)) {
+                if (!file.endsWith(".md") || file === INDEX_FILE)
+                    continue;
+                const path = join(dir, file);
+                const raw = safeRead(path);
+                if (raw === null)
+                    continue;
+                const parsed = parseMemoryFile(raw);
+                if (!parsed)
+                    continue;
+                out.push({
+                    slug: file.replace(/\.md$/, ""),
+                    type: parsed.frontmatter.type,
+                    name: parsed.frontmatter.name,
+                    description: parsed.frontmatter.description,
+                    body: parsed.body,
+                    scope: s,
+                    path,
+                });
+            }
+        }
+        return out.sort((a, b) => scopeRank(a.scope) - scopeRank(b.scope) || a.slug.localeCompare(b.slug));
+    }
+    save(input, scope) {
+        if (!input.name.trim())
+            throw new Error("memory name is required");
+        if (!input.body.trim())
+            throw new Error("memory body is required");
+        const dir = this.dirs[scope];
+        mkdirSync(dir, { recursive: true });
+        const base = slugify(`${input.type}_${input.name}`);
+        const slug = this.uniqueSlugFor(base, input, scope, dir);
+        const path = pathFor(dir, slug);
+        const fm = { name: input.name.trim(), description: (input.description ?? "").trim(), type: input.type };
+        writeFileSync(path, formatMemoryFile(fm, input.body));
+        this.rewriteIndex(scope);
+        return { slug, type: input.type, name: fm.name, description: fm.description, body: input.body, scope, path };
+    }
+    /** Returns true if the slug existed and was removed. */
+    delete(slug, scope) {
+        if (!isValidSlug(slug))
+            return false;
+        const dir = this.dirs[scope];
+        const path = pathFor(dir, slug);
+        if (!existsSync(path))
+            return false;
+        rmSync(path);
+        this.rewriteIndex(scope);
+        return true;
+    }
+    /**
+     * Resolves a slug collision by walking `base`, `base-2`, `base-3`, ... until
+     * we find a slot that's either (a) empty or (b) holds an entry with the same
+     * name+type (in which case overwrite is the intended behavior — same memory
+     * being updated). This prevents two distinct memories whose names normalize
+     * to the same slug from silently clobbering each other.
+     */
+    uniqueSlugFor(base, input, scope, dir) {
+        for (let i = 0; i < 100; i++) {
+            const candidate = i === 0 ? base : `${base}-${i + 1}`;
+            const path = join(dir, `${candidate}.md`);
+            if (!existsSync(path))
+                return candidate;
+            const raw = safeRead(path);
+            const parsed = raw ? parseMemoryFile(raw) : null;
+            if (parsed &&
+                parsed.frontmatter.type === input.type &&
+                parsed.frontmatter.name.trim() === input.name.trim()) {
+                // Same logical memory — caller is updating an existing entry.
+                return candidate;
+            }
+        }
+        throw new Error(`memory: too many collisions on slug "${base}" in ${scope}`);
+    }
+    /** System-prompt injection block. Empty string when nothing is saved. */
+    asSystemContext() {
+        const sections = [];
+        for (const scope of MEMORY_SCOPES) {
+            const entries = this.list(scope);
+            if (entries.length === 0)
+                continue;
+            sections.push(renderScope(scope, entries));
+        }
+        return sections.join("\n\n");
+    }
+    rewriteIndex(scope) {
+        const dir = this.dirs[scope];
+        const entries = this.list(scope);
+        const path = join(dir, INDEX_FILE);
+        if (entries.length === 0) {
+            if (existsSync(path))
+                rmSync(path);
+            return;
+        }
+        const grouped = groupByType(entries);
+        // MEMORY.md is generated, not authored — every save/delete rewrites it from
+        // the parsed entry files. Hand-edits here are discarded on the next tool
+        // call. We make that explicit so users don't lose work editing this file.
+        const lines = [
+            "<!-- This file is generated by chances. Hand-edit individual entry files;",
+            "     edits to MEMORY.md itself are overwritten on the next save/delete. -->",
+            "",
+            `# ${capitalize(scope)} memory index`,
+            "",
+        ];
+        for (const type of MEMORY_TYPES) {
+            const ofType = grouped[type];
+            if (!ofType || ofType.length === 0)
+                continue;
+            lines.push(`## ${type}`);
+            for (const e of ofType) {
+                const desc = e.description ? ` — ${oneLine(e.description)}` : "";
+                lines.push(`- [${e.name}](${e.slug}.md)${desc}`);
+            }
+            lines.push("");
+        }
+        writeFileSync(path, lines.join("\n").replace(/\n+$/g, "") + "\n");
+    }
+}
+// Allowlist: `slugify` only produces `[a-z0-9_]` plus an optional `-N`
+// collision suffix from `uniqueSlugFor`. Any input from a tool call gets
+// matched against this — anything else is rejected before path construction so
+// `../etc/passwd` style traversal cannot escape the memory dir.
+const SLUG_PATTERN = /^[a-z0-9_]{1,64}(?:-\d+)?$/;
+function isValidSlug(s) {
+    return typeof s === "string" && SLUG_PATTERN.test(s);
+}
+function pathFor(dir, slug) {
+    if (!isValidSlug(slug)) {
+        throw new Error(`memory: invalid slug "${slug}"`);
+    }
+    return join(dir, `${slug}.md`);
+}
+function renderScope(scope, entries) {
+    const grouped = groupByType(entries);
+    const header = `### ${capitalize(scope)} memory`;
+    const indexLines = [];
+    for (const type of MEMORY_TYPES) {
+        const ofType = grouped[type];
+        if (!ofType || ofType.length === 0)
+            continue;
+        indexLines.push(`- **${type}**:`);
+        for (const e of ofType) {
+            const desc = e.description ? ` — ${oneLine(e.description)}` : "";
+            indexLines.push(`  - ${e.name} (\`${e.slug}\`)${desc}`);
+        }
+    }
+    const bodies = [];
+    let bytes = 0;
+    let truncated = 0;
+    for (const e of entries) {
+        const block = `#### ${e.name} (${e.scope}/${e.slug})\n${e.body.trim()}\n`;
+        if (bytes + block.length > SCOPE_BUDGET_BYTES) {
+            truncated++;
+            continue;
+        }
+        bodies.push(block);
+        bytes += block.length;
+    }
+    const trailer = truncated > 0
+        ? `\n_(${truncated} entr${truncated === 1 ? "y" : "ies"} omitted — exceeded ${SCOPE_BUDGET_BYTES} byte budget. Use memory_list / read tools to inspect.)_`
+        : "";
+    return [header, "", indexLines.join("\n"), "", bodies.join("\n"), trailer].join("\n").trimEnd();
+}
+function groupByType(entries) {
+    const g = {};
+    for (const e of entries) {
+        (g[e.type] ??= []).push(e);
+    }
+    return g;
+}
+function scopeRank(scope) {
+    return scope === "global" ? 0 : 1;
+}
+export function slugify(s) {
+    const slug = s
+        .toLowerCase()
+        .normalize("NFKD")
+        .replace(/[^a-z0-9]+/g, "_")
+        .replace(/^_+|_+$/g, "")
+        .slice(0, SLUG_MAX_LENGTH);
+    return slug || "memory";
+}
+function oneLine(s) {
+    return s.replace(/\s+/g, " ").trim();
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+function safeRead(path) {
+    try {
+        return readFileSync(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/memory/store.js.map

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

package/dist/memory/tools.d.ts

@@ -0,0 +1,11 @@
+import type { Tool } from "../tools/index.js";
+import type { MemoryStore } from "./store.js";
+/**
+ * Builtin tools the model uses to persist memory. The three-tool surface
+ * (save / delete / list) intentionally matches the smallest set claude-code
+ * exposes for memory: just the read/write/index basics, with the model
+ * responsible for *what* to save. v2 will layer auto-extraction on top, but
+ * v1 keeps the contract simple — every write is an explicit, auditable call.
+ */
+export declare function memoryTools(store: MemoryStore): Tool[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/memory/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/memory/tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,mBAAmB,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,EAAE,CAEtD"}

package/dist/memory/tools.js

@@ -0,0 +1,159 @@
+import { AppError, ErrorCode } from "@chances-ai/runtime";
+import { MEMORY_SCOPES, MEMORY_TYPES, isMemoryScope, isMemoryType } from "./types.js";
+/**
+ * Builtin tools the model uses to persist memory. The three-tool surface
+ * (save / delete / list) intentionally matches the smallest set claude-code
+ * exposes for memory: just the read/write/index basics, with the model
+ * responsible for *what* to save. v2 will layer auto-extraction on top, but
+ * v1 keeps the contract simple — every write is an explicit, auditable call.
+ */
+export function memoryTools(store) {
+    return [saveTool(store), deleteTool(store), listTool(store)];
+}
+function obj(args) {
+    if (!args || typeof args !== "object" || Array.isArray(args)) {
+        throw new AppError(ErrorCode.Tool, "memory tool args must be an object");
+    }
+    return args;
+}
+function reqStr(args, key) {
+    const v = obj(args)[key];
+    if (typeof v !== "string" || !v.trim()) {
+        throw new AppError(ErrorCode.Tool, `memory tool: required string arg "${key}"`);
+    }
+    return v;
+}
+function optStr(args, key) {
+    const v = obj(args)[key];
+    if (v === undefined || v === null)
+        return undefined;
+    if (typeof v !== "string") {
+        throw new AppError(ErrorCode.Tool, `memory tool: expected string arg "${key}"`);
+    }
+    return v;
+}
+function requireScope(args) {
+    const raw = reqStr(args, "scope");
+    if (!isMemoryScope(raw)) {
+        throw new AppError(ErrorCode.Tool, `memory tool: scope must be one of ${MEMORY_SCOPES.join(", ")}`);
+    }
+    return raw;
+}
+function requireType(args) {
+    const raw = reqStr(args, "type");
+    if (!isMemoryType(raw)) {
+        throw new AppError(ErrorCode.Tool, `memory tool: type must be one of ${MEMORY_TYPES.join(", ")}`);
+    }
+    return raw;
+}
+function saveTool(store) {
+    return {
+        name: "memory_save",
+        description: "Save (or overwrite) a memory entry. Use sparingly — only for facts that will still be relevant in *future* conversations. Skip task-specific or code-derivable details.",
+        category: "memory-write",
+        parameters: {
+            type: "object",
+            properties: {
+                scope: { type: "string", enum: [...MEMORY_SCOPES], description: "'global' = applies across projects; 'project' = scoped to this repo." },
+                type: { type: "string", enum: [...MEMORY_TYPES], description: "'user' (who they are), 'feedback' (corrections/preferences), 'project' (work context), 'reference' (pointers to external systems)." },
+                name: { type: "string", description: "Short human label, e.g. 'user role' or 'auth deadline'. Used to derive the filename." },
+                description: { type: "string", description: "One-line hook describing when this memory is useful — shown in the index, kept under ~150 chars." },
+                body: { type: "string", description: "Markdown body. Lead with the fact itself; for feedback/project, include **Why:** and **How to apply:** lines so future-you can judge edge cases." },
+            },
+            required: ["scope", "type", "name", "body"],
+        },
+        summarize: (args) => {
+            const o = obj(args);
+            const name = typeof o["name"] === "string" ? o["name"] : "?";
+            const scope = typeof o["scope"] === "string" ? o["scope"] : "?";
+            const type = typeof o["type"] === "string" ? o["type"] : "?";
+            return `memory_save ${scope}/${type}: ${name}`;
+        },
+        async execute(args) {
+            try {
+                const scope = requireScope(args);
+                const type = requireType(args);
+                const name = reqStr(args, "name");
+                const body = reqStr(args, "body");
+                const description = optStr(args, "description");
+                const entry = store.save({ type, name, body, description }, scope);
+                return { ok: true, output: `Saved ${scope}/${entry.slug}.md (${entry.type})` };
+            }
+            catch (e) {
+                return { ok: false, output: e.message };
+            }
+        },
+    };
+}
+function deleteTool(store) {
+    return {
+        name: "memory_delete",
+        description: "Delete a memory entry by slug. Use when a saved memory turns out to be wrong or outdated.",
+        category: "memory-write",
+        parameters: {
+            type: "object",
+            properties: {
+                scope: { type: "string", enum: [...MEMORY_SCOPES] },
+                slug: { type: "string", description: "Filename stem (without .md), e.g. 'user_role'. Get it from memory_list." },
+            },
+            required: ["scope", "slug"],
+        },
+        summarize: (args) => {
+            const o = obj(args);
+            const slug = typeof o["slug"] === "string" ? o["slug"] : "?";
+            const scope = typeof o["scope"] === "string" ? o["scope"] : "?";
+            return `memory_delete ${scope}/${slug}`;
+        },
+        async execute(args) {
+            try {
+                const scope = requireScope(args);
+                const slug = reqStr(args, "slug");
+                const removed = store.delete(slug, scope);
+                return removed
+                    ? { ok: true, output: `Deleted ${scope}/${slug}.md` }
+                    : { ok: false, output: `No such memory: ${scope}/${slug}` };
+            }
+            catch (e) {
+                return { ok: false, output: e.message };
+            }
+        },
+    };
+}
+function listTool(store) {
+    return {
+        name: "memory_list",
+        description: "List saved memory entries. Pass scope to filter to one of 'global' or 'project'.",
+        category: "memory-read",
+        parameters: {
+            type: "object",
+            properties: {
+                scope: { type: "string", enum: [...MEMORY_SCOPES], description: "Optional. Omit to list both scopes." },
+            },
+        },
+        summarize: (args) => {
+            const o = obj(args);
+            const scope = typeof o["scope"] === "string" ? o["scope"] : "all";
+            return `memory_list ${scope}`;
+        },
+        async execute(args) {
+            try {
+                const scopeArg = optStr(args, "scope");
+                if (scopeArg !== undefined && !isMemoryScope(scopeArg)) {
+                    throw new AppError(ErrorCode.Tool, `memory tool: scope must be one of ${MEMORY_SCOPES.join(", ")}`);
+                }
+                const entries = store.list(scopeArg);
+                if (entries.length === 0)
+                    return { ok: true, output: "(no memory entries)" };
+                const lines = entries.map((e) => {
+                    const desc = e.description ? ` — ${e.description}` : "";
+                    return `${e.scope}/${e.slug}.md  [${e.type}]  ${e.name}${desc}`;
+                });
+                return { ok: true, output: lines.join("\n") };
+            }
+            catch (e) {
+                return { ok: false, output: e.message };
+            }
+        },
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/memory/tools.js.map

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

package/dist/memory/types.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Memory v1 — file-based, frontmatter-typed, hand-curatable by the user *and*
+ * tool-writable by the model. Two scopes:
+ *   - global : ~/.chances/memory/        (cross-project, e.g. "I'm a Go dev")
+ *   - project: <workspace>/.chances/memory/ (this-repo, e.g. "uses Turbo+Cargo")
+ *
+ * Schema deliberately mirrors claude-code's `src/memdir/memoryTypes.ts` so that
+ * users moving between agents have one mental model. The per-turn LLM relevance
+ * ranker and the background extraction agent are NOT in v1 — those are bigger
+ * pieces of work and earn their own version.
+ */
+export declare const MEMORY_TYPES: readonly ["user", "feedback", "project", "reference"];
+export type MemoryType = (typeof MEMORY_TYPES)[number];
+export declare const MEMORY_SCOPES: readonly ["global", "project"];
+export type MemoryScope = (typeof MEMORY_SCOPES)[number];
+export interface MemoryEntry {
+    /** Filename stem, e.g. `user_role` for `user_role.md`. Derived from name. */
+    slug: string;
+    type: MemoryType;
+    /** Human label shown in the index. */
+    name: string;
+    /** One-line hook used to decide relevance in future conversations. */
+    description: string;
+    /** Markdown body. */
+    body: string;
+    scope: MemoryScope;
+    /** Absolute path on disk. */
+    path: string;
+}
+export declare function isMemoryType(s: unknown): s is MemoryType;
+export declare function isMemoryScope(s: unknown): s is MemoryScope;
+//# sourceMappingURL=types.d.ts.map

package/dist/memory/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,YAAY,uDAAwD,CAAC;AAClF,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,eAAO,MAAM,aAAa,gCAAiC,CAAC;AAC5D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,UAAU,CAExD;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,WAAW,CAE1D"}

package/dist/memory/types.js

@@ -0,0 +1,20 @@
+/**
+ * Memory v1 — file-based, frontmatter-typed, hand-curatable by the user *and*
+ * tool-writable by the model. Two scopes:
+ *   - global : ~/.chances/memory/        (cross-project, e.g. "I'm a Go dev")
+ *   - project: <workspace>/.chances/memory/ (this-repo, e.g. "uses Turbo+Cargo")
+ *
+ * Schema deliberately mirrors claude-code's `src/memdir/memoryTypes.ts` so that
+ * users moving between agents have one mental model. The per-turn LLM relevance
+ * ranker and the background extraction agent are NOT in v1 — those are bigger
+ * pieces of work and earn their own version.
+ */
+export const MEMORY_TYPES = ["user", "feedback", "project", "reference"];
+export const MEMORY_SCOPES = ["global", "project"];
+export function isMemoryType(s) {
+    return typeof s === "string" && MEMORY_TYPES.includes(s);
+}
+export function isMemoryScope(s) {
+    return typeof s === "string" && MEMORY_SCOPES.includes(s);
+}
+//# sourceMappingURL=types.js.map

package/dist/memory/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,CAAU,CAAC;AAGlF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAU,CAAC;AAkB5D,MAAM,UAAU,YAAY,CAAC,CAAU;IACrC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAK,YAAkC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,CAAU;IACtC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAK,aAAmC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AACnF,CAAC"}