@adaptiqai/pi 0.0.0-stage → 0.1.0

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.
Files changed (3) hide show
  1. package/README.md +62 -2
  2. package/lib/index.js +5167 -0
  3. package/package.json +44 -3
package/README.md CHANGED
@@ -1,3 +1,63 @@
1
- # Temporary Holding Version
1
+ # AdaptiqAI for Pi
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Your AdaptiqAI workspace in [Pi](https://pi.dev): its models, conversations
4
+ that AdaptiqAI remembers, and your saved knowledge, in one Pi package.
5
+
6
+ ## Install
7
+
8
+ ```bash
9
+ pi install npm:@adaptiqai/pi
10
+ ```
11
+
12
+ Then sign in: run `/login adaptiqai` in Pi. Your browser opens; you sign in
13
+ (or create an account) and approve, and Pi picks it up by itself. Without a
14
+ browser, give a key from the AdaptiqAI console instead, either as
15
+ `ADAPTIQAI_API_KEY` or as Pi's own key for the `adaptiqai` provider in
16
+ `~/.pi/agent/auth.json`.
17
+
18
+ Choose a model from the **AdaptiqAI** provider (`/model`, or
19
+ `pi --provider adaptiqai --model <id>`). The list is the models in your
20
+ workspace, each with its own context window, output limit and
21
+ thinking levels.
22
+
23
+ ## What it does
24
+
25
+ - **A conversation is one AdaptiqAI session.** Every turn carries Pi's
26
+ session id as `x-adaptiq-session-id`, so AdaptiqAI keeps the conversation's
27
+ memory, and the collections and conversations you attach to it in the
28
+ console reach the model.
29
+ - **Helper calls leave nothing.** Compaction and branch summaries run once,
30
+ marked ephemeral, and never become a conversation. On Pi 1.4 the
31
+ cache-warming replays are switched off: AdaptiqAI keeps the conversation
32
+ itself.
33
+ - **A Pi started by another Pi** (an agent your extension spawns) names the
34
+ first as its parent, so the console folds it under that conversation.
35
+ - **Tools for the agent:** `adaptiq_knowledge` (what this conversation uses;
36
+ search, use or stop a collection), `adaptiq_memory` (how full the memory is;
37
+ the saved collections; keep a conversation private) and
38
+ `adaptiq_create_knowledge` (save material as a collection, only when you ask).
39
+ - **`/adaptiq`** shows the workspace, its models and this conversation.
40
+ `/adaptiq private` stops saving new messages of this conversation,
41
+ `/adaptiq remember` starts again, `/adaptiq console` opens the console on
42
+ it, and `/adaptiq logout` signs this computer out.
43
+
44
+ ## Configuration
45
+
46
+ | Variable | Default |
47
+ |---|---|
48
+ | `ADAPTIQAI_API_KEY` | none: the browser sign-in |
49
+ | `ADAPTIQAI_API_BASE` | `https://api.adaptiqai.com` |
50
+ | `ADAPTIQAI_CONSOLE_URL` | `https://memory.adaptiqai.com/memory` |
51
+
52
+ The sign-in, the plugin's state and the last model list are kept in
53
+ `~/.pi/agent/adaptiqai/` (or under `PI_CODING_AGENT_DIR`), readable by you
54
+ alone.
55
+
56
+ ## Development
57
+
58
+ ```bash
59
+ pnpm install
60
+ pnpm --filter @adaptiqai/pi run build
61
+ pnpm --filter @adaptiqai/pi run test
62
+ pi install ./packages/pi # try it in your own Pi
63
+ ```