@cogenta/agents 0.1.0

package/dist/rag/index/bm25.js

@@ -0,0 +1,38 @@
+const K1 = 1.5;
+const B = 0.75;
+function tokenize(text) {
+    return text.toLowerCase().match(/[\p{L}\p{N}]+/gu) ?? [];
+}
+/** Standard Okapi BM25 over each chunk's text — the keyword half of the hybrid search. */
+export function bm25Rank(chunks, queryText) {
+    const queryTerms = tokenize(queryText);
+    if (chunks.length === 0 || queryTerms.length === 0)
+        return [];
+    const docs = chunks.map((indexed) => ({
+        id: indexed.chunk.id,
+        terms: tokenize(indexed.chunk.text),
+    }));
+    const avgLength = docs.reduce((sum, doc) => sum + doc.terms.length, 0) / docs.length;
+    const docFrequency = new Map();
+    for (const term of new Set(queryTerms)) {
+        docFrequency.set(term, docs.filter((doc) => doc.terms.includes(term)).length);
+    }
+    const scored = docs.map((doc) => {
+        const termCounts = new Map();
+        for (const term of doc.terms)
+            termCounts.set(term, (termCounts.get(term) ?? 0) + 1);
+        let score = 0;
+        for (const term of queryTerms) {
+            const documentFrequency = docFrequency.get(term) ?? 0;
+            if (documentFrequency === 0)
+                continue;
+            const idf = Math.log((docs.length - documentFrequency + 0.5) / (documentFrequency + 0.5) + 1);
+            const termFrequency = termCounts.get(term) ?? 0;
+            const denominator = termFrequency + K1 * (1 - B + (B * doc.terms.length) / (avgLength === 0 ? 1 : avgLength));
+            score += idf * ((termFrequency * (K1 + 1)) / denominator);
+        }
+        return { id: doc.id, score };
+    });
+    return scored.filter((entry) => entry.score > 0).sort((a, b) => b.score - a.score);
+}
+//# sourceMappingURL=bm25.js.map

package/dist/rag/index/bm25.js.map

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

package/dist/rag/index/memory-index.d.ts

@@ -0,0 +1,12 @@
+import type { RagIndex } from './types.js';
+/**
+ * The always-available tier (R1) — every process has memory, nothing to
+ * configure. `search` filters to `options.canAccess` first, then ranks only
+ * what survived: BM25 and cosine similarity each produce a ranked list over
+ * the *filtered* candidate set, fused by RRF. A chunk `canAccess` rejects
+ * therefore cannot influence the result even indirectly (e.g. as noise in
+ * BM25's document-frequency statistics) — it is as if it were never
+ * indexed at all, for the duration of this one query.
+ */
+export declare function createMemoryRagIndex(): RagIndex;
+//# sourceMappingURL=memory-index.d.ts.map

package/dist/rag/index/memory-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-index.d.ts","sourceRoot":"","sources":["../../../src/rag/index/memory-index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAKV,QAAQ,EACT,MAAM,YAAY,CAAA;AAKnB;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,IAAI,QAAQ,CA8B/C"}

package/dist/rag/index/memory-index.js

@@ -0,0 +1,44 @@
+import { bm25Rank } from './bm25.js';
+import { reciprocalRankFusion } from './rrf.js';
+import { vectorRank } from './vector-rank.js';
+const DEFAULT_LIMIT = 10;
+/**
+ * The always-available tier (R1) — every process has memory, nothing to
+ * configure. `search` filters to `options.canAccess` first, then ranks only
+ * what survived: BM25 and cosine similarity each produce a ranked list over
+ * the *filtered* candidate set, fused by RRF. A chunk `canAccess` rejects
+ * therefore cannot influence the result even indirectly (e.g. as noise in
+ * BM25's document-frequency statistics) — it is as if it were never
+ * indexed at all, for the duration of this one query.
+ */
+export function createMemoryRagIndex() {
+    const chunks = new Map();
+    return {
+        upsert(indexed) {
+            chunks.set(indexed.chunk.id, indexed);
+        },
+        remove(chunkId) {
+            chunks.delete(chunkId);
+        },
+        search(query, options) {
+            const allowed = [...chunks.values()].filter((indexed) => options.canAccess(indexed));
+            const byId = new Map(allowed.map((indexed) => [indexed.chunk.id, indexed]));
+            const fused = reciprocalRankFusion([
+                bm25Rank(allowed, query.text),
+                vectorRank(allowed, query.vector),
+            ]);
+            const limit = options.limit ?? DEFAULT_LIMIT;
+            const results = [];
+            for (const { id, score } of fused) {
+                const indexed = byId.get(id);
+                if (indexed === undefined)
+                    continue;
+                results.push({ chunk: indexed.chunk, siteId: indexed.siteId, score });
+                if (results.length >= limit)
+                    break;
+            }
+            return results;
+        },
+    };
+}
+//# sourceMappingURL=memory-index.js.map

