@plurnk/plurnk-schemes 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PossumTech Laboratories
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,28 @@
+# plurnk-schemes
+
+Framework + contract for `@plurnk/plurnk-schemes-*` URI handler packages. Consumed by [plurnk-service](https://github.com/plurnk/plurnk-service).
+
+## Documentation
+
+- [`SPEC.md`](./SPEC.md) — author-facing contract.
+- Constellation: [plurnk-grammar](https://github.com/plurnk/plurnk-grammar), [plurnk-mimetypes](https://github.com/plurnk/plurnk-mimetypes), [plurnk-providers](https://github.com/plurnk/plurnk-providers), [plurnk-execs](https://github.com/plurnk/plurnk-execs).
+
+## Exports
+
+### Types
+
+`SchemeManifest`, `SchemeFlagAffinity`, `WriterTier`, `LoopFlags`, `DEFAULT_LOOP_FLAGS`.
+
+### Helpers
+
+- `resolveForLoop(handlers, flags)` — active-scheme resolution under loop flags.
+- `isBinaryMimetype` / `isLineNavigableMimetype` / `isJsonMimetype` / `normalizeAutoTextMimetype` / `TEXT_PRIMITIVE_MIMETYPE` — mimetype classification.
+- `sliceLines` / `sliceLinesRaw` / `sliceJsonItems` / `applyLineMarkerEdit` / `applyJsonItemEdit` — `<L>` slicing + structural EDIT.
+- `resolveEntryMimetype(pathname, default, mimetypes)` — path-extension mimetype resolver.
+- `matchAgainstContent(body, content, mimetype, mimetypes, baseLine?)` — body-matcher dispatch adapter over `Mimetypes.query`.
+
+DB-coupled helpers (CRUD primitives, entry-op handlers, channel writes, subscription registry) stay in plurnk-service; this repo ships only types and pure helpers. Forward-spec: a namespaced ctx API replaces the v0 split when third-party schemes are an actual concern.
+
+## Tests
+
+`test:lint`, `test:unit`.

package/SPEC.md

@@ -0,0 +1,143 @@
+# plurnk-schemes — Specification
+
+Contract for `@plurnk/plurnk-schemes-*` sibling packages. Audience: implementer of a URI scheme handler. Consumer: [plurnk-service](https://github.com/plurnk/plurnk-service) (SPEC.md §3).
+
+## §1 Manifest
+
+```json
+{
+    "name": "@plurnk/plurnk-schemes-<name>",
+    "plurnk": { "kind": "scheme", "name": "<scheme name>" }
+}
+```
+
+Class-level manifest (static field on the default export):
+
+```ts
+import type { SchemeManifest } from "@plurnk/plurnk-schemes";
+
+class Known {
+    static manifest: SchemeManifest = {
+        name: "known",
+        channels: { body: "text/markdown", preview: "text/markdown" },
+        defaultChannel: "body",
+        category: "data",
+        scope: "session",
+        writableBy: ["model", "client"],
+        volatile: false,
+        modelVisible: true,
+        flags: { /* optional SchemeFlagAffinity */ },
+    };
+}
+```
+
+| Field | Constraint |
+|---|---|
+| `name` | Matches `package.json#plurnk.name`. |
+| `channels` | `Record<channelName, mimetype>`. Channel names lowercase. Empty = dynamic per-call. |
+| `defaultChannel` | Channel name targeted when path has no `#fragment`. Empty when channels is empty. |
+| `category` | `"data"` \| `"logging"`. |
+| `scope` | `"agent"` \| `"session"`. |
+| `writableBy` | Subset of `["model", "client", "system", "plugin"]`. Consumer returns 403 for outside-set writes. |
+| `volatile` | Boolean. |
+| `modelVisible` | Boolean. |
+| `flags?` | Optional `SchemeFlagAffinity`. |
+
+## §2 Interface
+
+Sister scheme handlers implement op methods consumed by plurnk-service via dispatch. The expected method shape (per consumer-side §3 of plurnk-service's SPEC):
+
+```ts
+interface PlurnkScheme {
+    // CRUD primitives — REQUIRED for entry-bearing schemes.
+    readEntry(pathname, ctx): Promise<ReadEntryResult>;
+    writeEntry(pathname, entry, ctx): Promise<WriteEntryResult>;
+    deleteEntry(pathname, ctx): Promise<DeleteEntryResult>;
+
+    // Op handlers — OPTIONAL. Absent op = 501.
+    edit?(statement, ctx): Promise<EditResult>;
+    read?(statement, ctx): Promise<ReadResult>;
+    show?(statement, ctx): Promise<ShowHideResult>;
+    hide?(statement, ctx): Promise<ShowHideResult>;
+    find?(statement, ctx): Promise<FindResult>;
+    send?(statement, ctx): Promise<SendResult>;
+    exec?(statement, ctx): Promise<ExecResult>;
+
+    // Proposal lifecycle — OPTIONAL.
+    onProposalAccepted?(pathname, proposal, ctx): Promise<OpResult>;
+    onProposalRejected?(pathname, proposal, ctx): Promise<void>;
+}
+```
+
+Default export: a class implementing the shape with `static manifest: SchemeManifest`.
+
+Result-type definitions (`EditResult`, `ReadResult`, etc.) live in plurnk-service v0 alongside the helpers that produce them. Forward-spec: these migrate to this repo when the namespaced ctx API lands.
+
+## §3 Helpers exported by this repo
+
+### Types
+
+- `SchemeManifest`, `SchemeFlagAffinity`, `WriterTier`, `LoopFlags`, `DEFAULT_LOOP_FLAGS`.
+
+### Active-scheme resolution
+
+- `resolveForLoop(handlers: Map<string, object>, flags: LoopFlags): Set<string>` — applies `manifest.flags` affinity to each handler and returns names of schemes active under the loop's flags.
+
+### Mimetype classification
+
+- `isBinaryMimetype(mimetype)` — enforces 415 boundary on binary entries (text/* is text; application/{json,yaml,toml,xml,javascript,typescript,sql} is text; `+json`/`+xml`/`+yaml` suffix variants are text; everything else with a slash is binary).
+- `isJsonMimetype(mimetype)` — `application/json` plus `+json` variants. Used by `<L>` dispatch.
+- `isLineNavigableMimetype(mimetype)` — render-layer decides whether to prefix lines with `N:\t`.
+- `normalizeAutoTextMimetype(mimetype)` — `text/plain` / null / undefined → `TEXT_PRIMITIVE_MIMETYPE` (`text/markdown`).
+- `TEXT_PRIMITIVE_MIMETYPE` — `"text/markdown"`.
+
+### `<L>` slicing
+
+- `sliceLines(content, marker)` — line-navigable slice. Returns `{ status, text?, startLine?, error? }`.
+- `sliceLinesRaw(content, marker)` — same shape; no `N:\t` prefix.
+- `sliceJsonItems(content, marker)` — JSON-source item slice. Returns `{ status, body?, error? }`.
+- `applyLineMarkerEdit(content, marker, body)` — line-navigable EDIT.
+- `applyJsonItemEdit(content, marker, body)` — structural JSON EDIT.
+
+### Path-extension mimetype
+
+- `resolveEntryMimetype(pathname, defaultMimetype, mimetypes)` — pathname extension → `Mimetypes.detect({ ext })`; falls back to `defaultMimetype` when no extension. text/plain auto-normalizes to text/markdown.
+
+### Matcher dispatch
+
+- `matchAgainstContent(body, content, mimetype, mimetypes, baseLine?)` — body-matcher adapter over `Mimetypes.query`. Maps framework errors:
+  - `UnsupportedDialectError` → status 415
+  - `InvalidExpressionError` → status 400
+  - `QueryParseFailureError` → status 203 (soft fallback: raw content as text/markdown with `reason`)
+  - Empty match array → status 204
+  - Match array → status 200
+
+## §4 What's NOT in this repo
+
+DB-coupled helpers stay in plurnk-service for v0:
+
+- `_entry-ops.ts` (read/edit/show/hide session entries)
+- `_entry-crud.ts` (CRUD primitives + write-time tokenization helper)
+- `_entry-send.ts` (SEND[410]/[499] dispatcher)
+- `_entry-find.ts` (pathname-glob FIND)
+- `ChannelWrite.ts` (channel append + subscription registry)
+- `PlurnkSchemeContext` (per-call helper with DB handle)
+
+These migrate when the v1 namespaced ctx API lands (entries / channels / visibility / tags / subscriptions / proposals / crossScheme / notify). v0 scope: types + pure helpers only.
+
+## §5 Forbidden (for third-party schemes)
+
+| ❌ |
+|---|
+| Imports from `@plurnk/plurnk-service/*` |
+| Direct database access |
+| Writes outside the scheme's own namespace |
+| Direct invocation of peer schemes |
+| Mutating `ctx` |
+| Holding `ctx` references past the op handler's return |
+| Reading or writing `log_entries` directly |
+| Calling consumer-internal methods |
+| Writing to `console`, stdout, stderr |
+| Spawning subprocesses (unless the scheme is specifically a subprocess scheme) |
+| Opening network connections (unless specifically a network scheme) |
+| Caching across op invocations (state in instance fields beyond config) |

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export type { LoopFlags, SchemeFlagAffinity, SchemeManifest, WriterTier, } from "./types.ts";
+export { DEFAULT_LOOP_FLAGS } from "./types.ts";
+export { resolveForLoop } from "./resolveForLoop.ts";
+export { isBinaryMimetype, isJsonMimetype, isLineNavigableMimetype, normalizeAutoTextMimetype, TEXT_PRIMITIVE_MIMETYPE, } from "./mimetype-binary.ts";
+export { applyJsonItemEdit, applyLineMarkerEdit, sliceJsonItems, sliceLines, sliceLinesRaw, } from "./line-marker.ts";
+export type { EditResult as LineEditResult, JsonSliceResult, SliceResult } from "./line-marker.ts";
+export { resolveEntryMimetype } from "./path-mimetype.ts";
+export { matchAgainstContent } from "./matcher.ts";
+export type { MatchResult } from "./matcher.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,UAAU,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EACH,gBAAgB,EAChB,cAAc,EACd,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,GAC1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACH,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,UAAU,EACV,aAAa,GAChB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,UAAU,IAAI,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEnG,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { DEFAULT_LOOP_FLAGS } from "./types.js";
+export { resolveForLoop } from "./resolveForLoop.js";
+export { isBinaryMimetype, isJsonMimetype, isLineNavigableMimetype, normalizeAutoTextMimetype, TEXT_PRIMITIVE_MIMETYPE, } from "./mimetype-binary.js";
+export { applyJsonItemEdit, applyLineMarkerEdit, sliceJsonItems, sliceLines, sliceLinesRaw, } from "./line-marker.js";
+export { resolveEntryMimetype } from "./path-mimetype.js";
+export { matchAgainstContent } from "./matcher.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EACH,gBAAgB,EAChB,cAAc,EACd,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,GAC1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACH,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,UAAU,EACV,aAAa,GAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/line-marker.d.ts

@@ -0,0 +1,23 @@
+import type { LineMarker } from "@plurnk/plurnk-grammar";
+export interface SliceResult {
+    status: number;
+    text?: string;
+    startLine?: number;
+    error?: string;
+}
+export declare const sliceLines: (content: string, marker: LineMarker) => SliceResult;
+export interface JsonSliceResult {
+    status: number;
+    body?: string;
+    error?: string;
+}
+export declare const sliceJsonItems: (content: string, marker: LineMarker) => JsonSliceResult;
+export declare const applyJsonItemEdit: (content: string, marker: LineMarker, body: string) => EditResult;
+export declare const sliceLinesRaw: (content: string, marker: LineMarker) => SliceResult;
+export interface EditResult {
+    status: number;
+    result?: string;
+    error?: string;
+}
+export declare const applyLineMarkerEdit: (content: string, marker: LineMarker, body: string) => EditResult;
+//# sourceMappingURL=line-marker.d.ts.map

package/dist/line-marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-marker.d.ts","sourceRoot":"","sources":["../src/line-marker.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAkCzD,MAAM,WAAW,WAAW;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AAWlG,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,EAAE,QAAQ,UAAU,KAAG,WAOhE,CAAC;AAyBF,MAAM,WAAW,eAAe;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AAElF,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,EAAE,QAAQ,UAAU,KAAG,eAoBpE,CAAC;AA6GF,eAAO,MAAM,iBAAiB,GAAI,SAAS,MAAM,EAAE,QAAQ,UAAU,EAAE,MAAM,MAAM,KAAG,UAerF,CAAC;AAOF,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,EAAE,QAAQ,UAAU,KAAG,WAQnE,CAAC;AAEF,MAAM,WAAW,UAAU;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AAS/E,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,EAAE,QAAQ,UAAU,EAAE,MAAM,MAAM,KAAG,UAiBvF,CAAC"}

package/dist/line-marker.js

@@ -0,0 +1,321 @@
+// `<L>` line-marker semantics (plurnk.md §`<L>`):
+//
+//   <N>      selects position N (1-indexed)
+//   <N,M>    selects positions N..M inclusive
+//   <0>      sentinel: before position 1 (EDIT prepend)
+//   <-1>     sentinel: after the last position (EDIT append)
+//   <1,-1>   every position (in range context, -1 normalizes to last line)
+//
+// "N and M are signed integers" — but plurnk.md only documents <0> and
+// <-1> as defined sentinels. Other negatives (<-2>, <-3>) are not
+// specified and rejected as 416. Within a range, -1 as the M endpoint
+// means "include through the last line" (so <1,-1> is whole content).
+const splitLines = (content) => {
+    const trailingNewline = content.endsWith("\n");
+    if (content === "")
+        return { lines: [], trailingNewline: false };
+    const lines = content.split("\n");
+    if (trailingNewline)
+        lines.pop();
+    return { lines, trailingNewline };
+};
+const normalize = (marker, totalLines) => {
+    const { first, last } = marker;
+    if (last === null) {
+        if (first === 0)
+            return { kind: "before-first", start: 0, end: 0 };
+        if (first === -1)
+            return { kind: "after-last", start: 0, end: 0 };
+        if (first > 0 && first <= totalLines)
+            return { kind: "range", start: first, end: first };
+        return { error: `line ${first} out of range (1..${totalLines})` };
+    }
+    let n = first;
+    let m = last;
+    if (n === 0)
+        n = 1;
+    if (m === -1)
+        m = totalLines;
+    if (n < 1 || n > totalLines)
+        return { error: `range start ${first} out of range (1..${totalLines})` };
+    if (m < 1 || m > totalLines)
+        return { error: `range end ${last} out of range (1..${totalLines})` };
+    if (n > m)
+        return { error: `range start ${first} > end ${last}` };
+    return { kind: "range", start: n, end: m };
+};
+// READ a line range. Returns the raw selected lines (no `N:\t` prefix)
+// plus the 1-indexed position of the first selected line. The render
+// layer adds `N:\t` per plurnk.md ("READ output prefixes every line with
+// line numbers, N:\t") starting from `startLine` — keeps numbering as a
+// presentation concern, prevents double-prefixing when the same content
+// passes through the log render.
+//
+// Sentinel positions <0> and <-1> select no content (they're insertion
+// points, not lines) → status 200 with empty text.
+export const sliceLines = (content, marker) => {
+    const { lines } = splitLines(content);
+    const norm = normalize(marker, lines.length);
+    if ("error" in norm)
+        return { status: 416, error: norm.error };
+    if (norm.kind !== "range")
+        return { status: 200, text: "", startLine: undefined };
+    const selected = lines.slice(norm.start - 1, norm.end);
+    return { status: 200, text: selected.join("\n"), startLine: norm.start };
+};
+// Structural `<L>` slice for JSON sources (plurnk-grammar 0.13.0).
+// "On structured entries, <L> addresses item index, not line number."
+// Every JSON value becomes a list of top-level items:
+//   array `[a, b, c]`     → items are the array elements
+//   object `{k1: v1, ...}` → items are key-value pairs (as single-key objects)
+//   scalar `"hello"` / 42  → item is the scalar itself (length-1 list)
+// `<L>` indexes into that list (1-indexed). Result is always a JSON array.
+// Sentinels `<0>` / `<-1>` are insertion points — empty `[]` for READ.
+// Out-of-range positions return 416. Matches the uniform "always JSON
+// array out" shape we settled for matcher results.
+const jsonValueToItems = (parsed) => {
+    if (Array.isArray(parsed))
+        return parsed;
+    if (parsed !== null && typeof parsed === "object") {
+        // Object items are single-key {key: value} wrappers, in insertion
+        // order. Object.entries preserves spec-guaranteed iteration order
+        // for string keys.
+        return Object.entries(parsed).map(([k, v]) => ({ [k]: v }));
+    }
+    // Scalar (string, number, boolean, null): a length-1 list of itself.
+    return [parsed];
+};
+export const sliceJsonItems = (content, marker) => {
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch (err) {
+        return { status: 400, error: `malformed JSON: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    const items = jsonValueToItems(parsed);
+    const total = items.length;
+    const { first, last } = marker;
+    if (last === null) {
+        if (first === 0 || first === -1)
+            return { status: 200, body: "[]" };
+        if (first > 0 && first <= total)
+            return { status: 200, body: JSON.stringify([items[first - 1]], null, 2) };
+        return { status: 416, error: `item ${first} out of range (1..${total})` };
+    }
+    let n = first;
+    let m = last;
+    if (n === 0)
+        n = 1;
+    if (m === -1)
+        m = total;
+    if (n < 1 || n > total)
+        return { status: 416, error: `range start ${first} out of range (1..${total})` };
+    if (m < 1 || m > total)
+        return { status: 416, error: `range end ${last} out of range (1..${total})` };
+    if (n > m)
+        return { status: 416, error: `range start ${first} > end ${last}` };
+    return { status: 200, body: JSON.stringify(items.slice(n - 1, m), null, 2) };
+};
+// Structural `<L>` EDIT for JSON sources (plurnk-grammar 0.13.0/0.14.0).
+// Source-shape rules (matches sliceJsonItems' item definition):
+//   array  → items are elements
+//   object → items are key-value pairs (single-key fragments)
+//   scalar → length-1 list of itself; grow markers (<0>,<-1>) reject
+//
+// Body shape (Resolution B):
+//   body parses as JSON array → those are the items to splice in
+//   body parses as non-array JSON → single item to splice in
+//   empty body → delete the selection
+//   body fails JSON parse → 400 (path-extension declares intent; honor it)
+//
+// Marker semantics (parallel to line-EDIT):
+//   <N>    replace item N with body item(s)
+//   <N,M>  replace items N..M with body item(s)
+//   <0>    prepend body item(s)
+//   <-1>   append body item(s)
+//   <1,-1> replace whole top-level with body item(s); empty body clears
+//   Empty body on a sentinel insertion (<0> or <-1>) → no-op.
+const itemsFromBody = (body) => {
+    if (body === "")
+        return { items: [] }; // empty body = delete
+    let parsed;
+    try {
+        parsed = JSON.parse(body);
+    }
+    catch (err) {
+        return { error: `malformed JSON body: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    if (Array.isArray(parsed))
+        return { items: parsed };
+    return { items: [parsed] };
+};
+const applyJsonArrayEdit = (source, marker, items) => {
+    const total = source.length;
+    const { first, last } = marker;
+    let result;
+    if (last === null) {
+        if (first === 0)
+            result = [...items, ...source];
+        else if (first === -1)
+            result = [...source, ...items];
+        else if (first > 0 && first <= total)
+            result = [...source.slice(0, first - 1), ...items, ...source.slice(first)];
+        else
+            return { status: 416, error: `position ${first} out of range (1..${total})` };
+    }
+    else {
+        let n = first;
+        let m = last;
+        if (n === 0)
+            n = 1;
+        if (m === -1)
+            m = total;
+        if (total === 0 && (first !== 1 || last !== -1))
+            return { status: 416, error: `range on empty array` };
+        if (n < 1 || (total > 0 && n > total))
+            return { status: 416, error: `range start ${first} out of range (1..${total})` };
+        if (m < 1 || (total > 0 && m > total))
+            return { status: 416, error: `range end ${last} out of range (1..${total})` };
+        if (n > m)
+            return { status: 416, error: `range start ${first} > end ${last}` };
+        result = [...source.slice(0, n - 1), ...items, ...source.slice(m)];
+    }
+    return { status: 200, result: JSON.stringify(result, null, 2) };
+};
+const applyJsonObjectEdit = (source, marker, items) => {
+    // Object items are key-value pairs. Body items must be objects;
+    // each object's entries become kv-pairs to splice in. Items that
+    // aren't single objects → 400 (model used wrong body shape for an
+    // object source).
+    const bodyEntries = [];
+    for (const item of items) {
+        if (item === null || typeof item !== "object" || Array.isArray(item)) {
+            return { status: 400, error: "object source requires body items to be JSON objects (key-value pairs)" };
+        }
+        bodyEntries.push(...Object.entries(item));
+    }
+    const entries = Object.entries(source);
+    const total = entries.length;
+    const { first, last } = marker;
+    let result;
+    if (last === null) {
+        if (first === 0)
+            result = [...bodyEntries, ...entries];
+        else if (first === -1)
+            result = [...entries, ...bodyEntries];
+        else if (first > 0 && first <= total)
+            result = [...entries.slice(0, first - 1), ...bodyEntries, ...entries.slice(first)];
+        else
+            return { status: 416, error: `position ${first} out of range (1..${total})` };
+    }
+    else {
+        let n = first;
+        let m = last;
+        if (n === 0)
+            n = 1;
+        if (m === -1)
+            m = total;
+        if (total === 0 && (first !== 1 || last !== -1))
+            return { status: 416, error: `range on empty object` };
+        if (n < 1 || (total > 0 && n > total))
+            return { status: 416, error: `range start ${first} out of range (1..${total})` };
+        if (m < 1 || (total > 0 && m > total))
+            return { status: 416, error: `range end ${last} out of range (1..${total})` };
+        if (n > m)
+            return { status: 416, error: `range start ${first} > end ${last}` };
+        result = [...entries.slice(0, n - 1), ...bodyEntries, ...entries.slice(m)];
+    }
+    return { status: 200, result: JSON.stringify(Object.fromEntries(result), null, 2) };
+};
+const applyJsonScalarEdit = (source, marker, items) => {
+    // Scalar source is a length-1 list of itself. Only `<1>` replace
+    // works cleanly; grow markers (<0>,<-1>) and ranges that imply
+    // growth/delete would require type promotion (scalar → array),
+    // which is the kind of implicit magic that bites later. Reject.
+    const { first, last } = marker;
+    if (last === null && first === 1) {
+        if (items.length === 0)
+            return { status: 200, result: "null" }; // delete the scalar
+        if (items.length === 1)
+            return { status: 200, result: JSON.stringify(items[0], null, 2) };
+        return { status: 400, error: "scalar source: <1> body must produce 0 or 1 items (no implicit promotion to array)" };
+    }
+    if (last === -1 && first === 1) {
+        // <1,-1> = whole content. Same constraints as <1> for scalars.
+        if (items.length === 0)
+            return { status: 200, result: "null" };
+        if (items.length === 1)
+            return { status: 200, result: JSON.stringify(items[0], null, 2) };
+        return { status: 400, error: "scalar source: <1,-1> body must produce 0 or 1 items (no implicit promotion to array)" };
+    }
+    return { status: 400, error: "scalar JSON source: only <1> or <1,-1> markers supported (no implicit promotion to array via grow markers)" };
+};
+export const applyJsonItemEdit = (content, marker, body) => {
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch (err) {
+        return { status: 400, error: `malformed JSON source: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    const bodyResult = itemsFromBody(body);
+    if ("error" in bodyResult)
+        return { status: 400, error: bodyResult.error };
+    const items = bodyResult.items;
+    // Empty-body sentinel insertion is a no-op (model accidentally
+    // emitted no items at an insertion point).
+    if (items.length === 0 && marker.last === null && (marker.first === 0 || marker.first === -1)) {
+        return { status: 200, result: content };
+    }
+    if (Array.isArray(parsed))
+        return applyJsonArrayEdit(parsed, marker, items);
+    if (parsed !== null && typeof parsed === "object")
+        return applyJsonObjectEdit(parsed, marker, items);
+    return applyJsonScalarEdit(parsed, marker, items);
+};
+// COPY-style raw line slice. Returns the selected lines verbatim (no line-
+// number prefix), trailing newline appended if any lines were selected.
+// Used for COPY/MOVE `<L>` per SPEC.md §16.9 (source range, symmetric
+// with READ but without the READ-output prefix that's a render concern,
+// not a data concern).
+export const sliceLinesRaw = (content, marker) => {
+    const { lines } = splitLines(content);
+    const norm = normalize(marker, lines.length);
+    if ("error" in norm)
+        return { status: 416, error: norm.error };
+    if (norm.kind !== "range")
+        return { status: 200, text: "" };
+    const selected = lines.slice(norm.start - 1, norm.end);
+    const result = selected.length > 0 ? `${selected.join("\n")}\n` : "";
+    return { status: 200, text: result };
+};
+// EDIT applies body at the marker position:
+//   <0>     prepend body before line 1
+//   <-1>    append body after the last line
+//   <N>     replace line N with body
+//   <N,M>   replace lines N..M with body
+//   <1,-1>  whole content (replace everything); empty body clears.
+// Empty body with <N>/<N,M> deletes those lines.
+export const applyLineMarkerEdit = (content, marker, body) => {
+    const { lines, trailingNewline } = splitLines(content);
+    const norm = normalize(marker, lines.length);
+    if ("error" in norm)
+        return { status: 416, error: norm.error };
+    const bodyLines = splitLines(body).lines;
+    let newLines;
+    if (norm.kind === "before-first") {
+        newLines = [...bodyLines, ...lines];
+    }
+    else if (norm.kind === "after-last") {
+        newLines = [...lines, ...bodyLines];
+    }
+    else {
+        newLines = [...lines.slice(0, norm.start - 1), ...bodyLines, ...lines.slice(norm.end)];
+    }
+    let result = newLines.join("\n");
+    if (newLines.length > 0 && trailingNewline)
+        result += "\n";
+    return { status: 200, result };
+};
+//# sourceMappingURL=line-marker.js.map

package/dist/line-marker.js.map

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

package/dist/matcher.d.ts

@@ -0,0 +1,12 @@
+import type { MatcherBody } from "@plurnk/plurnk-grammar";
+import type { Mimetypes } from "@plurnk/plurnk-mimetypes";
+export interface MatchResult {
+    status: number;
+    body?: string;
+    matches?: number;
+    error?: string;
+    mimetype?: string;
+    reason?: string;
+}
+export declare const matchAgainstContent: (body: MatcherBody, content: string, mimetype: string, mimetypes: Mimetypes, baseLine?: number) => Promise<MatchResult>;
+//# sourceMappingURL=matcher.d.ts.map

package/dist/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../src/matcher.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,0BAA0B,CAAC;AAQtE,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;AAcD,eAAO,MAAM,mBAAmB,GAC5B,MAAM,WAAW,EACjB,SAAS,MAAM,EACf,UAAU,MAAM,EAChB,WAAW,SAAS,EACpB,WAAU,MAAU,KACrB,OAAO,CAAC,WAAW,CA2CrB,CAAC"}

package/dist/matcher.js

@@ -0,0 +1,77 @@
+// 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. plurnk-service catches
+// the framework's typed errors and maps them to HTTP-shaped status codes
+// the model can act on.
+//
+// Status mapping (per plurnk-service#172 + plurnk-grammar#19):
+//   UnsupportedDialectError  → 415  (dialect not supported for mimetype, or binary content)
+//   InvalidExpressionError   → 400  (model authored a malformed matcher body)
+//   QueryParseFailureError   → 203  (source can't be parsed for the dialect;
+//                                    returns raw content as text/markdown with
+//                                    `reason` so the model can fall back to
+//                                    regex/visual parsing on the bytes)
+//   Empty match array        → 204  (matcher applied, zero results)
+//   Match array              → 200  (matcher applied, results in body)
+//
+// 203 is HTTP-creative ("Non-Authoritative Information") — the runtime
+// produced content but not in the structured form the matcher requested.
+// Model sees the raw text plus a reason field and decides whether to
+// retry, fall back, or fix source. Choice ratified by user (#172).
+import { UnsupportedDialectError, InvalidExpressionError, QueryParseFailureError, } from "@plurnk/plurnk-mimetypes";
+import { TEXT_PRIMITIVE_MIMETYPE } from "./mimetype-binary.js";
+const prettyJson = (value) => JSON.stringify(value, null, 2);
+// Apply a `<L>`-slice baseLine offset to per-match line numbers. The
+// framework returns line numbers relative to the content it received;
+// when the matcher runs inside an `<L>` slice, those need to be shifted
+// back to original-source coordinates.
+const shiftLines = (matches, baseLine) => {
+    if (baseLine === 1)
+        return [...matches];
+    const offset = baseLine - 1;
+    return matches.map((m) => ({ ...m, line: m.line + offset }));
+};
+export const matchAgainstContent = async (body, content, mimetype, mimetypes, baseLine = 1) => {
+    try {
+        // Framework dispatches dialect by leading prefix of `body.raw`.
+        // `hint` carries the source mimetype so the framework selects the
+        // right per-mimetype handler without re-detecting from content.
+        const rawMatches = await mimetypes.query({ content, hint: mimetype }, body.raw);
+        if (rawMatches.length === 0) {
+            return { status: 204, matches: 0 };
+        }
+        const adjusted = shiftLines(rawMatches, baseLine);
+        return {
+            status: 200,
+            body: prettyJson(adjusted),
+            matches: adjusted.length,
+        };
+    }
+    catch (err) {
+        // Name-based dispatch tolerates dup-copy node_modules layouts where
+        // `instanceof` against the framework's exported classes can fail
+        // because the consumer loads a different physical copy. The framework
+        // 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) };
+        }
+        if (name === "InvalidExpressionError" || err instanceof InvalidExpressionError) {
+            return { status: 400, error: err instanceof Error ? err.message : String(err) };
+        }
+        if (name === "QueryParseFailureError" || err instanceof QueryParseFailureError) {
+            // 203 soft fallback: return raw content as text so the model
+            // can fall back to regex/visual parsing or fix the source.
+            return {
+                status: 203,
+                body: content,
+                mimetype: TEXT_PRIMITIVE_MIMETYPE,
+                reason: err instanceof Error ? err.message : String(err),
+            };
+        }
+        // Unexpected — let it propagate so the engine logs it as a 500.
+        throw err;
+    }
+};
+//# sourceMappingURL=matcher.js.map

package/dist/matcher.js.map

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

package/dist/mimetype-binary.d.ts

@@ -0,0 +1,6 @@
+export declare const isBinaryMimetype: (mimetype: string) => boolean;
+export declare const isJsonMimetype: (mimetype: string) => boolean;
+export declare const isLineNavigableMimetype: (mimetype: string) => boolean;
+export declare const TEXT_PRIMITIVE_MIMETYPE = "text/markdown";
+export declare const normalizeAutoTextMimetype: (mimetype: string | null | undefined) => string;
+//# sourceMappingURL=mimetype-binary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mimetype-binary.d.ts","sourceRoot":"","sources":["../src/mimetype-binary.ts"],"names":[],"mappings":"AAiCA,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,KAAG,OASnD,CAAC;AAKF,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,KAAG,OACe,CAAC;AAElE,eAAO,MAAM,uBAAuB,GAAI,UAAU,MAAM,KAAG,OAS1D,CAAC;AAaF,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AAEvD,eAAO,MAAM,yBAAyB,GAAI,UAAU,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,MAK/E,CAAC"}

package/dist/mimetype-binary.js

@@ -0,0 +1,82 @@
+// 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).
+const 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.
+const TREE_NAVIGABLE_MIMETYPES = new Set([
+    "application/json",
+    "application/xml",
+    "text/html",
+]);
+export const 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 (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.
+export const isJsonMimetype = (mimetype) => mimetype === "application/json" || mimetype.endsWith("+json");
+export const isLineNavigableMimetype = (mimetype) => {
+    if (mimetype.length === 0)
+        return false;
+    if (isBinaryMimetype(mimetype))
+        return false;
+    if (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;
+};
+// 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.
+export const TEXT_PRIMITIVE_MIMETYPE = "text/markdown";
+export const normalizeAutoTextMimetype = (mimetype) => {
+    if (mimetype === null || mimetype === undefined || mimetype === "" || mimetype === "text/plain") {
+        return TEXT_PRIMITIVE_MIMETYPE;
+    }
+    return mimetype;
+};
+//# sourceMappingURL=mimetype-binary.js.map

package/dist/mimetype-binary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mimetype-binary.js","sourceRoot":"","sources":["../src/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,0BAA0B,GAAwB,IAAI,GAAG,CAAC;IAC5D,kBAAkB;IAClB,kBAAkB;IAClB,kBAAkB;IAClB,iBAAiB;IACjB,wBAAwB;IACxB,wBAAwB;IACxB,iBAAiB;CACpB,CAAC,CAAC;AAEH,mEAAmE;AACnE,+DAA+D;AAC/D,MAAM,wBAAwB,GAAwB,IAAI,GAAG,CAAC;IAC1D,kBAAkB;IAClB,iBAAiB;IACjB,WAAW;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAgB,EAAW,EAAE;IAC1D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACtC,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IAClC,IAAI,0BAA0B,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3D,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACxG,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,uEAAuE;AACvE,mEAAmE;AACnE,oEAAoE;AACpE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAgB,EAAW,EAAE,CACxD,QAAQ,KAAK,kBAAkB,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAElE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,QAAgB,EAAW,EAAE;IACjE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,gBAAgB,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,wBAAwB,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IACzD,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1E,gEAAgE;IAChE,yEAAyE;IACzE,mEAAmE;IACnE,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,sEAAsE;AACtE,oEAAoE;AACpE,mEAAmE;AACnE,wEAAwE;AACxE,wEAAwE;AACxE,qEAAqE;AACrE,gEAAgE;AAChE,aAAa;AACb,EAAE;AACF,mEAAmE;AACnE,kFAAkF;AAClF,MAAM,CAAC,MAAM,uBAAuB,GAAG,eAAe,CAAC;AAEvD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,QAAmC,EAAU,EAAE;IACrF,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC9F,OAAO,uBAAuB,CAAC;IACnC,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC,CAAC"}

package/dist/path-mimetype.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"path-mimetype.d.ts","sourceRoot":"","sources":["../src/path-mimetype.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAmB1D,eAAO,MAAM,oBAAoB,GAC7B,UAAU,MAAM,EAChB,eAAe,MAAM,EACrB,WAAW,SAAS,GAAG,SAAS,KACjC,OAAO,CAAC,MAAM,CAOhB,CAAC"}

package/dist/path-mimetype.js

@@ -0,0 +1,47 @@
+// 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 { normalizeAutoTextMimetype } from "./mimetype-binary.js";
+// Extract the suffix (everything after the last dot in the last segment)
+// from a pathname. Empty if no dot in the last segment.
+const 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).
+export const resolveEntryMimetype = async (pathname, schemeDefault, mimetypes) => {
+    const ext = extractExtension(pathname);
+    if (ext.length > 0 && mimetypes !== undefined) {
+        const detected = await mimetypes.detect({ ext });
+        if (detected !== null)
+            return normalizeAutoTextMimetype(detected);
+    }
+    return schemeDefault;
+};
+//# sourceMappingURL=path-mimetype.js.map

package/dist/path-mimetype.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-mimetype.js","sourceRoot":"","sources":["../src/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,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,yEAAyE;AACzE,wDAAwD;AACxD,MAAM,gBAAgB,GAAG,CAAC,QAAgB,EAAU,EAAE;IAClD,MAAM,SAAS,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IAChF,MAAM,OAAO,GAAG,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC,CAAE,iDAAiD;IAC/E,OAAO,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAE,2BAA2B;AACnE,CAAC,CAAC;AAEF,2CAA2C;AAC3C,uEAAuE;AACvE,uEAAuE;AACvE,kCAAkC;AAClC,oEAAoE;AACpE,wEAAwE;AACxE,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EACrC,QAAgB,EAChB,aAAqB,EACrB,SAAgC,EACjB,EAAE;IACjB,MAAM,GAAG,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QACjD,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,aAAa,CAAC;AACzB,CAAC,CAAC"}

package/dist/resolveForLoop.d.ts

@@ -0,0 +1,12 @@
+import type { LoopFlags } from "./types.ts";
+/**
+ * Given a map of scheme name → handler instance and the active loop's
+ * flags, return the set of scheme names eligible to dispatch.
+ *
+ * - Schemes without `manifest.flags` are always active.
+ * - `excludedInAsk` filters out under `mode === "ask"`.
+ * - `requiresWeb` / `requiresInteraction` / `proposes` filter out under
+ *   the corresponding `no*` flag.
+ */
+export declare const resolveForLoop: (handlers: ReadonlyMap<string, object>, flags: LoopFlags) => Set<string>;
+//# sourceMappingURL=resolveForLoop.d.ts.map

package/dist/resolveForLoop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveForLoop.d.ts","sourceRoot":"","sources":["../src/resolveForLoop.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,YAAY,CAAC;AAM5D;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GACvB,UAAU,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EACrC,OAAO,SAAS,KACjB,GAAG,CAAC,MAAM,CAeZ,CAAC"}

package/dist/resolveForLoop.js

@@ -0,0 +1,32 @@
+// Active-scheme resolution under a given loop's flags. Schemes opt into
+// flag affinity via `manifest.flags`; absence = always active.
+/**
+ * Given a map of scheme name → handler instance and the active loop's
+ * flags, return the set of scheme names eligible to dispatch.
+ *
+ * - Schemes without `manifest.flags` are always active.
+ * - `excludedInAsk` filters out under `mode === "ask"`.
+ * - `requiresWeb` / `requiresInteraction` / `proposes` filter out under
+ *   the corresponding `no*` flag.
+ */
+export const resolveForLoop = (handlers, flags) => {
+    const active = new Set();
+    for (const [name, handler] of handlers.entries()) {
+        const affinity = handler.constructor.manifest?.flags;
+        if (affinity === undefined) {
+            active.add(name);
+            continue;
+        }
+        if (flags.mode === "ask" && affinity.excludedInAsk)
+            continue;
+        if (flags.noWeb && affinity.requiresWeb)
+            continue;
+        if (flags.noInteraction && affinity.requiresInteraction)
+            continue;
+        if (flags.noProposals && affinity.proposes)
+            continue;
+        active.add(name);
+    }
+    return active;
+};
+//# sourceMappingURL=resolveForLoop.js.map

package/dist/resolveForLoop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveForLoop.js","sourceRoot":"","sources":["../src/resolveForLoop.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,+DAA+D;AAQ/D;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC1B,QAAqC,EACrC,KAAgB,EACL,EAAE;IACb,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/C,MAAM,QAAQ,GAAI,OAA8B,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC;QAC7E,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACjB,SAAS;QACb,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,QAAQ,CAAC,aAAa;YAAE,SAAS;QAC7D,IAAI,KAAK,CAAC,KAAK,IAAI,QAAQ,CAAC,WAAW;YAAE,SAAS;QAClD,IAAI,KAAK,CAAC,aAAa,IAAI,QAAQ,CAAC,mBAAmB;YAAE,SAAS;QAClE,IAAI,KAAK,CAAC,WAAW,IAAI,QAAQ,CAAC,QAAQ;YAAE,SAAS;QACrD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,27 @@
+export type WriterTier = "model" | "client" | "system" | "plugin";
+export interface SchemeFlagAffinity {
+    readonly excludedInAsk?: boolean;
+    readonly requiresWeb?: boolean;
+    readonly requiresInteraction?: boolean;
+    readonly proposes?: boolean;
+}
+export interface SchemeManifest {
+    readonly name: string;
+    readonly channels: Record<string, string>;
+    readonly defaultChannel: string;
+    readonly category: "data" | "logging";
+    readonly scope: "agent" | "session";
+    readonly writableBy: ReadonlyArray<WriterTier>;
+    readonly volatile: boolean;
+    readonly modelVisible: boolean;
+    readonly flags?: SchemeFlagAffinity;
+}
+export interface LoopFlags {
+    readonly mode: "ask" | "act";
+    readonly yolo: boolean;
+    readonly noWeb: boolean;
+    readonly noInteraction: boolean;
+    readonly noProposals: boolean;
+}
+export declare const DEFAULT_LOOP_FLAGS: LoopFlags;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAElE,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;CACvC;AAED,MAAM,WAAW,SAAS;IACtB,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CACjC;AAED,eAAO,MAAM,kBAAkB,EAAE,SAMhC,CAAC"}

package/dist/types.js

@@ -0,0 +1,17 @@
+// Framework-grade types shared by every `@plurnk/plurnk-schemes-*` sibling
+// and its consumer (plurnk-service).
+//
+// Notably absent from this surface: `PlurnkSchemeContext`. The full per-call
+// context shape (which includes the database handle, channel-write notifier,
+// wake-on-completion notifier, etc.) is plurnk-service-coupled and lives
+// in the consumer. Sister schemes consume the parts of ctx the engine
+// supplies them per dispatch; this repo ships only the manifest + flag
+// types every sibling needs to declare itself.
+export const DEFAULT_LOOP_FLAGS = {
+    mode: "act",
+    yolo: false,
+    noWeb: false,
+    noInteraction: false,
+    noProposals: false,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,qCAAqC;AACrC,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,yEAAyE;AACzE,sEAAsE;AACtE,uEAAuE;AACvE,+CAA+C;AA+B/C,MAAM,CAAC,MAAM,kBAAkB,GAAc;IACzC,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,KAAK,EAAE,KAAK;IACZ,aAAa,EAAE,KAAK;IACpB,WAAW,EAAE,KAAK;CACrB,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+    "name": "@plurnk/plurnk-schemes",
+    "version": "0.1.0",
+    "description": "Framework + contract for the @plurnk/plurnk-schemes-* URI handler family.",
+    "keywords": ["plurnk", "scheme", "uri"],
+    "homepage": "https://github.com/plurnk/plurnk-schemes#readme",
+    "bugs": {
+        "url": "https://github.com/plurnk/plurnk-schemes/issues"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/plurnk/plurnk-schemes.git"
+    },
+    "engines": {
+        "node": ">=25"
+    },
+    "license": "MIT",
+    "author": "@wikitopian",
+    "type": "module",
+    "publishConfig": {
+        "access": "public"
+    },
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "files": [
+        "dist/**/*",
+        "README.md",
+        "SPEC.md"
+    ],
+    "scripts": {
+        "test:lint": "tsc --noEmit",
+        "test:unit": "node --test src/**/*.test.ts",
+        "test": "npm run test:lint && npm run test:unit",
+        "build:dist": "tsc -p tsconfig.build.json",
+        "build": "npm run build:dist",
+        "prepare": "npm run build"
+    },
+    "peerDependencies": {
+        "@plurnk/plurnk-grammar": "^0.15.0",
+        "@plurnk/plurnk-mimetypes": "^0.7.0"
+    },
+    "devDependencies": {
+        "@plurnk/plurnk-grammar": "^0.15.0",
+        "@plurnk/plurnk-mimetypes": "^0.7.0",
+        "@types/node": "^25.8.0",
+        "typescript": "^6.0.3"
+    }
+}