@duetso/agent 0.2.5 → 0.3.0

package/dist/src/memory/store/discovery.js

@@ -0,0 +1,34 @@
+import { lstat } from "node:fs/promises";
+import { join } from "node:path";
+import { walkAncestors } from "../../lib/walk-ancestors.js";
+const MEMORY_ROOT_NAMES = [".duet", ".agents", ".claude"];
+/**
+ * Find real memory-store directories from cwd toward the filesystem root.
+ * Nearest ancestors win naturally because callers consume this order first;
+ * `$HOME` remains excluded by the shared project-scope ancestor walk.
+ */
+export async function discoverMemoryStores(cwd) {
+    const stores = [];
+    for (const ancestor of walkAncestors(cwd)) {
+        for (const rootName of MEMORY_ROOT_NAMES) {
+            const storeDir = join(ancestor, rootName, "memories");
+            const status = await lstat(storeDir).catch((error) => {
+                if (isNodeError(error, "ENOENT") || isNodeError(error, "ENOTDIR"))
+                    return undefined;
+                throw error;
+            });
+            if (!status)
+                continue;
+            if (status.isSymbolicLink())
+                throw new Error(`Memory stores cannot be symlinks: ${storeDir}`);
+            if (!status.isDirectory())
+                throw new Error(`Memory store is not a directory: ${storeDir}`);
+            stores.push(storeDir);
+        }
+    }
+    return stores;
+}
+function isNodeError(error, code) {
+    return error instanceof Error && "code" in error && error.code === code;
+}
+//# sourceMappingURL=discovery.js.map

package/dist/src/memory/store/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../../../src/memory/store/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AAEnE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,GAAW;IACpD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,QAAQ,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,KAAK,MAAM,QAAQ,IAAI,iBAAiB,EAAE,CAAC;YACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;YACtD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBAC5D,IAAI,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC;oBAAE,OAAO,SAAS,CAAC;gBACpF,MAAM,KAAK,CAAC;YACd,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,MAAM;gBAAE,SAAS;YACtB,IAAI,MAAM,CAAC,cAAc,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,QAAQ,EAAE,CAAC,CAAC;YAC9F,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,QAAQ,EAAE,CAAC,CAAC;YAC3F,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,KAAc,EAAE,IAAY;IAC/C,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;AAC1E,CAAC"}

package/dist/src/memory/store/file.d.ts

@@ -0,0 +1,52 @@
+/** The established Train API ceiling, applied to UTF-8 body bytes. */
+export declare const MAX_TRAIN_RECORD_CONTENT_BYTES: number;
+/** A memory file's role: synthesized training or a directly curated note. */
+export type MemoryKind = "train" | "note";
+/** Scalar values retained for forward-compatible, unknown frontmatter keys. */
+export type MemoryFrontmatterValue = string | number | string[];
+/** The typed contents of one markdown memory file, excluding its filename-owned slug. */
+export interface MemoryFileRecord {
+    /** Byte-format version. Version 1 is the only format currently understood. */
+    version: 1;
+    /** Stable record identity shared with APIs and private archive metadata. */
+    id: string;
+    /** Whether the content came from training synthesis or direct note curation. */
+    kind: MemoryKind;
+    /** Unix epoch milliseconds used to derive observed dates and newest-first ordering. */
+    createdAt: number;
+    /** Short display label for the curated content. */
+    headline?: string;
+    /** Model identifier that produced synthesized content, when applicable. */
+    model?: string;
+    /** Number of source files represented by synthesized content. */
+    fileCount?: number;
+    /** Private archive manifest identifier; never an absolute archive path. */
+    archiveId?: string;
+    /** Ranking hint consumed by memory-context selection. */
+    priority?: string;
+    /** Origin label used when projecting a file into observational-memory shapes. */
+    source?: string;
+    /** Search and provenance labels attached to the record. */
+    tags?: string[];
+    /**
+     * Unknown scalar keys retained byte-stably so a newer writer can add metadata
+     * without an older reader silently deleting it on a content-only update.
+     */
+    extra?: Record<string, MemoryFrontmatterValue>;
+    /** Exact curated markdown after the closing frontmatter delimiter. */
+    content: string;
+}
+/**
+ * Parse the canonical YAML-compatible subset used by memory files.
+ *
+ * Values are canonical JSON strings, finite decimal numbers, or inline
+ * arrays of canonical JSON strings. Known keys stay in the order emitted by
+ * {@link serializeMemoryFile}; unknown keys may follow them and use the same
+ * scalar grammar.
+ */
+export declare function parseMemoryFile(text: string): MemoryFileRecord;
+/** Serialize a memory record into the one canonical byte representation. */
+export declare function serializeMemoryFile(record: MemoryFileRecord): string;
+/** Return the safe slug owned by a bare `<slug>.md` filename. */
+export declare function slugFromFilename(name: string): string;
+//# sourceMappingURL=file.d.ts.map

