@plurnk/plurnk-service 1.0.0

package/dist/schemes/_entry-semantic.d.ts

@@ -0,0 +1,38 @@
+import type { Db } from "../core/Db.ts";
+import type { Mimetypes } from "@plurnk/plurnk-mimetypes";
+export default class EntrySemantic {
+    #private;
+    static indexFts(db: Db, entryId: number, content: string): Promise<void>;
+    static cosine(a: Uint8Array, b: Uint8Array): number;
+    static indexEmbedding(db: Db, entryId: number, chunks: {
+        lineStart: number;
+        lineEnd: number;
+        vector: Uint8Array;
+    }[], model: string | undefined): Promise<void>;
+    static deriveEmbeddings(mimetypes: Mimetypes, content: string, symbols: readonly {
+        line?: number;
+        endLine?: number;
+    }[], fallbackEmbedding: Uint8Array | undefined, fallbackModel: string | undefined, signal?: AbortSignal, maxChunks?: number): Promise<{
+        chunks: {
+            lineStart: number;
+            lineEnd: number;
+            vector: Uint8Array;
+        }[];
+        model: string | undefined;
+        capped: boolean;
+    }>;
+    static deepConfigSignature(mimetypes: Mimetypes): Promise<string>;
+    static ftsQueryFor(text: string): string;
+    static rankSemantic(db: Db, sessionId: number, scheme: string | null, mimetypes: Mimetypes, queryText: string, marker: {
+        first: number;
+        last: number | null;
+    }): Promise<{
+        status: number;
+        results: Array<{
+            pathname: string;
+            lineStart: number;
+            lineEnd: number;
+        }>;
+    }>;
+}
+//# sourceMappingURL=_entry-semantic.d.ts.map

package/dist/schemes/_entry-semantic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_entry-semantic.d.ts","sourceRoot":"","sources":["../../src/schemes/_entry-semantic.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,EAAE,EAAc,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAO1D,MAAM,CAAC,OAAO,OAAO,aAAa;;IAG9B,OAAa,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG7E;IAMD,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,MAAM,CAOlD;IAKD,OAAa,cAAc,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,UAAU,CAAA;KAAE,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAWnK;IAOD,OAAa,gBAAgB,CACzB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,SAAS;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,EACvD,iBAAiB,EAAE,UAAU,GAAG,SAAS,EACzC,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,MAAM,CAAC,EAAE,WAAW,EACpB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC;QAAE,MAAM,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,UAAU,CAAA;SAAE,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CA6C/H;IAmCD,OAAa,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAItE;IAID,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIvC;IAMD,OAAa,YAAY,CAAC,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,KAAK,CAAC;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAyC1Q;CACJ"}

package/dist/schemes/_entry-semantic.js

