@agntn/harnesses 0.1.0 → 0.2.0

package/dist/tool-operations.d.mts

@@ -1,7 +1,7 @@
 import { AgentsSyncReport, AvailableModel, HarnessCapabilities, HarnessDetection, HarnessId, HarnessInvocationModes, McpConfigListing, McpServerConfig, PathCandidate, ResolvedPaths, StorageDescriptor, SyncReport } from "./_chunks/agents-sync.mjs";
 import { HARNESS_INFO_MAX_ITEMS } from "./_chunks/tool-schemas.mjs";
 /** Text for the model plus details for the harness, shared by every tool surface. */
-interface ToolResult<Details> {
+export interface ToolResult<Details> {
   content: Array<{
     type: "text";
     text: string;
@@ -11,18 +11,18 @@ interface ToolResult<Details> {
   isError?: boolean;
 }
 /** Install state of one harness on this machine. */
-interface HarnessStatus {
+export interface HarnessStatus {
   id: HarnessId;
   name: string;
   installed: boolean;
   version: string | null;
 }
 /** Every registered harness with its install state, as scanned by {@link detectHarnesses}. */
-interface HarnessListing {
+export interface HarnessListing {
   harnesses: HarnessStatus[];
 }
 /** Full metadata for one harness, including paths resolved for this platform. */
-interface HarnessMetadata {
+export interface HarnessMetadata {
   id: HarnessId;
   name: string;
   binaries: string[];
@@ -41,35 +41,35 @@ interface HarnessMetadata {
   resolved: ResolvedPaths;
 }
 /** Returned when the requested harness id is not registered. */
-interface UnknownHarness {
+export interface UnknownHarness {
   error: string;
   known: HarnessId[];
 }
 /** Returned when a direct batch call bypasses the tool schema limits. */
-interface HarnessInfoInputError {
+export interface HarnessInfoInputError {
   error: string;
 }
 /** One harness lookup result. */
-type HarnessInfoResult = HarnessMetadata | UnknownHarness;
+export type HarnessInfoResult = HarnessMetadata | UnknownHarness;
 /** Scalar, batch, or rejected batch details from {@link harnessInfo}. */
-type HarnessInfoDetails = HarnessInfoResult | HarnessInfoResult[] | HarnessInfoInputError;
+export type HarnessInfoDetails = HarnessInfoResult | HarnessInfoResult[] | HarnessInfoInputError;
 /** Default wall-clock budget for one harness run, in seconds. */
-declare const RUN_DEFAULT_TIMEOUT_SECONDS = 600;
+export declare const RUN_DEFAULT_TIMEOUT_SECONDS = 600;
 /** The run tool's per-stream cap: harness output is unbounded, model context is not. */
-declare const RUN_MAX_OUTPUT_CHARS = 8000;
+export declare const RUN_MAX_OUTPUT_CHARS = 8000;
 /**
  * Scans every registered harness for its binaries and version.
  *
  * @returns {ToolResult<HarnessListing>} The complete installation listing.
  */
-declare function detectHarnesses(): ToolResult<HarnessListing>;
+export declare function detectHarnesses(): ToolResult<HarnessListing>;
 /** Full metadata for one harness, with paths resolved for the current platform. */
-declare function harnessInfo(id: string): ToolResult<HarnessInfoResult>;
+export declare function harnessInfo(id: string): ToolResult<HarnessInfoResult>;
 /** Full metadata for several harnesses, preserving input order and errors for each item. */
-declare function harnessInfo(ids: readonly string[]): ToolResult<HarnessInfoResult[] | HarnessInfoInputError>;
-declare function harnessInfo(input: string | readonly string[]): ToolResult<HarnessInfoDetails>;
+export declare function harnessInfo(ids: readonly string[]): ToolResult<HarnessInfoResult[] | HarnessInfoInputError>;
+export declare function harnessInfo(input: string | readonly string[]): ToolResult<HarnessInfoDetails>;
 /** Options accepted by {@link listHarnessModels}. */
-interface ModelsOptions {
+export interface ModelsOptions {
   search?: string;
   cwd?: string;
   /** Wall-clock budget in seconds; defaults to {@link RUN_DEFAULT_TIMEOUT_SECONDS}. */
@@ -78,7 +78,7 @@ interface ModelsOptions {
   signal?: AbortSignal;
 }
 /** One completed native model-listing query. */
-interface ModelsOutcome {
+export interface ModelsOutcome {
   id: HarnessId;
   command: string;
   args: string[];
@@ -96,9 +96,9 @@ interface ModelsOutcome {
  * @param options - Search, working-directory, and timeout options.
  * @returns {Promise<ToolResult<ModelsOutcome | RunFailure>>} The model listing or failure.
  */
-declare function listHarnessModels(id: string, options?: ModelsOptions): Promise<ToolResult<ModelsOutcome | RunFailure>>;
+export declare function listHarnessModels(id: string, options?: ModelsOptions): Promise<ToolResult<ModelsOutcome | RunFailure>>;
 /** Options accepted by {@link runHarness}. */
-interface RunOptions {
+export interface RunOptions {
   cwd?: string;
   /** Harness-native model id or selector. */
   model?: string;
@@ -114,9 +114,10 @@ interface RunOptions {
   readOnly?: boolean;
 }
 /** One completed (or failed) harness run, with output capped for the model. */
-interface RunOutcome {
+export interface RunOutcome {
   id: HarnessId;
   command: string;
+  /** Expanded arguments; the model's text keeps "{prompt}" instead, it wrote the prompt itself. */
   args: string[];
   model?: string;
   structured: boolean;
@@ -129,7 +130,7 @@ interface RunOutcome {
   stderr: string;
 }
 /** Returned when the harness cannot be run at all. */
-interface RunFailure {
+export interface RunFailure {
   error: string;
   known?: HarnessId[];
   /** Modes accepted by the selected harness when invocation mode caused the failure. */
@@ -148,30 +149,30 @@ 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.
- * This layer also closes stdin, enforces the timeout, and
- * caps the echoed output.
+ * This layer also closes stdin, enforces the timeout, caps the echoed output,
+ * and leaves the prompt out of the echoed invocation.
  *
  * @param id - Harness id to run.
  * @param prompt - Prompt sent to the selected harness.
  * @param options - Model, mode, working-directory, and timeout options.
  * @returns {Promise<ToolResult<RunOutcome | RunFailure>>} The capped run outcome or failure.
  */
-declare function runHarness(id: string, prompt: string, options?: RunOptions): Promise<ToolResult<RunOutcome | RunFailure>>;
+export declare function runHarness(id: string, prompt: string, options?: RunOptions): Promise<ToolResult<RunOutcome | RunFailure>>;
 /** MCP server listings for one harness or all of them. */
-interface McpListing {
+export interface McpListing {
   harnesses: Array<{
     id: HarnessId;
     configs: McpConfigListing[];
   }>;
 }
 /** Result of one MCP config mutation. */
-interface McpMutation {
+export interface McpMutation {
   id: HarnessId;
   path: string;
   action: "added" | "replaced" | "removed" | "noop";
 }
 /** Flat tool parameters describing one MCP server, shared by every surface. */
-interface McpServerParams {
+export interface McpServerParams {
   name: string;
   transport?: McpServerConfig["transport"];
   command?: string;
@@ -186,14 +187,14 @@ interface McpServerParams {
  * @param params - Flat MCP server parameters.
  * @returns {McpServerConfig} The normalized server configuration.
  */
-declare function toMcpServerConfig(params: McpServerParams): McpServerConfig;
+export declare function toMcpServerConfig(params: McpServerParams): McpServerConfig;
 /**
  * Lists configured MCP servers, normalized across harness config dialects.
  *
  * @param id - Optional harness id; omission lists every harness.
  * @returns {ToolResult<McpListing | UnknownHarness>} The normalized listing or id error.
  */
-declare function mcpList(id?: string): ToolResult<McpListing | UnknownHarness>;
+export declare function mcpList(id?: string): ToolResult<McpListing | UnknownHarness>;
 /**
  * Adds or replaces one MCP server in a harness's config.
  *
@@ -202,7 +203,7 @@ declare function mcpList(id?: string): ToolResult<McpListing | UnknownHarness>;
  * @param scope - User or project config scope.
  * @returns {ToolResult<McpMutation | RunFailure>} The mutation outcome or failure.
  */
-declare function mcpAdd(id: string, params: McpServerParams, scope?: "user" | "project"): ToolResult<McpMutation | RunFailure>;
+export declare function mcpAdd(id: string, params: McpServerParams, scope?: "user" | "project"): ToolResult<McpMutation | RunFailure>;
 /**
  * Removes one MCP server from a harness's config.
  *
@@ -211,14 +212,14 @@ declare function mcpAdd(id: string, params: McpServerParams, scope?: "user" | "p
  * @param scope - User or project config scope.
  * @returns {ToolResult<McpMutation | RunFailure>} The mutation outcome or failure.
  */
-declare function mcpRemove(id: string, name: string, scope?: "user" | "project"): ToolResult<McpMutation | RunFailure>;
+export declare function mcpRemove(id: string, name: string, scope?: "user" | "project"): ToolResult<McpMutation | RunFailure>;
 /**
  * Pushes the master MCP list from ~/.config/agntn/mcp.jsonc into harness configs.
  *
  * @param id - Optional harness id; omission targets every harness.
  * @returns {ToolResult<SyncReport | RunFailure>} The sync report or failure.
  */
-declare function mcpSync(id?: string): ToolResult<SyncReport | RunFailure>;
+export declare function mcpSync(id?: string): ToolResult<SyncReport | RunFailure>;
 /**
  * Links every harness's global instructions file to the master AGENTS.md.
  *
@@ -226,6 +227,6 @@ declare function mcpSync(id?: string): ToolResult<SyncReport | RunFailure>;
  * @param check - Report intended changes without writing them.
  * @returns {ToolResult<AgentsSyncReport | RunFailure>} The sync report or failure.
  */
-declare function agentsSync(id?: string, check?: boolean): ToolResult<AgentsSyncReport | RunFailure>;
-export { type AgentsSyncReport, HARNESS_INFO_MAX_ITEMS, HarnessInfoDetails, HarnessInfoInputError, HarnessInfoResult, type HarnessInvocationModes, HarnessListing, HarnessMetadata, HarnessStatus, McpListing, McpMutation, McpServerParams, ModelsOptions, ModelsOutcome, RUN_DEFAULT_TIMEOUT_SECONDS, RUN_MAX_OUTPUT_CHARS, RunFailure, RunOptions, RunOutcome, type SyncReport, ToolResult, UnknownHarness, agentsSync, detectHarnesses, harnessInfo, listHarnessModels, mcpAdd, mcpList, mcpRemove, mcpSync, runHarness, toMcpServerConfig };
+export declare function agentsSync(id?: string, check?: boolean): ToolResult<AgentsSyncReport | RunFailure>;
+export { type AgentsSyncReport, HARNESS_INFO_MAX_ITEMS, type HarnessInvocationModes, type SyncReport };
 //# sourceMappingURL=tool-operations.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tool-operations.d.mts","names":[],"sources":["../src/tool-operations.ts"],"mappings":";;;UAsCiB,WAAW;EAC1B,SAAS;IAAQ;IAAc;;EAC/B,SAAS;;EAET;;;UAIe;EACf,IAAI;EACJ;EACA;EACA;;;UAIe;EACf,WAAW;;;UAII;EACf,IAAI;EACJ;EACA;EACA,cAAc;EACd,iBAAiB;EACjB;EACA;EACA,QAAQ;EACR,UAAU;EACV,cAAc;EACd,QAAQ;EACR,UAAU;EACV,OAAO;EACP,aAAa;EACb,WAAW;EACX,UAAU;;;UAIK;EACf;EACA,OAAO;;;UAIQ;EACf;;;KAIU,oBAAoB,kBAAkB;;KAGtC,qBAAqB,oBAAoB,sBAAsB;;cAM9D;;cAGA;;;;;;iBAgIG,mBAAmB,WAAW;;iBAyC9B,YAAY,aAAa,WAAW;;iBAEpC,YACd,yBACC,WAAW,sBAAsB;iBACpB,YAAY,oCAAoC,WAAW;;UAuB1D;EACf;EACA;;EAEA;;EAEA,SAAS;;;UAIM;EACf,IAAI;EACJ;EACA;EACA;EACA,QAAQ;EACR;EACA;EACA;EACA;;;;;;;;;iBAUoB,kBACpB,YACA,UAAS,gBACR,QAAQ,WAAW,gBAAgB;;UA4CrB;EACf;;EAEA;;EAEA;;EAEA,SAAS;;EAET;;EAEA;;EAEA;;;UAIe;EACf,IAAI;EACJ;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;UAIe;EACf;EACA,QAAQ;;EAER,kBAAkB;;EAElB;IAAU;IAAmB;;IAAsB;;;;;;;;;;;;;;;;;iBAyB/B,WACpB,YACA,gBACA,UAAS,aACR,QAAQ,WAAW,aAAa;;UAiClB;EACf,WAAW;IAAQ,IAAI;IAAW,SAAS;;;;UAY5B;EACf,IAAI;EACJ;EACA;;;UAIe;EACf;EACA,YAAY;EACZ;EACA;EACA,MAAM;EACN;EACA,UAAU;;;;;;;;iBASI,kBAAkB,QAAQ,kBAAkB;;;;;;;iBAmB5C,QAAQ,cAAc,WAAW,aAAa;;;;;;;;;iBAgD9C,OACd,YACA,QAAQ,iBACR,6BACC,WAAW,cAAc;;;;;;;;;iBAeZ,UACd,YACA,cACA,6BACC,WAAW,cAAc;;;;;;;iBAaZ,QAAQ,cAAc,WAAW,aAAa;;;;;;;;iBA+B9C,WAAW,aAAa,kBAAgB,WAAW,mBAAmB"}
+{"version":3,"file":"tool-operations.d.mts","names":[],"sources":["../src/tool-operations.ts"],"mappings":";;;iBAsCiB,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,UAAU;EACV,OAAO;EACP,aAAa;EACb,WAAW;EACX,UAAU;;;iBAIK;EACf;EACA,OAAO;;;iBAIQ;EACf;;;YAIU,oBAAoB,kBAAkB;;YAGtC,qBAAqB,oBAAoB,sBAAsB;;qBAM9D;;qBAGA;;;;;;wBAqIG,mBAAmB,WAAW;;wBAiF9B,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;EACA;;;;;;;;;wBAUoB,kBACpB,YACA,UAAS,gBACR,QAAQ,WAAW,gBAAgB;;iBA4CrB;EACf;;EAEA;;EAEA;;EAEA,SAAS;;EAET;;EAEA;;EAEA;;;iBAIe;EACf,IAAI;EACJ;;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;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"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@agntn/harnesses",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Metadata registry for AI coding harnesses: binaries, configs, sessions, and capabilities.",
-  "homepage": "https://github.com/agntn/harnesses#readme",
+  "homepage": "https://harnesses.agntn.dev",
   "bugs": "https://github.com/agntn/harnesses/issues",
   "license": "MIT",
   "author": "oritwoen (https://github.com/oritwoen)",
@@ -36,41 +36,30 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "obuild",
-    "dev": "obuild --stub",
-    "docs": "pnpm --dir docs dev",
-    "lint": "pnpm build && oxlint . && oxfmt --check .",
-    "lint:fix": "pnpm build && oxlint . --fix && oxfmt . && pnpm build",
-    "typecheck": "tsgo --noEmit --skipLibCheck && pnpm build && tsgo --noEmit --skipLibCheck -p tsconfig.extensions.json",
-    "test": "vitest",
-    "test:run": "vitest --run",
-    "prepack": "pnpm run build",
-    "release": "pnpm test:run && pnpm build && changelogen --release --push"
-  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.30.0",
     "@toon-format/toon": "^4.1.1",
     "citty": "^0.2.2",
     "consola": "^3.4.2",
     "smol-toml": "^1.8.0",
-    "typebox": "^1.3.19"
+    "typebox": "^1.3.33"
   },
   "devDependencies": {
     "@agntn/ox": "^0.1.0",
-    "@earendil-works/pi-coding-agent": "0.84.3",
-    "@earendil-works/pi-tui": "0.84.3",
-    "@oh-my-pi/omptype": "18.0.4",
-    "@oh-my-pi/pi-ai": "18.0.4",
-    "@oh-my-pi/pi-coding-agent": "18.0.4",
+    "@earendil-works/pi-coding-agent": "0.85.1",
+    "@earendil-works/pi-tui": "0.85.1",
+    "@oh-my-pi/omptype": "18.2.5",
+    "@oh-my-pi/pi-ai": "18.2.5",
+    "@oh-my-pi/pi-coding-agent": "18.2.5",
     "@types/node": "latest",
     "@typescript/native-preview": "latest",
     "changelogen": "^0.6.2",
-    "obuild": "^0.4.38",
-    "oxfmt": "^0.65.0",
-    "oxlint": "^1.80.0",
-    "oxlint-tsgolint": "^7.0.2001",
-    "vitest": "^4.1.11"
+    "obuild": "^0.4.40",
+    "oxfmt": "^0.68.0",
+    "oxlint": "^1.83.0",
+    "oxlint-tsgolint": "^7.0.2002",
+    "typescript": "6.0.3",
+    "vitest": "^5.0.1"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": ">=0.84.2 <1",
@@ -89,9 +78,8 @@
     }
   },
   "engines": {
-    "node": ">=22"
+    "node": ">=24"
   },
-  "packageManager": "pnpm@11.24.0",
   "omp": {
     "extensions": [
       "./packages/omp/extensions/harnesses.ts"
@@ -101,5 +89,16 @@
     "extensions": [
       "./packages/pi/extensions/harnesses.ts"
     ]
+  },
+  "scripts": {
+    "build": "obuild",
+    "dev": "obuild --stub",
+    "docs": "pnpm --dir docs dev",
+    "lint": "pnpm build && oxlint . && oxfmt --check .",
+    "lint:fix": "pnpm build && oxlint . --fix && oxfmt . && pnpm build",
+    "typecheck": "tsgo --noEmit --skipLibCheck && pnpm build && tsgo --noEmit --skipLibCheck -p tsconfig.extensions.json",
+    "test": "vitest",
+    "test:run": "vitest --run",
+    "release": "pnpm test:run && pnpm build && changelogen --release --push"
   }
-}
+}

package/packages/pi/extensions/harnesses.ts

@@ -81,7 +81,9 @@ export default function harnessesExtension(pi: ExtensionAPI): void {
     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.",
-    promptGuidelines: ["The scan checks each harness's binaries on PATH and reads their versions."],
+    promptGuidelines: [
+      "The scan checks binaries on PATH. Versions come from native metadata or the CLI.",
+    ],
     parameters: schemas.detect,
     ...statusRenderers("harnesses_detect"),
     async execute(_toolCallId, _params): Promise<AgentToolResult<HarnessTools.HarnessListing>> {