package/dist/src/memory/store/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../../src/memory/store/file.ts"],"names":[],"mappings":"AAGA,sEAAsE;AACtE,eAAO,MAAM,8BAA8B,QAAmB,CAAC;AAE/D,6EAA6E;AAC7E,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAE1C,+EAA+E;AAC/E,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;AAEhE,yFAAyF;AACzF,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,OAAO,EAAE,CAAC,CAAC;IACX,4EAA4E;IAC5E,EAAE,EAAE,MAAM,CAAC;IACX,gFAAgF;IAChF,IAAI,EAAE,UAAU,CAAC;IACjB,uFAAuF;IACvF,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAC/C,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;CACjB;AA2BD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAyE9D;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAyBpE;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOrD"}

package/dist/src/memory/store/file.js

@@ -0,0 +1,287 @@
+import { Buffer } from "node:buffer";
+import { basename } from "node:path";
+/** The established Train API ceiling, applied to UTF-8 body bytes. */
+export const MAX_TRAIN_RECORD_CONTENT_BYTES = 10 * 1024 * 1024;
+const SLUG_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+// Identifiers become path segments under the private archive root, so they
+// must never be able to traverse (`..`, separators) out of it. nanoid's
+// alphabet plus the `mem_` prefix always satisfies this.
+const ID_SEGMENT_PATTERN = /^[A-Za-z0-9_-]+$/;
+const KEY_PATTERN = /^[A-Za-z][A-Za-z0-9]*$/;
+const NUMBER_PATTERN = /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/;
+const KNOWN_KEYS = [
+    "version",
+    "id",
+    "kind",
+    "createdAt",
+    "headline",
+    "model",
+    "fileCount",
+    "archiveId",
+    "priority",
+    "source",
+    "tags",
+];
+const KNOWN_KEY_ORDER = new Map(KNOWN_KEYS.map((key, index) => [key, index]));
+// Line endings are byte-format state, not record metadata. Keeping them on the
+// parsed object preserves CRLF without exposing a formatting field to callers.
+const parsedLineEndings = new WeakMap();
+/**
+ * Parse the canonical YAML-compatible subset used by memory files.
+ *
+ * Values are canonical JSON strings, finite decimal numbers, or inline
+ * arrays of canonical JSON strings. Known keys stay in the order emitted by
+ * {@link serializeMemoryFile}; unknown keys may follow them and use the same
+ * scalar grammar.
+ */
+export function parseMemoryFile(text) {
+    const lineEnding = text.startsWith("---\r\n")
+        ? "\r\n"
+        : text.startsWith("---\n")
+            ? "\n"
+            : undefined;
+    if (!lineEnding)
+        throw new Error("Memory file must start with a frontmatter delimiter");
+    const closingDelimiter = `${lineEnding}---${lineEnding}`;
+    const closingIndex = text.indexOf(closingDelimiter, 3 + lineEnding.length);
+    if (closingIndex === -1)
+        throw new Error("Memory file is missing its closing delimiter");
+    const header = text.slice(3 + lineEnding.length, closingIndex);
+    const content = text.slice(closingIndex + closingDelimiter.length);
+    assertContent(content);
+    const values = new Map();
+    let lastKnownIndex = -1;
+    let sawUnknown = false;
+    for (const line of header.split(lineEnding)) {
+        const separator = line.indexOf(": ");
+        if (separator <= 0)
+            throw new Error(`Invalid frontmatter line: ${line}`);
+        const key = line.slice(0, separator);
+        const rawValue = line.slice(separator + 2);
+        if (!KEY_PATTERN.test(key))
+            throw new Error(`Invalid frontmatter key: ${key}`);
+        if (values.has(key))
+            throw new Error(`Duplicate frontmatter key: ${key}`);
+        if (key === "sourceFolder") {
+            throw new Error("sourceFolder is private archive metadata and cannot enter a memory file");
+        }
+        const knownIndex = KNOWN_KEY_ORDER.get(key);
+        if (knownIndex === undefined) {
+            sawUnknown = true;
+        }
+        else {
+            if (sawUnknown || knownIndex <= lastKnownIndex) {
+                throw new Error(`Frontmatter key is out of canonical order: ${key}`);
+            }
+            lastKnownIndex = knownIndex;
+        }
+        values.set(key, parseScalar(rawValue));
+    }
+    const version = requireNumber(values, "version");
+    if (version !== 1)
+        throw new Error(`Unsupported memory file version: ${version}`);
+    const kind = requireString(values, "kind");
+    if (kind !== "train" && kind !== "note")
+        throw new Error(`Invalid memory kind: ${kind}`);
+    const createdAt = requireNumber(values, "createdAt");
+    if (!Number.isSafeInteger(createdAt) || createdAt < 0) {
+        throw new Error("createdAt must be a non-negative integer");
+    }
+    const fileCount = optionalNumber(values, "fileCount");
+    if (fileCount !== undefined && (!Number.isSafeInteger(fileCount) || fileCount < 0)) {
+        throw new Error("fileCount must be a non-negative integer");
+    }
+    const record = {
+        version: 1,
+        id: requireIdSegment(values, "id"),
+        kind,
+        createdAt,
+        ...optionalStringProperty(values, "headline"),
+        ...optionalStringProperty(values, "model"),
+        ...(fileCount === undefined ? {} : { fileCount }),
+        ...optionalIdSegmentProperty(values, "archiveId"),
+        ...optionalStringProperty(values, "priority"),
+        ...optionalStringProperty(values, "source"),
+        ...optionalStringArrayProperty(values, "tags"),
+        ...extraProperties(values),
+        content,
+    };
+    parsedLineEndings.set(record, lineEnding);
+    return record;
+}
+/** Serialize a memory record into the one canonical byte representation. */
+export function serializeMemoryFile(record) {
+    validateRecord(record);
+    const lineEnding = parsedLineEndings.get(record) ?? "\n";
+    const fields = [
+        ["version", record.version],
+        ["id", record.id],
+        ["kind", record.kind],
+        ["createdAt", record.createdAt],
+    ];
+    appendOptional(fields, "headline", record.headline);
+    appendOptional(fields, "model", record.model);
+    appendOptional(fields, "fileCount", record.fileCount);
+    appendOptional(fields, "archiveId", record.archiveId);
+    appendOptional(fields, "priority", record.priority);
+    appendOptional(fields, "source", record.source);
+    appendOptional(fields, "tags", record.tags);
+    for (const [key, value] of Object.entries(record.extra ?? {})) {
+        if (!KEY_PATTERN.test(key) || KNOWN_KEY_ORDER.has(key) || key === "sourceFolder") {
+            throw new Error(`Invalid extra frontmatter key: ${key}`);
+        }
+        fields.push([key, value]);
+    }
+    const header = fields.map(([key, value]) => `${key}: ${serializeScalar(value)}`).join(lineEnding);
+    return `---${lineEnding}${header}${lineEnding}---${lineEnding}${record.content}`;
+}
+/** Return the safe slug owned by a bare `<slug>.md` filename. */
+export function slugFromFilename(name) {
+    if (basename(name) !== name || !name.endsWith(".md")) {
+        throw new Error(`Memory filename must be a bare .md filename: ${name}`);
+    }
+    const slug = name.slice(0, -3);
+    if (!SLUG_PATTERN.test(slug))
+        throw new Error(`Unsafe memory slug: ${slug}`);
+    return slug;
+}
+function parseScalar(rawValue) {
+    if (NUMBER_PATTERN.test(rawValue)) {
+        const value = Number(rawValue);
+        if (Number.isFinite(value) && String(value) === rawValue)
+            return value;
+    }
+    try {
+        const value = JSON.parse(rawValue);
+        if (typeof value === "string" && JSON.stringify(value) === rawValue)
+            return value;
+        if (Array.isArray(value) &&
+            value.every((item) => typeof item === "string") &&
+            `[${value.map((item) => JSON.stringify(item)).join(", ")}]` === rawValue) {
+            return value;
+        }
+    }
+    catch {
+        // The grammar error below is more useful than JSON's parser diagnostic.
+    }
+    throw new Error(`Unsupported frontmatter scalar: ${rawValue}`);
+}
+function serializeScalar(value) {
+    if (typeof value === "number") {
+        if (!Number.isFinite(value) || /[eE]/.test(String(value))) {
+            throw new Error(`Frontmatter numbers must be finite decimals: ${value}`);
+        }
+        return String(value);
+    }
+    if (typeof value === "string")
+        return JSON.stringify(value);
+    if (Array.isArray(value) && value.every((item) => typeof item === "string")) {
+        return `[${value.map((item) => JSON.stringify(item)).join(", ")}]`;
+    }
+    throw new Error("Frontmatter values must be strings, numbers, or string arrays");
+}
+function requireNumber(values, key) {
+    const value = values.get(key);
+    if (typeof value !== "number")
+        throw new Error(`Frontmatter ${key} must be a number`);
+    return value;
+}
+function optionalNumber(values, key) {
+    const value = values.get(key);
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "number")
+        throw new Error(`Frontmatter ${key} must be a number`);
+    return value;
+}
+function requireString(values, key) {
+    const value = values.get(key);
+    if (typeof value !== "string")
+        throw new Error(`Frontmatter ${key} must be a string`);
+    return value;
+}
+function requireNonBlankString(values, key) {
+    const value = requireString(values, key);
+    if (value.trim().length === 0)
+        throw new Error(`Frontmatter ${key} cannot be blank`);
+    return value;
+}
+function requireIdSegment(values, key) {
+    return assertIdSegment(key, requireNonBlankString(values, key));
+}
+function optionalIdSegmentProperty(values, key) {
+    if (!values.has(key))
+        return {};
+    return { [key]: requireIdSegment(values, key) };
+}
+function assertIdSegment(key, value) {
+    if (!ID_SEGMENT_PATTERN.test(value)) {
+        throw new Error(`Frontmatter ${key} must be a safe path segment: ${value}`);
+    }
+    return value;
+}
+function optionalStringProperty(values, key) {
+    if (!values.has(key))
+        return {};
+    return { [key]: requireNonBlankString(values, key) };
+}
+function optionalStringArrayProperty(values, key) {
+    const value = values.get(key);
+    if (value === undefined)
+        return {};
+    if (!Array.isArray(value) || value.some((item) => item.trim().length === 0)) {
+        throw new Error(`Frontmatter ${key} must be a string array without blank items`);
+    }
+    return { tags: value };
+}
+function extraProperties(values) {
+    const extra = Object.fromEntries(Array.from(values).filter(([key]) => !KNOWN_KEY_ORDER.has(key)));
+    return Object.keys(extra).length === 0 ? {} : { extra };
+}
+function appendOptional(fields, key, value) {
+    if (value !== undefined)
+        fields.push([key, value]);
+}
+function validateRecord(record) {
+    if (record.version !== 1)
+        throw new Error(`Unsupported memory file version: ${record.version}`);
+    if (record.id.trim().length === 0)
+        throw new Error("Frontmatter id cannot be blank");
+    assertIdSegment("id", record.id);
+    if (record.archiveId !== undefined)
+        assertIdSegment("archiveId", record.archiveId);
+    if (record.kind !== "train" && record.kind !== "note") {
+        throw new Error(`Invalid memory kind: ${String(record.kind)}`);
+    }
+    if (!Number.isSafeInteger(record.createdAt) || record.createdAt < 0) {
+        throw new Error("createdAt must be a non-negative integer");
+    }
+    if (record.fileCount !== undefined &&
+        (!Number.isSafeInteger(record.fileCount) || record.fileCount < 0)) {
+        throw new Error("fileCount must be a non-negative integer");
+    }
+    for (const [key, value] of Object.entries({
+        headline: record.headline,
+        model: record.model,
+        archiveId: record.archiveId,
+        priority: record.priority,
+        source: record.source,
+    })) {
+        if (value !== undefined && value.trim().length === 0) {
+            throw new Error(`Frontmatter ${key} cannot be blank`);
+        }
+    }
+    if (record.tags?.some((tag) => tag.trim().length === 0)) {
+        throw new Error("Frontmatter tags cannot contain blank items");
+    }
+    assertContent(record.content);
+}
+function assertContent(content) {
+    if (content.trim().length === 0)
+        throw new Error("Memory content cannot be blank");
+    const bytes = Buffer.byteLength(content, "utf8");
+    if (bytes > MAX_TRAIN_RECORD_CONTENT_BYTES) {
+        throw new Error(`Memory content exceeds ${MAX_TRAIN_RECORD_CONTENT_BYTES} UTF-8 bytes`);
+    }
+}
+//# sourceMappingURL=file.js.map

