visionclaw 0.1.0

package/dist/onboarding/index.js

@@ -0,0 +1,213 @@
+import prompts from "prompts";
+import { saveConfig, ensureConfigDir } from "../config/index.js";
+import { runGoogleOAuth } from "./google-auth.js";
+import { checkMacOSPermissions } from "./macos-permissions.js";
+import { installBuiltinSkills } from "../skills/install.js";
+export async function runOnboarding() {
+    ensureConfigDir();
+    console.log("=== VisionClaw Onboarding ===\n");
+    // --- macOS permission check (screen recording + accessibility) ---
+    const permissionsOk = await checkMacOSPermissions();
+    if (!permissionsOk) {
+        const continueResult = (await prompts({
+            type: "confirm",
+            name: "continueSetup",
+            message: "Continue setup without full permissions?",
+            initial: true,
+        }));
+        if (!continueResult.continueSetup) {
+            console.log("\nPlease grant the required permissions and run onboarding again.");
+            process.exit(0);
+        }
+    }
+    console.log("VisionClaw needs a dedicated Gmail account to serve as its identity.");
+    console.log("The agent will use this account for email and Google Calendar.\n");
+    // --- Required: Owner identity ---
+    const ownerNameResult = (await prompts({
+        type: "text",
+        name: "ownerName",
+        message: "Your name (the agent's owner):",
+        validate: (v) => v.trim().length > 0 ? true : "Name is required",
+    }));
+    const ownerName = ownerNameResult.ownerName;
+    if (!ownerName) {
+        throw new Error("Onboarding cancelled");
+    }
+    const ownerEmailResult = (await prompts({
+        type: "text",
+        name: "ownerEmail",
+        message: "Your personal email (so the agent can identify you):",
+    }));
+    const ownerEmail = ownerEmailResult.ownerEmail;
+    // --- Required: Anthropic API Key ---
+    const anthropicResult = (await prompts({
+        type: "password",
+        name: "anthropicApiKey",
+        message: "Anthropic API key:",
+        validate: (v) => v.trim().length > 0 ? true : "API key is required",
+    }));
+    const anthropicApiKey = anthropicResult.anthropicApiKey;
+    if (!anthropicApiKey) {
+        throw new Error("Onboarding cancelled");
+    }
+    // --- Required: Gmail address ---
+    const gmailResult = (await prompts({
+        type: "text",
+        name: "gmail",
+        message: "Gmail address for the agent (dedicated account):",
+        validate: (v) => v.includes("@gmail.com") ? true : "Must be a @gmail.com address",
+    }));
+    const gmail = gmailResult.gmail;
+    if (!gmail) {
+        throw new Error("Onboarding cancelled");
+    }
+    // --- Required: Agent name ---
+    const agentNameResult = (await prompts({
+        type: "text",
+        name: "agentName",
+        message: "Agent name:",
+        initial: "VisionClaw",
+    }));
+    const agentName = agentNameResult.agentName;
+    // --- Required: Google OAuth2 credentials ---
+    console.log("\n--- Google Cloud OAuth2 Credentials ---");
+    console.log("Create OAuth2 credentials at https://console.cloud.google.com/apis/credentials");
+    console.log('Set the application type to "Desktop app" and add http://127.0.0.1 as an authorized redirect URI if needed.\n');
+    const googleClientIdResult = (await prompts({
+        type: "text",
+        name: "googleClientId",
+        message: "Google OAuth2 Client ID:",
+        validate: (v) => v.trim().length > 0 ? true : "Client ID is required",
+    }));
+    const googleClientId = googleClientIdResult.googleClientId;
+    if (!googleClientId) {
+        throw new Error("Onboarding cancelled");
+    }
+    const googleClientSecretResult = (await prompts({
+        type: "password",
+        name: "googleClientSecret",
+        message: "Google OAuth2 Client Secret:",
+        validate: (v) => v.trim().length > 0 ? true : "Client Secret is required",
+    }));
+    const googleClientSecret = googleClientSecretResult.googleClientSecret;
+    if (!googleClientSecret) {
+        throw new Error("Onboarding cancelled");
+    }
+    // Run Google OAuth flow
+    console.log("\nStarting Google OAuth2 authorization...");
+    await runGoogleOAuth(googleClientId, googleClientSecret);
+    console.log("Google authorization successful!");
+    // --- Required: At least one command channel ---
+    console.log("\n--- Command Channels ---");
+    console.log("You need at least one channel to communicate with the agent.");
+    console.log(`Gmail (${gmail.trim()}) is always available as a channel.\n`);
+    const channelChoiceResult = (await prompts({
+        type: "multiselect",
+        name: "channels",
+        message: "Which channels do you want to enable?",
+        choices: [
+            { title: `Gmail (${gmail.trim()})`, value: "gmail", selected: true },
+            { title: "Telegram", value: "telegram" },
+            { title: "Discord", value: "discord" },
+        ],
+        min: 1,
+        hint: "- Space to toggle, Enter to confirm. At least one required.",
+    }));
+    const selectedChannels = channelChoiceResult.channels ?? ["gmail"];
+    if (selectedChannels.length === 0) {
+        throw new Error("At least one channel is required. Onboarding cancelled.");
+    }
+    // --- Telegram setup ---
+    let telegramBotToken;
+    let telegramChatIds = [];
+    if (selectedChannels.includes("telegram")) {
+        const telegramResult = (await prompts({
+            type: "text",
+            name: "botToken",
+            message: "Telegram Bot Token (from @BotFather):",
+            validate: (v) => v.trim().length > 0 ? true : "Bot token is required",
+        }));
+        telegramBotToken = telegramResult.botToken;
+        if (!telegramBotToken) {
+            throw new Error("Telegram bot token is required. Onboarding cancelled.");
+        }
+        console.log("\nTo find your Telegram Chat ID, message @userinfobot on Telegram -- it will reply with your ID.");
+        const chatIdResult = (await prompts({
+            type: "text",
+            name: "chatId",
+            message: "Your Telegram Chat ID (numeric, e.g. 5788338436):",
+            validate: (v) => /^\d+$/.test(v.trim()) ? true : "Must be a numeric Chat ID",
+        }));
+        if (chatIdResult.chatId) {
+            telegramChatIds = [Number(chatIdResult.chatId)];
+        }
+    }
+    // --- Discord setup ---
+    let discordBotToken;
+    let discordChannelIds = [];
+    if (selectedChannels.includes("discord")) {
+        console.log("\nCreate a bot at https://discord.com/developers/applications");
+        console.log("Enable MESSAGE CONTENT intent under Bot settings.\n");
+        const discordResult = (await prompts({
+            type: "text",
+            name: "botToken",
+            message: "Discord Bot Token:",
+            validate: (v) => v.trim().length > 0 ? true : "Bot token is required",
+        }));
+        discordBotToken = discordResult.botToken;
+        if (!discordBotToken) {
+            throw new Error("Discord bot token is required. Onboarding cancelled.");
+        }
+        const channelIdResult = (await prompts({
+            type: "text",
+            name: "channelId",
+            message: "Discord channel ID to listen on (right-click channel > Copy Channel ID, or leave blank for DMs only):",
+        }));
+        if (channelIdResult.channelId?.trim()) {
+            discordChannelIds = [channelIdResult.channelId.trim()];
+        }
+    }
+    // --- Optional: Phone number ---
+    const phoneNumberResult = (await prompts({
+        type: "text",
+        name: "phoneNumber",
+        message: "Phone number (optional, for reference):",
+    }));
+    const phoneNumber = phoneNumberResult.phoneNumber;
+    // --- Build and save config ---
+    const enabledList = selectedChannels.join(", ");
+    console.log(`\nEnabled channels: ${enabledList}`);
+    const config = {
+        agentName: agentName ?? "VisionClaw",
+        ownerName: ownerName.trim(),
+        ownerEmail: typeof ownerEmail === "string" ? ownerEmail.trim() || undefined : undefined,
+        gmail: gmail.trim(),
+        googleClientId: googleClientId.trim(),
+        googleClientSecret: googleClientSecret.trim(),
+        phoneNumber: typeof phoneNumber === "string" ? phoneNumber.trim() || undefined : undefined,
+        anthropicApiKey: anthropicApiKey.trim(),
+        channels: {
+            telegram: telegramBotToken
+                ? { enabled: true, botToken: telegramBotToken, allowedChatIds: telegramChatIds }
+                : { enabled: false, allowedChatIds: [] },
+            discord: discordBotToken
+                ? { enabled: true, botToken: discordBotToken, allowedChannelIds: discordChannelIds }
+                : { enabled: false, allowedChannelIds: [] },
+        },
+        // Advanced configuration (not prompted during onboarding)
+        // Defaults are applied by the schema, but include explicit values to keep
+        // the generated config file self-describing.
+        obs: {
+            enabled: true,
+            host: "127.0.0.1",
+            port: 3101,
+            bufferSize: 1000,
+        },
+        heartbeatIntervalMs: 5 * 60 * 1000,
+    };
+    saveConfig(config);
+    // Install built-in skills (e.g. transcribe-audio)
+    installBuiltinSkills();
+    console.log("Configuration saved successfully!");
+}
+//# sourceMappingURL=index.js.map

