@rudderjs/ai 1.17.3 → 1.18.1

package/dist/cached-embedding.js

@@ -1,44 +0,0 @@
-/**
- * In-memory caching wrapper for any EmbeddingAdapter.
- *
- * Caches embeddings by `model:text` key so repeated inputs skip the provider call.
- * Cache hits report zero token usage since no API call is made.
- */
-export class CachedEmbeddingAdapter {
-    inner;
-    cache = new Map();
-    constructor(inner) {
-        this.inner = inner;
-    }
-    async embed(input, model) {
-        const inputs = Array.isArray(input) ? input : [input];
-        const results = [];
-        const uncached = [];
-        const uncachedIndices = [];
-        for (let i = 0; i < inputs.length; i++) {
-            const key = `${model}:${inputs[i]}`;
-            const cached = this.cache.get(key);
-            if (cached) {
-                results[i] = cached;
-            }
-            else {
-                uncached.push(inputs[i]);
-                uncachedIndices.push(i);
-            }
-        }
-        if (uncached.length > 0) {
-            const fresh = await this.inner.embed(uncached, model);
-            for (let j = 0; j < uncachedIndices.length; j++) {
-                const idx = uncachedIndices[j];
-                const embedding = fresh.embeddings[j];
-                results[idx] = embedding;
-                this.cache.set(`${model}:${uncached[j]}`, embedding);
-            }
-        }
-        return {
-            embeddings: results,
-            usage: { promptTokens: 0, totalTokens: 0 },
-        };
-    }
-}
-//# sourceMappingURL=cached-embedding.js.map

package/dist/cached-embedding.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cached-embedding.js","sourceRoot":"","sources":["../src/cached-embedding.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,sBAAsB;IAGb;IAFZ,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAA;IAE3C,YAAoB,KAAuB;QAAvB,UAAK,GAAL,KAAK,CAAkB;IAAG,CAAC;IAE/C,KAAK,CAAC,KAAK,CAAC,KAAwB,EAAE,KAAa;QACjD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QACrD,MAAM,OAAO,GAAe,EAAE,CAAA;QAC9B,MAAM,QAAQ,GAAa,EAAE,CAAA;QAC7B,MAAM,eAAe,GAAa,EAAE,CAAA;QAEpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,GAAG,GAAG,GAAG,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;YACnC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YAClC,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAA;YACrB,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAA;gBACzB,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACzB,CAAC;QACH,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;YACrD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAChD,MAAM,GAAG,GAAG,eAAe,CAAC,CAAC,CAAE,CAAA;gBAC/B,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAE,CAAA;gBACtC,OAAO,CAAC,GAAG,CAAC,GAAG,SAAS,CAAA;gBACxB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,CAAC,CAAA;YACtD,CAAC;QACH,CAAC;QAED,OAAO;YACL,UAAU,EAAE,OAAO;YACnB,KAAK,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE;SAC3C,CAAA;IACH,CAAC;CACF"}

package/dist/computer-use/actions.d.ts

