@tangle-network/agent-interface 0.6.0 → 0.7.0

package/dist/harness.d.ts

@@ -0,0 +1,40 @@
+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).
+ *
+ * `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
+ * sandbox or locally via the CLI bridge.
+ *
+ * Some values are input aliases that collapse to a base runner (`claude`/`claudish` → `claude-code`,
+ * `kimi` → `kimi-code`); normalize with {@link canonicalizeHarness} before keying per-runner config.
+ */
+export type HarnessType = "claude-code" | "claude" | "claudish" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "kimi" | "pi" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "acp" | "cli-base";
+/** Runtime validator for {@link HarnessType}. Kept in lockstep with the type by the drift guard below. */
+export declare const harnessTypeSchema: 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";
+}>;
+/** Input alias → canonical base runner. Aliases accept legacy/shorthand harness names. */
+export declare const harnessAliases: Partial<Record<HarnessType, HarnessType>>;
+/** Collapse an alias to its base runner (idempotent on canonical values). */
+export declare function canonicalizeHarness(harness: HarnessType): HarnessType;

package/dist/harness.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+/** Runtime validator for {@link HarnessType}. Kept in lockstep with the type by the drift guard below. */
+export const harnessTypeSchema = z.enum([
+    "claude-code",
+    "claude",
+    "claudish",
+    "nanoclaw",
+    "codex",
+    "opencode",
+    "kimi-code",
+    "kimi",
+    "pi",
+    "gemini",
+    "hermes",
+    "openclaw",
+    "amp",
+    "factory-droids",
+    "acp",
+    "cli-base",
+]);
+/** Input alias → canonical base runner. Aliases accept legacy/shorthand harness names. */
+export const harnessAliases = {
+    claude: "claude-code",
+    claudish: "claude-code",
+    kimi: "kimi-code",
+};
+/** Collapse an alias to its base runner (idempotent on canonical values). */
+export function canonicalizeHarness(harness) {
+    return harnessAliases[harness] ?? harness;
+}
+const _harnessSchemaMatchesType = true;
+void _harnessSchemaMatchesType;

package/dist/index.d.ts

@@ -579,4 +579,5 @@ export interface SdkProviderAdapter {
     submitQuestionAnswer?(answers: Record<string, string[]>): Promise<void>;
 }
 export * from "./agent-profile.js";
+export * from "./harness.js";
 export * from "./profile-schema.js";

package/dist/index.js

@@ -123,4 +123,5 @@ export function resolveNativeWebTools(tools) {
     return posture;
 }
 export * from "./agent-profile.js";
+export * from "./harness.js";
 export * from "./profile-schema.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-interface",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",