@@ -0,0 +1,202 @@
+// ~semantic (plurnk-service#186) — the FTS half. Re-indexes an entry's body
+// content into entry_fts (the keyword/narrowing half of the fusion). The cosine
+// rank over embedding vectors — the precise half — lands when the embedding
+// channel does (a daughter projection, per the §mimetype boundary). Called from the
+// gated manifest-add hook, so only when body content actually changed.
+import EntryChunk from "./_entry-chunk.js";
+export default class EntrySemantic {
+    // Replace an entry's FTS row with its current body content (rowid = entryId).
+    // Empty content (binary member / cleared entry) → no FTS row (delete only).
+    static async indexFts(db, entryId, content) {
+        await db.fts_delete.run({ entry_id: entryId });
+        if (content.length > 0)
+            await db.fts_insert.run({ entry_id: entryId, content });
+    }
+    // Cosine similarity over two Float32 vectors stored as BLOBs — the SqlRite
+    // `cosine()` function delegates here (cosine.ts is the registration adapter).
+    // Alignment-proof: the BLOB Uint8Array may be an unaligned view, so copy the
+    // exact bytes to a fresh buffer before the Float32 view. A zero vector → 0.
+    static cosine(a, b) {
+        const x = new Float32Array(a.buffer.slice(a.byteOffset, a.byteOffset + a.byteLength));
+        const y = new Float32Array(b.buffer.slice(b.byteOffset, b.byteOffset + b.byteLength));
+        let dot = 0, nx = 0, ny = 0;
+        for (let i = 0; i < x.length; i++) {
+            dot += x[i] * y[i];
+            nx += x[i] * x[i];
+            ny += y[i] * y[i];
+        }
+        const denom = Math.sqrt(nx) * Math.sqrt(ny);
+        return denom === 0 ? 0 : dot / denom;
+    }
+    // Store an entry's embedding vector + the model that produced it, or clear the
+    // row (binary/empty entry, or a degraded `embeddingMissing` projection). Called
+    // from the gated manifest-add hook beside indexFts / the symbol index.
+    static async indexEmbedding(db, entryId, chunks, model) {
+        // Re-derivation = clear all of the entry's chunk rows, then insert each in seq
+        // order. No model (no embedder installed) or no chunks → just cleared.
+        await db.embedding_delete.run({ entry_id: entryId });
+        if (model === undefined)
+            return;
+        for (const [seq, c] of chunks.entries()) {
+            await db.embedding_set.run({
+                entry_id: entryId, chunk_seq: seq, line_start: c.lineStart, line_end: c.lineEnd,
+                vector: c.vector, embedding_model: model,
+            });
+        }
+    }
+    // Project Semantics — derive an entry's chunk embeddings. Probes the embedder
+    // capability (the daughter's window + tokenizer, surfaced via the Mimetypes
+    // handle): ABSENT → one whole-entry chunk from the fallback vector (today's
+    // behavior, no extra embed call); PRESENT → lossless tile, embed each chunk.
+    // Returns the chunk list + model for indexEmbedding; never touches the DB.
+    static async deriveEmbeddings(mimetypes, content, symbols, fallbackEmbedding, fallbackModel, signal, maxChunks) {
+        const info = await EntrySemantic.#embedderInfo(mimetypes);
+        if (info === null) {
+            const totalLines = content.length === 0 ? 0 : content.split("\n").length;
+            if (fallbackEmbedding === undefined || fallbackEmbedding.byteLength === 0 || totalLines === 0)
+                return { chunks: [], model: undefined, capped: false };
+            return { chunks: [{ lineStart: 1, lineEnd: totalLines, vector: fallbackEmbedding }], model: fallbackModel, capped: false };
+        }
+        // §semantic-entry-chunk-cap — a LATENCY stage, never a coverage bound: the INLINE
+        // (dispatch-time) path caps chunks so a cold ~query answers in bounded seconds, and a
+        // capped pass does NOT stamp the deep hash — the background pump completes the entry to
+        // FULL depth (a 300-page book is entirely searchable at steady state; rank can't be
+        // dominated regardless — semantic_rank takes one best chunk per entry). The old flat cap
+        // silently foreclosed legitimate large texts: head-only vectors under a whole-file FTS
+        // narrow returned head-biased spans forever, and the stamped hash made it permanent.
+        const CHUNK_CAP = maxChunks ?? Number.POSITIVE_INFINITY;
+        // Symbol edges (a @graph endLine, or the line before a symbol starts) are the
+        // tiler's preferred cut points; it still tiles every line if there are none.
+        const boundaries = new Set();
+        for (const s of symbols) {
+            if (typeof s.endLine === "number")
+                boundaries.add(s.endLine);
+            if (typeof s.line === "number" && s.line > 1)
+                boundaries.add(s.line - 1);
+        }
+        // mimetypes#50 — a REMOTE embedder is present with an incomplete self-report: the window
+        // is the operator's to declare (their knob), and the counter resolves through the seam's
+        // tokenizers by the embedder's model name — the chars/2 upper bound when inexact is the
+        // surfaced conservative fallback (smaller chunks are correct chunks).
+        if (info.maxTokens === null)
+            throw new Error("remote embedder reports no token window — set PLURNK_MIMETYPES_EMBED_MAX_TOKENS to the endpoint's limit");
+        const counter = info.countTokens ?? (await mimetypes.tokenizer(info.model ?? "")).countTokens;
+        const budget = EntrySemantic.#chunkBudget(info.maxTokens);
+        let specs = await EntryChunk.tile(content, boundaries, budget, EntrySemantic.#chunkOverlap(), counter);
+        if (specs.length === 0)
+            return { chunks: [], model: undefined, capped: false };
+        const capped = specs.length > CHUNK_CAP;
+        if (capped)
+            specs = specs.slice(0, CHUNK_CAP); // §semantic-entry-chunk-cap — inline latency stage; the pump completes
+        // One data-parallel batch over the tiled chunk texts (#272 — embedBatch via the
+        // framework seam, ~6× the per-chunk loop on a multi-core box; vectors bit-identical,
+        // so no re-embed). Each tile embeds as PLAIN TEXT: a chunk is a fragment, not a
+        // standalone document, so embedding under the entry's mimetype (e.g. application/json)
+        // re-validates the partial and throws — embedBatch embeds raw text directly.
+        const vectors = await mimetypes.embedBatch(specs.map((s) => s.text), { signal });
+        const chunks = [];
+        for (const [i, spec] of specs.entries()) {
+            const vector = vectors[i];
+            if (vector !== undefined && vector.byteLength > 0)
+                chunks.push({ lineStart: spec.lineStart, lineEnd: spec.lineEnd, vector });
+        }
+        return { chunks, model: chunks.length > 0 ? info.model : undefined, capped };
+    }
+    // Chunk budget in tokens — `.env.defaults` is the law, no code fallback. EMPTY =
+    // the embedder's reported window (scalable — NO model-specific number baked in);
+    // a positive value caps BELOW the window (e.g. to sweep granularity).
+    static #chunkBudget(maxTokens) {
+        const raw = process.env.PLURNK_SERVICE_SEMANTIC_CHUNK_TOKENS;
+        if (raw === undefined || raw.trim() === "")
+            return maxTokens;
+        const v = Number(raw);
+        if (!Number.isInteger(v) || v < 1)
+            throw new Error(`PLURNK_SERVICE_SEMANTIC_CHUNK_TOKENS must be empty (= the embedder's window) or a positive integer, got ${JSON.stringify(raw)}`);
+        return Math.min(v, maxTokens);
+    }
+    static #chunkOverlap() {
+        const v = Number(process.env.PLURNK_SERVICE_SEMANTIC_CHUNK_OVERLAP);
+        if (!(v >= 0 && v < 1))
+            throw new Error(`PLURNK_SERVICE_SEMANTIC_CHUNK_OVERLAP must be in [0,1), got ${JSON.stringify(process.env.PLURNK_SERVICE_SEMANTIC_CHUNK_OVERLAP)}`);
+        return v;
+    }
+    // The embedder capability surface (daughter window + tokenizer + model id), probed
+    // through the Mimetypes handle. null until an embedder is installed.
+    static async #embedderInfo(mimetypes) {
+        // PLURNK_SERVICE_EMBED_DISABLE=1 forces the no-embedder path even when the optional embeddings package
+        // IS installed — the whole semantic stack (deriveEmbeddings, the ~query FTS→cosine fusion, the
+        // deep_hash config) funnels through here, so one gate makes everything FTS-only. The fast lane
+        // (mock-provider tests) sets it so the suite doesn't spin up the MiniLM worker pool for nothing.
+        if (process.env.PLURNK_SERVICE_EMBED_DISABLE === "1")
+            return null;
+        return await mimetypes.embedderInfo();
+    }
+    // Folded into the entry's deep_hash so a derivation re-runs when the EMBEDDING
+    // inputs change, not just content: installing/swapping the embedder (the window
+    // flips none→N, activating tiling), the embedder's model id changing at the SAME
+    // window (#31 — else stale vectors from the old model's space survive the swap and
+    // get cosine-compared against the new model's), or sweeping the chunk knobs.
+    static async deepConfigSignature(mimetypes) {
+        const info = await EntrySemantic.#embedderInfo(mimetypes);
+        if (info === null)
+            return "embed:none";
+        return `embed:${info.model ?? "?"}:${info.maxTokens}:${info.maxTokens === null ? "?" : EntrySemantic.#chunkBudget(info.maxTokens)}:${EntrySemantic.#chunkOverlap()}`;
+    }
+    // Build the FTS5 narrow from a ~query: OR the alphanumeric terms (a broad cut —
+    // cosine does the precision). FTS5-syntax-safe (bare lowercased terms).
+    static ftsQueryFor(text) {
+        const terms = text.toLowerCase().match(/[a-z0-9]+/g);
+        if (terms === null)
+            return "";
+        return [...new Set(terms)].join(" OR ");
+    }
+    // The ~query dispatch: embed the query text through the SAME channel, FTS-narrow by
+    // its terms, cosine-rank the narrowed set, top-K. Each result carries its best-matching
+    // chunk's line span (the Finding extent). No embedder → the top-K <K> form degrades to an
+    // FTS-only keyword rank (whole-entry findings); the <0.x> threshold form stays 501.
+    static async rankSemantic(db, sessionId, scheme, mimetypes, queryText, marker) {
+        const ftsQuery = EntrySemantic.ftsQueryFor(queryText);
+        if (ftsQuery.length === 0)
+            return { status: 200, results: [] };
+        // #209 — the result marker form-dispatches: integer <K> → top-K rank;
+        // decimal <0.x> → a similarity threshold (minimum cosine in (0,1)), with
+        // <0.x,N> capping the threshold set at N (else unbounded). A fractional
+        // value outside (0,1) is a nonsense result-marker → 416, never coerced.
+        const { first, last } = marker;
+        const toResult = (x) => ({ pathname: x.pathname, lineStart: x.line_start, lineEnd: x.line_end });
+        // The query embedding honors the SAME gate as the corpus (#embedderInfo /
+        // PLURNK_SERVICE_EMBED_DISABLE): with the embeddings package installed but disabled,
+        // calling process() directly would compute a query vector and rank it against
+        // an empty entry_embeddings — every ~query silently []. Disabled → the honest
+        // FTS keyword fallback, same as no embedder at all.
+        const info = await EntrySemantic.#embedderInfo(mimetypes);
+        const r = info === null
+            ? { embedding: undefined, embeddingModel: undefined }
+            : await mimetypes.process({ content: queryText, hint: "text/markdown" }, { channels: ["embedding"] });
+        if (r.embedding === undefined || r.embedding.byteLength === 0 || r.embeddingModel === undefined) {
+            // FTS fallback: no embedder, so there is no query vector to cosine with. Top-K ranks
+            // by BM25 keyword relevance alone; the <0.x> threshold form is intrinsically cosine-
+            // based (no bounded BM25 analogue) → it stays 501.
+            if (!Number.isInteger(first))
+                return { status: 501, results: [] };
+            const rows = await db.semantic_rank_fts.all({
+                fts_query: ftsQuery, session_id: sessionId, scheme, k: first,
+            });
+            return { status: 200, results: rows.map(toResult) };
+        }
+        if (Number.isInteger(first)) {
+            const rows = await db.semantic_rank.all({
+                fts_query: ftsQuery, session_id: sessionId, scheme, query_vector: r.embedding, embedding_model: r.embeddingModel, k: first,
+            });
+            return { status: 200, results: rows.map(toResult) };
+        }
+        if (first <= 0 || first >= 1)
+            return { status: 416, results: [] };
+        const cap = (last !== null && Number.isInteger(last) && last > 0) ? last : -1;
+        const rows = await db.semantic_rank_threshold.all({
+            fts_query: ftsQuery, session_id: sessionId, scheme, query_vector: r.embedding, embedding_model: r.embeddingModel, threshold: first, cap,
+        });
+        return { status: 200, results: rows.map(toResult) };
+    }
+}
+//# sourceMappingURL=_entry-semantic.js.map