@@ -1,214 +0,0 @@
-/**
- * Action vocabulary for `@rudderjs/ai/computer-use` (#A7 Phase 1).
- *
- * Mirrors Anthropic's `computer_20250124` tool schema verbatim — see
- * https://docs.anthropic.com/en/docs/build-with-claude/tool-use/computer-use-tool
- *
- * The model emits a {@link ComputerAction} as the JSON argument of a
- * `computer` tool call; the executor (see `./playwright.ts`) dispatches
- * the action against a Playwright `Page` and returns a
- * {@link ComputerActionResult} the agent loop forwards back to the model.
- *
- * # Why mirror Anthropic exactly?
- *
- * Computer-use is `Anthropic-only` in v1 (see plan
- * `docs/plans/2026-05-10-ai-computer-use.md`). Claude is fine-tuned on
- * this exact action vocabulary; reusing the schema means:
- *
- * - Phase 2's `computerUseTool({ page })` factory maps cleanly to
- *   Anthropic's native `{ type: 'computer_20250124', name: 'computer',
- *   display_width_px, display_height_px }` block — zero translation
- *   layer.
- * - When OpenAI or Google's native computer-use APIs mature enough to
- *   route through, only the provider adapter changes; the schema and
- *   executor stay put.
- *
- * # Coordinates
- *
- * `[x, y]` in viewport pixels. Origin is top-left. Anthropic suggests a
- * 1280×800 viewport for Claude's training distribution; the executor
- * does not validate bounds — out-of-viewport coordinates pass through
- * to Playwright (which clips the cursor to viewport edges).
- *
- * # Modifier text on click / scroll actions
- *
- * Anthropic encodes "hold these modifier keys while clicking" as a `+`
- * separated string on the `text` field — e.g.
- * `{ action: 'left_click', coordinate: [400, 200], text: 'shift+ctrl' }`.
- * The executor translates `cmd`/`super`/`meta` → `Meta`,
- * `ctrl`/`control` → `Control`, etc. before passing to Playwright.
- */
-/** Viewport pixel coordinate, top-left origin. `[x, y]`. */
-export type Coordinate = readonly [number, number];
-/**
- * Discriminated union of every action Anthropic's `computer_20250124`
- * tool can emit. The executor dispatches on `action`; downstream code
- * should treat unknown variants as a forward-compatibility hazard
- * rather than a bug — Anthropic versions the schema with dated suffixes
- * (e.g. a future `computer_20260101` may add new variants we'll route
- * here once supported).
- */
-export type ComputerAction = {
-    action: 'screenshot';
-} | {
-    action: 'cursor_position';
-}
-/** Pause for `duration` seconds. Useful between an action that triggers async UI and the screenshot that should observe the result. */
- | {
-    action: 'wait';
-    duration: number;
-} | {
-    action: 'mouse_move';
-    coordinate: Coordinate;
-}
-/** Single left-button click. `text` holds optional modifier keys, `+`-separated (e.g. `'shift+ctrl'`). */
- | {
-    action: 'left_click';
-    coordinate: Coordinate;
-    text?: string;
-} | {
-    action: 'right_click';
-    coordinate: Coordinate;
-    text?: string;
-} | {
-    action: 'middle_click';
-    coordinate: Coordinate;
-    text?: string;
-} | {
-    action: 'double_click';
-    coordinate: Coordinate;
-    text?: string;
-} | {
-    action: 'triple_click';
-    coordinate: Coordinate;
-    text?: string;
-}
-/** Press the left mouse button. Pair with `left_mouse_up` to drag. `coordinate` (optional) moves first. */
- | {
-    action: 'left_mouse_down';
-    coordinate?: Coordinate;
-}
-/** Release the left mouse button. `coordinate` (optional) moves first. */
- | {
-    action: 'left_mouse_up';
-    coordinate?: Coordinate;
-}
-/** Type literal text. No modifier handling — use `key` for shortcuts. */
- | {
-    action: 'type';
-    text: string;
-}
-/** Press a key chord. `text` is `+`-separated (e.g. `'ctrl+a'`, `'Return'`, `'cmd+shift+t'`). */
- | {
-    action: 'key';
-    text: string;
-}
-/** Hold a single key for `duration` seconds. `text` is one key, not a chord. */
- | {
-    action: 'hold_key';
-    text: string;
-    duration: number;
-}
-/** Scroll at `coordinate`. `scroll_amount` is in mouse-wheel "clicks" (~100px each). `text` holds optional modifiers. */
- | {
-    action: 'scroll';
-    coordinate: Coordinate;
-    scroll_direction: 'up' | 'down' | 'left' | 'right';
-    scroll_amount: number;
-    text?: string;
-};
-/**
- * Tool-result content the agent loop hands back to the model after each
- * action. Shape matches Anthropic's tool-result block content vocabulary:
- *
- * - `image` carries a PNG screenshot. The agent loop wraps this as
- *   `{ type: 'image', source: { type: 'base64', media_type, data } }`
- *   when serializing to the API.
- * - `text` carries a one-line confirmation (`"left-clicked at (400, 200)"`)
- *   or the response of an introspective action (`cursor_position`).
- * - `error` carries the failure text from a Playwright throw. Caller
- *   typically maps this onto `{ is_error: true, content: [...] }` in
- *   the tool-result block so the model knows the action failed and can
- *   retry / recover.
- */
-export type ComputerActionResult = {
-    type: 'image';
-    media_type: 'image/png';
-    data: Uint8Array;
-} | {
-    type: 'text';
-    text: string;
-} | {
-    type: 'error';
-    text: string;
-};
-/**
- * Per-run state the executor mutates. Tracks the last known cursor
- * position so the `cursor_position` action can answer it (Playwright
- * has no native API to read the synthesized mouse position).
- *
- * Create one with {@link makeExecutorState} per agent run; pass the
- * same instance to every {@link executeComputerAction} call.
- */
-export interface ComputerExecutorState {
-    /** Last known cursor position in viewport pixels. Updated on move/click/drag. */
-    cursor: {
-        x: number;
-        y: number;
-    };
-}
-/**
- * Construct a fresh {@link ComputerExecutorState}. Optional `initial`
- * seeds the cursor (defaults to `(0, 0)`).
- */
-export declare function makeExecutorState(initial?: {
-    x: number;
-    y: number;
-}): ComputerExecutorState;
-/**
- * Structural subset of Playwright's `Page` the executor calls. Defining
- * this here means {@link executeComputerAction} types correctly without
- * `@rudderjs/ai` taking a hard dependency on the `playwright` package
- * (which carries a 300MB+ Chromium download). Apps install Playwright
- * themselves and pass `page` in.
- *
- * Any object with this shape works — real Playwright `Page`,
- * `puppeteer-core`'s `Page` (close enough), or a hand-rolled mock for
- * tests. Phase 2's `computerUseTool({ page })` accepts the same type.
- */
-export interface PageLike {
-    mouse: PageMouseLike;
-    keyboard: PageKeyboardLike;
-    /** Take a screenshot of the current viewport. Returns PNG bytes by default. */
-    screenshot(options?: {
-        type?: 'png' | 'jpeg';
-    }): Promise<Uint8Array>;
-}
-export interface PageMouseLike {
-    move(x: number, y: number, options?: {
-        steps?: number;
-    }): Promise<void>;
-    click(x: number, y: number, options?: {
-        button?: 'left' | 'right' | 'middle';
-        clickCount?: number;
-        delay?: number;
-    }): Promise<void>;
-    down(options?: {
-        button?: 'left' | 'right' | 'middle';
-    }): Promise<void>;
-    up(options?: {
-        button?: 'left' | 'right' | 'middle';
-    }): Promise<void>;
-    wheel(deltaX: number, deltaY: number): Promise<void>;
-}
-export interface PageKeyboardLike {
-    type(text: string, options?: {
-        delay?: number;
-    }): Promise<void>;
-    press(key: string, options?: {
-        delay?: number;
-    }): Promise<void>;
-    down(key: string): Promise<void>;
-    up(key: string): Promise<void>;
-}
-//# sourceMappingURL=actions.d.ts.map

