@odla-ai/harness 0.1.0

package/dist/testing.cjs

@@ -0,0 +1,106 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/testing.ts
+var testing_exports = {};
+__export(testing_exports, {
+  FakeHarnessControlPlane: () => FakeHarnessControlPlane,
+  fixtureLease: () => fixtureLease
+});
+module.exports = __toCommonJS(testing_exports);
+
+// src/types.ts
+var HARNESS_PROTOCOL_VERSION = 1;
+
+// src/testing.ts
+function fixtureLease(overrides = {}) {
+  return {
+    protocolVersion: HARNESS_PROTOCOL_VERSION,
+    leaseId: "lease_fixture",
+    generation: 1,
+    expiresAt: Date.now() + 6e4,
+    task: {
+      taskId: "task_fixture",
+      attemptId: "attempt_fixture",
+      title: "Fixture task",
+      prompt: "Create HARNESS_RESULT.md",
+      workspace: "fixture",
+      aiRoute: "coding",
+      policy: {
+        network: "none",
+        timeoutMs: 3e4,
+        maxOutputBytes: 1e6,
+        maxPatchBytes: 1e6
+      }
+    },
+    ...overrides
+  };
+}
+var FakeHarnessControlPlane = class {
+  leases = [];
+  events = [];
+  completions = [];
+  inferenceRequests = [];
+  cancelRequested = false;
+  response = {
+    id: "oracle_fixture",
+    model: "fixture-model",
+    provider: "openai",
+    role: "assistant",
+    content: [{ type: "text", text: "deterministic fixture response" }],
+    stopReason: "end_turn",
+    usage: { inputTokens: 5, outputTokens: 4 }
+  };
+  constructor(...leases) {
+    this.leases.push(...leases);
+  }
+  async lease(workspaces) {
+    const index = this.leases.findIndex((candidate) => workspaces.includes(candidate.task.workspace));
+    return index < 0 ? null : this.leases.splice(index, 1)[0];
+  }
+  async heartbeat() {
+    return { cancelRequested: this.cancelRequested, expiresAt: Date.now() + 6e4 };
+  }
+  async appendEvents(_attemptId, _leaseId, events) {
+    this.events.push(...events);
+  }
+  async infer(_attemptId, _leaseId, request) {
+    this.inferenceRequests.push(request);
+    return {
+      requestId: request.requestId,
+      response: this.response,
+      receipt: {
+        provider: this.response.provider,
+        model: this.response.model,
+        policyVersion: 1,
+        inputTokens: this.response.usage.inputTokens ?? 0,
+        outputTokens: this.response.usage.outputTokens ?? 0
+      }
+    };
+  }
+  async complete(_attemptId, _leaseId, completion) {
+    this.completions.push(completion);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FakeHarnessControlPlane,
+  fixtureLease
+});
+//# sourceMappingURL=testing.cjs.map

