@odla-ai/harness 0.11.17 → 0.11.19

package/dist/index.d.ts

@@ -1,5 +1,7 @@
-import { f as HarnessToolBroker, C as CodeSessionEventData, g as HarnessToolResponse, h as HarnessAgentInput, b as HarnessEventInput, i as HarnessAgentOutput, H as HarnessControlPlane, j as HarnessAiConnection } from './types-D-Kv1svf.js';
-export { k as CodeSessionEvent, l as CodeToolLocationPreview, m as CodeToolPresentation, D as DEFAULT_AI_ROUTE, n as HARNESS_PROTOCOL_VERSION, o as HarnessActor, p as HarnessAttemptStatus, q as HarnessAttemptSummary, c as HarnessCompletion, r as HarnessEvent, d as HarnessInferenceRequest, e as HarnessInferenceResponse, a as HarnessLease, s as HarnessPolicy, t as HarnessRunnerView, u as HarnessTaskDetail, v as HarnessTaskSpec, w as HarnessTaskStatus, x as HarnessTaskSummary, y as HarnessToolName, z as HarnessToolRequest } from './types-D-Kv1svf.js';
+import { g as HarnessToolBroker, h as HarnessToolResponse, i as HarnessAgentInput, b as HarnessEventInput, j as HarnessAgentOutput, H as HarnessControlPlane, k as HarnessAiConnection } from './types-DM-UgoBN.js';
+export { D as DEFAULT_AI_ROUTE, l as HARNESS_PROTOCOL_VERSION, m as HarnessActor, n as HarnessAttemptStatus, o as HarnessAttemptSummary, c as HarnessCompletion, p as HarnessEvent, d as HarnessInferenceRequest, e as HarnessInferenceResponse, a as HarnessLease, q as HarnessPolicy, r as HarnessRunnerView, s as HarnessTaskDetail, t as HarnessTaskSpec, u as HarnessTaskStatus, v as HarnessTaskSummary, f as HarnessToolName, w as HarnessToolRequest } from './types-DM-UgoBN.js';
+import { C as CodeSessionEventData } from './code-session-event-data-wCQc2py3.js';
+export { a as CodeSessionEvent, b as CodeToolLocationPreview, c as CodeToolPresentation } from './code-session-event-data-wCQc2py3.js';
 import { Ai } from '@odla-ai/ai';
 
 /** Longest failure reason forwarded onto a session event. A reason is a short
@@ -11,16 +13,25 @@ declare const MAX_FAILURE_REASON = 240;
  * failed and could never see why — which is what made an 84% apply_patch
  * failure rate undiagnosable (PM bugs 515655ec and 38d92f1d). */
 declare function toolFailureReason(response: HarnessToolResponse): string | undefined;
+/** Longest serialized tool input, and longest tool output, a verbose stream carries. */
+declare const MAX_VERBOSE_TOOL_BYTES = 4096;
+/** A tool input as a verbose watcher sees it: the object when it fits, else a
+ * marker saying how large it was. A stream must never carry a whole file. */
+declare function boundedToolInput(value: Record<string, unknown>): Record<string, unknown>;
+/** A tool output as a verbose watcher sees it, bounded. */
+declare function boundedToolOutput(content: string): string;
 /** Wrap `broker` so every effect reports its start and its finish.
  *
  * `emit` is the engine's own event sink; it already swallows its own errors, so
- * reporting can never fail the effect it is reporting on.
+ * reporting can never fail the effect it is reporting on. With `detail:
+ * "verbose"` each event also carries the bounded input and output.
  */
 declare function observedBroker(input: {
     broker: HarnessToolBroker;
     operationIdFor: (requestId: string) => string;
     emit: (event: CodeSessionEventData) => Promise<void>;
     now?: () => number;
+    detail?: "standard" | "verbose";
 }): HarnessToolBroker;
 
 /** Error raised when an agent emits malformed, oversized, or unsupported protocol data. */
@@ -62,4 +73,4 @@ declare function createOdlaAiConnection(ai: Pick<Ai, "chat">, options?: {
     policyVersion?: number;
 }): HarnessAiConnection;
 
-export { CodeSessionEventData, HarnessAgentInput, HarnessAgentOutput, HarnessAiConnection, type HarnessControlClientOptions, HarnessControlError, HarnessControlPlane, HarnessEventInput, HarnessProtocolError, HarnessToolBroker, HarnessToolResponse, MAX_FAILURE_REASON, createHarnessControlClient, createOdlaAiConnection, encodeAgentInput, makeHarnessEvent, observedBroker, parseAgentOutput, toolFailureReason };
+export { CodeSessionEventData, HarnessAgentInput, HarnessAgentOutput, HarnessAiConnection, type HarnessControlClientOptions, HarnessControlError, HarnessControlPlane, HarnessEventInput, HarnessProtocolError, HarnessToolBroker, HarnessToolResponse, MAX_FAILURE_REASON, MAX_VERBOSE_TOOL_BYTES, boundedToolInput, boundedToolOutput, createHarnessControlClient, createOdlaAiConnection, encodeAgentInput, makeHarnessEvent, observedBroker, parseAgentOutput, toolFailureReason };

