@plurnk/plurnk-schemes 1.3.12 → 1.5.0

package/dist/Manifest.d.ts

@@ -0,0 +1,6 @@
+import type { SchemeManifest } from "./types.ts";
+export default class Manifest {
+    #private;
+    static of(handler: unknown, expectedName?: string): SchemeManifest;
+}
+//# sourceMappingURL=Manifest.d.ts.map

package/dist/Manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Manifest.d.ts","sourceRoot":"","sources":["../src/Manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAsB,cAAc,EAAc,MAAM,YAAY,CAAC;AAuBjF,MAAM,CAAC,OAAO,OAAO,QAAQ;;IACzB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,cAAc,CA8CjE;CAgDJ"}

package/dist/Manifest.js

@@ -0,0 +1,115 @@
+const WRITERS = new Set(["model", "client", "plurnk", "plugin"]);
+const CATEGORIES = new Set(["data", "logging", "control"]);
+const MANIFEST_FIELD_NAMES = new Set(Object.keys({
+    name: true,
+    channels: true,
+    defaultChannel: true,
+    category: true,
+    writableBy: true,
+    volatile: true,
+    modelVisible: true,
+    folderScopes: true,
+    foldedByDefault: true,
+    flags: true,
+    example: true,
+    documentation: true,
+    glyph: true,
+    storedScheme: true,
+}));
+const FLAG_AFFINITIES = ["excludedInAsk", "requiresWeb", "requiresInteraction"];
+const FLAG_AFFINITY_NAMES = new Set(FLAG_AFFINITIES);
+export default class Manifest {
+    static of(handler, expectedName) {
+        if (typeof handler !== "object" || handler === null) {
+            throw new Error("scheme handler must be an object");
+        }
+        const instance = handler;
+        const value = instance.manifest ?? instance.constructor?.manifest;
+        if (typeof value !== "object" || value === null || Array.isArray(value)) {
+            throw new Error(`scheme '${expectedName ?? "unknown"}' must declare a static or instance manifest`);
+        }
+        const manifest = value;
+        const name = Manifest.#string(manifest, "name");
+        const unknown = Object.keys(manifest).find((field) => !MANIFEST_FIELD_NAMES.has(field));
+        if (unknown !== undefined) {
+            throw new Error(`scheme '${name}' manifest has unknown field '${unknown}'`);
+        }
+        if (expectedName !== undefined && name !== expectedName) {
+            throw new Error(`scheme identity mismatch: registered '${expectedName}', manifest declares '${name}'`);
+        }
+        const channels = manifest.channels;
+        if (typeof channels !== "object" || channels === null || Array.isArray(channels)
+            || !Object.entries(channels).every(([channel, mimetype]) => channel.length > 0
+                && channel === channel.toLowerCase()
+                && typeof mimetype === "string"
+                && mimetype.length > 0)) {
+            throw new Error(`scheme '${name}' manifest.channels must map lowercase channel names to non-empty mimetypes`);
+        }
+        const defaultChannel = Manifest.#string(manifest, "defaultChannel", true);
+        if (Object.keys(channels).length > 0 && !Object.hasOwn(channels, defaultChannel)) {
+            throw new Error(`scheme '${name}' manifest.defaultChannel '${defaultChannel}' is not declared in channels`);
+        }
+        if (!CATEGORIES.has(manifest.category)) {
+            throw new Error(`scheme '${name}' manifest.category must be data, logging, or control`);
+        }
+        const writableBy = manifest.writableBy;
+        if (!Array.isArray(writableBy)
+            || !writableBy.every((writer) => typeof writer === "string" && WRITERS.has(writer))
+            || new Set(writableBy).size !== writableBy.length) {
+            throw new Error(`scheme '${name}' manifest.writableBy must contain unique writer tiers`);
+        }
+        Manifest.#boolean(manifest, "volatile");
+        Manifest.#boolean(manifest, "modelVisible");
+        for (const field of ["folderScopes", "foldedByDefault"])
+            Manifest.#optionalBoolean(manifest, field);
+        for (const field of ["example", "documentation", "storedScheme"])
+            Manifest.#optionalString(manifest, field);
+        Manifest.#optionalNonemptyString(manifest, "glyph");
+        Manifest.#flags(manifest.flags, name);
+        return value;
+    }
+    static #string(record, field, emptyAllowed = false) {
+        const value = record[field];
+        if (typeof value !== "string" || (!emptyAllowed && value.length === 0)) {
+            throw new Error(`scheme manifest.${field} must be ${emptyAllowed ? "a string" : "a non-empty string"}`);
+        }
+        return value;
+    }
+    static #boolean(record, field) {
+        if (typeof record[field] !== "boolean")
+            throw new Error(`scheme manifest.${field} must be boolean`);
+    }
+    static #optionalBoolean(record, field) {
+        if (record[field] !== undefined && typeof record[field] !== "boolean") {
+            throw new Error(`scheme manifest.${field} must be boolean when present`);
+        }
+    }
+    static #optionalString(record, field) {
+        if (record[field] !== undefined && typeof record[field] !== "string") {
+            throw new Error(`scheme manifest.${field} must be a string when present`);
+        }
+    }
+    static #optionalNonemptyString(record, field) {
+        if (record[field] !== undefined && (typeof record[field] !== "string" || record[field].length === 0)) {
+            throw new Error(`scheme manifest.${field} must be a non-empty string when present`);
+        }
+    }
+    static #flags(value, name) {
+        if (value === undefined)
+            return;
+        if (typeof value !== "object" || value === null || Array.isArray(value)) {
+            throw new Error(`scheme '${name}' manifest.flags must be an object`);
+        }
+        const flags = value;
+        const unknown = Object.keys(flags).find((field) => !FLAG_AFFINITY_NAMES.has(field));
+        if (unknown !== undefined) {
+            throw new Error(`scheme '${name}' manifest.flags has unknown field '${unknown}'`);
+        }
+        for (const field of FLAG_AFFINITIES) {
+            if (flags[field] !== undefined && typeof flags[field] !== "boolean") {
+                throw new Error(`scheme '${name}' manifest.flags.${field} must be boolean`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=Manifest.js.map

package/dist/Manifest.js.map

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

package/dist/Matcher.d.ts

@@ -1,15 +1,14 @@
-import type { MatcherBody } from "@plurnk/plurnk-grammar";
+import type { MatcherBody } from "@plurnk/plurnk-contracts";
 import type { Mimetypes } from "@plurnk/plurnk-mimetypes";
-export interface MatchResult {
-    status: number;
+import { type MatchEvidence, type SchemeResult } from "./Results.ts";
+export interface MatchResult extends SchemeResult {
     body?: string;
-    matches?: number;
-    error?: string;
+    matches?: ReadonlyArray<MatchEvidence>;
     mimetype?: string;
     reason?: string;
 }
 export default class Matcher {
     #private;
-    static matchAgainstContent(body: MatcherBody, content: string, mimetype: string, mimetypes: Mimetypes, baseLine?: number): Promise<MatchResult>;
+    static matchAgainstContent(body: MatcherBody, content: string, mimetype: string, mimetypes: Mimetypes): Promise<MatchResult>;
 }
 //# sourceMappingURL=Matcher.d.ts.map

package/dist/Matcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Matcher.d.ts","sourceRoot":"","sources":["../src/Matcher.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAiC,MAAM,0BAA0B,CAAC;AAQzF,MAAM,WAAW,WAAW;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,CAAC,OAAO,OAAO,OAAO;;IA6DxB,OAAa,mBAAmB,CAC5B,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,SAAS,EACpB,QAAQ,GAAE,MAAU,GACrB,OAAO,CAAC,WAAW,CAAC,CA6CtB;CACJ"}
+{"version":3,"file":"Matcher.d.ts","sourceRoot":"","sources":["../src/Matcher.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAiC,MAAM,0BAA0B,CAAC;AAOzF,OAAgB,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAE9E,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,CAAC,OAAO,OAAO,OAAO;;IA+CxB,OAAa,mBAAmB,CAC5B,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,SAAS,GACrB,OAAO,CAAC,WAAW,CAAC,CAqEtB;CACJ"}

package/dist/Matcher.js

@@ -1,62 +1,44 @@
-// Body-matcher adapter — delegates to @plurnk/plurnk-mimetypes for the actual
-// dialect dispatch. The framework parses the matcher's leading prefix internally
-// (xpath `//`, jsonpath `$`, regex `/.../`, glob otherwise) and routes to
-// per-mimetype handlers; this maps its typed errors to the HTTP-shaped status
-// codes the model acts on.
+// {§matcher-dispatch} Body-matcher operation adapter. Mimetypes owns handler
+// resolution, dialect execution, and evidence; this layer maps its typed
+// outcomes to the universal scheme-result contract. PLURNK callers pass the
+// grammar's parsed dialect, while standalone raw strings retain framework
+// classification.
 //
-// The full status mapping is the contract: SPEC §matcher-dispatch. One
-// rationale that doesn't live there: 203 is HTTP-creative ("Non-Authoritative
-// Information") — content was produced, but not in the structured form the
-// matcher requested; the model sees raw text + a `reason` and chooses
-// retry/fallback/fix-source. Choice ratified by user (#172).
+// Status 203 preserves readable content when its requested structural
+// projection cannot be parsed; the owning mapping lives in {§matcher-dispatch}.
 import { UnsupportedDialectError, InvalidExpressionError, QueryParseFailureError, } from "@plurnk/plurnk-mimetypes";
 import { TEXT_PRIMITIVE_MIMETYPE } from "./MimetypeClassifier.js";
+import Results from "./Results.js";
 export default class Matcher {
-    // Render one match's value for the model-facing line. Bare for a single-
-    // line string; JSON-encoded otherwise so the one-match-per-line invariant
-    // holds (a multi-line value would otherwise break the `<L><K>` pick-Kth
-    // composition that matcher-then-slice depends on).
-    static #renderValue(value) {
-        return typeof value === "string" && !value.includes("\n") ? value : JSON.stringify(value);
-    }
-    // Render matches as the model-facing `<source-line>:\t<line-content>` form,
-    // one source line per entry — the `N:\t` convention READ emits. A matcher
-    // SELECTS a location; READ returns the SOURCE LINE at that location, never an
-    // extracted value (grammar contract plurnk.md:31, schemes#27). A regex hit on
-    // `### §grinder …` renders that whole line, not the matched token `grinder`.
-    //
-    // The hit's source footprint is `lines[]` (mimetypes #41: structural dialects
-    // self-provide it, symmetric with regex/glob). We anchor on the first span's
-    // start line and emit the SOURCE line text there. Deduped by source line — a
-    // line matched twice appears once (e.g. two regex hits on one line). A
-    // footprint-less match — an xpath computed scalar (count()/string()/sum()/…)
-    // that lives nowhere in the source — has no line to return, so it renders its
-    // value bare; the framework never fakes a line for it, and neither do we.
-    //
-    // Line lookup uses SLICE coordinates (the `content` the matcher ran against),
-    // while the displayed number is SOURCE coordinates (`+ baseLine - 1`) — so an
-    // `<L>`-sliced match reports its original-source line but reads text from the
-    // slice in hand. `matching` (the resolved query path) is never surfaced.
-    static #renderMatches(matches, content, baseLine) {
-        const sliceLines = content.split("\n");
-        const offset = baseLine - 1;
+    static #evidence(matches) {
+        const evidence = [];
         const seen = new Set();
-        const out = [];
-        for (const m of matches) {
-            const sliceLine = m.lines?.[0]?.line;
-            if (sliceLine === undefined) {
-                out.push(Matcher.#renderValue(m.matched));
+        for (const match of matches) {
+            const regions = match.regions ?? [];
+            if (regions.length === 0 && match.matching !== undefined) {
+                const item = Results.assertMatchEvidence({ locator: match.matching });
+                const key = JSON.stringify(item);
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    evidence.push(item);
+                }
                 continue;
             }
-            const sourceLine = sliceLine + offset;
-            if (seen.has(sourceLine))
-                continue; // dedup by source line
-            seen.add(sourceLine);
-            out.push(`${sourceLine}:\t${sliceLines[sliceLine - 1] ?? ""}`);
+            for (const region of regions) {
+                const item = Results.assertMatchEvidence({
+                    ...(match.matching === undefined ? {} : { locator: match.matching }),
+                    region,
+                });
+                const key = JSON.stringify(item);
+                if (seen.has(key))
+                    continue;
+                seen.add(key);
+                evidence.push(item);
+            }
         }
-        return out;
+        return evidence;
     }
-    // Hand the framework the ALREADY-PARSED matcher (mimetypes#42), not the raw
+    // {§matcher-dispatch} Hand the framework the ALREADY-PARSED matcher, not the raw
     // string — the grammar owns the matcher syntax, so re-classifying `raw`
     // inside mimetypes is a second parser for one syntax and a silent drift
     // surface (a body the grammar parsed as regex that re-classifies as xpath:
@@ -73,22 +55,18 @@ export default class Matcher {
             default: return body.raw;
         }
     }
-    static async matchAgainstContent(body, content, mimetype, mimetypes, baseLine = 1) {
+    static async matchAgainstContent(body, content, mimetype, mimetypes) {
         try {
             // Pass the parsed matcher (declared dialect authoritative) + `hint`
             // (source mimetype, so the framework picks the right per-mimetype
             // handler without re-detecting from content). No re-parse, no drift.
             const rawMatches = await mimetypes.query({ content, hint: mimetype }, Matcher.#parsedMatcher(body));
             if (rawMatches.length === 0) {
-                return { status: 204, matches: 0 };
+                return { status: 204, matches: [] };
             }
-            // Render to deduped source lines; `matches` counts the lines the model
-            // sees (post-dedup), not raw hits — a line matched twice is one result.
-            const rendered = Matcher.#renderMatches(rawMatches, content, baseLine);
             return {
                 status: 200,
-                body: rendered.join("\n"),
-                matches: rendered.length,
+                matches: Matcher.#evidence(rawMatches),
             };
         }
         catch (err) {
@@ -98,10 +76,24 @@ export default class Matcher {
             // sets each error subclass's `.name` to its class name.
             const name = err instanceof Error ? err.name : "";
             if (name === "UnsupportedDialectError" || err instanceof UnsupportedDialectError) {
-                return { status: 415, error: err instanceof Error ? err.message : String(err) };
+                const unsupportedMimetype = typeof err.mimetype === "string"
+                    ? err.mimetype
+                    : mimetype;
+                return Results.failure("schemes:matcher", "unsupported-dialect", 415, `The ${body.dialect} matcher is not supported for ${unsupportedMimetype}.`, {}, {
+                    stage: "matcher",
+                    dialect: body.dialect,
+                    mimetype: unsupportedMimetype,
+                    recovery: "Use a matcher supported by the resource mimetype.",
+                    retryable: false,
+                });
             }
             if (name === "InvalidExpressionError" || err instanceof InvalidExpressionError) {
-                return { status: 400, error: err instanceof Error ? err.message : String(err) };
+                return Results.failure("schemes:matcher", "invalid-expression", 400, `The ${body.dialect} matcher expression is invalid.`, {}, {
+                    stage: "matcher",
+                    dialect: body.dialect,
+                    recovery: "Correct or remove the matcher.",
+                    retryable: false,
+                });
             }
             if (name === "QueryParseFailureError" || err instanceof QueryParseFailureError) {
                 // 203 soft fallback: return raw content as text so the model

package/dist/Matcher.js.map

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

package/dist/MimetypeClassifier.d.ts

@@ -2,7 +2,7 @@ export declare const TEXT_PRIMITIVE_MIMETYPE = "text/markdown";
 export default class MimetypeClassifier {
     static isBinary(mimetype: string): boolean;
     static isJson(mimetype: string): boolean;
-    static isLineNavigable(mimetype: string): boolean;
+    static isHtml(mimetype: string): boolean;
     static normalizeAutoText(mimetype: string | null | undefined): string;
 }
 //# sourceMappingURL=MimetypeClassifier.d.ts.map

package/dist/MimetypeClassifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MimetypeClassifier.d.ts","sourceRoot":"","sources":["../src/MimetypeClassifier.ts"],"names":[],"mappings":"AAuBA,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AAEvD,MAAM,CAAC,OAAO,OAAO,kBAAkB;IAEnC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzC;IAMD,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvC;IAGD,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEhD;IAMD,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAKpE;CACJ"}
+{"version":3,"file":"MimetypeClassifier.d.ts","sourceRoot":"","sources":["../src/MimetypeClassifier.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AAEvD,MAAM,CAAC,OAAO,OAAO,kBAAkB;IAEnC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzC;IAKD,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvC;IAGD,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvC;IAMD,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAKpE;CACJ"}

package/dist/MimetypeClassifier.js

@@ -1,14 +1,11 @@
 // Mimetype classifiers used at op-handler boundaries.
 //
-// binary/line-navigable taxonomy DELEGATES to @plurnk/plurnk-mimetypes'
-// `classifyMimetype` (mimetypes#43, delivered 0.18.0) — the framework is the
-// single source of filetype truth, and our former local allowlists were a
-// drift surface (schemes#28: NDJSON classified binary → READ 415). The 44-case
-// truth table those tables encoded was absorbed upstream byte-for-byte; the
-// unit suite here remains as the conformance guard on that absorption.
+// Binary/text taxonomy delegates to @plurnk/plurnk-mimetypes. This adapter is
+// the registry-free surface; a consumer with a configured Mimetypes service
+// uses Mimetypes.classify() so installed handler declarations remain authoritative.
 //
-// What stays LOCAL is scheme semantics, not filetype fact (ruled in #43):
-//   isJson           — `<L>` item-index dispatch (RFC 6839 + slicer semantics).
+// {§mimetype-classifier} What stays local is scheme semantics, not filetype fact:
+//   isJson           - JSON receipt summarization (RFC 6839).
 //   normalizeAutoText — the text-primitive policy (auto-derived text is markdown).
 import { classifyMimetype } from "@plurnk/plurnk-mimetypes";
 // Text primitive for the agent contract: text/markdown is the default
@@ -21,20 +18,19 @@ import { classifyMimetype } from "@plurnk/plurnk-mimetypes";
 // markdown?"
 export const TEXT_PRIMITIVE_MIMETYPE = "text/markdown";
 export default class MimetypeClassifier {
-    // 415 boundary on binary entries (SPEC §mimetype-classifier).
+    // Pure taxonomy for registry-free boundaries (SPEC {§mimetype-classifier}).
     static isBinary(mimetype) {
         return classifyMimetype(mimetype).binary;
     }
-    // JSON-family check — used by `<L>` dispatch to pick structural slicer
-    // (Slicer.jsonItems) over line slicer (Slicer.lines) for JSON sources.
+    // JSON-family check used by receipt summarization.
     // Matches application/json plus +json suffix variants per RFC 6839.
-    // Scheme semantics, deliberately NOT delegated (mimetypes#43).
+    // {§mimetype-classifier} Scheme semantics, deliberately NOT delegated.
     static isJson(mimetype) {
         return mimetype === "application/json" || mimetype.endsWith("+json");
     }
-    // Render-layer `N:\t` prefix decision (SPEC §mimetype-classifier).
-    static isLineNavigable(mimetype) {
-        return classifyMimetype(mimetype).lineNavigable;
+    // Exact normalized HTML family used by web acquisition {§html-materialization}.
+    static isHtml(mimetype) {
+        return mimetype === "text/html" || mimetype === "application/xhtml+xml";
     }
     // Normalize an auto-derived text mimetype to the text primitive.
     // Use at any consumer-side auto-derivation point (file scheme

package/dist/MimetypeClassifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"MimetypeClassifier.js","sourceRoot":"","sources":["../src/MimetypeClassifier.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,EAAE;AACF,wEAAwE;AACxE,6EAA6E;AAC7E,0EAA0E;AAC1E,+EAA+E;AAC/E,4EAA4E;AAC5E,uEAAuE;AACvE,EAAE;AACF,0EAA0E;AAC1E,gFAAgF;AAChF,mFAAmF;AAEnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,sEAAsE;AACtE,oEAAoE;AACpE,mEAAmE;AACnE,wEAAwE;AACxE,wEAAwE;AACxE,qEAAqE;AACrE,gEAAgE;AAChE,aAAa;AACb,MAAM,CAAC,MAAM,uBAAuB,GAAG,eAAe,CAAC;AAEvD,MAAM,CAAC,OAAO,OAAO,kBAAkB;IACnC,8DAA8D;IAC9D,MAAM,CAAC,QAAQ,CAAC,QAAgB;QAC5B,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;IAC7C,CAAC;IAED,uEAAuE;IACvE,uEAAuE;IACvE,oEAAoE;IACpE,+DAA+D;IAC/D,MAAM,CAAC,MAAM,CAAC,QAAgB;QAC1B,OAAO,QAAQ,KAAK,kBAAkB,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACzE,CAAC;IAED,mEAAmE;IACnE,MAAM,CAAC,eAAe,CAAC,QAAgB;QACnC,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAC,aAAa,CAAC;IACpD,CAAC;IAED,iEAAiE;IACjE,8DAA8D;IAC9D,wEAAwE;IACxE,2BAA2B;IAC3B,MAAM,CAAC,iBAAiB,CAAC,QAAmC;QACxD,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC9F,OAAO,uBAAuB,CAAC;QACnC,CAAC;QACD,OAAO,QAAQ,CAAC;IACpB,CAAC;CACJ"}
+{"version":3,"file":"MimetypeClassifier.js","sourceRoot":"","sources":["../src/MimetypeClassifier.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,oFAAoF;AACpF,EAAE;AACF,kFAAkF;AAClF,8DAA8D;AAC9D,mFAAmF;AAEnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,sEAAsE;AACtE,oEAAoE;AACpE,mEAAmE;AACnE,wEAAwE;AACxE,wEAAwE;AACxE,qEAAqE;AACrE,gEAAgE;AAChE,aAAa;AACb,MAAM,CAAC,MAAM,uBAAuB,GAAG,eAAe,CAAC;AAEvD,MAAM,CAAC,OAAO,OAAO,kBAAkB;IACnC,4EAA4E;IAC5E,MAAM,CAAC,QAAQ,CAAC,QAAgB;QAC5B,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;IAC7C,CAAC;IAED,mDAAmD;IACnD,oEAAoE;IACpE,uEAAuE;IACvE,MAAM,CAAC,MAAM,CAAC,QAAgB;QAC1B,OAAO,QAAQ,KAAK,kBAAkB,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACzE,CAAC;IAED,gFAAgF;IAChF,MAAM,CAAC,MAAM,CAAC,QAAgB;QAC1B,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,uBAAuB,CAAC;IAC5E,CAAC;IAED,iEAAiE;IACjE,8DAA8D;IAC9D,wEAAwE;IACxE,2BAA2B;IAC3B,MAAM,CAAC,iBAAiB,CAAC,QAAmC;QACxD,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC9F,OAAO,uBAAuB,CAAC;QACnC,CAAC;QACD,OAAO,QAAQ,CAAC;IACpB,CAAC;CACJ"}

package/dist/NetworkAddress.d.ts

@@ -0,0 +1,13 @@
+import { type UrlPath } from "@plurnk/plurnk-contracts";
+/** Canonical, non-secret identity and transport form for network targets. {§network-address} */
+export default class NetworkAddress {
+    readonly scheme: string;
+    readonly pathname: string;
+    readonly url: string;
+    readonly hasCredentials: boolean;
+    private constructor();
+    static supports(scheme: string): boolean;
+    static from(target: UrlPath): NetworkAddress;
+    static render(scheme: string, pathname: string): string;
+}
+//# sourceMappingURL=NetworkAddress.d.ts.map

package/dist/NetworkAddress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkAddress.d.ts","sourceRoot":"","sources":["../src/NetworkAddress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAIpE,gGAAgG;AAChG,MAAM,CAAC,OAAO,OAAO,cAAc;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IAEjC,OAAO,eAgBN;IAED,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEvC;IAED,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,GAAG,cAAc,CAE3C;IAED,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAatD;CACJ"}

package/dist/NetworkAddress.js

@@ -0,0 +1,43 @@
+import { PathSyntax } from "@plurnk/plurnk-contracts";
+const NETWORK_SCHEMES = new Set(["http", "https", "ws", "wss"]);
+/** Canonical, non-secret identity and transport form for network targets. {§network-address} */
+export default class NetworkAddress {
+    scheme;
+    pathname;
+    url;
+    hasCredentials;
+    constructor(target) {
+        const scheme = target.scheme.toLowerCase();
+        if (!NetworkAddress.supports(scheme)) {
+            throw new TypeError(`unsupported network scheme: ${target.scheme}`);
+        }
+        if (target.hostname === null) {
+            throw new TypeError(`${scheme} target requires an authority`);
+        }
+        const authority = `${target.hostname}${target.port === null ? "" : `:${target.port}`}`;
+        const query = target.query === null ? "" : `?${target.query}`;
+        this.scheme = scheme;
+        this.pathname = PathSyntax.decodeParens(`/${authority}${target.pathname}`) + query;
+        this.url = `${scheme}://${authority}${target.pathname}${query}`;
+        this.hasCredentials = target.username !== null || target.password !== null;
+    }
+    static supports(scheme) {
+        return NETWORK_SCHEMES.has(scheme.toLowerCase());
+    }
+    static from(target) {
+        return new NetworkAddress(target);
+    }
+    static render(scheme, pathname) {
+        if (!NetworkAddress.supports(scheme)) {
+            throw new TypeError(`unsupported network scheme: ${scheme}`);
+        }
+        if (!pathname.startsWith("/")) {
+            throw new TypeError("network entry pathname must begin with `/`");
+        }
+        const queryStart = pathname.indexOf("?");
+        const path = queryStart === -1 ? pathname : pathname.slice(0, queryStart);
+        const query = queryStart === -1 ? "" : pathname.slice(queryStart);
+        return PathSyntax.escapeTarget(`${scheme.toLowerCase()}://${PathSyntax.encodeParens(path.slice(1))}${query}`);
+    }
+}
+//# sourceMappingURL=NetworkAddress.js.map

package/dist/NetworkAddress.js.map

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

package/dist/OutputScheme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OutputScheme.d.ts","sourceRoot":"","sources":["../src/OutputScheme.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjD,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,CAAC,OAAO,OAAO,YAAY;IAO7B,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,CAe5D;CACJ"}
+{"version":3,"file":"OutputScheme.d.ts","sourceRoot":"","sources":["../src/OutputScheme.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,CAAC,OAAO,OAAO,YAAY;IAO7B,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,CAc5D;CACJ"}

package/dist/OutputScheme.js

@@ -1,9 +1,9 @@
-// Derive an output-scheme manifest from an executor's per-tag runtime
-// declaration — the executor-is-a-scheme RFC (schemes#20 / service#240). An
+// {§executor-scheme-output} Derive an output-scheme manifest from an executor's
+// per-tag runtime declaration. An
 // executor authors NO SchemeManifest: its `plurnk.runtimes[]` entry already
-// carries name / glyph / example / output-channels, and everything else is the
-// shared read-only-output default. So `EXEC[sh]` gets `sh://` for free, and a
-// multi-tag executor (search/news/images) derives a distinct manifest per tag.
+// carries name / glyph / example / output-channels, and everything else is the shared
+// read-only-output default. So `EXEC[sh]` gets `sh://` for free, and a multi-tag
+// executor (search/news/images) derives a distinct manifest per tag.
 export default class OutputScheme {
     // The read-only-output default. An executor-scheme is a read-VIEW over
     // produced output: model never writes it (`writableBy: ["plugin"]`), it
@@ -17,7 +17,6 @@ export default class OutputScheme {
             channels: decl.channels,
             defaultChannel: decl.defaultChannel,
             category: "data",
-            scope: "workspace",
             writableBy: ["plugin"],
             volatile: true,
             modelVisible: true,

package/dist/OutputScheme.js.map

@@ -1 +1 @@
-{"version":3,"file":"OutputScheme.js","sourceRoot":"","sources":["../src/OutputScheme.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,4EAA4E;AAC5E,4EAA4E;AAC5E,+EAA+E;AAC/E,8EAA8E;AAC9E,+EAA+E;AAe/E,MAAM,CAAC,OAAO,OAAO,YAAY;IAC7B,uEAAuE;IACvE,wEAAwE;IACxE,6EAA6E;IAC7E,wEAAwE;IACxE,qEAAqE;IACrE,0EAA0E;IAC1E,MAAM,CAAC,mBAAmB,CAAC,IAAiB;QACxC,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,WAAW;YAClB,UAAU,EAAE,CAAC,QAAQ,CAAC;YACtB,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,IAAI;YAClB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,IAAI;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;SACxB,CAAC;IACN,CAAC;CACJ"}
+{"version":3,"file":"OutputScheme.js","sourceRoot":"","sources":["../src/OutputScheme.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,kCAAkC;AAClC,4EAA4E;AAC5E,sFAAsF;AACtF,iFAAiF;AACjF,qEAAqE;AAcrE,MAAM,CAAC,OAAO,OAAO,YAAY;IAC7B,uEAAuE;IACvE,wEAAwE;IACxE,6EAA6E;IAC7E,wEAAwE;IACxE,qEAAqE;IACrE,0EAA0E;IAC1E,MAAM,CAAC,mBAAmB,CAAC,IAAiB;QACxC,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,QAAQ,EAAE,MAAM;YAChB,UAAU,EAAE,CAAC,QAAQ,CAAC;YACtB,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,IAAI;YAClB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,IAAI;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;SACxB,CAAC;IACN,CAAC;CACJ"}

package/dist/PacketSections.d.ts

@@ -0,0 +1,6 @@
+import type { PacketSectionDraft } from "./packet.ts";
+export default class PacketSections {
+    #private;
+    static assertDrafts(value: unknown, subject?: string): PacketSectionDraft[];
+}
+//# sourceMappingURL=PacketSections.d.ts.map

package/dist/PacketSections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PacketSections.d.ts","sourceRoot":"","sources":["../src/PacketSections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAKtD,MAAM,CAAC,OAAO,OAAO,cAAc;;IAC/B,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,SAA0B,GAAG,kBAAkB,EAAE,CAY3F;CAuBJ"}

package/dist/PacketSections.js

@@ -0,0 +1,42 @@
+const FIELDS = ["name", "slot", "header", "content"];
+const FIELD_NAMES = new Set(FIELDS);
+export default class PacketSections {
+    static assertDrafts(value, subject = "packet section drafts") {
+        if (!Array.isArray(value))
+            throw new TypeError(`${subject} must be an array`);
+        const names = new Set();
+        for (let index = 0; index < value.length; index += 1) {
+            const section = PacketSections.#assertDraft(value[index], `${subject}[${index}]`);
+            if (names.has(section.name)) {
+                throw new TypeError(`${subject} has duplicate section name '${section.name}'`);
+            }
+            names.add(section.name);
+        }
+        return value;
+    }
+    static #assertDraft(value, subject) {
+        if (value === null || typeof value !== "object" || Array.isArray(value)) {
+            throw new TypeError(`${subject} must be an object`);
+        }
+        const section = value;
+        const missing = FIELDS.find((field) => !Object.hasOwn(section, field));
+        if (missing !== undefined)
+            throw new TypeError(`${subject} is missing field '${missing}'`);
+        const unexpected = Object.keys(section).find((field) => !FIELD_NAMES.has(field));
+        if (unexpected !== undefined)
+            throw new TypeError(`${subject} has unexpected field '${unexpected}'`);
+        if (typeof section.name !== "string" || section.name.length === 0) {
+            throw new TypeError(`${subject}.name must be a non-empty string`);
+        }
+        if (section.slot !== "system" && section.slot !== "user") {
+            throw new TypeError(`${subject}.slot must be system or user`);
+        }
+        if (section.header !== null && typeof section.header !== "string") {
+            throw new TypeError(`${subject}.header must be a string or null`);
+        }
+        if (typeof section.content !== "string")
+            throw new TypeError(`${subject}.content must be a string`);
+        return value;
+    }
+}
+//# sourceMappingURL=PacketSections.js.map

package/dist/PacketSections.js.map

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