@arach/lattices 0.2.0 → 0.6.1

package/docs/voice-error-model.md

@@ -0,0 +1,73 @@
+# Voice Error Model
+
+## Goal + anchors
+
+Use one error vocabulary for Mac voice capture/execution and iPad relay/status. The canonical protocol says Lattices borrows Vox for capture and never owns the mic directly (`docs/voice-command-protocol.md:5-7`), but the shared runtime already has a cross-platform `DeckVoiceState` slot (`swift/Sources/DeckKit/DeckRuntimeSnapshot.swift:49-68`). Current Mac code exposes local strings (`VoxError`, `executionResult`) instead of structured errors (`apps/mac/Sources/VoxClient.swift:43-59`, `apps/mac/Sources/AudioProvider.swift:343-349`); iPad has only a generic `errorMessage` (`apps/ios/Sources/DeckStore.swift:18`). Normalize at DeckKit, then let each surface render the same object.
+
+## Error structure
+
+Prefer `DeckVoiceError` now; if later reused for trackpad/deck actions, lift the same shape to `LatsError`.
+
+```swift
+public struct DeckVoiceError: Codable, Equatable, Identifiable, Sendable {
+    public var id: String              // uuid or request id
+    public var code: DeckVoiceErrorCode
+    public var severity: DeckErrorSeverity
+    public var recoverable: Bool
+    public var retry: DeckRetryHint?
+    public var source: DeckErrorSource // mac, ipad, vox, daemon, intent, bridge
+    public var owner: String?          // e.g. "Vox", "Lattices", "Bridge"
+    public var message: String         // cockpit copy, already human-readable
+    public var remediation: DeckRemediationAction?
+    public var occurredAt: Date
+    public var detail: String?         // diagnostic-only
+}
+
+public enum DeckVoiceErrorCode: String, Codable, Sendable { case vox_unreachable, daemon_unreachable, network, connection_lost, mic_denied, accessibility_denied, mic_busy, no_active_target, vox_not_running, vox_loading, intent_unresolved, action_failed, transcription_failed, empty_transcript, language_unsupported }
+public enum DeckErrorSeverity: String, Codable, Sendable { case info, warning, error, blocked }
+public enum DeckRetryHint: String, Codable, Sendable { case silent, immediate, afterLaunch, userAction }
+public enum DeckErrorSource: String, Codable, Sendable { case mac, ipad, vox, daemon, intent, bridge }
+public enum DeckRemediationAction: Codable, Equatable, Sendable {
+    case openVox, openSystemSettings(kind: String), retryVoice, openDiagnostics, chooseTarget
+}
+```
+
+Add `var error: DeckVoiceError?` and optionally `var lastError: DeckVoiceError?` to `DeckVoiceState`, preserving existing `phase`, transcript, and provider fields (`swift/Sources/DeckKit/DeckRuntimeSnapshot.swift:49-68`). Codes should stay stable string raw values for JSON logs and iPad bridge snapshots.
+
+## Categories
+
+| Category | Codes | Recovery rule |
+|---|---|---|
+| Connection | `vox_unreachable`, `daemon_unreachable`, `network`, `connection_lost` | Recoverable unless active capture was lost. Silent reconnect when idle; visible banner during `listening`/`transcribing`. |
+| Permission | `mic_denied`, `accessibility_denied` | Needs user action. `mic_denied` is Mac/Vox-owned; iPad only relays it. `accessibility_denied` blocks execution/navigation. |
+| State | `mic_busy { owner }`, `no_active_target`, `vox_not_running`, `vox_loading` | Usually recoverable. `mic_busy` waits for owner; `vox_not_running` supports launch-on-demand. |
+| Execution | `intent_unresolved`, `action_failed`, `transcription_failed` | Recoverable by retry or edited command; escalate to log if repeated. |
+| Validation | `empty_transcript`, `language_unsupported` | Recoverable; no scary chrome. Treat as a missed command, not a crash. |
+
+Copy examples: `Mic in use by Vox — finish memo first`, `No target window`, `Vox offline — starting`, `Connection lost — press again`, `Intent not found`.
+
+## Presentation patterns
+
+**Mac VoiceCommandWindow.** Keep the three-column cockpit. The top mic bar already owns live state (`connecting...`, `processing...`; `apps/mac/Sources/VoiceCommandWindow.swift:692-719`); render the active error as a compact red/amber status chip there. The center column uses `commandSection` cards (`apps/mac/Sources/VoiceCommandWindow.swift:1287-1304`): show a single `blocked`/`needs action` card only when the user can do something. The footer already has key chips (`apps/mac/Sources/VoiceCommandWindow.swift:1308-1348`); replace the generic command list with contextual remediation: `⌥ Retry`, `Return Open Vox`, `⌘, Permissions`. Logs stay in the right rail, using existing level colors (`apps/mac/Sources/VoiceCommandWindow.swift:1112-1150`).
+
+**Mac HUD.** `HUDTopBar.voiceStatus` already has dot, label, transcript, response (`apps/mac/Sources/HUDTopBar.swift:134-198`). Add severity tint: green idle/listening, amber connecting/recoverable, red blocked. For active voice errors, HUD shows a one-line banner in the top bar; no sheet.
+
+**iPad Home.** Add `HomeVoiceOverlay` as the full voice modal for active relay: title row `VOICE`, phase, transcript, Mac owner, and one remediation button. The bottom bar already has dense status slots and `hold·space` (`apps/ios/Sources/Home/HomeBottomBar.swift:58-68`, `apps/ios/Sources/Home/HomeBottomBar.swift:129-148`); render idle/recoverable errors inline there (`voice · reconnecting`, `voice · Vox offline`). Use a deck overlay banner only when an issued iPad action failed. Use sheets only for permissions/pairing because they need human action. This follows the chrome rule: do not remove noisy UI; replace it with state that answers “what am I controlling, who is listening, what failed?” (`/Users/arach/.claude/projects/-Users-arach-dev-lattices/memory/feedback_chrome_design.md:11-13`).
+
+## Unhappy-path prescriptions
+
+**Launch Vox on demand.** Spec flow is detect installed/not running, open Vox, show `Starting Vox...`, wait up to 10s, retry `startDictation`, then fail with manual-open copy (`docs/voice-command-protocol.md:73-89`). Current Mac waits 2s after `connect()` (`apps/mac/Sources/VoiceCommandWindow.swift:290-313`); design target is `vox_not_running` → `vox_loading` → retry → either clear error or `vox_unreachable` with `openVox`.
+
+**Mic busy.** Preserve owner attribution from protocol (`docs/voice-command-protocol.md:127-135`). `mic_busy(owner: "Vox")` is warning, recoverable, retry hint `userAction`; message: `Mic in use by Vox — finish memo first`. If owner is unknown: `Mic busy — wait for current recording`.
+
+**Connection recovery.** If idle, reconnect silently and write log only. If active, show red `Connection lost`; do not auto-retry captured audio because Vox cancels dropped sockets (`docs/voice-command-protocol.md:174-188`). iPad shows `Mac voice link lost` if bridge lost, not `network` unless the iPad transport failed.
+
+**JSONL.** Add `~/.lattices/voice.jsonl` beside `lattices.log` (current log path is `~/.lattices/lattices.log`; `apps/mac/Sources/DiagnosticLog.swift:40-59`). Shape:
+
+```json
+{"ts":"2026-04-27T14:03:11.120Z","platform":"mac","sessionId":"...","phase":"listening","event":"error","error":{"code":"mic_busy","severity":"warning","recoverable":true,"source":"vox","owner":"Vox","message":"Mic in use by Vox — finish memo first"},"transcript":null,"intent":null,"durationMs":820}
+```
+
+## Cross-platform conventions
+
+Tone: terse cockpit, no apologies. Prefer noun-state-action: `Vox offline — starting`, `No target — pick window`, `Access denied — enable Accessibility`. Tint maps to existing palettes: Mac `Palette.detach` amber and `Palette.kill` red (`apps/mac/Sources/Theme.swift:19-23`); iPad `LatsPalette.amber/red` (`apps/ios/Sources/LatsDeckScreen.swift:19-25`). Icons: `mic.fill` live, `mic.slash` denied, `waveform.badge.exclamationmark` transcription, `bolt.trianglebadge.exclamationmark` execution, `wifi.exclamationmark` connection, `scope` target. Ownership: Mac owns Vox, mic, Accessibility, intent execution, and JSONL. iPad owns relay/bridge/network presentation and never claims direct mic capture.

