@holoscript/holoscript-agent 2.0.0

package/dist/commit-hook.js

@@ -0,0 +1,103 @@
+// src/commit-hook.ts
+import { mkdirSync, writeFileSync } from "fs";
+import { dirname, join, resolve } from "path";
+import { spawnSync } from "child_process";
+var SAFE_HANDLE = /^[a-z0-9_-]{1,64}$/i;
+function makeCommitHook(opts) {
+  if (!opts.outputDir || opts.outputDir.trim().length === 0) {
+    throw new Error("CommitHookOptions.outputDir is required");
+  }
+  const spawn = opts.spawn ?? spawnSync;
+  const cwd = opts.workingDir ?? process.cwd();
+  const outputDir = resolve(cwd, opts.outputDir);
+  const now = opts.now ?? (() => /* @__PURE__ */ new Date());
+  const scope = opts.scope ?? "agent";
+  return async (result, task, identity) => {
+    if (!SAFE_HANDLE.test(identity.handle)) {
+      throw new Error(`Refusing to commit: handle "${identity.handle}" must match ${SAFE_HANDLE}`);
+    }
+    const date = now().toISOString().slice(0, 10);
+    const safeTaskId = task.id.replace(/[^a-zA-Z0-9_-]/g, "_").slice(0, 80);
+    const fileName = `${date}_${safeTaskId}_${identity.handle}.md`;
+    const filePath = join(outputDir, fileName);
+    mkdirSync(dirname(filePath), { recursive: true });
+    writeFileSync(filePath, renderMemo(result, task, identity, date), "utf8");
+    const relPath = relativeTo(cwd, filePath);
+    const addRes = spawn("git", ["add", relPath], { cwd, encoding: "utf8" });
+    if (addRes.status !== 0) {
+      throw new Error(`git add failed: ${addRes.stderr || addRes.stdout || `exit ${addRes.status}`}`);
+    }
+    const message = renderCommitMessage({ scope, task, identity, result });
+    const commitArgs = ["commit", "-m", message];
+    if (opts.authorName && opts.authorEmail) {
+      commitArgs.push("--author", `${opts.authorName} <${opts.authorEmail}>`);
+    }
+    const commitRes = spawn("git", commitArgs, { cwd, encoding: "utf8" });
+    if (commitRes.status !== 0) {
+      throw new Error(`git commit failed: ${commitRes.stderr || commitRes.stdout || `exit ${commitRes.status}`}`);
+    }
+    const hashRes = spawn("git", ["rev-parse", "HEAD"], { cwd, encoding: "utf8" });
+    const commitHash = hashRes.status === 0 ? hashRes.stdout.trim() : void 0;
+    return { filePath, commitHash, staged: [relPath], message };
+  };
+}
+function renderMemo(result, task, identity, date) {
+  return [
+    "---",
+    `title: "${task.title.replace(/"/g, "'")}"`,
+    `task_id: ${task.id}`,
+    `agent: ${identity.handle}`,
+    `surface: ${identity.surface}`,
+    `provider: ${identity.llmProvider}`,
+    `model: ${identity.llmModel}`,
+    `wallet: ${identity.wallet}`,
+    `date: ${date}`,
+    `tokens: ${result.usage.totalTokens}`,
+    `cost_usd: ${result.costUsd.toFixed(4)}`,
+    `duration_ms: ${result.durationMs}`,
+    `tags: [${(task.tags ?? []).map((t) => JSON.stringify(t)).join(", ")}]`,
+    "---",
+    "",
+    `# ${task.title}`,
+    "",
+    "## Task description",
+    "",
+    task.description ?? "(no description)",
+    "",
+    "## Agent response",
+    "",
+    result.responseText.trim(),
+    ""
+  ].join("\n");
+}
+var SUBJECT_MAX = 72;
+function renderCommitMessage(opts) {
+  const suffix = ` [agent:${opts.identity.handle}]`;
+  const prefix = `${opts.scope}: `;
+  const titleBudget = Math.max(8, SUBJECT_MAX - prefix.length - suffix.length);
+  const subject = `${prefix}${truncate(opts.task.title, titleBudget)}${suffix}`;
+  const body = [
+    "",
+    `task: ${opts.task.id}`,
+    `agent: ${opts.identity.handle} (${opts.identity.llmProvider}/${opts.identity.llmModel})`,
+    `wallet: ${opts.identity.wallet}`,
+    `cost: $${opts.result.costUsd.toFixed(4)} / ${opts.result.usage.totalTokens} tok / ${opts.result.durationMs}ms`
+  ].join("\n");
+  return `${subject}
+${body}
+`;
+}
+function truncate(s, max) {
+  return s.length <= max ? s : `${s.slice(0, max - 1)}\u2026`;
+}
+function relativeTo(base, target) {
+  const b = base.replace(/\\/g, "/");
+  const t = target.replace(/\\/g, "/");
+  if (t.startsWith(b + "/")) return t.slice(b.length + 1);
+  if (t === b) return ".";
+  return t;
+}
+export {
+  makeCommitHook
+};
+//# sourceMappingURL=commit-hook.js.map

