remodex-cli 1.0.0

package/dist/proxy.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Global proxy support for Bridge Server fetch() calls.
+ *
+ * Reads HTTPS_PROXY / HTTP_PROXY / ALL_PROXY and configures the
+ * Node.js global fetch dispatcher via undici.
+ *
+ * Supported protocols:
+ *   http://   → undici ProxyAgent
+ *   https://  → undici ProxyAgent
+ *   socks5:// → SOCKS5 tunnel via undici Agent + socks
+ *   socks4:// → SOCKS4 tunnel via undici Agent + socks
+ *
+ * Call setupProxy() once before any fetch() — typically in index.ts / cli.ts.
+ */
+export declare function setupProxy(): string | undefined;

package/dist/proxy.js

@@ -0,0 +1,95 @@
+/**
+ * Global proxy support for Bridge Server fetch() calls.
+ *
+ * Reads HTTPS_PROXY / HTTP_PROXY / ALL_PROXY and configures the
+ * Node.js global fetch dispatcher via undici.
+ *
+ * Supported protocols:
+ *   http://   → undici ProxyAgent
+ *   https://  → undici ProxyAgent
+ *   socks5:// → SOCKS5 tunnel via undici Agent + socks
+ *   socks4:// → SOCKS4 tunnel via undici Agent + socks
+ *
+ * Call setupProxy() once before any fetch() — typically in index.ts / cli.ts.
+ */
+import { setGlobalDispatcher, ProxyAgent, Agent } from "undici";
+import { SocksClient } from "socks";
+import { connect as tlsConnect } from "node:tls";
+function getProxyUrl() {
+    return (process.env.HTTPS_PROXY ||
+        process.env.https_proxy ||
+        process.env.HTTP_PROXY ||
+        process.env.http_proxy ||
+        process.env.ALL_PROXY ||
+        process.env.all_proxy);
+}
+export function setupProxy() {
+    const proxyUrl = getProxyUrl();
+    if (!proxyUrl)
+        return undefined;
+    let parsed;
+    try {
+        parsed = new URL(proxyUrl);
+    }
+    catch {
+        console.warn(`[proxy] Invalid proxy URL: ${proxyUrl}`);
+        return undefined;
+    }
+    const proto = parsed.protocol.replace(":", "").toLowerCase();
+    if (proto === "http" || proto === "https") {
+        setGlobalDispatcher(new ProxyAgent({ uri: proxyUrl }));
+    }
+    else if (proto === "socks5" || proto === "socks5h" || proto === "socks4" || proto === "socks") {
+        setupSocks(parsed, proto);
+    }
+    else {
+        console.warn(`[proxy] Unsupported protocol: ${proto}`);
+        return undefined;
+    }
+    console.log(`[proxy] Using ${proto} proxy ${parsed.hostname}:${parsed.port}`);
+    return proxyUrl;
+}
+function setupSocks(parsed, proto) {
+    const proxy = {
+        host: parsed.hostname,
+        port: parseInt(parsed.port, 10) || 1080,
+        type: proto.startsWith("socks4") ? 4 : 5,
+    };
+    if (parsed.username) {
+        proxy.userId = decodeURIComponent(parsed.username);
+    }
+    if (parsed.password) {
+        proxy.password = decodeURIComponent(parsed.password);
+    }
+    setGlobalDispatcher(new Agent({
+        connect: async (opts, cb) => {
+            try {
+                const host = typeof opts.hostname === "string"
+                    ? opts.hostname
+                    : (opts.host ?? "localhost");
+                const port = typeof opts.port === "number"
+                    ? opts.port
+                    : parseInt(String(opts.port ?? "443"), 10);
+                const { socket } = await SocksClient.createConnection({
+                    proxy,
+                    command: "connect",
+                    destination: { host, port },
+                });
+                if (opts.protocol === "https:" || port === 443) {
+                    const tls = tlsConnect({
+                        socket: socket,
+                        servername: host,
+                    });
+                    cb(null, tls);
+                }
+                else {
+                    cb(null, socket);
+                }
+            }
+            catch (err) {
+                cb(err instanceof Error ? err : new Error(String(err)), null);
+            }
+        },
+    }));
+}
+//# sourceMappingURL=proxy.js.map

package/dist/proxy.js.map

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

package/dist/push-i18n.d.ts