package/dist/schemes/_entry-semantic.js.map

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

package/dist/schemes/_entry-semantic.sql

@@ -0,0 +1,95 @@
+-- ~semantic (plurnk-service#186) — the FTS half of the dialect (FTS narrow →
+-- cosine rank). Populated at the gated manifest-add hook; the FTS5 rowid IS the
+-- entry id, so a re-index is delete-by-rowid then insert.
+
+-- PREP: fts_delete
+DELETE FROM entry_fts WHERE rowid = $entry_id;
+
+-- PREP: fts_insert
+INSERT INTO entry_fts (rowid, content) VALUES ($entry_id, $content);
+
+-- PREP: embedding_set
+-- Insert ONE chunk's vector + its <L> extent + the model. The caller clears the
+-- entry's rows (embedding_delete) first and inserts each chunk in seq order, so no
+-- upsert is needed — a re-derivation is delete-all then insert-each.
+INSERT INTO entry_embeddings (entry_id, chunk_seq, line_start, line_end, vector, embedding_model)
+VALUES ($entry_id, $chunk_seq, $line_start, $line_end, $vector, $embedding_model);
+
+-- PREP: embedding_delete
+-- Clears ALL of an entry's chunk rows (the re-derivation reset).
+DELETE FROM entry_embeddings WHERE entry_id = $entry_id;
+
+-- PREP: semantic_rank
+-- The ~semantic fusion: FTS narrows by keyword ($fts_query), then cosine ranks the
+-- narrowed candidates over the query embedding ($query_vector), top-K. Scheme-scoped
+-- like every dialect. FTS does the scale-cut; cosine the precise rank — so a high-
+-- cosine entry that doesn't match the keyword is correctly excluded by the narrow.
+-- Many chunk rows per entry → rank by the entry's BEST chunk (per-entry top cosine via
+-- ROW_NUMBER), and surface that winning chunk's line span as the finding extent
+-- (Project Findings). embedding_model filter keeps cosine within one model's dimensions.
+WITH ranked AS (
+    SELECT e.pathname, em.line_start, em.line_end,
+           cosine(em.vector, $query_vector) AS score,
+           ROW_NUMBER() OVER (PARTITION BY e.id ORDER BY cosine(em.vector, $query_vector) DESC) AS rn
+    FROM entry_fts f
+    JOIN entries e ON e.id = f.rowid
+    JOIN entry_embeddings em ON em.entry_id = e.id AND em.embedding_model = $embedding_model
+    WHERE f.content MATCH $fts_query
+      AND e.session_id = $session_id
+      AND e.scheme IS $scheme
+)
+SELECT pathname, line_start, line_end FROM ranked
+WHERE rn = 1
+ORDER BY score DESC
+LIMIT $k;
+
+-- PREP: semantic_rank_threshold
+-- #209 — the <0.x> similarity-threshold form: same FTS+cosine fusion, but a cosine
+-- floor ($threshold, in (0,1)) replaces top-K, and $cap (-1 = unbounded) is the
+-- optional <0.x,N> result cap.
+WITH ranked AS (
+    SELECT e.pathname, em.line_start, em.line_end,
+           cosine(em.vector, $query_vector) AS score,
+           ROW_NUMBER() OVER (PARTITION BY e.id ORDER BY cosine(em.vector, $query_vector) DESC) AS rn
+    FROM entry_fts f
+    JOIN entries e ON e.id = f.rowid
+    JOIN entry_embeddings em ON em.entry_id = e.id AND em.embedding_model = $embedding_model
+    WHERE f.content MATCH $fts_query
+      AND e.session_id = $session_id
+      AND e.scheme IS $scheme
+)
+SELECT pathname, line_start, line_end FROM ranked
+WHERE rn = 1 AND score >= $threshold
+ORDER BY score DESC
+LIMIT $cap;
+
+-- PREP: semantic_rank_fts
+-- FTS-only fallback when no embedder is installed: rank entry_fts by BM25 keyword
+-- relevance alone (no entry_embeddings join, no cosine), scheme-scoped, top-K. Without
+-- chunk vectors there is no winning span, so the finding is the whole entry — line
+-- 1..its line count, derived from the indexed FTS content.
+SELECT e.pathname,
+       1 AS line_start,
+       length(f.content) - length(replace(f.content, char(10), '')) + 1 AS line_end
+FROM entry_fts f
+JOIN entries e ON e.id = f.rowid
+WHERE f.content MATCH $fts_query
+  AND e.session_id = $session_id
+  AND e.scheme IS $scheme
+ORDER BY rank
+LIMIT $k;
+
+-- PREP: semantic_fts_candidates
+-- §semantic-cold-query-full-fidelity — the FTS-narrowed candidate slice, BM25-ordered,
+-- with the derivation inputs (content/mimetype/deep_hash) so the caller can derive any
+-- stale candidate INLINE before ranking. Ranking only ever scores this narrowed set, so
+-- embedding exactly this slice on demand gives bit-identical results to a warm corpus.
+SELECT e.id AS entry_id, e.pathname, ec.content, ec.mimetype, e.deep_hash, 'body' AS channel
+FROM entry_fts f
+JOIN entries e ON e.id = f.rowid
+JOIN entry_channels ec ON ec.entry_id = e.id AND ec.name = 'body'
+WHERE f.content MATCH $fts_query
+  AND e.session_id = $session_id
+  AND e.scheme IS $scheme
+ORDER BY bm25(entry_fts)
+LIMIT $cap;

