@pixerate/editor 0.180.0 → 0.182.0

package/dist/tools/index.js

@@ -8,7 +8,7 @@ import {
   runToolScript,
   toolResultError,
   toolResultValue
-} from "../chunk-ZXTO6U7T.js";
+} from "../chunk-GI3AVES4.js";
 import {
   JSON_RPC_ERRORS,
   MCP_PROTOCOL_VERSIONS,
@@ -46,7 +46,7 @@ import {
   playbackRefsFromResult,
   readingTime,
   unionRects
-} from "../chunk-WL4IN36A.js";
+} from "../chunk-EHTX34RE.js";
 import {
   CAPTURE_EXCLUDE_SELECTOR,
   CAPTURE_OVERLAY_SELECTORS,
@@ -92,7 +92,7 @@ import {
   realPresenceClock,
   trackPresenceDrag,
   tweenPresenceCursor
-} from "../chunk-O2ANJFUF.js";
+} from "../chunk-IVSWRVB4.js";
 import {
   validateJsonSchema
 } from "../chunk-V2ZCJRDM.js";

package/dist/tools/playback.d.cts

@@ -36,8 +36,11 @@ export type PlaybackStep = {
     type: 'say';
     text: string;
     ms?: number;
-} | {
+}
+/** Button down. `gesture: 'path'` tells the surface the drag that follows traces an outline (a lasso), not a box. */
+ | {
     type: 'press';
+    gesture?: 'path';
 } | {
     type: 'release';
 }

package/dist/tools/playback.d.ts

@@ -36,8 +36,11 @@ export type PlaybackStep = {
     type: 'say';
     text: string;
     ms?: number;
-} | {
+}
+/** Button down. `gesture: 'path'` tells the surface the drag that follows traces an outline (a lasso), not a box. */
+ | {
     type: 'press';
+    gesture?: 'path';
 } | {
     type: 'release';
 }

package/dist/tools/presence.d.cts

