@nylorun/harness 0.13.0-beta → 0.16.0-beta

package/dist/execution/dispatch.js

@@ -1,164 +0,0 @@
-import { HarnessError, isHarnessError } from "../errors.js";
-import { createId } from "../utils/ids.js";
-import { copyJson } from "../utils/immutable.js";
-import { toolResult } from "./tool-result.js";
-export async function dispatchPlan(invocation) {
-    const { signal, definitions, options, observe, record } = invocation;
-    let plan = invocation.state.plan;
-    if (plan.calls.some((call) => call.status === "interaction" && call.interactionPhase === "before")) {
-        for (const call of plan.calls)
-            if (call.status === "interaction")
-                observe({
-                    type: "interaction.required",
-                    turnId: plan.turnId,
-                    stepId: plan.stepId,
-                    interactionId: call.interaction.id,
-                    kind: call.interaction.kind,
-                    callId: call.callId,
-                    toolName: call.toolName,
-                    phase: "interaction",
-                    attributes: {
-                        prompt: call.interaction.prompt,
-                        ...(call.interaction.metadata ? { metadata: call.interaction.metadata } : {}),
-                    },
-                });
-        return "paused";
-    }
-    signal.throwIfAborted();
-    const pending = plan.calls.filter((call) => call.status === "pending");
-    if (pending.length) {
-        invocation.state = {
-            ...invocation.state,
-            plan: {
-                ...plan,
-                calls: plan.calls.map((call) => call.status === "pending" ? { ...call, status: "active" } : call),
-            },
-        };
-        await record();
-        signal.throwIfAborted();
-        const settled = await Promise.all(pending.map(async (call) => {
-            const definition = definitions.get(call.invocationId);
-            const eventIds = {
-                executionId: invocation.state.executionId,
-                turnId: plan.turnId,
-                stepId: plan.stepId,
-                callId: call.callId,
-                invocationId: call.invocationId,
-                toolName: call.toolName,
-                middlewareId: call.reference.capabilityId,
-                slot: definition.owner.slot,
-            };
-            observe({ type: "tool.started", ...eventIds, attributes: { args: call.args } });
-            let outcome;
-            try {
-                signal.throwIfAborted();
-                outcome = await definition.execute(call.args, {
-                    executionId: invocation.state.executionId,
-                    turnId: plan.turnId,
-                    stepId: plan.stepId,
-                    callId: call.callId,
-                    invocationId: call.invocationId,
-                    signal,
-                    info: options.info,
-                    onModelCall: options.onModelCall,
-                    ...(call.resume ? { resume: call.resume } : {}),
-                });
-                if (!outcome || typeof outcome !== "object")
-                    throw new HarnessError("tool.invalid-tool-result", "Tool returned an invalid outcome");
-                if (outcome.kind === "interaction-required") {
-                    if (!["approval", "response"].includes(outcome.interaction.kind) ||
-                        typeof outcome.interaction.prompt !== "string")
-                        throw new HarnessError("tool.invalid-tool-result", "Tool returned an invalid interaction");
-                    return copyJson({
-                        ...call,
-                        status: "interaction",
-                        interaction: {
-                            ...outcome.interaction,
-                            id: outcome.interaction.id ?? createId("interaction"),
-                        },
-                        interactionPhase: "execute",
-                        ...(outcome.token === undefined ? {} : { token: outcome.token }),
-                    });
-                }
-                if (outcome.kind === "deferred") {
-                    observe({
-                        type: "tool.deferred",
-                        ...eventIds,
-                        attributes: outcome.token === undefined ? {} : { token: outcome.token },
-                    });
-                    return copyJson({
-                        ...call,
-                        status: "deferred",
-                        ...(outcome.token === undefined ? {} : { token: outcome.token }),
-                    });
-                }
-                const result = toolResult(call, definition, outcome);
-                observe({
-                    type: "tool.completed",
-                    ...eventIds,
-                    outcome: result.kind,
-                    attributes: result,
-                });
-                return copyJson({ ...call, status: "settled", result });
-            }
-            catch (cause) {
-                const result = {
-                    callId: call.callId,
-                    toolName: call.toolName,
-                    kind: "failed",
-                    code: signal.aborted
-                        ? "tool.cancelled"
-                        : isHarnessError(cause)
-                            ? cause.code
-                            : "tool.execution-failed",
-                    message: cause instanceof Error ? cause.message : String(cause),
-                };
-                observe({
-                    type: "tool.completed",
-                    ...eventIds,
-                    outcome: result.kind,
-                    attributes: result,
-                });
-                return copyJson({ ...call, status: "settled", result });
-            }
-        }));
-        const byId = new Map(settled.map((call) => [call.invocationId, call]));
-        plan = { ...plan, calls: plan.calls.map((call) => byId.get(call.invocationId) ?? call) };
-        invocation.state = { ...invocation.state, plan };
-        await record();
-    }
-    signal.throwIfAborted();
-    if (plan.calls.some((call) => call.status === "interaction" || call.status === "deferred")) {
-        for (const call of plan.calls)
-            if (call.status === "interaction")
-                observe({
-                    type: "interaction.required",
-                    turnId: plan.turnId,
-                    stepId: plan.stepId,
-                    interactionId: call.interaction.id,
-                    kind: call.interaction.kind,
-                    callId: call.callId,
-                    toolName: call.toolName,
-                    phase: call.interactionPhase === "before" ? "interaction" : "execute",
-                    attributes: {
-                        prompt: call.interaction.prompt,
-                        ...(call.interaction.metadata ? { metadata: call.interaction.metadata } : {}),
-                    },
-                });
-        return "paused";
-    }
-    const results = [
-        ...plan.immediate,
-        ...plan.calls.flatMap((call) => (call.result ? [call.result] : [])),
-    ];
-    const ordered = plan.order.map((item) => results.find((result) => result.callId === item.callId && result.toolName === item.toolName));
-    const { plan: _, ...rest } = invocation.state;
-    invocation.state = {
-        ...rest,
-        transcript: [
-            ...invocation.state.transcript,
-            { kind: "tool-results", turnId: plan.turnId, stepId: plan.stepId, results: ordered },
-        ],
-    };
-    await record();
-}