package/dist/commit-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commit-hook.ts"],"sourcesContent":["import { mkdirSync, writeFileSync } from 'node:fs';\nimport { dirname, join, resolve } from 'node:path';\nimport { spawnSync } from 'node:child_process';\nimport type { AgentIdentity, BoardTask, ExecutionResult } from './types.js';\n\nexport interface CommitHookOptions {\n  outputDir: string;\n  workingDir?: string;\n  authorName?: string;\n  authorEmail?: string;\n  scope?: string;\n  spawn?: typeof spawnSync;\n  now?: () => Date;\n}\n\nexport interface CommitHookResult {\n  filePath: string;\n  commitHash?: string;\n  staged: string[];\n  message: string;\n}\n\nconst SAFE_HANDLE = /^[a-z0-9_-]{1,64}$/i;\n\nexport function makeCommitHook(opts: CommitHookOptions) {\n  if (!opts.outputDir || opts.outputDir.trim().length === 0) {\n    throw new Error('CommitHookOptions.outputDir is required');\n  }\n  const spawn = opts.spawn ?? spawnSync;\n  const cwd = opts.workingDir ?? process.cwd();\n  const outputDir = resolve(cwd, opts.outputDir);\n  const now = opts.now ?? (() => new Date());\n  const scope = opts.scope ?? 'agent';\n\n  return async (result: ExecutionResult, task: BoardTask, identity: AgentIdentity): Promise<CommitHookResult> => {\n    if (!SAFE_HANDLE.test(identity.handle)) {\n      throw new Error(`Refusing to commit: handle \"${identity.handle}\" must match ${SAFE_HANDLE}`);\n    }\n    const date = now().toISOString().slice(0, 10);\n    const safeTaskId = task.id.replace(/[^a-zA-Z0-9_-]/g, '_').slice(0, 80);\n    const fileName = `${date}_${safeTaskId}_${identity.handle}.md`;\n    const filePath = join(outputDir, fileName);\n\n    mkdirSync(dirname(filePath), { recursive: true });\n    writeFileSync(filePath, renderMemo(result, task, identity, date), 'utf8');\n\n    const relPath = relativeTo(cwd, filePath);\n    const addRes = spawn('git', ['add', relPath], { cwd, encoding: 'utf8' });\n    if (addRes.status !== 0) {\n      throw new Error(`git add failed: ${addRes.stderr || addRes.stdout || `exit ${addRes.status}`}`);\n    }\n\n    const message = renderCommitMessage({ scope, task, identity, result });\n    const commitArgs = ['commit', '-m', message];\n    if (opts.authorName && opts.authorEmail) {\n      commitArgs.push('--author', `${opts.authorName} <${opts.authorEmail}>`);\n    }\n    const commitRes = spawn('git', commitArgs, { cwd, encoding: 'utf8' });\n    if (commitRes.status !== 0) {\n      throw new Error(`git commit failed: ${commitRes.stderr || commitRes.stdout || `exit ${commitRes.status}`}`);\n    }\n\n    const hashRes = spawn('git', ['rev-parse', 'HEAD'], { cwd, encoding: 'utf8' });\n    const commitHash = hashRes.status === 0 ? hashRes.stdout.trim() : undefined;\n\n    return { filePath, commitHash, staged: [relPath], message };\n  };\n}\n\nfunction renderMemo(result: ExecutionResult, task: BoardTask, identity: AgentIdentity, date: string): string {\n  return [\n    '---',\n    `title: \"${task.title.replace(/\"/g, \"'\")}\"`,\n    `task_id: ${task.id}`,\n    `agent: ${identity.handle}`,\n    `surface: ${identity.surface}`,\n    `provider: ${identity.llmProvider}`,\n    `model: ${identity.llmModel}`,\n    `wallet: ${identity.wallet}`,\n    `date: ${date}`,\n    `tokens: ${result.usage.totalTokens}`,\n    `cost_usd: ${result.costUsd.toFixed(4)}`,\n    `duration_ms: ${result.durationMs}`,\n    `tags: [${(task.tags ?? []).map((t) => JSON.stringify(t)).join(', ')}]`,\n    '---',\n    '',\n    `# ${task.title}`,\n    '',\n    '## Task description',\n    '',\n    task.description ?? '(no description)',\n    '',\n    '## Agent response',\n    '',\n    result.responseText.trim(),\n    '',\n  ].join('\\n');\n}\n\nconst SUBJECT_MAX = 72;\n\nfunction renderCommitMessage(opts: {\n  scope: string;\n  task: BoardTask;\n  identity: AgentIdentity;\n  result: ExecutionResult;\n}): string {\n  const suffix = ` [agent:${opts.identity.handle}]`;\n  const prefix = `${opts.scope}: `;\n  const titleBudget = Math.max(8, SUBJECT_MAX - prefix.length - suffix.length);\n  const subject = `${prefix}${truncate(opts.task.title, titleBudget)}${suffix}`;\n  const body = [\n    '',\n    `task: ${opts.task.id}`,\n    `agent: ${opts.identity.handle} (${opts.identity.llmProvider}/${opts.identity.llmModel})`,\n    `wallet: ${opts.identity.wallet}`,\n    `cost: $${opts.result.costUsd.toFixed(4)} / ${opts.result.usage.totalTokens} tok / ${opts.result.durationMs}ms`,\n  ].join('\\n');\n  return `${subject}\\n${body}\\n`;\n}\n\nfunction truncate(s: string, max: number): string {\n  return s.length <= max ? s : `${s.slice(0, max - 1)}…`;\n}\n\nfunction relativeTo(base: string, target: string): string {\n  const b = base.replace(/\\\\/g, '/');\n  const t = target.replace(/\\\\/g, '/');\n  if (t.startsWith(b + '/')) return t.slice(b.length + 1);\n  if (t === b) return '.';\n  return t;\n}\n"],"mappings":"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","names":[]}

package/dist/cost-guard.d.ts