package/dist/computer-use/actions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/computer-use/actions.ts"],"names":[],"mappings":"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"}

package/dist/computer-use/actions.js

@@ -1,48 +0,0 @@
-/**
- * Action vocabulary for `@rudderjs/ai/computer-use` (#A7 Phase 1).
- *
- * Mirrors Anthropic's `computer_20250124` tool schema verbatim — see
- * https://docs.anthropic.com/en/docs/build-with-claude/tool-use/computer-use-tool
- *
- * The model emits a {@link ComputerAction} as the JSON argument of a
- * `computer` tool call; the executor (see `./playwright.ts`) dispatches
- * the action against a Playwright `Page` and returns a
- * {@link ComputerActionResult} the agent loop forwards back to the model.
- *
- * # Why mirror Anthropic exactly?
- *
- * Computer-use is `Anthropic-only` in v1 (see plan
- * `docs/plans/2026-05-10-ai-computer-use.md`). Claude is fine-tuned on
- * this exact action vocabulary; reusing the schema means:
- *
- * - Phase 2's `computerUseTool({ page })` factory maps cleanly to
- *   Anthropic's native `{ type: 'computer_20250124', name: 'computer',
- *   display_width_px, display_height_px }` block — zero translation
- *   layer.
- * - When OpenAI or Google's native computer-use APIs mature enough to
- *   route through, only the provider adapter changes; the schema and
- *   executor stay put.
- *
- * # Coordinates
- *
- * `[x, y]` in viewport pixels. Origin is top-left. Anthropic suggests a
- * 1280×800 viewport for Claude's training distribution; the executor
- * does not validate bounds — out-of-viewport coordinates pass through
- * to Playwright (which clips the cursor to viewport edges).
- *
- * # Modifier text on click / scroll actions
- *
- * Anthropic encodes "hold these modifier keys while clicking" as a `+`
- * separated string on the `text` field — e.g.
- * `{ action: 'left_click', coordinate: [400, 200], text: 'shift+ctrl' }`.
- * The executor translates `cmd`/`super`/`meta` → `Meta`,
- * `ctrl`/`control` → `Control`, etc. before passing to Playwright.
- */
-/**
- * Construct a fresh {@link ComputerExecutorState}. Optional `initial`
- * seeds the cursor (defaults to `(0, 0)`).
- */
-export function makeExecutorState(initial) {
-    return { cursor: { x: initial?.x ?? 0, y: initial?.y ?? 0 } };
-}
-//# sourceMappingURL=actions.js.map

