oh-my-super-agent 0.1.0

package/dist/src/conductor/recovery.js

@@ -0,0 +1,198 @@
+import { createHash } from "node:crypto";
+import { assertConductorActivityStore, } from "./activity.js";
+import { assertConductorNotificationStore, } from "./notifications.js";
+import { assertConductorWaiterStore, } from "./waiter.js";
+import { canonicalTimestamp } from "../queue/model.js";
+import { acquireDirectoryLock } from "../runtime/lock.js";
+import { linuxProcessIdentityIsLive, } from "../runtime/process-identity.js";
+import { errorMessage, validateExistingDirectory } from "../utils/fs.js";
+const INCOMPLETE_WAKE_GRACE_MS = 60_000;
+export function recoverConductorNotification(options) {
+    assertConductorActivityStore(options.activity);
+    assertConductorNotificationStore(options.notifications);
+    assertConductorWaiterStore(options.waiters);
+    const at = canonicalTimestamp(options.at, "conductor recovery timestamp");
+    const locksRoot = validateExistingDirectory(options.locksRoot, "conductor recovery locks root");
+    const processIsLive = options.processIsLive ?? linuxProcessIdentityIsLive;
+    const lock = acquireDirectoryLock({
+        locksRoot,
+        lockId: "conductor-recovery",
+        ownerId: "oms-watchdog",
+        note: at,
+    });
+    try {
+        const pending = options.notifications.pending();
+        if (pending.length === 0)
+            return result("empty", null, null, null);
+        let liveWaiter;
+        for (const waiter of options.waiters.list().filter((record) => record.state === "armed")) {
+            if (processIsLive(waiter.payload.waiter_process) && processIsLive(waiter.payload.conductor_process)) {
+                if (liveWaiter)
+                    return result("failed", pending[0].record_id, null, "multiple-live-waiters");
+                liveWaiter = waiter;
+                continue;
+            }
+            options.waiters.supersedeDead({
+                waiterId: waiter.record_id,
+                expectedVersion: waiter.version,
+                observedAt: at,
+                reasonCode: "dead-waiter-binding",
+            });
+        }
+        if (liveWaiter)
+            return result("waiting", pending[0].record_id, liveWaiter.record_id, null);
+        const notification = pending[0];
+        const deliveredSession = notification.state === "delivered"
+            ? notification.payload.delivered_to_session_id
+            : null;
+        if (deliveredSession) {
+            const liveNotified = options.waiters.list(deliveredSession).filter((waiter) => (waiter.state === "notified"
+                && waiter.payload.notification_id === notification.record_id
+                && processIsLive(waiter.payload.waiter_process)
+                && processIsLive(waiter.payload.conductor_process)));
+            if (liveNotified.length > 1) {
+                return result("failed", notification.record_id, null, "multiple-live-notified-waiters");
+            }
+            if (liveNotified[0]) {
+                return result("waiting", notification.record_id, liveNotified[0].record_id, null);
+            }
+        }
+        const notificationDigest = sha256(notification.record_id);
+        const activityBeforeRecovery = [...options.activity.list()]
+            .filter((record) => deliveredSession
+            ? record.payload.conductor_session_id === deliveredSession
+            : record.payload.last_source_sha256 === notificationDigest)
+            .sort((left, right) => right.payload.launch_generation - left.payload.launch_generation)[0];
+        const exactWakeActivity = activityBeforeRecovery?.state === "working"
+            && activityBeforeRecovery.payload.last_hook_event === "NotificationWake"
+            && activityBeforeRecovery.payload.last_source_sha256 === notificationDigest;
+        const incompleteWake = exactWakeActivity
+            && activityBeforeRecovery !== undefined
+            && Date.parse(at) - Date.parse(activityBeforeRecovery.payload.updated_at) >= INCOMPLETE_WAKE_GRACE_MS;
+        if (notification.state === "delivered") {
+            if (!deliveredSession)
+                return result("failed", notification.record_id, null, "notification-delivery-owner-missing");
+            if (activityBeforeRecovery?.state === "working" && !incompleteWake) {
+                return result("deferred", notification.record_id, null, "conductor-working");
+            }
+            if (activityBeforeRecovery?.state === "done"
+                || (activityBeforeRecovery?.state === "blocked" && !retryableFailedWake(activityBeforeRecovery))) {
+                return result("failed", notification.record_id, null, `conductor-${activityBeforeRecovery.state}`);
+            }
+            options.notifications.releaseDelivery({
+                notificationId: notification.record_id,
+                sessionId: deliveredSession,
+            });
+        }
+        if (incompleteWake && activityBeforeRecovery) {
+            options.activity.observe({
+                conductorSessionId: activityBeforeRecovery.payload.conductor_session_id,
+                launchGeneration: activityBeforeRecovery.payload.launch_generation,
+                paneId: activityBeforeRecovery.payload.pane_id,
+                conductorProcess: activityBeforeRecovery.payload.conductor_process,
+                providerVersion: "2.1.207",
+                hookEvent: "WatchdogFailure",
+                sourceSha256: sha256(`${notification.record_id}:incomplete-wake`),
+                observedAt: at,
+            });
+        }
+        let ensured;
+        try {
+            ensured = options.ensureConductor();
+        }
+        catch (error) {
+            const reason = boundedReason(error);
+            const latestDead = [...options.activity.list()]
+                .filter((record) => !processIsLive(record.payload.conductor_process))
+                .sort((left, right) => right.payload.launch_generation - left.payload.launch_generation)[0];
+            if (latestDead && (latestDead.state === "idle" || latestDead.state === "working")) {
+                options.activity.observe({
+                    conductorSessionId: latestDead.payload.conductor_session_id,
+                    launchGeneration: latestDead.payload.launch_generation,
+                    paneId: latestDead.payload.pane_id,
+                    conductorProcess: latestDead.payload.conductor_process,
+                    providerVersion: "2.1.207",
+                    hookEvent: "WatchdogFailure",
+                    sourceSha256: sha256(`${pending[0].record_id}:${reason}`),
+                    observedAt: at,
+                });
+            }
+            return result("failed", pending[0].record_id, null, reason);
+        }
+        if (ensured.action === "created") {
+            return result("failed", pending[0].record_id, null, "human-start-required");
+        }
+        if (ensured.action === "resumed") {
+            return result("resumed", pending[0].record_id, null, `conductor-${ensured.action}`);
+        }
+        if (!processIsLive(ensured.binding.conductor_process)) {
+            return result("failed", pending[0].record_id, null, "conductor-process-dead");
+        }
+        const activity = options.activity.readIfExists(ensured.binding.session_id, ensured.binding.launch_generation);
+        if (!activity)
+            return result("deferred", pending[0].record_id, null, "session-start-pending");
+        if (activity.payload.pane_id !== ensured.binding.pane_id
+            || !sameProcess(activity.payload.conductor_process, ensured.binding.conductor_process))
+            return result("failed", pending[0].record_id, null, "conductor-binding-changed");
+        if (activity.state === "working")
+            return result("deferred", pending[0].record_id, null, "conductor-working");
+        if (activity.state !== "idle" && !retryableFailedWake(activity)) {
+            return result("failed", pending[0].record_id, null, `conductor-${activity.state}`);
+        }
+        const claimed = options.notifications.claimNext({ sessionId: ensured.binding.session_id, observedAt: at });
+        if (!claimed.record)
+            return result("deferred", pending[0].record_id, null, "notification-owned-by-another-session");
+        options.activity.observe({
+            conductorSessionId: ensured.binding.session_id,
+            launchGeneration: ensured.binding.launch_generation,
+            paneId: ensured.binding.pane_id,
+            conductorProcess: ensured.binding.conductor_process,
+            providerVersion: "2.1.207",
+            hookEvent: "NotificationWake",
+            sourceSha256: sha256(claimed.record.record_id),
+            observedAt: at,
+        });
+        try {
+            options.wakeConductor(ensured.binding, claimed.record.record_id);
+        }
+        catch (error) {
+            options.notifications.releaseDelivery({
+                notificationId: claimed.record.record_id,
+                sessionId: ensured.binding.session_id,
+            });
+            options.activity.observe({
+                conductorSessionId: ensured.binding.session_id,
+                launchGeneration: ensured.binding.launch_generation,
+                paneId: ensured.binding.pane_id,
+                conductorProcess: ensured.binding.conductor_process,
+                providerVersion: "2.1.207",
+                hookEvent: "WatchdogFailure",
+                sourceSha256: sha256(`${claimed.record.record_id}:${boundedReason(error)}`),
+                observedAt: at,
+            });
+            return result("failed", claimed.record.record_id, null, "conductor-wake-failed");
+        }
+        return result("notified", claimed.record.record_id, null, null);
+    }
+    finally {
+        lock.release();
+    }
+}
+function result(status, notificationId, waiterId, reason) {
+    return Object.freeze({ status, notification_id: notificationId, waiter_id: waiterId, reason });
+}
+function boundedReason(error) {
+    return errorMessage(error).trim().replace(/[\0\r\n]+/gu, " ").slice(0, 128) || "conductor-recovery-failed";
+}
+function sameProcess(left, right) {
+    return left.process_id === right.process_id && left.boot_id === right.boot_id && left.start_ticks === right.start_ticks;
+}
+function retryableFailedWake(activity) {
+    return activity.state === "blocked"
+        && activity.payload.health === "stalled"
+        && activity.payload.last_hook_event === "WatchdogFailure";
+}
+function sha256(value) {
+    return createHash("sha256").update(value, "utf8").digest("hex");
+}
+//# sourceMappingURL=recovery.js.map

