agentfootprint 9.20.0 → 9.22.0

package/dist/artifacts/retention.js.map

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

package/dist/artifacts/sqliteArtifacts.js

@@ -0,0 +1,338 @@
+"use strict";
+/**
+ * artifacts/sqliteArtifacts — the claim-check store in one SQLite file.
+ *
+ * The durable pairing for `sqliteSessions`: point both at files beside each
+ * other and the artifacts a conversation minted live exactly as long as the
+ * conversation that can speak their refs — retention coupled by
+ * construction, not by checkup. It follows `hosting/sqliteSessions` law for
+ * law: `node:sqlite` loaded lazily at construction and refused by name where
+ * absent (no install, no native build, and no version-floor tax on consumers
+ * who never construct one); WAL requested and the journal mode REPORTED as
+ * read back rather than assumed; STRICT tables; a file that exists but is not
+ * ours refused by name (`not-our-schema` / `newer-schema` / `cannot-open`) —
+ * an unreadable store and an empty one are different facts, and only one of
+ * them is safe to answer with a fresh start; `':memory:'` refused, because
+ * `inMemoryArtifacts` says that in its name.
+ *
+ * The columns repeat what the meta knows (kind, bytes, expiry, creation) so
+ * an incident can ask "what is filling this store?" from the `sqlite3`
+ * command line without a JSON parser and without this library.
+ *
+ * One process, one machine, one writer at a time — the same ceiling
+ * sqliteSessions states, inherited rather than restated at length.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sqliteArtifacts = exports.UnreadableArtifactStoreError = void 0;
+const lazyRequire_js_1 = require("../lib/lazyRequire.js");
+const sqliteUnavailable_js_1 = require("../lib/sqliteUnavailable.js");
+const index_js_1 = require("../memory/identity/index.js");
+const minting_js_1 = require("./minting.js");
+const naming_js_1 = require("./naming.js");
+const payload_js_1 = require("./payload.js");
+const retention_js_1 = require("./retention.js");
+const types_js_1 = require("./types.js");
+/**
+ * Raised when the file exists but this runtime cannot use it as an artifact
+ * store — never answered with an empty store. Same law, same three cases as
+ * `UnreadableSessionFileError`, per store.
+ */
+class UnreadableArtifactStoreError extends Error {
+    code = 'ERR_UNREADABLE_ARTIFACT_STORE';
+    file;
+    problem;
+    constructor(file, problem, detail) {
+        super(`[artifacts] the artifact store at '${file}' cannot be used: ${detail} ` +
+            `An unreadable store and an empty one are different facts, and only one of them is ` +
+            `safe to answer with a fresh start. ` +
+            (problem === 'newer-schema'
+                ? `Roll agentfootprint forward, or point this store at its own file.`
+                : problem === 'not-our-schema'
+                    ? `Give the store a file of its own rather than sharing one with tables of the ` +
+                        `same name.`
+                    : `Check the path and its permissions, or move the file aside to start a new one.`));
+        this.name = 'UnreadableArtifactStoreError';
+        this.file = file;
+        this.problem = problem;
+    }
+}
+exports.UnreadableArtifactStoreError = UnreadableArtifactStoreError;
+/** Bumped only for a change an older reader could not survive. */
+const SCHEMA_VERSION = 1;
+const ARTIFACTS_TABLE = 'af_artifacts';
+const META_TABLE = 'af_artifacts_meta';
+const ARTIFACT_COLUMNS = [
+    'scope_ns',
+    'ref',
+    'kind',
+    'media_type',
+    'bytes',
+    'label',
+    'digest',
+    'expires_at',
+    'origin',
+    'parent_refs',
+    'created_at',
+    'last_accessed_at',
+    'payload_shape',
+    'payload',
+];
+/**
+ * An artifact store in one SQLite file — durable across restarts, crash-safe
+ * under WAL, and the natural neighbour of `sqliteSessions({ file })`.
+ *
+ * @throws SqliteUnavailableError when the running Node has no `node:sqlite`.
+ * @throws UnreadableArtifactStoreError when the file exists but cannot be used.
+ *
+ * @example
+ *   const agent = Agent.create({
+ *     provider,
+ *     artifacts: sqliteArtifacts({ file: './data/artifacts.db' }),
+ *   });
+ */
+function sqliteArtifacts(options) {
+    const { file, retention, busyTimeoutMs = 5000 } = options;
+    if (file === ':memory:' || typeof file !== 'string' || file.trim() === '') {
+        throw new TypeError(`[artifacts] sqliteArtifacts({ file: '${String(file)}' }) is not a durable store. ` +
+            `':memory:' looks like a file and keeps nothing across a restart, which is the one ` +
+            `thing this adapter exists to do. Use inMemoryArtifacts() when an in-process store ` +
+            `is what you want — it says so in its name — or give this one a real path.`);
+    }
+    (0, retention_js_1.assertRetention)('sqliteArtifacts', retention);
+    const now = options._now ?? Date.now;
+    const DatabaseSync = options._sqlite ?? loadSqlite();
+    ensureParentDirectory(file);
+    let db;
+    try {
+        db = new DatabaseSync(file);
+    }
+    catch (err) {
+        throw new UnreadableArtifactStoreError(file, 'cannot-open', `${describe(err)}.`);
+    }
+    let journalMode;
+    try {
+        journalMode = applyPragmas(db, busyTimeoutMs);
+        ensureSchema(db, file);
+    }
+    catch (err) {
+        db.close();
+        if (err instanceof UnreadableArtifactStoreError)
+            throw err;
+        throw new UnreadableArtifactStoreError(file, 'cannot-open', `${describe(err)}.`);
+    }
+    const insert = db.prepare(`INSERT INTO ${ARTIFACTS_TABLE} (${ARTIFACT_COLUMNS.join(', ')}) ` +
+        `VALUES (${ARTIFACT_COLUMNS.map(() => '?').join(', ')})`);
+    const selectOne = db.prepare(`SELECT ${ARTIFACT_COLUMNS.slice(1).join(', ')} FROM ${ARTIFACTS_TABLE} ` +
+        `WHERE scope_ns = ? AND ref = ?`);
+    const selectScope = db.prepare(`SELECT ref, kind, bytes, expires_at, last_accessed_at FROM ${ARTIFACTS_TABLE} ` +
+        `WHERE scope_ns = ?`);
+    const selectPage = db.prepare(`SELECT ${ARTIFACT_COLUMNS.slice(1).join(', ')} FROM ${ARTIFACTS_TABLE} ` +
+        `WHERE scope_ns = ? ORDER BY created_at DESC, ref ASC LIMIT ? OFFSET ?`);
+    const touch = db.prepare(`UPDATE ${ARTIFACTS_TABLE} SET last_accessed_at = ? WHERE scope_ns = ? AND ref = ?`);
+    const remove = db.prepare(`DELETE FROM ${ARTIFACTS_TABLE} WHERE scope_ns = ? AND ref = ?`);
+    let closed = false;
+    const open = (verb) => {
+        if (closed) {
+            throw new Error(`[artifacts] the sqliteArtifacts store at '${file}' is closed, so it cannot ${verb}. ` +
+                `close() is final by design — reopening the file behind you would hide a ` +
+                `shutdown-ordering bug rather than surface it. Build a new store if you need one.`);
+        }
+    };
+    const rowFor = (ns, ref) => selectOne.get(ns, ref);
+    /** Resolve a live row; sweep it when the calendar says it is gone. */
+    const liveRow = (ns, ref) => {
+        if (!(0, naming_js_1.isArtifactRef)(ref))
+            return undefined;
+        const row = rowFor(ns, ref);
+        if (row === undefined)
+            return undefined;
+        if (row.expires_at !== null && row.expires_at <= now()) {
+            remove.run(ns, ref);
+            return undefined;
+        }
+        return row;
+    };
+    const metaOf = (row) => ({
+        ref: row.ref,
+        kind: row.kind,
+        mediaType: row.media_type,
+        bytes: row.bytes,
+        createdAt: row.created_at,
+        ...(row.label !== null && { label: row.label }),
+        ...(row.digest !== null && { digest: row.digest }),
+        ...(row.expires_at !== null && { expiresAt: row.expires_at }),
+        ...(row.origin !== null && { origin: JSON.parse(row.origin) }),
+        ...(row.parent_refs !== null && {
+            parentRefs: JSON.parse(row.parent_refs),
+        }),
+    });
+    // Port methods are `async` so every refusal arrives as a rejection — the
+    // sqliteSessions law about not needing two error handlers.
+    return {
+        journalMode,
+        async put(scope, input) {
+            open('store an artifact');
+            const ns = (0, index_js_1.identityNamespace)(scope);
+            const at = now();
+            const { meta } = await (0, minting_js_1.prepareArtifact)(input, (parent) => liveRow(ns, parent) !== undefined, retention, at);
+            const held = selectScope.all(ns);
+            const rows = held.map((r) => ({
+                ref: r.ref,
+                kind: r.kind,
+                bytes: r.bytes,
+                ...(r.expires_at !== null && { expiresAt: r.expires_at }),
+                lastAccessedAt: r.last_accessed_at,
+            }));
+            const plan = (0, retention_js_1.planRetention)(rows, meta.bytes, retention, at);
+            if (plan.refusal !== undefined)
+                throw new types_js_1.InvalidArtifactError(plan.refusal);
+            for (const swept of plan.swept)
+                remove.run(ns, swept.ref);
+            const payload = (0, payload_js_1.encodeArtifactData)(input.data);
+            insert.run(ns, meta.ref, meta.kind, meta.mediaType, meta.bytes, meta.label ?? null, meta.digest ?? null, meta.expiresAt ?? null, meta.origin !== undefined ? JSON.stringify(meta.origin) : null, meta.parentRefs !== undefined ? JSON.stringify(meta.parentRefs) : null, meta.createdAt, at, payload.shape, payload.value);
+            return { meta, swept: plan.swept };
+        },
+        // eslint-disable-next-line @typescript-eslint/require-await
+        async head(scope, ref) {
+            open('describe an artifact');
+            const ns = (0, index_js_1.identityNamespace)(scope);
+            const row = liveRow(ns, ref);
+            if (row === undefined)
+                return null;
+            touch.run(now(), ns, ref);
+            return metaOf(row);
+        },
+        async get(scope, ref) {
+            open('read an artifact');
+            const ns = (0, index_js_1.identityNamespace)(scope);
+            const row = liveRow(ns, ref);
+            if (row === undefined)
+                return null;
+            touch.run(now(), ns, ref);
+            const data = (0, payload_js_1.decodeArtifactData)({ shape: row.payload_shape, value: row.payload });
+            if (row.digest !== null) {
+                const actual = await (0, payload_js_1.computeArtifactDigest)(data);
+                if (actual !== row.digest)
+                    throw new types_js_1.ArtifactIntegrityError(row.ref, row.digest, actual);
+            }
+            return { meta: metaOf(row), data };
+        },
+        // eslint-disable-next-line @typescript-eslint/require-await
+        async delete(scope, ref) {
+            open('delete an artifact');
+            if (!(0, naming_js_1.isArtifactRef)(ref))
+                return;
+            remove.run((0, index_js_1.identityNamespace)(scope), ref);
+        },
+        // eslint-disable-next-line @typescript-eslint/require-await
+        async list(scope, listOptions) {
+            open('list artifacts');
+            const ns = (0, index_js_1.identityNamespace)(scope);
+            const at = now();
+            const offset = decodeCursor(listOptions?.cursor);
+            const limit = Math.max(1, Math.floor(listOptions?.limit ?? 50));
+            // Ask for one extra row: "is there another page?" answered by the data.
+            // Expired rows are FILTERED here, not deleted — deleting mid-walk would
+            // shift every later offset and silently skip rows; the actual sweep
+            // happens where single rows are touched (put / head / get).
+            const rows = selectPage.all(ns, limit + 1, offset);
+            const artifacts = [];
+            let consumed = 0;
+            for (const row of rows) {
+                consumed++;
+                if (row.expires_at !== null && row.expires_at <= at)
+                    continue;
+                artifacts.push(metaOf(row));
+                if (artifacts.length === limit)
+                    break;
+            }
+            // More pages when rows were fetched but not walked (early break), or the
+            // over-fetch proved the table extends past this window. A final page that
+            // turns out empty is a valid cursor outcome, not an error.
+            const more = consumed < rows.length || rows.length === limit + 1;
+            return {
+                artifacts,
+                ...(more && { cursor: String(offset + consumed) }),
+            };
+        },
+        close() {
+            if (closed)
+                return;
+            closed = true;
+            db.close();
+        },
+    };
+}
+exports.sqliteArtifacts = sqliteArtifacts;
+// ─── Internals (the sqliteSessions liturgy, per store) ───────────────
+function loadSqlite() {
+    try {
+        const mod = (0, lazyRequire_js_1.lazyRequire)('node:sqlite');
+        if (typeof mod?.DatabaseSync !== 'function') {
+            throw new Error('the module loaded but has no DatabaseSync');
+        }
+        return mod.DatabaseSync;
+    }
+    catch (err) {
+        throw new sqliteUnavailable_js_1.SqliteUnavailableError(nodeVersion(), describe(err));
+    }
+}
+function nodeVersion() {
+    return typeof process !== 'undefined' && typeof process.version === 'string'
+        ? process.version
+        : 'unknown';
+}
+function ensureParentDirectory(file) {
+    try {
+        const { mkdirSync } = (0, lazyRequire_js_1.lazyRequire)('node:fs');
+        const { dirname } = (0, lazyRequire_js_1.lazyRequire)('node:path');
+        mkdirSync(dirname(file), { recursive: true });
+    }
+    catch {
+        /* Reported by the open below, with the path and the real reason. */
+    }
+}
+function applyPragmas(db, busyTimeoutMs) {
+    const row = db.prepare('PRAGMA journal_mode = WAL').get();
+    const waitMs = Number.isFinite(busyTimeoutMs) ? Math.max(0, Math.floor(busyTimeoutMs)) : 5000;
+    db.exec(`PRAGMA busy_timeout = ${waitMs}`);
+    db.exec('PRAGMA synchronous = NORMAL');
+    return typeof row?.journal_mode === 'string' ? row.journal_mode : 'unknown';
+}
+function ensureSchema(db, file) {
+    db.exec(`CREATE TABLE IF NOT EXISTS ${ARTIFACTS_TABLE} (` +
+        `scope_ns TEXT NOT NULL, ref TEXT NOT NULL, kind TEXT NOT NULL, ` +
+        `media_type TEXT NOT NULL, bytes INTEGER NOT NULL, label TEXT, digest TEXT, ` +
+        `expires_at INTEGER, origin TEXT, parent_refs TEXT, created_at INTEGER NOT NULL, ` +
+        `last_accessed_at INTEGER NOT NULL, payload_shape TEXT NOT NULL, payload TEXT NOT NULL, ` +
+        `PRIMARY KEY (scope_ns, ref)) STRICT`);
+    db.exec(`CREATE TABLE IF NOT EXISTS ${META_TABLE} (key TEXT PRIMARY KEY, value TEXT NOT NULL) STRICT`);
+    const columns = db.prepare(`PRAGMA table_info('${ARTIFACTS_TABLE}')`).all().map((c) => String(c.name));
+    const missing = ARTIFACT_COLUMNS.filter((name) => !columns.includes(name));
+    if (missing.length > 0) {
+        throw new UnreadableArtifactStoreError(file, 'not-our-schema', `it has an '${ARTIFACTS_TABLE}' table that is not this store's ` +
+            `(missing ${missing.join(', ')}; found ${columns.join(', ') || 'nothing'}).`);
+    }
+    const stored = db
+        .prepare(`SELECT value FROM ${META_TABLE} WHERE key = 'schema_version'`)
+        .get();
+    if (stored === undefined) {
+        db.prepare(`INSERT INTO ${META_TABLE} (key, value) VALUES ('schema_version', ?)`).run(String(SCHEMA_VERSION));
+        return;
+    }
+    const found = Number(stored.value);
+    if (!Number.isFinite(found) || found > SCHEMA_VERSION) {
+        throw new UnreadableArtifactStoreError(file, 'newer-schema', `it was written with schema version ${String(stored.value)} and this runtime reads ` +
+            `version ${SCHEMA_VERSION}.`);
+    }
+}
+function describe(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function decodeCursor(cursor) {
+    if (cursor === undefined)
+        return 0;
+    const parsed = Number(cursor);
+    return Number.isFinite(parsed) && parsed >= 0 ? Math.floor(parsed) : 0;
+}
+//# sourceMappingURL=sqliteArtifacts.js.map

package/dist/artifacts/sqliteArtifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqliteArtifacts.js","sourceRoot":"","sources":["../../src/artifacts/sqliteArtifacts.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;AAEH,0DAAoD;AACpD,sEAAqE;AACrE,0DAAgE;AAChE,6CAA+C;AAC/C,2CAA4C;AAC5C,6CAKsB;AACtB,iDAKwB;AACxB,yCAWoB;AAsDpB;;;;GAIG;AACH,MAAa,4BAA6B,SAAQ,KAAK;IAC5C,IAAI,GAAG,+BAAwC,CAAC;IAChD,IAAI,CAAS;IACb,OAAO,CAAoD;IAEpE,YAAY,IAAY,EAAE,OAAgD,EAAE,MAAc;QACxF,KAAK,CACH,sCAAsC,IAAI,qBAAqB,MAAM,GAAG;YACtE,oFAAoF;YACpF,qCAAqC;YACrC,CAAC,OAAO,KAAK,cAAc;gBACzB,CAAC,CAAC,mEAAmE;gBACrE,CAAC,CAAC,OAAO,KAAK,gBAAgB;oBAC9B,CAAC,CAAC,8EAA8E;wBAC9E,YAAY;oBACd,CAAC,CAAC,gFAAgF,CAAC,CACxF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AArBD,oEAqBC;AAED,kEAAkE;AAClE,MAAM,cAAc,GAAG,CAAC,CAAC;AACzB,MAAM,eAAe,GAAG,cAAc,CAAC;AACvC,MAAM,UAAU,GAAG,mBAAmB,CAAC;AACvC,MAAM,gBAAgB,GAAG;IACvB,UAAU;IACV,KAAK;IACL,MAAM;IACN,YAAY;IACZ,OAAO;IACP,OAAO;IACP,QAAQ;IACR,YAAY;IACZ,QAAQ;IACR,aAAa;IACb,YAAY;IACZ,kBAAkB;IAClB,eAAe;IACf,SAAS;CACD,CAAC;AAkBX;;;;;;;;;;;;GAYG;AACH,SAAgB,eAAe,CAAC,OAA+B;IAC7D,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAE1D,IAAI,IAAI,KAAK,UAAU,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC1E,MAAM,IAAI,SAAS,CACjB,wCAAwC,MAAM,CAAC,IAAI,CAAC,+BAA+B;YACjF,oFAAoF;YACpF,oFAAoF;YACpF,2EAA2E,CAC9E,CAAC;IACJ,CAAC;IACD,IAAA,8BAAe,EAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC;IAErC,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,IAAI,UAAU,EAAE,CAAC;IACrD,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAE5B,IAAI,EAA+B,CAAC;IACpC,IAAI,CAAC;QACH,EAAE,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,4BAA4B,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnF,CAAC;IAED,IAAI,WAAmB,CAAC;IACxB,IAAI,CAAC;QACH,WAAW,GAAG,YAAY,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;QAC9C,YAAY,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,IAAI,GAAG,YAAY,4BAA4B;YAAE,MAAM,GAAG,CAAC;QAC3D,MAAM,IAAI,4BAA4B,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnF,CAAC;IAED,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CACvB,eAAe,eAAe,KAAK,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QAChE,WAAW,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC3D,CAAC;IACF,MAAM,SAAS,GAAG,EAAE,CAAC,OAAO,CAC1B,UAAU,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,eAAe,GAAG;QACvE,gCAAgC,CACnC,CAAC;IACF,MAAM,WAAW,GAAG,EAAE,CAAC,OAAO,CAC5B,8DAA8D,eAAe,GAAG;QAC9E,oBAAoB,CACvB,CAAC;IACF,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAC3B,UAAU,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,eAAe,GAAG;QACvE,uEAAuE,CAC1E,CAAC;IACF,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CACtB,UAAU,eAAe,0DAA0D,CACpF,CAAC;IACF,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,eAAe,eAAe,iCAAiC,CAAC,CAAC;IAE3F,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,MAAM,IAAI,GAAG,CAAC,IAAY,EAAQ,EAAE;QAClC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,6CAA6C,IAAI,6BAA6B,IAAI,IAAI;gBACpF,0EAA0E;gBAC1E,kFAAkF,CACrF,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,EAAU,EAAE,GAAgB,EAA2B,EAAE,CACvE,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAA4B,CAAC;IAEpD,sEAAsE;IACtE,MAAM,OAAO,GAAG,CAAC,EAAU,EAAE,GAAgB,EAA2B,EAAE;QACxE,IAAI,CAAC,IAAA,yBAAa,EAAC,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAC5B,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACxC,IAAI,GAAG,CAAC,UAAU,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,EAAE,EAAE,CAAC;YACvD,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;YACpB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,GAAgB,EAAgB,EAAE,CAAC,CAAC;QAClD,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,IAAI,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;QAC/C,GAAG,CAAC,GAAG,CAAC,MAAM,KAAK,IAAI,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;QAClD,GAAG,CAAC,GAAG,CAAC,UAAU,KAAK,IAAI,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC;QAC7D,GAAG,CAAC,GAAG,CAAC,MAAM,KAAK,IAAI,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAmB,EAAE,CAAC;QAChF,GAAG,CAAC,GAAG,CAAC,WAAW,KAAK,IAAI,IAAI;YAC9B,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAkB;SACzD,CAAC;KACH,CAAC,CAAC;IAEH,yEAAyE;IACzE,2DAA2D;IAC3D,OAAO;QACL,WAAW;QAEX,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK;YACpB,IAAI,CAAC,mBAAmB,CAAC,CAAC;YAC1B,MAAM,EAAE,GAAG,IAAA,4BAAiB,EAAC,KAAK,CAAC,CAAC;YACpC,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC;YACjB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAA,4BAAe,EACpC,KAAK,EACL,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,SAAS,EAC7C,SAAS,EACT,EAAE,CACH,CAAC;YACF,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,CAM5B,CAAC;YACJ,MAAM,IAAI,GAAkB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC3C,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,GAAG,CAAC,CAAC,CAAC,UAAU,KAAK,IAAI,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC;gBACzD,cAAc,EAAE,CAAC,CAAC,gBAAgB;aACnC,CAAC,CAAC,CAAC;YACJ,MAAM,IAAI,GAAG,IAAA,4BAAa,EAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;YAC5D,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;gBAAE,MAAM,IAAI,+BAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7E,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK;gBAAE,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;YAC1D,MAAM,OAAO,GAAG,IAAA,+BAAkB,EAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/C,MAAM,CAAC,GAAG,CACR,EAAE,EACF,IAAI,CAAC,GAAG,EACR,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,KAAK,IAAI,IAAI,EAClB,IAAI,CAAC,MAAM,IAAI,IAAI,EACnB,IAAI,CAAC,SAAS,IAAI,IAAI,EACtB,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAC9D,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EACtE,IAAI,CAAC,SAAS,EACd,EAAE,EACF,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,KAAK,CACd,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QACrC,CAAC;QAED,4DAA4D;QAC5D,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG;YACnB,IAAI,CAAC,sBAAsB,CAAC,CAAC;YAC7B,MAAM,EAAE,GAAG,IAAA,4BAAiB,EAAC,KAAK,CAAC,CAAC;YACpC,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;YAC7B,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC;YACnC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;YAC1B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG;YAClB,IAAI,CAAC,kBAAkB,CAAC,CAAC;YACzB,MAAM,EAAE,GAAG,IAAA,4BAAiB,EAAC,KAAK,CAAC,CAAC;YACpC,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;YAC7B,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC;YACnC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;YAC1B,MAAM,IAAI,GAAG,IAAA,+BAAkB,EAAC,EAAE,KAAK,EAAE,GAAG,CAAC,aAAa,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAClF,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;gBACxB,MAAM,MAAM,GAAG,MAAM,IAAA,kCAAqB,EAAC,IAAI,CAAC,CAAC;gBACjD,IAAI,MAAM,KAAK,GAAG,CAAC,MAAM;oBAAE,MAAM,IAAI,iCAAsB,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC3F,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;QACrC,CAAC;QAED,4DAA4D;QAC5D,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG;YACrB,IAAI,CAAC,oBAAoB,CAAC,CAAC;YAC3B,IAAI,CAAC,IAAA,yBAAa,EAAC,GAAG,CAAC;gBAAE,OAAO;YAChC,MAAM,CAAC,GAAG,CAAC,IAAA,4BAAiB,EAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;QAC5C,CAAC;QAED,4DAA4D;QAC5D,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,WAAiC;YACjD,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACvB,MAAM,EAAE,GAAG,IAAA,4BAAiB,EAAC,KAAK,CAAC,CAAC;YACpC,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC;YACjB,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YACjD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;YAChE,wEAAwE;YACxE,wEAAwE;YACxE,oEAAoE;YACpE,4DAA4D;YAC5D,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,CAAkB,CAAC;YACpE,MAAM,SAAS,GAAmB,EAAE,CAAC;YACrC,IAAI,QAAQ,GAAG,CAAC,CAAC;YACjB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,QAAQ,EAAE,CAAC;gBACX,IAAI,GAAG,CAAC,UAAU,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,IAAI,EAAE;oBAAE,SAAS;gBAC9D,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC5B,IAAI,SAAS,CAAC,MAAM,KAAK,KAAK;oBAAE,MAAM;YACxC,CAAC;YACD,yEAAyE;YACzE,0EAA0E;YAC1E,2DAA2D;YAC3D,MAAM,IAAI,GAAG,QAAQ,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,GAAG,CAAC,CAAC;YACjE,OAAO;gBACL,SAAS;gBACT,GAAG,CAAC,IAAI,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC;aACnD,CAAC;QACJ,CAAC;QAED,KAAK;YACH,IAAI,MAAM;gBAAE,OAAO;YACnB,MAAM,GAAG,IAAI,CAAC;YACd,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC;KACF,CAAC;AACJ,CAAC;AAvND,0CAuNC;AAED,wEAAwE;AAExE,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAA,4BAAW,EAA8C,aAAa,CAAC,CAAC;QACpF,IAAI,OAAO,GAAG,EAAE,YAAY,KAAK,UAAU,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,GAAG,CAAC,YAAY,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,6CAAsB,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED,SAAS,WAAW;IAClB,OAAO,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ;QAC1E,CAAC,CAAC,OAAO,CAAC,OAAO;QACjB,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAY;IACzC,IAAI,CAAC;QACH,MAAM,EAAE,SAAS,EAAE,GAAG,IAAA,4BAAW,EAA2B,SAAS,CAAC,CAAC;QACvE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAA,4BAAW,EAA6B,WAAW,CAAC,CAAC;QACzE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,oEAAoE;IACtE,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,EAA+B,EAAE,aAAqB;IAC1E,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC,GAAG,EAE1C,CAAC;IACd,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9F,EAAE,CAAC,IAAI,CAAC,yBAAyB,MAAM,EAAE,CAAC,CAAC;IAC3C,EAAE,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IACvC,OAAO,OAAO,GAAG,EAAE,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9E,CAAC;AAED,SAAS,YAAY,CAAC,EAA+B,EAAE,IAAY;IACjE,EAAE,CAAC,IAAI,CACL,8BAA8B,eAAe,IAAI;QAC/C,iEAAiE;QACjE,6EAA6E;QAC7E,kFAAkF;QAClF,yFAAyF;QACzF,qCAAqC,CACxC,CAAC;IACF,EAAE,CAAC,IAAI,CACL,8BAA8B,UAAU,qDAAqD,CAC9F,CAAC;IAEF,MAAM,OAAO,GACX,EAAE,CAAC,OAAO,CAAC,sBAAsB,eAAe,IAAI,CAAC,CAAC,GAAG,EAC1D,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,4BAA4B,CACpC,IAAI,EACJ,gBAAgB,EAChB,cAAc,eAAe,mCAAmC;YAC9D,YAAY,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,IAAI,CAC/E,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,EAAE;SACd,OAAO,CAAC,qBAAqB,UAAU,+BAA+B,CAAC;SACvE,GAAG,EAAqC,CAAC;IAC5C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,EAAE,CAAC,OAAO,CAAC,eAAe,UAAU,4CAA4C,CAAC,CAAC,GAAG,CACnF,MAAM,CAAC,cAAc,CAAC,CACvB,CAAC;QACF,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,cAAc,EAAE,CAAC;QACtD,MAAM,IAAI,4BAA4B,CACpC,IAAI,EACJ,cAAc,EACd,sCAAsC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B;YAClF,WAAW,cAAc,GAAG,CAC/B,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,GAAY;IAC5B,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,YAAY,CAAC,MAA0B;IAC9C,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC"}

package/dist/artifacts/types.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * artifacts/types — the claim-check shapes and the five-verb port.
+ *
+ * A tool stores its result under a REFERENCE and hands the model a claim
+ * ticket; the model routes tickets instead of hauling data. These are the
+ * shapes that make that sentence true: the ref (an opaque minted string),
+ * the metadata a consumer decides from (never the bytes), and the store
+ * port every backend implements.
+ *
+ * ── The constitution this port inherits (from `MemoryStore`) ────────────────
+ *   1. **Scope is always the first argument.** Every call takes an
+ *      {@link ArtifactScope} — the same tenant/principal/conversation tuple
+ *      memory scopes on — so stores enforce isolation at the boundary. A ref
+ *      alone opens NOTHING; a wrong scope surfaces as "no data", never as a
+ *      cross-tenant read.
+ *   2. **`get` returns `null` for missing OR expired.** Deliberate ambiguity:
+ *      "no data" is the only actionable fact, and distinguishing the two would
+ *      let a caller reason about another scope's contents.
+ *   3. **Reads return cursors, not unbounded arrays.** `list` pages.
+ *   4. **Methods return Promises uniformly**, so sync adapters can become
+ *      async ones without breaking a caller.
+ *
+ * ── Five verbs, no more ─────────────────────────────────────────────────────
+ * `put · head · get · delete · list`. The moment this port grows `query()` or
+ * `transform()` we are building a database — compute belongs to the code leg,
+ * and that refusal is written here so a future round can be refused by
+ * citation. No streaming members either: an in-memory adapter must never fake
+ * a stream (streaming is a later, feature-detected addition — not Phase 1).
+ *
+ * `head` earns its place because it IS the render-by-ref decision: a consumer
+ * picks what to do from `kind` and `bytes` without paying for the payload.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidArtifactError = exports.ArtifactIntegrityError = exports.UnknownParentRefError = void 0;
+// ─── Refusals ────────────────────────────────────────────────────────
+/**
+ * A `put` named a parent that does not resolve in the same scope — a foreign
+ * key that would dangle at birth. Refused at mint, because a derivation fact
+ * that points at nothing is worse than no fact: every later consumer would
+ * inherit the lie.
+ */
+class UnknownParentRefError extends Error {
+    code = 'ERR_UNKNOWN_PARENT_REF';
+    /** The parents that failed to resolve. */
+    unresolved;
+    constructor(unresolved) {
+        super(`[artifacts] put refused: parentRefs ${unresolved.map((r) => `'${r}'`).join(', ')} ` +
+            `do not resolve in this scope. parentRefs are derivation FACTS validated at mint — ` +
+            `a parent must exist (and not be expired) in the same scope when the child is born. ` +
+            `Store the parent first, or drop it from parentRefs; head(ref) tells you what resolves.`);
+        this.name = 'UnknownParentRefError';
+        this.unresolved = unresolved;
+    }
+}
+exports.UnknownParentRefError = UnknownParentRefError;
+/**
+ * A stored payload no longer matches the digest minted with it. Thrown by
+ * `get` instead of returning the bytes — corrupt data delivered as whole data
+ * is the accepted-and-silently-wrong failure, and the one thing a claim check
+ * must never do is honor a ticket with someone else's parcel.
+ */
+class ArtifactIntegrityError extends Error {
+    code = 'ERR_ARTIFACT_INTEGRITY';
+    ref;
+    /** The digest minted at put. */
+    expected;
+    /** The digest of what the store actually holds now. */
+    actual;
+    constructor(ref, expected, actual) {
+        super(`[artifacts] get('${ref}') refused: the stored payload no longer matches its minted ` +
+            `digest (expected ${expected}, computed ${actual}). The bytes changed after put — ` +
+            `a corrupted file, an external edit, or a store bug — and returning them as if whole ` +
+            `would be silent corruption. Re-create the artifact from its source; the meta ` +
+            `(head) is still readable.`);
+        this.name = 'ArtifactIntegrityError';
+        this.ref = ref;
+        this.expected = expected;
+        this.actual = actual;
+    }
+}
+exports.ArtifactIntegrityError = ArtifactIntegrityError;
+/**
+ * A `put` this store cannot honor as stated — a payload JSON cannot carry, a
+ * blank `kind`, a payload larger than the whole scope budget. Refused by name
+ * at the door: storing an approximation would be accepted-and-silently-wrong.
+ */
+class InvalidArtifactError extends Error {
+    code = 'ERR_INVALID_ARTIFACT';
+    constructor(detail) {
+        super(`[artifacts] put refused: ${detail}`);
+        this.name = 'InvalidArtifactError';
+    }
+}
+exports.InvalidArtifactError = InvalidArtifactError;
+//# sourceMappingURL=types.js.map

package/dist/artifacts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/artifacts/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;;;AA2KH,wEAAwE;AAExE;;;;;GAKG;AACH,MAAa,qBAAsB,SAAQ,KAAK;IACrC,IAAI,GAAG,wBAAiC,CAAC;IAClD,0CAA0C;IACjC,UAAU,CAAyB;IAE5C,YAAY,UAAkC;QAC5C,KAAK,CACH,uCAAuC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YAClF,oFAAoF;YACpF,qFAAqF;YACrF,wFAAwF,CAC3F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAfD,sDAeC;AAED;;;;;GAKG;AACH,MAAa,sBAAuB,SAAQ,KAAK;IACtC,IAAI,GAAG,wBAAiC,CAAC;IACzC,GAAG,CAAc;IAC1B,gCAAgC;IACvB,QAAQ,CAAS;IAC1B,uDAAuD;IAC9C,MAAM,CAAS;IAExB,YAAY,GAAgB,EAAE,QAAgB,EAAE,MAAc;QAC5D,KAAK,CACH,oBAAoB,GAAG,8DAA8D;YACnF,oBAAoB,QAAQ,cAAc,MAAM,mCAAmC;YACnF,sFAAsF;YACtF,+EAA+E;YAC/E,2BAA2B,CAC9B,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AArBD,wDAqBC;AAED;;;;GAIG;AACH,MAAa,oBAAqB,SAAQ,KAAK;IACpC,IAAI,GAAG,sBAA+B,CAAC;IAEhD,YAAY,MAAc;QACxB,KAAK,CAAC,4BAA4B,MAAM,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAPD,oDAOC"}