agent-afk 5.310.5 → 5.310.7

package/dist/agent/file-checkpoint/file-checkpoint.d.ts

@@ -0,0 +1,15 @@
+export interface FileCheckpointRegistry {
+    snapshotFile(absPath: string): Promise<void>;
+    readonly turnId: string;
+}
+export interface FileSnapshot {
+    absPath: string;
+    snapshotPath: string;
+    isNewFile: boolean;
+    mode?: number;
+}
+export declare function decodePathKey(key: string): string;
+export declare const NEW_FILE_SENTINEL = "__afk_new_file__\n";
+export declare function createFileCheckpointRegistry(sessionId: string, turnId: string, _stateDir?: string): FileCheckpointRegistry;
+export declare function hasTurnCheckpoint(sessionId: string, turnId: string, _stateDir?: string): boolean;
+export declare function listTurnSnapshots(sessionId: string, turnId: string, _stateDir?: string): FileSnapshot[];

package/dist/agent/file-checkpoint/rewind-files.d.ts

@@ -0,0 +1,11 @@
+import type { ProviderRewindResult } from '../provider.js';
+import type { ToolHandlerContext } from '../tools/types.js';
+export interface RewindFilesDeps {
+    sessionId: string;
+    enableFileCheckpointing: boolean;
+    writePolicy?: ToolHandlerContext;
+    _stateDir?: string;
+}
+export declare function rewindFiles(deps: RewindFilesDeps, turnId: string, options?: {
+    dryRun?: boolean;
+}): Promise<ProviderRewindResult>;

package/dist/agent/file-checkpoint/rewind-staging.d.ts

@@ -0,0 +1,2 @@
+export declare function pinRewindParent(target: string): () => void;
+export declare function stageRewindFile(target: string, content: Buffer, validate: () => void, mode?: number): void;

package/dist/agent/file-checkpoint/write-policy.d.ts

@@ -0,0 +1,3 @@
+import type { ToolHandlerContext } from '../tools/types.js';
+export declare function validatedWriteTarget(path: string, context: ToolHandlerContext | undefined, cwd?: string): Promise<string>;
+export declare function currentWritePolicy(dispatcher: object | undefined, fallback: ToolHandlerContext): ToolHandlerContext;

package/dist/agent/provider.d.ts

