@mulmoclaude/shapescript-plugin 1.0.1 → 1.1.0

package/README.md

@@ -12,7 +12,7 @@ name, and the `Present3D*` type names, are renamed throughout.
 
 | Entry         | Contents                                                                                                                 |
 | ------------- | ------------------------------------------------------------------------------------------------------------------------ |
-| `.`           | `TOOL_NAME`, `TOOL_DEFINITION`, `executePresentShapeScript`, `pluginCore`, `samples`, `parseShapeScript`, `astToThreeJS` |
+| `.`           | `TOOL_NAME`, `TOOL_DEFINITION`, `executePresentShapeScript`, `pluginCore`, `samples`, `parseShapeScript`, `astToThreeJS`, `executeShapeScriptDispatch` + the `artifacts/shapes` path rules |
 | `./vue`       | the `ToolPlugin` (View + Preview + `SYSTEM_PROMPT`), plus everything on `.`                                              |
 | `./style.css` | the compiled component styles (Vite lib mode does not auto-inject them)                                                  |
 
@@ -51,6 +51,21 @@ for i in 1 to count {
 
 A function call takes **no space** before its parenthesis: `sin(x)` is a call, `sin (x)` is not.
 
+## Storage
+
+A new `script` is saved to `artifacts/shapes/<slug>-<epoch-ms>.shape` and the
+result names it as `data.filePath`; pass `path` instead of `script` to present a
+source that already exists — a `.shape` this tool wrote, or any other on disk —
+and it is rendered in place rather than copied. The two are mutually exclusive.
+The View's source editor writes edits back to that same file (dispatch kinds
+`loadShape` / `saveShape`), and refreshes from disk on open, so a model the agent
+rewrote is what the user sees.
+
+All file access goes through the host's generic gui-chat-protocol capability:
+`files.artifacts` for `artifacts/shapes/**`, `files.byPath` for anything else.
+A host that supplies neither keeps the pre-1.1 behaviour — the script travels
+inside the tool result and nothing is written — rather than failing.
+
 ## Validation and errors
 
 `executePresentShapeScript` checks arguments, parses the source, evaluates expressions,
@@ -133,9 +148,17 @@ self-intersecting inputs may fail.
 on the server, which validates it, and again in the browser, which renders it — and an
 unseeded generator lets those two runs take different branches.
 
-Conversion limits cover nodes, loop/path work, detail, aggregate vertices (including CSG
-intermediates), and a coarse wall-clock budget checked between nodes — it refuses to start
-the next node once the budget is spent, but cannot interrupt one long boolean.
+Conversion limits cover nodes (100,000), loop/path work (100,000 iterations), detail (3–256),
+aggregate vertices (5,000,000, including CSG intermediates), and a coarse 30-second wall-clock
+budget checked between nodes — it refuses to start the next node once the budget is spent, but
+cannot interrupt one long boolean. Every one is overridable through `ConversionOptions`.
+
+Measured, those ceilings bind in different places: a grid of 22,500 cubes is ~540k vertices and
+converts in under 200 ms, 930 spheres at `detail 64` reach the vertex budget, and the wall clock
+is in practice the CSG budget alone — 240k vertices of plain geometry take ~95 ms, while 100
+boolean subtractions take 5.3 s. Remember the script is built TWICE, once on the server to
+validate it and once in the browser to draw it, and that the browser's copy is what the user's
+tab has to keep rendering.
 
 ## Scripts
 

package/dist/core/contract.d.ts

