@mseep/clawdcursor 1.5.5

package/dist/core/decompose/parser.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * Offline task decomposer — regex + quote-aware compound split.
+ *
+ * Ported from src/local-parser.ts. Zero LLM calls, zero dependencies. Returns
+ * the task split into subtask strings, or null when the task is too ambiguous
+ * to split safely (caller falls back to the LLM decomposer).
+ *
+ * v0.6.3 product knowledge preserved:
+ *   - The `actionVerb` validator is the guard against dangerous splits like
+ *     "scroll through and read" where one half lacks a terminal condition and
+ *     would infinite-loop the text-agent.
+ *   - Quote-aware splitter so "send 'hello, world' to Bob" isn't broken.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.splitCompound = splitCompound;
+exports.decompose = decompose;
+const ACTION_VERB = /^(open|close|click|tap|type|press|save|go|navigate|visit|search|find|create|delete|write|send|copy|paste|select|drag|scroll(\s+up|\s+down)?(\s+and)?|download|upload|install|run|set|change|turn|enable|disable|check|uncheck|fill|submit|compose|reply|forward|focus|switch|minimize|maximize|summarize|read|extract|draw|paint|sketch|resize|compute|calculate|add|subtract|multiply|divide|highlight|describe|enter|show|display|play|pause|stop|start|restart|refresh|reload|zoom|expand|collapse|rename|move|sort|filter|attach|insert|remove|undo|redo|cut)\b/i;
+/**
+ * Split a compound task on ` and `, ` then `, or `,` — quote-aware.
+ */
+function splitCompound(task) {
+    const parts = [];
+    let current = '';
+    let inQuotes = false;
+    let quoteChar = '';
+    const len = task.length;
+    for (let i = 0; i < len;) {
+        const ch = task[i];
+        if ((ch === '"' || ch === "'") && !inQuotes) {
+            inQuotes = true;
+            quoteChar = ch;
+            current += ch;
+            i++;
+            continue;
+        }
+        if (ch === quoteChar && inQuotes) {
+            inQuotes = false;
+            quoteChar = '';
+            current += ch;
+            i++;
+            continue;
+        }
+        if (inQuotes) {
+            current += ch;
+            i++;
+            continue;
+        }
+        const rest = task.slice(i).toLowerCase();
+        if (rest.startsWith(' and ')) {
+            if (current.trim())
+                parts.push(current.trim());
+            current = '';
+            i += 5;
+            continue;
+        }
+        if (rest.startsWith(' then ')) {
+            if (current.trim())
+                parts.push(current.trim());
+            current = '';
+            i += 6;
+            continue;
+        }
+        if (ch === ',') {
+            if (current.trim())
+                parts.push(current.trim());
+            current = '';
+            i++;
+            continue;
+        }
+        current += ch;
+        i++;
+    }
+    if (current.trim())
+        parts.push(current.trim());
+    return parts;
+}
+/**
+ * Decompose a task. Null → ambiguous, caller escalates to LLM decomposer.
+ */
+function decompose(task) {
+    if (!task || typeof task !== 'string')
+        return null;
+    const trimmed = task.trim();
+    if (trimmed.length === 0)
+        return null;
+    const parts = splitCompound(trimmed);
+    if (parts.length > 1) {
+        const filtered = parts.map(p => p.trim()).filter(p => p.length > 0);
+        // Guard: every subtask must start with a real action verb — otherwise
+        // keep as one task. This prevents the "scroll through" infinite-loop bug.
+        const allHaveVerbs = filtered.every(p => ACTION_VERB.test(p));
+        if (allHaveVerbs)
+            return { subtasks: filtered, keptAsOne: false };
+        // Deliberately kept as one unit — caller should run the whole thing
+        // through the text-agent as-is, not escalate to LLM decomposer.
+        return { subtasks: [trimmed], keptAsOne: true };
+    }
+    return { subtasks: [trimmed], keptAsOne: false };
+}
+//# sourceMappingURL=parser.js.map

package/dist/core/decompose/parser.js.map

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

