exempclaw 0.4.0

package/dist/core/errors.js

@@ -0,0 +1,40 @@
+/**
+ * Typed error hierarchy. Every thrown error in Exempclaw should be (or extend)
+ * an ExempclawError so the runtime can distinguish recoverable failures
+ * (rate limits, connector outages) from programming errors.
+ */
+export class ExempclawError extends Error {
+    /** Whether retrying the same operation could plausibly succeed. */
+    retryable;
+    constructor(message, options = {}) {
+        super(message, options.cause !== undefined ? { cause: options.cause } : undefined);
+        this.name = this.constructor.name;
+        this.retryable = options.retryable ?? false;
+    }
+}
+/** A required config value was missing or malformed. */
+export class ConfigError extends ExempclawError {
+}
+/** A connector (email, Slack, …) failed to reach its upstream service. */
+export class ConnectorError extends ExempclawError {
+    connector;
+    constructor(connector, message, options = {}) {
+        super(`[${connector}] ${message}`, options);
+        this.connector = connector;
+    }
+}
+/** A tool threw while executing. Carried back into the agent loop as a tool_result error. */
+export class ToolExecutionError extends ExempclawError {
+    tool;
+    constructor(tool, message, options = {}) {
+        super(`tool "${tool}" failed: ${message}`, options);
+        this.tool = tool;
+    }
+}
+/** A human (or policy) denied an outward action. Not an error condition the model can retry. */
+export class ActionDeniedError extends ExempclawError {
+    constructor(message) {
+        super(message, { retryable: false });
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,mEAAmE;IAC1D,SAAS,CAAU;IAE5B,YAAY,OAAe,EAAE,UAAoD,EAAE;QACjF,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACnF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;IAC9C,CAAC;CACF;AAED,wDAAwD;AACxD,MAAM,OAAO,WAAY,SAAQ,cAAc;CAAG;AAElD,0EAA0E;AAC1E,MAAM,OAAO,cAAe,SAAQ,cAAc;IACvC,SAAS,CAAS;IAC3B,YAAY,SAAiB,EAAE,OAAe,EAAE,UAAoD,EAAE;QACpG,KAAK,CAAC,IAAI,SAAS,KAAK,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED,6FAA6F;AAC7F,MAAM,OAAO,kBAAmB,SAAQ,cAAc;IAC3C,IAAI,CAAS;IACtB,YAAY,IAAY,EAAE,OAAe,EAAE,UAAoD,EAAE;QAC/F,KAAK,CAAC,SAAS,IAAI,aAAa,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,gGAAgG;AAChG,MAAM,OAAO,iBAAkB,SAAQ,cAAc;IACnD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/core/logger.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Tiny structured logger. No external dependency so the foundation stays
+ * install-light; swap for pino/winston later behind the same interface.
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export interface Logger {
+    debug(msg: string, fields?: Record<string, unknown>): void;
+    info(msg: string, fields?: Record<string, unknown>): void;
+    warn(msg: string, fields?: Record<string, unknown>): void;
+    error(msg: string, fields?: Record<string, unknown>): void;
+    /** Returns a child logger that prefixes every line with these bound fields. */
+    child(bindings: Record<string, unknown>): Logger;
+}
+export declare function createLogger(level?: LogLevel): Logger;

package/dist/core/logger.js

@@ -0,0 +1,44 @@
+/**
+ * Tiny structured logger. No external dependency so the foundation stays
+ * install-light; swap for pino/winston later behind the same interface.
+ */
+const LEVEL_ORDER = { debug: 10, info: 20, warn: 30, error: 40 };
+const COLORS = {
+    debug: "\x1b[90m", // grey
+    info: "\x1b[36m", // cyan
+    warn: "\x1b[33m", // yellow
+    error: "\x1b[31m", // red
+};
+const RESET = "\x1b[0m";
+class ConsoleLogger {
+    threshold;
+    bindings;
+    constructor(threshold, bindings = {}) {
+        this.threshold = threshold;
+        this.bindings = bindings;
+    }
+    write(level, msg, fields) {
+        if (LEVEL_ORDER[level] < LEVEL_ORDER[this.threshold])
+            return;
+        const merged = { ...this.bindings, ...fields };
+        const scope = typeof merged.scope === "string" ? ` (${merged.scope})` : "";
+        const extra = Object.entries(merged)
+            .filter(([k]) => k !== "scope")
+            .map(([k, v]) => `${k}=${typeof v === "string" ? v : JSON.stringify(v)}`)
+            .join(" ");
+        const ts = new Date().toISOString();
+        const tag = `${COLORS[level]}${level.toUpperCase().padEnd(5)}${RESET}`;
+        process.stderr.write(`${ts} ${tag}${scope} ${msg}${extra ? ` ${extra}` : ""}\n`);
+    }
+    debug(msg, fields) { this.write("debug", msg, fields); }
+    info(msg, fields) { this.write("info", msg, fields); }
+    warn(msg, fields) { this.write("warn", msg, fields); }
+    error(msg, fields) { this.write("error", msg, fields); }
+    child(bindings) {
+        return new ConsoleLogger(this.threshold, { ...this.bindings, ...bindings });
+    }
+}
+export function createLogger(level = "info") {
+    return new ConsoleLogger(level);
+}
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

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

package/dist/core/run-log.d.ts

@@ -0,0 +1,37 @@
+import type { UsageTotals } from "./usage.js";
+/**
+ * Append-only audit trail of agent runs. One JSONL file per agent under
+ * <dataDir>/agents/<id>/runs.jsonl. This is the substrate for the `costs`
+ * command and for answering "what did this agent do, and who approved it".
+ */
+export type TriggerKind = "cli" | "chat" | "event" | "schedule" | "ingest";
+export interface OutwardActionRecord {
+    tool: string;
+    approved: boolean;
+    summary: string;
+    at: string;
+}
+export interface RunRecord {
+    runId: string;
+    agentId: string;
+    trigger: {
+        kind: TriggerKind;
+        detail?: string;
+    };
+    startedAt: string;
+    finishedAt: string;
+    model: string;
+    iterations: number;
+    stopReason: string | null;
+    usage: UsageTotals;
+    costUsd: number | null;
+    outwardActions: OutwardActionRecord[];
+    error?: string;
+}
+export declare class RunLog {
+    private readonly path;
+    constructor(dataDir: string, agentId: string);
+    append(record: RunRecord): Promise<void>;
+    /** Reads every record, skipping lines that fail to parse (torn writes). */
+    readAll(): Promise<RunRecord[]>;
+}

package/dist/core/run-log.js

@@ -0,0 +1,37 @@
+import { appendFile, mkdir, readFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+export class RunLog {
+    path;
+    constructor(dataDir, agentId) {
+        this.path = join(dataDir, "agents", agentId, "runs.jsonl");
+    }
+    async append(record) {
+        await mkdir(dirname(this.path), { recursive: true });
+        await appendFile(this.path, `${JSON.stringify(record)}\n`, "utf8");
+    }
+    /** Reads every record, skipping lines that fail to parse (torn writes). */
+    async readAll() {
+        let raw;
+        try {
+            raw = await readFile(this.path, "utf8");
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                return [];
+            throw err;
+        }
+        const records = [];
+        for (const line of raw.split("\n")) {
+            if (!line.trim())
+                continue;
+            try {
+                records.push(JSON.parse(line));
+            }
+            catch {
+                // torn or corrupt line — skip rather than fail the whole read
+            }
+        }
+        return records;
+    }
+}
+//# sourceMappingURL=run-log.js.map

package/dist/core/run-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-log.js","sourceRoot":"","sources":["../../src/core/run-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAiC1C,MAAM,OAAO,MAAM;IACA,IAAI,CAAS;IAE9B,YAAY,OAAe,EAAE,OAAe;QAC1C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAiB;QAC5B,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,OAAO;QACX,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,EAAE,CAAC;YAChE,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,MAAM,OAAO,GAAgB,EAAE,CAAC;QAChC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;gBAAE,SAAS;YAC3B,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAc,CAAC,CAAC;YAC9C,CAAC;YAAC,MAAM,CAAC;gBACP,8DAA8D;YAChE,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/core/usage.d.ts

@@ -0,0 +1,22 @@
+import type Anthropic from "@anthropic-ai/sdk";
+/**
+ * Token accounting shared by the agent runtime, run records, and the `costs`
+ * CLI. Cache reads/writes are tracked separately because they bill at
+ * different rates (~0.1x and 1.25x the input price respectively).
+ */
+export interface UsageTotals {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    /** Number of API turns these totals cover. */
+    turns: number;
+}
+export declare function emptyUsage(): UsageTotals;
+/** Folds one API response's usage into a running total (returns a new object). */
+export declare function addUsage(totals: UsageTotals, usage: Anthropic.Usage): UsageTotals;
+export declare function addTotals(a: UsageTotals, b: UsageTotals): UsageTotals;
+/** The total prompt size the model saw on the last turn (cached or not). */
+export declare function contextTokens(usage: Anthropic.Usage): number;
+export declare function estimateCostUsd(model: string, totals: UsageTotals): number | null;
+export declare function formatUsd(value: number | null): string;

package/dist/core/usage.js

@@ -0,0 +1,58 @@
+export function emptyUsage() {
+    return { inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0, turns: 0 };
+}
+/** Folds one API response's usage into a running total (returns a new object). */
+export function addUsage(totals, usage) {
+    return {
+        inputTokens: totals.inputTokens + usage.input_tokens,
+        outputTokens: totals.outputTokens + usage.output_tokens,
+        cacheReadTokens: totals.cacheReadTokens + (usage.cache_read_input_tokens ?? 0),
+        cacheWriteTokens: totals.cacheWriteTokens + (usage.cache_creation_input_tokens ?? 0),
+        turns: totals.turns + 1,
+    };
+}
+export function addTotals(a, b) {
+    return {
+        inputTokens: a.inputTokens + b.inputTokens,
+        outputTokens: a.outputTokens + b.outputTokens,
+        cacheReadTokens: a.cacheReadTokens + b.cacheReadTokens,
+        cacheWriteTokens: a.cacheWriteTokens + b.cacheWriteTokens,
+        turns: a.turns + b.turns,
+    };
+}
+/** The total prompt size the model saw on the last turn (cached or not). */
+export function contextTokens(usage) {
+    return usage.input_tokens + (usage.cache_read_input_tokens ?? 0) + (usage.cache_creation_input_tokens ?? 0);
+}
+/**
+ * USD per million tokens. Matched by model-id prefix so dated variants
+ * (claude-haiku-4-5-20251001) resolve to their family. Unknown models return
+ * null cost — token counts are still tracked.
+ */
+const MODEL_PRICES = [
+    { prefix: "claude-demo", inputPerMTok: 0, outputPerMTok: 0 },
+    { prefix: "claude-fable-5", inputPerMTok: 10, outputPerMTok: 50 },
+    { prefix: "claude-mythos-5", inputPerMTok: 10, outputPerMTok: 50 },
+    { prefix: "claude-opus-4", inputPerMTok: 5, outputPerMTok: 25 },
+    { prefix: "claude-sonnet-4", inputPerMTok: 3, outputPerMTok: 15 },
+    { prefix: "claude-haiku-4", inputPerMTok: 1, outputPerMTok: 5 },
+];
+const CACHE_READ_MULTIPLIER = 0.1;
+const CACHE_WRITE_MULTIPLIER = 1.25;
+export function estimateCostUsd(model, totals) {
+    const price = MODEL_PRICES.find((p) => model.startsWith(p.prefix));
+    if (!price)
+        return null;
+    const perTokIn = price.inputPerMTok / 1_000_000;
+    const perTokOut = price.outputPerMTok / 1_000_000;
+    return (totals.inputTokens * perTokIn +
+        totals.outputTokens * perTokOut +
+        totals.cacheReadTokens * perTokIn * CACHE_READ_MULTIPLIER +
+        totals.cacheWriteTokens * perTokIn * CACHE_WRITE_MULTIPLIER);
+}
+export function formatUsd(value) {
+    if (value === null)
+        return "n/a";
+    return value < 0.01 && value > 0 ? `$${value.toFixed(4)}` : `$${value.toFixed(2)}`;
+}
+//# sourceMappingURL=usage.js.map

package/dist/core/usage.js.map

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

package/dist/dashboard/data.d.ts

@@ -0,0 +1,62 @@
+import { type UsageTotals } from "../core/usage.js";
+import type { Persona } from "../agent/persona.js";
+/**
+ * Assembles the read-only fleet snapshot served to the dashboard. Everything
+ * comes from the data dir (runs.jsonl, memory.json); agent configs passed on
+ * the CLI enrich entries with persona details.
+ */
+export interface AgentMeta {
+    persona: Persona;
+    model?: string;
+    connectors: string[];
+}
+export interface AgentSnapshot {
+    id: string;
+    persona?: {
+        name: string;
+        role: string;
+        succeeds?: string;
+        disclosure: string;
+    };
+    model?: string;
+    connectors: string[];
+    memoryCount: number;
+    recentMemories: Array<{
+        text: string;
+        source: string;
+        tags: string[];
+        createdAt: string;
+    }>;
+    runs: {
+        total: number;
+        lastAt?: string;
+        recent: Array<{
+            runId: string;
+            trigger: string;
+            startedAt: string;
+            iterations: number;
+            stopReason: string | null;
+            tokens: number;
+            costUsd: number | null;
+            outward: Array<{
+                tool: string;
+                approved: boolean;
+                summary: string;
+            }>;
+            error?: string;
+        }>;
+    };
+    usage: UsageTotals;
+    costUsd: number | null;
+    outward: {
+        total: number;
+        denied: number;
+    };
+}
+export interface FleetSnapshot {
+    generatedAt: string;
+    dataDir: string;
+    agents: AgentSnapshot[];
+}
+export declare function buildFleetSnapshot(dataDir: string, metas?: Map<string, AgentMeta>): Promise<FleetSnapshot>;
+export declare function buildAgentSnapshot(dataDir: string, id: string, meta?: AgentMeta): Promise<AgentSnapshot>;

package/dist/dashboard/data.js

@@ -0,0 +1,84 @@
+import { readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { RunLog } from "../core/run-log.js";
+import { addTotals, emptyUsage, estimateCostUsd } from "../core/usage.js";
+import { FileMemoryStore } from "../memory/file-store.js";
+export async function buildFleetSnapshot(dataDir, metas = new Map()) {
+    let ids = [];
+    try {
+        ids = (await readdir(join(dataDir, "agents"), { withFileTypes: true }))
+            .filter((e) => e.isDirectory())
+            .map((e) => e.name);
+    }
+    catch {
+        // no data yet
+    }
+    for (const id of metas.keys()) {
+        if (!ids.includes(id))
+            ids.push(id); // configured but not yet run
+    }
+    const agents = await Promise.all(ids.sort().map((id) => buildAgentSnapshot(dataDir, id, metas.get(id))));
+    return { generatedAt: new Date().toISOString(), dataDir, agents };
+}
+export async function buildAgentSnapshot(dataDir, id, meta) {
+    const store = new FileMemoryStore(dataDir, id);
+    const memories = await store.allMemories().catch(() => []);
+    const records = await new RunLog(dataDir, id).readAll().catch(() => []);
+    let usage = emptyUsage();
+    let cost = 0;
+    let hasCost = false;
+    let outwardTotal = 0;
+    let outwardDenied = 0;
+    for (const record of records) {
+        usage = addTotals(usage, record.usage);
+        const recordCost = record.costUsd ?? estimateCostUsd(record.model, record.usage);
+        if (recordCost !== null) {
+            cost += recordCost;
+            hasCost = true;
+        }
+        outwardTotal += record.outwardActions.length;
+        outwardDenied += record.outwardActions.filter((a) => !a.approved).length;
+    }
+    const recent = records.slice(-30).reverse();
+    return {
+        id,
+        ...(meta
+            ? {
+                persona: {
+                    name: meta.persona.name,
+                    role: meta.persona.role,
+                    ...(meta.persona.succeeds ? { succeeds: meta.persona.succeeds } : {}),
+                    disclosure: meta.persona.disclosure,
+                },
+                model: meta.model,
+            }
+            : {}),
+        connectors: meta?.connectors ?? [],
+        memoryCount: memories.length,
+        recentMemories: memories.slice(-12).reverse().map((m) => ({
+            text: m.text,
+            source: m.source,
+            tags: m.tags,
+            createdAt: m.createdAt,
+        })),
+        runs: {
+            total: records.length,
+            ...(records.length > 0 ? { lastAt: records[records.length - 1].finishedAt } : {}),
+            recent: recent.map((r) => ({
+                runId: r.runId,
+                trigger: r.trigger.detail ? `${r.trigger.kind} · ${r.trigger.detail}` : r.trigger.kind,
+                startedAt: r.startedAt,
+                iterations: r.iterations,
+                stopReason: r.stopReason,
+                tokens: r.usage.inputTokens + r.usage.outputTokens + r.usage.cacheReadTokens + r.usage.cacheWriteTokens,
+                costUsd: r.costUsd ?? estimateCostUsd(r.model, r.usage),
+                outward: r.outwardActions.map((a) => ({ tool: a.tool, approved: a.approved, summary: a.summary })),
+                ...(r.error ? { error: r.error } : {}),
+            })),
+        },
+        usage,
+        costUsd: hasCost ? cost : null,
+        outward: { total: outwardTotal, denied: outwardDenied },
+    };
+}
+//# sourceMappingURL=data.js.map

package/dist/dashboard/data.js.map

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

package/dist/dashboard/page.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The dashboard UI: a single self-contained HTML document, no build step.
+ *
+ * Design: "the succession ledger" — a personnel-dossier / ledger aesthetic
+ * for software whose whole job is stepping into someone's vacated role.
+ * Ink-black paper, amber phosphor, ruled lines, stamped disclosure modes,
+ * tabular monospace figures. Fraunces for display, IBM Plex Mono for data.
+ */
+export declare function dashboardPage(): string;