@@ -0,0 +1,7 @@
+export type PushLocale = "en" | "ja" | "zh";
+export declare function normalizePushLocale(locale: string | undefined): PushLocale;
+/**
+ * Look up a translated push notification string.
+ * Supports `{param}` placeholders replaced by `params` values.
+ */
+export declare function t(locale: PushLocale, key: string, params?: Record<string, string>): string;

package/dist/push-i18n.js

@@ -0,0 +1,75 @@
+const translations = {
+    en: {
+        approval_title: "Approval needed",
+        ask_title: "Response needed",
+        plan_ready_title: "Plan ready",
+        approval_body: "Approve execution of {toolName}",
+        plan_ready_body: "Plan is ready for review",
+        ask_default_body: "Claude is asking a question",
+        task_completed: "Task completed",
+        error_occurred: "Error occurred",
+        session_completed: "Session completed",
+        session_failed: "Session failed",
+        // Privacy mode: generic bodies without tool names, question text, or result details
+        approval_body_private: "Approve tool execution",
+        ask_body_private: "Please respond to a question",
+        result_success_body_private: "Session completed",
+        result_error_body_private: "Session failed",
+    },
+    ja: {
+        approval_title: "承認待ち",
+        ask_title: "回答待ち",
+        plan_ready_title: "プラン完成",
+        approval_body: "{toolName} の実行を承認してください",
+        plan_ready_body: "プランが完成しました。確認してください",
+        ask_default_body: "Claude が質問しています",
+        task_completed: "タスク完了",
+        error_occurred: "エラー発生",
+        session_completed: "セッション完了",
+        session_failed: "セッションが失敗しました",
+        // Privacy mode
+        approval_body_private: "ツールの実行を承認してください",
+        ask_body_private: "質問に回答してください",
+        result_success_body_private: "セッション完了",
+        result_error_body_private: "セッションが失敗しました",
+    },
+    zh: {
+        approval_title: "需要批准",
+        ask_title: "需要回复",
+        plan_ready_title: "计划已准备好",
+        approval_body: "请批准执行 {toolName}",
+        plan_ready_body: "计划已准备好，请查看",
+        ask_default_body: "Claude 正在提问",
+        task_completed: "任务已完成",
+        error_occurred: "发生错误",
+        session_completed: "会话已完成",
+        session_failed: "会话失败",
+        // Privacy mode
+        approval_body_private: "请批准工具执行",
+        ask_body_private: "请回答一个问题",
+        result_success_body_private: "会话已完成",
+        result_error_body_private: "会话失败",
+    },
+};
+const SUPPORTED_LOCALES = new Set(["en", "ja", "zh"]);
+export function normalizePushLocale(locale) {
+    if (!locale)
+        return "en";
+    const lang = locale.split(/[-_]/)[0].toLowerCase();
+    return SUPPORTED_LOCALES.has(lang) ? lang : "en";
+}
+/**
+ * Look up a translated push notification string.
+ * Supports `{param}` placeholders replaced by `params` values.
+ */
+export function t(locale, key, params) {
+    const table = translations[locale] ?? translations.en;
+    let text = table[key] ?? translations.en[key] ?? key;
+    if (params) {
+        for (const [k, v] of Object.entries(params)) {
+            text = text.replaceAll(`{${k}}`, v);
+        }
+    }
+    return text;
+}
+//# sourceMappingURL=push-i18n.js.map

