@tensnap/protocol 0.2.0

package/README.md

@@ -0,0 +1,143 @@
+# @tensnap/protocol
+
+`@tensnap/protocol` is the source of truth for TenSnap protocol v0.2 payload
+shapes, runtime schemas, and wire codecs.
+
+The package is intentionally about the renderer/simulator contract only. It
+does not define rendering layers, React state, storage adapters, project UI, or
+concrete WebSocket implementations.
+
+## Source Files
+
+- [src/types.ts](./src/types.ts): message envelopes and payload interfaces.
+- [src/schemas.ts](./src/schemas.ts): runtime zod schemas for protocol payloads.
+- [src/codec.ts](./src/codec.ts): JSON and MessagePack protocol codecs.
+- [src/binary.ts](./src/binary.ts): base64 and data URL handling for binary semantic fields.
+- [src/controls.ts](./src/controls.ts): parameter and action payload definitions.
+- [src/chart.ts](./src/chart.ts): chart metadata and update payload definitions.
+- [src/asset.ts](./src/asset.ts): asset metadata payload definitions.
+
+To export the complete TypeScript definitions into Markdown:
+
+```bash
+pnpm --dir packages/protocol export:types protocol-types.md
+```
+
+Omit the output path to print the Markdown to stdout.
+
+## Scope
+
+Protocol v0.2 defines:
+
+- the wire format between a simulator and a renderer;
+- canonical message families and payload shapes;
+- runtime schemas used to validate protocol payloads;
+- JSON and MessagePack encoding rules;
+- ownership boundaries for state synchronization, assets, screenshots,
+  parameters, actions, charts, environments, layers, and layer items.
+
+Protocol v0.2 does not define:
+
+- a concrete WebSocket, postMessage, or SSE implementation;
+- renderer-specific Scenario stores or project UI state;
+- React, Zustand, Tauri, browser file-system behavior, or layout state;
+- drawing libraries, canvas layers, charts, or component rendering.
+
+## Architectural Model
+
+Protocol v0.2 is organized around one rule:
+
+**The renderer owns synchronized session state; the simulator is a stateless
+step executor and update producer.**
+
+The simulator owns the simulation model and emits updates. The renderer owns
+the synchronized Scenario-like state that can be replayed, inspected, rendered,
+snapshotted, and reconnected. Reconnection is therefore not a special hidden
+mode: it is a protocol-level state-sync transaction.
+
+This split keeps the protocol independent of deployment shape. A simulator may
+run in Python, Julia, Go, Node, a worker, or a process behind WebSocket. A
+renderer may be a browser app, desktop shell, benchmark harness, or headless
+agent. The payload contract stays the same.
+
+## Naming
+
+Protocol v0.2 uses renderer/simulator terminology. Older client/server names
+are not part of the v0.2 contract.
+
+| Old term | v0.2 term |
+| --- | --- |
+| client | renderer |
+| server | simulator |
+| server -> client | simulator -> renderer |
+| client -> server | renderer -> simulator |
+
+## Message Families
+
+Simulator-to-renderer messages:
+
+- scenario metadata and sync boundaries: `metadata_update`,
+  `state_sync_begin`, `state_sync_end`;
+- controls: `action_create`, `action_update`, `action_delete`, `action_end`,
+  `param_create`, `param_update`, `param_delete`, `param_sync`;
+- environments and layers: `env_create`, `env_delete`, `env_layer_create`,
+  `env_layer_update`, `env_layer_delete`;
+- layer items: `item_create`, `item_update`, `item_delete`;
+- charts, assets, screenshots, and diagnostics: `chart_create`,
+  `chart_update`, `chart_delete`, `asset_meta`, `asset_data`,
+  `asset_delete`, `screenshot_request`, `log`, `error`.
+
+Renderer-to-simulator messages:
+
+- `state_sync`;
+- `param_change`;
+- `action_start`;
+- `asset_sync`;
+- `screenshot_response`;
+- `error`.
+
+## Event Loop
+
+Continuous simulation is renderer-driven:
+
+1. The renderer sends `action_start` for a continuous action.
+2. The simulator advances its model and emits state updates.
+3. The simulator sends `action_end` with timing metadata and an optional
+   `continue` flag.
+4. The renderer decides whether to schedule the next `action_start`.
+
+This avoids a simulator-owned hidden loop. The renderer can pause, throttle,
+drop frames, reconnect, or cancel continuous actions without inventing a second
+control channel.
+
+## State Sync
+
+`state_sync` is a renderer-to-simulator request containing the renderer's
+current definitions for parameters, actions, environments, layers, and charts.
+The simulator replies by replaying the required create/update/delete messages.
+
+That replay is bracketed by `state_sync_begin` and `state_sync_end`, making
+initial sync and reconnect a transaction rather than a timing convention.
+
+## Binary Payloads
+
+The protocol has binary semantic fields, notably `asset_data.data` and
+`screenshot_response.data`.
+
+JSON transports encode those fields as base64 data URLs. MessagePack transports
+preserve bytes as `Uint8Array`. The codec normalizes both directions so callers
+work with the same semantic message shape.
+
+See [src/codec.ts](./src/codec.ts) and [src/binary.ts](./src/binary.ts).
+
+## Package Boundary
+
+`@tensnap/protocol` is a dependency of higher-level packages:
+
+- `@tensnap/core` owns renderer-side Scenario, rendering primitives, and stores.
+- `@tensnap/js` owns JavaScript simulator-side helpers and transports.
+- `@tensnap/agent` owns node-side automation/session runtime code.
+- application packages own concrete UI and deployment behavior.
+
+Those packages should import payload types and codecs directly from
+`@tensnap/protocol`; `@tensnap/core` is not a compatibility alias for protocol.