@@ -0,0 +1,42 @@
+/** True for a non-null, non-array object. Local rather than imported from
+ *  `@mulmoclaude/common`: this package's only other dependency is
+ *  `@mulmoclaude/core/artifacts` (browser-safe path rules), and one two-line
+ *  predicate does not justify a second. */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/** Read the current source of an existing ShapeScript artifact — the View
+ *  refreshes from disk so an edit made elsewhere (the agent, an editor) is
+ *  what gets rendered, not the copy frozen into the tool result. */
+export interface LoadShapeArgs {
+    kind: "loadShape";
+    /** Workspace-relative path under `artifacts/shapes/…`. */
+    path: string;
+}
+/** Overwrite an existing ShapeScript artifact in place (the source editor's
+ *  "Apply Changes"). */
+export interface SaveShapeArgs {
+    kind: "saveShape";
+    /** Workspace-relative path under `artifacts/shapes/…`. */
+    path: string;
+    script: string;
+}
+/** Discriminated union of every action the View's package router serves. */
+export type ShapeScriptDispatchArgs = LoadShapeArgs | SaveShapeArgs;
+/** Maps a dispatch `kind` to its result shape. Read back with the readers
+ *  below — protocol 2.0.0 makes `dispatch` return `unknown` without one,
+ *  because naming the type at the call site never checked anything. */
+export interface ShapeScriptDispatchResult {
+    loadShape: {
+        script: string;
+    };
+    saveShape: {
+        path: string;
+    };
+}
+/** True when `value` is a well-formed payload for the package router.
+ *
+ *  `saveShape` additionally requires `script` to be a string — without that,
+ *  `undefined` would reach `files.artifacts.write` and blank the artifact. */
+export declare function isShapeScriptDispatchArgs(value: unknown): value is ShapeScriptDispatchArgs;
+export declare function readLoadShapeResult(value: unknown): ShapeScriptDispatchResult["loadShape"];
+export declare function readSaveShapeResult(value: unknown): ShapeScriptDispatchResult["saveShape"];
+//# sourceMappingURL=contract.d.ts.map

package/dist/core/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/core/contract.ts"],"names":[],"mappings":"AAOA;;;2CAG2C;AAC3C,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED;;oEAEoE;AACpE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;CACd;AAED;wBACwB;AACxB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,4EAA4E;AAC5E,MAAM,MAAM,uBAAuB,GAAG,aAAa,GAAG,aAAa,CAAC;AAEpE;;uEAEuE;AACvE,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7B;AASD;;;8EAG8E;AAC9E,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,uBAAuB,CAI1F;AAYD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,yBAAyB,CAAC,WAAW,CAAC,CAG1F;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,yBAAyB,CAAC,WAAW,CAAC,CAG1F"}

package/dist/core/definition.d.ts

@@ -14,6 +14,10 @@ export declare const TOOL_DEFINITION: {
                 type: string;
                 description: string;
             };
+            path: {
+                type: string;
+                description: string;
+            };
         };
         required: string[];
     };

package/dist/core/definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/core/definition.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,uBAAuB,CAAC;AAE9C,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;CAsK3B,CAAC"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/core/definition.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,uBAAuB,CAAC;AAE9C,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;CA4K3B,CAAC"}

package/dist/core/dispatch.d.ts

@@ -0,0 +1,38 @@
+import type { FileOps } from "gui-chat-protocol";
+import type { ShapeScriptDispatchArgs } from "./contract";
+/** Capabilities the dispatch router needs: the generic, shared
+ *  `files.artifacts` FileOps, plus — for hosts that let presentShapeScript
+ *  open sources outside `artifacts/shapes/` — `files.byPath`. */
+export interface ShapeScriptDispatchContext {
+    files: {
+        artifacts: FileOps;
+        byPath?: FileOps;
+    };
+}
+/** The FileOps that owns a given source, plus the path in that FileOps' terms.
+ *  An `artifacts/shapes/**` source goes through `files.artifacts` — the only
+ *  capability an older host provides, and what writes there — while anything
+ *  else needs the host's `files.byPath`. */
+export declare function locateShape(context: ShapeScriptDispatchContext, filePath: string): {
+    files: FileOps;
+    rel: string;
+} | null;
+/**
+ * Server-side router for the View's `useRuntime().dispatch({ kind, … })` calls.
+ * `loadShape` returns the source's current bytes (the View refreshes from disk
+ * rather than trusting the copy in the tool result); `saveShape` overwrites one
+ * that already exists, and refuses to create. Both validate containment with
+ * the same guards as the tool-call path before touching FileOps.
+ *
+ * Throws on an invalid path / missing file — the host's dispatch route maps a
+ * throw to a non-2xx, which the View's `dispatch` rejects on. Geometry is NOT
+ * validated here: the View validates before it dispatches (it has the same
+ * parser), and a save that refused to persist a work-in-progress source would
+ * make the editor unusable.
+ */
+export declare function executeShapeScriptDispatch(context: ShapeScriptDispatchContext, args: ShapeScriptDispatchArgs): Promise<{
+    script: string;
+} | {
+    path: string;
+}>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/core/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/core/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1D;;iEAEiE;AACjE,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACjD;AAED;;;4CAG4C;AAC5C,wBAAgB,WAAW,CAAC,OAAO,EAAE,0BAA0B,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKzH;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,0BAA0B,EACnC,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAqChD"}