package/dist/onboarding/index.js.map

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

package/dist/onboarding/macos-permissions.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Check if Screen Recording permission is granted on macOS.
+ *
+ * We do this by attempting a silent screenshot. If it succeeds and
+ * produces a non-trivial file, we have permission. If the file is
+ * tiny or missing, the permission was denied.
+ */
+export declare function checkScreenRecordingPermission(): Promise<boolean>;
+/**
+ * Check if cliclick is installed (required for computer_use tools).
+ */
+export declare function checkCliclickInstalled(): Promise<boolean>;
+/**
+ * Check if ffmpeg is installed (required for screenshot compression and audio transcription).
+ */
+export declare function checkFfmpegInstalled(): Promise<boolean>;
+/**
+ * Check if Google Chrome or Chromium is installed (required for Playwright browser tools).
+ */
+export declare function checkChromeInstalled(): Promise<boolean>;
+/**
+ * Check if Accessibility permission is granted on macOS.
+ *
+ * Uses AppleScript to test if we can check accessibility status.
+ * Also tries the `tccutil` approach as a fallback.
+ */
+export declare function checkAccessibilityPermission(): Promise<boolean>;
+/**
+ * Print instructions for granting a macOS permission.
+ */
+export declare function printPermissionInstructions(permission: "screen-recording" | "accessibility"): void;
+/**
+ * Run all macOS permission checks and report results.
+ * Returns true if all required permissions are granted.
+ */
+export declare function checkMacOSPermissions(): Promise<boolean>;
+//# sourceMappingURL=macos-permissions.d.ts.map