package/dist/src/memory/store/file.js.map

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

package/dist/src/memory/store/index.d.ts

@@ -0,0 +1,5 @@
+export { MAX_TRAIN_RECORD_CONTENT_BYTES, parseMemoryFile, serializeMemoryFile, slugFromFilename, type MemoryFileRecord, type MemoryFrontmatterValue, type MemoryKind, } from "./file.js";
+export { discoverMemoryStores } from "./discovery.js";
+export { mergeListings, resolveSources, type MemorySourceFlags, type MemorySources, type MemoryWriteTarget, type SourceListing, } from "./sources.js";
+export { deleteEntry, listStore, readEntry, updateEntry, writeEntry, type MemoryEntryInput, type StoredMemory, } from "./store.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/memory/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,UAAU,GAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EACL,aAAa,EACb,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,aAAa,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,WAAW,EACX,SAAS,EACT,SAAS,EACT,WAAW,EACX,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC"}

package/dist/src/memory/store/index.js

@@ -0,0 +1,5 @@
+export { MAX_TRAIN_RECORD_CONTENT_BYTES, parseMemoryFile, serializeMemoryFile, slugFromFilename, } from "./file.js";
+export { discoverMemoryStores } from "./discovery.js";
+export { mergeListings, resolveSources, } from "./sources.js";
+export { deleteEntry, listStore, readEntry, updateEntry, writeEntry, } from "./store.js";
+//# sourceMappingURL=index.js.map

