agent-afk 5.296.3 → 5.296.5

package/dist/agent/daemon/tool-health-task.d.ts

@@ -1,4 +1,5 @@
 import type { TelemetryRecord, TelemetryTrigger } from './scheduler.js';
+export declare function _resetToolHealthAlertCooldownForTests(): void;
 export declare const TOOL_HEALTH_LOOKBACK_MS: number;
 export declare const TOOL_HEALTH_MIN_SESSIONS = 2;
 export declare const TOOL_HEALTH_COOLDOWN_MS: number;

package/dist/agent/tools/hooks/path-approval-hook.d.ts

@@ -1,9 +1,21 @@
-import type { HookHandler } from '../../hooks.js';
+import type { GrantManager } from '../grant-manager.js';
+import type { HookDecision, HookHandler } from '../../hooks.js';
+export { extractCandidatePath, extractAllPaths } from './path-approval-hook.prompt.js';
 export type PathApprovalSurface = 'repl' | 'telegram' | 'web' | 'unknown';
 export interface PathApprovalHookOptions {
     getCwd: () => string | undefined;
     surface: PathApprovalSurface;
 }
+export interface PathApprovalState {
+    sessionApproved: Set<string>;
+    onceApproved: Map<string, {
+        resolvedPath: string;
+        mode: 'read' | 'write';
+        capturedCwd: string | undefined;
+    }>;
+    inFlight: Map<string, Promise<HookDecision>>;
+    lastSeenGrantManager: GrantManager | undefined;
+}
 export interface PathApprovalHookHandlers {
     preToolUse: HookHandler;
     postToolUse: HookHandler;

package/dist/agent/tools/hooks/path-approval-hook.prompt.d.ts

@@ -0,0 +1,18 @@
+import type { GrantManager } from '../grant-manager.js';
+import type { HookDecision } from '../../hooks.js';
+import type { PathApprovalState, PathApprovalSurface } from './path-approval-hook.js';
+export declare function extractCandidatePath(toolName: string, input: Record<string, unknown>): string | undefined;
+export declare function extractAllPaths(toolName: string, input: Record<string, unknown>): string[];
+export declare function pathApprovalKey(mode: 'read' | 'write', resolvedPath: string): string;
+export declare function promptForApproval(args: {
+    toolName: string;
+    resolvedPath: string;
+    allPaths?: string[];
+    capturedCwd: string | undefined;
+    mode: 'read' | 'write';
+    grantManager: GrantManager;
+    state: PathApprovalState;
+    surface: PathApprovalSurface;
+    signal?: AbortSignal;
+    sessionId?: string;
+}): Promise<HookDecision>;

package/dist/agent/tools/readonly-bash.d.ts

@@ -1,3 +1,4 @@
+export { tokenizedSegmentReason } from './readonly-bash.tokenizer.js';
 export declare function classifyBashCommand(command: string): {
     mutating: boolean;
     reason?: string;

package/dist/agent/tools/readonly-bash.tokenizer.d.ts

@@ -0,0 +1,10 @@
+export interface CmdSegment {
+    readonly command: string;
+    readonly argv: readonly string[];
+}
+export declare function baseName(cmd: string): string;
+export declare function tokenizeSegments(command: string): string[][];
+export declare function resolveSegment(rawTokens: readonly string[], vars: Map<string, string>): CmdSegment | null;
+export declare function gitSegmentReason(argv: readonly string[]): string | null;
+export declare function curlSegmentMutating(seg: CmdSegment): boolean;
+export declare function tokenizedSegmentReason(command: string): string | null;

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

@@ -1,3 +1,4 @@
+export { renderReceiptMarkdown } from './receipt.render.js';
 import type { HookHandler } from '../hooks.js';
 import { type ClosureReason, type ToolFailureClass, type TraceEvent, type TraceEventKind } from './types.js';
 export declare const RECEIPT_SCHEMA_VERSION: 1;
@@ -78,7 +79,6 @@ export declare function receiptPathsFor(tracePath: string): {
     mdPath: string;
 };
 export declare function generateReceipt(events: TraceEvent[], meta: ReceiptMeta): RunReceipt;
-export declare function renderReceiptMarkdown(r: RunReceipt): string;
 export interface WriteRunReceiptOptions {
     tracePath: string;
     sessionId?: string;

package/dist/agent/trace/receipt.render.d.ts

@@ -0,0 +1,2 @@
+import type { RunReceipt } from './receipt.js';
+export declare function renderReceiptMarkdown(r: RunReceipt): string;

package/dist/agent/worktree/worktree-sweep.classify.d.ts

@@ -0,0 +1,43 @@
+export declare const MIN_EMPTY_AGE_MS = 3600000;
+export type DirtyReason = 'clean' | 'uncommitted changes' | 'git status failed' | `non-rebuildable ignored files: ${string}` | 'ignored-file probe failed';
+export interface WorktreeMeta {
+    owner: 'interactive' | 'diagnose' | string;
+    pid?: number;
+    createdAt: string;
+    baseSha?: string;
+    baseBranch?: string;
+    preservedReason?: 'dirty' | 'commits-ahead' | 'ignored-local-state';
+    preservedAt?: string;
+    commitsAheadAtPreserve?: number;
+}
+export interface WorktreeCandidate {
+    path: string;
+    head?: string;
+    branch?: string;
+    locked: boolean;
+    prunable: boolean;
+    meta?: WorktreeMeta;
+    ageMs: number;
+    isDirty: boolean;
+    dirtyReason: DirtyReason;
+    commitsAhead: number;
+    commitsUnpushed: number;
+    ownerLiveness: 'alive' | 'dead' | 'unknown';
+}
+export type WorktreeVerdict = 'empty' | 'stale-clean' | 'stale-dirty' | 'locked' | 'active' | 'orphaned-dir' | 'orphaned-dir-preserved' | 'orphaned-registration' | 'dead-owner';
+export declare const MAX_TRUSTED_PID_AGE_MS: number;
+export { isProcessAlive } from '../process-liveness.js';
+export declare function realpathSafe(p: string): string;
+export declare function isPathWithin(child: string, parent: string): boolean;
+export declare function shortBranchName(branch: string): string;
+export interface ParsedWorktree {
+    path: string;
+    head: string;
+    branch: string;
+    locked: boolean;
+    lockReason?: string;
+    prunable: boolean;
+    isBare: boolean;
+}
+export declare function parseWorktreeList(stdout: string): ParsedWorktree[];
+export declare function classifyCandidate(candidate: WorktreeCandidate, maxAgeDaysClean: number, maxAgeDaysDirty: number): WorktreeVerdict;

package/dist/agent/worktree/worktree-sweep.d.ts

@@ -1,4 +1,6 @@
 import { type PresenceRecord } from '../awareness/presence.js';
+import { type WorktreeVerdict } from './worktree-sweep.classify.js';
+export { MIN_EMPTY_AGE_MS } from './worktree-sweep.classify.js';
 export type ExecFileFn = (file: string, args: string[], opts?: {
     cwd?: string;
     maxBuffer?: number;
@@ -7,7 +9,6 @@ export type ExecFileFn = (file: string, args: string[], opts?: {
     stdout: string;
     stderr: string;
 }>;
-type WorktreeVerdict = 'empty' | 'stale-clean' | 'stale-dirty' | 'locked' | 'active' | 'orphaned-dir' | 'orphaned-dir-preserved' | 'orphaned-registration' | 'dead-owner';
 export interface SweepOptions {
     execFile: ExecFileFn;
     repoRoot: string;
@@ -33,6 +34,4 @@ export interface SweepResult {
     candidates: SweepCandidateSummary[];
     contested?: boolean;
 }
-export declare const MIN_EMPTY_AGE_MS = 3600000;
 export declare function runSweep(options: SweepOptions): Promise<SweepResult>;
-export {};

package/dist/agent/worktree/worktree-sweep.lock.d.ts

@@ -0,0 +1,5 @@
+export declare function countPriorSuccessfulRuns(telemetryPath: string): Promise<number>;
+export declare class LockContestedError extends Error {
+    constructor(lockPath: string);
+}
+export declare function acquireLock(lockPath: string): Promise<() => Promise<void>>;

package/dist/cli/commands/chat.mcp-setup.d.ts

@@ -0,0 +1,8 @@
+import { McpManager } from '../../agent/mcp/index.js';
+import type { TraceWriter } from '../../agent/trace/writer.js';
+export interface ChatMcpSetupParams {
+    worktreeCwd: string | undefined;
+    mcpConfigOverride: string | undefined;
+    traceWriter: TraceWriter | undefined;
+}
+export declare function connectMcpForChat(params: ChatMcpSetupParams): Promise<McpManager | undefined>;

package/dist/cli/commands/chat.response-output.d.ts

@@ -0,0 +1,24 @@
+import type { AgentSession } from '../../agent/session.js';
+import type { SessionStats } from '../slash/types.js';
+import type { AgentModelInput } from '../../agent/types.js';
+import type { Ora } from 'ora';
+export interface StreamJsonPathParams {
+    session: AgentSession;
+    message: string;
+    stats: SessionStats;
+    maybePublish: (reviewText: string, errored: boolean) => Promise<void>;
+}
+export declare function runStreamJsonPath(params: StreamJsonPathParams): Promise<void>;
+export interface TextResponseParams {
+    session: AgentSession;
+    message: string;
+    stats: SessionStats;
+    sessionModel: AgentModelInput;
+    format: string;
+    streamFlag: boolean;
+    receiptSessionLabel: string | undefined;
+    receiptTracePath: string | undefined;
+    maybePublish: (reviewText: string, errored: boolean) => Promise<void>;
+    spinner: Ora;
+}
+export declare function renderTextResponse(params: TextResponseParams): Promise<void>;

package/dist/cli/commands/chat.session-setup.d.ts

@@ -0,0 +1,46 @@
+import { AgentSession } from '../../agent/session.js';
+import { wireExecutors } from '../../agent/session/wire-executors.js';
+import { MemoryStore } from '../../agent/memory/index.js';
+import { StateStore } from '../../agent/state/state-store.js';
+import { WorkspaceStore } from '../../agent/workspace/workspace-store.js';
+import type { AgentModelInput, ThinkingConfig, EffortLevel } from '../../agent/types.js';
+import type { TraceWriter } from '../../agent/trace/writer.js';
+import type { McpManager } from '../../agent/mcp/index.js';
+import type { PermissionMode } from '../../agent/types/sdk-types.js';
+import type { ProviderRouteHints } from '../../agent/providers/index.js';
+export interface ChatSessionSetupParams {
+    model: AgentModelInput;
+    sessionModel: AgentModelInput;
+    apiKey: string | undefined;
+    systemPrompt: string | undefined;
+    systemPromptSource: string | undefined;
+    basePrompt: string | undefined;
+    providerHints: ProviderRouteHints | undefined;
+    providerRaw: string | undefined;
+    thinking: ThinkingConfig | undefined;
+    effort: EffortLevel | undefined;
+    maxBudgetUsd: number | undefined;
+    taskBudget: number | undefined;
+    maxOutputTokens: number | undefined;
+    maxToolUseIterations: number | undefined;
+    worktreeCwd: string | undefined;
+    traceWriter: TraceWriter | undefined;
+    mcpManager: McpManager | undefined;
+    resumeConfig: Record<string, unknown>;
+    permissionMode: PermissionMode | undefined;
+    dangerouslySkipPermissions: boolean | undefined;
+    maxTurns: number;
+    temperature: number | undefined;
+    baseUrl: string | undefined;
+    openaiBaseUrl: string | undefined;
+    autoResumeOnUsageLimit: boolean | undefined;
+}
+export interface ChatSessionSetupResult {
+    session: AgentSession;
+    rootManager: ReturnType<typeof wireExecutors>['rootManager'];
+    composeExecutor: ReturnType<typeof wireExecutors>['composeExecutor'];
+    sharedMemoryStore: MemoryStore;
+    sharedStateStore: StateStore;
+    workspaceStore: WorkspaceStore | undefined;
+}
+export declare function buildChatSession(params: ChatSessionSetupParams): Promise<ChatSessionSetupResult>;

package/dist/cli/commands/chat.stdin-stream.d.ts

@@ -0,0 +1,3 @@
+export declare const STDIN_MAX_BYTES: number;
+export declare function readStdin(): Promise<string>;
+export declare function writeAndDrain(stream: NodeJS.WritableStream, chunk: string): Promise<void>;

package/dist/cli/commands/farm.d.ts

@@ -5,12 +5,12 @@ import { scoreBranch, writeScore } from '../../skills/score/index.js';
 import { writeFarmFact } from '../../skills/score/memory-write.js';
 import { sendFarmDigest } from '../../skills/score/digest.js';
 import { createDefaultTraceWriter } from '../../agent/trace/factory.js';
+import { printSummary, formatScore } from './farm.summary.js';
+export { FarmIsolationViolation } from './farm.escape-check.js';
+export type { BranchResult } from './farm.summary.js';
+export { formatScore, printSummary };
 declare function getCommitCount(worktreePath: string, baseSha: string): Promise<number>;
 declare function getSourceRepoDirtyFiles(sourceCwd: string): Promise<string[]>;
-export declare class FarmIsolationViolation extends Error {
-    readonly dirtyFiles: string[];
-    constructor(dirtyFiles: string[]);
-}
 export interface RunFarmOptions {
     task: string;
     branches: number;
@@ -37,4 +37,3 @@ export interface RunFarmOptions {
 }
 export declare function runFarm(opts: RunFarmOptions): Promise<void>;
 export declare function registerFarmCommand(program: Command): void;
-export {};

package/dist/cli/commands/farm.escape-check.d.ts

@@ -0,0 +1,4 @@
+export declare class FarmIsolationViolation extends Error {
+    readonly dirtyFiles: string[];
+    constructor(dirtyFiles: string[]);
+}

package/dist/cli/commands/farm.run-record.d.ts

@@ -0,0 +1,4 @@
+import type { FarmRunRecord } from '../../skills/score/farm-run-record.js';
+import type { FarmManifest } from '../../agent/worktree.js';
+import type { BranchResult } from './farm.summary.js';
+export declare function buildFarmRunRecord(manifest: FarmManifest, branchResults: BranchResult[], startedAt: string): FarmRunRecord;

package/dist/cli/commands/farm.summary.d.ts

@@ -0,0 +1,11 @@
+import { type BranchScore } from '../../skills/score/index.js';
+import type { CreatedBranch } from '../../agent/worktree.js';
+export interface BranchResult {
+    index: number;
+    ok: boolean;
+    commitCount: number;
+    error?: string;
+    score?: BranchScore | null;
+}
+export declare function formatScore(score: BranchScore | null | undefined): string;
+export declare function printSummary(taskName: string, taskSlug: string, branches: CreatedBranch[], branchResults: BranchResult[]): void;

package/dist/cli/commands/interactive/worktree.cleanup.d.ts

@@ -0,0 +1,11 @@
+import type { ExecFileFn } from './worktree.js';
+import type { WorktreeDisposition } from './worktree-disposition.js';
+export interface WorktreeCleanupParams {
+    worktreePath: string;
+    branch: string;
+    repoRoot: string;
+    execFile: ExecFileFn;
+    force?: boolean;
+    disposition?: WorktreeDisposition;
+}
+export declare function runWorktreeCleanup(params: WorktreeCleanupParams): Promise<void>;

package/dist/cli/commands/interactive/worktree.errors.d.ts

@@ -0,0 +1,5 @@
+export interface ExecError extends Error {
+    stderr?: string;
+    stdout?: string;
+}
+export declare function isExecError(value: unknown): value is ExecError;

package/dist/cli/commands/interactive/worktree.refs.d.ts

@@ -0,0 +1,5 @@
+import type { ExecFileFn } from './worktree.js';
+export declare function fetchIfRemoteRef(repoRoot: string, ref: string, execFile: ExecFileFn): Promise<void>;
+export declare function resolveRefToSha(repoRoot: string, ref: string, execFile: ExecFileFn): Promise<string>;
+export declare function resolveRefToShaOrUndefined(repoRoot: string, ref: string, execFile: ExecFileFn): Promise<string | undefined>;
+export declare function detectDefaultBaseRef(repoRoot: string, execFile: ExecFileFn): Promise<string | undefined>;