package/docs/voice.md

@@ -0,0 +1,221 @@
+---
+title: Voice Commands
+description: Natural language voice control for window management
+order: 7
+---
+
+Voice commands let you control Lattices by speaking. Press **Hyper+D**
+to open the voice command window, hold **Option** to speak, release to
+stop. Lattices transcribes your speech via Vox,
+matches it to an intent, and executes it.
+
+## Quick start
+
+1. Install Vox (provides mic + transcription)
+2. Connect an Assistant provider in **Settings > AI**
+3. Press **Hyper+D** to open the voice command window
+4. Hold **Option** and speak a command
+5. Release **Option** — Lattices transcribes and executes
+
+## Keyboard shortcuts
+
+| Key | Action |
+|-----|--------|
+| **Hyper+D** | Open/close voice command window |
+| **⌥ (hold)** | Push-to-talk — hold to record, release to stop |
+| **Tab** | Arm/disarm the mic |
+| **Escape** | Cancel recording or dismiss window |
+
+## Built-in commands
+
+### Search
+
+Find windows by app name, title, content, or category.
+
+```
+"Find all vox windows"
+"Find terminals"           → expands to iTerm, Terminal, Warp, etc.
+"Show me all browsers"     → expands to Safari, Chrome, Firefox, Arc, etc.
+"Where is my editor?"      → expands to VS Code, Cursor, Xcode, etc.
+```
+
+Category synonyms are built in — saying "terminals", "browsers", "editors",
+"chat", "music", "mail", or "notes" automatically expands to search for
+the actual app names.
+
+### Tile
+
+Move windows to screen positions.
+
+```
+"Tile this left"
+"Snap to the right half"
+"Maximize the window"
+"Put this in the top right corner"
+```
+
+Voice tiling should resolve into the same canonical daemon mutation used
+by other agent surfaces: `window.place`.
+
+### Focus
+
+Bring a window or app to the front.
+
+```
+"Focus Safari"
+"Switch to Slack"
+"Go to the lattices window"
+```
+
+### Open / Launch
+
+Open applications or project workspaces.
+
+```
+"Open Spotify"
+"Launch the vox project"
+```
+
+### Kill
+
+Close windows or quit applications.
+
+```
+"Kill this window"
+"Close Safari"
+"Quit Spotify"
+```
+
+### Scan
+
+Trigger an OCR scan of visible windows.
+
+```
+"Scan the screen"
+"Read what's on screen"
+```
+
+### Other
+
+```
+"List all windows"
+"Show my sessions"
+"Switch to layer 2"
+"Help"
+```
+
+## AI advisor
+
+Every voice command can ask the selected Assistant provider for
+commentary and follow-up suggestions in the **AI corner** (bottom-right
+of the voice command window).
+
+When local matching handles the command well, the AI corner shows
+"no AI needed" with an optional "ask AI" button. When the advisor
+has something useful, it shows a one-line comment and an actionable
+suggestion button.
+
+### How it works
+
+1. You speak a command
+2. Local intent matching runs immediately (fast, free)
+3. The selected Assistant provider runs in parallel when connected
+4. If the advisor suggests something, a button appears in the AI corner
+5. Click the suggestion to execute it
+6. If you engage with a suggestion that the local matcher missed,
+   it's recorded in `~/.lattices/advisor-learning.jsonl` for future
+   improvement
+
+## Hands-off inference
+
+Hands-off voice uses the shared inference wrapper in `bin/infer.ts`.
+By default it chooses the lowest-latency configured provider and, when
+Groq credentials are present, uses `groq/llama-3.1-8b-instant`.
+
+Credentials are read from process env, `.env.local`, `.env`,
+`~/.lattices/inference.json`, then `~/.config/speakeasy/settings.json`.
+For Groq, either `GROQ_API_KEY` or the common typo `GROK_API_KEY` works
+when the key has Groq's `gsk_` prefix.
+
+Override the voice engine if needed:
+
+```bash
+LATTICES_VOICE_PROVIDER=groq
+LATTICES_VOICE_MODEL=llama-3.1-8b-instant
+```
+
+## Configuration
+
+Open **Settings > AI** to configure:
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| Assistant provider | OpenAI Codex | Provider used by the in-app chat and provider-backed voice advisor. Supports OAuth providers such as GitHub Copilot and OpenAI Codex plus API-key providers. |
+| Pi runtime | Auto-detected | Installs or refreshes the provider runtime used by the in-app assistant. |
+| Provider credentials | Not authenticated | Sign in with OAuth or save an API key locally for the selected provider. |
+
+## Layout
+
+The voice command window has four sections:
+
+| Section | Position | Content |
+|---------|----------|---------|
+| **History** | Left column | Past commands with expandable details |
+| **Voice Command** | Center column | Current transcript, matched intent, results |
+| **Log** | Top-right | Rolling diagnostic log (last 12 entries) |
+| **AI Corner** | Bottom-right | Advisor commentary, suggestions, provider readiness |
+
+## Search architecture
+
+Voice search uses the same backend as `lattices search`:
+
+1. **Quick search** — window titles, app names, session tags (instant)
+2. **Complete search** — adds terminal cwd/processes + OCR content
+3. **Synonym expansion** — category terms like "terminals" expand to
+   actual app names before searching
+4. **Query cleanup** — strips natural language qualifiers ("and sort by...",
+   "please", "for me") before searching
+
+## Processing resilience
+
+- **15-second timeout** — if processing doesn't complete, returns to idle
+- **Cancellation on dismiss** — closing the window cancels in-flight work
+- **Double-execution prevention** — streaming and stop callbacks can't
+  both fire the intent
+
+## Advisor learning
+
+When the local matcher fails but the AI advisor suggests something that
+you engage with, the interaction is recorded:
+
+```
+~/.lattices/advisor-learning.jsonl
+```
+
+Each line is a JSON object:
+
+```json
+{
+  "timestamp": "2026-03-15T18:30:00.000Z",
+  "transcript": "find all terminals",
+  "localIntent": "search",
+  "localSlots": {"query": "terminals"},
+  "localResultCount": 0,
+  "advisorIntent": "search",
+  "advisorSlots": {"query": "iterm"},
+  "advisorLabel": "Search iTerm"
+}
+```
+
+This dataset captures where the local system falls short and what the
+right answer was. Future work can mine it for automatic synonym
+mappings and phrase pattern improvements.
+
+## Requirements
+
+- **Vox** — provides microphone access and
+  speech-to-text transcription
+- **Assistant provider** — enables provider-backed AI suggestions from
+  **Settings > AI** (optional, voice commands still work without it)
+- **Accessibility** permission — for window tiling and focus
+- **Screen Recording** permission — for window discovery

