@holoscript/holoscript-agent 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 HoloScript Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/ablation.d.ts

@@ -0,0 +1,56 @@
+import { LLMProviderName, TokenUsage, ILLMProvider } from '@holoscript/llm-provider';
+import { CostGuard } from './cost-guard.js';
+import { AuditLog } from './audit-log.js';
+import { AgentIdentity } from './types.js';
+
+interface AblationProviderSpec {
+    label: string;
+    provider: LLMProviderName;
+    model: string;
+    build: () => Promise<ILLMProvider> | ILLMProvider;
+    pricer?: (usage: TokenUsage) => number;
+}
+interface AblationTaskSpec {
+    taskId: string;
+    taskTitle: string;
+    systemPrompt: string;
+    userPrompt: string;
+    brainPath?: string;
+    maxTokens?: number;
+    temperature?: number;
+}
+interface AblationCell {
+    label: string;
+    provider: LLMProviderName;
+    model: string;
+    responseText: string;
+    usage: TokenUsage;
+    costUsd: number;
+    durationMs: number;
+    finishReason: string;
+    errorMessage?: string;
+}
+interface AblationMatrix {
+    taskId: string;
+    taskTitle: string;
+    brainPath?: string;
+    promptHash: string;
+    cells: AblationCell[];
+    totalCostUsd: number;
+    startedAt: string;
+    completedAt: string;
+    budgetExhausted: boolean;
+}
+interface RunAblationOptions {
+    task: AblationTaskSpec;
+    providers: AblationProviderSpec[];
+    costGuard?: CostGuard;
+    timeoutPerCellMs?: number;
+    auditLog?: AuditLog;
+    matrixId?: string;
+    identityFor?: (spec: AblationProviderSpec) => AgentIdentity;
+}
+declare function runAblation(opts: RunAblationOptions): Promise<AblationMatrix>;
+declare function renderAblationMarkdown(matrix: AblationMatrix): string;
+
+export { type AblationCell, type AblationMatrix, type AblationProviderSpec, type AblationTaskSpec, type RunAblationOptions, renderAblationMarkdown, runAblation };

package/dist/ablation.js

@@ -0,0 +1,183 @@
+// src/ablation.ts
+import { createHash } from "crypto";
+async function runAblation(opts) {
+  const { task, providers, costGuard } = opts;
+  const startedAt = (/* @__PURE__ */ new Date()).toISOString();
+  const promptHash = hashPrompt(task.systemPrompt, task.userPrompt);
+  const request = {
+    messages: [
+      { role: "system", content: task.systemPrompt },
+      { role: "user", content: task.userPrompt }
+    ],
+    maxTokens: task.maxTokens ?? 2048,
+    temperature: task.temperature ?? 0.4
+  };
+  const cells = [];
+  let budgetExhausted = false;
+  const matrixId = opts.matrixId ?? `mx_${promptHash}_${Date.now()}`;
+  for (const spec of providers) {
+    if (costGuard?.isOverBudget()) {
+      budgetExhausted = true;
+      cells.push({
+        label: spec.label,
+        provider: spec.provider,
+        model: spec.model,
+        responseText: "",
+        usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
+        costUsd: 0,
+        durationMs: 0,
+        finishReason: "error",
+        errorMessage: "budget-exhausted-before-cell"
+      });
+      continue;
+    }
+    const t0 = Date.now();
+    try {
+      const provider = await spec.build();
+      const cellPromise = provider.complete(request, spec.model);
+      const response = opts.timeoutPerCellMs ? await withTimeout(cellPromise, opts.timeoutPerCellMs, spec.label) : await cellPromise;
+      const durationMs = Date.now() - t0;
+      const costUsd = spec.pricer ? spec.pricer(response.usage) : costGuard?.recordUsage(spec.model, response.usage).costUsd ?? 0;
+      if (spec.pricer && costGuard) {
+        costGuard.recordUsage(spec.model, response.usage);
+      }
+      cells.push({
+        label: spec.label,
+        provider: spec.provider,
+        model: spec.model,
+        responseText: response.content,
+        usage: response.usage,
+        costUsd,
+        durationMs,
+        finishReason: response.finishReason
+      });
+      recordAblationCellIfWired(opts, spec, {
+        matrixId,
+        promptHash,
+        promptTokens: response.usage.promptTokens,
+        completionTokens: response.usage.completionTokens,
+        costUsd,
+        durationMs,
+        finishReason: response.finishReason
+      });
+    } catch (err) {
+      const errorMessage = err instanceof Error ? err.message : String(err);
+      cells.push({
+        label: spec.label,
+        provider: spec.provider,
+        model: spec.model,
+        responseText: "",
+        usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
+        costUsd: 0,
+        durationMs: Date.now() - t0,
+        finishReason: "error",
+        errorMessage
+      });
+      recordAblationCellIfWired(opts, spec, {
+        matrixId,
+        promptHash,
+        promptTokens: 0,
+        completionTokens: 0,
+        costUsd: 0,
+        durationMs: Date.now() - t0,
+        finishReason: "error",
+        errorMessage
+      });
+    }
+  }
+  return {
+    taskId: task.taskId,
+    taskTitle: task.taskTitle,
+    brainPath: task.brainPath,
+    promptHash,
+    cells,
+    totalCostUsd: cells.reduce((sum, c) => sum + c.costUsd, 0),
+    startedAt,
+    completedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    budgetExhausted
+  };
+}
+function renderAblationMarkdown(matrix) {
+  const header = [
+    `# Ablation: ${matrix.taskTitle}`,
+    "",
+    `- task_id: \`${matrix.taskId}\``,
+    `- prompt_hash: \`${matrix.promptHash}\``,
+    matrix.brainPath ? `- brain: \`${matrix.brainPath}\`` : "- brain: _(none)_",
+    `- started: ${matrix.startedAt}`,
+    `- completed: ${matrix.completedAt}`,
+    `- total_cost_usd: $${matrix.totalCostUsd.toFixed(4)}`,
+    matrix.budgetExhausted ? `- **budget_exhausted: true** (some cells skipped)` : "",
+    "",
+    "| Label | Provider | Model | Tokens (in/out) | Cost (USD) | Duration (ms) | Finish | Excerpt |",
+    "|---|---|---|---|---|---|---|---|"
+  ].filter((line) => line !== "");
+  const rows = matrix.cells.map((c) => {
+    const tokens = `${c.usage.promptTokens}/${c.usage.completionTokens}`;
+    const excerpt = c.errorMessage ? `_error: ${truncate(c.errorMessage, 80)}_` : truncate(escapeMd(c.responseText.replace(/\n/g, " ")), 80);
+    return `| ${c.label} | ${c.provider} | ${c.model} | ${tokens} | $${c.costUsd.toFixed(4)} | ${c.durationMs} | ${c.finishReason} | ${excerpt} |`;
+  });
+  return [...header, ...rows, ""].join("\n");
+}
+function recordAblationCellIfWired(opts, spec, cell) {
+  if (!opts.auditLog) return;
+  const identity = opts.identityFor?.(spec) ?? {
+    handle: `ablation:${spec.label}`,
+    surface: `ablation:${spec.label}`,
+    wallet: "0x0000000000000000000000000000000000000000",
+    x402Bearer: "",
+    llmProvider: spec.provider,
+    llmModel: spec.model,
+    brainPath: opts.task.brainPath ?? "(none)",
+    budgetUsdPerDay: 0,
+    teamId: "(ablation)",
+    meshApiBase: "(ablation)"
+  };
+  try {
+    opts.auditLog.recordAblationCell({
+      identity,
+      matrixId: cell.matrixId,
+      label: spec.label,
+      taskId: opts.task.taskId,
+      taskTitle: opts.task.taskTitle,
+      promptHash: cell.promptHash,
+      promptTokens: cell.promptTokens,
+      completionTokens: cell.completionTokens,
+      costUsd: cell.costUsd,
+      durationMs: cell.durationMs,
+      finishReason: cell.finishReason,
+      errorMessage: cell.errorMessage
+    });
+  } catch {
+  }
+}
+function hashPrompt(system, user) {
+  return createHash("sha256").update(`SYS:${system}
+USR:${user}`).digest("hex").slice(0, 16);
+}
+function withTimeout(p, ms, label) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => reject(new Error(`ablation cell "${label}" timed out after ${ms}ms`)), ms);
+    p.then(
+      (v) => {
+        clearTimeout(timer);
+        resolve(v);
+      },
+      (e) => {
+        clearTimeout(timer);
+        reject(e);
+      }
+    );
+  });
+}
+function truncate(s, max) {
+  return s.length <= max ? s : `${s.slice(0, max - 1)}\u2026`;
+}
+function escapeMd(s) {
+  return s.replace(/\|/g, "\\|");
+}
+export {
+  renderAblationMarkdown,
+  runAblation
+};
+//# sourceMappingURL=ablation.js.map