package/dist/computer-use/actions.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../src/computer-use/actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAqFH;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAkC;IAClE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAA;AAC/D,CAAC"}

package/dist/computer-use/errors.d.ts

@@ -1,57 +0,0 @@
-/**
- * Error classes for `@rudderjs/ai/computer-use` (#A7 Phase 2).
- *
- * Both extend native `Error` so apps can `instanceof`-check from
- * `try/catch`, error middleware, observers, etc.
- */
-/**
- * Thrown by {@link computerUseTool} at construction time when the
- * caller supplies a `model` that isn't an Anthropic-family model
- * (matches `anthropic/*` or `bedrock/<region.>?anthropic.*`).
- *
- * Computer-use is Anthropic-only in v1 — see plan
- * `docs/plans/2026-05-10-ai-computer-use.md`. Other providers either
- * lack native computer-use entirely (Google, Cohere, …) or only have
- * preview-quality versions that aren't worth shipping yet (OpenAI's
- * `computer_use_preview`).
- *
- * Apps that wire `computerUseTool({ page, model: this.model() })`
- * inside `Agent.tools()` get this error at agent boot — fail loud
- * before the model gets a chance to hallucinate tool calls against a
- * provider that can't execute them.
- */
-export declare class ComputerUseProviderError extends Error {
-    readonly code: "COMPUTER_USE_PROVIDER_MISMATCH";
-    readonly model: string;
-    constructor(model: string);
-}
-/**
- * Thrown by {@link computerUseTool}'s execute when the per-run action
- * counter exceeds {@link ComputerUseToolOptions.maxActions}.
- *
- * Bounds runaway agent loops (e.g. a model that keeps clicking the
- * same broken button forever). Default cap is 50 — most real
- * computer-use tasks finish well under that. Override via
- * `computerUseTool({ page, maxActions: 100 })`.
- */
-export declare class ComputerUseLimitError extends Error {
-    readonly code: "COMPUTER_USE_LIMIT_EXCEEDED";
-    readonly maxActions: number;
-    constructor(maxActions: number);
-}
-/**
- * Returns true when `model` is an Anthropic-family model id —
- * `anthropic/*` or `bedrock/<region.>?anthropic.*` (covers cross-region
- * inference profiles like `us.anthropic.*`, `eu.anthropic.*`,
- * `apac.anthropic.*`).
- *
- * Used by {@link computerUseTool}'s upfront `model` check. Exported so
- * apps can guard their own code path symmetrically.
- *
- * **Excludes** OpenRouter-routed Anthropic models
- * (`openrouter/anthropic/*`) — OpenRouter goes through the OpenAI SDK
- * with a different base URL, so the request never hits Anthropic's
- * native API and the native computer-use tool block can't be sent.
- */
-export declare function isAnthropicLikeModel(model: string): boolean;
-//# sourceMappingURL=errors.d.ts.map

package/dist/computer-use/errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/computer-use/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,EAAG,gCAAgC,CAAS;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;gBAEV,KAAK,EAAE,MAAM;CAQ1B;AAED;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAG,6BAA6B,CAAS;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;gBAEf,UAAU,EAAE,MAAM;CAQ/B;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAM3D"}