package/dist/core/index.d.ts

@@ -1,6 +1,12 @@
 export type { PresentShapeScriptData, PresentShapeScriptArgs, PresentShapeScriptResult, PresentShapeScriptRenderedResult, PresentShapeScriptErrorResult, PresentShapeScriptExecutionResult, ShapeScriptDiagnostic, } from "./types";
 export { TOOL_NAME, TOOL_DEFINITION } from "./definition";
 export { pluginCore, presentShapeScript, executePresentShapeScript } from "./plugin";
+export type { ShapeScriptExecuteContext } from "./plugin";
+export { executeShapeScriptDispatch, locateShape } from "./dispatch";
+export type { ShapeScriptDispatchContext } from "./dispatch";
+export { isShapeScriptDispatchArgs, readLoadShapeResult, readSaveShapeResult } from "./contract";
+export type { LoadShapeArgs, SaveShapeArgs, ShapeScriptDispatchArgs, ShapeScriptDispatchResult } from "./contract";
+export { isPresentableShapePath, isShapeArtifactPath, shapeArtifactPath, toArtifactsRelative, SHAPE_EXTENSIONS } from "./paths";
 export { samples } from "./samples";
 export { parseShapeScript } from "../shapescript/parser";
 export { astToThreeJS } from "../shapescript/toThreeJS";

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,gCAAgC,EAChC,6BAA6B,EAC7B,iCAAiC,EACjC,qBAAqB,GACtB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,gCAAgC,EAChC,6BAA6B,EAC7B,iCAAiC,EACjC,qBAAqB,GACtB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AACrF,YAAY,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACrE,YAAY,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjG,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AACnH,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChI,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/core/paths.d.ts

@@ -0,0 +1,40 @@
+/** The extension a ShapeScript source carries — upstream ShapeScript's own. */
+export declare const SHAPE_EXTENSIONS: readonly [".shape"];
+/** Lowercase-hyphen slug, capped, leading/trailing hyphens stripped; falls back
+ *  to `fallback` for empty/undefined/non-ASCII input. */
+export declare function slugify(title: string | undefined, fallback?: string): string;
+export interface ShapePath {
+    /** Path relative to the artifacts root — what `files.artifacts.write` takes
+     *  (e.g. `shapes/a-lamp-1718765432101.shape`). */
+    relPath: string;
+    /** Workspace-relative path for display / tool-result data
+     *  (e.g. `artifacts/shapes/a-lamp-1718765432101.shape`). */
+    filePath: string;
+}
+/** Build a fresh, collision-safe artifact path for a new ShapeScript source.
+ *  Flat rather than `YYYY/MM`-partitioned (the `artifacts/stories` shape): a
+ *  model is something the user opens by name, and one directory keeps that
+ *  browsable.
+ *
+ *  The random token matters because the timestamp alone does not: two calls
+ *  sharing a title inside one millisecond mint the SAME name, and the second
+ *  `write` replaces the first model with no error anywhere (codex on #3056).
+ *  `token` is injectable so a test can assert the whole filename. */
+export declare function shapeArtifactPath(title: string | undefined, now?: Date, token?: string): ShapePath;
+/**
+ * Strict guard for a workspace-relative path the caller claims is an existing
+ * ShapeScript artifact. Rejects anything outside `artifacts/shapes/`,
+ * non-`.shape`, or with traversal / non-canonical segments — the primary
+ * defence before a `files.artifacts` read/write.
+ */
+export declare function isShapeArtifactPath(value: string): boolean;
+/** Convert a workspace-relative artifacts path (`artifacts/shapes/…`) to the
+ *  `files.artifacts`-relative form (`shapes/…`) that FileOps expects. Assumes
+ *  the input already passed `isShapeArtifactPath`. */
+export declare function toArtifactsRelative(workspaceRelPath: string): string;
+/** The `path` argument's gate: ANY ShapeScript source, not just the ones this
+ *  tool wrote — a workspace-relative path (`models/lamp.shape`) or, where the
+ *  host permits it, an absolute one. Lexical only; the host's `files.byPath`
+ *  capability decides which of those it will actually open. */
+export declare function isPresentableShapePath(value: string): boolean;
+//# sourceMappingURL=paths.d.ts.map

