@pmndre/pine 0.22.0 → 0.33.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.
- package/README.md +2 -1
- package/changes.json +265 -0
- package/docs/SKILL.md +31 -7
- package/docs/references/agents.md +245 -21
- package/docs/references/coding.md +1 -1
- package/docs/references/computer.md +1 -1
- package/docs/references/configuration.md +14 -5
- package/docs/references/mcp.md +9 -0
- package/docs/references/operations.md +20 -9
- package/docs/references/overview.md +3 -1
- package/docs/references/security.md +83 -24
- package/docs/references/setup.md +55 -9
- package/docs/references/source-types.md +1418 -0
- package/docs/references/sources.md +333 -19
- package/docs/references/stack.md +1 -0
- package/docs/references/tui.md +86 -12
- package/examples/home/AGENTS.md +4 -0
- package/examples/home/TOOLS.md +5 -0
- package/examples/home/agents/main/workspace/AGENTS.md +1 -1
- package/examples/home/agents/main/workspace/TOOLS.md +5 -0
- package/mcp/browser.d.ts +6 -0
- package/mcp/browser.js +19 -0
- package/mcp/render.d.ts +1 -0
- package/mcp/render.js +237 -0
- package/package.json +3 -1
- package/src/actions.d.ts +6 -1
- package/src/actions.js +17 -4
- package/src/admin.d.ts +4 -0
- package/src/admin.js +25 -6
- package/src/agents.d.ts +167 -2
- package/src/agents.js +912 -45
- package/src/catalogue.d.ts +60 -0
- package/src/catalogue.js +791 -0
- package/src/cli.js +10 -7
- package/src/config.d.ts +53 -4
- package/src/config.js +30 -5
- package/src/goals.d.ts +1 -1
- package/src/goals.js +14 -1
- package/src/manual.js +24 -2
- package/src/mime.d.ts +78 -0
- package/src/mime.js +342 -0
- package/src/net.d.ts +11 -0
- package/src/net.js +29 -2
- package/src/pine.js +10 -1
- package/src/router.js +3 -3
- package/src/sandbox-linux.d.ts +3 -1
- package/src/sandbox-linux.js +5 -0
- package/src/security.d.ts +22 -6
- package/src/security.js +44 -13
- package/src/slots.d.ts +106 -0
- package/src/slots.js +250 -0
- package/src/source-types.d.ts +20 -0
- package/src/sources/calendar.d.ts +24 -0
- package/src/sources/calendar.js +265 -0
- package/src/sources/command.js +109 -4
- package/src/sources/discord.d.ts +4 -0
- package/src/sources/discord.js +298 -0
- package/src/sources/feed.d.ts +19 -0
- package/src/sources/feed.js +257 -0
- package/src/sources/http.js +154 -103
- package/src/sources/mail.d.ts +51 -0
- package/src/sources/mail.js +1013 -0
- package/src/sources/matrix.d.ts +4 -0
- package/src/sources/matrix.js +232 -0
- package/src/sources/modbus.d.ts +15 -0
- package/src/sources/modbus.js +240 -0
- package/src/sources/onvif.d.ts +35 -0
- package/src/sources/onvif.js +326 -0
- package/src/sources/presence.d.ts +80 -0
- package/src/sources/presence.js +480 -0
- package/src/sources/serial.d.ts +21 -0
- package/src/sources/serial.js +220 -0
- package/src/sources/slack.d.ts +16 -0
- package/src/sources/slack.js +1062 -0
- package/src/sources/smtp.d.ts +4 -0
- package/src/sources/smtp.js +360 -0
- package/src/sources/stream.d.ts +68 -0
- package/src/sources/stream.js +534 -0
- package/src/sources/syslog.d.ts +32 -0
- package/src/sources/syslog.js +243 -0
- package/src/sources/system.d.ts +14 -0
- package/src/sources/system.js +236 -0
- package/src/sources/system.swift +102 -0
- package/src/sources/telegram.js +34 -1
- package/src/sources.d.ts +41 -1
- package/src/sources.js +147 -24
- package/src/tools.d.ts +1 -1
- package/src/tools.js +304 -23
- package/src/tui/app.d.ts +35 -2
- package/src/tui/app.js +306 -43
- package/src/tui/levels.d.ts +68 -0
- package/src/tui/levels.js +273 -0
- package/src/tui/picture.d.ts +17 -1
- package/src/tui/picture.js +72 -5
- package/src/types.d.ts +3 -0
- package/src/update.d.ts +9 -1
- package/src/update.js +75 -3
- package/src/watching.d.ts +156 -0
- package/src/watching.js +609 -4
package/README.md
CHANGED
|
@@ -218,9 +218,10 @@ Start at [docs/SKILL.md](docs/SKILL.md); it indexes everything.
|
|
|
218
218
|
| Install, run, use the CLI, run it as a service | [operations.md](docs/references/operations.md) |
|
|
219
219
|
| Write `pine.json` and `agent.json` | [configuration.md](docs/references/configuration.md) |
|
|
220
220
|
| Let agents set things up by tool call instead of editing files | [setup.md](docs/references/setup.md) |
|
|
221
|
-
| Set up agents, delegation and sub-agents
|
|
221
|
+
| Set up agents, delegation and sub-agents; how tools are declared and what stays cached | [agents.md](docs/references/agents.md) |
|
|
222
222
|
| Route events, schedules, model calls | [events.md](docs/references/events.md) |
|
|
223
223
|
| Event sources: Telegram, folders, MQTT, web addresses, commands, webhooks, FTP | [sources.md](docs/references/sources.md) |
|
|
224
|
+
| Every source type and what it reaches: feeds, mail, Slack, streams, cameras, meters | [source-types.md](docs/references/source-types.md) |
|
|
224
225
|
| MCP servers, web search, command tools | [mcp.md](docs/references/mcp.md) |
|
|
225
226
|
| Let an agent operate the apps on your Mac | [computer.md](docs/references/computer.md) |
|
|
226
227
|
| Know what is protected and what is not | [security.md](docs/references/security.md) |
|
package/changes.json
ADDED
|
@@ -0,0 +1,265 @@
|
|
|
1
|
+
[
|
|
2
|
+
{
|
|
3
|
+
"version": "0.32.0",
|
|
4
|
+
"changes": [
|
|
5
|
+
"feat: agents can watch feeds, calendars, mailboxes, Slack, Matrix, Discord, pushed streams, cameras, meters and the computer itself",
|
|
6
|
+
"fix: a page in pine's browser can no longer send anything past the guard, by WebRTC or QUIC"
|
|
7
|
+
]
|
|
8
|
+
},
|
|
9
|
+
{
|
|
10
|
+
"version": "0.31.3",
|
|
11
|
+
"changes": [
|
|
12
|
+
"fix: an agent at work is reminded of its list of steps, so that it does not stay at \"0 of 6\""
|
|
13
|
+
]
|
|
14
|
+
},
|
|
15
|
+
{
|
|
16
|
+
"version": "0.31.2",
|
|
17
|
+
"changes": [
|
|
18
|
+
"fix: pine update lists what changed by version, where it is not read over"
|
|
19
|
+
]
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"version": "0.31.1",
|
|
23
|
+
"changes": [
|
|
24
|
+
"fix: a sound or a picture that an agent downloaded is played or shown, not put into the answer as a link"
|
|
25
|
+
]
|
|
26
|
+
},
|
|
27
|
+
{
|
|
28
|
+
"version": "0.31.0",
|
|
29
|
+
"changes": [
|
|
30
|
+
"feat: every agent has a TOOLS.md of its own, on top of the one for all agents"
|
|
31
|
+
]
|
|
32
|
+
},
|
|
33
|
+
{
|
|
34
|
+
"version": "0.30.0",
|
|
35
|
+
"changes": [
|
|
36
|
+
"feat: pine update says what changed between the version you had and the one you have now"
|
|
37
|
+
]
|
|
38
|
+
},
|
|
39
|
+
{
|
|
40
|
+
"version": "0.29.1",
|
|
41
|
+
"changes": [
|
|
42
|
+
"fix: a default for a tool, told to the main agent in passing, goes into the TOOLS.md for all agents"
|
|
43
|
+
]
|
|
44
|
+
},
|
|
45
|
+
{
|
|
46
|
+
"version": "0.29.0",
|
|
47
|
+
"changes": [
|
|
48
|
+
"feat: the main agent keeps rules and tool preferences for all agents"
|
|
49
|
+
]
|
|
50
|
+
},
|
|
51
|
+
{
|
|
52
|
+
"version": "0.28.0",
|
|
53
|
+
"changes": [
|
|
54
|
+
"feat: a sound in the conversation shows its levels as bars while it plays"
|
|
55
|
+
]
|
|
56
|
+
},
|
|
57
|
+
{
|
|
58
|
+
"version": "0.27.0",
|
|
59
|
+
"changes": [
|
|
60
|
+
"feat: an agent can be woken in a fresh conversation for every event",
|
|
61
|
+
"feat: an agent tells its owner without a question after outside content, and sends a picture or a video along"
|
|
62
|
+
]
|
|
63
|
+
},
|
|
64
|
+
{
|
|
65
|
+
"version": "0.26.0",
|
|
66
|
+
"changes": [
|
|
67
|
+
"feat: a sub-agent runs on the model and at the reasoning level its conversation gives it, and never waits for the owner",
|
|
68
|
+
"fix: the tab of an agent's main conversation has the star of a conversation that is kept"
|
|
69
|
+
]
|
|
70
|
+
},
|
|
71
|
+
{
|
|
72
|
+
"version": "0.25.1",
|
|
73
|
+
"changes": [
|
|
74
|
+
"fix: an agent reads the files its event sources received"
|
|
75
|
+
]
|
|
76
|
+
},
|
|
77
|
+
{
|
|
78
|
+
"version": "0.25.0",
|
|
79
|
+
"changes": [
|
|
80
|
+
"feat: the main agent lists, reads, pins, renames, opens, closes and removes conversations"
|
|
81
|
+
]
|
|
82
|
+
},
|
|
83
|
+
{
|
|
84
|
+
"version": "0.24.0",
|
|
85
|
+
"changes": [
|
|
86
|
+
"fix: a conversation's first request after a cold start is not taken for another client's",
|
|
87
|
+
"feat: a conversation of another client of the model server is seen, and its slot is not taken for empty",
|
|
88
|
+
"fix: a source that is set up without a name has one from its folder or address"
|
|
89
|
+
]
|
|
90
|
+
},
|
|
91
|
+
{
|
|
92
|
+
"version": "0.23.1",
|
|
93
|
+
"changes": [
|
|
94
|
+
"fix: requests that are open side by side each get their dialog, one after the other"
|
|
95
|
+
]
|
|
96
|
+
},
|
|
97
|
+
{
|
|
98
|
+
"version": "0.23.0",
|
|
99
|
+
"changes": [
|
|
100
|
+
"fix: a click into the input leaves it the place where keys go",
|
|
101
|
+
"chore: the reel has a second film, about an agent for its owner's bills",
|
|
102
|
+
"feat: a memory that was rewritten is told in the note, and the conversation is not read again for it",
|
|
103
|
+
"feat: one tool for all lists, conversations beyond the model server's slots are read back from files, and the judge of a goal has a slot of its own",
|
|
104
|
+
"feat: tools are declared in families, and a conversation keeps what the model server has read",
|
|
105
|
+
"test: the first live test runs on a model server of one's own too",
|
|
106
|
+
"fix: the browser and web tools reach public addresses in 192.0.x.x",
|
|
107
|
+
"feat: what an agent does in a turn folds into one line in the conversation, and a click opens it"
|
|
108
|
+
]
|
|
109
|
+
},
|
|
110
|
+
{
|
|
111
|
+
"version": "0.22.2",
|
|
112
|
+
"changes": [
|
|
113
|
+
"chore: the package is @pmndrs/pine on npm again"
|
|
114
|
+
]
|
|
115
|
+
},
|
|
116
|
+
{
|
|
117
|
+
"version": "0.22.1",
|
|
118
|
+
"changes": [
|
|
119
|
+
"chore: the first release through the trusted publisher of @pmndre/pine",
|
|
120
|
+
"chore: @pmndrs/pine forwards to @pmndre/pine [skip release]"
|
|
121
|
+
]
|
|
122
|
+
},
|
|
123
|
+
{
|
|
124
|
+
"version": "0.22.0",
|
|
125
|
+
"changes": [
|
|
126
|
+
"chore: the package is @pmndre/pine on npm [skip release]"
|
|
127
|
+
]
|
|
128
|
+
},
|
|
129
|
+
{
|
|
130
|
+
"version": "0.21.0",
|
|
131
|
+
"changes": [
|
|
132
|
+
"fix: dictating never holds the input, and a question the daemon no longer has is dropped",
|
|
133
|
+
"feat: the agent's steps stay in view in the code pane, and the status line says when a command still runs"
|
|
134
|
+
]
|
|
135
|
+
},
|
|
136
|
+
{
|
|
137
|
+
"version": "0.20.1",
|
|
138
|
+
"changes": [
|
|
139
|
+
"fix: tools given to an agent reach its conversations that are already there, and a mode that was picked is kept"
|
|
140
|
+
]
|
|
141
|
+
},
|
|
142
|
+
{
|
|
143
|
+
"version": "0.20.0",
|
|
144
|
+
"changes": [
|
|
145
|
+
"feat: the main agent reads and replaces another agent's SOUL.md with its own tools"
|
|
146
|
+
]
|
|
147
|
+
},
|
|
148
|
+
{
|
|
149
|
+
"version": "0.19.0",
|
|
150
|
+
"changes": [
|
|
151
|
+
"feat: a message can be dictated: voice input in the terminal UI, recognised on the Mac"
|
|
152
|
+
]
|
|
153
|
+
},
|
|
154
|
+
{
|
|
155
|
+
"version": "0.18.0",
|
|
156
|
+
"changes": [
|
|
157
|
+
"feat: the tab of a pinned conversation has the mark it has in the list of conversations"
|
|
158
|
+
]
|
|
159
|
+
},
|
|
160
|
+
{
|
|
161
|
+
"version": "0.17.1",
|
|
162
|
+
"changes": [
|
|
163
|
+
"fix: a question that waits in another tab is said in every tab, and a click beside it does not close it"
|
|
164
|
+
]
|
|
165
|
+
},
|
|
166
|
+
{
|
|
167
|
+
"version": "0.17.0",
|
|
168
|
+
"changes": [
|
|
169
|
+
"feat!: no reviewer: in auto and safe mode a critical action asks the owner, and after outside content what is sent out"
|
|
170
|
+
]
|
|
171
|
+
},
|
|
172
|
+
{
|
|
173
|
+
"version": "0.16.0",
|
|
174
|
+
"changes": [
|
|
175
|
+
"feat: how fast the model read and wrote is shown: prompt processing and tokens a second"
|
|
176
|
+
]
|
|
177
|
+
},
|
|
178
|
+
{
|
|
179
|
+
"version": "0.15.0",
|
|
180
|
+
"changes": [
|
|
181
|
+
"feat!: the mode says whether an agent works in a sandbox: auto and bypass without one, safe and manual in one",
|
|
182
|
+
"chore: the reel's code is in the repository [skip release]"
|
|
183
|
+
]
|
|
184
|
+
},
|
|
185
|
+
{
|
|
186
|
+
"version": "0.14.0",
|
|
187
|
+
"changes": [
|
|
188
|
+
"test: a manual question finds the pine agent update docs",
|
|
189
|
+
"docs: tidy goal-verdict casing and the routes manual entry",
|
|
190
|
+
"feat: pine agent update changes an agent from the command line"
|
|
191
|
+
]
|
|
192
|
+
},
|
|
193
|
+
{
|
|
194
|
+
"version": "0.13.1",
|
|
195
|
+
"changes": [
|
|
196
|
+
"fix: pine update installs the version it found, and says so when the old one is still there"
|
|
197
|
+
]
|
|
198
|
+
},
|
|
199
|
+
{
|
|
200
|
+
"version": "0.13.0",
|
|
201
|
+
"changes": [
|
|
202
|
+
"feat: the main agent administers pine: agents, settings, routes, and what any agent has",
|
|
203
|
+
"feat: pine asks the owner itself when a call needs something outside the sandbox"
|
|
204
|
+
]
|
|
205
|
+
},
|
|
206
|
+
{
|
|
207
|
+
"version": "0.12.1",
|
|
208
|
+
"changes": [
|
|
209
|
+
"fix: an agent leaves playing a sound to pine"
|
|
210
|
+
]
|
|
211
|
+
},
|
|
212
|
+
{
|
|
213
|
+
"version": "0.12.0",
|
|
214
|
+
"changes": [
|
|
215
|
+
"feat: sound is played in the conversation, with play and pause"
|
|
216
|
+
]
|
|
217
|
+
},
|
|
218
|
+
{
|
|
219
|
+
"version": "0.11.1",
|
|
220
|
+
"changes": [
|
|
221
|
+
"fix: a picture a server made is shown once, and its file is fetched by link with the server's key"
|
|
222
|
+
]
|
|
223
|
+
},
|
|
224
|
+
{
|
|
225
|
+
"version": "0.11.0",
|
|
226
|
+
"changes": [
|
|
227
|
+
"feat: an agent lists its MCP servers and skills by tool, and a conversation's server can become the agent's",
|
|
228
|
+
"fix: the browser answers again after its owner opened a tab"
|
|
229
|
+
]
|
|
230
|
+
},
|
|
231
|
+
{
|
|
232
|
+
"version": "0.10.0",
|
|
233
|
+
"changes": [
|
|
234
|
+
"fix: an agent knows which model it runs on",
|
|
235
|
+
"fix: a picture of an app holds its open menu, and positions in it land where it shows",
|
|
236
|
+
"feat: steering, undo, plan mode, goals, background commands, questions and a list of steps",
|
|
237
|
+
"feat: an agent operates the apps on a Mac, by outline or by picture, and asks once per app"
|
|
238
|
+
]
|
|
239
|
+
},
|
|
240
|
+
{
|
|
241
|
+
"version": "0.9.1",
|
|
242
|
+
"changes": [
|
|
243
|
+
"fix: an agent does not act on a browser page its owner opened unseen, and esc spares the message typed meanwhile"
|
|
244
|
+
]
|
|
245
|
+
},
|
|
246
|
+
{
|
|
247
|
+
"version": "0.9.0",
|
|
248
|
+
"changes": [
|
|
249
|
+
"feat: pine init sets up Linux itself, and the README says how to run pine in Docker"
|
|
250
|
+
]
|
|
251
|
+
},
|
|
252
|
+
{
|
|
253
|
+
"version": "0.8.0",
|
|
254
|
+
"changes": [
|
|
255
|
+
"feat: an agent shows its browser on request, and screenshots come back clean"
|
|
256
|
+
]
|
|
257
|
+
},
|
|
258
|
+
{
|
|
259
|
+
"version": "0.7.0",
|
|
260
|
+
"changes": [
|
|
261
|
+
"feat: the terminal UI shows what a model thinks",
|
|
262
|
+
"Update README.md"
|
|
263
|
+
]
|
|
264
|
+
}
|
|
265
|
+
]
|
package/docs/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: pine
|
|
3
|
-
description: Run, configure and extend pine, the event-driven multi-agent daemon built on the pi coding agent SDK. Use when setting up agents and their workspaces, subscribing agents to event sources (Telegram, folders, MQTT, webhooks, FTP uploads, web addresses, commands), scheduling what happens at a time, adding MCP servers and skills, routing events to agents, reaching agents on Telegram, delegating between agents, reviewing what is protected against prompt injection, or changing pine's code.
|
|
3
|
+
description: Run, configure and extend pine, the event-driven multi-agent daemon built on the pi coding agent SDK. Use when setting up agents and their workspaces, subscribing agents to event sources (Telegram, folders, MQTT, webhooks, FTP uploads, web addresses, commands, feeds, calendars, mail, Slack, Matrix, Discord, pushed streams, syslog, cameras, Modbus devices, serial ports, the computer itself), scheduling what happens at a time, adding MCP servers and skills, routing events to agents, reaching agents on Telegram, delegating between agents, reviewing what is protected against prompt injection, or changing pine's code.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# pine
|
|
@@ -16,8 +16,10 @@ Three things to know before anything else:
|
|
|
16
16
|
`models.json` (pi's model file), `.env` (secrets), and one folder per agent under `agents/`.
|
|
17
17
|
2. **An agent is a folder**: `agents/<id>/agent.json` and a workspace. In the workspace lie the
|
|
18
18
|
files the agent keeps itself and that are read into its prompt: `AGENTS.md` (its purpose),
|
|
19
|
-
`SOUL.md` (who it is), `
|
|
20
|
-
|
|
19
|
+
`SOUL.md` (who it is), `TOOLS.md` (how it uses its tools), `MEMORY.md` (its memory). Three
|
|
20
|
+
files in the home are for all agents and kept by the main agent: `AGENTS.md` (traits and
|
|
21
|
+
behaviour), `TOOLS.md` (tooling defaults and preferences) and `USER.md` (what agents know
|
|
22
|
+
about you); an agent's own `AGENTS.md` and `TOOLS.md` say what is different for it. The workspace is wherever `workspace` points, for example a repository.
|
|
21
23
|
3. **Where content came from decides what it may do.** Your own messages get the agent's full
|
|
22
24
|
tool set. Anything else is data. An event from outside runs with a reduced tool set in a
|
|
23
25
|
separate session; an event from a source a conversation subscribed to arrives in that
|
|
@@ -30,14 +32,21 @@ You search this manual with your `manual` tool: a search names the parts that fi
|
|
|
30
32
|
line that matched, and you then read the one or two parts you need. Search before you answer a
|
|
31
33
|
question about pine or say that something is not possible.
|
|
32
34
|
|
|
35
|
+
A tool that this manual names and that is not among your tools by that name is an action of
|
|
36
|
+
one of them: `add_source` is your tool `pine_sources` with `action: "add_source"`, a list
|
|
37
|
+
such as `sources` or `schedules` is `pine_list` with `what: ["sources"]`, and
|
|
38
|
+
`mcp__browser__browser_navigate` is `browser` with `action: "browser_navigate"`
|
|
39
|
+
([references/agents.md](references/agents.md), "How tools are declared").
|
|
40
|
+
|
|
33
41
|
pine's configuration lives in its home folder (`~/.pine` unless your owner chose another),
|
|
34
42
|
which is closed to you on purpose: you never write those files. Four things you set up by
|
|
35
43
|
calling a tool, for the conversation you are in or for yourself as an agent
|
|
36
44
|
([references/setup.md](references/setup.md)): event sources and subscriptions, schedules,
|
|
37
45
|
MCP servers, and skills. The main agent administers pine, and the rest is its job, also by
|
|
38
46
|
tool call ([references/setup.md](references/setup.md), "The main agent administers pine"):
|
|
39
|
-
creating, changing and deleting one of the others with its folder, pine's settings, routes,
|
|
40
|
-
|
|
47
|
+
creating, changing and deleting one of the others with its folder, pine's settings, routes,
|
|
48
|
+
the conversations there are (listing them, reading one, pinning, renaming, opening and closing
|
|
49
|
+
its tab, removing it), and anything that is for everyone or for somebody else. If that is you, use those tools and never
|
|
41
50
|
send your owner to the files; if not, send your owner to it.
|
|
42
51
|
For what has no tool (the control API, a secret):
|
|
43
52
|
|
|
@@ -48,6 +57,20 @@ For what has no tool (the control API, a secret):
|
|
|
48
57
|
3. Do not try to edit those files or work around the restriction. Say plainly that this is a
|
|
49
58
|
step for them.
|
|
50
59
|
|
|
60
|
+
What you keep yourself are four files at the top of your workspace, which are part of your
|
|
61
|
+
instructions: `AGENTS.md` (your purpose and how you work), `SOUL.md` (who you are), `TOOLS.md`
|
|
62
|
+
(your own defaults and preferences for your tools) and `MEMORY.md` (what should outlive a
|
|
63
|
+
conversation). Three more files hold for every agent and lie in pine's home, where only the
|
|
64
|
+
main agent writes: `AGENTS.md` (traits and behaviour for all agents), `TOOLS.md` (tooling
|
|
65
|
+
defaults and preferences for all agents) and `USER.md` (what is known about your owner). You
|
|
66
|
+
read both an `AGENTS.md` and a `TOOLS.md` of each kind; yours say what is different or more for
|
|
67
|
+
you. If you are the main agent: a default or a preference for a tool that your owner tells you
|
|
68
|
+
is for all agents unless they say otherwise, and goes into the `TOOLS.md` in pine's home;
|
|
69
|
+
"for you alone" goes into your own, and for another agent alone you use `update_agent` with
|
|
70
|
+
`tooling`. If you are not: write it into your own file, and when your owner means all agents,
|
|
71
|
+
tell them to ask the main agent. Every file that is read as instructions is listed in
|
|
72
|
+
[references/agents.md](references/agents.md), "Every file that is read as instructions".
|
|
73
|
+
|
|
51
74
|
One thing you can start yourself: when your owner asks you to install or connect an MCP
|
|
52
75
|
server, call `add_mcp_server` with a short name and either its https URL (a remote server) or,
|
|
53
76
|
for a local server, the line that starts it (`command`, for example
|
|
@@ -146,9 +169,10 @@ hand work to the agents listed in your prompt, and write shared state under your
|
|
|
146
169
|
| Work on a project: `pine .`, a folder for a conversation, the code pane with git changes, files and tool output, what an agent left running, what it runs in the background, and taking a message back with `/undo` and `/redo` | [references/coding.md](references/coding.md) |
|
|
147
170
|
| Install it, start it, update it, use the CLI (every `pine` command), the control API for scripts, run it at login or in a container, find out why something did not happen | [references/operations.md](references/operations.md) |
|
|
148
171
|
| Look up a key in `pine.json`, `agent.json`, `models.json` or `.env` | [references/configuration.md](references/configuration.md) |
|
|
149
|
-
| Know what agents can set up by tool call, for whom, and what you are asked: event sources, MCP servers, skills, schedules, new agents, new source types, model servers; how an agent lists what it has; the table of pine's own tools (`question`, `todo`, `stop_program` and the rest) | [references/setup.md](references/setup.md) |
|
|
150
|
-
| Add an agent, give it a workspace, tools and a persona; skills; how agents look pine up (the `manual` tool); delegation, sub-agents, sessions, goal mode (`/goal`: working until an objective is met), shared state | [references/agents.md](references/agents.md) |
|
|
172
|
+
| Know what agents can set up by tool call, for whom, and what you are asked: event sources, MCP servers, skills, schedules, new agents, new source types, model servers; the main agent's tools for conversations and tabs; how an agent lists what it has; the table of pine's own tools (`question`, `todo`, `stop_program` and the rest) | [references/setup.md](references/setup.md) |
|
|
173
|
+
| Add an agent, give it a workspace, tools and a persona; skills; how agents look pine up (the `manual` tool); how tools are declared to the model (`catalogue`: families) and what a model server keeps of a conversation (prompt cache, slots); delegation, sub-agents, sessions, goal mode (`/goal`: working until an objective is met), shared state | [references/agents.md](references/agents.md) |
|
|
151
174
|
| Let an agent react to the outside world and reach out: Telegram, a watched folder, MQTT devices, a web address or a command that is looked at again and again, webhooks, FTP uploads from cameras; subscribing, unsubscribing, sending; a source type of your own | [references/sources.md](references/sources.md) |
|
|
175
|
+
| Pick the source type for a service or a device, with its options, its events and an entry to copy: feeds, calendars, services that push (SSE, WebSocket), mail, Slack, Matrix, Discord, devices that mail or log (SMTP, syslog), cameras (ONVIF), inverters and meters (Modbus), serial ports, who is on the network, this computer (sleep, lock, power), a command that is followed; filtering events with `when` | [references/source-types.md](references/source-types.md) |
|
|
152
176
|
| Have something done at a time (schedules); write rules for events yourself: set state, publish, single model calls, debounce | [references/events.md](references/events.md) |
|
|
153
177
|
| Add MCP servers globally, per agent or for one conversation; web search, page reading and the bundled browser (showing its window to log in yourself, local addresses); turn shell commands into tools | [references/mcp.md](references/mcp.md) |
|
|
154
178
|
| Operate the apps on a Mac: read a window, press, click, type; who may, what is asked, the grants macOS needs | [references/computer.md](references/computer.md) |
|