agent-afk 5.274.8 → 5.275.1

package/dist/agent/daemon/scheduler.execute-agent-task.d.ts

@@ -0,0 +1,32 @@
+import type { IdleDetector } from './idle-detector.js';
+import type { AgentSession } from '../session/agent-session.js';
+import type { MemoryStore } from '../memory/index.js';
+import type { McpManager } from '../mcp/index.js';
+import type { StateStore } from '../state/state-store.js';
+import type { ScheduledTask } from './triggers.js';
+import type { TelemetryRecord, TelemetryTrigger, TaskCompletionDetails } from './scheduler.js';
+import type { Telegraf } from 'telegraf';
+export interface AgentTaskOptions {
+    bot?: Telegraf;
+    primaryChatId?: number;
+    primaryThreadId?: number;
+    doneUnverifiedProbe?: (args: {
+        responseText: string;
+        successfulToolNames: readonly string[];
+    }) => boolean;
+}
+export interface AgentTaskContext {
+    options: AgentTaskOptions;
+    queueDir: string;
+    idleDetector: IdleDetector;
+    now: () => number;
+    spawnSession: (task: ScheduledTask, trigger: TelemetryTrigger) => Promise<{
+        session: AgentSession;
+        memoryStore: MemoryStore;
+        stateStore: StateStore;
+        mcpManager?: McpManager;
+        dispose: () => void;
+    }>;
+    writeTelemetry: (record: TelemetryRecord, task: ScheduledTask, details?: TaskCompletionDetails) => void;
+}
+export declare function executeAgentTask(ctx: AgentTaskContext, task: ScheduledTask, trigger: TelemetryTrigger): Promise<TelemetryRecord>;

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;