package/dist/schemes/_entry-send.d.ts

@@ -0,0 +1,11 @@
+import type { SendStatement } from "@plurnk/plurnk-grammar";
+import type { PlurnkSchemeContext } from "../core/scheme-types.ts";
+export interface SendResult {
+    status: number;
+    [key: string]: unknown;
+}
+export default class EntrySend {
+    #private;
+    static sendToSessionEntry(statement: SendStatement, ctx: PlurnkSchemeContext, scheme: string): Promise<SendResult>;
+}
+//# sourceMappingURL=_entry-send.d.ts.map

package/dist/schemes/_entry-send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_entry-send.d.ts","sourceRoot":"","sources":["../../src/schemes/_entry-send.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAG5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAInE,MAAM,WAAW,UAAU;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,CAAC,OAAO,OAAO,SAAS;;IAc1B,OAAa,kBAAkB,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAuCvH;CACJ"}

package/dist/schemes/_entry-send.js

@@ -0,0 +1,66 @@
+// Shared SEND dispatcher for entry-bearing schemes. Schemes interpret
+// status codes per SPEC §send-dispatch. v0 handles 410 (Gone, delete the resource)
+// and 499 (Client Closed Request, cancel active subscription).
+import { decodePathParens } from "../core/path-decode.js";
+import EntryCrud from "./_entry-crud.js";
+import ChannelWrite from "../core/ChannelWrite.js";
+export default class EntrySend {
+    static #pathnameOf(statement) {
+        const path = statement.target;
+        if (path === null)
+            return null;
+        if (path.kind === "regex")
+            return path.raw; // regex source — parens are syntax, never encoded
+        return decodePathParens(path.kind === "url" ? path.pathname : path.raw); // #239 item 4
+    }
+    static #fragmentOf(statement) {
+        const path = statement.target;
+        if (path === null || path.kind !== "url")
+            return null;
+        return path.fragment;
+    }
+    static async sendToSessionEntry(statement, ctx, scheme) {
+        if (statement.target === null)
+            return { status: 400, error: "directed SEND requires a path" };
+        const status = statement.signal;
+        if (status === null)
+            return { status: 400, error: "SEND requires a numeric status code" };
+        // SEND[410] Gone — delete the targeted resource (SPEC §send-dispatch). With a
+        // #fragment, deletes just that channel; without, deletes the whole entry.
+        if (status === 410) {
+            const pathname = EntrySend.#pathnameOf(statement);
+            if (pathname === null)
+                return { status: 400 };
+            const fragment = EntrySend.#fragmentOf(statement);
+            if (fragment !== null) {
+                const { db, sessionId } = ctx;
+                const entry = await db.crud_find_session_entry.get({ session_id: sessionId, scheme, pathname });
+                if (entry === undefined)
+                    return { status: 404 };
+                const deleted = await db.crud_delete_channel.get({ entry_id: entry.id, name: fragment });
+                return { status: deleted === undefined ? 404 : 200 };
+            }
+            const result = await EntryCrud.deleteEntry(pathname, ctx, scheme);
+            return { status: result.status };
+        }
+        // SEND[499] Client Closed Request — cancel active subscription (SPEC §send-dispatch, §stream-control).
+        // Entry-bearing schemes never have subscriptions in v0; always return 404.
+        // Streaming schemes (sse / exec / etc.) override this and look up via
+        // findActiveSubscription, then call their teardown using the stored handle.
+        if (status === 499) {
+            const pathname = EntrySend.#pathnameOf(statement);
+            if (pathname === null)
+                return { status: 400 };
+            const { db, sessionId, runId } = ctx;
+            const entry = await db.crud_find_session_entry.get({ session_id: sessionId, scheme, pathname });
+            if (entry === undefined)
+                return { status: 404, error: "no entry at path" };
+            const subscription = await ChannelWrite.findActiveSubscription(db, { runId, entryId: entry.id });
+            if (subscription === null)
+                return { status: 404, error: "no active subscription to cancel" };
+            return { status: 501, error: `entry scheme does not own subscription cancellation; subscription owned by scheme '${subscription.scheme}'` };
+        }
+        return { status: 501, error: `entry scheme does not interpret SEND status ${status}` }; // §send-dispatch-entry-schemes-501-on-non-410
+    }
+}
+//# sourceMappingURL=_entry-send.js.map