package/dist/onboarding/macos-permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"macos-permissions.d.ts","sourceRoot":"","sources":["../../src/onboarding/macos-permissions.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,wBAAsB,8BAA8B,IAAI,OAAO,CAAC,OAAO,CAAC,CAmBvE;AAED;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,OAAO,CAAC,CAQ/D;AAED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC,CAiB7D;AAED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC,CAsB7D;AAED;;;;;GAKG;AACH,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,OAAO,CAAC,CAcrE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,kBAAkB,GAAG,eAAe,GAC/C,IAAI,CAYN;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,CA+E9D"}

package/dist/onboarding/macos-permissions.js

@@ -0,0 +1,207 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+const execAsync = promisify(exec);
+/**
+ * Check if Screen Recording permission is granted on macOS.
+ *
+ * We do this by attempting a silent screenshot. If it succeeds and
+ * produces a non-trivial file, we have permission. If the file is
+ * tiny or missing, the permission was denied.
+ */
+export async function checkScreenRecordingPermission() {
+    if (process.platform !== "darwin")
+        return true;
+    try {
+        const tmpFile = `/tmp/visionclaw-permission-check-${Date.now()}.png`;
+        await execAsync(`screencapture -x -C "${tmpFile}"`);
+        // Check if the file exists and has meaningful content
+        const { stdout } = await execAsync(`stat -f%z "${tmpFile}" 2>/dev/null || echo 0`);
+        const size = parseInt(stdout.trim(), 10);
+        // Clean up
+        await execAsync(`rm -f "${tmpFile}"`).catch(() => { });
+        // A real screenshot is at least a few KB; a blank/denied one is tiny or zero
+        return size > 1000;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if cliclick is installed (required for computer_use tools).
+ */
+export async function checkCliclickInstalled() {
+    if (process.platform !== "darwin")
+        return true;
+    try {
+        const { stdout } = await execAsync("which cliclick 2>/dev/null");
+        return stdout.trim().length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if ffmpeg is installed (required for screenshot compression and audio transcription).
+ */
+export async function checkFfmpegInstalled() {
+    try {
+        const { stdout } = await execAsync("which ffmpeg 2>/dev/null");
+        if (stdout.trim().length > 0)
+            return true;
+    }
+    catch { /* fall through */ }
+    const candidates = [
+        "/opt/homebrew/bin/ffmpeg",
+        "/usr/local/bin/ffmpeg",
+        "/usr/bin/ffmpeg",
+    ];
+    for (const c of candidates) {
+        try {
+            await execAsync(`test -x "${c}"`);
+            return true;
+        }
+        catch { /* try next */ }
+    }
+    return false;
+}
+/**
+ * Check if Google Chrome or Chromium is installed (required for Playwright browser tools).
+ */
+export async function checkChromeInstalled() {
+    // Check common macOS app locations
+    const appPaths = [
+        "/Applications/Google Chrome.app",
+        "/Applications/Chromium.app",
+        `${process.env.HOME}/Applications/Google Chrome.app`,
+        `${process.env.HOME}/Applications/Chromium.app`,
+    ];
+    for (const p of appPaths) {
+        try {
+            await execAsync(`test -d "${p}"`);
+            return true;
+        }
+        catch { /* try next */ }
+    }
+    // Check PATH-based executables
+    try {
+        const { stdout } = await execAsync("which google-chrome chromium chromium-browser 2>/dev/null | head -1");
+        if (stdout.trim().length > 0)
+            return true;
+    }
+    catch { /* fall through */ }
+    return false;
+}
+/**
+ * Check if Accessibility permission is granted on macOS.
+ *
+ * Uses AppleScript to test if we can check accessibility status.
+ * Also tries the `tccutil` approach as a fallback.
+ */
+export async function checkAccessibilityPermission() {
+    if (process.platform !== "darwin")
+        return true;
+    try {
+        // Use the system's accessibility check via osascript
+        const { stdout } = await execAsync(`osascript -e 'tell application "System Events" to return name of first process'`);
+        // If this returns a process name, we have accessibility access
+        return stdout.trim().length > 0;
+    }
+    catch {
+        // "System Events got an error: osascript is not allowed assistive access"
+        return false;
+    }
+}
+/**
+ * Print instructions for granting a macOS permission.
+ */
+export function printPermissionInstructions(permission) {
+    if (permission === "screen-recording") {
+        console.log("\n  To grant Screen Recording permission:");
+        console.log("  1. Open System Settings > Privacy & Security > Screen Recording");
+        console.log("  2. Click '+' and add your terminal app (Terminal, iTerm2, etc.)");
+        console.log("  3. Restart your terminal after granting permission");
+    }
+    else {
+        console.log("\n  To grant Accessibility permission:");
+        console.log("  1. Open System Settings > Privacy & Security > Accessibility");
+        console.log("  2. Click '+' and add your terminal app (Terminal, iTerm2, etc.)");
+        console.log("  3. Restart your terminal after granting permission");
+    }
+}
+/**
+ * Run all macOS permission checks and report results.
+ * Returns true if all required permissions are granted.
+ */
+export async function checkMacOSPermissions() {
+    if (process.platform !== "darwin") {
+        return true;
+    }
+    console.log("--- macOS Permissions Check ---\n");
+    let allGranted = true;
+    // Screen Recording
+    process.stdout.write("  Screen Recording: ");
+    const screenOk = await checkScreenRecordingPermission();
+    if (screenOk) {
+        console.log("Granted");
+    }
+    else {
+        console.log("NOT GRANTED");
+        printPermissionInstructions("screen-recording");
+        allGranted = false;
+    }
+    // Accessibility
+    process.stdout.write("  Accessibility:    ");
+    const accessOk = await checkAccessibilityPermission();
+    if (accessOk) {
+        console.log("Granted");
+    }
+    else {
+        console.log("NOT GRANTED");
+        printPermissionInstructions("accessibility");
+        allGranted = false;
+    }
+    // cliclick (for computer_use tools)
+    process.stdout.write("  cliclick:        ");
+    const cliclickOk = await checkCliclickInstalled();
+    if (cliclickOk) {
+        console.log("Installed");
+    }
+    else {
+        console.log("NOT INSTALLED");
+        console.log("\n  To install cliclick: brew install cliclick");
+        allGranted = false;
+    }
+    // ffmpeg (for screenshot compression and audio transcription)
+    process.stdout.write("  ffmpeg:          ");
+    const ffmpegOk = await checkFfmpegInstalled();
+    if (ffmpegOk) {
+        console.log("Installed");
+    }
+    else {
+        console.log("NOT INSTALLED");
+        console.log("\n  To install ffmpeg: brew install ffmpeg");
+        allGranted = false;
+    }
+    // Chrome / Chromium (for Playwright browser tools)
+    process.stdout.write("  Chrome:          ");
+    const chromeOk = await checkChromeInstalled();
+    if (chromeOk) {
+        console.log("Found");
+    }
+    else {
+        console.log("NOT FOUND");
+        console.log("\n  Install Google Chrome from https://www.google.com/chrome/");
+        allGranted = false;
+    }
+    console.log("");
+    if (!allGranted) {
+        console.log("  Some permissions are missing. VisionClaw needs these to control the desktop.");
+        console.log("  You can continue setup now and grant them later, but the agent will");
+        console.log("  not be fully functional until all permissions are granted.\n");
+    }
+    else {
+        console.log("  All permissions granted!\n");
+    }
+    return allGranted;
+}
+//# sourceMappingURL=macos-permissions.js.map

package/dist/onboarding/macos-permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"macos-permissions.js","sourceRoot":"","sources":["../../src/onboarding/macos-permissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B;IAClD,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE/C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,oCAAoC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC;QACrE,MAAM,SAAS,CAAC,wBAAwB,OAAO,GAAG,CAAC,CAAC;QAEpD,sDAAsD;QACtD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,cAAc,OAAO,yBAAyB,CAAC,CAAC;QACnF,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAEzC,WAAW;QACX,MAAM,SAAS,CAAC,UAAU,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAc,CAAC,CAAC,CAAC;QAElE,6EAA6E;QAC7E,OAAO,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB;IAC1C,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,4BAA4B,CAAC,CAAC;QACjE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,0BAA0B,CAAC,CAAC;QAC/D,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAC9B,MAAM,UAAU,GAAG;QACjB,0BAA0B;QAC1B,uBAAuB;QACvB,iBAAiB;KAClB,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,mCAAmC;IACnC,MAAM,QAAQ,GAAG;QACf,iCAAiC;QACjC,4BAA4B;QAC5B,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,iCAAiC;QACpD,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,4BAA4B;KAChD,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC;IAC5B,CAAC;IACD,+BAA+B;IAC/B,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAChC,qEAAqE,CACtE,CAAC;QACF,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B;IAChD,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE/C,IAAI,CAAC;QACH,qDAAqD;QACrD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAChC,iFAAiF,CAClF,CAAC;QACF,+DAA+D;QAC/D,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,0EAA0E;QAC1E,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,UAAgD;IAEhD,IAAI,UAAU,KAAK,kBAAkB,EAAE,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC;QACjF,OAAO,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC;QACjF,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;IACtE,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAAC;QAC9E,OAAO,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC;QACjF,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;IAEjD,IAAI,UAAU,GAAG,IAAI,CAAC;IAEtB,mBAAmB;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,MAAM,8BAA8B,EAAE,CAAC;IACxD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACzB,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,2BAA2B,CAAC,kBAAkB,CAAC,CAAC;QAChD,UAAU,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,MAAM,4BAA4B,EAAE,CAAC;IACtD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACzB,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,2BAA2B,CAAC,eAAe,CAAC,CAAC;QAC7C,UAAU,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,oCAAoC;IACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,MAAM,sBAAsB,EAAE,CAAC;IAClD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC3B,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;QAC9D,UAAU,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,8DAA8D;IAC9D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,MAAM,oBAAoB,EAAE,CAAC;IAC9C,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC3B,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;QAC1D,UAAU,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,mDAAmD;IACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,MAAM,oBAAoB,EAAE,CAAC;IAC9C,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC;QAC7E,UAAU,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CACT,gFAAgF,CACjF,CAAC;QACF,OAAO,CAAC,GAAG,CACT,uEAAuE,CACxE,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAAC;IAChF,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/skills/install.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Install built-in skills to the active profile's skills directory.
+ * Copies from src/skills/ to {profileDir}/.claude/skills/.
+ * Only copies skills that don't already exist (won't overwrite user edits).
+ */
+export declare function installBuiltinSkills(): void;
+//# sourceMappingURL=install.d.ts.map

package/dist/skills/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/skills/install.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CA8D3C"}

package/dist/skills/install.js

@@ -0,0 +1,63 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { getSkillsDir } from "../config/index.js";
+import { logger } from "../logger.js";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+/**
+ * Install built-in skills to the active profile's skills directory.
+ * Copies from src/skills/ to {profileDir}/.claude/skills/.
+ * Only copies skills that don't already exist (won't overwrite user edits).
+ */
+export function installBuiltinSkills() {
+    const builtinDir = path.join(__dirname, "..", "skills");
+    const targetDir = getSkillsDir();
+    // In dev mode (tsx), __dirname points to src/skills.
+    // In built mode, it points to dist/skills.
+    // The skill files are in src/skills/ which may not exist in dist.
+    // Try both locations.
+    const sourceDirs = [
+        builtinDir,
+        path.join(__dirname, "..", "..", "src", "skills"),
+    ];
+    let sourceDir = null;
+    for (const dir of sourceDirs) {
+        if (fs.existsSync(dir)) {
+            sourceDir = dir;
+            break;
+        }
+    }
+    if (!sourceDir) {
+        logger.debug("No built-in skills directory found");
+        return;
+    }
+    if (!fs.existsSync(targetDir)) {
+        fs.mkdirSync(targetDir, { recursive: true });
+    }
+    const entries = fs.readdirSync(sourceDir, { withFileTypes: true });
+    for (const entry of entries) {
+        // Skip non-directories and the install.ts file itself
+        if (!entry.isDirectory())
+            continue;
+        const skillSource = path.join(sourceDir, entry.name);
+        const skillTarget = path.join(targetDir, entry.name);
+        const skillFile = path.join(skillSource, "SKILL.md");
+        // Only copy if source has SKILL.md and target doesn't exist yet
+        if (!fs.existsSync(skillFile))
+            continue;
+        if (fs.existsSync(path.join(skillTarget, "SKILL.md"))) {
+            logger.debug(`Skill "${entry.name}" already installed, skipping`);
+            continue;
+        }
+        // Copy the skill directory
+        if (!fs.existsSync(skillTarget)) {
+            fs.mkdirSync(skillTarget, { recursive: true });
+        }
+        const files = fs.readdirSync(skillSource);
+        for (const file of files) {
+            fs.copyFileSync(path.join(skillSource, file), path.join(skillTarget, file));
+        }
+        logger.system(`Installed built-in skill: ${entry.name}`);
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/skills/install.js.map

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

package/dist/tools/browser.d.ts

@@ -0,0 +1,7 @@
+import { z } from "zod";
+export declare const browserTool: import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition<{
+    action: z.ZodEnum<["navigate", "screenshot", "get_text", "get_page_elements", "back", "forward", "new_tab", "close", "close_browser"]>;
+    url: z.ZodOptional<z.ZodString>;
+    selector: z.ZodOptional<z.ZodString>;
+}>;
+//# sourceMappingURL=browser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/tools/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2BxB,eAAO,MAAM,WAAW;;;;EAmMvB,CAAC"}