package/dist/src/conductor/recovery.js.map

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

package/dist/src/conductor/start.d.ts

@@ -0,0 +1,73 @@
+import { type LiveDeliveryAuthorization, type PreDispatchAdviceAuthorization } from "../live/contact-journal.js";
+import { type ProcessResult, type ProcessRunner } from "../providers/process.js";
+import { type LinuxProcessIdentity } from "../runtime/process-identity.js";
+declare const TMUX_SESSION = "oms";
+export interface InteractiveProcessRequest {
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly cwd: string;
+    readonly env: NodeJS.ProcessEnv;
+}
+export type InteractiveProcessRunner = (request: InteractiveProcessRequest) => ProcessResult;
+export interface ConductorStartResult {
+    readonly action: "created" | "resumed" | "attached";
+    readonly tmux_session: typeof TMUX_SESSION;
+    readonly pane_id: string;
+    readonly claude_session_id: string;
+    readonly claude_version: string;
+    readonly live_delivery_authorization: LiveDeliveryAuthorization | null;
+    readonly pre_dispatch_advice_authorization: PreDispatchAdviceAuthorization | null;
+}
+export interface ConductorBridgeSessionBinding {
+    readonly session_id: string;
+    readonly actor_id: "oms-conductor";
+    readonly pane_id: string;
+    readonly launch_generation: number;
+}
+export interface ConductorRuntimeBinding extends ConductorBridgeSessionBinding {
+    readonly process_id: number;
+}
+export declare function requireStoredConductorAuthorization(stateRoot: string, workspaceRoot: string): {
+    readonly liveDeliveryAuthorization: LiveDeliveryAuthorization;
+    readonly preDispatchAdviceAuthorization: PreDispatchAdviceAuthorization;
+};
+export declare function startConductor(options: {
+    readonly packageRoot: string;
+    readonly configRoot: string;
+    readonly workspaceRoot: string;
+    readonly stateRoot: string;
+    readonly executablePath: string;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly processRunner?: ProcessRunner;
+    readonly interactiveRunner?: InteractiveProcessRunner;
+    readonly now?: () => string;
+    readonly sessionIdFactory?: () => string;
+    readonly attach?: boolean;
+    readonly resumeOnly?: boolean;
+    readonly liveDeliveryRepository?: string;
+    readonly confirmLiveDelivery?: boolean;
+}): ConductorStartResult;
+export declare function assertConductorBridgeSession(options: {
+    readonly workspaceRoot: string;
+    readonly stateRoot: string;
+    readonly sessionId: string;
+}): ConductorBridgeSessionBinding;
+export declare function inspectConductorRuntimeBinding(options: {
+    readonly workspaceRoot: string;
+    readonly stateRoot: string;
+    readonly sessionId: string;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly processRunner?: ProcessRunner;
+}): ConductorRuntimeBinding;
+export declare function wakeConductorWithNotification(options: {
+    readonly workspaceRoot: string;
+    readonly stateRoot: string;
+    readonly sessionId: string;
+    readonly launchGeneration: number;
+    readonly paneId: string;
+    readonly conductorProcess: LinuxProcessIdentity;
+    readonly notificationId: string;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly processRunner?: ProcessRunner;
+}): void;
+export {};