@plurnk/plurnk-service 1.0.0

package/dist/core/ExecutorRegistry.d.ts

@@ -0,0 +1,45 @@
+import type { ChannelDecl, ExecArgs, ExecResult, Effect, RuntimeAvailability } from "@plurnk/plurnk-execs";
+import type { SchemeManifest } from "./types.ts";
+export interface Executor {
+    readonly runtime: string;
+    readonly glyph: string;
+    get manifest(): SchemeManifest;
+    get defaultChannel(): string;
+    get channels(): Readonly<Record<string, ChannelDecl>>;
+    run(args: ExecArgs): Promise<ExecResult>;
+    probe(signal?: AbortSignal): Promise<RuntimeAvailability>;
+    effect(target: string | null, command?: string): Effect;
+}
+export interface RegistryEntry {
+    readonly executor: Executor;
+    readonly glyph: string;
+    readonly example: string;
+    readonly documentation: string;
+    readonly available: boolean;
+    readonly detail: string | undefined;
+}
+export default class ExecutorRegistry {
+    #private;
+    constructor(byTag: ReadonlyMap<string, RegistryEntry>, attributions?: readonly string[]);
+    register(tag: string, entry: RegistryEntry): void;
+    attributions(): string[];
+    static build({ defaultRuntime, probeTimeoutMs, cwd, discoverFn, load }?: {
+        defaultRuntime?: string | null;
+        probeTimeoutMs?: number;
+        cwd?: string;
+        discoverFn?: () => Promise<{
+            registry: ReadonlyMap<string, {
+                runtime: string;
+                glyph: string;
+                example?: string;
+                documentation?: string;
+                packageName: string;
+            }>;
+            skipped?: string[];
+        }>;
+        load?: (name: string) => Promise<unknown>;
+    }): Promise<ExecutorRegistry>;
+    entry(tag: string): RegistryEntry | undefined;
+    availableRuntimes(): readonly string[];
+}
+//# sourceMappingURL=ExecutorRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutorRegistry.d.ts","sourceRoot":"","sources":["../../src/core/ExecutorRegistry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,mBAAmB,EAAoB,MAAM,sBAAsB,CAAC;AAE7H,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,IAAI,QAAQ,IAAI,cAAc,CAAC;IAC/B,IAAI,cAAc,IAAI,MAAM,CAAC;IAC7B,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IACtD,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAGzC,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAI1D,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3D;AAED,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAGvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAGzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAWD,MAAM,CAAC,OAAO,OAAO,gBAAgB;;IAIjC,YAAY,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,YAAY,GAAE,SAAS,MAAM,EAAO,EAG1F;IAQD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAGhD;IAID,YAAY,IAAI,MAAM,EAAE,CAAoC;IAE5D,OAAa,KAAK,CAAC,EAAE,cAAqB,EAAE,cAAqB,EAAE,GAAG,EAAE,UAAU,EAAE,IAAuD,EAAE,GAAE;QAC3I,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;YAAE,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAC;gBAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAAC,aAAa,CAAC,EAAE,MAAM,CAAC;gBAAC,WAAW,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAC;QACrL,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KACxC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4CjC;IAiCD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAE5C;IAKD,iBAAiB,IAAI,SAAS,MAAM,EAAE,CAIrC;CACJ"}

package/dist/core/ExecutorRegistry.js