package/dist/computer-use/errors.js

@@ -1,76 +0,0 @@
-/**
- * Error classes for `@rudderjs/ai/computer-use` (#A7 Phase 2).
- *
- * Both extend native `Error` so apps can `instanceof`-check from
- * `try/catch`, error middleware, observers, etc.
- */
-/**
- * Thrown by {@link computerUseTool} at construction time when the
- * caller supplies a `model` that isn't an Anthropic-family model
- * (matches `anthropic/*` or `bedrock/<region.>?anthropic.*`).
- *
- * Computer-use is Anthropic-only in v1 — see plan
- * `docs/plans/2026-05-10-ai-computer-use.md`. Other providers either
- * lack native computer-use entirely (Google, Cohere, …) or only have
- * preview-quality versions that aren't worth shipping yet (OpenAI's
- * `computer_use_preview`).
- *
- * Apps that wire `computerUseTool({ page, model: this.model() })`
- * inside `Agent.tools()` get this error at agent boot — fail loud
- * before the model gets a chance to hallucinate tool calls against a
- * provider that can't execute them.
- */
-export class ComputerUseProviderError extends Error {
-    code = 'COMPUTER_USE_PROVIDER_MISMATCH';
-    model;
-    constructor(model) {
-        super(`[Rudder AI] computerUseTool is Anthropic-only in v1; got model "${model}". ` +
-            `Use an "anthropic/*" or "bedrock/<region.>?anthropic.*" model, or remove the tool.`);
-        this.name = 'ComputerUseProviderError';
-        this.model = model;
-    }
-}
-/**
- * Thrown by {@link computerUseTool}'s execute when the per-run action
- * counter exceeds {@link ComputerUseToolOptions.maxActions}.
- *
- * Bounds runaway agent loops (e.g. a model that keeps clicking the
- * same broken button forever). Default cap is 50 — most real
- * computer-use tasks finish well under that. Override via
- * `computerUseTool({ page, maxActions: 100 })`.
- */
-export class ComputerUseLimitError extends Error {
-    code = 'COMPUTER_USE_LIMIT_EXCEEDED';
-    maxActions;
-    constructor(maxActions) {
-        super(`[Rudder AI] computerUseTool exceeded maxActions cap of ${maxActions}. ` +
-            `Bump the cap with computerUseTool({ page, maxActions: <n> }) if your agent legitimately needs more steps.`);
-        this.name = 'ComputerUseLimitError';
-        this.maxActions = maxActions;
-    }
-}
-// ─── Model classification ─────────────────────────────────
-/**
- * Returns true when `model` is an Anthropic-family model id —
- * `anthropic/*` or `bedrock/<region.>?anthropic.*` (covers cross-region
- * inference profiles like `us.anthropic.*`, `eu.anthropic.*`,
- * `apac.anthropic.*`).
- *
- * Used by {@link computerUseTool}'s upfront `model` check. Exported so
- * apps can guard their own code path symmetrically.
- *
- * **Excludes** OpenRouter-routed Anthropic models
- * (`openrouter/anthropic/*`) — OpenRouter goes through the OpenAI SDK
- * with a different base URL, so the request never hits Anthropic's
- * native API and the native computer-use tool block can't be sent.
- */
-export function isAnthropicLikeModel(model) {
-    if (model.startsWith('anthropic/'))
-        return true;
-    // Bedrock: bedrock/anthropic.* OR bedrock/<region>.anthropic.*
-    // (region prefixes us./eu./apac./...)
-    if (/^bedrock\/(?:[a-z]{2,4}\.)?anthropic\./.test(model))
-        return true;
-    return false;
-}
-//# sourceMappingURL=errors.js.map

package/dist/computer-use/errors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/computer-use/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACxC,IAAI,GAAG,gCAAyC,CAAA;IAChD,KAAK,CAAQ;IAEtB,YAAY,KAAa;QACvB,KAAK,CACH,mEAAmE,KAAK,KAAK;YAC7E,oFAAoF,CACrF,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAA;QACtC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IACrC,IAAI,GAAG,6BAAsC,CAAA;IAC7C,UAAU,CAAQ;IAE3B,YAAY,UAAkB;QAC5B,KAAK,CACH,0DAA0D,UAAU,IAAI;YACxE,2GAA2G,CAC5G,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAA;QACnC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;CACF;AAED,6DAA6D;AAE7D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,IAAI,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAA;IAC/C,+DAA+D;IAC/D,sCAAsC;IACtC,IAAI,wCAAwC,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACrE,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/computer-use/playwright.d.ts