package/dist/schemes/_entry-send.js.map

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

package/dist/schemes/cosine.d.ts

@@ -0,0 +1,4 @@
+export declare const deterministic = true;
+export default _default;
+declare function _default(a: Uint8Array, b: Uint8Array): number;
+//# sourceMappingURL=cosine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cosine.d.ts","sourceRoot":"","sources":["../../src/schemes/cosine.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,aAAa,OAAO,CAAC;;0BAClB,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,MAAM"}

package/dist/schemes/cosine.js

@@ -0,0 +1,9 @@
+// SqlRite function module (#186, ~semantic). The sqlrite contract requires a
+// default-export handler and turns the filename into the SQL function name — so
+// this is a thin registration adapter; the logic lives in EntrySemantic.cosine
+// (OO). `deterministic` marks it a pure function so SQLite may optimize it. One
+// of the few intentionally non-class modules (sqlrite's function convention).
+import EntrySemantic from "./_entry-semantic.js";
+export const deterministic = true;
+export default (a, b) => EntrySemantic.cosine(a, b);
+//# sourceMappingURL=cosine.js.map

package/dist/schemes/cosine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cosine.js","sourceRoot":"","sources":["../../src/schemes/cosine.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,gFAAgF;AAChF,+EAA+E;AAC/E,gFAAgF;AAChF,8EAA8E;AAC9E,OAAO,aAAa,MAAM,sBAAsB,CAAC;AAEjD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC;AAClC,eAAe,CAAC,CAAa,EAAE,CAAa,EAAU,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}

