@plurnk/plurnk-service 0.7.0 → 0.9.0

package/dist/content/matcher.js

@@ -0,0 +1,112 @@
+// Body-matcher filtering. plurnk-service owns the filtering: the mimetypes
+// daughter PROJECTS every entry (process() → deepJson + deepXml, for ANY source
+// type); we FILTER here by running the matcher's dialect against the right
+// channel:
+//
+//   glob / regex  → the raw default content (line filter; daughter primitives)
+//   jsonpath      → deepJson  (daughter's queryJsonpathObject)
+//   xpath         → deepXml   (our own xpath engine — the daughter exports no
+//                              xpath primitive; we own the xml dependency)
+//
+// Cross-dialect (xpath over a JSON doc, jsonpath over an XML doc) works because
+// process() yields BOTH projections for any type. Matches render as the
+// model-facing `<source-line>:\t<value>` form, the same as a READ slice.
+//
+// Status: 200 = matches; 204 = matcher applied, zero results; 400 = malformed
+// matcher expression; 203 = source unparseable for its mimetype → raw bytes as
+// text so the model can fall back to regex/visual parsing (SPEC §16.1).
+import { queryGlob, queryRegex, queryJsonpathObject } from "@plurnk/plurnk-mimetypes";
+import { DOMParser } from "@xmldom/xmldom";
+import { select } from "xpath";
+import MimetypeBinary from "./mimetype-binary.js";
+export default class Matcher {
+    // Render matches as the model-facing line-numbered form `<source-line>:\t<value>`,
+    // one match per line — the same N:\t convention READ emits. Value is bare for a
+    // single-line string, JSON-encoded otherwise so the one-match-per-line invariant
+    // holds and `<L>` can still page the result set.
+    static #renderValue(v) {
+        return typeof v === "string" && !v.includes("\n") ? v : JSON.stringify(v);
+    }
+    static #renderMatches(matches) {
+        return matches.map((m) => `${m.line}:\t${Matcher.#renderValue(m.matched)}`).join("\n");
+    }
+    // Apply an `<L>`-slice baseLine offset to per-match line numbers — match lines
+    // are relative to the content received; when matching inside a slice they shift
+    // back to original-source coordinates.
+    static #shiftLines(matches, baseLine) {
+        if (baseLine === 1)
+            return [...matches];
+        const offset = baseLine - 1;
+        return matches.map((m) => ({ ...m, line: m.line + offset }));
+    }
+    static async matchAgainstContent(body, content, mimetype, mimetypes, baseLine = 1) {
+        if (body.dialect === "rag") {
+            // Semantic similarity (grammar 0.21.0: `~query`, top-K via <L>). A
+            // service-side feature needing its own embedding/vector design — the
+            // resolution mechanism is ours, not the grammar's to prescribe. Parked.
+            return { status: 501, error: "rag matcher not yet implemented (semantic similarity — parked, needs its own embedding/vector design)" };
+        }
+        let matches;
+        if (body.dialect === "glob") {
+            matches = queryGlob(content, body.raw);
+        }
+        else if (body.dialect === "regex") {
+            matches = queryRegex(content, body.pattern, body.flags);
+        }
+        else {
+            // Structural dialects query a projected channel, not the raw text.
+            let deepJson;
+            let deepXml;
+            try {
+                ({ deepJson, deepXml } = await mimetypes.process({ content, hint: mimetype }));
+            }
+            catch (err) {
+                // The SOURCE couldn't be parsed for its mimetype → 203 soft fallback:
+                // hand back the raw bytes as text so the model can regex/visual-parse.
+                return {
+                    status: 203,
+                    body: content,
+                    mimetype: MimetypeBinary.TEXT_PRIMITIVE_MIMETYPE,
+                    reason: err instanceof Error ? err.message : String(err),
+                };
+            }
+            try {
+                matches = body.dialect === "jsonpath"
+                    ? queryJsonpathObject(deepJson, body.raw)
+                    : Matcher.#queryXpath(deepXml, body.raw);
+            }
+            catch (err) {
+                // A throw from the QUERY is a malformed matcher expression the grammar
+                // didn't catch (model-facing → 400, not a system 500).
+                return { status: 400, error: err instanceof Error ? err.message : String(err) };
+            }
+        }
+        if (matches.length === 0)
+            return { status: 204, matches: 0 };
+        const adjusted = Matcher.#shiftLines(matches, baseLine);
+        return { status: 200, body: Matcher.#renderMatches(adjusted), matches: adjusted.length };
+    }
+    // XPath over the daughter's deepXml projection — our own engine. An element
+    // node renders as its XML serialization, a text/attribute node its value. Line
+    // comes from the matched node's `line` attr (its parent's, for `text()`),
+    // defaulting to 1 where the projection carries no source lines (JSON's deepXml).
+    // The projection's inline `line`/`endLine` bookkeeping currently pollutes
+    // element serialization (and is invalid XML on a content-attr collision) — the
+    // daughter's to fix (plurnk-mimetypes#12), not ours to strip.
+    static #queryXpath(deepXml, expression) {
+        const doc = new DOMParser().parseFromString(deepXml, "text/xml");
+        const selected = select(expression, doc);
+        const nodes = Array.isArray(selected) ? selected : [selected];
+        return nodes.map((node) => {
+            const el = node;
+            const line = el.getAttribute?.("line") ?? el.parentNode?.getAttribute?.("line");
+            const matched = el.nodeType === 1 ? String(node) : el.nodeValue ?? String(node);
+            return {
+                line: line !== undefined && line !== null ? Number(line) : 1,
+                matched,
+                matching: expression,
+            };
+        });
+    }
+}
+//# sourceMappingURL=matcher.js.map

