@sema-agent/core 1.451.0 → 2.0.0

package/dist/core/task-registry.d.ts

@@ -1,113 +1,19 @@
 import type { AgentTool, ExecutionEnv } from "../internal/harness.js";
 import type { ToolEffect } from "./types.js";
 import { type BackgroundShellCapability, type BackgroundShellId } from "./background-shell.js";
-import { type WorkflowRunStore } from "./workflow-run-store.js";
-import { type BackgroundAgentRecord, type BackgroundAgentStore } from "./background-agent-store.js";
-import type { WorkflowHandle, WorkflowRun } from "../orchestration/workflow.js";
+import type { WorkflowRunStore } from "./workflow-run-store.js";
+import { type BackgroundAgentStore } from "./background-agent-store.js";
 import type { TaskNotificationPayload } from "./task-notification.js";
-export type SemaTaskType = "background_bash" | "workflow" | "background_agent" | "monitor";
-export type StopSource = "user" | "parent" | "system" | (string & {});
-export type SemaTaskStatus = "pending" | "running" | "parked" | "completed" | "failed" | "killed" | "cancelled";
-export interface ParkedClaimTicket {
-    handle: string;
-    scope: string;
-    token: string;
-    claimId: string;
-    reservedRev: number;
-    row: import("./background-agent-store.js").BackgroundAgentRecord;
-}
-export type TaskRetrievalStatus = "success" | "not_ready" | "timeout";
-export interface UnifiedTaskOutput {
-    task_id: string;
-    type?: SemaTaskType | "unknown";
-    status?: SemaTaskStatus | string;
-    retrieval_status: TaskRetrievalStatus;
-    content?: string;
-    error?: string;
-    stoppedBy?: StopSource;
-    seq?: number;
-    partial_result?: boolean;
-    details?: unknown;
-}
-export interface SemaTaskHandle {
-    id: string;
-    type: SemaTaskType;
-    status: SemaTaskStatus;
-    description?: string;
-    owner?: string;
-    scope?: string;
-    toolUseId?: string;
-    createdAt: number;
-    updatedAt: number;
-    outputFile?: string;
-    outputOffset?: number;
-}
+import { type SemaTaskType, type StopSource, type SemaTaskStatus, type TaskRetrievalStatus, type UnifiedTaskOutput, type UnifiedTaskResult, type SemaTaskHandle, type TaskAccess, type BackgroundAgentTaskHandle, type MonitorTimers, type RegisterMonitorInput, type RegisterWorkflowInput, canAccessWorkflowRun, clipTaskOutput, MONITOR_BATCH_WINDOW_MS, MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_MAX_TIMEOUT_MS, MONITOR_MAX_BATCHES_PER_MINUTE } from "./task-registry-shared.js";
+export { normalizeAgentName, DURABLE_AGENT_HEARTBEAT_MS, DURABLE_AGENT_HANDLE_RE, BG_AGENT_REAP_STOP_ERROR } from "./task-registry-shared.js";
+export type { ParkedClaimTicket, RegisterBackgroundAgentInput } from "./task-registry-shared.js";
+import type { RegisterBackgroundAgentInput, ParkedClaimTicket } from "./task-registry-shared.js";
+export type { SemaTaskType, StopSource, SemaTaskStatus, TaskRetrievalStatus, UnifiedTaskOutput, SemaTaskHandle, TaskAccess, MonitorTimers, RegisterMonitorInput, RegisterWorkflowInput, };
+export { canAccessWorkflowRun, clipTaskOutput, MONITOR_BATCH_WINDOW_MS, MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_MAX_TIMEOUT_MS, MONITOR_MAX_BATCHES_PER_MINUTE };
 export interface TaskKind {
     type: SemaTaskType;
     effect: ToolEffect;
 }