package/dist/push-i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-i18n.js","sourceRoot":"","sources":["../src/push-i18n.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAA+C;IAC/D,EAAE,EAAE;QACF,cAAc,EAAE,iBAAiB;QACjC,SAAS,EAAE,iBAAiB;QAC5B,gBAAgB,EAAE,YAAY;QAC9B,aAAa,EAAE,iCAAiC;QAChD,eAAe,EAAE,0BAA0B;QAC3C,gBAAgB,EAAE,6BAA6B;QAC/C,cAAc,EAAE,gBAAgB;QAChC,cAAc,EAAE,gBAAgB;QAChC,iBAAiB,EAAE,mBAAmB;QACtC,cAAc,EAAE,gBAAgB;QAChC,oFAAoF;QACpF,qBAAqB,EAAE,wBAAwB;QAC/C,gBAAgB,EAAE,8BAA8B;QAChD,2BAA2B,EAAE,mBAAmB;QAChD,yBAAyB,EAAE,gBAAgB;KAC5C;IACD,EAAE,EAAE;QACF,cAAc,EAAE,MAAM;QACtB,SAAS,EAAE,MAAM;QACjB,gBAAgB,EAAE,OAAO;QACzB,aAAa,EAAE,yBAAyB;QACxC,eAAe,EAAE,qBAAqB;QACtC,gBAAgB,EAAE,iBAAiB;QACnC,cAAc,EAAE,OAAO;QACvB,cAAc,EAAE,OAAO;QACvB,iBAAiB,EAAE,SAAS;QAC5B,cAAc,EAAE,cAAc;QAC9B,eAAe;QACf,qBAAqB,EAAE,iBAAiB;QACxC,gBAAgB,EAAE,aAAa;QAC/B,2BAA2B,EAAE,SAAS;QACtC,yBAAyB,EAAE,cAAc;KAC1C;IACD,EAAE,EAAE;QACF,cAAc,EAAE,MAAM;QACtB,SAAS,EAAE,MAAM;QACjB,gBAAgB,EAAE,QAAQ;QAC1B,aAAa,EAAE,kBAAkB;QACjC,eAAe,EAAE,YAAY;QAC7B,gBAAgB,EAAE,aAAa;QAC/B,cAAc,EAAE,OAAO;QACvB,cAAc,EAAE,MAAM;QACtB,iBAAiB,EAAE,OAAO;QAC1B,cAAc,EAAE,MAAM;QACtB,eAAe;QACf,qBAAqB,EAAE,SAAS;QAChC,gBAAgB,EAAE,SAAS;QAC3B,2BAA2B,EAAE,OAAO;QACpC,yBAAyB,EAAE,MAAM;KAClC;CACF,CAAC;AAEF,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAS,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAE9D,MAAM,UAAU,mBAAmB,CAAC,MAA0B;IAC5D,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACnD,OAAO,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAmB,CAAC,CAAC,CAAC,IAAI,CAAC;AACnE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,CAAC,CACf,MAAkB,EAClB,GAAW,EACX,MAA+B;IAE/B,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,EAAE,CAAC;IACtD,IAAI,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;IACrD,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5C,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/push-relay.d.ts

@@ -0,0 +1,29 @@
+import type { FirebaseAuthClient } from "./firebase-auth.js";
+export type PushPlatform = "ios" | "android" | "web";
+export interface PushNotifyPayload {
+    eventType: string;
+    title: string;
+    body: string;
+    /** When set, only tokens registered with this locale receive the notification. */
+    locale?: string;
+    data?: Record<string, string>;
+}
+export interface PushRelayClientOptions {
+    relayUrl?: string;
+    firebaseAuth?: FirebaseAuthClient | null;
+    timeoutMs?: number;
+    fetchImpl?: typeof fetch;
+}
+export declare class PushRelayClient {
+    private readonly relayUrl;
+    private readonly firebaseAuth;
+    private readonly timeoutMs;
+    private readonly fetchImpl;
+    constructor(options?: PushRelayClientOptions);
+    get isConfigured(): boolean;
+    private get bridgeId();
+    registerToken(token: string, platform: PushPlatform, locale?: string): Promise<void>;
+    unregisterToken(token: string): Promise<void>;
+    notify(payload: PushNotifyPayload): Promise<void>;
+    private post;
+}

package/dist/push-relay.js

@@ -0,0 +1,70 @@
+const DEFAULT_RELAY_URL = "https://us-central1-remodex-ca33b.cloudfunctions.net/relay";
+export class PushRelayClient {
+    relayUrl;
+    firebaseAuth;
+    timeoutMs;
+    fetchImpl;
+    constructor(options = {}) {
+        this.relayUrl = options.relayUrl ?? DEFAULT_RELAY_URL;
+        this.firebaseAuth = options.firebaseAuth ?? null;
+        this.timeoutMs = options.timeoutMs ?? 10_000;
+        this.fetchImpl = options.fetchImpl ?? fetch;
+    }
+    get isConfigured() {
+        return this.firebaseAuth != null;
+    }
+    get bridgeId() {
+        return this.firebaseAuth.uid;
+    }
+    async registerToken(token, platform, locale) {
+        if (!this.isConfigured)
+            return;
+        await this.post({ op: "register", token, platform, locale, bridgeId: this.bridgeId });
+    }
+    async unregisterToken(token) {
+        if (!this.isConfigured)
+            return;
+        await this.post({ op: "unregister", token, bridgeId: this.bridgeId });
+    }
+    async notify(payload) {
+        if (!this.isConfigured)
+            return;
+        await this.post({
+            op: "notify",
+            bridgeId: this.bridgeId,
+            eventType: payload.eventType,
+            title: payload.title,
+            body: payload.body,
+            locale: payload.locale,
+            data: payload.data,
+        });
+    }
+    async post(payload) {
+        if (!this.isConfigured || !this.firebaseAuth)
+            return;
+        console.log(`[push-relay] ${payload.op} → ${this.relayUrl} (bridgeId: ${payload.bridgeId})`);
+        const idToken = await this.firebaseAuth.getIdToken();
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await this.fetchImpl(this.relayUrl, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "Authorization": `Bearer ${idToken}`,
+                },
+                body: JSON.stringify(payload),
+                signal: controller.signal,
+            });
+            const responseText = (await response.text()).trim().slice(0, 200);
+            if (!response.ok) {
+                throw new Error(`Push relay returned ${response.status}${responseText ? `: ${responseText}` : ""}`);
+            }
+            console.log(`[push-relay] ${payload.op} OK: ${responseText}`);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=push-relay.js.map