package/dist/execution/initial-state.d.ts

@@ -1,3 +0,0 @@
-import type { AgentDefinition } from "../definition/agent-definition.js";
-import type { ExecutionState } from "../types/execution.js";
-export declare function initializeExecutionState(agent: AgentDefinition): ExecutionState;

package/dist/execution/initial-state.js

@@ -1,14 +0,0 @@
-import { copyJson } from "../utils/immutable.js";
-import { createId } from "../utils/ids.js";
-export function initializeExecutionState(agent) {
-    return copyJson({
-        version: 1,
-        agentId: agent.id,
-        executionId: createId("execution"),
-        revision: 0,
-        turnCount: 0,
-        transcript: [],
-        status: "ready",
-        ...(agent.output ? { outputContract: agent.output.schema.jsonSchema } : {}),
-    });
-}

package/dist/types/agent.d.ts

@@ -1,9 +0,0 @@
-import type { AgentManifest } from "./manifest.js";
-import type { RunOptions, RunResult } from "./execution.js";
-/** An agent definition built with Agent(...).use(...).build(). */
-export interface BuiltAgent<Info = unknown, Output = string> {
-    readonly id: string;
-    readonly name: string;
-    readonly manifest: AgentManifest;
-    run(options: RunOptions<Info>): Promise<RunResult<Output>>;
-}

package/dist/types/agent.js

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

package/dist/types/manifest.d.ts

@@ -1,22 +0,0 @@
-import type { ModelDirective } from "./model.js";
-import type { JsonObject } from "./shared.js";
-export interface ManifestTool {
-    readonly name: string;
-    readonly description?: string;
-    readonly inputSchema: JsonObject;
-    readonly outputSchema?: JsonObject;
-}
-export interface CapabilityManifest {
-    readonly id: string;
-    readonly kind: "agent" | "capability" | "middleware";
-    readonly hasMiddleware: boolean;
-    readonly instructions?: readonly string[];
-    readonly tools?: readonly ManifestTool[];
-    readonly model?: Pick<ModelDirective, "id" | "controls">;
-}
-export interface AgentManifest {
-    readonly id: string;
-    readonly name: string;
-    readonly outputSchema?: JsonObject;
-    readonly capabilities: readonly CapabilityManifest[];
-}

