agent-afk 5.336.0 → 5.338.1

package/dist/agent/background-registry.mark-terminal.d.ts

@@ -9,7 +9,7 @@ export interface MarkTerminalJob {
     startedAt: number;
     endedAt?: number;
     result?: SubagentResult;
-    provenance: 'user' | 'model';
+    provenance: 'user' | 'model' | 'user-backgrounded';
     parentSessionId?: string;
     cancelSource?: 'explicit' | 'cascade';
     modelCancelReason?: string;

package/dist/agent/background-registry.types.d.ts

@@ -1,6 +1,6 @@
 import type { SubagentResult } from './subagent.js';
 export type BackgroundJobStatus = 'running' | 'completed' | 'failed' | 'cancelled';
-export type BackgroundJobProvenance = 'model' | 'user';
+export type BackgroundJobProvenance = 'model' | 'user' | 'user-backgrounded';
 export interface BackgroundJob {
     readonly jobId: string;
     readonly provenance: BackgroundJobProvenance;

package/dist/agent/providers/anthropic-direct/query-options.d.ts

@@ -34,6 +34,7 @@ export interface AnthropicDirectQueryOptions {
     rawEffort?: import('../../types/sdk-types.js').EffortLevel;
     temperature?: number;
     baseUrl?: string;
+    endpointConcurrency?: number;
     maxToolUseIterations?: number;
     softDeadlineMs?: number;
     traceWriter?: import('../../trace/index.js').TraceSink;

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

@@ -18,6 +18,7 @@ export declare class AnthropicDirectQuery implements ProviderQuery {
     private readonly launchModel;
     private readonly temperature?;
     private readonly baseUrl?;
+    private readonly endpointConcurrency?;
     private readonly maxToolUseIterations?;
     private readonly softDeadlineMs?;
     private readonly traceWriter?;

package/dist/agent/providers/anthropic-direct/query-turn-driver.d.ts

@@ -18,6 +18,7 @@ export interface TurnDriverContext {
     readonly temperature: number | undefined;
     readonly thinkingBlockBinding: import('./types.js').RunTurnInput['thinkingBlockBinding'] | undefined;
     readonly baseUrl: string | undefined;
+    readonly endpointConcurrency: number | undefined;
     readonly maxToolUseIterations: number | undefined;
     readonly softDeadlineMs: number | undefined;
     readonly traceWriter: import('../../trace/index.js').TraceSink | undefined;

package/dist/agent/providers/anthropic-direct/request-types.d.ts

@@ -22,6 +22,7 @@ export interface RunTurnInput {
     };
     fastMode?: boolean;
     baseUrl?: string;
+    endpointConcurrency?: number;
     traceWriter?: import('../../trace/index.js').TraceSink;
     subagentId?: string;
     onUsageProgress?: (usage: ProviderUsage) => void;

package/dist/agent/providers/openai-compatible/query/turn-driver.d.ts

@@ -7,6 +7,7 @@ import type { OpenAIMessage } from '../messages.js';
 import type { OpenAIJournalWiring } from './journal-wiring.js';
 import type { AgentConfig } from '../../../types/config-types.js';
 import type { OpenAIAuthResolution } from '../auth.js';
+export declare const INCOMPLETE_MARKER = "Context capacity exhausted. Partial tool outputs are journaled; resume from saved work.";
 export interface TurnDriverContext extends IterationContext, FinishTurnContext {
     readonly abort: AbortCoordinator;
     readonly toolDispatcher: ToolDispatcher | undefined;

package/dist/agent/providers/shared/tool-grant.d.ts

@@ -1,3 +1,4 @@
 import { type ToolPermissionConfig } from '../../tools/permissions.js';
 export declare function providerGrantsTool(toolName: string, permissions: ToolPermissionConfig | undefined, hasWorkspaceStore: boolean): boolean;
 export declare function grantsWorkspacePrompt(grantsTool: (toolName: string) => boolean): boolean;
+export declare function grantsToolStrict(grantsTool: ((toolName: string) => boolean) | undefined, toolName: string): boolean;

package/dist/agent/session/model-slots.d.ts

@@ -9,6 +9,7 @@ export interface ModelSlotBinding {
     apiKey?: string;
     contextWindow?: number;
     maxOutputTokens?: number;
+    maxConcurrency?: number;
 }
 export type ModelSlots = Record<SlotName, ModelSlotBinding>;
 export declare const CLAUDE_HAIKU_ID = "claude-haiku-5-5";
@@ -29,6 +30,7 @@ export { OPENAI_MODEL_HINTS } from './model-slots.hints.js';
 export declare const MODEL_ALIASES_HINT: readonly string[];
 export declare function setSlotBindings(bindings: ModelSlots | undefined): void;
 export declare function resetSlotBindings(): void;
+export declare const MAX_SLOT_CONCURRENCY = 32;
 export declare function computeSlotBindings(fileOverrides?: Partial<Record<SlotName, ModelSlotBinding>>): ModelSlots;
 export declare function getSlotBindings(override?: ModelSlots): ModelSlots;
 export declare function slotForInput(input: string, bindings?: ModelSlots): SlotName | undefined;

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

@@ -0,0 +1,13 @@
+export interface SessionMeta {
+    v: 1;
+    sessionId: string;
+    model: string;
+    cwd?: string;
+    traceLabel?: string | null;
+    surface?: string;
+    provider?: string;
+    startedAt?: number;
+    afkVersion?: string;
+}
+export declare function writeSessionMeta(meta: SessionMeta): Promise<void>;
+export declare function readSessionMeta(sessionId: string): SessionMeta | null;

package/dist/agent/session/slot-credentials.d.ts

@@ -8,5 +8,6 @@ export interface SlotCredentialTarget {
     forceXaiOAuth?: boolean;
     forceXaiApiKey?: boolean;
     xaiBaseUrl?: string;
+    endpointConcurrency?: number;
 }
 export declare function applySlotCredentials(config: SlotCredentialTarget, bindings?: ModelSlots): void;

package/dist/agent/session-control/index.d.ts

@@ -1,5 +1,5 @@
 export { clearConversation } from './clear.js';
 export { compactConversation, type CompactConversationResult, type CompactProgress } from './compact.js';
 export { setSessionModel, type SetSessionModelResult } from './model.js';
-export { setSessionName, sessionDisplayName, type SetSessionNameResult, type SessionNameOptions, THINKING_MODES, getSessionThinking, setSessionThinking, readSessionFast, setSessionFast, } from './preferences.js';
+export { setSessionName, sessionDisplayName, type SetSessionNameResult, type SessionNameOptions, THINKING_MODES, getSessionThinking, setSessionThinking, readSessionFast, setSessionFast, getUsageAwareness, setUsageAwarenessPreference, } from './preferences.js';
 export { readSubscriptionUsage, readContextUsage, readLocalTokenUsage, readTokenUsage, readMcpStatus, readMcpOauthPending, type ContextUsage, type LocalTokenUsage, type TokenUsage, } from './reads.js';

package/dist/agent/session-control/preferences.d.ts

@@ -22,6 +22,13 @@ export declare function setSessionThinking(stats: Pick<SessionStats, 'thinkingUi
 } | {
     ok: false;
 };
+export declare function getUsageAwareness(stats: Pick<SessionStats, 'usageAwareness'>): boolean;
+export declare function setUsageAwarenessPreference(stats: Pick<SessionStats, 'usageAwareness'>, value: string): {
+    ok: true;
+    enabled: boolean;
+} | {
+    ok: false;
+};
 export declare function readSessionFast(controller: FastModeController, context: FastModeContext): FastModeStatus;
 export declare function setSessionFast(controller: FastModeController, value: string): {
     ok: true;

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

@@ -1,9 +1,11 @@
 import { renderReceiptMarkdown } from './receipt.render.js';
 import type { HookHandler } from '../hooks.js';
 import { type CostTokens, type SessionCostSource } from './cost.js';
+import { type JournalSummary } from './receipt.journal.js';
 import { type ClosureReason, type ToolFailureClass, type TraceEvent, type TraceEventKind } from './types.js';
 export { renderReceiptMarkdown };
-export declare const RECEIPT_SCHEMA_VERSION: 1;
+export { extractJournalSummary, type JournalSummary } from './receipt.journal.js';
+export declare const RECEIPT_SCHEMA_VERSION: 2;
 export interface ReceiptToolFailure {
     toolUseId: string;
     name: string;
@@ -66,6 +68,7 @@ export interface RunReceipt {
     humanReviewRequired: boolean;
     humanReviewReasons: string[];
     limitations: string[];
+    journalSummary?: JournalSummary;
 }
 export interface ReceiptMeta {
     tracePath: string;
@@ -73,6 +76,7 @@ export interface ReceiptMeta {
     sessionId?: string;
     endReason?: string;
     now?: Date;
+    journalSummary?: JournalSummary;
 }
 export declare function parseTraceJsonl(raw: string): TraceEvent[];
 export declare function receiptPathsFor(tracePath: string): {

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

@@ -0,0 +1,10 @@
+import type { JournalMessage } from '../journal/types.js';
+export interface JournalSummary {
+    firstUserMessage?: string;
+    lastAssistantMessage?: string;
+    toolNames: string[];
+    toolUseCount: number;
+    messageCount: number;
+    textRedacted?: boolean;
+}
+export declare function extractJournalSummary(messages: JournalMessage[] | null, textDisabled: boolean): JournalSummary | undefined;

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' | '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';
 export interface SessionPhasePayload {
     phase: SessionPhaseName;
     durationMs?: number;

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

@@ -30,6 +30,7 @@ export interface AgentConfig {
     models?: ModelSlots;
     apiKey?: string;
     baseUrl?: string;
+    endpointConcurrency?: number;
     openaiBaseUrl?: string;
     forceChatgptOAuth?: boolean;
     forceXaiOAuth?: boolean;

package/dist/agent/usage/usage-awareness-toggle.d.ts

@@ -0,0 +1,3 @@
+export declare function isUsageAwarenessEnabled(): boolean;
+export declare function setUsageAwareness(value: boolean): void;
+export declare function resetUsageAwarenessForTests(): void;

package/dist/bundled-plugins/awa-bundled/skills/ground-state/SKILL.md

@@ -22,13 +22,13 @@ Run the four surveys below **directly using your own tools**. Do NOT dispatch an
 
 ### State survey *(bash)*
 
-Issue these commands (combine into one or two bash calls):
-- `git symbolic-ref --short HEAD` — current branch
+Issue these commands (combine into one or two bash calls; when running under `git_read` instead of `bash`, adapt accordingly — `git_read` uses an argv allowlist, so use only the long-form flags shown here):
+- `git rev-parse --abbrev-ref HEAD` — current branch
 - `git rev-parse HEAD` — HEAD SHA
 - `git status -s` — uncommitted changes
-- `git log --oneline -5` — recent commit history
-- `git stash list` — stash state
-- `git rev-list --left-right --count HEAD...@{upstream} 2>/dev/null` — upstream divergence
+- `git log --oneline --max-count=5` — recent commit history
+- `git stash list` — stash state (via `git_read`: subcommand `stash` with no arguments; the tool forces `list`)
+- `git rev-list --count HEAD..@{upstream}` + `git rev-list --count @{upstream}..HEAD` — upstream divergence (ahead / behind)
 
 Adapt what you surface to the domain:
 
@@ -110,7 +110,7 @@ After the snapshot is assembled, construct the **Brief Anchor** — a path-verif
 
 **Construction procedure:**
 
-1. From your state survey output, extract the verified `cwd` (absolute path from `pwd`), `branch` (from `git symbolic-ref --short HEAD`), and `HEAD` SHA (from `git rev-parse HEAD`).
+1. From your state survey output, extract the verified `cwd` (absolute path from `pwd`), `branch` (from `git rev-parse --abbrev-ref HEAD`), and `HEAD` SHA (from `git rev-parse HEAD`).
 2. From your infrastructure survey output, extract the 2–4 canonical file paths most relevant to the task. For each, run `stat <path>` — include the path only if `stat` exits 0. Paths that fail `stat` are omitted; if zero paths survive, set the list to `(none verified)`.
 3. Assemble the preamble block:
 

package/dist/cli/commands/interactive/mascot-bar.d.ts

@@ -32,6 +32,7 @@ export declare class MascotBar {
         toolErrored?: boolean;
     }): void;
     redraw(): void;
+    releaseBand(): void;
     getRowCount(): number;
     private clearBand;
     private repaint;

package/dist/cli/commands/interactive/shared.d.ts

@@ -156,6 +156,7 @@ export declare const REPL_SPINNER_OPTIONS: {
 };
 export declare function contextRatio(stats: SessionStats, sampler?: ContextSampler): number;
 export declare function formatStatusFields(stats: SessionStats, sampler?: ContextSampler, gitSampler?: GitStatusSampler, maxTurns?: number, backgroundRegistry?: BackgroundAgentRegistry, maxBudgetUsd?: number): {
+    usageAwarenessOff?: boolean | undefined;
     activeAgentCount?: number | undefined;
     maxBudgetUsd?: number | undefined;
     budgetUsd?: number | undefined;

package/dist/cli/commands/interactive/startup-dashboard.d.ts

@@ -0,0 +1,6 @@
+export interface StartupDashboardOpts {
+    isTTY: boolean;
+    isFirstRun: boolean;
+    bootPruneStaleCount?: number;
+}
+export declare function renderStartupDashboard(opts: StartupDashboardOpts): Promise<string[]>;

package/dist/cli/commands/interactive/startup-recall.d.ts

@@ -0,0 +1,9 @@
+export declare function formatTimeAgo(isoString: string, now?: Date): string;
+export interface StartupRecallOpts {
+    cwd: string;
+    isResume: boolean;
+    isTTY: boolean;
+    isFirstRun: boolean;
+    currentSessionId?: string;
+}
+export declare function renderStartupRecall(opts: StartupRecallOpts): string | undefined;

package/dist/cli/commands/interactive.register-helpers.d.ts

@@ -48,6 +48,7 @@ export interface StartupBannerParams {
     };
     worktreeCwd: string | undefined;
     bootPruneNotice: string | undefined;
+    bootPruneRemovedCount?: number;
 }
 export declare function printStartupBanner(params: StartupBannerParams): Promise<void>;
 export interface ResumeValidationResult {

package/dist/cli/config/types.d.ts

@@ -11,6 +11,7 @@ export interface AutoRoutingConfig {
 export interface CliConfig {
     tools?: {
         disabled?: string[];
+        usageAwareness?: boolean;
     };
     apiKey?: string;
     baseUrl?: string;
@@ -84,6 +85,7 @@ export interface ConfigFileSchema {
     tools?: {
         disabled?: string[];
         disabledBySlot?: Partial<Record<string, string[]>>;
+        usageAwareness?: boolean;
     };
     model?: string;
     models?: {

package/dist/cli/render/status-line-format.d.ts

@@ -21,5 +21,6 @@ export interface StatusLineFields {
     maxBudgetUsd?: number;
     activeAgentCount?: number;
     tokPerSec?: number;
+    usageAwarenessOff?: boolean;
 }
 export declare function formatStatusLine(f: StatusLineFields, maxW: number): string;

package/dist/cli/session-store.d.ts

@@ -27,6 +27,7 @@ export interface StoredSession {
     repoRoot?: string;
     handleId?: string;
     bindings?: SessionBinding[];
+    usageAwareness?: boolean;
 }
 export interface SessionListEntry {
     path: string;

package/dist/cli/slash/commands/usage-awareness.d.ts

@@ -0,0 +1,2 @@
+import type { SlashCommand } from '../types.js';
+export declare const usageAwarenessCmd: SlashCommand;

package/dist/cli/slash/types.d.ts

@@ -61,6 +61,7 @@ export interface SessionStats {
     model: AgentModelInput;
     permissionMode: PermissionMode;
     thinkingUi?: ThinkingUiMode;
+    usageAwareness?: boolean;
     sessionId?: string;
     name?: string;
     nameExplicit?: boolean;