package/dist/core/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAoBA,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,qBAAsB,CAAC;AAEpD;yDACyD;AACzD,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,SAAsB,GAAG,MAAM,CAEzF;AAED,MAAM,WAAW,SAAS;IACxB;sDACkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB;gEAC4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAeD;;;;;;;;qEAQqE;AACrE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,GAAE,IAAiB,EAAE,KAAK,GAAE,MAAsB,GAAG,SAAS,CAW7H;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAI1D;AAED;;sDAEsD;AACtD,wBAAgB,mBAAmB,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED;;;+DAG+D;AAC/D,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE7D"}

package/dist/core/plugin.d.ts

@@ -1,8 +1,25 @@
-import type { ToolContext, ToolPluginCore } from "gui-chat-protocol";
+import type { FileOps, ToolContext, ToolPluginCore } from "gui-chat-protocol";
 import type { PresentShapeScriptArgs, PresentShapeScriptData, PresentShapeScriptExecutionResult } from "./types";
 import { TOOL_NAME, TOOL_DEFINITION } from "./definition";
-export declare const presentShapeScript: (_context: ToolContext, args: PresentShapeScriptArgs) => Promise<PresentShapeScriptExecutionResult>;
+/** Host capabilities the ShapeScript core needs, delivered through the GENERIC
+ *  gui-chat-protocol runtime — `files.artifacts` (the shared, user-browsable
+ *  output area) for new sources, and `files.byPath` for a `path` outside
+ *  `artifacts/shapes/`.
+ *
+ *  Both are OPTIONAL, and a plain `ToolContext` satisfies this type: a host
+ *  with no file layer keeps the pre-1.1 behaviour — the script round-trips
+ *  inside the tool result and nothing is written — rather than failing. */
+export interface ShapeScriptExecuteContext extends ToolContext {
+    files?: {
+        /** Rooted at `<workspace>/artifacts` — where NEW sources are written. */
+        artifacts: FileOps;
+        /** Reads a source the caller named by path: workspace-relative or, where
+         *  the host allows it, absolute. */
+        byPath?: FileOps;
+    };
+}
+export declare const presentShapeScript: (context: ShapeScriptExecuteContext, args: PresentShapeScriptArgs) => Promise<PresentShapeScriptExecutionResult>;
 export declare const pluginCore: ToolPluginCore<PresentShapeScriptData, unknown, PresentShapeScriptArgs>;
 export { TOOL_NAME, TOOL_DEFINITION };
-export declare const executePresentShapeScript: (_context: ToolContext, args: PresentShapeScriptArgs) => Promise<PresentShapeScriptExecutionResult>;
+export declare const executePresentShapeScript: (context: ShapeScriptExecuteContext, args: PresentShapeScriptArgs) => Promise<PresentShapeScriptExecutionResult>;
 //# sourceMappingURL=plugin.d.ts.map