package/dist/core/observability/correlation.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Correlation IDs — each /task or CLI invocation generates a UUID, and every
+ * log line / trace event from that task carries it. Surface in /status so
+ * users can grep logs by ID for debugging.
+ *
+ * Uses Node's built-in AsyncLocalStorage so a correlation ID set at the top of
+ * Pipeline.run() flows to every awaited call inside, without threading it
+ * through every function signature.
+ */
+interface Context {
+    correlationId: string;
+    taskText?: string;
+    startedAt: number;
+}
+export declare function newCorrelationId(): string;
+export declare function runWithCorrelation<T>(ctx: Pick<Context, 'correlationId' | 'taskText'>, fn: () => Promise<T> | T): Promise<T> | T;
+export declare function getCorrelationId(): string | undefined;
+export declare function getContext(): Context | undefined;
+export {};

package/dist/core/observability/correlation.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * Correlation IDs — each /task or CLI invocation generates a UUID, and every
+ * log line / trace event from that task carries it. Surface in /status so
+ * users can grep logs by ID for debugging.
+ *
+ * Uses Node's built-in AsyncLocalStorage so a correlation ID set at the top of
+ * Pipeline.run() flows to every awaited call inside, without threading it
+ * through every function signature.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.newCorrelationId = newCorrelationId;
+exports.runWithCorrelation = runWithCorrelation;
+exports.getCorrelationId = getCorrelationId;
+exports.getContext = getContext;
+const node_async_hooks_1 = require("node:async_hooks");
+const node_crypto_1 = require("node:crypto");
+const storage = new node_async_hooks_1.AsyncLocalStorage();
+function newCorrelationId() {
+    return (0, node_crypto_1.randomUUID)();
+}
+function runWithCorrelation(ctx, fn) {
+    const full = {
+        correlationId: ctx.correlationId,
+        taskText: ctx.taskText,
+        startedAt: Date.now(),
+    };
+    return storage.run(full, fn);
+}
+function getCorrelationId() {
+    return storage.getStore()?.correlationId;
+}
+function getContext() {
+    return storage.getStore();
+}
+//# sourceMappingURL=correlation.js.map

package/dist/core/observability/correlation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation.js","sourceRoot":"","sources":["../../../src/core/observability/correlation.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAaH,4CAEC;AAED,gDAUC;AAED,4CAEC;AAED,gCAEC;AAjCD,uDAAqD;AACrD,6CAAyC;AAQzC,MAAM,OAAO,GAAG,IAAI,oCAAiB,EAAW,CAAC;AAEjD,SAAgB,gBAAgB;IAC9B,OAAO,IAAA,wBAAU,GAAE,CAAC;AACtB,CAAC;AAED,SAAgB,kBAAkB,CAChC,GAAgD,EAChD,EAAwB;IAExB,MAAM,IAAI,GAAY;QACpB,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;IACF,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,SAAgB,gBAAgB;IAC9B,OAAO,OAAO,CAAC,QAAQ,EAAE,EAAE,aAAa,CAAC;AAC3C,CAAC;AAED,SAAgB,UAAU;IACxB,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;AAC5B,CAAC"}

package/dist/core/observability/cost-meter.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Per-task cost meter — model-agnostic.
+ *
+ * Tracks tokens in/out per model, plus non-LLM costs (OCR calls, screenshot
+ * bytes) if we want to surface those later. Converts to USD via a static
+ * price table that is overrideable at runtime.
+ *
+ * Why this exists: the product claim is "cost-aware — picks the cheapest path
+ * that works." The audit showed we had no way to prove it. The cost meter
+ * makes blind-first savings visible in /task responses and in a new
+ * `clawdcursor cost` CLI.
+ *
+ * Price table is loaded from:
+ *   1. ~/.clawdcursor/pricing.json (user override; precedence)
+ *   2. src/core/observability/pricing.default.json (bundled defaults)
+ *
+ * Unknown models fall back to { inputPerM: 1.0, outputPerM: 5.0 } — a safe
+ * ballpark that won't silently report $0 for unmapped models.
+ */
+export interface ModelPrice {
+    /** USD per 1M input tokens. */
+    inputPerM: number;
+    /** USD per 1M output tokens. */
+    outputPerM: number;
+}
+export declare function priceFor(model: string): ModelPrice;
+export interface CostEvent {
+    model: string;
+    /** Where in the pipeline this cost was incurred. Kept wide enough to cover
+     *  router-free stages (classify / decompose) and every unified-agent mode. */
+    stage: 'classify' | 'decompose' | 'decomposer-fallback' | 'text-agent' | 'vision-agent' | 'blind' | 'hybrid' | 'vision';
+    inputTokens: number;
+    outputTokens: number;
+}
+export interface CostSnapshot {
+    totalUsd: number;
+    byModel: Record<string, {
+        inputTokens: number;
+        outputTokens: number;
+        usd: number;
+    }>;
+    byStage: Record<string, {
+        usd: number;
+        calls: number;
+    }>;
+}
+export declare class CostMeter {
+    private events;
+    record(e: CostEvent): void;
+    snapshot(): CostSnapshot;
+}