package/dist/push-relay.js.map

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

package/dist/recording-store.d.ts

@@ -0,0 +1,51 @@
+import type { ClientMessage, ServerMessage } from "./parser.js";
+export interface RecordingMeta {
+    bridgeSessionId: string;
+    claudeSessionId?: string;
+    projectPath: string;
+    createdAt: string;
+}
+export interface RecordingFileInfo {
+    name: string;
+    path: string;
+    modified: string;
+    sizeBytes: number;
+    meta?: RecordingMeta;
+    summary?: string;
+    firstPrompt?: string;
+    lastPrompt?: string;
+}
+export interface RecordedEvent {
+    ts: string;
+    direction: "outgoing" | "incoming";
+    message: ServerMessage | ClientMessage;
+}
+export declare class RecordingStore {
+    private recordingDir;
+    private writeChains;
+    constructor(rootDir?: string);
+    init(): Promise<void>;
+    getFilePath(sessionId: string): string;
+    private getMetaPath;
+    /** Save or update session metadata alongside the recording. */
+    saveMeta(sessionId: string, meta: RecordingMeta): void;
+    /** Read session metadata. */
+    getMeta(sessionId: string): Promise<RecordingMeta | null>;
+    record(sessionId: string, direction: "outgoing" | "incoming", message: ServerMessage | ClientMessage): void;
+    /** List all recording files, newest first, with metadata if available. */
+    listRecordings(): Promise<RecordingFileInfo[]>;
+    /**
+     * Extract key info directly from JSONL content without requiring meta or sessions-index.
+     * Scans for first/last user input messages and claudeSessionId from system messages.
+     */
+    extractInfoFromJsonl(sessionId: string): Promise<{
+        firstPrompt?: string;
+        lastPrompt?: string;
+        claudeSessionId?: string;
+        projectPath?: string;
+    }>;
+    /** Read recording content as string. */
+    getRecordingContent(sessionId: string): Promise<string | null>;
+    flush(): Promise<void>;
+    private enqueue;
+}

package/dist/recording-store.js

