@daniel156161/prism 0.2.60 → 0.2.78

package/node_modules/@earendil-works/pi-coding-agent/node_modules/typebox/readme.md

@@ -50,7 +50,7 @@ type T = Type.Static<typeof T>              // type T = {
 
 [Documentation](https://sinclairzx81.github.io/typebox/)
 
-TypeBox is a runtime type system that creates in-memory JSON Schema objects that infer as TypeScript types. The schematics produced by this library are designed to match the static type checking rules of the TypeScript compiler. TypeBox offers a unified type system that can be statically checked by TypeScript and validated at runtime using standard JSON Schema.
+TypeBox is a runtime type system that creates in-memory JSON Schema objects that infer as TypeScript types. The schematics produced by this library are designed to match the static type checking rules of the TypeScript compiler. TypeBox offers a unified type that can be statically checked by TypeScript and runtime checked using standard JSON Schema validation.
 
 This library is designed to allow JSON Schema to compose similar to how types compose within TypeScript's type system. It can be used as a simple tool to build up complex schematics or integrated into REST and RPC services to help validate data received over the wire.
 
@@ -73,7 +73,7 @@ License: MIT
 
 TypeBox types are JSON Schema fragments that compose into more complex types. The library offers a set of types used to construct JSON Schema compliant schematics as well as a set of extended types used to model constructs native to the JavaScript language. The schematics produced by TypeBox can be passed directly to any JSON Schema compliant validator.
 
-## Example
+### Example
 
 The following creates a User type and infers with Static.
 
@@ -111,113 +111,127 @@ type User = Type.Static<typeof User>              // type User = {
 
 ## Script
 
-[Documentation](https://sinclairzx81.github.io/typebox/#/docs/script/overview) | [Example 1](https://www.typescriptlang.org/play/#code/JYWwDg9gTgLgBAFQJ5gKZwGZQiOByGFVAIwgA88AoSgehrgFonmXW32POvueHb6AygGMowMDH6Ne0mbLnNqQiADsAzvADecAKqrUUADQ69UbWAAmAQxjoAvnAC8iIgDpho8QAoABtThxgZRsoDEshdABRIOBCOA1Kf39gcwAuOHVRZQBzBLhbPwCg-VDw4304VDIbZXNVOCiYGKQ4uFz-ZUsQVDSMwKyjNoqQS2AAGx6YTKzW-3zcwjQy0wtrdCcIgDdLUYBXVYAeQYAFYCEAa33dfSMz1CQIDHrowgA+OAAyGcSjy1hgbf2AHkQDFLiYbncHk9Gq8Xrk4ZRvABKah0KTyDGYzGSABKqAwo1QQgkaKxZPJvEUKlUEEJLlGECyniuUCRiXZHM5XK5aPi3P5AsFgrR-gW3XwEGIACsiTA8AZBkKlcrOSK4GBsGg-qhVGk+SqDYa1UlUi0xWk8L1sng8grDfblca4B0unq4Ob8FasjbbHaHf7+U7UMMxm6PZbJn0fYqA7G4GrfTG4-61VBUABHHbANOmgDaSeT9qdeGS8q+hdjxZdqDLBYrKuLwZGoyo9cr9H8AF0622hWi5ko1LTUPTGcyTGYrDY2YXeT3ewK1eHJTLifL5wvuWqNRAtY0dXqN5vVR3Eskw0QLV6fX7jw3T+1OuKtOHr7aj3fEkGQ+MzZfPZG1p5B+n7xqeiagY6p5ppm2aoHmJbmHg3aQUq-aovQFJYdhLCSAIMDWKckg4SRFLUGKSyOM4aBuARjRCPsYpQiybxofQFEslR+qocKp7nukgH9CBoFqtWExTLePGBqeTahgJUzCZ+6GUBxE4rDYVHIDR+GEQxTGPCyk6rKxaKqfoRkaU43FSVufGml6kk2SeiTVgA-OJfSOU57JqrJozufJfSKXe6FAA) | [Example 2](https://www.typescriptlang.org/play/#code/JYWwDg9gTgLgBAFQJ5gKZwGZQiOByGFVAIwgA88AoSgehrgFonmXW32POvnb7k1ejbsJGj21AMYQAdgGd4AUWkxghOAF5ERAHQBJZaigYAhhNQAKANoBdADRwA3pThxgAEwBcWtNoDKMKGBpAHNzAEpKAF8Iyik5eABVWUMNb1Q9AyNTC0slFUI7R2c4aWMQVC9+dP9AkPDbYtQQY2AAG0qdGqDQiOjJGXk4JMMEsDdjGHRNKu0FADdjVoBXCYsZ-UmoZIkYK2KZgAVgCQBrc2GoexmAaVQkAHkMczzVJDCwhpdD41hgRfMZvcQKpzslLmltLcHk8XoR3hFrO9qHQhGI0eiMdxBAAlVAYVqoHaCTEk0mY-pyCAE7StCChC5hFxM5ks1lslkopzs7k83m8lEuQhoLx4CDEABWhJgeE+fLl8u5ArgYGwaF+qFkXi5Cp1uqVLncWrgQoq+HktWCeDgkVlurtfP1JTKpocxqIIvN3StNuK9r97MdTRa7UcbuFZoCXutvv9saZSp9caTLiVUFQAEclsA0544JYY8m-Y68O4ZXAC4W7cXSuUyxXKzri0G2lQG-6ldZ6225SjIhTZFT0rT6WDRuNJozk5yu93+fRBe78GLJTsZTPZ4r58rVYYVBqteuN2zHYbQyaPZGQt7bUee1uXDWXWHTXhPVfrTfb3OWc2Q67zxGFreoeX7xluiagQ6W5ppm2aoLmlglm4eCdpBUHRsSZJYdhnCCP4EzHJhOHEcR1AmkMYKpDM+EqBIAA8JoQBgFGGAAfPKKLkRcqTamhPJKqeb7BJ+fGskqj5eEJImicySq-pJl7BCBaG9mRRAsVAY6rFRnQwAR9GMcxFxaZM7FwJx6nGWM2maLxMliVugmKdJ9nmVuj4APwKRaLn2XJzRtF5cBCcpkG9kAA)
+[Documentation](https://sinclairzx81.github.io/typebox/#/docs/script/overview) | [Example 1](https://www.typescriptlang.org/play/?target=99&module=7#code/JYWwDg9gTgLgBAFQJ5gKZwGZQiOByGFVAIwgA88AoSgehrgFkIATAVwBtVKBjCAOwDO8BgEMYACzgBeREQB0AZW5RgYGAAoABpThxCaOADVU3GNABM0uAG84ZAFxw+rEMVRQANHCSPnr93AAvjp6REYmZlAAzFa2Dk4ubp7evonuXgBeqf5QQSH66Mam0AAssXbZSV4+CTmZlelwAO4NucGaAJTUdHAAIqhofMyofMIsHFy8gvC2DKgCkoFWyGiKyqoaohJemrr5YcawqGSxIbqQAsAwwPyORZElHmdO0CAi7HcR0FFPurqsADdPsUoOYQsFdAU4ABxVA4VAwKBIU5-OAA9zXbjzT5HMgAbQAur8-sAhsAsQJWoTwfsDFt3MB3ii-iJXMARjBgQ9ibpmMAMBhWAJUFzSjy4AI0NwOCIoKKoCUaZCwnMFszdABzOEgBFIxyw+GIpDit4wBnvRz0lTvGmdbr0ABKrFGoHQDtQGE4phufEoqvEcjA2DQsHZAjkWsNSMDwYxYbk6NDFLkV1QIHDQYgIeu80DEEu134MazcdzZD98wDmez8cjOqNxZrucTmNzqfTjdL4b4r3endDZYrC37OfDdd1SBH8Zb5LbZo71a7ckBU8H-tX4dN5vYG7kfIFQtQu-L68XA83Ym3u9ZxHZo2PQ6rsfPci31p3Z9HcklJhlUAftD0AoMBiOScAAJJ8Bg7gjFilCCnw3r8HAUAjMMUDqDqCyOCsR7AaB3AADwFBAGCMJWAB8HQ2CEWEBuODYzhSeIAAwEnmBY+nI5a6HREbahOCZxsxbFyD2UBvDuPFwHxDHRkx8ysexK7SXxb6Mju+6CsK3G0ZWr6Xu+cg3neMC6bx+nqX2P7Suwsq6YEQA) | [Example 2](https://www.typescriptlang.org/play/?target=99&module=7#code/JYWwDg9gTgLgBAFQJ5gKZwGZQiOByGFVAIwgA88AoSgehrgFkIATAVwBtVKA7AQxFQBnMLwDG6BrxgALOAG9KcOKjKRYcURG6D4ANVSiY0AExwAvIiIA6APLEAVgZgAKOXDIAuS2isA5ViDEqFDOAJQANHBIXsg+-oHBYXAAvqGKyqrQ8Jraek7QAMzm3qi2Dk6u7jHW8UEhEVHVcQF1YZEAXk2ltYmhKWlKKmrZWjpw+obQACzFsaV2joaVniV+Lb2R0as99R1dawm7cADu+ztJqZTJ1HRwACKoaNzMqNzwTGyclDlj+rAqs2sCwqCiUkEEwBgwC0XkkMisEyMUCm4XS3GgIF47FhUmkCPyUAKqKUrAAbjj4YiTFc0j94ABxVA4VAwKBIQE+YFLUFwUnBKHiQT7ACCUCgvCQzj+MBUEXSwGewEFIrFEuccwOrVCaUudMYUmCwCxHPm5W56X4xGArxgFLxVORxLgzGAGAwrEEqDt+MmjvSwgMHF4UG9DqmNO+o3eQlkFg1XJcPIA5kyBKytozmemnZiZVAjdj9XmCxHaPQAEqsN6gdDl1AYTiGaHcSgMGNWMDYNCwa2CKwprNsjtd-m9qx8nuCqyQ1AgPudiDdqFCDsQCFQrTDxejldkVvthdLscDtNDw87vsTgUrmdzrdHlfoqCY9j3i9WPdtwR4889lcnlkzxHP9L1HKdb3nYDlz7Mk3xAj992-ODoKsXNDSxZCxxdN0PVKX8UM-A8oLHND8ww-Cx0ta03kw3dEJ-YiV1IgtaL7ANRCDKBWIQss4AAZRgKQlTgABJbgMGCV5xEod1uCbLQ4CgV4XhCARv32AShNEAAeQg0AgDBGBjAA+PoeTUvEAPTccwKEABtAAGABdVd12bBClAs-tU0ApAbMneznKsJ8Xw8uAvKsocryVQKXNgvdPPbZiMOw91PTCrzktfKibQypKDTI192M4hDkiAA) | [Challenge](test/typescript/readme.md)
 
-The TypeBox Script function is a micro DSL for constructing JSON Schema from TypeScript syntax. It offers a full syntactic frontend to Type.* with broad support for type-level expressions including Conditional, Mapped, Infer, Generic, Distributive types and more. This feature is implemented symmetrically at both runtime and in the type system.
+TypeBox includes a runtime scripting engine that can transform TypeScript definitions into JSON Schema. The engine is implemented symmetrically at runtime and inside TypeScript's type system. It supports many programmable type-level constructs such as Conditional, Mapped, Indexed, Generic, Distributive Conditional, and more. The engine is designed for TypeScript 7 but is supported in TypeScript 5 and above.
 
 ### Example
 
-The following uses the Script function to parse TypeScript interfaces into JSON Schema.
+Syntax highlighting is available via the [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=sinclairzx81.typebox-script)
 
 ```typescript
-import Type from 'typebox'
-
-// Script
-
-const { User, UserUpdate } = Type.Script(`
+// Module
+const Math = Type.Script(`
+  type Vector2 = { x: number, y: number }
+  type Vector3 = { x: number, y: number, z: number }
+  type Vector4 = { x: number, y: number, z: number, w: number }
+`)
 
-  interface Entity {
-    id: string
+// Dependent Module
+const { Mesh } = Type.Script(Math, `  
+  type Vertex = {
+    position: Vector4,
+    normal: Vector3,
+    uv: Vector2
   }
-
-  interface User extends Entity { 
-    name: string, 
-    email: string 
+  type Geometry = {
+    vertices: Vertex[],
+    indices: number[]
+  }
+  type Material = {
+    ambient: Vector4,
+    diffuse: Vector4,
+    specular: Vector4
+  }
+  type Mesh = {
+    geometry: Geometry,
+    material: Material
   }
-
-  type UserUpdate = Evaluate<
-    Pick<User, keyof Entity> & 
-    Partial<Omit<User, keyof Entity>>
-  >
-
 `)
 
-// Reflect
-
-console.log(User)                                // {
-                                                 //   type: 'object',
-                                                 //   properties: {
-                                                 //     id: { type: 'string' },
-                                                 //     name: { type: 'string' },
-                                                 //     email: { type: 'string' }
-                                                 //   },
-                                                 //   required: [
-                                                 //     'id', 
-                                                 //     'name', 
-                                                 //     'email'
-                                                 //   ]
-                                                 // }
-
-console.log(UserUpdate)                          // {
-                                                 //   type: 'object',
-                                                 //   properties: {
-                                                 //     id: { type: 'string' },
-                                                 //     name: { type: 'string' },
-                                                 //     email: { type: 'string' }
-                                                 //   },
-                                                 //   required: ['id']
-                                                 // }
-
-// Static
-
-type User = Type.Static<typeof User>              // type User = {
-                                                  //   id: string,
-                                                  //   name: string,
-                                                  //   email: string
-                                                  // }
-
-type UserUpdate = Type.Static<typeof UserUpdate>  // type UserUpdate = {
-                                                  //   id: string,
-                                                  //   name?: string,
-                                                  //   email?: string
-                                                  // }
-
-
+// Runtime Reflection
+Mesh.properties.geometry.properties.vertices.items.properties.position.properties.x
+Mesh.properties.geometry.properties.vertices.items.properties.normal.properties.x
+Mesh.properties.geometry.properties.vertices.items.properties.uv.properties.x
+Mesh.properties.material.properties.diffuse.properties.x
+Mesh.properties.material.properties.ambient.properties.x
+Mesh.properties.material.properties.specular.properties.x
+
+// Static Inference
+function render(mesh: Type.Static<typeof Mesh>) {
+  mesh.geometry.vertices[0].position.x
+  mesh.geometry.vertices[0].normal.x
+  mesh.geometry.vertices[0].uv.x
+  mesh.material.diffuse.x
+  mesh.material.ambient.x
+  mesh.material.specular.x
+}
 ```
 
 <a name="Schema"></a>
 
 ## Schema
 
-[Documentation](https://sinclairzx81.github.io/typebox/#/docs/schema/overview) | [Example 1](https://www.typescriptlang.org/play/?#code/JYWwDg9gTgLgBAZQMYAsCmICGcBmUIhwDkMAnmGgEYQAeA9AM6oaZEBQokscAKuWrnyES-ajXZs6dOAFo58hYqXKVqteo0zJ0gMIEwwADZptszeYuWr8tmyQQAdg3gBVBmihwAvImZYAdHrgRmgAFHwU-gDylABWaEgwoQDebHBwwAAmAFy8-P4IMFDADgDmoQCUADRpcA6YIGi5EWgFRSXl1bUsRs35hcVlKbjQWDC5RD2GRHAAvhVs8wum1qtr61pScAAKmFDuKxtHx6q29k7wAK7unj5uHv67+2HJ6W-vH5-vW+fOcNceXKpdJZCYANgArDgAIyYABMlAAzEgACyZCFoME4ADsmAAHJQAJxIAAMmWhRCqX2pcC2IJycGcg1KNXS9UaEwBUEpNN5fO+0jZDSajPaZVZcCmnJuAAFMgRMCV-PYQDN+by6ZKsL1RczFhV1YajR8trNvHB-JagA) | [Example 2](https://www.typescriptlang.org/play/#code/JYWwDg9gTgLgBAZQMYAsCmICGcBmUIhwDkMAnmGgEYQAeA9AM6oaZEBQbddcAtH-wMFDhI0WPESenbgGECYYABs003pPUbNW-hyQQAdg3gBVBmihwAvImZYAdHPBK0ACgDebOHDIUAXMQhKACs0JBgiABpPODB8ClhgNAZ-Dy8vYAATFO9yNH8iIyhgfQBzIjgAXyi0uH1MEDy4Nxy-YkLissrqtJYlbJ9Ggpgi0sjcaCwYfN7FcoroquioNABHAFdgZay4AG1oryJMsf3iOobjmqIZ9i8AXTYKgEoOLjVtd4+P1QAFTCgzVSfIHAyS6AxGOBrMwWaymcx2X7-VzNGqotHouCvPSGeBQ8wpaKZfIANgArDgAIyYABMlAAzEgACwZUloYk4ADsmAAHJQAJxIAAMGQpYwx6Ne6W27VK3TOgzxUDF4pVqq8ktq9UaMpK3Rm+UVAAEMgRMMU7HoQOU1SqNfq4DqHo8bS7XajXhUrHA7D6gA) | [Specification](https://sinclairzx81.github.io/typebox/#/docs/schema/1_spec)
-
-TypeBox includes a high-performance JSON Schema compiler with support for drafts 3 through to 2020-12. The compiler is designed to be a lightweight industry-grade alternative to Ajv and offers improved compilation and validation performance. The compiler also offers automatic fallback to dynamic checking in JIT-restricted environments such as Cloudflare Workers.
+[Documentation](https://sinclairzx81.github.io/typebox/#/docs/schema/overview) | [Example 1](https://www.typescriptlang.org/play/#code/JYWwDg9gTgLgBAZQMYAsCmICGcBmUIhwDkMAnmGgEYQAeA9AM6oaZEBQbddcAtH-wMFDhI0WPESenbgGECYYABs003pPUbNW-hyQQAdg3gBVBmihwAvImZYAdHPBK0ACgDebOHDIUAXMQhKACs0JBgiABpPODB8ClhgNAZ-Dy8vYAATFO9yNH8iIyhgfQBzIjgAXyi0uH1MEDy4Nxy-YkLissrqtJYlbJ9Ggpgi0sjcaCwYfN7FcoroquioNABHAFdgZay4AG1oryJMsf3iOobjmqIZ9i8AXTYKgEoOLjVtd4+P1QAFTCgzVSfIHAyS6AxGOBrMwWaymcx2X7-VzNGqotHouCvPSGeBQ8wpaKZfIANgArDgAIyYABMlAAzEgACwZUloYk4ADsmAAHJQAJxIAAMGQpYwx6Ne6W27VK3TOgzxUDF4pVqq8ktq9UaMpK3Rm+UVAAEMgRMMU7HoQOU1SqNfq4DqHo8bS7XajXhUrHA7D6gA) | [Example 2](https://www.typescriptlang.org/play/?#code/JYWwDg9gTgLgBAZQMYAsCmICGcBmUIhwDkMAnmGgEYQAeA9AM6oaZEBQokscAKuWrnyES-ajXZs6dOAFo58hYqXKVqteo0zJ0gMIEwwADZptszeYuWr8tmyQQAdg3gBVBmihwAvImZYAdHrgRmgAFHwU-gDylABWaEgwoQDebHBwwAAmAFy8-P4IMFDADgDmoQCUADRpcA6YIGi5EWgFRSXl1bUsRs35hcVlKbjQWDC5RD2GRHAAvhVs8wum1qtr61pScAAKmFDuKxtHx6q29k7wAK7unj5uHv67+2HJ6W-vH5-vW+fOcNceXKpdJZCYANgArDgAIyYABMlAAzEgACyZCFoME4ADsmAAHJQAJxIAAMmWhRCqX2pcC2IJycGcg1KNXS9UaEwBUEpNN5fO+0jZDSajPaZVZcCmnJuAAFMgRMCV-PYQDN+by6ZKsL1RczFhV1YajR8trNvHB-JagA)
 
-### Example
+TypeBox includes a high-performance JIT compiler that supports JSON Schema Draft 3 through to 2020-12. It is designed to be a lightweight industry-grade alternative to Ajv and offers improved compilation and validation performance. It also provides automatic fallback to dynamic validation in JIT restricted environments such as Cloudflare Workers.
 
-The following uses the Schema submodule to compile a TypeBox type.
+The compiler is available via optional sub module import.
 
 ```typescript
 import Schema from 'typebox/schema'
+```
 
-// Compile
+### Compile
 
-const User = Schema.Compile(Type.Object({        // const User = Validator<Type.TObject<{
-  id: Type.String(),                             //   id: Type.TString;
-  name: Type.String(),                           //   name: Type.TString;
-  email: Type.String({ format: 'email' })        //   email: Type.TString;
-}))                                              // }>, { ... }>
+The compiler accepts JSON Schema and returns Validator instances.
 
-// Parse
+```typescript
+const Vector = Schema.Compile(Type.Object({       // const Vector: Validator<TObject<{
+  x: Type.Number(),                                //   x: TNumber
+  y: Type.Number(),                                //   y: TNumber
+  z: Type.Number()                                 //   z: TNumber
+}))                                                // }>>
+```
+With JSON Schema
+```typescript
+const Vector = Schema.Compile({                    // const Vector: Validator<{
+  type: 'object',                                  //   type: "object";
+  required: ['x', 'y', 'z'],                       //   required: ["x", "y", "z"];
+  properties: {                                    //   properties: { ... };
+    x: { type: 'number' },                         // }, { ... }>
+    y: { type: 'number' },
+    z: { type: 'number' }
+  }
+})
+```
+
+### Validate
 
-const user = User.Parse({                        // const user: {
-  id: '65f1a2b3c4d5e6f7a8b9c0d1',                //   id: string,
-  name: 'user',                                  //   name: string,
-  email: 'user@domain.com'                       //   email: string
-})                                               // } = ...
+Validator instances provide functions to Check and Parse values.
 
+```typescript
+const Vector = Schema.Compile(Type.Script(`{
+  x: number
+  y: number
+  z: number
+}`))
+
+const valid = Vector.Check({                       // const valid: boolean
+  x: 1,
+  y: 0,
+  z: 0
+}) 
+
+const value = Vector.Parse({                       // const value: {      
+  x: 1,                                            //   x: number
+  y: 0,                                            //   y: number
+  z: 0                                             //   z: number
+})                                                 // }
 ```
 
+
+
 ### Coverage
 
 The following table shows specification coverage implemented by TypeBox.
@@ -281,29 +295,29 @@ The following table shows compile performance for various JSON Schema structures
 ┌──────────────────────┬─────────────┬─────────────┐
 │ Compile              │ TB1X        │ AJV8        │
 ├──────────────────────┼─────────────┼─────────────┤
-│ Boolean              │ 29.2K ops/s │  7.1K ops/s │
-│ Number               │ 34.5K ops/s │  7.6K ops/s │
-│ String               │ 48.9K ops/s │  8.7K ops/s │
-│ Null                 │ 39.6K ops/s │  7.6K ops/s │
-│ Literal_String       │ 46.8K ops/s │  6.8K ops/s │
-│ Literal_Number       │ 48.3K ops/s │  7.4K ops/s │
-│ Literal_Boolean      │ 48.8K ops/s │  7.3K ops/s │
-│ Pattern              │ 32.5K ops/s │  6.1K ops/s │
-│ Object_Open          │  6.6K ops/s │  1.4K ops/s │
-│ Object_Close         │  7.6K ops/s │    1K ops/s │
-│ Object_Vector3       │ 20.8K ops/s │  2.8K ops/s │
-│ Object_Basis3        │  7.5K ops/s │    1K ops/s │
-│ Intersect_And        │   23K ops/s │  3.9K ops/s │
-│ Intersect_Structural │  8.7K ops/s │  1.2K ops/s │
-│ Union_Or             │ 17.9K ops/s │  3.4K ops/s │
-│ Union_Structural     │ 11.3K ops/s │  2.1K ops/s │
-│ Tuple_Values         │  9.6K ops/s │  2.1K ops/s │
-│ Tuple_Objects        │  2.1K ops/s │   350 ops/s │
-│ Array_Numbers_4      │ 33.6K ops/s │  4.2K ops/s │
-│ Array_Numbers_8      │   39K ops/s │  3.7K ops/s │
-│ Array_Numbers_16     │ 29.6K ops/s │  3.8K ops/s │
-│ Array_Objects_Open   │  7.7K ops/s │   833 ops/s │
-│ Array_Objects_Close  │  7.6K ops/s │   860 ops/s │
+│ Boolean              │ 39.7K ops/s │  6.8K ops/s │
+│ Number               │ 86.2K ops/s │  7.5K ops/s │
+│ String               │ 82.6K ops/s │  8.2K ops/s │
+│ Null                 │   62K ops/s │  7.3K ops/s │
+│ Literal_String       │ 72.1K ops/s │  5.7K ops/s │
+│ Literal_Number       │ 72.7K ops/s │  6.9K ops/s │
+│ Literal_Boolean      │ 80.9K ops/s │    7K ops/s │
+│ Pattern              │ 38.7K ops/s │  5.7K ops/s │
+│ Object_Open          │ 16.3K ops/s │  1.3K ops/s │
+│ Object_Close         │ 15.7K ops/s │   952 ops/s │
+│ Object_Vector3       │ 40.2K ops/s │  3.2K ops/s │
+│ Object_Basis3        │ 16.1K ops/s │   834 ops/s │
+│ Intersect_And        │ 45.7K ops/s │  3.5K ops/s │
+│ Intersect_Structural │   21K ops/s │  1.6K ops/s │
+│ Union_Or             │ 45.1K ops/s │  3.4K ops/s │
+│ Union_Structural     │ 27.6K ops/s │    2K ops/s │
+│ Tuple_Values         │ 14.7K ops/s │    2K ops/s │
+│ Tuple_Objects        │  3.7K ops/s │   380 ops/s │
+│ Array_Numbers_4      │ 73.6K ops/s │  4.3K ops/s │
+│ Array_Numbers_8      │ 50.9K ops/s │  3.8K ops/s │
+│ Array_Numbers_16     │   85K ops/s │  3.9K ops/s │
+│ Array_Objects_Open   │ 18.9K ops/s │   789 ops/s │
+│ Array_Objects_Close  │ 17.9K ops/s │   909 ops/s │
 └──────────────────────┴─────────────┴─────────────┘
 ```
 

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

@@ -1,6 +1,6 @@
 {
 	"name": "@earendil-works/pi-coding-agent",
-	"version": "0.82.1",
+	"version": "0.84.0",
 	"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 ./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.82.1",
-		"@earendil-works/pi-ai": "^0.82.1",
-		"@earendil-works/pi-tui": "^0.82.1",
+		"@earendil-works/pi-agent-core": "^0.84.0",
+		"@earendil-works/pi-ai": "^0.84.0",
+		"@earendil-works/pi-client": "^0.84.0",
+		"@earendil-works/pi-protocol": "^0.84.0",
+		"@earendil-works/pi-tui": "^0.84.0",
 		"@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",
@@ -54,8 +61,8 @@
 		"minimatch": "10.2.5",
 		"proper-lockfile": "4.1.2",
 		"semver": "7.8.0",
-		"typebox": "1.1.38",
-		"undici": "8.5.0",
+		"typebox": "1.3.7",
+		"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