@agntn/harnesses 0.3.1 → 0.4.1

package/dist/tool-operations.d.mts

@@ -1,4 +1,4 @@
-import { A as AvailableModel, F as HarnessId, G as PathCandidate, J as PromptTemplateSyncTarget, L as HarnessInvocationModes, N as HarnessCapabilities, P as HarnessDetection, Q as StorageDescriptor, W as McpServerConfig, X as ResolvedPaths, Z as SkillsSyncTarget, _ as McpConfigListing, j as EnvOverride, n as SkillsSyncReport, o as PromptSyncReport, p as AgentsSyncReport, y as SyncReport } from "./_chunks/skills-sync.mjs";
+import { $ as StorageDescriptor, F as HarnessDetection, G as McpServerConfig, I as HarnessId, K as PathCandidate, M as EnvOverride, P as HarnessCapabilities, Q as SkillsSyncTarget, R as HarnessInvocationModes, Y as PromptTemplateSyncTarget, Z as ResolvedPaths, _ as McpConfigListing, b as SyncReport, j as AvailableModel, n as SkillsSyncReport, o as PromptSyncReport, p as AgentsSyncReport } from "./_chunks/skills-sync.mjs";
 import { n as HARNESS_INFO_MAX_ITEMS } from "./_chunks/tool-schemas.mjs";
 //#region src/tool-operations.d.ts
 /** Text for the model plus details for the harness, shared by every tool surface. */
@@ -11,12 +11,18 @@ export interface ToolResult<Details> {
   /** Set when the tool could not answer. */
   isError?: boolean;
 }
