axon-code 2.4.0

package/dist/eye/index.js

@@ -0,0 +1,356 @@
+/**
+ * Perception Daemon Manager
+ *
+ * Manages the perception daemon — a single Python process that keeps the
+ * camera open in memory and serves frames on demand via local HTTP API.
+ *
+ * Design: devices stay open, frames stay in memory, disk writes only on demand.
+ * The AI calls GET /eye → daemon writes latest frame → returns path → AI sees it.
+ */
+import { spawn, execSync } from 'child_process';
+import { existsSync, readFileSync, mkdirSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+export const EYE_DIR = join(homedir(), '.axon', 'eye');
+export const LATEST_IMAGE = join(EYE_DIR, 'latest.png');
+const PID_FILE = join(EYE_DIR, 'eye.pid');
+const PORT_FILE = join(EYE_DIR, 'eye.port');
+const DEFAULT_PORT = 7890;
+/**
+ * Find the camera.py script path.
+ */
+function findScript() {
+    const candidates = [
+        join(__dirname, 'camera.py'), // same dir (dist/eye/ or src/eye/)
+        join(__dirname, '..', 'eye', 'camera.py'), // sibling
+        join(__dirname, '..', '..', 'src', 'eye', 'camera.py'), // project root from dist/eye/
+    ];
+    for (const p of candidates) {
+        if (existsSync(p))
+            return p;
+    }
+    return null;
+}
+/**
+ * Read the daemon port from the port file.
+ */
+function readPort() {
+    if (!existsSync(PORT_FILE))
+        return DEFAULT_PORT;
+    try {
+        return parseInt(readFileSync(PORT_FILE, 'utf-8').trim(), 10) || DEFAULT_PORT;
+    }
+    catch {
+        return DEFAULT_PORT;
+    }
+}
+/**
+ * Read PID from file.
+ */
+function readPid() {
+    if (!existsSync(PID_FILE))
+        return null;
+    try {
+        const pid = parseInt(readFileSync(PID_FILE, 'utf-8').trim(), 10);
+        return isNaN(pid) ? null : pid;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if the daemon process is alive.
+ */
+function isProcessAlive(pid) {
+    try {
+        if (process.platform === 'win32') {
+            const output = execSync(`tasklist /FI "PID eq ${pid}" /NH`, { encoding: 'utf-8', stdio: 'pipe' });
+            return output.includes(String(pid));
+        }
+        else {
+            process.kill(pid, 0);
+            return true;
+        }
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if the daemon process exists (PID file + process alive).
+ * This is a fast, synchronous check — does NOT verify HTTP readiness.
+ */
+export function isEyeProcessAlive() {
+    const pid = readPid();
+    if (pid === null)
+        return false;
+    return isProcessAlive(pid);
+}
+/**
+ * Check if the daemon is fully running (process alive + HTTP responding).
+ * This is async because it probes the HTTP endpoint.
+ */
+export async function isEyeReady() {
+    if (!isEyeProcessAlive())
+        return false;
+    try {
+        const data = await daemonRequest('/status');
+        return data.daemon === 'running';
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Synchronous check — kept for backward compatibility but only checks process.
+ * Prefer isEyeReady() for accurate readiness checks.
+ */
+export function isEyeRunning() {
+    return isEyeProcessAlive();
+}
+/**
+ * Get the daemon's HTTP base URL.
+ */
+export function getDaemonUrl() {
+    return `http://127.0.0.1:${readPort()}`;
+}
+/**
+ * Call the daemon's HTTP API.
+ */
+async function daemonRequest(path, method = 'GET') {
+    const url = `${getDaemonUrl()}${path}`;
+    const response = await fetch(url, { method, signal: AbortSignal.timeout(5000) });
+    return response.json();
+}
+/**
+ * Request a frame from the daemon. Returns the path to latest.png.
+ */
+export async function captureFrame() {
+    try {
+        const data = await daemonRequest('/eye');
+        if (data.error) {
+            return { success: false, error: data.error };
+        }
+        return {
+            success: true,
+            path: data.path,
+            resolution: data.resolution,
+            timestamp: data.timestamp,
+        };
+    }
+    catch (e) {
+        return { success: false, error: `Daemon not responding: ${e.message}` };
+    }
+}
+/**
+ * Start the perception daemon.
+ */
+export async function startEye(config = {}) {
+    // If process is alive, check if HTTP is also ready
+    if (isEyeProcessAlive()) {
+        if (await isEyeReady()) {
+            const pid = readPid();
+            return { success: true, message: 'Perception daemon already running', pid };
+        }
+        // Process alive but HTTP not ready — wait for it instead of spawning a new one
+        const ready = await waitForDaemonReady(6000);
+        if (ready) {
+            const pid = readPid();
+            return { success: true, message: 'Perception daemon is now ready', pid };
+        }
+        // Still not ready after waiting — kill the stale process and restart
+        const stalePid = readPid();
+        if (stalePid) {
+            try {
+                if (process.platform === 'win32') {
+                    execSync(`taskkill /F /PID ${stalePid}`, { stdio: 'pipe' });
+                }
+                else {
+                    process.kill(stalePid, 'SIGKILL');
+                }
+            }
+            catch { /* ignore */ }
+        }
+    }
+    // Clean up stale files
+    for (const f of [PID_FILE, PORT_FILE]) {
+        if (existsSync(f)) {
+            try {
+                unlinkSync(f);
+            }
+            catch { /* ignore */ }
+        }
+    }
+    const script = findScript();
+    if (!script) {
+        return { success: false, message: 'camera.py not found' };
+    }
+    mkdirSync(EYE_DIR, { recursive: true });
+    const port = config.port ?? DEFAULT_PORT;
+    const camera = config.camera ?? 0;
+    const interval = config.interval ?? 0.5;
+    const python = findPython();
+    if (!python) {
+        return { success: false, message: 'Python not found. Install Python 3.x with opencv-python' };
+    }
+    return new Promise((resolve) => {
+        const child = spawn(python, [
+            script,
+            '--port', String(port),
+            '--camera', String(camera),
+            '--interval', String(interval),
+        ], {
+            detached: true,
+            stdio: 'ignore',
+            windowsHide: true,
+        });
+        child.unref();
+        // Wait for daemon to be ready (PID file + HTTP responding)
+        const startTime = Date.now();
+        const check = setInterval(async () => {
+            if (Date.now() - startTime > 8000) {
+                clearInterval(check);
+                resolve({ success: false, message: 'Daemon failed to start within 8 seconds. Check ~/.axon/eye/eye.log' });
+                return;
+            }
+            if (!existsSync(PID_FILE))
+                return;
+            try {
+                const data = await daemonRequest('/status');
+                if (data.daemon === 'running') {
+                    clearInterval(check);
+                    resolve({
+                        success: true,
+                        message: `Perception daemon started (port=${port}, camera=${camera})`,
+                        pid: data.pid,
+                    });
+                }
+            }
+            catch {
+                // Not ready yet
+            }
+        }, 500);
+    });
+}
+/**
+ * Stop the perception daemon.
+ */
+export async function stopEye() {
+    if (!isEyeRunning()) {
+        // Clean up stale files
+        for (const f of [PID_FILE, PORT_FILE]) {
+            if (existsSync(f)) {
+                try {
+                    unlinkSync(f);
+                }
+                catch { /* ignore */ }
+            }
+        }
+        return { success: true, message: 'Daemon not running' };
+    }
+    try {
+        // Try graceful HTTP shutdown first
+        await daemonRequest('/stop', 'POST');
+        // Wait for process to exit
+        const pid = readPid();
+        if (pid) {
+            for (let i = 0; i < 10; i++) {
+                await sleep(500);
+                if (!isProcessAlive(pid))
+                    break;
+            }
+            // Force kill if still alive
+            if (isProcessAlive(pid)) {
+                if (process.platform === 'win32') {
+                    execSync(`taskkill /F /PID ${pid}`, { stdio: 'pipe' });
+                }
+                else {
+                    process.kill(pid, 'SIGKILL');
+                }
+            }
+        }
+        return { success: true, message: 'Daemon stopped' };
+    }
+    catch {
+        // HTTP failed, try force kill via PID
+        const pid = readPid();
+        if (pid) {
+            try {
+                if (process.platform === 'win32') {
+                    execSync(`taskkill /F /PID ${pid}`, { stdio: 'pipe' });
+                }
+                else {
+                    process.kill(pid, 'SIGKILL');
+                }
+            }
+            catch { /* ignore */ }
+        }
+        // Clean up files
+        for (const f of [PID_FILE, PORT_FILE]) {
+            if (existsSync(f)) {
+                try {
+                    unlinkSync(f);
+                }
+                catch { /* ignore */ }
+            }
+        }
+        return { success: true, message: 'Daemon force-killed' };
+    }
+}
+/**
+ * Get daemon status.
+ */
+export async function getEyeStatus() {
+    if (!isEyeRunning()) {
+        return { running: false, eyeDir: EYE_DIR };
+    }
+    try {
+        const data = await daemonRequest('/status');
+        return { ...data, eyeDir: EYE_DIR, daemonUrl: getDaemonUrl() };
+    }
+    catch (e) {
+        return { running: false, error: e.message, eyeDir: EYE_DIR };
+    }
+}
+// ── Helpers ─────────────────────────────────────────────────────────────
+function findPython() {
+    const candidates = process.platform === 'win32'
+        ? ['python', 'python3', 'py']
+        : ['python3', 'python'];
+    for (const cmd of candidates) {
+        try {
+            execSync(`${cmd} --version`, { stdio: 'pipe' });
+            return cmd;
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Wait for the daemon HTTP endpoint to become ready.
+ */
+async function waitForDaemonReady(timeoutMs) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeoutMs) {
+        try {
+            const data = await daemonRequest('/status');
+            if (data.daemon === 'running')
+                return true;
+        }
+        catch {
+            // Not ready yet
+        }
+        await sleep(500);
+    }
+    return false;
+}
+//# sourceMappingURL=index.js.map

package/dist/eye/index.js.map

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

package/dist/fast-mode/index.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Fast Mode 核心模块
+ *
+ * 对齐官方 v2.1.36: Fast mode is now available for Opus 4.6
+ * 对齐官方 v2.1.37: Fixed /fast not immediately available after /extra-usage
+ *
+ * Fast mode 的本质是同一个 Opus 4.6 模型，通过在 API 请求中设置
+ * research_preview_2026_02: "active" 和特定 beta flag 来启用服务端快速输出管线。
+ * 计费按 extra usage 的高级费率。遇到 429 速率限制时自动进入 cooldown 并降级到普通模式。
+ *
+ * 内部代号: "penguin"
+ */
+/** Fast mode 强制使用的模型标识 */
+export declare const FAST_MODE_MODEL = "opus";
+/** Fast mode 对应的模型显示名 */
+export declare const FAST_MODE_DISPLAY_NAME = "Opus 4.6";
+/** Fast mode 计费说明 */
+export declare const FAST_MODE_BILLING_NOTE = "Billed at a premium rate";
+/** Fast mode beta flag */
+export declare const FAST_MODE_BETA = "fast-mode-2026-02-06";
+/** Fast mode extra body 参数 */
+export declare const FAST_MODE_RESEARCH_PREVIEW = "research_preview_2026_02";
+/** Cooldown 事件监听器 */
+export interface CooldownListener {
+    onCooldownTriggered(resetAt: number): void;
+    onCooldownExpired(): void;
+}
+/**
+ * 检查 fast mode feature flag 是否启用（对齐官方 n4()）
+ *
+ * 官方使用 LaunchDarkly: y8("tengu_penguins_enabled", true)
+ * 我们默认启用，除非被环境变量明确禁用
+ */
+export declare function isPenguinEnabled(): boolean;
+/**
+ * 检查 fast mode 是否完全可用（对齐官方 C$()）
+ */
+export declare function isFastModeAvailable(): boolean;
+/**
+ * 获取不可用原因（对齐官方 W46()）
+ * 返回 null 表示可用
+ */
+export declare function getUnavailableReason(): string | null;
+/**
+ * 检查模型是否支持 fast mode（对齐官方 X0()）
+ */
+export declare function isModelSupportsFastMode(model?: string | null): boolean;
+/**
+ * 判断当前是否处于 fast mode（对齐官方 vt8()）
+ */
+export declare function isInFastMode(model: string | null, fastModeState: boolean): boolean;
+/**
+ * 检查是否在 cooldown 中（对齐官方 nk()）
+ */
+export declare function isInCooldown(): boolean;
+/**
+ * 触发 cooldown（对齐官方 kt8()）
+ */
+export declare function triggerCooldown(resetAt: number): void;
+/**
+ * 重置 cooldown（对齐官方 k81()）
+ */
+export declare function resetCooldown(): void;
+/**
+ * 获取用户的 fast mode 设置
+ */
+export declare function getUserFastModeSetting(): boolean | undefined;
+/**
+ * 设置用户的 fast mode 设置（对齐官方 w7()）
+ */
+export declare function setUserFastModeSetting(enabled: boolean | undefined): void;
+/**
+ * 切换 fast mode 的核心逻辑（对齐官方 Q9q() + xAz()）
+ *
+ * 返回提示信息
+ */
+export declare function toggleFastMode(enable: boolean, getCurrentModel: () => string | null, setModel: (model: string) => void, setFastModeState: (enabled: boolean) => void): string;
+/**
+ * 处理 overage 拒绝（对齐官方 yt8()）
+ */
+export declare function handleOverageRejection(reason: string | null, setFastModeState: (enabled: boolean) => void): string;
+/**
+ * 检查 API 返回的 penguin mode 状态（对齐官方 G46()）
+ *
+ * v2.1.37 修复: 在 /extra-usage enable 后立即重新检查
+ */
+export declare function prefetchPenguinMode(authInfo?: {
+    accessToken?: string;
+    apiKey?: string;
+}, force?: boolean): Promise<void>;
+/**
+ * v2.1.37: 强制重新检查 penguin mode（用于 /extra-usage enable 后）
+ */
+export declare function forcePrefetchPenguinMode(authInfo?: {
+    accessToken?: string;
+    apiKey?: string;
+}): Promise<void>;
+/**
+ * 检查 fast mode 是否应该激活（用于 API 请求构建）
+ * 对齐官方的 isFastMode 条件检查
+ */
+export declare function shouldActivateFastMode(model: string, fastModeState: boolean): boolean;
+/**
+ * 检查是否为 fast mode 特定的 400 错误
+ * 对齐官方 _79()
+ */
+export declare function isFastModeNotEnabledError(error: any): boolean;
+/**
+ * 永久禁用 fast mode（当服务端返回 fast mode not enabled 错误时）
+ */
+export declare function permanentlyDisableFastMode(): void;
+/** 普通 Opus 定价（每百万 token，美元） */
+export declare const OPUS_PRICING: {
+    inputTokens: number;
+    outputTokens: number;
+    promptCacheWriteTokens: number;
+    promptCacheReadTokens: number;
+};
+/** Fast mode 标准定价（每百万 token，美元） */
+export declare const FAST_MODE_PRICING: {
+    inputTokens: number;
+    outputTokens: number;
+    promptCacheWriteTokens: number;
+    promptCacheReadTokens: number;
+};
+/** Fast mode 1M 上下文定价（每百万 token，美元） */
+export declare const FAST_MODE_1M_PRICING: {
+    inputTokens: number;
+    outputTokens: number;
+    promptCacheWriteTokens: number;
+    promptCacheReadTokens: number;
+};
+export declare function addCooldownListener(listener: CooldownListener): () => void;
+export declare function addOverageListener(listener: (message: string) => void): () => void;
+export declare function addOrgStatusListener(listener: (enabled: boolean) => void): () => void;
+//# sourceMappingURL=index.d.ts.map

package/dist/fast-mode/index.d.ts.map

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