package/dist/core/observability/cost-meter.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * Per-task cost meter — model-agnostic.
+ *
+ * Tracks tokens in/out per model, plus non-LLM costs (OCR calls, screenshot
+ * bytes) if we want to surface those later. Converts to USD via a static
+ * price table that is overrideable at runtime.
+ *
+ * Why this exists: the product claim is "cost-aware — picks the cheapest path
+ * that works." The audit showed we had no way to prove it. The cost meter
+ * makes blind-first savings visible in /task responses and in a new
+ * `clawdcursor cost` CLI.
+ *
+ * Price table is loaded from:
+ *   1. ~/.clawdcursor/pricing.json (user override; precedence)
+ *   2. src/core/observability/pricing.default.json (bundled defaults)
+ *
+ * Unknown models fall back to { inputPerM: 1.0, outputPerM: 5.0 } — a safe
+ * ballpark that won't silently report $0 for unmapped models.
+ */
+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.CostMeter = void 0;
+exports.priceFor = priceFor;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const FALLBACK_PRICE = { inputPerM: 1.0, outputPerM: 5.0 };
+// Published list prices as of plan-time. User can override per provider/model
+// via ~/.clawdcursor/pricing.json without code changes.
+const DEFAULT_PRICES = {
+    // Anthropic (approximate public list prices)
+    'claude-haiku-4-5': { inputPerM: 1.0, outputPerM: 5.0 },
+    'claude-sonnet-4-20250514': { inputPerM: 3.0, outputPerM: 15.0 },
+    'claude-opus-4': { inputPerM: 15.0, outputPerM: 75.0 },
+    'claude-opus-4-6': { inputPerM: 15.0, outputPerM: 75.0 },
+    // OpenAI
+    'gpt-4o-mini': { inputPerM: 0.15, outputPerM: 0.60 },
+    'gpt-4o': { inputPerM: 2.5, outputPerM: 10.0 },
+    // Ollama / local — zero by construction
+    'llama3.2': { inputPerM: 0.0, outputPerM: 0.0 },
+    'qwen2.5:7b': { inputPerM: 0.0, outputPerM: 0.0 },
+    // Groq
+    'llama-3.3-70b-versatile': { inputPerM: 0.59, outputPerM: 0.79 },
+    // Kimi / Moonshot
+    'moonshot-v1-8k': { inputPerM: 0.15, outputPerM: 2.0 },
+};
+let loadedPrices = null;
+function loadPrices() {
+    if (loadedPrices)
+        return loadedPrices;
+    const override = path.join(os.homedir(), '.clawdcursor', 'pricing.json');
+    let merged = { ...DEFAULT_PRICES };
+    try {
+        if (fs.existsSync(override)) {
+            const parsed = JSON.parse(fs.readFileSync(override, 'utf8'));
+            merged = { ...merged, ...parsed };
+        }
+    }
+    catch {
+        // Bad override file — log would be nice, but cost-meter must stay silent.
+    }
+    loadedPrices = merged;
+    return loadedPrices;
+}
+function priceFor(model) {
+    const table = loadPrices();
+    // Exact match first, then provider-prefix match (e.g. "claude-sonnet-4-*").
+    if (table[model])
+        return table[model];
+    for (const key of Object.keys(table)) {
+        if (model.startsWith(key))
+            return table[key];
+    }
+    return FALLBACK_PRICE;
+}
+class CostMeter {
+    events = [];
+    record(e) {
+        this.events.push(e);
+    }
+    snapshot() {
+        const byModel = {};
+        const byStage = {};
+        let total = 0;
+        for (const e of this.events) {
+            const p = priceFor(e.model);
+            const usd = (e.inputTokens / 1_000_000) * p.inputPerM + (e.outputTokens / 1_000_000) * p.outputPerM;
+            total += usd;
+            const m = byModel[e.model] ??= { inputTokens: 0, outputTokens: 0, usd: 0 };
+            m.inputTokens += e.inputTokens;
+            m.outputTokens += e.outputTokens;
+            m.usd += usd;
+            const s = byStage[e.stage] ??= { usd: 0, calls: 0 };
+            s.usd += usd;
+            s.calls += 1;
+        }
+        return { totalUsd: total, byModel, byStage };
+    }
+}
+exports.CostMeter = CostMeter;
+//# sourceMappingURL=cost-meter.js.map

