visionclaw 0.1.211-beta.6 → 0.1.211

package/dist/tools/coordinate-resolver.js

@@ -0,0 +1,104 @@
+/**
+ * Resolves natural language targets to pixel coordinates using
+ * Anthropic's computer_20251124 tool via the Messages API.
+ *
+ * Sends screenshot + instruction to Claude; Claude returns a tool_use
+ * with action and coordinate. We extract coordinates only (no execution).
+ *
+ * IMPORTANT: The input screenshot is assumed to be already resized to fit
+ * Claude's vision constraints (done by takeScreenshot). We read the actual
+ * image dimensions, tell the computer-use tool those are the display size,
+ * and unscale returned coordinates back to the real display space.
+ * Reference: https://platform.claude.com/docs/en/agents-and-tools/tool-use/computer-use-tool
+ */
+import { logger } from "../logger.js";
+import { getImageDimensions, getImageDimensionsFromFile } from "./screenshot.js";
+import { createClient, getModelId } from "../agent/providers/client-factory.js";
+function clamp(n, min, max) {
+    return Math.max(min, Math.min(max, n));
+}
+// ── Resolver ───────────────────────────────────────────────────────────
+/**
+ * Resolve a natural language target to pixel coordinates.
+ * Uses Messages API with computer_20251124 tool; returns the first tool_use result.
+ *
+ * The input screenshot is expected to already be resized to fit Claude's
+ * vision constraints (by takeScreenshot). We read its actual pixel dimensions,
+ * use those as display_width_px / display_height_px, and unscale the returned
+ * coordinates back to the real display space using imageWidth/displayWidth ratio.
+ */
+export async function resolveCoordinates(screenshotBase64, instruction, displayWidth, displayHeight, config, screenshotFilePath) {
+    // Read actual pixel dimensions of the (already resized) screenshot.
+    // Prefer file path to avoid base64 decode + temp file round-trip.
+    const dims = screenshotFilePath
+        ? await getImageDimensionsFromFile(screenshotFilePath)
+        : await getImageDimensions(Buffer.from(screenshotBase64, "base64"));
+    if (!dims) {
+        logger.warn("Could not read screenshot dimensions, aborting coordinate resolution");
+        return null;
+    }
+    const imgW = dims.width;
+    const imgH = dims.height;
+    // Scale factors to convert from image space back to actual display space
+    const scaleX = displayWidth / imgW;
+    const scaleY = displayHeight / imgH;
+    logger.info(`Resolving coordinates: "${instruction}" (display ${displayWidth}x${displayHeight}, image ${imgW}x${imgH}, scaleX=${scaleX.toFixed(3)}, scaleY=${scaleY.toFixed(3)})`, { instruction, displayWidth, displayHeight, imgW, imgH, scaleX, scaleY });
+    const client = createClient(config);
+    const response = await client.beta.messages.create({
+        model: getModelId(config),
+        max_tokens: 1024,
+        betas: ["computer-use-2025-11-24"],
+        tools: [
+            {
+                type: "computer_20251124",
+                name: "computer",
+                display_width_px: imgW,
+                display_height_px: imgH,
+                display_number: 1,
+            },
+        ],
+        system: "You are a helpful assistant that can resolve natural language targets to pixel coordinates using the computer tool. Call the tool directly, no questions or explanations.",
+        tool_choice: { type: "tool", name: "computer" },
+        messages: [
+            {
+                role: "user",
+                content: [
+                    {
+                        type: "image",
+                        source: {
+                            type: "base64",
+                            media_type: "image/png",
+                            data: screenshotBase64,
+                        },
+                    },
+                    {
+                        type: "text",
+                        text: instruction,
+                    },
+                ],
+            },
+        ],
+    });
+    for (const block of response.content) {
+        if (block.type === "tool_use" && block.name === "computer") {
+            const input = block.input;
+            const coord = input.coordinate;
+            const action = input.action ?? "left_click";
+            logger.debug(`Coordinate resolver raw response: action=${action} coordinate=${JSON.stringify(coord)}`, { instruction, action, coordinate: coord, fullInput: input });
+            if (Array.isArray(coord) && coord.length >= 2) {
+                const rawX = coord[0];
+                const rawY = coord[1];
+                if (typeof rawX === "number" && typeof rawY === "number" && Number.isFinite(rawX) && Number.isFinite(rawY)) {
+                    // Unscale: Claude returned coords in image space → convert to actual display space
+                    const x = clamp(Math.round(rawX * scaleX), 0, displayWidth);
+                    const y = clamp(Math.round(rawY * scaleY), 0, displayHeight);
+                    logger.info(`Resolved coordinates: action=${action} raw=(${rawX},${rawY}) unscaled=(${x},${y}) scaleX=${scaleX.toFixed(3)} scaleY=${scaleY.toFixed(3)}`, { instruction, action, rawX, rawY, x, y, scaleX, scaleY });
+                    return { action, x, y };
+                }
+            }
+        }
+    }
+    logger.info(`Could not resolve coordinates: "${instruction}"`, { instruction });
+    return null;
+}
+//# sourceMappingURL=coordinate-resolver.js.map