package/dist/testing.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing.ts","../src/types.ts"],"sourcesContent":["import type { OracleResponse } from \"@odla-ai/ai\";\nimport {\n  HARNESS_PROTOCOL_VERSION,\n  type HarnessCompletion,\n  type HarnessControlPlane,\n  type HarnessEventInput,\n  type HarnessInferenceRequest,\n  type HarnessInferenceResponse,\n  type HarnessLease,\n} from \"./types\";\n\n/** Create a deterministic, valid lease for harness unit and integration tests. */\nexport function fixtureLease(overrides: Partial<HarnessLease> = {}): HarnessLease {\n  return {\n    protocolVersion: HARNESS_PROTOCOL_VERSION,\n    leaseId: \"lease_fixture\",\n    generation: 1,\n    expiresAt: Date.now() + 60_000,\n    task: {\n      taskId: \"task_fixture\",\n      attemptId: \"attempt_fixture\",\n      title: \"Fixture task\",\n      prompt: \"Create HARNESS_RESULT.md\",\n      workspace: \"fixture\",\n      aiRoute: \"coding\",\n      policy: {\n        network: \"none\",\n        timeoutMs: 30_000,\n        maxOutputBytes: 1_000_000,\n        maxPatchBytes: 1_000_000,\n      },\n    },\n    ...overrides,\n  };\n}\n\n/** In-memory control plane that records runner interactions without network access. */\nexport class FakeHarnessControlPlane implements HarnessControlPlane {\n  readonly leases: HarnessLease[] = [];\n  readonly events: HarnessEventInput[] = [];\n  readonly completions: HarnessCompletion[] = [];\n  readonly inferenceRequests: HarnessInferenceRequest[] = [];\n  cancelRequested = false;\n  response: OracleResponse = {\n    id: \"oracle_fixture\",\n    model: \"fixture-model\",\n    provider: \"openai\",\n    role: \"assistant\",\n    content: [{ type: \"text\", text: \"deterministic fixture response\" }],\n    stopReason: \"end_turn\",\n    usage: { inputTokens: 5, outputTokens: 4 },\n  };\n\n  constructor(...leases: HarnessLease[]) { this.leases.push(...leases); }\n\n  async lease(workspaces: string[]): Promise<HarnessLease | null> {\n    const index = this.leases.findIndex((candidate) => workspaces.includes(candidate.task.workspace));\n    return index < 0 ? null : this.leases.splice(index, 1)[0]!;\n  }\n  async heartbeat(): Promise<{ cancelRequested: boolean; expiresAt: number }> {\n    return { cancelRequested: this.cancelRequested, expiresAt: Date.now() + 60_000 };\n  }\n  async appendEvents(_attemptId: string, _leaseId: string, events: HarnessEventInput[]): Promise<void> {\n    this.events.push(...events);\n  }\n  async infer(_attemptId: string, _leaseId: string, request: HarnessInferenceRequest): Promise<HarnessInferenceResponse> {\n    this.inferenceRequests.push(request);\n    return {\n      requestId: request.requestId,\n      response: this.response,\n      receipt: {\n        provider: this.response.provider,\n        model: this.response.model,\n        policyVersion: 1,\n        inputTokens: this.response.usage.inputTokens ?? 0,\n        outputTokens: this.response.usage.outputTokens ?? 0,\n      },\n    };\n  }\n  async complete(_attemptId: string, _leaseId: string, completion: HarnessCompletion): Promise<void> {\n    this.completions.push(completion);\n  }\n}\n","import type { ChatInput, OracleResponse } from \"@odla-ai/ai\";\n\n/** Current JSONL protocol version exchanged between a runner and an agent container. */\nexport const HARNESS_PROTOCOL_VERSION = 1 as const;\n\n/** Default control-plane route used for model inference requested by coding agents. */\nexport const DEFAULT_AI_ROUTE = \"coding\" as const;\n\n/** Lifecycle state reported for a harness task and its active attempt. */\nexport type HarnessTaskStatus =\n  | \"queued\"\n  | \"running\"\n  | \"cancel_requested\"\n  | \"completed\"\n  | \"failed\"\n  | \"cancelled\";\n\n/** Lifecycle state of one execution attempt for a task. */\nexport type HarnessAttemptStatus = HarnessTaskStatus;\n\n/** Trusted or untrusted participant that emitted a harness event. */\nexport type HarnessActor = \"operator\" | \"runner\" | \"agent\" | \"model\" | \"system\";\n\n/** Resource and isolation limits enforced while an untrusted task executes. */\nexport interface HarnessPolicy {\n  network: \"none\";\n  timeoutMs: number;\n  maxOutputBytes: number;\n  maxPatchBytes: number;\n}\n\n/** Immutable task instructions and execution policy delivered with a lease. */\nexport interface HarnessTaskSpec {\n  taskId: string;\n  attemptId: string;\n  title: string;\n  prompt: string;\n  workspace: string;\n  aiRoute: string;\n  policy: HarnessPolicy;\n  parentAttemptId?: string | null;\n  checkpointSeq?: number | null;\n}\n\n/** Time-bound assignment authorizing a runner to execute one task attempt. */\nexport interface HarnessLease {\n  protocolVersion: typeof HARNESS_PROTOCOL_VERSION;\n  leaseId: string;\n  generation: number;\n  expiresAt: number;\n  task: HarnessTaskSpec;\n}\n\n/** Runner-supplied event before the control plane assigns sequence and task metadata. */\nexport interface HarnessEventInput {\n  eventId: string;\n  kind: string;\n  actor: HarnessActor;\n  payload: unknown;\n  createdAt: number;\n}\n\n/** Persisted, ordered event associated with a specific task attempt. */\nexport interface HarnessEvent extends HarnessEventInput {\n  seq: number;\n  taskId: string;\n  attemptId: string;\n}\n\n/** List-view metadata for a task and its current attempt. */\nexport interface HarnessTaskSummary {\n  taskId: string;\n  attemptId: string;\n  appId: string;\n  env: string;\n  title: string;\n  prompt: string;\n  workspace: string;\n  aiRoute: string;\n  status: HarnessTaskStatus;\n  parentAttemptId: string | null;\n  checkpointSeq: number | null;\n  runnerId: string | null;\n  generation: number;\n  createdAt: number;\n  updatedAt: number;\n}\n\n/** List-view metadata for one attempt, including retry ancestry and runner ownership. */\nexport interface HarnessAttemptSummary {\n  attemptId: string;\n  taskId: string;\n  parentAttemptId: string | null;\n  checkpointSeq: number | null;\n  status: HarnessAttemptStatus;\n  runnerId: string | null;\n  generation: number;\n  createdAt: number;\n  updatedAt: number;\n}\n\n/** Complete task view including attempts, events, result, and generated patch. */\nexport interface HarnessTaskDetail extends HarnessTaskSummary {\n  attempts: HarnessAttemptSummary[];\n  events: HarnessEvent[];\n  patch: string | null;\n  result: unknown;\n}\n\n/** Public control-plane view of a registered harness runner. */\nexport interface HarnessRunnerView {\n  runnerId: string;\n  appId: string;\n  env: string;\n  name: string;\n  createdAt: number;\n  lastSeenAt: number | null;\n  revokedAt: number | null;\n}\n\n/** Credential-free normalized model request sent from an agent through the runner. */\nexport interface HarnessInferenceRequest {\n  requestId: string;\n  /** Exact initial, follow-up, or resume command whose budget this call consumes. */\n  interactionId?: string;\n  call: ChatInput;\n}\n\n/** Normalized model response plus auditable provider, policy, and token metadata. */\nexport interface HarnessInferenceResponse {\n  requestId: string;\n  response: OracleResponse;\n  receipt: {\n    provider: string;\n    model: string;\n    policyVersion: number;\n    inputTokens: number;\n    outputTokens: number;\n  };\n}\n\n/** Bounded, content-free session activity emitted by a Code runtime. Message\n * bodies are projected separately into the app's owner-private odla-db chat. */\nexport type CodeSessionEventData =\n  | { type: \"message\"; actor: \"agent\" | \"system\"; body: string }\n  | { type: \"diagnostic\"; level: \"error\"; message: string }\n  | { type: \"thinking\"; available: true; durationMs: number }\n  | { type: \"tool\"; phase: \"started\"; tool: HarnessToolName }\n  | { type: \"tool\"; phase: \"completed\"; tool: HarnessToolName; ok: boolean; durationMs: number }\n  | {\n      type: \"usage\"; provider: string; model: string;\n      inputTokens: number; outputTokens: number; durationMs: number;\n      interactionId?: string; interactionTokens?: number; interactionMaxTokens?: number;\n    }\n  | {\n      type: \"status\"; status: \"running\" | \"idle\" | \"failed\" | \"checkpointed\";\n      durationMs?: number;\n    };\n\n/** Registry-assigned cursor and timestamp for an owner-visible Code event. */\nexport type CodeSessionEvent = CodeSessionEventData & {\n  eventId: string; sequence: number; createdAt: number;\n};\n\n/** Closed set of effects an agent container may request from its trusted broker. */\nexport type HarnessToolName = \"sandbox.read\" | \"sandbox.apply_patch\" | \"sandbox.run_recipe\";\n/** Correlated, structured tool request emitted by an untrusted agent container. */\nexport interface HarnessToolRequest {\n  requestId: string;\n  tool: HarnessToolName;\n  input: Record<string, unknown>;\n}\n/** Bounded tool result returned to an agent after trusted policy evaluation. */\nexport interface HarnessToolResponse {\n  requestId: string;\n  ok: boolean;\n  content: string;\n  details?: Record<string, unknown>;\n}\n\n/** Validated JSONL message emitted by an untrusted agent container. */\nexport type HarnessAgentOutput =\n  | {\n      protocolVersion: typeof HARNESS_PROTOCOL_VERSION;\n      type: \"event\";\n      kind: string;\n      payload?: unknown;\n    }\n  | {\n      protocolVersion: typeof HARNESS_PROTOCOL_VERSION;\n      type: \"inference.request\";\n      requestId: string;\n      call: ChatInput;\n    }\n  | ({ protocolVersion: typeof HARNESS_PROTOCOL_VERSION; type: \"tool.request\" } & HarnessToolRequest)\n  | {\n      protocolVersion: typeof HARNESS_PROTOCOL_VERSION;\n      type: \"attempt.complete\";\n      status: \"completed\" | \"failed\" | \"cancelled\";\n      result?: unknown;\n    };\n\n/** JSONL command or inference result written by the trusted runner to an agent. */\nexport type HarnessAgentInput =\n  | {\n      protocolVersion: typeof HARNESS_PROTOCOL_VERSION;\n      type: \"task.start\";\n      task: HarnessTaskSpec;\n    }\n  | {\n      protocolVersion: typeof HARNESS_PROTOCOL_VERSION;\n      type: \"inference.response\";\n      requestId: string;\n      response: OracleResponse;\n    }\n  | ({ protocolVersion: typeof HARNESS_PROTOCOL_VERSION; type: \"tool.response\" } & HarnessToolResponse)\n  | {\n      protocolVersion: typeof HARNESS_PROTOCOL_VERSION;\n      type: \"attempt.cancel\";\n      reason: string;\n    };\n\n/** Terminal attempt report submitted by a runner to the control plane. */\nexport interface HarnessCompletion {\n  status: \"completed\" | \"failed\" | \"cancelled\";\n  result?: unknown;\n  patch?: string;\n  error?: string;\n}\n\n/** Operations a credentialed runner may perform against the harness control plane. */\nexport interface HarnessControlPlane {\n  lease(workspaces: string[]): Promise<HarnessLease | null>;\n  heartbeat(attemptId: string, leaseId: string): Promise<{ cancelRequested: boolean; expiresAt: number }>;\n  appendEvents(attemptId: string, leaseId: string, events: HarnessEventInput[]): Promise<void>;\n  infer(attemptId: string, leaseId: string, request: HarnessInferenceRequest): Promise<HarnessInferenceResponse>;\n  complete(attemptId: string, leaseId: string, completion: HarnessCompletion): Promise<void>;\n}\n\n/** Trusted inference bridge used to keep model credentials outside agent containers. */\nexport interface HarnessAiConnection {\n  infer(request: HarnessInferenceRequest): Promise<HarnessInferenceResponse>;\n}\n\n/** Trusted tool boundary. Implementations must evaluate CaMeL policy before effects. */\nexport interface HarnessToolBroker {\n  execute(\n    context: { lease: HarnessLease; workspaceDir: string; signal?: AbortSignal },\n    request: HarnessToolRequest,\n  ): Promise<HarnessToolResponse>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACGO,IAAM,2BAA2B;;;ADSjC,SAAS,aAAa,YAAmC,CAAC,GAAiB;AAChF,SAAO;AAAA,IACL,iBAAiB;AAAA,IACjB,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,WAAW,KAAK,IAAI,IAAI;AAAA,IACxB,MAAM;AAAA,MACJ,QAAQ;AAAA,MACR,WAAW;AAAA,MACX,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,WAAW;AAAA,MACX,SAAS;AAAA,MACT,QAAQ;AAAA,QACN,SAAS;AAAA,QACT,WAAW;AAAA,QACX,gBAAgB;AAAA,QAChB,eAAe;AAAA,MACjB;AAAA,IACF;AAAA,IACA,GAAG;AAAA,EACL;AACF;AAGO,IAAM,0BAAN,MAA6D;AAAA,EACzD,SAAyB,CAAC;AAAA,EAC1B,SAA8B,CAAC;AAAA,EAC/B,cAAmC,CAAC;AAAA,EACpC,oBAA+C,CAAC;AAAA,EACzD,kBAAkB;AAAA,EAClB,WAA2B;AAAA,IACzB,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,UAAU;AAAA,IACV,MAAM;AAAA,IACN,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,iCAAiC,CAAC;AAAA,IAClE,YAAY;AAAA,IACZ,OAAO,EAAE,aAAa,GAAG,cAAc,EAAE;AAAA,EAC3C;AAAA,EAEA,eAAe,QAAwB;AAAE,SAAK,OAAO,KAAK,GAAG,MAAM;AAAA,EAAG;AAAA,EAEtE,MAAM,MAAM,YAAoD;AAC9D,UAAM,QAAQ,KAAK,OAAO,UAAU,CAAC,cAAc,WAAW,SAAS,UAAU,KAAK,SAAS,CAAC;AAChG,WAAO,QAAQ,IAAI,OAAO,KAAK,OAAO,OAAO,OAAO,CAAC,EAAE,CAAC;AAAA,EAC1D;AAAA,EACA,MAAM,YAAsE;AAC1E,WAAO,EAAE,iBAAiB,KAAK,iBAAiB,WAAW,KAAK,IAAI,IAAI,IAAO;AAAA,EACjF;AAAA,EACA,MAAM,aAAa,YAAoB,UAAkB,QAA4C;AACnG,SAAK,OAAO,KAAK,GAAG,MAAM;AAAA,EAC5B;AAAA,EACA,MAAM,MAAM,YAAoB,UAAkB,SAAqE;AACrH,SAAK,kBAAkB,KAAK,OAAO;AACnC,WAAO;AAAA,MACL,WAAW,QAAQ;AAAA,MACnB,UAAU,KAAK;AAAA,MACf,SAAS;AAAA,QACP,UAAU,KAAK,SAAS;AAAA,QACxB,OAAO,KAAK,SAAS;AAAA,QACrB,eAAe;AAAA,QACf,aAAa,KAAK,SAAS,MAAM,eAAe;AAAA,QAChD,cAAc,KAAK,SAAS,MAAM,gBAAgB;AAAA,MACpD;AAAA,IACF;AAAA,EACF;AAAA,EACA,MAAM,SAAS,YAAoB,UAAkB,YAA8C;AACjG,SAAK,YAAY,KAAK,UAAU;AAAA,EAClC;AACF;","names":[]}