@@ -1,76 +0,0 @@
-/**
- * Playwright executor for {@link ComputerAction} (#A7 Phase 1).
- *
- * Translates Anthropic's `computer_20250124` action vocabulary into
- * Playwright `Page` calls. Stateless apart from {@link ComputerExecutorState},
- * which the caller threads through so `cursor_position` can answer.
- *
- * # Errors
- *
- * Playwright throws on failures (selector misses, timeouts, navigation
- * during action). The executor catches and returns
- * `{ type: 'error', text: <message> }` so the agent loop can hand the
- * failure back to the model as a tool-result with `is_error: true`. The
- * model decides whether to retry, recover, or give up — failing the
- * whole agent run on a single missed click is too brittle.
- *
- * # Modifier keys & key chords
- *
- * Anthropic uses xdotool naming (`ctrl`, `cmd`, `Return`); Playwright
- * uses its own (`Control`, `Meta`, `Enter`). {@link normalizeKey} maps
- * the common ones; unmapped keys pass through verbatim and Playwright
- * either accepts them (single chars, function keys) or throws — which
- * surfaces as the standard error path above.
- *
- * # Scroll units
- *
- * Anthropic's `scroll_amount` is in mouse-wheel "clicks". A typical
- * desktop wheel click is ~100px; the executor multiplies through
- * {@link SCROLL_PIXELS_PER_CLICK}. Tunable later if customer feedback
- * shows drift.
- */
-import type { ComputerAction, ComputerActionResult, ComputerExecutorState, PageLike } from './actions.js';
-/**
- * Pixels per `scroll_amount` unit. Roughly matches a desktop mouse
- * wheel click on most platforms.
- */
-export declare const SCROLL_PIXELS_PER_CLICK = 100;
-/**
- * Number of intermediate move steps Playwright interpolates when the
- * executor moves the mouse to a target. Higher = smoother (more hover
- * events fire), but slower. 5 is a reasonable default — instant enough
- * for most pages, slow enough that hover-driven UI (tooltips, menus)
- * has a chance to react.
- */
-export declare const MOUSE_MOVE_STEPS = 5;
-/**
- * Dispatch a single {@link ComputerAction} against a Playwright `Page`.
- *
- * Updates `state.cursor` after every action that targets a coordinate
- * (move / click / drag / scroll). Caller owns `state` and threads it
- * through every call within an agent run.
- *
- * Returns a {@link ComputerActionResult} suitable for forwarding to the
- * model as a tool-result. Never throws — Playwright failures surface as
- * `{ type: 'error', text }`.
- */
-export declare function executeComputerAction(page: PageLike, action: ComputerAction, state: ComputerExecutorState): Promise<ComputerActionResult>;
-/**
- * Parse Anthropic's `+`-separated modifier text into Playwright key
- * names. Empty / undefined input → empty array (no modifiers).
- */
-export declare function parseModifiers(text: string | undefined): string[];
-/**
- * Map Anthropic / xdotool key names to Playwright key names.
- * Unmapped keys (single chars, F-keys, anything we haven't covered)
- * pass through verbatim — Playwright either accepts them or throws,
- * which is the right failure mode.
- */
-export declare function normalizeKey(key: string): string;
-/**
- * Normalize a key chord (`+`-separated). Playwright's
- * `keyboard.press()` parses chords natively, so we just normalize each
- * segment and rejoin.
- */
-export declare function normalizeChord(chord: string): string;
-//# sourceMappingURL=playwright.d.ts.map

package/dist/computer-use/playwright.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"playwright.d.ts","sourceRoot":"","sources":["../../src/computer-use/playwright.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,QAAQ,EACT,MAAM,cAAc,CAAA;AAErB;;;GAGG;AACH,eAAO,MAAM,uBAAuB,MAAM,CAAA;AAE1C;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAA;AAEjC;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CA4I/B;AAQD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAMjE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA8BhD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKpD"}