agent-afk 5.344.0 → 5.346.0

package/dist/agent/daemon/session-spawn.d.ts

@@ -16,8 +16,8 @@ export declare function daemonTraceLabel(taskId: string): string;
 export declare function _resetDaemonDefaultCwdCache(): void;
 export declare function daemonDefaultCwd(): string;
 export declare function parseDaemonEnvLimits(rawMaxToolIters: string | undefined, rawMaxBudget: string | undefined): {
-    parsedMaxToolIters: number | undefined;
-    parsedMaxBudget: number | undefined;
+    parsedMaxToolIters: number;
+    parsedMaxBudget: number;
 };
 export declare function spawnDaemonSession(taskId: string, options: DaemonSpawnOptions): Promise<{
     session: AgentSession;

package/dist/agent/daemon-instance.lock.d.ts

@@ -1,6 +1,7 @@
 export declare class DaemonAlreadyRunningError extends Error {
     readonly ownerPid: number | null;
-    constructor(lockPath: string, ownerPid: number | null);
+    readonly windowsEpermAmbiguous: boolean;
+    constructor(lockPath: string, ownerPid: number | null, windowsEpermAmbiguous?: boolean);
 }
 export declare function getDaemonLockPath(instanceId?: string): string;
 export declare function acquireDaemonLock(lockPath?: string, platform?: string): Promise<() => Promise<void>>;

package/dist/agent/episodes/index.d.ts

@@ -3,4 +3,4 @@ export { extractEpisodeInput } from './extract.js';
 export { synthesizeEpisode } from './synthesize.js';
 export { writeEpisode, formatEpisodeContent, sanitizeNarrative } from './writer.js';
 import type { EpisodeRecord } from './types.js';
-export declare function synthesizeAndWriteEpisode(sessionId: string): Promise<EpisodeRecord>;
+export declare function synthesizeAndWriteEpisode(sessionId: string): Promise<EpisodeRecord | null>;

package/dist/agent/facets/index.d.ts

@@ -2,3 +2,4 @@ export { FACET_VERSION, SessionFacetSchema, StoredSessionInputSchema, FacetOutco
 export { deriveSessionFacet, type DeriveOptions } from './derive.js';
 export { getOrDeriveFacet, loadStoredSession, listSessionIds, type FacetStoreOptions, } from './store.js';
 export { createFacetSessionEndHook } from './session-end-hook.js';
+export { patchFacetDecisions } from './yield-probe.js';

package/dist/agent/facets/yield-probe.d.ts

@@ -9,4 +9,5 @@ export declare function getCurrentBranch(execFn: ExecFnYield, cwd?: string): Pro
 export declare function queryPrState(execFn: ExecFnYield, branch: string, cwd?: string): Promise<'merged' | 'open' | 'closed' | 'none' | 'error'>;
 export declare function queryPrStateByUrl(execFn: ExecFnYield, prUrl: string, cwd?: string): Promise<'merged' | 'open' | 'closed' | 'error'>;
 export declare function patchYieldFields(sessionId: string, produced_pr: boolean, pr_merged: boolean | null, cacheDir?: string, pr_url?: string | null): void;
+export declare function patchFacetDecisions(sessionId: string, decisions: string[], cacheDir?: string): void;
 export declare function writeFacetYield(sessionId: string, execFn: ExecFnYield, cwd?: string, cacheDir?: string): Promise<void>;

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

@@ -20,6 +20,10 @@ export type TurnLogEntry = {
     kind: 'restore';
     paths: PathHashes;
     ts: number;
+} | {
+    kind: 'tip';
+    turnId: string;
+    ts: number;
 } | BashLogEntry;
 export declare function hashBytes(bytes: Buffer | null): string | null;
 export declare function currentHash(absPath: string): string | null;
@@ -28,3 +32,5 @@ export declare function readTurnLog(sessionId: string, stateDir?: string): TurnL
 export declare function turnsFrom(log: readonly TurnLogEntry[], turnId: string): string[] | undefined;
 export declare function expectedHashes(log: readonly TurnLogEntry[]): Map<string, string | null>;
 export declare function hashPaths(paths: Iterable<string>): PathHashes;
+export declare function latestCheckpointTurnId(sessionId: string, stateDir?: string): string | undefined;
+export declare function latestTipTurnId(sessionId: string, stateDir?: string): string | undefined;

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

@@ -13,7 +13,7 @@ export declare class AnthropicDirectProvider implements ModelProvider {
     private _stateStore;
     private readonly providerFactory?;
     private readonly skillExecutor?;
-    private readonly schemas;
+    private schemas;
     private readonly hookRegistry;
     private readonly permissions;
     private readonly canUseTool;

package/dist/agent/session/pause-controller.d.ts

@@ -0,0 +1,19 @@
+export declare function getPauseLockPath(): string;
+export declare class PauseController {
+    private static _instance;
+    static instance(): PauseController;
+    static _resetForTest(): void;
+    private _paused;
+    private _pollInterval;
+    private _watchPath;
+    private constructor();
+    dispose(): void;
+    isPaused(): boolean;
+    check(signal?: AbortSignal): Promise<void>;
+    private _handlePause;
+    private _handleResume;
+    private _syncState;
+    private _startWatching;
+}
+export declare function writePauseLock(): boolean;
+export declare function removePauseLock(): void;

package/dist/agent/subagent/handle.d.ts

@@ -63,6 +63,7 @@ export declare class SubagentHandleImpl<T> implements SubagentHandle<T> {
     readonly _pendingBillingStreams: Set<Promise<void>>;
     _billingStreamSink?: Set<Promise<void>>;
     get pendingBillingStreams(): Promise<void>[];
+    get pendingWorkspaceEntryCount(): number;
     get _runBilling(): BillingUsage | undefined;
     set _runBilling(value: BillingUsage | undefined);
     _modelFallback?: HandleModelFallback;

package/dist/agent/unattended-limits.d.ts

@@ -0,0 +1,6 @@
+import type { AgentConfig } from './types.js';
+export declare const DEFAULT_UNATTENDED_BUDGET_USD = 5;
+export declare const DEFAULT_UNATTENDED_TOOL_ROUNDS = 100;
+type Limits = Pick<AgentConfig, 'maxBudgetUsd' | 'maxToolUseIterations'>;
+export declare function resolveUnattendedLimits(rawRounds: string | undefined, rawBudget: string | undefined, explicit?: Limits): Required<Limits>;
+export {};

package/dist/bundled-plugins/awa-bundled/skills/diagnose/SKILL.md

@@ -5,6 +5,8 @@ context: fork
 category: Debug & fix
 ---
 
+**Reference documents.** Before forming hypotheses, check `references/` alongside this SKILL.md for decision tables matching the bug's domain keywords (e.g. layout jumps, reflow). When a reference applies, use it to constrain the hypothesis space rather than exploring from scratch.
+
 Gather context: read the failing test or bug description, relevant error output, and recent git changes. If no failing test exists yet, write a minimal reproducer test (or identify a concrete verification command) before proceeding — hypotheses need a pass/fail signal to validate against. Dispatch two sub-agents in parallel — one to search the codebase for code paths involved in the failure (`subagent_type: research-agent`, read-only), and one to check recent commits and diffs that could have introduced the regression (`subagent_type: general-purpose` — requires Bash for `git log`/`git diff`/`git show`). When both return, synthesize findings into 2–4 ranked hypotheses, each with a specific code location and proposed cause.
 
 **TUI label convention.** Set `id_prefix` on each Agent dispatch to a short, descriptive label so the live progress view shows the agent's role:

package/dist/bundled-plugins/awa-bundled/skills/diagnose/references/layout-jump-decision-table.md

@@ -0,0 +1,52 @@
+# Layout Jump Decision Table
+
+Consult this reference when a bug report mentions **jump**, **gap**, **shift**, **pop**, **reflow**, or **flicker** in a UI context (TUI, web, or desktop). These keywords warrant checking layout behavior; they do not establish a single root cause or remedy.
+
+## Core invariant
+
+First establish the intended layout contract and inspect the element's existing layout footprint:
+
+- **Intended overlay** (e.g. a floating toast or modal): it should not displace siblings. Absolute/fixed positioning and layering can be appropriate; do not reserve in-flow space merely because the overlay appears dynamically.
+- **Intentional expansion/collapse** (e.g. an accordion or expanding sidebar): sibling movement may be expected. Verify the intended transition rather than forcing a permanently reserved box.
+- **Stable in-flow footprint** (e.g. a mascot bar or loading slot whose siblings should stay put): if insertion/removal or resizing changes that footprint, **reserve space before reveal, not after**. If the element already retains its in-flow footprint, investigate another cause (e.g. changing dimensions, margins, or ancestor layout) rather than adding a redundant placeholder.
+
+The decision table below applies to unintended shifts where a stable in-flow footprint is required.
+
+## Signal keywords
+
+| Keyword | Example report phrasing |
+|---------|------------------------|
+| jump | "the input area jumps up" |
+| gap | "there's a gap when X appears" |
+| shift | "content shifts down when the banner loads" |
+| pop | "the element pops in and pushes everything" |
+| reflow | "reflow when toggling the sidebar" |
+| flicker | "layout flickers on mount" |
+
+## Decision table
+
+| Symptom | Root cause | Fix strategy | Anti-pattern to avoid |
+|---------|-----------|-------------|----------------------|
+| Element appears and displaces siblings | Conditional render inserts new layout space | Reserve space with hidden/opacity-zero placeholder; toggle visibility, not existence | Using z-index/absolute positioning instead of preserving the required in-flow footprint (not an exclusion for intended overlays); animation-delay |
+| Element disappears and siblings collapse | Conditional render removes layout space | Keep element in DOM with `visibility: hidden` or `opacity: 0`; preserve its layout box | Removing from DOM and re-inserting |
+| Element animates in and causes reflow | Height/width transition from 0 triggers layout recalc | Reserve full space in a fixed-size wrapper; animate content within it using `transform: scale` or `opacity` | Animating `height`/`width`/`max-height` from 0 (all change the layout box) |
+| Content shifts after async load | Placeholder absent during fetch; content insertion changes layout | Reserve exact or minimum dimensions before content arrives | Rendering nothing then inserting loaded content |
+| Show/hide toggle causes jump per cycle | Each toggle adds/removes layout participation | Toggle `opacity` or `visibility`, not `display: none`/DOM presence | Conditional rendering (`if`/`v-if`/ternary) that adds/removes nodes |
+
+## Verification
+
+For the stable in-flow footprint remedy, a fix is valid when:
+
+1. The target element can cycle through every show/hide state without unintended sibling movement
+2. The reserved in-flow footprint remains stable during the visibility transition, even if content inside the wrapper mounts/unmounts
+3. The fix survives fast repeated toggles (no transient jump on race conditions)
+
+For intended overlays or intentional expansion/collapse, verify the declared layout contract instead: overlays do not displace siblings; expansion/collapse produces only the intended movement, including under fast repeated toggles.
+
+## Falsifier
+
+The reservation diagnosis is wrong for a stable in-flow case if the jump is fixed durably without stabilizing a changing footprint and does not recur under repeated show/hide cycles. Intended overlays, intentional expansion/collapse, and elements that already retain their in-flow footprint do not establish a need for additional space reservation.
+
+## Provenance
+
+Derived from pattern card `layout-jumps-caused-by-dynamic-element-insertion-a-2026-10-04t21-54-24-831` (session `1d6cf0de`, score 26/35, status: operational). Original fix: opacity-toggle reservation for mascot-bar vertical jump in Goblin Portal TUI.

package/dist/cli/_lib/stream-renderer-lifecycle.d.ts

@@ -11,6 +11,7 @@ import type { ProgressEvent } from '../../agent/types.js';
 import { type TtfbTickCtx } from './stream-renderer-ttfb.js';
 export declare const WAITING_LABEL_PREFIX = " \u00B7 waiting ";
 export declare const AWAITING_LABEL_PREFIX = " \u00B7 awaiting ";
+export declare const THINKING_GRACE_MS = 2000;
 export interface LifecycleContext extends TtfbTickCtx {
     compositor: TerminalCompositor | null;
     overlayComposer: OverlayComposer | null;
@@ -26,6 +27,7 @@ export interface LifecycleContext extends TtfbTickCtx {
     sources: Map<string, SourceState>;
     pauseTickInterval: ReturnType<typeof setInterval> | null;
     resizeUnsub: (() => void) | null;
+    lastThinkingAnnotation: string;
 }
 export declare function registerOverlaySlots(overlayComposer: OverlayComposer, ctx: Readonly<Pick<LifecycleContext, 'stageTracker' | 'thinkingMode' | 'thinkingLane' | 'streamingMarkdownRef' | 'toolLane' | 'lastProgressByTask'>> & {
     sources?: ReadonlyMap<string, SourceState>;
@@ -36,3 +38,4 @@ export declare function registerOverlaySlots(overlayComposer: OverlayComposer, c
 export declare function formatInterruptAffordance(interrupting: boolean): string;
 export declare function subscribeToResize(overlayComposer: OverlayComposer, disposed: boolean): () => void;
 export declare function checkPauseAnnotations(ctx: LifecycleContext): boolean;
+export declare function checkThinkingAnnotation(ctx: LifecycleContext, _now: number): boolean;

package/dist/cli/_lib/stream-renderer.d.ts

@@ -44,6 +44,7 @@ export declare class StreamRenderer {
     private readonly ttfbStartedAt;
     private ttfbDone;
     private lastTtfbAnnotation;
+    private lastThinkingAnnotation;
     private readonly addPreviewDiffRef;
     private completionWriter;
     readonly sink: (event: OutputEvent, meta?: SubagentProgressMeta) => void;

package/dist/cli/commands/interactive/thinking-lane.d.ts

@@ -15,4 +15,5 @@ export declare class ThinkingLane {
     drainPhase(): string;
     collapse(): string | null;
     inlineSummary(): string | null;
+    activeThinkingElapsedMs(): number | null;
 }

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

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerPauseCommand(program: Command): void;

package/dist/cli/commands/resume-all.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerResumeAllCommand(program: Command): void;

package/dist/cli/slash/commands/core.rewind.d.ts

@@ -1,2 +1,6 @@
-import type { SlashCommand } from '../types.js';
+import type { SlashCommand, SlashContext } from '../types.js';
+type Session = SlashContext['session']['current'];
+export declare function pick(ctx: SlashContext, choices: string[], title?: string): Promise<number | ':cancel' | null>;
+export declare function restoreFiles(ctx: SlashContext, session: Session, checkpointTurnId: string): Promise<boolean>;
 export declare const rewindCmd: SlashCommand;
+export {};