@plurnk/plurnk-service 0.44.0 → 0.45.0

package/bin/plurnk-service.ts

@@ -1,176 +0,0 @@
-#!/usr/bin/env node
-
-import { parseArgs } from "node:util";
-import { existsSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-import { dirname, resolve } from "node:path";
-import SqlRite from "@possumtech/sqlrite";
-import type { Db } from "../src/core/Db.ts";
-import Daemon from "../src/server/Daemon.ts";
-import EnvFlags from "../src/core/EnvFlags.ts";
-import ProviderInstantiate from "../src/core/ProviderInstantiate.ts";
-import { resolveActiveAlias } from "@plurnk/plurnk-providers";
-
-export default class Cli {
-    static #projectRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
-
-    static #die(code: number, message: string): never {
-        process.stderr.write(`${message}\n`);
-        process.exit(code);
-    }
-
-    static #loadEnv(path: string, required: boolean): void {
-        if (existsSync(path)) {
-            try { process.loadEnvFile(path); }
-            catch (cause) { Cli.#die(64, `failed to load ${path}: ${cause instanceof Error ? cause.message : String(cause)}`); }
-        } else if (required) {
-            Cli.#die(64, `${path} does not exist`);
-        }
-    }
-
-    // node-style env-file flags: --env-file=<path> (required) / --env-file-if-exists=<path>
-    // (skip if missing), repeatable, in command-line order. They layer extra files ABOVE
-    // the .env cascade but BELOW shell env (loadEnvFile is set-if-unset) and the --<knob>
-    // CLI flags (assigned last). The `=` form only — node's canonical syntax (so it never
-    // leaks a positional). NB: node validates these paths from the full argv (and exits on
-    // a missing *required* one), but only LOADS pre-script files — the post-script loading
-    // a published `plurnk-service --env-file=…` needs is this.
-    static #envFileArgs(): Array<{ path: string; required: boolean }> {
-        return process.argv.flatMap((a): Array<{ path: string; required: boolean }> => {
-            if (a.startsWith("--env-file-if-exists=")) return [{ path: a.slice(a.indexOf("=") + 1), required: false }];
-            if (a.startsWith("--env-file=")) return [{ path: a.slice(a.indexOf("=") + 1), required: true }];
-            return [];
-        });
-    }
-
-    // The .env cascade always populates these from .env.example, so absence is
-    // a broken config, not a runtime branch — fail hard rather than `?? ""`.
-    static #requireEnv(name: string): string {
-        const value = process.env[name];
-        if (value === undefined || value.length === 0) Cli.#die(78, `missing required env ${name} (declare it in .env.example)`);
-        return value;
-    }
-
-    // Optional integer sqlite tuning knob — undefined when unset (so it never clobbers
-    // sqlrite's default by spreading an explicit `undefined`); fail-hard on a non-integer.
-    static #sqliteKnob(name: string): number | undefined {
-        const raw = process.env[name];
-        if (raw === undefined || raw.trim() === "") return undefined;
-        const n = Number(raw);
-        if (!Number.isInteger(n)) Cli.#die(78, `${name} must be an integer, got ${JSON.stringify(raw)}`);
-        return n;
-    }
-
-    static async #openDb(dbPath: string): Promise<Db> {
-        // Curated sqlite tuning (sqlrite 5.2.0, #7) — pass through ONLY the knobs the
-        // operator set, so an unset one keeps sqlrite's default (e.g. busy_timeout=5000).
-        const tuning: Record<string, number> = {};
-        for (const [env, opt] of [
-            ["PLURNK_SQLITE_TIMEOUT", "timeout"],
-            ["PLURNK_SQLITE_CACHE_SIZE", "cacheSize"],
-            ["PLURNK_SQLITE_MMAP_SIZE", "mmapSize"],
-            ["PLURNK_SQLITE_MAX_PAGE_COUNT", "maxPageCount"],
-        ] as const) {
-            const v = Cli.#sqliteKnob(env);
-            if (v !== undefined) tuning[opt] = v;
-        }
-        const db = await SqlRite.open({
-            path: dbPath,
-            dir: [resolve(Cli.#projectRoot, "migrations"), resolve(Cli.#projectRoot, "src")],
-            functions: [resolve(Cli.#projectRoot, "src/schemes/cosine.ts")],
-            ...tuning,
-        });
-        return db as unknown as Db;
-    }
-
-    static async #migrate(): Promise<void> {
-        const dbPath = Cli.#requireEnv("PLURNK_DB_PATH");
-        const db = await Cli.#openDb(dbPath);
-        try { process.stdout.write(`migrated: ${dbPath}\n`); }
-        finally { await db.close(); }
-    }
-
-    static async #start(): Promise<void> {
-        const dbPath = Cli.#requireEnv("PLURNK_DB_PATH");
-        const host = Cli.#requireEnv("PLURNK_HOST");
-        const port = Number(Cli.#requireEnv("PLURNK_PORT"));
-
-        const db = await Cli.#openDb(dbPath);
-        const alias = resolveActiveAlias();
-        const provider = alias === null ? null : await ProviderInstantiate.loadActiveProvider();
-        const daemon = new Daemon({ db, provider });
-        const addr = await daemon.start({ host, port });
-        const aliasStr = alias === null ? "no model" : `${alias.alias}=${alias.provider}/${alias.model}`;
-        process.stdout.write(`plurnk-service ws://${addr.host}:${addr.port} db=${dbPath} ${aliasStr}\n`);
-
-        const shutdown = async (): Promise<void> => { await daemon.stop(); await db.close(); process.exit(0); };
-        process.on("SIGINT", shutdown);
-        process.on("SIGTERM", shutdown);
-    }
-
-    static async main(): Promise<void> {
-        // Env cascade, highest precedence loads FIRST (loadEnvFile is set-if-unset,
-        // first write wins): --env-file(s) < --config < .env < .env.example, all of them
-        // OUTRANKED by pre-set shell env, then by the --<knob> CLI flags (assigned last,
-        // below). So --env-file overrides the .env files but never a shell var or a CLI
-        // arg — node-idiomatic layering.
-        for (const { path: envFile, required } of Cli.#envFileArgs()) Cli.#loadEnv(envFile, required);
-
-        const configFlagIndex = process.argv.findIndex((a) => a === "--config" || a.startsWith("--config="));
-        const configFile = ((): string | null => {
-            if (configFlagIndex === -1) return null;
-            const arg = process.argv[configFlagIndex];
-            if (arg.includes("=")) return arg.slice(arg.indexOf("=") + 1);
-            return process.argv[configFlagIndex + 1] ?? null;
-        })();
-
-        if (configFile !== null) Cli.#loadEnv(configFile, true);
-        Cli.#loadEnv(".env", false);
-        Cli.#loadEnv(resolve(Cli.#projectRoot, ".env.example"), false);
-
-        const flagDescriptors = await EnvFlags.parseEnvExample(resolve(Cli.#projectRoot, ".env.example"));
-        const flagOptions: Record<string, { type: "string" }> = {};
-        for (const f of flagDescriptors) {
-            flagOptions[f.flagName.replace(/^--/, "")] = { type: "string" };
-        }
-
-        const usage = `usage: plurnk-service [options] [migrate]
-
-${EnvFlags.formatFlagsHelp(flagDescriptors)}
-
-  --env-file=<path>            layer env from <path> (repeatable; errors if missing)
-  --env-file-if-exists=<path>  layer env from <path> if present (repeatable)
-  --config=<path>              layer additional env from <path>
-  -h, --help                   show this help
-`;
-
-        const { positionals, values } = parseArgs({
-            allowPositionals: true,
-            strict: false,
-            options: { help: { type: "boolean", short: "h" }, config: { type: "string" }, ...flagOptions },
-        });
-
-        for (const f of flagDescriptors) {
-            const key = f.flagName.replace(/^--/, "");
-            const v = values[key];
-            if (typeof v === "string") process.env[f.envName] = v;
-        }
-
-        if (values.help) { process.stdout.write(usage); process.exit(0); }
-
-        const dispatch: Record<string, () => Promise<void>> = { migrate: Cli.#migrate, start: Cli.#start };
-        const subcommand = typeof positionals[0] === "string" ? positionals[0] : "start";
-        const handler = dispatch[subcommand];
-        if (handler === undefined) Cli.#die(64, `unknown subcommand: ${subcommand}\n\n${usage}`);
-        if (positionals.length > 1) Cli.#die(64, `unexpected arguments: ${positionals.slice(1).join(" ")}`);
-
-        try { await handler(); }
-        catch (cause) {
-            process.stderr.write(`${subcommand}: ${cause instanceof Error ? cause.message : String(cause)}\n`);
-            if (cause instanceof Error && cause.cause) process.stderr.write(`  cause: ${cause.cause instanceof Error ? cause.cause.message : String(cause.cause)}\n`);
-            process.exit(1);
-        }
-    }
-}
-
-await Cli.main();

package/dist/core/ProviderRegistry.d.ts

@@ -1,42 +0,0 @@
-interface ChatMessage {
-    role: "system" | "user" | "assistant";
-    content: string;
-}
-export interface ProviderUsage {
-    readonly prompt: number;
-    readonly completion: number;
-    readonly cached: number;
-    readonly total: number;
-}
-export interface ProviderAssistant {
-    readonly content: string;
-    readonly reasoning: string | null;
-    readonly usage: ProviderUsage;
-    readonly finishReason: string | null;
-    readonly model: string;
-}
-export interface ProviderResponse {
-    readonly assistant: ProviderAssistant;
-    readonly assistantRaw: unknown;
-}
-export interface Provider {
-    generate(args: {
-        messages: ChatMessage[];
-        signal?: AbortSignal;
-    }): Promise<ProviderResponse>;
-    readonly contextSize: number | null;
-    readonly model: string;
-    countTokens(text: string): number;
-    costFor(usage: ProviderUsage): number;
-}
-export interface ProviderAlias {
-    readonly alias: string;
-    readonly provider: string;
-    readonly model: string;
-}
-export declare const parseAliasesFromEnv: (env?: NodeJS.ProcessEnv) => ProviderAlias[];
-export declare const resolveActiveAlias: (env?: NodeJS.ProcessEnv) => ProviderAlias | null;
-export declare const instantiateProvider: (alias: ProviderAlias, env?: NodeJS.ProcessEnv) => Promise<Provider>;
-export declare const loadActiveProvider: (env?: NodeJS.ProcessEnv) => Promise<Provider | null>;
-export {};
-//# sourceMappingURL=ProviderRegistry.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ProviderRegistry.d.ts","sourceRoot":"","sources":["../../src/core/ProviderRegistry.ts"],"names":[],"mappings":"AAWA,UAAU,WAAW;IAAG,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AAYhF,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B;AACD,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B;AACD,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAClC;AACD,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAK7F,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAMvB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAKlC,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAAC;CACzC;AAED,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,mBAAmB,GAAI,MAAK,MAAM,CAAC,UAAwB,KAAG,aAAa,EAgBvF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,MAAK,MAAM,CAAC,UAAwB,KAAG,aAAa,GAAG,IAKzF,CAAC;AAcF,eAAO,MAAM,mBAAmB,GAAU,OAAO,aAAa,EAAE,MAAK,MAAM,CAAC,UAAwB,KAAG,OAAO,CAAC,QAAQ,CAmBtH,CAAC;AAIF,eAAO,MAAM,kBAAkB,GAAU,MAAK,MAAM,CAAC,UAAwB,KAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAItG,CAAC"}

package/dist/core/ProviderRegistry.js

@@ -1,72 +0,0 @@
-// Model alias resolution. Reads PLURNK_MODEL_<alias>=<provider>/<model> env
-// vars; PLURNK_MODEL=<alias> selects which to use at boot. Each alias maps
-// to a provider plugin (`@plurnk/plurnk-providers-<provider>`); the registry
-// imports the matching package and constructs it with provider-specific
-// env conventions.
-//
-// Rummy parallel: RUMMY_MODEL_<alias>="<provider>/<model>" cascade. The
-// first path segment selects the provider plugin; the rest is the
-// provider's own identifier (may contain "/" for tri-level providers like
-// openrouter's publisher/model).
-var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
-    if (typeof path === "string" && /^\.\.?\//.test(path)) {
-        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
-            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
-        });
-    }
-    return path;
-};
-export const parseAliasesFromEnv = (env = process.env) => {
-    const out = [];
-    for (const [key, value] of Object.entries(env)) {
-        if (value === undefined || value.length === 0)
-            continue;
-        if (!key.startsWith("PLURNK_MODEL_"))
-            continue;
-        const aliasRaw = key.slice("PLURNK_MODEL_".length);
-        if (aliasRaw.length === 0)
-            continue;
-        const slash = value.indexOf("/");
-        if (slash <= 0)
-            continue;
-        out.push({
-            alias: aliasRaw.toLowerCase(),
-            provider: value.slice(0, slash),
-            model: value.slice(slash + 1),
-        });
-    }
-    return out;
-};
-export const resolveActiveAlias = (env = process.env) => {
-    const selected = env.PLURNK_MODEL;
-    if (selected === undefined || selected.length === 0)
-        return null;
-    const aliases = parseAliasesFromEnv(env);
-    return aliases.find((a) => a.alias === selected.toLowerCase()) ?? null;
-};
-export const instantiateProvider = async (alias, env = process.env) => {
-    const packageName = `@plurnk/plurnk-providers-${alias.provider}`;
-    let mod;
-    try {
-        mod = await import(__rewriteRelativeImportExtension(packageName));
-    }
-    catch (cause) {
-        throw new Error(`provider package ${packageName} not installed (alias '${alias.alias}' requires it): ` +
-            (cause instanceof Error ? cause.message : String(cause)));
-    }
-    const factory = mod.default;
-    if (typeof factory?.fromEnv !== "function") {
-        throw new Error(`${packageName}: default export must have a static \`fromEnv(env, model)\` factory ` +
-            `(plurnk-providers#1)`);
-    }
-    return await factory.fromEnv(env, alias.model);
-};
-// Convenience: resolve + instantiate in one call. Returns null when no
-// PLURNK_MODEL is set (caller decides what 'no provider' means).
-export const loadActiveProvider = async (env = process.env) => {
-    const alias = resolveActiveAlias(env);
-    if (alias === null)
-        return null;
-    return instantiateProvider(alias, env);
-};
-//# sourceMappingURL=ProviderRegistry.js.map

package/dist/core/ProviderRegistry.js.map

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

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

@@ -1,23 +0,0 @@
-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/core/line-marker.d.ts.map

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

@@ -1,321 +0,0 @@
-// `<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