@tangle-network/agent-interface 0.6.0 → 0.8.0

package/dist/agent-profile.d.ts

@@ -87,11 +87,14 @@ export interface AgentProfileResources {
 /**
  * Portable reasoning/thinking effort. Backends map it to their native control at materialization:
  * codex `model_reasoning_effort`, kimi `--thinking`/`--no-thinking`, claude thinking budget.
- * Ordered low→high: `none` = no extended thinking; `ultracode` = maximum (claude-code's
- * "ultracode" run mode). A backend without a matching native tier clamps to its nearest
- * (e.g. codex maps `xhigh`/`ultracode` → `high`).
+ * Ordered low→high:
+ *   - `none`     — extended thinking OFF (no reasoning budget at all)
+ *   - `minimal`  — thinking ON, the lowest budget (distinct from `none`)
+ *   - `low` / `medium` / `high` / `xhigh`
+ *   - `ultracode` — maximum (claude-code's "ultracode" run mode; codex's `max` reconciles here).
+ * A backend without a matching native tier clamps to its nearest (e.g. codex maps `xhigh`/`ultracode` → `high`).
  */
-export type ReasoningEffort = 'none' | 'low' | 'medium' | 'high' | 'xhigh' | 'ultracode';
+export type ReasoningEffort = 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'ultracode';
 /**
  * Model selection hints for backends.
  */

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/dist/profile-schema.d.ts

@@ -118,6 +118,7 @@ export declare const agentProfileModelHintsSchema: z.ZodObject<{
     provider: z.ZodOptional<z.ZodString>;
     reasoningEffort: z.ZodOptional<z.ZodEnum<{
         none: "none";
+        minimal: "minimal";
         low: "low";
         medium: "medium";
         high: "high";
@@ -211,6 +212,7 @@ export declare const agentProfileSchema: z.ZodObject<{
         provider: z.ZodOptional<z.ZodString>;
         reasoningEffort: z.ZodOptional<z.ZodEnum<{
             none: "none";
+            minimal: "minimal";
             low: "low";
             medium: "medium";
             high: "high";

package/dist/profile-schema.js

@@ -37,7 +37,7 @@ export const agentProfileModelHintsSchema = z.object({
     default: z.string().optional(),
     small: z.string().optional(),
     provider: z.string().optional(),
-    reasoningEffort: z.enum(['none', 'low', 'medium', 'high', 'xhigh', 'ultracode']).optional(),
+    reasoningEffort: z.enum(['none', 'minimal', 'low', 'medium', 'high', 'xhigh', 'ultracode']).optional(),
     metadata: z.record(z.string(), z.unknown()).optional(),
 });
 export const agentProfilePromptSchema = z.object({

package/package.json

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