agent-afk 5.338.1 → 5.339.0

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

@@ -0,0 +1,5 @@
+import type { FileCheckpointRegistry } from './file-checkpoint.js';
+export interface BashCheckpoint {
+    finish(partialReason?: string): Promise<void>;
+}
+export declare function beginBashCheckpoint(registry: FileCheckpointRegistry | undefined, cwd: string, skipReason?: string, signal?: AbortSignal): Promise<BashCheckpoint>;

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

@@ -1,5 +1,11 @@
 export interface FileCheckpointRegistry {
     snapshotFile(absPath: string): Promise<void>;
+    recordPriorState(absPath: string, prior: {
+        bytes: Buffer;
+        mode: number;
+    } | null): Promise<void>;
+    readonly sessionId: string;
+    readonly stateDir?: string;
     readonly turnId: string;
     touchedPaths(): string[];
 }

package/dist/agent/file-checkpoint/git-snapshot.attrs.d.ts

@@ -0,0 +1,9 @@
+import { type Failure, type GitCtx } from './git-snapshot.exec.js';
+export declare function _setAttrSourceSupportForTests(value: boolean | undefined): void;
+export declare function attrSourceSupported(ctx: GitCtx, cwd: string, emptyTree: string): Promise<boolean | null>;
+export declare function hasConvertingAttribute(text: string): boolean;
+export declare function findConverting(files: readonly string[]): Promise<string | null>;
+export declare function workTreeAttributeFiles(ctx: GitCtx, repoRoot: string): Promise<string[] | Failure>;
+export declare function globalAttributeFiles(ctx: GitCtx, cwd: string): Promise<string[]>;
+export declare function systemAttributeFile(ctx: GitCtx, cwd: string): Promise<string | undefined>;
+export declare function captureAttributeCheck(ctx: GitCtx, repoRoot: string, infoAttributes: string, supported: boolean): Promise<Failure | null>;

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

@@ -0,0 +1,49 @@
+export { MAX_BLOB_BYTES } from './git-snapshot.diff.js';
+export type GitSnapshotFailure = 'not-git' | 'timeout' | 'unsafe-attributes' | 'error';
+export interface CaptureOptions {
+    cwd: string;
+    objectDir: string;
+    indexFile: string;
+    timeoutMs: number;
+}
+export type CaptureResult = {
+    ok: true;
+    repoRoot: string;
+    tree: string;
+    partial?: string;
+} | {
+    ok: false;
+    reason: GitSnapshotFailure;
+    detail?: string;
+};
+export interface DiffOptions {
+    repoRoot: string;
+    objectDir: string;
+    before: string;
+    after: string;
+    maxFiles: number;
+    timeoutMs: number;
+}
+export interface TreeChange {
+    absPath: string;
+    prior: {
+        bytes: Buffer;
+        mode: number;
+    } | null;
+}
+export interface SkippedChange {
+    absPath: string;
+    reason: string;
+}
+export type DiffResult = {
+    ok: true;
+    changes: TreeChange[];
+    skipped: SkippedChange[];
+    truncated: boolean;
+} | {
+    ok: false;
+    reason: GitSnapshotFailure;
+    detail?: string;
+};
+export declare function captureWorkspaceTree(options: CaptureOptions): Promise<CaptureResult>;
+export declare function diffTrees(options: DiffOptions): Promise<DiffResult>;

package/dist/agent/file-checkpoint/git-snapshot.diff.d.ts

@@ -0,0 +1,27 @@
+import { type GitCtx } from './git-snapshot.exec.js';
+import type { DiffOptions, DiffResult } from './git-snapshot.js';
+export interface RawEntry {
+    oldMode: string;
+    newMode: string;
+    oldSha: string;
+    status: string;
+    gitPath: string;
+}
+export declare function parseRawDiff(buf: Buffer, onNonUtf8Path?: (rawPath: Buffer) => void): RawEntry[] | null;
+export declare function toAbsPath(repoRoot: string, gitPath: string): string;
+type Classified = {
+    kind: 'added';
+} | {
+    kind: 'prior';
+    mode: number;
+} | {
+    kind: 'skip';
+    reason: string;
+};
+export declare function classifyEntry(e: RawEntry): Classified;
+export declare function parseCatFileBatch(buf: Buffer, count: number): Buffer[] | null;
+export declare const MAX_BLOB_BYTES: number;
+export declare function _setMaxBlobBytesForTests(value: number | undefined): void;
+export declare function parseBatchCheck(buf: Buffer, count: number): number[] | null;
+export declare function diffWithCtx(options: DiffOptions, ctx: GitCtx): Promise<DiffResult>;
+export {};

package/dist/agent/file-checkpoint/git-snapshot.exec.d.ts

