agent-afk 5.296.4 → 5.296.5

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>>;