package/dist/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Bill Toshiaki Stark
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/asset.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+/**
+ * Asset identifiers and metadata are protocol payloads, not renderer cache
+ * objects. Renderers may resolve them into blob URLs or local buffers, but the
+ * wire contract stays content-addressed by id plus hash.
+ */
+export declare const AssetIdSchema: z.ZodString;
+export type AssetId = z.infer<typeof AssetIdSchema>;
+export declare const AssetMetaSchema: z.ZodObject<{
+    id: z.ZodString;
+    hash: z.ZodString;
+    mime: z.ZodString;
+    size: z.ZodNumber;
+    label: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AssetMeta = z.infer<typeof AssetMetaSchema>;
+//# sourceMappingURL=asset.d.ts.map

package/dist/asset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset.d.ts","sourceRoot":"","sources":["../src/asset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,aAAa,aAAa,CAAC;AAExC,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,eAAO,MAAM,eAAe;;;;;;iBAM1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/asset.js

@@ -0,0 +1,15 @@
+// src/asset.ts
+import { z } from "zod";
+var AssetIdSchema = z.string();
+var AssetMetaSchema = z.object({
+  id: AssetIdSchema,
+  hash: z.string(),
+  mime: z.string(),
+  size: z.number(),
+  label: z.string().optional()
+});
+export {
+  AssetIdSchema,
+  AssetMetaSchema
+};
+//# sourceMappingURL=asset.js.map

package/dist/asset.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/asset.ts"],
+  "sourcesContent": ["import { z } from 'zod';\n\n/**\n * Asset identifiers and metadata are protocol payloads, not renderer cache\n * objects. Renderers may resolve them into blob URLs or local buffers, but the\n * wire contract stays content-addressed by id plus hash.\n */\nexport const AssetIdSchema = z.string();\n\nexport type AssetId = z.infer<typeof AssetIdSchema>;\n\nexport const AssetMetaSchema = z.object({\n  id: AssetIdSchema,\n  hash: z.string(),\n  mime: z.string(),\n  size: z.number(),\n  label: z.string().optional(),\n});\n\nexport type AssetMeta = z.infer<typeof AssetMetaSchema>;\n"],
+  "mappings": ";AAAA,SAAS,SAAS;AAOX,IAAM,gBAAgB,EAAE,OAAO;AAI/B,IAAM,kBAAkB,EAAE,OAAO;AAAA,EACtC,IAAI;AAAA,EACJ,MAAM,EAAE,OAAO;AAAA,EACf,MAAM,EAAE,OAAO;AAAA,EACf,MAAM,EAAE,OAAO;AAAA,EACf,OAAO,EAAE,OAAO,EAAE,SAAS;AAC7B,CAAC;",
+  "names": []
+}

package/dist/binary.d.ts