package/dist/ablation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ablation.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport type {\n  ILLMProvider,\n  LLMCompletionRequest,\n  LLMProviderName,\n  TokenUsage,\n} from '@holoscript/llm-provider';\nimport type { CostGuard } from './cost-guard.js';\nimport type { AuditLog } from './audit-log.js';\nimport type { AgentIdentity } from './types.js';\n\nexport interface AblationProviderSpec {\n  label: string;\n  provider: LLMProviderName;\n  model: string;\n  build: () => Promise<ILLMProvider> | ILLMProvider;\n  pricer?: (usage: TokenUsage) => number;\n}\n\nexport interface AblationTaskSpec {\n  taskId: string;\n  taskTitle: string;\n  systemPrompt: string;\n  userPrompt: string;\n  brainPath?: string;\n  maxTokens?: number;\n  temperature?: number;\n}\n\nexport interface AblationCell {\n  label: string;\n  provider: LLMProviderName;\n  model: string;\n  responseText: string;\n  usage: TokenUsage;\n  costUsd: number;\n  durationMs: number;\n  finishReason: string;\n  errorMessage?: string;\n}\n\nexport interface AblationMatrix {\n  taskId: string;\n  taskTitle: string;\n  brainPath?: string;\n  promptHash: string;\n  cells: AblationCell[];\n  totalCostUsd: number;\n  startedAt: string;\n  completedAt: string;\n  budgetExhausted: boolean;\n}\n\nexport interface RunAblationOptions {\n  task: AblationTaskSpec;\n  providers: AblationProviderSpec[];\n  costGuard?: CostGuard;\n  timeoutPerCellMs?: number;\n  auditLog?: AuditLog;\n  matrixId?: string;\n  identityFor?: (spec: AblationProviderSpec) => AgentIdentity;\n}\n\nexport async function runAblation(opts: RunAblationOptions): Promise<AblationMatrix> {\n  const { task, providers, costGuard } = opts;\n  const startedAt = new Date().toISOString();\n  const promptHash = hashPrompt(task.systemPrompt, task.userPrompt);\n\n  const request: LLMCompletionRequest = {\n    messages: [\n      { role: 'system', content: task.systemPrompt },\n      { role: 'user', content: task.userPrompt },\n    ],\n    maxTokens: task.maxTokens ?? 2048,\n    temperature: task.temperature ?? 0.4,\n  };\n\n  const cells: AblationCell[] = [];\n  let budgetExhausted = false;\n  const matrixId = opts.matrixId ?? `mx_${promptHash}_${Date.now()}`;\n\n  for (const spec of providers) {\n    if (costGuard?.isOverBudget()) {\n      budgetExhausted = true;\n      cells.push({\n        label: spec.label,\n        provider: spec.provider,\n        model: spec.model,\n        responseText: '',\n        usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },\n        costUsd: 0,\n        durationMs: 0,\n        finishReason: 'error',\n        errorMessage: 'budget-exhausted-before-cell',\n      });\n      continue;\n    }\n\n    const t0 = Date.now();\n    try {\n      const provider = await spec.build();\n      const cellPromise = provider.complete(request, spec.model);\n      const response = opts.timeoutPerCellMs\n        ? await withTimeout(cellPromise, opts.timeoutPerCellMs, spec.label)\n        : await cellPromise;\n      const durationMs = Date.now() - t0;\n\n      const costUsd = spec.pricer\n        ? spec.pricer(response.usage)\n        : costGuard?.recordUsage(spec.model, response.usage).costUsd ?? 0;\n      if (spec.pricer && costGuard) {\n        costGuard.recordUsage(spec.model, response.usage);\n      }\n\n      cells.push({\n        label: spec.label,\n        provider: spec.provider,\n        model: spec.model,\n        responseText: response.content,\n        usage: response.usage,\n        costUsd,\n        durationMs,\n        finishReason: response.finishReason,\n      });\n      recordAblationCellIfWired(opts, spec, {\n        matrixId,\n        promptHash,\n        promptTokens: response.usage.promptTokens,\n        completionTokens: response.usage.completionTokens,\n        costUsd,\n        durationMs,\n        finishReason: response.finishReason,\n      });\n    } catch (err) {\n      const errorMessage = err instanceof Error ? err.message : String(err);\n      cells.push({\n        label: spec.label,\n        provider: spec.provider,\n        model: spec.model,\n        responseText: '',\n        usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },\n        costUsd: 0,\n        durationMs: Date.now() - t0,\n        finishReason: 'error',\n        errorMessage,\n      });\n      recordAblationCellIfWired(opts, spec, {\n        matrixId,\n        promptHash,\n        promptTokens: 0,\n        completionTokens: 0,\n        costUsd: 0,\n        durationMs: Date.now() - t0,\n        finishReason: 'error',\n        errorMessage,\n      });\n    }\n  }\n\n  return {\n    taskId: task.taskId,\n    taskTitle: task.taskTitle,\n    brainPath: task.brainPath,\n    promptHash,\n    cells,\n    totalCostUsd: cells.reduce((sum, c) => sum + c.costUsd, 0),\n    startedAt,\n    completedAt: new Date().toISOString(),\n    budgetExhausted,\n  };\n}\n\nexport function renderAblationMarkdown(matrix: AblationMatrix): string {\n  const header = [\n    `# Ablation: ${matrix.taskTitle}`,\n    '',\n    `- task_id: \\`${matrix.taskId}\\``,\n    `- prompt_hash: \\`${matrix.promptHash}\\``,\n    matrix.brainPath ? `- brain: \\`${matrix.brainPath}\\`` : '- brain: _(none)_',\n    `- started: ${matrix.startedAt}`,\n    `- completed: ${matrix.completedAt}`,\n    `- total_cost_usd: $${matrix.totalCostUsd.toFixed(4)}`,\n    matrix.budgetExhausted ? `- **budget_exhausted: true** (some cells skipped)` : '',\n    '',\n    '| Label | Provider | Model | Tokens (in/out) | Cost (USD) | Duration (ms) | Finish | Excerpt |',\n    '|---|---|---|---|---|---|---|---|',\n  ].filter((line) => line !== '');\n\n  const rows = matrix.cells.map((c) => {\n    const tokens = `${c.usage.promptTokens}/${c.usage.completionTokens}`;\n    const excerpt = c.errorMessage\n      ? `_error: ${truncate(c.errorMessage, 80)}_`\n      : truncate(escapeMd(c.responseText.replace(/\\n/g, ' ')), 80);\n    return `| ${c.label} | ${c.provider} | ${c.model} | ${tokens} | $${c.costUsd.toFixed(4)} | ${c.durationMs} | ${c.finishReason} | ${excerpt} |`;\n  });\n\n  return [...header, ...rows, ''].join('\\n');\n}\n\nfunction recordAblationCellIfWired(\n  opts: RunAblationOptions,\n  spec: AblationProviderSpec,\n  cell: {\n    matrixId: string;\n    promptHash: string;\n    promptTokens: number;\n    completionTokens: number;\n    costUsd: number;\n    durationMs: number;\n    finishReason: string;\n    errorMessage?: string;\n  }\n): void {\n  if (!opts.auditLog) return;\n  const identity = opts.identityFor?.(spec) ?? {\n    handle: `ablation:${spec.label}`,\n    surface: `ablation:${spec.label}`,\n    wallet: '0x0000000000000000000000000000000000000000',\n    x402Bearer: '',\n    llmProvider: spec.provider,\n    llmModel: spec.model,\n    brainPath: opts.task.brainPath ?? '(none)',\n    budgetUsdPerDay: 0,\n    teamId: '(ablation)',\n    meshApiBase: '(ablation)',\n  };\n  try {\n    opts.auditLog.recordAblationCell({\n      identity,\n      matrixId: cell.matrixId,\n      label: spec.label,\n      taskId: opts.task.taskId,\n      taskTitle: opts.task.taskTitle,\n      promptHash: cell.promptHash,\n      promptTokens: cell.promptTokens,\n      completionTokens: cell.completionTokens,\n      costUsd: cell.costUsd,\n      durationMs: cell.durationMs,\n      finishReason: cell.finishReason,\n      errorMessage: cell.errorMessage,\n    });\n  } catch {\n    // Audit log write must never break the ablation matrix output.\n  }\n}\n\nfunction hashPrompt(system: string, user: string): string {\n  return createHash('sha256').update(`SYS:${system}\\nUSR:${user}`).digest('hex').slice(0, 16);\n}\n\nfunction withTimeout<T>(p: Promise<T>, ms: number, label: string): Promise<T> {\n  return new Promise((resolve, reject) => {\n    const timer = setTimeout(() => reject(new Error(`ablation cell \"${label}\" timed out after ${ms}ms`)), ms);\n    p.then(\n      (v) => {\n        clearTimeout(timer);\n        resolve(v);\n      },\n      (e) => {\n        clearTimeout(timer);\n        reject(e);\n      }\n    );\n  });\n}\n\nfunction truncate(s: string, max: number): string {\n  return s.length <= max ? s : `${s.slice(0, max - 1)}…`;\n}\n\nfunction escapeMd(s: string): string {\n  return s.replace(/\\|/g, '\\\\|');\n}\n"],"mappings":"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","names":[]}

package/dist/audit-log.d.ts

@@ -0,0 +1,99 @@
+import { LLMProviderName } from '@holoscript/llm-provider';
+import { AgentIdentity, BoardTask, ExecutionResult } from './types.js';
+
+type AuditEventKind = 'task-executed' | 'ablation-cell' | 'budget-exhausted' | 'agent-crash';
+interface AuditEvent {
+    ts: string;
+    kind: AuditEventKind;
+    agent: {
+        handle: string;
+        surface: string;
+        wallet: string;
+        walletShort: string;
+        provider: LLMProviderName;
+        model: string;
+        brainPath: string;
+    };
+    task?: {
+        id: string;
+        title: string;
+        tags: string[];
+    };
+    execution?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+        costUsd: number;
+        durationMs: number;
+        finishReason?: string;
+        promptHash?: string;
+    };
+    result?: {
+        commitHash?: string;
+        filePath?: string;
+        errorMessage?: string;
+    };
+    ablation?: {
+        label: string;
+        matrixId: string;
+    };
+}
+interface AuditQuery {
+    agent?: string;
+    task?: string;
+    provider?: LLMProviderName;
+    kind?: AuditEventKind;
+    since?: string;
+    until?: string;
+    limit?: number;
+}
+interface AuditLogOptions {
+    logPath: string;
+    maxBytes?: number;
+}
+declare class AuditLog {
+    private readonly logPath;
+    private readonly maxBytes;
+    constructor(opts: AuditLogOptions);
+    record(event: AuditEvent): void;
+    recordTaskExecuted(opts: {
+        identity: AgentIdentity;
+        task: BoardTask;
+        result: ExecutionResult;
+        commitHash?: string;
+        filePath?: string;
+    }): void;
+    recordAblationCell(opts: {
+        identity: AgentIdentity;
+        matrixId: string;
+        label: string;
+        taskId: string;
+        taskTitle: string;
+        promptHash: string;
+        promptTokens: number;
+        completionTokens: number;
+        costUsd: number;
+        durationMs: number;
+        finishReason: string;
+        errorMessage?: string;
+    }): void;
+    query(filter?: AuditQuery): AuditEvent[];
+    rollup(filter?: AuditQuery): {
+        totalEvents: number;
+        byAgent: Record<string, {
+            events: number;
+            costUsd: number;
+            tokens: number;
+        }>;
+        byProvider: Record<string, {
+            events: number;
+            costUsd: number;
+            tokens: number;
+        }>;
+        totalCostUsd: number;
+        totalTokens: number;
+    };
+    private rotateIfFull;
+}
+
+export { type AuditEvent, type AuditEventKind, AuditLog, type AuditLogOptions, type AuditQuery };

package/dist/audit-log.js

@@ -0,0 +1,123 @@
+// src/audit-log.ts
+import { mkdirSync, appendFileSync, readFileSync, existsSync, statSync, renameSync } from "fs";
+import { dirname } from "path";
+var AuditLog = class {
+  constructor(opts) {
+    this.logPath = opts.logPath;
+    this.maxBytes = opts.maxBytes ?? 50 * 1024 * 1024;
+    mkdirSync(dirname(this.logPath), { recursive: true });
+  }
+  record(event) {
+    this.rotateIfFull();
+    appendFileSync(this.logPath, `${JSON.stringify(event)}
+`, "utf8");
+  }
+  recordTaskExecuted(opts) {
+    this.record({
+      ts: (/* @__PURE__ */ new Date()).toISOString(),
+      kind: "task-executed",
+      agent: agentFromIdentity(opts.identity),
+      task: { id: opts.task.id, title: opts.task.title, tags: opts.task.tags ?? [] },
+      execution: {
+        promptTokens: opts.result.usage.promptTokens,
+        completionTokens: opts.result.usage.completionTokens,
+        totalTokens: opts.result.usage.totalTokens,
+        costUsd: opts.result.costUsd,
+        durationMs: opts.result.durationMs
+      },
+      result: {
+        commitHash: opts.commitHash,
+        filePath: opts.filePath
+      }
+    });
+  }
+  recordAblationCell(opts) {
+    this.record({
+      ts: (/* @__PURE__ */ new Date()).toISOString(),
+      kind: "ablation-cell",
+      agent: agentFromIdentity(opts.identity),
+      task: { id: opts.taskId, title: opts.taskTitle, tags: ["ablation"] },
+      execution: {
+        promptTokens: opts.promptTokens,
+        completionTokens: opts.completionTokens,
+        totalTokens: opts.promptTokens + opts.completionTokens,
+        costUsd: opts.costUsd,
+        durationMs: opts.durationMs,
+        finishReason: opts.finishReason,
+        promptHash: opts.promptHash
+      },
+      result: { errorMessage: opts.errorMessage },
+      ablation: { label: opts.label, matrixId: opts.matrixId }
+    });
+  }
+  query(filter = {}) {
+    if (!existsSync(this.logPath)) return [];
+    const raw = readFileSync(this.logPath, "utf8");
+    const lines = raw.split("\n").filter((l) => l.length > 0);
+    const events = [];
+    for (const line of lines) {
+      try {
+        events.push(JSON.parse(line));
+      } catch {
+      }
+    }
+    return applyFilter(events, filter);
+  }
+  rollup(filter = {}) {
+    const events = this.query(filter);
+    const byAgent = {};
+    const byProvider = {};
+    let totalCostUsd = 0;
+    let totalTokens = 0;
+    for (const e of events) {
+      const agent = e.agent.handle;
+      const provider = e.agent.provider;
+      const cost = e.execution?.costUsd ?? 0;
+      const tokens = e.execution?.totalTokens ?? 0;
+      byAgent[agent] = byAgent[agent] ?? { events: 0, costUsd: 0, tokens: 0 };
+      byAgent[agent].events += 1;
+      byAgent[agent].costUsd += cost;
+      byAgent[agent].tokens += tokens;
+      byProvider[provider] = byProvider[provider] ?? { events: 0, costUsd: 0, tokens: 0 };
+      byProvider[provider].events += 1;
+      byProvider[provider].costUsd += cost;
+      byProvider[provider].tokens += tokens;
+      totalCostUsd += cost;
+      totalTokens += tokens;
+    }
+    return { totalEvents: events.length, byAgent, byProvider, totalCostUsd, totalTokens };
+  }
+  rotateIfFull() {
+    if (!existsSync(this.logPath)) return;
+    const size = statSync(this.logPath).size;
+    if (size < this.maxBytes) return;
+    const archived = `${this.logPath}.${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")}.jsonl`;
+    renameSync(this.logPath, archived);
+  }
+};
+function agentFromIdentity(identity) {
+  return {
+    handle: identity.handle,
+    surface: identity.surface,
+    wallet: identity.wallet,
+    walletShort: `${identity.wallet.slice(0, 6)}\u2026${identity.wallet.slice(-4)}`,
+    provider: identity.llmProvider,
+    model: identity.llmModel,
+    brainPath: identity.brainPath
+  };
+}
+function applyFilter(events, filter) {
+  let result = events;
+  if (filter.agent) result = result.filter((e) => e.agent.handle === filter.agent);
+  if (filter.provider) result = result.filter((e) => e.agent.provider === filter.provider);
+  if (filter.task) result = result.filter((e) => e.task?.id === filter.task);
+  if (filter.kind) result = result.filter((e) => e.kind === filter.kind);
+  if (filter.since) result = result.filter((e) => e.ts >= filter.since);
+  if (filter.until) result = result.filter((e) => e.ts <= filter.until);
+  if (filter.limit != null) result = result.slice(-filter.limit);
+  return result;
+}
+export {
+  AuditLog
+};
+//# sourceMappingURL=audit-log.js.map

package/dist/audit-log.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/audit-log.ts"],"sourcesContent":["import { mkdirSync, appendFileSync, readFileSync, existsSync, statSync, renameSync } from 'node:fs';\nimport { dirname } from 'node:path';\nimport type { LLMProviderName } from '@holoscript/llm-provider';\nimport type { AgentIdentity, BoardTask, ExecutionResult } from './types.js';\n\nexport type AuditEventKind = 'task-executed' | 'ablation-cell' | 'budget-exhausted' | 'agent-crash';\n\nexport interface AuditEvent {\n  ts: string;\n  kind: AuditEventKind;\n  agent: {\n    handle: string;\n    surface: string;\n    wallet: string;\n    walletShort: string;\n    provider: LLMProviderName;\n    model: string;\n    brainPath: string;\n  };\n  task?: {\n    id: string;\n    title: string;\n    tags: string[];\n  };\n  execution?: {\n    promptTokens: number;\n    completionTokens: number;\n    totalTokens: number;\n    costUsd: number;\n    durationMs: number;\n    finishReason?: string;\n    promptHash?: string;\n  };\n  result?: {\n    commitHash?: string;\n    filePath?: string;\n    errorMessage?: string;\n  };\n  ablation?: {\n    label: string;\n    matrixId: string;\n  };\n}\n\nexport interface AuditQuery {\n  agent?: string;\n  task?: string;\n  provider?: LLMProviderName;\n  kind?: AuditEventKind;\n  since?: string;\n  until?: string;\n  limit?: number;\n}\n\nexport interface AuditLogOptions {\n  logPath: string;\n  maxBytes?: number;\n}\n\nexport class AuditLog {\n  private readonly logPath: string;\n  private readonly maxBytes: number;\n\n  constructor(opts: AuditLogOptions) {\n    this.logPath = opts.logPath;\n    this.maxBytes = opts.maxBytes ?? 50 * 1024 * 1024;\n    mkdirSync(dirname(this.logPath), { recursive: true });\n  }\n\n  record(event: AuditEvent): void {\n    this.rotateIfFull();\n    appendFileSync(this.logPath, `${JSON.stringify(event)}\\n`, 'utf8');\n  }\n\n  recordTaskExecuted(opts: {\n    identity: AgentIdentity;\n    task: BoardTask;\n    result: ExecutionResult;\n    commitHash?: string;\n    filePath?: string;\n  }): void {\n    this.record({\n      ts: new Date().toISOString(),\n      kind: 'task-executed',\n      agent: agentFromIdentity(opts.identity),\n      task: { id: opts.task.id, title: opts.task.title, tags: opts.task.tags ?? [] },\n      execution: {\n        promptTokens: opts.result.usage.promptTokens,\n        completionTokens: opts.result.usage.completionTokens,\n        totalTokens: opts.result.usage.totalTokens,\n        costUsd: opts.result.costUsd,\n        durationMs: opts.result.durationMs,\n      },\n      result: {\n        commitHash: opts.commitHash,\n        filePath: opts.filePath,\n      },\n    });\n  }\n\n  recordAblationCell(opts: {\n    identity: AgentIdentity;\n    matrixId: string;\n    label: string;\n    taskId: string;\n    taskTitle: string;\n    promptHash: string;\n    promptTokens: number;\n    completionTokens: number;\n    costUsd: number;\n    durationMs: number;\n    finishReason: string;\n    errorMessage?: string;\n  }): void {\n    this.record({\n      ts: new Date().toISOString(),\n      kind: 'ablation-cell',\n      agent: agentFromIdentity(opts.identity),\n      task: { id: opts.taskId, title: opts.taskTitle, tags: ['ablation'] },\n      execution: {\n        promptTokens: opts.promptTokens,\n        completionTokens: opts.completionTokens,\n        totalTokens: opts.promptTokens + opts.completionTokens,\n        costUsd: opts.costUsd,\n        durationMs: opts.durationMs,\n        finishReason: opts.finishReason,\n        promptHash: opts.promptHash,\n      },\n      result: { errorMessage: opts.errorMessage },\n      ablation: { label: opts.label, matrixId: opts.matrixId },\n    });\n  }\n\n  query(filter: AuditQuery = {}): AuditEvent[] {\n    if (!existsSync(this.logPath)) return [];\n    const raw = readFileSync(this.logPath, 'utf8');\n    const lines = raw.split('\\n').filter((l) => l.length > 0);\n    const events: AuditEvent[] = [];\n    for (const line of lines) {\n      try {\n        events.push(JSON.parse(line) as AuditEvent);\n      } catch {\n        // Corrupt line — skip rather than fail the whole query.\n        // Agents must keep flying even if one line got partially flushed.\n      }\n    }\n    return applyFilter(events, filter);\n  }\n\n  rollup(filter: AuditQuery = {}): {\n    totalEvents: number;\n    byAgent: Record<string, { events: number; costUsd: number; tokens: number }>;\n    byProvider: Record<string, { events: number; costUsd: number; tokens: number }>;\n    totalCostUsd: number;\n    totalTokens: number;\n  } {\n    const events = this.query(filter);\n    const byAgent: Record<string, { events: number; costUsd: number; tokens: number }> = {};\n    const byProvider: Record<string, { events: number; costUsd: number; tokens: number }> = {};\n    let totalCostUsd = 0;\n    let totalTokens = 0;\n    for (const e of events) {\n      const agent = e.agent.handle;\n      const provider = e.agent.provider;\n      const cost = e.execution?.costUsd ?? 0;\n      const tokens = e.execution?.totalTokens ?? 0;\n      byAgent[agent] = byAgent[agent] ?? { events: 0, costUsd: 0, tokens: 0 };\n      byAgent[agent].events += 1;\n      byAgent[agent].costUsd += cost;\n      byAgent[agent].tokens += tokens;\n      byProvider[provider] = byProvider[provider] ?? { events: 0, costUsd: 0, tokens: 0 };\n      byProvider[provider].events += 1;\n      byProvider[provider].costUsd += cost;\n      byProvider[provider].tokens += tokens;\n      totalCostUsd += cost;\n      totalTokens += tokens;\n    }\n    return { totalEvents: events.length, byAgent, byProvider, totalCostUsd, totalTokens };\n  }\n\n  private rotateIfFull(): void {\n    if (!existsSync(this.logPath)) return;\n    const size = statSync(this.logPath).size;\n    if (size < this.maxBytes) return;\n    const archived = `${this.logPath}.${new Date().toISOString().replace(/[:.]/g, '-')}.jsonl`;\n    renameSync(this.logPath, archived);\n  }\n}\n\nfunction agentFromIdentity(identity: AgentIdentity): AuditEvent['agent'] {\n  return {\n    handle: identity.handle,\n    surface: identity.surface,\n    wallet: identity.wallet,\n    walletShort: `${identity.wallet.slice(0, 6)}…${identity.wallet.slice(-4)}`,\n    provider: identity.llmProvider,\n    model: identity.llmModel,\n    brainPath: identity.brainPath,\n  };\n}\n\nfunction applyFilter(events: AuditEvent[], filter: AuditQuery): AuditEvent[] {\n  let result = events;\n  if (filter.agent) result = result.filter((e) => e.agent.handle === filter.agent);\n  if (filter.provider) result = result.filter((e) => e.agent.provider === filter.provider);\n  if (filter.task) result = result.filter((e) => e.task?.id === filter.task);\n  if (filter.kind) result = result.filter((e) => e.kind === filter.kind);\n  if (filter.since) result = result.filter((e) => e.ts >= filter.since!);\n  if (filter.until) result = result.filter((e) => e.ts <= filter.until!);\n  if (filter.limit != null) result = result.slice(-filter.limit);\n  return result;\n}\n"],"mappings":"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","names":[]}

package/dist/brain.d.ts

@@ -0,0 +1,6 @@
+import { RuntimeBrainConfig } from './types.js';
+import '@holoscript/llm-provider';
+
+declare function loadBrain(brainPath: string, scopeTier?: 'cold' | 'warm' | 'hot'): Promise<RuntimeBrainConfig>;
+
+export { loadBrain };

package/dist/brain.js

@@ -0,0 +1,66 @@
+// src/brain.ts
+import { readFile } from "fs/promises";
+async function loadBrain(brainPath, scopeTier = "warm") {
+  const systemPrompt = await readFile(brainPath, "utf8");
+  const { domain, capabilityTags } = extractIdentity(systemPrompt);
+  return { brainPath, systemPrompt, capabilityTags, domain, scopeTier };
+}
+function extractIdentity(brain) {
+  const identityBlock = sliceNamedBlock(brain, "identity");
+  if (!identityBlock) return { domain: "unknown", capabilityTags: [] };
+  const domain = scalarField(identityBlock, "domain") ?? "unknown";
+  const capabilityTags = listField(identityBlock, "capability_tags") ?? [];
+  return { domain, capabilityTags };
+}
+function sliceNamedBlock(src, name) {
+  const re = new RegExp(`\\b${name}\\s*:?\\s*\\{`, "g");
+  const match = re.exec(src);
+  if (!match) return void 0;
+  const headerEnd = match.index + match[0].length;
+  let depth = 1;
+  for (let i = headerEnd; i < src.length; i++) {
+    const ch = src[i];
+    if (ch === "{") depth++;
+    else if (ch === "}") {
+      depth--;
+      if (depth === 0) return src.slice(headerEnd, i);
+    }
+  }
+  return void 0;
+}
+function scalarField(block, key) {
+  const idx = block.indexOf(`${key}:`);
+  if (idx < 0) return void 0;
+  const after = block.slice(idx + key.length + 1).trimStart();
+  if (after.startsWith('"')) {
+    const end = after.indexOf('"', 1);
+    if (end > 0) return after.slice(1, end);
+  }
+  const eol = after.indexOf("\n");
+  return after.slice(0, eol < 0 ? void 0 : eol).trim();
+}
+function listField(block, key) {
+  const idx = block.indexOf(`${key}:`);
+  if (idx < 0) return void 0;
+  const after = block.slice(idx + key.length + 1).trimStart();
+  if (!after.startsWith("[")) return void 0;
+  let depth = 0;
+  let end = -1;
+  for (let i = 0; i < after.length; i++) {
+    if (after[i] === "[") depth++;
+    else if (after[i] === "]") {
+      depth--;
+      if (depth === 0) {
+        end = i;
+        break;
+      }
+    }
+  }
+  if (end < 0) return void 0;
+  const inner = after.slice(1, end);
+  return inner.split(",").map((s) => s.trim().replace(/^["']|["']$/g, "")).filter((s) => s.length > 0);
+}
+export {
+  loadBrain
+};
+//# sourceMappingURL=brain.js.map

package/dist/brain.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/brain.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport type { RuntimeBrainConfig } from './types.js';\n\nexport async function loadBrain(\n  brainPath: string,\n  scopeTier: 'cold' | 'warm' | 'hot' = 'warm'\n): Promise<RuntimeBrainConfig> {\n  const systemPrompt = await readFile(brainPath, 'utf8');\n  const { domain, capabilityTags } = extractIdentity(systemPrompt);\n  return { brainPath, systemPrompt, capabilityTags, domain, scopeTier };\n}\n\nfunction extractIdentity(brain: string): { domain: string; capabilityTags: string[] } {\n  const identityBlock = sliceNamedBlock(brain, 'identity');\n  if (!identityBlock) return { domain: 'unknown', capabilityTags: [] };\n  const domain = scalarField(identityBlock, 'domain') ?? 'unknown';\n  const capabilityTags = listField(identityBlock, 'capability_tags') ?? [];\n  return { domain, capabilityTags };\n}\n\nfunction sliceNamedBlock(src: string, name: string): string | undefined {\n  // Accept both `identity {` and `identity: {` — brain compositions in\n  // .ai-ecosystem use both forms (lean-theorist + antigravity-hot use the\n  // colon variant; security-auditor + others use the bare form). Without\n  // both-form tolerance the colon-form brains parse to empty\n  // capability_tags, breaking task scoring entirely (silent claim-blackhole\n  // observed 2026-04-25 on W01 H200 lean-theorist).\n  const re = new RegExp(`\\\\b${name}\\\\s*:?\\\\s*\\\\{`, 'g');\n  const match = re.exec(src);\n  if (!match) return undefined;\n  const headerEnd = match.index + match[0].length; // position just past the `{`\n  let depth = 1;\n  for (let i = headerEnd; i < src.length; i++) {\n    const ch = src[i];\n    if (ch === '{') depth++;\n    else if (ch === '}') {\n      depth--;\n      if (depth === 0) return src.slice(headerEnd, i);\n    }\n  }\n  return undefined;\n}\n\nfunction scalarField(block: string, key: string): string | undefined {\n  const idx = block.indexOf(`${key}:`);\n  if (idx < 0) return undefined;\n  const after = block.slice(idx + key.length + 1).trimStart();\n  if (after.startsWith('\"')) {\n    const end = after.indexOf('\"', 1);\n    if (end > 0) return after.slice(1, end);\n  }\n  const eol = after.indexOf('\\n');\n  return after.slice(0, eol < 0 ? undefined : eol).trim();\n}\n\nfunction listField(block: string, key: string): string[] | undefined {\n  const idx = block.indexOf(`${key}:`);\n  if (idx < 0) return undefined;\n  const after = block.slice(idx + key.length + 1).trimStart();\n  if (!after.startsWith('[')) return undefined;\n  let depth = 0;\n  let end = -1;\n  for (let i = 0; i < after.length; i++) {\n    if (after[i] === '[') depth++;\n    else if (after[i] === ']') {\n      depth--;\n      if (depth === 0) {\n        end = i;\n        break;\n      }\n    }\n  }\n  if (end < 0) return undefined;\n  const inner = after.slice(1, end);\n  return inner\n    .split(',')\n    .map((s) => s.trim().replace(/^[\"']|[\"']$/g, ''))\n    .filter((s) => s.length > 0);\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AAGzB,eAAsB,UACpB,WACA,YAAqC,QACR;AAC7B,QAAM,eAAe,MAAM,SAAS,WAAW,MAAM;AACrD,QAAM,EAAE,QAAQ,eAAe,IAAI,gBAAgB,YAAY;AAC/D,SAAO,EAAE,WAAW,cAAc,gBAAgB,QAAQ,UAAU;AACtE;AAEA,SAAS,gBAAgB,OAA6D;AACpF,QAAM,gBAAgB,gBAAgB,OAAO,UAAU;AACvD,MAAI,CAAC,cAAe,QAAO,EAAE,QAAQ,WAAW,gBAAgB,CAAC,EAAE;AACnE,QAAM,SAAS,YAAY,eAAe,QAAQ,KAAK;AACvD,QAAM,iBAAiB,UAAU,eAAe,iBAAiB,KAAK,CAAC;AACvE,SAAO,EAAE,QAAQ,eAAe;AAClC;AAEA,SAAS,gBAAgB,KAAa,MAAkC;AAOtE,QAAM,KAAK,IAAI,OAAO,MAAM,IAAI,iBAAiB,GAAG;AACpD,QAAM,QAAQ,GAAG,KAAK,GAAG;AACzB,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,YAAY,MAAM,QAAQ,MAAM,CAAC,EAAE;AACzC,MAAI,QAAQ;AACZ,WAAS,IAAI,WAAW,IAAI,IAAI,QAAQ,KAAK;AAC3C,UAAM,KAAK,IAAI,CAAC;AAChB,QAAI,OAAO,IAAK;AAAA,aACP,OAAO,KAAK;AACnB;AACA,UAAI,UAAU,EAAG,QAAO,IAAI,MAAM,WAAW,CAAC;AAAA,IAChD;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,YAAY,OAAe,KAAiC;AACnE,QAAM,MAAM,MAAM,QAAQ,GAAG,GAAG,GAAG;AACnC,MAAI,MAAM,EAAG,QAAO;AACpB,QAAM,QAAQ,MAAM,MAAM,MAAM,IAAI,SAAS,CAAC,EAAE,UAAU;AAC1D,MAAI,MAAM,WAAW,GAAG,GAAG;AACzB,UAAM,MAAM,MAAM,QAAQ,KAAK,CAAC;AAChC,QAAI,MAAM,EAAG,QAAO,MAAM,MAAM,GAAG,GAAG;AAAA,EACxC;AACA,QAAM,MAAM,MAAM,QAAQ,IAAI;AAC9B,SAAO,MAAM,MAAM,GAAG,MAAM,IAAI,SAAY,GAAG,EAAE,KAAK;AACxD;AAEA,SAAS,UAAU,OAAe,KAAmC;AACnE,QAAM,MAAM,MAAM,QAAQ,GAAG,GAAG,GAAG;AACnC,MAAI,MAAM,EAAG,QAAO;AACpB,QAAM,QAAQ,MAAM,MAAM,MAAM,IAAI,SAAS,CAAC,EAAE,UAAU;AAC1D,MAAI,CAAC,MAAM,WAAW,GAAG,EAAG,QAAO;AACnC,MAAI,QAAQ;AACZ,MAAI,MAAM;AACV,WAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACrC,QAAI,MAAM,CAAC,MAAM,IAAK;AAAA,aACb,MAAM,CAAC,MAAM,KAAK;AACzB;AACA,UAAI,UAAU,GAAG;AACf,cAAM;AACN;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACA,MAAI,MAAM,EAAG,QAAO;AACpB,QAAM,QAAQ,MAAM,MAAM,GAAG,GAAG;AAChC,SAAO,MACJ,MAAM,GAAG,EACT,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,gBAAgB,EAAE,CAAC,EAC/C,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC;AAC/B;","names":[]}

package/dist/commit-hook.d.ts

@@ -0,0 +1,22 @@
+import { spawnSync } from 'node:child_process';
+import { ExecutionResult, BoardTask, AgentIdentity } from './types.js';
+import '@holoscript/llm-provider';
+
+interface CommitHookOptions {
+    outputDir: string;
+    workingDir?: string;
+    authorName?: string;
+    authorEmail?: string;
+    scope?: string;
+    spawn?: typeof spawnSync;
+    now?: () => Date;
+}
+interface CommitHookResult {
+    filePath: string;
+    commitHash?: string;
+    staged: string[];
+    message: string;
+}
+declare function makeCommitHook(opts: CommitHookOptions): (result: ExecutionResult, task: BoardTask, identity: AgentIdentity) => Promise<CommitHookResult>;
+
+export { type CommitHookOptions, type CommitHookResult, makeCommitHook };