@assemblyline-agents/core 0.1.0

package/dist/deploy.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Shared deploy contracts used by deploy adapter packages (fly, railway, docker, vps)
+ * and hosts that publish build artifacts.
+ */
+/** A single manifest preflight requirement relevant to deploy publishers. */
+export interface DeployPreflightRequirement {
+    kind: string;
+    name: string;
+    alternatives?: string[];
+    required?: boolean;
+    adapter?: string;
+}
+export interface DeployArtifactManifest {
+    /** Source agent folder; used for stable provider naming when id/name are absent. */
+    root?: string;
+    preflight?: DeployPreflightRequirement[];
+    agent?: {
+        id?: string;
+        name?: string;
+        model: string;
+    };
+    deploymentRequirements?: {
+        persistentDirectories: Array<{
+            id: string;
+            path: string;
+            sensitive: boolean;
+        }>;
+        remoteExecution: boolean;
+    };
+}
+/** A built agent artifact ready to publish. */
+export interface DeployArtifact {
+    root: string;
+    manifest?: DeployArtifactManifest;
+}
+/** The resolved plan describing where and what to publish. */
+export interface DeployPlan {
+    target: string;
+    environment: string;
+    agentRevision: string;
+    /** Stable logical agent identity (manifest `agent.id`, falling back to `agent.name`). */
+    agentId?: string;
+    /**
+     * The environment deploys land in when `--env` is not passed (manifest
+     * `gateway.deploy.options.environment`, else "development"). Resources for
+     * this environment keep their legacy unscoped names; every other environment
+     * must be isolated — see {@link environmentScopedName}.
+     */
+    defaultEnvironment?: string;
+    /** Resolved requirements when a compiler deployment plan is passed through the CLI. */
+    requirements?: DeployPreflightRequirement[];
+}
+/** Lowercased, dash-separated resource label safe for provider resource names. */
+export declare function sanitizeDeployName(value: string, maxLength?: number): string;
+/**
+ * Environment-scoped resource naming shared by deploy targets that isolate
+ * environments by name (docker containers/volumes, fly apps) rather than
+ * natively (railway environments) or by identity hash (vps). The default
+ * environment keeps the unscoped `base` so existing deployments are never
+ * orphaned; any other environment gets a `-<environment>` suffix.
+ */
+export declare function environmentScopedName(base: string, plan: Pick<DeployPlan, "environment" | "defaultEnvironment">): string;
+export interface DeployCommandResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+export interface DeployCommandOptions {
+    cwd?: string;
+    env?: Record<string, string | undefined>;
+    silent?: boolean;
+}
+/** Runner used by deploy publishers to execute provider CLI commands. */
+export type RunDeployCommand = (executable: string, args: string[], options?: DeployCommandOptions) => Promise<DeployCommandResult>;
+/** Provider-specific receipt describing the published deployment. */
+export interface DeployReceipt {
+    [key: string]: unknown;
+}
+/**
+ * Canonical URL fields every deploy receipt should populate so callers never
+ * conflate the public service URL with a provider dashboard link.
+ * `deploymentUrl` is the reachable service URL (or null when the provider can't
+ * resolve one yet); `dashboardUrl` is the provider's management console.
+ */
+export interface DeployReceiptUrls {
+    deploymentUrl: string | null;
+    dashboardUrl?: string;
+}
+/** Receipt for a secret-sync operation. Never contains secret values. */
+export interface DeploySecretsReceipt {
+    target: string;
+    /** Keys that were pushed to the target (names only). */
+    syncedKeys: string[];
+    /** Keys skipped because they were empty/unset locally. */
+    skippedKeys: string[];
+}
+/** Migration inputs resolved by the CLI and delegated to capable publishers. */
+export interface DeployMigrationRequest {
+    /** Artifact-relative migration entries, in deterministic order. */
+    entries: string[];
+    /** Executable configured by --migration-command/OPENEVE_MIGRATION_COMMAND. */
+    command?: string;
+}
+export interface DeployRemoteCommandOptions {
+    interactive?: boolean;
+    silent?: boolean;
+    /** Run against the currently active release or the most recently prepared release. */
+    release?: "active" | "prepared";
+}
+export interface DeployDestroyOptions {
+    /** Also delete durable data (volumes, databases). Default keeps data. */
+    purgeData?: boolean;
+}
+/** Contract implemented by deploy adapter packages. */
+export interface DeployPublisher {
+    target: string;
+    /** Validate the remote target before making deployment-scoped changes. */
+    preflight?(artifact: DeployArtifact, plan: DeployPlan): Promise<DeployReceipt | void>;
+    /** Stage immutable build inputs and provision deployment-scoped infrastructure. */
+    prepare?(artifact: DeployArtifact, plan: DeployPlan): Promise<DeployReceipt | void>;
+    /** Activate the most recently prepared release. `publish` remains the compatibility alias. */
+    activate?(artifact: DeployArtifact, plan: DeployPlan): Promise<DeployReceipt>;
+    publish(artifact: DeployArtifact, plan: DeployPlan): Promise<DeployReceipt>;
+    /** Restore the prior active release without rebuilding or replacing durable state. */
+    rollback?(artifact: DeployArtifact, plan: DeployPlan): Promise<DeployReceipt>;
+    /**
+     * Remove the provider resources backing `plan.environment` (container/app/
+     * service). Durable data survives unless `options.purgeData`. Like rollback,
+     * implementations re-derive resource names from the plan; there is no receipt
+     * to consult. Targets that cannot remove resources safely omit this.
+     */
+    destroy?(artifact: DeployArtifact, plan: DeployPlan, options?: DeployDestroyOptions): Promise<DeployReceipt>;
+    /** Reconcile the configured primary domain and aliases without rebuilding the runtime. */
+    reconcileDomains?(artifact: DeployArtifact, plan: DeployPlan): Promise<DeployReceipt>;
+    /**
+     * Optional: push secrets to the deployed service. Adapters without a remote
+     * service (docker, local) omit this; callers feature-detect. Implementations
+     * MUST NOT log secret values — only key names.
+     */
+    syncSecrets?(secrets: Record<string, string>, plan: DeployPlan): Promise<DeploySecretsReceipt>;
+    /** Return configured remote secret key names only; values must never cross this interface. */
+    inspectSecrets?(artifact: DeployArtifact, plan: DeployPlan): Promise<string[]>;
+    /**
+     * Optional publisher-owned migration path. VPS-like targets use this to run
+     * migrations beside private databases without exposing credentials locally.
+     */
+    runMigrations?(artifact: DeployArtifact, plan: DeployPlan, request: DeployMigrationRequest): Promise<string>;
+    /** Execute a command in the deployed runtime without exposing credential material to OpenEve. */
+    runRemoteCommand?(artifact: DeployArtifact, plan: DeployPlan, command: string[], options?: DeployRemoteCommandOptions): Promise<DeployCommandResult>;
+}
+//# sourceMappingURL=deploy.d.ts.map

