@pmndre/pine 0.35.1 → 0.36.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 -2
- package/changes.json +12 -16
- package/docs/SKILL.md +4 -3
- package/docs/references/events.md +1 -1
- package/docs/references/operations.md +1 -1
- package/docs/references/setup.md +1 -1
- package/docs/references/source-types.md +553 -82
- package/docs/references/sources.md +75 -513
- package/package.json +1 -1
- package/src/cli.js +1 -1
- package/src/manual.d.ts +1 -1
- package/src/sources/slack.d.ts +9 -1
- package/src/sources/slack.js +297 -13
- package/src/tools.js +1 -1
- package/src/tui/app.js +1 -1
package/README.md
CHANGED
|
@@ -220,8 +220,8 @@ Start at [docs/SKILL.md](docs/SKILL.md); it indexes everything.
|
|
|
220
220
|
| Let agents set things up by tool call instead of editing files | [setup.md](docs/references/setup.md) |
|
|
221
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
|
-
| Event sources:
|
|
224
|
-
| Every source type
|
|
223
|
+
| Event sources: setting one up, subscribing, sending, secrets, trust | [sources.md](docs/references/sources.md) |
|
|
224
|
+
| Every source type: Telegram, folders, MQTT, web addresses, feeds, mail, Slack, cameras | [source-types.md](docs/references/source-types.md) |
|
|
225
225
|
| MCP servers, web search, command tools | [mcp.md](docs/references/mcp.md) |
|
|
226
226
|
| Let an agent operate the apps on your Mac | [computer.md](docs/references/computer.md) |
|
|
227
227
|
| Know what is protected and what is not | [security.md](docs/references/security.md) |
|
package/changes.json
CHANGED
|
@@ -1,4 +1,16 @@
|
|
|
1
1
|
[
|
|
2
|
+
{
|
|
3
|
+
"version": "0.36.0",
|
|
4
|
+
"changes": [
|
|
5
|
+
"feat: after a time without a connection, a Slack source asks for what was written meanwhile and says whether that is everything"
|
|
6
|
+
]
|
|
7
|
+
},
|
|
8
|
+
{
|
|
9
|
+
"version": "0.35.2",
|
|
10
|
+
"changes": [
|
|
11
|
+
"docs: sources.md says how sources work, source-types.md describes every type"
|
|
12
|
+
]
|
|
13
|
+
},
|
|
2
14
|
{
|
|
3
15
|
"version": "0.35.1",
|
|
4
16
|
"changes": [
|
|
@@ -245,21 +257,5 @@
|
|
|
245
257
|
"changes": [
|
|
246
258
|
"fix: a picture a server made is shown once, and its file is fetched by link with the server's key"
|
|
247
259
|
]
|
|
248
|
-
},
|
|
249
|
-
{
|
|
250
|
-
"version": "0.11.0",
|
|
251
|
-
"changes": [
|
|
252
|
-
"feat: an agent lists its MCP servers and skills by tool, and a conversation's server can become the agent's",
|
|
253
|
-
"fix: the browser answers again after its owner opened a tab"
|
|
254
|
-
]
|
|
255
|
-
},
|
|
256
|
-
{
|
|
257
|
-
"version": "0.10.0",
|
|
258
|
-
"changes": [
|
|
259
|
-
"fix: an agent knows which model it runs on",
|
|
260
|
-
"fix: a picture of an app holds its open menu, and positions in it land where it shows",
|
|
261
|
-
"feat: steering, undo, plan mode, goals, background commands, questions and a list of steps",
|
|
262
|
-
"feat: an agent operates the apps on a Mac, by outline or by picture, and asks once per app"
|
|
263
|
-
]
|
|
264
260
|
}
|
|
265
261
|
]
|
package/docs/SKILL.md
CHANGED
|
@@ -171,8 +171,8 @@ hand work to the agents listed in your prompt, and write shared state under your
|
|
|
171
171
|
| Look up a key in `pine.json`, `agent.json`, `models.json` or `.env` | [references/configuration.md](references/configuration.md) |
|
|
172
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
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) |
|
|
174
|
-
| Let an agent react to the outside world and reach out:
|
|
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)
|
|
174
|
+
| Let an agent react to the outside world and reach out: what a source and a subscription are, setting one up, who is woken (three scopes, a fresh conversation for every event), filtering events with `when`, sending and reading through a source, secrets, trust, files a source received; 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: a watched folder, MQTT devices, webhooks, FTP uploads from cameras, Telegram, a web address or a command that is looked at again and again or followed, 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) | [references/source-types.md](references/source-types.md) |
|
|
176
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) |
|
|
177
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) |
|
|
178
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) |
|
|
@@ -213,7 +213,8 @@ model" in [references/operations.md](references/operations.md).)
|
|
|
213
213
|
|
|
214
214
|
Telegram as a second way in is set up by asking the main agent: "watch Telegram". The dialog
|
|
215
215
|
you confirm has a field for the bot's token; then you write to the bot and type the six-digit
|
|
216
|
-
code it sends you into pine. See
|
|
216
|
+
code it sends you into pine. See "telegram" in
|
|
217
|
+
[references/source-types.md](references/source-types.md).
|
|
217
218
|
|
|
218
219
|
`~/.pine/agents/gonzo/agent.json`, a second agent, a specialist the main agent can hand work to.
|
|
219
220
|
Create the folder; the workspace here is `~/dev/gonzo`, which must exist, and an `AGENTS.md` in
|
|
@@ -253,7 +253,7 @@ To receive webhooks from outside your network, put a tunnel or reverse proxy in
|
|
|
253
253
|
forward only `/hook/`.
|
|
254
254
|
|
|
255
255
|
A hook here only publishes an event; a route decides what happens. For a webhook that wakes an
|
|
256
|
-
agent directly, use a source of type `webhook` ([
|
|
256
|
+
agent directly, use a source of type `webhook` ([source-types.md](source-types.md)): it answers under
|
|
257
257
|
`/hook/` too, while an agent is subscribed. A hook in `http.hooks` with the same name comes
|
|
258
258
|
first.
|
|
259
259
|
|
|
@@ -329,7 +329,7 @@ are JSON with `Content-Type: application/json`.
|
|
|
329
329
|
| `POST /tasks/<id>/cancel` | Cancel |
|
|
330
330
|
| `POST /approvals/<id>` `{ allow, always?, values? }` | Answer an approval. A request that lists `inputs` (a token, a password) is only allowed together with `values: { <name>: "..." }`; the terminal UI has a field for them. A question an agent asks with its `question` tool is such a request (`tool: "question"`, with the answers it offers in `choices`): answer it with `values: { "answer": "..." }`, or with `allow: false` for no answer |
|
|
331
331
|
| `POST /state` `{ key, value }` | Write state; `null` deletes |
|
|
332
|
-
| `POST /hook/<name>` | Webhook: a hook from `http.hooks` ([events.md](events.md)) or a running `webhook` source ([
|
|
332
|
+
| `POST /hook/<name>` | Webhook: a hook from `http.hooks` ([events.md](events.md)) or a running `webhook` source ([source-types.md](source-types.md)). No token; each has its own secret, unless a hook is declared `"open": true` |
|
|
333
333
|
|
|
334
334
|
## Day to day
|
|
335
335
|
|
package/docs/references/setup.md
CHANGED
|
@@ -128,7 +128,7 @@ Which model the agent runs on is told to it with your message, so it needs no to
|
|
|
128
128
|
|---|---|
|
|
129
129
|
| **Events** | |
|
|
130
130
|
| `sources` | Lists the event sources this conversation can use and who is subscribed. |
|
|
131
|
-
| `add_source` `name` `type` `description` [`options`] [`scope`] [`note`] [`throttle`] [`own`] [`ask`] | Sets up a source; with a note it subscribes at once. `options` is an object with the options of the chosen type ([
|
|
131
|
+
| `add_source` `name` `type` `description` [`options`] [`scope`] [`note`] [`throttle`] [`own`] [`ask`] | Sets up a source; with a note it subscribes at once. `options` is an object with the options of the chosen type ([source-types.md](source-types.md)). `own: true` marks it as your own device or folder, whose events are trusted. `ask` names secret options that you are to type into the dialog. |
|
|
132
132
|
| `subscribe` `source` [`scope`] [`note`] [`when`] [`throttle`] [`fresh`], `unsubscribe` `source` [`scope`] | Starts or ends being woken by a source. `fresh`: every event is handled in a conversation of its own, started empty, for a source that reports all day ([sources.md](sources.md), "A fresh conversation for every event"). For `unsubscribe` the scope can also be `all`: everything the agent has on that source. |
|
|
133
133
|
| `send` `source` [`text`] [`file`] [`data`] | Sends something out through a source that can send (Telegram, MQTT). `file`: a picture, video or sound file of the agent's workspace to go with a Telegram message. A message to you through Telegram is never held back for approval. |
|
|
134
134
|
| `read_source` `source` [`data`] | Looks something up through a source that can be asked: what was written earlier in a Slack channel, a direct conversation or a thread. `data` says what, as JSON (`{"channel": "C0123", "thread": "1712345678.000100"}`). It only reads, so it is not asked about; what it returns is outside content, and the conversation is marked as having read some. The `sources` tool says which sources can be read. |
|