agent-afk 5.232.1 → 5.233.0

package/README.md

@@ -19,23 +19,22 @@ Open source. Runs locally. Works with any model provider, including local models
 
 > ⭐ **Like the idea of an agent you can walk away from? [Star the repo](https://github.com/griffinwork40/agent-afk/stargazers)** -- it's the fastest way to help other people find it.
 
-## Install
+## Quick Start
 
 ```bash
-npm install -g agent-afk
+npm install -g agent-afk    # Node ≥ 22 required
+afk login                   # authenticate (auto-detects Claude Code / Codex creds)
+afk doctor                  # verify everything works
+afk chat "hello"             # first real conversation
 ```
 
-Requires Node ≥ 22.
+That's it. You're in.
 
-Smoke test:
+**Try without installing:** `npx agent-afk chat "hello"` runs a one-shot turn with zero global install.
 
-```bash
-afk --version    # confirm the install (works before login)
-afk doctor       # environment self-check
-afk chat "hello"
-```
+**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.
 
-**Already using Claude Code or Codex?** Run `afk migrate` — it imports your existing plugins, skills, and MCP servers. It doesn't copy files; it live-reads the source tool's dirs, so anything you install there keeps showing up in AFK with no re-run.
+> 📖 **Full documentation at [docs.agentafk.com](https://docs.agentafk.com)** -- quickstart, configuration, model setup, surfaces, skills, and SDK reference.
 
 ## What you can do with it
 
@@ -231,7 +230,7 @@ With containment on (`default`), a file tool (read/write/edit/list/glob/grep) ta
 
 ## Troubleshooting
 
-**`invalid x-api-key` / `ANTHROPIC_API_KEY not found`** — run `afk doctor`. Confirm the key is set in your shell or in `~/.afk/config/afk.env`.
+**`invalid x-api-key` / `ANTHROPIC_API_KEY not found`** — run `afk login` to authenticate interactively, or set the key manually: `export ANTHROPIC_API_KEY=sk-ant-...` (or add it to `~/.afk/config/afk.env`). Run `afk doctor` to confirm.
 
 **`Cannot send message: session is closed`** — the session timed out or was closed. Start a new one (`afk i` or a fresh `afk chat`).
 

package/dist/agent/branch/branch-prune.d.ts

@@ -0,0 +1,36 @@
+export type ExecForBranchPrune = (file: string, args: string[], opts?: {
+    cwd?: string;
+}) => Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+export type PrState = 'open' | 'merged' | 'closed' | 'none';
+export type BranchVerdict = 'prune' | 'keep' | 'error';
+export interface BranchCandidate {
+    remoteBranch: string;
+    shortName: string;
+    prState: PrState;
+    commitsAhead: number;
+    verdict: BranchVerdict;
+    reason: string;
+    errorDetail?: string;
+}
+export interface BranchPruneResult {
+    candidates: BranchCandidate[];
+    deleted: string[];
+    warnings: string[];
+    dryRun: boolean;
+}
+export interface BranchPruneOptions {
+    execFn: ExecForBranchPrune;
+    remote?: string;
+    baseBranch?: string;
+    branchPrefix?: string;
+    dryRun?: boolean;
+    cwd?: string;
+}
+export declare function parseGhPrState(ghOutput: string): PrState;
+export declare function parseCommitsAhead(revListOutput: string): number;
+export declare function classify(prState: PrState, commitsAhead: number): Pick<BranchCandidate, 'verdict' | 'reason'>;
+export declare function listRemoteBranches(execFn: ExecForBranchPrune, remote: string, branchPrefix: string, cwd: string): Promise<string[]>;
+export declare function runBranchPrune(options: BranchPruneOptions): Promise<BranchPruneResult>;

package/dist/agent/facets/index.d.ts

@@ -1,4 +1,4 @@
-export { FACET_VERSION, SessionFacetSchema, StoredSessionInputSchema, FacetOutcomeSchema, SubagentPersistenceSchema, SubagentInvocationSchema, WorldChangesSchema, TokenBreakdownSchema, type SessionFacet, type StoredSessionInput, type ToolEventInput, type FacetOutcome, type SubagentInvocation, type WorldChanges, type TokenBreakdown, } from './schema.js';
+export { FACET_VERSION, SessionFacetSchema, StoredSessionInputSchema, FacetOutcomeSchema, SubagentPersistenceSchema, SubagentInvocationSchema, WorldChangesSchema, TokenBreakdownSchema, ParallelDispatchStatsSchema, type SessionFacet, type StoredSessionInput, type ToolEventInput, type FacetOutcome, type SubagentInvocation, type WorldChanges, type TokenBreakdown, type ParallelDispatchStats, } from './schema.js';
 export { deriveSessionFacet, type DeriveOptions } from './derive.js';
 export { getOrDeriveFacet, loadStoredSession, listSessionIds, type FacetStoreOptions, } from './store.js';
 export { createFacetSessionEndHook } from './session-end-hook.js';

package/dist/agent/facets/schema.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-export declare const FACET_VERSION = 3;
+export declare const FACET_VERSION = 4;
 export declare const ToolEventInputSchema: z.ZodObject<{
     toolName: z.ZodString;
     toolUseId: z.ZodOptional<z.ZodString>;
@@ -86,6 +86,14 @@ export declare const TokenBreakdownSchema: z.ZodObject<{
     cost_usd: z.ZodNumber;
 }, z.core.$strip>;
 export type TokenBreakdown = z.infer<typeof TokenBreakdownSchema>;
+export declare const ParallelDispatchStatsSchema: z.ZodObject<{
+    total_tool_calls: z.ZodNumber;
+    parallel_tool_calls: z.ZodNumber;
+    parallel_turns: z.ZodNumber;
+    tool_turns: z.ZodNumber;
+    ratio: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type ParallelDispatchStats = z.infer<typeof ParallelDispatchStatsSchema>;
 export declare const SessionFacetSchema: z.ZodObject<{
     facet_version: z.ZodNumber;
     session_id: z.ZodString;
@@ -148,6 +156,13 @@ export declare const SessionFacetSchema: z.ZodObject<{
         cache_creation: z.ZodOptional<z.ZodNumber>;
         cost_usd: z.ZodNumber;
     }, z.core.$strip>>;
+    parallel_dispatch: z.ZodObject<{
+        total_tool_calls: z.ZodNumber;
+        parallel_tool_calls: z.ZodNumber;
+        parallel_turns: z.ZodNumber;
+        tool_turns: z.ZodNumber;
+        ratio: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
     decisions: z.ZodArray<z.ZodString>;
     evidence_pointers: z.ZodArray<z.ZodString>;
 }, z.core.$loose>;

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

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerBranchCommand(program: Command): void;

package/dist/cli/commands/interactive/turn-handler.d.ts

@@ -1,9 +1,12 @@
 import type { AgentSession } from '../../../agent/session.js';
-import type { SessionStats } from '../../slash/types.js';
+import type { SessionStats, ToolEvent } from '../../slash/types.js';
+import type { ContentBlockParam } from '@anthropic-ai/sdk/resources';
 import { type ImageAttachment } from '../../input/attachments.js';
 import type { InputSurfaceRefs } from '../../input/input-surface.js';
 import { type CompletionWriter, type ThinkingUiMode, type TurnHandles } from './shared.js';
 export { formatToolLine, formatToolResultLine, ToolLane } from './tool-lane.js';
+export declare function buildAssistantContentBlocks(responseText: string, toolEvents: ToolEvent[]): ContentBlockParam[] | undefined;
+export declare function buildUserContentBlocks(userText: string, toolEvents: ToolEvent[]): ContentBlockParam[] | undefined;
 export type { InputSurfaceRefs } from '../../input/input-surface.js';
 export declare function runTurn(input: {
     text: string;

package/dist/cli/slash/session-stats.d.ts

@@ -1,6 +1,7 @@
 import type { ResponseMetadata } from '../../agent/types/message-types.js';
 import type { AgentModelInput } from '../../agent/types.js';
+import type { ContentBlockParam } from '@anthropic-ai/sdk/resources';
 import type { SessionStats, ToolEvent, TurnRecord } from './types.js';
 export declare function createSessionStats(model: AgentModelInput): SessionStats;
 export declare function resetStats(stats: SessionStats): void;
-export declare function recordTurn(stats: SessionStats, userInput: string, assistantText: string, metadata: ResponseMetadata | undefined, toolEvents?: ToolEvent[]): TurnRecord;
+export declare function recordTurn(stats: SessionStats, userInput: string, assistantText: string, metadata: ResponseMetadata | undefined, toolEvents?: ToolEvent[], userContentBlocks?: ContentBlockParam[], assistantContentBlocks?: ContentBlockParam[]): TurnRecord;