agent-afk 5.321.9 → 5.322.0

package/dist/agent/mcp/error-hints.d.ts

@@ -0,0 +1,13 @@
+import type { ToolResult } from '../tools/types.js';
+import type { McpServerConfig } from './types.js';
+import { channelFromArgs, type RealChromeProbeResult } from '../../browser/real-chrome-probe.js';
+export interface McpErrorHintRule {
+    id: string;
+    appliesTo(serverName: string, config: McpServerConfig): boolean;
+    hint(errorText: string, config: McpServerConfig): string | undefined;
+}
+export interface McpErrorHintDeps {
+    probe?: (channel: ReturnType<typeof channelFromArgs>) => RealChromeProbeResult;
+}
+export declare function chromeDevtoolsActivePortRule(deps?: McpErrorHintDeps): McpErrorHintRule;
+export declare function applyMcpErrorHints(serverName: string, config: McpServerConfig, result: ToolResult, rules?: readonly McpErrorHintRule[]): ToolResult;

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

@@ -0,0 +1,6 @@
+import type { ProviderEvent, ProviderUsage } from '../../../provider.js';
+import { TOOL_USE_LOOP_CAPPED } from '../../shared/tool-loop-cap.js';
+import { SOFT_DEADLINE_WIND_DOWN } from '../../shared/soft-deadline.js';
+import { CONTEXT_PRESSURE_WIND_DOWN } from '../../shared/context-pressure.js';
+import type { TurnDriverContext } from './turn-driver.js';
+export declare function emitTurnTerminal(ctx: TurnDriverContext, finalAssistantText: string, droppedToolNames: string[], accumulatedUsage: ProviderUsage, windDownReason: typeof TOOL_USE_LOOP_CAPPED | typeof SOFT_DEADLINE_WIND_DOWN | typeof CONTEXT_PRESSURE_WIND_DOWN | null, turnStartTime: number): AsyncGenerator<ProviderEvent>;

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

@@ -21,6 +21,7 @@ export declare class SessionCostAccumulator {
     private closureSum;
     private closureCount;
     private lastClosureCost;
+    private lastClosureSubagentId;
     private readonly tokens;
     private sealRoot;
     private sealSubagent;

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

@@ -714,6 +714,7 @@ export declare const TraceEventInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject
             compose_recovery_decision: "compose_recovery_decision";
             compose_leaf_tools_stripped: "compose_leaf_tools_stripped";
             hook_block_repeat_tripped: "hook_block_repeat_tripped";
+            billing_settled: "billing_settled";
         }>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
@@ -1173,6 +1174,7 @@ export declare const TraceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             compose_recovery_decision: "compose_recovery_decision";
             compose_leaf_tools_stripped: "compose_leaf_tools_stripped";
             hook_block_repeat_tripped: "hook_block_repeat_tripped";
+            billing_settled: "billing_settled";
         }>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;

package/dist/agent/trace/events.session-phase.d.ts