package/dist/types/manifest.js

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

package/dist/types/middleware.d.ts

@@ -1,66 +0,0 @@
-import type { ContextMutationOptions, ModelCandidate, ModelDirective, ModelToolCall, ModelConfigurationMutationOptions } from "./model.js";
-import type { InputEvent, TranscriptEntry } from "./transcript.js";
-import type { ContextItem, Tripwire } from "./shared.js";
-import type { Interaction, ToolDefinition, ToolResult } from "./tool.js";
-interface StepRequestBase {
-    /** Opaque identity of the execution that owns this Step. */
-    readonly executionId: string;
-    /** Opaque identity of the Turn that owns this Step. */
-    readonly turnId: string;
-    /** Opaque identity of this Model Step. */
-    readonly stepId: string;
-    readonly turnNumber: number;
-    readonly stepNumber: number;
-    readonly arrivals: readonly InputEvent[];
-    readonly toolResults: readonly ToolResult[];
-    readonly transcript: readonly TranscriptEntry[];
-    readonly context: {
-        set(slot: string, items: readonly ContextItem[], options?: ContextMutationOptions): void;
-    };
-    readonly configuration: {
-        readonly instructions: {
-            set(slot: string, items: readonly string[], options?: ModelConfigurationMutationOptions): void;
-        };
-        readonly tools: {
-            set(slot: string, tools: readonly ToolDefinition[], options?: ModelConfigurationMutationOptions): void;
-        };
-        readonly model: {
-            select(directive: ModelDirective, options?: Omit<ModelConfigurationMutationOptions, "order">): void;
-            replace(directive: ModelDirective, options?: Omit<ModelConfigurationMutationOptions, "order">): void;
-            clear(options?: Omit<ModelConfigurationMutationOptions, "order">): void;
-        };
-    };
-    tripwire(error: Tripwire): StepResponse;
-}
-export type StepRequest<Info = unknown> = StepRequestBase & {
-    readonly info?: Info;
-};
-export interface StepResponse {
-    candidate(): Readonly<ModelCandidate> | undefined;
-    toolCalls(): readonly ModelToolCall[];
-    replace(candidate: ModelCandidate): void;
-    deny(callId: string, reason: string): void;
-    requireInteraction(callId: string, interaction: Interaction): void;
-    tripwire(error: Tripwire): StepResponse;
-}
-export type StepMiddleware<Info = unknown> = (request: StepRequest<Info>, next: () => Promise<StepResponse>) => Promise<StepResponse>;
-export type CapabilityItems<Item> = readonly Item[] | Readonly<{
-    readonly slot: string;
-    readonly items: readonly Item[];
-}>;
-export interface CapabilityDeclaration<Info = unknown> {
-    readonly id: string;
-    readonly tools?: CapabilityItems<ToolDefinition<any, Info, any>>;
-    readonly instructions?: CapabilityItems<string>;
-    readonly model?: ModelDirective;
-    readonly middleware?: StepMiddleware<Info>;
-}
-export interface MiddlewareContributions {
-    readonly instructions?: readonly string[];
-    readonly tools?: readonly {
-        readonly name: string;
-        readonly description?: string;
-    }[];
-    readonly model?: Pick<ModelDirective, "id" | "controls">;
-}
-export {};

package/dist/types/middleware.js

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

package/dist/types/model.d.ts

