@plurnk/plurnk-service 1.7.0 → 1.9.0

package/dist/core/ToolResources.d.ts

@@ -0,0 +1,19 @@
+import type { RuntimeInvocationDecl, RuntimeToolRegistry } from "@plurnk/plurnk-execs";
+export interface ToolResource {
+    readonly pathname: string;
+    readonly content: string;
+}
+interface ToolSource {
+    readonly runtime: string;
+    readonly summary: string;
+    readonly invocation: RuntimeInvocationDecl;
+    readonly details: string;
+    readonly registry: RuntimeToolRegistry | null;
+    readonly resourcesPath?: string;
+}
+export default class ToolResources {
+    static targetSegment(target: string): string;
+    static render(source: ToolSource): ToolResource[];
+}
+export {};
+//# sourceMappingURL=ToolResources.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ToolResources.d.ts","sourceRoot":"","sources":["../../src/core/ToolResources.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACR,qBAAqB,EACrB,mBAAmB,EACtB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B;AAED,UAAU,UAAU;IAChB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAK9C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACnC;AAgHD,MAAM,CAAC,OAAO,OAAO,aAAa;IAC9B,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAG3C;IAED,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,YAAY,EAAE,CAsDhD;CACJ"}

package/dist/core/ToolResources.js

@@ -0,0 +1,123 @@
+import { PathSyntax } from "@plurnk/plurnk-contracts";
+import { generatedPathname } from "./plurnk-uri.js";
+const inlineCode = (value) => {
+    const longest = Math.max(0, ...[...value.matchAll(/`+/gu)].map((match) => match[0].length));
+    const fence = "`".repeat(longest + 1);
+    const padding = value.startsWith("`") || value.endsWith("`") ? " " : "";
+    return `${fence}${padding}${value}${padding}${fence}`;
+};
+const fence = (language, value) => {
+    const longest = Math.max(2, ...[...value.matchAll(/`+/gu)].map((match) => match[0].length));
+    const marker = "`".repeat(longest + 1);
+    return `${marker}${language}\n${value}\n${marker}`;
+};
+const escapeCell = (value) => value.replaceAll("|", "\\|");
+const summaryParagraph = (value) => /^(?:[>#+*`~-]|\d+[.)]\s|<)/u.test(value) && !value.startsWith("`")
+    ? `\\${value}`
+    : value;
+const annotationText = (value) => {
+    const normalized = value.replaceAll(/\s+/gu, " ").trim().replaceAll("--", "—");
+    const safeStart = /^(?:>|->)/u.test(normalized) ? `Description: ${normalized}` : normalized;
+    return safeStart.endsWith("-") ? `${safeStart}.` : safeStart;
+};
+const requirement = (required) => required ? "required" : "optional";
+const invocationRows = (invocation, exactTarget) => {
+    const exclusive = invocation.exclusive === true ? "; choose either target or body" : "";
+    const target = invocation.target === undefined
+        ? "unavailable"
+        : exactTarget === undefined
+            ? `${requirement(invocation.target.required)}: ${invocation.target.role}`
+                + (invocation.target.directory === "cwd" ? "; a local directory selects the working directory" : "")
+                + exclusive
+            : `${requirement(invocation.target.required)}: exact target ${inlineCode(exactTarget)}; ${invocation.target.role}${exclusive}`;
+    const body = `${requirement(invocation.body.required)}: ${invocation.body.role}${exclusive}`;
+    return [
+        "| Input | Contract |",
+        "| --- | --- |",
+        `| \`(target)\` | ${escapeCell(target)} |`,
+        `| body | ${escapeCell(body)} |`,
+    ];
+};
+const exampleSource = (runtime, invocation, exactTarget, annotation) => {
+    const target = exactTarget ?? invocation.example?.target;
+    const heading = `## EXEC0 [${runtime}]${target === undefined ? "" : ` (${PathSyntax.escapeTarget(target)})`}`
+        + (annotation === undefined ? "" : ` <!-- ${annotationText(annotation)} -->`);
+    return invocation.example?.body === undefined
+        ? heading
+        : `${heading}\n${invocation.example.body}`;
+};
+const summaryInvocation = (runtime, invocation, exactTarget, summary) => {
+    const source = exampleSource(runtime, invocation, exactTarget, summary)
+        .replace(/^## EXEC0/u, "EXEC")
+        .replace("\n", "\\n");
+    return inlineCode(source);
+};
+const renderInvocation = (runtime, invocation, exactTarget, annotation) => [
+    "## Invocation",
+    "",
+    ...invocationRows(invocation, exactTarget),
+    "",
+    ...(invocation.signature === undefined
+        ? [fence("plurnk", exampleSource(runtime, invocation, exactTarget, annotation))]
+        : [
+            inlineCode(exampleSource(runtime, invocation, exactTarget, annotation)),
+            "",
+            `Signature: ${inlineCode(invocation.signature)}`,
+        ]),
+];
+const renderDocument = (title, summary, invocation, details) => [
+    `# ${title}`,
+    "",
+    "## Summary",
+    "",
+    summaryParagraph(summary),
+    "",
+    ...invocation,
+    ...(details.length === 0 ? [] : ["", details.trimEnd()]),
+].join("\n");
+export default class ToolResources {
+    static targetSegment(target) {
+        return encodeURIComponent(target).replaceAll(/[!'()*]/gu, (character) => `%${character.codePointAt(0)?.toString(16).toUpperCase()}`);
+    }
+    static render(source) {
+        const toolsNamespace = source.resourcesPath !== undefined;
+        // A runtime's resourcesPath is relative to the generated root; Core owns the root.
+        const root = generatedPathname(toolsNamespace ? source.resourcesPath : "/skills/plurnk");
+        if (source.registry === null) {
+            return [{
+                    pathname: `${root}/${source.runtime}.md`,
+                    content: renderDocument(source.runtime, summaryInvocation(source.runtime, source.invocation, undefined, source.summary), renderInvocation(source.runtime, source.invocation, undefined, source.summary), source.details),
+                }];
+        }
+        if (source.registry.tools.length === 0)
+            return [];
+        // One document per registried runtime — no per-target child documents,
+        // shown or existing. The invocation fence carries every target's
+        // heading and signature; a target's details become a section of this
+        // same document. One survey row orients the whole family; the packet
+        // token floor never pays per-tool.
+        const tools = source.registry.tools
+            .toSorted((left, right) => left.target.localeCompare(right.target));
+        const familyInvocations = tools.flatMap((tool, index) => {
+            const heading = exampleSource(source.runtime, tool.invocation, tool.target, tool.summary).split("\n", 1)[0];
+            const input = tool.invocation.signature ?? tool.invocation.example?.body;
+            return [
+                ...(index === 0 ? [] : [""]),
+                heading,
+                ...(input === undefined ? [] : [input]),
+            ];
+        });
+        // A target's details nest as `## <target>`; their own headings demote
+        // one level so the target heading stays the section boundary.
+        const demote = (value) => value.replaceAll(/^(#{2,5}) /gmu, "#$1 ");
+        const sections = tools
+            .filter((tool) => (tool.details ?? "").length > 0)
+            .map((tool) => `## ${inlineCode(tool.target)}\n\n${demote((tool.details ?? "").trimEnd())}`);
+        const detailsBlock = [source.details.trimEnd(), ...sections]
+            .filter((part) => part.length > 0)
+            .join("\n\n");
+        const family = renderDocument(source.runtime, source.summary, ["## Invocation", "", fence("plurnk", familyInvocations.join("\n"))], detailsBlock);
+        return [{ pathname: `${root}/${source.runtime}.md`, content: family }];
+    }
+}
+//# sourceMappingURL=ToolResources.js.map

package/dist/core/ToolResources.js.map

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

package/dist/core/Turn.d.ts

@@ -0,0 +1,27 @@
+import type { Db } from "./Db.ts";
+import type { WriterTier } from "./scheme-types.ts";
+export type TurnProducer = WriterTier;
+export type TurnKind = "inference" | "initialization" | "overflow" | "operation" | "maintenance";
+export interface TurnRow {
+    readonly id: number;
+    readonly sequence: number;
+}
+export interface InferenceEvidence {
+    readonly packet: string;
+    readonly usageCurationBudget: number | null;
+    readonly finishReason: string | null;
+    readonly model: string;
+    readonly meta: string;
+}
+export default class Turn {
+    static open(db: Db, args: {
+        loopId: number;
+        producer: TurnProducer;
+        kind: TurnKind;
+    }): Promise<TurnRow>;
+    static becomeOverflow(db: Db, id: number): Promise<void>;
+    static recordInference(db: Db, id: number, evidence: InferenceEvidence): Promise<void>;
+    static complete(db: Db, id: number, status: number): Promise<void>;
+    static failOpen(db: Db, id: number): Promise<boolean>;
+}
+//# sourceMappingURL=Turn.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Turn.d.ts","sourceRoot":"","sources":["../../src/core/Turn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC;AACtC,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,gBAAgB,GAAG,UAAU,GAAG,WAAW,GAAG,aAAa,CAAC;AAEjG,MAAM,WAAW,OAAO;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAKD,MAAM,CAAC,OAAO,OAAO,IAAI;IACrB,OAAa,IAAI,CACb,EAAE,EAAE,EAAE,EACN,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,GACjE,OAAO,CAAC,OAAO,CAAC,CAQlB;IAED,OAAa,cAAc,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK7D;IAED,OAAa,eAAe,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAY3F;IAED,OAAa,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGvE;IAED,OAAa,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE1D;CACJ"}

package/dist/core/Turn.js

@@ -0,0 +1,43 @@
+// {§turn-record} — one lifecycle owner for every producer. A packet and its
+// provider metadata are optional inference evidence, never the definition of a
+// turn. Client, plugin, model, and `_plurnk` work all open and complete here.
+export default class Turn {
+    static async open(db, args) {
+        const turn = await db.turn_open.get({
+            loop_id: args.loopId,
+            producer: args.producer,
+            kind: args.kind,
+        });
+        if (turn === undefined)
+            throw new Error("Turn.open: insert returned no row");
+        return turn;
+    }
+    static async becomeOverflow(db, id) {
+        const turn = await db.turn_become_overflow.get({ id });
+        if (turn === undefined) {
+            throw new Error(`Turn.becomeOverflow: model inference turn ${id} cannot become overflow`);
+        }
+    }
+    static async recordInference(db, id, evidence) {
+        const turn = await db.turn_record_inference.get({
+            id,
+            packet: evidence.packet,
+            usage_curation_budget: evidence.usageCurationBudget,
+            finish_reason: evidence.finishReason,
+            model: evidence.model,
+            meta: evidence.meta,
+        });
+        if (turn === undefined) {
+            throw new Error(`Turn.recordInference: turn ${id} is not an open model inference turn`);
+        }
+    }
+    static async complete(db, id, status) {
+        const turn = await db.turn_complete.get({ id, status });
+        if (turn === undefined)
+            throw new Error(`Turn.complete: turn ${id} is not open`);
+    }
+    static async failOpen(db, id) {
+        return (await db.turn_fail_open.get({ id })) !== undefined;
+    }
+}
+//# sourceMappingURL=Turn.js.map

package/dist/core/Turn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Turn.js","sourceRoot":"","sources":["../../src/core/Turn.ts"],"names":[],"mappings":"AAmBA,4EAA4E;AAC5E,+EAA+E;AAC/E,8EAA8E;AAC9E,MAAM,CAAC,OAAO,OAAO,IAAI;IACrB,MAAM,CAAC,KAAK,CAAC,IAAI,CACb,EAAM,EACN,IAAgE;QAEhE,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,CAAU;YACzC,OAAO,EAAE,IAAI,CAAC,MAAM;YACpB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI;SAClB,CAAC,CAAC;QACH,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAC7E,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,EAAM,EAAE,EAAU;QAC1C,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAiB,EAAE,EAAE,EAAE,CAAC,CAAC;QACvE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,6CAA6C,EAAE,yBAAyB,CAAC,CAAC;QAC9F,CAAC;IACL,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,EAAM,EAAE,EAAU,EAAE,QAA2B;QACxE,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,qBAAqB,CAAC,GAAG,CAAiB;YAC5D,EAAE;YACF,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,qBAAqB,EAAE,QAAQ,CAAC,mBAAmB;YACnD,aAAa,EAAE,QAAQ,CAAC,YAAY;YACpC,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,IAAI,EAAE,QAAQ,CAAC,IAAI;SACtB,CAAC,CAAC;QACH,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,8BAA8B,EAAE,sCAAsC,CAAC,CAAC;QAC5F,CAAC;IACL,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAM,EAAE,EAAU,EAAE,MAAc;QACpD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,aAAa,CAAC,GAAG,CAAiB,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACxE,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,EAAE,cAAc,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAM,EAAE,EAAU;QACpC,OAAO,CAAC,MAAM,EAAE,CAAC,cAAc,CAAC,GAAG,CAAiB,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC;IAC/E,CAAC;CACJ"}

package/dist/core/Turn.sql

@@ -0,0 +1,72 @@
+-- Producer-neutral turn lifecycle. A turn is an ordered durable operation
+-- container; model request/response evidence is an optional specialization.
+
+-- PREP: turn_open
+INSERT INTO turns (loop_id, sequence, producer, kind, status, completed_at)
+SELECT $loop_id,
+       COALESCE(MAX(sequence), 0) + 1,
+       $producer,
+       $kind,
+       102,
+       NULL
+FROM turns
+WHERE loop_id = $loop_id
+RETURNING id, sequence;
+
+-- PREP: turn_become_overflow
+-- Packet admission may divert a would-be inference boundary into a kernel
+-- recovery turn. Once model-authored rows, model calls, or packet evidence
+-- exist, changing the producer would falsify history and is refused.
+UPDATE turns
+SET producer = '_plurnk',
+    kind = 'overflow'
+WHERE id = $id
+  AND producer = 'model'
+  AND kind = 'inference'
+  AND completed_at IS NULL
+  AND packet IS NULL
+  AND usage_curation_budget IS NULL
+  AND finish_reason IS NULL
+  AND model IS NULL
+  AND meta IS NULL
+  AND NOT EXISTS (SELECT 1 FROM model_calls WHERE turn_id = turns.id)
+  AND NOT EXISTS (
+      SELECT 1 FROM log_entries
+      WHERE turn_id = turns.id AND origin != '_plurnk'
+  )
+RETURNING id;
+
+-- PREP: turn_record_inference
+-- Preserve the exact admitted/request-only packet and provider metadata while
+-- the operation sequence is still executing. Completion remains a separate
+-- lifecycle transition after every admitted OP has settled.
+UPDATE turns
+SET packet = $packet,
+    usage_curation_budget = $usage_curation_budget,
+    finish_reason = $finish_reason,
+    model = $model,
+    meta = $meta
+WHERE id = $id
+  AND producer = 'model'
+  AND kind = 'inference'
+  AND completed_at IS NULL
+  AND packet IS NULL
+RETURNING id;
+
+-- PREP: turn_complete
+UPDATE turns
+SET status = $status,
+    completed_at = strftime('%Y-%m-%dT%H:%M:%fZ', 'now')
+WHERE id = $id
+  AND completed_at IS NULL
+RETURNING id;
+
+-- PREP: turn_fail_open
+-- Exception cleanup is idempotent across a run that may already have completed
+-- one of several producer turns before a later sibling failed.
+UPDATE turns
+SET status = 500,
+    completed_at = strftime('%Y-%m-%dT%H:%M:%fZ', 'now')
+WHERE id = $id
+  AND completed_at IS NULL
+RETURNING id;

package/dist/core/TurnOps.d.ts

@@ -0,0 +1,7 @@
+import { type PlurnkStatement } from "@plurnk/plurnk-contracts";
+export type InternalTurnStatement = PlurnkStatement;
+export default class TurnOps {
+    static renderInternal(statements: readonly InternalTurnStatement[]): string;
+    static parseInternal(source: string): PlurnkStatement[];
+}
+//# sourceMappingURL=TurnOps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TurnOps.d.ts","sourceRoot":"","sources":["../../src/core/TurnOps.ts"],"names":[],"mappings":"AAAA,OAAO,EAIH,KAAK,eAAe,EACvB,MAAM,0BAA0B,CAAC;AAElC,MAAM,MAAM,qBAAqB,GAAG,eAAe,CAAC;AAiBpD,MAAM,CAAC,OAAO,OAAO,OAAO;IACxB,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,SAAS,qBAAqB,EAAE,GAAG,MAAM,CAuB1E;IAED,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE,CAqBtD;CACJ"}

package/dist/core/TurnOps.js

@@ -0,0 +1,73 @@
+import { PlurnkParseError, PlurnkParser, PlanValue, } from "@plurnk/plurnk-contracts";
+const renderBody = (statement) => {
+    if (statement.op === "PLAN")
+        return PlanValue.stringify(statement.body);
+    if (statement.body === null)
+        return null;
+    if (typeof statement.body === "string")
+        return statement.body;
+    if ("raw" in statement.body)
+        return statement.body.raw;
+    const marker = statement.body.lineMarker;
+    return marker === null
+        ? statement.body.target.raw
+        : `${statement.body.target.raw} <${marker.marks.join(",")}>`;
+};
+// Core-authored turns are programs, not synthetic result rows. This formatter
+// owns the deliberately small statement alphabet used by initialization and
+// overflow recovery; its output is reparsed before admission so the parser,
+// rather than constructed AST objects, remains the executable authority.
+export default class TurnOps {
+    static renderInternal(statements) {
+        if (statements[0]?.op !== "PLAN" || statements.at(-1)?.op !== "SEND") {
+            throw new TypeError("An internal turnOps program must begin with PLAN and end with SEND.");
+        }
+        const delimiter = statements[0].delimiter || "0";
+        return statements.map((statement, index) => {
+            const heading = statement.op === "PLAN"
+                ? `# PLAN${delimiter}`
+                : `## ${statement.op}${delimiter}`;
+            const modifiers = [];
+            if (statement.signal !== null) {
+                modifiers.push(`[${Array.isArray(statement.signal) ? statement.signal.join(",") : statement.signal}]`);
+            }
+            if (statement.target !== null)
+                modifiers.push(`(${statement.target.raw})`);
+            if (statement.lineMarker !== null)
+                modifiers.push(`<${statement.lineMarker.marks.join(",")}>`);
+            if (statement.annotation !== null)
+                modifiers.push(`<!-- ${statement.annotation} -->`);
+            const header = modifiers.length === 0 ? heading : `${heading} ${modifiers.join(" ")}`;
+            const body = renderBody(statement);
+            const boundaryPadding = body?.endsWith("\n") === true && index < statements.length - 1
+                ? "\n"
+                : "";
+            return body === null ? header : `${header}\n${body}${boundaryPadding}`;
+        }).join("\n");
+    }
+    static parseInternal(source) {
+        const parsed = PlurnkParser.parse(source);
+        const statements = [];
+        const failures = [];
+        for (const item of parsed.items) {
+            if (item.kind === "statement") {
+                statements.push(item.statement);
+                continue;
+            }
+            if (item.kind === "text" && item.text.trim().length === 0)
+                continue;
+            const error = item.kind === "error" ? item.error : null;
+            failures.push(error instanceof PlurnkParseError ? error.message : "unparsed text");
+        }
+        if (parsed.unparsedTail !== undefined)
+            failures.push(parsed.unparsedTail.reason);
+        if (failures.length > 0) {
+            throw new SyntaxError(`Core generated invalid turnOps: ${failures.join("; ")}`);
+        }
+        if (statements[0]?.op !== "PLAN" || statements.at(-1)?.op !== "SEND") {
+            throw new SyntaxError("Core generated turnOps without a PLAN…SEND boundary.");
+        }
+        return statements;
+    }
+}
+//# sourceMappingURL=TurnOps.js.map

package/dist/core/TurnOps.js.map

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

package/dist/core/TurnRunner.d.ts

@@ -1,10 +1,19 @@
+import type { PlurnkStatement } from "@plurnk/plurnk-contracts";
+type ParseErrorInfo = {
+    message: string;
+    line: number;
+    column: number;
+    source: string;
+};
 import type SchemeRegistry from "./SchemeRegistry.ts";
 import { Mimetypes } from "@plurnk/plurnk-mimetypes";
 import type { Db } from "./Db.ts";
-import type { WriterTier, PlurnkSchemeContext } from "./scheme-types.ts";
+import type { PlurnkSchemeContext, WriterTier } from "./scheme-types.ts";
 import type ExecutorRegistry from "./ExecutorRegistry.ts";
 import type { StreamEventNotify, WakeWorkerNotify } from "./ChannelWrite.ts";
+import type { ReasoningEventNotify } from "./ReasoningEvent.ts";
 import LiveSubscriptions from "./LiveSubscriptions.ts";
+export declare const resolveGrammarRailPath: (variant: string) => string;
 import { type SchemeResult } from "./results.ts";
 import type ClientInteractions from "./ClientInteractions.ts";
 import NoticeChannel from "./NoticeChannel.ts";
@@ -13,8 +22,9 @@ import StrikeRail, { type StrikeOutcome } from "./StrikeRail.ts";
 import PacketBuilder, { type ChatMessage } from "./PacketBuilder.ts";
 import Dispatcher from "./Dispatcher.ts";
 import type { DispatchContext, DispatchResult } from "./Dispatcher.ts";
-import type { Provider } from "@plurnk/plurnk-providers";
+import type { Provider, ProviderEncryptedReasoningItem } from "@plurnk/plurnk-providers";
 type EngineTurnResult = {
+    createdTurnIds: number[];
     turnId: number;
     status: number;
     outcomes: StrikeOutcome[];
@@ -25,13 +35,34 @@ type EngineTurnResult = {
     emissionExhausted: boolean;
     rejectedModelEntryId?: number;
     capacityFailure?: SchemeResult;
+    curationFailure?: SchemeResult;
+} & ({
+    producer: "model";
+    kind: "inference";
+} | {
+    producer: "_plurnk";
+    kind: "overflow";
+});
+type BareExecution = {
+    readonly provider: Provider;
+    readonly modelCallSequenceStart: number;
+    readonly primaryWorkerId: string;
+    readonly loopSequence: number;
+    readonly turnSequence: number;
+    readonly signal: AbortSignal | undefined;
+};
+type AdmittedTurnResult = {
+    readonly status: number;
+    readonly outcomes: StrikeOutcome[];
+    readonly fingerprint: string;
+    readonly steerStruck: boolean;
 };
 export declare const LOOP_TIMEOUT_REASON = "loop_timeout";
 type TurnDispatch = (context: DispatchContext) => Promise<DispatchResult>;
 type WarmWorkspace = (context: PlurnkSchemeContext, invalidate?: boolean, materialize?: boolean) => Promise<void>;
 export default class TurnRunner {
     #private;
-    constructor({ db, schemes, mimetypes, weigh, notices, problems, strikes, packets, dispatcher, liveSubscriptions, streamEventNotify, wakeWorkerNotify, executors, loopSignal, interactions, warmWorkspace, dispatch, resolveWorkerProviderIdentity, }: {
+    constructor({ db, schemes, mimetypes, weigh, notices, problems, strikes, packets, dispatcher, liveSubscriptions, streamEventNotify, reasoningEventNotify, wakeWorkerNotify, executors, loopSignal, interactions, warmWorkspace, dispatch, resolveWorkerProviderIdentity, }: {
         db: Db;
         schemes: SchemeRegistry;
         mimetypes: Mimetypes;
@@ -43,6 +74,7 @@ export default class TurnRunner {
         dispatcher: Dispatcher;
         liveSubscriptions: LiveSubscriptions;
         streamEventNotify?: StreamEventNotify;
+        reasoningEventNotify?: ReasoningEventNotify;
         wakeWorkerNotify?: WakeWorkerNotify;
         executors: () => ExecutorRegistry | undefined;
         loopSignal: (loopId: number) => AbortSignal | undefined;
@@ -54,7 +86,27 @@ export default class TurnRunner {
             primaryWorkerId: string;
         }>;
     });
-    runTurn({ provider, childProvider, messages, requirements, workspaceId, workerId, loopId, origin, signal, onDispatch, turnNumber, maxTurns, invalidEmissionRecoveryEntryId, }: {
+    executeAdmittedTurn({ statements, source, sourceFolded, sourceModelCallId, sourceReasoningItems, origin, workspaceId, workerId, loopId, turnId, fromSequence, maxCommands, enforceIdle, failOnOperationError, recoverableParseErrors, bare, signal, onDispatch, }: {
+        statements: readonly PlurnkStatement[];
+        source: string | null;
+        sourceFolded: boolean;
+        sourceModelCallId?: number | null;
+        sourceReasoningItems?: ReadonlyArray<ProviderEncryptedReasoningItem>;
+        origin: WriterTier;
+        workspaceId: number;
+        workerId: number;
+        loopId: number;
+        turnId: number;
+        fromSequence: number;
+        maxCommands?: number;
+        enforceIdle?: boolean;
+        failOnOperationError?: boolean;
+        recoverableParseErrors?: readonly ParseErrorInfo[];
+        bare?: BareExecution;
+        signal?: AbortSignal;
+        onDispatch?: (logEntryId: number) => void;
+    }): Promise<AdmittedTurnResult>;
+    runTurn({ provider, childProvider, messages, requirements, workspaceId, workerId, loopId, signal, onDispatch, turnNumber, maxTurns, invalidEmissionRecoveryEntryId, }: {
         provider: Provider;
         childProvider?: Provider;
         messages: ChatMessage[];
@@ -62,7 +114,6 @@ export default class TurnRunner {
         workspaceId: number;
         workerId: number;
         loopId: number;
-        origin?: WriterTier;
         signal?: AbortSignal;
         onDispatch?: (logEntryId: number) => void;
         turnNumber?: number;

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

@@ -1 +1 @@
-{"version":3,"file":"TurnRunner.d.ts","sourceRoot":"","sources":["../../src/core/TurnRunner.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAMlC,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,KAAK,gBAAgB,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG7E,OAAO,iBAAiB,MAAM,wBAAwB,CAAC;AAQvD,OAAgB,EAAyB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAMjF,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAC;AAI9D,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAC/C,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,UAAU,EAAE,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,aAAa,EAAE,EAAE,KAAK,WAAW,EAAyB,MAAM,oBAAoB,CAAC;AAE5F,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AA6FvE,OAAO,KAAK,EAER,QAAQ,EAIX,MAAM,0BAA0B,CAAC;AAkDlC,KAAK,gBAAgB,GAAG;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,YAAY,CAAC;CAClC,CAAC;AAuCF,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAElD,KAAK,YAAY,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAC1E,KAAK,aAAa,GAAG,CACjB,OAAO,EAAE,mBAAmB,EAC5B,UAAU,CAAC,EAAE,OAAO,EACpB,WAAW,CAAC,EAAE,OAAO,KACpB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,CAAC,OAAO,OAAO,UAAU;;IAwB3B,YAAY,EACR,EAAE,EACF,OAAO,EACP,SAAS,EACT,KAAK,EACL,OAAO,EACP,QAAQ,EACR,OAAO,EACP,OAAO,EACP,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,6BAA6B,GAChC,EAAE;QACC,EAAE,EAAE,EAAE,CAAC;QACP,OAAO,EAAE,cAAc,CAAC;QACxB,SAAS,EAAE,SAAS,CAAC;QACrB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;QAChC,OAAO,EAAE,aAAa,CAAC;QACvB,QAAQ,EAAE,UAAU,CAAC;QACrB,OAAO,EAAE,UAAU,CAAC;QACpB,OAAO,EAAE,aAAa,CAAC;QACvB,UAAU,EAAE,UAAU,CAAC;QACvB,iBAAiB,EAAE,iBAAiB,CAAC;QACrC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;QACtC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;QACpC,SAAS,EAAE,MAAM,gBAAgB,GAAG,SAAS,CAAC;QAC9C,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,CAAC;QACxD,YAAY,EAAE,kBAAkB,CAAC;QACjC,aAAa,EAAE,aAAa,CAAC;QAC7B,QAAQ,EAAE,YAAY,CAAC;QACvB,6BAA6B,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;YACzD,QAAQ,EAAE,MAAM,CAAC;YACjB,eAAe,EAAE,MAAM,CAAC;SAC3B,CAAC,CAAC;KACN,EAmBA;IA2OK,OAAO,CAAC,EACV,QAAQ,EAAE,aAAwB,EAAE,QAAQ,EAAE,YAAiB,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAgB,EAAE,MAAM,EAAE,UAAU,EACpI,UAAc,EAAE,QAAa,EAAE,8BAA8B,GAChE,EAAE;QACC,QAAQ,EAAE,QAAQ,CAAC;QACnB,aAAa,CAAC,EAAE,QAAQ,CAAC;QACzB,QAAQ,EAAE,WAAW,EAAE,CAAC;QAExB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QACtD,MAAM,CAAC,EAAE,UAAU,CAAC;QACpB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;QAK1C,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAGlB,8BAA8B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAClD,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmgC5B;CAscJ"}
+{"version":3,"file":"TurnRunner.d.ts","sourceRoot":"","sources":["../../src/core/TurnRunner.ts"],"names":[],"mappings":"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"}