@@ -0,0 +1,34 @@
+import type { GitSnapshotFailure } from './git-snapshot.js';
+export type GitEnv = Record<string, string | undefined>;
+export declare const GIT_SNAPSHOT_GLOBAL_ARGS: readonly string[];
+export declare function snapshotArgs(hooksDir: string): string[];
+export interface GitCtx {
+    args: readonly string[];
+    env: GitEnv;
+    deadline: number;
+}
+export declare function buildSnapshotEnv(): GitEnv;
+export interface GitRun {
+    code: number | null;
+    stdout: Buffer;
+    stderr: string;
+    timedOut: boolean;
+    spawnError?: NodeJS.ErrnoException;
+}
+export interface RunOptions {
+    cwd: string;
+    env: GitEnv;
+    deadline: number;
+    input?: Buffer | string;
+}
+export declare function runGit(args: readonly string[], opts: RunOptions): Promise<GitRun>;
+export interface Failure {
+    ok: false;
+    reason: GitSnapshotFailure;
+    detail?: string;
+}
+export declare function classifyFailure(run: GitRun, what: string): Failure;
+export declare function isOk(run: GitRun): boolean;
+export declare function firstLine(s: string): string;
+export declare function runIn(ctx: GitCtx, cwd: string, args: readonly string[], input?: string): Promise<GitRun>;
+export declare function quoteAlternate(dir: string, sep?: string): string;

package/dist/agent/file-checkpoint/git-snapshot.index.d.ts

@@ -0,0 +1,6 @@
+import { type GitCtx } from './git-snapshot.exec.js';
+export declare function withIndexLock<T>(indexFile: string, fn: () => Promise<T>): Promise<T>;
+export declare function hasFlaggedEntries(lsFilesV: Buffer): boolean;
+export declare function seedingSafe(ctx: GitCtx, repoRoot: string, infoAttributes: string): Promise<boolean>;
+export declare function preparePrivateIndex(indexFile: string, repoRoot: string, seed: () => Promise<string | null>): Promise<void>;
+export declare function discardPrivateIndex(indexFile: string): Promise<void>;

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