package/dist/schemes/exec-abort.d.ts

@@ -0,0 +1,15 @@
+export default class ExecAbort {
+    static get graceMs(): number;
+    static teardownReason(): {
+        housekeeping: true;
+        graceMs: number;
+    };
+    static killReason(signal: number | null): {
+        signal: number | null;
+    };
+    static timeoutReason(): {
+        housekeeping: true;
+        graceMs: number;
+    };
+}
+//# sourceMappingURL=exec-abort.d.ts.map

package/dist/schemes/exec-abort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-abort.d.ts","sourceRoot":"","sources":["../../src/schemes/exec-abort.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,OAAO,OAAO,SAAS;IAI1B,MAAM,KAAK,OAAO,IAAI,MAAM,CAE3B;IAGD,MAAM,CAAC,cAAc,IAAI;QAAE,YAAY,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAE/D;IAID,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG;QAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAElE;IAKD,MAAM,CAAC,aAAa,IAAI;QAAE,YAAY,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAE9D;CACJ"}

package/dist/schemes/exec-abort.js

@@ -0,0 +1,29 @@
+// The abort-reason protocol @plurnk/plurnk-execs' SubprocessExecutor reads off `signal.reason`:
+//   { signal }                       → deliver exactly that Unix signal, once, no escalation.
+//   { housekeeping: true, graceMs }  → loop/run teardown: the polite signal, then SIGKILL after graceMs.
+// A { signal: null } reason (a bare KILL) carries no override, so the executor applies its own
+// polite default, SIGHUP — the gentlest rung; the model escalates with explicit codes.
+export default class ExecAbort {
+    // The grace a teardown straggler gets before the hard SIGKILL. The executor refuses to bake a
+    // number (it'd be a magic literal there); the consumer owns it — env-tunable, 2s default. A
+    // getter, not a static field, so a test can set the env at runtime. §run-lifecycle-total-reap
+    static get graceMs() {
+        return Number(process.env.PLURNK_SERVICE_EXEC_KILL_GRACE_MS ?? "2000");
+    }
+    // Loop/run teardown — a BOUNDED reap, so Exec.idle() can't wedge on a signal-ignoring spawn.
+    static teardownReason() {
+        return { housekeeping: true, graceMs: ExecAbort.graceMs };
+    }
+    // The model's KILL[code] → exactly that signal, once (the model owns escalation: KILL[15] SIGTERM,
+    // KILL[9] SIGKILL). A bare KILL (null) carries no override — the executor's SIGHUP polite default.
+    static killReason(signal) {
+        return { signal };
+    }
+    // grammar 0.74.20 EXEC `<T>` timeout — the spawn outlived its T-second budget. A BOUNDED reap
+    // (polite signal then SIGKILL after graceMs), same protocol as teardown so a signal-ignoring
+    // spawn still dies; the caller stamps the distinct 504 close status (a timeout, not a plain kill).
+    static timeoutReason() {
+        return { housekeeping: true, graceMs: ExecAbort.graceMs };
+    }
+}
+//# sourceMappingURL=exec-abort.js.map