package/dist/content/matcher.js.map

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

package/dist/content/mimetype-binary.d.ts

@@ -0,0 +1,9 @@
+export default class MimetypeBinary {
+    #private;
+    static TEXT_PRIMITIVE_MIMETYPE: string;
+    static isBinaryMimetype(mimetype: string): boolean;
+    static isJsonMimetype(mimetype: string): boolean;
+    static isLineNavigableMimetype(mimetype: string): boolean;
+    static normalizeAutoTextMimetype(mimetype: string | null | undefined): string;
+}
+//# sourceMappingURL=mimetype-binary.d.ts.map

package/dist/content/mimetype-binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mimetype-binary.d.ts","sourceRoot":"","sources":["../../src/content/mimetype-binary.ts"],"names":[],"mappings":"AAeA,MAAM,CAAC,OAAO,OAAO,cAAc;;IA8B/B,MAAM,CAAC,uBAAuB,SAAmB;IAEjD,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAclD,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIhD,MAAM,CAAC,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAWzD,MAAM,CAAC,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM;CAMhF"}

package/dist/content/mimetype-binary.js

@@ -0,0 +1,86 @@
+// Mimetype classifiers used at op-handler boundaries.
+//
+// `isBinaryMimetype` — enforces 415 on binary entries for READ/EDIT/
+// SHOW/HIDE (SPEC.md §16.9 — binary entries → 415).
+//
+// `isLineNavigableMimetype` — decides whether the render layer prefixes
+// each line with `N:\t` on READ output. Line-oriented mimetypes (text,
+// markdown, source code, line-aligned configs) get `N:\t`. Tree-oriented
+// mimetypes (JSON, XML, HTML) don't — line numbers would conflict with
+// the structural navigation those formats use (jsonpath, xpath).
+//
+// Local heuristic until @plurnk/plurnk-mimetypes exposes per-mimetype
+// metadata via its public API (HandlerInfo flags exist at registry
+// level; not queryable per-mimetype yet — see plurnk-mimetypes#3).
+export default class MimetypeBinary {
+    static #TEXT_APPLICATION_MIMETYPES = new Set([
+        "application/json",
+        "application/yaml",
+        "application/toml",
+        "application/xml",
+        "application/javascript",
+        "application/typescript",
+        "application/sql",
+    ]);
+    // Mimetypes that are structurally tree-navigated rather than line-
+    // navigated. READ output of these doesn't get `N:\t` prefixes.
+    static #TREE_NAVIGABLE_MIMETYPES = new Set([
+        "application/json",
+        "application/xml",
+        "text/html",
+    ]);
+    // Text primitive for the agent contract: text/markdown is the default
+    // text mimetype anywhere plurnk-service auto-derives a text result.
+    // text/plain is reserved for explicit scheme-manifest declarations
+    // (exec subprocess streams) and client-set entries. Rationale: markdown
+    // is a strict superset of plain text — any plain text is valid markdown
+    // — so the agent gets markdown-aware processing capability for free,
+    // and never needs to decide "is this markdown enough to mark as
+    // markdown?"
+    //
+    // Use this at any consumer-side auto-derivation point (file scheme
+    // extension fallback, log rx wrap, etc.) to normalize text/plain → text/markdown.
+    static TEXT_PRIMITIVE_MIMETYPE = "text/markdown";
+    static isBinaryMimetype(mimetype) {
+        if (mimetype.length === 0)
+            return false;
+        const slash = mimetype.indexOf("/");
+        if (slash === -1)
+            return true;
+        const type = mimetype.slice(0, slash);
+        if (type === "text")
+            return false;
+        if (MimetypeBinary.#TEXT_APPLICATION_MIMETYPES.has(mimetype))
+            return false;
+        if (mimetype.endsWith("+json") || mimetype.endsWith("+xml") || mimetype.endsWith("+yaml"))
+            return false;
+        return true;
+    }
+    // JSON-family check — used by `<L>` dispatch to pick structural slicer
+    // (sliceJsonItems) over line slicer (sliceLines) for JSON sources.
+    // Matches application/json plus +json suffix variants per RFC 6839.
+    static isJsonMimetype(mimetype) {
+        return mimetype === "application/json" || mimetype.endsWith("+json");
+    }
+    static isLineNavigableMimetype(mimetype) {
+        if (mimetype.length === 0)
+            return false;
+        if (MimetypeBinary.isBinaryMimetype(mimetype))
+            return false;
+        if (MimetypeBinary.#TREE_NAVIGABLE_MIMETYPES.has(mimetype))
+            return false;
+        if (mimetype.endsWith("+json") || mimetype.endsWith("+xml"))
+            return false;
+        // Everything text-ish that isn't tree-shaped is line-navigable.
+        // text/plain, text/markdown, text/csv, text/javascript, text/typescript,
+        // application/yaml, application/toml, application/javascript, etc.
+        return true;
+    }
+    static normalizeAutoTextMimetype(mimetype) {
+        if (mimetype === null || mimetype === undefined || mimetype === "" || mimetype === "text/plain") {
+            return MimetypeBinary.TEXT_PRIMITIVE_MIMETYPE;
+        }
+        return mimetype;
+    }
+}
+//# sourceMappingURL=mimetype-binary.js.map

package/dist/content/mimetype-binary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mimetype-binary.js","sourceRoot":"","sources":["../../src/content/mimetype-binary.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,EAAE;AACF,qEAAqE;AACrE,oDAAoD;AACpD,EAAE;AACF,wEAAwE;AACxE,uEAAuE;AACvE,yEAAyE;AACzE,uEAAuE;AACvE,iEAAiE;AACjE,EAAE;AACF,sEAAsE;AACtE,mEAAmE;AACnE,mEAAmE;AAEnE,MAAM,CAAC,OAAO,OAAO,cAAc;IAC/B,MAAM,CAAC,2BAA2B,GAAwB,IAAI,GAAG,CAAC;QAC9D,kBAAkB;QAClB,kBAAkB;QAClB,kBAAkB;QAClB,iBAAiB;QACjB,wBAAwB;QACxB,wBAAwB;QACxB,iBAAiB;KACpB,CAAC,CAAC;IAEH,mEAAmE;IACnE,+DAA+D;IAC/D,MAAM,CAAC,yBAAyB,GAAwB,IAAI,GAAG,CAAC;QAC5D,kBAAkB;QAClB,iBAAiB;QACjB,WAAW;KACd,CAAC,CAAC;IAEH,sEAAsE;IACtE,oEAAoE;IACpE,mEAAmE;IACnE,wEAAwE;IACxE,wEAAwE;IACxE,qEAAqE;IACrE,gEAAgE;IAChE,aAAa;IACb,EAAE;IACF,mEAAmE;IACnE,kFAAkF;IAClF,MAAM,CAAC,uBAAuB,GAAG,eAAe,CAAC;IAEjD,MAAM,CAAC,gBAAgB,CAAC,QAAgB;QACpC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACtC,IAAI,IAAI,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC;QAClC,IAAI,cAAc,CAAC,2BAA2B,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QAC3E,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QACxG,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,uEAAuE;IACvE,mEAAmE;IACnE,oEAAoE;IACpE,MAAM,CAAC,cAAc,CAAC,QAAgB;QAClC,OAAO,QAAQ,KAAK,kBAAkB,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,CAAC,uBAAuB,CAAC,QAAgB;QAC3C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACxC,IAAI,cAAc,CAAC,gBAAgB,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QAC5D,IAAI,cAAc,CAAC,yBAAyB,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QACzE,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;QAC1E,gEAAgE;QAChE,yEAAyE;QACzE,mEAAmE;QACnE,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,yBAAyB,CAAC,QAAmC;QAChE,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC9F,OAAO,cAAc,CAAC,uBAAuB,CAAC;QAClD,CAAC;QACD,OAAO,QAAQ,CAAC;IACpB,CAAC"}

package/dist/content/path-mimetype.d.ts

@@ -0,0 +1,6 @@
+import type { Mimetypes } from "@plurnk/plurnk-mimetypes";
+export default class PathMimetype {
+    #private;
+    static resolveEntryMimetype(pathname: string, schemeDefault: string, mimetypes: Mimetypes | undefined): Promise<string>;
+}
+//# sourceMappingURL=path-mimetype.d.ts.map

package/dist/content/path-mimetype.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-mimetype.d.ts","sourceRoot":"","sources":["../../src/content/path-mimetype.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAG1D,MAAM,CAAC,OAAO,OAAO,YAAY;;WAiBhB,oBAAoB,CAC7B,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,SAAS,GAAG,SAAS,GACjC,OAAO,CAAC,MAAM,CAAC;CAQrB"}

package/dist/content/path-mimetype.js

@@ -0,0 +1,49 @@
+// Path-extension mimetype resolver for entry schemes per plurnk-grammar
+// 0.14.0 §Paths: "Path suffix (`.json`, `.md`, `.txt`, etc.) declares
+// mimetype; absent suffix defers to scheme default."
+//
+// Plurnk-service implements this uniformly across entry schemes: a
+// pathname's extension drives the effective mimetype (via the sibling
+// Mimetypes detect service), and the scheme manifest's channel default
+// is the fallback when no extension is present.
+//
+// This makes structural ops (`<L>` item-index, matcher dialect dispatch)
+// fire correctly without content-sniffing: a model writing JSON to
+// `known://users.json` opts into JSON treatment via the `.json` suffix,
+// while `known://notes` (no suffix) stays at Known's default of
+// `text/markdown`.
+//
+// Consistent across:
+//   - known://users.json     → application/json
+//   - known://notes.md       → text/markdown
+//   - known://config.yaml    → application/yaml
+//   - known://users          → scheme default (text/markdown for Known)
+import MimetypeBinary from "./mimetype-binary.js";
+export default class PathMimetype {
+    // Extract the suffix (everything after the last dot in the last segment)
+    // from a pathname. Empty if no dot in the last segment.
+    static #extractExtension(pathname) {
+        const lastSlash = pathname.lastIndexOf("/");
+        const lastSegment = lastSlash === -1 ? pathname : pathname.slice(lastSlash + 1);
+        const lastDot = lastSegment.lastIndexOf(".");
+        if (lastDot <= 0)
+            return ""; // leading-dot files (".env") aren't an extension
+        return lastSegment.slice(lastDot); // includes the leading "."
+    }
+    // Resolve a pathname → effective mimetype.
+    // 1. If the pathname has an extension, query Mimetypes.detect({ ext })
+    //    and use what comes back (normalized via the text-primitive rule —
+    //    text/plain → text/markdown).
+    // 2. Otherwise (no extension or no Mimetypes service), fall back to
+    //    `schemeDefault` (typically the scheme manifest's channel default).
+    static async resolveEntryMimetype(pathname, schemeDefault, mimetypes) {
+        const ext = PathMimetype.#extractExtension(pathname);
+        if (ext.length > 0 && mimetypes !== undefined) {
+            const detected = await mimetypes.detect({ ext });
+            if (detected !== null)
+                return MimetypeBinary.normalizeAutoTextMimetype(detected);
+        }
+        return schemeDefault;
+    }
+}
+//# sourceMappingURL=path-mimetype.js.map

