agent-afk 5.344.0 → 5.345.0

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