@plurnk/plurnk-contracts 1.4.0

package/dist/src/types.generated.d.ts

@@ -0,0 +1,450 @@
+export type ClientDisplayCapabilities = (SchemeDisplayCapability | MimetypeDisplayCapability)[];
+export interface SchemeDisplayCapability {
+    kind: "scheme";
+    scheme: string;
+    display: CapabilityDisplay;
+}
+export interface CapabilityDisplay {
+    glyph?: string;
+}
+export interface MimetypeDisplayCapability {
+    kind: "mimetype";
+    mimetype: string;
+    display: CapabilityDisplay;
+}
+export type ClientStatement = (PlurnkStatement | LookStatement | BuffStatement);
+/**
+ * The parsed AST union for one protocol statement, discriminated by `op`. Every variant has fixed signal, target, lineMarker, body, suffix, and source-position fields; operation-specific schemas constrain their types. A null field records an omitted tolerated slot and does not satisfy runtime requirements by itself.
+ */
+export type PlurnkStatement = (FindStatement | ReadStatement | OpenStatement | FoldStatement | EditStatement | CopyStatement | MoveStatement | SendStatement | ExecStatement | WorkStatement | ForkStatement | KillStatement | PlanStatement);
+/**
+ * A parsed target slot from a plurnk statement. Discriminated on `kind`: a bare local path or a WHATWG-decomposed URL. Targets carry an exact address or a path glob; content matching belongs in the statement body.
+ */
+export type ParsedPath = (LocalPath | UrlPath);
+/**
+ * Parsed body of a FIND/READ/OPEN/FOLD statement, discriminated on `dialect`. The dialect is determined by the body's leading characters (`//` xpath, `/` regex, `$` jsonpath, `~` semantic, `@` graph, else glob). The regex variant carries pattern and flags split out of the `/pattern/flags` literal; every variant remains JSON-serializable.
+ */
+export type MatcherBody = (XPathBody | RegexBody | JsonPathBody | SemanticBody | GraphBody | GlobBody);
+export type TagSignal = (string[] | null);
+export type PathOrNull = (ParsedPath | null);
+export type LineMarkerOrNull = (LineMarker | null);
+export type MatcherBodyOrNull = (MatcherBody | null);
+export interface FindStatement {
+    op: "FIND";
+    suffix: string;
+    signal: (string[] | null);
+    target: (ParsedPath | null);
+    lineMarker: (LineMarker | null);
+    body: (MatcherBody | null);
+    position: Position;
+}
+/**
+ * A bare local path with no `scheme://` prefix. The raw string is stored verbatim; resolution is the runtime's job.
+ */
+export interface LocalPath {
+    kind: "local";
+    raw: string;
+}
+/**
+ * A path with a `scheme://` prefix, fully decomposed via WHATWG URL.
+ */
+export interface UrlPath {
+    kind: "url";
+    raw: string;
+    scheme: string;
+    username: (string | null);
+    password: (string | null);
+    hostname: (string | null);
+    port: (number | null);
+    pathname: string;
+    /**
+     * Canonical serialized WHATWG query component without the leading `?`. Null means no query; the empty string means an explicit empty query (`?`). Ordering, duplicate names, and encoded spelling are preserved.
+     */
+    query: (string | null);
+    fragment: (string | null);
+    /**
+     * Trailing `{key: value}` request-metadata blocks removed before WHATWG decomposition and preserved as ordered pairs. Order and duplicate names survive; the addressed scheme owns their meaning. Absent when no block was supplied.
+     */
+    headers?: [string, string][];
+}
+/**
+ * The ordered numeric components parsed from a `<scope>` slot. AstBuilder converts each lexical number to a JavaScript number; the operation owner assigns arity and meaning, including text coordinates, result positions, timing, mutation anchors, and an optional leading semantic threshold.
+ */
+export interface LineMarker {
+    /**
+     * @minItems 1
+     */
+    marks: [number, ...(number)[]];
+}
+/**
+ * XPath 1.0 expression. Validated at parse time via the xpath library.
+ */
+export interface XPathBody {
+    dialect: "xpath";
+    raw: string;
+}
+/**
+ * ECMAScript regex literal `/pattern/flags`. Escape a literal delimiter as `\/`. Pattern and flags are split out for direct use. `raw` preserves the literal form for round-tripping.
+ */
+export interface RegexBody {
+    dialect: "regex";
+    raw: string;
+    pattern: string;
+    flags: string;
+}
+/**
+ * RFC 9535 JSONPath expression. Compiled at parse time with json-p3, the same engine used for runtime matching.
+ */
+export interface JsonPathBody {
+    dialect: "jsonpath";
+    raw: string;
+}
+/**
+ * Semantic similarity query. Body is `~phrase`: natural language after the tilde, with no parse step. Similarity thresholds and result ranges belong to the statement's scope; resolution happens service-side through the configured embedding implementation.
+ */
+export interface SemanticBody {
+    dialect: "semantic";
+    raw: string;
+}
+/**
+ * Code-graph reference query. Body is `@symbol` for a neighborhood, `@<symbol` for inbound references, or `@>symbol` for outbound references. Resolution happens service-side through the symbol index; no parse step occurs in the language parser.
+ */
+export interface GraphBody {
+    dialect: "graph";
+    raw: string;
+}
+/**
+ * Pattern with no dialect prefix; treated as a glob/literal match.
+ */
+export interface GlobBody {
+    dialect: "glob";
+    raw: string;
+}
+/**
+ * A source point in parsed PLURNK input. Lines are 1-based; columns are 0-based Unicode code points. LF and CRLF delimit lines, while a lone CR occupies one column. The exact pair {line: 0, column: 0} is the sole unknown/degraded position.
+ */
+export interface Position {
+    line: number;
+    column: number;
+}
+export interface ReadStatement {
+    op: "READ";
+    suffix: string;
+    signal: (string[] | null);
+    target: (ParsedPath | null);
+    lineMarker: (LineMarker | null);
+    body: (MatcherBody | null);
+    position: Position;
+}
+export interface OpenStatement {
+    op: "OPEN";
+    suffix: string;
+    signal: (string[] | null);
+    target: (ParsedPath | null);
+    lineMarker: null;
+    body: (MatcherBody | null);
+    position: Position;
+}
+export interface FoldStatement {
+    op: "FOLD";
+    suffix: string;
+    signal: (string[] | null);
+    target: (ParsedPath | null);
+    lineMarker: null;
+    body: (MatcherBody | null);
+    position: Position;
+}
+export interface EditStatement {
+    op: "EDIT";
+    suffix: string;
+    signal: (string[] | null);
+    target: (ParsedPath | null);
+    lineMarker: (LineMarker | null);
+    body: (string | null);
+    position: Position;
+}
+export interface CopyStatement {
+    op: "COPY";
+    suffix: string;
+    signal: (string[] | null);
+    target: (ParsedPath | null);
+    lineMarker: (LineMarker | null);
+    body: (ResourceSelection | null);
+    position: Position;
+}
+/**
+ * A COPY/MOVE destination target and optional text scope. A target without a fragment selects the scheme's default channel; a fragment selects a named channel; lineMarker scopes the selected destination content.
+ */
+export interface ResourceSelection {
+    target: ParsedPath;
+    lineMarker: (LineMarker | null);
+}
+export interface MoveStatement {
+    op: "MOVE";
+    suffix: string;
+    signal: (string[] | null);
+    target: (ParsedPath | null);
+    lineMarker: (LineMarker | null);
+    body: (ResourceSelection | null);
+    position: Position;
+}
+export interface SendStatement {
+    op: "SEND";
+    suffix: string;
+    signal: (number | null);
+    target: (ParsedPath | null);
+    lineMarker: (LineMarker | null);
+    body: (SendBody | null);
+    position: Position;
+}
+/**
+ * Parsed body of a SEND statement. `raw` is the literal body text; `json` is the best-effort `JSON.parse(raw)` result, or null when the body isn't valid JSON.
+ */
+export interface SendBody {
+    raw: string;
+    json: unknown;
+}
+export interface ExecStatement {
+    op: "EXEC";
+    suffix: string;
+    signal: (string | null);
+    target: (ParsedPath | null);
+    lineMarker: (LineMarker | null);
+    body: (string | null);
+    position: Position;
+}
+export interface WorkStatement {
+    op: "WORK";
+    suffix: string;
+    signal: (string | null);
+    target: (ParsedPath | null);
+    lineMarker: null;
+    body: string;
+    position: Position;
+}
+export interface ForkStatement {
+    op: "FORK";
+    suffix: string;
+    signal: (string | null);
+    target: (ParsedPath | null);
+    lineMarker: null;
+    body: string;
+    position: Position;
+}
+export interface KillStatement {
+    op: "KILL";
+    suffix: string;
+    signal: (number | null);
+    target: (ParsedPath | null);
+    lineMarker: null;
+    body: (string | null);
+    position: Position;
+}
+export interface PlanStatement {
+    op: "PLAN";
+    suffix: string;
+    signal: (string[] | null);
+    target: (ParsedPath | null);
+    lineMarker: (LineMarker | null);
+    body: (string | null);
+    position: Position;
+}
+export interface LookStatement {
+    op: "LOOK";
+    suffix: string;
+    signal: TagSignal;
+    target: PathOrNull;
+    lineMarker: LineMarkerOrNull;
+    body: MatcherBodyOrNull;
+    position: Position;
+}
+export interface BuffStatement {
+    op: "BUFF";
+    suffix: string;
+    signal: TagSignal;
+    target: PathOrNull;
+    lineMarker: LineMarkerOrNull;
+    body: MatcherBodyOrNull;
+    position: Position;
+}
+export type EntryReadResult = ({
+    status: 200;
+    entry: ClientEntry;
+} | {
+    status: number;
+    problem: ProblemDetails;
+    entry: null;
+});
+export interface ClientEntry {
+    entryId: number;
+    target: string;
+    channels: {
+        [k: string]: ClientEntryChannel;
+    };
+    tags: string[];
+}
+export interface ClientEntryChannel {
+    content: string;
+    contentOffset: number;
+    contentLength: number;
+    mimetype: string;
+    tokens: number;
+    state: ("static" | "active" | "closed" | "errored");
+}
+/**
+ * PLURNK operation failure using RFC 9457 Problem Details. Extension members are permitted so an owning boundary can add structured causal and recovery facts without inventing a second error envelope.
+ */
+export interface ProblemDetails {
+    /**
+     * Absolute URI identifying the stable problem class.
+     */
+    type: string;
+    /**
+     * Short, stable summary for this problem type.
+     */
+    title: string;
+    /**
+     * Operation status. It must equal the containing result status.
+     */
+    status: number;
+    /**
+     * Specific, causal explanation of this occurrence.
+     */
+    detail: string;
+    /**
+     * Absolute URI identifying the failed durable operation, normally its log URI. Core adds it at persistence when a plugin cannot know the durable coordinate.
+     */
+    instance?: string;
+    /**
+     * Stable producer-owned stage at which the operation failed, when the operation has multiple independently recoverable stages.
+     */
+    stage?: string;
+    /**
+     * One generally valid next action. It is omitted when recovery depends on facts the producer does not know.
+     */
+    recovery?: string;
+    /**
+     * Whether the producer recommends automatically retrying the identical request.
+     */
+    retryable?: boolean;
+    [k: string]: unknown;
+}
+export interface LoopFlags {
+    mode: ("ask" | "act");
+    auto: boolean;
+    noWeb: boolean;
+    noInteraction: boolean;
+    noProposals: boolean;
+}
+export interface Notice {
+    /**
+     * Producer identifier. Top-level for self-contained subsystems; colon-namespaced for parameterized producers such as `provider:openai` or `exec:search`.
+     */
+    source: string;
+    /**
+     * Open discriminator within a source. Examples include `grammar_unenforced`, `embed_progress`, `search_progress`, and `turn_awaiting_model`.
+     */
+    kind: string;
+    /**
+     * Display severity set by the producer. It does not make the Notice a durable operation result.
+     */
+    level: ("error" | "warn" | "info");
+    /**
+     * Optional terse, factual display message.
+     */
+    message?: (string | null);
+    /**
+     * Optional typed position for an observation. ContentOffset points into model output; LogCoordinate points at a durable log row without replacing it.
+     */
+    position?: (ContentOffset | LogCoordinate | null);
+    [k: string]: unknown;
+}
+/**
+ * A point in model output using the parser-point convention: 1-based line and 0-based Unicode-code-point column. Absence or a null Notice.position represents an unknown location.
+ */
+export interface ContentOffset {
+    type: "content-offset";
+    line: number;
+    column: number;
+}
+export interface LogCoordinate {
+    type: "log-coordinate";
+    /**
+     * Log row identity, typically `log:///<loop>/<turn>/<sequence>`.
+     */
+    coordinate: string;
+    /**
+     * Optional op token (FIND/READ/EDIT/...) at the coordinate, for human-readable rendering.
+     */
+    op?: string;
+}
+export type OperationResult = ({
+    status: number;
+    problem?: ProblemDetails;
+    error?: never;
+    [k: string]: unknown;
+} & {
+    status?: number;
+});
+/**
+ * PLURNK operation failure using RFC 9457 Problem Details. Extension members are permitted so an owning boundary can add structured causal and recovery facts without inventing a second error envelope.
+ */
+export type ResourceSelectionOrNull = (ResourceSelection | null);
+export type SendBodyOrNull = (SendBody | null);
+export type ProposalDisposition = ({
+    owner: "client";
+} | {
+    owner: "loop";
+    decision: ("accept" | "reject");
+    outcome?: string;
+});
+export interface ProposalProjection {
+    logEntryId: number;
+    workerId: number;
+    loopId: number;
+    turnId: number;
+    op: ("FIND" | "READ" | "EDIT" | "COPY" | "MOVE" | "OPEN" | "FOLD" | "SEND" | "EXEC" | "WORK" | "FORK" | "KILL" | "PLAN");
+    target: {
+        scheme: (string | null);
+        pathname: (string | null);
+    };
+    body: string;
+    attrs: {
+        [k: string]: unknown;
+    };
+    flags: LoopFlags;
+    staleClobberRisk: boolean;
+    disposition: ProposalDisposition;
+}
+/**
+ * The complete effective policy posture of one model loop. Persisted partial objects are expanded to this shape by the runtime owner before use or projection.
+ */
+export type ProviderCost = ({
+    kind: "authoritative";
+    amount: MonetaryAmount;
+    usdEquivalent: DecimalAmount;
+    source: NonEmptyString;
+} | {
+    kind: "estimated";
+    usd: DecimalAmount;
+    source: NonEmptyString;
+} | {
+    kind: "free";
+    source: NonEmptyString;
+} | {
+    kind: "unknown";
+    reason: NonEmptyString;
+});
+export type DecimalAmount = string;
+export type NonEmptyString = string;
+export interface MonetaryAmount {
+    amount: DecimalAmount;
+    currency: string;
+}
+export interface TextRegion {
+    startLine: number;
+    startColumn: number;
+    endLine: number;
+    endColumn: number;
+}
+//# sourceMappingURL=types.generated.d.ts.map

