@tangle-network/agent-interface 0.19.0 → 0.20.0

package/dist/agent-profile.d.ts

@@ -6,6 +6,7 @@
  * formats internally. This is the canonical home; `@tangle-network/sandbox`
  * re-exports these symbols for backward compatibility.
  */
+import type { HarnessType } from "./harness.js";
 /**
  * Permission policy value for a capability.
  */
@@ -230,6 +231,19 @@ export interface AgentProfile {
     tags?: string[];
     prompt?: AgentProfilePrompt;
     model?: AgentProfileModelHints;
+    /**
+     * Preferred execution harness for this profile — the coding-CLI runtime that
+     * materializes and runs it (`claude-code`, `codex`, `opencode`, `pi`, …).
+     *
+     * This is an optional PREFERENCE, not part of profile IDENTITY: the same
+     * profile still runs on any harness, and an executor MAY override it (e.g. the
+     * leaderboard's `harness × model` axis sweeps a profile across every harness,
+     * and a supervisor spawning a worker may pick a harness per subtask). When
+     * unset, the caller/executor chooses. Formalizes what runtimes already read as
+     * `profile.harness`; making it typed also lets an improvement loop optimize
+     * harness routing as a first-class lever.
+     */
+    harness?: HarnessType;
     permissions?: Record<string, AgentProfilePermission>;
     tools?: Record<string, boolean>;
     mcp?: Record<string, AgentProfileMcpServer>;

package/dist/harness.d.ts

@@ -2,10 +2,13 @@ import { z } from "zod";
 /**
  * The execution runner for an agent — WHICH runtime materializes and runs an `AgentProfile`.
  *
- * Harness is an EXECUTION concern chosen by the caller/executor per run, NOT part of the portable
- * profile identity: the same `AgentProfile` (prompt/model/skills/tools/mcp/subagents) runs on any
- * harness. This is the single shared enum every layer references instead of keeping its own copy
- * (session control, the profile materializer, the cli-bridge backends, VB profile specs).
+ * Harness is an EXECUTION concern, not part of profile IDENTITY: the same `AgentProfile`
+ * (prompt/model/skills/tools/mcp/subagents) runs on any harness. A profile MAY carry an optional
+ * `harness` PREFERENCE (`AgentProfile.harness`), but the caller/executor can always override it per
+ * run — the leaderboard's `harness × model` axis sweeps one profile across every harness, and a
+ * supervisor may pick a harness per spawned worker. This is the single shared enum every layer
+ * references instead of keeping its own copy (session control, the profile materializer, the
+ * cli-bridge backends, VB profile specs).
  *
  * `cli-base` is the router-backed mode — a plain multi-turn router call (a reviewer, a cheap judge,
  * a one-shot) with no full coding-agent harness. The rest are full agentic harnesses run in a

package/dist/profile-schema.d.ts

@@ -270,6 +270,24 @@ export declare const agentProfileSchema: z.ZodObject<{
         }>>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>>;
+    harness: z.ZodOptional<z.ZodEnum<{
+        "claude-code": "claude-code";
+        claude: "claude";
+        claudish: "claudish";
+        nanoclaw: "nanoclaw";
+        codex: "codex";
+        opencode: "opencode";
+        "kimi-code": "kimi-code";
+        kimi: "kimi";
+        pi: "pi";
+        gemini: "gemini";
+        hermes: "hermes";
+        openclaw: "openclaw";
+        amp: "amp";
+        "factory-droids": "factory-droids";
+        acp: "acp";
+        "cli-base": "cli-base";
+    }>>;
     permissions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodEnum<{
         allow: "allow";
         ask: "ask";

package/dist/profile-schema.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { harnessTypeSchema } from "./harness.js";
 import { SANDBOX_SIZE_PRESET_NAMES, } from "./sandbox-size.js";
 export const agentProfilePermissionValueSchema = z.enum([
     "allow",
@@ -140,6 +141,7 @@ export const agentProfileSchema = z.object({
     tags: z.array(z.string()).optional(),
     prompt: agentProfilePromptSchema.optional(),
     model: agentProfileModelHintsSchema.optional(),
+    harness: harnessTypeSchema.optional(),
     permissions: z.record(z.string(), agentProfilePermissionSchema).optional(),
     tools: z.record(z.string(), z.boolean()).optional(),
     mcp: z.record(z.string(), agentProfileMcpServerSchema).optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-interface",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "type": "module",
   "license": "MIT",
   "main": "./dist/index.js",