@@ -118,6 +118,7 @@ export type ProviderEvent = {
     sessionId?: string;
 } | {
     type: 'turn.completed';
+    userMessageId?: string;
     usage: ProviderUsage;
     sessionId?: string;
 } | {
@@ -156,6 +157,7 @@ export type ProviderEvent = {
 };
 export interface ProviderUserTurn {
     content: string | ContentBlockParam[];
+    userMessageId?: string;
     sessionId?: string;
 }
 export interface ProviderQueryArgs {

package/dist/agent/providers/anthropic-direct/query/session-state.d.ts

@@ -14,6 +14,8 @@ export interface SessionState {
     autoCompactThreshold: number | undefined;
     readonly journalSync: JournalSync<MessageParam>;
     readonly messageJournal: MessageJournal | undefined;
+    enableFileCheckpointing: boolean;
+    currentTurnId: string | undefined;
 }
 export declare function createSessionState(opts: {
     model: string;
@@ -25,4 +27,5 @@ export declare function createSessionState(opts: {
     autoCompactThreshold?: number;
     initialUsageInputTokens?: number;
     messageJournal?: MessageJournal;
+    enableFileCheckpointing?: boolean;
 }): SessionState;

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

@@ -46,5 +46,6 @@ export interface AnthropicDirectQueryOptions {
     throttleQueue?: import('./throttle-queue.js').ThrottleQueue;
     fastModeController?: import('../../fast-mode.js').FastModeController;
     beforeNextRound?: () => string | undefined;
+    enableFileCheckpointing?: boolean;
 }
 export declare function starterModels(): ProviderModelInfo[];

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

@@ -57,7 +57,7 @@ export declare class AnthropicDirectQuery implements ProviderQuery {
         oldAccountId: string;
         swapped: boolean;
     } | null>;
-    rewindFiles(_userMessageId: string, _options?: {
+    rewindFiles(userMessageId: string, options?: {
         dryRun?: boolean;
     }): Promise<ProviderRewindResult>;
     compact(): Promise<ProviderCompactResult>;

package/dist/agent/providers/openai-compatible/query.d.ts

@@ -56,6 +56,7 @@ export declare class OpenAICompatibleQuery implements ProviderQuery, TurnDriverC
     get closed(): boolean;
     lastUsage: ProviderUsage | null;
     private readonly autoCompactThreshold;
+    private readonly checkpoint;
     constructor(opts: OpenAICompatibleQueryOptions);
     activeOpenAITools(): OpenAIFunctionTool[] | undefined;
     [Symbol.asyncIterator](): AsyncIterator<ProviderEvent>;
@@ -81,7 +82,7 @@ export declare class OpenAICompatibleQuery implements ProviderQuery, TurnDriverC
     getContextUsage(): Promise<ProviderContextUsage>;
     mcpServerStatus(): Promise<ProviderMcpServerStatus[]>;
     accountInfo(): Promise<ProviderAccountInfo>;
-    rewindFiles(_userMessageId: string, _options?: {
+    rewindFiles(userMessageId: string, options?: {
         dryRun?: boolean;
     }): Promise<ProviderRewindResult>;
     journalSnapshot(): ReturnType<OpenAIJournalWiring['snapshot']>;

package/dist/agent/providers/openai-compatible/query.file-checkpoint.d.ts

@@ -0,0 +1,14 @@
+import type { ToolHandlerContext } from '../../tools/types.js';
+import type { ProviderEvent, ProviderRewindResult } from '../../provider.js';
+export declare class FileCheckpointState {
+    private readonly enabled;
+    private readonly sessionId;
+    private currentTurnId;
+    constructor(enabled: boolean, sessionId: string);
+    begin(dispatcher: object | undefined, userMessageId?: string): string | undefined;
+    end(dispatcher: object | undefined): void;
+    events(events: AsyncIterable<ProviderEvent>, dispatcher: object | undefined, checkpointId: string | undefined): AsyncGenerator<ProviderEvent>;
+    rewind(userMessageId: string, options?: {
+        dryRun?: boolean;
+    }, writePolicy?: ToolHandlerContext): Promise<ProviderRewindResult>;
+}

package/dist/agent/providers/shared/chain-provider-close.d.ts

@@ -0,0 +1,2 @@
+import type { ProviderQuery } from '../../provider.js';
+export declare function chainProviderClose<Q extends ProviderQuery>(query: Q, closeProvider: () => void): Q;

package/dist/agent/session/stream-consumer.d.ts

@@ -20,5 +20,5 @@ export declare function parsePersistedOutput(content: string): {
     sizeBytes: number;
     absolutePath: string;
 } | null;
-export declare function usageToMetadata(usage: ProviderUsage, sessionId: string | undefined): ResponseMetadata;
+export declare function usageToMetadata(usage: ProviderUsage, sessionId: string | undefined, userMessageId?: string): ResponseMetadata;
 export declare function transformProviderEvent(event: ProviderEvent, deps: TransformDeps): OutputEvent | null;

package/dist/agent/tools/compose-agent-resolve.d.ts

@@ -1,11 +1,17 @@
 import type { AgentRegistry } from '../agents/index.js';
 import type { CanUseTool } from '../types.js';
+export { COMPOSE_LEAF_STRIPPED_TOOLS } from './nesting.js';
+export declare const COMPOSE_LEAF_NOTICE: string;
 export interface ResolvedComposeAgent {
     replaySafe?: boolean;
     systemPrompt?: string;
+    leafNotice?: string;
     namedAgentModel?: string;
     canUseTool?: CanUseTool;
+    namedAgentAllowedTools?: string[];
     readOnlyBash?: true;
 }
 export declare function buildAllowlistCanUseTool(allowed: string[]): CanUseTool;
 export declare function resolveComposeNodeAgent(agentType: string | undefined, agentRegistry: AgentRegistry | undefined): ResolvedComposeAgent;
+export declare function resolveComposeAgentPrompt(agent: ResolvedComposeAgent, basePrompt: string): string;
+export declare function resolvedAgentToolRestriction(agent: ResolvedComposeAgent): Pick<ResolvedComposeAgent, 'canUseTool' | 'namedAgentAllowedTools'> | Record<string, never>;

package/dist/agent/tools/compose-node-provider.d.ts

@@ -4,6 +4,7 @@ import type { CanUseTool } from '../types.js';
 import type { AgentModelInput } from '../types/model-types.js';
 export interface ComposeNodeRestrictions {
     canUseTool?: CanUseTool;
+    namedAgentAllowedTools?: string[];
     readOnlyBash?: true;
 }
 export declare function resolveComposeNodeProvider(nodeModel: AgentModelInput, workspaceStore: WorkspaceStore | undefined, openaiBaseUrl: string | undefined, restrictions?: ComposeNodeRestrictions): {

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

@@ -16,6 +16,7 @@ import type { TraceSink } from '../trace/index.js';
 import { type UserAttention } from './user-yield.js';
 import { type DetachableToolRegistry } from './detach-bash.js';
 import type { ProcessJobRegistry } from '../shell-jobs/process-jobs.js';
+import { FileCheckpointWiring } from './dispatcher.file-checkpoint.js';
 export { defaultConcurrencyClassifier } from './dispatch-batching.js';
 export declare const REPEAT_CIRCUIT_BREAKER_THRESHOLD = 8;
 export { DEFAULT_MAX_CONCURRENT_SAFE_TOOL_CALLS, resolveMaxConcurrentSafeToolCalls };
@@ -79,6 +80,7 @@ export declare class SessionToolDispatcher implements ToolDispatcher {
     private readonly userAttention;
     private readonly detachRegistry;
     private readonly processJobs;
+    readonly fileCheckpointWiring: FileCheckpointWiring;
     private readonly bashOutputTailReporter;
     private readonly gateState;
     private readonly repeatFailureGuard;

package/dist/agent/tools/dispatcher.file-checkpoint.d.ts

@@ -0,0 +1,9 @@
+import type { FileCheckpointRegistry } from '../file-checkpoint/file-checkpoint.js';
+export type { FileCheckpointRegistry };
+export declare class FileCheckpointWiring {
+    private _registry;
+    set(registry: FileCheckpointRegistry | undefined): void;
+    contextSpread(): {
+        fileCheckpoint: FileCheckpointRegistry;
+    } | Record<never, never>;
+}

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

@@ -35,10 +35,12 @@ 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 const COMPOSE_LEAF_STRIPPED_TOOLS: ReadonlySet<string>;
 export interface BuildComposeNodeProviderOpts {
     openaiBaseUrl?: string;
     readOnlyBash?: true;
     canUseTool?: CanUseTool;
+    namedAgentAllowedTools?: string[];
 }
 export declare function buildComposeNodeProvider(model: AgentModelInput | undefined, workspaceStore: WorkspaceStore | undefined, opts?: BuildComposeNodeProviderOpts): 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, pluginConfigs?: SdkPluginConfig[], skillAllowlist?: readonly string[], hookRegistry?: HookRegistry): (depth: number, maxDepth: number, signal: AbortSignal, inheritedCwd?: string, inheritedReadScope?: ReadScopeInputs, skillDispatchName?: string, journalParent?: JournalParent, rootSessionId?: string) => SkillExecutor;

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

@@ -8,6 +8,7 @@ import type { SpawnedPidRegistry } from './handlers/pid-registry.js';
 import type { UserAttention } from './user-yield.js';
 import type { DetachableToolRegistry } from './detach-registry.js';
 import type { ProcessJobRegistry } from '../shell-jobs/process-jobs.js';
+import type { FileCheckpointRegistry } from '../file-checkpoint/file-checkpoint.js';
 export interface ToolHandlerContext {
     resolveBase?: string;
     cwd?: string;
@@ -23,6 +24,7 @@ export interface ToolHandlerContext {
     userAttention?: UserAttention;
     detachRegistry?: DetachableToolRegistry;
     processJobs?: ProcessJobRegistry;
+    fileCheckpoint?: FileCheckpointRegistry;
 }
 export type ToolHandler = (input: unknown, signal: AbortSignal, context?: ToolHandlerContext) => Promise<ToolResult>;
 export type ConcurrencyClassifier = (toolName: string, input?: unknown) => boolean;

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

@@ -2,6 +2,7 @@ import type { DiffPayload } from '../../utils/diff.js';
 import type { ToolFailureClass } from '../trace/types.js';
 export type MessageRole = 'user' | 'assistant';
 export interface ResponseMetadata extends Record<string, unknown> {
+    userMessageId?: string;
     sessionId?: string;
     stopReason?: string | null;
     resultSubtype?: string;

package/dist/cli/first-run.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from 'commander';
+export declare function needsCredentialGate(command: Command): boolean;
+export declare function runFirstRunDetector(command: Command): Promise<void>;
+export declare function installCredentialGate(program: Command): void;

package/dist/cli/index.d.ts

@@ -1,4 +1,3 @@
 #!/usr/bin/env node
 export { parseThinking, parseEffort, parseBudget, parseMaxOutputTokens, getMaxBudgetUsd, getTaskBudget, getMaxOutputTokens, } from './shared-helpers.js';
-export declare function needsCredentialGate(argv: string[]): boolean;
-export declare function runFirstRunDetector(argv?: string[]): Promise<void>;
+export { needsCredentialGate, runFirstRunDetector } from './first-run.js';

package/dist/cli/provider-selection.d.ts

@@ -0,0 +1,7 @@
+import { type BundledProviderName } from '../agent/providers/index.js';
+export interface CliProviderContext {
+    model?: string;
+    openaiBaseUrl?: string;
+}
+export declare function selectCliProvider(raw: string | undefined, opts?: CliProviderContext): string | undefined;
+export declare function cliProviderFamily(raw: string | undefined, opts?: CliProviderContext): BundledProviderName;