@plurnk/plurnk-grammar 0.2.0 → 0.5.0

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

@@ -0,0 +1,465 @@
+export interface Agent {
+    version: number;
+    provider: ProviderDeclaration;
+    /**
+     * Agent-wide default scheme registrations. The v0 inventory ships with `plurnk`, `known`, `unknown`; everything else is plugin-registered.
+     */
+    scheme_registry: SchemeRegistration[];
+}
+/**
+ * Declaration of the active provider for an agent. The grammar package owns these four fields; auth/connection config lives in the agent repo.
+ */
+export interface ProviderDeclaration {
+    /**
+     * API vendor identifier (e.g. "anthropic", "openai", "google", "local").
+     */
+    provider: string;
+    /**
+     * Model family (e.g. "claude", "gpt", "gemini", "llama").
+     */
+    family: string;
+    /**
+     * Specific model id (e.g. "claude-opus-4-7").
+     */
+    model: string;
+    /**
+     * Total context window in tokens.
+     */
+    contextSize: number;
+    /**
+     * ISO 4217 code; the unit `cost_pico` is denominated in.
+     */
+    currency: string;
+}
+/**
+ * A scheme entry in the agent's scheme registry. Defines what `<name>://` resolves to and how it's accessible.
+ */
+export interface SchemeRegistration {
+    /**
+     * Scheme name without `://`. Matches the URL scheme character class.
+     */
+    name: string;
+    model_visible: boolean;
+    category: string;
+    default_scope: ("agent" | "session");
+    /**
+     * Channel name selected when an op against this scheme has no fragment. Conventionally `body`; exec schemes typically declare `stdout`.
+     */
+    default_channel: string;
+    /**
+     * Per-channel content-orientation hints. `head` = whole-document or front-anchored (readers care about the beginning); `tail` = append-temporal stream (readers care about the latest content). Channels not listed default to `head`. Renderers use this to pick truncation direction; the amount to render is a core/runtime concern, not a contract field.
+     */
+    channel_orientations?: {
+        [k: string]: ("head" | "tail");
+    };
+    writable_by: ("model" | "client" | "system" | "plugin")[];
+    volatile: boolean;
+    handler: (string | null);
+}
+export interface ChannelContent {
+    /**
+     * Raw content bytes/string for this channel. Binary content awaits a future encoding pass (see AGENTS.md).
+     */
+    content: string;
+    mimetype: string;
+    /**
+     * Token count of `content` under the active model's tokenizer.
+     */
+    tokens: number;
+}
+export type Entry = ({
+    [k: string]: unknown;
+} & {
+    id: number;
+    version: number;
+    scope: ("agent" | "session");
+    session_id: (number | null);
+    scheme: (string | null);
+    username: (string | null);
+    password: (string | null);
+    hostname: (string | null);
+    port: (number | null);
+    pathname: string;
+    params: (Params | null);
+    /**
+     * Named channels on this entry. Keys are channel names (lowercase identifiers); values are ChannelContent. Must be non-empty. The scheme registry declares which channel is the default for unspecified ops.
+     */
+    channels: {
+        [k: string]: ChannelContent;
+    };
+    attributes: {};
+    tags: string[];
+});
+/**
+ * URL query parameters parsed into a JSON object. Single-value keys map to strings; multi-value keys (repeated in the original query string) map to arrays of strings. Empty object when the URL has no query string; nullable usages wrap this schema in a oneOf with null.
+ */
+export interface Params {
+    [k: string]: (string | string[]);
+}
+/**
+ * One named stream of content on an entry. Channels carry distinct, parallel views of an entry (e.g. `stdout` and `stderr` on `exec://`; `body` and `headers` on `https://`; `body` and `symbols` on a code file). Each channel has its own content bytes, mimetype, and token count.
+ */
+export interface LineMarker {
+    first: number;
+    last: (number | null);
+}
+export type LogEntry = ({
+    [k: string]: unknown;
+} & {
+    id: number;
+    version: number;
+    run_id: number;
+    loop_id: number;
+    turn_id: number;
+    action_index: number;
+    at: string;
+    origin: ("model" | "client" | "system" | "plugin");
+    op: ("FIND" | "READ" | "EDIT" | "COPY" | "MOVE" | "SHOW" | "HIDE" | "SEND" | "EXEC");
+    suffix: string;
+    signal: (string[] | number | string | null);
+    target_scheme: (string | null);
+    target_username: (string | null);
+    target_password: (string | null);
+    target_hostname: (string | null);
+    target_port: (number | null);
+    target_pathname: (string | null);
+    target_params: (Params | null);
+    /**
+     * Channel selector at request time. Names the channel the op targeted; null when the op used the scheme's default channel.
+     */
+    target_fragment: (string | null);
+    lineMarker: (LineMarker | null);
+    /**
+     * Raw request payload. For origin=model: the literal plurnk DSL substring of assistant.content. For origin=system/client/plugin: whatever the originator emitted, with `mimetype_tx` declaring the structure.
+     */
+    tx: string;
+    /**
+     * Mimetype of `tx`. Typically `text/vnd.plurnk` for model-origin rows; arbitrary per-origin for system/client/plugin.
+     */
+    mimetype_tx: string;
+    /**
+     * Raw response payload bytes/string.
+     */
+    rx: string;
+    mimetype_rx: string;
+    status_rx: number;
+    tokens: number;
+});
+/**
+ * URL query parameters parsed into a JSON object. Single-value keys map to strings; multi-value keys (repeated in the original query string) map to arrays of strings. Empty object when the URL has no query string; nullable usages wrap this schema in a oneOf with null.
+ */
+export interface Loop {
+    id: number;
+    version: number;
+    run_id: number;
+    /**
+     * 1-based within the run.
+     */
+    sequence: number;
+    /**
+     * 102 = continuing; 200 = terminal success; 499 = terminal cancellation.
+     */
+    status: (102 | 200 | 499);
+    /**
+     * The original user prompt for this loop, replayed on every turn.
+     */
+    prompt: string;
+}
+export type MatcherBody = (XPathBody | RegexBody | JsonPathBody | GlobBody);
+/**
+ * XPath 1.0 expression. Validated at parse time via the xpath library.
+ */
+export interface XPathBody {
+    dialect: "xpath";
+    raw: string;
+}
+/**
+ * JavaScript regex literal `/pattern/flags`. 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;
+}
+/**
+ * JSONPath expression. Validated at parse time via jsonpath-plus.
+ */
+export interface JsonPathBody {
+    dialect: "jsonpath";
+    raw: string;
+}
+/**
+ * Pattern with no dialect prefix; treated as a glob/literal match.
+ */
+export interface GlobBody {
+    dialect: "glob";
+    raw: string;
+}
+export type PlurnkStatement = (FindStatement | ReadStatement | ShowStatement | HideStatement | EditStatement | CopyStatement | MoveStatement | SendStatement | ExecStatement);
+/**
+ * A parsed path slot from a plurnk statement. Discriminated on `kind`: either a bare local path (no scheme) or a fully decomposed URL.
+ */
+export type ParsedPath = (LocalPath | UrlPath);
+/**
+ * Parsed body of a FIND/READ/SHOW/HIDE statement, discriminated on `dialect`. The dialect is determined by the body's leading characters (`//` xpath, `/` regex, `$` jsonpath, else glob). The regex variant carries pattern/flags split out of the `/pattern/flags` literal; the compiled `RegExp` object on the in-memory AST is a runtime ergonomic only and is not part of the persisted/wire contract.
+ */
+export interface Packet {
+    /**
+     * Total packet tokens — sum of section subtotals.
+     */
+    tokens: number;
+    system: {
+        tokens: number;
+        /**
+         * text/markdown — plurnk grammar + scheme registry refs.
+         */
+        system_definition: string;
+        /**
+         * text/markdown — identity / mission.
+         */
+        persona: string;
+        index: Entry[];
+        log: LogEntry[];
+    };
+    user: {
+        tokens: number;
+        /**
+         * Copy of loop.prompt — never null on a continuation turn.
+         */
+        prompt: string;
+        /**
+         * Per-turn instrumentation surfaced to the model. `budget` is renderer-provided markdown describing remaining context / cost / etc. `errors` carries actionless failures (parse errors and similar) that the model should confront on this turn. Inner shapes intentionally open at v0; consumers populate as needs solidify.
+         */
+        telemetry: {
+            /**
+             * text/markdown — budget surface (token/cost/etc. left to spend). Empty string when nothing to surface.
+             */
+            budget: string;
+            /**
+             * TelemetryError[] — element shape TBD. Empty array when no errors to surface.
+             */
+            errors: {}[];
+        };
+        /**
+         * text/markdown — per-turn rules.
+         */
+        system_requirements: string;
+    };
+    assistant: {
+        tokens: number;
+        /**
+         * Raw DSL string emitted by the model.
+         */
+        content: string;
+        /**
+         * Parsed PlurnkStatement[] derived from `content`.
+         */
+        ops: PlurnkStatement[];
+        /**
+         * text/plain — provider-exposed CoT when present, null otherwise.
+         */
+        reasoning: (string | null);
+        [k: string]: unknown;
+    };
+    assistantRaw: unknown;
+}
+/**
+ * URL query parameters parsed into a JSON object. Single-value keys map to strings; multi-value keys (repeated in the original query string) map to arrays of strings. Empty object when the URL has no query string; nullable usages wrap this schema in a oneOf with null.
+ */
+export interface FindStatement {
+    op: "FIND";
+    suffix: string;
+    signal: (string[] | null);
+    path: (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;
+    params: Params;
+    fragment: (string | null);
+}
+/**
+ * XPath 1.0 expression. Validated at parse time via the xpath library.
+ */
+export interface Position {
+    line: number;
+    column: number;
+}
+export interface ReadStatement {
+    op: "READ";
+    suffix: string;
+    signal: (string[] | null);
+    path: (ParsedPath | null);
+    lineMarker: (LineMarker | null);
+    body: (MatcherBody | null);
+    position: Position;
+}
+export interface ShowStatement {
+    op: "SHOW";
+    suffix: string;
+    signal: (string[] | null);
+    path: (ParsedPath | null);
+    lineMarker: (LineMarker | null);
+    body: (MatcherBody | null);
+    position: Position;
+}
+export interface HideStatement {
+    op: "HIDE";
+    suffix: string;
+    signal: (string[] | null);
+    path: (ParsedPath | null);
+    lineMarker: (LineMarker | null);
+    body: (MatcherBody | null);
+    position: Position;
+}
+export interface EditStatement {
+    op: "EDIT";
+    suffix: string;
+    signal: (string[] | null);
+    path: (ParsedPath | null);
+    lineMarker: (LineMarker | null);
+    body: (string | null);
+    position: Position;
+}
+export interface CopyStatement {
+    op: "COPY";
+    suffix: string;
+    signal: (string[] | null);
+    path: (ParsedPath | null);
+    lineMarker: (LineMarker | null);
+    body: (ParsedPath | null);
+    position: Position;
+}
+export interface MoveStatement {
+    op: "MOVE";
+    suffix: string;
+    signal: (string[] | null);
+    path: (ParsedPath | null);
+    lineMarker: (LineMarker | null);
+    body: (ParsedPath | null);
+    position: Position;
+}
+export interface SendStatement {
+    op: "SEND";
+    suffix: string;
+    signal: (number | null);
+    path: (ParsedPath | null);
+    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);
+    path: (ParsedPath | null);
+    lineMarker: null;
+    body: (string | null);
+    position: Position;
+}
+export type TagSignal = (string[] | null);
+export type PathOrNull = (ParsedPath | null);
+/**
+ * A parsed path slot from a plurnk statement. Discriminated on `kind`: either a bare local path (no scheme) or a fully decomposed URL.
+ */
+export type LineMarkerOrNull = (LineMarker | null);
+export type MatcherBodyOrNull = (MatcherBody | null);
+/**
+ * Parsed body of a FIND/READ/SHOW/HIDE statement, discriminated on `dialect`. The dialect is determined by the body's leading characters (`//` xpath, `/` regex, `$` jsonpath, else glob). The regex variant carries pattern/flags split out of the `/pattern/flags` literal; the compiled `RegExp` object on the in-memory AST is a runtime ergonomic only and is not part of the persisted/wire contract.
+ */
+export type SendBodyOrNull = (SendBody | null);
+export interface Run {
+    id: number;
+    version: number;
+    session_id: number;
+    /**
+     * Unique within the session. Auto-populated default form `run-{unixtime}` until renamed. Clients display this; cross-table references use `id` so renames don't cascade-break.
+     */
+    name: string;
+    created_at: string;
+    /**
+     * FK to parent run when this is a fork; null for the trunk run.
+     */
+    parent_run_id: (number | null);
+    /**
+     * Cumulative cost across this run's turns, in pico-units of the active provider's currency.
+     */
+    cost_pico: number;
+}
+export interface Session {
+    id: number;
+    version: number;
+    /**
+     * Unique within the agent. Auto-populated default form `session-{unixtime}` until renamed. Clients display this; cross-table references use `id` so renames don't cascade-break.
+     */
+    name: string;
+    created_at: string;
+    /**
+     * Cumulative cost across this session's runs.
+     */
+    cost_pico: number;
+    scheme_registry_additions: SchemeRegistration[];
+}
+/**
+ * A scheme entry in the agent's scheme registry. Defines what `<name>://` resolves to and how it's accessible.
+ */
+export interface Turn {
+    id: number;
+    version: number;
+    loop_id: number;
+    /**
+     * 1-based within the loop; resets at each new loop.
+     */
+    sequence: number;
+    timestamp: string;
+    status: number;
+    /**
+     * Provider-returned token counts and computed cost.
+     */
+    usage: {
+        prompt: number;
+        completion: number;
+        cached: number;
+        /**
+         * Per-turn cost in pico-units of the active provider's currency.
+         */
+        cost_pico: number;
+    };
+    packet: Packet;
+}
+/**
+ * One turn's full exchange with the provider: { system, user, assistant, assistantRaw }. system aggregates durable + accumulating context (definition, persona, indexed entries, in-scope log rows). user carries the per-turn ephemera. assistant is the provider-normalized output. assistantRaw is opaque.
+ */
+export interface Visibility {
+    entry_id: number;
+    channel: string;
+    indexed: boolean;
+}
+//# 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,4 @@
+// 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";
+//# 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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plurnk/plurnk-grammar",
-  "version": "0.2.0",
+  "version": "0.5.0",
   "description": "ANTLR4 grammar for the Plurnk LLM agent protocol",
   "type": "module",
   "license": "MIT",