@@ -0,0 +1,54 @@
+import { TokenUsage } from '@holoscript/llm-provider';
+import { ModelPricer, CostState } from './types.js';
+
+declare const ANTHROPIC_PRICING_USD_PER_MTOK: Record<string, {
+    input: number;
+    output: number;
+}>;
+declare function defaultAnthropicPricer(model: string, usage: TokenUsage): number;
+/**
+ * Pricer for local-llm providers (vLLM-on-GPU). The compute cost is the
+ * Vast.ai (or other GPU) hourly rental, NOT per-token. From the agent's
+ * perspective each LLM call has $0 marginal cost — the budget guard for
+ * local-llm should track tick count or wall-clock time, not tokens.
+ *
+ * Returns 0 unconditionally. Token counts are still recorded in CostState
+ * so usage analytics work, but cost-guard never trips on token spend.
+ */
+declare function defaultLocalLlmPricer(_model: string, _usage: TokenUsage): number;
+/**
+ * Provider-aware default pricer dispatch. Picks the right pricer by
+ * provider so the holoscript-agent runtime works for both Anthropic
+ * (per-token billing) and local-llm (compute already paid via GPU
+ * rental) without a custom pricer at every call site.
+ *
+ * Refs: 2026-04-26 mw02 boot loop — local-llm workers tick-erroring with
+ * "No pricing configured for model 'Qwen/Qwen2.5-0.5B-Instruct'" because
+ * defaultAnthropicPricer was wired in for ALL providers regardless of
+ * which LLM the agent uses.
+ */
+declare function defaultPricerForProvider(provider: 'anthropic' | 'local-llm' | 'openai' | string): ModelPricer;
+declare class CostGuard {
+    private state;
+    private readonly statePath;
+    private readonly dailyBudgetUsd;
+    private readonly pricer;
+    constructor(opts: {
+        statePath: string;
+        dailyBudgetUsd: number;
+        pricer?: ModelPricer;
+    });
+    recordUsage(model: string, usage: TokenUsage): {
+        costUsd: number;
+        spentUsd: number;
+        remainingUsd: number;
+    };
+    isOverBudget(): boolean;
+    getRemainingUsd(): number;
+    getState(): Readonly<CostState>;
+    private rolloverIfNewDay;
+    private loadOrInit;
+    private persist;
+}
+
+export { ANTHROPIC_PRICING_USD_PER_MTOK, CostGuard, defaultAnthropicPricer, defaultLocalLlmPricer, defaultPricerForProvider };

package/dist/cost-guard.js

@@ -0,0 +1,92 @@
+// src/cost-guard.ts
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { dirname } from "path";
+var ANTHROPIC_PRICING_USD_PER_MTOK = {
+  "claude-opus-4-7": { input: 15, output: 75 },
+  "claude-opus-4-6": { input: 15, output: 75 },
+  "claude-sonnet-4-6": { input: 3, output: 15 },
+  "claude-haiku-4-5-20251001": { input: 1, output: 5 },
+  "claude-haiku-4-5": { input: 1, output: 5 }
+};
+function defaultAnthropicPricer(model, usage) {
+  const price = ANTHROPIC_PRICING_USD_PER_MTOK[model];
+  if (!price) {
+    throw new Error(
+      `No pricing configured for model "${model}" \u2014 add to ANTHROPIC_PRICING_USD_PER_MTOK or pass a custom pricer`
+    );
+  }
+  return (usage.promptTokens * price.input + usage.completionTokens * price.output) / 1e6;
+}
+function defaultLocalLlmPricer(_model, _usage) {
+  return 0;
+}
+function defaultPricerForProvider(provider) {
+  if (provider === "local-llm" || provider === "mock") return defaultLocalLlmPricer;
+  return defaultAnthropicPricer;
+}
+var CostGuard = class {
+  constructor(opts) {
+    this.statePath = opts.statePath;
+    this.dailyBudgetUsd = opts.dailyBudgetUsd;
+    this.pricer = opts.pricer ?? defaultAnthropicPricer;
+    this.state = this.loadOrInit();
+  }
+  recordUsage(model, usage) {
+    this.rolloverIfNewDay();
+    const costUsd = this.pricer(model, usage);
+    this.state.spentUsd += costUsd;
+    this.state.promptTokens += usage.promptTokens;
+    this.state.completionTokens += usage.completionTokens;
+    this.state.callCount += 1;
+    this.persist();
+    return {
+      costUsd,
+      spentUsd: this.state.spentUsd,
+      remainingUsd: Math.max(0, this.dailyBudgetUsd - this.state.spentUsd)
+    };
+  }
+  isOverBudget() {
+    if (this.dailyBudgetUsd === 0) return false;
+    this.rolloverIfNewDay();
+    return this.state.spentUsd >= this.dailyBudgetUsd;
+  }
+  getRemainingUsd() {
+    if (this.dailyBudgetUsd === 0) return Number.POSITIVE_INFINITY;
+    this.rolloverIfNewDay();
+    return Math.max(0, this.dailyBudgetUsd - this.state.spentUsd);
+  }
+  getState() {
+    this.rolloverIfNewDay();
+    return { ...this.state };
+  }
+  rolloverIfNewDay() {
+    const today = todayUtc();
+    if (this.state.date !== today) {
+      this.state = { date: today, spentUsd: 0, promptTokens: 0, completionTokens: 0, callCount: 0 };
+      this.persist();
+    }
+  }
+  loadOrInit() {
+    if (existsSync(this.statePath)) {
+      const raw = readFileSync(this.statePath, "utf8");
+      const parsed = JSON.parse(raw);
+      if (parsed.date === todayUtc()) return parsed;
+    }
+    return { date: todayUtc(), spentUsd: 0, promptTokens: 0, completionTokens: 0, callCount: 0 };
+  }
+  persist() {
+    mkdirSync(dirname(this.statePath), { recursive: true });
+    writeFileSync(this.statePath, JSON.stringify(this.state, null, 2), "utf8");
+  }
+};
+function todayUtc() {
+  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+}
+export {
+  ANTHROPIC_PRICING_USD_PER_MTOK,
+  CostGuard,
+  defaultAnthropicPricer,
+  defaultLocalLlmPricer,
+  defaultPricerForProvider
+};
+//# sourceMappingURL=cost-guard.js.map