package/dist/deploy.d.ts.map

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

package/dist/deploy.js

@@ -0,0 +1,25 @@
+/**
+ * Shared deploy contracts used by deploy adapter packages (fly, railway, docker, vps)
+ * and hosts that publish build artifacts.
+ */
+/** Lowercased, dash-separated resource label safe for provider resource names. */
+export function sanitizeDeployName(value, maxLength = 40) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/gu, "-")
+        .replace(/^-+|-+$/gu, "")
+        .slice(0, maxLength) || "default";
+}
+/**
+ * Environment-scoped resource naming shared by deploy targets that isolate
+ * environments by name (docker containers/volumes, fly apps) rather than
+ * natively (railway environments) or by identity hash (vps). The default
+ * environment keeps the unscoped `base` so existing deployments are never
+ * orphaned; any other environment gets a `-<environment>` suffix.
+ */
+export function environmentScopedName(base, plan) {
+    if (!plan.defaultEnvironment || plan.environment === plan.defaultEnvironment)
+        return base;
+    return `${base}-${sanitizeDeployName(plan.environment, 20)}`;
+}
+//# sourceMappingURL=deploy.js.map

package/dist/deploy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../src/deploy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAsDH,kFAAkF;AAClF,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,SAAS,GAAG,EAAE;IAC9D,OAAO,KAAK;SACT,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;SACxB,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,SAAS,CAAC;AACtC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAY,EACZ,IAA4D;IAE5D,IAAI,CAAC,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC,kBAAkB;QAAE,OAAO,IAAI,CAAC;IAC1F,OAAO,GAAG,IAAI,IAAI,kBAAkB,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC;AAC/D,CAAC"}

