agent-afk 5.343.0 → 5.345.0

package/dist/agent/artifact-registry/store.d.ts

@@ -1,8 +1,8 @@
 import type { ArtifactListFilter, ArtifactPutOptions, ArtifactRecord } from './types.js';
 export declare function artifactPut(opts: ArtifactPutOptions, _storeDir?: string, _indexPath?: string): Promise<ArtifactRecord>;
-export declare function artifactGet(id: string, _indexPath?: string): ArtifactRecord | undefined;
-export declare function artifactList(filter?: ArtifactListFilter, _indexPath?: string): ArtifactRecord[];
+export declare function artifactGet(id: string, _indexPath?: string, maxIndexBytes?: number): ArtifactRecord | undefined;
+export declare function artifactList(filter?: ArtifactListFilter, _indexPath?: string, maxIndexBytes?: number): ArtifactRecord[];
 export declare function artifactRead(id: string, _indexPath?: string): Promise<Buffer>;
-export declare function artifactCount(_indexPath?: string): number;
+export declare function artifactCount(_indexPath?: string, maxIndexBytes?: number): number;
 export declare function compactIndex(_indexPath?: string): Promise<void>;
 export declare function listStoreBlobs(_storeDir?: string): string[];

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

@@ -0,0 +1,7 @@
+export declare class DaemonAlreadyRunningError extends Error {
+    readonly 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/daemon.oauth-timer.d.ts

@@ -0,0 +1,2 @@
+export declare const DEFAULT_OAUTH_REFRESH_INTERVAL_MS: number;
+export declare function startOAuthRefreshTimer(refresher: (() => Promise<unknown>) | undefined, intervalMs?: number): ReturnType<typeof setInterval> | undefined;

package/dist/agent/effect-ledger/remote-idempotency.d.ts

@@ -0,0 +1,5 @@
+import type { EffectRecord } from './types.js';
+export declare function remoteIdempotencyInput(toolName: string, input: unknown, prior: EffectRecord | null): {
+    updatedInput?: Record<string, unknown>;
+    remoteIdempotencyKey?: string;
+};

package/dist/agent/effect-ledger/store.d.ts

@@ -1,5 +1,5 @@
 import { type InputBudget } from '../outcomes/outcomes-input.js';
-import type { EffectRecord, EffectQuery, PendingEffectInput, ExecuteEffectInput } from './types.js';
+import type { EffectRecord, EffectQuery, PendingEffectInput, ExecuteEffectInput, EffectRemoteRead } from './types.js';
 export declare class EffectStore {
     private readonly path;
     private cachedRecords;
@@ -8,6 +8,7 @@ export declare class EffectStore {
     private invalidateCache;
     writePending(input: PendingEffectInput): EffectRecord;
     updateStatus(input: ExecuteEffectInput): Promise<EffectRecord>;
+    reconcile(id: string, readRemote: EffectRemoteRead): Promise<EffectRecord>;
     acknowledgeRetry(id: string): Promise<EffectRecord>;
     findByIdempotencyKey(key: string, sessionId?: string): Promise<EffectRecord | null>;
     query(filters?: EffectQuery): Promise<EffectRecord[]>;

package/dist/agent/effect-ledger/types.d.ts

@@ -10,6 +10,7 @@ export interface EffectRecord {
     taskId?: string;
     timestamp: number;
     retryOf?: string;
+    remoteIdempotencyKey?: string;
     retryAcknowledgedAt?: number;
     result?: unknown;
     reconciledAt?: number;
@@ -27,7 +28,12 @@ export interface PendingEffectInput {
     sessionId?: string;
     taskId?: string;
     retryOf?: string;
+    remoteIdempotencyKey?: string;
 }
+export type EffectRemoteRead = (record: Readonly<EffectRecord>) => Promise<{
+    matched: boolean;
+    evidence: unknown;
+}>;
 export interface ExecuteEffectInput {
     id: string;
     status: Exclude<EffectStatus, 'pending'>;

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/hooks.d.ts

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

package/dist/agent/lsp/repo-map.d.ts

@@ -0,0 +1,11 @@
+import { type LspServerPool } from './pool.js';
+export declare const MAX_SYMBOLS = 200;
+export declare const MAX_LINES = 80;
+export interface RepoMapOptions {
+    readonly rootDir?: string;
+    readonly timeoutMs?: number;
+    readonly pool?: LspServerPool;
+    readonly serverCmd?: readonly string[];
+    readonly signal?: AbortSignal;
+}
+export declare function buildRepoMap(opts?: RepoMapOptions): Promise<string>;

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/tools/compose-executor.node-build.d.ts

@@ -6,6 +6,10 @@ export type ComposeNodeBuildResult = SubagentDAGNode | {
     attachmentError: true;
     nodeId: string;
     error: Error;
+} | {
+    usageBlocked: true;
+    nodeId: string;
+    notice: string;
 };
 export interface BuildComposeDagNodeArgs {
     node: ComposeNodeInput;

package/dist/agent/tools/compose-node-results.d.ts

@@ -3,6 +3,10 @@ type BuildResult = SubagentDAGNode | {
     attachmentError: true;
     nodeId: string;
     error: Error;
+} | {
+    usageBlocked: true;
+    nodeId: string;
+    notice: string;
 };
 export declare function splitComposeNodeResults(results: BuildResult[]): {
     dagNodes: SubagentDAGNode[];
@@ -10,5 +14,9 @@ export declare function splitComposeNodeResults(results: BuildResult[]): {
         id: string;
         error: Error;
     }>;
+    usageBlocks: Array<{
+        id: string;
+        notice: string;
+    }>;
 };
 export {};

package/dist/agent/tools/handlers/artifact.d.ts

@@ -0,0 +1,8 @@
+import type { ToolHandler } from '../types.js';
+interface ArtifactHandlerOptions {
+    cwd?: string;
+    storeDir?: string;
+    indexPath?: string;
+}
+export declare function createArtifactHandlers(opts?: ArtifactHandlerOptions): Map<string, ToolHandler>;
+export {};

package/dist/agent/tools/handlers/bash-sandbox.d.ts

@@ -0,0 +1,12 @@
+export type SandboxPolicy = 'workspace-write' | 'read-only' | 'off';
+export interface SandboxedCommand {
+    readonly shell: string;
+    readonly args: readonly string[];
+    readonly command: string;
+    readonly sandboxed: boolean;
+}
+export declare function parseSandboxPolicy(): SandboxPolicy | undefined;
+export declare function _resetBwrapCacheForTests(): void;
+export declare function _forceBwrapUnavailableForTests(): void;
+export declare function buildSandboxedCommand(command: string, policy: SandboxPolicy, cwd: string | undefined, childTemp?: string): SandboxedCommand;
+export declare function sandboxDescription(policy: SandboxPolicy): string;

package/dist/agent/tools/handlers/bash-sandbox.paths.d.ts

@@ -0,0 +1,5 @@
+export declare function canonicalSandboxPath(input: string): string;
+export declare function sandboxWriteFloor(): readonly string[];
+export declare function sandboxFloorAncestors(floor: readonly string[]): readonly string[];
+export declare function assertDisjointSandboxGrants(grants: readonly string[], floor: readonly string[]): void;
+export declare function sandboxSchemeString(value: string): string;

package/dist/agent/tools/handlers/worktree-managed.d.ts

@@ -5,7 +5,7 @@ export interface RepoContext {
     repoRoot: string;
     afkWorktreesRoot: string;
 }
-export declare function resolveRepoContext(execFile: ExecFileFn, cwd: string): Promise<RepoContext>;
+export declare function resolveRepoContext(execFile: ExecFileFn, cwd: string, explicitRepo?: string): Promise<RepoContext>;
 export declare function sanitizeSlug(name: string): string;
 export declare function detectRemoteDefaultRef(execFile: ExecFileFn, repoRoot: string): Promise<string | undefined>;
 export declare function resolveAnchorBaseRef(execFile: ExecFileFn, anchor: string): Promise<string>;

package/dist/agent/tools/handlers/worktree.d.ts

@@ -4,4 +4,4 @@ export interface WorktreeHandlerDeps {
     execFile?: ExecFileFn;
     generateSuffix?: () => string;
 }
-export declare function createWorktreeHandler(cwd?: string, deps?: WorktreeHandlerDeps): ToolHandler;
+export declare function createWorktreeHandler(cwdFallback?: string, deps?: WorktreeHandlerDeps): ToolHandler;

package/dist/agent/tools/handlers/write-denylist.d.ts

@@ -1,4 +1,5 @@
 export declare const BUILTIN_WRITE_DENYLIST: readonly string[];
+export declare function getUnresolvedWriteDenylist(): readonly string[];
 export declare function getWriteDenylist(): readonly string[];
 export declare function _resetWriteDenylistCacheForTests(): void;
 export declare function safeRealpath(p: string): string;

package/dist/agent/tools/schemas.artifact.d.ts

@@ -0,0 +1,5 @@
+import type { AnthropicToolDef } from './types.js';
+export declare const artifactGetTool: AnthropicToolDef;
+export declare const artifactListTool: AnthropicToolDef;
+export declare const artifactReadTool: AnthropicToolDef;
+export declare const artifactToolSchemas: readonly [AnthropicToolDef, AnthropicToolDef, AnthropicToolDef];

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

@@ -137,6 +137,7 @@ export declare const HookDecisionPayloadSchema: z.ZodObject<{
         "outbound-message": "outbound-message";
         "release-boundary": "release-boundary";
     }>>;
+    ruleId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const HookSummaryPayloadSchema: z.ZodObject<{
     scope: z.ZodLiteral<"root-session-including-subagents">;
@@ -415,6 +416,7 @@ export declare const TraceEventInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject
             "outbound-message": "outbound-message";
             "release-boundary": "release-boundary";
         }>>;
+        ruleId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"hook_summary">;
@@ -874,6 +876,7 @@ export declare const TraceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             "outbound-message": "outbound-message";
             "release-boundary": "release-boundary";
         }>>;
+        ruleId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     ts: z.ZodString;

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

@@ -19,6 +19,7 @@ export interface RunReceipt {
     witnessLabel: string;
     tracePath: string;
     sessionId?: string;
+    cwd?: string;
     endReason?: string;
     status: 'succeeded' | 'failed' | 'cancelled' | 'unknown';
     closureReason?: ClosureReason;
@@ -72,6 +73,7 @@ export interface ReceiptMeta {
     tracePath: string;
     witnessLabel: string;
     sessionId?: string;
+    cwd?: string;
     endReason?: string;
     now?: Date;
     journalSummary?: JournalSummary;

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

@@ -42,6 +42,7 @@ export interface HookDecisionPayload {
     durationMs?: number;
     approvalOutcome?: AfkApprovalOutcome;
     riskCategory?: import('../risk-classifier.js').RiskCategory;
+    ruleId?: string;
 }
 export interface HookSummaryPayload {
     scope: 'root-session-including-subagents';

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/errors/classifier.d.ts

@@ -1,4 +1,4 @@
-type ErrorKind = 'auth' | 'rate_limit' | 'usage_limit' | 'overloaded' | 'budget_exceeded' | 'unsupported_config' | 'hook_blocked' | 'timeout' | 'network' | 'not_git_repo' | 'unknown';
+type ErrorKind = 'auth' | 'rate_limit' | 'usage_limit' | 'overloaded' | 'budget_exceeded' | 'unsupported_config' | 'hook_blocked' | 'timeout' | 'network' | 'not_git_repo' | 'daemon_already_running' | 'unknown';
 export interface ClassifiedError {
     kind: ErrorKind;
     userMessage: string;