@@ -0,0 +1,158 @@
+import { appendFile, mkdir, readdir, readFile, stat, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+const DEFAULT_ROOT_DIR = join(homedir(), ".remodex", "debug");
+const RECORDING_DIRNAME = "recordings";
+export class RecordingStore {
+    recordingDir;
+    writeChains = new Map();
+    constructor(rootDir = DEFAULT_ROOT_DIR) {
+        this.recordingDir = join(rootDir, RECORDING_DIRNAME);
+    }
+    async init() {
+        await mkdir(this.recordingDir, { recursive: true });
+    }
+    getFilePath(sessionId) {
+        return join(this.recordingDir, `${sanitizeSegment(sessionId)}.jsonl`);
+    }
+    getMetaPath(sessionId) {
+        return join(this.recordingDir, `${sanitizeSegment(sessionId)}.meta.json`);
+    }
+    /** Save or update session metadata alongside the recording. */
+    saveMeta(sessionId, meta) {
+        const path = this.getMetaPath(sessionId);
+        this.enqueue(path, async () => {
+            await writeFile(path, JSON.stringify(meta, null, 2), "utf-8");
+        });
+    }
+    /** Read session metadata. */
+    async getMeta(sessionId) {
+        try {
+            const raw = await readFile(this.getMetaPath(sessionId), "utf-8");
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    record(sessionId, direction, message) {
+        const path = this.getFilePath(sessionId);
+        const event = {
+            ts: new Date().toISOString(),
+            direction,
+            message,
+        };
+        const line = `${JSON.stringify(event)}\n`;
+        this.enqueue(path, async () => {
+            await appendFile(path, line, "utf-8");
+        });
+    }
+    /** List all recording files, newest first, with metadata if available. */
+    async listRecordings() {
+        try {
+            const entries = await readdir(this.recordingDir);
+            const results = [];
+            for (const entry of entries) {
+                if (!entry.endsWith(".jsonl"))
+                    continue;
+                const name = entry.replace(/\.jsonl$/, "");
+                const filePath = join(this.recordingDir, entry);
+                const s = await stat(filePath);
+                const meta = await this.getMeta(name);
+                results.push({
+                    name,
+                    path: filePath,
+                    modified: s.mtime.toISOString(),
+                    sizeBytes: s.size,
+                    ...(meta ? { meta } : {}),
+                });
+            }
+            results.sort((a, b) => b.modified.localeCompare(a.modified));
+            return results;
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Extract key info directly from JSONL content without requiring meta or sessions-index.
+     * Scans for first/last user input messages and claudeSessionId from system messages.
+     */
+    async extractInfoFromJsonl(sessionId) {
+        try {
+            const content = await readFile(this.getFilePath(sessionId), "utf-8");
+            const lines = content.trim().split("\n");
+            let firstPrompt;
+            let lastPrompt;
+            let claudeSessionId;
+            let projectPath;
+            for (const line of lines) {
+                try {
+                    const event = JSON.parse(line);
+                    const msg = event.message;
+                    // Extract user input messages (incoming "input" type)
+                    if (event.direction === "incoming" && msg.type === "input" && typeof msg.text === "string") {
+                        if (!firstPrompt)
+                            firstPrompt = msg.text;
+                        lastPrompt = msg.text;
+                    }
+                    // Extract claudeSessionId from system messages
+                    if (event.direction === "outgoing" && msg.type === "system" && typeof msg.sessionId === "string") {
+                        // Claude CLI session IDs are full UUIDs (36 chars)
+                        const sid = msg.sessionId;
+                        if (sid.length > 8 && !claudeSessionId) {
+                            claudeSessionId = sid;
+                        }
+                    }
+                    // Extract projectPath from start messages
+                    if (event.direction === "incoming" && msg.type === "start" && typeof msg.projectPath === "string") {
+                        projectPath = msg.projectPath;
+                    }
+                }
+                catch {
+                    // skip malformed lines
+                }
+            }
+            return { firstPrompt, lastPrompt, claudeSessionId, projectPath };
+        }
+        catch {
+            return {};
+        }
+    }
+    /** Read recording content as string. */
+    async getRecordingContent(sessionId) {
+        try {
+            const filePath = this.getFilePath(sessionId);
+            return await readFile(filePath, "utf-8");
+        }
+        catch {
+            return null;
+        }
+    }
+    async flush() {
+        const pendingWrites = [...this.writeChains.values()];
+        await Promise.all(pendingWrites.map((p) => p.catch(() => { })));
+    }
+    enqueue(path, task) {
+        const previous = this.writeChains.get(path) ?? Promise.resolve();
+        const next = previous
+            .catch(() => { })
+            .then(async () => {
+            await mkdir(dirname(path), { recursive: true });
+            await task();
+        })
+            .finally(() => {
+            if (this.writeChains.get(path) === next) {
+                this.writeChains.delete(path);
+            }
+        });
+        this.writeChains.set(path, next);
+        void next.catch((err) => {
+            console.warn(`[recording-store] Failed to write ${path}:`, err);
+        });
+    }
+}
+function sanitizeSegment(value) {
+    return value.replace(/[^a-zA-Z0-9._-]/g, "_");
+}
+//# sourceMappingURL=recording-store.js.map

package/dist/recording-store.js.map

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

package/dist/screenshot.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Screenshot module — macOS native screenshot capture via CLI commands.
+ *
+ * - `listWindows()`: Enumerate on-screen windows using CGWindowListCopyWindowInfo
+ *   via Swift's CoreGraphics (Quartz PyObjC is unreliable across Python installs).
+ * - `takeScreenshot()`: Capture full-screen or a specific window via `screencapture`.
+ */
+export interface WindowBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface WindowInfo {
+    windowId: number;
+    ownerName: string;
+    windowTitle: string;
+    bounds: WindowBounds;
+}
+export interface ScreenshotOptions {
+    mode: "fullscreen" | "window";
+    windowId?: number;
+}
+export interface ScreenshotResult {
+    filePath: string;
+}
+export declare function listWindows(): Promise<WindowInfo[]>;
+export declare function takeScreenshot(options: ScreenshotOptions): Promise<ScreenshotResult>;

package/dist/screenshot.js

@@ -0,0 +1,98 @@
+/**
+ * Screenshot module — macOS native screenshot capture via CLI commands.
+ *
+ * - `listWindows()`: Enumerate on-screen windows using CGWindowListCopyWindowInfo
+ *   via Swift's CoreGraphics (Quartz PyObjC is unreliable across Python installs).
+ * - `takeScreenshot()`: Capture full-screen or a specific window via `screencapture`.
+ */
+import { execFile } from "node:child_process";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+// ---------------------------------------------------------------------------
+// listWindows
+// ---------------------------------------------------------------------------
+/**
+ * Swift inline script that calls CGWindowListCopyWindowInfo and outputs JSON.
+ * Uses `swift -e` which is available on any macOS with Xcode CLT.
+ * Python + Quartz was unreliable (PyObjC missing on non-system python installs).
+ */
+const LIST_WINDOWS_SWIFT = `
+import CoreGraphics
+import Foundation
+
+let windowList = CGWindowListCopyWindowInfo(
+    [.optionOnScreenOnly, .excludeDesktopElements],
+    kCGNullWindowID
+) as? [[String: Any]] ?? []
+
+var out: [[String: Any]] = []
+for w in windowList {
+    guard let layer = w[kCGWindowLayer as String] as? Int, layer == 0 else { continue }
+    guard let owner = w[kCGWindowOwnerName as String] as? String, !owner.isEmpty else { continue }
+    let bounds = w[kCGWindowBounds as String] as? [String: Any] ?? [:]
+    let width = bounds["Width"] as? Double ?? 0
+    let height = bounds["Height"] as? Double ?? 0
+    if width < 50 || height < 50 { continue }
+    out.append([
+        "windowId": w[kCGWindowNumber as String] as? Int ?? 0,
+        "ownerName": owner,
+        "windowTitle": (w[kCGWindowName as String] as? String) ?? "",
+        "bounds": [
+            "x": (bounds["X"] as? Double ?? 0) as Any,
+            "y": (bounds["Y"] as? Double ?? 0) as Any,
+            "width": width as Any,
+            "height": height as Any,
+        ] as Any,
+    ])
+}
+let data = try JSONSerialization.data(withJSONObject: out, options: [])
+print(String(data: data, encoding: .utf8)!)
+`;
+export async function listWindows() {
+    if (process.platform !== "darwin") {
+        throw new Error("listWindows is only supported on macOS");
+    }
+    return new Promise((resolve, reject) => {
+        execFile("swift", ["-e", LIST_WINDOWS_SWIFT], { timeout: 15_000 }, (err, stdout, stderr) => {
+            if (err) {
+                reject(new Error(`Failed to list windows: ${err.message}${stderr ? ` — ${stderr}` : ""}`));
+                return;
+            }
+            try {
+                const windows = JSON.parse(stdout);
+                resolve(windows);
+            }
+            catch (parseErr) {
+                reject(new Error(`Failed to parse window list: ${parseErr}`));
+            }
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// takeScreenshot
+// ---------------------------------------------------------------------------
+export async function takeScreenshot(options) {
+    if (process.platform !== "darwin") {
+        throw new Error("takeScreenshot is only supported on macOS");
+    }
+    const filePath = join(tmpdir(), `remodex-screenshot-${Date.now()}.png`);
+    const args = ["-x"]; // silent (no capture sound)
+    if (options.mode === "window") {
+        if (options.windowId == null) {
+            throw new Error("windowId is required for window mode");
+        }
+        args.push("-o"); // no window shadow
+        args.push("-l", String(options.windowId));
+    }
+    args.push("-t", "png", filePath);
+    return new Promise((resolve, reject) => {
+        execFile("screencapture", args, { timeout: 10_000 }, (err, _stdout, stderr) => {
+            if (err) {
+                reject(new Error(`screencapture failed: ${err.message}${stderr ? ` — ${stderr}` : ""}`));
+                return;
+            }
+            resolve({ filePath });
+        });
+    });
+}
+//# sourceMappingURL=screenshot.js.map