package/dist/tools/coordinate-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinate-resolver.js","sourceRoot":"","sources":["../../src/tools/coordinate-resolver.ts"],"names":[],"mappings":"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"}

package/dist/tools/sms.d.ts

@@ -0,0 +1,16 @@
+/**
+ * SMS MCP Tool — polls recent SMS messages from the VisionClaw SMS service.
+ *
+ * Uses the agent's SMS API key (from config.json `smsApiKey`) to authenticate
+ * against the SMS service REST API at sms.visionclaw.dev.
+ */
+import { z } from "zod";
+export declare const smsTool: import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    since: z.ZodOptional<z.ZodString>;
+    direction: z.ZodOptional<z.ZodEnum<{
+        inbound: "inbound";
+        outbound: "outbound";
+    }>>;
+}>;
+//# sourceMappingURL=sms.d.ts.map

package/dist/tools/sms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sms.d.ts","sourceRoot":"","sources":["../../src/tools/sms.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,eAAO,MAAM,OAAO;;;;;;;EAoFnB,CAAC"}

package/dist/tools/sms.js

@@ -0,0 +1,78 @@
+/**
+ * SMS MCP Tool — polls recent SMS messages from the VisionClaw SMS service.
+ *
+ * Uses the agent's SMS API key (from config.json `smsApiKey`) to authenticate
+ * against the SMS service REST API at sms.visionclaw.dev.
+ */
+import { z } from "zod";
+import { tool } from "@anthropic-ai/claude-agent-sdk";
+import { getAgentState } from "../agent/state.js";
+const SMS_SERVICE_URL = "https://sms.visionclaw.dev";
+function ok(text) {
+    return { content: [{ type: "text", text }] };
+}
+function err(text) {
+    return { content: [{ type: "text", text }], isError: true };
+}
+export const smsTool = tool("sms", "Poll recent SMS messages from the VisionClaw SMS service. Uses the SMS API key from config to authenticate. Can retrieve inbound and outbound messages, filter by direction and time range.", {
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(200)
+        .optional()
+        .default(1)
+        .describe("Max number of messages to retrieve (default 1)"),
+    since: z
+        .string()
+        .optional()
+        .describe("Only return messages after this ISO 8601 timestamp, e.g. '2026-04-27T00:00:00Z'"),
+    direction: z
+        .enum(["inbound", "outbound"])
+        .optional()
+        .describe("Filter by message direction"),
+}, async (params) => {
+    const state = getAgentState();
+    const config = state.config;
+    const smsApiKey = config.smsApiKey;
+    if (!smsApiKey) {
+        return err("SMS API key not configured. Add 'smsApiKey' to your config.json (format: sms_xxx).");
+    }
+    try {
+        const url = new URL(`${SMS_SERVICE_URL}/api/messages`);
+        if (params.limit)
+            url.searchParams.set("limit", String(params.limit));
+        if (params.since)
+            url.searchParams.set("since", params.since);
+        if (params.direction)
+            url.searchParams.set("direction", params.direction);
+        const resp = await fetch(url.toString(), {
+            headers: {
+                Authorization: `Bearer ${smsApiKey}`,
+                "Content-Type": "application/json",
+            },
+        });
+        if (!resp.ok) {
+            const body = await resp.text();
+            return err(`SMS service returned ${resp.status}: ${body}`);
+        }
+        const data = (await resp.json());
+        if (data.messages.length === 0) {
+            return ok("No SMS messages found matching the criteria.");
+        }
+        const lines = data.messages.map((m) => {
+            const dir = m.direction === "inbound" ? "\u{1F4E5} IN" : "\u{1F4E4} OUT";
+            const time = new Date(m.created_at).toLocaleString();
+            const from = m.from_number;
+            const to = m.to_number;
+            const body = m.body ?? "(no body)";
+            return `[${dir}] ${time}\n  From: ${from} → To: ${to}\n  ${body}\n  Status: ${m.status}`;
+        });
+        return ok(`Found ${data.total} total messages (showing ${data.messages.length}):\n\n${lines.join("\n\n")}`);
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return err(`SMS tool error: ${msg}`);
+    }
+});
+//# sourceMappingURL=sms.js.map

