agent-afk 5.168.2 → 5.169.1

package/README.md

@@ -1,10 +1,8 @@
 # Agent AFK
 
-> **Claude Code decides how the agent behaves. Agent AFK lets you edit the rules.**
+**Start a task and walk away.** AFK builds the feature, verifies its own work, and texts you when it's done. You come back to a receipt of every step, every decision, and what's waiting on you.
 
-**Agent AFK** is an open-source coding-agent harness you can actually change. Run long coding tasks while you're away, use any model, and edit the rules that decide what the agent can touch, when it stops, and how it proves the work.
-
-> Agent AFK isn't "smarter than Claude Code." It's *yours* in a way Claude Code can't be.
+Open source. Runs locally. Works with any model provider, including local models. Your keys, your machine, your rules.
 
 [![npm version](https://img.shields.io/npm/v/agent-afk.svg)](https://www.npmjs.com/package/agent-afk)
 [![CI](https://github.com/griffinwork40/agent-afk/actions/workflows/ci.yml/badge.svg)](https://github.com/griffinwork40/agent-afk/actions/workflows/ci.yml)
@@ -19,18 +17,7 @@
   </video>
 </p>
 
-> ⭐ **Like the idea of an agent loop you fully own? [Star the repo](https://github.com/griffinwork40/agent-afk/stargazers)** — it's the fastest way to help other people find it.
-
-## Claude Code vs. Agent AFK
-
-| | Claude Code | Agent AFK |
-|---|---|---|
-| Harness | Closed binary | Apache-2.0, editable |
-| The loop | You configure *around* it | You edit *the loop* |
-| Behavior | Mostly fixed | Prompts, gates, routing, skills are code |
-| Result | A great default agent | An agent system you own |
-
-The model isn't the product — the loop is. Agent AFK hands you the loop as code: prompts, gates, routing, skills, traces, providers, terminal states. Edit any of them.
+> ⭐ **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
 
@@ -57,11 +44,20 @@ afk chat "hello"
 - **Read the trace** — every run writes an append-only record of what the agent did. `afk trace show` prints it back as a human-readable receipt — tool calls, gate decisions, subagent lifecycles, cost — so you can audit a run without reaching for `jq`.
 - **Message Claude from Telegram** — `afk telegram setup` walks you through bot token + allowlist. After that you have a private chat surface backed by the same session manager as the REPL.
 - **Built-in orchestrators** — `/mint`, `/diagnose`, `/spec`, `/research`, `/ship`, `/review` dispatch subagent waves. `/mint` takes a feature idea and runs spec → research → plan → parallelize → build → verify → ship. `/diagnose` forks parallel root-cause hypotheses for failing tests and bugs.
-
-> **Agent AFK Pro:** Autonomous skill-generation (`/forge`) and the calibrated skill-qualification rubric (`/qualify`) are reserved for Agent AFK Pro and are not part of the open-source build.
 - **Cross-session memory** — Claude remembers preferences, decisions, and procedures across runs. See [Memory](#memory) below.
 - **Background subagent jobs** — dispatch a subagent with `mode:'background'`; results auto-deliver into the model's context when they finish. `/bgsub` lists running and completed jobs, `/bgsub:join <id>` replays a result manually.
 
+## How it compares
+
+| | Claude Code | Agent AFK |
+|---|---|---|
+| Harness | Closed binary | Apache-2.0, editable |
+| The loop | You configure *around* it | You edit *the loop* |
+| Behavior | Mostly fixed | Prompts, gates, routing, skills are code |
+| Result | A great default agent | An agent system you own |
+
+The model isn't the product -- the loop is. Agent AFK hands you the loop as code: prompts, gates, routing, skills, traces, providers, terminal states. Edit any of them.
+
 ## Four surfaces, one session manager
 | Command | Surface |
 |---|---|
@@ -251,15 +247,15 @@ Recent releases at [`CHANGELOG.md`](CHANGELOG.md), also viewable in-REPL via `/c
 
 ## License
 
-Agent AFK is **open core**, licensed under **[Apache-2.0](LICENSE)** (SPDX: `Apache-2.0`).
-Use it, modify it, fork it, embed it in commercial or closed-source products — the
+Agent AFK is **open source**, licensed under **[Apache-2.0](LICENSE)** (SPDX: `Apache-2.0`).
+Use it, modify it, fork it, embed it in commercial or closed-source products -- the
 standard Apache conditions apply (keep the license and [`NOTICE`](NOTICE), note
 significant changes, and don't use the "Agent AFK" name or marks to imply
-endorsement). No copyleft, no CLA.
+endorsement). No copyleft, no CLA. Every feature ships in the open-source repo --
+there are no paid unlocks.
 
-**Pro & Team add-ons** (premium skill packs, team features, priority support) are
-separate commercial products under their own terms — see [`LICENSING.md`](LICENSING.md).
-The core harness is, and will stay, free and open.
+Paid plans are monthly support from the maintainer (setup, custom skills, tuning),
+not feature gates. See [`LICENSING.md`](LICENSING.md).
 
 Contributions are accepted under the [DCO](https://developercertificate.org/)
-(`git commit -s`). "Agent AFK" is a trademark of Griffin Long. © Griffin Long.
+(`git commit -s`). "Agent AFK" is a trademark of Griffin Long. (c) Griffin Long.

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

@@ -36,6 +36,7 @@ export declare class AgentSession implements IAgentSession {
     private subagentRunningTokens;
     private subagentRunningCostUsd;
     private readonly ledger;
+    private readonly outputBroadcast;
     constructor(config: AgentConfig, ownedTraceWriter?: TraceWriter);
     private initSdkLifecycle;
     private pullInitialization;

package/dist/agent/session/output-broadcast.d.ts

@@ -0,0 +1,8 @@
+import type { OutputEvent } from '../types/session-types.js';
+export declare class OutputBroadcast {
+    private readonly subscribers;
+    private closed;
+    push(event: OutputEvent): void;
+    close(): void;
+    subscribe(): AsyncIterable<OutputEvent>;
+}

package/dist/agent/subagent/handle.d.ts

@@ -20,6 +20,8 @@ export interface SubagentHandle<T = unknown> {
         deferInjectContextToCaller?: boolean;
     }): Promise<void>;
     getLastStopInjectContext(): string | undefined;
+    readonly durationMs: number | undefined;
+    sendMessage(text: string): void;
 }
 export declare class SubagentHandleImpl<T> implements SubagentHandle<T> {
     readonly id: string;
@@ -55,6 +57,7 @@ export declare class SubagentHandleImpl<T> implements SubagentHandle<T> {
     };
     constructor(id: string, session: IAgentSession, _controller: AbortController, abortGraph: AbortGraph, _outputSchema: ZodType<T> | undefined, timeoutMs: number, _hookRegistry: HookRegistry | undefined, _onTerminal: () => void, _parentInputStreamRef?: ReturnType<IAgentSession["getInputStreamRef"]> | undefined, _parentAbortSignal?: AbortSignal | undefined, _agentType?: string | undefined, progressSink?: SubagentProgressSink, parentId?: string, _traceWriter?: TraceSink | undefined, onSubagentSucceeded?: ((usage: SubagentTrace["usage"], costUsd: number | undefined) => void) | undefined, _idleTimeoutMs?: number);
     get status(): SubagentStatus;
+    get durationMs(): number | undefined;
     run(prompt: string | ContentBlockParam[], sinkOverride?: SubagentProgressSink): Promise<Message>;
     runToResult(prompt: string | ContentBlockParam[], sinkOverride?: SubagentProgressSink): Promise<SubagentResult<T>>;
     runInBackground(prompt: string, onResult?: (result: SubagentResult<T>) => void, onProgress?: (event: OutputEvent) => void): void;
@@ -63,4 +66,7 @@ export declare class SubagentHandleImpl<T> implements SubagentHandle<T> {
         deferInjectContextToCaller?: boolean;
     }): Promise<void>;
     getLastStopInjectContext(): string | undefined;
+    readonly _pendingUserMessages: string[];
+    private _drainingMessages;
+    sendMessage(text: string): void;
 }

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

@@ -106,6 +106,7 @@ export interface TurnHandles {
     setBackgroundHandler?(handler: (() => void) | null): void;
     subagentControl?: SubagentControl;
     setSoftStopHandler?(handler: (() => void) | null): void;
+    setTaskViewHandler?(handler: (() => boolean) | null): void;
     setPausedState?(paused: boolean): void;
     setPauseInterruptHandler?(handler: (() => void) | null): void;
     onContextProgress?(): void | Promise<void>;

package/dist/cli/commands/interactive/task-view-mid-turn.d.ts

@@ -0,0 +1,9 @@
+import type { SubagentManager } from '../../../agent/subagent.js';
+import type { TerminalCompositor } from '../../terminal-compositor.js';
+import type { TurnHandles } from './shared.js';
+export interface MidTurnTaskViewOptions {
+    manager: SubagentManager;
+    compositor: TerminalCompositor;
+}
+export declare function launchMidTurnTaskView(opts: MidTurnTaskViewOptions): Promise<boolean>;
+export declare function createTaskViewHandler(h: Pick<TurnHandles, 'getCompositor' | 'setTaskViewHandler'>): (() => boolean) | null;

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

@@ -1,6 +1,6 @@
 import type { AgentSession } from '../../../agent/session.js';
 import type { SessionStats } from '../../slash/types.js';
-import type { ImageAttachment } from '../../input/attachments.js';
+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';

package/dist/cli/input/input-surface.d.ts

@@ -49,6 +49,7 @@ export declare class InputSurface {
     private armedStdout;
     private backgroundHandler;
     private softStopHandler;
+    private taskViewHandler;
     private pauseInterruptHandler;
     private pendingReadReject;
     private pendingReadResolve;
@@ -59,6 +60,7 @@ export declare class InputSurface {
     getCompositor(): TerminalCompositor | null;
     setBackgroundHandler(handler: (() => void) | null): void;
     setSoftStopHandler(handler: (() => void) | null): void;
+    setTaskViewHandler(handler: (() => boolean) | null): void;
     setPauseInterruptHandler(handler: (() => void) | null): void;
     setPausedState(paused: boolean): void;
     suspendForElicitation(): void;

package/dist/cli/slash/commands/tasks.d.ts

@@ -3,6 +3,7 @@ import type { SubagentManager } from '../../../agent/subagent.js';
 import type { InteractiveCtx } from '../../commands/interactive/shared.js';
 export declare function setTasksRegistry(manager: SubagentManager, sessionLabel: string): void;
 export declare function setTasksIctx(ictx: InteractiveCtx): void;
+export declare function getTasksManager(): SubagentManager | undefined;
 export declare function resetTasksRegistry(): void;
 export declare const tasksCmd: SlashCommand;
 export declare const tasksViewCmd: SlashCommand;

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

@@ -23,6 +23,7 @@ export declare class TerminalCompositor {
     lastIdleEscAt: number;
     onPauseInterrupt?: () => void;
     onShiftTab?: () => void;
+    onTaskView?: () => boolean;
     onOpenEditor?: () => void;
     readonly promptTextFn: () => string;
     readonly history?: IHistoryRing;

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

@@ -43,6 +43,7 @@ export interface KeyDispatchHost {
     readonly onRewindRequest?: () => void;
     readonly onPauseInterrupt?: () => void;
     readonly onShiftTab?: () => void;
+    readonly onTaskView?: () => boolean;
     readonly onOpenEditor?: () => void;
     readonly onSubmit?: (payload: SubmissionPayload) => void;
 }

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

@@ -63,6 +63,7 @@ export interface TerminalCompositorOptions {
     onBackground?: () => void;
     onPauseInterrupt?: () => void;
     onShiftTab?: () => void;
+    onTaskView?: () => boolean;
     onOpenEditor?: () => void;
     onSubmit?: (payload: SubmissionPayload) => void;
     promptText?: string | (() => string);