package/dist/testing.d.cts

@@ -0,0 +1,25 @@
+import { OracleResponse } from '@odla-ai/ai';
+import { H as HarnessControlPlane, a as HarnessLease, b as HarnessEventInput, c as HarnessCompletion, d as HarnessInferenceRequest, e as HarnessInferenceResponse } from './types-D12vK3K9.cjs';
+
+/** Create a deterministic, valid lease for harness unit and integration tests. */
+declare function fixtureLease(overrides?: Partial<HarnessLease>): HarnessLease;
+/** In-memory control plane that records runner interactions without network access. */
+declare class FakeHarnessControlPlane implements HarnessControlPlane {
+    readonly leases: HarnessLease[];
+    readonly events: HarnessEventInput[];
+    readonly completions: HarnessCompletion[];
+    readonly inferenceRequests: HarnessInferenceRequest[];
+    cancelRequested: boolean;
+    response: OracleResponse;
+    constructor(...leases: HarnessLease[]);
+    lease(workspaces: string[]): Promise<HarnessLease | null>;
+    heartbeat(): Promise<{
+        cancelRequested: boolean;
+        expiresAt: number;
+    }>;
+    appendEvents(_attemptId: string, _leaseId: string, events: HarnessEventInput[]): Promise<void>;
+    infer(_attemptId: string, _leaseId: string, request: HarnessInferenceRequest): Promise<HarnessInferenceResponse>;
+    complete(_attemptId: string, _leaseId: string, completion: HarnessCompletion): Promise<void>;
+}
+
+export { FakeHarnessControlPlane, fixtureLease };

