@plurnk/plurnk-service 1.0.0

package/dist/schemes/Log.js

@@ -0,0 +1,269 @@
+import { LineMarkerOps } from "../content/index.js";
+import { ReadResolve } from "../content/index.js";
+import Matcher from "../content/matcher.js";
+// log:///<loop_seq>/<turn_seq>/<sequence>[/<op>] — the trailing /op segment
+// is wire-rendering self-documentation derived from the row's `op` field;
+// parsing accepts it (or omits it) and identifies the row by coordinate. The op
+// suffix is case-INSENSITIVE: model ops render UPPERCASE (READ/EDIT/FIND) but the
+// engine-minted rows are lowercase (`error`, `model`), and those are curatable too —
+// a `[A-Z]+`-only suffix silently rejected FOLD(log:///1/6/2/error), so the model
+// could not reclaim budget by folding its own error rows and spiralled to 413 (jumbo).
+const COORDINATE = /^(\d+)\/(\d+)\/(\d+)(?:\/([A-Za-z]+))?$/;
+// §log-coordinate-hierarchy — a log coordinate is a HIERARCHICAL PREFIX: `1` selects loop 1's rows,
+// `1/2` turn 1/2's rows, `1/2/3` the one row. A full coordinate is always 3 parts, so a 1- or 2-part
+// path is unambiguously a prefix — the trailing slash is OPTIONAL (`log:///1/2` ≡ `log:///1/2/`).
+const PARTIAL_COORDINATE = /^\d+(?:\/\d+)?\/?$/;
+// The ONE content projection of a stored rx — what READ shows and therefore what FIND matches
+// (§find-source-agnostic: the matcher must see exactly the content the model can retrieve).
+// rx.content (with its own mimetype) when the op produced a body; the rx itself as compact JSON
+// otherwise (EDIT/SEND acks — inspectable, matchable); the raw string if the rx isn't JSON.
+const rxProjection = (rawRx) => {
+    try {
+        const rx = JSON.parse(rawRx);
+        if (typeof rx.content === "string") {
+            return { content: rx.content, mimetype: typeof rx.mimetype === "string" ? rx.mimetype : "text/plain" };
+        }
+        return { content: JSON.stringify(rx), mimetype: "application/json" };
+    }
+    catch {
+        return { content: rawRx, mimetype: "text/plain" };
+    }
+};
+// A log target pathname → the coordinate GLOB it scopes (§log-coordinate-hierarchy): a partial
+// coordinate (`1`, `1/2`, with or without slash) is a prefix over its descendants; a trailing
+// slash is the folder idiom; a full coordinate/glob passes through. null = malformed.
+const coordinateGlob = (pathname) => {
+    if (pathname === "")
+        return "*";
+    if (pathname.endsWith("/"))
+        return `${pathname}*`;
+    if (PARTIAL_COORDINATE.test(pathname))
+        return `${pathname}/*`;
+    if (parseCoordinate(pathname) !== null || pathname.includes("*"))
+        return pathname;
+    return null;
+};
+const parseCoordinate = (pathname) => {
+    const match = COORDINATE.exec(pathname);
+    if (match === null)
+        return null;
+    return {
+        loopSeq: Number(match[1]),
+        turnSeq: Number(match[2]),
+        sequence: Number(match[3]),
+    };
+};
+// <L> over a matched row set (mirrors EntryFind.#paginate): <N> picks the Nth,
+// <N,M> the range; 0→1, -1→last; out-of-range → 416.
+const paginate = (items, marker) => {
+    const total = items.length;
+    const { first, last } = marker;
+    if (last === null) {
+        if (first === 0 || first === -1)
+            return { status: 200, items: [] };
+        if (first > 0 && first <= total)
+            return { status: 200, items: [items[first - 1]] };
+        return { status: 416 };
+    }
+    const n = first === 0 ? 1 : first;
+    const m = last === -1 ? total : last;
+    if (n < 1 || n > total || m < 1 || m > total || n > m)
+        return { status: 416 };
+    return { status: 200, items: items.slice(n - 1, m) };
+};
+export default class Log {
+    static manifest = {
+        name: "log",
+        channels: {}, // logs render through read(), not channel storage
+        defaultChannel: "",
+        category: "logging",
+        scope: "session",
+        // Engine-only WRITES — but KILL ∈ MUTATING_OPS rides this same gate, and log-KILL is the
+        // model's DB-storage curation lever (plurnk.md:10/:47 + the OP×resource matrix; §model-entry-log-curation).
+        // The model clears the gate; Log's handler surface (kill only — no edit/writeEntry) is the
+        // op-level truth, so every other mutating op still 501s.
+        writableBy: ["plurnk", "model"],
+        volatile: false,
+        modelVisible: true,
+        example: "<<READ(log:///1/2/3)::READ",
+    };
+    async read(statement, ctx) {
+        const { db, runId } = ctx;
+        if (statement.target === null)
+            return { status: 400, content: null, mimetype: null };
+        // log:/// entries have no tag concept (engine-written events).
+        if (Array.isArray(statement.signal) && statement.signal.length > 0) {
+            return { status: 404, content: null, mimetype: null };
+        }
+        const pathname = (statement.target.kind === "url" ? statement.target.pathname : statement.target.raw).replace(/^\//, "");
+        const coord = parseCoordinate(pathname);
+        if (coord === null)
+            return { status: 400, content: null, mimetype: null };
+        const row = await db.log_read_by_coordinate.get({ run_id: runId, loop_seq: coord.loopSeq, turn_seq: coord.turnSeq, sequence: coord.sequence });
+        if (row === undefined)
+            return { status: 404, content: null, mimetype: null };
+        const { content: underlyingContent, mimetype: underlyingMimetype } = rxProjection(row.rx);
+        return ReadResolve.resolve({
+            content: underlyingContent,
+            mimetype: underlyingMimetype,
+            lineMarker: statement.lineMarker,
+            body: statement.body,
+            mimetypes: ctx.mimetypes,
+        });
+    }
+    // §log-uniform-query — FIND over the run's log rows, on the SAME source-agnostic primitive
+    // every entry scheme runs (Matcher.matchCandidates, §find-source-agnostic): candidates are the
+    // coordinate-scoped rows projected exactly as READ shows them (rxProjection), so every content
+    // dialect works on log BY CONSTRUCTION and FIND(log)→READ(coordinate) composes like any scheme.
+    // ~semantic stays 501 until the pump embeds log rows (epic S5); @graph is 501 (log rows carry
+    // no symbol channels — an honest absence, not an exception).
+    async find(statement, ctx) {
+        const { db, runId, mimetypes } = ctx;
+        const empty = (status) => ({ status, content: null, mimetype: null, results: [], itemsTokenTotal: 0, pathnames: [], matches: [] });
+        if (statement.target === null)
+            return empty(400);
+        // log rows have no tag concept (engine-written events) — a tag filter matches nothing.
+        if (Array.isArray(statement.signal) && statement.signal.length > 0)
+            return empty(204);
+        if (statement.body !== null && (statement.body.dialect === "semantic" || statement.body.dialect === "graph"))
+            return empty(501);
+        const pathname = (statement.target.kind === "url" ? statement.target.pathname : statement.target.raw).replace(/^\//, "");
+        const glob = coordinateGlob(pathname);
+        if (glob === null)
+            return empty(400);
+        const rows = await db.log_find_candidates.all({ run_id: runId, glob });
+        const byCoord = new Map(rows.map((r) => [r.coordinate, r]));
+        const projected = rows.map((r) => ({ key: r.coordinate, ...rxProjection(r.rx) }));
+        let matches;
+        if (statement.body === null) {
+            matches = projected.map((c) => ({ pathname: c.key, span: null }));
+        }
+        else {
+            if (mimetypes === undefined)
+                return empty(501);
+            const r = await Matcher.matchCandidates(statement.body, projected, mimetypes);
+            if (r.status !== 200)
+                return empty(r.status);
+            matches = r.matches.map((m) => ({ pathname: m.key, span: m.span, ...(m.path !== undefined ? { path: m.path } : {}) }));
+        }
+        if (statement.lineMarker !== null) {
+            const page = paginate(matches, LineMarkerOps.firstLast(statement.lineMarker));
+            if (page.status !== 200)
+                return empty(page.status);
+            matches = page.items ?? [];
+        }
+        if (matches.length === 0)
+            return empty(204);
+        // The result rows mirror the catalog-row shape (§find-result-catalog-rows): one item per
+        // match, keyed by the row's self-documenting path, carrying {mimetype, tokens, lines} so
+        // the model budgets its READs — uniform with every scheme's FIND.
+        const results = [];
+        const seenPath = [];
+        const seen = new Set();
+        let itemsTokenTotal = 0;
+        for (const m of matches) {
+            const row = byCoord.get(m.pathname);
+            if (row === undefined)
+                continue;
+            const path = `log:///${m.pathname}`;
+            const proj = rxProjection(row.rx);
+            const item = {
+                path,
+                channels: { [path]: { mimetype: proj.mimetype, tokens: row.tokens, lines: proj.content.length === 0 ? 0 : proj.content.split("\n").length } },
+            };
+            results.push(m.span !== null ? { ...item, matchSpan: m.span, ...(m.path !== undefined ? { matchPath: m.path } : {}) } : item);
+            if (!seen.has(m.pathname)) {
+                seen.add(m.pathname);
+                seenPath.push(m.pathname);
+                itemsTokenTotal += row.tokens;
+            }
+        }
+        // matches[].pathname is the fan-out's retarget key — `/loop/turn/seq/OP` re-parses as a
+        // coordinate (the /OP suffix is accepted), so READ(log://)<matcher> fan-out delivers rows.
+        const fanMatches = matches.map((m) => ({ ...m, pathname: `/${m.pathname}` }));
+        return { status: 200, content: JSON.stringify(results), mimetype: "application/json", results, itemsTokenTotal, pathnames: seenPath.map((p) => `/${p}`), matches: fanMatches };
+    }
+    async open(statement, ctx) {
+        return this.#setExpanded(statement, ctx, 1);
+    }
+    // FOLD toggles the expanded bit only — an active subscription stays alive. §subscriptions-fold-keeps-subscription
+    async fold(statement, ctx) {
+        return this.#setExpanded(statement, ctx, 0);
+    }
+    // Resolve a log:/// target — a concrete coordinate, or a path-glob optionally paginated
+    // by <L> (OPEN/FOLD only) — to the matched row ids. The ONE resolution OPEN/FOLD and
+    // KILL share: fold flips `expanded` on the ids, kill deletes them.
+    async #resolveIds(pathname, lineMarker, ctx) {
+        const { db, runId } = ctx;
+        const coord = parseCoordinate(pathname);
+        if (coord !== null && lineMarker === null) {
+            const row = await db.log_id_by_coordinate.get({ run_id: runId, loop_seq: coord.loopSeq, turn_seq: coord.turnSeq, sequence: coord.sequence });
+            return row === undefined ? { status: 404, ids: [] } : { status: 200, ids: [row.id] };
+        }
+        // §log-coordinate-hierarchy — one resolution for every consumer (curation here, find below).
+        const glob = coordinateGlob(pathname);
+        if (glob === null)
+            return { status: 400, ids: [], error: `malformed log target '${pathname}' — a coordinate (1/2/3), a prefix (1 or 1/2), or a glob (**/READ)` };
+        const matched = await db.log_match_coordinates.all({ run_id: runId, glob });
+        // Zero matches on a well-formed glob is a NO-OP SUCCESS, not an error (owner ruling): a
+        // curation sweep that found nothing to curate steers nothing — 204 keeps it out of the
+        // errors surface (>= 400), and the rx carries matched: 0, clearly shown.
+        if (matched.length === 0)
+            return { status: 204, ids: [] };
+        let selected = matched;
+        if (lineMarker !== null) {
+            const page = paginate(matched, LineMarkerOps.firstLast(lineMarker));
+            if (page.status !== 200)
+                return { status: page.status, ids: [] };
+            selected = page.items ?? [];
+        }
+        if (selected.length === 0)
+            return { status: 404, ids: [] };
+        return { status: 200, ids: selected.map((s) => s.id) };
+    }
+    async #setExpanded(statement, ctx, expanded) {
+        if (statement.target === null)
+            return { status: 400 };
+        const pathname = (statement.target.kind === "url" ? statement.target.pathname : statement.target.raw).replace(/^\//, "");
+        const r = await this.#resolveIds(pathname, statement.lineMarker, ctx);
+        if (r.status === 204)
+            return { status: 204, matched: 0 };
+        if (r.status !== 200)
+            return { status: r.status, ...(r.error !== undefined ? { error: r.error } : {}) };
+        let ids = r.ids;
+        // §prompt-fold-illegal (#382, owner) — the user prompt is the task frame, not curatable
+        // memory: a FOLD that would HIDE it is refused (run43: a weak model folded its own task in
+        // a housekeeping turn and lost the plot). KILL still DELETES it deliberately — curation
+        // preserved, accident prevented. A glob sweep silently spares the prompt and folds the
+        // rest; an explicit fold whose whole target IS the prompt gets the steer.
+        if (expanded === 0) {
+            const promptIds = new Set();
+            for (const id of r.ids) {
+                const row = await ctx.db.log_row_target.get({ id });
+                if (row?.scheme === "plurnk" && (row.pathname ?? "").startsWith("/prompt/"))
+                    promptIds.add(id);
+            }
+            if (promptIds.size > 0) {
+                ids = r.ids.filter((id) => !promptIds.has(id));
+                if (ids.length === 0)
+                    return { status: 403, error: "Illegal attempt to FOLD a user prompt. Use KILL if you want it removed." };
+            }
+        }
+        for (const id of ids)
+            await ctx.db.log_set_expanded_by_id.run({ id, expanded });
+        return { status: 200, matched: ids.length };
+    }
+    // KILL erases log items (plurnk.md:36, :98) — the model's DB-storage curation lever and
+    // the only way to shed accumulated log rows in a long session (FOLD only collapses the
+    // render; the row persists). Same resolution as OPEN/FOLD, DELETE instead of flip. KILL
+    // carries no <L> result slot, so no pagination — a concrete coordinate or a path-glob.
+    async kill(pathname, _signal, ctx) {
+        const r = await this.#resolveIds(pathname.replace(/^\//, ""), null, ctx);
+        if (r.status !== 200)
+            return { status: r.status };
+        for (const id of r.ids)
+            await ctx.db.log_delete_by_id.run({ id });
+        return { status: 200 };
+    }
+}
+//# sourceMappingURL=Log.js.map

package/dist/schemes/Log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Log.js","sourceRoot":"","sources":["../../src/schemes/Log.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,OAAO,MAAM,uBAAuB,CAAC;AAK5C,4EAA4E;AAC5E,0EAA0E;AAC1E,gFAAgF;AAChF,kFAAkF;AAClF,qFAAqF;AACrF,kFAAkF;AAClF,uFAAuF;AACvF,MAAM,UAAU,GAAG,yCAAyC,CAAC;AAC7D,oGAAoG;AACpG,qGAAqG;AACrG,kGAAkG;AAClG,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AAEhD,8FAA8F;AAC9F,4FAA4F;AAC5F,gGAAgG;AAChG,4FAA4F;AAC5F,MAAM,YAAY,GAAG,CAAC,KAAa,EAAyC,EAAE;IAC1E,IAAI,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAA8C,CAAC;QAC1E,IAAI,OAAO,EAAE,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC;QAC3G,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;IACtD,CAAC;AACL,CAAC,CAAC;AAEF,+FAA+F;AAC/F,8FAA8F;AAC9F,sFAAsF;AACtF,MAAM,cAAc,GAAG,CAAC,QAAgB,EAAiB,EAAE;IACvD,IAAI,QAAQ,KAAK,EAAE;QAAG,OAAO,GAAG,CAAC;IACjC,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,QAAQ,GAAG,CAAC;IAClD,IAAI,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,GAAG,QAAQ,IAAI,CAAC;IAC9D,IAAI,eAAe,CAAC,QAAQ,CAAC,KAAK,IAAI,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IAClF,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,QAAgB,EAAiE,EAAE;IACxG,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO;QACH,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KAC7B,CAAC;AACN,CAAC,CAAC;AAEF,+EAA+E;AAC/E,qDAAqD;AACrD,MAAM,QAAQ,GAAG,CAAI,KAAU,EAAE,MAA8C,EAAmC,EAAE;IAChH,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;IAC3B,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IAC/B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAChB,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACnE,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,KAAK;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACnF,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAC3B,CAAC;IACD,MAAM,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAClC,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACrC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAC9E,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACzD,CAAC,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,GAAG;IACpB,MAAM,CAAC,QAAQ,GAAmB;QAC9B,IAAI,EAAE,KAAK;QACX,QAAQ,EAAE,EAAE,EAAG,kDAAkD;QACjE,cAAc,EAAE,EAAE;QAClB,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,SAAS;QAChB,yFAAyF;QACzF,4GAA4G;QAC5G,2FAA2F;QAC3F,yDAAyD;QACzD,UAAU,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC/B,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,IAAI;QAClB,OAAO,EAAE,4BAA4B;KACxC,CAAC;IAEF,KAAK,CAAC,IAAI,CAAC,SAAwB,EAAE,GAAwB;QACzD,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC;QAC1B,IAAI,SAAS,CAAC,MAAM,KAAK,IAAI;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACrF,+DAA+D;QAC/D,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC1D,CAAC;QAED,MAAM,QAAQ,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACzH,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAE1E,MAAM,GAAG,GAAG,MAAO,EAAE,CAAC,sBAAqC,CAAC,GAAG,CAO5D,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAElG,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAE7E,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,kBAAkB,EAAE,GAAG,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAE1F,OAAO,WAAW,CAAC,OAAO,CAAC;YACvB,OAAO,EAAE,iBAAiB;YAC1B,QAAQ,EAAE,kBAAkB;YAC5B,UAAU,EAAE,SAAS,CAAC,UAAU;YAChC,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,SAAS,EAAE,GAAG,CAAC,SAAS;SAC3B,CAAC,CAAC;IACP,CAAC;IAED,2FAA2F;IAC3F,+FAA+F;IAC/F,+FAA+F;IAC/F,gGAAgG;IAChG,8FAA8F;IAC9F,6DAA6D;IAC7D,KAAK,CAAC,IAAI,CAAC,SAAwB,EAAE,GAAwB;QACzD,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC;QACrC,MAAM,KAAK,GAAG,CAAC,MAAc,EAAc,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACvJ,IAAI,SAAS,CAAC,MAAM,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;QACjD,uFAAuF;QACvF,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;QACtF,IAAI,SAAS,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,KAAK,UAAU,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;QAEhI,MAAM,QAAQ,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACzH,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,MAAO,EAAE,CAAC,mBAAkC,CAAC,GAAG,CAAsF,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5K,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAU,CAAC,CAAC,CAAC;QACrE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAElF,IAAI,OAAgB,CAAC;QACrB,IAAI,SAAS,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC1B,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACtE,CAAC;aAAM,CAAC;YACJ,IAAI,SAAS,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;YAC/C,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;YAC9E,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG;gBAAE,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAC7C,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3H,CAAC;QACD,IAAI,SAAS,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;YAC9E,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG;gBAAE,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACnD,OAAO,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAC/B,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;QAE5C,yFAAyF;QACzF,yFAAyF;QACzF,kEAAkE;QAClE,MAAM,OAAO,GAAgB,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,IAAI,eAAe,GAAG,CAAC,CAAC;QACxB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACpC,IAAI,GAAG,KAAK,SAAS;gBAAE,SAAS;YAChC,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClC,MAAM,IAAI,GAAc;gBACpB,IAAI;gBACJ,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;aACnI,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC9H,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;gBAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;gBAAC,eAAe,IAAI,GAAG,CAAC,MAAM,CAAC;YAAC,CAAC;QAClH,CAAC;QACD,wFAAwF;QACxF,2FAA2F;QAC3F,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;QAC9E,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IACnL,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAwB,EAAE,GAAwB;QACzD,OAAO,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,kHAAkH;IAClH,KAAK,CAAC,IAAI,CAAC,SAAwB,EAAE,GAAwB;QACzD,OAAO,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,wFAAwF;IACxF,qFAAqF;IACrF,mEAAmE;IACnE,KAAK,CAAC,WAAW,CAAC,QAAgB,EAAE,UAAuC,EAAE,GAAwB;QACjG,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC;QAC1B,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,KAAK,KAAK,IAAI,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,MAAO,EAAE,CAAC,oBAAmC,CAAC,GAAG,CAAiB,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC7K,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QACzF,CAAC;QACD,6FAA6F;QAC7F,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,yBAAyB,QAAQ,oEAAoE,EAAE,CAAC;QACjK,MAAM,OAAO,GAAG,MAAO,EAAE,CAAC,qBAAoC,CAAC,GAAG,CAAiB,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5G,wFAAwF;QACxF,uFAAuF;QACvF,yEAAyE;QACzE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;QAC1D,IAAI,QAAQ,GAAG,OAAO,CAAC;QACvB,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;YACpE,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG;gBAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;YACjE,QAAQ,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAChC,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;QAC3D,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,SAAwC,EAAE,GAAwB,EAAE,QAAe;QAClG,IAAI,SAAS,CAAC,MAAM,KAAK,IAAI;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QACtD,MAAM,QAAQ,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACzH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACtE,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QACzD,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACxG,IAAI,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;QAChB,wFAAwF;QACxF,2FAA2F;QAC3F,wFAAwF;QACxF,uFAAuF;QACvF,0EAA0E;QAC1E,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;YACpC,KAAK,MAAM,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;gBACrB,MAAM,GAAG,GAAG,MAAO,GAAG,CAAC,EAAE,CAAC,cAA6B,CAAC,GAAG,CAAqD,EAAE,EAAE,EAAE,CAAC,CAAC;gBACxH,IAAI,GAAG,EAAE,MAAM,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;oBAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACnG,CAAC;YACD,IAAI,SAAS,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACrB,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC/C,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,yEAAyE,EAAE,CAAC;YACnI,CAAC;QACL,CAAC;QACD,KAAK,MAAM,EAAE,IAAI,GAAG;YAAE,MAAO,GAAG,CAAC,EAAE,CAAC,sBAAqC,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QAChG,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;IAChD,CAAC;IAED,wFAAwF;IACxF,uFAAuF;IACvF,wFAAwF;IACxF,uFAAuF;IACvF,KAAK,CAAC,IAAI,CAAC,QAAgB,EAAE,OAAsB,EAAE,GAAwB;QACzE,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;QACzE,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;QAClD,KAAK,MAAM,EAAE,IAAI,CAAC,CAAC,GAAG;YAAE,MAAO,GAAG,CAAC,EAAE,CAAC,gBAA+B,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAClF,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAC3B,CAAC;CACJ"}

package/dist/schemes/Log.sql

@@ -0,0 +1,59 @@
+-- log:/// scheme — read by (loop_sequence, turn_sequence, sequence)
+-- coordinate; open/fold toggle the `expanded` flag on the addressed row.
+
+-- PREP: log_read_by_coordinate
+SELECT le.op, le.scheme, le.pathname, le.status_rx, le.rx, le.mimetype_rx
+FROM log_entries le
+JOIN turns t ON t.id = le.turn_id
+JOIN loops l ON l.id = t.loop_id
+WHERE l.run_id = $run_id AND l.sequence = $loop_seq AND t.sequence = $turn_seq AND le.sequence = $sequence;
+
+-- PREP: log_id_by_coordinate
+-- Resolve a concrete log:/// coordinate to its row id within the run (shared by
+-- OPEN/FOLD's flip and KILL's erase — one resolution, two actions).
+SELECT le.id FROM log_entries le
+JOIN turns t ON t.id = le.turn_id
+JOIN loops l ON l.id = t.loop_id
+WHERE l.run_id = $run_id AND l.sequence = $loop_seq AND t.sequence = $turn_seq AND le.sequence = $sequence;
+
+-- PREP: log_match_coordinates
+-- Resolve a log:/// path-glob to the matching rows within the run, coordinate-ordered.
+-- The rendered `loop/turn/seq/op` is GLOB-matched against the target (SQLite GLOB:
+-- `*` spans any chars incl '/', so `**/READ` ≈ `*/READ`). Drives glob/paginated
+-- OPEN/FOLD — the model's primary log-curation move, e.g. FOLD(log:///**/READ)<1>.
+SELECT le.id
+FROM log_entries le
+JOIN turns t ON t.id = le.turn_id
+JOIN loops l ON l.id = t.loop_id
+WHERE l.run_id = $run_id
+  AND (l.sequence || '/' || t.sequence || '/' || le.sequence || '/' || le.op) GLOB $glob
+ORDER BY l.sequence, t.sequence, le.sequence;
+
+-- PREP: log_set_expanded_by_id
+UPDATE log_entries SET expanded = $expanded WHERE id = $id;
+
+-- PREP: log_delete_by_id
+-- KILL erases a log item (plurnk.md:36, :98) — the model's DB-storage curation lever,
+-- the only way to shed accumulated log rows in a long session (FOLD only collapses the
+-- render). A hard delete: the row is gone, freeing storage; the derived errors pointer
+-- for an `op='error'` row vanishes with it.
+DELETE FROM log_entries WHERE id = $id;
+
+-- PREP: log_find_candidates
+-- §find-source-agnostic ÷ §log-coordinate-hierarchy — the run's log rows as FIND candidates,
+-- coordinate-glob-scoped (the same GLOB semantics log_match_coordinates curates by), each with the
+-- fields Log's rx projection renders (FIND must match exactly what READ shows). Coordinate-ordered.
+SELECT
+    (l.sequence || '/' || t.sequence || '/' || le.sequence || '/' || le.op) AS coordinate,
+    le.op, le.rx, le.mimetype_rx, le.tokens
+FROM log_entries le
+JOIN turns t ON t.id = le.turn_id
+JOIN loops l ON l.id = t.loop_id
+WHERE l.run_id = $run_id
+  AND (l.sequence || '/' || t.sequence || '/' || le.sequence || '/' || le.op) GLOB $glob
+ORDER BY l.sequence, t.sequence, le.sequence;
+
+-- PREP: log_row_target
+-- #382 §prompt-fold-illegal — a log row's acted-on target (scheme+pathname), to spot the user
+-- prompt frame rows (scheme='plurnk', pathname '/prompt/%') a FOLD must never hide.
+SELECT scheme, pathname FROM log_entries WHERE id = $id;