@@ -49,6 +49,7 @@ export declare const SessionPhaseNameSchema: z.ZodEnum<{
     compose_recovery_decision: "compose_recovery_decision";
     compose_leaf_tools_stripped: "compose_leaf_tools_stripped";
     hook_block_repeat_tripped: "hook_block_repeat_tripped";
+    billing_settled: "billing_settled";
 }>;
 export declare const SessionPhasePayloadSchema: z.ZodObject<{
     phase: z.ZodEnum<{
@@ -101,6 +102,7 @@ export declare const SessionPhasePayloadSchema: z.ZodObject<{
         compose_recovery_decision: "compose_recovery_decision";
         compose_leaf_tools_stripped: "compose_leaf_tools_stripped";
         hook_block_repeat_tripped: "hook_block_repeat_tripped";
+        billing_settled: "billing_settled";
     }>;
     durationMs: z.ZodOptional<z.ZodNumber>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;

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

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

@@ -118,5 +118,6 @@ export interface AgentConfig {
     };
     telegramChatId?: number;
     telegramThreadId?: number;
+    telegramOnInjectable?: () => void;
     customTools?: import('../tools/custom-tool.js').CustomToolDef[];
 }

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

@@ -1,5 +1,7 @@
 export type EffortLevel = 'low' | 'medium' | 'high' | 'xhigh' | 'max';
 export type PermissionMode = 'default' | 'acceptEdits' | 'bypassPermissions' | 'plan' | 'dontAsk' | 'auto' | 'autonomous';
+export declare const VALID_PERMISSION_MODES: ReadonlySet<string>;
+export declare function isValidPermissionMode(value: string): value is PermissionMode;
 export type SettingSource = 'user' | 'project' | 'local';
 export type ApiKeySource = 'user' | 'project' | 'org' | 'temporary' | 'oauth';
 export type SDKStatus = 'compacting' | 'requesting' | null;

package/dist/browser/real-chrome-advice.d.ts

@@ -0,0 +1,10 @@
+import { type RealChromeProbeResult } from './real-chrome-probe.js';
+export declare const REMOTE_DEBUGGING_URL = "chrome://inspect/#remote-debugging";
+export declare const MAC_FILES_AND_FOLDERS_URL = "x-apple.systempreferences:com.apple.preference.security?Privacy_FilesAndFolders";
+export interface RealChromeAdvice {
+    headline: string;
+    steps: string[];
+    openUrl?: string;
+}
+export declare function adviseRealChrome(probe: RealChromeProbeResult): RealChromeAdvice;
+export declare function formatRealChromeAdvice(advice: RealChromeAdvice): string;

package/dist/browser/real-chrome-probe.d.ts

@@ -0,0 +1,24 @@
+export declare const CHROME_DEVTOOLS_SERVER_NAME = "chrome-devtools";
+export declare const REAL_CHROME_CHANNELS: readonly ["stable", "beta", "canary", "dev"];
+export type RealChromeChannel = (typeof REAL_CHROME_CHANNELS)[number];
+export type RealChromeState = 'ok' | 'missing' | 'blocked' | 'unknown';
+export interface RealChromeProbeResult {
+    state: RealChromeState;
+    channel: RealChromeChannel;
+    platform: NodeJS.Platform;
+    userDataDir: string | null;
+    errorCode?: string;
+    terminalBundleId?: string;
+}
+export interface RealChromeProbeOptions {
+    channel?: RealChromeChannel;
+    platform?: NodeJS.Platform;
+    home?: string;
+    localAppData?: string;
+    terminalBundleId?: string;
+    touchFile?: (file: string) => void;
+}
+export declare function chromeAppName(channel: RealChromeChannel): string;
+export declare function resolveChromeUserDataDir(channel: RealChromeChannel, platform: NodeJS.Platform, home: string, localAppData: string | undefined): string | null;
+export declare function probeRealChrome(opts?: RealChromeProbeOptions): RealChromeProbeResult;
+export declare function channelFromArgs(args: readonly string[] | undefined): RealChromeChannel;

package/dist/cli/commands/browser.connect-diagnosis.d.ts

@@ -0,0 +1,4 @@
+import { type RealChromeChannel } from '../../browser/real-chrome-probe.js';
+export declare const CHROME_DEVTOOLS_MCP_FALLBACK_VERSION = "1.11.0";
+export declare function resolveChromeDevtoolsMcpVersion(): string;
+export declare function printConnectDiagnosis(channel: RealChromeChannel, open: boolean, platform?: NodeJS.Platform): void;

package/dist/cli/commands/browser.d.ts

@@ -1,11 +1,10 @@
 import { Command } from 'commander';
 import { type McpConfigFile } from '../../agent/mcp/index.js';
 import type { McpServerConfig } from '../../agent/mcp/types.js';
-export declare const CHROME_DEVTOOLS_SERVER_NAME = "chrome-devtools";
-declare const VALID_CHANNELS: readonly ["stable", "beta", "canary", "dev"];
-type ChromeChannel = (typeof VALID_CHANNELS)[number];
-export declare function buildChromeDevtoolsEntry(channel?: ChromeChannel): McpServerConfig;
+import { CHROME_DEVTOOLS_SERVER_NAME, type RealChromeChannel } from '../../browser/real-chrome-probe.js';
+export { CHROME_DEVTOOLS_SERVER_NAME };
+type ChromeChannel = RealChromeChannel;
+export declare function buildChromeDevtoolsEntry(channel?: ChromeChannel, version?: string): McpServerConfig;
 export declare function readMcpConfigFile(path: string): McpConfigFile;
 export declare function writeMcpConfigFileAtomic(path: string, cfg: McpConfigFile): void;
 export declare function registerBrowserCommand(program: Command): void;
-export {};

package/dist/cli/commands/chat.action-body.d.ts

@@ -1,5 +1,6 @@
 import type { AgentSession } from '../../agent/session.js';
 import type { AgentModelInput } from '../../agent/types.js';
+import type { PermissionMode } from '../../agent/types/sdk-types.js';
 import { parseThinking, parseEffort } from '../shared-helpers.js';
 import { setupWorktree } from './interactive/worktree.js';
 import { resolveResumeTarget, resumeConfigFor } from '../resume-session.js';
@@ -30,6 +31,7 @@ export interface ChatActionOptions {
     sessionId?: string;
     post?: string;
     postPr?: string;
+    permissionMode?: PermissionMode;
     dangerouslySkipPermissions?: boolean;
 }
 export declare function resolvePostTargets(post: string | undefined): PostTarget[];

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

@@ -6,6 +6,7 @@ import type { SessionRef } from '../../../agent/session-ref.js';
 import type { MemoryStore } from '../../../agent/memory/index.js';
 import type { StateStore } from '../../../agent/state/state-store.js';
 import type { AgentModelInput } from '../../../agent/types.js';
+import type { PermissionMode } from '../../../agent/types/sdk-types.js';
 import type { BackgroundAgentRegistry } from '../../../agent/background-registry.js';
 import type { BackgroundSummarizer } from '../../../agent/background-summarizer.js';
 import type { SubagentControl } from '../../../agent/tools/subagent-executor.js';
@@ -36,6 +37,7 @@ export interface CliOptions {
     continue?: boolean;
     debug?: boolean;
     dangerouslySkipPermissions?: boolean;
+    permissionMode?: PermissionMode;
     worktree?: string | true;
     worktreeAutoname?: boolean;
     worktreeBase?: string;
@@ -169,5 +171,5 @@ export declare function formatStatusFields(stats: SessionStats, sampler?: Contex
     contextLimit: number;
     contextUsedTokens: number | undefined;
     contextSparkline: string | undefined;
-    permissionMode: import("../../../agent/types.js").PermissionMode;
+    permissionMode: PermissionMode;
 };

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

@@ -87,6 +87,7 @@ export declare class TerminalCompositor {
     committedBandArchivedPrefix: number;
     bandReflowCache: BandReflowCache | null;
     lastKnownRows: number;
+    lastKnownCols: number;
     pendingResizeErase: {
         top: number;
         bottom: number;

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

@@ -35,6 +35,7 @@ export interface FrameHost {
     anchorRow: number | undefined;
     placementMode: FramePlacementMode;
     lastKnownRows: number;
+    lastKnownCols: number;
     commitInFlight: boolean;
     cprPending: boolean;
     resizeGeometryStale: boolean;

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

@@ -31,6 +31,7 @@ export interface LifecycleHost {
     readonly caretBlinkController: CaretBlinkController;
     readonly ghostEngine: SuggestEngine | undefined;
     lastKnownRows: number;
+    lastKnownCols: number;
     pendingResizeErase: {
         top: number;
         bottom: number;

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

@@ -31,6 +31,7 @@ export interface ResetStateHost {
     bandGeometryStale: boolean;
     resizeGeometryStale: boolean;
     lastKnownRows: number;
+    lastKnownCols: number;
     cprPending: boolean;
     pickerController: PickerController | null;
     inputMode: CompositorInputMode;