@mseep/clawdcursor 1.5.5

package/dist/surface/report.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Error Report — opt-in user report submission.
+ *
+ * Users can send task logs + system info to help improve the agent.
+ * All data is redacted before sending (no clipboard, no typed text,
+ * no file paths with usernames, no API keys).
+ *
+ * Privacy-first: never automatic, user must explicitly trigger.
+ */
+export interface ErrorReport {
+    reportId: string;
+    timestamp: string;
+    version: string;
+    system: {
+        platform: string;
+        arch: string;
+        nodeVersion: string;
+        osRelease: string;
+    };
+    task?: {
+        description: string;
+        status: string;
+        totalSteps: number;
+        durationMs: number;
+        layersUsed: (string | number)[];
+        llmCallCount: number;
+    };
+    steps: RedactedStep[];
+    userNote?: string;
+    errorContext?: string;
+}
+interface RedactedStep {
+    stepIndex: number;
+    timestamp: string;
+    layer: string | number;
+    actionType: string;
+    result: string;
+    durationMs?: number;
+    error?: string;
+    verification?: {
+        method: string;
+        verified: boolean;
+    };
+}
+/** Build a report from a task log */
+export declare function buildReport(logPath?: string, userNote?: string): ErrorReport;
+/** Submit a report to the backend */
+export declare function submitReport(report: ErrorReport): Promise<{
+    success: boolean;
+    reportId: string;
+    error?: string;
+}>;
+/** Save report locally (fallback if network fails) */
+export declare function saveReportLocally(report: ErrorReport): string;
+/** Interactive report flow — shows what will be sent, asks for confirmation */
+export declare function interactiveReport(): Promise<void>;
+/** Build and submit a report programmatically (for REST API) */
+export declare function apiSubmitReport(opts: {
+    logPath?: string;
+    userNote?: string;
+    logIndex?: number;
+}): Promise<{
+    success: boolean;
+    reportId: string;
+    preview?: ErrorReport;
+    error?: string;
+}>;
+export {};

package/dist/surface/report.js