-/** Install state of one harness on this machine. */
+/** Install state of one harness on this machine, plus the runs harnesses_run takes for it. */
 export interface HarnessStatus {
   id: HarnessId;
   name: string;
   installed: boolean;
   version: string | null;
+  /** Takes `tools: false`, an advisor without tools. */
+  advisor: boolean;
+  /** Takes `tools: true` with `readOnly: true`; false while the installed CLI is too old for it. */
+  readOnly: boolean;
+  /** Takes `tools: true`, the full agent. */
+  agent: boolean;
 }
 /** Every registered harness with its install state, as scanned by {@link detectHarnesses}. */
 export interface HarnessListing {
@@ -31,6 +37,7 @@ export interface HarnessMetadata {
   invocationModes: HarnessInvocationModes;
   modelListing: boolean;
   modelSelection: boolean;
+  effortSelection: boolean;
   config: PathCandidate[];
   sessions: PathCandidate[];
   instructions: PathCandidate[];
@@ -64,7 +71,7 @@ export declare const RUN_DEFAULT_TIMEOUT_SECONDS = 600;
 /** The run tool's per-stream cap: harness output is unbounded, model context is not. */
 export declare const RUN_MAX_OUTPUT_CHARS = 8000;
 /**
- * Scans every registered harness for its binaries and version.
+ * Scans every registered harness for its binaries and version, next to the modes it runs in.
  *
  * @returns {ToolResult<HarnessListing>} The complete installation listing.
  */
@@ -110,6 +117,8 @@ export interface RunOptions {
   cwd?: string;
   /** Harness-native model id or selector. */
   model?: string;
+  /** Reasoning effort in the harness's own words; rejected where `effortArgs` is missing. */
+  effort?: string;
   /** Wall-clock budget in seconds; defaults to {@link RUN_DEFAULT_TIMEOUT_SECONDS}. */
   timeoutSeconds?: number;
   /** Cancel the owned command through the host request signal. */
@@ -128,6 +137,7 @@ export interface RunOutcome {
   /** Expanded arguments; the model's text keeps "{prompt}" instead, it wrote the prompt itself. */
   args: string[];
   model?: string;
+  effort?: string;
   structured: boolean;
   tools: boolean;
   readOnly: boolean;
@@ -158,7 +168,7 @@ export interface RunFailure {
  *
  * Tool use defaults to a native advisor without tools invocation. Harnesses that
  * cannot disable tools reject that mode; setting `tools` selects their full
- * agent invocation. `model` is translated through the harness-specific recipe.
+ * agent invocation. `model` and `effort` are translated through the harness-specific recipe.
  * This layer also closes stdin, enforces the timeout, caps the echoed output,
  * and leaves the prompt out of the echoed invocation.
  *

package/dist/tool-operations.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-operations.d.mts","names":[],"sources":["../src/tool-operations.ts"],"mappings":";;;;iBAiDiB,WAAW;EAC1B,SAAS;IAAQ;IAAc;;EAC/B,SAAS;;EAET;;;iBAIe;EACf,IAAI;EACJ;EACA;EACA;;;iBAIe;EACf,WAAW;;;iBAII;EACf,IAAI;EACJ;EACA;EACA,cAAc;EACd,iBAAiB;EACjB;EACA;EACA,QAAQ;EACR,UAAU;EACV,cAAc;EACd,QAAQ;EACR,kBAAkB;EAClB,UAAU;EACV,iBAAiB;EACjB,0BAA0B;EAC1B,OAAO;EACP,MAAM;EACN,cAAc;EACd,aAAa;EACb,WAAW;EACX,UAAU;;;iBAIK;EACf;EACA,OAAO;;;iBAIQ;EACf;;;YAIU,oBAAoB,kBAAkB;;YAGtC,qBAAqB,oBAAoB,sBAAsB;;qBAM9D;;qBAGA;;;;;;wBAoKG,mBAAmB,WAAW;;wBAyG9B,YAAY,aAAa,WAAW;;wBAEpC,YACd,yBACC,WAAW,sBAAsB;wBACpB,YAAY,oCAAoC,WAAW;;iBA2B1D;EACf;EACA;;EAEA;;EAEA,SAAS;;;iBAIM;EACf,IAAI;EACJ;EACA;EACA;EACA,QAAQ;EACR;EACA;EACA;;EAEA;EACA;;;;;;;;;wBAUoB,kBACpB,YACA,UAAS,gBACR,QAAQ,WAAW,gBAAgB;;iBAsDrB;EACf;;EAEA;;EAEA;;EAEA,SAAS;;EAET;;EAEA;;EAEA;;;iBAIe;EACf,IAAI;EACJ;;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;EAEA;EACA;EACA;;;iBAIe;EACf;EACA,QAAQ;;EAER,kBAAkB;;EAElB;IAAU;IAAmB;;IAAsB;;;;;;;;;;;;;;;;;wBAyB/B,WACpB,YACA,gBACA,UAAS,aACR,QAAQ,WAAW,aAAa;;iBAkClB;EACf,WAAW;IAAQ,IAAI;IAAW,SAAS;;;;iBAY5B;EACf,IAAI;EACJ;EACA;;;iBAIe;EACf;EACA,YAAY;EACZ;EACA;EACA,MAAM;EACN;EACA,UAAU;;;;;;;;wBASI,kBAAkB,QAAQ,kBAAkB;;;;;;;wBAmB5C,QAAQ,cAAc,WAAW,aAAa;;;;;;;;;wBAgD9C,OACd,YACA,QAAQ,iBACR,6BACC,WAAW,cAAc;;;;;;;;;wBAeZ,UACd,YACA,cACA,6BACC,WAAW,cAAc;;;;;;;wBAaZ,QAAQ,cAAc,WAAW,aAAa;;;;;;;;wBA+B9C,WAAW,aAAa,kBAAgB,WAAW,mBAAmB;;;;;;;;wBAgCtE,YAAY,aAAa,kBAAgB,WAAW,mBAAmB;;;;;;;;wBAsBvE,WAAW,aAAa,kBAAgB,WAAW,mBAAmB"}
+{"version":3,"file":"tool-operations.d.mts","names":[],"sources":["../src/tool-operations.ts"],"mappings":";;;;iBAkDiB,WAAW;EAC1B,SAAS;IAAQ;IAAc;;EAC/B,SAAS;;EAET;;;iBAIe;EACf,IAAI;EACJ;EACA;EACA;;EAEA;;EAEA;;EAEA;;;iBAIe;EACf,WAAW;;;iBAII;EACf,IAAI;EACJ;EACA;EACA,cAAc;EACd,iBAAiB;EACjB;EACA;EACA;EACA,QAAQ;EACR,UAAU;EACV,cAAc;EACd,QAAQ;EACR,kBAAkB;EAClB,UAAU;EACV,iBAAiB;EACjB,0BAA0B;EAC1B,OAAO;EACP,MAAM;EACN,cAAc;EACd,aAAa;EACb,WAAW;EACX,UAAU;;;iBAIK;EACf;EACA,OAAO;;;iBAIQ;EACf;;;YAIU,oBAAoB,kBAAkB;;YAGtC,qBAAqB,oBAAoB,sBAAsB;;qBAM9D;;qBAGA;;;;;;wBA+KG,mBAAmB,WAAW;;wBAmH9B,YAAY,aAAa,WAAW;;wBAEpC,YACd,yBACC,WAAW,sBAAsB;wBACpB,YAAY,oCAAoC,WAAW;;iBA2B1D;EACf;EACA;;EAEA;;EAEA,SAAS;;;iBAIM;EACf,IAAI;EACJ;EACA;EACA;EACA,QAAQ;EACR;EACA;EACA;;EAEA;EACA;;;;;;;;;wBAUoB,kBACpB,YACA,UAAS,gBACR,QAAQ,WAAW,gBAAgB;;iBAqDrB;EACf;;EAEA;;EAEA;;EAEA;;EAEA,SAAS;;EAET;;EAEA;;EAEA;;;iBAIe;EACf,IAAI;EACJ;;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;EAEA;EACA;EACA;;;iBAIe;EACf;EACA,QAAQ;;EAER,kBAAkB;;EAElB;IAAU;IAAmB;;IAAsB;;;;;;;;;;;;;;;;;wBAyB/B,WACpB,YACA,gBACA,UAAS,aACR,QAAQ,WAAW,aAAa;;iBAyClB;EACf,WAAW;IAAQ,IAAI;IAAW,SAAS;;;;iBAY5B;EACf,IAAI;EACJ;EACA;;;iBAIe;EACf;EACA,YAAY;EACZ;EACA;EACA,MAAM;EACN;EACA,UAAU;;;;;;;;wBASI,kBAAkB,QAAQ,kBAAkB;;;;;;;wBAmB5C,QAAQ,cAAc,WAAW,aAAa;;;;;;;;;wBAgD9C,OACd,YACA,QAAQ,iBACR,6BACC,WAAW,cAAc;;;;;;;;;wBAeZ,UACd,YACA,cACA,6BACC,WAAW,cAAc;;;;;;;wBAaZ,QAAQ,cAAc,WAAW,aAAa;;;;;;;;wBA+B9C,WAAW,aAAa,kBAAgB,WAAW,mBAAmB;;;;;;;;wBAgCtE,YAAY,aAAa,kBAAgB,WAAW,mBAAmB;;;;;;;;wBAsBvE,WAAW,aAAa,kBAAgB,WAAW,mBAAmB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agntn/harnesses",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "description": "Metadata registry for AI coding harnesses: binaries, configs, sessions, and capabilities.",
   "homepage": "https://harnesses.agntn.dev",
   "bugs": "https://github.com/agntn/harnesses/issues",
@@ -79,7 +79,7 @@
     }
   },
   "engines": {
-    "node": ">=24"
+    "node": ">=26"
   },
   "omp": {
     "extensions": [

package/packages/omp/extensions/harnesses.ts

@@ -67,13 +67,13 @@ export default function harnessesExtension(pi: ExtensionAPI): void {
   pi.registerTool({
     name: "harnesses_detect",
     label: HARNESS_TOOL_LABELS.harnesses_detect,
-    description: "List every known AI coding harness with its install state and version",
+    description:
+      "List every known AI coding harness with its install state, version and the harnesses_run modes it takes: advisor (tools=false), readOnly (tools=true with readOnly=true) and agent (tools=true)",
     parameters: schemas.detect,
     approval: HARNESS_TOOL_APPROVALS.harnesses_detect,
     async execute(_toolCallId, _params): Promise<AgentToolResult<HarnessTools.HarnessListing>> {
       const { detectHarnesses } = await loadToolOperations();
-      const { content, details } = detectHarnesses();
-      return { content, details };
+      return detectHarnesses();
     },
     ...statusRenderers("harnesses_detect"),
   });
@@ -90,8 +90,7 @@ export default function harnessesExtension(pi: ExtensionAPI): void {
       params: HarnessSchemas.InfoParams,
     ): Promise<AgentToolResult<HarnessTools.HarnessInfoDetails>> {
       const { harnessInfo } = await loadToolOperations();
-      const { content, details } = harnessInfo(params.id);
-      return { content, details };
+      return harnessInfo(params.id);
     },
     ...statusRenderers("harnesses_info"),
   });
@@ -109,24 +108,12 @@ export default function harnessesExtension(pi: ExtensionAPI): void {
       signal,
     ): Promise<AgentToolResult<HarnessTools.ModelsOutcome | HarnessTools.RunFailure>> {
       const { listHarnessModels } = await loadToolOperations();
-      const { content, details, isError } = await listHarnessModels(params.id, {
+      return listHarnessModels(params.id, {
         search: params.search,
         cwd: params.cwd,
         timeoutSeconds: params.timeoutSeconds,
         signal,
       });
-      if (isError) {
-        const message =
-          "error" in details
-            ? details.error
-            : details.aborted
-              ? `Harness ${details.id} model listing aborted`
-              : details.timedOut
-                ? `Harness ${details.id} model listing timed out`
-                : details.stderr || `Harness ${details.id} exited with code ${details.exitCode}`;
-        throw new Error(message);
-      }
-      return { content, details };
     },
     ...statusRenderers("harnesses_models"),
   });
@@ -135,7 +122,7 @@ export default function harnessesExtension(pi: ExtensionAPI): void {
     name: "harnesses_run",
     label: HARNESS_TOOL_LABELS.harnesses_run,
     description:
-      "Run one prompt through a harness. Always choose tools explicitly. Add readOnly when tools is true to require native read-only enforcement, or use tools false for an advisor without tools.",
+      "Run one prompt through a harness. Always choose tools explicitly. Add readOnly when tools is true to require native read-only enforcement, or use tools false for an advisor without tools. harnesses_detect shows which modes each harness takes.",
     parameters: schemas.run,
     approval: HARNESS_TOOL_APPROVALS.harnesses_run,
     async execute(
@@ -144,25 +131,16 @@ export default function harnessesExtension(pi: ExtensionAPI): void {
       signal,
     ): Promise<AgentToolResult<HarnessTools.RunOutcome | HarnessTools.RunFailure>> {
       const { runHarness } = await loadToolOperations();
-      const { content, details, isError } = await runHarness(params.id, params.prompt, {
+      return runHarness(params.id, params.prompt, {
         cwd: params.cwd,
         model: params.model,
+        effort: params.effort,
         timeoutSeconds: params.timeoutSeconds,
         signal,
         structured: params.structured,
         tools: params.tools,
         readOnly: params.readOnly,
       });
-      if (isError) {
-        if ("error" in details) throw new Error(details.error);
-        const message =
-          content[0]?.text ??
-          (details.timedOut
-            ? `Harness ${details.id} timed out`
-            : details.stderr || `Harness ${details.id} exited with code ${details.exitCode}`);
-        throw new Error(message);
-      }
-      return { content, details };
     },
     ...statusRenderers("harnesses_run"),
   });
@@ -179,8 +157,7 @@ export default function harnessesExtension(pi: ExtensionAPI): void {
       params: HarnessSchemas.McpListParams,
     ): Promise<AgentToolResult<HarnessTools.McpListing | HarnessTools.UnknownHarness>> {
       const { mcpList } = await loadToolOperations();
-      const { content, details } = mcpList(params.id);
-      return { content, details };
+      return mcpList(params.id);
     },
     ...statusRenderers("harnesses_mcp_list"),
   });
@@ -197,8 +174,7 @@ export default function harnessesExtension(pi: ExtensionAPI): void {
       params: HarnessSchemas.McpAddParams,
     ): Promise<AgentToolResult<HarnessTools.McpMutation | HarnessTools.RunFailure>> {
       const { mcpAdd } = await loadToolOperations();
-      const { content, details } = mcpAdd(params.id, params, params.scope ?? "user");
-      return { content, details };
+      return mcpAdd(params.id, params, params.scope ?? "user");
     },
     ...statusRenderers("harnesses_mcp_add"),
   });
@@ -215,8 +191,7 @@ export default function harnessesExtension(pi: ExtensionAPI): void {
       params: HarnessSchemas.McpSyncParams,
     ): Promise<AgentToolResult<HarnessTools.SyncReport | HarnessTools.RunFailure>> {
       const { mcpSync } = await loadToolOperations();
-      const { content, details } = mcpSync(params.id);
-      return { content, details };
+      return mcpSync(params.id);
     },
     ...statusRenderers("harnesses_mcp_sync"),
   });
@@ -233,8 +208,7 @@ export default function harnessesExtension(pi: ExtensionAPI): void {
       params: HarnessSchemas.AgentsSyncParams,
     ): Promise<AgentToolResult<HarnessTools.AgentsSyncReport | HarnessTools.RunFailure>> {
       const { agentsSync } = await loadToolOperations();
-      const { content, details } = agentsSync(params.id, params.check === true);
-      return { content, details };
+      return agentsSync(params.id, params.check === true);
     },
     ...statusRenderers("harnesses_agents_sync"),
   });