package/dist/schemes/Plurnk.d.ts

@@ -0,0 +1,17 @@
+import type { SchemeManifest, PlurnkSchemeContext } from "../core/scheme-types.ts";
+import type { EditStatement, FindStatement, ReadStatement, SendStatement } from "@plurnk/plurnk-grammar";
+import type { EditResult, ReadResult } from "./_entry-ops.ts";
+import type { EntryData, ReadEntryResult, WriteEntryResult, DeleteEntryResult } from "./_entry-crud.ts";
+import type { SendResult } from "./_entry-send.ts";
+import type { FindResult } from "./_entry-find.ts";
+export default class Plurnk {
+    static manifest: SchemeManifest;
+    edit(statement: EditStatement, ctx: PlurnkSchemeContext): Promise<EditResult>;
+    read(statement: ReadStatement, ctx: PlurnkSchemeContext): Promise<ReadResult>;
+    readEntry(pathname: string, ctx: PlurnkSchemeContext): Promise<ReadEntryResult>;
+    writeEntry(pathname: string, entry: EntryData, ctx: PlurnkSchemeContext): Promise<WriteEntryResult>;
+    deleteEntry(pathname: string, ctx: PlurnkSchemeContext): Promise<DeleteEntryResult>;
+    send(statement: SendStatement, ctx: PlurnkSchemeContext): Promise<SendResult>;
+    find(statement: FindStatement, ctx: PlurnkSchemeContext): Promise<FindResult>;
+}
+//# sourceMappingURL=Plurnk.d.ts.map