package/dist/src/memory/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/memory/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,eAAe,EACf,mBAAmB,EACnB,gBAAgB,GAIjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EACL,aAAa,EACb,cAAc,GAKf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,WAAW,EACX,SAAS,EACT,SAAS,EACT,WAAW,EACX,UAAU,GAGX,MAAM,YAAY,CAAC"}

package/dist/src/memory/store/pack.d.ts

@@ -0,0 +1,25 @@
+import { type StoredMemory } from "./store.js";
+/** Standalone ceiling for curated file memory pinned into an agent prompt. */
+export declare const PINNED_STORE_TOKEN_BUDGET = 15000;
+export interface LoadPinnedStorePackOptions {
+    /** Store directories in collision precedence order, nearest first. */
+    stores: readonly string[];
+    /** Independent ceiling for file-backed content; defaults to 15,000 tokens. */
+    tokenBudget?: number;
+}
+export interface PinnedStorePack {
+    /** Newest-first entries retained after collision resolution and budget fitting. */
+    entries: StoredMemory[];
+    /** Number of complete older entries removed to satisfy the cap. */
+    dropped: number;
+}
+/**
+ * Load a frozen, newest-first view of curated file memories.
+ *
+ * Malformed entries are isolated to their own file and warned about instead
+ * of making agent startup fail. When the complete set exceeds the independent
+ * cap, whole entries leave oldest-first; the newest entry is retained and
+ * deterministically tail-truncated when it alone is too large.
+ */
+export declare function loadPinnedStorePack(options: LoadPinnedStorePackOptions): Promise<PinnedStorePack>;
+//# sourceMappingURL=pack.d.ts.map