package/dist/env-alias.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Environment-variable aliasing for the rename compatibility window.
+ *
+ * The contract is a uniform prefix bijection: every `ASSEMBLY_LINE_X` has the
+ * legacy spelling `OPENEVE_X` and vice versa. Aliasing mirrors each value
+ * under both names so existing read sites (including prefix rules like
+ * `OPENEVE_VPS_BACKUP_*` and the `OPENEVE_*_RATE_LIMIT` family) keep working
+ * without per-site edits. Precedence: the new name wins; equal duplicates are
+ * accepted; conflicting duplicates are a hard error.
+ */
+export declare function canonicalEnvName(name: string): string;
+export declare function legacyEnvName(name: string): string;
+export declare class EnvAliasConflictError extends Error {
+    readonly names: readonly [string, string];
+    constructor(newName: string, legacyName: string);
+}
+export interface AppliedEnvAliases {
+    env: Record<string, string | undefined>;
+    /** Variables supplied only under their legacy `OPENEVE_*` name. */
+    legacyOnlyNames: string[];
+}
+/**
+ * Returns a copy of `env` where every branded variable is readable under both
+ * its `ASSEMBLY_LINE_*` and `OPENEVE_*` spellings. Throws
+ * {@link EnvAliasConflictError} when both spellings are set to different
+ * values. The input record is not mutated.
+ */
+export declare function applyEnvAliases(env: Record<string, string | undefined>): AppliedEnvAliases;
+/**
+ * Mirrors branded variables into `target` in place (used for `process.env`,
+ * which must keep its exotic binding). Same precedence rules as
+ * {@link applyEnvAliases}.
+ */
+export declare function mirrorEnvAliasesInPlace(target: Record<string, string | undefined>): AppliedEnvAliases;
+//# sourceMappingURL=env-alias.d.ts.map

package/dist/env-alias.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-alias.d.ts","sourceRoot":"","sources":["../src/env-alias.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAE9B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAQhD;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACxC,mEAAmE;IACnE,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,iBAAiB,CAyB1F;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,iBAAiB,CAMrG"}

package/dist/env-alias.js