package/dist/schemes/Plurnk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plurnk.d.ts","sourceRoot":"","sources":["../../src/schemes/Plurnk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAKzG,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACxG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQnD,MAAM,CAAC,OAAO,OAAO,MAAM;IACvB,MAAM,CAAC,QAAQ,EAAE,cAAc,CAW7B;IAEI,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAElF;IAEK,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAElF;IAEK,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CAEpF;IAEK,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAExG;IAEK,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAExF;IAEK,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAElF;IAEK,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAElF;CACJ"}

package/dist/schemes/Plurnk.js

@@ -0,0 +1,46 @@
+import EntryOps from "./_entry-ops.js";
+import EntryCrud from "./_entry-crud.js";
+import EntrySend from "./_entry-send.js";
+import EntryFind from "./_entry-find.js";
+// Engine-authored reference scheme — the prompt (`plurnk://prompt/<run>/<loop>/<N>`), the scheme
+// docs (`plurnk:///docs/*`), the catalog. All of it the engine writes FOR the model to READ;
+// none of it is the model's to write. writableBy excludes "model", so the manifest gate
+// (§scheme-surface-writableby-403) rejects every model-origin write uniformly — no path special-
+// case. The model's scratch surface is `known://`; editing plurnk:// reference used to "succeed"
+// and became a scratch-behavior sink for weak models (#310).
+export default class Plurnk {
+    static manifest = {
+        name: "plurnk",
+        channels: { body: "text/markdown" },
+        defaultChannel: "body",
+        category: "data",
+        scope: "session",
+        writableBy: ["client", "plurnk"],
+        volatile: false,
+        modelVisible: true,
+        example: "<<FIND(plurnk:///**)::FIND",
+        documentation: "Engine-authored reference surfaced to you — your active prompt at `plurnk://prompt/<run>/<loop>/<N>` (READ the address the User Prompts section lists), the scheme docs at `plurnk://docs/*`. READ-ONLY: READ these, never EDIT them (use `known://` for your own scratch).",
+    };
+    async edit(statement, ctx) {
+        return EntryOps.editSessionEntry(statement, ctx, Plurnk.manifest);
+    }
+    async read(statement, ctx) {
+        return EntryOps.readSessionEntry(statement, ctx, Plurnk.manifest);
+    }
+    async readEntry(pathname, ctx) {
+        return EntryCrud.readEntry(pathname, ctx, Plurnk.manifest.name);
+    }
+    async writeEntry(pathname, entry, ctx) {
+        return EntryCrud.writeEntry(pathname, entry, ctx, Plurnk.manifest.name);
+    }
+    async deleteEntry(pathname, ctx) {
+        return EntryCrud.deleteEntry(pathname, ctx, Plurnk.manifest.name);
+    }
+    async send(statement, ctx) {
+        return EntrySend.sendToSessionEntry(statement, ctx, Plurnk.manifest.name);
+    }
+    async find(statement, ctx) {
+        return EntryFind.findSessionEntries(statement, ctx, Plurnk.manifest);
+    }
+}
+//# sourceMappingURL=Plurnk.js.map