@@ -251,8 +225,7 @@ export default function harnessesExtension(pi: ExtensionAPI): void {
       params: Readonly<HarnessSchemas.PromptsSyncParams>,
     ): Promise<AgentToolResult<HarnessTools.PromptSyncReport | HarnessTools.RunFailure>> {
       const { promptsSync } = await loadToolOperations();
-      const { content, details, isError } = promptsSync(params.id, params.check === true);
-      return { content, details, isError };
+      return promptsSync(params.id, params.check === true);
     },
     ...statusRenderers("harnesses_prompts_sync"),
   });
@@ -269,8 +242,7 @@ export default function harnessesExtension(pi: ExtensionAPI): void {
       params: Readonly<HarnessSchemas.SkillsSyncParams>,
     ): Promise<AgentToolResult<HarnessTools.SkillsSyncReport | HarnessTools.RunFailure>> {
       const { skillsSync } = await loadToolOperations();
-      const { content, details, isError } = skillsSync(params.id, params.check === true);
-      return { content, details, isError };
+      return skillsSync(params.id, params.check === true);
     },
     ...statusRenderers("harnesses_skills_sync"),
   });
@@ -287,8 +259,7 @@ export default function harnessesExtension(pi: ExtensionAPI): void {
       params: HarnessSchemas.McpRemoveParams,
     ): Promise<AgentToolResult<HarnessTools.McpMutation | HarnessTools.RunFailure>> {
       const { mcpRemove } = await loadToolOperations();
-      const { content, details } = mcpRemove(params.id, params.name, params.scope ?? "user");
-      return { content, details };
+      return mcpRemove(params.id, params.name, params.scope ?? "user");
     },
     ...statusRenderers("harnesses_mcp_remove"),
   });