@@ -2,6 +2,7 @@ import { type FileSnapshot } from './file-checkpoint.js';
 export interface RewindPlan {
     snapshots: FileSnapshot[];
     expected: Map<string, string | null>;
+    uncaptured: string[];
 }
 export type RewindPlanResult = {
     plan: RewindPlan;

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

@@ -1,4 +1,12 @@
 export type PathHashes = Record<string, string | null>;
+export type BashLogEntry = {
+    kind: 'bash';
+    turnId: string;
+    status: 'captured' | 'partial' | 'skipped';
+    reason?: string;
+    files?: number;
+    ts: number;
+};
 export type TurnLogEntry = {
     kind: 'turn';
     turnId: string;
@@ -12,7 +20,7 @@ export type TurnLogEntry = {
     kind: 'restore';
     paths: PathHashes;
     ts: number;
-};
+} | BashLogEntry;
 export declare function hashBytes(bytes: Buffer | null): string | null;
 export declare function currentHash(absPath: string): string | null;
 export declare function appendTurnLog(sessionId: string, entry: TurnLogEntry, stateDir?: string): boolean;

package/dist/agent/hooks.d.ts

@@ -6,6 +6,7 @@ export interface HookDecision {
     continue?: boolean;
     decision?: 'block' | 'approve';
     reason?: string;
+    riskCategory?: import('./risk-classifier.js').RiskCategory;
     injectContext?: string;
     updatedInput?: Record<string, unknown>;
 }

package/dist/agent/provider.d.ts

@@ -281,6 +281,7 @@ export interface ProviderRewindResult {
     deletions?: number;
     failures?: RewindFileFailure[];
     conflicts?: string[];
+    uncaptured?: string[];
 }
 export interface RewindFileFailure {
     path: string;

package/dist/agent/providers/openai-compatible/system-prompt-wiring.d.ts

@@ -17,5 +17,15 @@ export interface SystemPromptWiringResult {
     initialSystemPrompt: string;
     rebuildAfterCwdChange: () => string;
     systemPromptRebuildFactory: (base: string | undefined) => string;
+    stableFragments: {
+        toolBase: string;
+        userSystem: string | undefined;
+        memoryPrompt: string;
+        workspacePrompt: string;
+        hotMemory: string;
+        goalPrompt: string;
+        manifest: string;
+        agentTypeListing: string;
+    };
 }
 export declare function buildSystemPromptWiring(args: SystemPromptWiringArgs): SystemPromptWiringResult;

package/dist/agent/providers/shared/prompt-fragment-tokens.d.ts

@@ -0,0 +1,23 @@
+import type { TraceSink } from '../../trace/writer.js';
+export interface PromptFragments {
+    toolBase?: string;
+    userSystem?: string | null;
+    memoryPrompt?: string;
+    workspacePrompt?: string;
+    hotMemory?: string;
+    goalPrompt?: string;
+    environment?: string;
+    manifest?: string;
+    agentTypeListing?: string;
+}
+export declare function logFragmentTokens(traceWriter: TraceSink | undefined, fragments: PromptFragments): void;
+export declare function logStablePartsTokens(traceWriter: TraceSink | undefined, parts: {
+    toolBase: string;
+    userSystem: string | null;
+    memoryPrompt: string;
+    workspacePrompt: string;
+    hotMemory: string;
+    goalPrompt?: string;
+    manifest: string;
+    agentTypeListing?: string;
+}): void;

package/dist/agent/risk-classifier.d.ts

@@ -1,5 +1,5 @@
 export type RiskLevel = 'safe' | 'medium' | 'high';
-export declare const RISK_CATEGORIES: readonly ["read-only", "bash-destructive", "bash-mutating", "bash-background", "workspace-write", "credential-path", "workspace-escape", "network-mutation", "schedule-mutation", "mcp-destructive", "mcp-unknown", "worktree-mutation", "browser-action", "remote-exec", "outbound-message", "unknown"];
+export declare const RISK_CATEGORIES: readonly ["read-only", "bash-destructive", "bash-mutating", "bash-background", "workspace-write", "credential-path", "workspace-escape", "network-mutation", "schedule-mutation", "mcp-destructive", "mcp-unknown", "worktree-mutation", "browser-action", "remote-exec", "outbound-message", "release-boundary", "unknown"];
 export type RiskCategory = (typeof RISK_CATEGORIES)[number];
 export interface RiskVerdict {
     level: RiskLevel;

package/dist/agent/session/session-meta.d.ts

@@ -8,6 +8,7 @@ export interface SessionMeta {
     provider?: string;
     startedAt?: number;
     afkVersion?: string;
+    forkedFrom?: string;
 }
 export declare function writeSessionMeta(meta: SessionMeta): Promise<void>;
 export declare function readSessionMeta(sessionId: string): SessionMeta | null;

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

@@ -135,6 +135,7 @@ export declare const HookDecisionPayloadSchema: z.ZodObject<{
         "browser-action": "browser-action";
         "remote-exec": "remote-exec";
         "outbound-message": "outbound-message";
+        "release-boundary": "release-boundary";
     }>>;
 }, z.core.$strip>;
 export declare const HookSummaryPayloadSchema: z.ZodObject<{
@@ -412,6 +413,7 @@ export declare const TraceEventInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject
             "browser-action": "browser-action";
             "remote-exec": "remote-exec";
             "outbound-message": "outbound-message";
+            "release-boundary": "release-boundary";
         }>>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
@@ -758,6 +760,7 @@ export declare const TraceEventInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject
             subagent_model_fallback: "subagent_model_fallback";
             round_cap_notice_dropped: "round_cap_notice_dropped";
             continuation_settle_degraded: "continuation_settle_degraded";
+            prompt_fragment_sizes: "prompt_fragment_sizes";
         }>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
@@ -869,6 +872,7 @@ export declare const TraceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             "browser-action": "browser-action";
             "remote-exec": "remote-exec";
             "outbound-message": "outbound-message";
+            "release-boundary": "release-boundary";
         }>>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
@@ -1243,6 +1247,7 @@ export declare const TraceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             subagent_model_fallback: "subagent_model_fallback";
             round_cap_notice_dropped: "round_cap_notice_dropped";
             continuation_settle_degraded: "continuation_settle_degraded";
+            prompt_fragment_sizes: "prompt_fragment_sizes";
         }>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;

package/dist/agent/trace/events.session-phase.d.ts

