visionclaw 0.1.32 → 0.1.34

package/dist/onboarding/onboarding-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-session.d.ts","sourceRoot":"","sources":["../../src/onboarding/onboarding-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,gCAAgC,CAAC;AAUxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAwD3D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,WAAW,CAA6B;gBAG9C,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC;IAQ7C;;;;OAIG;IACG,eAAe,CACnB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAC/D,OAAO,CAAC,eAAe,CAAC;YAoCb,YAAY;IA+E1B,OAAO,CAAC,cAAc;IAoCtB,OAAO,CAAC,gBAAgB;IAQxB,YAAY,IAAI,MAAM,GAAG,IAAI;IAI7B,sBAAsB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;CAG7C"}

package/dist/onboarding/onboarding-session.js

@@ -0,0 +1,207 @@
+import { query, } from "@anthropic-ai/claude-agent-sdk";
+import { createRequire } from "module";
+import path from "path";
+import { loadOnboardingSessionId, saveOnboardingSessionId, getConfigDir, } from "../config/index.js";
+import { CLAUDE_MODEL } from "../agent/session.js";
+import { logger } from "../logger.js";
+import { AVATAR_OPTIONS } from "./onboarding-tools.js";
+const ONBOARDING_MODEL = CLAUDE_MODEL;
+const ONBOARDING_QUERY_TIMEOUT_MS = 2 * 60 * 1000;
+const MAX_QUERY_RETRIES = 2;
+const RETRY_BASE_DELAY_MS = 3_000;
+function buildOnboardingSystemPrompt(ownerEmail) {
+    const avatarList = AVATAR_OPTIONS.map((opt, i) => `  ${i + 1}. ${opt.label}`).join("\n");
+    return `# Identity
+
+You are a setup assistant for a personal desktop agent. You are helping a new owner complete the initial configuration via Telegram.
+
+## Your Goal
+
+Collect the following information through natural conversation:
+
+1. **Owner's name** — Ask what they'd like to be called. Make sure it's a real name (not gibberish, not a question, not a greeting). If the response doesn't look like a name, politely ask again.
+2. **Agent name** — What they want to name their assistant. Default is "VisionClaw" if they don't have a preference. This should be a proper name, not a sentence.
+3. **Wakeup interval** — How often the agent should check in (in minutes). Default is 3 minutes. Range: 1 to 1440. If the user doesn't care, use the default.
+4. **Profile photo** — The user can choose a profile photo for the bot. Call \`send_avatar_options\` to show them the available options. They can pick a number or upload their own photo. This step is optional — the user can skip it.
+
+## Available Avatar Options
+
+${avatarList}
+
+## Owner Information Already Known
+
+- **Email**: ${ownerEmail}
+
+## Behavior
+
+- Be friendly, warm, and concise. Keep messages short (1-4 sentences).
+- Handle off-topic messages gracefully — acknowledge them briefly and steer back to onboarding.
+- If a user response is ambiguous (e.g. you asked for their name and they said "How are you?"), don't accept it as the answer. Clarify politely.
+- Before calling \`complete_onboarding\`, briefly summarize what you've collected and ask the user to confirm.
+- After calling \`complete_onboarding\`, send a brief welcome message. Do NOT call any more tools after that.
+
+## Tool Usage
+
+- Call \`send_avatar_options\` to send the bundled avatar images to the user.
+- Call \`set_bot_profile_photo\` with an option number (1-6) or a Telegram file URL when the user makes their choice.
+- Call \`complete_onboarding\` when all information is confirmed.
+
+## Conversation Flow
+
+Start by greeting the user and asking for their name. Then proceed through agent name, wakeup interval, and profile photo in a natural conversational order. You don't have to follow a rigid sequence — adapt to the user's responses.
+
+You should politely reject any request that is not related to the onboarding process.
+`;
+}
+/**
+ * Lightweight Agent SDK session for onboarding.
+ *
+ * Each call to `sendAndGetReply` creates a one-shot `query()` call
+ * (resumed from the saved session ID if available) and streams the
+ * response to collect text and detect tool calls.
+ */
+export class OnboardingSession {
+    config;
+    ownerEmail;
+    sessionId;
+    mcpServers;
+    onCompleted = null;
+    constructor(config, ownerEmail, mcpServers) {
+        this.config = config;
+        this.ownerEmail = ownerEmail;
+        this.mcpServers = mcpServers;
+        this.sessionId = loadOnboardingSessionId();
+    }
+    /**
+     * Send a user message and collect the agent's text reply.
+     * Retries on timeout or transient errors when no text was collected.
+     * The optional `onRetry` callback is invoked before each retry attempt.
+     */
+    async sendAndGetReply(userMessage, onRetry) {
+        let lastError;
+        for (let attempt = 0; attempt <= MAX_QUERY_RETRIES; attempt++) {
+            if (attempt > 0) {
+                const delay = RETRY_BASE_DELAY_MS * attempt;
+                logger.debug(`Onboarding query: retry ${attempt}/${MAX_QUERY_RETRIES} after ${delay}ms`);
+                if (onRetry) {
+                    await onRetry(attempt, MAX_QUERY_RETRIES);
+                }
+                await new Promise((r) => setTimeout(r, delay));
+            }
+            const result = await this.executeQuery(userMessage);
+            if (result.text || result.completed) {
+                return result;
+            }
+            if (result.error) {
+                lastError = result.error;
+                logger.warn(`Onboarding query attempt ${attempt + 1} failed: ${result.error}`);
+                continue;
+            }
+            return { text: result.text, completed: result.completed };
+        }
+        logger.warn(`Onboarding query failed after ${MAX_QUERY_RETRIES + 1} attempts: ${lastError ?? "unknown"}`);
+        return { text: "", completed: false };
+    }
+    async executeQuery(userMessage) {
+        const _require = createRequire(import.meta.url);
+        const sdkCliPath = path.resolve(path.dirname(_require.resolve("@anthropic-ai/claude-agent-sdk")), "cli.js");
+        const savedSessionId = this.sessionId;
+        const abortController = new AbortController();
+        const timeout = setTimeout(() => abortController.abort(), ONBOARDING_QUERY_TIMEOUT_MS);
+        const options = {
+            model: ONBOARDING_MODEL,
+            pathToClaudeCodeExecutable: sdkCliPath,
+            systemPrompt: buildOnboardingSystemPrompt(this.ownerEmail),
+            permissionMode: "bypassPermissions",
+            allowDangerouslySkipPermissions: true,
+            cwd: getConfigDir(),
+            settingSources: ["project"],
+            mcpServers: this.mcpServers,
+            abortController,
+            env: {
+                ...process.env,
+                ANTHROPIC_API_KEY: this.config.anthropicApiKey,
+            },
+            ...(savedSessionId ? { resume: savedSessionId } : {}),
+        };
+        if (savedSessionId) {
+            logger.debug(`Onboarding session: resuming ${savedSessionId}`);
+        }
+        else {
+            logger.debug("Onboarding session: creating new session");
+        }
+        const textParts = [];
+        const state = { completed: false };
+        try {
+            for await (const msg of query({ prompt: userMessage, options })) {
+                if ("session_id" in msg && msg.session_id) {
+                    this.captureSessionId(msg.session_id);
+                }
+                this.processMessage(msg, textParts, (isComplete) => {
+                    if (isComplete)
+                        state.completed = true;
+                });
+            }
+        }
+        catch (err) {
+            const text = textParts.join("").trim();
+            if (text || state.completed) {
+                logger.debug("Onboarding query errored but collected partial response");
+                return { text, completed: state.completed };
+            }
+            if (abortController.signal.aborted) {
+                logger.warn("Onboarding query timed out");
+            }
+            return { text: "", completed: false, error: err instanceof Error ? err.message : String(err) };
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+        const text = textParts.join("").trim();
+        if (state.completed && this.onCompleted) {
+            this.onCompleted();
+        }
+        return { text, completed: state.completed };
+    }
+    processMessage(msg, textParts, onCompleteTool) {
+        switch (msg.type) {
+            case "assistant": {
+                for (const block of msg.message.content) {
+                    if (block.type === "text" && block.text) {
+                        textParts.push(block.text);
+                    }
+                    if (block.type === "tool_use" && block.name === "complete_onboarding") {
+                        onCompleteTool(true);
+                    }
+                    if (block.type === "tool_use" &&
+                        block.name === "mcp__onboarding__complete_onboarding") {
+                        onCompleteTool(true);
+                    }
+                }
+                break;
+            }
+            case "result": {
+                const cost = msg.total_cost_usd.toFixed(4);
+                logger.debug(`Onboarding query: turns=${msg.num_turns} cost=$${cost} ` +
+                    `in=${msg.usage.input_tokens} out=${msg.usage.output_tokens}`);
+                break;
+            }
+            default:
+                break;
+        }
+    }
+    captureSessionId(id) {
+        if (id && id !== this.sessionId) {
+            this.sessionId = id;
+            saveOnboardingSessionId(id);
+            logger.debug(`Onboarding session ID saved: ${id}`);
+        }
+    }
+    getSessionId() {
+        return this.sessionId;
+    }
+    setOnCompletedCallback(cb) {
+        this.onCompleted = cb;
+    }
+}
+//# sourceMappingURL=onboarding-session.js.map

package/dist/onboarding/onboarding-session.js.map

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

package/dist/onboarding/onboarding-tools.d.ts

@@ -0,0 +1,43 @@
+export declare const AVATAR_OPTIONS: readonly [{
+    readonly name: "visionclaw";
+    readonly label: "VisionClaw";
+    readonly file: "visionclaw.jpg";
+}, {
+    readonly name: "robot";
+    readonly label: "Friendly Robot";
+    readonly file: "robot.jpg";
+}, {
+    readonly name: "owl";
+    readonly label: "Wise Owl";
+    readonly file: "owl.jpg";
+}, {
+    readonly name: "orb";
+    readonly label: "Crystal Orb";
+    readonly file: "orb.jpg";
+}, {
+    readonly name: "fox";
+    readonly label: "Clever Fox";
+    readonly file: "fox.jpg";
+}, {
+    readonly name: "cat";
+    readonly label: "Curious Cat";
+    readonly file: "cat.jpg";
+}, {
+    readonly name: "abstract";
+    readonly label: "Abstract Geometry";
+    readonly file: "abstract.jpg";
+}];
+export interface OnboardingResult {
+    ownerName: string;
+    agentName: string;
+    wakeupIntervalMinutes: number;
+}
+interface OnboardingToolDeps {
+    botToken: string;
+    chatId: number;
+    sendPhoto: (chatId: number, photoPath: string, caption: string) => Promise<void>;
+    onComplete: (result: OnboardingResult) => void;
+}
+export declare function createOnboardingToolServer(deps: OnboardingToolDeps): import("@anthropic-ai/claude-agent-sdk").McpSdkServerConfigWithInstance;
+export {};
+//# sourceMappingURL=onboarding-tools.d.ts.map

package/dist/onboarding/onboarding-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-tools.d.ts","sourceRoot":"","sources":["../../src/onboarding/onboarding-tools.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQjB,CAAC;AAEX,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF,UAAU,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;CAChD;AAmLD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,kBAAkB,2EAUlE"}

package/dist/onboarding/onboarding-tools.js

@@ -0,0 +1,178 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { z } from "zod";
+import { tool, createSdkMcpServer } from "@anthropic-ai/claude-agent-sdk";
+import { DEFAULT_HEARTBEAT_INTERVAL_MS } from "../config/types.js";
+import { logger } from "../logger.js";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const AVATARS_DIR = path.resolve(__dirname, "../../assets/avatars");
+export const AVATAR_OPTIONS = [
+    { name: "visionclaw", label: "VisionClaw", file: "visionclaw.jpg" },
+    { name: "robot", label: "Friendly Robot", file: "robot.jpg" },
+    { name: "owl", label: "Wise Owl", file: "owl.jpg" },
+    { name: "orb", label: "Crystal Orb", file: "orb.jpg" },
+    { name: "fox", label: "Clever Fox", file: "fox.jpg" },
+    { name: "cat", label: "Curious Cat", file: "cat.jpg" },
+    { name: "abstract", label: "Abstract Geometry", file: "abstract.jpg" },
+];
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
+function createSendAvatarOptionsTool(deps) {
+    return tool("send_avatar_options", "Send the available avatar/profile photo options to the user as Telegram photos. " +
+        "Call this when it's time for the user to choose a profile picture for the bot.", {}, async () => {
+        const results = [];
+        for (let i = 0; i < AVATAR_OPTIONS.length; i++) {
+            const opt = AVATAR_OPTIONS[i];
+            const filePath = path.join(AVATARS_DIR, opt.file);
+            if (!fs.existsSync(filePath)) {
+                results.push(`Option ${i + 1} (${opt.label}): file not found`);
+                continue;
+            }
+            try {
+                await deps.sendPhoto(deps.chatId, filePath, `Option ${i + 1}: ${opt.label}`);
+                results.push(`Option ${i + 1}: ${opt.label} ✓`);
+            }
+            catch (err) {
+                results.push(`Option ${i + 1} (${opt.label}): failed to send - ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: `Sent ${AVATAR_OPTIONS.length} avatar options to the user:\n${results.join("\n")}\n\n` +
+                        "The user can reply with an option number (1-7) or send their own photo. " +
+                        "They can also skip by saying they don't want to set a profile photo.",
+                }],
+        };
+    });
+}
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
+function createSetBotProfilePhotoTool(deps) {
+    return tool("set_bot_profile_photo", "Set the Telegram bot's profile photo. Use an option number (1-7) for a bundled avatar, " +
+        "or provide a Telegram file URL from a user-uploaded image.", {
+        source: z
+            .string()
+            .describe("Either an option number ('1' through '7') for a bundled avatar, " +
+            "or a Telegram file URL (https://api.telegram.org/file/...) from a user-uploaded image."),
+    }, async (args) => {
+        const { source } = args;
+        let photoPath;
+        let tempFile;
+        try {
+            const optionNum = parseInt(source, 10);
+            if (!isNaN(optionNum) && optionNum >= 1 && optionNum <= AVATAR_OPTIONS.length) {
+                const opt = AVATAR_OPTIONS[optionNum - 1];
+                photoPath = path.join(AVATARS_DIR, opt.file);
+                if (!fs.existsSync(photoPath)) {
+                    return {
+                        content: [{ type: "text", text: `Avatar file not found: ${opt.file}` }],
+                        isError: true,
+                    };
+                }
+            }
+            else if (source.startsWith("https://")) {
+                const res = await fetch(source);
+                if (!res.ok) {
+                    return {
+                        content: [{ type: "text", text: `Failed to download image: HTTP ${res.status}` }],
+                        isError: true,
+                    };
+                }
+                const buffer = Buffer.from(await res.arrayBuffer());
+                tempFile = path.join(AVATARS_DIR, `_temp_upload_${Date.now()}.jpg`);
+                fs.writeFileSync(tempFile, buffer);
+                photoPath = tempFile;
+            }
+            else {
+                return {
+                    content: [{
+                            type: "text",
+                            text: "Invalid source. Provide an option number (1-7) or a Telegram file URL.",
+                        }],
+                    isError: true,
+                };
+            }
+            const fileBuffer = fs.readFileSync(photoPath);
+            const file = new File([fileBuffer], "photo.jpg", { type: "image/jpeg" });
+            const form = new FormData();
+            form.append("photo", JSON.stringify({ type: "static", photo: "attach://photo_file" }));
+            form.append("photo_file", file);
+            const apiRes = await fetch(`https://api.telegram.org/bot${deps.botToken}/setMyProfilePhoto`, { method: "POST", body: form, signal: AbortSignal.timeout(30_000) });
+            const data = (await apiRes.json());
+            if (data.ok) {
+                logger.system("Telegram bot profile photo updated");
+                return {
+                    content: [{ type: "text", text: "Bot profile photo updated successfully!" }],
+                };
+            }
+            else {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Failed to set profile photo: ${data.description ?? "unknown error"}`,
+                        }],
+                    isError: true,
+                };
+            }
+        }
+        catch (err) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `Error setting profile photo: ${err instanceof Error ? err.message : String(err)}`,
+                    }],
+                isError: true,
+            };
+        }
+        finally {
+            if (tempFile && fs.existsSync(tempFile)) {
+                fs.unlinkSync(tempFile);
+            }
+        }
+    });
+}
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
+function createCompleteOnboardingTool(deps) {
+    return tool("complete_onboarding", "Finalize onboarding with the collected information. Call this ONLY after you have " +
+        "gathered all required info (owner name, agent name, wakeup interval) and the user " +
+        "has confirmed. After calling this tool, send a brief goodbye/welcome message and stop.", {
+        ownerName: z.string().min(1).describe("The owner's name"),
+        agentName: z
+            .string()
+            .default("VisionClaw")
+            .describe('The name the user chose for the agent (default: "VisionClaw")'),
+        wakeupIntervalMinutes: z
+            .number()
+            .min(1)
+            .max(1440)
+            .default(DEFAULT_HEARTBEAT_INTERVAL_MS / 60_000)
+            .describe("How often the agent wakes up, in minutes (1-1440, default: 3)"),
+    }, (args) => {
+        deps.onComplete({
+            ownerName: args.ownerName,
+            agentName: args.agentName,
+            wakeupIntervalMinutes: args.wakeupIntervalMinutes,
+        });
+        return Promise.resolve({
+            content: [{
+                    type: "text",
+                    text: `Onboarding finalized! Owner: ${args.ownerName}, Agent: ${args.agentName}, ` +
+                        `Wakeup: every ${args.wakeupIntervalMinutes} min. ` +
+                        "Send a brief welcome message to the user and then stop.",
+                }],
+        });
+    });
+}
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
+export function createOnboardingToolServer(deps) {
+    return createSdkMcpServer({
+        name: "onboarding",
+        version: "0.1.0",
+        tools: [
+            createSendAvatarOptionsTool(deps),
+            createSetBotProfilePhotoTool(deps),
+            createCompleteOnboardingTool(deps),
+        ],
+    });
+}
+//# sourceMappingURL=onboarding-tools.js.map

package/dist/onboarding/onboarding-tools.js.map

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

package/dist/onboarding/send-invite.d.ts

@@ -0,0 +1,7 @@
+import type { VisionClawConfig, OwnerConfig } from "../config/types.js";
+/**
+ * Send the onboarding invitation email to the owner.
+ * Includes a verification code and a direct link to the Telegram bot.
+ */
+export declare function sendOnboardingEmail(config: VisionClawConfig, ownerConfig: OwnerConfig): Promise<void>;
+//# sourceMappingURL=send-invite.d.ts.map

package/dist/onboarding/send-invite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-invite.d.ts","sourceRoot":"","sources":["../../src/onboarding/send-invite.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAqBxE;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,gBAAgB,EACxB,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,IAAI,CAAC,CAmDf"}

package/dist/onboarding/send-invite.js

@@ -0,0 +1,61 @@
+import { GmailEmailClient } from "../email/gmail-email.js";
+import { logger } from "../logger.js";
+/**
+ * Resolve the Telegram bot's username from its token using the Bot API.
+ */
+async function resolveBotUsername(botToken) {
+    try {
+        const res = await fetch(`https://api.telegram.org/bot${botToken}/getMe`);
+        const data = (await res.json());
+        return data.ok ? (data.result?.username ?? null) : null;
+    }
+    catch (err) {
+        logger.warn(`Failed to resolve Telegram bot username: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+}
+/**
+ * Send the onboarding invitation email to the owner.
+ * Includes a verification code and a direct link to the Telegram bot.
+ */
+export async function sendOnboardingEmail(config, ownerConfig) {
+    const botToken = config.channels.telegram?.botToken;
+    if (!botToken) {
+        throw new Error("Telegram is not configured. Cannot send onboarding email without a Telegram bot.");
+    }
+    const botUsername = await resolveBotUsername(botToken);
+    if (!botUsername) {
+        throw new Error("Could not resolve Telegram bot username. Check the bot token in config.json.");
+    }
+    const code = ownerConfig.onboardingCode;
+    if (!code) {
+        throw new Error("No onboarding code found in owner.json.");
+    }
+    const telegramLink = `https://t.me/${botUsername}`;
+    const emailBody = `Hi there!
+
+I'm your new personal desktop assistant, and I'm ready to get started.
+
+To complete setup, please open Telegram and message me. Here's how:
+
+1. Click this link to open our chat: ${telegramLink}
+2. Send me the following message:
+
+   /start ${code}
+
+3. I'll walk you through the rest — just a couple of quick questions!
+
+Your verification code: ${code}
+
+If you don't have Telegram installed, you can get it at https://telegram.org
+
+Looking forward to working with you!`;
+    const emailClient = new GmailEmailClient(config);
+    await emailClient.sendEmail({
+        to: ownerConfig.ownerEmail,
+        subject: "Your Personal Assistant Is Ready - Let's Get Started!",
+        body: emailBody,
+    });
+    logger.system(`Onboarding email sent to ${ownerConfig.ownerEmail} (bot: @${botUsername})`);
+}
+//# sourceMappingURL=send-invite.js.map

package/dist/onboarding/send-invite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-invite.js","sourceRoot":"","sources":["../../src/onboarding/send-invite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAGtC;;GAEG;AACH,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IAChD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,+BAA+B,QAAQ,QAAQ,CAAC,CAAC;QACzE,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAG7B,CAAC;QACF,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CACT,4CAA4C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC/F,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAwB,EACxB,WAAwB;IAExB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,kFAAkF,CACnF,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACvD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,cAAc,CAAC;IACxC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,YAAY,GAAG,gBAAgB,WAAW,EAAE,CAAC;IAEnD,MAAM,SAAS,GAAG;;;;;;uCAMmB,YAAY;;;YAGvC,IAAI;;;;0BAIU,IAAI;;;;qCAIO,CAAC;IAEpC,MAAM,WAAW,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,WAAW,CAAC,SAAS,CAAC;QAC1B,EAAE,EAAE,WAAW,CAAC,UAAU;QAC1B,OAAO,EAAE,uDAAuD;QAChE,IAAI,EAAE,SAAS;KAChB,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CACX,4BAA4B,WAAW,CAAC,UAAU,WAAW,WAAW,GAAG,CAC5E,CAAC;AACJ,CAAC"}

package/dist/onboarding/set-owner.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CLI command: visionclaw set-owner --email <owner-email>
+ *
+ * Writes a partial owner.json with the owner's email and a verification code.
+ * The agent will send an onboarding invitation email on next startup.
+ */
+export declare function runSetOwner(args: string[]): void;
+//# sourceMappingURL=set-owner.d.ts.map

package/dist/onboarding/set-owner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-owner.d.ts","sourceRoot":"","sources":["../../src/onboarding/set-owner.ts"],"names":[],"mappings":"AAmBA;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAiDhD"}

package/dist/onboarding/set-owner.js

@@ -0,0 +1,53 @@
+import crypto from "node:crypto";
+import { configExists, ensureConfigDir, saveOwnerConfig, ownerConfigExists, } from "../config/index.js";
+function generateVerificationCode() {
+    const chars = "ABCDEFGHJKLMNPQRSTUVWXYZ23456789";
+    let code = "";
+    const bytes = crypto.randomBytes(6);
+    for (let i = 0; i < 6; i++) {
+        code += chars[bytes[i] % chars.length];
+    }
+    return code;
+}
+/**
+ * CLI command: visionclaw set-owner --email <owner-email>
+ *
+ * Writes a partial owner.json with the owner's email and a verification code.
+ * The agent will send an onboarding invitation email on next startup.
+ */
+export function runSetOwner(args) {
+    if (!configExists()) {
+        console.error("Error: No manufacturer config found. Run the agent first to complete manufacturer setup.");
+        process.exit(1);
+    }
+    const emailIdx = args.indexOf("--email");
+    const email = emailIdx !== -1 && emailIdx + 1 < args.length
+        ? args[emailIdx + 1]
+        : undefined;
+    if (!email?.includes("@")) {
+        console.error("Usage: visionclaw set-owner --email <owner-email>");
+        process.exit(1);
+    }
+    if (ownerConfigExists()) {
+        console.error("Error: owner.json already exists for this profile. Owner has already been set.");
+        process.exit(1);
+    }
+    ensureConfigDir();
+    const code = generateVerificationCode();
+    const ownerConfig = {
+        agentName: "VisionClaw",
+        ownerName: "",
+        ownerEmail: email,
+        allowedTelegramChatIds: [],
+        allowedDiscordChannelIds: [],
+        heartbeatIntervalMs: 3 * 60 * 1000,
+        onboardingComplete: false,
+        onboardingCodeVerified: false,
+        onboardingCode: code,
+    };
+    saveOwnerConfig(ownerConfig);
+    console.log(`\nOwner email set to: ${email}`);
+    console.log(`Verification code: ${code}`);
+    console.log("\nStart the agent to send the onboarding invitation email to the owner.");
+}
+//# sourceMappingURL=set-owner.js.map

package/dist/onboarding/set-owner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-owner.js","sourceRoot":"","sources":["../../src/onboarding/set-owner.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,SAAS,wBAAwB;IAC/B,MAAM,KAAK,GAAG,kCAAkC,CAAC;IACjD,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAc;IACxC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CACX,0FAA0F,CAC3F,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,KAAK,GACT,QAAQ,KAAK,CAAC,CAAC,IAAI,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM;QAC3C,CAAC,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QACpB,CAAC,CAAC,SAAS,CAAC;IAEhB,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,iBAAiB,EAAE,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CACX,gFAAgF,CACjF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,eAAe,EAAE,CAAC;IAElB,MAAM,IAAI,GAAG,wBAAwB,EAAE,CAAC;IAExC,MAAM,WAAW,GAAgB;QAC/B,SAAS,EAAE,YAAY;QACvB,SAAS,EAAE,EAAE;QACb,UAAU,EAAE,KAAK;QACjB,sBAAsB,EAAE,EAAE;QAC1B,wBAAwB,EAAE,EAAE;QAC5B,mBAAmB,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI;QAClC,kBAAkB,EAAE,KAAK;QACzB,sBAAsB,EAAE,KAAK;QAC7B,cAAc,EAAE,IAAI;KACrB,CAAC;IAEF,eAAe,CAAC,WAAW,CAAC,CAAC;IAE7B,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CACT,yEAAyE,CAC1E,CAAC;AACJ,CAAC"}