agent-afk 5.274.6 → 5.275.0

package/README.md

@@ -22,7 +22,7 @@ Open source. Runs locally. Works with any model provider, including local models
 ## Quick Start
 
 ```bash
-npm install -g agent-afk    # Node ≥ 22 required
+npm install -g agent-afk    # Node ≥ 22.13 required
 afk login                   # authenticate (auto-detects Claude Code / Codex creds)
 afk doctor                  # verify everything works
 afk chat "hello"             # first real conversation
@@ -30,7 +30,7 @@ afk chat "hello"             # first real conversation
 
 That's it. You're in.
 
-**Using pnpm?** `pnpm add -g agent-afk` works, but pnpm 10 blocks build scripts by default and skips `postinstall` (with an easy-to-miss warning — see [#2199](https://github.com/griffinwork40/agent-afk/issues/2199)). Run `pnpm approve-builds -g` after install to approve the hook, or use `npm install -g agent-afk` instead. If an `afk daemon` is already running and pnpm skipped the hook, restart it manually with `afk service restart daemon` — on macOS the hook restarts the daemon automatically when it runs, but on Linux you must always run this command after an upgrade even when the hook ran. If you have a manually-started Telegram bot, also run `afk telegram restart`.
+**Using pnpm?** `pnpm add -g agent-afk` works, but pnpm 10 and later block build scripts by default and skips `postinstall` (with an easy-to-miss warning — see [#2199](https://github.com/griffinwork40/agent-afk/issues/2199)). Run `pnpm approve-builds -g` after install to approve the hook, or use `npm install -g agent-afk` instead. If an `afk daemon` is already running and pnpm skipped the hook, restart it manually with `afk service restart daemon` — on macOS the hook restarts the daemon automatically when it runs, but on Linux you must always run this command after an upgrade even when the hook ran. If you have a manually-started Telegram bot, also run `afk telegram restart`.
 
 **Try without installing:** `npx agent-afk chat "hello"` runs a one-shot turn with zero global install.
 

package/dist/agent/providers/openai-compatible/base-schemas.d.ts

@@ -0,0 +1,5 @@
+import type { AnthropicToolDef } from '../anthropic-direct/types.js';
+export declare function selectBaseSchemas(schemas: AnthropicToolDef[], opts: {
+    isSkillDispatch?: boolean;
+    isNonInteractive?: boolean;
+}): AnthropicToolDef[];

package/dist/agent/tools/dispatcher.d.ts

@@ -13,6 +13,7 @@ import type { ToolPermissionConfig } from './permissions.js';
 import type { CanUseTool } from '../types/sdk-types.js';
 import { type GrantSnapshot, type GrantManager } from './grant-manager.js';
 import type { TraceSink } from '../trace/index.js';
+import { type UserAttention } from './user-yield.js';
 export { defaultConcurrencyClassifier } from './dispatch-batching.js';
 export declare const REPEAT_CIRCUIT_BREAKER_THRESHOLD = 8;
 export { DEFAULT_MAX_CONCURRENT_SAFE_TOOL_CALLS, resolveMaxConcurrentSafeToolCalls };
@@ -40,6 +41,7 @@ export interface SessionToolDispatcherOptions {
     readOnlyBash?: boolean;
     maxOutputBytes?: number;
     spawnedPidRegistry?: SpawnedPidRegistry;
+    userAttention?: UserAttention;
     bashOutputTailReporter?: (toolUseId: string) => (tail: string | undefined) => void;
 }
 export declare class SessionToolDispatcher implements ToolDispatcher {
@@ -66,6 +68,7 @@ export declare class SessionToolDispatcher implements ToolDispatcher {
     private readonly readOnlyBash;
     private readonly maxOutputBytes;
     private readonly spawnedPidRegistry;
+    private readonly userAttention;
     private readonly bashOutputTailReporter;
     private readonly gateState;
     private readonly repeatFailureGuard;

package/dist/agent/tools/handlers/wait-for-poller.d.ts

@@ -8,9 +8,11 @@ export interface PollOptions {
     poll_interval_ms: number;
     backoff: 'none' | 'linear' | 'exponential';
     signal: AbortSignal;
+    shouldYield?: () => boolean;
 }
+export declare const YIELD_CHECK_SLICE_MS = 1000;
 export interface PollResult {
-    status: 'succeeded' | 'timed_out' | 'cancelled' | 'failed';
+    status: 'succeeded' | 'timed_out' | 'cancelled' | 'failed' | 'yielded_to_user';
     elapsed_ms: number;
     attempts: number;
     result?: WaitResult;

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

@@ -5,6 +5,7 @@ export type { ToolDispatcher } from '../providers/anthropic-direct/tool-dispatch
 import type { ToolResult } from '../providers/shared/tool-result.js';
 import type { TraceSink } from '../trace/index.js';
 import type { SpawnedPidRegistry } from './handlers/pid-registry.js';
+import type { UserAttention } from './user-yield.js';
 export interface ToolHandlerContext {
     cwd?: string;
     resolveBase?: string;
@@ -17,6 +18,7 @@ export interface ToolHandlerContext {
     sessionId?: string;
     spawnedPidRegistry?: SpawnedPidRegistry;
     onBashOutputTail?: (tail: string | undefined) => void;
+    userAttention?: UserAttention;
 }
 export type ToolHandler = (input: unknown, signal: AbortSignal, context?: ToolHandlerContext) => Promise<ToolResult>;
 export type ConcurrencyClassifier = (toolName: string, input?: unknown) => boolean;

package/dist/agent/tools/user-yield.d.ts

@@ -0,0 +1,10 @@
+export interface UserAttention {
+    hasPendingUserMessage(): boolean;
+}
+export declare const YIELDABLE_TOOLS: ReadonlySet<string>;
+export declare function isYieldableTool(name: string): boolean;
+export declare function userAttentionFrom(holder: {
+    hasPendingUserMessage?: () => boolean;
+} | undefined): UserAttention | undefined;
+export declare function isUserWaiting(attention: UserAttention | undefined): boolean;
+export declare function yieldNotice(retry: string, lead?: string): string;

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

@@ -31,6 +31,7 @@ export declare function getBuffer(self: ApiHost): {
     queued: boolean;
 };
 export declare function getPendingCount(self: ApiHost): number;
+export declare function hasPendingSubmission(self: ApiHost): boolean;
 export declare function peekQueuedText(self: ApiHost): QueuedSnapshot | undefined;
 export declare function reserveQueued(self: ApiHost, snapshot: QueuedSnapshot): void;
 export declare function releaseQueued(self: ApiHost, snapshot: QueuedSnapshot): void;

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

@@ -136,6 +136,7 @@ export declare class TerminalCompositor {
     };
     getPendingCount(): number;
     peekQueuedText(): QueuedAccess.QueuedSnapshot | undefined;
+    hasPendingSubmission(): boolean;
     reserveQueued(snapshot: QueuedAccess.QueuedSnapshot): void;
     releaseQueued(snapshot: QueuedAccess.QueuedSnapshot): void;
     dropQueued(snapshot: QueuedAccess.QueuedSnapshot): number;

package/dist/cli/terminal-compositor.queued-access.d.ts

@@ -15,5 +15,6 @@ export interface QueuedSnapshot {
 export declare function reserveQueued(self: QueuedAccessHost, snapshot: QueuedSnapshot): void;
 export declare function releaseQueued(self: QueuedAccessHost, snapshot: QueuedSnapshot): void;
 export declare function isQueuedReserved(self: QueuedAccessHost, payload: SubmissionPayload): boolean;
+export declare function hasPendingSubmission(self: QueuedAccessHost): boolean;
 export declare function peekQueuedText(self: QueuedAccessHost): QueuedSnapshot | undefined;
 export declare function dropQueued(self: QueuedAccessHost, snapshot: QueuedSnapshot): number;