@nyte-ai/plugin 0.0.24 → 0.0.25-beta.1

package/dist/chunks/{bash-description-qnwggxq3.js → bash-description-1neewp76.js}

@@ -4,22 +4,33 @@ import {
 
 // src/canvas/schema.ts
 import { definePart } from "@nyte-ai/core";
-import { standard } from "@nyte-ai/schema";
+import { idSchema, standard } from "@nyte-ai/schema";
 import { Type } from "typebox";
-var state = standard(Type.Object({
+var CANVAS_RENDER_TOOL2 = "canvas_render";
+var CANVAS_REVISIONS_KEPT2 = 50;
+var drawn = {
   runtime: Type.Integer({ minimum: 1 }),
   title: Type.String({ minLength: 1, maxLength: 120 }),
+  height: Type.Union([Type.Number(), Type.Null()])
+};
+var revision = Type.Object({
+  number: Type.Integer({ minimum: 1 }),
+  blob: idSchema(),
+  ...drawn,
+  at: Type.Number()
+});
+var state = standard(Type.Object({
+  ...drawn,
   code: Type.String({ maxLength: CANVAS_CODE_LIMIT2 }),
-  height: Type.Union([Type.Number(), Type.Null()]),
-  error: Type.Union([Type.String(), Type.Null()])
+  error: Type.Union([Type.String(), Type.Null()]),
+  revisions: Type.Optional(Type.Array(revision, { maxItems: CANVAS_REVISIONS_KEPT2 }))
 }));
 var actions = {
   replace: {
     input: standard(Type.Object({
-      runtime: Type.Integer({ minimum: 1 }),
-      title: Type.String({ minLength: 1, maxLength: 120 }),
+      ...drawn,
       code: Type.String({ maxLength: CANVAS_CODE_LIMIT2 }),
-      height: Type.Union([Type.Number(), Type.Null()])
+      blob: idSchema()
     }))
   },
   report: {
@@ -33,4 +44,4 @@ var canvas2 = definePart({
   fallback: (current, { id }) => `Canvas ${id}: ${current.title}.${current.error === null ? "" : ` It failed to render: ${current.error}. Fix it by calling canvas_render with canvas "${id}".`}`
 });
 
-export { canvas2 };
+export { CANVAS_RENDER_TOOL2, CANVAS_REVISIONS_KEPT2, canvas2 };

package/dist/chunks/{bash-description-necnb2k7.js → bash-description-eqp7ap2w.js}

@@ -15,7 +15,7 @@ import { processEnvironment } from "@nyte-ai/core";
 // package.json
 var package_default = {
   name: "@nyte-ai/plugin",
-  version: "0.0.24",
+  version: "0.0.25-beta.1",
   private: false,
   license: "MIT",
   repository: {
@@ -190,7 +190,7 @@ var package_default = {
   scripts: {
     clean: "rm -rf node_modules .turbo",
     test: "vitest --run",
-    typecheck: "tsrs --noEmit",
+    typecheck: "tsc --noEmit",
     "build:package": "bun ../../scripts/sdk-packages.mjs build plugin"
   },
   dependencies: {
@@ -215,7 +215,6 @@ var package_default = {
     "@types/node": "^26.6.5",
     "@types/react": "^19.3.0",
     react: "^19.3.1",
-    typescript: "6.0.3",
     vitest: "^5.0.5"
   },
   peerDependencies: {

package/dist/src/acp/connection.js

@@ -1,6 +1,6 @@
 import {
   AcpProcess2
-} from "../../chunks/bash-description-necnb2k7.js";
+} from "../../chunks/bash-description-eqp7ap2w.js";
 import"../../chunks/bash-description-svrhh5a5.js";
 import"../../chunks/bash-description-9nn3yp18.js";
 export {

package/dist/src/acp/index.d.ts

@@ -25,11 +25,11 @@ export declare function acpAgents(options?: {
         id: string;
         contribute: {
             tools: ToolDefinition<{
+                thread: string;
                 id: string;
-                kind: string;
                 title: string;
+                kind: string;
                 input: Record<string, unknown>;
-                thread: string;
                 paths: string[];
             }, unknown>[];
         };
@@ -39,7 +39,7 @@ export declare function acpAgents(options?: {
             readonly contribute: import("@nyte-ai/core").Registries<"core">;
             readonly storage: import("@nyte-ai/core").PluginStorage;
             readonly signal: AbortSignal;
-            hook<N extends "session_activated" | "before_send" | "run_started" | "transform_transcript" | "before_compaction" | "before_request" | "before_tool" | "after_tool" | "after_request" | "run_ended">(name: N, entry: import("@nyte-ai/core").HookEntry<"core", N>): import("@nyte-ai/schema").Disposer;
+            hook<N extends import("@nyte-ai/core").HookName<"core">>(name: N, entry: import("@nyte-ai/core").HookEntry<"core", N>): import("@nyte-ai/schema").Disposer;
             report(issue: import("@nyte-ai/schema").ValidationIssue): void;
             reload(): void;
         } & {

package/dist/src/acp/index.js

@@ -8,7 +8,7 @@ import {
 import"../../chunks/bash-description-svrhh5a5.js";
 import {
   AcpProcess2
-} from "../../chunks/bash-description-necnb2k7.js";
+} from "../../chunks/bash-description-eqp7ap2w.js";
 import"../../chunks/bash-description-4vz9pxyx.js";
 import {
   registryEntries2,

package/dist/src/approvals/approvals.d.ts

@@ -32,6 +32,7 @@ export declare function approvalReason(policy: ApprovalPolicy, tool: ApprovalToo
  * @since 0.1.0
  */
 export declare const approval: import("@nyte-ai/core").PartDefinition<{
+    tool: string;
     class: {
         kind: "read";
         path: string;
@@ -42,21 +43,20 @@ export declare const approval: import("@nyte-ai/core").PartDefinition<{
         kind: "edit";
         path: string;
     } | {
-        description?: string | undefined;
         kind: "shell";
         command: string;
+        description?: string | undefined;
     } | {
         kind: "delegate";
-        title: string | null;
-        role: "read" | "task" | "create" | "send" | "await" | "stop";
         child: import("@nyte-ai/schema").Id<"session"> | null;
+        role: "await" | "create" | "read" | "send" | "stop" | "task";
+        title: string | null;
     } | {
         kind: "custom";
         label: string;
     };
-    reason: "edit" | "shell" | "tool" | "outside";
-    tool: string;
-    decision: "session" | "once" | "deny" | null;
+    reason: "edit" | "outside" | "shell" | "tool";
+    decision: "deny" | "once" | "session" | null;
 }, {
     once: {
         input: import("@nyte-ai/schema").Schema<object>;
@@ -89,6 +89,7 @@ declare const _default: {
     id: string;
     contribute: {
         parts: import("@nyte-ai/core").PartDefinition<{
+            tool: string;
             class: {
                 kind: "read";
                 path: string;
@@ -99,21 +100,20 @@ declare const _default: {
                 kind: "edit";
                 path: string;
             } | {
-                description?: string | undefined;
                 kind: "shell";
                 command: string;
+                description?: string | undefined;
             } | {
                 kind: "delegate";
-                title: string | null;
-                role: "read" | "task" | "create" | "send" | "await" | "stop";
                 child: import("@nyte-ai/schema").Id<"session"> | null;
+                role: "await" | "create" | "read" | "send" | "stop" | "task";
+                title: string | null;
             } | {
                 kind: "custom";
                 label: string;
             };
-            reason: "edit" | "shell" | "tool" | "outside";
-            tool: string;
-            decision: "session" | "once" | "deny" | null;
+            reason: "edit" | "outside" | "shell" | "tool";
+            decision: "deny" | "once" | "session" | null;
         }, {
             once: {
                 input: import("@nyte-ai/schema").Schema<object>;
@@ -143,14 +143,14 @@ declare const _default: {
                 readonly kind: "edit";
                 readonly path: string;
             } | {
-                readonly description?: string | undefined;
                 readonly kind: "shell";
                 readonly command: string;
+                readonly description?: string | undefined;
             } | {
                 readonly kind: "delegate";
-                readonly title: string | null;
-                readonly role: "read" | "task" | "create" | "send" | "await" | "stop";
                 readonly child: import("@nyte-ai/schema").Id<"session"> | null;
+                readonly role: "await" | "create" | "read" | "send" | "stop" | "task";
+                readonly title: string | null;
             } | {
                 readonly kind: "custom";
                 readonly label: string;
@@ -162,7 +162,7 @@ declare const _default: {
                 readonly contribute: import("@nyte-ai/core").Registries<"core">;
                 readonly storage: import("@nyte-ai/core").PluginStorage;
                 readonly signal: AbortSignal;
-                hook<N extends "session_activated" | "before_send" | "run_started" | "transform_transcript" | "before_compaction" | "before_request" | "before_tool" | "after_tool" | "after_request" | "run_ended">(name: N, entry: import("@nyte-ai/core").HookEntry<"core", N>): import("@nyte-ai/schema").Disposer;
+                hook<N extends import("@nyte-ai/core").HookName<"core">>(name: N, entry: import("@nyte-ai/core").HookEntry<"core", N>): import("@nyte-ai/schema").Disposer;
                 report(issue: import("@nyte-ai/schema").ValidationIssue): void;
                 reload(): void;
             } & {

package/dist/src/approvals/schema.d.ts

@@ -25,6 +25,7 @@ export declare const APPROVAL_POLICIES: readonly [{
     readonly description: "Runs every tool without asking";
 }];
 declare const state: import("@nyte-ai/schema").Schema<{
+    tool: string;
     class: {
         kind: "read";
         path: string;
@@ -35,21 +36,20 @@ declare const state: import("@nyte-ai/schema").Schema<{
         kind: "edit";
         path: string;
     } | {
-        description?: string | undefined;
         kind: "shell";
         command: string;
+        description?: string | undefined;
     } | {
         kind: "delegate";
-        title: string | null;
-        role: "read" | "task" | "create" | "send" | "await" | "stop";
         child: import("@nyte-ai/schema").Id<"session"> | null;
+        role: "await" | "create" | "read" | "send" | "stop" | "task";
+        title: string | null;
     } | {
         kind: "custom";
         label: string;
     };
-    reason: "edit" | "shell" | "tool" | "outside";
-    tool: string;
-    decision: "session" | "once" | "deny" | null;
+    reason: "edit" | "outside" | "shell" | "tool";
+    decision: "deny" | "once" | "session" | null;
 }>;
 /**
  * One gated tool call: its tool, its class, why it asks (`shell`, `edit` in
@@ -87,6 +87,7 @@ export declare function approvalPrompt(current: Pick<ApprovalState, "tool" | "cl
 export declare const approval: {
     kind: string;
     state: import("@nyte-ai/schema").Schema<{
+        tool: string;
         class: {
             kind: "read";
             path: string;
@@ -97,21 +98,20 @@ export declare const approval: {
             kind: "edit";
             path: string;
         } | {
-            description?: string | undefined;
             kind: "shell";
             command: string;
+            description?: string | undefined;
         } | {
             kind: "delegate";
-            title: string | null;
-            role: "read" | "task" | "create" | "send" | "await" | "stop";
             child: import("@nyte-ai/schema").Id<"session"> | null;
+            role: "await" | "create" | "read" | "send" | "stop" | "task";
+            title: string | null;
         } | {
             kind: "custom";
             label: string;
         };
-        reason: "edit" | "shell" | "tool" | "outside";
-        tool: string;
-        decision: "session" | "once" | "deny" | null;
+        reason: "edit" | "outside" | "shell" | "tool";
+        decision: "deny" | "once" | "session" | null;
     }>;
     actions: {
         once: {
@@ -125,6 +125,7 @@ export declare const approval: {
         };
     };
     fallback: (current: {
+        tool: string;
         class: {
             kind: "read";
             path: string;
@@ -135,21 +136,20 @@ export declare const approval: {
             kind: "edit";
             path: string;
         } | {
-            description?: string | undefined;
             kind: "shell";
             command: string;
+            description?: string | undefined;
         } | {
             kind: "delegate";
-            title: string | null;
-            role: "read" | "task" | "create" | "send" | "await" | "stop";
             child: import("@nyte-ai/schema").Id<"session"> | null;
+            role: "await" | "create" | "read" | "send" | "stop" | "task";
+            title: string | null;
         } | {
             kind: "custom";
             label: string;
         };
-        reason: "edit" | "shell" | "tool" | "outside";
-        tool: string;
-        decision: "session" | "once" | "deny" | null;
+        reason: "edit" | "outside" | "shell" | "tool";
+        decision: "deny" | "once" | "session" | null;
     }, { id }: {
         readonly id: PartId;
     }) => string;

package/dist/src/bash-description.d.ts

@@ -15,7 +15,7 @@ declare const _default: {
         readonly contribute: import("@nyte-ai/core").Registries<"core">;
         readonly storage: import("@nyte-ai/core").PluginStorage;
         readonly signal: AbortSignal;
-        hook<N extends "session_activated" | "before_send" | "run_started" | "transform_transcript" | "before_compaction" | "before_request" | "before_tool" | "after_tool" | "after_request" | "run_ended">(name: N, entry: import("@nyte-ai/core").HookEntry<"core", N>): import("@nyte-ai/schema").Disposer;
+        hook<N extends import("@nyte-ai/core").HookName<"core">>(name: N, entry: import("@nyte-ai/core").HookEntry<"core", N>): import("@nyte-ai/schema").Disposer;
         report(issue: import("@nyte-ai/schema").ValidationIssue): void;
         reload(): void;
     } & {

package/dist/src/bash-description.js

@@ -1,14 +1,12 @@
 // src/bash-description.ts
+import { bashProperties } from "@nyte-ai/core";
 import { standard } from "@nyte-ai/schema";
 import { Type } from "typebox";
 var parameters = standard(Type.Object({
-  command: Type.String({ description: "The shell command to run." }),
+  ...bashProperties,
   description: Type.String({
     description: "Clear, concise description of what this command does in 5-10 words, in active voice."
-  }),
-  background: Type.Optional(Type.Boolean({
-    description: "Start the command and return a job id with its first output instead of waiting for it to exit. Use for servers, watchers, and other long-lived commands, without a trailing &. The command keeps running across turns, and you are told when it exits; read its output or stop it with the job tool. Do not use it to speed up ordinary commands."
-  }))
+  })
 }));
 var bash_description_default = {
   id: "bash-description",

package/dist/src/canvas/canvas-protocol.d.ts

@@ -48,24 +48,24 @@ export declare const TINTS: readonly ["blue", "pink", "orange", "teal", "red", "
  * answers any other import of `nyte/canvas` with a positioned error.
  */
 export declare const KIT: {
-    readonly Stack: "{ direction?: \"row\" | \"column\" = \"column\", gap?: 0 | 1 | 2 | 3 | 4 | 6 = 2 (×4 px), align?: \"start\" | \"center\" | \"end\" | \"stretch\", justify?: \"start\" | \"center\" | \"end\" | \"between\", wrap?: boolean, children }: flex layout";
-    readonly Grid: "{ columns?: number | \"auto\" = \"auto\", minWidth?: number = 160 (px, with \"auto\"), gap?: 0 | 1 | 2 | 3 | 4 | 6 = 2, children }: equal columns";
+    readonly Stack: '{ direction?: "row" | "column" = "column", gap?: 0 | 1 | 2 | 3 | 4 | 6 = 2 (×4 px), align?: "start" | "center" | "end" | "stretch", justify?: "start" | "center" | "end" | "between", wrap?: boolean, children }: flex layout';
+    readonly Grid: '{ columns?: number | "auto" = "auto", minWidth?: number = 160 (px, with "auto"), gap?: 0 | 1 | 2 | 3 | 4 | 6 = 2, children }: equal columns';
     readonly Divider: "{}: a hairline";
     readonly Heading: "{ level?: 1 | 2 | 3 = 2, children }";
-    readonly Text: "{ size?: \"xs\" | \"sm\" | \"base\" | \"lg\", tone?: \"primary\" | \"secondary\" | \"tertiary\", weight?: \"normal\" | \"medium\" | \"semibold\", mono?: boolean, truncate?: boolean, align?: \"start\" | \"center\" | \"end\", children }";
+    readonly Text: '{ size?: "xs" | "sm" | "base" | "lg", tone?: "primary" | "secondary" | "tertiary", weight?: "normal" | "medium" | "semibold", mono?: boolean, truncate?: boolean, align?: "start" | "center" | "end", children }';
     readonly Code: "{ block?: boolean, children: string }: monospace, inline or a block";
-    readonly Stat: "{ label: string, value: ReactNode, detail?: ReactNode, tone?: \"neutral\" | \"success\" | \"warning\" | \"danger\" }: a labelled number";
-    readonly Badge: "{ tone?: \"neutral\" | \"info\" | \"success\" | \"warning\" | \"danger\", children }";
-    readonly Meter: "{ value: number, max?: number = 100, label?: string, tone?: \"primary\" | \"success\" | \"warning\" | \"danger\" = \"primary\" }: a thin filled bar with the value beside the label";
-    readonly Table: "{ columns: { key: string, label: ReactNode, align?: \"start\" | \"end\", width?: number | string }[], rows: Record<string, ReactNode>[], caption?: string }: rows are keyed by column key; a cell can hold a Sparkline or a Badge";
-    readonly Callout: "{ tone?: \"info\" | \"success\" | \"warning\" | \"danger\", title?: string, children }";
+    readonly Stat: '{ label: string, value: ReactNode, detail?: ReactNode, tone?: "neutral" | "success" | "warning" | "danger" }: a labelled number';
+    readonly Badge: '{ tone?: "neutral" | "info" | "success" | "warning" | "danger", children }';
+    readonly Meter: '{ value: number, max?: number = 100, label?: string, tone?: "primary" | "success" | "warning" | "danger" = "primary" }: a thin filled bar with the value beside the label';
+    readonly Table: '{ columns: { key: string, label: ReactNode, align?: "start" | "end", width?: number | string }[], rows: Record<string, ReactNode>[], caption?: string }: rows are keyed by column key; a cell can hold a Sparkline or a Badge';
+    readonly Callout: '{ tone?: "info" | "success" | "warning" | "danger", title?: string, children }';
     readonly Card: "{ title?: ReactNode, actions?: ReactNode, padding?: 0 | 2 | 3 | 4 = 4, children }: an elevated bordered surface";
     readonly StackedBars: "{ label: string, series: { key: string, label: string, tint: Tint }[], buckets: { key: string, label: string, values: number[] }[], format: (value: number) => string, height?: number = 88, ticks?: number = 5 }: compact stacked bars without axes, a readout on pointer or arrow keys; the numbers live in the copy around it. Preferred beside a Stat or a heading figure";
     readonly Sparkline: "{ values: number[], tint?: Tint, label?: string, width?: number = 72, height?: number = 20 }: a row's trend scaled to its own peak, for a Table cell beside the row's number";
-    readonly LineChart: "{ series: { id: string, data: { x: number | string, y: number }[], tint?: Tint }[], height?: number = 240, xFormat?: (x) => string, yFormat?: (y) => string, curve?: \"linear\" | \"monotone\" | \"step\", area?: boolean, legend?: boolean }: a full chart with axes and a readout";
-    readonly BarChart: "{ data: Record<string, number | string>[], keys: (string | { key: string, label?: string, tint?: Tint })[], indexBy: string, height?: number = 240, layout?: \"vertical\" | \"horizontal\", mode?: \"grouped\" | \"stacked\" = \"stacked\", valueFormat?: (value: number) => string, legend?: boolean }: a full chart with axes and a readout with the total";
+    readonly LineChart: '{ series: { id: string, data: { x: number | string, y: number }[], tint?: Tint }[], height?: number = 240, xFormat?: (x) => string, yFormat?: (y) => string, curve?: "linear" | "monotone" | "step", area?: boolean, legend?: boolean }: a full chart with axes and a readout';
+    readonly BarChart: '{ data: Record<string, number | string>[], keys: (string | { key: string, label?: string, tint?: Tint })[], indexBy: string, height?: number = 240, layout?: "vertical" | "horizontal", mode?: "grouped" | "stacked" = "stacked", valueFormat?: (value: number) => string, legend?: boolean }: a full chart with axes and a readout with the total';
     readonly PieChart: "{ data: { id: string, value: number, label?: string, tint?: Tint }[], height?: number = 240, donut?: boolean, valueFormat?: (value: number) => string, legend?: boolean }";
-    readonly Button: "{ variant?: \"solid\" | \"outline\" | \"ghost\", pill?: boolean, size?: \"2xs\" | \"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\", tone?: \"neutral\" | \"primary\" | \"success\" | \"warning\" | \"danger\", loading?: boolean, disabled?: boolean, onClick, children }";
+    readonly Button: '{ variant?: "solid" | "outline" | "ghost", pill?: boolean, size?: "2xs" | "xs" | "sm" | "md" | "lg" | "xl", tone?: "neutral" | "primary" | "success" | "warning" | "danger", loading?: boolean, disabled?: boolean, onClick, children }';
     readonly Tabs: "Tabs.Root { value?, defaultValue?, onValueChange? } > Tabs.List { children: Tabs.Tab { value, children }[] } + Tabs.Panel { value, children }";
     readonly Select: "Select { value?, defaultValue?, onValueChange? } > SelectTrigger { children: <SelectValue /> } + SelectContent { children: SelectItem[] }";
     readonly SelectTrigger: "see Select";
@@ -83,7 +83,7 @@ export declare const KIT: {
     readonly Collapsible: "Collapsible.Root { open?, defaultOpen?, onOpenChange? } > Collapsible.Trigger { children } + Collapsible.Panel { children }";
     readonly Kbd: "{ keys: string[] }";
     readonly Spinner: "{}";
-    readonly useColorScheme: "(): \"light\" | \"dark\"";
+    readonly useColorScheme: '(): "light" | "dark"';
 };
 /** Every name `nyte/canvas` exports, in `KIT` order. */
 export declare const KIT_EXPORTS: readonly string[];

package/dist/src/canvas/canvas.d.ts

@@ -1,18 +1,27 @@
 import type { CanvasPreviewer } from "./canvas-preview.ts";
 import type { Plugin } from "@nyte-ai/plugin/core";
 export declare const canvas: import("@nyte-ai/core").PartDefinition<{
-    code: string;
     runtime: number;
     title: string;
-    error: string | null;
     height: number | null;
+    code: string;
+    error: string | null;
+    revisions?: {
+        runtime: number;
+        title: string;
+        height: number | null;
+        number: number;
+        blob: import("@nyte-ai/schema").Id<"blob">;
+        at: number;
+    }[] | undefined;
 }, {
     replace: {
         input: import("@nyte-ai/schema").Schema<{
-            code: string;
             runtime: number;
             title: string;
             height: number | null;
+            code: string;
+            blob: import("@nyte-ai/schema").Id<"blob">;
         }>;
     };
     report: {

package/dist/src/canvas/canvas.js

@@ -18,8 +18,10 @@ import {
   describeCanvasPreview2
 } from "../../chunks/bash-description-yyd9jznf.js";
 import {
+  CANVAS_RENDER_TOOL2,
+  CANVAS_REVISIONS_KEPT2,
   canvas2
-} from "../../chunks/bash-description-qnwggxq3.js";
+} from "../../chunks/bash-description-1neewp76.js";
 
 // src/canvas/canvas.ts
 import { definePart, followedTrace, traced } from "@nyte-ai/core";
@@ -27,7 +29,24 @@ import { asId, standard } from "@nyte-ai/schema";
 import { Type } from "typebox";
 var handlers = {
   async replace(input, context) {
-    const outcome = await context.part.update(() => ({ ...input, error: null }));
+    const outcome = await context.part.update((current) => ({
+      runtime: input.runtime,
+      title: input.title,
+      code: input.code,
+      height: input.height,
+      error: null,
+      revisions: [
+        ...current.revisions ?? [],
+        {
+          number: (current.revisions?.at(-1)?.number ?? 1) + 1,
+          blob: input.blob,
+          runtime: input.runtime,
+          title: input.title,
+          height: input.height,
+          at: Date.now()
+        }
+      ].slice(-CANVAS_REVISIONS_KEPT2)
+    }));
     if (outcome.kind !== "updated")
       throw new Error(`The canvas could not be replaced: ${outcome.kind}.`);
   },
@@ -99,7 +118,7 @@ ${describeErrors(compiled.errors)}`);
 var PREVIEW_FIRST = "Before rendering, call `canvas_preview` with the same `source` and `files`: it shows you the canvas and its errors, console and height without the user seeing it. Fix what it shows, then render once.";
 function renderTool(previewing) {
   return {
-    name: "canvas_render",
+    name: CANVAS_RENDER_TOOL2,
     description: previewing ? `${PREVIEW_FIRST}
 
 ${CANVAS_DESCRIPTION}` : CANVAS_DESCRIPTION,
@@ -113,15 +132,18 @@ ${CANVAS_DESCRIPTION}` : CANVAS_DESCRIPTION,
     replay: "safe",
     async execute(args, invocation) {
       const compiled = await compile(args, invocation);
-      const next = {
-        runtime: compiled.runtime,
-        title: args.title,
-        code: compiled.code,
-        height: args.height ?? null
-      };
+      const drawn = { runtime: compiled.runtime, title: args.title, height: args.height ?? null };
+      const blob = await invocation.env.files.upload(async function* () {
+        yield encoder.encode(compiled.code);
+      }());
       if (args.canvas === undefined) {
         const part = await invocation.session.parts.create(canvas, {
-          state: { ...next, error: null },
+          state: {
+            ...drawn,
+            code: compiled.code,
+            error: null,
+            revisions: [{ number: 1, blob, ...drawn, at: Date.now() }]
+          },
           placement: { kind: "transcript", role: "answer" }
         });
         return {
@@ -129,7 +151,7 @@ ${CANVAS_DESCRIPTION}` : CANVAS_DESCRIPTION,
           parts: [part.id]
         };
       }
-      const outcome = await invocation.session.part(asId(args.canvas)).act("replace", next);
+      const outcome = await invocation.session.part(asId(args.canvas)).act("replace", { ...drawn, code: compiled.code, blob });
       if (outcome.kind !== "ok")
         throw new Error(`Canvas ${args.canvas} was not replaced: ${outcome.kind}.`);
       return {

package/dist/src/canvas/schema.d.ts

@@ -1,41 +1,81 @@
 import type { Infer } from "@nyte-ai/schema";
+/**
+ * The tool that renders a canvas and replaces one in place.
+ *
+ * @category plugins
+ * @since 0.1.0
+ */
+export declare const CANVAS_RENDER_TOOL = "canvas_render";
+/**
+ * How many revisions a canvas lists; a replace past it drops the oldest.
+ *
+ * @category plugins
+ * @since 0.1.0
+ */
+export declare const CANVAS_REVISIONS_KEPT = 50;
 declare const state: import("@nyte-ai/schema").Schema<{
-    code: string;
     runtime: number;
     title: string;
-    error: string | null;
     height: number | null;
+    code: string;
+    error: string | null;
+    revisions?: {
+        runtime: number;
+        title: string;
+        height: number | null;
+        number: number;
+        blob: import("@nyte-ai/schema").Id<"blob">;
+        at: number;
+    }[] | undefined;
 }>;
 /**
  * Returns a canvas part's state: the compiled module, the runtime it needs,
- * its title, the agent's height hint and the last error a client reported.
+ * its title, the agent's height hint, the last error a client reported, and
+ * its revisions, oldest first, the last one being the module itself.
  *
  * @category plugins
  * @since 0.1.0
  */
 export type CanvasState = Infer<typeof state>;
+/**
+ * One revision of a canvas: its compiled module stored as a blob, with what
+ * drawing it needs besides the code.
+ *
+ * @category plugins
+ * @since 0.1.0
+ */
+export type CanvasRevision = NonNullable<CanvasState["revisions"]>[number];
 /**
  * A canvas part: a React module the agent wrote, compiled on the host and
  * drawn by a client inside the sandboxed runtime shell. `replace` swaps the
- * module in place; `report` records a load or render error a client saw,
- * which the model reads in the fallback.
+ * module in place and lists it as the next revision; `report` records a load
+ * or render error a client saw, which the model reads in the fallback.
  *
  * @category plugins
  * @since 0.1.0
  */
 export declare const canvas: import("@nyte-ai/core").PartDefinition<{
-    code: string;
     runtime: number;
     title: string;
-    error: string | null;
     height: number | null;
+    code: string;
+    error: string | null;
+    revisions?: {
+        runtime: number;
+        title: string;
+        height: number | null;
+        number: number;
+        blob: import("@nyte-ai/schema").Id<"blob">;
+        at: number;
+    }[] | undefined;
 }, {
     replace: {
         input: import("@nyte-ai/schema").Schema<{
-            code: string;
             runtime: number;
             title: string;
             height: number | null;
+            code: string;
+            blob: import("@nyte-ai/schema").Id<"blob">;
         }>;
     };
     report: {

package/dist/src/canvas/schema.js

@@ -1,8 +1,12 @@
 import {
+  CANVAS_RENDER_TOOL2,
+  CANVAS_REVISIONS_KEPT2,
   canvas2
-} from "../../chunks/bash-description-qnwggxq3.js";
+} from "../../chunks/bash-description-1neewp76.js";
 import"../../chunks/bash-description-dnvgk30y.js";
 import"../../chunks/bash-description-zfpm2rt0.js";
 export {
+  CANVAS_RENDER_TOOL2 as CANVAS_RENDER_TOOL,
+  CANVAS_REVISIONS_KEPT2 as CANVAS_REVISIONS_KEPT,
   canvas2 as canvas
 };

package/dist/src/claude-code-sdk/index.d.ts

@@ -20,7 +20,7 @@ export declare function claudeCodeSdk(start?: StartQuery): {
             readonly contribute: import("@nyte-ai/core").Registries<"core">;
             readonly storage: import("@nyte-ai/core").PluginStorage;
             readonly signal: AbortSignal;
-            hook<N extends "session_activated" | "before_send" | "run_started" | "transform_transcript" | "before_compaction" | "before_request" | "before_tool" | "after_tool" | "after_request" | "run_ended">(name: N, entry: import("@nyte-ai/core").HookEntry<"core", N>): import("@nyte-ai/schema").Disposer;
+            hook<N extends import("@nyte-ai/core").HookName<"core">>(name: N, entry: import("@nyte-ai/core").HookEntry<"core", N>): import("@nyte-ai/schema").Disposer;
             report(issue: import("@nyte-ai/schema").ValidationIssue): void;
             reload(): void;
         } & {

package/dist/src/client/notifications.d.ts

@@ -22,7 +22,7 @@ declare const _default: {
                 readonly contribute: import("@nyte-ai/core").Registries<"client">;
                 readonly storage: import("@nyte-ai/core").PluginStorage;
                 readonly signal: AbortSignal;
-                hook<N extends "run_ended_anywhere" | "app_ready" | "session_opened" | "before_submit" | "session_closed" | "app_closing">(name: N, entry: import("@nyte-ai/core").HookEntry<"client", N>): import("@nyte-ai/schema").Disposer;
+                hook<N extends import("@nyte-ai/core").HookName<"client">>(name: N, entry: import("@nyte-ai/core").HookEntry<"client", N>): import("@nyte-ai/schema").Disposer;
                 report(issue: import("@nyte-ai/schema").ValidationIssue): void;
                 reload(): void;
             } & import("@nyte-ai/plugin/client").ClientApi;

package/dist/src/client/presentation.d.ts

@@ -1,6 +1,6 @@
 import { text, thinking } from "@nyte-ai/core";
 import type { PartState } from "@nyte-ai/core";
-import type { Execution, Failure, HeadInfo, Message, MessageSource, SessionInfo, ToolClass, ToolPartState, UserContent, UserStatus } from "@nyte-ai/schema";
+import type { Execution, Failure, HeadInfo, Message, MessageSource, SessionInfo, ToolClass, ToolPartState, UserContent } from "@nyte-ai/schema";
 /**
  * A message the user sent, or one a child, job or action delivered for them.
  *
@@ -92,32 +92,6 @@ export declare function readRawPart(message: PartMessage): RawPart;
  * @category presentation
  */
 export declare function showsReport(message: UserMessage): message is ReportMessage;
-type PendingStatus = Extract<UserStatus, {
-    readonly kind: "pending";
-}>;
-/**
- * A message that waits in the queue: unsent, or pending for a later turn. A pending steer sent
- * while idle or joining the live run is never one.
- *
- * @category presentation
- */
-export type QueuedMessage = UserMessage & {
-    readonly status: Extract<UserStatus, {
-        readonly kind: "unsent";
-    }> | (PendingStatus & {
-        readonly schedule: Exclude<PendingStatus["schedule"], {
-            readonly kind: "joined";
-        }>;
-    });
-};
-/**
- * Whether a message waits in the queue rather than showing in the transcript. A retrying send
- * always waits. Reports, joined steers and steers sent while idle stay in the transcript.
- * Other messages wait only while a run is active.
- *
- * @category presentation
- */
-export declare function waitsInQueue(message: UserMessage, running: boolean): message is QueuedMessage;
 /**
  * What a user message shows: an action's label in place of the prompt it sent.
  *

package/dist/src/client/presentation.js

@@ -21,23 +21,6 @@ function readRawPart(message) {
 function showsReport(message) {
   return message.source.kind === "child" || message.source.kind === "job";
 }
-function waitsInQueue(message, running) {
-  const { status } = message;
-  if (showsReport(message))
-    return false;
-  switch (status.kind) {
-    case "landed":
-      return false;
-    case "unsent":
-      return status.retrying !== null || running && message.delivery !== "steer";
-    case "pending":
-      return running && status.schedule.kind !== "joined" && !(message.delivery === "steer" && status.schedule.kind === "next-turn" && status.schedule.reason === "idle");
-    default: {
-      const _exhaustive = status;
-      return _exhaustive;
-    }
-  }
-}
 function shownContent(message) {
   return message.source.kind === "action" ? message.source.label : message.content;
 }
@@ -386,6 +369,5 @@ export {
   toolStatus,
   toolSubject,
   toolTitle,
-  toolVerbs,
-  waitsInQueue
+  toolVerbs
 };

package/dist/src/question/question.d.ts

@@ -1,15 +1,15 @@
 import type { ToolDefinition } from "@nyte-ai/core";
 export declare const question: import("@nyte-ai/core").PartDefinition<{
-    answers: string[][] | null;
     questions: {
-        multiple?: boolean | undefined;
+        question: string;
+        header: string;
         options: {
-            description: string;
             label: string;
+            description: string;
         }[];
-        question: string;
-        header: string;
+        multiple?: boolean | undefined;
     }[];
+    answers: string[][] | null;
 }, {
     answer: {
         input: import("@nyte-ai/schema").Schema<{
@@ -28,16 +28,16 @@ declare const _default: {
     id: string;
     contribute: {
         parts: import("@nyte-ai/core").PartDefinition<{
-            answers: string[][] | null;
             questions: {
-                multiple?: boolean | undefined;
+                question: string;
+                header: string;
                 options: {
-                    description: string;
                     label: string;
+                    description: string;
                 }[];
-                question: string;
-                header: string;
+                multiple?: boolean | undefined;
             }[];
+            answers: string[][] | null;
         }, {
             answer: {
                 input: import("@nyte-ai/schema").Schema<{
@@ -47,13 +47,13 @@ declare const _default: {
         }>[];
         tools: ToolDefinition<{
             questions: {
-                multiple?: boolean | undefined;
+                question: string;
+                header: string;
                 options: {
-                    description: string;
                     label: string;
+                    description: string;
                 }[];
-                question: string;
-                header: string;
+                multiple?: boolean | undefined;
             }[];
         }, {
             answers: string[][] | null;

package/dist/src/question/schema.d.ts

@@ -1,12 +1,12 @@
 import type { Infer, PartId, SessionView } from "@nyte-ai/schema";
 declare const info: import("@nyte-ai/schema").Schema<{
-    multiple?: boolean | undefined;
+    question: string;
+    header: string;
     options: {
-        description: string;
         label: string;
+        description: string;
     }[];
-    question: string;
-    header: string;
+    multiple?: boolean | undefined;
 }>;
 export declare const answerInput: import("@nyte-ai/schema").Schema<{
     answers: string[][];
@@ -15,26 +15,26 @@ export declare const questionOutput: import("@nyte-ai/schema").Schema<{
     answers: string[][] | null;
 }>;
 declare const state: import("@nyte-ai/schema").Schema<{
-    answers: string[][] | null;
     questions: {
-        multiple?: boolean | undefined;
+        question: string;
+        header: string;
         options: {
-            description: string;
             label: string;
+            description: string;
         }[];
-        question: string;
-        header: string;
+        multiple?: boolean | undefined;
     }[];
+    answers: string[][] | null;
 }>;
 export declare const questionParameters: import("@nyte-ai/schema").Schema<{
     questions: {
-        multiple?: boolean | undefined;
+        question: string;
+        header: string;
         options: {
-            description: string;
             label: string;
+            description: string;
         }[];
-        question: string;
-        header: string;
+        multiple?: boolean | undefined;
     }[];
 }>;
 /** A question, its described choices, and whether the user may select several. */
@@ -53,16 +53,16 @@ export type QuestionState = Infer<typeof state>;
 export declare const question: {
     kind: string;
     state: import("@nyte-ai/schema").Schema<{
-        answers: string[][] | null;
         questions: {
-            multiple?: boolean | undefined;
+            question: string;
+            header: string;
             options: {
-                description: string;
                 label: string;
+                description: string;
             }[];
-            question: string;
-            header: string;
+            multiple?: boolean | undefined;
         }[];
+        answers: string[][] | null;
     }>;
     actions: {
         answer: {
@@ -72,16 +72,16 @@ export declare const question: {
         };
     };
     fallback: (current: {
-        answers: string[][] | null;
         questions: {
-            multiple?: boolean | undefined;
+            question: string;
+            header: string;
             options: {
-                description: string;
                 label: string;
+                description: string;
             }[];
-            question: string;
-            header: string;
+            multiple?: boolean | undefined;
         }[];
+        answers: string[][] | null;
     }, { id }: {
         readonly id: PartId;
     }) => string;

package/dist/src/rename.d.ts

@@ -27,26 +27,26 @@ declare const _default: {
     };
     hooks: {
         run_started: (run: Readonly<{
+            readonly id: import("@nyte-ai/schema").Id<"run">;
+            readonly head: import("@nyte-ai/schema").Id<"head">;
+            readonly startedAt: number;
+            readonly attempt: number;
             readonly configuration: {
+                readonly kind: "exact";
                 readonly model: {
-                    readonly id: string;
                     readonly provider: string;
+                    readonly id: string;
                 };
-                readonly thinking: "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
-                readonly kind: "exact";
+                readonly thinking: "high" | "low" | "max" | "medium" | "minimal" | "off" | "xhigh";
+                readonly agent: string | null;
                 readonly settings: {
                     readonly [x: string]: import("@nyte-ai/schema").Json;
                 };
-                readonly agent: string | null;
                 readonly settingsVersion: string;
             };
-            readonly id: import("@nyte-ai/schema").Id<"run">;
-            readonly head: import("@nyte-ai/schema").Id<"head">;
-            readonly startedAt: number;
-            readonly attempt: number;
             readonly origin: {
-                readonly message: import("@nyte-ai/schema").Id<"message">;
                 readonly kind: "input";
+                readonly message: import("@nyte-ai/schema").Id<"message">;
             } | {
                 readonly kind: "continuation";
                 readonly from: "child" | "job" | "wake";
@@ -58,7 +58,7 @@ declare const _default: {
                 readonly contribute: import("@nyte-ai/core").Registries<"core">;
                 readonly storage: import("@nyte-ai/core").PluginStorage;
                 readonly signal: AbortSignal;
-                hook<N extends "session_activated" | "before_send" | "run_started" | "transform_transcript" | "before_compaction" | "before_request" | "before_tool" | "after_tool" | "after_request" | "run_ended">(name: N, entry: import("@nyte-ai/core").HookEntry<"core", N>): import("@nyte-ai/schema").Disposer;
+                hook<N extends import("@nyte-ai/core").HookName<"core">>(name: N, entry: import("@nyte-ai/core").HookEntry<"core", N>): import("@nyte-ai/schema").Disposer;
                 report(issue: import("@nyte-ai/schema").ValidationIssue): void;
                 reload(): void;
             } & {

package/dist/src/telemetry.d.ts

@@ -21,7 +21,7 @@ declare const _default: {
         readonly contribute: import("@nyte-ai/core").Registries<"core">;
         readonly storage: import("@nyte-ai/core").PluginStorage;
         readonly signal: AbortSignal;
-        hook<N extends "session_activated" | "before_send" | "run_started" | "transform_transcript" | "before_compaction" | "before_request" | "before_tool" | "after_tool" | "after_request" | "run_ended">(name: N, entry: import("@nyte-ai/core").HookEntry<"core", N>): import("@nyte-ai/schema").Disposer;
+        hook<N extends import("@nyte-ai/core").HookName<"core">>(name: N, entry: import("@nyte-ai/core").HookEntry<"core", N>): import("@nyte-ai/schema").Disposer;
         report(issue: import("@nyte-ai/schema").ValidationIssue): void;
         reload(): void;
     } & {

package/dist/src/web-search.d.ts

@@ -54,7 +54,7 @@ export declare const adapters: {
 declare const _default: {
     id: string;
     contribute: {
-        settings: SettingDefinition<"exa" | "tavily" | "firecrawl" | "parallel">[];
+        settings: SettingDefinition<"exa" | "firecrawl" | "parallel" | "tavily">[];
         commands: Command<keyof import("@nyte-ai/core").SideTable>[];
     };
     activate(api: {
@@ -63,7 +63,7 @@ declare const _default: {
         readonly contribute: import("@nyte-ai/core").Registries<"core">;
         readonly storage: import("@nyte-ai/core").PluginStorage;
         readonly signal: AbortSignal;
-        hook<N extends "session_activated" | "before_send" | "run_started" | "transform_transcript" | "before_compaction" | "before_request" | "before_tool" | "after_tool" | "after_request" | "run_ended">(name: N, entry: import("@nyte-ai/core").HookEntry<"core", N>): import("@nyte-ai/schema").Disposer;
+        hook<N extends import("@nyte-ai/core").HookName<"core">>(name: N, entry: import("@nyte-ai/core").HookEntry<"core", N>): import("@nyte-ai/schema").Disposer;
         report(issue: import("@nyte-ai/schema").ValidationIssue): void;
         reload(): void;
     } & {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nyte-ai/plugin",
-  "version": "0.0.24",
+  "version": "0.0.25-beta.1",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -144,9 +144,9 @@
     "@agentclientprotocol/sdk": "^2.0.0",
     "@anthropic-ai/claude-agent-sdk": "^0.3.306",
     "@earendil-works/pi-codemode": "^1.3.0",
-    "@nyte-ai/ai": "0.0.24",
-    "@nyte-ai/core": "0.0.24",
-    "@nyte-ai/schema": "0.0.24",
+    "@nyte-ai/ai": "0.0.25-beta.1",
+    "@nyte-ai/core": "0.0.25-beta.1",
+    "@nyte-ai/schema": "0.0.25-beta.1",
     "@opentelemetry/api": "^1.10.0",
     "@opentelemetry/exporter-trace-otlp-http": "^0.300.0",
     "@opentelemetry/resources": "^3.0.0",
@@ -162,7 +162,6 @@
     "@types/node": "^26.6.5",
     "@types/react": "^19.3.0",
     "react": "^19.3.1",
-    "typescript": "6.0.3",
     "vitest": "^5.0.5"
   },
   "peerDependencies": {
@@ -183,7 +182,7 @@
   "scripts": {
     "clean": "rm -rf node_modules .turbo",
     "test": "vitest --run",
-    "typecheck": "tsrs --noEmit",
+    "typecheck": "tsc --noEmit",
     "build:package": "bun ../../scripts/sdk-packages.mjs build plugin"
   }
 }