@agntn/harnesses 0.4.0 → 0.4.1

package/dist/tool-operations.d.mts

@@ -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;;;;;;wBA2KG,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;;iBAqDrB;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.4.0",
+  "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",

package/packages/omp/extensions/harnesses.ts

@@ -67,7 +67,8 @@ 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>> {
@@ -121,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(
@@ -133,6 +134,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,

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,