@mseep/clawdcursor 1.5.5

package/dist/core/agent-loop/tools.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Unified-agent tool catalog.
+ *
+ * ONE tool vocabulary across blind / hybrid / vision modes. The only
+ * difference between modes: in `blind`, the `screenshot` tool is removed
+ * from the catalog before the LLM sees it.
+ *
+ * Design rules:
+ *   - Every mutation goes through PlatformAdapter (OS-agnostic).
+ *   - NO ctx.platform call happens outside a tool's `execute()` — the agent
+ *     loop never touches the adapter directly.
+ *   - Terminal actions (`done` / `give_up` / `cannot_read`) just return
+ *     `stop: true` with a terminalExit tag; the agent loop decides the
+ *     AgentResult.
+ *   - a11y-first wording. `invoke_element` and `set_field_value` are the
+ *     preferred targeting tools; coord clicks are the fallback.
+ *
+ * Zero app-specific rules. A new LOB app works because a11y roles + the
+ * rank-before-truncate sense layer surface its buttons.
+ */
+import type { UnifiedTool } from './types';
+export declare function buildUnifiedTools(): UnifiedTool[];
+/**
+ * Coerce an LLM-supplied coordinate argument into a clean `{ x, y }` pair.
+ * Models occasionally smush both axes into one field (e.g. `x="390, 79"`,
+ * `x="(390, 79)"`, or `x="390 79"`). The strict number schema makes `Number(...)`
+ * silently produce NaN, which then becomes a click at (NaN, y) — a crash
+ * disguised as a no-op. This helper splits the smushed form when present
+ * and falls back to a clean parse otherwise.
+ *
+ * App-agnostic, OS-agnostic, model-agnostic. Used by every coordinate-taking
+ * tool (click, drag, scroll, hover, move).
+ */
+export declare function coerceCoord(rawX: unknown, rawY: unknown): {
+    x: number;
+    y: number;
+    warning?: string;
+};