@daniel156161/prism 0.2.76 → 0.2.81

package/node_modules/@earendil-works/pi-coding-agent/examples/extensions/summarize.ts

@@ -1,5 +1,4 @@
 import { uuidv7 } from "@earendil-works/pi-ai";
-import { complete, getModel } from "@earendil-works/pi-ai/compat";
 import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
 import { DynamicBorder, getMarkdownTheme } from "@earendil-works/pi-coding-agent";
 import { Container, Markdown, matchesKey, Text } from "@earendil-works/pi-tui";
@@ -161,20 +160,13 @@ export default function (pi: ExtensionAPI) {
 				ctx.ui.notify("Preparing summary...", "info");
 			}
 
-			const model = getModel("openai", "gpt-5.2");
-			if (!model && ctx.hasUI) {
-				ctx.ui.notify("Model openai/gpt-5.2 not found", "warning");
-			}
-
-			const auth = model ? await ctx.modelRegistry.getApiKeyAndHeaders(model) : undefined;
-			if (auth && !auth.ok && ctx.hasUI) {
-				ctx.ui.notify(auth.error, "warning");
-			}
-			if (auth?.ok && !auth.apiKey && ctx.hasUI) {
-				ctx.ui.notify("No API key for openai/gpt-5.2", "warning");
+			const model = ctx.modelRegistry.find("openai", "gpt-5.2");
+			if (!model) {
+				if (ctx.hasUI) ctx.ui.notify("Model openai/gpt-5.2 not found", "warning");
+				return;
 			}
-
-			if (!model || !auth?.ok || !auth.apiKey) {
+			if (!ctx.modelRegistry.hasConfiguredAuth(model)) {
+				if (ctx.hasUI) ctx.ui.notify("No authentication configured for openai/gpt-5.2", "warning");
 				return;
 			}
 
@@ -186,13 +178,10 @@ export default function (pi: ExtensionAPI) {
 				},
 			];
 
-			const response = await complete(
+			const response = await ctx.modelRegistry.complete(
 				model,
 				{ messages: summaryMessages },
 				{
-					apiKey: auth.apiKey,
-					headers: auth.headers,
-					env: auth.env,
 					reasoningEffort: "high",
 					cacheRetention: "none",
 					sessionId: uuidv7(),

package/node_modules/@earendil-works/pi-coding-agent/examples/extensions/with-deps/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pi-extension-with-deps",
-  "version": "0.83.0",
+  "version": "0.84.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pi-extension-with-deps",
-      "version": "0.83.0",
+      "version": "0.84.1",
       "dependencies": {
         "ms": "^2.1.3"
       },

package/node_modules/@earendil-works/pi-coding-agent/examples/extensions/with-deps/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-extension-with-deps",
   "private": true,
-  "version": "0.83.0",
+  "version": "0.84.1",
   "type": "module",
   "scripts": {
     "clean": "echo 'nothing to clean'",

package/node_modules/@earendil-works/pi-coding-agent/examples/rpc-extension-ui.ts

@@ -18,7 +18,16 @@ import { spawn } from "node:child_process";
 import { dirname, join } from "node:path";
 import * as readline from "node:readline";
 import { fileURLToPath } from "node:url";
-import { type Component, Container, Input, matchesKey, ProcessTerminal, SelectList, TUI } from "@earendil-works/pi-tui";
+import {
+	type Component,
+	Container,
+	Input,
+	matchesKey,
+	ProcessTerminal,
+	SelectList,
+	type TUI,
+	TuiMainScreen,
+} from "@earendil-works/pi-tui";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
@@ -267,7 +276,7 @@ async function main() {
 	// -- TUI setup --
 
 	const terminal = new ProcessTerminal();
-	const tui = new TUI(terminal);
+	const tui: TUI = new TuiMainScreen(terminal);
 
 	const outputLog = new OutputLog();
 	const loadingIndicator = new LoadingIndicator();

package/node_modules/@earendil-works/pi-coding-agent/examples/sdk/02-custom-model.ts

@@ -4,13 +4,12 @@
  * Shows how to select a specific model and thinking level.
  */
 
-import { getModel } from "@earendil-works/pi-ai/compat";
 import { createAgentSession, ModelRuntime } from "@earendil-works/pi-coding-agent";
 
 const modelRuntime = await ModelRuntime.create();
 
 // Option 1: Find a specific built-in model by provider/id
-const opus = getModel("anthropic", "claude-opus-4-5");
+const opus = modelRuntime.getModel("anthropic", "claude-opus-4-5");
 if (opus) {
 	console.log(`Found model: ${opus.provider}/${opus.id}`);
 }

package/node_modules/@earendil-works/pi-coding-agent/examples/sdk/09-api-keys-and-oauth.ts

@@ -25,7 +25,7 @@ const { session: customAuthSession } = await createAgentSession({
 console.log("Session with custom auth and models locations");
 customAuthSession.dispose();
 
-modelRuntime.setRuntimeApiKey("anthropic", "sk-my-temp-key");
+await modelRuntime.setRuntimeApiKey("anthropic", "sk-my-temp-key");
 const { session: runtimeKeySession } = await createAgentSession({
 	sessionManager: SessionManager.inMemory(),
 	modelRuntime,

package/node_modules/@earendil-works/pi-coding-agent/examples/sdk/12-full-control.ts

@@ -19,7 +19,7 @@ const modelRuntime = await ModelRuntime.create({
 	modelsPath: "/tmp/my-agent/models.json",
 });
 if (process.env.MY_ANTHROPIC_KEY) {
-	modelRuntime.setRuntimeApiKey("anthropic", process.env.MY_ANTHROPIC_KEY);
+	await modelRuntime.setRuntimeApiKey("anthropic", process.env.MY_ANTHROPIC_KEY);
 }
 
 const model = getModel("anthropic", "claude-sonnet-4-5");

package/node_modules/@earendil-works/pi-coding-agent/examples/sdk/README.md

@@ -71,7 +71,7 @@ const customRuntime = await ModelRuntime.create({
   authPath: "/my/app/auth.json",
   modelsPath: "/my/app/models.json",
 });
-customRuntime.setRuntimeApiKey("anthropic", process.env.MY_KEY!);
+await customRuntime.setRuntimeApiKey("anthropic", process.env.MY_KEY!);
 
 const resourceLoader = new DefaultResourceLoader({
   systemPromptOverride: () => "You are helpful.",

package/node_modules/@earendil-works/pi-coding-agent/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@earendil-works/pi-coding-agent",
-	"version": "0.83.0",
+	"version": "0.84.1",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"piConfig": {
@@ -18,6 +18,10 @@
 		},
 		"./rpc-entry": {
 			"import": "./dist/rpc-entry.js"
+		},
+		"./client": {
+			"types": "./dist/client/index.d.ts",
+			"import": "./dist/client/index.js"
 		}
 	},
 	"files": [
@@ -31,7 +35,7 @@
 	"scripts": {
 		"clean": "shx rm -rf dist",
 		"build": "tsgo -p tsconfig.build.json && shx chmod +x dist/cli.js dist/rpc-entry.js && npm run copy-assets",
-		"build:binary": "npm --prefix ../tui run build && npm --prefix ../ai run build && npm --prefix ../agent run build && npm run build && bun build --compile ./dist/bun/cli.js ./src/utils/image-resize-worker.ts --outfile dist/pi && npm run copy-binary-assets",
+		"build:binary": "npm --prefix ../tui run build && npm --prefix ../telemetry run build && npm --prefix ../ai run build && npm --prefix ../agent run build && npm --prefix ../protocol run build && npm --prefix ../client run build && npm run build && bun build --compile --no-compile-autoload-bunfig ./dist/bun/cli.js ./src/utils/image-resize-worker.ts --outfile dist/pi && npm run copy-binary-assets",
 		"copy-assets": "shx mkdir -p dist/modes/interactive/theme && shx cp src/modes/interactive/theme/*.json dist/modes/interactive/theme/ && shx mkdir -p dist/modes/interactive/assets && shx cp src/modes/interactive/assets/*.png dist/modes/interactive/assets/ && shx mkdir -p dist/core/export-html/vendor && shx cp src/core/export-html/template.html src/core/export-html/template.css src/core/export-html/template.js dist/core/export-html/ && shx cp src/core/export-html/vendor/*.js dist/core/export-html/vendor/",
 		"copy-binary-assets": "shx cp package.json dist/ && shx cp README.md dist/ && shx cp CHANGELOG.md dist/ && shx mkdir -p dist/theme && shx cp src/modes/interactive/theme/*.json dist/theme/ && shx mkdir -p dist/assets && shx cp src/modes/interactive/assets/*.png dist/assets/ && shx mkdir -p dist/export-html/vendor && shx cp src/core/export-html/template.html dist/export-html/ && shx cp src/core/export-html/vendor/*.js dist/export-html/vendor/ && shx cp -r docs dist/ && shx cp -r examples dist/ && shx cp ../../node_modules/@silvia-odwyer/photon-node/photon_rs_bg.wasm dist/",
 		"test": "vitest --run",
@@ -39,14 +43,17 @@
 		"prepublishOnly": "npm run clean && npm run build && npm run shrinkwrap"
 	},
 	"dependencies": {
-		"@earendil-works/pi-agent-core": "^0.83.0",
-		"@earendil-works/pi-ai": "^0.83.0",
-		"@earendil-works/pi-tui": "^0.83.0",
+		"@earendil-works/pi-agent-core": "^0.84.1",
+		"@earendil-works/pi-ai": "^0.84.1",
+		"@earendil-works/pi-client": "^0.84.1",
+		"@earendil-works/pi-protocol": "^0.84.1",
+		"@earendil-works/pi-tui": "^0.84.1",
 		"@silvia-odwyer/photon-node": "0.3.4",
 		"chalk": "5.6.2",
 		"cross-spawn": "7.0.6",
 		"diff": "8.0.4",
 		"glob": "13.0.6",
+		"grok-mermaid": "0.2.2",
 		"highlight.js": "10.7.3",
 		"hosted-git-info": "9.0.3",
 		"ignore": "7.0.5",
@@ -55,7 +62,7 @@
 		"proper-lockfile": "4.1.2",
 		"semver": "7.8.0",
 		"typebox": "1.3.7",
-		"undici": "8.5.0",
+		"undici": "8.9.0",
 		"yaml": "2.9.0"
 	},
 	"overrides": {

package/node_modules/@earendil-works/pi-protocol/README.md

@@ -0,0 +1,69 @@
+# @earendil-works/pi-protocol
+
+Runtime-neutral schemas, types, CBOR encoding, and byte-stream framing for the experimental pi protocol.
+
+Protocol version `1` uses binary messages with this wire layout:
+
+1. A four-byte unsigned big-endian payload length.
+2. One definite-length CBOR item containing the message.
+
+The first client message is always `hello`, containing `PROTOCOL_VERSION`. Subsequent messages use correlated request/response envelopes and server event envelopes. Session and server snapshots are authoritative. Progress events are transient UI hints and must not be reduced into authoritative state. Transports complete authentication before protocol bytes are exchanged.
+
+Session lists contain `SessionMetadata`, the normalized durable metadata available without acquiring a session runtime. Only `id` and `createdAt` are required; `updatedAt`, `parentSessionId`, `sessionName`, and `cwd` are included when supported by the backing store. Runtime state such as phase, model, thinking level, attachment, and locking appears only in an acquired `SessionSnapshot`.
+
+## Validated message API
+
+`encodeClientMessage()` and `encodeServerMessage()` validate a message and return a complete framed `Uint8Array`. The incremental decoders accept arbitrary fragmentation or coalescing, so they work with streams, sockets, and custom byte transports.
+
+```ts
+import {
+  PROTOCOL_VERSION,
+  createServerMessageDecoder,
+  encodeClientMessage,
+  type ClientHello,
+} from "@earendil-works/pi-protocol";
+
+const hello: ClientHello = {
+  type: "hello",
+  version: PROTOCOL_VERSION,
+};
+
+transport.send(encodeClientMessage(hello));
+
+const decoder = createServerMessageDecoder({ maxFrameLength: 1024 * 1024 });
+for (const message of decoder.push(incomingChunk)) {
+  handleServerMessage(message);
+}
+decoder.end(); // Call when the byte stream closes to detect truncation.
+```
+
+`ClientMessageDecoder` and `ServerMessageDecoder` are also available directly. Schema violations, malformed CBOR, and invalid framing throw `ProtocolValidationError`. Validation errors do not retain rejected payloads.
+
+`parseClientMessage()` and `parseServerMessage()` only validate already-decoded values. They do not parse JSON strings.
+
+## Transport support
+
+Every transport carries the same complete bytes: `[uint32-be CBOR length][CBOR payload]`. Transports may split or coalesce those bytes arbitrarily.
+
+This package does not bundle a transport. Consumers provide a byte-stream transport that preserves byte order and reports stream closure. Custom transports must handle arbitrary frame fragmentation and coalescing.
+
+All transports are untrusted. Configure matching frame limits and enforce access controls appropriate for the transport before exposing a connection to the protocol. Unix sockets can use filesystem permissions, while network transports can authenticate during connection establishment.
+
+## Encoding and framing
+
+`encodeCbor()` and `decodeCbor()` implement the protocol's strict RFC 8949 subset. `encodeFrame()` and `FrameDecoder` handle framing independently of schemas and CBOR.
+
+The CBOR subset supports:
+
+- `null` and booleans
+- finite numbers, with integers restricted to JavaScript's safe range and non-integers encoded as float64
+- UTF-8 strings
+- `Uint8Array` byte strings
+- definite-length arrays
+- definite-length maps represented by objects with unique string keys
+
+Undefined object properties are omitted. JSON-valued protocol fields reject CBOR byte strings and non-plain objects. Top-level undefined, undefined array entries, sparse arrays, non-finite or unsafe numbers, tags, indefinite-length items, malformed UTF-8, trailing data, excessive nesting, and oversized values are rejected.
+
+Default limits are 16 MiB per CBOR payload/frame, 1,000,000 array elements or map entries, and 64 nested item levels. Options can configure these limits. A frame decoder validates the declared length before buffering payload bytes.
+
+All schemas reject unknown object properties. The protocol is experimental and has no compatibility guarantees.

package/node_modules/@earendil-works/pi-protocol/dist/cbor/decoder.d.ts

@@ -0,0 +1,4 @@
+import { type CborOptions } from "./options.ts";
+/** Decodes exactly one item from the protocol's strict RFC 8949 subset. */
+export declare function decodeCbor(bytes: Uint8Array, options?: CborOptions): unknown;
+//# sourceMappingURL=decoder.d.ts.map

package/node_modules/@earendil-works/pi-protocol/dist/cbor/decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder.d.ts","sourceRoot":"","sources":["../../src/cbor/decoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,WAAW,EAKhB,MAAM,cAAc,CAAC;AAwJtB,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAO5E","sourcesContent":["import {\n\tCborError,\n\ttype CborOptions,\n\ttype ResolvedCborOptions,\n\tresolveOptions,\n\ttextDecoder,\n\tUINT32_BASE,\n} from \"./options.ts\";\n\nclass CborReader {\n\tprivate readonly bytes: Uint8Array;\n\tprivate offset = 0;\n\tprivate readonly options: ResolvedCborOptions;\n\n\tconstructor(bytes: Uint8Array, options: ResolvedCborOptions) {\n\t\tthis.bytes = bytes;\n\t\tthis.options = options;\n\t}\n\n\tdecode(): unknown {\n\t\tconst value = this.readItem(0);\n\t\tif (this.offset !== this.bytes.byteLength) throw new CborError(\"CBOR payload contains trailing data\");\n\t\treturn value;\n\t}\n\n\tprivate readItem(depth: number): unknown {\n\t\tif (depth > this.options.maxDepth) {\n\t\t\tthrow new CborError(`CBOR nesting depth exceeds configured limit of ${this.options.maxDepth}`);\n\t\t}\n\t\tconst initial = this.readByte();\n\t\tconst majorType = initial >>> 5;\n\t\tconst additionalInformation = initial & 0x1f;\n\n\t\tswitch (majorType) {\n\t\t\tcase 0:\n\t\t\t\treturn this.readArgument(additionalInformation);\n\t\t\tcase 1: {\n\t\t\t\tconst value = -1 - this.readArgument(additionalInformation);\n\t\t\t\tif (!Number.isSafeInteger(value)) throw new CborError(\"Decoded CBOR integer is outside the safe range\");\n\t\t\t\treturn value;\n\t\t\t}\n\t\t\tcase 2: {\n\t\t\t\tconst length = this.readLength(additionalInformation, \"byte string\", this.options.maxByteLength);\n\t\t\t\treturn new Uint8Array(this.readBytes(length));\n\t\t\t}\n\t\t\tcase 3: {\n\t\t\t\tconst length = this.readLength(additionalInformation, \"text string\", this.options.maxByteLength);\n\t\t\t\tconst bytes = this.readBytes(length);\n\t\t\t\ttry {\n\t\t\t\t\treturn textDecoder.decode(bytes);\n\t\t\t\t} catch (_error) {\n\t\t\t\t\tthrow new CborError(\"CBOR text string contains invalid UTF-8\");\n\t\t\t\t}\n\t\t\t}\n\t\t\tcase 4: {\n\t\t\t\tconst length = this.readLength(additionalInformation, \"array\", this.options.maxContainerLength);\n\t\t\t\tconst result: unknown[] = [];\n\t\t\t\tfor (let index = 0; index < length; index++) result.push(this.readItem(depth + 1));\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\tcase 5: {\n\t\t\t\tconst length = this.readLength(additionalInformation, \"map\", this.options.maxContainerLength);\n\t\t\t\tconst result: Record<string, unknown> = {};\n\t\t\t\tconst keys = new Set<string>();\n\t\t\t\tfor (let index = 0; index < length; index++) {\n\t\t\t\t\tconst key = this.readItem(depth + 1);\n\t\t\t\t\tif (typeof key !== \"string\") throw new CborError(\"CBOR map keys must be strings\");\n\t\t\t\t\tif (keys.has(key)) throw new CborError(\"CBOR map contains a duplicate key\");\n\t\t\t\t\tkeys.add(key);\n\t\t\t\t\tObject.defineProperty(result, key, {\n\t\t\t\t\t\tconfigurable: true,\n\t\t\t\t\t\tenumerable: true,\n\t\t\t\t\t\tvalue: this.readItem(depth + 1),\n\t\t\t\t\t\twritable: true,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\tcase 6:\n\t\t\t\tthrow new CborError(\"CBOR tags are not supported\");\n\t\t\tcase 7:\n\t\t\t\treturn this.readSimple(additionalInformation);\n\t\t\tdefault:\n\t\t\t\tthrow new CborError(\"Malformed CBOR major type\");\n\t\t}\n\t}\n\n\tprivate readSimple(additionalInformation: number): unknown {\n\t\tswitch (additionalInformation) {\n\t\t\tcase 20:\n\t\t\t\treturn false;\n\t\t\tcase 21:\n\t\t\t\treturn true;\n\t\t\tcase 22:\n\t\t\t\treturn null;\n\t\t\tcase 27: {\n\t\t\t\tconst bytes = this.readBytes(8);\n\t\t\t\tconst value = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength).getFloat64(0, false);\n\t\t\t\tif (!Number.isFinite(value)) throw new CborError(\"Decoded CBOR number must be finite\");\n\t\t\t\tif (Number.isInteger(value) && !Number.isSafeInteger(value)) {\n\t\t\t\t\tthrow new CborError(\"Decoded CBOR integer is outside the safe range\");\n\t\t\t\t}\n\t\t\t\treturn value;\n\t\t\t}\n\t\t\tcase 31:\n\t\t\t\tthrow new CborError(\"CBOR break marker is not supported\");\n\t\t\tdefault:\n\t\t\t\tthrow new CborError(\"Unsupported CBOR simple value or floating-point width\");\n\t\t}\n\t}\n\n\tprivate readLength(additionalInformation: number, kind: string, limit: number): number {\n\t\tif (additionalInformation === 31) throw new CborError(`Indefinite-length CBOR ${kind}s are not supported`);\n\t\tconst length = this.readArgument(additionalInformation);\n\t\tif (length > limit) throw new CborError(`CBOR ${kind} length exceeds configured limit of ${limit}`);\n\t\treturn length;\n\t}\n\n\tprivate readArgument(additionalInformation: number): number {\n\t\tif (additionalInformation < 24) return additionalInformation;\n\t\tswitch (additionalInformation) {\n\t\t\tcase 24:\n\t\t\t\treturn this.readByte();\n\t\t\tcase 25: {\n\t\t\t\tconst bytes = this.readBytes(2);\n\t\t\t\treturn bytes[0]! * 0x100 + bytes[1]!;\n\t\t\t}\n\t\t\tcase 26: {\n\t\t\t\tconst bytes = this.readBytes(4);\n\t\t\t\treturn bytes[0]! * 0x1_000_000 + bytes[1]! * 0x1_0000 + bytes[2]! * 0x100 + bytes[3]!;\n\t\t\t}\n\t\t\tcase 27: {\n\t\t\t\tconst high = this.readArgument(26);\n\t\t\t\tconst low = this.readArgument(26);\n\t\t\t\tif (high > 0x1f_ffff) throw new CborError(\"Decoded CBOR integer or length is outside the safe range\");\n\t\t\t\treturn high * UINT32_BASE + low;\n\t\t\t}\n\t\t\tcase 31:\n\t\t\t\tthrow new CborError(\"Indefinite-length CBOR items are not supported\");\n\t\t\tdefault:\n\t\t\t\tthrow new CborError(\"Malformed CBOR additional information\");\n\t\t}\n\t}\n\n\tprivate readByte(): number {\n\t\tif (this.offset >= this.bytes.byteLength) throw new CborError(\"Truncated CBOR payload\");\n\t\tconst value = this.bytes[this.offset]!;\n\t\tthis.offset++;\n\t\treturn value;\n\t}\n\n\tprivate readBytes(length: number): Uint8Array {\n\t\tif (length > this.bytes.byteLength - this.offset) throw new CborError(\"Truncated CBOR payload\");\n\t\tconst value = this.bytes.subarray(this.offset, this.offset + length);\n\t\tthis.offset += length;\n\t\treturn value;\n\t}\n}\n\n/** Decodes exactly one item from the protocol's strict RFC 8949 subset. */\nexport function decodeCbor(bytes: Uint8Array, options?: CborOptions): unknown {\n\tif (!(bytes instanceof Uint8Array)) throw new TypeError(\"CBOR input must be a Uint8Array\");\n\tconst resolved = resolveOptions(options);\n\tif (bytes.byteLength > resolved.maxByteLength) {\n\t\tthrow new CborError(`CBOR byte length exceeds configured limit of ${resolved.maxByteLength}`);\n\t}\n\treturn new CborReader(bytes, resolved).decode();\n}\n"]}

package/node_modules/@earendil-works/pi-protocol/dist/cbor/decoder.js

@@ -0,0 +1,165 @@
+import { CborError, resolveOptions, textDecoder, UINT32_BASE, } from "./options.js";
+class CborReader {
+    bytes;
+    offset = 0;
+    options;
+    constructor(bytes, options) {
+        this.bytes = bytes;
+        this.options = options;
+    }
+    decode() {
+        const value = this.readItem(0);
+        if (this.offset !== this.bytes.byteLength)
+            throw new CborError("CBOR payload contains trailing data");
+        return value;
+    }
+    readItem(depth) {
+        if (depth > this.options.maxDepth) {
+            throw new CborError(`CBOR nesting depth exceeds configured limit of ${this.options.maxDepth}`);
+        }
+        const initial = this.readByte();
+        const majorType = initial >>> 5;
+        const additionalInformation = initial & 0x1f;
+        switch (majorType) {
+            case 0:
+                return this.readArgument(additionalInformation);
+            case 1: {
+                const value = -1 - this.readArgument(additionalInformation);
+                if (!Number.isSafeInteger(value))
+                    throw new CborError("Decoded CBOR integer is outside the safe range");
+                return value;
+            }
+            case 2: {
+                const length = this.readLength(additionalInformation, "byte string", this.options.maxByteLength);
+                return new Uint8Array(this.readBytes(length));
+            }
+            case 3: {
+                const length = this.readLength(additionalInformation, "text string", this.options.maxByteLength);
+                const bytes = this.readBytes(length);
+                try {
+                    return textDecoder.decode(bytes);
+                }
+                catch (_error) {
+                    throw new CborError("CBOR text string contains invalid UTF-8");
+                }
+            }
+            case 4: {
+                const length = this.readLength(additionalInformation, "array", this.options.maxContainerLength);
+                const result = [];
+                for (let index = 0; index < length; index++)
+                    result.push(this.readItem(depth + 1));
+                return result;
+            }
+            case 5: {
+                const length = this.readLength(additionalInformation, "map", this.options.maxContainerLength);
+                const result = {};
+                const keys = new Set();
+                for (let index = 0; index < length; index++) {
+                    const key = this.readItem(depth + 1);
+                    if (typeof key !== "string")
+                        throw new CborError("CBOR map keys must be strings");
+                    if (keys.has(key))
+                        throw new CborError("CBOR map contains a duplicate key");
+                    keys.add(key);
+                    Object.defineProperty(result, key, {
+                        configurable: true,
+                        enumerable: true,
+                        value: this.readItem(depth + 1),
+                        writable: true,
+                    });
+                }
+                return result;
+            }
+            case 6:
+                throw new CborError("CBOR tags are not supported");
+            case 7:
+                return this.readSimple(additionalInformation);
+            default:
+                throw new CborError("Malformed CBOR major type");
+        }
+    }
+    readSimple(additionalInformation) {
+        switch (additionalInformation) {
+            case 20:
+                return false;
+            case 21:
+                return true;
+            case 22:
+                return null;
+            case 27: {
+                const bytes = this.readBytes(8);
+                const value = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength).getFloat64(0, false);
+                if (!Number.isFinite(value))
+                    throw new CborError("Decoded CBOR number must be finite");
+                if (Number.isInteger(value) && !Number.isSafeInteger(value)) {
+                    throw new CborError("Decoded CBOR integer is outside the safe range");
+                }
+                return value;
+            }
+            case 31:
+                throw new CborError("CBOR break marker is not supported");
+            default:
+                throw new CborError("Unsupported CBOR simple value or floating-point width");
+        }
+    }
+    readLength(additionalInformation, kind, limit) {
+        if (additionalInformation === 31)
+            throw new CborError(`Indefinite-length CBOR ${kind}s are not supported`);
+        const length = this.readArgument(additionalInformation);
+        if (length > limit)
+            throw new CborError(`CBOR ${kind} length exceeds configured limit of ${limit}`);
+        return length;
+    }
+    readArgument(additionalInformation) {
+        if (additionalInformation < 24)
+            return additionalInformation;
+        switch (additionalInformation) {
+            case 24:
+                return this.readByte();
+            case 25: {
+                const bytes = this.readBytes(2);
+                return bytes[0] * 0x100 + bytes[1];
+            }
+            case 26: {
+                const bytes = this.readBytes(4);
+                return bytes[0] * 0x1_000_000 + bytes[1] * 0x1_0000 + bytes[2] * 0x100 + bytes[3];
+            }
+            case 27: {
+                const high = this.readArgument(26);
+                const low = this.readArgument(26);
+                if (high > 0x1f_ffff)
+                    throw new CborError("Decoded CBOR integer or length is outside the safe range");
+                return high * UINT32_BASE + low;
+            }
+            case 31:
+                throw new CborError("Indefinite-length CBOR items are not supported");
+            default:
+                throw new CborError("Malformed CBOR additional information");
+        }
+    }
+    readByte() {
+        if (this.offset >= this.bytes.byteLength)
+            throw new CborError("Truncated CBOR payload");
+        const value = this.bytes[this.offset];
+        this.offset++;
+        return value;
+    }
+    readBytes(length) {
+        if (length > this.bytes.byteLength - this.offset)
+            throw new CborError("Truncated CBOR payload");
+        const value = this.bytes.subarray(this.offset, this.offset + length);
+        this.offset += length;
+        return value;
+    }
+}
+/** Decodes exactly one item from the protocol's strict RFC 8949 subset. */
+export function decodeCbor(bytes, options) {
+    if (!(bytes instanceof Uint8Array))
+        throw new TypeError("CBOR input must be a Uint8Array");
+    const resolved = resolveOptions(options);
+    if (bytes.byteLength > resolved.maxByteLength) {
+        throw new CborError(`CBOR byte length exceeds configured limit of ${resolved.maxByteLength}`);
+    }
+    return new CborReader(bytes, resolved).decode();
+}
+//# sourceMappingURL=decoder.js.map

package/node_modules/@earendil-works/pi-protocol/dist/cbor/decoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder.js","sourceRoot":"","sources":["../../src/cbor/decoder.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\tCborError,\n\ttype CborOptions,\n\ttype ResolvedCborOptions,\n\tresolveOptions,\n\ttextDecoder,\n\tUINT32_BASE,\n} from \"./options.ts\";\n\nclass CborReader {\n\tprivate readonly bytes: Uint8Array;\n\tprivate offset = 0;\n\tprivate readonly options: ResolvedCborOptions;\n\n\tconstructor(bytes: Uint8Array, options: ResolvedCborOptions) {\n\t\tthis.bytes = bytes;\n\t\tthis.options = options;\n\t}\n\n\tdecode(): unknown {\n\t\tconst value = this.readItem(0);\n\t\tif (this.offset !== this.bytes.byteLength) throw new CborError(\"CBOR payload contains trailing data\");\n\t\treturn value;\n\t}\n\n\tprivate readItem(depth: number): unknown {\n\t\tif (depth > this.options.maxDepth) {\n\t\t\tthrow new CborError(`CBOR nesting depth exceeds configured limit of ${this.options.maxDepth}`);\n\t\t}\n\t\tconst initial = this.readByte();\n\t\tconst majorType = initial >>> 5;\n\t\tconst additionalInformation = initial & 0x1f;\n\n\t\tswitch (majorType) {\n\t\t\tcase 0:\n\t\t\t\treturn this.readArgument(additionalInformation);\n\t\t\tcase 1: {\n\t\t\t\tconst value = -1 - this.readArgument(additionalInformation);\n\t\t\t\tif (!Number.isSafeInteger(value)) throw new CborError(\"Decoded CBOR integer is outside the safe range\");\n\t\t\t\treturn value;\n\t\t\t}\n\t\t\tcase 2: {\n\t\t\t\tconst length = this.readLength(additionalInformation, \"byte string\", this.options.maxByteLength);\n\t\t\t\treturn new Uint8Array(this.readBytes(length));\n\t\t\t}\n\t\t\tcase 3: {\n\t\t\t\tconst length = this.readLength(additionalInformation, \"text string\", this.options.maxByteLength);\n\t\t\t\tconst bytes = this.readBytes(length);\n\t\t\t\ttry {\n\t\t\t\t\treturn textDecoder.decode(bytes);\n\t\t\t\t} catch (_error) {\n\t\t\t\t\tthrow new CborError(\"CBOR text string contains invalid UTF-8\");\n\t\t\t\t}\n\t\t\t}\n\t\t\tcase 4: {\n\t\t\t\tconst length = this.readLength(additionalInformation, \"array\", this.options.maxContainerLength);\n\t\t\t\tconst result: unknown[] = [];\n\t\t\t\tfor (let index = 0; index < length; index++) result.push(this.readItem(depth + 1));\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\tcase 5: {\n\t\t\t\tconst length = this.readLength(additionalInformation, \"map\", this.options.maxContainerLength);\n\t\t\t\tconst result: Record<string, unknown> = {};\n\t\t\t\tconst keys = new Set<string>();\n\t\t\t\tfor (let index = 0; index < length; index++) {\n\t\t\t\t\tconst key = this.readItem(depth + 1);\n\t\t\t\t\tif (typeof key !== \"string\") throw new CborError(\"CBOR map keys must be strings\");\n\t\t\t\t\tif (keys.has(key)) throw new CborError(\"CBOR map contains a duplicate key\");\n\t\t\t\t\tkeys.add(key);\n\t\t\t\t\tObject.defineProperty(result, key, {\n\t\t\t\t\t\tconfigurable: true,\n\t\t\t\t\t\tenumerable: true,\n\t\t\t\t\t\tvalue: this.readItem(depth + 1),\n\t\t\t\t\t\twritable: true,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\treturn result;\n\t\t\t}\n\t\t\tcase 6:\n\t\t\t\tthrow new CborError(\"CBOR tags are not supported\");\n\t\t\tcase 7:\n\t\t\t\treturn this.readSimple(additionalInformation);\n\t\t\tdefault:\n\t\t\t\tthrow new CborError(\"Malformed CBOR major type\");\n\t\t}\n\t}\n\n\tprivate readSimple(additionalInformation: number): unknown {\n\t\tswitch (additionalInformation) {\n\t\t\tcase 20:\n\t\t\t\treturn false;\n\t\t\tcase 21:\n\t\t\t\treturn true;\n\t\t\tcase 22:\n\t\t\t\treturn null;\n\t\t\tcase 27: {\n\t\t\t\tconst bytes = this.readBytes(8);\n\t\t\t\tconst value = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength).getFloat64(0, false);\n\t\t\t\tif (!Number.isFinite(value)) throw new CborError(\"Decoded CBOR number must be finite\");\n\t\t\t\tif (Number.isInteger(value) && !Number.isSafeInteger(value)) {\n\t\t\t\t\tthrow new CborError(\"Decoded CBOR integer is outside the safe range\");\n\t\t\t\t}\n\t\t\t\treturn value;\n\t\t\t}\n\t\t\tcase 31:\n\t\t\t\tthrow new CborError(\"CBOR break marker is not supported\");\n\t\t\tdefault:\n\t\t\t\tthrow new CborError(\"Unsupported CBOR simple value or floating-point width\");\n\t\t}\n\t}\n\n\tprivate readLength(additionalInformation: number, kind: string, limit: number): number {\n\t\tif (additionalInformation === 31) throw new CborError(`Indefinite-length CBOR ${kind}s are not supported`);\n\t\tconst length = this.readArgument(additionalInformation);\n\t\tif (length > limit) throw new CborError(`CBOR ${kind} length exceeds configured limit of ${limit}`);\n\t\treturn length;\n\t}\n\n\tprivate readArgument(additionalInformation: number): number {\n\t\tif (additionalInformation < 24) return additionalInformation;\n\t\tswitch (additionalInformation) {\n\t\t\tcase 24:\n\t\t\t\treturn this.readByte();\n\t\t\tcase 25: {\n\t\t\t\tconst bytes = this.readBytes(2);\n\t\t\t\treturn bytes[0]! * 0x100 + bytes[1]!;\n\t\t\t}\n\t\t\tcase 26: {\n\t\t\t\tconst bytes = this.readBytes(4);\n\t\t\t\treturn bytes[0]! * 0x1_000_000 + bytes[1]! * 0x1_0000 + bytes[2]! * 0x100 + bytes[3]!;\n\t\t\t}\n\t\t\tcase 27: {\n\t\t\t\tconst high = this.readArgument(26);\n\t\t\t\tconst low = this.readArgument(26);\n\t\t\t\tif (high > 0x1f_ffff) throw new CborError(\"Decoded CBOR integer or length is outside the safe range\");\n\t\t\t\treturn high * UINT32_BASE + low;\n\t\t\t}\n\t\t\tcase 31:\n\t\t\t\tthrow new CborError(\"Indefinite-length CBOR items are not supported\");\n\t\t\tdefault:\n\t\t\t\tthrow new CborError(\"Malformed CBOR additional information\");\n\t\t}\n\t}\n\n\tprivate readByte(): number {\n\t\tif (this.offset >= this.bytes.byteLength) throw new CborError(\"Truncated CBOR payload\");\n\t\tconst value = this.bytes[this.offset]!;\n\t\tthis.offset++;\n\t\treturn value;\n\t}\n\n\tprivate readBytes(length: number): Uint8Array {\n\t\tif (length > this.bytes.byteLength - this.offset) throw new CborError(\"Truncated CBOR payload\");\n\t\tconst value = this.bytes.subarray(this.offset, this.offset + length);\n\t\tthis.offset += length;\n\t\treturn value;\n\t}\n}\n\n/** Decodes exactly one item from the protocol's strict RFC 8949 subset. */\nexport function decodeCbor(bytes: Uint8Array, options?: CborOptions): unknown {\n\tif (!(bytes instanceof Uint8Array)) throw new TypeError(\"CBOR input must be a Uint8Array\");\n\tconst resolved = resolveOptions(options);\n\tif (bytes.byteLength > resolved.maxByteLength) {\n\t\tthrow new CborError(`CBOR byte length exceeds configured limit of ${resolved.maxByteLength}`);\n\t}\n\treturn new CborReader(bytes, resolved).decode();\n}\n"]}

package/node_modules/@earendil-works/pi-protocol/dist/cbor/encoder.d.ts

@@ -0,0 +1,4 @@
+import { type CborOptions } from "./options.ts";
+/** Encodes the protocol's strict, definite-length RFC 8949 subset. */
+export declare function encodeCbor(value: unknown, options?: CborOptions): Uint8Array;
+//# sourceMappingURL=encoder.d.ts.map

package/node_modules/@earendil-works/pi-protocol/dist/cbor/encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../src/cbor/encoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,WAAW,EAOhB,MAAM,cAAc,CAAC;AAwMtB,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,UAAU,CAK5E","sourcesContent":["import {\n\tCborError,\n\ttype CborOptions,\n\tMAX_UINT32,\n\ttype ResolvedCborOptions,\n\tresolveOptions,\n\ttextDecoder,\n\ttextEncoder,\n\tUINT32_BASE,\n} from \"./options.ts\";\n\nclass CborWriter {\n\tprivate buffer: Uint8Array;\n\tprivate offset = 0;\n\tprivate readonly maxByteLength: number;\n\n\tconstructor(maxByteLength: number) {\n\t\tthis.maxByteLength = maxByteLength;\n\t\tthis.buffer = new Uint8Array(Math.min(256, maxByteLength));\n\t}\n\n\twriteByte(value: number): void {\n\t\tthis.ensureCapacity(1);\n\t\tthis.buffer[this.offset] = value;\n\t\tthis.offset++;\n\t}\n\n\twriteBytes(bytes: Uint8Array): void {\n\t\tthis.ensureCapacity(bytes.byteLength);\n\t\tthis.buffer.set(bytes, this.offset);\n\t\tthis.offset += bytes.byteLength;\n\t}\n\n\twriteUint16(value: number): void {\n\t\tthis.ensureCapacity(2);\n\t\tthis.buffer[this.offset] = value >>> 8;\n\t\tthis.buffer[this.offset + 1] = value;\n\t\tthis.offset += 2;\n\t}\n\n\twriteUint32(value: number): void {\n\t\tthis.ensureCapacity(4);\n\t\tthis.buffer[this.offset] = value >>> 24;\n\t\tthis.buffer[this.offset + 1] = value >>> 16;\n\t\tthis.buffer[this.offset + 2] = value >>> 8;\n\t\tthis.buffer[this.offset + 3] = value;\n\t\tthis.offset += 4;\n\t}\n\n\twriteUint64(value: number): void {\n\t\tconst high = Math.floor(value / UINT32_BASE);\n\t\tconst low = value - high * UINT32_BASE;\n\t\tthis.writeUint32(high);\n\t\tthis.writeUint32(low);\n\t}\n\n\twriteFloat64(value: number): void {\n\t\tthis.ensureCapacity(9);\n\t\tthis.buffer[this.offset] = 0xfb;\n\t\tnew DataView(this.buffer.buffer).setFloat64(this.offset + 1, value, false);\n\t\tthis.offset += 9;\n\t}\n\n\tfinish(): Uint8Array {\n\t\treturn this.buffer.slice(0, this.offset);\n\t}\n\n\tprivate ensureCapacity(additionalBytes: number): void {\n\t\tconst required = this.offset + additionalBytes;\n\t\tif (required > this.maxByteLength) {\n\t\t\tthrow new CborError(`CBOR byte length exceeds configured limit of ${this.maxByteLength}`);\n\t\t}\n\t\tif (required <= this.buffer.byteLength) return;\n\n\t\tlet capacity = Math.max(1, this.buffer.byteLength);\n\t\twhile (capacity < required) capacity = Math.min(this.maxByteLength, Math.max(required, capacity * 2));\n\t\tconst expanded = new Uint8Array(capacity);\n\t\texpanded.set(this.buffer);\n\t\tthis.buffer = expanded;\n\t}\n}\n\nfunction writeArgument(writer: CborWriter, majorType: number, value: number): void {\n\tconst prefix = majorType << 5;\n\tif (value < 24) {\n\t\twriter.writeByte(prefix | value);\n\t} else if (value <= 0xff) {\n\t\twriter.writeByte(prefix | 24);\n\t\twriter.writeByte(value);\n\t} else if (value <= 0xffff) {\n\t\twriter.writeByte(prefix | 25);\n\t\twriter.writeUint16(value);\n\t} else if (value <= MAX_UINT32) {\n\t\twriter.writeByte(prefix | 26);\n\t\twriter.writeUint32(value);\n\t} else {\n\t\twriter.writeByte(prefix | 27);\n\t\twriter.writeUint64(value);\n\t}\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n\tif (typeof value !== \"object\" || value === null) return false;\n\tconst prototype = Object.getPrototypeOf(value);\n\treturn prototype === Object.prototype || prototype === null;\n}\n\nfunction encodeText(writer: CborWriter, value: string, options: ResolvedCborOptions): void {\n\tconst bytes = textEncoder.encode(value);\n\tif (bytes.byteLength > options.maxByteLength) {\n\t\tthrow new CborError(`CBOR text string length exceeds configured limit of ${options.maxByteLength}`);\n\t}\n\tif (textDecoder.decode(bytes) !== value)\n\t\tthrow new CborError(\"CBOR text strings must contain valid Unicode scalar values\");\n\twriteArgument(writer, 3, bytes.byteLength);\n\twriter.writeBytes(bytes);\n}\n\nfunction encodeValue(\n\twriter: CborWriter,\n\tvalue: unknown,\n\toptions: ResolvedCborOptions,\n\tdepth: number,\n\tancestors: Set<object>,\n): void {\n\tif (depth > options.maxDepth)\n\t\tthrow new CborError(`CBOR nesting depth exceeds configured limit of ${options.maxDepth}`);\n\n\tif (value === null) {\n\t\twriter.writeByte(0xf6);\n\t\treturn;\n\t}\n\tif (typeof value === \"boolean\") {\n\t\twriter.writeByte(value ? 0xf5 : 0xf4);\n\t\treturn;\n\t}\n\tif (typeof value === \"number\") {\n\t\tif (!Number.isFinite(value)) throw new CborError(\"CBOR numbers must be finite\");\n\t\tif (Number.isInteger(value) && !Object.is(value, -0)) {\n\t\t\tif (!Number.isSafeInteger(value)) throw new CborError(\"CBOR integers must be safe JavaScript integers\");\n\t\t\tif (value >= 0) writeArgument(writer, 0, value);\n\t\t\telse writeArgument(writer, 1, -1 - value);\n\t\t} else {\n\t\t\twriter.writeFloat64(value);\n\t\t}\n\t\treturn;\n\t}\n\tif (typeof value === \"string\") {\n\t\tencodeText(writer, value, options);\n\t\treturn;\n\t}\n\tif (value instanceof Uint8Array) {\n\t\tif (value.byteLength > options.maxByteLength) {\n\t\t\tthrow new CborError(`CBOR byte string length exceeds configured limit of ${options.maxByteLength}`);\n\t\t}\n\t\twriteArgument(writer, 2, value.byteLength);\n\t\twriter.writeBytes(value);\n\t\treturn;\n\t}\n\tif (Array.isArray(value)) {\n\t\tif (ancestors.has(value)) throw new CborError(\"CBOR values must not contain cycles\");\n\t\tif (value.length > options.maxContainerLength) {\n\t\t\tthrow new CborError(`CBOR array length exceeds configured limit of ${options.maxContainerLength}`);\n\t\t}\n\t\tancestors.add(value);\n\t\ttry {\n\t\t\twriteArgument(writer, 4, value.length);\n\t\t\tfor (let index = 0; index < value.length; index++) {\n\t\t\t\tif (!Object.hasOwn(value, index) || value[index] === undefined) {\n\t\t\t\t\tthrow new CborError(\"CBOR arrays must not contain holes or undefined values\");\n\t\t\t\t}\n\t\t\t\tencodeValue(writer, value[index], options, depth + 1, ancestors);\n\t\t\t}\n\t\t} finally {\n\t\t\tancestors.delete(value);\n\t\t}\n\t\treturn;\n\t}\n\tif (isPlainObject(value)) {\n\t\tif (ancestors.has(value)) throw new CborError(\"CBOR values must not contain cycles\");\n\t\tfor (const symbol of Object.getOwnPropertySymbols(value)) {\n\t\t\tif (Object.prototype.propertyIsEnumerable.call(value, symbol)) {\n\t\t\t\tthrow new CborError(\"CBOR map keys must be strings\");\n\t\t\t}\n\t\t}\n\t\tconst entries: Array<readonly [string, unknown]> = [];\n\t\tfor (const key of Object.keys(value)) {\n\t\t\tconst entryValue = value[key];\n\t\t\tif (entryValue !== undefined) entries.push([key, entryValue]);\n\t\t}\n\t\tif (entries.length > options.maxContainerLength) {\n\t\t\tthrow new CborError(`CBOR map length exceeds configured limit of ${options.maxContainerLength}`);\n\t\t}\n\t\tancestors.add(value);\n\t\ttry {\n\t\t\twriteArgument(writer, 5, entries.length);\n\t\t\tfor (const [key, entryValue] of entries) {\n\t\t\t\tencodeText(writer, key, options);\n\t\t\t\tencodeValue(writer, entryValue, options, depth + 1, ancestors);\n\t\t\t}\n\t\t} finally {\n\t\t\tancestors.delete(value);\n\t\t}\n\t\treturn;\n\t}\n\n\tthrow new CborError(`Unsupported CBOR value type: ${typeof value}`);\n}\n\n/** Encodes the protocol's strict, definite-length RFC 8949 subset. */\nexport function encodeCbor(value: unknown, options?: CborOptions): Uint8Array {\n\tconst resolved = resolveOptions(options);\n\tconst writer = new CborWriter(resolved.maxByteLength);\n\tencodeValue(writer, value, resolved, 0, new Set<object>());\n\treturn writer.finish();\n}\n"]}