agent-afk 5.140.0 → 5.141.1

package/dist/agent/background-registry.cap.d.ts

@@ -0,0 +1,4 @@
+export declare function resolveBackgroundJobCap(explicit: number | undefined): number;
+export declare class BackgroundJobCapError extends Error {
+    constructor(running: number, cap: number);
+}

package/dist/agent/background-registry.d.ts

@@ -1,18 +1,10 @@
 import { EventEmitter } from 'node:events';
 import type { SubagentHandle, SubagentResult } from './subagent.js';
 import type { TraceSink } from './trace/index.js';
-export type BackgroundJobStatus = 'running' | 'completed' | 'failed' | 'cancelled';
-export interface BackgroundJob {
-    readonly jobId: string;
-    readonly subagentId: string;
-    readonly label: string;
-    readonly model: string;
-    readonly startedAt: number;
-    readonly status: BackgroundJobStatus;
-    readonly result?: SubagentResult;
-    readonly endedAt?: number;
-}
-export declare const MAX_TRANSCRIPT_TAIL_BYTES = 4096;
+import type { BackgroundJob, BackgroundJobProvenance } from './background-registry.types.js';
+export { BackgroundJobCapError } from './background-registry.cap.js';
+export { MAX_TRANSCRIPT_TAIL_BYTES } from './background-registry.transcript.js';
+export type { BackgroundJob, BackgroundJobProvenance, BackgroundJobStatus } from './background-registry.types.js';
 export interface BackgroundRegistryOptions {
     traceWriter?: TraceSink | undefined;
     maxConcurrentJobs?: number;
@@ -21,12 +13,10 @@ export interface RegisterArgs {
     handle: SubagentHandle;
     prompt: string;
     model: string;
+    provenance?: BackgroundJobProvenance;
     parentSessionId?: string | undefined;
     onCleanup?: () => Promise<void>;
 }
-export declare class BackgroundJobCapError extends Error {
-    constructor(running: number, cap: number);
-}
 export interface BackgroundRegistryEvents {
     started: [job: BackgroundJob];
     settled: [job: BackgroundJob];
@@ -49,6 +39,7 @@ export declare class BackgroundAgentRegistry extends EventEmitter<BackgroundRegi
     join(jobId: string): Promise<SubagentResult>;
     markDelivered(jobId: string): void;
     cancelJob(jobId: string): Promise<boolean>;
+    cancelModelJob(jobId: string, reason: string): Promise<boolean>;
     cancelAll(): Promise<void>;
     appendTranscript(jobId: string, chunk: string): void;
     getTranscript(jobId: string): string | undefined;

package/dist/agent/background-registry.telemetry.d.ts

@@ -0,0 +1,2 @@
+import { appendRoutingDecision } from './routing-telemetry.js';
+export declare function emitBackgroundRoutingTelemetry(entry: Parameters<typeof appendRoutingDecision>[0]): void;

package/dist/agent/background-registry.transcript.d.ts

@@ -0,0 +1,2 @@
+export declare const MAX_TRANSCRIPT_TAIL_BYTES = 4096;
+export declare function appendTranscriptTail(current: string, chunk: string): string;

package/dist/agent/background-registry.types.d.ts

@@ -0,0 +1,14 @@
+import type { SubagentResult } from './subagent.js';
+export type BackgroundJobStatus = 'running' | 'completed' | 'failed' | 'cancelled';
+export type BackgroundJobProvenance = 'model' | 'user';
+export interface BackgroundJob {
+    readonly jobId: string;
+    readonly provenance: BackgroundJobProvenance;
+    readonly subagentId: string;
+    readonly label: string;
+    readonly model: string;
+    readonly startedAt: number;
+    readonly status: BackgroundJobStatus;
+    readonly result?: SubagentResult;
+    readonly endedAt?: number;
+}

package/dist/agent/tools/dispatcher.subagent-tools.d.ts

@@ -0,0 +1,8 @@
+import type { SubagentExecutor } from './subagent-executor.js';
+import type { ToolCall, ToolResult } from './types.js';
+export declare function isSubagentProviderTool(name: string): boolean;
+export interface SubagentProviderToolOutcome {
+    result: ToolResult;
+    thrownMessage?: string;
+}
+export declare function executeSubagentProviderTool(executor: SubagentExecutor | undefined, call: ToolCall): Promise<SubagentProviderToolOutcome>;

package/dist/agent/tools/schemas.background-cancel.d.ts

@@ -0,0 +1,2 @@
+import type { AnthropicToolDef } from './types.js';
+export declare const cancelBackgroundJobTool: AnthropicToolDef;

package/dist/agent/tools/schemas.orchestration.d.ts

@@ -0,0 +1 @@
+export { cancelBackgroundJobTool } from './schemas.background-cancel.js';

package/dist/agent/tools/subagent/background-cancel.d.ts

@@ -0,0 +1,3 @@
+import type { BackgroundAgentRegistry } from '../../background-registry.js';
+import type { ToolCall, ToolResult } from '../types.js';
+export declare function cancelBackgroundJob(registry: BackgroundAgentRegistry | undefined, call: ToolCall): Promise<ToolResult>;

package/dist/agent/tools/subagent-executor.d.ts

@@ -62,7 +62,9 @@ export declare class SubagentExecutor implements SubagentControl {
     notifyWaveStart(calls: ReadonlyArray<ToolCall>, sessionId: string, traceLabel: string | null): void;
     notifyWaveEnd(): void;
     private updateCurrentWaveUnit;
+    supportsBackgroundJobs(): boolean;
     hasPromotableForeground(): boolean;
+    cancelBackgroundJob(call: ToolCall): Promise<ToolResult>;
     hasActiveForeground(): boolean;
     private cancelGeneration;
     cancelActiveForeground(): Promise<number>;

package/dist/agent/trace/background-agent-payloads.d.ts

@@ -0,0 +1,43 @@
+export interface BackgroundAgentStartedPayload {
+    transition: 'started';
+    jobId: string;
+    subagentId: string;
+    label: string;
+    model: string;
+}
+export interface BackgroundAgentCompletedPayload {
+    transition: 'completed';
+    jobId: string;
+    subagentId: string;
+    durationMs: number;
+    outputBytes: number;
+}
+export interface BackgroundAgentFailedPayload {
+    transition: 'failed';
+    jobId: string;
+    subagentId: string;
+    durationMs: number;
+    errorClass: string;
+    errorMessage: string;
+}
+export interface BackgroundAgentCancelledPayload {
+    transition: 'cancelled';
+    jobId: string;
+    subagentId: string;
+    source: 'explicit' | 'cascade';
+    cancelledBy?: 'model';
+    reason?: string;
+}
+export interface BackgroundAgentJoinedPayload {
+    transition: 'joined';
+    jobId: string;
+    subagentId: string;
+    jobStatus: 'completed' | 'failed' | 'cancelled';
+}
+export interface BackgroundAgentDeliveredPayload {
+    transition: 'delivered';
+    jobId: string;
+    subagentId: string;
+    jobStatus: 'completed' | 'failed' | 'cancelled';
+}
+export type BackgroundAgentPayload = BackgroundAgentStartedPayload | BackgroundAgentCompletedPayload | BackgroundAgentFailedPayload | BackgroundAgentCancelledPayload | BackgroundAgentJoinedPayload | BackgroundAgentDeliveredPayload;

package/dist/agent/trace/background-agent-schema.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+export declare const BackgroundAgentCancelledPayloadSchema: z.ZodObject<{
+    transition: z.ZodLiteral<"cancelled">;
+    jobId: z.ZodString;
+    subagentId: z.ZodString;
+    source: z.ZodEnum<{
+        explicit: "explicit";
+        cascade: "cascade";
+    }>;
+    cancelledBy: z.ZodOptional<z.ZodLiteral<"model">>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;

package/dist/agent/trace/events.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+export { BackgroundAgentCancelledPayloadSchema } from './background-agent-schema.js';
 export declare const ToolCallStartedPayloadSchema: z.ZodObject<{
     phase: z.ZodLiteral<"started">;
     toolUseId: z.ZodString;
@@ -159,8 +160,8 @@ export declare const SubagentCancelledPayloadSchema: z.ZodObject<{
     transition: z.ZodLiteral<"cancelled">;
     subagentId: z.ZodString;
     source: z.ZodEnum<{
-        cascade: "cascade";
         explicit: "explicit";
+        cascade: "cascade";
     }>;
     timeout: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
@@ -204,8 +205,8 @@ export declare const SubagentLifecyclePayloadSchema: z.ZodDiscriminatedUnion<[z.
     transition: z.ZodLiteral<"cancelled">;
     subagentId: z.ZodString;
     source: z.ZodEnum<{
-        cascade: "cascade";
         explicit: "explicit";
+        cascade: "cascade";
     }>;
     timeout: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>], "transition">;
@@ -231,15 +232,6 @@ export declare const BackgroundAgentFailedPayloadSchema: z.ZodObject<{
     errorClass: z.ZodString;
     errorMessage: z.ZodString;
 }, z.core.$strip>;
-export declare const BackgroundAgentCancelledPayloadSchema: z.ZodObject<{
-    transition: z.ZodLiteral<"cancelled">;
-    jobId: z.ZodString;
-    subagentId: z.ZodString;
-    source: z.ZodEnum<{
-        cascade: "cascade";
-        explicit: "explicit";
-    }>;
-}, z.core.$strip>;
 export declare const BackgroundAgentJoinedPayloadSchema: z.ZodObject<{
     transition: z.ZodLiteral<"joined">;
     jobId: z.ZodString;
@@ -284,9 +276,11 @@ export declare const BackgroundAgentPayloadSchema: z.ZodDiscriminatedUnion<[z.Zo
     jobId: z.ZodString;
     subagentId: z.ZodString;
     source: z.ZodEnum<{
-        cascade: "cascade";
         explicit: "explicit";
+        cascade: "cascade";
     }>;
+    cancelledBy: z.ZodOptional<z.ZodLiteral<"model">>;
+    reason: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     transition: z.ZodLiteral<"joined">;
     jobId: z.ZodString;
@@ -313,17 +307,17 @@ export declare const BudgetPayloadSchema: z.ZodObject<{
     lastTurnCostUsd: z.ZodNumber;
 }, z.core.$strip>;
 export declare const AbortOriginSchema: z.ZodEnum<{
+    cascade: "cascade";
     budget: "budget";
     timeout: "timeout";
-    cascade: "cascade";
     user_signal: "user_signal";
     hook_block: "hook_block";
 }>;
 export declare const AbortPayloadSchema: z.ZodObject<{
     origin: z.ZodEnum<{
+        cascade: "cascade";
         budget: "budget";
         timeout: "timeout";
-        cascade: "cascade";
         user_signal: "user_signal";
         hook_block: "hook_block";
     }>;
@@ -568,8 +562,8 @@ export declare const SessionPhasePayloadSchema: z.ZodObject<{
 export declare const SessionSealedPayloadSchema: z.ZodObject<{
     status: z.ZodEnum<{
         failed: "failed";
-        succeeded: "succeeded";
         cancelled: "cancelled";
+        succeeded: "succeeded";
     }>;
     finalCostUsd: z.ZodNumber;
     finalTurnCount: z.ZodNumber;
@@ -691,8 +685,8 @@ export declare const TraceEventInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject
         transition: z.ZodLiteral<"cancelled">;
         subagentId: z.ZodString;
         source: z.ZodEnum<{
-            cascade: "cascade";
             explicit: "explicit";
+            cascade: "cascade";
         }>;
         timeout: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>], "transition">;
@@ -722,9 +716,11 @@ export declare const TraceEventInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject
         jobId: z.ZodString;
         subagentId: z.ZodString;
         source: z.ZodEnum<{
-            cascade: "cascade";
             explicit: "explicit";
+            cascade: "cascade";
         }>;
+        cancelledBy: z.ZodOptional<z.ZodLiteral<"model">>;
+        reason: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         transition: z.ZodLiteral<"joined">;
         jobId: z.ZodString;
@@ -756,9 +752,9 @@ export declare const TraceEventInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject
     kind: z.ZodLiteral<"abort">;
     payload: z.ZodObject<{
         origin: z.ZodEnum<{
+            cascade: "cascade";
             budget: "budget";
             timeout: "timeout";
-            cascade: "cascade";
             user_signal: "user_signal";
             hook_block: "hook_block";
         }>;
@@ -1031,8 +1027,8 @@ export declare const TraceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         transition: z.ZodLiteral<"cancelled">;
         subagentId: z.ZodString;
         source: z.ZodEnum<{
-            cascade: "cascade";
             explicit: "explicit";
+            cascade: "cascade";
         }>;
         timeout: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>], "transition">;
@@ -1064,9 +1060,11 @@ export declare const TraceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         jobId: z.ZodString;
         subagentId: z.ZodString;
         source: z.ZodEnum<{
-            cascade: "cascade";
             explicit: "explicit";
+            cascade: "cascade";
         }>;
+        cancelledBy: z.ZodOptional<z.ZodLiteral<"model">>;
+        reason: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         transition: z.ZodLiteral<"joined">;
         jobId: z.ZodString;
@@ -1102,9 +1100,9 @@ export declare const TraceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"abort">;
     payload: z.ZodObject<{
         origin: z.ZodEnum<{
+            cascade: "cascade";
             budget: "budget";
             timeout: "timeout";
-            cascade: "cascade";
             user_signal: "user_signal";
             hook_block: "hook_block";
         }>;
@@ -1286,8 +1284,8 @@ export declare const TraceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     payload: z.ZodObject<{
         status: z.ZodEnum<{
             failed: "failed";
-            succeeded: "succeeded";
             cancelled: "cancelled";
+            succeeded: "succeeded";
         }>;
         finalCostUsd: z.ZodNumber;
         finalTurnCount: z.ZodNumber;

package/dist/agent/trace/types.d.ts

@@ -74,47 +74,8 @@ export interface SubagentCancelledPayload {
     timeout?: boolean;
 }
 export type SubagentLifecyclePayload = SubagentStartedPayload | SubagentSucceededPayload | SubagentFailedPayload | SubagentCancelledPayload;
-export interface BackgroundAgentStartedPayload {
-    transition: 'started';
-    jobId: string;
-    subagentId: string;
-    label: string;
-    model: string;
-}
-export interface BackgroundAgentCompletedPayload {
-    transition: 'completed';
-    jobId: string;
-    subagentId: string;
-    durationMs: number;
-    outputBytes: number;
-}
-export interface BackgroundAgentFailedPayload {
-    transition: 'failed';
-    jobId: string;
-    subagentId: string;
-    durationMs: number;
-    errorClass: string;
-    errorMessage: string;
-}
-export interface BackgroundAgentCancelledPayload {
-    transition: 'cancelled';
-    jobId: string;
-    subagentId: string;
-    source: 'explicit' | 'cascade';
-}
-export interface BackgroundAgentJoinedPayload {
-    transition: 'joined';
-    jobId: string;
-    subagentId: string;
-    jobStatus: 'completed' | 'failed' | 'cancelled';
-}
-export interface BackgroundAgentDeliveredPayload {
-    transition: 'delivered';
-    jobId: string;
-    subagentId: string;
-    jobStatus: 'completed' | 'failed' | 'cancelled';
-}
-export type BackgroundAgentPayload = BackgroundAgentStartedPayload | BackgroundAgentCompletedPayload | BackgroundAgentFailedPayload | BackgroundAgentCancelledPayload | BackgroundAgentJoinedPayload | BackgroundAgentDeliveredPayload;
+export type { BackgroundAgentStartedPayload, BackgroundAgentCompletedPayload, BackgroundAgentFailedPayload, BackgroundAgentCancelledPayload, BackgroundAgentJoinedPayload, BackgroundAgentDeliveredPayload, BackgroundAgentPayload, } from './background-agent-payloads.js';
+import type { BackgroundAgentPayload } from './background-agent-payloads.js';
 export interface BudgetPayload {
     kind: 'monetary';
     runningCostUsd: number;