package/dist/src/types.generated.d.ts.map

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

package/dist/src/types.generated.js

@@ -0,0 +1,4 @@
+// @generated by scriptify/generate-types.ts from schema/*.json
+// DO NOT EDIT — run `npm run build:types` to regenerate.
+export {};
+//# sourceMappingURL=types.generated.js.map

package/dist/src/types.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.generated.js","sourceRoot":"","sources":["../../src/types.generated.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,yDAAyD"}

package/dist/src/types.js

@@ -0,0 +1,23 @@
+// Schema-derived types are generated from schema/*.json — re-exported here as
+// the single import surface for consumers. Run `npm run build:types` to regenerate.
+export * from "./types.generated.js";
+// Non-schema types — depend on the PlurnkParseError class and so can't be
+// expressed in JSON Schema. Hand-maintained.
+// Runtime protocol alphabet; PlurnkOp is structurally derived from this tuple. {§op-shapes}
+export const PLURNK_OPS = [
+    "FIND", "READ", "EDIT", "COPY", "MOVE", "OPEN", "FOLD", "SEND", "EXEC", "WORK", "FORK", "KILL", "PLAN",
+];
+export const DEFAULT_LOOP_FLAGS = Object.freeze({
+    mode: "act",
+    auto: false,
+    noWeb: false,
+    noInteraction: false,
+    noProposals: false,
+});
+// Minting predicate only; URL ingestion deliberately remains permissive. {§worker-name}
+export const WORKER_NAME = /^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$/;
+// Authority-shaped internal worker names excluded from minting. {§worker-name}
+export const RESERVED_AUTHORITIES = Object.freeze(["commons", "plurnk"]);
+// Structurally synthesized statements have no parsed source point. {§parser-position}
+export const UNKNOWN_POSITION = Object.freeze({ line: 0, column: 0 });
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,oFAAoF;AACpF,cAAc,sBAAsB,CAAC;AAKrC,0EAA0E;AAC1E,6CAA6C;AAE7C,4FAA4F;AAC5F,MAAM,CAAC,MAAM,UAAU,GAAG;IACtB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAChG,CAAC;AAIX,MAAM,CAAC,MAAM,kBAAkB,GAAc,MAAM,CAAC,MAAM,CAAC;IACvD,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,KAAK,EAAE,KAAK;IACZ,aAAa,EAAE,KAAK;IACpB,WAAW,EAAE,KAAK;CACrB,CAAC,CAAC;AAEH,wFAAwF;AACxF,MAAM,CAAC,MAAM,WAAW,GAAG,sCAAsC,CAAC;AAElE,+EAA+E;AAC/E,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAU,CAAC,CAAC;AAElF,sFAAsF;AACtF,MAAM,CAAC,MAAM,gBAAgB,GAAuB,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,87 @@
+{
+    "name": "@plurnk/plurnk-contracts",
+    "version": "1.4.0",
+    "description": "Canonical PLURNK language, schemas, generated types, parser, rails, and runtime-neutral wire contracts",
+    "keywords": [
+        "plurnk",
+        "antlr",
+        "gbnf",
+        "rfc-9457",
+        "protocol"
+    ],
+    "homepage": "https://github.com/plurnk/plurnk-service/tree/main/plurnk-contracts#readme",
+    "bugs": {
+        "url": "https://repo.possumtech.com/plurnk/plurnk-service/issues"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/plurnk/plurnk-service.git",
+        "directory": "plurnk-contracts"
+    },
+    "engines": {
+        "node": ">=26"
+    },
+    "license": "MIT",
+    "author": "@wikitopian",
+    "type": "module",
+    "publishConfig": {
+        "access": "public"
+    },
+    "exports": {
+        ".": {
+            "plurnk-dev": "./src/index.ts",
+            "types": "./dist/src/index.d.ts",
+            "default": "./dist/src/index.js"
+        },
+        "./package.json": "./package.json",
+        "./plurnk.gbnf": "./dist/plurnk.gbnf",
+        "./schema/*.json": {
+            "plurnk-dev": "./schema/*.json",
+            "default": "./dist/schema/*.json"
+        }
+    },
+    "bin": {
+        "plurnk-contracts": "./bin/plurnk-contracts.js"
+    },
+    "files": [
+        "bin/plurnk-contracts.js",
+        "dist/**/*",
+        "plurnk.md",
+        "README.md",
+        "SPEC.md"
+    ],
+    "scripts": {
+        "build:grammar": "antlr-ng -D language=TypeScript -o src/generated --generate-visitor true --generate-listener false plurnkLexer.g4 plurnkParser.g4 && node --conditions=plurnk-dev scriptify/fix-generated-imports.ts",
+        "build:types": "node --conditions=plurnk-dev scriptify/generate-types.ts",
+        "build:clean": "rm -rf dist",
+        "build:dist": "tsc -p tsconfig.build.json",
+        "build:gbnf": "node --conditions=plurnk-dev scriptify/generate-gbnf.ts",
+        "build:schemas": "node --conditions=plurnk-dev scriptify/copy-schemas.ts",
+        "build": "npm run build:clean && npm run build:grammar && npm run build:types && npm run build:dist && npm run build:gbnf && npm run build:schemas",
+        "antlr:tokens": "testrig src/generated/plurnk document --tokens",
+        "antlr:trace": "testrig src/generated/plurnk document --trace",
+        "antlr:parse": "testrig src/generated/plurnk document --tree",
+        "test:lint": "tsc --noEmit",
+        "test:unit": "node --conditions=plurnk-dev --test src/*.test.ts test/unit/*.test.ts",
+        "test:intg": "node --conditions=plurnk-dev --test test/integration/*.test.ts",
+        "test:demo": "node --conditions=plurnk-dev --test test/demo/*.test.ts",
+        "test:smoke": "node --conditions=plurnk-dev scriptify/smoke-test.ts",
+        "test:llama": "node --conditions=plurnk-dev --test test/llama/*.test.ts",
+        "test:all": "npm run test:lint && npm run test:unit && npm run test:intg && npm run test:demo",
+        "test": "npm run test:all",
+        "prepublishOnly": "npm audit && npm run build && npm run test:all && npm run test:smoke",
+        "prepack": "npm run build",
+        "prepare": "npm run build"
+    },
+    "dependencies": {
+        "@cfworker/json-schema": "^4.1.1",
+        "antlr4ng": "^3.0.0",
+        "json-p3": "^2.2.2",
+        "xpath": "^0.0.34"
+    },
+    "devDependencies": {
+        "antlr-ng": "^1.0.10",
+        "esbuild": "^0.28.1",
+        "json-schema-to-typescript": "^15.0.4"
+    }
+}