agent-afk 5.254.3 → 5.254.4

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/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;