package/dist/testing.d.ts

@@ -0,0 +1,25 @@
+import { OracleResponse } from '@odla-ai/ai';
+import { H as HarnessControlPlane, a as HarnessLease, b as HarnessEventInput, c as HarnessCompletion, d as HarnessInferenceRequest, e as HarnessInferenceResponse } from './types-D12vK3K9.js';
+
+/** Create a deterministic, valid lease for harness unit and integration tests. */
+declare function fixtureLease(overrides?: Partial<HarnessLease>): HarnessLease;
+/** In-memory control plane that records runner interactions without network access. */
+declare class FakeHarnessControlPlane implements HarnessControlPlane {
+    readonly leases: HarnessLease[];
+    readonly events: HarnessEventInput[];
+    readonly completions: HarnessCompletion[];
+    readonly inferenceRequests: HarnessInferenceRequest[];
+    cancelRequested: boolean;
+    response: OracleResponse;
+    constructor(...leases: HarnessLease[]);
+    lease(workspaces: string[]): Promise<HarnessLease | null>;
+    heartbeat(): Promise<{
+        cancelRequested: boolean;
+        expiresAt: number;
+    }>;
+    appendEvents(_attemptId: string, _leaseId: string, events: HarnessEventInput[]): Promise<void>;
+    infer(_attemptId: string, _leaseId: string, request: HarnessInferenceRequest): Promise<HarnessInferenceResponse>;
+    complete(_attemptId: string, _leaseId: string, completion: HarnessCompletion): Promise<void>;
+}
+
+export { FakeHarnessControlPlane, fixtureLease };

