@workbench-ai/agent-driver 0.0.44

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,44 @@
+import { z } from "zod";
+export * from "./behavior-contract.js";
+export * from "./access-contracts.js";
+export * from "./conformance.js";
+export * from "./global-skills.js";
+export * from "./internal-utils.js";
+export * from "./json-rpc.js";
+export * from "./managed-runtime.js";
+export * from "./model-config.js";
+export * from "./normalized-activity.js";
+export * from "./prepare.js";
+export * from "./process-env.js";
+export * from "./session-runtime.js";
+export * from "./trace-builder.js";
+export * from "./trace-replay.js";
+export * from "./tool-semantics.js";
+export * from "./types.js";
+export function defineHarnessProvider(factory) {
+    return factory;
+}
+export function createCliHarnessManifest(args) {
+    return {
+        id: args.id,
+        display_name: args.displayName ?? args.id,
+        auth_schema: zodSchemaToManifestJsonSchema(args.auth),
+        config_schema: zodSchemaToManifestJsonSchema(args.config),
+        defaults: {
+            ...(args.defaults ?? {}),
+            config: { ...(args.defaults?.config ?? {}) },
+        },
+        capabilities: args.capabilities,
+        supported_workspace_modes: [...args.supportedWorkspaceModes],
+    };
+}
+function zodSchemaToManifestJsonSchema(schema) {
+    const jsonSchema = z.toJSONSchema(schema);
+    if (jsonSchema &&
+        typeof jsonSchema === "object" &&
+        !Array.isArray(jsonSchema)) {
+        const { $schema: _schema, ...rest } = jsonSchema;
+        return rest;
+    }
+    return jsonSchema;
+}

package/dist/internal-utils.d.ts

@@ -0,0 +1,8 @@
+export declare function nowIso(): string;
+export declare function createId(prefix: string): string;
+export declare function ensureDir(dirPath: string): Promise<void>;
+export declare function appendNdjson(filePath: string, value: unknown): Promise<void>;
+export declare function expandHome(inputPath: string): string;
+export declare function resolveRuntimeHome(runtimeHome?: string): string;
+export declare function resolveCanonicalProjectRoot(repoRoot: string): string;
+//# sourceMappingURL=internal-utils.d.ts.map

package/dist/internal-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-utils.d.ts","sourceRoot":"","sources":["../src/internal-utils.ts"],"names":[],"mappings":"AAMA,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlF;AAOD,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAUpD;AAED,wBAAgB,kBAAkB,CAChC,WAAW,SAA8E,GACxF,MAAM,CAER;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUpE"}

package/dist/internal-utils.js

