agent-afk 3.80.7 → 3.81.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # Agent AFK
2
2
 
3
- > Past the happy path of AI coding.
3
+ > Works while you're away.
4
4
  >
5
- > One prompt, one agent, one clean diff is the easy case. **Agent AFK** is the runtime for everything after multi-session work, nested subagents, verification loops, and traces you can actually read. Local-first. Bring your own model.
5
+ > Start a coding run before dinner. Agent AFK works locally, texts you when it's done or stuck, and leaves behind a PR, trace, and Telegram thread showing exactly what happened.
6
6
 
7
7
  [![npm version](https://img.shields.io/npm/v/agent-afk.svg)](https://www.npmjs.com/package/agent-afk)
8
8
  [![Node](https://img.shields.io/node/v/agent-afk.svg)](https://nodejs.org/)
@@ -13,13 +13,7 @@
13
13
  npm install -g agent-afk
14
14
  ```
15
15
 
16
- Requires Node ≥ 20. Then point it at an API key:
17
-
18
- ```bash
19
- export ANTHROPIC_API_KEY=sk-ant-...
20
- # or, for Anthropic OAuth:
21
- afk login
22
- ```
16
+ Requires Node ≥ 20.
23
17
 
24
18
  Smoke test:
25
19
 
@@ -33,7 +27,9 @@ afk doctor # environment self-check
33
27
  - **Chat from your terminal** — `afk chat "..."` for one-shot, `afk i` for a REPL with full tool access (Bash, file ops, web fetch, grep/glob, subagents).
34
28
  - **Hand long work off to a daemon** — `afk daemon` runs headless. Pair it with `send_telegram` and you get pings on your phone when work lands in a terminal state.
35
29
  - **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.
36
- - **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. (Maintainer-loop skills like `/forge` and `/audit-fit` are hidden by default; set `AFK_INTERNAL=1` to surface them.)
30
+ - **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.
31
+
32
+ > **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.
37
33
  - **Cross-session memory** — Claude remembers preferences, decisions, and procedures across runs. Backed by SQLite at `~/.afk/agent-framework/memory/` plus a `HOT.md` that injects into every future session's system prompt.
38
34
  - **Background tasks** — Ctrl+B in the REPL detaches the current turn into a tracked task; `/tasks` lists them, `/attach <id>` re-attaches.
39
35
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: contract
3
- description: "Reference convention for sub-agent I/O schemas. Loaded by orchestrator skills via /contract and into agents (e.g., qualify) via the `skills:` field."
3
+ description: "Reference convention for sub-agent I/O schemas. Loaded by orchestrator skills via /contract and into agents via the `skills:` field."
4
4
  ---
5
5
 
6
6
  # Contract
@@ -10,7 +10,7 @@ Self-referential meta-capability questions about the current repository, framewo
10
10
 
11
11
  - "What does this repo enable?"
12
12
  - "What are the orchestration patterns available?"
13
- - "List the skills in private-framework."
13
+ - "List the available skills."
14
14
  - "What capabilities does the plugin provide?"
15
15
  - "Show me what the framework can do."
16
16
 
@@ -25,11 +25,11 @@ Skip: usage questions ("how do I use X?"), bug reports, feature requests, techni
25
25
  - Read at least one concrete source file per capability. Record the file path and specific line numbers.
26
26
  - Do not rely on training data, model recall, or session-listing attachments. Evidence must come from Read tool output.
27
27
 
28
- 3. **Build the answer inline.** As you write the response, embed citations **within claims**, not in a separate appendix. Format: `path/to/file.md:line—<claim context>`. Example: `agents/qualify.md:5—the qualify agent enforces a force-multiplier rubric`.
28
+ 3. **Build the answer inline.** As you write the response, embed citations **within claims**, not in a separate appendix. Format: `path/to/file.md:line—<claim context>`. Example: `skills/mint/SKILL.md:5—the mint skill orchestrates end-to-end feature delivery`.
29
29
 
30
30
  4. **Tag ungrounded claims.** If a capability claim cannot be traced to a file read, prefix it with `[UNVERIFIED: what would be needed to verify this]`. Never present an unverified claim without the tag.
31
31
 
32
- 5. **Declare sources read.** Explicitly name which files you read in the response (e.g., "Read: `skills/mint/SKILL.md`, `agents/qualify.md`, `hooks/hooks.json`").
32
+ 5. **Declare sources read.** Explicitly name which files you read in the response (e.g., "Read: `skills/mint/SKILL.md`, `hooks/hooks.json`").
33
33
 
34
34
  ## Hard rules
35
35