package/dist/content/path-mimetype.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-mimetype.js","sourceRoot":"","sources":["../../src/content/path-mimetype.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,sEAAsE;AACtE,qDAAqD;AACrD,EAAE;AACF,mEAAmE;AACnE,sEAAsE;AACtE,uEAAuE;AACvE,gDAAgD;AAChD,EAAE;AACF,yEAAyE;AACzE,mEAAmE;AACnE,wEAAwE;AACxE,gEAAgE;AAChE,mBAAmB;AACnB,EAAE;AACF,qBAAqB;AACrB,gDAAgD;AAChD,6CAA6C;AAC7C,gDAAgD;AAChD,wEAAwE;AAGxE,OAAO,cAAc,MAAM,sBAAsB,CAAC;AAElD,MAAM,CAAC,OAAO,OAAO,YAAY;IAC7B,yEAAyE;IACzE,wDAAwD;IACxD,MAAM,CAAC,iBAAiB,CAAC,QAAgB;QACrC,MAAM,SAAS,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QAChF,MAAM,OAAO,GAAG,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,OAAO,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC,CAAE,iDAAiD;QAC/E,OAAO,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAE,2BAA2B;IACnE,CAAC;IAED,2CAA2C;IAC3C,uEAAuE;IACvE,uEAAuE;IACvE,kCAAkC;IAClC,oEAAoE;IACpE,wEAAwE;IACxE,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAC7B,QAAgB,EAChB,aAAqB,EACrB,SAAgC;QAEhC,MAAM,GAAG,GAAG,YAAY,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5C,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;YACjD,IAAI,QAAQ,KAAK,IAAI;gBAAE,OAAO,cAAc,CAAC,yBAAyB,CAAC,QAAQ,CAAC,CAAC;QACrF,CAAC;QACD,OAAO,aAAa,CAAC;IACzB,CAAC;CACJ"}

