@jigs.design/protocol 0.3.1 → 0.3.3

package/dist/parse.d.ts

@@ -4,7 +4,6 @@ export declare function parseErrorData(value: unknown): JigsErrorData | null;
 /** The `invalidate` list of a mutation's reply. */
 export declare function parseInvalidations(value: unknown): ReadonlyArray<Invalidation> | null;
 export declare function parseProgram(value: unknown): Program | null;
-/** A page request's reply body, or null when it is not one. */
 export declare function parsePageReply(value: unknown): PageReply | null;
 /** One session event from its JSON text, or null when it is not one. */
 export declare function parseSessionEvent(text: string): SessionEvent | null;

package/dist/parse.js

@@ -133,11 +133,19 @@ function parseDiagnostics(value) {
 	});
 }
 /** A page request's reply body, or null when it is not one. */
+/** A page's provided data: a record, as the server sends it; missing reads as empty. */
+function parsePageData(value) {
+	if (value === void 0) return {};
+	if (!isRecord(value)) return null;
+	return value;
+}
 function parsePageReply(value) {
 	if (!isRecord(value) || !isString(value.version)) return null;
 	const program = parseProgram(value.program);
 	const diagnostics = parseDiagnostics(value.diagnostics);
-	return program === null || diagnostics === null ? null : {
+	const data = parsePageData(value.data);
+	return program === null || diagnostics === null || data === null ? null : {
+		data,
 		diagnostics,
 		program,
 		version: value.version

package/dist/types.d.ts

@@ -157,10 +157,16 @@ export interface PageInvalidation<TName extends string = string> {
 /**
  * The answer to a page request, `POST { type: "page", name, props }`: the
  * page's program, its diagnostics (a saved page is compiled leniently, so
- * they may hold errors), and the server's `jigs-version`, so a client can
- * drop programs an older server compiled.
+ * they may hold errors), the provided data the page keeps, and the server's
+ * `jigs-version`, so a client can drop programs an older server compiled.
  */
 export interface PageReply {
+  /**
+   * Provided data the page is drawn with, by slot: what `resolvePage` kept
+   * with a saved page. Empty for a shipped page. A server before 0.3.3
+   * sends none, which the client reads as empty.
+   */
+  data: Readonly<Record<string, JsonValue>>;
   diagnostics: ReadonlyArray<Diagnostic>;
   program: Program;
   version: string;
@@ -196,6 +202,13 @@ export interface ChatBlock {
   /** The checked source, with its pragma. Store this, not the program. */
   source: string;
   status: ChatBlockStatus;
+  /**
+   * Set when the block reads the `toolResults` slot (a server with
+   * `toolResults: true`): the tool names it reads, or `"all"` when it uses
+   * the results whole. `toolData` passes the block only these. Derived from
+   * the source on every compile, never trusted for more than trimming.
+   */
+  toolKeys?: ReadonlyArray<string> | "all";
   /** 1 for the first block with this name in the conversation, then 2, 3… */
   version: number;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jigs.design/protocol",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "The program format, the diagnostics, and the types and messages the server, the browser and the sandbox share. No runtime and no dependencies.",
   "license": "MIT",
   "repository": {