package/dist/index.js

@@ -4,19 +4,22 @@ import {
 } from "./chunk-PTXZVYD4.js";
 import {
   MAX_FAILURE_REASON,
+  MAX_VERBOSE_TOOL_BYTES,
+  boundedToolInput,
+  boundedToolOutput,
   observedBroker,
   toolFailureReason
-} from "./chunk-6T26HEWI.js";
+} from "./chunk-SMN2FWQE.js";
 import {
   HarnessProtocolError,
   encodeAgentInput,
   makeHarnessEvent,
   parseAgentOutput
-} from "./chunk-T2IW7MYQ.js";
+} from "./chunk-4TG55ATB.js";
 import {
   DEFAULT_AI_ROUTE,
   HARNESS_PROTOCOL_VERSION
-} from "./chunk-ONYW2VSB.js";
+} from "./chunk-O4QLHUGO.js";
 
 // src/ai.ts
 function createOdlaAiConnection(ai, options = {}) {
@@ -43,6 +46,9 @@ export {
   HarnessControlError,
   HarnessProtocolError,
   MAX_FAILURE_REASON,
+  MAX_VERBOSE_TOOL_BYTES,
+  boundedToolInput,
+  boundedToolOutput,
   createHarnessControlClient,
   createOdlaAiConnection,
   encodeAgentInput,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/ai.ts"],"sourcesContent":["import type { Ai } from \"@odla-ai/ai\";\nimport type { HarnessAiConnection, HarnessInferenceRequest, HarnessInferenceResponse } from \"./types\";\n\n/**\n * Adapt the normalized odla AI chat surface to a harness connection.\n * Provider credentials remain in the process that owns `ai`; only normalized\n * requests and responses cross the container protocol.\n */\nexport function createOdlaAiConnection(\n  ai: Pick<Ai, \"chat\">,\n  options: { model?: string; policyVersion?: number } = {},\n): HarnessAiConnection {\n  return {\n    async infer(request: HarnessInferenceRequest): Promise<HarnessInferenceResponse> {\n      const response = await ai.chat({ ...request.call, ...(options.model ? { model: options.model } : {}) });\n      return {\n        requestId: request.requestId,\n        response,\n        receipt: {\n          provider: response.provider,\n          model: response.model,\n          policyVersion: options.policyVersion ?? 1,\n          inputTokens: response.usage.inputTokens ?? 0,\n          outputTokens: response.usage.outputTokens ?? 0,\n        },\n      };\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAQO,SAAS,uBACd,IACA,UAAsD,CAAC,GAClC;AACrB,SAAO;AAAA,IACL,MAAM,MAAM,SAAqE;AAC/E,YAAM,WAAW,MAAM,GAAG,KAAK,EAAE,GAAG,QAAQ,MAAM,GAAI,QAAQ,QAAQ,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC,EAAG,CAAC;AACtG,aAAO;AAAA,QACL,WAAW,QAAQ;AAAA,QACnB;AAAA,QACA,SAAS;AAAA,UACP,UAAU,SAAS;AAAA,UACnB,OAAO,SAAS;AAAA,UAChB,eAAe,QAAQ,iBAAiB;AAAA,UACxC,aAAa,SAAS,MAAM,eAAe;AAAA,UAC3C,cAAc,SAAS,MAAM,gBAAgB;AAAA,QAC/C;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../src/ai.ts"],"sourcesContent":["import type { Ai } from \"@odla-ai/ai\";\nimport type { HarnessAiConnection, HarnessInferenceRequest, HarnessInferenceResponse } from \"./types\";\n\n/**\n * Adapt the normalized odla AI chat surface to a harness connection.\n * Provider credentials remain in the process that owns `ai`; only normalized\n * requests and responses cross the container protocol.\n */\nexport function createOdlaAiConnection(\n  ai: Pick<Ai, \"chat\">,\n  options: { model?: string; policyVersion?: number } = {},\n): HarnessAiConnection {\n  return {\n    async infer(request: HarnessInferenceRequest): Promise<HarnessInferenceResponse> {\n      const response = await ai.chat({ ...request.call, ...(options.model ? { model: options.model } : {}) });\n      return {\n        requestId: request.requestId,\n        response,\n        receipt: {\n          provider: response.provider,\n          model: response.model,\n          policyVersion: options.policyVersion ?? 1,\n          inputTokens: response.usage.inputTokens ?? 0,\n          outputTokens: response.usage.outputTokens ?? 0,\n        },\n      };\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAQO,SAAS,uBACd,IACA,UAAsD,CAAC,GAClC;AACrB,SAAO;AAAA,IACL,MAAM,MAAM,SAAqE;AAC/E,YAAM,WAAW,MAAM,GAAG,KAAK,EAAE,GAAG,QAAQ,MAAM,GAAI,QAAQ,QAAQ,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC,EAAG,CAAC;AACtG,aAAO;AAAA,QACL,WAAW,QAAQ;AAAA,QACnB;AAAA,QACA,SAAS;AAAA,UACP,UAAU,SAAS;AAAA,UACnB,OAAO,SAAS;AAAA,UAChB,eAAe,QAAQ,iBAAiB;AAAA,UACxC,aAAa,SAAS,MAAM,eAAe;AAAA,UAC3C,cAAc,SAAS,MAAM,gBAAgB;AAAA,QAC/C;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/node.cjs

@@ -1446,7 +1446,7 @@ var CodeRuntimeReconciler = class {
 };
 
 // src/code-runtime.ts
-var CODE_RUNTIME_PROTOCOL_VERSION = 3;
+var CODE_RUNTIME_PROTOCOL_VERSION = 4;
 async function runCodeRuntimeHeartbeatLoop(options) {
   const heartbeatMs = options.heartbeatMs ?? 15e3;
   if (!Number.isSafeInteger(heartbeatMs) || heartbeatMs < 1e3 || heartbeatMs > 3e5) {
@@ -2334,13 +2334,13 @@ function codeCommandMetadata(payload, resume) {
   const title = payload.title;
   const prompt = payload.prompt;
   const maxTokensPerInteraction = payload.maxTokensPerInteraction ?? 32e3;
-  if (role !== "coding" && role !== "review" || typeof title !== "string" || typeof prompt !== "string") {
+  if (role !== "coding" && role !== "review" && role !== "planning" || typeof title !== "string" || typeof prompt !== "string") {
     throw new TypeError(`invalid Code ${resume ? "resume" : "start"} metadata`);
   }
   if (payload.readOnly !== void 0 && typeof payload.readOnly !== "boolean") {
     throw new TypeError(`invalid Code ${resume ? "resume" : "start"} read-only capability`);
   }
-  const readOnly = role === "review" || payload.readOnly === true;
+  const readOnly = role !== "coding" || payload.readOnly === true;
   const planning = trusted?.planningInputDigest;
   const attestation = trusted?.attestationDigest;
   const repository = trusted?.repository;
@@ -2353,11 +2353,16 @@ function codeCommandMetadata(payload, resume) {
   if (!Number.isSafeInteger(maxTokensPerInteraction) || Number(maxTokensPerInteraction) < 4e3 || Number(maxTokensPerInteraction) > 2e5) {
     throw new TypeError(`invalid Code ${resume ? "resume" : "start"} interaction token limit`);
   }
+  const eventDetail = payload.eventDetail ?? "standard";
+  if (eventDetail !== "standard" && eventDetail !== "verbose") {
+    throw new TypeError(`invalid Code ${resume ? "resume" : "start"} event detail`);
+  }
   return {
     role,
     readOnly,
     title,
     prompt,
+    eventDetail,
     proof: codeCommandProof(payload.proof, resume),
     maxTokensPerInteraction: Number(maxTokensPerInteraction),
     planningInputDigest: typeof planning === "string" && /^sha256:[0-9a-f]{64}$/.test(planning) ? planning : null,
@@ -3306,6 +3311,20 @@ async function sessionSkillsFor(options, command) {
 
 // src/code-runtime-inference.ts
 var inferWithBackoff = (infer, wait2, onRetry) => withOverloadRetry(infer, wait2, (cause, delayMs) => onRetry(cause, delayMs), transientControlFailure);
+var MAX_VERBOSE_TEXT = 4e3;
+var clip = (text2) => text2.length <= MAX_VERBOSE_TEXT ? text2 : `${text2.slice(0, MAX_VERBOSE_TEXT - 1)}\u2026`;
+function verboseTurnEvents(response2, durationMs) {
+  const events = [];
+  const interim = response2.response.stopReason === "tool_use";
+  for (const block of response2.response.content) {
+    if (block.type === "thinking" && block.thinking.trim()) {
+      events.push({ type: "thinking", available: true, durationMs, text: clip(block.thinking.trim()) });
+    } else if (block.type === "text" && interim && block.text.trim()) {
+      events.push({ type: "text", text: clip(block.text.trim()) });
+    }
+  }
+  return events;
+}
 async function handleCodeRuntimeInference(input) {
   const { command, request, state } = input;
   const startedAt = Date.now();
@@ -3323,6 +3342,11 @@ async function handleCodeRuntimeInference(input) {
       message: `Code control plane overloaded (${cause.code}); retrying the model call in ${delayMs / 1e3}s`
     }).catch(() => void 0)
   );
+  if (input.metadata.eventDetail === "verbose") {
+    for (const event of verboseTurnEvents(response2, Date.now() - startedAt)) {
+      await input.event(event).catch(() => void 0);
+    }
+  }
   state.tokens += response2.receipt.inputTokens + response2.receipt.outputTokens;
   const { costUsd } = response2.receipt;
   if (costUsd === void 0) state.costKnown = false;
@@ -3517,8 +3541,17 @@ var DEFAULT_FAILURE_REASON = {
   "tool denied by CaMeL policy": "tool denied by CaMeL policy",
   "review sessions are read-only": "review session is read-only; workspace changes are not permitted"
 };
+var MAX_VERBOSE_TOOL_BYTES = 4096;
+function boundedToolInput(value) {
+  const serialized = JSON.stringify(value);
+  return serialized.length <= MAX_VERBOSE_TOOL_BYTES ? value : { truncated: true, bytes: serialized.length, keys: Object.keys(value).slice(0, 20) };
+}
+function boundedToolOutput(content) {
+  return content.length <= MAX_VERBOSE_TOOL_BYTES ? content : `${content.slice(0, MAX_VERBOSE_TOOL_BYTES - 1)}\u2026`;
+}
 function observedBroker(input) {
   const now = input.now ?? Date.now;
+  const verbose = input.detail === "verbose";
   return {
     execute: async (context, request) => {
       const startedAt = now();
@@ -3529,7 +3562,8 @@ function observedBroker(input) {
         phase: "started",
         tool: request.tool,
         operationId,
-        ...startedPresentation ? { presentation: startedPresentation } : {}
+        ...startedPresentation ? { presentation: startedPresentation } : {},
+        ...verbose ? { input: boundedToolInput(request.input) } : {}
       });
       const response2 = await input.broker.execute(context, request);
       const completedPresentation = codeToolResultPresentation(request, response2);
@@ -3542,7 +3576,8 @@ function observedBroker(input) {
         durationMs: now() - startedAt,
         operationId,
         ...failureReason ? { failureReason } : {},
-        ...completedPresentation ? { presentation: completedPresentation } : {}
+        ...completedPresentation ? { presentation: completedPresentation } : {},
+        ...verbose ? { output: boundedToolOutput(response2.content) } : {}
       });
       return response2;
     }
@@ -4435,7 +4470,7 @@ function createCodeRuntimeToolBroker(input, lease, role) {
     "sandbox.who_touches",
     "sandbox.run_recipe"
   ]);
-  return role === "coding" ? broker : { execute: (context, request) => reviewTools.has(request.tool) ? broker.execute(context, request) : Promise.resolve({ requestId: request.requestId, ok: false, content: "review sessions are read-only" }) };
+  return role !== "review" ? broker : { execute: (context, request) => reviewTools.has(request.tool) ? broker.execute(context, request) : Promise.resolve({ requestId: request.requestId, ok: false, content: "review sessions are read-only" }) };
 }
 
 // src/code-runtime-events.ts
@@ -5022,6 +5057,7 @@ var TheseusRuntimeEngine = class {
       buildPolicyDigest: resolvedRecipes.buildPolicyDigest,
       role: metadata.role,
       readOnly: metadata.readOnly,
+      eventDetail: metadata.eventDetail,
       title: metadata.title,
       proof: metadata.proof,
       maxTokensPerInteraction: metadata.maxTokensPerInteraction,
@@ -5089,6 +5125,7 @@ var TheseusRuntimeEngine = class {
         prompt,
         proof: active.proof,
         maxTokensPerInteraction: active.maxTokensPerInteraction,
+        eventDetail: active.eventDetail,
         planningInputDigest: active.planningInputDigest,
         attestationDigest: "pursue",
         repository: active.repository,
@@ -5133,6 +5170,7 @@ var TheseusRuntimeEngine = class {
       prompt,
       proof: active.proof,
       maxTokensPerInteraction: active.maxTokensPerInteraction,
+      eventDetail: active.eventDetail,
       planningInputDigest: active.planningInputDigest,
       attestationDigest: "follow-up",
       repository: active.repository,
@@ -5216,7 +5254,8 @@ var TheseusRuntimeEngine = class {
     return observedBroker({
       broker,
       operationIdFor: (requestId) => digestRuntimeValue(`${command.commandId}:${requestId}`),
-      emit: (event) => this.#event(command, event, active.conversationRefs).catch(() => void 0)
+      emit: (event) => this.#event(command, event, active.conversationRefs).catch(() => void 0),
+      detail: active.eventDetail
     });
   }
   async #checkpoint(command) {