@@ -0,0 +1,79 @@
+import { ENV_PREFIX, LEGACY_ENV_PREFIX } from "./brand.js";
+/**
+ * Environment-variable aliasing for the rename compatibility window.
+ *
+ * The contract is a uniform prefix bijection: every `ASSEMBLY_LINE_X` has the
+ * legacy spelling `OPENEVE_X` and vice versa. Aliasing mirrors each value
+ * under both names so existing read sites (including prefix rules like
+ * `OPENEVE_VPS_BACKUP_*` and the `OPENEVE_*_RATE_LIMIT` family) keep working
+ * without per-site edits. Precedence: the new name wins; equal duplicates are
+ * accepted; conflicting duplicates are a hard error.
+ */
+export function canonicalEnvName(name) {
+    return name.startsWith(LEGACY_ENV_PREFIX)
+        ? `${ENV_PREFIX}${name.slice(LEGACY_ENV_PREFIX.length)}`
+        : name;
+}
+export function legacyEnvName(name) {
+    return name.startsWith(ENV_PREFIX)
+        ? `${LEGACY_ENV_PREFIX}${name.slice(ENV_PREFIX.length)}`
+        : name;
+}
+export class EnvAliasConflictError extends Error {
+    names;
+    constructor(newName, legacyName) {
+        super(`Conflicting values for ${newName} and ${legacyName}. ` +
+            `These are aliases for the same setting; set one, or set both to the same value.`);
+        this.name = "EnvAliasConflictError";
+        this.names = [newName, legacyName];
+    }
+}
+/**
+ * Returns a copy of `env` where every branded variable is readable under both
+ * its `ASSEMBLY_LINE_*` and `OPENEVE_*` spellings. Throws
+ * {@link EnvAliasConflictError} when both spellings are set to different
+ * values. The input record is not mutated.
+ */
+export function applyEnvAliases(env) {
+    const merged = { ...env };
+    const legacyOnlyNames = [];
+    for (const [name, value] of Object.entries(env)) {
+        if (value === undefined)
+            continue;
+        if (name.startsWith(ENV_PREFIX)) {
+            const legacy = legacyEnvName(name);
+            const legacyValue = env[legacy];
+            if (legacyValue !== undefined && legacyValue !== value) {
+                throw new EnvAliasConflictError(name, legacy);
+            }
+            merged[legacy] = value;
+        }
+        else if (name.startsWith(LEGACY_ENV_PREFIX)) {
+            const canonical = canonicalEnvName(name);
+            const canonicalValue = env[canonical];
+            if (canonicalValue !== undefined) {
+                if (canonicalValue !== value)
+                    throw new EnvAliasConflictError(canonical, name);
+                continue;
+            }
+            merged[canonical] = value;
+            legacyOnlyNames.push(name);
+        }
+    }
+    legacyOnlyNames.sort();
+    return { env: merged, legacyOnlyNames };
+}
+/**
+ * Mirrors branded variables into `target` in place (used for `process.env`,
+ * which must keep its exotic binding). Same precedence rules as
+ * {@link applyEnvAliases}.
+ */
+export function mirrorEnvAliasesInPlace(target) {
+    const applied = applyEnvAliases({ ...target });
+    for (const [name, value] of Object.entries(applied.env)) {
+        if (value !== undefined && target[name] === undefined)
+            target[name] = value;
+    }
+    return { env: target, legacyOnlyNames: applied.legacyOnlyNames };
+}
+//# sourceMappingURL=env-alias.js.map

package/dist/env-alias.js.map

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

package/dist/harness.d.ts