@@ -1,184 +0,0 @@
-import type { ContextItem, JsonObject, JsonValue } from "./shared.js";
-import type { InputEvent, TranscriptEntry } from "./transcript.js";
-import type { ToolDescriptor, ToolResult } from "./tool.js";
-export interface ModelToolCall {
-    readonly id: string;
-    readonly name: string;
-    readonly args: JsonObject;
-}
-export type ModelOutputBlock = {
-    readonly type: "text";
-    readonly text: string;
-    readonly providerMetadata?: JsonObject;
-} | {
-    readonly type: "reasoning";
-    readonly text: string;
-    readonly providerMetadata?: JsonObject;
-} | {
-    readonly type: "json";
-    readonly value: JsonValue;
-} | {
-    readonly type: "tool-call";
-    readonly providerMetadata?: JsonObject;
-    readonly id: string;
-    readonly name: string;
-    readonly args: JsonObject;
-    readonly raw?: string;
-};
-export interface ModelUsage {
-    readonly inputTokens?: number;
-    readonly outputTokens?: number;
-    readonly totalTokens?: number;
-    readonly cachedTokens?: number;
-    readonly reasoningTokens?: number;
-    readonly costUsd?: number;
-}
-export type ModelFinishReason = "stop" | "length" | "tool-calls" | "content-filter" | "other";
-export interface ModelEvidence {
-    readonly requestId?: string;
-    readonly resolvedModel?: string;
-    readonly warnings?: readonly string[];
-    readonly extras?: JsonObject;
-}
-export interface ModelCandidate {
-    readonly output: readonly ModelOutputBlock[];
-    readonly finishReason?: ModelFinishReason;
-    readonly usage?: ModelUsage;
-    readonly evidence?: ModelEvidence;
-}
-export interface ModelControls {
-    readonly temperature?: number;
-    readonly maxOutputTokens?: number;
-}
-export interface ModelDirective {
-    readonly id?: string;
-    readonly controls?: ModelControls;
-    readonly config?: JsonObject;
-}
-/** A middleware-owned declaration for the model-visible configuration. */
-export interface ModelConfigurationMutationOptions {
-    readonly order?: number;
-    readonly reason?: string;
-}
-export interface ModelConfigurationContributor {
-    readonly middlewareId: string;
-    readonly slot: string;
-    readonly order: number;
-    readonly reason?: string;
-}
-export interface ModelConfigurationTool {
-    readonly name: string;
-    readonly description?: string;
-    readonly inputSchema: JsonObject;
-    readonly outputSchema?: JsonObject;
-    readonly contributor: ModelConfigurationContributor;
-}
-export interface ModelConfigurationInstruction {
-    readonly text: string;
-    readonly contributor: ModelConfigurationContributor;
-}
-export interface ModelConfigurationSnapshot {
-    readonly version: 1;
-    readonly model?: ModelDirective;
-    readonly instructions: readonly ModelConfigurationInstruction[];
-    /** Data-only descriptions of the selected tools. */
-    readonly tools: readonly ToolDescriptor[];
-    readonly toolContracts: readonly ModelConfigurationTool[];
-    readonly contributors: readonly ModelConfigurationContributor[];
-}
-/** A middleware-owned declaration for this model call's runtime context. */
-export interface ContextMutationOptions {
-    readonly order?: number;
-    readonly reason?: string;
-}
-export interface ContextContributor {
-    readonly middlewareId: string;
-    readonly slot: string;
-    readonly order: number;
-    readonly reason?: string;
-}
-/** Canonical runtime context for one model call. */
-export interface ContextSnapshot {
-    readonly items: readonly ContextItem[];
-    readonly contributors: readonly ContextContributor[];
-}
-export interface ModelRequest {
-    readonly executionId: string;
-    readonly turnId: string;
-    readonly stepId: string;
-    readonly model?: ModelDirective;
-    /** Canonical, immutable Harness-owned model configuration for this call. */
-    readonly configuration: ModelConfigurationSnapshot;
-    readonly instructions: readonly string[];
-    readonly context: ContextSnapshot;
-    readonly transcript: readonly TranscriptEntry[];
-    readonly arrivals: readonly InputEvent[];
-    readonly toolResults: readonly ToolResult[];
-    /** Immutable tool descriptions; executable definitions stay inside Harness. */
-    readonly tools: readonly ToolDescriptor[];
-    /** Optional portable contract for this turn's terminal JSON result. */
-    readonly outputSchema?: JsonObject;
-}
-export type PromptContentPart = {
-    readonly type: "reasoning";
-    readonly text: string;
-    readonly providerMetadata?: JsonObject;
-} | {
-    readonly type: "text";
-    readonly text: string;
-    readonly providerMetadata?: JsonObject;
-} | {
-    readonly type: "media";
-    readonly mediaType: string;
-    readonly reference: JsonValue;
-} | {
-    readonly type: "tool-call";
-    readonly providerMetadata?: JsonObject;
-    readonly id: string;
-    readonly name: string;
-    readonly args: JsonObject;
-};
-export type PromptItem = {
-    readonly kind: "instructions";
-    readonly role: "system";
-    readonly content: readonly PromptContentPart[];
-} | {
-    readonly kind: "message";
-    readonly role: "user" | "assistant";
-    readonly content: readonly PromptContentPart[];
-} | {
-    readonly kind: "tool-result";
-    readonly toolCallId: string;
-    readonly toolName: string;
-    readonly status: "completed" | "denied" | "failed";
-    readonly content: readonly PromptContentPart[];
-} | {
-    readonly kind: "context";
-    readonly role: "user";
-    readonly content: readonly PromptContentPart[];
-};
-export interface ModelCallTool {
-    readonly name: string;
-    readonly description?: string;
-    readonly inputSchema: JsonObject;
-}
-export interface ModelCall {
-    readonly model?: ModelDirective;
-    readonly prompt: readonly PromptItem[];
-    readonly tools: readonly ModelCallTool[];
-    /** Optional portable contract for this turn's terminal JSON result. */
-    readonly outputSchema?: JsonObject;
-    readonly executionId: string;
-}
-export interface ModelAdapterContext {
-    readonly request: ModelRequest;
-    readonly invocationId: string;
-    readonly signal: AbortSignal;
-    /** Publishes one JSON-safe provider request derived from the canonical ModelCall. */
-    reportPreparedCall(prepared: ModelPreparedCall): void;
-}
-export interface ModelPreparedCall {
-    readonly adapter: string;
-    readonly call: JsonValue;
-}
-export type ModelAdapter = (call: ModelCall, context: ModelAdapterContext) => Promise<ModelCandidate | string>;