@@ -54,6 +54,7 @@ export declare const SessionPhaseNameSchema: z.ZodEnum<{
     subagent_model_fallback: "subagent_model_fallback";
     round_cap_notice_dropped: "round_cap_notice_dropped";
     continuation_settle_degraded: "continuation_settle_degraded";
+    prompt_fragment_sizes: "prompt_fragment_sizes";
 }>;
 export declare const SessionPhasePayloadSchema: z.ZodObject<{
     phase: z.ZodEnum<{
@@ -111,6 +112,7 @@ export declare const SessionPhasePayloadSchema: z.ZodObject<{
         subagent_model_fallback: "subagent_model_fallback";
         round_cap_notice_dropped: "round_cap_notice_dropped";
         continuation_settle_degraded: "continuation_settle_degraded";
+        prompt_fragment_sizes: "prompt_fragment_sizes";
     }>;
     durationMs: z.ZodOptional<z.ZodNumber>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;

package/dist/agent/trace/types.session-phase.d.ts

@@ -1,4 +1,4 @@
-export type SessionPhaseName = 'bootstrap_start' | 'bootstrap_done' | 'session_init_start' | 'session_init_done' | 'mcp_connect_start' | 'mcp_connect_done' | 'mcp_server_start' | 'mcp_server_done' | 'loop_start' | 'loop_end' | 'model_ttfb' | 'context_pressure_wind_down' | 'catalog_model_upgrade' | 'interrupt_halt' | 'rate_limit' | 'ttfb_timeout' | 'usage_limit_pause' | 'usage_limit_resume' | 'credential_swap' | 'overload_pause' | 'overload_resume' | 'idle_watchdog_fired' | 'pause_extension_granted' | 'suspected_loop' | 'compaction_disabled' | 'boot_warning' | 'workspace_subscribed' | 'workspace_delivery' | 'gate_shape' | 'session_id_assigned' | 'many_image_degraded' | 'stream_accepted_after_drop' | 'connection_retry' | 'connection_retry_exhausted' | 'connection_failure' | 'connection_recovered' | 'connection_budget_exhausted' | 'usage_notice' | 'tool_degraded' | 'strategy_nudge_fired' | 'stop_inject_dropped' | 'stop_hook_continuation' | 'stop_hook_cap_reached' | 'orphan_repair' | 'thinking_block_dropped' | 'background_process_started' | 'background_process_settled' | 'compose_recovery_decision' | 'compose_leaf_tools_stripped' | 'hook_block_repeat_tripped' | 'endpoint_semaphore_wait' | 'billing_settled' | 'subagent_model_fallback' | 'round_cap_notice_dropped' | 'continuation_settle_degraded';
+export type SessionPhaseName = 'bootstrap_start' | 'bootstrap_done' | 'session_init_start' | 'session_init_done' | 'mcp_connect_start' | 'mcp_connect_done' | 'mcp_server_start' | 'mcp_server_done' | 'loop_start' | 'loop_end' | 'model_ttfb' | 'context_pressure_wind_down' | 'catalog_model_upgrade' | 'interrupt_halt' | 'rate_limit' | 'ttfb_timeout' | 'usage_limit_pause' | 'usage_limit_resume' | 'credential_swap' | 'overload_pause' | 'overload_resume' | 'idle_watchdog_fired' | 'pause_extension_granted' | 'suspected_loop' | 'compaction_disabled' | 'boot_warning' | 'workspace_subscribed' | 'workspace_delivery' | 'gate_shape' | 'session_id_assigned' | 'many_image_degraded' | 'stream_accepted_after_drop' | 'connection_retry' | 'connection_retry_exhausted' | 'connection_failure' | 'connection_recovered' | 'connection_budget_exhausted' | 'usage_notice' | 'tool_degraded' | 'strategy_nudge_fired' | 'stop_inject_dropped' | 'stop_hook_continuation' | 'stop_hook_cap_reached' | 'orphan_repair' | 'thinking_block_dropped' | 'background_process_started' | 'background_process_settled' | 'compose_recovery_decision' | 'compose_leaf_tools_stripped' | 'hook_block_repeat_tripped' | 'endpoint_semaphore_wait' | 'billing_settled' | 'subagent_model_fallback' | 'round_cap_notice_dropped' | 'continuation_settle_degraded' | 'prompt_fragment_sizes';
 export interface SessionPhasePayload {
     phase: SessionPhaseName;
     durationMs?: number;

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

@@ -151,6 +151,7 @@ export interface RewindFilesResult {
         error: string;
     }>;
     conflicts?: string[];
+    uncaptured?: string[];
 }
 export interface IAgentSession {
     readonly state: SessionState;

package/dist/cli/terminal-compositor.frame.lines.d.ts

@@ -1,3 +1,3 @@
 import type { ChromeRows } from './terminal-compositor.frame.layout.js';
 export declare function buildFrameLines(chrome: ChromeRows, trimmedOverlay: string[], renderGap: boolean, dropdownRows: string[], hintRow: string | null, inputLine: string, margin?: string): string[];
-export declare function buildPickerFrameLines(chrome: ChromeRows, trimmedOverlay: string[], renderGap: boolean, pickerRows: string[], margin?: string): string[];
+export declare function buildPickerFrameLines(chrome: ChromeRows, trimmedOverlay: string[], renderGap: boolean, pickerRows: string[], margin?: string, bandWidth?: number): string[];

package/dist/cli/terminal-compositor.types.d.ts

@@ -51,6 +51,7 @@ export interface PickerController {
         meta?: boolean;
         sequence?: string;
     }) => void;
+    editable?: boolean;
 }
 export interface SubmissionPayload {
     text: string;