@0xmaxma/claude-gateway 1.8.13 → 2.0.0

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

@@ -0,0 +1,109 @@
+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;
+    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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"}