@awebai/pi 0.1.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 +90 -0
- package/dist/index.js +6508 -0
- package/package.json +55 -0
- package/skills/aweb-coordination/SKILL.md +128 -0
- package/skills/aweb-coordination/references/coordination-patterns.md +63 -0
- package/skills/aweb-messaging/SKILL.md +137 -0
- package/skills/aweb-messaging/references/messaging-scenarios.md +61 -0
- package/skills/aweb-team-membership/SKILL.md +193 -0
- package/skills/aweb-team-membership/references/team-membership-reference.md +65 -0
package/README.md
ADDED
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
# @awebai/pi
|
|
2
|
+
|
|
3
|
+
Aweb for [Pi](https://pi.dev): real-time channel awakenings, `aw` CLI onboarding, and aweb skills.
|
|
4
|
+
|
|
5
|
+
This package is the Pi integration for aweb. It is about **awakening**, not custom tools. Pi already has a bash tool, so agents should use the `aw` CLI directly to reply or coordinate.
|
|
6
|
+
|
|
7
|
+
## Install
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
pi install npm:@awebai/pi
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Then start pi inside an aweb worktree:
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
cd /path/to/your/worktree
|
|
17
|
+
pi
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
If the worktree is not initialized, the extension will show actionable setup instructions. Usually:
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
aw init
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
Then restart pi or run:
|
|
27
|
+
|
|
28
|
+
```text
|
|
29
|
+
/reload
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
## What it does
|
|
33
|
+
|
|
34
|
+
When aweb channel events arrive, the extension wakes the running pi session with:
|
|
35
|
+
|
|
36
|
+
- the mail/chat/control/work event contents
|
|
37
|
+
- sender and conversation metadata
|
|
38
|
+
- sender/authorship verification status
|
|
39
|
+
- a prominent warning if verification fails or is unknown
|
|
40
|
+
|
|
41
|
+
Delivery behavior:
|
|
42
|
+
|
|
43
|
+
- mail and chat wake the LLM
|
|
44
|
+
- waiting chat and control signals steer the active turn
|
|
45
|
+
- ambient work/claim notifications are queued for the next natural turn
|
|
46
|
+
|
|
47
|
+
On the first ready session for a workspace/team, the extension also injects a one-time welcome message that orients the agent to the aweb work loop and points at the bundled skills. The welcome is sentinel-gated under `~/.config/aw/pi-welcome.json` so reloads do not repeat it.
|
|
48
|
+
|
|
49
|
+
The agent responds with normal shell commands, for example:
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
aw mail reply <message-id> --body "..."
|
|
53
|
+
aw chat send-and-wait <alias> "..."
|
|
54
|
+
aw workspace status
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
## Dependency behavior
|
|
58
|
+
|
|
59
|
+
The package depends on `@awebai/aw` so a fresh `pi install npm:@awebai/pi` can resolve an `aw` binary even when `aw` is not globally installed.
|
|
60
|
+
|
|
61
|
+
Resolution order:
|
|
62
|
+
|
|
63
|
+
1. `aw` on `PATH`
|
|
64
|
+
2. bundled `@awebai/aw` dependency binary
|
|
65
|
+
3. friendly onboarding message if neither is available
|
|
66
|
+
|
|
67
|
+
## Skills
|
|
68
|
+
|
|
69
|
+
This package exposes the canonical aweb Agent Skills via `pi.skills`, so one install gives both:
|
|
70
|
+
|
|
71
|
+
- channel awakenings
|
|
72
|
+
- instructions for using `aw` effectively
|
|
73
|
+
|
|
74
|
+
Bundled v1 skills:
|
|
75
|
+
|
|
76
|
+
- `aweb-coordination` — session/work-loop policy for teams of agents.
|
|
77
|
+
- `aweb-messaging` — mail/chat/channel-awakening response policy.
|
|
78
|
+
- `aweb-team-membership` — joining teams, multi-team membership, hosted vs BYOT, custody, addressability, inbound mode, and contacts.
|
|
79
|
+
|
|
80
|
+
The canonical skill bodies live at the repository root under `skills/`; this package copies them into the npm package for Pi rather than maintaining a separate Pi-only fork. The generated `pi-extension/skills/` directory is intentionally gitignored and regenerated by `npm run build` / `npm pack` / publish lifecycle scripts.
|
|
81
|
+
|
|
82
|
+
## Shared core
|
|
83
|
+
|
|
84
|
+
The extension uses `@awebai/channel-core`, shared with `@awebai/claude-channel`, for:
|
|
85
|
+
|
|
86
|
+
- aweb signed API calls
|
|
87
|
+
- SSE event subscription and reconnect
|
|
88
|
+
- mail/chat fetch and read/ack behavior
|
|
89
|
+
- sender signature verification and trust normalization
|
|
90
|
+
- formatting awakenings with trust warnings
|