@@ -0,0 +1,10 @@
+export interface DecodedBinaryString {
+    bytes: Uint8Array;
+    mime?: string;
+    encoding: 'base64' | 'data-url';
+}
+export declare function encodeBytesAsBase64(bytes: Uint8Array): string;
+export declare function encodeBytesAsDataUrl(bytes: Uint8Array, mime?: string): string;
+export declare function decodeBinaryString(value: string): DecodedBinaryString;
+export declare function isEncodedBinaryString(value: string): boolean;
+//# sourceMappingURL=binary.d.ts.map

package/dist/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../src/binary.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,GAAG,UAAU,CAAC;CACjC;AAMD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAe7D;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,UAAU,EACjB,IAAI,SAA6B,GAChC,MAAM,CAER;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAMrE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE5D"}

package/dist/binary.js

@@ -0,0 +1,95 @@
+// src/binary.ts
+var BASE64_DATA_URL_MARKER = ";base64,";
+function getGlobalBuffer() {
+  return globalThis.Buffer;
+}
+function encodeBytesAsBase64(bytes) {
+  const buffer = getGlobalBuffer();
+  if (buffer) {
+    return buffer.from(bytes).toString("base64");
+  }
+  if (typeof btoa === "function") {
+    let binary = "";
+    for (let index = 0; index < bytes.length; index += 1) {
+      binary += String.fromCharCode(bytes[index]);
+    }
+    return btoa(binary);
+  }
+  throw new Error("No base64 encoder is available in this runtime.");
+}
+function encodeBytesAsDataUrl(bytes, mime = "application/octet-stream") {
+  return `data:${mime};base64,${encodeBytesAsBase64(bytes)}`;
+}
+function decodeBinaryString(value) {
+  const decoded = tryDecodeBinaryString(value);
+  if (!decoded) {
+    throw new Error("Expected a base64 string or a base64 data URL.");
+  }
+  return decoded;
+}
+function isEncodedBinaryString(value) {
+  return tryDecodeBinaryString(value) !== null;
+}
+function tryDecodeBinaryString(value) {
+  if (value.startsWith("data:")) {
+    const dataUrl = tryDecodeBase64DataUrl(value);
+    if (dataUrl) {
+      return dataUrl;
+    }
+  }
+  const bytes = tryDecodeBase64(value);
+  if (!bytes) {
+    return null;
+  }
+  return {
+    bytes,
+    encoding: "base64"
+  };
+}
+function tryDecodeBase64DataUrl(value) {
+  const markerIndex = value.indexOf(BASE64_DATA_URL_MARKER);
+  if (markerIndex === -1) {
+    return null;
+  }
+  const mime = value.slice(5, markerIndex) || void 0;
+  const base64 = value.slice(markerIndex + BASE64_DATA_URL_MARKER.length);
+  const bytes = tryDecodeBase64(base64);
+  if (!bytes) {
+    return null;
+  }
+  return {
+    bytes,
+    mime,
+    encoding: "data-url"
+  };
+}
+function tryDecodeBase64(value) {
+  const normalized = value.replace(/\s+/g, "");
+  if (!normalized || normalized.length % 4 !== 0 || /[^A-Za-z0-9+/=]/.test(normalized)) {
+    return null;
+  }
+  try {
+    const buffer = getGlobalBuffer();
+    if (buffer) {
+      return new Uint8Array(buffer.from(normalized, "base64"));
+    }
+    if (typeof atob === "function") {
+      const binary = atob(normalized);
+      const bytes = new Uint8Array(binary.length);
+      for (let index = 0; index < binary.length; index += 1) {
+        bytes[index] = binary.charCodeAt(index);
+      }
+      return bytes;
+    }
+  } catch {
+    return null;
+  }
+  throw new Error("No base64 decoder is available in this runtime.");
+}
+export {
+  decodeBinaryString,
+  encodeBytesAsBase64,
+  encodeBytesAsDataUrl,
+  isEncodedBinaryString
+};
+//# sourceMappingURL=binary.js.map