@@ -0,0 +1,341 @@
+"use strict";
+/**
+ * Error Report — opt-in user report submission.
+ *
+ * Users can send task logs + system info to help improve the agent.
+ * All data is redacted before sending (no clipboard, no typed text,
+ * no file paths with usernames, no API keys).
+ *
+ * Privacy-first: never automatic, user must explicitly trigger.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildReport = buildReport;
+exports.submitReport = submitReport;
+exports.saveReportLocally = saveReportLocally;
+exports.interactiveReport = interactiveReport;
+exports.apiSubmitReport = apiSubmitReport;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const readline = __importStar(require("readline"));
+const version_1 = require("./version");
+const paths_1 = require("../paths");
+// ─── Configuration ──────────────────────────────────────────
+const REPORT_ENDPOINT = process.env.CLAWD_REPORT_URL || 'https://api.clawdcursor.com/reports';
+const LOG_DIR = paths_1.TASK_LOGS_DIR;
+// ─── Redaction ───────────────────────────────────────────────
+const SENSITIVE_PATTERNS = [
+    // API keys
+    /sk-[a-zA-Z0-9_-]{20,}/g,
+    /api[_-]?key["\s:=]+["']?[a-zA-Z0-9_-]{16,}/gi,
+    /bearer\s+[a-zA-Z0-9_.-]{20,}/gi,
+    // Auth tokens in URLs
+    /token=[a-zA-Z0-9_.-]{10,}/gi,
+    /auth=[a-zA-Z0-9_.-]{10,}/gi,
+    // Email addresses
+    /[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/g,
+];
+/** Redact user home directory from paths */
+function redactPaths(text) {
+    const home = os.homedir().replace(/\\/g, '/');
+    const homeWin = os.homedir().replace(/\//g, '\\');
+    let result = text.replace(new RegExp(escapeRegex(home), 'gi'), '~');
+    result = result.replace(new RegExp(escapeRegex(homeWin), 'gi'), '~');
+    // Also redact common username patterns in paths
+    const username = os.userInfo().username;
+    if (username.length > 2) {
+        result = result.replace(new RegExp(`/Users/${escapeRegex(username)}`, 'gi'), '/Users/[REDACTED]');
+        result = result.replace(new RegExp(`\\\\Users\\\\${escapeRegex(username)}`, 'gi'), '\\Users\\[REDACTED]');
+        result = result.replace(new RegExp(`/home/${escapeRegex(username)}`, 'gi'), '/home/[REDACTED]');
+    }
+    return result;
+}
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** Redact sensitive patterns from a string */
+function redactSensitive(text) {
+    let result = text;
+    for (const pattern of SENSITIVE_PATTERNS) {
+        result = result.replace(pattern, '[REDACTED]');
+    }
+    return redactPaths(result);
+}
+/** Redact a step entry — strips typed text, clipboard, actionParams with sensitive data */
+function redactStep(raw) {
+    const step = {
+        stepIndex: raw.stepIndex ?? 0,
+        timestamp: raw.timestamp ?? '',
+        layer: raw.layer ?? '',
+        actionType: raw.actionType ?? '',
+        result: raw.result ?? '',
+    };
+    if (raw.durationMs !== undefined)
+        step.durationMs = raw.durationMs;
+    if (raw.error)
+        step.error = redactSensitive(String(raw.error));
+    if (raw.verification) {
+        const v = raw.verification;
+        step.verification = {
+            method: v.method ?? 'unknown',
+            verified: v.verified ?? false,
+        };
+    }
+    // Deliberately omit: actionParams (may contain typed text, selectors with user data),
+    // llmReasoning (may reference user content), uiStateSummary (may contain screen text)
+    return step;
+}
+// ─── Report Building ────────────────────────────────────────
+/** Read and parse a task log JSONL file */
+function readTaskLog(logPath) {
+    try {
+        const content = fs.readFileSync(logPath, 'utf-8');
+        return content.trim().split('\n').map(line => {
+            try {
+                return JSON.parse(line);
+            }
+            catch {
+                return null;
+            }
+        }).filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+/** Get the most recent task log file path */
+function getMostRecentLog() {
+    try {
+        const files = fs.readdirSync(LOG_DIR)
+            .filter(f => f.endsWith('.jsonl'))
+            .sort()
+            .reverse();
+        if (files.length === 0)
+            return null;
+        return path.join(LOG_DIR, files[0]);
+    }
+    catch {
+        return null;
+    }
+}
+/** Get N most recent log files */
+function getRecentLogs(count) {
+    try {
+        return fs.readdirSync(LOG_DIR)
+            .filter(f => f.endsWith('.jsonl'))
+            .sort()
+            .reverse()
+            .slice(0, count)
+            .map(f => path.join(LOG_DIR, f));
+    }
+    catch {
+        return [];
+    }
+}
+/** Build a report from a task log */
+function buildReport(logPath, userNote) {
+    const targetPath = logPath || getMostRecentLog();
+    const entries = targetPath ? readTaskLog(targetPath) : [];
+    // Separate summary from steps
+    const summary = entries.find(e => e._type === 'task_summary');
+    const steps = entries.filter(e => e._type !== 'task_summary');
+    const reportId = `rpt_${Date.now().toString(36)}_${Math.random().toString(36).substring(2, 6)}`;
+    const report = {
+        reportId,
+        timestamp: new Date().toISOString(),
+        version: (0, version_1.getVersion)(),
+        system: {
+            platform: process.platform,
+            arch: process.arch,
+            nodeVersion: process.version,
+            osRelease: os.release(),
+        },
+        steps: steps.map(redactStep),
+    };
+    if (summary) {
+        report.task = {
+            description: redactSensitive(String(summary.task || '')),
+            status: String(summary.status || 'unknown'),
+            totalSteps: summary.totalSteps ?? 0,
+            durationMs: summary.durationMs ?? 0,
+            layersUsed: summary.layersUsed ?? [],
+            llmCallCount: summary.llmCallCount ?? 0,
+        };
+    }
+    if (userNote) {
+        report.userNote = userNote;
+    }
+    // Check if the last step had an error
+    const lastStep = steps[steps.length - 1];
+    if (lastStep?.error) {
+        report.errorContext = redactSensitive(String(lastStep.error));
+    }
+    return report;
+}
+// ─── Submission ─────────────────────────────────────────────
+/** Submit a report to the backend */
+async function submitReport(report) {
+    try {
+        const resp = await fetch(REPORT_ENDPOINT, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(report),
+            signal: AbortSignal.timeout(15000),
+        });
+        if (resp.ok) {
+            const data = await resp.json().catch(() => ({}));
+            return { success: true, reportId: data.reportId ?? report.reportId };
+        }
+        return { success: false, reportId: report.reportId, error: `Server responded ${resp.status}` };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Network error';
+        return { success: false, reportId: report.reportId, error: message };
+    }
+}
+/** Save report locally (fallback if network fails) */
+function saveReportLocally(report) {
+    const reportDir = paths_1.REPORTS_DIR;
+    fs.mkdirSync(reportDir, { recursive: true });
+    const filePath = path.join(reportDir, `${report.reportId}.json`);
+    fs.writeFileSync(filePath, JSON.stringify(report, null, 2));
+    return filePath;
+}
+// ─── Interactive CLI ────────────────────────────────────────
+/** Interactive report flow — shows what will be sent, asks for confirmation */
+async function interactiveReport() {
+    const logPath = getMostRecentLog();
+    if (!logPath) {
+        console.log('\n  No task logs found. Run a task first, then try again.\n');
+        return;
+    }
+    const logName = path.basename(logPath);
+    console.log(`\n  Most recent task log: ${logName}`);
+    // Show available logs
+    const recentLogs = getRecentLogs(5);
+    if (recentLogs.length > 1) {
+        console.log('\n  Recent logs:');
+        recentLogs.forEach((l, i) => {
+            const entries = readTaskLog(l);
+            const summary = entries.find(e => e._type === 'task_summary');
+            const task = summary?.task ? redactSensitive(String(summary.task)).substring(0, 60) : '(no summary)';
+            const status = summary?.status ?? 'unknown';
+            const marker = i === 0 ? ' [latest]' : '';
+            console.log(`    ${i + 1}. ${path.basename(l)} — ${status} — "${task}"${marker}`);
+        });
+    }
+    // Build the report
+    const report = buildReport(logPath);
+    // Show preview
+    console.log('\n  ── Report Preview ──────────────────────────────');
+    console.log(`  Report ID:  ${report.reportId}`);
+    console.log(`  Version:    ${report.version}`);
+    console.log(`  Platform:   ${report.system.platform}/${report.system.arch}`);
+    console.log(`  Node:       ${report.system.nodeVersion}`);
+    if (report.task) {
+        console.log(`  Task:       "${report.task.description}"`);
+        console.log(`  Status:     ${report.task.status}`);
+        console.log(`  Steps:      ${report.task.totalSteps}`);
+        console.log(`  Duration:   ${(report.task.durationMs / 1000).toFixed(1)}s`);
+        console.log(`  LLM Calls:  ${report.task.llmCallCount}`);
+    }
+    console.log(`  Step data:  ${report.steps.length} entries (redacted)`);
+    if (report.errorContext) {
+        console.log(`  Error:      ${report.errorContext}`);
+    }
+    console.log('  ────────────────────────────────────────────────');
+    console.log('\n  Privacy: No typed text, clipboard data, screenshots,');
+    console.log('  or personal file paths are included.');
+    // Ask for optional note
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const note = await new Promise((resolve) => {
+        rl.question('\n  Add a note (optional, press Enter to skip): ', resolve);
+    });
+    if (note.trim()) {
+        report.userNote = note.trim();
+    }
+    // Confirm
+    const confirm = await new Promise((resolve) => {
+        rl.question('  Send this report? (y/N) ', resolve);
+    });
+    rl.close();
+    if (confirm.toLowerCase() !== 'y' && confirm.toLowerCase() !== 'yes') {
+        // Save locally as fallback
+        const savedPath = saveReportLocally(report);
+        console.log(`\n  Report saved locally: ${savedPath}`);
+        console.log('  You can manually share this file if needed.\n');
+        return;
+    }
+    // Submit
+    console.log('\n  Sending report...');
+    const result = await submitReport(report);
+    if (result.success) {
+        console.log(`  Report sent. ID: ${result.reportId}`);
+        console.log('  Thank you — this helps us make clawdcursor better.\n');
+    }
+    else {
+        // Save locally on failure
+        const savedPath = saveReportLocally(report);
+        console.log(`  Failed to send: ${result.error}`);
+        console.log(`  Report saved locally: ${savedPath}`);
+        console.log('  You can manually share this file if needed.\n');
+    }
+}
+// ─── Server API Helpers ─────────────────────────────────────
+/** Build and submit a report programmatically (for REST API) */
+async function apiSubmitReport(opts) {
+    let targetPath = opts.logPath;
+    if (!targetPath && opts.logIndex !== undefined) {
+        const logs = getRecentLogs(opts.logIndex + 1);
+        targetPath = logs[opts.logIndex];
+    }
+    if (!targetPath) {
+        targetPath = getMostRecentLog() ?? undefined;
+    }
+    if (!targetPath) {
+        return { success: false, reportId: '', error: 'No task logs found' };
+    }
+    const report = buildReport(targetPath, opts.userNote);
+    const result = await submitReport(report);
+    if (!result.success) {
+        saveReportLocally(report);
+    }
+    return { ...result, preview: report };
+}
+//# sourceMappingURL=report.js.map

package/dist/surface/report.js.map

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

package/dist/surface/skill-register.d.ts

@@ -0,0 +1,14 @@
+export interface SkillRegResult {
+    name: string;
+    ok: boolean;
+    detail: string;
+}
+export interface SkillRegSummary {
+    registered: number;
+    results: SkillRegResult[];
+}
+/**
+ * Register clawdcursor as a skill in every detected agent framework.
+ * Returns per-host results + how many registries got it.
+ */
+export declare function registerSkills(folderName?: string): SkillRegSummary;

package/dist/surface/skill-register.js

@@ -0,0 +1,150 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSkills = registerSkills;
+/**
+ * Cross-framework skill registration.
+ *
+ * clawdcursor exposes the SAME capability two ways: an MCP server (typed tools)
+ * and a Skill (SKILL.md — the "how to use me" knowledge: fallback positioning,
+ * the el_NN UI map, sustainable/autonomous execution via the daemon + `task`).
+ * An agent that only gets the MCP tools has the hands but not the playbook.
+ *
+ * This used to run ONLY inside `clawdcursor doctor`. But doctor configures the
+ * autonomous daemon, and the MCP-first onboarding explicitly tells people to
+ * skip it — so MCP-direct users never registered the skill, and clawdcursor
+ * showed up as bare MCP tools with none of the guidance. Pulling it out here
+ * lets `consent` (always required) and `clawdcursor register-skill` install the
+ * skill into EVERY detected agent framework, regardless of install path.
+ *
+ * Best-effort and non-invasive: only writes into a framework's skills directory
+ * if that directory already exists (never creates host config the user doesn't
+ * have), and symlinks the package root so SKILL.md's referenced paths (scripts/,
+ * etc.) resolve — falling back to a plain SKILL.md copy when symlinks are blocked.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const paths_1 = require("../paths");
+/** Agent frameworks that expose a skills registry, and where it lives. */
+function hostRegistries(homeDir) {
+    return [
+        // Claude Code — ~/.claude/skills/<name>/SKILL.md (Skill tool + /<skill>).
+        ['Claude Code', path.join(homeDir, '.claude', 'skills')],
+        // OpenClaw — the original target. Both the workspace and flat layouts.
+        ['OpenClaw', path.join(homeDir, '.openclaw', 'workspace', 'skills')],
+        ['OpenClaw (dev)', path.join(homeDir, '.openclaw-dev', 'workspace', 'skills')],
+        ['OpenClaw (flat)', path.join(homeDir, '.openclaw', 'skills')],
+        // Codex — ~/.codex/skills.
+        ['Codex', path.join(homeDir, '.codex', 'skills')],
+        // Cursor — ~/.cursor/skills (only if the user's Cursor has skills enabled).
+        ['Cursor', path.join(homeDir, '.cursor', 'skills')],
+    ];
+}
+/**
+ * Register clawdcursor as a skill in every detected agent framework.
+ * Returns per-host results + how many registries got it.
+ */
+function registerSkills(folderName = 'clawdcursor') {
+    const results = [];
+    const homeDir = process.env.HOME || process.env.USERPROFILE || '';
+    if (!homeDir)
+        return { registered: 0, results };
+    const clawdCursorRoot = (0, paths_1.getPackageRoot)();
+    const skillSource = path.join(clawdCursorRoot, 'SKILL.md');
+    if (!fs.existsSync(skillSource)) {
+        results.push({ name: 'Skill registration', ok: false, detail: 'SKILL.md not found at package root' });
+        return { registered: 0, results };
+    }
+    let registered = 0;
+    for (const [name, skillsDir] of hostRegistries(homeDir)) {
+        if (!fs.existsSync(skillsDir))
+            continue; // framework not installed → skip silently
+        const skillTarget = path.join(skillsDir, folderName);
+        const targetSkillFile = path.join(skillTarget, 'SKILL.md');
+        // Already present → refresh the SKILL.md if ours is newer (so an upgrade
+        // propagates new guidance), otherwise leave it.
+        if (fs.existsSync(skillTarget)) {
+            try {
+                if (fs.existsSync(targetSkillFile)) {
+                    const srcMtime = fs.statSync(skillSource).mtimeMs;
+                    const dstMtime = fs.statSync(targetSkillFile).mtimeMs;
+                    if (srcMtime > dstMtime) {
+                        fs.copyFileSync(skillSource, targetSkillFile);
+                        results.push({ name: `${name} skill`, ok: true, detail: 'Refreshed (SKILL.md updated)' });
+                    }
+                    else {
+                        results.push({ name: `${name} skill`, ok: true, detail: 'Registered (up to date)' });
+                    }
+                }
+                else {
+                    fs.copyFileSync(skillSource, targetSkillFile);
+                    results.push({ name: `${name} skill`, ok: true, detail: 'Registered (SKILL.md copied)' });
+                }
+                registered++;
+            }
+            catch {
+                // best-effort
+            }
+            continue;
+        }
+        // Fresh: symlink the whole package root (keeps SKILL.md's relative paths
+        // valid); fall back to a SKILL.md copy if symlinks are blocked.
+        try {
+            fs.symlinkSync(clawdCursorRoot, skillTarget, process.platform === 'win32' ? 'junction' : 'dir');
+            results.push({ name: `${name} skill`, ok: true, detail: 'Registered (symlink)' });
+            registered++;
+        }
+        catch {
+            try {
+                fs.mkdirSync(skillTarget, { recursive: true });
+                fs.copyFileSync(skillSource, targetSkillFile);
+                results.push({ name: `${name} skill`, ok: true, detail: 'Registered (SKILL.md copied)' });
+                registered++;
+            }
+            catch {
+                // non-critical
+            }
+        }
+    }
+    if (registered === 0) {
+        results.push({
+            name: 'Skill registration',
+            ok: true,
+            detail: 'No host registry found (Claude Code, OpenClaw, Codex, Cursor) — clawdcursor still works standalone via MCP',
+        });
+    }
+    return { registered, results };
+}
+//# sourceMappingURL=skill-register.js.map

package/dist/surface/skill-register.js.map

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

package/dist/surface/version.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Version utilities.
+ * Reads package.json at runtime so CLI + API stay in sync.
+ */
+export declare function getVersion(): string;
+export declare const VERSION: string;

package/dist/surface/version.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Version utilities.
+ * Reads package.json at runtime so CLI + API stay in sync.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = void 0;
+exports.getVersion = getVersion;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const paths_1 = require("../paths");
+let cachedVersion = null;
+function getVersion() {
+    if (cachedVersion)
+        return cachedVersion;
+    try {
+        const pkgPath = (0, path_1.join)((0, paths_1.getPackageRoot)(), 'package.json');
+        const pkg = JSON.parse((0, fs_1.readFileSync)(pkgPath, 'utf-8'));
+        cachedVersion = pkg.version || '0.0.0';
+    }
+    catch {
+        cachedVersion = '0.0.0';
+    }
+    return cachedVersion;
+}
+exports.VERSION = getVersion();
+//# sourceMappingURL=version.js.map

package/dist/surface/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/surface/version.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAQH,gCAUC;AAhBD,2BAAkC;AAClC,+BAA4B;AAC5B,oCAA0C;AAE1C,IAAI,aAAa,GAAkB,IAAI,CAAC;AAExC,SAAgB,UAAU;IACxB,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAA,WAAI,EAAC,IAAA,sBAAc,GAAE,EAAE,cAAc,CAAC,CAAC;QACvD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,OAAO,EAAE,OAAO,CAAC,CAAyB,CAAC;QAC/E,aAAa,GAAG,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,aAAa,GAAG,OAAO,CAAC;IAC1B,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAEY,QAAA,OAAO,GAAG,UAAU,EAAE,CAAC"}

package/dist/tools/a11y.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Accessibility & window management tools.
+ *
+ * Text-first strategy: always try read_screen before desktop_screenshot.
+ * Provides structured perception of the desktop without vision models.
+ */
+import type { ToolDefinition } from './types';
+export declare function getA11yTools(): ToolDefinition[];