package/dist/rag/index/memory-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-index.js","sourceRoot":"","sources":["../../../src/rag/index/memory-index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAQ/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,MAAM,aAAa,GAAG,EAAE,CAAA;AAExB;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAA;IAE9C,OAAO;QACL,MAAM,CAAC,OAAqB;YAC1B,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QACvC,CAAC;QACD,MAAM,CAAC,OAAe;YACpB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QACxB,CAAC;QACD,MAAM,CAAC,KAAwB,EAAE,OAA4B;YAC3D,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;YACpF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;YAE3E,MAAM,KAAK,GAAG,oBAAoB,CAAC;gBACjC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC;gBAC7B,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;aAClC,CAAC,CAAA;YAEF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAAA;YAC5C,MAAM,OAAO,GAAyB,EAAE,CAAA;YACxC,KAAK,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,KAAK,EAAE,CAAC;gBAClC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;gBAC5B,IAAI,OAAO,KAAK,SAAS;oBAAE,SAAQ;gBACnC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;gBACrE,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK;oBAAE,MAAK;YACpC,CAAC;YACD,OAAO,OAAO,CAAA;QAChB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/rag/index/rrf.d.ts

@@ -0,0 +1,9 @@
+import type { RankedId } from './types.js';
+/**
+ * Reciprocal Rank Fusion — merges any number of independently-ranked lists
+ * by rank position, not by raw score (BM25 and cosine similarity live on
+ * different, incomparable scales, so fusing their scores directly would be
+ * meaningless; fusing their ranks is the whole point of RRF).
+ */
+export declare function reciprocalRankFusion(rankings: readonly (readonly RankedId[])[], k?: number): readonly RankedId[];
+//# sourceMappingURL=rrf.d.ts.map

package/dist/rag/index/rrf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rrf.d.ts","sourceRoot":"","sources":["../../../src/rag/index/rrf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAI1C;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,SAAS,CAAC,SAAS,QAAQ,EAAE,CAAC,EAAE,EAC1C,CAAC,SAAY,GACZ,SAAS,QAAQ,EAAE,CAWrB"}

package/dist/rag/index/rrf.js

@@ -0,0 +1,20 @@
+const DEFAULT_K = 60;
+/**
+ * Reciprocal Rank Fusion — merges any number of independently-ranked lists
+ * by rank position, not by raw score (BM25 and cosine similarity live on
+ * different, incomparable scales, so fusing their scores directly would be
+ * meaningless; fusing their ranks is the whole point of RRF).
+ */
+export function reciprocalRankFusion(rankings, k = DEFAULT_K) {
+    const fused = new Map();
+    for (const ranking of rankings) {
+        ranking.forEach((entry, index) => {
+            const rank = index + 1;
+            fused.set(entry.id, (fused.get(entry.id) ?? 0) + 1 / (k + rank));
+        });
+    }
+    return [...fused.entries()]
+        .map(([id, score]) => ({ id, score }))
+        .sort((a, b) => b.score - a.score);
+}
+//# sourceMappingURL=rrf.js.map

package/dist/rag/index/rrf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rrf.js","sourceRoot":"","sources":["../../../src/rag/index/rrf.ts"],"names":[],"mappings":"AAEA,MAAM,SAAS,GAAG,EAAE,CAAA;AAEpB;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAA0C,EAC1C,CAAC,GAAG,SAAS;IAEb,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAA;IACvC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YAC/B,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAA;YACtB,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAA;QAClE,CAAC,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;SACxB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;SACrC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAA;AACtC,CAAC"}

package/dist/rag/index/types.d.ts