package/dist/binary.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/binary.ts"],
+  "sourcesContent": ["const BASE64_DATA_URL_MARKER = ';base64,';\n\ninterface BufferEncoderResult {\n  toString(encoding: 'base64'): string;\n}\n\ninterface BufferLike {\n  from(data: Uint8Array): BufferEncoderResult;\n  from(data: string, encoding: 'base64'): ArrayLike<number>;\n}\n\nexport interface DecodedBinaryString {\n  bytes: Uint8Array;\n  mime?: string;\n  encoding: 'base64' | 'data-url';\n}\n\nfunction getGlobalBuffer(): BufferLike | undefined {\n  return (globalThis as { Buffer?: BufferLike }).Buffer;\n}\n\nexport function encodeBytesAsBase64(bytes: Uint8Array): string {\n  const buffer = getGlobalBuffer();\n  if (buffer) {\n    return buffer.from(bytes).toString('base64');\n  }\n\n  if (typeof btoa === 'function') {\n    let binary = '';\n    for (let index = 0; index < bytes.length; index += 1) {\n      binary += String.fromCharCode(bytes[index]);\n    }\n    return btoa(binary);\n  }\n\n  throw new Error('No base64 encoder is available in this runtime.');\n}\n\nexport function encodeBytesAsDataUrl(\n  bytes: Uint8Array,\n  mime = 'application/octet-stream',\n): string {\n  return `data:${mime};base64,${encodeBytesAsBase64(bytes)}`;\n}\n\nexport function decodeBinaryString(value: string): DecodedBinaryString {\n  const decoded = tryDecodeBinaryString(value);\n  if (!decoded) {\n    throw new Error('Expected a base64 string or a base64 data URL.');\n  }\n  return decoded;\n}\n\nexport function isEncodedBinaryString(value: string): boolean {\n  return tryDecodeBinaryString(value) !== null;\n}\n\nfunction tryDecodeBinaryString(value: string): DecodedBinaryString | null {\n  if (value.startsWith('data:')) {\n    const dataUrl = tryDecodeBase64DataUrl(value);\n    if (dataUrl) {\n      return dataUrl;\n    }\n  }\n\n  const bytes = tryDecodeBase64(value);\n  if (!bytes) {\n    return null;\n  }\n\n  return {\n    bytes,\n    encoding: 'base64',\n  };\n}\n\nfunction tryDecodeBase64DataUrl(value: string): DecodedBinaryString | null {\n  const markerIndex = value.indexOf(BASE64_DATA_URL_MARKER);\n  if (markerIndex === -1) {\n    return null;\n  }\n\n  const mime = value.slice(5, markerIndex) || undefined;\n  const base64 = value.slice(markerIndex + BASE64_DATA_URL_MARKER.length);\n  const bytes = tryDecodeBase64(base64);\n  if (!bytes) {\n    return null;\n  }\n\n  return {\n    bytes,\n    mime,\n    encoding: 'data-url',\n  };\n}\n\nfunction tryDecodeBase64(value: string): Uint8Array | null {\n  const normalized = value.replace(/\\s+/g, '');\n  if (!normalized || normalized.length % 4 !== 0 || /[^A-Za-z0-9+/=]/.test(normalized)) {\n    return null;\n  }\n\n  try {\n    const buffer = getGlobalBuffer();\n    if (buffer) {\n      return new Uint8Array(buffer.from(normalized, 'base64'));\n    }\n\n    if (typeof atob === 'function') {\n      const binary = atob(normalized);\n      const bytes = new Uint8Array(binary.length);\n      for (let index = 0; index < binary.length; index += 1) {\n        bytes[index] = binary.charCodeAt(index);\n      }\n      return bytes;\n    }\n  } catch {\n    return null;\n  }\n\n  throw new Error('No base64 decoder is available in this runtime.');\n}\n"],
+  "mappings": ";AAAA,IAAM,yBAAyB;AAiB/B,SAAS,kBAA0C;AACjD,SAAQ,WAAuC;AACjD;AAEO,SAAS,oBAAoB,OAA2B;AAC7D,QAAM,SAAS,gBAAgB;AAC/B,MAAI,QAAQ;AACV,WAAO,OAAO,KAAK,KAAK,EAAE,SAAS,QAAQ;AAAA,EAC7C;AAEA,MAAI,OAAO,SAAS,YAAY;AAC9B,QAAI,SAAS;AACb,aAAS,QAAQ,GAAG,QAAQ,MAAM,QAAQ,SAAS,GAAG;AACpD,gBAAU,OAAO,aAAa,MAAM,KAAK,CAAC;AAAA,IAC5C;AACA,WAAO,KAAK,MAAM;AAAA,EACpB;AAEA,QAAM,IAAI,MAAM,iDAAiD;AACnE;AAEO,SAAS,qBACd,OACA,OAAO,4BACC;AACR,SAAO,QAAQ,IAAI,WAAW,oBAAoB,KAAK,CAAC;AAC1D;AAEO,SAAS,mBAAmB,OAAoC;AACrE,QAAM,UAAU,sBAAsB,KAAK;AAC3C,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AACA,SAAO;AACT;AAEO,SAAS,sBAAsB,OAAwB;AAC5D,SAAO,sBAAsB,KAAK,MAAM;AAC1C;AAEA,SAAS,sBAAsB,OAA2C;AACxE,MAAI,MAAM,WAAW,OAAO,GAAG;AAC7B,UAAM,UAAU,uBAAuB,KAAK;AAC5C,QAAI,SAAS;AACX,aAAO;AAAA,IACT;AAAA,EACF;AAEA,QAAM,QAAQ,gBAAgB,KAAK;AACnC,MAAI,CAAC,OAAO;AACV,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL;AAAA,IACA,UAAU;AAAA,EACZ;AACF;AAEA,SAAS,uBAAuB,OAA2C;AACzE,QAAM,cAAc,MAAM,QAAQ,sBAAsB;AACxD,MAAI,gBAAgB,IAAI;AACtB,WAAO;AAAA,EACT;AAEA,QAAM,OAAO,MAAM,MAAM,GAAG,WAAW,KAAK;AAC5C,QAAM,SAAS,MAAM,MAAM,cAAc,uBAAuB,MAAM;AACtE,QAAM,QAAQ,gBAAgB,MAAM;AACpC,MAAI,CAAC,OAAO;AACV,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,UAAU;AAAA,EACZ;AACF;AAEA,SAAS,gBAAgB,OAAkC;AACzD,QAAM,aAAa,MAAM,QAAQ,QAAQ,EAAE;AAC3C,MAAI,CAAC,cAAc,WAAW,SAAS,MAAM,KAAK,kBAAkB,KAAK,UAAU,GAAG;AACpF,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,SAAS,gBAAgB;AAC/B,QAAI,QAAQ;AACV,aAAO,IAAI,WAAW,OAAO,KAAK,YAAY,QAAQ,CAAC;AAAA,IACzD;AAEA,QAAI,OAAO,SAAS,YAAY;AAC9B,YAAM,SAAS,KAAK,UAAU;AAC9B,YAAM,QAAQ,IAAI,WAAW,OAAO,MAAM;AAC1C,eAAS,QAAQ,GAAG,QAAQ,OAAO,QAAQ,SAAS,GAAG;AACrD,cAAM,KAAK,IAAI,OAAO,WAAW,KAAK;AAAA,MACxC;AACA,aAAO;AAAA,IACT;AAAA,EACF,QAAQ;AACN,WAAO;AAAA,EACT;AAEA,QAAM,IAAI,MAAM,iDAAiD;AACnE;",
+  "names": []
+}

