@0xmaxma/claude-gateway 1.8.14 → 2.0.1

package/dist/orchestration/tasks/scheduler.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkerScheduler = void 0;
+const failure_1 = require("./failure");
+/** Workers run outside the scheduler's claim transaction and outside agent
+ * turns. All attempts count toward admission, including uncertain processes. */
+class WorkerScheduler {
+    constructor(tasks, driver, reportError = () => { }, recoveredReservations = new Map()) {
+        this.tasks = tasks;
+        this.driver = driver;
+        this.reportError = reportError;
+        /** Sessions whose workers were admitted in this runtime, including recovered queued work. */
+        this.startedSessions = new Set();
+        this.active = new Map();
+        this.starting = new Set();
+        this.ticking = false;
+        this.closed = false;
+        this.pending = new Set();
+        this.uncertainReservations = recoveredReservations;
+    }
+    start() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => { void this.tick().catch(this.reportError); }, 100);
+        this.timer.unref();
+        void this.tick().catch(this.reportError);
+    }
+    async tick() {
+        if (this.closed || this.ticking)
+            return;
+        this.ticking = true;
+        try {
+            this.tasks.pruneWorkers();
+            for (const [taskId, handle] of this.active) {
+                const task = this.tasks.store.task(taskId);
+                if (task && ['cancel_requested', 'interrupting'].includes(task.state))
+                    void handle.stop().catch(this.reportError);
+            }
+            for (const row of this.tasks.store.all("SELECT id FROM tasks WHERE state='cancel_requested'")) {
+                const taskId = String(row.id);
+                if (this.active.has(taskId) || this.starting.has(taskId))
+                    continue;
+                const task = this.tasks.store.task(taskId);
+                const attempt = task.activeAttemptId ? this.tasks.store.attempt(task.activeAttemptId) : undefined;
+                if (!attempt)
+                    continue;
+                let stopped = false;
+                try {
+                    stopped = await this.driver.cleanup?.(attempt) ?? false;
+                }
+                catch (error) {
+                    this.reportError(error);
+                }
+                const current = this.tasks.store.task(taskId);
+                if (current?.state !== 'cancel_requested' || current.activeAttemptId !== attempt.attemptId)
+                    continue;
+                this.tasks.finishCleanup(attempt.attemptId, attempt.generation, stopped);
+                if (stopped) {
+                    this.uncertainReservations.get(taskId)?.();
+                    this.uncertainReservations.delete(taskId);
+                    await this.driver.release?.(taskId).catch(this.reportError);
+                }
+            }
+            if (this.closed)
+                return;
+            const ceiling = Number(this.tasks.store.get('SELECT COALESCE(MAX(rowid),0) n FROM tasks').n);
+            let cursor;
+            admission: while (!this.closed) {
+                const rows = this.tasks.store.all(`SELECT id,created_at FROM tasks WHERE state='queued' AND rowid<=?
+          ${cursor ? 'AND (created_at>? OR (created_at=? AND id>?))' : ''}
+          ORDER BY created_at,id LIMIT 100`, ceiling, ...(cursor ? [cursor.createdAt, cursor.createdAt, cursor.id] : []));
+                if (!rows.length)
+                    break;
+                for (const row of rows) {
+                    cursor = { createdAt: Number(row.created_at), id: String(row.id) };
+                    const taskId = String(row.id);
+                    if (this.starting.has(taskId) || this.active.has(taskId))
+                        continue;
+                    if (this.driver.available && !this.driver.available(taskId))
+                        continue;
+                    const release = this.driver.reserve?.(taskId);
+                    if (this.driver.reserve && !release)
+                        break admission;
+                    const attempt = this.tasks.claim(taskId);
+                    if (!attempt) {
+                        release?.();
+                        continue;
+                    }
+                    this.startedSessions.add(this.tasks.store.task(taskId).agentSessionId);
+                    this.starting.add(taskId);
+                    // Do not await startup here: one slow spawn cannot serialize every task
+                    // or control operation behind it.
+                    const run = this.run(taskId, attempt, release);
+                    this.pending.add(run);
+                    void run.finally(() => this.pending.delete(run)).catch(this.reportError);
+                }
+            }
+        }
+        finally {
+            this.ticking = false;
+        }
+    }
+    async run(taskId, attempt, release) {
+        let handle;
+        try {
+            handle = await this.driver.start(this.tasks.store.task(taskId), attempt, Boolean(release));
+            this.active.set(taskId, handle);
+            if (this.closed)
+                await handle.stop();
+            // Attach rejection handlers before waiting on either branch.
+            const outcome = handle.result.catch(error => ({ type: 'unknown', failure: (0, failure_1.taskFailure)(error) }));
+            try {
+                await handle.accepted;
+                const task = this.tasks.store.task(taskId);
+                if (task.state === 'starting')
+                    this.tasks.started(attempt.attemptId, attempt.generation, handle.identity?.());
+                else
+                    await handle.stop();
+            }
+            catch {
+                await handle.stop();
+            }
+            let result = await outcome;
+            if (this.closed && result.type !== 'completed' && !['cancel_requested', 'interrupting'].includes(this.tasks.store.task(taskId)?.state ?? ''))
+                result = { ...result, failure: (0, failure_1.shutdownFailure)() };
+            this.tasks.finish(attempt.attemptId, attempt.generation, result);
+        }
+        catch (error) {
+            const task = this.tasks.store.task(taskId);
+            if (!handle && error.code === 'RESOURCE_BUSY' && task?.state === 'starting')
+                this.tasks.deferUnstarted(attempt.attemptId, attempt.generation);
+            else if (task?.activeAttemptId === attempt.attemptId && task.state !== 'needs_reconciliation')
+                this.tasks.finish(attempt.attemptId, attempt.generation, { type: handle ? 'unknown' : 'failed', failure: this.closed ? (0, failure_1.shutdownFailure)() : (0, failure_1.taskFailure)(error, 'WORKER_START_FAILED') });
+            this.reportError(error);
+        }
+        finally {
+            await this.driver.release?.(taskId).catch(this.reportError);
+            if (this.tasks.store.task(taskId)?.state !== 'needs_reconciliation')
+                release?.();
+            else if (release)
+                this.uncertainReservations.set(taskId, release);
+            this.active.delete(taskId);
+            this.starting.delete(taskId);
+            if (!this.closed)
+                void this.tick().catch(this.reportError);
+        }
+    }
+    async close() {
+        this.closed = true;
+        if (this.timer)
+            clearInterval(this.timer);
+        // A persisted-process cleanup may be awaiting termination outside a run handle.
+        while (this.ticking)
+            await new Promise(resolve => setTimeout(resolve, 25));
+        await Promise.allSettled([...this.active.values()].map(handle => handle.stop()));
+        await Promise.allSettled([...this.pending]);
+    }
+}
+exports.WorkerScheduler = WorkerScheduler;
+//# sourceMappingURL=scheduler.js.map