package/dist/schemes/exec-abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-abort.js","sourceRoot":"","sources":["../../src/schemes/exec-abort.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,8FAA8F;AAC9F,yGAAyG;AACzG,+FAA+F;AAC/F,uFAAuF;AACvF,MAAM,CAAC,OAAO,OAAO,SAAS;IAC1B,8FAA8F;IAC9F,4FAA4F;IAC5F,8FAA8F;IAC9F,MAAM,KAAK,OAAO;QACd,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,iCAAiC,IAAI,MAAM,CAAC,CAAC;IAC3E,CAAC;IAED,6FAA6F;IAC7F,MAAM,CAAC,cAAc;QACjB,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC;IAC9D,CAAC;IAED,mGAAmG;IACnG,mGAAmG;IACnG,MAAM,CAAC,UAAU,CAAC,MAAqB;QACnC,OAAO,EAAE,MAAM,EAAE,CAAC;IACtB,CAAC;IAED,8FAA8F;IAC9F,6FAA6F;IAC7F,mGAAmG;IACnG,MAAM,CAAC,aAAa;QAChB,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC;IAC9D,CAAC;CACJ"}

package/dist/schemes/exec-env.d.ts

@@ -0,0 +1,5 @@
+export default class ExecEnv {
+    #private;
+    static scoped(env?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+}
+//# sourceMappingURL=exec-env.d.ts.map

package/dist/schemes/exec-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-env.d.ts","sourceRoot":"","sources":["../../src/schemes/exec-env.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,OAAO,OAAO,OAAO;;IAYxB,MAAM,CAAC,MAAM,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAAC,UAAU,CAOrE;CACJ"}

package/dist/schemes/exec-env.js

@@ -0,0 +1,34 @@
+// SPEC §exec {§exec-env-scoped} — the environment an EXEC subprocess receives.
+//
+// It gets the *project's* environment (its `.env`, the standard shell vars like PATH
+// and HOME) so the model's commands run as the project expects — but never plurnk's
+// own secrets: the `PLURNK_*` config (all of plurnk's knobs are prefixed; see
+// .env.defaults) and the provider API keys plurnk-providers reads. The provider key-vars
+// are sourced from STANDARD_PROVIDERS so the denylist tracks the provider set rather
+// than a hand-maintained list that drifts as providers are added.
+//
+// A denylist, not an allowlist: a subprocess needs the long tail of inherited vars
+// (PATH, HOME, LANG, the project's own keys); only plurnk's two owned families are
+// stripped. The service owns this policy; the executor (plurnk-execs SubprocessExecutor,
+// plurnk-execs#8) spawns with the env it is handed.
+import { STANDARD_PROVIDERS } from "@plurnk/plurnk-providers";
+export default class ExecEnv {
+    // apiKeyVar is optional (providers 0.9.0): an anonymous provider like `plurnk`
+    // has none. It loses no secret here — plurnk's PLURNK_API_KEY cred is
+    // already stripped by the PLURNK_ prefix rule below — so drop the empties.
+    static #providerKeys = new Set(Object.values(STANDARD_PROVIDERS)
+        .map((spec) => spec.apiKeyVar)
+        .filter((v) => v !== undefined));
+    // Read at call time (not memoized) so a secret set into process.env after boot is
+    // still scoped out of the next spawn.
+    static scoped(env = process.env) {
+        const out = {};
+        for (const [key, value] of Object.entries(env)) {
+            if (key.startsWith("PLURNK_") || ExecEnv.#providerKeys.has(key))
+                continue; // plurnk's own — never to a subprocess
+            out[key] = value;
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=exec-env.js.map

package/dist/schemes/exec-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-env.js","sourceRoot":"","sources":["../../src/schemes/exec-env.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,qFAAqF;AACrF,oFAAoF;AACpF,8EAA8E;AAC9E,yFAAyF;AACzF,qFAAqF;AACrF,kEAAkE;AAClE,EAAE;AACF,mFAAmF;AACnF,mFAAmF;AACnF,yFAAyF;AACzF,oDAAoD;AAEpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,CAAC,OAAO,OAAO,OAAO;IACxB,+EAA+E;IAC/E,sEAAsE;IACtE,2EAA2E;IAC3E,MAAM,CAAC,aAAa,GAAwB,IAAI,GAAG,CAC/C,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC;SAC5B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC;SAC7B,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CACnD,CAAC;IAEF,kFAAkF;IAClF,sCAAsC;IACtC,MAAM,CAAC,MAAM,CAAC,GAAG,GAAsB,OAAO,CAAC,GAAG;QAC9C,MAAM,GAAG,GAAsB,EAAE,CAAC;QAClC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7C,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS,CAAE,uCAAuC;YACnH,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACrB,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC;CACJ"}