package/dist/chart.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+/**
+ * Protocol-level chart types describe series identity and updates only. Chart
+ * rendering config, layouts, and UI-specific storage live in renderer packages.
+ */
+export declare const ChartMetadataSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    color: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ChartMetadata = z.infer<typeof ChartMetadataSchema>;
+export declare const ChartGroupMetadataSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    color: z.ZodOptional<z.ZodString>;
+    dataList: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        color: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type ChartGroupMetadata = z.infer<typeof ChartGroupMetadataSchema>;
+export declare const ChartUpdateDataSchema: z.ZodObject<{
+    id: z.ZodString;
+    time: z.ZodOptional<z.ZodNumber>;
+    value: z.ZodUnknown;
+}, z.core.$strip>;
+export type ChartUpdateData = z.infer<typeof ChartUpdateDataSchema>;
+export declare const ChartUpdateOperationSchema: z.ZodObject<{
+    id: z.ZodString;
+    operation: z.ZodLiteral<"clear">;
+}, z.core.$strip>;
+export type ChartUpdateOperation = z.infer<typeof ChartUpdateOperationSchema>;
+//# sourceMappingURL=chart.d.ts.map

package/dist/chart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart.d.ts","sourceRoot":"","sources":["../src/chart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;iBAI9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,wBAAwB;;;;;;;;;iBAEnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,qBAAqB;;;;iBAIhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,0BAA0B;;;iBAGrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/chart.js