package/packages/pi/extensions/harnesses.ts

@@ -79,10 +79,13 @@ export default function harnessesExtension(pi: ExtensionAPI): void {
   pi.registerTool({
     name: "harnesses_detect",
     label: HARNESS_TOOL_LABELS.harnesses_detect,
-    description: "List every known AI coding harness with its install state and version",
-    promptSnippet: "Use harnesses_detect to see which AI coding harnesses are installed.",
+    description:
+      "List every known AI coding harness with its install state, version and the harnesses_run modes it takes: advisor (tools=false), readOnly (tools=true with readOnly=true) and agent (tools=true)",
+    promptSnippet:
+      "Use harnesses_detect to see which AI coding harnesses are installed and how each one runs.",
     promptGuidelines: [
       "The scan checks binaries on PATH. Versions come from native metadata or the CLI.",
+      "advisor, readOnly and agent say whether harnesses_run takes tools false, tools true with readOnly, or tools true for that harness.",
     ],
     parameters: schemas.detect,
     ...statusRenderers("harnesses_detect"),
@@ -146,13 +149,13 @@ export default function harnessesExtension(pi: ExtensionAPI): void {
     name: "harnesses_run",
     label: HARNESS_TOOL_LABELS.harnesses_run,
     description:
-      "Run one prompt through an AI coding harness's normalized non-interactive invocation, optionally selecting a model, and return its output",
+      "Run one prompt through an AI coding harness's normalized non-interactive invocation, optionally selecting a model and reasoning effort, and return its output",
     promptSnippet: "Use harnesses_run to delegate one prompt to another installed coding harness.",
     promptGuidelines: [
       "Always choose tools explicitly. Set true whenever the task needs harness tools, including Grok native X search.",
       "Add readOnly when tools is true to require native read-only enforcement. Unsupported harnesses reject it instead of widening access.",
       "Set tools false only for an advisor without tools. It never silently falls back to a full agent.",
-      "An unsupported mode returns an explicit retry when the alternate mode is available.",
+      "An unsupported mode returns an explicit retry when the alternate mode is available. harnesses_detect shows the modes up front.",
       "Output is capped for context; long runs stop at the timeout.",
     ],
     parameters: schemas.run,
@@ -166,6 +169,7 @@ export default function harnessesExtension(pi: ExtensionAPI): void {
       return runHarness(params.id, params.prompt, {
         cwd: params.cwd,
         model: params.model,
+        effort: params.effort,
         timeoutSeconds: params.timeoutSeconds,
         signal,
         structured: params.structured,