package/package.json

@@ -1,19 +1,37 @@
 {
   "name": "@arach/lattices",
-  "version": "0.2.0",
-  "description": "macOS workspace manager with window tiling, OCR, and a 30-method daemon API for AI agents",
+  "version": "0.6.1",
+  "description": "macOS workspace manager — menu bar app, CLI, and WebSocket daemon API for tiling, search, layers, and agent control",
+  "homepage": "https://lattices.dev",
+  "bugs": {
+    "url": "https://github.com/arach/lattices/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "packageManager": "bun@1.3.11",
+  "engines": {
+    "node": ">=18"
+  },
   "bin": {
-    "lattices": "./bin/lattices.js",
-    "lattices-app": "./bin/lattices-app.js"
+    "lattices": "./bin/lattices.ts",
+    "lattices-app": "./bin/lattices-app.ts"
   },
   "keywords": [
+    "lattices",
+    "macos",
+    "workspace",
+    "window-manager",
     "tmux",
+    "daemon",
+    "ai-agents",
     "claude",
-    "dev-server",
     "developer-tools",
     "cli",
     "terminal",
-    "multiplexer"
+    "ocr",
+    "tiling"
   ],
   "repository": {
     "type": "git",
@@ -21,22 +39,57 @@
   },
   "license": "MIT",
   "exports": {
-    ".": "./bin/lattices.js",
-    "./daemon-client": "./bin/daemon-client.js"
+    ".": "./bin/client.ts",
+    "./assistant-intelligence": "./bin/assistant-intelligence.ts",
+    "./cua": "./bin/cua.ts",
+    "./daemon-client": "./bin/daemon-client.ts",
+    "./project-twin": "./bin/project-twin.ts"
   },
   "scripts": {
-    "dev": "bun --cwd docs-site dev"
+    "dev": "bun --cwd apps/site dev",
+    "site:build": "bun --cwd apps/site build",
+    "studio:dev": "bun --cwd apps/studio dev",
+    "studio:build": "bun --cwd apps/studio build",
+    "docs:agent": "bun --cwd apps/site agent-docs",
+    "check": "bun run check:types && bun run check:app",
+    "check:types": "tsc --noEmit",
+    "check:app": "env CLANG_MODULE_CACHE_PATH=/tmp/lattices-clang-cache SWIFTPM_TESTS_MODULECACHE=/tmp/lattices-swiftpm-cache swift build --package-path apps/mac",
+    "test": "node --experimental-strip-types --test tests/cli.test.mjs",
+    "test:cli": "node --experimental-strip-types --test tests/cli.test.mjs",
+    "test:e2e": "node --experimental-strip-types --test tests/e2e-daemon.test.mjs",
+    "test:e2e:voice": "node --experimental-strip-types tests/eval-voice.js",
+    "typecheck": "bun run check:types",
+    "build:app-bundle": "bash ./bin/lattices-build package",
+    "build:dev-app": "bash ./bin/lattices-build dev",
+    "build:dist": "bash ./bin/lattices-build dist",
+    "build:dist:local": "bash ./bin/lattices-build dist:local",
+    "prepack": "bash ./bin/lattices-build package"
   },
   "type": "module",
-  "engines": {
-    "node": ">=18"
-  },
   "os": ["darwin"],
   "files": [
     "bin",
-    "app/Package.swift",
-    "app/Sources",
-    "app/Lattices.app/Contents/Info.plist",
+    "packages/npm/sdk/cua.mjs",
+    "packages/npm/sdk/cua.d.ts",
+    "packages/npm/sdk/cua.d.mts",
+    "apps/mac/Info.plist",
+    "apps/mac/Lattices.app",
+    "apps/mac/Lattices.entitlements",
+    "apps/mac/Resources",
+    "assets/AppIcon.icns",
     "docs"
-  ]
+  ],
+  "devDependencies": {
+    "bun-types": "^1.3.10",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@ai-sdk/anthropic": "^3.0.58",
+    "@ai-sdk/google": "^3.0.43",
+    "@ai-sdk/openai": "^3.0.41",
+    "@ai-sdk/xai": "^3.0.67",
+    "@arach/speakeasy": "^0.2.8",
+    "ai": "^6.0.116",
+    "zod": "^3.25.76"
+  }
 }