package/dist/testing.js

@@ -0,0 +1,79 @@
+import {
+  HARNESS_PROTOCOL_VERSION
+} from "./chunk-QTUEF2HZ.js";
+
+// src/testing.ts
+function fixtureLease(overrides = {}) {
+  return {
+    protocolVersion: HARNESS_PROTOCOL_VERSION,
+    leaseId: "lease_fixture",
+    generation: 1,
+    expiresAt: Date.now() + 6e4,
+    task: {
+      taskId: "task_fixture",
+      attemptId: "attempt_fixture",
+      title: "Fixture task",
+      prompt: "Create HARNESS_RESULT.md",
+      workspace: "fixture",
+      aiRoute: "coding",
+      policy: {
+        network: "none",
+        timeoutMs: 3e4,
+        maxOutputBytes: 1e6,
+        maxPatchBytes: 1e6
+      }
+    },
+    ...overrides
+  };
+}
+var FakeHarnessControlPlane = class {
+  leases = [];
+  events = [];
+  completions = [];
+  inferenceRequests = [];
+  cancelRequested = false;
+  response = {
+    id: "oracle_fixture",
+    model: "fixture-model",
+    provider: "openai",
+    role: "assistant",
+    content: [{ type: "text", text: "deterministic fixture response" }],
+    stopReason: "end_turn",
+    usage: { inputTokens: 5, outputTokens: 4 }
+  };
+  constructor(...leases) {
+    this.leases.push(...leases);
+  }
+  async lease(workspaces) {
+    const index = this.leases.findIndex((candidate) => workspaces.includes(candidate.task.workspace));
+    return index < 0 ? null : this.leases.splice(index, 1)[0];
+  }
+  async heartbeat() {
+    return { cancelRequested: this.cancelRequested, expiresAt: Date.now() + 6e4 };
+  }
+  async appendEvents(_attemptId, _leaseId, events) {
+    this.events.push(...events);
+  }
+  async infer(_attemptId, _leaseId, request) {
+    this.inferenceRequests.push(request);
+    return {
+      requestId: request.requestId,
+      response: this.response,
+      receipt: {
+        provider: this.response.provider,
+        model: this.response.model,
+        policyVersion: 1,
+        inputTokens: this.response.usage.inputTokens ?? 0,
+        outputTokens: this.response.usage.outputTokens ?? 0
+      }
+    };
+  }
+  async complete(_attemptId, _leaseId, completion) {
+    this.completions.push(completion);
+  }
+};
+export {
+  FakeHarnessControlPlane,
+  fixtureLease
+};
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing.ts"],"sourcesContent":["import type { OracleResponse } from \"@odla-ai/ai\";\nimport {\n  HARNESS_PROTOCOL_VERSION,\n  type HarnessCompletion,\n  type HarnessControlPlane,\n  type HarnessEventInput,\n  type HarnessInferenceRequest,\n  type HarnessInferenceResponse,\n  type HarnessLease,\n} from \"./types\";\n\n/** Create a deterministic, valid lease for harness unit and integration tests. */\nexport function fixtureLease(overrides: Partial<HarnessLease> = {}): HarnessLease {\n  return {\n    protocolVersion: HARNESS_PROTOCOL_VERSION,\n    leaseId: \"lease_fixture\",\n    generation: 1,\n    expiresAt: Date.now() + 60_000,\n    task: {\n      taskId: \"task_fixture\",\n      attemptId: \"attempt_fixture\",\n      title: \"Fixture task\",\n      prompt: \"Create HARNESS_RESULT.md\",\n      workspace: \"fixture\",\n      aiRoute: \"coding\",\n      policy: {\n        network: \"none\",\n        timeoutMs: 30_000,\n        maxOutputBytes: 1_000_000,\n        maxPatchBytes: 1_000_000,\n      },\n    },\n    ...overrides,\n  };\n}\n\n/** In-memory control plane that records runner interactions without network access. */\nexport class FakeHarnessControlPlane implements HarnessControlPlane {\n  readonly leases: HarnessLease[] = [];\n  readonly events: HarnessEventInput[] = [];\n  readonly completions: HarnessCompletion[] = [];\n  readonly inferenceRequests: HarnessInferenceRequest[] = [];\n  cancelRequested = false;\n  response: OracleResponse = {\n    id: \"oracle_fixture\",\n    model: \"fixture-model\",\n    provider: \"openai\",\n    role: \"assistant\",\n    content: [{ type: \"text\", text: \"deterministic fixture response\" }],\n    stopReason: \"end_turn\",\n    usage: { inputTokens: 5, outputTokens: 4 },\n  };\n\n  constructor(...leases: HarnessLease[]) { this.leases.push(...leases); }\n\n  async lease(workspaces: string[]): Promise<HarnessLease | null> {\n    const index = this.leases.findIndex((candidate) => workspaces.includes(candidate.task.workspace));\n    return index < 0 ? null : this.leases.splice(index, 1)[0]!;\n  }\n  async heartbeat(): Promise<{ cancelRequested: boolean; expiresAt: number }> {\n    return { cancelRequested: this.cancelRequested, expiresAt: Date.now() + 60_000 };\n  }\n  async appendEvents(_attemptId: string, _leaseId: string, events: HarnessEventInput[]): Promise<void> {\n    this.events.push(...events);\n  }\n  async infer(_attemptId: string, _leaseId: string, request: HarnessInferenceRequest): Promise<HarnessInferenceResponse> {\n    this.inferenceRequests.push(request);\n    return {\n      requestId: request.requestId,\n      response: this.response,\n      receipt: {\n        provider: this.response.provider,\n        model: this.response.model,\n        policyVersion: 1,\n        inputTokens: this.response.usage.inputTokens ?? 0,\n        outputTokens: this.response.usage.outputTokens ?? 0,\n      },\n    };\n  }\n  async complete(_attemptId: string, _leaseId: string, completion: HarnessCompletion): Promise<void> {\n    this.completions.push(completion);\n  }\n}\n"],"mappings":";;;;;AAYO,SAAS,aAAa,YAAmC,CAAC,GAAiB;AAChF,SAAO;AAAA,IACL,iBAAiB;AAAA,IACjB,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,WAAW,KAAK,IAAI,IAAI;AAAA,IACxB,MAAM;AAAA,MACJ,QAAQ;AAAA,MACR,WAAW;AAAA,MACX,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,WAAW;AAAA,MACX,SAAS;AAAA,MACT,QAAQ;AAAA,QACN,SAAS;AAAA,QACT,WAAW;AAAA,QACX,gBAAgB;AAAA,QAChB,eAAe;AAAA,MACjB;AAAA,IACF;AAAA,IACA,GAAG;AAAA,EACL;AACF;AAGO,IAAM,0BAAN,MAA6D;AAAA,EACzD,SAAyB,CAAC;AAAA,EAC1B,SAA8B,CAAC;AAAA,EAC/B,cAAmC,CAAC;AAAA,EACpC,oBAA+C,CAAC;AAAA,EACzD,kBAAkB;AAAA,EAClB,WAA2B;AAAA,IACzB,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,UAAU;AAAA,IACV,MAAM;AAAA,IACN,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,iCAAiC,CAAC;AAAA,IAClE,YAAY;AAAA,IACZ,OAAO,EAAE,aAAa,GAAG,cAAc,EAAE;AAAA,EAC3C;AAAA,EAEA,eAAe,QAAwB;AAAE,SAAK,OAAO,KAAK,GAAG,MAAM;AAAA,EAAG;AAAA,EAEtE,MAAM,MAAM,YAAoD;AAC9D,UAAM,QAAQ,KAAK,OAAO,UAAU,CAAC,cAAc,WAAW,SAAS,UAAU,KAAK,SAAS,CAAC;AAChG,WAAO,QAAQ,IAAI,OAAO,KAAK,OAAO,OAAO,OAAO,CAAC,EAAE,CAAC;AAAA,EAC1D;AAAA,EACA,MAAM,YAAsE;AAC1E,WAAO,EAAE,iBAAiB,KAAK,iBAAiB,WAAW,KAAK,IAAI,IAAI,IAAO;AAAA,EACjF;AAAA,EACA,MAAM,aAAa,YAAoB,UAAkB,QAA4C;AACnG,SAAK,OAAO,KAAK,GAAG,MAAM;AAAA,EAC5B;AAAA,EACA,MAAM,MAAM,YAAoB,UAAkB,SAAqE;AACrH,SAAK,kBAAkB,KAAK,OAAO;AACnC,WAAO;AAAA,MACL,WAAW,QAAQ;AAAA,MACnB,UAAU,KAAK;AAAA,MACf,SAAS;AAAA,QACP,UAAU,KAAK,SAAS;AAAA,QACxB,OAAO,KAAK,SAAS;AAAA,QACrB,eAAe;AAAA,QACf,aAAa,KAAK,SAAS,MAAM,eAAe;AAAA,QAChD,cAAc,KAAK,SAAS,MAAM,gBAAgB;AAAA,MACpD;AAAA,IACF;AAAA,EACF;AAAA,EACA,MAAM,SAAS,YAAoB,UAAkB,YAA8C;AACjG,SAAK,YAAY,KAAK,UAAU;AAAA,EAClC;AACF;","names":[]}