@@ -0,0 +1,128 @@
+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;
+};
+import { discover } from "@plurnk/plurnk-execs";
+import PluginAttribution from "./plugin-attribution.js";
+// Boot-time runtime registry. Discovers installed @plurnk/plurnk-execs-*
+// siblings (plurnk.kind:"exec") and probes each runtime TAG independently —
+// one executor instance per tag (this.runtime = the tag), so a multi-tag
+// package (-common: sh/perl/ruby/…; -git: git/gh) lights up only the tags the
+// host actually has, instead of stamping all of them with the first tag's
+// probe. Probes are cheap + local (command -v / env read / `gh auth status`),
+// so per-tag costs nothing. A probe that rejects or exceeds its timeout
+// degrades that tag to unavailable — it never crashes boot. SPEC §scheme;
+// plurnk-service#181, #185.
+export default class ExecutorRegistry {
+    #byTag; // own copy — runtime-registration (#289) mutates it in place
+    #attributions; // #249 — declared attribution tags of discovered exec packages
+    constructor(byTag, attributions = []) {
+        this.#byTag = new Map(byTag);
+        this.#attributions = attributions;
+    }
+    // Runtime registration (#289) — add an executor TAG after boot (the /mcp hotload: an MCP server
+    // becomes an EXEC[<server>] runtime once connected). The boot path is discover→probe→build; this
+    // is the post-boot door for a runtime the operator installs live. The caller owns availability
+    // (a hotloaded MCP server is connected, hence available); the SchemeRegistry face is registered
+    // separately (registerRuntimeScheme), keeping the reserved/cross-family arbitration one-owned there.
+    // Fail-hard on a tag already registered — one name, one owner (mirrors #240 boot policy).
+    register(tag, entry) {
+        if (this.#byTag.has(tag))
+            throw new Error(`executor tag '${tag}' is already registered — one name, one owner (#289)`);
+        this.#byTag.set(tag, entry);
+    }
+    // #249 — declared attribution tags of the discovered exec packages (opaque; the engine
+    // unions these across plugin families onto the generate() `attributions` wire).
+    attributions() { return [...this.#attributions]; }
+    static async build({ defaultRuntime = null, probeTimeoutMs = 3000, cwd, discoverFn, load = (name) => import(__rewriteRelativeImportExtension(name)) } = {}) {
+        const { registry: discovered, skipped = [] } = await (discoverFn ?? (() => discover({ cwd })))();
+        // #229 trust gate: discover() skips untrusted third-party packages
+        // (PLURNK_PLUGINS_TRUSTED_ONLY) and reports them here — note each, mirror
+        // of SchemeRegistry's untrusted-scheme warning. Discovered, not loaded.
+        for (const name of skipped) {
+            console.warn(`exec discovery: '${name}' is discovered but untrusted (PLURNK_PLUGINS_TRUSTED_ONLY); not registered`);
+        }
+        // #259 — git lockout. PLURNK_SERVICE_GIT_ALLOWED=0 must drop the git/gh executors ENTIRELY (not
+        // just membership + telemetry): a denied host neither dispatches EXEC[git]/[gh] nor teaches
+        // them (the tools sheet reads the registered set). "No git" then training on git is a break.
+        const gitDenied = process.env.PLURNK_SERVICE_GIT_ALLOWED !== "1";
+        const infos = [...discovered.values()].filter((info) => !(gitDenied && info.packageName === "@plurnk/plurnk-execs-git"));
+        // Probe per-TAG: one executor instance per tag (this.runtime = the tag),
+        // each probed on its own merits. import() is module-cached, so
+        // re-importing a package once per tag is free.
+        const probed = await Promise.all(infos.map(async (info) => {
+            const mod = await load(info.packageName);
+            const executor = new mod.default({ runtime: info.runtime, glyph: info.glyph });
+            const availability = await ExecutorRegistry.#probe(executor, probeTimeoutMs);
+            return { info, executor, availability };
+        }));
+        const byTag = new Map();
+        for (const { info, executor, availability } of probed) {
+            byTag.set(info.runtime, {
+                executor,
+                glyph: info.glyph,
+                example: info.example ?? "",
+                documentation: info.documentation ?? "",
+                available: availability.available,
+                detail: availability.detail,
+            });
+        }
+        ExecutorRegistry.#assertDefaultUsable(byTag, defaultRuntime);
+        // #249 — collect attribution per DISTINCT package (a multi-tag package — -common's
+        // sh/perl/ruby — shares one manifest); fail-hard if any claims the reserved @plurnk/.
+        const packages = new Set(infos.map((info) => info.packageName));
+        const attributions = [...packages].flatMap((pkg) => PluginAttribution.read(pkg));
+        return new ExecutorRegistry(byTag, attributions);
+    }
+    // A configured default runtime that can't run is an operator misconfig the
+    // boot must surface, not hide behind a silent fallback.
+    static #assertDefaultUsable(byTag, defaultRuntime) {
+        if (defaultRuntime === null)
+            return;
+        const entry = byTag.get(defaultRuntime);
+        if (entry === undefined)
+            throw new Error(`exec default runtime '${defaultRuntime}' has no installed executor`);
+        if (!entry.available) {
+            const why = entry.detail === undefined ? "" : `: ${entry.detail}`;
+            throw new Error(`exec default runtime '${defaultRuntime}' is unavailable${why}`);
+        }
+    }
+    // probe() may reject or hang; bound it and treat either as unavailable.
+    static async #probe(executor, timeoutMs) {
+        const controller = new AbortController();
+        const timeout = new Promise((_, reject) => {
+            const timer = setTimeout(() => reject(new Error(`probe exceeded ${timeoutMs}ms`)), timeoutMs);
+            timer.unref();
+            controller.signal.addEventListener("abort", () => clearTimeout(timer), { once: true });
+        });
+        try {
+            // Hand the probe our abort signal — the finally reaps its child on resolve OR timeout,
+            // so a slow --version write can't EPIPE after the host tears down (execs#16).
+            return await Promise.race([executor.probe(controller.signal), timeout]);
+        }
+        catch (error) {
+            return { available: false, detail: error instanceof Error ? error.message : String(error) };
+        }
+        finally {
+            controller.abort();
+        }
+    }
+    entry(tag) {
+        return this.#byTag.get(tag);
+    }
+    // The actionable set offered to the model — available tags only. Unavailable
+    // or unknown tags are omitted; they surface their `detail` on the 501 if the
+    // model attempts one anyway.
+    availableRuntimes() {
+        const tags = [];
+        for (const [tag, entry] of this.#byTag)
+            if (entry.available)
+                tags.push(tag);
+        return tags.toSorted((left, right) => left.localeCompare(right));
+    }
+}
+//# sourceMappingURL=ExecutorRegistry.js.map

package/dist/core/ExecutorRegistry.js.map

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

package/dist/core/PacketBuilder.d.ts

@@ -0,0 +1,67 @@
+import type { PlurnkStatement } from "@plurnk/plurnk-grammar";
+import type { Db } from "./Db.ts";
+import type SchemeRegistry from "./SchemeRegistry.ts";
+import type ExecutorRegistry from "./ExecutorRegistry.ts";
+import type TelemetryChannel from "./TelemetryChannel.ts";
+import type { GitStatus } from "./git-state.ts";
+import { type PacketSection } from "./packet-wire.ts";
+import type { Provider } from "@plurnk/plurnk-providers";
+export type ChatMessage = {
+    role: "system" | "user" | "assistant";
+    content: string;
+};
+export type PacketAssistant = {
+    content: string;
+    ops: PlurnkStatement[];
+    reasoning: string | null;
+};
+export type RequestPacket = {
+    tokens: number;
+    sections: PacketSection[];
+    telemetryErrors: object[];
+};
+export default class PacketBuilder {
+    #private;
+    constructor({ db, schemes, telemetry, executors }: {
+        db: Db;
+        schemes: SchemeRegistry;
+        telemetry: TelemetryChannel;
+        executors: () => ExecutorRegistry | undefined;
+    });
+    decodeBudget(provider: Provider): number;
+    promptBudgetFor(provider: Provider): number;
+    ceilingFor(provider: Provider, tokenRatio?: number): number;
+    buildRequestPacket({ initialMessages, requirements, sessionId, runId, loopId, currentTurnSeq, provider, gitStatus, tokenRatio, telemetryErrors: presetTelemetry, }: {
+        tokenRatio?: number;
+        initialMessages: ChatMessage[];
+        requirements: string;
+        gitStatus: GitStatus | null;
+        sessionId: number;
+        runId: number;
+        loopId: number;
+        currentTurnSeq: number;
+        provider: Provider;
+        telemetryErrors?: object[];
+    }): Promise<RequestPacket>;
+    docEntries(sessionId: number): Promise<Array<{
+        name: string;
+        content: string;
+    }>>;
+    enforceBudget({ packet, provider, runId, loopId, turnId, mintSequence, tokenRatio, rebuild }: {
+        packet: RequestPacket;
+        provider: Provider;
+        runId: number;
+        loopId: number;
+        turnId: number;
+        mintSequence: number;
+        tokenRatio?: number;
+        rebuild: () => Promise<RequestPacket>;
+    }): Promise<{
+        packet: RequestPacket;
+        fit: boolean;
+        struck: boolean;
+    }>;
+    completePacket(requestPacket: RequestPacket, assistant: PacketAssistant, assistantRaw: unknown, provider: Provider): object;
+    buildTelemetryErrors(loopId: number, currentTurnSeq: number): Promise<object[]>;
+}
+//# sourceMappingURL=PacketBuilder.d.ts.map

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

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