package/dist/cost-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cost-guard.ts"],"sourcesContent":["import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';\nimport { dirname } from 'node:path';\nimport type { TokenUsage } from '@holoscript/llm-provider';\nimport type { CostState, ModelPricer } from './types.js';\n\nexport const ANTHROPIC_PRICING_USD_PER_MTOK: Record<string, { input: number; output: number }> = {\n  'claude-opus-4-7': { input: 15, output: 75 },\n  'claude-opus-4-6': { input: 15, output: 75 },\n  'claude-sonnet-4-6': { input: 3, output: 15 },\n  'claude-haiku-4-5-20251001': { input: 1, output: 5 },\n  'claude-haiku-4-5': { input: 1, output: 5 },\n};\n\nexport function defaultAnthropicPricer(model: string, usage: TokenUsage): number {\n  const price = ANTHROPIC_PRICING_USD_PER_MTOK[model];\n  if (!price) {\n    throw new Error(\n      `No pricing configured for model \"${model}\" — add to ANTHROPIC_PRICING_USD_PER_MTOK or pass a custom pricer`\n    );\n  }\n  return (usage.promptTokens * price.input + usage.completionTokens * price.output) / 1_000_000;\n}\n\n/**\n * Pricer for local-llm providers (vLLM-on-GPU). The compute cost is the\n * Vast.ai (or other GPU) hourly rental, NOT per-token. From the agent's\n * perspective each LLM call has $0 marginal cost — the budget guard for\n * local-llm should track tick count or wall-clock time, not tokens.\n *\n * Returns 0 unconditionally. Token counts are still recorded in CostState\n * so usage analytics work, but cost-guard never trips on token spend.\n */\nexport function defaultLocalLlmPricer(_model: string, _usage: TokenUsage): number {\n  return 0;\n}\n\n/**\n * Provider-aware default pricer dispatch. Picks the right pricer by\n * provider so the holoscript-agent runtime works for both Anthropic\n * (per-token billing) and local-llm (compute already paid via GPU\n * rental) without a custom pricer at every call site.\n *\n * Refs: 2026-04-26 mw02 boot loop — local-llm workers tick-erroring with\n * \"No pricing configured for model 'Qwen/Qwen2.5-0.5B-Instruct'\" because\n * defaultAnthropicPricer was wired in for ALL providers regardless of\n * which LLM the agent uses.\n */\nexport function defaultPricerForProvider(\n  provider: 'anthropic' | 'local-llm' | 'openai' | string\n): ModelPricer {\n  if (provider === 'local-llm' || provider === 'mock') return defaultLocalLlmPricer;\n  return defaultAnthropicPricer;\n}\n\nexport class CostGuard {\n  private state: CostState;\n  private readonly statePath: string;\n  private readonly dailyBudgetUsd: number;\n  private readonly pricer: ModelPricer;\n\n  constructor(opts: { statePath: string; dailyBudgetUsd: number; pricer?: ModelPricer }) {\n    this.statePath = opts.statePath;\n    this.dailyBudgetUsd = opts.dailyBudgetUsd;\n    this.pricer = opts.pricer ?? defaultAnthropicPricer;\n    this.state = this.loadOrInit();\n  }\n\n  recordUsage(model: string, usage: TokenUsage): { costUsd: number; spentUsd: number; remainingUsd: number } {\n    this.rolloverIfNewDay();\n    const costUsd = this.pricer(model, usage);\n    this.state.spentUsd += costUsd;\n    this.state.promptTokens += usage.promptTokens;\n    this.state.completionTokens += usage.completionTokens;\n    this.state.callCount += 1;\n    this.persist();\n    return {\n      costUsd,\n      spentUsd: this.state.spentUsd,\n      remainingUsd: Math.max(0, this.dailyBudgetUsd - this.state.spentUsd),\n    };\n  }\n\n  isOverBudget(): boolean {\n    if (this.dailyBudgetUsd === 0) return false;\n    this.rolloverIfNewDay();\n    return this.state.spentUsd >= this.dailyBudgetUsd;\n  }\n\n  getRemainingUsd(): number {\n    if (this.dailyBudgetUsd === 0) return Number.POSITIVE_INFINITY;\n    this.rolloverIfNewDay();\n    return Math.max(0, this.dailyBudgetUsd - this.state.spentUsd);\n  }\n\n  getState(): Readonly<CostState> {\n    this.rolloverIfNewDay();\n    return { ...this.state };\n  }\n\n  private rolloverIfNewDay(): void {\n    const today = todayUtc();\n    if (this.state.date !== today) {\n      this.state = { date: today, spentUsd: 0, promptTokens: 0, completionTokens: 0, callCount: 0 };\n      this.persist();\n    }\n  }\n\n  private loadOrInit(): CostState {\n    if (existsSync(this.statePath)) {\n      const raw = readFileSync(this.statePath, 'utf8');\n      const parsed = JSON.parse(raw) as CostState;\n      if (parsed.date === todayUtc()) return parsed;\n    }\n    return { date: todayUtc(), spentUsd: 0, promptTokens: 0, completionTokens: 0, callCount: 0 };\n  }\n\n  private persist(): void {\n    mkdirSync(dirname(this.statePath), { recursive: true });\n    writeFileSync(this.statePath, JSON.stringify(this.state, null, 2), 'utf8');\n  }\n}\n\nfunction todayUtc(): string {\n  return new Date().toISOString().slice(0, 10);\n}\n"],"mappings":"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","names":[]}

package/dist/holomesh-client.d.ts

