agent-afk 5.254.3 → 5.255.0

package/README.md

@@ -30,6 +30,8 @@ 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 silently skips `postinstall` (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 a launchd/systemd-supervised `afk daemon` is already running and pnpm skipped the hook, restart it manually with `afk service restart daemon`.
+
 **Try without installing:** `npx agent-afk chat "hello"` runs a one-shot turn with zero global install.
 
 **Already using Claude Code or Codex?** `afk login` will detect your existing credentials automatically. Run `afk migrate` to import your plugins, skills, and MCP servers too -- it live-reads the source tool's dirs, so anything you install there keeps showing up in AFK with no re-run.

package/dist/agent/daemon/cwd-validator.d.ts

@@ -0,0 +1,9 @@
+export declare function expandCwd(rawCwd: string): string;
+export declare function validateScheduleCwd(rawCwd: string): {
+    ok: true;
+    resolved: string;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function checkTaskCwdAtRuntime(cwd: string): string | undefined;

package/dist/agent/daemon/schedule-store.d.ts

@@ -4,6 +4,7 @@ export interface ScheduledTaskConfig {
     name: string;
     command: string;
     cron: string;
+    cwd?: string;
     executor?: Exclude<TaskExecutor, 'builtin'>;
     trigger?: 'cron' | 'sessionstart' | 'both';
     enabled: boolean;

package/dist/agent/daemon/session-spawn.d.ts

@@ -8,6 +8,7 @@ export interface DaemonSpawnOptions {
     sessionConfig?: Partial<AgentConfig>;
     sessionFactory?: (config: AgentConfig, ownedTraceWriter?: TraceWriter) => AgentSession;
     trigger?: 'cron' | 'sessionstart' | 'pull';
+    taskCwd?: string;
 }
 export declare function daemonTraceLabel(taskId: string): string;
 export declare function spawnDaemonSession(taskId: string, options: DaemonSpawnOptions): Promise<{

package/dist/agent/daemon/shell-task.d.ts

@@ -7,4 +7,5 @@ export declare function runShellTask(task: {
     taskId: string;
     command: string;
     cronExpression?: string;
+    cwd?: string;
 }, trigger: TelemetryTrigger, options: ShellTaskOptions): Promise<TelemetryRecord>;

package/dist/agent/daemon/triggers.d.ts

@@ -11,5 +11,6 @@ export interface ScheduledTask {
     debounceMs?: number;
     notifyOn?: 'failure' | 'always' | 'never';
     notifyChat?: number | string;
+    cwd?: string;
 }
 export declare function validateScheduledTask(task: ScheduledTask): void;

package/dist/agent/fast-mode.d.ts

@@ -6,6 +6,7 @@ export interface FastModeContext {
     providerFamily: string;
     hasCustomEndpoint: boolean;
     executionPath: FastExecutionPath;
+    modelEligible?: boolean;
 }
 export type FastModeStatus = Readonly<{
     preference: FastModePreference;
@@ -13,6 +14,7 @@ export type FastModeStatus = Readonly<{
     reason?: FastModeInactiveReason;
 }>;
 export type FastTurnDecision = FastModeStatus;
+export declare const OPENAI_FAST_MODEL_FALLBACK: RegExp;
 export declare function resolveFastModeStatus(preference: FastModePreference, context: FastModeContext): FastModeStatus;
 export declare class FastModeController {
     private preference;

package/dist/agent/mcp/client.d.ts

@@ -22,7 +22,7 @@ export declare class McpClient {
     onToolListChanged?: () => void;
     constructor(serverName: string, config: McpServerConfig, layer?: McpServerLayer, trustedAllowSecretEnv?: readonly string[]);
     connect(): Promise<McpClientConnectResult>;
-    listTools(): Promise<McpTool[]>;
+    listTools(signal?: AbortSignal): Promise<McpTool[]>;
     refreshTools(): Promise<McpTool[]>;
     callTool(toolName: string, input: unknown, signal: AbortSignal): Promise<ToolResult>;
     finishAuth(authorizationCode: string): Promise<void>;

package/dist/agent/mcp/health-check.d.ts

@@ -0,0 +1,13 @@
+export interface McpHealthCheckResult {
+    serverName: string;
+    healthy: boolean;
+    error?: string;
+    durationMs: number;
+}
+export interface HealthCheckTarget {
+    serverName: string;
+    listTools(signal?: AbortSignal): Promise<unknown[]>;
+}
+export declare function runMcpHealthChecks(targets: readonly HealthCheckTarget[], timeoutMs?: number): Promise<McpHealthCheckResult[]>;
+export declare function warnUnhealthyServers(results: readonly McpHealthCheckResult[]): void;
+export declare function isMcpHealthCheckEnabled(): boolean;

package/dist/agent/provider.d.ts

@@ -71,7 +71,7 @@ export type ProviderEvent = {
 } | {
     type: 'notice';
     text: string;
-    kind: 'truncation' | 'refusal';
+    kind: 'truncation' | 'refusal' | 'fast-tier';
     sessionId?: string;
 } | {
     type: 'tool.use.start';

package/dist/agent/providers/openai-compatible/index.d.ts

@@ -28,6 +28,7 @@ export interface OpenAICompatibleProviderOptions extends ChildSessionOptions {
     tools?: ToolDispatcher;
     mcpManager?: import('../../mcp/index.js').McpManager;
     customTools?: import('../../tools/custom-tool.js').CustomToolDef[];
+    fastModeController?: import('../../fast-mode.js').FastModeController;
 }
 export declare class OpenAICompatibleProvider implements ModelProvider {
     readonly name = "openai-compatible";

package/dist/agent/providers/openai-compatible/models-catalog.d.ts

@@ -0,0 +1,16 @@
+export interface CatalogModel {
+    slug: string;
+    service_tiers?: Array<{
+        id: string;
+        name?: string;
+        description?: string;
+    }>;
+    default_service_tier?: string;
+}
+export interface CatalogReaderDeps {
+    homedir?: () => string;
+    readFile?: (path: string) => string | null;
+}
+export declare function resetCatalogCache(): void;
+export declare function loadModelsCatalog(deps?: CatalogReaderDeps): Map<string, CatalogModel>;
+export declare function isCatalogModelPriorityEligible(modelSlug: string, deps?: CatalogReaderDeps): boolean | undefined;

package/dist/agent/providers/openai-compatible/pricing.d.ts

@@ -5,3 +5,4 @@ export interface ModelPricing {
 }
 export declare const MODEL_PRICING: ReadonlyMap<string, ModelPricing>;
 export declare function deriveCallCostUsd(model: string, inputTokens: number, outputTokens: number, cachedInputTokens?: number): number | undefined;
+export declare function deriveCallCostUsdWithTier(model: string, inputTokens: number, outputTokens: number, cachedInputTokens?: number, confirmedPriorityTier?: boolean): number | undefined;

package/dist/agent/providers/openai-compatible/query/chatgpt-backend-errors.d.ts

@@ -0,0 +1,2 @@
+export declare function chatGptClaudeModelError(model: string): Error;
+export declare function clarifyResponsesError(err: unknown, isChatGptBackend: boolean, model: string): Error;

package/dist/agent/providers/openai-compatible/query/fast-mode.d.ts

@@ -0,0 +1,6 @@
+import type { FastModeController, FastTurnDecision } from '../../../fast-mode.js';
+export declare function snapshotFastDecision(controller: FastModeController | undefined, model: string, hasCustomEndpoint: boolean): FastTurnDecision | undefined;
+export declare function isFastModeServiceTierError(error: unknown): boolean;
+export declare function extractResponsesServiceTier(responseObj: Record<string, unknown> | null | undefined): string | undefined;
+export declare function extractChatCompletionsServiceTier(chunk: Record<string, unknown> | null | undefined): string | undefined;
+export declare function makeFastModeMismatchWarning(fast: boolean, appliedTier: string | undefined): string | undefined;

package/dist/agent/providers/openai-compatible/query/fast-tier-session.d.ts

@@ -0,0 +1,26 @@
+import type { FastModeController } from '../../../fast-mode.js';
+import type { ProviderEvent } from '../../../provider.js';
+export declare const OPENAI_FAST_SERVICE_TIER = "priority";
+export declare function isCustomOpenAIEndpoint(baseURL: string | undefined): boolean;
+export interface FastTierOptions {
+    controller: FastModeController;
+    hasCustomEndpoint: boolean;
+}
+export declare class FastTierSession {
+    private readonly opts;
+    private rejected;
+    private warned;
+    private turnFast;
+    private appliedTier;
+    private pendingNotice;
+    constructor(opts: FastTierOptions | undefined);
+    beginTurn(model: string): boolean;
+    get active(): boolean;
+    create<T>(body: Record<string, unknown>, call: (b: Record<string, unknown>) => Promise<T>): Promise<T>;
+    observeResponsesEvent(event: unknown): void;
+    observeChatChunk(chunk: unknown): void;
+    confirmedFast(): boolean;
+    drainNotice(sessionId: string): Generator<ProviderEvent>;
+    private recordApplied;
+    private queueNotice;
+}

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

@@ -4,6 +4,7 @@ import type { ProviderQuery, ProviderEvent, ProviderUserTurn, ProviderContextUsa
 import { type OpenAIAuthResolution, type AuthResolverDeps } from './auth.js';
 import type { ToolDispatcher } from '../anthropic-direct/tool-dispatcher.js';
 import { resolveReasoningEffort } from './query/model-params.js';
+import { type FastTierOptions } from './query/fast-tier-session.js';
 export { __setRetryBaseDelay } from './query/retry.js';
 export { __setOpenAIClientFactory } from './query/client.js';
 export type { OpenAIClientFactory } from './query/client.js';
@@ -23,6 +24,7 @@ export interface OpenAICompatibleQueryOptions {
     mcpManager?: import('../../mcp/index.js').McpManager;
     useResponsesApi?: boolean;
     traceWriter?: TraceSink;
+    fastTier?: FastTierOptions;
 }
 export declare class OpenAICompatibleQuery implements ProviderQuery {
     private readonly client;
@@ -35,6 +37,7 @@ export declare class OpenAICompatibleQuery implements ProviderQuery {
     private readonly wireMode;
     private readonly useOpenAIPricing;
     private readonly traceWriter;
+    private readonly fastTier;
     private priorTurns;
     private currentModel;
     private currentPermissionMode;
@@ -49,7 +52,6 @@ export declare class OpenAICompatibleQuery implements ProviderQuery {
     private runTurn;
     private _runTurnInner;
     private finishTurn;
-    private clarifyResponsesError;
     private runIteration;
     private dispatchAndAppend;
     interrupt(reason?: import('../../abort-reason.js').ProviderAbortReason): Promise<void>;
@@ -80,4 +82,5 @@ export declare function buildQueryFromConfig(config: AgentConfig, promptStream:
     useResponsesApi?: boolean;
     authDeps?: AuthResolverDeps;
     sessionIdOverride?: string;
+    fastTier?: FastTierOptions;
 }): OpenAICompatibleQuery;

package/dist/agent/providers/openai-compatible/translate.d.ts

@@ -48,6 +48,6 @@ export interface AccumulatedToolCall {
 }
 export declare function createStreamState(): StreamState;
 export declare function translateChunk(chunk: OpenAIChunk, state: StreamState, sessionId: string): Generator<ProviderEvent>;
-export declare function usageFromState(state: StreamState, model?: string): ProviderUsage;
+export declare function usageFromState(state: StreamState, model?: string, confirmedPriorityTier?: boolean): ProviderUsage;
 export declare function finalizedToolCalls(state: StreamState): AccumulatedToolCall[];
 export declare function isToolCallStop(state: StreamState): boolean;

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

@@ -71,7 +71,7 @@ export type OutputEvent = {
 } | {
     type: 'notice';
     text: string;
-    kind: 'truncation' | 'refusal';
+    kind: 'truncation' | 'refusal' | 'fast-tier';
 } | {
     type: 'tool-activity';
     activeCount: number;

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

@@ -22,6 +22,7 @@ export interface ResetStateHost {
     hasCommitted: boolean;
     placementMode: FramePlacementMode;
     commitInFlight: boolean;
+    pendingContentRows: number | null;
     pendingResizeErase: {
         top: number;
         bottom: number;