package/dist/src/memory/store/pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.d.ts","sourceRoot":"","sources":["../../../../src/memory/store/pack.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAElE,8EAA8E;AAC9E,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD,MAAM,WAAW,0BAA0B;IACzC,sEAAsE;IACtE,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,eAAe,CAAC,CAwC1B"}

package/dist/src/memory/store/pack.js

@@ -0,0 +1,71 @@
+import { estimateTokens } from "../observational.js";
+import { mergeListings } from "./sources.js";
+import { listStoreTolerant } from "./store.js";
+/** Standalone ceiling for curated file memory pinned into an agent prompt. */
+export const PINNED_STORE_TOKEN_BUDGET = 15_000;
+/**
+ * Load a frozen, newest-first view of curated file memories.
+ *
+ * Malformed entries are isolated to their own file and warned about instead
+ * of making agent startup fail. When the complete set exceeds the independent
+ * cap, whole entries leave oldest-first; the newest entry is retained and
+ * deterministically tail-truncated when it alone is too large.
+ */
+export async function loadPinnedStorePack(options) {
+    const tokenBudget = options.tokenBudget ?? PINNED_STORE_TOKEN_BUDGET;
+    if (!Number.isFinite(tokenBudget) || tokenBudget < 0) {
+        throw new Error(`Pinned store token budget must be a non-negative number: ${tokenBudget}`);
+    }
+    const listings = await Promise.all(options.stores.map(async (store) => ({
+        source: store,
+        entries: await loadStoreEntries(store),
+    })));
+    const entries = mergeListings(listings, []);
+    let totalTokens = entries.reduce((total, entry) => total + estimateTokens(entry.content), 0);
+    let dropped = 0;
+    let truncated = false;
+    while (entries.length > 1 && totalTokens > tokenBudget) {
+        const removed = entries.pop();
+        totalTokens -= estimateTokens(removed.content);
+        dropped += 1;
+    }
+    if (entries.length === 1 && totalTokens > tokenBudget) {
+        entries[0] = {
+            ...entries[0],
+            content: truncateToTokenBudget(entries[0].content, tokenBudget),
+        };
+        truncated = true;
+    }
+    if (dropped > 0 || truncated) {
+        const truncation = truncated ? " and truncated the newest entry" : "";
+        const formattedBudget = tokenBudget.toLocaleString("en-US");
+        console.warn(`[duet-agent] pinned memory store context exceeded ${formattedBudget}-token cap; dropped ${dropped} older memory ${dropped === 1 ? "entry" : "entries"}${truncation}.`);
+    }
+    return { entries, dropped };
+}
+async function loadStoreEntries(store) {
+    try {
+        return await listStoreTolerant(store, warnSkippedStore);
+    }
+    catch (error) {
+        warnSkippedStore(store, error);
+        return [];
+    }
+}
+function truncateToTokenBudget(content, tokenBudget) {
+    let low = 0;
+    let high = content.length;
+    while (low < high) {
+        const midpoint = Math.ceil((low + high) / 2);
+        if (estimateTokens(content.slice(0, midpoint)) <= tokenBudget)
+            low = midpoint;
+        else
+            high = midpoint - 1;
+    }
+    return content.slice(0, low);
+}
+function warnSkippedStore(path, error) {
+    const reason = error instanceof Error ? error.message : String(error);
+    console.warn(`[duet-agent] skipped malformed memory store entry ${path}: ${reason}`);
+}
+//# sourceMappingURL=pack.js.map