package/dist/orchestration/tasks/scheduler.js.map

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

package/dist/orchestration/tasks/service.d.ts

@@ -0,0 +1,114 @@
+import { WorkerPool } from './pool';
+import { OrchestrationStore } from '../store';
+import { OrchestrationConfig } from '../config';
+import { CommandContext, TaskSnapshot, TaskRevision, TaskAttempt, WorkerOutcome, ChangeMode } from '../types';
+export interface SpawnTask {
+    title: string;
+    instructions: string;
+    targetProfile: string;
+    skill?: import('../skills').TaskSkill;
+    contextRefs?: string[];
+    continueTaskId?: string;
+    continuationPolicy?: 'after_success' | 'after_terminal';
+}
+/** Task mutations use short durable transactions; admission probes are read-only. */
+export declare class TaskService {
+    readonly store: OrchestrationStore;
+    private readonly defaultProjectRoot;
+    private config;
+    readonly pool: WorkerPool;
+    constructor(store: OrchestrationStore, config?: OrchestrationConfig, defaultProjectRoot?: string);
+    configure(config?: OrchestrationConfig): void;
+    /** Admission feedback reaches the agent before a doomed task is committed. */
+    validateSpawnProfile(context: CommandContext, targetProfile: string): Promise<void>;
+    private command;
+    private owned;
+    status(conversationId: string, principalId: string, taskId?: string): TaskSnapshot[];
+    /** Current reports are lossless. Other tasks are an index, never partial reports. */
+    context(conversationId: string, principalId: string, decisionId: string): (TaskSnapshot | {
+        taskId: string;
+        title: string;
+        state: import("../types").TaskState;
+        stateVersion: number;
+        revision: number;
+        appliedRevision: number;
+        createdAt: number;
+        updatedAt: number;
+        workflow: import("../workflow").TaskWorkflow | undefined;
+        latestProgress: {
+            text: string;
+            observedAt: number;
+            source: "worker" | "runtime";
+        } | undefined;
+        execution: import("../execution-observation").ExecutionObservation | undefined;
+        pendingQuestion: {
+            questionId: string;
+            text: string;
+            revision: number;
+        } | undefined;
+        failure: import("../types").TaskFailure | undefined;
+        cancellation: {
+            requestedBy: "user" | "agent";
+            requestedAt: number;
+        } | undefined;
+        replacedByTaskId: string | undefined;
+        workstreamId: string | undefined;
+        continueTaskId: string | undefined;
+        continuationPolicy: "after_success" | "after_terminal" | undefined;
+        resultAvailable: boolean;
+        details: {
+            tool: string;
+            task_id: string;
+        };
+    })[];
+    private withRecentTools;
+    spawn(context: CommandContext, command: SpawnTask): TaskSnapshot;
+    update(context: CommandContext, taskId: string, expectedRevision: number, instruction: string, mode: ChangeMode): TaskSnapshot;
+    cancel(context: CommandContext, taskId: string, replacedByTaskId?: string): TaskSnapshot;
+    /** Authenticated user control bypasses inference, but retains conversation ownership and task fencing. */
+    cancelByUser(conversationId: string, principalId: string, taskId: string): TaskSnapshot;
+    private cancelOwned;
+    /** Scheduler-only cleanup acknowledgment; never authorizes new worker writes. */
+    finishCleanup(attemptId: string, generation: number, stopped: boolean): void;
+    answer(context: CommandContext, taskId: string, questionId: string, answer: string): TaskSnapshot;
+    /** A scoped authenticated reply is user authorization, without a fabricated model decision. */
+    answerByUser(conversationId: string, principalId: string, taskId: string, questionId: string, answer: string, acceptedInputId?: string): TaskSnapshot;
+    private handleAnswerInput;
+    private assertQuestion;
+    private answerOwned;
+    revision(taskId: string, revision: number): TaskRevision;
+    pruneWorkers(): void;
+    claim(taskId: string): TaskAttempt | undefined;
+    private failDependency;
+    private active;
+    started(attemptId: string, generation: number, identity?: TaskAttempt['processIdentity']): TaskSnapshot;
+    private workerReceipt;
+    private saveWorkerReceipt;
+    /** Diagnostic snapshots do not change task state/version or refresh Updated
+     * merely because a polling timer ran. Late observations are attempt-fenced. */
+    observeExecution(attemptId: string, generation: number, observation: import('../execution-observation').ExecutionObservation): void;
+    private supervise;
+    /** Called at native CLI tool boundaries. No commands, raw tool results or secrets are persisted. */
+    checkpoint(attemptId: string, generation: number, args: Record<string, unknown>): {
+        revision?: number;
+        directive?: string;
+        directiveKind?: 'advice' | 'assignment';
+        feedback?: TaskSnapshot['supervision'];
+    };
+    observeToolBoundary(attemptId: string, generation: number, activeTools: string[]): void;
+    private readonly repeatedTools;
+    observeToolResult(attemptId: string, generation: number, signature: string, eventId: string): void;
+    progress(attemptId: string, generation: number, text: string, actionId?: string, checkpoint?: unknown): {
+        accepted: true;
+        workflowWarning?: string;
+    };
+    requestInput(attemptId: string, generation: number, question: string, actionId?: string): TaskSnapshot;
+    /** Driver terminal/exit acknowledgment, never a model's unverified "done". */
+    finish(attemptId: string, generation: number, outcome: WorkerOutcome): TaskSnapshot;
+    private notify;
+    /** Offline operator workflow only; not exposed through conversation tools.
+     * Caller holds the instance lock and has checked liveness/side effects. */
+    reconcile(taskId: string, state: 'queued' | 'failed' | 'cancelled', evidence: string): TaskSnapshot;
+    deferUnstarted(attemptId: string, generation: number): void;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/orchestration/tasks/service.d.ts.map

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