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 +6 -10
- package/dist/bundled-plugins/awa-bundled/skills/contract/SKILL.md +1 -1
- package/dist/bundled-plugins/awa-bundled/skills/ground-claim/SKILL.md +3 -3
- package/dist/cli.mjs +373 -373
- package/dist/index.mjs +130 -127
- package/dist/telegram.mjs +141 -138
- package/package.json +1 -2
- package/dist/threads.mjs +0 -1366
package/README.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# Agent AFK
|
|
2
2
|
|
|
3
|
-
>
|
|
3
|
+
> Works while you're away.
|
|
4
4
|
>
|
|
5
|
-
>
|
|
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
|
[](https://www.npmjs.com/package/agent-afk)
|
|
8
8
|
[](https://nodejs.org/)
|
|
@@ -13,13 +13,7 @@
|
|
|
13
13
|
npm install -g agent-afk
|
|
14
14
|
```
|
|
15
15
|
|
|
16
|
-
Requires Node ≥ 20.
|
|
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.
|
|
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
|
|
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
|
|
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: `
|
|
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`, `
|
|
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
|
|