package/dist/schemes/Plurnk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plurnk.js","sourceRoot":"","sources":["../../src/schemes/Plurnk.ts"],"names":[],"mappings":"AAEA,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AACvC,OAAO,SAAS,MAAM,kBAAkB,CAAC;AACzC,OAAO,SAAS,MAAM,kBAAkB,CAAC;AACzC,OAAO,SAAS,MAAM,kBAAkB,CAAC;AAMzC,iGAAiG;AACjG,6FAA6F;AAC7F,wFAAwF;AACxF,iGAAiG;AACjG,iGAAiG;AACjG,6DAA6D;AAC7D,MAAM,CAAC,OAAO,OAAO,MAAM;IACvB,MAAM,CAAC,QAAQ,GAAmB;QAC9B,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE;QACnC,cAAc,EAAE,MAAM;QACtB,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,SAAS;QAChB,UAAU,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAChC,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,IAAI;QAClB,OAAO,EAAE,4BAA4B;QACrC,aAAa,EAAE,6QAA6Q;KAC/R,CAAC;IAEF,KAAK,CAAC,IAAI,CAAC,SAAwB,EAAE,GAAwB;QACzD,OAAO,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAwB,EAAE,GAAwB;QACzD,OAAO,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,QAAgB,EAAE,GAAwB;QACtD,OAAO,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,KAAgB,EAAE,GAAwB;QACzE,OAAO,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,QAAgB,EAAE,GAAwB;QACxD,OAAO,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAwB,EAAE,GAAwB;QACzD,OAAO,SAAS,CAAC,kBAAkB,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAwB,EAAE,GAAwB;QACzD,OAAO,SAAS,CAAC,kBAAkB,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzE,CAAC;CACJ"}