@@ -0,0 +1,46 @@
+import { randomUUID } from "node:crypto";
+import { promises as fs } from "node:fs";
+import { realpathSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+export function nowIso() {
+    return new Date().toISOString();
+}
+export function createId(prefix) {
+    return `${prefix}_${randomUUID()}`;
+}
+export async function ensureDir(dirPath) {
+    await fs.mkdir(dirPath, { recursive: true });
+}
+export async function appendNdjson(filePath, value) {
+    await ensureDir(path.dirname(filePath));
+    await fs.appendFile(filePath, `${JSON.stringify(value)}\n`, "utf8");
+}
+function isMissingPathError(error) {
+    const code = error?.code;
+    return code === "ENOENT" || code === "ENOTDIR";
+}
+export function expandHome(inputPath) {
+    if (inputPath === "~") {
+        return process.env.HOME ?? inputPath;
+    }
+    if (inputPath.startsWith("~/")) {
+        return path.join(process.env.HOME ?? "", inputPath.slice(2));
+    }
+    return inputPath;
+}
+export function resolveRuntimeHome(runtimeHome = process.env.AGENT_RUNTIME_HOME ?? path.join(os.homedir(), ".agent-runtime")) {
+    return path.resolve(expandHome(runtimeHome));
+}
+export function resolveCanonicalProjectRoot(repoRoot) {
+    const absoluteRoot = path.resolve(repoRoot);
+    try {
+        return realpathSync.native(absoluteRoot);
+    }
+    catch (error) {
+        if (isMissingPathError(error)) {
+            return absoluteRoot;
+        }
+        throw error;
+    }
+}

package/dist/json-rpc.d.ts

@@ -0,0 +1,22 @@
+export interface JsonRpcResponse<T = unknown> {
+    jsonrpc: "2.0";
+    id: number | string;
+    result?: T;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export interface JsonRpcNotification<T = unknown> {
+    jsonrpc?: "2.0";
+    method: string;
+    params: T;
+}
+export interface JsonRpcRequest<T = unknown> {
+    jsonrpc: "2.0";
+    id: number | string;
+    method: string;
+    params?: T;
+}
+//# sourceMappingURL=json-rpc.d.ts.map

package/dist/json-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-rpc.d.ts","sourceRoot":"","sources":["../src/json-rpc.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC9C,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,CAAC,CAAC;CACX;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,CAAC,CAAC;CACZ"}

package/dist/json-rpc.js

@@ -0,0 +1 @@
+export {};

package/dist/managed-runtime.d.ts

@@ -0,0 +1,21 @@
+import type { WorkspaceMode } from "./types.js";
+export declare function mirrorManagedWorkspace(sourcePath: string, destinationPath: string, excludedTopLevelEntries?: readonly string[]): Promise<void>;
+export interface PreparedStageSessionWorkspace {
+    workspacePath: string;
+    attemptWorkspacePath: string;
+    sessionWorkspacePath: string | null;
+}
+export declare function prepareStageSessionWorkspace(args: {
+    workspaceMode: WorkspaceMode;
+    workspacePath: string;
+    stageSessionPath: string;
+    excludedTopLevelEntries?: readonly string[];
+}): Promise<PreparedStageSessionWorkspace>;
+export declare function persistStageSessionWorkspace(args: {
+    attemptWorkspacePath: string;
+    sessionWorkspacePath: string | null;
+    excludedTopLevelEntries?: readonly string[];
+}): Promise<void>;
+export declare function buildManagedHarnessEnv(parentEnv: NodeJS.ProcessEnv, injectedEnv?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+export declare function getManagedHarnessHomePath(stageSessionPath: string): string;
+//# sourceMappingURL=managed-runtime.d.ts.map

package/dist/managed-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-runtime.d.ts","sourceRoot":"","sources":["../src/managed-runtime.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAwBhD,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,uBAAuB,GAAE,SAAS,MAAM,EAAO,GAC9C,OAAO,CAAC,IAAI,CAAC,CA4Cf;AAED,MAAM,WAAW,6BAA6B;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,wBAAsB,4BAA4B,CAAC,IAAI,EAAE;IACvD,aAAa,EAAE,aAAa,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,uBAAuB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAoBzC;AAED,wBAAsB,4BAA4B,CAAC,IAAI,EAAE;IACvD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,uBAAuB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C,GAAG,OAAO,CAAC,IAAI,CAAC,CAShB;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,CAAC,UAAU,EAC5B,WAAW,GAAE,MAAM,CAAC,UAAe,GAClC,MAAM,CAAC,UAAU,CAoBnB;AAED,wBAAgB,yBAAyB,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAE1E"}

package/dist/managed-runtime.js

@@ -0,0 +1,119 @@
+import { randomUUID } from "node:crypto";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+const managedHarnessEnvAllowlist = new Set([
+    "PATH",
+    "LANG",
+    "LC_ALL",
+    "LC_CTYPE",
+    "LC_MESSAGES",
+    "TERM",
+    "COLORTERM",
+    "NO_COLOR",
+    "TMPDIR",
+    "TMP",
+    "TEMP",
+    "SSL_CERT_FILE",
+    "SSL_CERT_DIR",
+    "HTTP_PROXY",
+    "HTTPS_PROXY",
+    "NO_PROXY",
+    "http_proxy",
+    "https_proxy",
+    "no_proxy",
+]);
+export async function mirrorManagedWorkspace(sourcePath, destinationPath, excludedTopLevelEntries = []) {
+    const destinationRelativeToSource = path.relative(sourcePath, destinationPath);
+    if (destinationRelativeToSource &&
+        destinationRelativeToSource !== "." &&
+        !destinationRelativeToSource.startsWith(`..${path.sep}`) &&
+        destinationRelativeToSource !== ".." &&
+        !path.isAbsolute(destinationRelativeToSource)) {
+        throw new Error(`Cannot mirror ${sourcePath} into nested destination ${destinationPath}.`);
+    }
+    const exclusions = new Set(excludedTopLevelEntries.map((value) => value.replace(/\/+$/u, "")));
+    const destinationParent = path.dirname(destinationPath);
+    const stagingPath = path.join(destinationParent, `.flow-mirror-${path.basename(destinationPath)}-${randomUUID()}`);
+    await fs.rm(stagingPath, { recursive: true, force: true });
+    await fs.mkdir(destinationParent, { recursive: true });
+    try {
+        await fs.cp(sourcePath, stagingPath, {
+            recursive: true,
+            force: true,
+            filter: (entry) => {
+                const relative = path.relative(sourcePath, entry);
+                if (!relative || relative === ".") {
+                    return true;
+                }
+                const topLevel = relative.split(path.sep, 1)[0] ?? relative;
+                return !exclusions.has(topLevel);
+            },
+        });
+        await replaceMirroredWorkspace(stagingPath, destinationPath);
+    }
+    catch (error) {
+        await fs.rm(stagingPath, { recursive: true, force: true }).catch(() => undefined);
+        throw error;
+    }
+}
+export async function prepareStageSessionWorkspace(args) {
+    if (args.workspaceMode === "project") {
+        return {
+            workspacePath: args.workspacePath,
+            attemptWorkspacePath: args.workspacePath,
+            sessionWorkspacePath: null,
+        };
+    }
+    const sessionWorkspacePath = path.join(args.stageSessionPath, "workspace");
+    await mirrorManagedWorkspace(args.workspacePath, sessionWorkspacePath, args.excludedTopLevelEntries);
+    return {
+        workspacePath: sessionWorkspacePath,
+        attemptWorkspacePath: args.workspacePath,
+        sessionWorkspacePath,
+    };
+}
+export async function persistStageSessionWorkspace(args) {
+    if (!args.sessionWorkspacePath) {
+        return;
+    }
+    await mirrorManagedWorkspace(args.sessionWorkspacePath, args.attemptWorkspacePath, args.excludedTopLevelEntries);
+}
+export function buildManagedHarnessEnv(parentEnv, injectedEnv = {}) {
+    const env = {};
+    for (const [key, value] of Object.entries(parentEnv)) {
+        if (typeof value === "string" &&
+            (managedHarnessEnvAllowlist.has(key)
+                || key.startsWith("FLOW_FAKE_")
+                || key.startsWith("WORKBENCH_"))) {
+            env[key] = value;
+        }
+    }
+    for (const [key, value] of Object.entries(injectedEnv)) {
+        if (value !== undefined) {
+            env[key] = value;
+        }
+    }
+    return env;
+}
+export function getManagedHarnessHomePath(stageSessionPath) {
+    return path.join(stageSessionPath, "home");
+}
+async function replaceMirroredWorkspace(stagingPath, destinationPath) {
+    await fs.rm(destinationPath, { recursive: true, force: true });
+    try {
+        await fs.rename(stagingPath, destinationPath);
+    }
+    catch (error) {
+        if (!isMirrorDestinationConflict(error)) {
+            throw error;
+        }
+        await fs.rm(destinationPath, { recursive: true, force: true });
+        await fs.rename(stagingPath, destinationPath);
+    }
+}
+function isMirrorDestinationConflict(error) {
+    return (error instanceof Error &&
+        "code" in error &&
+        (error.code === "EEXIST" ||
+            error.code === "ENOTEMPTY"));
+}

package/dist/model-config.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod";
+import type { JsonValue } from "./types.js";
+export declare const harnessModelConfigJsonSchemaProperty: JsonValue;
+export declare const harnessModelConfigZodShape: {
+    readonly model: z.ZodOptional<z.ZodString>;
+};
+export declare const sharedHarnessEffortValues: readonly ["low", "medium", "high"];
+export declare const codexHarnessEffortValues: readonly ["none", "minimal", "low", "medium", "high", "xhigh"];
+export declare function createHarnessEffortJsonSchemaProperty(values: readonly string[]): JsonValue;
+export declare function createHarnessEffortZodSchema<T extends readonly [string, ...string[]]>(values: T): z.ZodOptional<z.ZodType<T[number]>>;
+export declare function resolveHarnessConfiguredModel(config: {
+    model?: string | null;
+}): string | null;
+export declare function resolveHarnessConfiguredEffort<T extends readonly string[]>(config: {
+    effort?: string | null;
+}, values: T): T[number] | null;
+//# sourceMappingURL=model-config.d.ts.map

package/dist/model-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-config.d.ts","sourceRoot":"","sources":["../src/model-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,eAAO,MAAM,oCAAoC,EAAE,SAGlD,CAAC;AAEF,eAAO,MAAM,0BAA0B;;CAE7B,CAAC;AAEX,eAAO,MAAM,yBAAyB,oCAAqC,CAAC;AAE5E,eAAO,MAAM,wBAAwB,gEAK3B,CAAC;AAEX,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,SAAS,CAIX;AAED,wBAAgB,4BAA4B,CAC1C,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EACxC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAQhD;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,MAAM,GAAG,IAAI,CAO9F;AAED,wBAAgB,8BAA8B,CAC5C,CAAC,SAAS,SAAS,MAAM,EAAE,EAE3B,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAClC,MAAM,EAAE,CAAC,GACR,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,CAWlB"}

package/dist/model-config.js

@@ -0,0 +1,43 @@
+import { z } from "zod";
+export const harnessModelConfigJsonSchemaProperty = {
+    type: "string",
+    minLength: 1,
+};
+export const harnessModelConfigZodShape = {
+    model: z.string().trim().min(1).optional(),
+};
+export const sharedHarnessEffortValues = ["low", "medium", "high"];
+export const codexHarnessEffortValues = [
+    "none",
+    "minimal",
+    ...sharedHarnessEffortValues,
+    "xhigh",
+];
+export function createHarnessEffortJsonSchemaProperty(values) {
+    return {
+        enum: [...values],
+    };
+}
+export function createHarnessEffortZodSchema(values) {
+    const enumSchema = z.enum(values);
+    return z
+        .preprocess((value) => (typeof value === "string" ? value.trim() : value), enumSchema)
+        .optional();
+}
+export function resolveHarnessConfiguredModel(config) {
+    if (typeof config.model !== "string") {
+        return null;
+    }
+    const model = config.model.trim();
+    return model.length > 0 ? model : null;
+}
+export function resolveHarnessConfiguredEffort(config, values) {
+    if (typeof config.effort !== "string") {
+        return null;
+    }
+    const effort = config.effort.trim();
+    if (effort.length === 0 || !values.includes(effort)) {
+        return null;
+    }
+    return effort;
+}

package/dist/normalized-activity.d.ts

@@ -0,0 +1,75 @@
+import type { JsonValue } from "./types.js";
+import { HarnessTraceBuilder } from "./trace-builder.js";
+export type NormalizedHarnessActivity = {
+    type: "session.started";
+    at?: string;
+    provider: string;
+    model?: string | null;
+    sessionId?: string | null;
+    attributes?: Record<string, JsonValue>;
+} | {
+    type: "turn.started";
+    at?: string;
+    provider: string;
+    model?: string | null;
+    sessionId?: string | null;
+    operationId?: string | null;
+    attributes?: Record<string, JsonValue>;
+} | {
+    type: "turn.completed";
+    at?: string;
+    provider?: string | null;
+    model?: string | null;
+    sessionId?: string | null;
+    operationId?: string | null;
+    status?: string | null;
+    errorMessage?: string | null;
+    attributes?: Record<string, JsonValue>;
+} | {
+    type: "assistant_output.started";
+    at?: string;
+    phase?: string | null;
+    itemId?: string | null;
+} | {
+    type: "assistant_output.delta";
+    at?: string;
+    phase?: string | null;
+    itemId?: string | null;
+    delta: string;
+} | {
+    type: "assistant_output.completed";
+    at?: string;
+    phase?: string | null;
+    itemId?: string | null;
+    text: string;
+} | {
+    type: "tool.started";
+    at?: string;
+    toolId?: string | null;
+    toolName?: string | null;
+    attributes?: Record<string, JsonValue>;
+} | {
+    type: "tool.completed";
+    at?: string;
+    toolId?: string | null;
+    toolName?: string | null;
+    attributes?: Record<string, JsonValue>;
+} | {
+    type: "usage.updated";
+    at?: string;
+    inputTokens?: number | null;
+    outputTokens?: number | null;
+    attributes?: Record<string, JsonValue>;
+} | {
+    type: "note";
+    at?: string;
+    message: string;
+    attributes?: Record<string, JsonValue>;
+} | {
+    type: "error";
+    at?: string;
+    message: string;
+    attributes?: Record<string, JsonValue>;
+};
+export declare function applyNormalizedHarnessActivity(trace: HarnessTraceBuilder, activity: NormalizedHarnessActivity): void;
+//# sourceMappingURL=normalized-activity.d.ts.map

package/dist/normalized-activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalized-activity.d.ts","sourceRoot":"","sources":["../src/normalized-activity.ts"],"names":[],"mappings":"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"}

package/dist/normalized-activity.js

@@ -0,0 +1,89 @@
+import { nowIso } from "./internal-utils.js";
+export function applyNormalizedHarnessActivity(trace, activity) {
+    const at = activity.at ?? nowIso();
+    switch (activity.type) {
+        case "session.started":
+            trace.recordNote("Model session started", at, {
+                provider: activity.provider,
+                model: activity.model ?? null,
+                session_id: activity.sessionId ?? null,
+                ...(activity.attributes ?? {}),
+            });
+            return;
+        case "turn.started":
+            trace.startTurn({
+                at,
+                provider: activity.provider,
+                model: activity.model ?? null,
+                sessionId: activity.sessionId ?? null,
+                operationId: activity.operationId ?? null,
+                attributes: activity.attributes,
+            });
+            return;
+        case "turn.completed":
+            trace.completeTurn({
+                at,
+                provider: activity.provider ?? null,
+                model: activity.model ?? null,
+                sessionId: activity.sessionId ?? null,
+                operationId: activity.operationId ?? null,
+                status: activity.status ?? null,
+                errorMessage: activity.errorMessage ?? null,
+                attributes: activity.attributes,
+            });
+            return;
+        case "assistant_output.started":
+            trace.startAssistantOutput({
+                at,
+                phase: activity.phase ?? null,
+                itemId: activity.itemId ?? null,
+            });
+            return;
+        case "assistant_output.delta":
+            trace.appendOutputDelta({
+                at,
+                delta: activity.delta,
+                phase: activity.phase ?? null,
+                itemId: activity.itemId ?? null,
+            });
+            return;
+        case "assistant_output.completed":
+            trace.completeAssistantOutput({
+                at,
+                text: activity.text,
+                phase: activity.phase ?? null,
+                itemId: activity.itemId ?? null,
+            });
+            return;
+        case "tool.started":
+            trace.startToolCall({
+                at,
+                toolId: activity.toolId ?? null,
+                toolName: activity.toolName ?? null,
+                attributes: activity.attributes,
+            });
+            return;
+        case "tool.completed":
+            trace.completeToolCall({
+                at,
+                toolId: activity.toolId ?? null,
+                toolName: activity.toolName ?? null,
+                attributes: activity.attributes,
+            });
+            return;
+        case "usage.updated":
+            trace.recordUsage({
+                at,
+                inputTokens: activity.inputTokens ?? null,
+                outputTokens: activity.outputTokens ?? null,
+                attributes: activity.attributes,
+            });
+            return;
+        case "note":
+            trace.recordNote(activity.message, at, activity.attributes);
+            return;
+        case "error":
+            trace.recordError(activity.message, at, activity.attributes);
+            return;
+    }
+}

package/dist/prepare.d.ts

@@ -0,0 +1,9 @@
+import type { HarnessExecutionPlan } from "./index.js";
+export interface HarnessPrepareCommandArgs {
+    plan: HarnessExecutionPlan;
+    workspacePath: string;
+    stageSessionPath: string;
+    childEnv: NodeJS.ProcessEnv;
+}
+export declare function runHarnessPrepareCommand(args: HarnessPrepareCommandArgs): Promise<void>;
+//# sourceMappingURL=prepare.d.ts.map

package/dist/prepare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../src/prepare.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAUvD,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC;CAC7B;AAcD,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA8Ff"}

package/dist/prepare.js

@@ -0,0 +1,119 @@
+import { spawn } from "node:child_process";
+import { DEFAULT_HARNESS_PREPARE_TIMEOUT_MS } from "./types.js";
+const harnessPrepareContextEnvNames = Object.freeze([
+    "AGENT_HARNESS_PROVIDER",
+    "AGENT_HARNESS_WORKSPACE_ROOT",
+    "AGENT_HARNESS_STAGE_ROOT",
+    "AGENT_HARNESS_WORKSPACE_MODE",
+]);
+function buildHarnessPrepareEnv(args) {
+    const prepare = args.plan.harness.prepare;
+    return {
+        ...args.childEnv,
+        ...(prepare?.env ?? {}),
+        AGENT_HARNESS_PROVIDER: args.plan.harness.id,
+        AGENT_HARNESS_WORKSPACE_ROOT: args.workspacePath,
+        AGENT_HARNESS_STAGE_ROOT: args.stageSessionPath,
+        AGENT_HARNESS_WORKSPACE_MODE: args.plan.workspace.mode,
+    };
+}
+export async function runHarnessPrepareCommand(args) {
+    const prepare = args.plan.harness.prepare;
+    if (!prepare) {
+        return;
+    }
+    const timeoutMs = prepare.timeout_ms ?? DEFAULT_HARNESS_PREPARE_TIMEOUT_MS;
+    const env = buildHarnessPrepareEnv(args);
+    await new Promise((resolve, reject) => {
+        const child = spawn("sh", ["-lc", prepare.run], {
+            cwd: args.workspacePath,
+            env,
+            stdio: "pipe",
+        });
+        let stdout = "";
+        let stderr = "";
+        let settled = false;
+        let timedOut = false;
+        const finish = (callback) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            clearTimeout(timeout);
+            callback();
+        };
+        const timeout = setTimeout(() => {
+            timedOut = true;
+            child.kill("SIGKILL");
+        }, timeoutMs);
+        child.stdout.setEncoding("utf8");
+        child.stderr.setEncoding("utf8");
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk;
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk;
+        });
+        child.on("error", (error) => {
+            finish(() => {
+                reject(new Error(formatHarnessPrepareFailure({
+                    command: prepare.run,
+                    error,
+                    stdout,
+                    stderr,
+                })));
+            });
+        });
+        child.on("exit", (code, signal) => {
+            finish(() => {
+                if (timedOut) {
+                    reject(new Error(formatHarnessPrepareTimeout({
+                        command: prepare.run,
+                        timeoutMs,
+                        stdout,
+                        stderr,
+                    })));
+                    return;
+                }
+                if (code === 0) {
+                    resolve();
+                    return;
+                }
+                reject(new Error(formatHarnessPrepareFailure({
+                    command: prepare.run,
+                    code,
+                    signal,
+                    stdout,
+                    stderr,
+                })));
+            });
+        });
+    });
+}
+function formatHarnessPrepareFailure(args) {
+    const reason = args.error instanceof Error
+        ? args.error.message
+        : `code ${args.code ?? "null"} signal ${args.signal ?? "null"}`;
+    return [
+        `Harness prepare command failed (${reason}): ${args.command}`,
+        ...formatHarnessPrepareOutput(args.stdout, args.stderr),
+    ].join("\n");
+}
+function formatHarnessPrepareTimeout(args) {
+    return [
+        `Harness prepare command timed out after ${args.timeoutMs}ms: ${args.command}`,
+        ...formatHarnessPrepareOutput(args.stdout, args.stderr),
+    ].join("\n");
+}
+function formatHarnessPrepareOutput(stdout, stderr) {
+    const lines = [];
+    const normalizedStdout = stdout.trim();
+    const normalizedStderr = stderr.trim();
+    if (normalizedStdout) {
+        lines.push(`stdout: ${normalizedStdout}`);
+    }
+    if (normalizedStderr) {
+        lines.push(`stderr: ${normalizedStderr}`);
+    }
+    return lines;
+}