package/dist/tools/sms.js.map

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

package/dist/tools/stock-data.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Unified stock data query MCP tool.
+ * Provides real-time quotes, historical data, financials, and search
+ * for A-shares, HK, and US stocks.
+ *
+ * Uses stock-sdk (Tencent/EastMoney data) for quotes, history, and search,
+ * and yahoo-finance2 for financials (fundamental data).
+ * No Python bridge required — pure TypeScript.
+ */
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+export type StockDataAction = "quote" | "history" | "financials" | "search";
+export interface StockDataArgs {
+    action?: StockDataAction;
+    symbols?: string;
+    symbol?: string;
+    market?: "A" | "HK" | "US" | "auto" | "all";
+    period?: "1d" | "5d" | "1mo" | "3mo" | "6mo" | "1y" | "2y" | "5y" | "max";
+    interval?: "daily" | "weekly" | "monthly";
+    start_date?: string;
+    end_date?: string;
+    report_type?: "summary" | "income" | "balance" | "cashflow";
+    keyword?: string;
+    limit?: number;
+}
+export declare function queryStockData(args: StockDataArgs): Promise<CallToolResult>;
+export declare const stockDataTool: import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{
+    action: z.ZodEnum<{
+        search: "search";
+        quote: "quote";
+        financials: "financials";
+        history: "history";
+    }>;
+    symbols: z.ZodOptional<z.ZodString>;
+    symbol: z.ZodOptional<z.ZodString>;
+    market: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        all: "all";
+        A: "A";
+        HK: "HK";
+        US: "US";
+    }>>>;
+    period: z.ZodOptional<z.ZodEnum<{
+        max: "max";
+        "1d": "1d";
+        "5d": "5d";
+        "1mo": "1mo";
+        "3mo": "3mo";
+        "6mo": "6mo";
+        "1y": "1y";
+        "2y": "2y";
+        "5y": "5y";
+    }>>;
+    interval: z.ZodOptional<z.ZodEnum<{
+        daily: "daily";
+        weekly: "weekly";
+        monthly: "monthly";
+    }>>;
+    start_date: z.ZodOptional<z.ZodString>;
+    end_date: z.ZodOptional<z.ZodString>;
+    report_type: z.ZodOptional<z.ZodEnum<{
+        summary: "summary";
+        income: "income";
+        balance: "balance";
+        cashflow: "cashflow";
+    }>>;
+    keyword: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}>;
+//# sourceMappingURL=stock-data.d.ts.map

package/dist/tools/stock-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stock-data.d.ts","sourceRoot":"","sources":["../../src/tools/stock-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AA6jBzE,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,CAAC;AAE5E,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,GAAG,KAAK,CAAC;IAC5C,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAC1E,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAmDjF;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+EzB,CAAC"}