package/dist/content/read-resolve.d.ts

@@ -0,0 +1,20 @@
+import type { LineMarker, MatcherBody } from "@plurnk/plurnk-grammar";
+import type { Mimetypes } from "@plurnk/plurnk-mimetypes";
+export interface ReadSliceResult {
+    status: number;
+    content: string | null;
+    mimetype: string;
+    startLine?: number | null;
+    matches?: number;
+    reason?: string;
+}
+export default class ReadResolve {
+    static resolve(opts: {
+        content: string;
+        mimetype: string;
+        lineMarker: LineMarker | null;
+        body: MatcherBody | null;
+        mimetypes: Mimetypes | undefined;
+    }): Promise<ReadSliceResult>;
+}
+//# sourceMappingURL=read-resolve.d.ts.map

package/dist/content/read-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-resolve.d.ts","sourceRoot":"","sources":["../../src/content/read-resolve.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAK1D,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,CAAC,OAAO,OAAO,WAAW;WACf,OAAO,CAAC,IAAI,EAAE;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;QAC9B,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;QACzB,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;KACpC,GAAG,OAAO,CAAC,eAAe,CAAC;CA2C/B"}

package/dist/content/read-resolve.js

@@ -0,0 +1,60 @@
+// Shared READ slice→match resolution for entry-bearing schemes (Known/Skill/
+// Unknown/Exec/Plurnk via `_entry-ops`), plus `Log` and `File`. `<L>` scopes,
+// the body matches within the scope: slice-then-match (plurnk.md slot order
+// `<L>?:body?`). `<L>` dispatches on source mimetype — JSON → item index
+// (sliceJsonItems), line-navigable → line index (sliceLines). Callers bind their
+// own (content, mimetype) and wrap the result (e.g. `_entry-ops` adds `channel`).
+import LineMarkerOps from "./line-marker.js";
+import Matcher from "./matcher.js";
+import MimetypeBinary from "./mimetype-binary.js";
+export default class ReadResolve {
+    static async resolve(opts) {
+        const { content, mimetype, lineMarker, body, mimetypes } = opts;
+        let workingContent = content;
+        let workingStart = 1;
+        let workingMimetypeForSlice = MimetypeBinary.TEXT_PRIMITIVE_MIMETYPE;
+        if (lineMarker !== null) {
+            if (MimetypeBinary.isJsonMimetype(mimetype)) {
+                const sliced = LineMarkerOps.sliceJsonItems(content, lineMarker);
+                if (sliced.status !== 200)
+                    return { status: sliced.status, content: null, mimetype };
+                workingContent = sliced.body ?? "[]";
+                workingStart = null;
+                workingMimetypeForSlice = "application/json";
+            }
+            else {
+                const sliced = LineMarkerOps.sliceLines(content, lineMarker);
+                if (sliced.status !== 200)
+                    return { status: sliced.status, content: null, mimetype };
+                workingContent = sliced.text ?? "";
+                workingStart = sliced.startLine ?? null;
+            }
+        }
+        if (body !== null) {
+            if (mimetypes === undefined)
+                return { status: 500, content: null, mimetype };
+            const matched = await Matcher.matchAgainstContent(body, workingContent, mimetype, mimetypes, workingStart ?? 1);
+            if (matched.status === 204)
+                return { status: 204, content: "", mimetype: "text/markdown", startLine: null, matches: 0 };
+            if (matched.status === 203) {
+                // Dialect-parse-failure fallback: raw source as text/markdown; reason surfaces why.
+                return { status: 203, content: matched.body ?? "", mimetype: matched.mimetype ?? "text/markdown", startLine: 1, reason: matched.reason };
+            }
+            if (matched.status !== 200)
+                return { status: matched.status, content: null, mimetype };
+            return { status: 200, content: matched.body ?? "", mimetype: "text/markdown", startLine: null, matches: matched.matches };
+        }
+        if (lineMarker !== null) {
+            // `<L>` slice mimetype follows the source family: line-navigable → text/markdown,
+            // JSON → application/json (structure preserved for compose). Empty / `[]` → 204.
+            const isEmptyJsonArray = workingMimetypeForSlice === "application/json" && workingContent === "[]";
+            if (workingContent === "" || isEmptyJsonArray)
+                return { status: 204, content: "", mimetype: workingMimetypeForSlice, startLine: null };
+            return { status: 200, content: workingContent, mimetype: workingMimetypeForSlice, startLine: workingStart };
+        }
+        if (content === "")
+            return { status: 204, content: "", mimetype, startLine: null };
+        return { status: 200, content, mimetype, startLine: 1 };
+    }
+}
+//# sourceMappingURL=read-resolve.js.map