-export interface TaskAccess {
-    owner?: string;
-    scope?: string;
-    sessionId?: string;
-}
-interface DurableAgentLane {
-    store: BackgroundAgentStore;
-    record: BackgroundAgentRecord;
-    chain: Promise<void>;
-    written: boolean;
-    poisoned: boolean;
-    flushFailed: boolean;
-    redrives?: number;
-}
-interface BackgroundAgentTaskHandle extends SemaTaskHandle {
-    type: "background_agent";
-    abort: AbortController;
-    sessionId?: string;
-    durable?: DurableAgentLane;
-    notify?: (notification: import("./task-notification.js").TaskNotificationPayload, opts?: {
-        priority?: import("./task-notification.js").SystemInjectionPriority;
-    }) => void | "queued" | "parked" | "dropped_duplicate" | Promise<"queued" | "parked" | "dropped_duplicate">;
-    retainedContinuation?: boolean;
-    reviveCycle?: number;
-    cycleSeq?: number;
-    parkedCheckpointToken?: string;
-    resolveParkedStop?: () => Promise<boolean>;
-    inFlightDirect?: Set<(r: {
-        ok: true;
-        disposition: "queued" | "parked";
-    } | {
-        ok: false;
-        reason: "not_found" | "not_running" | "no_channel";
-    }) => void>;
-    channelState?: "attaching" | "attached";
-    preAttachQueue?: Array<[
-        import("./task-notification.js").TaskNotificationPayload,
-        {
-            priority?: import("./task-notification.js").SystemInjectionPriority;
-        } | undefined,
-        (((r: {
-            ok: true;
-            disposition: "queued" | "parked";
-        } | {
-            ok: false;
-            reason: "not_found" | "not_running" | "no_channel";
-        }) => void) | undefined)?
-    ]>;
-    name?: string;
-    sessionScoped?: true;
-    result?: string;
-    resultFull?: string;
-    error?: string;
-    resultIsPartial?: boolean;
-    stopSource?: StopSource;
-    stoppedBy?: StopSource;
-}
-export interface MonitorTimers {
-    setInterval: (fn: () => unknown, ms: number) => unknown;
-    clearInterval: (handle: unknown) => void;
-    now: () => number;
-}
 export interface RegisterBackgroundBashInput extends TaskAccess {
     shellId: BackgroundShellId;
     env: ExecutionEnv & BackgroundShellCapability;
@@ -119,55 +25,6 @@ export interface RegisterBackgroundBashInput extends TaskAccess {
     onTerminal?: (notification: TaskNotificationPayload) => void;
     outputFile?: string;
 }
-export interface RegisterMonitorInput extends TaskAccess {
-    shellId: BackgroundShellId;
-    env: ExecutionEnv & BackgroundShellCapability;
-    description?: string;
-    toolUseId?: string;
-    persistent?: boolean;
-    sessionScoped?: true;
-    timeoutMs?: number;
-    onEvent?: (n: TaskNotificationPayload) => void;
-    timers?: MonitorTimers;
-    batchWindowMs?: number;
-    maxBatchesPerMinute?: number;
-    now?: number;
-}
-export interface RegisterBackgroundAgentInput extends TaskAccess {
-    initialStatus?: "parked";
-    parkedCheckpointToken?: string;
-    resolveParkedStop?: () => Promise<boolean>;
-    deliveryChannel?: "attaching";
-    retainedContinuation?: boolean;
-    description?: string;
-    name?: string;
-    agentType?: string;
-    parentTaskId?: string;
-    parentSessionId?: string;
-    rootSessionId?: string;
-    model?: string;
-    teamName?: string;
-    toolUseId?: string;
-    abort: AbortController;
-    now?: number;
-    sessionScoped?: true;
-    id?: string;
-    store?: BackgroundAgentStore;
-    durableSeed?: {
-        record: BackgroundAgentRecord;
-        rev: number;
-    };
-}
-export interface RegisterWorkflowInput extends TaskAccess {
-    runId: string;
-    handle: WorkflowHandle<unknown>;
-    store?: WorkflowRunStore;
-    description?: string;
-    toolUseId?: string;
-    now?: number;
-    originatingSessionId?: string;
-    onServedTerminal?: () => void;
-}
 export interface TaskPollOptions {
     workflowStore?: WorkflowRunStore;
     agentStore?: BackgroundAgentStore;
@@ -185,17 +42,8 @@ export interface TaskToolOptions extends TaskAccess {
     workflowStore?: WorkflowRunStore;
     agentStore?: BackgroundAgentStore;
     deadlineMs?: () => number | undefined;
+    notificationWired?: boolean;
 }
-export declare const DURABLE_AGENT_HEARTBEAT_MS = 60000;
-export declare const DURABLE_AGENT_HANDLE_RE: RegExp;
-export declare const BG_AGENT_REAP_STOP_ERROR = "stopped (parent task ended or TaskStop)";
-export declare const MONITOR_BATCH_WINDOW_MS = 200;
-export declare const MONITOR_DEFAULT_TIMEOUT_MS = 300000;
-export declare const MONITOR_MAX_TIMEOUT_MS = 3600000;
-export declare const MONITOR_MAX_BATCHES_PER_MINUTE = 50;
-export declare function clipTaskOutput(s: string, fullOutputPath?: string): string;
-export declare function normalizeAgentName(s: string): string;
-export declare function canAccessWorkflowRun(run: Pick<WorkflowRun, "scope" | "sourceTaskId" | "originatingSessionId">, access: TaskAccess): boolean;
 export interface AccessibleTaskRow {
     task_id: string;
     type: SemaTaskHandle["type"];
@@ -216,12 +64,7 @@ export declare class TaskRegistry {
     private sessionReapHooks;
     private bgQuiescenceWatchers;
     private legacyToTaskId;
-    readonly writerId: string;
-    private reapingHandles;
-    private claimingHandles;
-    private durableHeartbeatTimer;
-    private ensureDurableHeartbeat;
-    private durableAgentWrite;
+    private readonly core;
     durableAgentArmed(id: string): boolean;
     durableAgentRowProbe(id: string): (() => Promise<boolean>) | undefined;
     beginDurableClaim(id: string): boolean;
@@ -247,16 +90,7 @@ export declare class TaskRegistry {
     }>;
     releaseDurableTranscriptAnchor(id: string): void;
     bindBackgroundAgentSession(id: string, sessionId: string): void;
-    mintTaskId(type: SemaTaskType): string;
-    registerBackgroundBash(input: RegisterBackgroundBashInput): string;
-    isBackgroundOutputFile(canonicalPath: string, access: TaskAccess, env: unknown): boolean;
     registerBackgroundAgent(input: RegisterBackgroundAgentInput): string;
-    getAccessibleTask(taskId: string, access: TaskAccess): AccessibleTaskRow | undefined;
-    markStopSource(id: string, source: StopSource): void;
-    markStopSourceForEnvSweep(env: unknown, source: StopSource, except?: readonly string[]): string[];
-    markStopSourceByShellId(shellId: string, source: StopSource, env?: unknown): void;
-    clearPendingStopSourceByShellId(shellId: string, source: StopSource, env?: unknown): void;
-    getStopAttribution(id: string): StopSource | undefined;
     parkBackgroundAgent(id: string, park: {
         checkpointToken: string;
         seq?: number;
@@ -301,40 +135,10 @@ export declare class TaskRegistry {
         skipSessionScoped?: boolean;
         sessionScopedOnly?: boolean;
     }): number;
-    markStopSourceForOwner(access: TaskAccess, source: StopSource, opts?: {
-        skipSessionScoped?: boolean;
-    }): number;
-    settleKilledForOwner(access: TaskAccess, opts?: {
-        source?: StopSource;
-        skipSessionScoped?: boolean;
-        envDying?: boolean;
-        retainProcesses?: boolean;
-    }): Promise<number>;
-    reapSessionBackground(sessionId: string, scope?: string): number;
-    reapAllSessionBackground(): number;
-    onSessionReap(hook: (sessionId: string, scope?: string) => void): () => void;
-    countRunningBackgroundForOwner(owner: string): number;
-    private static readonly BG_QUIESCENCE_WATCHERS_MAX;
-    onBackgroundQuiescence(owner: string, cb: (reason: "quiescent" | "evicted") => void): () => void;
-    private pokeBgQuiescence;
-    private notifyTerminalOnce;
-    private startBashWatcher;
-    sessionResidentShellIds(sessionId: string, env: unknown): BackgroundShellId[];
-    timeoutResidentShellIds(env: unknown): BackgroundShellId[];
-    retainedShellIds(env: unknown): BackgroundShellId[];
-    registerMonitor(input: RegisterMonitorInput): string;
-    private startMonitorWatcher;
-    registerWorkflow(input: RegisterWorkflowInput): string;
-    pollTask(id: string, access: TaskAccess, opts?: TaskPollOptions): Promise<{
-        content: string;
-        details: UnifiedTaskOutput;
-    }>;
     private serveDurableAgentRow;
-    stopTask(id: string, access: TaskAccess, opts?: TaskStopOptions): Promise<{
-        content: string;
-        details: UnifiedTaskOutput;
-    }>;
-    resolveBackgroundAgentByName(name: string, access: TaskAccess): {
+    resolveBackgroundAgentByName(name: string, access: TaskAccess, opts?: {
+        preferRunning?: boolean;
+    }): {
         status: "found";
         handle: BackgroundAgentTaskHandle;
     } | {
@@ -370,6 +174,47 @@ export declare class TaskRegistry {
         reason: "not_found" | "not_running" | "no_channel";
     }>;
     runningBackgroundAgentLabels(access: TaskAccess): string[];
+    private pollBackgroundAgent;
+    private stopBackgroundAgent;
+    readonly writerId: string;
+    private reapingHandles;
+    private claimingHandles;
+    private durableHeartbeatTimer;
+    mintTaskId(type: SemaTaskType): string;
+    registerBackgroundBash(input: RegisterBackgroundBashInput): string;
+    isBackgroundOutputFile(canonicalPath: string, access: TaskAccess, env: unknown): boolean;
+    getAccessibleTask(taskId: string, access: TaskAccess): AccessibleTaskRow | undefined;
+    markStopSource(id: string, source: StopSource): void;
+    markStopSourceForEnvSweep(env: unknown, source: StopSource, except?: readonly string[]): string[];
+    markStopSourceByShellId(shellId: string, source: StopSource, env?: unknown): void;
+    clearPendingStopSourceByShellId(shellId: string, source: StopSource, env?: unknown): void;
+    getStopAttribution(id: string): StopSource | undefined;
+    getCompletionId(id: string): string | undefined;
+    markStopSourceForOwner(access: TaskAccess, source: StopSource, opts?: {
+        skipSessionScoped?: boolean;
+    }): number;
+    settleKilledForOwner(access: TaskAccess, opts?: {
+        source?: StopSource;
+        skipSessionScoped?: boolean;
+        envDying?: boolean;
+        retainProcesses?: boolean;
+    }): Promise<number>;
+    reapSessionBackground(sessionId: string, scope?: string): number;
+    reapAllSessionBackground(): number;
+    onSessionReap(hook: (sessionId: string, scope?: string) => void): () => void;
+    countRunningBackgroundForOwner(owner: string): number;
+    private static readonly BG_QUIESCENCE_WATCHERS_MAX;
+    onBackgroundQuiescence(owner: string, cb: (reason: "quiescent" | "evicted") => void): () => void;
+    private pokeBgQuiescence;
+    private notifyTerminalOnce;
+    private startBashWatcher;
+    sessionResidentShellIds(sessionId: string, env: unknown): BackgroundShellId[];
+    timeoutResidentShellIds(env: unknown): BackgroundShellId[];
+    retainedShellIds(env: unknown): BackgroundShellId[];
+    registerMonitor(input: RegisterMonitorInput): string;
+    registerWorkflow(input: RegisterWorkflowInput): string;
+    pollTask(id: string, access: TaskAccess, opts?: TaskPollOptions): Promise<UnifiedTaskResult>;
+    stopTask(id: string, access: TaskAccess, opts?: TaskStopOptions): Promise<UnifiedTaskResult>;
     deliverConfirmTimeoutMs: number;
     private lastGcAt;
     list(access: TaskAccess, opts?: {
@@ -389,16 +234,12 @@ export declare class TaskRegistry {
     clearBackgroundForOwner(access: TaskAccess): number;
     private resolveInternal;
     private pollBackgroundBash;
-    private fireServedTerminal;
     private pollWorkflow;
     private stopBackgroundBash;
     private pollMonitor;
     private stopMonitor;
-    private pollBackgroundAgent;
-    private stopBackgroundAgent;
     private stopWorkflow;
 }
 export declare const defaultTaskRegistry: TaskRegistry;
 export declare function createTaskOutputTool(opts: TaskToolOptions): AgentTool;
 export declare function createTaskStopTool(opts: TaskToolOptions): AgentTool;
-export {};