package/dist/types/model.js

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

package/dist/types/observe.d.ts

@@ -1,165 +0,0 @@
-import type { ContextSnapshot, ModelCandidate, ModelCall, ModelConfigurationSnapshot } from "./model.js";
-import type { JsonObject, JsonValue } from "./shared.js";
-import type { InputEvent, TranscriptEntry } from "./transcript.js";
-import type { RequiredInteraction, ToolDescriptor, ToolResult } from "./tool.js";
-export type ObserveToolSnapshot = ToolDescriptor;
-/** JSON-only model-configuration view suitable for an observation stream. */
-export interface ObserveModelConfigurationSnapshot extends Omit<ModelConfigurationSnapshot, "tools"> {
-    readonly tools: readonly ObserveToolSnapshot[];
-}
-export interface ObserveSealedCall {
-    readonly callId: string;
-    readonly toolName: string;
-    readonly args: JsonValue;
-    readonly invocationId: string;
-    readonly owner: {
-        readonly middlewareId: string;
-        readonly slot: string;
-    };
-    readonly interaction?: RequiredInteraction;
-}
-export interface ObserveModelRequested {
-    /** The exact immutable logical input supplied to the ModelAdapter. */
-    readonly call: ModelCall;
-    /** Canonical configuration facts and attribution. */
-    readonly configuration: ObserveModelConfigurationSnapshot;
-    /** Current-step runtime context and attribution. */
-    readonly context: ContextSnapshot;
-}
-export type ObserveEvent = {
-    readonly type: "model.requested";
-    readonly invocationId: string;
-    readonly turnId: string;
-    readonly stepId: string;
-    readonly inputId?: string;
-    readonly requestedModelId?: string;
-    readonly attributes: ObserveModelRequested;
-} | {
-    readonly type: "model.prepared";
-    readonly invocationId: string;
-    readonly turnId: string;
-    readonly stepId: string;
-    readonly inputId?: string;
-    readonly requestedModelId?: string;
-    readonly attributes: {
-        readonly adapter: string;
-        readonly call: JsonValue;
-    };
-} | {
-    readonly type: "model.completed";
-    readonly invocationId?: string;
-    readonly turnId: string;
-    readonly stepId: string;
-    readonly inputId?: string;
-    readonly requestedModelId?: string;
-    readonly attributes: ModelCandidate;
-} | {
-    readonly type: "step.started";
-    readonly turnId: string;
-    readonly stepId: string;
-    readonly inputId?: string;
-    readonly turnNumber: number;
-    readonly stepNumber: number;
-    readonly attributes: {
-        readonly arrivals: readonly InputEvent[];
-        readonly toolResults: readonly ToolResult[];
-        readonly transcript: readonly TranscriptEntry[];
-    };
-} | {
-    readonly type: "middleware.entered" | "middleware.completed";
-    readonly turnId: string;
-    readonly stepId: string;
-    readonly inputId?: string;
-    readonly middlewareId: string;
-} | {
-    readonly type: "middleware.lease-violation";
-    readonly turnId: string;
-    readonly stepId: string;
-    readonly inputId?: string;
-    readonly middlewareId: string;
-    readonly reason: string;
-} | {
-    readonly type: "tool.sealed";
-    readonly turnId: string;
-    readonly stepId: string;
-    readonly inputId?: string;
-    readonly attributes: {
-        readonly executable: readonly ObserveSealedCall[];
-        readonly immediate: readonly ToolResult[];
-    };
-} | {
-    readonly type: "tool.started";
-    readonly executionId: string;
-    readonly turnId: string;
-    readonly stepId: string;
-    readonly inputId?: string;
-    readonly toolName: string;
-    readonly callId: string;
-    readonly invocationId: string;
-    readonly middlewareId: string;
-    readonly slot: string;
-    readonly attributes: {
-        readonly args: JsonValue;
-    };
-} | {
-    readonly type: "tool.completed";
-    readonly executionId: string;
-    readonly turnId: string;
-    readonly stepId: string;
-    readonly inputId?: string;
-    readonly toolName: string;
-    readonly callId: string;
-    readonly invocationId: string;
-    readonly middlewareId: string;
-    readonly slot: string;
-    readonly outcome: string;
-    readonly code?: string;
-    readonly attributes?: ToolResult;
-} | {
-    readonly type: "tool.deferred";
-    readonly executionId: string;
-    readonly turnId: string;
-    readonly stepId: string;
-    readonly inputId?: string;
-    readonly toolName: string;
-    readonly callId: string;
-    readonly invocationId: string;
-    readonly middlewareId: string;
-    readonly slot: string;
-    readonly attributes: {
-        readonly token?: JsonValue;
-    };
-} | {
-    readonly type: "turn.completed";
-    readonly turnId: string;
-    readonly stepId: string;
-    readonly inputId?: string;
-    readonly attributes: {
-        readonly output: JsonValue;
-    };
-} | {
-    readonly type: "interaction.required";
-    readonly turnId: string;
-    readonly stepId: string;
-    readonly inputId?: string;
-    readonly interactionId: string;
-    readonly kind: string;
-    readonly callId?: string;
-    readonly toolName?: string;
-    readonly phase?: "interaction" | "execute";
-    readonly attributes: {
-        readonly prompt: string;
-        readonly metadata?: JsonObject;
-    };
-} | {
-    readonly type: "tripwire";
-    readonly turnId: string;
-    readonly stepId?: string;
-    readonly inputId?: string;
-    readonly code: string;
-    readonly scope: string;
-    readonly attributes: {
-        readonly message: string;
-    };
-};
-export type Observer = (event: ObserveEvent) => void | Promise<void>;

package/dist/types/observe.js

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

package/dist/types/shared.d.ts

@@ -1,25 +0,0 @@
-export type JsonPrimitive = string | number | boolean | null;
-export type JsonValue = JsonPrimitive | JsonObject | readonly JsonValue[];
-export type JsonObject = {
-    readonly [key: string]: JsonValue;
-};
-export interface DeferredOutcome {
-    readonly kind: "deferred";
-    readonly token?: JsonValue;
-}
-export interface BuildDiagnostic {
-    readonly code: string;
-    readonly message: string;
-    readonly toolName?: string;
-    readonly details?: Readonly<Record<string, string | number | boolean>>;
-    readonly cause?: unknown;
-}
-export interface ContextItem {
-    readonly type?: string;
-    readonly value: JsonValue;
-}
-export interface Tripwire {
-    readonly code: string;
-    readonly message: string;
-    readonly scope?: "step" | "execution";
-}

package/dist/types/shared.js

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