package/packages/npm/sdk/cua.d.mts

@@ -0,0 +1 @@
+export * from "./cua.d.ts";

package/packages/npm/sdk/cua.d.ts

@@ -0,0 +1,188 @@
+import type { z } from "zod";
+
+export type ComputerTreatment = "observe" | "stage" | "present" | "execute";
+export type ComputerClickTransport =
+  | "auto"
+  | "ax"
+  | "accessibility"
+  | "pointer"
+  | "mouse"
+  | "hardware";
+export type CursorStyle = "spotlight" | "pulse" | "marker";
+export type CursorShape =
+  | "arrow"
+  | "chevron"
+  | "facet"
+  | "shard"
+  | "wedge"
+  | "prism"
+  | "notch"
+  | "needle"
+  | "petal"
+  | "kite";
+export type CursorSize = "tiny" | "small" | "regular" | "large";
+export type CursorTrail = "none" | "thread" | "ribbon" | "spark" | "comet" | "route";
+export type CursorMotion =
+  | "glide"
+  | "snap"
+  | "float"
+  | "rush"
+  | "crawl"
+  | "accelerate"
+  | "teleport"
+  | "spring"
+  | "magnet"
+  | "slingshot";
+export type CursorTrajectory = "straight" | "soft" | "arc" | "swoop" | "overshoot";
+export type CursorGlow = "none" | "soft" | "halo" | "comet";
+export type CursorIdle =
+  | "still"
+  | "breathe"
+  | "wiggle"
+  | "orbit"
+  | "hover"
+  | "nod"
+  | "drift"
+  | "shimmer"
+  | "blink"
+  | "tremble";
+export type CursorEdge =
+  | "none"
+  | "pulse"
+  | "ripple"
+  | "tick"
+  | "reticle"
+  | "blink"
+  | "spark"
+  | "underline"
+  | "echo"
+  | "scan"
+  | "pin";
+export type CursorSound = "none" | "tick" | "click" | "engage" | "chime";
+export type CaptionPlacement =
+  | "top-left"
+  | "top-right"
+  | "bottom-left"
+  | "bottom-right"
+  | "top-center"
+  | "top"
+  | "center"
+  | "middle"
+  | "near-cursor"
+  | "cursor";
+
+export interface WindowTarget {
+  wid?: number;
+  app?: string;
+  title?: string;
+}
+
+export interface ActionBase {
+  treatment?: ComputerTreatment;
+  dryRun?: boolean;
+  capture?: boolean;
+  source?: string;
+}
+
+export interface PointTarget {
+  x?: number;
+  y?: number;
+  xRatio?: number;
+  yRatio?: number;
+}
+
+export interface ComputerClickParams extends WindowTarget, PointTarget, ActionBase {
+  button?: "left" | "right" | "secondary" | "context";
+  transport?: ComputerClickTransport;
+  axLabel?: string;
+  targetText?: string;
+  noFocus?: boolean;
+  label?: string;
+}
+
+export interface ComputerMagicCursorParams extends WindowTarget, PointTarget, ActionBase {
+  style?: CursorStyle;
+  appearance?: CursorStyle;
+  shape?: CursorShape;
+  angleDeg?: number;
+  size?: CursorSize;
+  color?: string;
+  durationMs?: number;
+  label?: string;
+  caption?: string;
+  captionTitle?: string;
+  captionBody?: string;
+  captionDetail?: string;
+  captionTags?: string;
+  captionMode?: "auto" | "selection";
+  captionEyebrow?: string;
+  captionLeadMs?: number;
+  captionSound?: CursorSound;
+  captionPlacement?: CaptionPlacement;
+  captionMargin?: number;
+  captionX?: number;
+  captionY?: number;
+  captionXRatio?: number;
+  captionYRatio?: number;
+  captionLeftRatio?: number;
+  captionTopRatio?: number;
+  sound?: CursorSound;
+  sfx?: CursorSound;
+  showCaption?: boolean;
+  captionSelections?: boolean;
+  treatmentLabel?: string;
+  variant?: string;
+  trail?: CursorTrail;
+  pathStyle?: CursorTrail;
+  motion?: CursorMotion;
+  trajectory?: CursorTrajectory;
+  glow?: CursorGlow;
+  bloom?: CursorGlow;
+  idle?: CursorIdle;
+  settle?: CursorIdle;
+  presence?: CursorIdle;
+  edge?: CursorEdge;
+  edgeEffect?: CursorEdge;
+  arrival?: CursorEdge;
+  typewriter?: boolean;
+  typing?: boolean;
+  typeIntervalMs?: number;
+  typingIntervalMs?: number;
+  text?: string;
+  append?: boolean;
+  fromX?: number;
+  fromY?: number;
+  fromXRatio?: number;
+  fromYRatio?: number;
+}
+
+export interface CuaClientOptions {
+  defaultTimeoutMs?: number;
+}
+
+export interface CuaClient {
+  click(params: ComputerClickParams): Promise<unknown>;
+  magicCursor(params: ComputerMagicCursorParams): Promise<unknown>;
+}
+
+export declare const computerTreatmentSchema: z.ZodType<ComputerTreatment>;
+export declare const computerClickTransportSchema: z.ZodType<ComputerClickTransport>;
+export declare const cursorStyleSchema: z.ZodType<CursorStyle>;
+export declare const cursorShapeSchema: z.ZodType<CursorShape>;
+export declare const cursorSizeSchema: z.ZodType<CursorSize>;
+export declare const cursorTrailSchema: z.ZodType<CursorTrail>;
+export declare const cursorMotionSchema: z.ZodType<CursorMotion>;
+export declare const cursorTrajectorySchema: z.ZodType<CursorTrajectory>;
+export declare const cursorGlowSchema: z.ZodType<CursorGlow>;
+export declare const cursorIdleSchema: z.ZodType<CursorIdle>;
+export declare const cursorEdgeSchema: z.ZodType<CursorEdge>;
+export declare const cursorSoundSchema: z.ZodType<CursorSound>;
+export declare const captionPlacementSchema: z.ZodType<CaptionPlacement>;
+export declare const computerClickParamsSchema: z.ZodType<ComputerClickParams>;
+export declare const computerMagicCursorParamsSchema: z.ZodType<ComputerMagicCursorParams>;
+
+export declare function createCuaClient(options?: CuaClientOptions): CuaClient;
+export declare function click(params: ComputerClickParams): Promise<unknown>;
+export declare function magicCursor(params: ComputerMagicCursorParams): Promise<unknown>;
+
+export declare const cua: CuaClient;