@@ -0,0 +1,26 @@
+// src/chart.ts
+import { z } from "zod";
+var ChartMetadataSchema = z.object({
+  id: z.string(),
+  label: z.string(),
+  color: z.string().optional()
+});
+var ChartGroupMetadataSchema = ChartMetadataSchema.extend({
+  dataList: z.array(ChartMetadataSchema).optional()
+});
+var ChartUpdateDataSchema = z.object({
+  id: z.string(),
+  time: z.number().optional(),
+  value: z.unknown()
+});
+var ChartUpdateOperationSchema = z.object({
+  id: z.string(),
+  operation: z.literal("clear")
+});
+export {
+  ChartGroupMetadataSchema,
+  ChartMetadataSchema,
+  ChartUpdateDataSchema,
+  ChartUpdateOperationSchema
+};
+//# sourceMappingURL=chart.js.map

package/dist/chart.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/chart.ts"],
+  "sourcesContent": ["import { z } from 'zod';\n\n/**\n * Protocol-level chart types describe series identity and updates only. Chart\n * rendering config, layouts, and UI-specific storage live in renderer packages.\n */\nexport const ChartMetadataSchema = z.object({\n  id: z.string(),\n  label: z.string(),\n  color: z.string().optional(),\n});\n\nexport type ChartMetadata = z.infer<typeof ChartMetadataSchema>;\n\nexport const ChartGroupMetadataSchema = ChartMetadataSchema.extend({\n  dataList: z.array(ChartMetadataSchema).optional(),\n});\n\nexport type ChartGroupMetadata = z.infer<typeof ChartGroupMetadataSchema>;\n\nexport const ChartUpdateDataSchema = z.object({\n  id: z.string(),\n  time: z.number().optional(),\n  value: z.unknown(),\n});\n\nexport type ChartUpdateData = z.infer<typeof ChartUpdateDataSchema>;\n\nexport const ChartUpdateOperationSchema = z.object({\n  id: z.string(),\n  operation: z.literal('clear'),\n});\n\nexport type ChartUpdateOperation = z.infer<typeof ChartUpdateOperationSchema>;\n"],
+  "mappings": ";AAAA,SAAS,SAAS;AAMX,IAAM,sBAAsB,EAAE,OAAO;AAAA,EAC1C,IAAI,EAAE,OAAO;AAAA,EACb,OAAO,EAAE,OAAO;AAAA,EAChB,OAAO,EAAE,OAAO,EAAE,SAAS;AAC7B,CAAC;AAIM,IAAM,2BAA2B,oBAAoB,OAAO;AAAA,EACjE,UAAU,EAAE,MAAM,mBAAmB,EAAE,SAAS;AAClD,CAAC;AAIM,IAAM,wBAAwB,EAAE,OAAO;AAAA,EAC5C,IAAI,EAAE,OAAO;AAAA,EACb,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,OAAO,EAAE,QAAQ;AACnB,CAAC;AAIM,IAAM,6BAA6B,EAAE,OAAO;AAAA,EACjD,IAAI,EAAE,OAAO;AAAA,EACb,WAAW,EAAE,QAAQ,OAAO;AAC9B,CAAC;",
+  "names": []
+}

package/dist/codec.d.ts

@@ -0,0 +1,12 @@
+import type { AnyProtocolMessage } from './types';
+export type ProtocolEncoding = 'json' | 'msgpack';
+export declare function detectProtocolEncoding(data: string | Uint8Array | ArrayBuffer): ProtocolEncoding;
+/**
+ * Encode semantic protocol messages for a transport.
+ *
+ * JSON cannot carry bytes directly, so binary semantic fields become data URLs.
+ * MessagePack keeps those fields as Uint8Array values.
+ */
+export declare function encodeProtocolMessage(message: AnyProtocolMessage, encoding: ProtocolEncoding): string | Uint8Array;
+export declare function decodeProtocolMessage(data: string | Uint8Array | ArrayBuffer): AnyProtocolMessage;
+//# sourceMappingURL=codec.d.ts.map

package/dist/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../src/codec.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAAC;AAElD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,gBAAgB,CAEhG;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,gBAAgB,GACzB,MAAM,GAAG,UAAU,CAGrB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,kBAAkB,CAOjG"}