package/dist/core/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/core/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,iCAAiC,EAAyB,MAAM,SAAS,CAAC;AACxI,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAO1D,eAAO,MAAM,kBAAkB,GAAU,UAAU,WAAW,EAAE,MAAM,sBAAsB,KAAG,OAAO,CAAC,iCAAiC,CAkCvI,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,sBAAsB,EAAE,OAAO,EAAE,sBAAsB,CAM9F,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;AACtC,eAAO,MAAM,yBAAyB,aA7Ca,WAAW,QAAQ,sBAAsB,KAAG,OAAO,CAAC,iCAAiC,CA6C7E,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/core/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,iCAAiC,EAAyB,MAAM,SAAS,CAAC;AACxI,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAU1D;;;;;;;2EAO2E;AAC3E,MAAM,WAAW,yBAA0B,SAAQ,WAAW;IAC5D,KAAK,CAAC,EAAE;QACN,yEAAyE;QACzE,SAAS,EAAE,OAAO,CAAC;QACnB;4CACoC;QACpC,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;CACH;AA+DD,eAAO,MAAM,kBAAkB,GAAU,SAAS,yBAAyB,EAAE,MAAM,sBAAsB,KAAG,OAAO,CAAC,iCAAiC,CAoCpJ,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,sBAAsB,EAAE,OAAO,EAAE,sBAAsB,CAM9F,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;AACtC,eAAO,MAAM,yBAAyB,YA/CY,yBAAyB,QAAQ,sBAAsB,KAAG,OAAO,CAAC,iCAAiC,CA+C1F,CAAC"}

package/dist/core/types.d.ts

@@ -1,10 +1,22 @@
 import type { ToolResult } from "gui-chat-protocol";
 export interface PresentShapeScriptData {
     script: string;
+    /** The `.shape` file this result renders, when it is backed by one. Set for
+     *  every result a host with the `files.artifacts` capability produces; absent
+     *  for a host that has no file layer, where `script` is the only copy. The
+     *  View saves edits back to THIS path — without it, "Apply Changes" only
+     *  updates the conversation's copy. */
+    filePath?: string | undefined;
 }