package/dist/src/memory/store/pack.js.map

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

package/dist/src/memory/store/sources.d.ts

@@ -0,0 +1,55 @@
+/** Ordered source paths collected from repeatable CLI backend flags. */
+export interface MemorySourceFlags {
+    /** Explicit memory-file directories, in command-line order. */
+    stores: string[];
+    /** Explicit PGlite files, in command-line order. */
+    dbs: string[];
+}
+/** The single backend selected for a create operation. */
+export interface MemoryWriteTarget {
+    /** Selects the file-store or legacy PGlite persistence path. */
+    kind: "store" | "db";
+    /** Absolute store directory or PGlite data path. */
+    path: string;
+}
+/** Effective read sources plus the create-operation target implied by them. */
+export interface MemorySources {
+    /** File stores in collision-precedence order. */
+    stores: string[];
+    /** PGlite paths in collision-precedence order after every file store. */
+    dbs: string[];
+    /** Present only when the invocation selects exactly one write backend. */
+    writeTarget?: MemoryWriteTarget;
+}
+/** One backend's already-projected listing rows. */
+export interface SourceListing<T> {
+    /** Absolute backend path; file-store groups stamp it as row provenance. */
+    source: string;
+    /** Rows returned by this backend before collision resolution. */
+    entries: readonly T[];
+}
+/**
+ * Resolve explicit flags or the skills-style flagless source set.
+ *
+ * Any explicit backend flag replaces discovery. Without flags, reads inherit
+ * every existing memory store from cwd toward the filesystem root and then
+ * consult the default DB. Writes target the nearest ancestor that owns an
+ * `.agents` directory, falling back to cwd when no agent marker exists; the
+ * `memories` child itself is allowed to be absent because writers create it.
+ */
+export declare function resolveSources(flags: MemorySourceFlags, cwd: string): Promise<MemorySources>;
+/**
+ * Merge projected rows under the one canonical ordering policy.
+ *
+ * File-store groups precede DB groups; within each family the caller supplies
+ * nearest-to-root or explicit flag order. The first row for a slug wins that
+ * collision. Only after shadowed copies are removed are all winners sorted
+ * newest-first, with the precedence order retained for timestamp ties.
+ */
+export declare function mergeListings<T extends {
+    slug: string;
+    createdAt: number;
+}>(storeEntries: readonly SourceListing<T>[], dbEntries: readonly SourceListing<T>[]): Array<T & {
+    store?: string;
+}>;
+//# sourceMappingURL=sources.d.ts.map

package/dist/src/memory/store/sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../../../../src/memory/store/sources.ts"],"names":[],"mappings":"AAOA,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,oDAAoD;IACpD,GAAG,EAAE,MAAM,EAAE,CAAC;CACf;AAED,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IACrB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,yEAAyE;IACzE,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,0EAA0E;IAC1E,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC;AAED,oDAAoD;AACpD,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,aAAa,CAAC,CAuBxB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EACzE,YAAY,EAAE,SAAS,aAAa,CAAC,CAAC,CAAC,EAAE,EACzC,SAAS,EAAE,SAAS,aAAa,CAAC,CAAC,CAAC,EAAE,GACrC,KAAK,CAAC,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAa/B"}