@@ -0,0 +1,299 @@
+import type { JsonObject, JsonSchema, ReasoningLevel } from "./index.js";
+/**
+ * Internal contract between the OpenEve runtime and the primary agent engine.
+ * Pi (`@assemblyline-agents/pi`) is the canonical engine; this seam is not a public
+ * extension point, but it is deliberately engine-shaped: nothing in this
+ * module may reference a specific engine, continuation state is an opaque
+ * JSON object owned by the engine adapter, and all durability (tool records,
+ * pauses, checkpoints, events, usage, spans) stays in the runtime. That keeps
+ * the runtime free of pi types, persisted state independent of pi internals,
+ * and `RuntimeOptions.agentHarness` available as the embedder/test seam
+ * (scripted engines drive the durability test suite through it).
+ *
+ * Message content (prompts, completions, tool arguments) is optionally surfaced
+ * through lifecycle events for observability, and only when the runtime opts in
+ * via `AgentHarnessContext.captureContent`. When that flag is false a harness
+ * must not populate the content fields (skip the transcript clone entirely).
+ * The runtime — not the harness — owns redaction, truncation, and sampling of
+ * whatever content it receives before any of it reaches a telemetry sink.
+ */
+/** A tool exposed to the model, described in engine-neutral terms. */
+export interface HarnessToolDescriptor {
+    name: string;
+    description: string;
+    inputSchema: JsonSchema;
+    /**
+     * Tool-batch scheduling hint. `"sequential"` marks tools that may pause the
+     * run (approval gates, human input, connection authorization) or must not
+     * run concurrently; an engine must run any batch containing one
+     * sequentially and stop the batch at a pause. Absent means parallel-safe.
+     */
+    execution?: "parallel" | "sequential";
+}
+/**
+ * Binary media supplied to a model turn.
+ *
+ * `data` is raw base64 (not a data URL). Engine adapters own the final
+ * provider-specific encoding. `path` is the stable logical `/files/...`
+ * reference and is safe to surface when the selected model cannot accept the
+ * media natively.
+ */
+export interface HarnessImageInput {
+    type: "image";
+    data: string;
+    mimeType: string;
+    name?: string;
+    path?: string;
+}
+/** A complete video supplied for native temporal model understanding. */
+export interface HarnessVideoInput {
+    type: "video";
+    data: string;
+    mimeType: string;
+    name?: string;
+    path?: string;
+}
+/** Engine-neutral media accepted by a harness turn. */
+export type HarnessInputMedia = HarnessImageInput | HarnessVideoInput;
+/**
+ * Outcome of a runtime tool execution as seen by the harness.
+ *
+ * - `result`: the tool produced bounded/redacted `output` plus optional typed
+ *   `media`, which the harness returns to the model in its native format.
+ * - `pause`: the runtime paused the run (approval, human input, connection
+ *   authorization). The harness must stop the loop after returning `output`
+ *   as the tool result. `toolCallId` is an opaque correlation id the runtime
+ *   will echo conceptually when the paused tool later resolves; harnesses
+ *   that splice resumed tool results into their transcript should persist it
+ *   in their continuation state.
+ */
+export type HarnessToolOutcome = {
+    kind: "result";
+    output: unknown;
+    media?: HarnessInputMedia[];
+} | {
+    kind: "pause";
+    output: unknown;
+    media?: HarnessInputMedia[];
+    toolCallId?: string;
+};
+/** A model-requested tool call, described in engine-neutral terms. */
+export interface HarnessContentToolCall {
+    id?: string;
+    name: string;
+    arguments: unknown;
+}
+/**
+ * One message in the transcript sent to (or produced by) the model, surfaced
+ * for observability. Populated by a harness only when `captureContent` is set;
+ * the system prompt is intentionally excluded (the runtime already holds it).
+ */
+export interface HarnessContentMessage {
+    role: "system" | "user" | "assistant" | "tool";
+    text?: string;
+    /** Media metadata only; base64 payloads are never copied into observability events. */
+    media?: Array<{
+        type: HarnessInputMedia["type"];
+        mimeType: string;
+        name?: string;
+        path?: string;
+    }>;
+    toolCalls?: HarnessContentToolCall[];
+    toolResult?: {
+        toolCallId?: string;
+        output: unknown;
+    };
+}
+/** Where a provider call was billed. */
+export type HarnessBillingMode = "api_key" | "chatgpt" | "byok" | "subscription" | "unknown";
+/** Provenance for token counts returned by a harness. */
+export type HarnessTokenSource = "provider_reported" | "provider_reconciled" | "unavailable";
+/** Provenance for monetary values returned by a harness. */
+export type HarnessCostSource = "provider_reported" | "provider_reconciled" | "unavailable";
+/**
+ * Normalized provider usage. `inputTokens` is total provider input, including
+ * cached input; cached/reasoning counts are subsets and must not be added when
+ * computing total tokens. `costUsd` only carries provider-reported or
+ * reconciled cash; absent provider cash remains unavailable.
+ */
+export interface HarnessUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    cachedTokens?: number;
+    cacheWriteTokens?: number;
+    reasoningTokens?: number;
+    costUsd?: number;
+    upstreamCostUsd?: number;
+    currency?: string;
+    tokenSource?: HarnessTokenSource;
+    costSource?: HarnessCostSource;
+}
+/** Model-loop lifecycle events the harness reports back to the runtime. */
+export type AgentHarnessEvent = {
+    type: "request_started";
+    iteration: number;
+    toolNames: string[];
+    provider?: string;
+    billingMode?: HarnessBillingMode;
+    /** Transcript sent to the model this iteration; only set when `captureContent` is on. */
+    requestMessages?: HarnessContentMessage[];
+} | {
+    /** A model request attempt failed with a retryable error and is being retried. */
+    type: "model_retry";
+    iteration: number;
+    attempt: number;
+    delayMs: number;
+    error: string;
+    status?: number;
+} | {
+    /**
+     * Incremental assistant text. Ephemeral: the runtime fans these out to
+     * live run-stream subscribers and never persists them to the event log.
+     */
+    type: "response_delta";
+    iteration: number;
+    delta: string;
+} | {
+    type: "response_completed";
+    iteration: number;
+    finishReason?: string;
+    toolCallCount: number;
+    usage?: HarnessUsage;
+    provider?: string;
+    responseModel?: string;
+    providerRequestId?: string;
+    billingMode?: HarnessBillingMode;
+    /** Sanitized provider receipt. Credentials and direct identifiers are forbidden. */
+    providerReceipt?: JsonObject;
+    /** Assistant output this iteration; only set when `captureContent` is on. */
+    responseContent?: {
+        text?: string;
+        toolCalls?: HarnessContentToolCall[];
+    };
+};
+/**
+ * Versioned, opaque harness continuation. The runtime persists this as-is and
+ * hands it back on resume. `state` must be JSON-serializable and is only
+ * interpreted by the harness that produced it (matched by `harness` + `version`).
+ */
+export interface HarnessContinuation {
+    harness: string;
+    version: number;
+    state: JsonObject;
+}
+/** Input for one harness turn: a fresh message or a resume of a paused turn. */
+export type AgentTurnInput = {
+    kind: "message";
+    message: string;
+    recentHistory: string[];
+    media?: HarnessInputMedia[];
+} | {
+    kind: "resume";
+    continuation: HarnessContinuation;
+    toolResult?: {
+        toolName: string;
+        output: unknown;
+        media?: HarnessInputMedia[];
+    };
+    /** Optional user follow-up appended to the restored transcript (subagent follow-ups). */
+    message?: string;
+    /** Optional media accompanying a user follow-up. */
+    media?: HarnessInputMedia[];
+};
+/** Runtime-provided context for one harness turn. */
+export interface AgentHarnessContext {
+    runId: string;
+    sessionId: string;
+    modelSpec: string;
+    reasoning?: ReasoningLevel | undefined;
+    systemPrompt: string;
+    /** Optional final-output contract. Harnesses may use native provider constraints; the runtime validates authoritatively. */
+    outputSchema?: JsonSchema | undefined;
+    /** Maximum model requests permitted for this harness invocation. */
+    maxIterations?: number | undefined;
+    /** Cooperative runtime control signal, checked before each model request. */
+    shouldStop?(): boolean;
+    /**
+     * Hard-abort signal for run cancellation and deadline enforcement. Harnesses
+     * should abort in-flight model requests when it fires; the runtime settles
+     * the run outcome after the turn unwinds.
+     */
+    signal?: AbortSignal;
+    env: Record<string, string | undefined>;
+    /** Current tool set. Re-invoked before each model request so mid-turn discovery is visible. */
+    tools(): Promise<HarnessToolDescriptor[]>;
+    /** Execute a model-requested tool through runtime durability. */
+    executeTool(call: {
+        toolCallId: string;
+        name: string;
+        input: unknown;
+    }): Promise<HarnessToolOutcome>;
+    /** Report a model-loop lifecycle event (events, usage, spans stay runtime-side). */
+    emit(event: AgentHarnessEvent): void | Promise<void>;
+    /**
+     * When true, the runtime wants message content on the lifecycle events
+     * (`requestMessages` / `responseContent`). When false or undefined, harnesses
+     * must skip populating them to avoid the transcript clone cost.
+     */
+    captureContent?: boolean;
+    /** When provided, called with a fresh continuation snapshot after every model response. */
+    onIterationCheckpoint?(continuation: HarnessContinuation): Promise<void>;
+}
+export interface AgentTurnResult {
+    response: string;
+    paused?: boolean;
+    continuation?: HarnessContinuation;
+    /** Set when the turn ended at a runtime boundary rather than naturally or for a tool pause. */
+    stoppedReason?: "max_iterations" | "control_signal";
+}
+/** Token budget the runtime hands a harness when trimming a stored transcript. */
+export interface HarnessTranscriptBudget {
+    /** Provider-reported input tokens of the transcript's last model request, when known. */
+    lastInputTokens?: number;
+    /** Tokens reserved below the model context window before compaction triggers. */
+    reserveTokens: number;
+    /** Approximate recent-transcript tokens kept verbatim through compaction. */
+    keepRecentTokens: number;
+    /** Character cap applied to tool-result bodies outside the recent tail. */
+    toolResultCapChars: number;
+}
+/** Outcome of a harness transcript trim: the (possibly compacted) continuation plus what happened. */
+export interface HarnessTrimOutcome {
+    continuation: HarnessContinuation;
+    /** True when history was summarized (not merely capped). */
+    compacted: boolean;
+    /** Estimated context tokens before compaction, when compaction ran. */
+    tokensBefore?: number;
+    /** Number of tool-result bodies capped by the lossless pass. */
+    cappedToolResults?: number;
+}
+export interface AgentHarness {
+    readonly id: string;
+    readonly continuationVersion: number;
+    runTurn(input: AgentTurnInput, ctx: AgentHarnessContext): Promise<AgentTurnResult>;
+    /**
+     * Trim a stored continuation to the given budget before a conversation
+     * resume: cap stale tool-result bodies, and summarize older history when
+     * the transcript exceeds the model context window minus `reserveTokens`.
+     * Optional; harnesses that cannot trim leave the runtime to its fallback
+     * (rebuilding context from flattened recent history). Returning undefined
+     * means the continuation is not this harness's to trim.
+     */
+    trimContinuation?(continuation: HarnessContinuation, budget: HarnessTranscriptBudget, ctx: {
+        env: Record<string, string | undefined>;
+        modelSpec: string;
+        reasoning?: ReasoningLevel | undefined;
+        signal?: AbortSignal;
+    }): Promise<HarnessTrimOutcome | undefined>;
+}
+/** Classification of a model-call failure surfaced by a harness error. */
+export type ModelErrorClassification = "fatal" | "retryable" | "unknown";
+/**
+ * Reads the classification a harness attached to a thrown error, if any.
+ * Kept as a duck-typed check so the runtime never imports engine error classes.
+ */
+export declare function modelErrorClassification(error: unknown): ModelErrorClassification | undefined;
+export declare const DEFAULT_MODEL_OUTPUT_MAX_CHARS = 8000;
+/** Bound a tool output for model consumption (large payloads become previews). */
+export declare function boundModelOutput(value: unknown, maxChars?: number): unknown;
+//# sourceMappingURL=harness.d.ts.map