@@ -0,0 +1,63 @@
+import { BoardTask } from './types.js';
+import '@holoscript/llm-provider';
+
+interface CaelAuditRecord {
+    tick_iso: string;
+    layer_hashes: string[];
+    operation: string;
+    prev_hash: string | null;
+    fnv1a_chain: string;
+    version_vector_fingerprint: string;
+    brain_class?: string;
+    trial?: number;
+    attack_class?: string;
+    defense_state?: string;
+}
+
+interface HolomeshClientOptions {
+    apiBase: string;
+    bearer: string;
+    teamId: string;
+    fetchImpl?: typeof fetch;
+}
+declare class HolomeshClient {
+    private readonly apiBase;
+    private readonly bearer;
+    private readonly teamId;
+    private readonly fetchImpl;
+    constructor(opts: HolomeshClientOptions);
+    heartbeat(payload: {
+        agentName: string;
+        surface: string;
+    }): Promise<void>;
+    getOpenTasks(): Promise<BoardTask[]>;
+    claim(taskId: string): Promise<BoardTask>;
+    joinTeam(): Promise<{
+        success: boolean;
+        role?: string;
+        members?: number;
+    }>;
+    sendMessageOnTask(taskId: string, body: string): Promise<void>;
+    markDone(taskId: string, summary: string, commitHash?: string): Promise<void>;
+    postAuditRecords(handle: string, records: CaelAuditRecord[]): Promise<{
+        appended: number;
+        rejected: number;
+    }>;
+    whoAmI(): Promise<{
+        agentId: string;
+        surface: string;
+        wallet?: string;
+    }>;
+    private req;
+}
+/**
+ * Derive a surface tag from a seat name returned by /me. Mirrors the surface
+ * detection in scripts/probe-surface-bearers.mjs and hooks/lib/holomesh-env.mjs
+ * so a single agent's surface attribution is consistent across read and write
+ * paths. Returns 'unknown' when the seat name doesn't encode a surface
+ * (e.g. shared-key resolution to "Founder").
+ */
+declare function deriveSurface(seatName: string | undefined): string;
+declare function pickClaimableTask(tasks: BoardTask[], brainCapabilityTags: string[]): BoardTask | undefined;
+
+export { HolomeshClient, type HolomeshClientOptions, deriveSurface, pickClaimableTask };

package/dist/holomesh-client.js

@@ -0,0 +1,117 @@
+// src/holomesh-client.ts
+var HolomeshClient = class {
+  constructor(opts) {
+    this.apiBase = opts.apiBase.replace(/\/$/, "");
+    this.bearer = opts.bearer;
+    this.teamId = opts.teamId;
+    this.fetchImpl = opts.fetchImpl ?? fetch;
+  }
+  async heartbeat(payload) {
+    await this.req("POST", `/team/${this.teamId}/presence`, payload);
+  }
+  async getOpenTasks() {
+    const data = await this.req(
+      "GET",
+      `/team/${this.teamId}/board`
+    );
+    return data.tasks ?? data.open ?? [];
+  }
+  async claim(taskId) {
+    return this.req("PATCH", `/team/${this.teamId}/board/${taskId}`, { action: "claim" });
+  }
+  async joinTeam() {
+    return this.req(
+      "POST",
+      `/team/${this.teamId}/join`,
+      {}
+    );
+  }
+  async sendMessageOnTask(taskId, body) {
+    await this.req("POST", `/team/${this.teamId}/message`, {
+      to: "team",
+      subject: `task:${taskId}`,
+      content: body
+    });
+  }
+  async markDone(taskId, summary, commitHash) {
+    await this.req("PATCH", `/team/${this.teamId}/board/${taskId}`, {
+      action: "done",
+      summary,
+      commitHash
+    });
+  }
+  // POST CAEL audit records for this agent. Server validator at
+  // packages/mcp-server/src/holomesh/routes/core-routes.ts:472-533 requires
+  // bearer == handle owner OR founder; the per-surface x402 bearer is the
+  // handle owner so this resolves correctly. Records that fail shape
+  // validation (layer_hashes != 7 elements, missing tick_iso/operation/
+  // fnv1a_chain) are silently dropped server-side, not rejected as a batch.
+  async postAuditRecords(handle, records) {
+    return this.req(
+      "POST",
+      `/agent/${encodeURIComponent(handle)}/audit`,
+      { records }
+    );
+  }
+  async whoAmI() {
+    const raw = await this.req("GET", "/me");
+    return {
+      agentId: raw.agentId,
+      surface: deriveSurface(raw.name),
+      wallet: raw.wallet
+    };
+  }
+  async req(method, path, body) {
+    const url = `${this.apiBase}${path}`;
+    const res = await this.fetchImpl(url, {
+      method,
+      headers: {
+        Authorization: `Bearer ${this.bearer}`,
+        "content-type": "application/json"
+      },
+      body: body ? JSON.stringify(body) : void 0
+    });
+    if (!res.ok) {
+      const txt = await res.text().catch(() => "");
+      throw new Error(`HoloMesh ${method} ${path} ${res.status}: ${txt.slice(0, 300)}`);
+    }
+    if (res.status === 204) return void 0;
+    return await res.json();
+  }
+};
+function deriveSurface(seatName) {
+  if (!seatName) return "unknown";
+  const n = seatName.toLowerCase();
+  if (n.startsWith("claudecode")) return "claude-code";
+  if (n.startsWith("cursor")) return "claude-cursor";
+  if (n.startsWith("claudedesktop")) return "claude-desktop";
+  if (n.startsWith("vscode-claude") || n.startsWith("claude-vscode")) return "claude-vscode";
+  if (n.startsWith("gemini")) return "gemini-antigravity";
+  if (n.startsWith("copilot")) return "copilot-vscode";
+  return "unknown";
+}
+function pickClaimableTask(tasks, brainCapabilityTags) {
+  const wanted = new Set(brainCapabilityTags.map((t) => t.toLowerCase()));
+  const open = tasks.filter((t) => t.status === "open" && !t.claimedBy);
+  const scored = open.map((t) => ({ task: t, score: scoreTask(t, wanted) })).filter((s) => s.score > 0).sort((a, b) => b.score - a.score || priority(a.task) - priority(b.task));
+  return scored[0]?.task;
+}
+function scoreTask(task, wanted) {
+  const tags = (task.tags ?? []).map((t) => t.toLowerCase());
+  const text = `${task.title} ${task.description ?? ""}`.toLowerCase();
+  let score = 0;
+  for (const tag of tags) if (wanted.has(tag)) score += 2;
+  for (const w of wanted) if (text.includes(w)) score += 1;
+  return score;
+}
+function priority(t) {
+  if (typeof t.priority === "number") return t.priority;
+  const map = { critical: 1, high: 2, medium: 4, low: 6 };
+  return map[String(t.priority).toLowerCase()] ?? 5;
+}
+export {
+  HolomeshClient,
+  deriveSurface,
+  pickClaimableTask
+};
+//# sourceMappingURL=holomesh-client.js.map

