@holoscript/holoscript-agent 2.0.0 → 2.0.2

package/dist/types.d.ts

@@ -18,6 +18,43 @@ interface RuntimeBrainConfig {
     capabilityTags: string[];
     domain: string;
     scopeTier: 'cold' | 'warm' | 'hot';
+    /**
+     * Capability keys (from `Capabilities` in @holoscript/llm-provider) that
+     * this brain MUST have. Router refuses to assign the brain to a provider
+     * whose manifest doesn't satisfy every entry. Empty array (default) =
+     * open routing — matches today's behavior, backward-compatible.
+     *
+     * Per founder ruling 2026-05-06 (universal+segregated foundation): brains
+     * declare needs as data; router does set arithmetic at session start.
+     * `HOLOSCRIPT_AGENT_PROVIDER` env becomes override, not source-of-truth.
+     */
+    requires: string[];
+    /**
+     * Capability keys this brain prefers but doesn't require. Router uses
+     * to break ties between candidates that all satisfy `requires`.
+     * Empty array (default) = no preference.
+     */
+    prefers: string[];
+    /**
+     * Capability keys this brain explicitly avoids. Router excludes any
+     * provider whose manifest declares any of these capabilities (e.g.
+     * a privacy-sensitive brain may avoid `liveWebSearch`).
+     * Empty array (default) = no exclusions.
+     */
+    avoids: string[];
+    /**
+     * Optional cognitive self-evaluation gate — the brain's `reflect` verb (W.736).
+     * When the brain declares a `reflect { criteria, escalate_on_fail }` block, the
+     * runner runs one self-evaluation pass over the produced artifact before
+     * accepting it. With `escalateOnFail: true` a failed self-evaluation escalates
+     * to the fleet (the `local_first` directive) instead of marking the task done;
+     * otherwise the verdict is advisory (logged + recorded, never blocks).
+     * Absent (default) = no reflect pass — existing brains are unaffected.
+     */
+    reflect?: {
+        criteria: string;
+        escalateOnFail: boolean;
+    };
 }
 interface CostState {
     date: string;
@@ -40,11 +77,16 @@ interface BoardTask {
     claimedBy?: string;
 }
 interface TickResult {
-    action: 'heartbeat-only' | 'over-budget' | 'no-claimable-task' | 'claimed' | 'executed' | 'errored' | 'no-artifact';
+    action: 'heartbeat-only' | 'over-budget' | 'no-claimable-task' | 'claimed' | 'executed' | 'errored' | 'no-artifact' | 'reflect-escalate' | 'messages-processed';
     taskId?: string;
     spentUsd: number;
     remainingUsd: number;
     message?: string;
+    receipts?: Array<{
+        status: string;
+        action: string;
+        reason: string;
+    }>;
 }
 interface ExecutionResult {
     taskId: string;

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "@holoscript/holoscript-agent",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "Headless agent runtime for the HoloMesh — multi-LLM-provider, brain-mounted, cost-guarded. Closes W.087 vertex B.",
   "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
-    "holoscript-agent": "./dist/index.js"
+    "holoscript-agent": "./bin/holoscript-agent.cjs"
   },
   "exports": {
     ".": {
@@ -56,6 +59,7 @@
     }
   },
   "files": [
+    "bin",
     "dist"
   ],
   "keywords": [
@@ -82,18 +86,19 @@
   },
   "dependencies": {
     "ethers": "^6.16.0",
-    "@holoscript/llm-provider": "1.2.0"
+    "@holoscript/llm-provider": "^1.2.1"
   },
   "devDependencies": {
     "@types/node": "^24.10.1",
     "tsup": "^8.0.1",
     "typescript": "~5.9.3",
-    "vitest": "^4.1.0"
+    "vitest": "^4.1.5"
   },
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
     "test": "vitest run",
-    "lint": "eslint src --ext .ts"
+    "lint": "eslint src --ext .ts",
+    "test:coverage": "vitest run --coverage"
   }
 }