package/dist/content/read-resolve.js.map

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

package/dist/core/ChannelWrite.d.ts

@@ -2,6 +2,7 @@ import type { Db } from "./Db.ts";
 export type ChannelState = "static" | "active" | "closed" | "errored";
 export interface StreamEventPayload {
     entryId: number;
+    target: string;
     channel: string;
     state: ChannelState;
     contentLength: number;
@@ -11,6 +12,7 @@ export interface WakeRunPayload {
     sessionId: number;
     runId: number;
     entryId: number;
+    target: string;
     subscriptionId: number;
     closeStatus: number;
     scheme: string;
@@ -22,34 +24,37 @@ export interface TelemetryEventPayload {
     event: object;
 }
 export type TelemetryEventNotify = (sessionId: number, payload: TelemetryEventPayload) => void;
-export declare const appendToChannel: (db: Db, { entryId, channel, chunk, notify }: {
-    entryId: number;
-    channel: string;
-    chunk: string;
-    notify?: StreamEventNotify;
-}) => Promise<void>;
-export declare const setChannelState: (db: Db, { entryId, channel, state, notify }: {
-    entryId: number;
-    channel: string;
-    state: ChannelState;
-    notify?: StreamEventNotify;
-}) => Promise<void>;
-export declare const openSubscription: (db: Db, { runId, entryId, scheme, handle }: {
-    runId: number;
-    entryId: number;
-    scheme: string;
-    handle: string;
-}) => Promise<number>;
-export declare const closeSubscription: (db: Db, { subscriptionId, status }: {
-    subscriptionId: number;
-    status: number;
-}) => Promise<void>;
-export declare const findActiveSubscription: (db: Db, { runId, entryId }: {
-    runId: number;
-    entryId: number;
-}) => Promise<{
-    id: number;
-    scheme: string;
-    handle: string;
-} | null>;
+export default class ChannelWrite {
+    #private;
+    static appendToChannel(db: Db, { entryId, channel, chunk, notify }: {
+        entryId: number;
+        channel: string;
+        chunk: string;
+        notify?: StreamEventNotify;
+    }): Promise<void>;
+    static setChannelState(db: Db, { entryId, channel, state, notify }: {
+        entryId: number;
+        channel: string;
+        state: ChannelState;
+        notify?: StreamEventNotify;
+    }): Promise<void>;
+    static openSubscription(db: Db, { runId, entryId, scheme, handle }: {
+        runId: number;
+        entryId: number;
+        scheme: string;
+        handle: string;
+    }): Promise<number>;
+    static closeSubscription(db: Db, { subscriptionId, status }: {
+        subscriptionId: number;
+        status: number;
+    }): Promise<void>;
+    static findActiveSubscription(db: Db, { runId, entryId }: {
+        runId: number;
+        entryId: number;
+    }): Promise<{
+        id: number;
+        scheme: string;
+        handle: string;
+    } | null>;
+}
 //# sourceMappingURL=ChannelWrite.d.ts.map

package/dist/core/ChannelWrite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChannelWrite.d.ts","sourceRoot":"","sources":["../../src/core/ChannelWrite.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,EAAE,EAAc,MAAM,SAAS,CAAC;AAE9C,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtE,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,YAAY,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAQvF,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;AAQ9D,MAAM,WAAW,qBAAqB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;AAe/F,eAAO,MAAM,eAAe,GACxB,IAAI,EAAE,EACN,qCAAqC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAAE,KACrH,OAAO,CAAC,IAAI,CAOd,CAAC;AAEF,eAAO,MAAM,eAAe,GACxB,IAAI,EAAE,EACN,qCAAqC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAC;IAAC,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAAE,KAC3H,OAAO,CAAC,IAAI,CAOd,CAAC;AAEF,eAAO,MAAM,gBAAgB,GACzB,IAAI,EAAE,EACN,oCAAoC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,KACvG,OAAO,CAAC,MAAM,CAIhB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC1B,IAAI,EAAE,EACN,4BAA4B;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,KACvE,OAAO,CAAC,IAAI,CAEd,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAC/B,IAAI,EAAE,EACN,oBAAoB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,KACvD,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAG/D,CAAC"}
+{"version":3,"file":"ChannelWrite.d.ts","sourceRoot":"","sources":["../../src/core/ChannelWrite.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,EAAE,EAAc,MAAM,SAAS,CAAC;AAE9C,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtE,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,YAAY,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAQvF,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;AAQ9D,MAAM,WAAW,qBAAqB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;AAU/F,MAAM,CAAC,OAAO,OAAO,YAAY;;WAehB,eAAe,CACxB,EAAE,EAAE,EAAE,EACN,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,iBAAiB,CAAA;KAAE,GACrH,OAAO,CAAC,IAAI,CAAC;WASH,eAAe,CACxB,EAAE,EAAE,EAAE,EACN,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAC;QAAC,MAAM,CAAC,EAAE,iBAAiB,CAAA;KAAE,GAC3H,OAAO,CAAC,IAAI,CAAC;WASH,gBAAgB,CACzB,EAAE,EAAE,EAAE,EACN,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GACvG,OAAO,CAAC,MAAM,CAAC;WAML,iBAAiB,CAC1B,EAAE,EAAE,EAAE,EACN,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GACvE,OAAO,CAAC,IAAI,CAAC;WAIH,sBAAsB,CAC/B,EAAE,EAAE,EAAE,EACN,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GACvD,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAIpE"}

package/dist/core/ChannelWrite.js

@@ -5,45 +5,53 @@
 // Helpers update entry_channels (content / state) and subscriptions, and emit
 // stream/event notifications scoped to the entry's session via an optional
 // callback the daemon wires in.
-const channelMeta = (db) => db.channel_meta;
-const appendStmt = (db) => db.append_to_channel;
-const stateStmt = (db) => db.set_channel_state;
-const openSubStmt = (db) => db.open_subscription;
-const closeSubStmt = (db) => db.close_subscription;
-const findActiveStmt = (db) => db.find_active_subscription;
-export const appendToChannel = async (db, { entryId, channel, chunk, notify }) => {
-    const result = await appendStmt(db).run({ chunk, entry_id: entryId, channel });
-    if (result.changes === 0)
-        return;
-    if (notify === undefined)
-        return;
-    const meta = await channelMeta(db).get({ entry_id: entryId, channel });
-    if (meta === undefined)
-        return;
-    notify(meta.session_id, { entryId, channel, state: meta.state, contentLength: meta.contentLength });
-};
-export const setChannelState = async (db, { entryId, channel, state, notify }) => {
-    const result = await stateStmt(db).run({ state, entry_id: entryId, channel });
-    if (result.changes === 0)
-        return;
-    if (notify === undefined)
-        return;
-    const meta = await channelMeta(db).get({ entry_id: entryId, channel });
-    if (meta === undefined)
-        return;
-    notify(meta.session_id, { entryId, channel, state: meta.state, contentLength: meta.contentLength });
-};
-export const openSubscription = async (db, { runId, entryId, scheme, handle }) => {
-    const row = await openSubStmt(db).get({ run_id: runId, entry_id: entryId, scheme, handle });
-    if (row === undefined)
-        throw new Error("openSubscription: INSERT ... RETURNING produced no row");
-    return row.id;
-};
-export const closeSubscription = async (db, { subscriptionId, status }) => {
-    await closeSubStmt(db).run({ status, subscription_id: subscriptionId });
-};
-export const findActiveSubscription = async (db, { runId, entryId }) => {
-    const row = await findActiveStmt(db).get({ run_id: runId, entry_id: entryId });
-    return row ?? null;
-};
+export default class ChannelWrite {
+    static #channelMeta(db) { return db.channel_meta; }
+    static #appendStmt(db) { return db.append_to_channel; }
+    static #stateStmt(db) { return db.set_channel_state; }
+    static #openSubStmt(db) { return db.open_subscription; }
+    static #closeSubStmt(db) { return db.close_subscription; }
+    static #findActiveStmt(db) { return db.find_active_subscription; }
+    // The entry's target URI for stream notifications (#179). A NULL scheme is
+    // a filesystem entry (the file scheme stores scheme=NULL), so it decodes to
+    // file://.
+    static #targetUri(scheme, pathname) {
+        return `${scheme === null ? "file" : scheme}://${pathname}`;
+    }
+    static async appendToChannel(db, { entryId, channel, chunk, notify }) {
+        const result = await ChannelWrite.#appendStmt(db).run({ chunk, entry_id: entryId, channel });
+        if (result.changes === 0)
+            return;
+        if (notify === undefined)
+            return;
+        const meta = await ChannelWrite.#channelMeta(db).get({ entry_id: entryId, channel });
+        if (meta === undefined)
+            return;
+        notify(meta.session_id, { entryId, target: ChannelWrite.#targetUri(meta.scheme, meta.pathname), channel, state: meta.state, contentLength: meta.contentLength });
+    }
+    static async setChannelState(db, { entryId, channel, state, notify }) {
+        const result = await ChannelWrite.#stateStmt(db).run({ state, entry_id: entryId, channel });
+        if (result.changes === 0)
+            return;
+        if (notify === undefined)
+            return;
+        const meta = await ChannelWrite.#channelMeta(db).get({ entry_id: entryId, channel });
+        if (meta === undefined)
+            return;
+        notify(meta.session_id, { entryId, target: ChannelWrite.#targetUri(meta.scheme, meta.pathname), channel, state: meta.state, contentLength: meta.contentLength });
+    }
+    static async openSubscription(db, { runId, entryId, scheme, handle }) {
+        const row = await ChannelWrite.#openSubStmt(db).get({ run_id: runId, entry_id: entryId, scheme, handle });
+        if (row === undefined)
+            throw new Error("openSubscription: INSERT ... RETURNING produced no row");
+        return row.id;
+    }
+    static async closeSubscription(db, { subscriptionId, status }) {
+        await ChannelWrite.#closeSubStmt(db).run({ status, subscription_id: subscriptionId });
+    }
+    static async findActiveSubscription(db, { runId, entryId }) {
+        const row = await ChannelWrite.#findActiveStmt(db).get({ run_id: runId, entry_id: entryId });
+        return row ?? null;
+    }
+}
 //# sourceMappingURL=ChannelWrite.js.map

package/dist/core/ChannelWrite.js.map

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