agent-conveyor 0.1.0

package/dist/runtime/commands.js

@@ -0,0 +1,408 @@
+import { randomUUID } from "node:crypto";
+import { validateRequiredPermission as validateManagerRequiredPermission } from "./manager-permissions.js";
+export class CommandQueueError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "CommandQueueError";
+    }
+}
+export function claimableDispatchCommandsSync(database, options) {
+    if (options.commandTypes.length === 0) {
+        throw new CommandQueueError("command_types must not be empty");
+    }
+    const timestamp = options.now ?? new Date().toISOString();
+    const placeholders = options.commandTypes.map(() => "?").join(", ");
+    const rows = database.prepare(`
+    select id, idempotency_key, created_at, updated_at, task_id, worker_id,
+           manager_id, correlation_id, type, state, available_at, claimed_by,
+           claimed_at, claim_expires_at, attempts, max_attempts, payload_json,
+           required_permission, result_json, error
+    from commands
+    where state = 'pending'
+      and type in (${placeholders})
+      and (available_at is null or available_at <= ?)
+      and attempts < max_attempts
+    order by created_at, id
+    limit ?
+  `).all(...options.commandTypes, timestamp, Math.max(1, options.limit ?? 10));
+    return rows.map(commandRecord);
+}
+export function createCommandSync(database, options) {
+    const requiredPermission = validateRequiredPermission(options.requiredPermission ?? null);
+    const commandId = options.commandId ?? `command-${randomUUID()}`;
+    const correlationId = options.correlationId ?? `dispatch-${randomUUID()}`;
+    const timestamp = options.now ?? new Date().toISOString();
+    const idempotencyKey = options.idempotencyKey ?? commandId;
+    database.prepare(`
+    insert into commands(
+      id, idempotency_key, created_at, updated_at, task_id, worker_id,
+      manager_id, correlation_id, type, state, available_at, max_attempts,
+      required_permission, payload_json
+    )
+    values (?, ?, ?, ?, ?, ?, ?, ?, ?, 'pending', ?, ?, ?, ?)
+  `).run(commandId, idempotencyKey, timestamp, timestamp, options.taskId ?? null, options.workerId ?? null, options.managerId ?? null, correlationId, options.commandType, options.availableAt ?? null, options.maxAttempts ?? 1, requiredPermission, stableJson(options.payload));
+    emitTelemetry(database, {
+        actor: "workerctl",
+        attributes: {
+            idempotency_key: idempotencyKey,
+            manager_id: options.managerId ?? null,
+            required_permission: requiredPermission,
+            state: "pending",
+            worker_id: options.workerId ?? null,
+        },
+        correlation: {
+            command_id: commandId,
+            command_type: options.commandType,
+            correlation_id: correlationId,
+        },
+        eventType: "command_created",
+        severity: "info",
+        summary: `Created command ${options.commandType}.`,
+        taskId: options.taskId ?? null,
+        timestamp,
+    });
+    return commandId;
+}
+export function recoverStaleDispatchClaimsSync(database, options) {
+    if (options.commandTypes.length === 0) {
+        throw new CommandQueueError("command_types must not be empty");
+    }
+    const timestamp = options.now ?? new Date().toISOString();
+    const placeholders = options.commandTypes.map(() => "?").join(", ");
+    const commands = database.prepare(`
+    select id, task_id, type, correlation_id, attempts, max_attempts
+    from commands
+    where state = 'attempted'
+      and type in (${placeholders})
+      and claim_expires_at is not null
+      and claim_expires_at <= ?
+    order by claim_expires_at, created_at, id
+    limit ?
+  `).all(...options.commandTypes, timestamp, Math.max(1, options.limit ?? 10));
+    const recovered = [];
+    for (const command of commands) {
+        const attempt = database.prepare(`
+      select id, side_effect_started
+      from command_attempts
+      where command_id = ? and state = 'running'
+      order by id desc
+      limit 1
+    `).get(command.id);
+        const sideEffectStarted = Boolean(attempt?.side_effect_started);
+        let error;
+        let eventType;
+        let state;
+        if (sideEffectStarted) {
+            error = "stale dispatch claim expired after side effect started; manual review required";
+            if (attempt) {
+                database.prepare(`
+          update command_attempts
+          set state = 'failed', finished_at = ?, error = ?
+          where id = ?
+        `).run(timestamp, error, attempt.id);
+            }
+            database.prepare(`
+        update commands
+        set state = 'failed', updated_at = ?, error = ?,
+            claimed_by = null, claimed_at = null, claim_expires_at = null
+        where id = ?
+      `).run(timestamp, error, command.id);
+            state = "failed";
+            eventType = "dispatch_command_failed";
+        }
+        else {
+            error = "stale dispatch claim abandoned before side effect started";
+            const nextState = command.attempts < command.max_attempts ? "pending" : "failed";
+            if (attempt) {
+                database.prepare(`
+          update command_attempts
+          set state = 'abandoned', finished_at = ?, error = ?
+          where id = ?
+        `).run(timestamp, error, attempt.id);
+            }
+            database.prepare(`
+        update commands
+        set state = ?, updated_at = ?, error = ?,
+            claimed_by = null, claimed_at = null, claim_expires_at = null
+        where id = ?
+      `).run(nextState, timestamp, nextState === "pending" ? null : error, command.id);
+            state = nextState === "pending" ? "requeued" : "failed";
+            eventType = "dispatch_command_abandoned";
+        }
+        emitTelemetry(database, {
+            actor: "dispatch",
+            attributes: {
+                recovery_state: state,
+                side_effect_started: sideEffectStarted,
+            },
+            correlation: {
+                attempt_id: attempt?.id ?? null,
+                command_id: command.id,
+                command_type: command.type,
+                correlation_id: command.correlation_id,
+                dispatcher_id: options.dispatcherId,
+            },
+            eventType,
+            severity: state === "failed" ? "error" : "warning",
+            summary: `Recovered stale dispatch claim for ${command.type}.`,
+            taskId: command.task_id,
+            timestamp,
+        });
+        recovered.push({
+            attempt_id: attempt?.id ?? null,
+            command_id: command.id,
+            command_type: command.type,
+            error,
+            side_effect_started: sideEffectStarted,
+            state,
+        });
+    }
+    return recovered;
+}
+export function claimNextDispatchCommandSync(database, options) {
+    if (options.commandTypes.length === 0) {
+        throw new CommandQueueError("command_types must not be empty");
+    }
+    const timestamp = options.now ?? new Date().toISOString();
+    const claimExpiresAt = isoAfter(timestamp, Math.max(1, options.leaseSeconds ?? 60));
+    const correlationId = `dispatch-${randomUUID()}`;
+    const placeholders = options.commandTypes.map(() => "?").join(", ");
+    const row = database.prepare(`
+    update commands
+    set state = 'attempted',
+        updated_at = ?,
+        correlation_id = coalesce(correlation_id, ?),
+        claimed_by = ?,
+        claimed_at = ?,
+        claim_expires_at = ?,
+        attempts = attempts + 1
+    where id = (
+      select id
+      from commands
+      where state = 'pending'
+        and type in (${placeholders})
+        and (available_at is null or available_at <= ?)
+        and attempts < max_attempts
+      order by created_at, id
+      limit 1
+    )
+      and state = 'pending'
+    returning id, idempotency_key, created_at, updated_at, task_id, worker_id,
+              manager_id, correlation_id, type, state, available_at, claimed_by,
+              claimed_at, claim_expires_at, attempts, max_attempts, payload_json,
+              required_permission, result_json, error
+  `).get(timestamp, correlationId, options.dispatcherId, timestamp, claimExpiresAt, ...options.commandTypes, timestamp);
+    if (!row) {
+        return null;
+    }
+    const attemptResult = database.prepare(`
+    insert into command_attempts(
+      command_id, correlation_id, dispatcher_id, started_at, state
+    )
+    values (?, ?, ?, ?, 'running')
+  `).run(row.id, row.correlation_id, options.dispatcherId, timestamp);
+    const attemptId = Number(attemptResult.lastInsertRowid);
+    emitTelemetry(database, {
+        actor: "dispatch",
+        attributes: {
+            attempts: row.attempts,
+            claim_expires_at: row.claim_expires_at,
+            manager_id: row.manager_id,
+            worker_id: row.worker_id,
+        },
+        correlation: {
+            attempt_id: attemptId,
+            command_id: row.id,
+            command_type: row.type,
+            correlation_id: row.correlation_id,
+            dispatcher_id: options.dispatcherId,
+        },
+        eventType: "dispatch_command_claimed",
+        severity: "info",
+        summary: `Dispatch claimed command ${row.type}.`,
+        taskId: row.task_id,
+        timestamp,
+    });
+    return {
+        attempt: {
+            command_id: row.id,
+            correlation_id: row.correlation_id ?? "",
+            dispatcher_id: options.dispatcherId,
+            error: null,
+            finished_at: null,
+            id: attemptId,
+            result: null,
+            side_effect_completed: false,
+            side_effect_started: false,
+            started_at: timestamp,
+            state: "running",
+        },
+        command: commandRecord(row),
+    };
+}
+export function finishCommandAttemptSync(database, options) {
+    const timestamp = options.now ?? new Date().toISOString();
+    const resultJson = options.result === undefined || options.result === null ? null : stableJson(options.result);
+    const update = database.prepare(`
+    update command_attempts
+    set state = ?, finished_at = ?, result_json = ?, error = ?,
+        side_effect_started = ?, side_effect_completed = ?
+    where id = ? and state = 'running'
+  `).run(options.state, timestamp, resultJson, options.error ?? null, options.sideEffectStarted ? 1 : 0, options.sideEffectCompleted ? 1 : 0, options.attemptId);
+    if (update.changes !== 1) {
+        const existing = database.prepare("select state from command_attempts where id = ?").get(options.attemptId);
+        if (!existing) {
+            throw new CommandQueueError(`Unknown command attempt: ${options.attemptId}`);
+        }
+        throw new CommandQueueError(`Command attempt ${options.attemptId} is not running (state: ${existing.state})`);
+    }
+    const attempt = database.prepare(`
+    select command_attempts.id, command_attempts.command_id,
+           command_attempts.correlation_id, command_attempts.dispatcher_id,
+           command_attempts.started_at, command_attempts.finished_at,
+           command_attempts.state, command_attempts.result_json,
+           command_attempts.error, command_attempts.side_effect_started,
+           command_attempts.side_effect_completed,
+           commands.task_id, commands.worker_id, commands.manager_id,
+           commands.type as command_type
+    from command_attempts
+    join commands on commands.id = command_attempts.command_id
+    where command_attempts.id = ?
+  `).get(options.attemptId);
+    if (!attempt) {
+        throw new CommandQueueError(`Unknown command attempt: ${options.attemptId}`);
+    }
+    const commandState = options.state === "succeeded" ? "succeeded" : options.state === "blocked" ? "blocked" : "failed";
+    database.prepare(`
+    update commands
+    set state = ?, updated_at = ?, result_json = ?, error = ?
+    where id = ?
+  `).run(commandState, timestamp, resultJson, options.error ?? null, attempt.command_id);
+    const finishEventType = {
+        abandoned: "dispatch_command_abandoned",
+        blocked: "dispatch_command_blocked",
+        failed: "dispatch_command_failed",
+        succeeded: "dispatch_command_succeeded",
+    };
+    const finishSeverity = {
+        abandoned: "warning",
+        blocked: "warning",
+        failed: "error",
+        succeeded: "info",
+    };
+    emitTelemetry(database, {
+        actor: "dispatch",
+        attributes: {
+            error: options.error ?? null,
+            manager_id: attempt.manager_id,
+            result: options.result ?? {},
+            side_effect_completed: options.sideEffectCompleted ?? false,
+            side_effect_started: options.sideEffectStarted ?? false,
+            worker_id: attempt.worker_id,
+        },
+        correlation: {
+            attempt_id: options.attemptId,
+            command_id: attempt.command_id,
+            command_type: attempt.command_type,
+            correlation_id: attempt.correlation_id,
+            dispatcher_id: attempt.dispatcher_id,
+        },
+        eventType: finishEventType[options.state],
+        severity: finishSeverity[options.state],
+        summary: `Dispatch command ${attempt.command_type} ${options.state}.`,
+        taskId: attempt.task_id,
+        timestamp,
+    });
+    return commandAttemptRecord(attempt);
+}
+export function markCommandAttemptSideEffectStartedSync(database, attemptId) {
+    database.prepare(`
+    update command_attempts
+    set side_effect_started = 1
+    where id = ? and state = 'running'
+  `).run(attemptId);
+}
+function commandRecord(row) {
+    return {
+        attempts: row.attempts,
+        available_at: row.available_at,
+        claim_expires_at: row.claim_expires_at,
+        claimed_at: row.claimed_at,
+        claimed_by: row.claimed_by,
+        correlation_id: row.correlation_id,
+        created_at: row.created_at,
+        error: row.error,
+        id: row.id,
+        idempotency_key: row.idempotency_key,
+        manager_id: row.manager_id,
+        max_attempts: row.max_attempts,
+        payload: JSON.parse(row.payload_json),
+        required_permission: row.required_permission,
+        result: row.result_json ? JSON.parse(row.result_json) : null,
+        state: row.state,
+        task_id: row.task_id,
+        type: row.type,
+        updated_at: row.updated_at,
+        worker_id: row.worker_id,
+    };
+}
+function commandAttemptRecord(row) {
+    return {
+        command_id: row.command_id,
+        correlation_id: row.correlation_id,
+        dispatcher_id: row.dispatcher_id,
+        error: row.error,
+        finished_at: row.finished_at,
+        id: row.id,
+        result: row.result_json ? JSON.parse(row.result_json) : null,
+        side_effect_completed: Boolean(row.side_effect_completed),
+        side_effect_started: Boolean(row.side_effect_started),
+        started_at: row.started_at,
+        state: row.state,
+    };
+}
+function validateRequiredPermission(requiredPermission) {
+    try {
+        return validateManagerRequiredPermission(requiredPermission);
+    }
+    catch (error) {
+        throw new CommandQueueError(error instanceof Error ? error.message : String(error));
+    }
+}
+function emitTelemetry(database, options) {
+    const eventId = `telemetry-${randomUUID()}`;
+    const attributesJson = stableJson(options.attributes);
+    database.prepare(`
+    insert into telemetry_events(
+      id, run_id, task_id, timestamp, actor, event_type, severity,
+      summary, correlation_json, attributes_json
+    )
+    values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(eventId, null, options.taskId, options.timestamp, options.actor, options.eventType, options.severity, options.summary, stableJson(options.correlation), attributesJson);
+    database.prepare(`
+    insert into telemetry_events_fts(
+      event_id, task_id, run_id, actor, event_type, summary, attributes
+    )
+    values (?, ?, ?, ?, ?, ?, ?)
+  `).run(eventId, options.taskId, null, options.actor, options.eventType, options.summary, attributesJson);
+}
+function isoAfter(value, seconds) {
+    const date = new Date(value);
+    date.setUTCSeconds(date.getUTCSeconds() + seconds);
+    return date.toISOString().replace(/\.\d{3}Z$/, "Z");
+}
+function stableJson(value) {
+    return JSON.stringify(sortJson(value));
+}
+function sortJson(value) {
+    if (Array.isArray(value)) {
+        return value.map(sortJson);
+    }
+    if (value !== null && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, child]) => [key, sortJson(child)]));
+    }
+    return value;
+}
+//# sourceMappingURL=commands.js.map

package/dist/runtime/commands.js.map

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

package/dist/runtime/dispatch.d.ts

@@ -0,0 +1,74 @@
+import { DatabaseSync } from "node:sqlite";
+import type { ClaimedCommand, CommandRecord } from "./commands.js";
+import type { RoutedNotificationDeliveryMode } from "./notifications.js";
+import type { SendTextResult, TmuxRunner } from "./tmux.js";
+export interface DispatchPermissionCheck {
+    allowed: boolean;
+    configured: boolean;
+    required_permission: string;
+}
+export interface DispatchCommandRoute {
+    binding_id: string;
+    created_at: string;
+    manager_session_id: string;
+    manager_session_name: string;
+    signal_type: string;
+    source_session_id: string;
+    source_session_name: string;
+    state: string;
+    target_session_id: string;
+    target_session_name: string;
+    task_id: string;
+    worker_session_id: string;
+    worker_session_name: string;
+}
+export interface DispatchCommandResult {
+    attempt_id: number;
+    cleanup_policy?: string | null;
+    command_id: string;
+    command_type: string;
+    correlation_id: string | null;
+    current_iteration?: number;
+    delivered?: boolean;
+    delivery_mode?: RoutedNotificationDeliveryMode;
+    dispatcher_id: string;
+    dry_run: boolean;
+    error?: string;
+    loop_policy?: Record<string, unknown>;
+    manager_decision_id?: number | null;
+    max_iterations?: number;
+    missing_evidence?: string[];
+    notification_id?: number | null;
+    permission_check?: DispatchPermissionCheck | null;
+    reason?: string | null;
+    requested_iteration?: number;
+    required_before_continue?: string[];
+    run_id?: string;
+    seed_prompt_sha256?: string | null;
+    send_result?: SendTextResult;
+    side_effect_completed?: boolean;
+    side_effect_started?: boolean;
+    state: "blocked" | "delivered" | "failed" | "planned" | "pull_required";
+    stop_conditions?: string[];
+    target_session?: string;
+    target_worker_notified?: boolean;
+}
+export declare class DispatchPermissionError extends Error {
+    constructor(message: string);
+}
+export declare class DispatchRoutingError extends Error {
+    constructor(message: string);
+}
+export declare function resolveDispatchCommandRouteSync(database: DatabaseSync, command: CommandRecord): DispatchCommandRoute;
+export declare function executeDispatchCommandSync(database: DatabaseSync, options: {
+    claimed: ClaimedCommand;
+    dispatcherId: string;
+    dryRun?: boolean;
+    now?: string;
+    sleep?: (milliseconds: number) => void;
+    tmuxRunner?: TmuxRunner;
+}): DispatchCommandResult;
+export declare function checkDispatchRequiredPermissionSync(database: DatabaseSync, options: {
+    command: CommandRecord;
+    now?: string;
+}): DispatchPermissionCheck | null;