@assemblyline-agents/runtime 0.1.0

package/dist/eval-run-options.js

@@ -0,0 +1,106 @@
+/**
+ * Per-run eval harness options. The block travels on `RunAgentOptions.eval`,
+ * is persisted verbatim into `RunRecord.input.eval` (crash-resume safe and
+ * auditable in run detail), and is honored by the tool-execution and delivery
+ * paths. `results` sequence cursors are intentionally in-memory: a resumed or
+ * subagent-child run restarts its sequence, which is acceptable for evals and
+ * avoids a durable write per stubbed tool call.
+ */
+function isJsonValue(value) {
+    if (value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean")
+        return true;
+    if (Array.isArray(value))
+        return value.every(isJsonValue);
+    if (typeof value === "object")
+        return Object.values(value).every(isJsonValue);
+    return false;
+}
+function validateStubSpec(name, value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`eval.toolStubs.${name} must be an object with exactly one of result, results, or error.`);
+    }
+    const spec = value;
+    const keys = ["result", "results", "error"].filter((key) => spec[key] !== undefined);
+    if (keys.length !== 1) {
+        throw new Error(`eval.toolStubs.${name} must declare exactly one of result, results, or error.`);
+    }
+    if (keys[0] === "results") {
+        if (!Array.isArray(spec.results) || spec.results.length === 0) {
+            throw new Error(`eval.toolStubs.${name}.results must be a non-empty array.`);
+        }
+        if (!isJsonValue(spec.results))
+            throw new Error(`eval.toolStubs.${name}.results must be JSON-serializable.`);
+        return { results: spec.results };
+    }
+    if (keys[0] === "error") {
+        if (typeof spec.error !== "string" || !spec.error.trim()) {
+            throw new Error(`eval.toolStubs.${name}.error must be a non-empty string.`);
+        }
+        return { error: spec.error };
+    }
+    if (!isJsonValue(spec.result))
+        throw new Error(`eval.toolStubs.${name}.result must be JSON-serializable.`);
+    return { result: spec.result };
+}
+/** Strict ingress validation; throws descriptive errors on malformed input. */
+export function validateEvalRunOptions(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error("eval must be an object.");
+    }
+    const raw = value;
+    const options = {};
+    if (raw.toolStubs !== undefined) {
+        if (!raw.toolStubs || typeof raw.toolStubs !== "object" || Array.isArray(raw.toolStubs)) {
+            throw new Error("eval.toolStubs must be an object keyed by tool name.");
+        }
+        const stubs = {};
+        for (const [name, spec] of Object.entries(raw.toolStubs)) {
+            stubs[name] = validateStubSpec(name, spec);
+        }
+        options.toolStubs = stubs;
+    }
+    if (raw.autoApproveTools !== undefined) {
+        if (typeof raw.autoApproveTools !== "boolean")
+            throw new Error("eval.autoApproveTools must be a boolean.");
+        options.autoApproveTools = raw.autoApproveTools;
+    }
+    if (raw.recordOnlyDelivery !== undefined) {
+        if (typeof raw.recordOnlyDelivery !== "boolean")
+            throw new Error("eval.recordOnlyDelivery must be a boolean.");
+        options.recordOnlyDelivery = raw.recordOnlyDelivery;
+    }
+    return options;
+}
+/** Tolerant read of run.input.eval; returns undefined for absent or malformed blocks. */
+export function evalRunOptionsForRun(run) {
+    const value = run?.input?.eval;
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    try {
+        return validateEvalRunOptions(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Returns an execute function for a per-run stubbed tool, or undefined when
+ * the run carries no stub for that tool name.
+ */
+export function resolveEvalToolStub(cursors, run, toolName) {
+    const spec = evalRunOptionsForRun(run)?.toolStubs?.[toolName];
+    if (!spec || !run)
+        return undefined;
+    return () => {
+        if ("error" in spec)
+            throw new Error(spec.error);
+        if ("results" in spec) {
+            const key = `${run.id}:${toolName}`;
+            const index = cursors.get(key) ?? 0;
+            cursors.set(key, index + 1);
+            return spec.results[Math.min(index, spec.results.length - 1)];
+        }
+        return spec.result;
+    };
+}
+//# sourceMappingURL=eval-run-options.js.map

package/dist/eval-run-options.js.map

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

package/dist/harness-continuation.d.ts

@@ -0,0 +1,54 @@
+import type { HarnessContinuation, HarnessToolOutcome, JsonObject, JsonSchema, ReasoningLevel } from "@assemblyline-agents/core";
+import type { ConnectionToolMetadata } from "./connections.js";
+import type { RunRecord } from "./state.js";
+/**
+ * Persisted harness-continuation envelope helpers: the runtime-owned runtime
+ * state plus the engine's opaque continuation, and the pause bookkeeping the
+ * loop uses to park a run on a tool boundary.
+ */
+export interface RestoredHarnessRuntime {
+    modelSpec: string;
+    reasoning?: ReasoningLevel | undefined;
+    systemPrompt: string;
+    outputSchema?: JsonSchema;
+    maxIterations?: number;
+    sessionId: string;
+    channel: string;
+    conversationId?: string;
+    activeSkills: string[];
+    defaultToolNames: string[];
+    discoveredConnectionTools: ConnectionToolMetadata[];
+    pendingToolName?: string;
+}
+export interface RestoredHarnessSession {
+    runtime: RestoredHarnessRuntime;
+    continuation: HarnessContinuation;
+}
+export interface RuntimePause {
+    run: RunRecord;
+    waitingForApproval?: boolean;
+    waitingForInput?: boolean;
+    waitingForConnection?: boolean;
+    toolCallId?: string;
+    toolName?: string;
+    authorizationSessionId?: string;
+}
+export declare function storedHarnessContinuation(data: JsonObject | undefined): RestoredHarnessSession | undefined;
+/** Session fields captured into a persisted continuation envelope. */
+export interface ContinuationEnvelopeSession {
+    modelSpec: string;
+    reasoning?: ReasoningLevel | undefined;
+    systemPrompt: string;
+    outputSchema?: JsonSchema | undefined;
+    maxIterations?: number | undefined;
+    sessionId: string;
+    channel: string;
+    conversationId?: string;
+    activeSkills: Set<string>;
+    defaultToolNames: Set<string>;
+    discoveredConnectionTools: Map<string, ConnectionToolMetadata>;
+}
+/** Build the persisted envelope: runtime-owned session state + the engine's opaque continuation. */
+export declare function buildHarnessContinuationEnvelope(session: ContinuationEnvelopeSession, continuation: HarnessContinuation, pendingToolName?: string): JsonObject;
+export declare function harnessPauseOutcome(pause: RuntimePause): HarnessToolOutcome;
+//# sourceMappingURL=harness-continuation.d.ts.map

package/dist/harness-continuation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-continuation.d.ts","sourceRoot":"","sources":["../src/harness-continuation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,cAAc,EACf,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;GAIG;AAEH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,UAAU,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,yBAAyB,EAAE,sBAAsB,EAAE,CAAC;IACpD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,sBAAsB,CAAC;IAChC,YAAY,EAAE,mBAAmB,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,SAAS,CAAC;IACf,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAMD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,GAAG,sBAAsB,GAAG,SAAS,CAW1G;AAED,sEAAsE;AACtE,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACtC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,yBAAyB,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;CAChE;AAED,oGAAoG;AACpG,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,2BAA2B,EACpC,YAAY,EAAE,mBAAmB,EACjC,eAAe,CAAC,EAAE,MAAM,GACvB,UAAU,CAyBZ;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,kBAAkB,CAO3E"}

package/dist/harness-continuation.js

@@ -0,0 +1,58 @@
+import { safeJson } from "./json-util.js";
+function isEnvelopeObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function storedHarnessContinuation(data) {
+    if (!data)
+        return undefined;
+    if (!isEnvelopeObject(data.runtime) || !isEnvelopeObject(data.continuation))
+        return undefined;
+    const continuation = data.continuation;
+    if (typeof continuation.harness !== "string" || typeof continuation.version !== "number" || !isEnvelopeObject(continuation.state)) {
+        return undefined;
+    }
+    return {
+        runtime: data.runtime,
+        continuation: { harness: continuation.harness, version: continuation.version, state: continuation.state }
+    };
+}
+/** Build the persisted envelope: runtime-owned session state + the engine's opaque continuation. */
+export function buildHarnessContinuationEnvelope(session, continuation, pendingToolName) {
+    const runtimeState = {
+        modelSpec: session.modelSpec,
+        systemPrompt: session.systemPrompt,
+        sessionId: session.sessionId,
+        channel: session.channel,
+        activeSkills: [...session.activeSkills].sort(),
+        defaultToolNames: [...session.defaultToolNames].sort(),
+        discoveredConnectionTools: safeJson([...session.discoveredConnectionTools.values()].sort((a, b) => a.qualifiedName.localeCompare(b.qualifiedName)))
+    };
+    if (session.reasoning)
+        runtimeState.reasoning = session.reasoning;
+    if (session.outputSchema)
+        runtimeState.outputSchema = safeJson(session.outputSchema);
+    if (session.maxIterations !== undefined)
+        runtimeState.maxIterations = session.maxIterations;
+    if (session.conversationId)
+        runtimeState.conversationId = session.conversationId;
+    if (pendingToolName)
+        runtimeState.pendingToolName = pendingToolName;
+    return safeJson({
+        runtime: runtimeState,
+        continuation: {
+            harness: continuation.harness,
+            version: continuation.version,
+            state: continuation.state
+        }
+    });
+}
+export function harnessPauseOutcome(pause) {
+    const outcome = {
+        kind: "pause",
+        output: { paused: true, status: pause.run.status }
+    };
+    if (pause.toolCallId)
+        outcome.toolCallId = pause.toolCallId;
+    return outcome;
+}
+//# sourceMappingURL=harness-continuation.js.map

package/dist/harness-continuation.js.map

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

package/dist/harness-loop.d.ts

@@ -0,0 +1,110 @@
+import { type AgentHarness, type AgentHarnessContext, type AgentManifest, type HarnessContinuation, type HarnessToolDescriptor, type HarnessToolOutcome, type JsonObject, type JsonSchema, type JsonValue, type ReasoningLevel } from "@assemblyline-agents/core";
+import type { ChannelTurn } from "./channel.js";
+import { RuntimeConnectionRegistry, type ConnectionAuthorizationSessionStore, type ConnectionToolMetadata } from "./connections.js";
+import { type TranscriptPolicyOptions } from "./context-policy-util.js";
+import { type LoadedConversationTranscript } from "./conversation-transcript.js";
+import { type RuntimePause } from "./harness-continuation.js";
+import type { RuntimeLogger } from "./logging.js";
+import type { RunEventBus } from "./run-stream.js";
+import type { BlobAdapter, ContextBundle, EmitSpanOptions, HarnessLoopSession, HarnessLoopState, RuntimeInstrumentationConfig, RuntimeSandboxHandle } from "./runtime-types.js";
+import type { CheckpointRecord, RunRecord, StateAdapter } from "./state.js";
+/**
+ * Primary harness loop: pi-default harness resolution, the model loop over
+ * {@link AgentHarnessContext} (tool listing/execution, telemetry emit,
+ * iteration checkpoints), and harness continuation persistence. Follows the
+ * delivery-send/resource-projection host-delegate pattern: OpenEveRuntime
+ * builds a {@link HarnessLoopHost} closing over itself and keeps thin
+ * delegate methods with unchanged signatures. The `defaultAgentHarness`
+ * memo and `instrumentationConfig` are exposed as accessors on the host so
+ * reads/writes land on the runtime's own fields.
+ */
+/** Narrow slice of the runtime the harness loop needs. */
+export interface HarnessLoopHost {
+    state: StateAdapter;
+    blob: BlobAdapter;
+    manifest: AgentManifest;
+    env: Record<string, string | undefined>;
+    logger: RuntimeLogger;
+    models: unknown;
+    agentHarnessOverride: AgentHarness | undefined;
+    modelHarnesses: Record<string, AgentHarness>;
+    defaultAgentHarness: AgentHarness | undefined;
+    checkpointEveryIteration: boolean;
+    maxModelIterations: number;
+    outputValidationMaxRetries: number;
+    now(): Date;
+    shouldStopRun(runId: string): boolean;
+    /** True once the run's wall-clock deadline fired (heartbeat-enforced). */
+    runDeadlineExceeded(runId: string): boolean;
+    /** Register a per-turn AbortController; the deadline aborts registered controllers. */
+    registerRunAbort(runId: string, controller: AbortController): () => void;
+    maxRunDurationMs: number;
+    instrumentationConfig: RuntimeInstrumentationConfig;
+    runEventBus: RunEventBus;
+    connectionAuthorizationSessionStore: ConnectionAuthorizationSessionStore;
+    createConnectionRegistry(channel: string, turn?: ChannelTurn): RuntimeConnectionRegistry;
+    createConnectionRegistryForRun(run: RunRecord, fallbackChannel: string, sandboxHandle: RuntimeSandboxHandle): RuntimeConnectionRegistry;
+    visibleToolSet(defaultToolNames: Set<string>, activeSkills: Set<string>): Set<string>;
+    modelTools(activeToolNames: Set<string>, connectionRegistry: RuntimeConnectionRegistry | undefined, discoveredConnectionTools: Map<string, ConnectionToolMetadata>): Promise<HarnessToolDescriptor[]>;
+    harnessExecuteTool(call: {
+        toolCallId: string;
+        name: string;
+        input: unknown;
+    }, state: HarnessLoopState): Promise<HarnessToolOutcome>;
+    createCheckpoint(input: Omit<CheckpointRecord, "id" | "createdAt">): Promise<CheckpointRecord>;
+    emitSpan(name: string, startedAt: string, attributes: JsonObject, options?: EmitSpanOptions): Promise<void>;
+    runSpanAttributes(run: RunRecord, extra?: JsonObject): JsonObject;
+    turnSpanId(runId: string): string;
+}
+export interface HarnessLoopOutcome {
+    run: RunRecord;
+    response: string;
+    output?: JsonValue;
+    waitingForApproval?: boolean;
+    waitingForInput?: boolean;
+    waitingForConnection?: boolean;
+    failed?: boolean;
+    controlStopped?: boolean;
+    continuation?: HarnessContinuation;
+}
+interface HarnessRequestBudget {
+    max: number;
+    used: number;
+}
+export declare const DEFAULT_MAX_MODEL_ITERATIONS = 25;
+export declare const DEFAULT_OUTPUT_VALIDATION_MAX_RETRIES = 2;
+/** Pi is the default primary engine; explicit provider-prefix routes are opt-in. */
+export declare function resolveAgentHarnessImpl(host: HarnessLoopHost, modelSpec?: string): Promise<AgentHarness>;
+export declare function piHarnessImpl(host: HarnessLoopHost): AgentHarness;
+export declare function runHarnessLoopImpl(host: HarnessLoopHost, input: {
+    run: RunRecord;
+    bundle: ContextBundle;
+    sandboxHandle: RuntimeSandboxHandle;
+    message: string;
+    channel: string;
+    turn?: ChannelTurn;
+    conversationId?: string;
+    model?: string;
+    reasoning?: ReasoningLevel | undefined;
+    instructions?: string;
+    defaultToolNames?: string[];
+    harness?: AgentHarness;
+    outputSchema?: JsonSchema | undefined;
+    maxIterations?: number | undefined;
+    /** Stored conversation transcript to resume from, with trim settings. */
+    transcript?: {
+        loaded: LoadedConversationTranscript;
+        settings: TranscriptPolicyOptions;
+    } | undefined;
+}): Promise<HarnessLoopOutcome>;
+/** Execute a fresh or resumed harness turn under shared iteration and final-output policies. */
+export declare function executeHarnessTurnImpl(host: HarnessLoopHost, harness: AgentHarness, input: Parameters<AgentHarness["runTurn"]>[0], session: HarnessLoopSession, loopState: HarnessLoopState, resumed: boolean): Promise<{
+    result: Awaited<ReturnType<AgentHarness["runTurn"]>>;
+    output?: JsonValue;
+    failed?: boolean;
+    controlStopped?: boolean;
+}>;
+export declare function createHarnessContextImpl(host: HarnessLoopHost, session: HarnessLoopSession, loopState: HarnessLoopState, resumed: boolean, requestBudget?: HarnessRequestBudget): AgentHarnessContext;
+export declare function persistHarnessContinuationImpl(host: HarnessLoopHost, runId: string, session: HarnessLoopSession, continuation: HarnessContinuation | undefined, pause?: RuntimePause): Promise<void>;
+export {};
+//# sourceMappingURL=harness-loop.d.ts.map

package/dist/harness-loop.d.ts.map

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