@@ -7,6 +7,8 @@ export interface PresenceActor {
     y: number;
     /** The button is down (dragging). */
     pressed: boolean;
+    /** What a drag traces while `pressed`: `path` for a freehand outline (a lasso), else a box from the press. */
+    gesture?: 'path';
     /** A short note shown next to the cursor (what the agent is doing). */
     message?: string;
     /** A rectangle (surface coordinates) the agent is working on, drawn as a highlight ring. */
@@ -87,13 +89,23 @@ export interface PresenceDragBox {
     width: number;
     height: number;
 }
+/** An agent's drag so far: the box from the press to the cursor, and the points it passed through. */
+export interface PresenceDrag extends PresenceDragBox {
+    /** The cursor positions since the press, in order (the press first). */
+    path: readonly {
+        x: number;
+        y: number;
+    }[];
+    /** `path` when the agent traces an outline (see `PresenceActor.gesture`); a box drag otherwise. */
+    gesture?: 'path';
+}
 /**
  * Follows a presence store for an agent's drag (press, move, release) and reports the box from
- * the press to the cursor, so a surface can draw its own drag feedback (a crop box or a marquee
- * being pulled out) under the agent's cursor. `onEnd` runs on release, or when the cursor leaves
+ * the press to the cursor and the path it took, so a surface can draw its own drag feedback (a crop
+ * box, a marquee being pulled out or a lasso being traced) under the agent's cursor. `onEnd` runs on release, or when the cursor leaves
  * the surface mid-drag. Pass the result to `PresenceStore.subscribe`.
  */
 export declare function trackPresenceDrag(handlers: {
-    onDrag: (box: PresenceDragBox) => void;
+    onDrag: (drag: PresenceDrag) => void;
     onEnd: () => void;
 }): (state: PresenceState) => void;

package/dist/tools/presence.d.ts

@@ -7,6 +7,8 @@ export interface PresenceActor {
     y: number;
     /** The button is down (dragging). */
     pressed: boolean;
+    /** What a drag traces while `pressed`: `path` for a freehand outline (a lasso), else a box from the press. */
+    gesture?: 'path';
     /** A short note shown next to the cursor (what the agent is doing). */
     message?: string;
     /** A rectangle (surface coordinates) the agent is working on, drawn as a highlight ring. */
@@ -87,13 +89,23 @@ export interface PresenceDragBox {
     width: number;
     height: number;
 }
+/** An agent's drag so far: the box from the press to the cursor, and the points it passed through. */
+export interface PresenceDrag extends PresenceDragBox {
+    /** The cursor positions since the press, in order (the press first). */
+    path: readonly {
+        x: number;
+        y: number;
+    }[];
+    /** `path` when the agent traces an outline (see `PresenceActor.gesture`); a box drag otherwise. */
+    gesture?: 'path';
+}
 /**
  * Follows a presence store for an agent's drag (press, move, release) and reports the box from
- * the press to the cursor, so a surface can draw its own drag feedback (a crop box or a marquee
- * being pulled out) under the agent's cursor. `onEnd` runs on release, or when the cursor leaves
+ * the press to the cursor and the path it took, so a surface can draw its own drag feedback (a crop
+ * box, a marquee being pulled out or a lasso being traced) under the agent's cursor. `onEnd` runs on release, or when the cursor leaves
  * the surface mid-drag. Pass the result to `PresenceStore.subscribe`.
  */
 export declare function trackPresenceDrag(handlers: {
-    onDrag: (box: PresenceDragBox) => void;
+    onDrag: (drag: PresenceDrag) => void;
     onEnd: () => void;
 }): (state: PresenceState) => void;

package/dist/tools/registry.d.cts

@@ -1,6 +1,6 @@
 import { type JsonSchema, type SchemaValidationError } from './schema.cjs';
 import { ToolRegistryView, type ToolViewOptions } from './view.cjs';
-import type { ToolPlanner } from './playback.cjs';
+import type { PlaybackStep, ToolPlanner } from './playback.cjs';
 import type { PresenceActorInfo } from './presence.cjs';
 /**
  * MCP-shaped tool definition, as returned by `tools/list`.
@@ -57,6 +57,12 @@ export interface ToolCallContext {
      * (`await context.stage?.()`), so they appear one by one; without playback it is absent.
      */
     stage?: () => Promise<void>;
+    /**
+     * Set by agent playback while the handler runs: acts out cursor steps (surface coordinates) the
+     * handler only learns mid-call, such as the outline a model returned, before it lands its change.
+     * `commit`, `stage` and `open` steps are ignored. Without playback it is absent.
+     */
+    perform?: (steps: readonly PlaybackStep[]) => Promise<void>;
 }
 /** Options for `callTool`. */
 export interface ToolCallOptions {

package/dist/tools/registry.d.ts

@@ -1,6 +1,6 @@
 import { type JsonSchema, type SchemaValidationError } from './schema.js';
 import { ToolRegistryView, type ToolViewOptions } from './view.js';
-import type { ToolPlanner } from './playback.js';
+import type { PlaybackStep, ToolPlanner } from './playback.js';
 import type { PresenceActorInfo } from './presence.js';
 /**
  * MCP-shaped tool definition, as returned by `tools/list`.
@@ -57,6 +57,12 @@ export interface ToolCallContext {
      * (`await context.stage?.()`), so they appear one by one; without playback it is absent.
      */
     stage?: () => Promise<void>;
+    /**
+     * Set by agent playback while the handler runs: acts out cursor steps (surface coordinates) the
+     * handler only learns mid-call, such as the outline a model returned, before it lands its change.
+     * `commit`, `stage` and `open` steps are ignored. Without playback it is absent.
+     */
+    perform?: (steps: readonly PlaybackStep[]) => Promise<void>;
 }
 /** Options for `callTool`. */
 export interface ToolCallOptions {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixerate/editor",
-  "version": "0.180.0",
+  "version": "0.182.0",
   "description": "UI-agnostic rich text and media editing core library",
   "author": "Pixerate",
   "license": "MIT",