@tangle-network/agent-interface 0.5.0 → 0.7.0

package/dist/agent-profile.d.ts

@@ -84,6 +84,14 @@ export interface AgentProfileResources {
      */
     failOnError?: boolean;
 }
+/**
+ * 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`).
+ */
+export type ReasoningEffort = 'none' | 'low' | 'medium' | 'high' | 'xhigh' | 'ultracode';
 /**
  * Model selection hints for backends.
  */
@@ -100,6 +108,11 @@ export interface AgentProfileModelHints {
      * Optional provider preference hint.
      */
     provider?: string;
+    /**
+     * Reasoning/thinking effort hint — a first-class, portable model dimension (not buried in
+     * `extensions`). Backends map it to their native control at materialization.
+     */
+    reasoningEffort?: ReasoningEffort;
     /**
      * Backend-agnostic model metadata/hints.
      */

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

@@ -116,6 +116,14 @@ export declare const agentProfileModelHintsSchema: z.ZodObject<{
     default: z.ZodOptional<z.ZodString>;
     small: z.ZodOptional<z.ZodString>;
     provider: z.ZodOptional<z.ZodString>;
+    reasoningEffort: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        low: "low";
+        medium: "medium";
+        high: "high";
+        xhigh: "xhigh";
+        ultracode: "ultracode";
+    }>>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
 export declare const agentProfilePromptSchema: z.ZodObject<{
@@ -201,6 +209,14 @@ export declare const agentProfileSchema: z.ZodObject<{
         default: z.ZodOptional<z.ZodString>;
         small: z.ZodOptional<z.ZodString>;
         provider: z.ZodOptional<z.ZodString>;
+        reasoningEffort: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            low: "low";
+            medium: "medium";
+            high: "high";
+            xhigh: "xhigh";
+            ultracode: "ultracode";
+        }>>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>>;
     permissions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodEnum<{

package/dist/profile-schema.js

@@ -37,6 +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(),
     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.5.0",
+  "version": "0.7.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",