package/dist/schemes/Run.d.ts

@@ -0,0 +1,25 @@
+import type { SchemeManifest, PlurnkSchemeContext } from "../core/scheme-types.ts";
+import type { EditResult, ReadResult } from "./_entry-ops.ts";
+import type { FindResult } from "./_entry-find.ts";
+import type { EditStatement, ReadStatement, SendStatement, FindStatement, KillStatement } from "@plurnk/plurnk-grammar";
+export declare const markTerminal: (terminatedBy: string | null, message: string | null) => string | null;
+export default class Run {
+    #private;
+    static manifest: SchemeManifest;
+    edit(statement: EditStatement, ctx: PlurnkSchemeContext): Promise<EditResult | {
+        status: number;
+        error?: string;
+        body?: string;
+    }>;
+    deleteEntry(statement: KillStatement, ctx: PlurnkSchemeContext): Promise<{
+        status: number;
+        error?: string;
+    }>;
+    read(statement: ReadStatement, ctx: PlurnkSchemeContext): Promise<ReadResult>;
+    find(statement: FindStatement, ctx: PlurnkSchemeContext): Promise<FindResult>;
+    send(statement: SendStatement, ctx: PlurnkSchemeContext): Promise<{
+        status: number;
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=Run.d.ts.map

package/dist/schemes/Run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Run.d.ts","sourceRoot":"","sources":["../../src/schemes/Run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAa,MAAM,yBAAyB,CAAC;AAI9F,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAc,MAAM,wBAAwB,CAAC;AAOpI,eAAO,MAAM,YAAY,iBAAkB,MAAM,GAAG,IAAI,WAAW,MAAM,GAAG,IAAI,KAAG,MAAM,GAAG,IAI3F,CAAC;AAWF,MAAM,CAAC,OAAO,OAAO,GAAG;;IACpB,MAAM,CAAC,QAAQ,EAAE,cAAc,CAU7B;IAgCI,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAetI;IAKK,WAAW,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAQjH;IAEK,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAsBlF;IAQK,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAUlF;IAEK,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAoB1G;CACJ"}

package/dist/schemes/Run.js

@@ -0,0 +1,172 @@
+import { DEFAULT_LOOP_FLAGS } from "../core/scheme-types.js";
+import EntryOps from "./_entry-ops.js";
+import EntryFind from "./_entry-find.js";
+import { foldAuthorityIntoPath } from "../core/plurnk-uri.js";
+// #379 (owner ruling) — a loop the ENGINE concluded (∅-collapse) or the CLIENT killed (cancel)
+// must not present its last words as a deliverable: run42's workers parked on nothing, the
+// collapse concluded them, and the parent COLLECTed 'Standing by for user input' as a status-200
+// stage result — nine blind re-spawns. The marker names the act as STATE; the model's words
+// follow unrewritten. NULL terminated_by = the model's own terminal — the message IS the result.
+export const markTerminal = (terminatedBy, message) => {
+    if (terminatedBy === "collapse")
+        return `[ concluded on ∅-collapse — waited on nothing; no result was produced ]${message === null ? "" : ` ${message}`}`;
+    if (terminatedBy === "cancel")
+        return `[ cancelled from outside the run ]${message === null ? "" : ` ${message}`}`;
+    return message;
+};
+// run:// — the run scheme: inter-run CONTROL (irc=SEND; WORK=spawn, FORK=fork is Dispatcher.#handleRunControl)
+// AND run-scoped STORAGE (§run-scheme). The run is always the AUTHORITY: run://<name>/<path> is
+// entry <path> owned by run <name>; `run://self` is the current run, empty authority is invalid.
+// Run is excluded from #extractTarget's authority-fold (Engine) so the authority stays the run
+// name, never folded.
+//   - path present → storage: READ any run's entry by address (cross-run read ok); EDIT self
+//     only (cross-run write → 403 — a run reads a sister's notes, never writes them).
+//   - path absent  → control on the run-as-actor: WORK spawns / FORK forks (Engine), SEND ircs, READ
+//     collects the deliverable; EDIT on the bare entity is rejected (the entity is not an entry).
+export default class Run {
+    static manifest = {
+        name: "run",
+        channels: { body: "text/markdown" },
+        defaultChannel: "body",
+        category: "data",
+        scope: "run",
+        writableBy: ["model", "client"],
+        volatile: false,
+        modelVisible: true,
+        example: "<<EDIT(run://self/todo.md):- [ ] investigate the timeout:EDIT",
+    };
+    // The run name from a run:// target's authority (hostname). "self" = the current run;
+    // "" (empty authority) is invalid; null when the target isn't a run:// url.
+    static #authority(target) {
+        if (target === null || target.kind !== "url" || target.scheme !== "run")
+            return null;
+        return target.hostname ?? "";
+    }
+    // The entry path within the run — the target's pathname; "" / "/" mean no entry (the
+    // run-as-actor / control form).
+    static #entryPath(target) {
+        if (target === null || target.kind !== "url")
+            return "";
+        const p = target.pathname ?? "";
+        return p === "/" ? "" : p;
+    }
+    // The acting run's own name — for self-resolution and the cross-run-write gate.
+    static async #selfName(ctx) {
+        const row = await ctx.db.run_name_by_id.get({ run_id: ctx.runId });
+        if (row === undefined)
+            throw new Error("run: acting run has no name");
+        return row.name;
+    }
+    // Clone a statement with its target's authority (hostname) set to the resolved owner, so
+    // the shared entry helper folds it into the storage path (/<owner>/<entry>).
+    static #withOwner(statement, owner) {
+        const t = statement.target;
+        if (t === null || t.kind !== "url")
+            return statement;
+        return { ...statement, target: { ...t, hostname: owner } };
+    }
+    async edit(statement, ctx) {
+        const authority = Run.#authority(statement.target);
+        if (authority === null)
+            return { status: 400, error: "run:// requires a run target" };
+        const entryPath = Run.#entryPath(statement.target);
+        // The run ENTITY (path-absent run://<name>) is not EDITable — EDIT is file/entry only
+        // (grammar 0.74.55): WORK(run://<name>) spawns a worker; FORK(run://<name>) forks a named branch.
+        if (entryPath === "")
+            return { status: 400, error: "run:// entity is not editable — WORK(run://<name>) to spawn a worker, FORK(run://<name>) to fork a branch" };
+        // Storage: write a run-scope entry. Self only — cross-run write is denied (§run-scheme).
+        if (authority === "")
+            return { status: 400, error: "run:// requires a run name or 'self' (run://self/<path>)" };
+        const self = await Run.#selfName(ctx);
+        const owner = authority === "self" ? self : authority;
+        if (owner !== self)
+            return { status: 403, error: "run:// write is self-only — read a sister's notes, never write them" };
+        return EntryOps.editSessionEntry(Run.#withOwner(statement, owner), ctx, Run.manifest);
+    }
+    // KILL a run-scope scratch ENTRY (path present). Self-only — deleting a sister's notes
+    // is a cross-run write, denied like EDIT (§run-scheme). The path-ABSENT KILL form is run
+    // cancellation, handled in Dispatcher.#handleKill (it routes only entry-path KILLs here).
+    async deleteEntry(statement, ctx) {
+        const authority = Run.#authority(statement.target);
+        if (authority === null)
+            return { status: 400, error: "run:// requires a run target" };
+        if (authority === "")
+            return { status: 400, error: "run:// requires a run name or 'self' (run://self/<path>)" };
+        const self = await Run.#selfName(ctx);
+        const owner = authority === "self" ? self : authority;
+        if (owner !== self)
+            return { status: 403, error: "run:// kill is self-only — read a sister's notes, never delete them" };
+        return EntryOps.deleteSessionEntry(Run.#withOwner(statement, owner), ctx, Run.manifest);
+    }
+    async read(statement, ctx) {
+        const authority = Run.#authority(statement.target);
+        if (authority === null)
+            return { status: 400, content: null, mimetype: null, channel: null };
+        if (authority === "")
+            return { status: 400, content: null, mimetype: null, channel: null }; // empty-authority run:/// is invalid
+        const entryPath = Run.#entryPath(statement.target);
+        // Path-absent READ(run://<name>) COLLECTS the run's deliverable (§run-scheme-collect, pull side):
+        // its latest loop's terminal message — the SEND[200] result, or an abandonment reason. A worker
+        // still running hasn't delivered yet → 425 steers the model to park until it does (the
+        // same deliverable the wake/collect-delta will push). The pull complements the push; neither is lost.
+        if (entryPath === "") {
+            const owner = authority === "self" ? await Run.#selfName(ctx) : authority;
+            const row = await ctx.db.run_deliverable_by_name.get({ session_id: ctx.sessionId, name: owner });
+            if (row === undefined)
+                return { status: 404, content: `run://${owner} not found in this session`, mimetype: "text/markdown", channel: null };
+            // §join-blocking-collect (#354) — a still-running worker is a BLOCKING JOIN: the READ
+            // arms the join (awaitRun), and the turn's bare SEND[102] parks until the worker delivers.
+            // The model doesn't drive the park — the engine does (a blocking read() hiding the scheduler).
+            if (!Run.#TERMINAL_LOOP.has(row.status))
+                return { status: 425, content: `[ worker '${owner}' is still running — parking this turn until it delivers its result ]`, mimetype: "text/markdown", channel: null, awaitRun: owner };
+            return { status: 200, content: markTerminal(row.terminated_by, row.terminal_message) ?? `[ worker '${owner}' concluded with no deliverable (status ${row.status}) ]`, mimetype: "text/markdown", channel: null };
+        }
+        // Path-present: cross-run scratch READ — resolve self, fold the owner into the storage path.
+        const owner = authority === "self" ? await Run.#selfName(ctx) : authority;
+        return EntryOps.readSessionEntry(Run.#withOwner(statement, owner), ctx, Run.manifest);
+    }
+    // Terminal loop statuses (§lifecycle-terms) — a loop here has DELIVERED; anything else is still running.
+    static #TERMINAL_LOOP = new Set([200, 413, 429, 499, 500, 504, 508]);
+    // §run-scheme — FIND a run's scratch. `run://self/**` is self; `run://<name>/**` a sister
+    // (cross-run READ is allowed, so cross-run FIND is too). Resolve the owner and fold it into
+    // the scope pathname (`/<owner>/<rest>`) so EntryFind draws from that run's partition alone.
+    async find(statement, ctx) {
+        const authority = Run.#authority(statement.target);
+        if (authority === null)
+            return { status: 400, content: null, mimetype: null, results: [], itemsTokenTotal: 0, pathnames: [], matches: [] };
+        if (authority === "")
+            return { status: 400, content: null, mimetype: null, results: [], itemsTokenTotal: 0, pathnames: [], matches: [] };
+        const owner = authority === "self" ? await Run.#selfName(ctx) : authority;
+        const t = statement.target;
+        const folded = t !== null && t.kind === "url"
+            ? { ...statement, target: { ...t, hostname: null, pathname: foldAuthorityIntoPath(owner, t.pathname) } }
+            : statement;
+        return EntryFind.findSessionEntries(folded, ctx, Run.manifest);
+    }
+    async send(statement, ctx) {
+        const authority = Run.#authority(statement.target);
+        if (authority === null)
+            return { status: 400, error: "run:// irc requires a run (run://<name>)" };
+        if (authority === "")
+            return { status: 400, error: "run:// irc requires a run name or 'self' (run://<name>)" };
+        if (ctx.injectRun === undefined)
+            throw new Error("run.send: injectRun capability absent");
+        let runId = ctx.runId;
+        if (authority !== "self") {
+            const row = await ctx.db.run_resolve_by_name.get({ session_id: ctx.sessionId, name: authority });
+            if (row === undefined)
+                return { status: 404, error: `run://${authority} not found in this session` };
+            runId = row.id;
+        }
+        const body = statement.body;
+        const prompt = body === null ? "" : typeof body === "string" ? body : body.raw;
+        // §run-delegation-inherits-flags — an irc that RESUMES a parked loop keeps that loop's
+        // own flags (inject ignores these there); a fresh loop raised by the message acts on
+        // the sender's behalf and carries the sender's authority.
+        const row = await ctx.db.engine_get_loop_flags.get({ loop_id: ctx.loopId });
+        const flags = row === undefined ? undefined : { ...DEFAULT_LOOP_FLAGS, ...JSON.parse(row.flags) };
+        await ctx.injectRun({ sessionId: ctx.sessionId, runId, prompt, flags });
+        return { status: 200 };
+    }
+}
+//# sourceMappingURL=Run.js.map