package/dist/types-D12vK3K9.d.cts

@@ -0,0 +1,249 @@
+import { OracleResponse, ChatInput } from '@odla-ai/ai';
+
+/** Current JSONL protocol version exchanged between a runner and an agent container. */
+declare const HARNESS_PROTOCOL_VERSION: 1;
+/** Default control-plane route used for model inference requested by coding agents. */
+declare const DEFAULT_AI_ROUTE: "coding";
+/** Lifecycle state reported for a harness task and its active attempt. */
+type HarnessTaskStatus = "queued" | "running" | "cancel_requested" | "completed" | "failed" | "cancelled";
+/** Lifecycle state of one execution attempt for a task. */
+type HarnessAttemptStatus = HarnessTaskStatus;
+/** Trusted or untrusted participant that emitted a harness event. */
+type HarnessActor = "operator" | "runner" | "agent" | "model" | "system";
+/** Resource and isolation limits enforced while an untrusted task executes. */
+interface HarnessPolicy {
+    network: "none";
+    timeoutMs: number;
+    maxOutputBytes: number;
+    maxPatchBytes: number;
+}
+/** Immutable task instructions and execution policy delivered with a lease. */
+interface HarnessTaskSpec {
+    taskId: string;
+    attemptId: string;
+    title: string;
+    prompt: string;
+    workspace: string;
+    aiRoute: string;
+    policy: HarnessPolicy;
+    parentAttemptId?: string | null;
+    checkpointSeq?: number | null;
+}
+/** Time-bound assignment authorizing a runner to execute one task attempt. */
+interface HarnessLease {
+    protocolVersion: typeof HARNESS_PROTOCOL_VERSION;
+    leaseId: string;
+    generation: number;
+    expiresAt: number;
+    task: HarnessTaskSpec;
+}
+/** Runner-supplied event before the control plane assigns sequence and task metadata. */
+interface HarnessEventInput {
+    eventId: string;
+    kind: string;
+    actor: HarnessActor;
+    payload: unknown;
+    createdAt: number;
+}
+/** Persisted, ordered event associated with a specific task attempt. */
+interface HarnessEvent extends HarnessEventInput {
+    seq: number;
+    taskId: string;
+    attemptId: string;
+}
+/** List-view metadata for a task and its current attempt. */
+interface HarnessTaskSummary {
+    taskId: string;
+    attemptId: string;
+    appId: string;
+    env: string;
+    title: string;
+    prompt: string;
+    workspace: string;
+    aiRoute: string;
+    status: HarnessTaskStatus;
+    parentAttemptId: string | null;
+    checkpointSeq: number | null;
+    runnerId: string | null;
+    generation: number;
+    createdAt: number;
+    updatedAt: number;
+}
+/** List-view metadata for one attempt, including retry ancestry and runner ownership. */
+interface HarnessAttemptSummary {
+    attemptId: string;
+    taskId: string;
+    parentAttemptId: string | null;
+    checkpointSeq: number | null;
+    status: HarnessAttemptStatus;
+    runnerId: string | null;
+    generation: number;
+    createdAt: number;
+    updatedAt: number;
+}
+/** Complete task view including attempts, events, result, and generated patch. */
+interface HarnessTaskDetail extends HarnessTaskSummary {
+    attempts: HarnessAttemptSummary[];
+    events: HarnessEvent[];
+    patch: string | null;
+    result: unknown;
+}
+/** Public control-plane view of a registered harness runner. */
+interface HarnessRunnerView {
+    runnerId: string;
+    appId: string;
+    env: string;
+    name: string;
+    createdAt: number;
+    lastSeenAt: number | null;
+    revokedAt: number | null;
+}
+/** Credential-free normalized model request sent from an agent through the runner. */
+interface HarnessInferenceRequest {
+    requestId: string;
+    /** Exact initial, follow-up, or resume command whose budget this call consumes. */
+    interactionId?: string;
+    call: ChatInput;
+}
+/** Normalized model response plus auditable provider, policy, and token metadata. */
+interface HarnessInferenceResponse {
+    requestId: string;
+    response: OracleResponse;
+    receipt: {
+        provider: string;
+        model: string;
+        policyVersion: number;
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+/** Bounded, content-free session activity emitted by a Code runtime. Message
+ * bodies are projected separately into the app's owner-private odla-db chat. */
+type CodeSessionEventData = {
+    type: "message";
+    actor: "agent" | "system";
+    body: string;
+} | {
+    type: "diagnostic";
+    level: "error";
+    message: string;
+} | {
+    type: "thinking";
+    available: true;
+    durationMs: number;
+} | {
+    type: "tool";
+    phase: "started";
+    tool: HarnessToolName;
+} | {
+    type: "tool";
+    phase: "completed";
+    tool: HarnessToolName;
+    ok: boolean;
+    durationMs: number;
+} | {
+    type: "usage";
+    provider: string;
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    durationMs: number;
+    interactionId?: string;
+    interactionTokens?: number;
+    interactionMaxTokens?: number;
+} | {
+    type: "status";
+    status: "running" | "idle" | "failed" | "checkpointed";
+    durationMs?: number;
+};
+/** Registry-assigned cursor and timestamp for an owner-visible Code event. */
+type CodeSessionEvent = CodeSessionEventData & {
+    eventId: string;
+    sequence: number;
+    createdAt: number;
+};
+/** Closed set of effects an agent container may request from its trusted broker. */
+type HarnessToolName = "sandbox.read" | "sandbox.apply_patch" | "sandbox.run_recipe";
+/** Correlated, structured tool request emitted by an untrusted agent container. */
+interface HarnessToolRequest {
+    requestId: string;
+    tool: HarnessToolName;
+    input: Record<string, unknown>;
+}
+/** Bounded tool result returned to an agent after trusted policy evaluation. */
+interface HarnessToolResponse {
+    requestId: string;
+    ok: boolean;
+    content: string;
+    details?: Record<string, unknown>;
+}
+/** Validated JSONL message emitted by an untrusted agent container. */
+type HarnessAgentOutput = {
+    protocolVersion: typeof HARNESS_PROTOCOL_VERSION;
+    type: "event";
+    kind: string;
+    payload?: unknown;
+} | {
+    protocolVersion: typeof HARNESS_PROTOCOL_VERSION;
+    type: "inference.request";
+    requestId: string;
+    call: ChatInput;
+} | ({
+    protocolVersion: typeof HARNESS_PROTOCOL_VERSION;
+    type: "tool.request";
+} & HarnessToolRequest) | {
+    protocolVersion: typeof HARNESS_PROTOCOL_VERSION;
+    type: "attempt.complete";
+    status: "completed" | "failed" | "cancelled";
+    result?: unknown;
+};
+/** JSONL command or inference result written by the trusted runner to an agent. */
+type HarnessAgentInput = {
+    protocolVersion: typeof HARNESS_PROTOCOL_VERSION;
+    type: "task.start";
+    task: HarnessTaskSpec;
+} | {
+    protocolVersion: typeof HARNESS_PROTOCOL_VERSION;
+    type: "inference.response";
+    requestId: string;
+    response: OracleResponse;
+} | ({
+    protocolVersion: typeof HARNESS_PROTOCOL_VERSION;
+    type: "tool.response";
+} & HarnessToolResponse) | {
+    protocolVersion: typeof HARNESS_PROTOCOL_VERSION;
+    type: "attempt.cancel";
+    reason: string;
+};
+/** Terminal attempt report submitted by a runner to the control plane. */
+interface HarnessCompletion {
+    status: "completed" | "failed" | "cancelled";
+    result?: unknown;
+    patch?: string;
+    error?: string;
+}
+/** Operations a credentialed runner may perform against the harness control plane. */
+interface HarnessControlPlane {
+    lease(workspaces: string[]): Promise<HarnessLease | null>;
+    heartbeat(attemptId: string, leaseId: string): Promise<{
+        cancelRequested: boolean;
+        expiresAt: number;
+    }>;
+    appendEvents(attemptId: string, leaseId: string, events: HarnessEventInput[]): Promise<void>;
+    infer(attemptId: string, leaseId: string, request: HarnessInferenceRequest): Promise<HarnessInferenceResponse>;
+    complete(attemptId: string, leaseId: string, completion: HarnessCompletion): Promise<void>;
+}
+/** Trusted inference bridge used to keep model credentials outside agent containers. */
+interface HarnessAiConnection {
+    infer(request: HarnessInferenceRequest): Promise<HarnessInferenceResponse>;
+}
+/** Trusted tool boundary. Implementations must evaluate CaMeL policy before effects. */
+interface HarnessToolBroker {
+    execute(context: {
+        lease: HarnessLease;
+        workspaceDir: string;
+        signal?: AbortSignal;
+    }, request: HarnessToolRequest): Promise<HarnessToolResponse>;
+}
+
+export { type CodeSessionEvent as C, DEFAULT_AI_ROUTE as D, type HarnessControlPlane as H, type HarnessLease as a, type HarnessEventInput as b, type HarnessCompletion as c, type HarnessInferenceRequest as d, type HarnessInferenceResponse as e, type HarnessAgentInput as f, type HarnessAgentOutput as g, type HarnessAiConnection as h, type CodeSessionEventData as i, HARNESS_PROTOCOL_VERSION as j, type HarnessActor as k, type HarnessAttemptStatus as l, type HarnessAttemptSummary as m, type HarnessEvent as n, type HarnessPolicy as o, type HarnessRunnerView as p, type HarnessTaskDetail as q, type HarnessTaskSpec as r, type HarnessTaskStatus as s, type HarnessTaskSummary as t, type HarnessToolBroker as u, type HarnessToolName as v, type HarnessToolRequest as w, type HarnessToolResponse as x };