+/** Args the LLM passes when invoking the tool. Two shapes share this type: the
+ *  create path (`script`, saved to a fresh `artifacts/shapes/**` path) and the
+ *  present-existing path (`path`, rendered in place). Only `title` is
+ *  `required` in TOOL_DEFINITION.parameters because JSON Schema can't express
+ *  that either-or; the executor enforces the mutual exclusion. */
 export interface PresentShapeScriptArgs {
     title: string;
-    script: string;
+    script?: string;
+    path?: string;
 }
 export type PresentShapeScriptResult = ToolResult<PresentShapeScriptData>;
 /** The success shape of `presentShapeScript`.

package/dist/core/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,sBAAsB,CAAC,CAAC;AAE1E;;;;;;;;GAQG;AACH,MAAM,MAAM,gCAAgC,GAAG,wBAAwB,GAAG;IACxE,IAAI,EAAE,sBAAsB,CAAC;CAC9B,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,kBAAkB,GAAG,aAAa,GAAG,kBAAkB,GAAG,gBAAgB,CAAC;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,kFAAkF;AAClF,MAAM,MAAM,6BAA6B,GAAG,UAAU,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,qBAAqB,CAAA;CAAE,CAAC,GAAG;IAChG,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,qBAAqB,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG,gCAAgC,GAAG,6BAA6B,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf;;;;2CAIuC;IACvC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED;;;;kEAIkE;AAClE,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,sBAAsB,CAAC,CAAC;AAE1E;;;;;;;;GAQG;AACH,MAAM,MAAM,gCAAgC,GAAG,wBAAwB,GAAG;IACxE,IAAI,EAAE,sBAAsB,CAAC;CAC9B,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,kBAAkB,GAAG,aAAa,GAAG,kBAAkB,GAAG,gBAAgB,CAAC;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,kFAAkF;AAClF,MAAM,MAAM,6BAA6B,GAAG,UAAU,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,qBAAqB,CAAA;CAAE,CAAC,GAAG;IAChG,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,qBAAqB,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG,gCAAgC,GAAG,6BAA6B,CAAC"}

package/dist/core.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./samples-D6hOBqbS.cjs");exports.TOOL_DEFINITION=e.Rn,exports.TOOL_NAME=e.zn,exports.astToThreeJS=e.a,exports.executePresentShapeScript=e.n,exports.parseShapeScript=e.Ln,exports.pluginCore=e.r,exports.presentShapeScript=e.i,exports.samples=e.t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./samples-0PjcB6cu.cjs");exports.SHAPE_EXTENSIONS=e.Bn,exports.TOOL_DEFINITION=e.Jn,exports.TOOL_NAME=e.Yn,exports.astToThreeJS=e.a,exports.executePresentShapeScript=e.n,exports.executeShapeScriptDispatch=e.Rn,exports.isPresentableShapePath=e.Vn,exports.isShapeArtifactPath=e.Hn,exports.isShapeScriptDispatchArgs=e.Gn,exports.locateShape=e.zn,exports.parseShapeScript=e.Ln,exports.pluginCore=e.r,exports.presentShapeScript=e.i,exports.readLoadShapeResult=e.Kn,exports.readSaveShapeResult=e.qn,exports.samples=e.t,exports.shapeArtifactPath=e.Un,exports.toArtifactsRelative=e.Wn;

package/dist/core.js

@@ -1,2 +1,2 @@
-import { Ln as e, Rn as t, a as n, i as r, n as i, r as a, t as o, zn as s } from "./samples-BwRpwZSm.js";
-export { t as TOOL_DEFINITION, s as TOOL_NAME, n as astToThreeJS, i as executePresentShapeScript, e as parseShapeScript, a as pluginCore, r as presentShapeScript, o as samples };
+import { Bn as e, Gn as t, Hn as n, Jn as r, Kn as i, Ln as a, Rn as o, Un as s, Vn as c, Wn as l, Yn as u, a as d, i as f, n as p, qn as m, r as h, t as g, zn as _ } from "./samples-N1JR7LKe.js";
+export { e as SHAPE_EXTENSIONS, r as TOOL_DEFINITION, u as TOOL_NAME, d as astToThreeJS, p as executePresentShapeScript, o as executeShapeScriptDispatch, c as isPresentableShapePath, n as isShapeArtifactPath, t as isShapeScriptDispatchArgs, _ as locateShape, a as parseShapeScript, h as pluginCore, f as presentShapeScript, i as readLoadShapeResult, m as readSaveShapeResult, g as samples, s as shapeArtifactPath, l as toArtifactsRelative };

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./samples-D6hOBqbS.cjs");require("./core.cjs"),exports.TOOL_DEFINITION=e.Rn,exports.TOOL_NAME=e.zn,exports.astToThreeJS=e.a,exports.executePresentShapeScript=e.n,exports.parseShapeScript=e.Ln,exports.pluginCore=e.r,exports.presentShapeScript=e.i,exports.samples=e.t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./samples-0PjcB6cu.cjs");require("./core.cjs"),exports.SHAPE_EXTENSIONS=e.Bn,exports.TOOL_DEFINITION=e.Jn,exports.TOOL_NAME=e.Yn,exports.astToThreeJS=e.a,exports.executePresentShapeScript=e.n,exports.executeShapeScriptDispatch=e.Rn,exports.isPresentableShapePath=e.Vn,exports.isShapeArtifactPath=e.Hn,exports.isShapeScriptDispatchArgs=e.Gn,exports.locateShape=e.zn,exports.parseShapeScript=e.Ln,exports.pluginCore=e.r,exports.presentShapeScript=e.i,exports.readLoadShapeResult=e.Kn,exports.readSaveShapeResult=e.qn,exports.samples=e.t,exports.shapeArtifactPath=e.Un,exports.toArtifactsRelative=e.Wn;

package/dist/index.js

@@ -1,3 +1,3 @@
-import { Ln as e, Rn as t, a as n, i as r, n as i, r as a, t as o, zn as s } from "./samples-BwRpwZSm.js";
+import { Bn as e, Gn as t, Hn as n, Jn as r, Kn as i, Ln as a, Rn as o, Un as s, Vn as c, Wn as l, Yn as u, a as d, i as f, n as p, qn as m, r as h, t as g, zn as _ } from "./samples-N1JR7LKe.js";
 import "./core.js";
-export { t as TOOL_DEFINITION, s as TOOL_NAME, n as astToThreeJS, i as executePresentShapeScript, e as parseShapeScript, a as pluginCore, r as presentShapeScript, o as samples };
+export { e as SHAPE_EXTENSIONS, r as TOOL_DEFINITION, u as TOOL_NAME, d as astToThreeJS, p as executePresentShapeScript, o as executeShapeScriptDispatch, c as isPresentableShapePath, n as isShapeArtifactPath, t as isShapeScriptDispatchArgs, _ as locateShape, a as parseShapeScript, h as pluginCore, f as presentShapeScript, i as readLoadShapeResult, m as readSaveShapeResult, g as samples, s as shapeArtifactPath, l as toArtifactsRelative };

package/dist/lang/de.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"de.d.ts","sourceRoot":"","sources":["../../src/lang/de.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAST,CAAC;AAEF,eAAe,EAAE,CAAC"}
+{"version":3,"file":"de.d.ts","sourceRoot":"","sources":["../../src/lang/de.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAUT,CAAC;AAEF,eAAe,EAAE,CAAC"}

package/dist/lang/en.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../src/lang/en.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAST,CAAC;AAEF,eAAe,EAAE,CAAC"}
+{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../src/lang/en.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAUT,CAAC;AAEF,eAAe,EAAE,CAAC"}

package/dist/lang/es.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"es.d.ts","sourceRoot":"","sources":["../../src/lang/es.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAST,CAAC;AAEF,eAAe,EAAE,CAAC"}
+{"version":3,"file":"es.d.ts","sourceRoot":"","sources":["../../src/lang/es.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAUT,CAAC;AAEF,eAAe,EAAE,CAAC"}

package/dist/lang/fr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fr.d.ts","sourceRoot":"","sources":["../../src/lang/fr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAST,CAAC;AAEF,eAAe,EAAE,CAAC"}
+{"version":3,"file":"fr.d.ts","sourceRoot":"","sources":["../../src/lang/fr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAUT,CAAC;AAEF,eAAe,EAAE,CAAC"}

package/dist/lang/ja.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ja.d.ts","sourceRoot":"","sources":["../../src/lang/ja.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAST,CAAC;AAEF,eAAe,EAAE,CAAC"}
+{"version":3,"file":"ja.d.ts","sourceRoot":"","sources":["../../src/lang/ja.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAUT,CAAC;AAEF,eAAe,EAAE,CAAC"}

package/dist/lang/ko.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ko.d.ts","sourceRoot":"","sources":["../../src/lang/ko.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAST,CAAC;AAEF,eAAe,EAAE,CAAC"}
+{"version":3,"file":"ko.d.ts","sourceRoot":"","sources":["../../src/lang/ko.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAUT,CAAC;AAEF,eAAe,EAAE,CAAC"}

package/dist/lang/messages.d.ts

@@ -7,5 +7,6 @@ export interface Messages {
     editSource: string;
     scriptEditorLabel: string;
     applyChanges: string;
+    saveError: string;
 }
 //# sourceMappingURL=messages.d.ts.map

package/dist/lang/messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/lang/messages.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/lang/messages.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/lang/ptBR.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ptBR.d.ts","sourceRoot":"","sources":["../../src/lang/ptBR.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,IAAI,EAAE,QASX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"ptBR.d.ts","sourceRoot":"","sources":["../../src/lang/ptBR.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,IAAI,EAAE,QAUX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/lang/zh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zh.d.ts","sourceRoot":"","sources":["../../src/lang/zh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAST,CAAC;AAEF,eAAe,EAAE,CAAC"}
+{"version":3,"file":"zh.d.ts","sourceRoot":"","sources":["../../src/lang/zh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,QAAA,MAAM,EAAE,EAAE,QAUT,CAAC;AAEF,eAAe,EAAE,CAAC"}