@@ -11,7 +11,10 @@
     "node": ">=25"
   },
   "exports": {
-    ".": "./src/index.ts",
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    },
     "./package.json": "./package.json"
   },
   "bin": {
@@ -19,15 +22,14 @@
   },
   "files": [
     "bin/plurnk.js",
-    "src/*.ts",
-    "src/generated/*.ts",
-    "schema/*.json",
+    "dist/**/*",
     "plurnk.md"
   ],
   "scripts": {
     "build:grammar": "antlr-ng -D language=TypeScript -o src/generated --generate-visitor true --generate-listener false plurnkLexer.g4 plurnkParser.g4 && node scriptify/fix-generated-imports.ts",
     "build:types": "node scriptify/generate-types.ts",
-    "build": "npm run build:grammar && npm run build:types",
+    "build:dist": "tsc -p tsconfig.build.json",
+    "build": "npm run build:grammar && npm run build:types && npm run build:dist",
     "antlr:tokens": "testrig src/generated/plurnk document --tokens",
     "antlr:trace": "testrig src/generated/plurnk document --trace",
     "antlr:parse": "testrig src/generated/plurnk document --tree",
@@ -35,9 +37,10 @@
     "test:unit": "node --test test/unit/*.test.ts",
     "test:intg": "node --test test/integration/*.test.ts",
     "test:demo": "node --test test/demo/*.test.ts",
+    "test:smoke": "node scriptify/smoke-test.ts",
     "test:all": "npm run test:lint && npm run test:unit && npm run test:intg && npm run test:demo",
     "prepare": "npm run build",
-    "prepublishOnly": "npm run build && npm run test:all"
+    "prepublishOnly": "npm run build && npm run test:all && npm run test:smoke"
   },
   "dependencies": {
     "@cfworker/json-schema": "^4.1.1",

package/plurnk.md

@@ -24,7 +24,7 @@ Slots between `<<OPsuffix` and `:body:` are all optional. `:body:` fences are re
 | SEND | HTTP status   | recipient | —               | message (JSON for data)  |
 | EXEC | Runtime Tag   | cwd       | —               | command or code          |
 
-SEND signal is a single integer. EXEC signal is a single Runtime Tag (`sh`, `node`, `python`, etc.). All other signals are CSV.
+SEND signal is a single integer. SEND broadcasts when path is omitted; with a path it is directed (path must be a URI). EXEC signal is a single Runtime Tag (`sh`, `node`, `python`, etc.). All other signals are tags.
 
 ## `<L>`
 

package/src/RecordingListener.ts

@@ -1,34 +0,0 @@
-import {
-    BaseErrorListener,
-    type RecognitionException,
-    type Recognizer,
-    type Token,
-} from "antlr4ng";
-import { plurnkLexer } from "./generated/plurnkLexer.ts";
-import PlurnkParseError from "./PlurnkParseError.ts";
-import PlurnkErrorStrategy from "./PlurnkErrorStrategy.ts";
-
-export default class RecordingListener extends BaseErrorListener {
-    readonly errors: PlurnkParseError[];
-    readonly source: "lexer" | "parser";
-
-    constructor(source: "lexer" | "parser", errors: PlurnkParseError[]) {
-        super();
-        this.source = source;
-        this.errors = errors;
-    }
-
-    override syntaxError(
-        recognizer: Recognizer<any>,
-        _offendingSymbol: Token | null,
-        line: number,
-        column: number,
-        msg: string,
-        _e: RecognitionException | null,
-    ): void {
-        const translated = this.source === "lexer"
-            ? PlurnkErrorStrategy.translateLexerMessage(recognizer as plurnkLexer, msg)
-            : msg;
-        this.errors.push(new PlurnkParseError(line, column, this.source, translated));
-    }
-}