package/dist/harness.d.ts.map

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

package/dist/harness.js

@@ -0,0 +1,22 @@
+/**
+ * Reads the classification a harness attached to a thrown error, if any.
+ * Kept as a duck-typed check so the runtime never imports engine error classes.
+ */
+export function modelErrorClassification(error) {
+    if (!(error instanceof Error))
+        return undefined;
+    const value = error.classification;
+    return value === "fatal" || value === "retryable" || value === "unknown" ? value : undefined;
+}
+export const DEFAULT_MODEL_OUTPUT_MAX_CHARS = 8_000;
+/** Bound a tool output for model consumption (large payloads become previews). */
+export function boundModelOutput(value, maxChars = DEFAULT_MODEL_OUTPUT_MAX_CHARS) {
+    const json = JSON.stringify(value ?? null);
+    if (json.length <= maxChars)
+        return JSON.parse(json);
+    return {
+        truncated: true,
+        preview: json.slice(0, maxChars)
+    };
+}
+//# sourceMappingURL=harness.js.map

package/dist/harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.js","sourceRoot":"","sources":["../src/harness.ts"],"names":[],"mappings":"AAsSA;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,KAAK,GAAI,KAAsC,CAAC,cAAc,CAAC;IACrE,OAAO,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/F,CAAC;AAED,MAAM,CAAC,MAAM,8BAA8B,GAAG,KAAK,CAAC;AAEpD,kFAAkF;AAClF,MAAM,UAAU,gBAAgB,CAAC,KAAc,EAAE,WAAmB,8BAA8B;IAChG,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;IAC3C,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;IAChE,OAAO;QACL,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC;KACjC,CAAC;AACJ,CAAC"}