@assemblyline-agents/runtime 0.1.0

package/dist/delivery-queue.js

@@ -0,0 +1,244 @@
+import { randomUUID } from "node:crypto";
+/**
+ * Durable delivery queue: lease/retry record helpers shared by the state
+ * adapters, plus the worker loop that drains deferred deliveries. Mirrors the
+ * sandbox-sync job queue so at-least-once channel delivery survives process
+ * crashes and works across replicas (postgres leases use
+ * `for update skip locked`).
+ */
+export const DEFAULT_DELIVERY_QUEUE_MAX_ATTEMPTS = 5;
+function timestamp() {
+    return new Date().toISOString();
+}
+function positiveOr(value, fallback) {
+    return typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.floor(value) : fallback;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export function createDeliveryRecord(input) {
+    const now = timestamp();
+    const record = {
+        ...input,
+        attemptCount: input.attemptCount ?? 0,
+        maxAttempts: input.maxAttempts ?? DEFAULT_DELIVERY_QUEUE_MAX_ATTEMPTS,
+        nextAttemptAt: input.nextAttemptAt ?? now,
+        id: randomUUID(),
+        createdAt: now,
+        updatedAt: now
+    };
+    return record;
+}
+/** Fill queue defaults on rows persisted before the durable delivery queue existed. */
+export function normalizeDeliveryRecord(delivery) {
+    const createdAt = delivery.createdAt ?? timestamp();
+    return {
+        ...delivery,
+        status: delivery.status ?? "pending",
+        payload: delivery.payload ?? {},
+        attemptCount: typeof delivery.attemptCount === "number" ? delivery.attemptCount : 0,
+        maxAttempts: typeof delivery.maxAttempts === "number" ? delivery.maxAttempts : DEFAULT_DELIVERY_QUEUE_MAX_ATTEMPTS,
+        nextAttemptAt: delivery.nextAttemptAt ?? createdAt,
+        createdAt,
+        updatedAt: delivery.updatedAt ?? createdAt
+    };
+}
+const OPTIONAL_DELIVERY_KEYS = new Set(["leaseToken", "leaseExpiresAt", "lastError", "sentAt", "failedAt"]);
+export function applyDeliveryPatch(current, patch) {
+    const updated = { ...current, updatedAt: timestamp() };
+    for (const [key, value] of Object.entries(patch)) {
+        if (value === undefined) {
+            if (OPTIONAL_DELIVERY_KEYS.has(key))
+                delete updated[key];
+            continue;
+        }
+        updated[key] = value;
+    }
+    return updated;
+}
+export function isDeliveryDue(delivery, now) {
+    if (delivery.status !== "pending")
+        return false;
+    if (delivery.attemptCount >= delivery.maxAttempts)
+        return false;
+    return Date.parse(delivery.nextAttemptAt) <= now.getTime();
+}
+export function deliveryQueueRetryDelayMs(attemptCount) {
+    const bounded = Math.max(1, Math.min(8, attemptCount));
+    return Math.min(15 * 60_000, 2 ** (bounded - 1) * 1_000);
+}
+/** Feature detection: adapters opt into the durable queue by implementing the lease methods. */
+export function stateSupportsDeliveryQueue(state) {
+    return typeof state.leaseDueDeliveries === "function" &&
+        typeof state.completeDeliverySend === "function" &&
+        typeof state.failDeliverySend === "function";
+}
+/**
+ * Move a failed in-process delivery onto the durable queue instead of marking
+ * it terminally failed: status back to `pending` with exponential backoff so a
+ * delivery worker (possibly in another process, after a crash) retries it.
+ */
+export async function deferFailedDelivery(input) {
+    const attemptCount = Math.max(input.delivery.attemptCount, input.attempts);
+    const nextAttemptAt = new Date(input.now.getTime() + deliveryQueueRetryDelayMs(Math.max(1, attemptCount))).toISOString();
+    const updated = await input.state.updateDelivery(input.delivery.id, {
+        status: "pending",
+        attemptCount,
+        maxAttempts: Math.max(input.maxAttempts, attemptCount + 1),
+        nextAttemptAt,
+        lastError: input.error,
+        // Release any inline-send lease so the delivery worker can pick this up.
+        leaseToken: undefined,
+        leaseExpiresAt: undefined
+    });
+    await input.state.appendEvent(input.runId, "delivery.deferred", {
+        deliveryId: input.delivery.id,
+        error: input.error,
+        attempts: attemptCount,
+        maxAttempts: updated.maxAttempts,
+        nextAttemptAt
+    });
+    return updated;
+}
+/** Recover expired leases, lease due deliveries, and attempt each send once. */
+export async function runDueDeliveriesImpl(host, options = {}) {
+    if (!(await host.agentEnabled()))
+        return [];
+    const { state } = host;
+    if (!stateSupportsDeliveryQueue(state) || !state.leaseDueDeliveries)
+        return [];
+    const now = options.now ?? host.now();
+    const recovered = await state.recoverExpiredDeliveries?.(now) ?? [];
+    for (const delivery of recovered) {
+        await state.appendEvent(delivery.runId, "delivery.retrying", {
+            deliveryId: delivery.id,
+            reason: "expired_lease",
+            attemptCount: delivery.attemptCount,
+            maxAttempts: delivery.maxAttempts,
+            nextAttemptAt: delivery.nextAttemptAt
+        });
+    }
+    const leased = await state.leaseDueDeliveries({
+        now,
+        limit: positiveOr(options.limit, host.batchSize),
+        leaseForMs: positiveOr(options.leaseForMs, host.leaseMs)
+    });
+    const results = [];
+    for (const delivery of leased) {
+        results.push(await processLeasedDelivery(host, delivery));
+    }
+    return results;
+}
+async function processLeasedDelivery(host, delivery) {
+    const { state } = host;
+    const leaseToken = delivery.leaseToken ?? "";
+    let outcome;
+    try {
+        outcome = await host.sendQueuedDelivery(delivery);
+    }
+    catch (error) {
+        outcome = { ok: false, error: errorMessage(error), retryable: true };
+    }
+    if (outcome.ok) {
+        const send = { ...(outcome.metadata ?? {}), attempts: delivery.attemptCount, queued: true };
+        const completed = await state.completeDeliverySend(delivery.id, leaseToken, {
+            payload: { ...delivery.payload, send }
+        });
+        await state.appendEvent(delivery.runId, "delivery.sent", {
+            deliveryId: delivery.id,
+            attempts: completed.attemptCount,
+            queued: true,
+            metadata: send
+        });
+        return { deliveryId: delivery.id, runId: delivery.runId, status: "sent" };
+    }
+    const error = outcome.error ?? "Channel delivery failed.";
+    const failed = await state.failDeliverySend(delivery.id, leaseToken, {
+        error,
+        now: host.now(),
+        ...(outcome.retryable === false ? { permanent: true } : {})
+    });
+    if (failed.status === "failed") {
+        await state.appendEvent(delivery.runId, "delivery.failed", {
+            deliveryId: delivery.id,
+            error,
+            attempts: failed.attemptCount,
+            queued: true
+        });
+        host.logger.warn("delivery permanently failed", {
+            deliveryId: delivery.id,
+            runId: delivery.runId,
+            channel: delivery.channel,
+            attempts: failed.attemptCount,
+            error
+        });
+        return { deliveryId: delivery.id, runId: delivery.runId, status: "failed", error };
+    }
+    await state.appendEvent(delivery.runId, "delivery.retrying", {
+        deliveryId: delivery.id,
+        error,
+        attemptCount: failed.attemptCount,
+        maxAttempts: failed.maxAttempts,
+        nextAttemptAt: failed.nextAttemptAt
+    });
+    return { deliveryId: delivery.id, runId: delivery.runId, status: "retrying", error };
+}
+export function finalDeliveryIdempotencyKey(run, channel, turn) {
+    const inputEventId = typeof run.input.eventId === "string" ? run.input.eventId.trim() : "";
+    const eventId = turn?.eventId ?? inputEventId;
+    if (eventId)
+        return `delivery:${channel}:${eventId}:final`;
+    return `delivery:${run.id}`;
+}
+export function deliveryFileName(path) {
+    return path.split("/").filter(Boolean).at(-1) ?? "artifact";
+}
+export function deliveryFileContentType(path) {
+    const lower = path.toLowerCase();
+    if (lower.endsWith(".txt"))
+        return "text/plain";
+    if (lower.endsWith(".md") || lower.endsWith(".markdown"))
+        return "text/markdown";
+    if (lower.endsWith(".json"))
+        return "application/json";
+    if (lower.endsWith(".csv"))
+        return "text/csv";
+    if (lower.endsWith(".html"))
+        return "text/html";
+    if (lower.endsWith(".pdf"))
+        return "application/pdf";
+    if (lower.endsWith(".zip"))
+        return "application/zip";
+    if (lower.endsWith(".png"))
+        return "image/png";
+    if (lower.endsWith(".jpg") || lower.endsWith(".jpeg"))
+        return "image/jpeg";
+    if (lower.endsWith(".gif"))
+        return "image/gif";
+    if (lower.endsWith(".svg"))
+        return "image/svg+xml";
+    return "application/octet-stream";
+}
+export function startDeliveryWorkerImpl(host, options) {
+    if (!stateSupportsDeliveryQueue(host.state))
+        return undefined;
+    const runOptions = {};
+    if (options.batchSize !== undefined)
+        runOptions.limit = options.batchSize;
+    if (options.leaseForMs !== undefined)
+        runOptions.leaseForMs = options.leaseForMs;
+    const timer = setInterval(() => {
+        void runDueDeliveriesImpl(host, runOptions).catch((error) => {
+            // Per-delivery failures are recorded on their owning run. This catch
+            // prevents an unexpected adapter-level error from tearing down the loop.
+            host.logger.warn("delivery worker tick failed", { error: errorMessage(error) });
+        });
+    }, options.intervalMs);
+    timer.unref?.();
+    return {
+        stop() {
+            clearInterval(timer);
+        }
+    };
+}
+//# sourceMappingURL=delivery-queue.js.map

package/dist/delivery-queue.js.map

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

package/dist/delivery-send.d.ts

@@ -0,0 +1,44 @@
+import type { AgentManifest, CompiledChannel, JsonObject, SandboxSession } from "@assemblyline-agents/core";
+import type { ChannelContext, ChannelModule, ChannelTurn, ChannelTurnLifecycle } from "./channel.js";
+import type { RuntimeLogger } from "./logging.js";
+import type { BlobAdapter, DeliverySendResult, EmitSpanOptions, RunAgentResult, RuntimeSandboxHandle } from "./runtime-types.js";
+import type { DeliveryObligation, RunRecord, SandboxSyncJobRecord, StateAdapter } from "./state.js";
+/** Narrow slice of the runtime the delivery send path needs. */
+export interface DeliverySendHost {
+    state: StateAdapter;
+    blob: BlobAdapter;
+    logger: RuntimeLogger;
+    env: Record<string, string | undefined>;
+    manifest: AgentManifest;
+    devMode: boolean;
+    deliveryMode: "send" | "record-only";
+    now(): Date;
+    sandboxSyncInline: boolean;
+    deliveryQueueLeaseMs: number;
+    deliveryQueueMaxAttempts: number;
+    sandboxSyncMaxAttempts: number;
+    result(run: RunRecord, response: string, waitingForApproval?: boolean, waitingForInput?: boolean, waitingForConnection?: boolean): Promise<RunAgentResult>;
+    sandboxSessionKey(run: RunRecord): string;
+    debugSwallow(message: string, fields: JsonObject): (error: unknown) => undefined;
+    emitSpan(name: string, startedAt: string, attributes: JsonObject, options?: EmitSpanOptions): Promise<void>;
+    runSpanAttributes(run: RunRecord, extra?: JsonObject): JsonObject;
+    turnSpanId(runId: string): string;
+    captureSandboxSnapshot(run: RunRecord, sandboxSession: SandboxSession, stage: "run_completed" | "delivery_failed" | "delivery_deferred"): Promise<RunRecord>;
+    loadChannelModule(channel: CompiledChannel): Promise<ChannelModule>;
+    channelContext(channel: CompiledChannel): ChannelContext;
+}
+export interface ChannelTurnStart {
+    lifecycle?: ChannelTurnLifecycle;
+    outcome: "skipped" | "unsupported" | "started" | "failed";
+    error?: string;
+    claimed: boolean;
+}
+export declare function completeRunImpl(host: DeliverySendHost, run: RunRecord, sandboxHandle: RuntimeSandboxHandle, response: string, channel: string, turn?: ChannelTurn, conversationId?: string): Promise<RunAgentResult>;
+export declare function latestRunFailureMessageImpl(host: DeliverySendHost, runId: string): Promise<string | undefined>;
+export declare function enqueueSandboxSyncAfterDeliveryImpl(host: DeliverySendHost, run: RunRecord, sandboxSession: SandboxSession): Promise<SandboxSyncJobRecord>;
+export declare function beginChannelTurnImpl(host: DeliverySendHost, channelName: string, turn: ChannelTurn | undefined): Promise<ChannelTurnStart>;
+export declare function recordChannelTurnStartImpl(host: DeliverySendHost, start: ChannelTurnStart, run: RunRecord, channelName: string): Promise<void>;
+export declare function stopUnclaimedChannelTurnImpl(host: DeliverySendHost, start: ChannelTurnStart | undefined, channelName: string): Promise<void>;
+export declare function stopChannelTurnImpl(host: DeliverySendHost, lifecycle: ChannelTurnLifecycle | undefined, run: RunRecord, channelName: string): Promise<void>;
+export declare function sendDeliveryImpl(host: DeliverySendHost, delivery: DeliveryObligation, response: string, turn?: ChannelTurn, run?: RunRecord): Promise<DeliverySendResult>;
+//# sourceMappingURL=delivery-send.d.ts.map

package/dist/delivery-send.d.ts.map

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