@@ -0,0 +1,48 @@
+import type { Chunk } from '../chunking/types.js';
+/**
+ * A chunk (task 15) plus what it needs to be searched and to be filtered: the
+ * site it belongs to and the vector task 14's `EmbeddingProvider` produced
+ * for it. `{provider, model, dimensions}` is not repeated here — an index
+ * mixing vectors from two different models is a caller error, not something
+ * this module tries to detect; the lot's own answer to a model change is a
+ * parallel index (a second `RagIndex` instance), not a mixed one.
+ */
+export interface IndexedChunk {
+    readonly chunk: Chunk;
+    readonly siteId: string;
+    readonly vector: readonly number[];
+}
+export interface HybridSearchQuery {
+    readonly text: string;
+    readonly vector: readonly number[];
+}
+export interface HybridSearchResult {
+    readonly chunk: Chunk;
+    readonly siteId: string;
+    /** The fused RRF score — a rank signal, not a probability or a distance. */
+    readonly score: number;
+}
+export interface HybridSearchOptions {
+    readonly limit?: number;
+    /**
+     * Applied to every candidate **before** BM25/vector scoring even run — a
+     * chunk this rejects is invisible to ranking, not merely dropped after the
+     * fact. "Filtrage de permissions au moment de la requête — non
+     * négociable": this module does not know what a draft, a private entry, or
+     * a site boundary is — that stays the caller's real permission system's
+     * job, structurally injected here exactly like `ContentServiceLike`
+     * (task 5).
+     */
+    readonly canAccess: (chunk: IndexedChunk) => boolean;
+}
+export interface RagIndex {
+    upsert(indexed: IndexedChunk): void;
+    remove(chunkId: string): void;
+    search(query: HybridSearchQuery, options: HybridSearchOptions): readonly HybridSearchResult[];
+}
+/** One ranked list's entry — BM25's, the vector search's, or RRF's fused output. */
+export interface RankedId {
+    readonly id: string;
+    readonly score: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/rag/index/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/rag/index/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAEjD;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB;;;;;;;;OAQG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAA;CACrD;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAA;IACnC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,mBAAmB,GAAG,SAAS,kBAAkB,EAAE,CAAA;CAC9F;AAED,oFAAoF;AACpF,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB"}

package/dist/rag/index/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/rag/index/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/rag/index/types.ts"],"names":[],"mappings":""}

package/dist/rag/index/vector-rank.d.ts

@@ -0,0 +1,4 @@
+import type { IndexedChunk, RankedId } from './types.js';
+/** The vector half of the hybrid search — cosine similarity against each chunk's stored embedding. */
+export declare function vectorRank(chunks: readonly IndexedChunk[], queryVector: readonly number[]): readonly RankedId[];
+//# sourceMappingURL=vector-rank.d.ts.map

package/dist/rag/index/vector-rank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-rank.d.ts","sourceRoot":"","sources":["../../../src/rag/index/vector-rank.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAkBxD,sGAAsG;AACtG,wBAAgB,UAAU,CACxB,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,SAAS,QAAQ,EAAE,CAQrB"}

package/dist/rag/index/vector-rank.js

@@ -0,0 +1,27 @@
+function cosineSimilarity(a, b) {
+    let dot = 0;
+    let magnitudeA = 0;
+    let magnitudeB = 0;
+    const length = Math.min(a.length, b.length);
+    for (let i = 0; i < length; i++) {
+        const valueA = a[i] ?? 0;
+        const valueB = b[i] ?? 0;
+        dot += valueA * valueB;
+        magnitudeA += valueA * valueA;
+        magnitudeB += valueB * valueB;
+    }
+    if (magnitudeA === 0 || magnitudeB === 0)
+        return 0;
+    return dot / (Math.sqrt(magnitudeA) * Math.sqrt(magnitudeB));
+}
+/** The vector half of the hybrid search — cosine similarity against each chunk's stored embedding. */
+export function vectorRank(chunks, queryVector) {
+    return chunks
+        .map((indexed) => ({
+        id: indexed.chunk.id,
+        score: cosineSimilarity(indexed.vector, queryVector),
+    }))
+        .filter((entry) => entry.score > 0)
+        .sort((a, b) => b.score - a.score);
+}
+//# sourceMappingURL=vector-rank.js.map

package/dist/rag/index/vector-rank.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-rank.js","sourceRoot":"","sources":["../../../src/rag/index/vector-rank.ts"],"names":[],"mappings":"AAEA,SAAS,gBAAgB,CAAC,CAAoB,EAAE,CAAoB;IAClE,IAAI,GAAG,GAAG,CAAC,CAAA;IACX,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAA;IAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QACxB,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QACxB,GAAG,IAAI,MAAM,GAAG,MAAM,CAAA;QACtB,UAAU,IAAI,MAAM,GAAG,MAAM,CAAA;QAC7B,UAAU,IAAI,MAAM,GAAG,MAAM,CAAA;IAC/B,CAAC;IACD,IAAI,UAAU,KAAK,CAAC,IAAI,UAAU,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IAClD,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAA;AAC9D,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,UAAU,CACxB,MAA+B,EAC/B,WAA8B;IAE9B,OAAO,MAAM;SACV,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACjB,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE;QACpB,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC;KACrD,CAAC,CAAC;SACF,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;SAClC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAA;AACtC,CAAC"}

package/dist/reversibility/diff.d.ts

@@ -0,0 +1,17 @@
+export type DiffChangeKind = 'added' | 'removed' | 'changed';
+export interface DiffEntry {
+    readonly path: string;
+    readonly kind: DiffChangeKind;
+    readonly before: unknown;
+    readonly after: unknown;
+}
+/**
+ * "Diffé" — Contract C's own word for what every audited action carries.
+ * Not wired into every tool automatically (this runtime has no generic way
+ * to read a tool's "before" state); a caller who has both snapshots — a
+ * revert, a content-edit tool that read the entry first — hands them here
+ * to get the field-by-field record R6 asks for, rather than diffing a raw
+ * serialisation.
+ */
+export declare function diffValues(before: unknown, after: unknown, path?: string): readonly DiffEntry[];
+//# sourceMappingURL=diff.d.ts.map

package/dist/reversibility/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/reversibility/diff.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAA;AAE5D,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB;AAUD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,SAAK,GAAG,SAAS,SAAS,EAAE,CAqB3F"}

package/dist/reversibility/diff.js

@@ -0,0 +1,39 @@
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function sameValue(a, b) {
+    return a === b || JSON.stringify(a) === JSON.stringify(b);
+}
+/**
+ * "Diffé" — Contract C's own word for what every audited action carries.
+ * Not wired into every tool automatically (this runtime has no generic way
+ * to read a tool's "before" state); a caller who has both snapshots — a
+ * revert, a content-edit tool that read the entry first — hands them here
+ * to get the field-by-field record R6 asks for, rather than diffing a raw
+ * serialisation.
+ */
+export function diffValues(before, after, path = '') {
+    if (isPlainObject(before) && isPlainObject(after)) {
+        const entries = [];
+        const keys = new Set([...Object.keys(before), ...Object.keys(after)]);
+        for (const key of keys) {
+            const childPath = path === '' ? key : `${path}.${key}`;
+            const hasBefore = Object.hasOwn(before, key);
+            const hasAfter = Object.hasOwn(after, key);
+            if (!hasBefore) {
+                entries.push({ path: childPath, kind: 'added', before: undefined, after: after[key] });
+            }
+            else if (!hasAfter) {
+                entries.push({ path: childPath, kind: 'removed', before: before[key], after: undefined });
+            }
+            else {
+                entries.push(...diffValues(before[key], after[key], childPath));
+            }
+        }
+        return entries;
+    }
+    if (sameValue(before, after))
+        return [];
+    return [{ path: path === '' ? '(root)' : path, kind: 'changed', before, after }];
+}
+//# sourceMappingURL=diff.js.map

package/dist/reversibility/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/reversibility/diff.ts"],"names":[],"mappings":"AASA,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC7E,CAAC;AAED,SAAS,SAAS,CAAC,CAAU,EAAE,CAAU;IACvC,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;AAC3D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,MAAe,EAAE,KAAc,EAAE,IAAI,GAAG,EAAE;IACnE,IAAI,aAAa,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,OAAO,GAAgB,EAAE,CAAA;QAC/B,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QACrE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,SAAS,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,GAAG,EAAE,CAAA;YACtD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;YAC5C,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;YAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YACxF,CAAC;iBAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACrB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;YAC3F,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC,CAAA;YACjE,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACvC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;AAClF,CAAC"}

package/dist/reversibility/receipt-store.d.ts

@@ -0,0 +1,9 @@
+import type { ReceiptStore } from './types.js';
+/**
+ * In-process — enough for a single run or a single server process to revert
+ * a call it just made. A durable store (surviving a restart) is later work,
+ * the same "not needed until something depends on it" reasoning `withAudit`
+ * and `captureTrace` already followed for their own stores.
+ */
+export declare function createMemoryReceiptStore(): ReceiptStore;
+//# sourceMappingURL=receipt-store.d.ts.map

package/dist/reversibility/receipt-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt-store.d.ts","sourceRoot":"","sources":["../../src/reversibility/receipt-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAyB,YAAY,EAAE,MAAM,YAAY,CAAA;AAErE;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,YAAY,CA6BvD"}

package/dist/reversibility/receipt-store.js

@@ -0,0 +1,34 @@
+import { CogentaError } from '@cogenta/core';
+/**
+ * In-process — enough for a single run or a single server process to revert
+ * a call it just made. A durable store (surviving a restart) is later work,
+ * the same "not needed until something depends on it" reasoning `withAudit`
+ * and `captureTrace` already followed for their own stores.
+ */
+export function createMemoryReceiptStore() {
+    const receipts = new Map();
+    return {
+        async save(receipt) {
+            receipts.set(receipt.id, receipt);
+        },
+        async get(id) {
+            return receipts.get(id) ?? null;
+        },
+        async list(query = {}) {
+            return [...receipts.values()].filter((receipt) => (query.agentName === undefined || receipt.agentName === query.agentName) &&
+                (query.toolName === undefined || receipt.toolName === query.toolName));
+        },
+        async markReverted(id, revertedAt) {
+            const existing = receipts.get(id);
+            if (existing === undefined) {
+                throw new CogentaError({
+                    code: 'RECEIPT_UNKNOWN',
+                    message: `No receipt with id "${id}".`,
+                    hint: 'Check the id, or list receipts to find the right one.',
+                });
+            }
+            receipts.set(id, { ...existing, revertedAt });
+        },
+    };
+}
+//# sourceMappingURL=receipt-store.js.map

package/dist/reversibility/receipt-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt-store.js","sourceRoot":"","sources":["../../src/reversibility/receipt-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAG5C;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB;IACtC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAA;IAE3C,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,OAAgB;YACzB,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QACnC,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,EAAU;YAClB,OAAO,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAA;QACjC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,KAAK,GAAiB,EAAE;YACjC,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAClC,CAAC,OAAO,EAAE,EAAE,CACV,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,CAAC;gBACxE,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,CAAC,CACxE,CAAA;QACH,CAAC;QACD,KAAK,CAAC,YAAY,CAAC,EAAU,EAAE,UAAkB;YAC/C,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YACjC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,MAAM,IAAI,YAAY,CAAC;oBACrB,IAAI,EAAE,iBAAiB;oBACvB,OAAO,EAAE,uBAAuB,EAAE,IAAI;oBACtC,IAAI,EAAE,uDAAuD;iBAC9D,CAAC,CAAA;YACJ,CAAC;YACD,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAA;QAC/C,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/reversibility/revert.d.ts

@@ -0,0 +1,18 @@
+import type { ExecutableTool, ToolExecutionContext } from '../runtime/types.js';
+import type { Receipt, ReceiptStore } from './types.js';
+export interface RevertReceiptOptions {
+    readonly store: ReceiptStore;
+    /** The tools this agent was actually run with — `revert` is looked up by name from here, not from the whole registry, so a call can only be undone by the same tool that made it. */
+    readonly tools: readonly ExecutableTool[];
+    readonly ctx: ToolExecutionContext;
+    readonly now?: () => number;
+}
+/**
+ * Looks up a past call by its receipt id and calls the tool's own `revert`
+ * with exactly what that call produced. Refuses a receipt that was already
+ * reverted (undoing an undo is not this function's job — a fresh, explicit
+ * action is, if that is really what is wanted) and a tool that never
+ * declared `revert` at all, even if the receipt itself is real.
+ */
+export declare function revertReceipt(receiptId: string, options: RevertReceiptOptions): Promise<Receipt>;
+//# sourceMappingURL=revert.d.ts.map

package/dist/reversibility/revert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revert.d.ts","sourceRoot":"","sources":["../../src/reversibility/revert.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC/E,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEvD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;IAC5B,qLAAqL;IACrL,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAA;IACzC,QAAQ,CAAC,GAAG,EAAE,oBAAoB,CAAA;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CAC5B;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,OAAO,CAAC,CA8BlB"}

package/dist/reversibility/revert.js

@@ -0,0 +1,38 @@
+import { CogentaError } from '@cogenta/core';
+/**
+ * Looks up a past call by its receipt id and calls the tool's own `revert`
+ * with exactly what that call produced. Refuses a receipt that was already
+ * reverted (undoing an undo is not this function's job — a fresh, explicit
+ * action is, if that is really what is wanted) and a tool that never
+ * declared `revert` at all, even if the receipt itself is real.
+ */
+export async function revertReceipt(receiptId, options) {
+    const receipt = await options.store.get(receiptId);
+    if (receipt === null) {
+        throw new CogentaError({
+            code: 'RECEIPT_UNKNOWN',
+            message: `No receipt with id "${receiptId}".`,
+            hint: 'Check the id, or list receipts to find the right one.',
+        });
+    }
+    if (receipt.revertedAt !== undefined) {
+        throw new CogentaError({
+            code: 'RECEIPT_ALREADY_REVERTED',
+            message: `Receipt "${receiptId}" was already reverted at ${receipt.revertedAt}.`,
+            hint: 'This receipt cannot be reverted twice; take a new action instead.',
+        });
+    }
+    const tool = options.tools.find((candidate) => candidate.spec.name === receipt.toolName);
+    if (tool?.revert === undefined) {
+        throw new CogentaError({
+            code: 'RECEIPT_NOT_REVERTIBLE',
+            message: `"${receipt.toolName}" has no revert() available in this run.`,
+            hint: 'Only a tool declared reversible: true, and present in the current manifest, can be reverted.',
+        });
+    }
+    await tool.revert(receipt.output, options.ctx);
+    const revertedAt = new Date((options.now ?? Date.now)()).toISOString();
+    await options.store.markReverted(receiptId, revertedAt);
+    return { ...receipt, revertedAt };
+}
+//# sourceMappingURL=revert.js.map

package/dist/reversibility/revert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revert.js","sourceRoot":"","sources":["../../src/reversibility/revert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAY5C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,SAAiB,EACjB,OAA6B;IAE7B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IAClD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,iBAAiB;YACvB,OAAO,EAAE,uBAAuB,SAAS,IAAI;YAC7C,IAAI,EAAE,uDAAuD;SAC9D,CAAC,CAAA;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACrC,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,0BAA0B;YAChC,OAAO,EAAE,YAAY,SAAS,6BAA6B,OAAO,CAAC,UAAU,GAAG;YAChF,IAAI,EAAE,mEAAmE;SAC1E,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IACxF,IAAI,IAAI,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,wBAAwB;YAC9B,OAAO,EAAE,IAAI,OAAO,CAAC,QAAQ,0CAA0C;YACvE,IAAI,EAAE,8FAA8F;SACrG,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;IAC9C,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;IACtE,MAAM,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;IACvD,OAAO,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,CAAA;AACnC,CAAC"}

package/dist/reversibility/types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Contract C's "reçu" (receipt): a reversible tool's own output, kept so
+ * `revert(receipt, ctx)` can later be called with exactly what the original
+ * call produced — nothing here is guessed or reconstructed.
+ */
+export interface Receipt {
+    readonly id: string;
+    readonly agentName: string;
+    readonly toolName: string;
+    readonly input: Readonly<Record<string, unknown>>;
+    readonly output: unknown;
+    readonly executedAt: string;
+    readonly revertedAt?: string;
+}
+export interface ReceiptQuery {
+    readonly agentName?: string;
+    readonly toolName?: string;
+}
+export interface ReceiptStore {
+    save(receipt: Receipt): Promise<void>;
+    get(id: string): Promise<Receipt | null>;
+    list(query?: ReceiptQuery): Promise<readonly Receipt[]>;
+    markReverted(id: string, revertedAt: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/reversibility/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACjD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IACxC,IAAI,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAA;IACvD,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5D"}

package/dist/reversibility/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/reversibility/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/reversibility/types.ts"],"names":[],"mappings":""}

package/dist/reversibility/with-receipts.d.ts

@@ -0,0 +1,19 @@
+import type { ExecutableTool } from '../runtime/types.js';
+import type { ReceiptStore } from './types.js';
+export interface WithReceiptsOptions {
+    readonly agentName: string;
+    readonly store: ReceiptStore;
+    readonly now?: () => number;
+    readonly newId?: () => string;
+}
+/**
+ * Captures a `Receipt` after every successful call of a `reversible: true`
+ * tool — nothing else changes about the call, and nothing is captured for a
+ * tool that is not reversible (there would be nothing to revert it with).
+ * Composes with `withAudit`/`withAutonomy`: order does not matter for what
+ * gets captured, since this only reads the tool's own output.
+ */
+export declare function withReceipts(tool: ExecutableTool, options: WithReceiptsOptions): ExecutableTool;
+/** Applies `withReceipts` to every tool in a manifest. */
+export declare function withReceiptsForManifest(tools: readonly ExecutableTool[], options: WithReceiptsOptions): readonly ExecutableTool[];
+//# sourceMappingURL=with-receipts.d.ts.map

package/dist/reversibility/with-receipts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-receipts.d.ts","sourceRoot":"","sources":["../../src/reversibility/with-receipts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAwB,MAAM,qBAAqB,CAAA;AAC/E,OAAO,KAAK,EAAW,YAAY,EAAE,MAAM,YAAY,CAAA;AAEvD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAA;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,mBAAmB,GAAG,cAAc,CAsB/F;AAED,0DAA0D;AAC1D,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,OAAO,EAAE,mBAAmB,GAC3B,SAAS,cAAc,EAAE,CAE3B"}

package/dist/reversibility/with-receipts.js

@@ -0,0 +1,35 @@
+import { newId } from '@cogenta/core';
+/**
+ * Captures a `Receipt` after every successful call of a `reversible: true`
+ * tool — nothing else changes about the call, and nothing is captured for a
+ * tool that is not reversible (there would be nothing to revert it with).
+ * Composes with `withAudit`/`withAutonomy`: order does not matter for what
+ * gets captured, since this only reads the tool's own output.
+ */
+export function withReceipts(tool, options) {
+    if (tool.reversible !== true)
+        return tool;
+    const now = options.now ?? Date.now;
+    const generateId = options.newId ?? newId;
+    return {
+        ...tool,
+        async execute(input, ctx) {
+            const output = await tool.execute(input, ctx);
+            const receipt = {
+                id: generateId(),
+                agentName: options.agentName,
+                toolName: tool.spec.name,
+                input,
+                output,
+                executedAt: new Date(now()).toISOString(),
+            };
+            await options.store.save(receipt);
+            return output;
+        },
+    };
+}
+/** Applies `withReceipts` to every tool in a manifest. */
+export function withReceiptsForManifest(tools, options) {
+    return tools.map((tool) => withReceipts(tool, options));
+}
+//# sourceMappingURL=with-receipts.js.map

package/dist/reversibility/with-receipts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-receipts.js","sourceRoot":"","sources":["../../src/reversibility/with-receipts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAWrC;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,IAAoB,EAAE,OAA4B;IAC7E,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAEzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAA;IACnC,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAA;IAEzC,OAAO;QACL,GAAG,IAAI;QACP,KAAK,CAAC,OAAO,CAAC,KAAwC,EAAE,GAAyB;YAC/E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;YAC7C,MAAM,OAAO,GAAY;gBACvB,EAAE,EAAE,UAAU,EAAE;gBAChB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;gBACxB,KAAK;gBACL,MAAM;gBACN,UAAU,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE;aAC1C,CAAA;YACD,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACjC,OAAO,MAAM,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,uBAAuB,CACrC,KAAgC,EAChC,OAA4B;IAE5B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;AACzD,CAAC"}

package/dist/runtime/loop.d.ts

@@ -0,0 +1,11 @@
+import type { RunAgentLoopInput, RunResult } from './types.js';
+/**
+ * L4 task 2: one model call, tool dispatch, repeat — with the three guards
+ * the lot's own "pièges connus" call out by name: a step ceiling, repetition
+ * detection, and per-call cost (usage) measured from the first line rather
+ * than discovered later. Permission checking (task 4) and budgets (task 8)
+ * wrap this from the outside; this loop only knows how to hold a
+ * conversation with a model and the tools it was handed.
+ */
+export declare function runAgentLoop(input: RunAgentLoopInput): Promise<RunResult>;
+//# sourceMappingURL=loop.d.ts.map

package/dist/runtime/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/runtime/loop.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,iBAAiB,EACjB,SAAS,EAGV,MAAM,YAAY,CAAA;AAkCnB;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC,CAoG/E"}