package/dist/core/observability/cost-meter.js.map

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

package/dist/core/observability/logger.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Leveled logger with TTY pretty-print + JSON file log.
+ *
+ * Two output surfaces:
+ *
+ *   1. JSON file log (stable machine-readable contract) — one
+ *      `{ts, level, msg, meta}` line per event, rotated at 10 MB, 5 backups,
+ *      never changes format between releases. Greppable, tailable.
+ *
+ *   2. TTY pretty-print (the default when stderr is a TTY) — layer-tagged,
+ *      color-coded, one visual block per meaningful event. Redundant events
+ *      (`safety.decision=allow`, `agent.turn.end`) are suppressed. Correlation
+ *      ID + task + model lineup are printed ONCE in a header, not repeated on
+ *      every line.
+ *
+ *      The format is designed so the reader sees "router doing X", "blind
+ *      agent turn 3 thinking Y, calling tool Z", "vision fallback turn 5"
+ *      at a glance — every line carries its LAYER, so there is never
+ *      ambiguity about which part of the pipeline is running.
+ *
+ *      `CLAWD_LOG=json` disables pretty-print (useful for piping to a file
+ *      or CI). `CLAWD_NO_COLOR=1` / `NO_COLOR=1` keeps pretty-print but
+ *      without ANSI colors.
+ */
+export declare const EVENTS: {
+    readonly PIPELINE_START: "pipeline.start";
+    readonly PIPELINE_PREPROCESS: "pipeline.preprocess";
+    readonly PIPELINE_SUBTASK: "pipeline.subtask";
+    readonly PIPELINE_RUNG: "pipeline.rung";
+    readonly PIPELINE_DONE: "pipeline.done";
+    readonly AGENT_TURN_START: "agent.turn.start";
+    readonly AGENT_THINK: "agent.think";
+    readonly AGENT_TOOL_CALL: "agent.tool.call";
+    readonly AGENT_TOOL_RESULT: "agent.tool.result";
+    readonly AGENT_TURN_END: "agent.turn.end";
+    readonly AGENT_STAGNATION: "agent.stagnation";
+    readonly ADAPTER_CALL: "adapter.call";
+};
+/**
+ * Begin a nested span. Currently a no-op on pretty format (indentation is
+ * baked into per-event rendering); kept for API compatibility with callers
+ * that wrap turns / playbook steps in spans.
+ */
+export declare function beginSpan(): {
+    end: () => void;
+};
+export declare const logger: {
+    debug: (msg: string, meta?: Record<string, unknown>) => void;
+    info: (msg: string, meta?: Record<string, unknown>) => void;
+    warn: (msg: string, meta?: Record<string, unknown>) => void;
+    error: (msg: string, meta?: Record<string, unknown>) => void;
+    /** Child logger bound to a correlation ID — inlined into every JSON record's meta. */
+    with: (extra: Record<string, unknown>) => {
+        debug: (msg: string, meta?: Record<string, unknown>) => void;
+        info: (msg: string, meta?: Record<string, unknown>) => void;
+        warn: (msg: string, meta?: Record<string, unknown>) => void;
+        error: (msg: string, meta?: Record<string, unknown>) => void;
+    };
+    span: typeof beginSpan;
+};
+export type Logger = typeof logger;