agent-afk 5.297.0 → 5.298.1

package/dist/agent/hooks.d.ts

@@ -55,6 +55,7 @@ export interface PostToolUseContext {
     sessionId?: string;
     subagentId?: string;
     parentSessionId?: string;
+    rootSessionId?: string;
     toolName: string;
     input?: unknown;
     output?: unknown;

package/dist/agent/peer/inbox-store.d.ts

@@ -10,13 +10,21 @@ export declare function envelopeFilename(env: Pick<PeerEnvelope, 'ts' | 'message
 export declare function writeEnvelope(env: PeerEnvelope): Promise<void>;
 export declare function listPending(sessionId: string): Promise<string[]>;
 export declare function claimPending(sessionId: string, file: string): Promise<PeerEnvelope | null>;
-export declare function checkOrphanPending(sessionId: string, file: string): Promise<'valid' | 'corrupt' | 'none'>;
-export declare function peekPending(sessionId: string, file: string): Promise<PeerEnvelope | null>;
+export { checkOrphanPending, clearDeliveredReceipt } from './inbox-store.orphan.js';
+export declare function peekPending(sessionId: string, file: string): Promise<PeerEnvelope | 'vanished' | 'unparseable'>;
 export declare function holdPending(sessionId: string, file: string): Promise<boolean>;
-export declare function listHeld(sessionId: string): Promise<Array<{
+export interface HeldEntryOk {
     file: string;
     envelope: PeerEnvelope;
-}>>;
+    corrupt?: never;
+}
+export interface HeldEntryCorrupt {
+    file: string;
+    corrupt: true;
+    envelope?: never;
+}
+export type HeldEntry = HeldEntryOk | HeldEntryCorrupt;
+export declare function listHeld(sessionId: string): Promise<HeldEntry[]>;
 export declare function releaseHeld(sessionId: string, file: string): Promise<boolean>;
 export declare function dropHeld(sessionId: string, file: string): Promise<boolean>;
 export declare function countPending(sessionId: string): Promise<number>;

package/dist/agent/peer/inbox-store.orphan.d.ts

@@ -0,0 +1,2 @@
+export declare function checkOrphanPending(sessionId: string, file: string): Promise<'valid' | 'corrupt' | 'none'>;
+export declare function clearDeliveredReceipt(sessionId: string, file: string): Promise<void>;

package/dist/agent/providers/anthropic-direct/build-dispatcher.d.ts

@@ -22,6 +22,7 @@ export interface BuildDispatcherOptions {
     env?: Record<string, string>;
     sessionId?: string;
     parentSessionId?: string;
+    rootSessionId?: string;
     subagentId?: string;
     subagentToolOutputCapBytes?: number;
     traceWriter?: TraceSink;

package/dist/agent/providers/anthropic-direct/query/cwd-dependents.d.ts

@@ -29,6 +29,7 @@ export interface CwdDependentsFactoryArgs {
         writeRoots?: string[];
         sessionId?: string;
         parentSessionId?: string;
+        rootSessionId?: string;
         traceWriter?: AgentConfig['traceWriter'];
         runtimeStateSource?: RuntimeStateSource;
         hookRegistry?: AgentConfig['hookRegistry'];

package/dist/agent/providers/openai-compatible/index.dispatcher-opts.d.ts

@@ -0,0 +1,21 @@
+import type { PlanExitControls } from '../../types/config-types.js';
+import type { RuntimeStateSource } from '../../awareness/index.js';
+export interface BuildDispatcherOpts {
+    cwd?: string;
+    readRoots?: string[];
+    writeRoots?: string[];
+    sessionId?: string;
+    parentSessionId?: string;
+    rootSessionId?: string;
+    subagentId?: string;
+    env?: Record<string, string>;
+    subagentToolOutputCapBytes?: number;
+    traceWriter?: import('../../trace/index.js').TraceSink;
+    bashOutputTailReporter?: (toolUseId: string) => (tail: string | undefined) => void;
+    detachRegistry?: import('../../tools/detach-registry.js').DetachableToolRegistry;
+    runtimeStateSource?: RuntimeStateSource;
+    isSkillDispatch?: boolean;
+    isNonInteractive?: boolean;
+    hookRegistry?: import('../../hooks.js').HookRegistry;
+    planExitControls?: PlanExitControls;
+}

package/dist/agent/spine/spine-hook.diff.d.ts

@@ -0,0 +1,9 @@
+export interface DiffResult {
+    diff: string;
+    fingerprint: string;
+    worktreeRoot: string;
+    skipped: boolean;
+}
+export declare function getClassifiableDiff(worktreeCwd: string, fallbackRoot: string): DiffResult;
+export declare function isDuplicateDiff(fingerprint: string, worktreeRoot: string): boolean;
+export declare function persistDiffFingerprint(fingerprint: string, worktreeRoot: string): void;

package/dist/agent/subagent/fork-child-config.d.ts

@@ -24,6 +24,8 @@ export interface AssembleChildConfigArgs<T> {
     parentTraceWriter: TraceSink | undefined;
     parentSurface: Surface | undefined;
     parentCanUseTool: CanUseTool | undefined;
+    parentRootSessionId: string | undefined;
     nestedAgentAllowlist?: readonly string[];
 }
+export type ParentForkFields = Pick<AssembleChildConfigArgs<unknown>, 'parentCwd' | 'parentApiKey' | 'parentBaseUrl' | 'parentProvider' | 'parentTraceWriter' | 'parentSurface' | 'parentCanUseTool' | 'parentRootSessionId'>;
 export declare function assembleChildConfig<T>(args: AssembleChildConfigArgs<T>): AgentConfig;

package/dist/agent/subagent/fork-types.d.ts

@@ -15,6 +15,7 @@ export interface ForkParent {
 }
 export interface JournalParent {
     readonly messageJournal?: MessageJournal;
+    readonly sessionId?: string | undefined;
 }
 export interface ForkSubagentOptions<T = unknown> {
     parent: Pick<IAgentSession, 'sessionId'> & Partial<Pick<IAgentSession, 'getInputStreamRef' | 'abortSignal' | 'hookRegistry'>> & JournalParent;
@@ -45,6 +46,7 @@ export interface SubagentManagerOptions {
     parentModel?: string;
     cwd?: string;
     parentReadRoots?: string[];
+    parentRootSessionId?: string;
     traceWriter?: TraceSink;
     surface?: Surface;
     onSubagentSucceeded?: (usage: import('./result.js').SubagentTrace['usage'], costUsd: number | undefined) => void;

package/dist/agent/subagent/worktree-main-root-cache.d.ts

@@ -0,0 +1,5 @@
+export declare class WorktreeMainRootCache {
+    private readonly cache;
+    resolve(cwd: string): Promise<string | undefined>;
+    invalidate(cwd: string): void;
+}

package/dist/agent/subagent.d.ts

@@ -23,6 +23,7 @@ export declare class SubagentManager {
     private readonly parentModel;
     private parentCwd;
     private readonly parentReadRoots;
+    private readonly parentRootSessionId;
     private readonly worktreeMainRootCache;
     private parentTraceWriter;
     private readonly parentSurface;
@@ -46,6 +47,7 @@ export declare class SubagentManager {
     setCwd(cwd: string): void;
     setTraceWriter(writer: TraceSink | undefined): void;
     getReadScopeInputs(): ReadScopeInputs;
+    private parentForkFields;
     private resolveMainRootForCwd;
     abortAll(reason?: unknown, origin?: AbortOrigin): void;
     forkSubagent<T = unknown>(options: ForkSubagentOptions<T>): Promise<SubagentHandle<T>>;

package/dist/agent/tools/dispatcher.core-exec.d.ts

@@ -14,6 +14,7 @@ export interface CoreExecDeps {
     hookRegistry: HookRegistry | undefined;
     sessionId: string | undefined;
     parentSessionId: string | undefined;
+    rootSessionId: string | undefined;
     sessionGrantManager: GrantManager | undefined;
     traceWriter: TraceSink | undefined;
     maxOutputBytes: number | undefined;

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

@@ -36,6 +36,7 @@ export interface SessionToolDispatcherOptions {
     env?: Record<string, string>;
     sessionId?: string;
     parentSessionId?: string;
+    rootSessionId?: string;
     subagentId?: string;
     sessionGrantManager?: GrantManager;
     traceWriter?: TraceSink;
@@ -64,6 +65,7 @@ export declare class SessionToolDispatcher implements ToolDispatcher {
     private readonly _env;
     private readonly sessionId;
     private readonly parentSessionId;
+    private readonly rootSessionId;
     private readonly subagentId;
     private readonly sessionGrantManager;
     private readonly traceWriter;

package/dist/agent/tools/handlers/bash.d.ts

@@ -1,3 +1,3 @@
 import type { ToolHandler } from '../types.js';
-export declare function createBashHandler(permissionMode: string, cwd?: string): ToolHandler;
+export declare function createBashHandler(_permissionMode: string, cwd?: string): ToolHandler;
 export declare const bashHandler: ToolHandler;

package/dist/agent/tools/nesting.d.ts

@@ -34,7 +34,7 @@ export interface CreateChildProviderFactoryOptions {
 export declare function createChildProviderFactory(opts?: CreateChildProviderFactoryOptions): (args: ChildProviderFactoryArgs) => ModelProvider;
 export declare function buildReadOnlyReconProvider(model: AgentModelInput | undefined, openaiBaseUrl?: string, allowedTools?: readonly string[]): ModelProvider;
 export declare function buildComposeNodeProvider(model: AgentModelInput | undefined, workspaceStore: WorkspaceStore, openaiBaseUrl?: string, readOnlyBash?: boolean): ModelProvider;
-export declare function createChildSkillExecutorFactory(defaultModel: AgentModelInput, apiKey: string | undefined, childProviderFactory: (args: ChildProviderFactoryArgs) => ModelProvider, baseUrl?: string, traceWriter?: TraceSink, backgroundRegistry?: BackgroundAgentRegistry, cwd?: string, resolveApiKeyForModel?: (model: string) => string | undefined, surface?: Surface, defaultSubagentModel?: AgentModelInput, agentRegistry?: AgentRegistry, openaiBaseUrl?: string, xaiBaseUrl?: string, workspaceStore?: WorkspaceStore, delegationBudget?: import('./delegation-budget.js').DelegationBudget): (depth: number, maxDepth: number, signal: AbortSignal, inheritedCwd?: string, inheritedReadScope?: ReadScopeInputs, skillDispatchName?: string, journalParent?: JournalParent) => SkillExecutor;
+export declare function createChildSkillExecutorFactory(defaultModel: AgentModelInput, apiKey: string | undefined, childProviderFactory: (args: ChildProviderFactoryArgs) => ModelProvider, baseUrl?: string, traceWriter?: TraceSink, backgroundRegistry?: BackgroundAgentRegistry, cwd?: string, resolveApiKeyForModel?: (model: string) => string | undefined, surface?: Surface, defaultSubagentModel?: AgentModelInput, agentRegistry?: AgentRegistry, openaiBaseUrl?: string, xaiBaseUrl?: string, workspaceStore?: WorkspaceStore, delegationBudget?: import('./delegation-budget.js').DelegationBudget): (depth: number, maxDepth: number, signal: AbortSignal, inheritedCwd?: string, inheritedReadScope?: ReadScopeInputs, skillDispatchName?: string, journalParent?: JournalParent, rootSessionId?: string) => SkillExecutor;
 export type PhaseRole = 'read-only' | 'read-write';
 export declare function buildSkillRestrictedProvider(allowedTools: string[], model: AgentModelInput | undefined, readOnlyBash?: boolean, openaiBaseUrl?: string, workspaceStore?: WorkspaceStore): ModelProvider;
 export declare function buildPhaseRestrictedProvider(_role: 'read-only', model: AgentModelInput | undefined): ModelProvider;

package/dist/agent/tools/skill-executor/fork-child-config.d.ts

@@ -4,6 +4,7 @@ import type { SkillExecutorInternals } from './types.js';
 import type { MessageJournal } from '../../journal/types.js';
 export interface JournalParentHolder {
     messageJournal?: MessageJournal;
+    sessionId?: string | undefined;
 }
 export declare function buildForkedChildConfig(internals: SkillExecutorInternals, baseConfig: AgentConfig, signal: AbortSignal, readOnly?: boolean, allowedTools?: string[], journalView?: JournalParentHolder): {
     childConfig: AgentConfig;

package/dist/agent/tools/skill-executor/types.d.ts

@@ -22,7 +22,7 @@ export interface SkillExecutorContext {
     depth?: number;
     maxDepth?: number;
     childProviderFactory?: (args: ChildProviderFactoryArgs) => ModelProvider;
-    childSkillExecutorFactory?: (depth: number, maxDepth: number, signal: AbortSignal, inheritedCwd?: string, inheritedReadScope?: ReadScopeInputs, skillDispatchName?: string, journalParent?: JournalParent) => SkillExecutor;
+    childSkillExecutorFactory?: (depth: number, maxDepth: number, signal: AbortSignal, inheritedCwd?: string, inheritedReadScope?: ReadScopeInputs, skillDispatchName?: string, journalParent?: JournalParent, rootSessionId?: string) => SkillExecutor;
     traceWriter?: TraceSink;
     backgroundRegistry?: BackgroundAgentRegistry;
     cwd?: string;
@@ -31,6 +31,7 @@ export interface SkillExecutorContext {
     skillDispatchName?: string;
     workspaceStore?: import('../../workspace/index.js').WorkspaceStore;
     delegationBudget?: import('../../tools/delegation-budget.js').DelegationBudget;
+    parentRootSessionId?: string;
 }
 export interface SkillInput {
     name: string;

package/dist/agent/tools/subagent/child-config.d.ts

@@ -29,7 +29,7 @@ export interface BuildChildConfigArgs {
     resolveApiKeyForModel?: (model: string) => string | undefined;
     defaultSubagentModel: AgentModelInput;
     childProviderFactory?: (args: ChildProviderFactoryArgs) => ModelProvider;
-    childSkillExecutorFactory?: (depth: number, maxDepth: number, signal: AbortSignal, inheritedCwd?: string, inheritedReadScope?: ReadScopeInputs, skillDispatchName?: string, journalParent?: JournalParent) => SkillExecutor;
+    childSkillExecutorFactory?: (depth: number, maxDepth: number, signal: AbortSignal, inheritedCwd?: string, inheritedReadScope?: ReadScopeInputs, skillDispatchName?: string, journalParent?: JournalParent, rootSessionId?: string) => SkillExecutor;
     surface?: Surface;
     allowedTools?: string[];
     readOnlyBash?: boolean;
@@ -38,6 +38,7 @@ export interface BuildChildConfigArgs {
     traceWriter?: TraceSink;
     workspaceStore?: import('../../workspace/index.js').WorkspaceStore;
     delegationBudget?: import('../../tools/delegation-budget.js').DelegationBudget;
+    parentRootSessionId?: string;
     createChildExecutor: (ctx: SubagentExecutorContext) => SubagentExecutor;
 }
 export interface BuildChildConfigResult {

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

@@ -23,7 +23,7 @@ export interface SubagentExecutorContext {
     resolveApiKeyForModel?: (model: string) => string | undefined;
     defaultSubagentModel: AgentModelInput;
     childProviderFactory?: (args: ChildProviderFactoryArgs) => ModelProvider;
-    childSkillExecutorFactory?: (depth: number, maxDepth: number, signal: AbortSignal, inheritedCwd?: string, inheritedReadScope?: ReadScopeInputs, skillDispatchName?: string, journalParent?: JournalParent) => SkillExecutor;
+    childSkillExecutorFactory?: (depth: number, maxDepth: number, signal: AbortSignal, inheritedCwd?: string, inheritedReadScope?: ReadScopeInputs, skillDispatchName?: string, journalParent?: JournalParent, rootSessionId?: string) => SkillExecutor;
     depth: number;
     maxDepth?: number;
     backgroundRegistry?: BackgroundAgentRegistry;
@@ -37,6 +37,7 @@ export interface SubagentExecutorContext {
     agentRegistry?: AgentRegistry;
     inboundAttachmentRegistry?: InboundAttachmentReader;
     parentModel?: AgentModelInput;
+    parentRootSessionId?: string;
 }
 export interface SubagentControl {
     hasPromotableForeground(): boolean;

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

@@ -18,11 +18,11 @@ export declare class SubagentExecutor implements SubagentControl {
     describeAgentTool(): AnthropicToolDef;
     private readonly promotionTriggers;
     private readonly activeForegroundHandles;
-    private currentWaveId;
-    private currentWaveCallIds;
+    private readonly waveTracker;
     notifyWaveStart(calls: ReadonlyArray<ToolCall>, sessionId: string, traceLabel: string | null): void;
     notifyWaveEnd(): void;
     private updateCurrentWaveUnit;
+    private inheritedChildConfigArgs;
     supportsBackgroundJobs(): boolean;
     hasPromotableForeground(): boolean;
     cancelBackgroundJob(call: ToolCall): Promise<ToolResult>;

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

@@ -0,0 +1,9 @@
+import type { ToolCall } from './types.js';
+export declare class WaveManifestTracker {
+    private currentWaveId;
+    private currentWaveCallIds;
+    notifyWaveStart(calls: ReadonlyArray<ToolCall>, sessionId: string, traceLabel: string | null, depth: number, currentCwd: string | undefined): void;
+    notifyWaveEnd(): void;
+    updateUnit(callId: string, status: 'running' | 'done' | 'failed', error?: string, cwd?: string): void;
+    get waveId(): string | undefined;
+}

package/dist/agent/types/config-types.d.ts

@@ -98,6 +98,7 @@ export interface AgentConfig {
     autoResumeOnUsageLimit?: boolean;
     surface?: Surface;
     parentSessionId?: string;
+    rootSessionId?: string;
     subagentId?: string;
     subagentToolOutputCapBytes?: number;
     depth?: number;

package/dist/cli/commands/interactive/peer-inbox-notifier.d.ts

@@ -48,6 +48,7 @@ export declare class PeerInboxNotifier {
     private scanOnce;
     private accept;
     private noteHeld;
+    private noteCorrupt;
     private fireInjectable;
     private tick;
     private stopWatcher;

package/dist/cli/commands/interactive/peer-inbox-scan.d.ts

@@ -1,13 +1,20 @@
 import type { PeerInboundMode } from '../../../agent/peer/inbound-mode.js';
 import type { WakeBudget } from '../../../agent/peer/guards.js';
 import type { PeerEnvelope } from '../../../agent/peer/envelope.js';
-export type HeldReason = 'inbound-hold' | 'wake-budget';
+export type HeldReason = 'inbound-hold' | 'wake-budget' | 'corrupt';
+export interface HeldEntryOk {
+    envelope: PeerEnvelope;
+    reason: Exclude<HeldReason, 'corrupt'>;
+}
+export interface HeldEntryCorrupt {
+    envelope?: never;
+    reason: 'corrupt';
+    file: string;
+}
+export type HeldEntry = HeldEntryOk | HeldEntryCorrupt;
 export interface PeerScanResult {
     claimed: PeerEnvelope[];
-    held: Array<{
-        envelope: PeerEnvelope;
-        reason: HeldReason;
-    }>;
+    held: HeldEntry[];
 }
 export interface PeerScanArgs {
     sessionId: string;