@assemblyline-agents/runtime 0.1.0

package/dist/channel-ingress.js

@@ -0,0 +1,273 @@
+import { acceptedChannelBody, defaultChannelHttpResult, runCapacityHttpResponse } from "./channel-http-util.js";
+import { RunCapacityError } from "./concurrency.js";
+import { safeJson } from "./json-util.js";
+export async function dispatchHttpChannelImpl(host, channelName, request) {
+    host.boot();
+    const channel = host.manifest.channels.find((candidate) => candidate.name === channelName);
+    if (!channel)
+        return { status: 404, body: { error: `Channel not found: ${channelName}` } };
+    const module = await host.loadChannelModule(channel);
+    if (!module.normalizeHttp && !host.devMode && request.trusted !== true) {
+        return {
+            status: 403,
+            body: { error: `Channel ${channel.name} requires normalizeHttp() or trusted host authorization in production.` }
+        };
+    }
+    const normalized = module.normalizeHttp
+        ? await module.normalizeHttp(request, host.channelContext(channel))
+        : defaultChannelHttpResult(channel, request);
+    if (normalized.kind === "response") {
+        const response = { status: normalized.status, body: normalized.body };
+        if (normalized.headers)
+            response.headers = normalized.headers;
+        return response;
+    }
+    if (normalized.kind === "ignored") {
+        const response = { status: normalized.status ?? 202, body: normalized.body ?? { ignored: true } };
+        if (normalized.headers)
+            response.headers = normalized.headers;
+        return response;
+    }
+    if (normalized.kind === "event") {
+        if (!(await host.agentEnabled())) {
+            return { status: 503, body: { error: "Agent ingress is disabled.", disabled: true } };
+        }
+        const results = await host.dispatchAutomationEvent(normalized.event);
+        return {
+            status: normalized.status ?? 200,
+            body: normalized.body ?? safeJson({ ok: true, matched: results.length, results })
+        };
+    }
+    if (!(await host.agentEnabled())) {
+        return { status: 503, body: { error: "Agent ingress is disabled.", disabled: true } };
+    }
+    const runOptions = runOptionsFromChannelTurn(normalized.turn);
+    if (normalized.kind === "accepted") {
+        const acceptedInput = {
+            turn: normalized.turn,
+            idempotencyScope: normalized.idempotencyScope ?? `channel:${channel.name}:http`
+        };
+        if (normalized.idempotencyKey)
+            acceptedInput.idempotencyKey = normalized.idempotencyKey;
+        const accepted = await acceptChannelTurnImpl(host, channel.name, acceptedInput);
+        if (accepted.rejected === "capacity") {
+            return runCapacityHttpResponse(normalized.turn.eventId, accepted.retryAfterMs ?? host.runSemaphore.retryAfterHintMs);
+        }
+        if (accepted.rejected === "disabled") {
+            return { status: 503, body: { error: "Agent ingress is disabled.", disabled: true } };
+        }
+        if (accepted.idempotentReplay) {
+            return {
+                status: normalized.status ?? 200,
+                body: acceptedChannelBody(normalized.body, normalized.turn.eventId, true)
+            };
+        }
+        return {
+            status: normalized.status ?? 200,
+            body: acceptedChannelBody(normalized.body, normalized.turn.eventId, false)
+        };
+    }
+    // Claim capacity before the run idempotency key so a 429'd request can be
+    // retried by the provider without replaying as a duplicate.
+    const admission = host.admitRunOrReject();
+    if (admission instanceof RunCapacityError) {
+        return runCapacityHttpResponse(normalized.turn.eventId, admission.retryAfterMs);
+    }
+    const runIdempotencyKey = normalized.turn.eventId;
+    const runIdempotencyScope = `channel:${channel.name}:run`;
+    // Release the admission if the reservation throws, or the semaphore slot leaks.
+    let runReserved;
+    try {
+        runReserved = await host.state.reserveIdempotencyKey(runIdempotencyScope, runIdempotencyKey, normalized.turn.eventId);
+    }
+    catch (error) {
+        admission.release();
+        throw error;
+    }
+    if (!runReserved) {
+        admission.release();
+        return {
+            status: 200,
+            body: {
+                ok: true,
+                idempotentReplay: true,
+                eventId: normalized.turn.eventId
+            }
+        };
+    }
+    const result = await host.run({ ...runOptions, admission });
+    return {
+        status: result.run.status === "failed" ? 500 : 200,
+        body: {
+            runId: result.run.id,
+            status: result.run.status,
+            response: result.response ?? "",
+            waitingForApproval: result.waitingForApproval ?? false,
+            waitingForInput: result.waitingForInput ?? false,
+            waitingForConnection: result.waitingForConnection ?? false,
+            eventCount: result.events.length,
+            toolCallCount: result.toolCalls.length
+        }
+    };
+}
+export async function acceptChannelTurnImpl(host, channelName, input) {
+    host.boot();
+    const channel = host.manifest.channels.find((candidate) => candidate.name === channelName);
+    if (!channel)
+        throw new Error(`Channel not found: ${channelName}`);
+    if (!(await host.agentEnabled())) {
+        return {
+            accepted: false,
+            idempotentReplay: false,
+            eventId: input.turn.eventId,
+            rejected: "disabled"
+        };
+    }
+    const idempotencyKey = input.idempotencyKey ?? input.turn.eventId;
+    const idempotencyScope = input.idempotencyScope ?? `channel:${channel.name}:ingress`;
+    const queued = await host.enqueueConversationTurn({
+        turn: input.turn,
+        idempotencyScope,
+        idempotencyKey
+    });
+    if (!queued.inserted) {
+        return { accepted: false, idempotentReplay: true, eventId: input.turn.eventId };
+    }
+    return { accepted: true, idempotentReplay: false, eventId: input.turn.eventId };
+}
+export async function startChannelIngressImpl(host) {
+    host.boot();
+    const lifecycles = [];
+    for (const channel of host.manifest.channels) {
+        const module = await host.loadChannelModule(channel).catch((error) => {
+            host.logger.warn("channel ingress module load failed", {
+                channel: channel.name,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            return undefined;
+        });
+        if (!module?.startIngress)
+            continue;
+        const emit = {
+            accepted: (input) => acceptChannelTurnImpl(host, channel.name, input),
+            automation: (event) => host.dispatchAutomationEvent(event),
+            event: (type, payload = {}) => {
+                host.logger.info("channel ingress event", {
+                    type: "openeve.channel.ingress",
+                    channel: channel.name,
+                    event: type,
+                    ...(payload ?? {})
+                });
+            }
+        };
+        try {
+            const lifecycle = await module.startIngress(host.channelContext(channel), emit);
+            if (!lifecycle)
+                continue;
+            lifecycles.push({ channel: channel.name, lifecycle });
+            host.logger.info("channel ingress event", {
+                type: "openeve.channel.ingress",
+                channel: channel.name,
+                event: "started"
+            });
+        }
+        catch (error) {
+            host.logger.warn("channel ingress start failed", {
+                channel: channel.name,
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    if (lifecycles.length === 0)
+        return undefined;
+    const logger = host.logger;
+    return {
+        channels: lifecycles.map((entry) => entry.channel),
+        async stop() {
+            for (const entry of [...lifecycles].reverse()) {
+                try {
+                    const metadata = await entry.lifecycle.stop?.();
+                    logger.info("channel ingress event", {
+                        type: "openeve.channel.ingress",
+                        channel: entry.channel,
+                        event: "stopped",
+                        metadata: safeJson(metadata ?? {})
+                    });
+                }
+                catch (error) {
+                    logger.warn("channel ingress stop failed", {
+                        channel: entry.channel,
+                        error: error instanceof Error ? error.message : String(error)
+                    });
+                }
+            }
+        }
+    };
+}
+function runOptionsFromChannelTurn(turn) {
+    const runOptions = {
+        message: turn.message,
+        channel: turn.channel,
+        turn
+    };
+    if (turn.model)
+        runOptions.model = turn.model;
+    if (turn.recentHistory)
+        runOptions.recentHistory = turn.recentHistory;
+    if (turn.attachments)
+        runOptions.attachments = turn.attachments;
+    if (turn.metadata)
+        runOptions.metadata = turn.metadata;
+    return runOptions;
+}
+/**
+ * Load a channel module, preferring named exports and falling back to the
+ * default export so a one-line `export default definePhotonChannel()` wires
+ * the full lifecycle.
+ */
+export async function loadChannelModuleImpl(loadModule, channel) {
+    const loaded = await loadModule(channel.source);
+    const fallback = loaded.default ?? {};
+    const resolved = {};
+    const normalizeHttp = loaded.normalizeHttp ?? fallback.normalizeHttp;
+    const startIngress = loaded.startIngress ?? fallback.startIngress;
+    const startTurn = loaded.startTurn ?? fallback.startTurn;
+    const augmentContext = loaded.augmentContext ?? fallback.augmentContext;
+    const send = loaded.send ?? fallback.send;
+    const resolveAttachment = loaded.resolveAttachment ?? fallback.resolveAttachment;
+    const ingressAuth = loaded.ingressAuth ?? fallback.ingressAuth;
+    if (normalizeHttp)
+        resolved.normalizeHttp = normalizeHttp;
+    if (startIngress)
+        resolved.startIngress = startIngress;
+    if (startTurn)
+        resolved.startTurn = startTurn;
+    if (augmentContext)
+        resolved.augmentContext = augmentContext;
+    if (send)
+        resolved.send = send;
+    if (resolveAttachment)
+        resolved.resolveAttachment = resolveAttachment;
+    if (ingressAuth)
+        resolved.ingressAuth = ingressAuth;
+    return resolved;
+}
+/**
+ * Bind the turn channel's `resolveAttachment` for attachment intake.
+ * Trust boundary: only the module of the channel that produced the turn is
+ * consulted, and only when the turn's trusted provider matches that channel's
+ * provider — a hostile attachment claiming another provider can never route
+ * to that provider's credentials.
+ */
+export async function channelAttachmentResolverImpl(host, channel, trustedProvider) {
+    if (!channel || !trustedProvider || host.channelProvider(channel) !== trustedProvider)
+        return undefined;
+    const module = await host.loadChannelModule(channel)
+        .catch(host.warnSwallow("channel module load failed for attachment resolution", { channel: channel.name }));
+    const resolveAttachment = module?.resolveAttachment;
+    if (!resolveAttachment)
+        return undefined;
+    const ctx = host.channelContext(channel);
+    return async (attachment) => resolveAttachment(attachment, ctx);
+}
+//# sourceMappingURL=channel-ingress.js.map

package/dist/channel-ingress.js.map

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

package/dist/channel.d.ts

@@ -0,0 +1,146 @@
+import type { AutomationEvent, CompiledChannel, JsonObject } from "@assemblyline-agents/core";
+import type { AutomationEventDispatchResult } from "./runtime-types.js";
+import type { BlobAdapter, StateAdapter } from "./index.js";
+export interface ChannelTurn {
+    eventId: string;
+    channel: string;
+    conversationId: string;
+    userId?: string;
+    model?: string;
+    message: string;
+    attachments?: JsonObject[];
+    delivery?: JsonObject;
+    metadata?: JsonObject;
+    recentHistory?: string[];
+}
+export interface ChannelHttpRequest {
+    method: string;
+    url: string;
+    path: string;
+    params: Record<string, string>;
+    headers: Record<string, string>;
+    rawBody: string;
+    rawBodyBytes?: Uint8Array;
+    body: JsonObject;
+    trusted?: boolean;
+}
+export type ChannelHttpResponseBody = JsonObject | string | Uint8Array;
+export interface ChannelHttpResponse {
+    status: number;
+    body: ChannelHttpResponseBody;
+    headers?: Record<string, string>;
+}
+export type ChannelHttpResult = {
+    kind: "run";
+    turn: ChannelTurn;
+} | {
+    kind: "accepted";
+    turn: ChannelTurn;
+    status?: number;
+    body?: JsonObject;
+    idempotencyKey?: string;
+    idempotencyScope?: string;
+} | {
+    kind: "event";
+    event: AutomationEvent;
+    status?: number;
+    body?: JsonObject;
+} | {
+    kind: "response";
+    status: number;
+    body: ChannelHttpResponseBody;
+    headers?: Record<string, string>;
+} | {
+    kind: "ignored";
+    status?: number;
+    body?: ChannelHttpResponseBody;
+    headers?: Record<string, string>;
+};
+export interface ChannelDelivery {
+    id: string;
+    runId: string;
+    channel: string;
+    response: string;
+    payload: JsonObject;
+    idempotencyKey: string;
+    turn?: ChannelTurn;
+}
+export interface ChannelContext {
+    channel: CompiledChannel;
+    agentScope: string;
+    connections: Record<string, unknown>;
+    env: Record<string, string | undefined>;
+    fetch: typeof fetch;
+    state: StateAdapter;
+    blob: BlobAdapter;
+}
+export interface ChannelTurnLifecycle {
+    stop?: () => Promise<JsonObject | void> | JsonObject | void;
+}
+export interface ChannelAcceptedTurn {
+    turn: ChannelTurn;
+    idempotencyKey?: string;
+    idempotencyScope?: string;
+}
+export interface ChannelAcceptedTurnResult {
+    accepted: boolean;
+    idempotentReplay: boolean;
+    eventId: string;
+    /**
+     * Set when the turn was rejected without consuming its idempotency key —
+     * the provider can redeliver the same event once capacity frees up.
+     */
+    rejected?: "capacity" | "disabled";
+    /** Suggested client backoff before retrying (pairs with `rejected`). */
+    retryAfterMs?: number;
+}
+export interface ChannelIngressEmitter {
+    accepted(input: ChannelAcceptedTurn): Promise<ChannelAcceptedTurnResult>;
+    automation(event: AutomationEvent): Promise<AutomationEventDispatchResult[]>;
+    event(type: string, payload?: JsonObject): Promise<void> | void;
+}
+export interface ChannelIngressLifecycle {
+    stop?: () => Promise<JsonObject | void> | JsonObject | void;
+}
+export interface RuntimeChannelIngressController {
+    channels: string[];
+    stop(): Promise<void>;
+}
+export interface ChannelIngressAuthDescriptor {
+    /**
+     * Any-of groups of env var names: production ingress auth is satisfied when
+     * every var in at least one group is set (e.g. `[["TELEGRAM_WEBHOOK_SECRET"]]`
+     * or `[["PHOTON_WEBHOOK_SIGNING_SECRET"], ["PHOTON_INGRESS_TOKEN"]]`).
+     */
+    requiredSecretEnv?: string[][];
+}
+/** A resolved attachment download the runtime performs on the channel's behalf. */
+export interface ChannelAttachmentRequest {
+    url: string;
+    headers: Record<string, string>;
+    filename?: string;
+}
+export interface ChannelModule {
+    normalizeHttp?: (request: ChannelHttpRequest, ctx: ChannelContext) => Promise<ChannelHttpResult> | ChannelHttpResult;
+    startIngress?: (ctx: ChannelContext, emit: ChannelIngressEmitter) => Promise<ChannelIngressLifecycle | void> | ChannelIngressLifecycle | void;
+    startTurn?: (turn: ChannelTurn, ctx: ChannelContext) => Promise<ChannelTurnLifecycle | void> | ChannelTurnLifecycle | void;
+    augmentContext?: (turn: ChannelTurn, ctx: ChannelContext) => Promise<{
+        recentHistory?: string[];
+        channelContext?: JsonObject;
+    } | void> | {
+        recentHistory?: string[];
+        channelContext?: JsonObject;
+    } | void;
+    send?: (delivery: ChannelDelivery, ctx: ChannelContext) => Promise<JsonObject | void> | JsonObject | void;
+    /** Ingress-auth secrets this channel requires in production (mirrors `ChannelDefinition.ingress`). */
+    ingressAuth?: ChannelIngressAuthDescriptor;
+    /**
+     * Resolve a turn attachment this channel produced into a download request
+     * (URL + auth headers). The runtime only consults the module of the channel
+     * that produced the turn, so credentials never cross channels. Return
+     * `undefined` to fall back to the runtime's generic, unauthenticated URL
+     * download.
+     */
+    resolveAttachment?: (attachment: JsonObject, ctx: ChannelContext) => Promise<ChannelAttachmentRequest | undefined> | ChannelAttachmentRequest | undefined;
+}
+//# sourceMappingURL=channel.d.ts.map

package/dist/channel.d.ts.map

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

package/dist/channel.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=channel.js.map

package/dist/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":""}

package/dist/checkpoints.d.ts

@@ -0,0 +1,34 @@
+import type { JsonObject } from "@assemblyline-agents/core";
+import type { CheckpointRetentionResult } from "./state.js";
+export interface CheckpointRetentionPolicy {
+    maxActivePerRunName?: number;
+    terminalTtlMs?: number;
+    failedRunTtlMs?: number;
+    scheduledRunTtlMs?: number;
+    blobThresholdBytes?: number;
+}
+export type ResolvedCheckpointRetentionPolicy = Required<CheckpointRetentionPolicy>;
+export interface CheckpointBlobAdapter {
+    put(key: string, value: string | Uint8Array, contentTypeOrOptions?: string | {
+        contentType?: string;
+        visibility?: "private" | "public";
+    }): Promise<{
+        key: string;
+        size: number;
+    }>;
+    get(key: string): Promise<Uint8Array | undefined>;
+}
+export declare const COMPACTABLE_ACTIVE_CHECKPOINT_NAMES: string[];
+export declare const CHECKPOINT_BLOB_POINTER_KEY = "__openeveCheckpointBlob";
+export declare function resolveCheckpointRetentionPolicy(policy: CheckpointRetentionPolicy | undefined, env: Record<string, string | undefined>): ResolvedCheckpointRetentionPolicy;
+export declare function checkpointDataForStorage(input: {
+    blob: CheckpointBlobAdapter;
+    enabled: boolean;
+    thresholdBytes: number;
+    runId: string;
+    name: string;
+    data: JsonObject;
+}): Promise<JsonObject>;
+export declare function hydrateCheckpointData(data: JsonObject, blob: CheckpointBlobAdapter): Promise<JsonObject>;
+export declare function emptyCheckpointRetentionResult(dryRun: boolean): CheckpointRetentionResult;
+//# sourceMappingURL=checkpoints.d.ts.map

package/dist/checkpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoints.d.ts","sourceRoot":"","sources":["../src/checkpoints.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,WAAW,yBAAyB;IACxC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,iCAAiC,GAAG,QAAQ,CAAC,yBAAyB,CAAC,CAAC;AAEpF,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,oBAAoB,CAAC,EAAE,MAAM,GAAG;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC;QACjJ,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;CACnD;AAQD,eAAO,MAAM,mCAAmC,UAA2B,CAAC;AAC5E,eAAO,MAAM,2BAA2B,4BAA4B,CAAC;AAErE,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,yBAAyB,GAAG,SAAS,EAC7C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,iCAAiC,CAyBnC;AAED,wBAAsB,wBAAwB,CAAC,KAAK,EAAE;IACpD,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;CAClB,GAAG,OAAO,CAAC,UAAU,CAAC,CAqBtB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CAS9G;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,OAAO,GAAG,yBAAyB,CAYzF"}

package/dist/checkpoints.js

@@ -0,0 +1,86 @@
+import { createHash } from "node:crypto";
+import { gzipSync, gunzipSync } from "node:zlib";
+import { boundedPositiveIntEnv, resolvePositiveIntegerEnv } from "./env-config.js";
+const DEFAULT_CHECKPOINT_MAX_ACTIVE_PER_RUN_NAME = 2;
+const DEFAULT_CHECKPOINT_TERMINAL_TTL_MS = 7 * 24 * 60 * 60_000;
+const DEFAULT_CHECKPOINT_FAILED_TTL_MS = 14 * 24 * 60 * 60_000;
+const DEFAULT_CHECKPOINT_SCHEDULED_TTL_MS = 24 * 60 * 60_000;
+const DEFAULT_CHECKPOINT_BLOB_THRESHOLD_BYTES = 64 * 1024;
+export const COMPACTABLE_ACTIVE_CHECKPOINT_NAMES = ["harness.continuation"];
+export const CHECKPOINT_BLOB_POINTER_KEY = "__openeveCheckpointBlob";
+export function resolveCheckpointRetentionPolicy(policy, env) {
+    return {
+        maxActivePerRunName: positiveNumber(policy?.maxActivePerRunName, boundedPositiveIntEnv(env.OPENEVE_CHECKPOINT_MAX_ACTIVE_PER_RUN_NAME, DEFAULT_CHECKPOINT_MAX_ACTIVE_PER_RUN_NAME, 1, 50)),
+        terminalTtlMs: positiveNumber(policy?.terminalTtlMs, resolvePositiveIntegerEnv(env.OPENEVE_CHECKPOINT_TERMINAL_TTL_MS, DEFAULT_CHECKPOINT_TERMINAL_TTL_MS)),
+        failedRunTtlMs: positiveNumber(policy?.failedRunTtlMs, resolvePositiveIntegerEnv(env.OPENEVE_CHECKPOINT_FAILED_TTL_MS, DEFAULT_CHECKPOINT_FAILED_TTL_MS)),
+        scheduledRunTtlMs: positiveNumber(policy?.scheduledRunTtlMs, resolvePositiveIntegerEnv(env.OPENEVE_CHECKPOINT_SCHEDULED_TTL_MS, DEFAULT_CHECKPOINT_SCHEDULED_TTL_MS)),
+        blobThresholdBytes: positiveNumber(policy?.blobThresholdBytes, resolvePositiveIntegerEnv(env.OPENEVE_CHECKPOINT_BLOB_THRESHOLD_BYTES, DEFAULT_CHECKPOINT_BLOB_THRESHOLD_BYTES))
+    };
+}
+export async function checkpointDataForStorage(input) {
+    if (!input.enabled)
+        return input.data;
+    const json = JSON.stringify(input.data);
+    const sizeBytes = Buffer.byteLength(json);
+    if (sizeBytes < input.thresholdBytes)
+        return input.data;
+    const compressed = gzipSync(Buffer.from(json));
+    const sha256 = createHash("sha256").update(json).digest("hex");
+    const blob = await input.blob.put(`checkpoints/sha256/${sha256}.json.gz`, compressed, "application/gzip");
+    return {
+        [CHECKPOINT_BLOB_POINTER_KEY]: {
+            version: 1,
+            runId: input.runId,
+            name: input.name,
+            blobKey: blob.key,
+            sha256,
+            sizeBytes,
+            compressedSizeBytes: blob.size,
+            compression: "gzip",
+            contentType: "application/json"
+        }
+    };
+}
+export async function hydrateCheckpointData(data, blob) {
+    const pointer = checkpointBlobPointer(data);
+    if (!pointer)
+        return data;
+    const bytes = await blob.get(pointer.blobKey);
+    if (!bytes)
+        throw new Error(`Checkpoint blob not found: ${pointer.blobKey}`);
+    const json = Buffer.from(gunzipSync(Buffer.from(bytes))).toString("utf8");
+    const sha256 = createHash("sha256").update(json).digest("hex");
+    if (sha256 !== pointer.sha256)
+        throw new Error(`Checkpoint blob hash mismatch for ${pointer.blobKey}.`);
+    return JSON.parse(JSON.stringify(JSON.parse(json) ?? null));
+}
+export function emptyCheckpointRetentionResult(dryRun) {
+    return {
+        dryRun,
+        candidateRows: 0,
+        candidateBytes: 0,
+        prunedRows: 0,
+        prunedBytes: 0,
+        byReason: {
+            active_compaction: { rows: 0, bytes: 0 },
+            terminal_ttl: { rows: 0, bytes: 0 }
+        }
+    };
+}
+function positiveNumber(value, fallback) {
+    return typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.floor(value) : fallback;
+}
+function checkpointBlobPointer(data) {
+    const pointer = data[CHECKPOINT_BLOB_POINTER_KEY];
+    if (!isJsonObject(pointer))
+        return undefined;
+    if (pointer.version !== 1)
+        return undefined;
+    if (typeof pointer.blobKey !== "string" || typeof pointer.sha256 !== "string")
+        return undefined;
+    return { blobKey: pointer.blobKey, sha256: pointer.sha256 };
+}
+function isJsonObject(value) {
+    return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+//# sourceMappingURL=checkpoints.js.map

package/dist/checkpoints.js.map

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

package/dist/code-mode.d.ts

@@ -0,0 +1,20 @@
+import { type AgentManifest, type CompiledTool, type JsonObject, type ToolDefinition } from "@openeve/core";
+export declare const READ_TOOL_NAME = "read";
+export declare const WRITE_TOOL_NAME = "write";
+export declare const EDIT_TOOL_NAME = "edit";
+export declare const DELETE_TOOL_NAME = "delete";
+export declare const LIST_TOOL_NAME = "list";
+export declare const GREP_TOOL_NAME = "grep";
+export declare const BASH_TOOL_NAME = "bash";
+export declare const ASK_QUESTION_TOOL_NAME = "ask_question";
+export declare const SPAWN_SUBAGENT_TOOL_NAME = "spawn_subagent";
+export declare const LOAD_SKILL_TOOL_NAME = "load_skill";
+export declare const TOOL_SEARCH_TOOL_NAME = "tool_search";
+export declare const TOOL_DESCRIBE_TOOL_NAME = "tool_describe";
+export declare const TOOL_CALL_TOOL_NAME = "tool_call";
+export declare const CORE_HARNESS_TOOL_NAMES: readonly ["read", "write", "edit", "delete", "list", "grep", "bash", "ask_question", "spawn_subagent", "load_skill", "tool_search", "tool_describe", "tool_call"];
+export declare function runtimeToolsForManifest(manifest: AgentManifest): CompiledTool[];
+export declare function builtInToolDefinition(name: string): ToolDefinition | undefined;
+export declare function isBuiltInToolName(name: string): boolean;
+export declare function builtInToolContext(tool: CompiledTool): JsonObject | undefined;
+//# sourceMappingURL=code-mode.d.ts.map

package/dist/code-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-mode.d.ts","sourceRoot":"","sources":["../src/code-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,UAAU,EAKf,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AAEvB,eAAO,MAAM,cAAc,SAAS,CAAC;AACrC,eAAO,MAAM,eAAe,UAAU,CAAC;AACvC,eAAO,MAAM,cAAc,SAAS,CAAC;AACrC,eAAO,MAAM,gBAAgB,WAAW,CAAC;AACzC,eAAO,MAAM,cAAc,SAAS,CAAC;AACrC,eAAO,MAAM,cAAc,SAAS,CAAC;AACrC,eAAO,MAAM,cAAc,SAAS,CAAC;AACrC,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AACrD,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AACzD,eAAO,MAAM,oBAAoB,eAAe,CAAC;AACjD,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AACnD,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AACvD,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAE/C,eAAO,MAAM,uBAAuB,mKAc1B,CAAC;AAyUX,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,aAAa,GAAG,YAAY,EAAE,CAK/E;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAe9E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAkRD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,UAAU,GAAG,SAAS,CAM7E"}