package/dist/holomesh-client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/holomesh-client.ts"],"sourcesContent":["import type { BoardTask } from './types.js';\nimport type { CaelAuditRecord } from './cael-builder.js';\n\nexport interface HolomeshClientOptions {\n  apiBase: string;\n  bearer: string;\n  teamId: string;\n  fetchImpl?: typeof fetch;\n}\n\nexport class HolomeshClient {\n  private readonly apiBase: string;\n  private readonly bearer: string;\n  private readonly teamId: string;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(opts: HolomeshClientOptions) {\n    this.apiBase = opts.apiBase.replace(/\\/$/, '');\n    this.bearer = opts.bearer;\n    this.teamId = opts.teamId;\n    this.fetchImpl = opts.fetchImpl ?? fetch;\n  }\n\n  async heartbeat(payload: { agentName: string; surface: string }): Promise<void> {\n    await this.req('POST', `/team/${this.teamId}/presence`, payload);\n  }\n\n  async getOpenTasks(): Promise<BoardTask[]> {\n    const data = await this.req<{ tasks?: BoardTask[]; open?: BoardTask[] }>(\n      'GET',\n      `/team/${this.teamId}/board`\n    );\n    return data.tasks ?? data.open ?? [];\n  }\n\n  async claim(taskId: string): Promise<BoardTask> {\n    return this.req<BoardTask>('PATCH', `/team/${this.teamId}/board/${taskId}`, { action: 'claim' });\n  }\n\n  async joinTeam(): Promise<{ success: boolean; role?: string; members?: number }> {\n    return this.req<{ success: boolean; role?: string; members?: number }>(\n      'POST',\n      `/team/${this.teamId}/join`,\n      {}\n    );\n  }\n\n  async sendMessageOnTask(taskId: string, body: string): Promise<void> {\n    await this.req('POST', `/team/${this.teamId}/message`, {\n      to: 'team',\n      subject: `task:${taskId}`,\n      content: body,\n    });\n  }\n\n  async markDone(taskId: string, summary: string, commitHash?: string): Promise<void> {\n    await this.req('PATCH', `/team/${this.teamId}/board/${taskId}`, {\n      action: 'done',\n      summary,\n      commitHash,\n    });\n  }\n\n  // POST CAEL audit records for this agent. Server validator at\n  // packages/mcp-server/src/holomesh/routes/core-routes.ts:472-533 requires\n  // bearer == handle owner OR founder; the per-surface x402 bearer is the\n  // handle owner so this resolves correctly. Records that fail shape\n  // validation (layer_hashes != 7 elements, missing tick_iso/operation/\n  // fnv1a_chain) are silently dropped server-side, not rejected as a batch.\n  async postAuditRecords(handle: string, records: CaelAuditRecord[]): Promise<{ appended: number; rejected: number }> {\n    return this.req<{ appended: number; rejected: number }>(\n      'POST',\n      `/agent/${encodeURIComponent(handle)}/audit`,\n      { records }\n    );\n  }\n\n  async whoAmI(): Promise<{ agentId: string; surface: string; wallet?: string }> {\n    // GET /api/holomesh/me returns { agentId, name, wallet, isFounder, teamId, teams, permissions }\n    // (see packages/mcp-server/src/holomesh/routes/core-routes.ts §/me handler).\n    // It does NOT return a `surface` field — derive it from the seat name on the\n    // client side. Seat naming convention (set by the provisioning admin path):\n    //   claudecode-claude-x402  → claude-code\n    //   cursor-claude-x402      → claude-cursor\n    //   gemini-antigravity      → gemini-antigravity\n    //   copilot-vscode          → copilot-vscode\n    //   Founder                 → unknown (shared key, no surface attribution)\n    const raw = await this.req<{\n      agentId: string;\n      name?: string;\n      wallet?: string;\n    }>('GET', '/me');\n    return {\n      agentId: raw.agentId,\n      surface: deriveSurface(raw.name),\n      wallet: raw.wallet,\n    };\n  }\n\n  private async req<T>(method: string, path: string, body?: unknown): Promise<T> {\n    const url = `${this.apiBase}${path}`;\n    // HoloMesh REST auth: server (packages/mcp-server/src/holomesh/auth-utils.ts\n    // resolveRequestingAgent) accepts EITHER `Authorization: Bearer <token>`\n    // (HTTP-standard, used here) OR `x-mcp-api-key: <token>` (orchestrator\n    // convention). Both resolve through the same key-registry / agent-store /\n    // env-fallback chain. Bearer is preferred for new code (W.087 vertex B,\n    // task_1777073616424_klls).\n    const res = await this.fetchImpl(url, {\n      method,\n      headers: {\n        Authorization: `Bearer ${this.bearer}`,\n        'content-type': 'application/json',\n      },\n      body: body ? JSON.stringify(body) : undefined,\n    });\n    if (!res.ok) {\n      const txt = await res.text().catch(() => '');\n      throw new Error(`HoloMesh ${method} ${path} ${res.status}: ${txt.slice(0, 300)}`);\n    }\n    if (res.status === 204) return undefined as T;\n    return (await res.json()) as T;\n  }\n}\n\n/**\n * Derive a surface tag from a seat name returned by /me. Mirrors the surface\n * detection in scripts/probe-surface-bearers.mjs and hooks/lib/holomesh-env.mjs\n * so a single agent's surface attribution is consistent across read and write\n * paths. Returns 'unknown' when the seat name doesn't encode a surface\n * (e.g. shared-key resolution to \"Founder\").\n */\nexport function deriveSurface(seatName: string | undefined): string {\n  if (!seatName) return 'unknown';\n  const n = seatName.toLowerCase();\n  if (n.startsWith('claudecode')) return 'claude-code';\n  if (n.startsWith('cursor')) return 'claude-cursor';\n  if (n.startsWith('claudedesktop')) return 'claude-desktop';\n  if (n.startsWith('vscode-claude') || n.startsWith('claude-vscode')) return 'claude-vscode';\n  if (n.startsWith('gemini')) return 'gemini-antigravity';\n  if (n.startsWith('copilot')) return 'copilot-vscode';\n  return 'unknown';\n}\n\nexport function pickClaimableTask(\n  tasks: BoardTask[],\n  brainCapabilityTags: string[]\n): BoardTask | undefined {\n  const wanted = new Set(brainCapabilityTags.map((t) => t.toLowerCase()));\n  const open = tasks.filter((t) => t.status === 'open' && !t.claimedBy);\n  const scored = open\n    .map((t) => ({ task: t, score: scoreTask(t, wanted) }))\n    .filter((s) => s.score > 0)\n    .sort((a, b) => b.score - a.score || priority(a.task) - priority(b.task));\n  return scored[0]?.task;\n}\n\nfunction scoreTask(task: BoardTask, wanted: Set<string>): number {\n  const tags = (task.tags ?? []).map((t) => t.toLowerCase());\n  const text = `${task.title} ${task.description ?? ''}`.toLowerCase();\n  let score = 0;\n  for (const tag of tags) if (wanted.has(tag)) score += 2;\n  for (const w of wanted) if (text.includes(w)) score += 1;\n  return score;\n}\n\nfunction priority(t: BoardTask): number {\n  if (typeof t.priority === 'number') return t.priority;\n  const map: Record<string, number> = { critical: 1, high: 2, medium: 4, low: 6 };\n  return map[String(t.priority).toLowerCase()] ?? 5;\n}\n"],"mappings":"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","names":[]}

package/dist/identity.d.ts

@@ -0,0 +1,7 @@
+import { AgentIdentity } from './types.js';
+import '@holoscript/llm-provider';
+
+declare function loadIdentity(env?: NodeJS.ProcessEnv): AgentIdentity;
+declare function identityForLog(id: AgentIdentity): Record<string, string | number>;
+
+export { identityForLog, loadIdentity };

package/dist/identity.js

@@ -0,0 +1,64 @@
+// src/identity.ts
+var VALID_PROVIDERS = /* @__PURE__ */ new Set([
+  "anthropic",
+  "openai",
+  "gemini",
+  "mock",
+  "bitnet",
+  "local-llm"
+]);
+function loadIdentity(env = process.env) {
+  const handle = required(env, "HOLOSCRIPT_AGENT_HANDLE");
+  const provider = required(env, "HOLOSCRIPT_AGENT_PROVIDER");
+  if (!VALID_PROVIDERS.has(provider)) {
+    throw new Error(
+      `HOLOSCRIPT_AGENT_PROVIDER=${provider} not in [${[...VALID_PROVIDERS].join(", ")}]`
+    );
+  }
+  const x402Bearer = required(env, "HOLOSCRIPT_AGENT_X402_BEARER");
+  const wallet = required(env, "HOLOSCRIPT_AGENT_WALLET");
+  if (!/^0x[0-9a-fA-F]{40}$/.test(wallet)) {
+    throw new Error(`HOLOSCRIPT_AGENT_WALLET is not a 0x-prefixed 40-hex address: ${wallet}`);
+  }
+  const budgetRaw = env.HOLOSCRIPT_AGENT_BUDGET_USD_DAY ?? "5";
+  const budget = Number(budgetRaw);
+  if (!Number.isFinite(budget) || budget < 0) {
+    throw new Error(`HOLOSCRIPT_AGENT_BUDGET_USD_DAY must be >= 0 (0 = unlimited), got ${budgetRaw}`);
+  }
+  return {
+    handle,
+    surface: env.HOLOSCRIPT_AGENT_SURFACE ?? handle,
+    wallet,
+    x402Bearer,
+    llmProvider: provider,
+    llmModel: required(env, "HOLOSCRIPT_AGENT_MODEL"),
+    brainPath: required(env, "HOLOSCRIPT_AGENT_BRAIN"),
+    budgetUsdPerDay: budget,
+    teamId: required(env, "HOLOMESH_TEAM_ID"),
+    meshApiBase: env.HOLOMESH_API_BASE ?? "https://mcp.holoscript.net/api/holomesh"
+  };
+}
+function required(env, key) {
+  const v = env[key];
+  if (!v || v.trim().length === 0) {
+    throw new Error(`Missing required env var: ${key}`);
+  }
+  return v.trim();
+}
+function identityForLog(id) {
+  return {
+    handle: id.handle,
+    surface: id.surface,
+    wallet: `${id.wallet.slice(0, 6)}\u2026${id.wallet.slice(-4)}`,
+    bearer: `${id.x402Bearer.slice(0, 6)}\u2026`,
+    provider: id.llmProvider,
+    model: id.llmModel,
+    brain: id.brainPath,
+    budgetUsdPerDay: id.budgetUsdPerDay
+  };
+}
+export {
+  identityForLog,
+  loadIdentity
+};
+//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/identity.ts"],"sourcesContent":["import type { LLMProviderName } from '@holoscript/llm-provider';\nimport type { AgentIdentity } from './types.js';\n\nconst VALID_PROVIDERS: ReadonlySet<LLMProviderName> = new Set([\n  'anthropic',\n  'openai',\n  'gemini',\n  'mock',\n  'bitnet',\n  'local-llm',\n]);\n\nexport function loadIdentity(env: NodeJS.ProcessEnv = process.env): AgentIdentity {\n  const handle = required(env, 'HOLOSCRIPT_AGENT_HANDLE');\n  const provider = required(env, 'HOLOSCRIPT_AGENT_PROVIDER');\n  if (!VALID_PROVIDERS.has(provider as LLMProviderName)) {\n    throw new Error(\n      `HOLOSCRIPT_AGENT_PROVIDER=${provider} not in [${[...VALID_PROVIDERS].join(', ')}]`\n    );\n  }\n  const x402Bearer = required(env, 'HOLOSCRIPT_AGENT_X402_BEARER');\n  const wallet = required(env, 'HOLOSCRIPT_AGENT_WALLET');\n  if (!/^0x[0-9a-fA-F]{40}$/.test(wallet)) {\n    throw new Error(`HOLOSCRIPT_AGENT_WALLET is not a 0x-prefixed 40-hex address: ${wallet}`);\n  }\n  const budgetRaw = env.HOLOSCRIPT_AGENT_BUDGET_USD_DAY ?? '5';\n  const budget = Number(budgetRaw);\n  if (!Number.isFinite(budget) || budget < 0) {\n    throw new Error(`HOLOSCRIPT_AGENT_BUDGET_USD_DAY must be >= 0 (0 = unlimited), got ${budgetRaw}`);\n  }\n\n  return {\n    handle,\n    surface: env.HOLOSCRIPT_AGENT_SURFACE ?? handle,\n    wallet,\n    x402Bearer,\n    llmProvider: provider as LLMProviderName,\n    llmModel: required(env, 'HOLOSCRIPT_AGENT_MODEL'),\n    brainPath: required(env, 'HOLOSCRIPT_AGENT_BRAIN'),\n    budgetUsdPerDay: budget,\n    teamId: required(env, 'HOLOMESH_TEAM_ID'),\n    meshApiBase: env.HOLOMESH_API_BASE ?? 'https://mcp.holoscript.net/api/holomesh',\n  };\n}\n\nfunction required(env: NodeJS.ProcessEnv, key: string): string {\n  const v = env[key];\n  if (!v || v.trim().length === 0) {\n    throw new Error(`Missing required env var: ${key}`);\n  }\n  return v.trim();\n}\n\nexport function identityForLog(id: AgentIdentity): Record<string, string | number> {\n  return {\n    handle: id.handle,\n    surface: id.surface,\n    wallet: `${id.wallet.slice(0, 6)}…${id.wallet.slice(-4)}`,\n    bearer: `${id.x402Bearer.slice(0, 6)}…`,\n    provider: id.llmProvider,\n    model: id.llmModel,\n    brain: id.brainPath,\n    budgetUsdPerDay: id.budgetUsdPerDay,\n  };\n}\n"],"mappings":";AAGA,IAAM,kBAAgD,oBAAI,IAAI;AAAA,EAC5D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,SAAS,aAAa,MAAyB,QAAQ,KAAoB;AAChF,QAAM,SAAS,SAAS,KAAK,yBAAyB;AACtD,QAAM,WAAW,SAAS,KAAK,2BAA2B;AAC1D,MAAI,CAAC,gBAAgB,IAAI,QAA2B,GAAG;AACrD,UAAM,IAAI;AAAA,MACR,6BAA6B,QAAQ,YAAY,CAAC,GAAG,eAAe,EAAE,KAAK,IAAI,CAAC;AAAA,IAClF;AAAA,EACF;AACA,QAAM,aAAa,SAAS,KAAK,8BAA8B;AAC/D,QAAM,SAAS,SAAS,KAAK,yBAAyB;AACtD,MAAI,CAAC,sBAAsB,KAAK,MAAM,GAAG;AACvC,UAAM,IAAI,MAAM,gEAAgE,MAAM,EAAE;AAAA,EAC1F;AACA,QAAM,YAAY,IAAI,mCAAmC;AACzD,QAAM,SAAS,OAAO,SAAS;AAC/B,MAAI,CAAC,OAAO,SAAS,MAAM,KAAK,SAAS,GAAG;AAC1C,UAAM,IAAI,MAAM,qEAAqE,SAAS,EAAE;AAAA,EAClG;AAEA,SAAO;AAAA,IACL;AAAA,IACA,SAAS,IAAI,4BAA4B;AAAA,IACzC;AAAA,IACA;AAAA,IACA,aAAa;AAAA,IACb,UAAU,SAAS,KAAK,wBAAwB;AAAA,IAChD,WAAW,SAAS,KAAK,wBAAwB;AAAA,IACjD,iBAAiB;AAAA,IACjB,QAAQ,SAAS,KAAK,kBAAkB;AAAA,IACxC,aAAa,IAAI,qBAAqB;AAAA,EACxC;AACF;AAEA,SAAS,SAAS,KAAwB,KAAqB;AAC7D,QAAM,IAAI,IAAI,GAAG;AACjB,MAAI,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,GAAG;AAC/B,UAAM,IAAI,MAAM,6BAA6B,GAAG,EAAE;AAAA,EACpD;AACA,SAAO,EAAE,KAAK;AAChB;AAEO,SAAS,eAAe,IAAoD;AACjF,SAAO;AAAA,IACL,QAAQ,GAAG;AAAA,IACX,SAAS,GAAG;AAAA,IACZ,QAAQ,GAAG,GAAG,OAAO,MAAM,GAAG,CAAC,CAAC,SAAI,GAAG,OAAO,MAAM,EAAE,CAAC;AAAA,IACvD,QAAQ,GAAG,GAAG,WAAW,MAAM,GAAG,CAAC,CAAC;AAAA,IACpC,UAAU,GAAG;AAAA,IACb,OAAO,GAAG;AAAA,IACV,OAAO,GAAG;AAAA,IACV,iBAAiB,GAAG;AAAA,EACtB;AACF;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node