@timqi/pier 0.1.2 → 0.1.4
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 +8 -3
- package/dist/agent/config.js +63 -59
- package/dist/agent/events.js +1 -2
- package/dist/agent/listing.js +38 -15
- package/dist/agent/packages.js +347 -0
- package/dist/agent/pi.js +33 -59
- package/dist/channels/config.js +30 -20
- package/dist/channels/routes.js +0 -3
- package/dist/channels/slack-api.js +19 -10
- package/dist/channels/slack-cli.js +503 -0
- package/dist/channels/slack-directory.js +2 -2
- package/dist/channels/slack-outbound.js +1 -1
- package/dist/channels/slack-thread.js +41 -0
- package/dist/channels/slack-transcript.js +107 -0
- package/dist/channels/slack.js +9 -17
- package/dist/channels/types.js +0 -1
- package/dist/cli.js +158 -7
- package/dist/core/identity.js +20 -11
- package/dist/core/reply.js +16 -15
- package/dist/core/router.js +4 -1
- package/dist/core/types.js +7 -0
- package/dist/db.js +28 -0
- package/dist/extensions/index.js +1 -20
- package/dist/main.js +34 -42
- package/dist/paths.js +3 -0
- package/dist/secrets.js +2 -1
- package/dist/settings.js +5 -0
- package/dist/socket.js +95 -0
- package/dist/tasks/agent.js +5 -6
- package/dist/tasks/callbacks.js +2 -2
- package/dist/tasks/cli.js +215 -0
- package/dist/tasks/definitions.js +3 -3
- package/dist/tasks/execution.js +1 -3
- package/dist/tasks/groups.js +2 -5
- package/dist/tasks/messages.js +18 -158
- package/dist/tasks/operations.js +323 -0
- package/dist/tasks/routes.js +1 -11
- package/dist/tasks/runs.js +5 -20
- package/dist/tasks/service.js +18 -43
- package/dist/tasks/store.js +15 -15
- package/dist/tools.js +63 -85
- package/dist/vault.js +107 -0
- package/dist/web/auth.js +2 -1
- package/dist/web/config.js +25 -11
- package/dist/web/explorer.js +5 -3
- package/dist/web/instance.js +6 -18
- package/dist/web/packages.js +84 -0
- package/dist/web/public/assets/{activity-DOr8dWeX.js → activity-NLS8W9yl.js} +2 -2
- package/dist/web/public/assets/activity-NLS8W9yl.js.br +0 -0
- package/dist/web/public/assets/activity-NLS8W9yl.js.gz +0 -0
- package/dist/web/public/assets/boards-DleegoiC.js +1 -0
- package/dist/web/public/assets/boards-DleegoiC.js.br +0 -0
- package/dist/web/public/assets/boards-DleegoiC.js.gz +0 -0
- package/dist/web/public/assets/explorer-vJvV1Sx0.js +4 -0
- package/dist/web/public/assets/explorer-vJvV1Sx0.js.br +0 -0
- package/dist/web/public/assets/explorer-vJvV1Sx0.js.gz +0 -0
- package/dist/web/public/assets/index-Bs-gol9o.css +2 -0
- package/dist/web/public/assets/index-Bs-gol9o.css.br +0 -0
- package/dist/web/public/assets/index-Bs-gol9o.css.gz +0 -0
- package/dist/web/public/assets/index-Cyp2DKKF.js +85 -0
- package/dist/web/public/assets/index-Cyp2DKKF.js.br +0 -0
- package/dist/web/public/assets/index-Cyp2DKKF.js.gz +0 -0
- package/dist/web/public/assets/runs-C5FveZ75.js +1 -0
- package/dist/web/public/assets/runs-C5FveZ75.js.br +0 -0
- package/dist/web/public/assets/runs-C5FveZ75.js.gz +0 -0
- package/dist/web/public/assets/settings-nJHIBbAz.js +5 -0
- package/dist/web/public/assets/settings-nJHIBbAz.js.br +0 -0
- package/dist/web/public/assets/settings-nJHIBbAz.js.gz +0 -0
- package/dist/web/public/assets/task-runs-CJJ2j5Ks.js +3 -0
- package/dist/web/public/assets/task-runs-CJJ2j5Ks.js.br +0 -0
- package/dist/web/public/assets/task-runs-CJJ2j5Ks.js.gz +0 -0
- package/dist/web/public/assets/tasks-R2Pv0Abg.js +4 -0
- package/dist/web/public/assets/tasks-R2Pv0Abg.js.br +0 -0
- package/dist/web/public/assets/tasks-R2Pv0Abg.js.gz +0 -0
- package/dist/web/public/index.html +2 -2
- package/dist/web/public/index.html.br +0 -0
- package/dist/web/public/index.html.gz +0 -0
- package/dist/web/server.js +3 -1
- package/dist/web/vault.js +68 -0
- package/docs/deploy.md +42 -8
- package/package.json +1 -1
- package/skills/pier-help/SKILL.md +10 -6
- package/skills/pier-slack/SKILL.md +52 -71
- package/skills/pier-tasks/SKILL.md +48 -145
- package/skills/pier-vault/SKILL.md +36 -0
- package/dist/channels/slack-tool.js +0 -416
- package/dist/tasks/tool.js +0 -416
- package/dist/web/public/assets/activity-DOr8dWeX.js.br +0 -0
- package/dist/web/public/assets/activity-DOr8dWeX.js.gz +0 -0
- package/dist/web/public/assets/boards-CneyR23E.js +0 -1
- package/dist/web/public/assets/boards-CneyR23E.js.br +0 -0
- package/dist/web/public/assets/boards-CneyR23E.js.gz +0 -0
- package/dist/web/public/assets/explorer-D0srXT1c.js +0 -4
- package/dist/web/public/assets/explorer-D0srXT1c.js.br +0 -0
- package/dist/web/public/assets/explorer-D0srXT1c.js.gz +0 -0
- package/dist/web/public/assets/index-DbFu15NN.js +0 -85
- package/dist/web/public/assets/index-DbFu15NN.js.br +0 -0
- package/dist/web/public/assets/index-DbFu15NN.js.gz +0 -0
- package/dist/web/public/assets/index-eqQLVS8Q.css +0 -2
- package/dist/web/public/assets/index-eqQLVS8Q.css.br +0 -0
- package/dist/web/public/assets/index-eqQLVS8Q.css.gz +0 -0
- package/dist/web/public/assets/runs-Cv0A-e08.js +0 -1
- package/dist/web/public/assets/runs-Cv0A-e08.js.br +0 -0
- package/dist/web/public/assets/runs-Cv0A-e08.js.gz +0 -0
- package/dist/web/public/assets/settings-VmCjhGBd.js +0 -5
- package/dist/web/public/assets/settings-VmCjhGBd.js.br +0 -0
- package/dist/web/public/assets/settings-VmCjhGBd.js.gz +0 -0
- package/dist/web/public/assets/task-runs-CqpTV644.js +0 -3
- package/dist/web/public/assets/task-runs-CqpTV644.js.br +0 -0
- package/dist/web/public/assets/task-runs-CqpTV644.js.gz +0 -0
- package/dist/web/public/assets/tasks-BffPVgXg.js +0 -4
- package/dist/web/public/assets/tasks-BffPVgXg.js.br +0 -0
- package/dist/web/public/assets/tasks-BffPVgXg.js.gz +0 -0
package/dist/channels/slack.js
CHANGED
|
@@ -17,8 +17,8 @@ import { ReceiptLedger, Receipts } from "./receipts.js";
|
|
|
17
17
|
import { SlackDirectory } from "./slack-directory.js";
|
|
18
18
|
import { SlackApi, } from "./slack-api.js";
|
|
19
19
|
import { SlackOutbound } from "./slack-outbound.js";
|
|
20
|
-
import { readThread, slackToolAvailable } from "./slack-tool.js";
|
|
21
20
|
import { SlackPanel } from "./slack-panel.js";
|
|
21
|
+
import { readThread } from "./slack-thread.js";
|
|
22
22
|
import { context, escapeMrkdwn, offeredLabel } from "./slack-render.js";
|
|
23
23
|
const WORKING = "eyes";
|
|
24
24
|
// The envelope is already acked, so this bounds concurrency (sockets,
|
|
@@ -90,7 +90,7 @@ export class SlackChannel {
|
|
|
90
90
|
const config = deps.store.get("slack");
|
|
91
91
|
this.log = deps.log ?? ((m) => logger("slack").warn(m));
|
|
92
92
|
this.chains = new Chains(this.log, MAX_ACTIVE_CHATS);
|
|
93
|
-
this.directory =
|
|
93
|
+
this.directory = new SlackDirectory(this.log);
|
|
94
94
|
this.gate = new Gatekeeper(deps.store, "slack", this.log, "channel");
|
|
95
95
|
this.seen = new Dedup(this.log, DEDUP_TTL_MS, DEDUP_MAX);
|
|
96
96
|
this.api = deps.client ?? new SlackApi(config.token, config.appToken, this.log);
|
|
@@ -354,10 +354,8 @@ export class SlackChannel {
|
|
|
354
354
|
}
|
|
355
355
|
return name ?? channel;
|
|
356
356
|
}
|
|
357
|
-
/** The eager thread read
|
|
358
|
-
*
|
|
359
|
-
* gates. `agentTool` only changes the hint, which must not name a tool this
|
|
360
|
-
* session does not have. */
|
|
357
|
+
/** The eager thread read is not gated: a human handing the agent a message
|
|
358
|
+
* is the same act as an upload. */
|
|
361
359
|
async sharedBlock(share) {
|
|
362
360
|
const source = share.original_message;
|
|
363
361
|
const ts = share.ts ?? source?.ts;
|
|
@@ -386,23 +384,19 @@ export class SlackChannel {
|
|
|
386
384
|
const thread = parent && parent.replies <= INLINE_REPLY_MAX
|
|
387
385
|
? await this.sharedThread(parent.channel, parent.ts, parent.replies)
|
|
388
386
|
: { transcript: false, lines: [] };
|
|
389
|
-
// The coordinates
|
|
390
|
-
// a lie when the Console has switched agent access off.
|
|
391
|
-
const how = slackToolAvailable(this.deps.store) ? "read with the slack tool: " : "";
|
|
387
|
+
// The coordinates in `pier slack`'s own words (skills/pier-slack).
|
|
392
388
|
const hint = parent && !thread.transcript
|
|
393
|
-
? `[thread: ${parent.replies} replies —
|
|
389
|
+
? `[thread: ${parent.replies} replies — channel ${parent.channel}, thread_ts ${parent.ts}]`
|
|
394
390
|
: "";
|
|
395
391
|
// The transcript opens with the shared message itself.
|
|
396
392
|
return [`[${head}]`, thread.transcript ? "" : body, ...thread.lines, hint]
|
|
397
393
|
.filter(Boolean).join("\n");
|
|
398
394
|
}
|
|
399
|
-
/**
|
|
400
|
-
* that fails or comes back cut says so in the prompt (§5). */
|
|
395
|
+
/** A read that fails or comes back cut says so in the prompt (§5). */
|
|
401
396
|
async sharedThread(channel, ts, replies) {
|
|
402
|
-
const deps = { directory: this.directory, log: this.log };
|
|
403
397
|
try {
|
|
404
398
|
// One over the budget, so an undercounting reply_count still reports as cut.
|
|
405
|
-
const read = await readThread(
|
|
399
|
+
const read = await readThread(this.directory, this.api, channel, ts, INLINE_REPLY_MAX + 2);
|
|
406
400
|
if (!read.messages.length)
|
|
407
401
|
return { transcript: false, lines: [] };
|
|
408
402
|
return {
|
|
@@ -410,9 +404,7 @@ export class SlackChannel {
|
|
|
410
404
|
lines: [
|
|
411
405
|
`[thread: ${replies} replies, oldest first — ${read.format}]`,
|
|
412
406
|
...read.messages,
|
|
413
|
-
...(read.
|
|
414
|
-
? [`[thread partly read: ${read.incomplete ?? `cut at ${read.count} lines`}]`]
|
|
415
|
-
: []),
|
|
407
|
+
...(read.truncated ? [`[thread partly read: cut at ${read.count} lines]`] : []),
|
|
416
408
|
],
|
|
417
409
|
};
|
|
418
410
|
}
|
package/dist/channels/types.js
CHANGED
package/dist/cli.js
CHANGED
|
@@ -1,8 +1,10 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
// What `pier` does when typed. Dispatch only, and no server imports until a
|
|
3
3
|
// command needs them: `pier service install` must not open a database.
|
|
4
|
-
import { execFileSync } from "node:child_process";
|
|
4
|
+
import { execFileSync, spawn } from "node:child_process";
|
|
5
5
|
import { accessSync, constants, realpathSync } from "node:fs";
|
|
6
|
+
import { request } from "node:http";
|
|
7
|
+
import { constants as osConstants } from "node:os";
|
|
6
8
|
import { delimiter, join, resolve } from "node:path";
|
|
7
9
|
import { parseArgs } from "node:util";
|
|
8
10
|
import { fileURLToPath } from "node:url";
|
|
@@ -21,6 +23,10 @@ Usage
|
|
|
21
23
|
pier restart finish running turns first, then restart the service
|
|
22
24
|
pier reload re-read channel config and recycle idle sessions
|
|
23
25
|
pier backup snapshot pier.db before a manual update
|
|
26
|
+
pier vault run [ENV=NAME | NAME]... -- <command> [args...]
|
|
27
|
+
run a command with named secrets in its env
|
|
28
|
+
pier slack <subcommand> ... Slack from a shell, token from the vault (pier slack --help)
|
|
29
|
+
pier task <command> ... subagents and scheduled tasks from a shell (pier task --help)
|
|
24
30
|
pier --version | --help
|
|
25
31
|
|
|
26
32
|
Options for "service install"
|
|
@@ -33,13 +39,21 @@ The workbench is behind a password generated on first run and printed once.
|
|
|
33
39
|
Under systemd that print lands in the journal: journalctl --user -u pier -e
|
|
34
40
|
`;
|
|
35
41
|
const say = (message) => void process.stdout.write(`${message}\n`);
|
|
36
|
-
|
|
37
|
-
|
|
42
|
+
/** Every socket route answers from memory and the database, so a Pier that
|
|
43
|
+
* takes longer than this is stuck, and an agent's shell must not hang with it. */
|
|
44
|
+
const SOCKET_TIMEOUT_MS = 30_000;
|
|
45
|
+
/** Typed on the binding: only then does a call narrow the code after it. */
|
|
46
|
+
const die = (message) => {
|
|
47
|
+
process.stderr.write(`${message}\n`);
|
|
38
48
|
process.exit(2);
|
|
39
49
|
};
|
|
50
|
+
const fail = (message) => die(`pier: ${message}`);
|
|
51
|
+
const argv = process.argv.slice(2);
|
|
40
52
|
const parsed = (() => {
|
|
41
53
|
try {
|
|
42
54
|
return parseArgs({
|
|
55
|
+
// `slack` and `task` own their options; only the name is parsed here.
|
|
56
|
+
args: argv[0] === "slack" || argv[0] === "task" ? [argv[0]] : argv,
|
|
43
57
|
allowPositionals: true,
|
|
44
58
|
strict: true,
|
|
45
59
|
options: {
|
|
@@ -59,7 +73,8 @@ const parsed = (() => {
|
|
|
59
73
|
})();
|
|
60
74
|
const { values, positionals } = parsed;
|
|
61
75
|
const [command, subcommand, ...extra] = positionals;
|
|
62
|
-
|
|
76
|
+
// `vault run` reads process.argv itself: parseArgs cannot say where the `--` was.
|
|
77
|
+
if (command !== "vault" && extra.length)
|
|
63
78
|
fail(`unexpected argument "${extra[0]}"`);
|
|
64
79
|
const allowOnly = (allowed, usage) => {
|
|
65
80
|
const invalid = Object.keys(values).find((key) => !allowed.includes(key));
|
|
@@ -100,6 +115,16 @@ else if (command === "update") {
|
|
|
100
115
|
else if (command === "tools") {
|
|
101
116
|
await tools(subcommand);
|
|
102
117
|
}
|
|
118
|
+
else if (command === "vault") {
|
|
119
|
+
await vault(subcommand, argv);
|
|
120
|
+
}
|
|
121
|
+
else if (command === "slack") {
|
|
122
|
+
await slack(argv.slice(1));
|
|
123
|
+
}
|
|
124
|
+
else if (command === "task") {
|
|
125
|
+
const { runTaskCli } = await import("./tasks/cli.js");
|
|
126
|
+
process.exitCode = await runTaskCli(argv.slice(1), (params) => askPier("/task", { params }));
|
|
127
|
+
}
|
|
103
128
|
else if (command === "restart" || command === "reload") {
|
|
104
129
|
if (subcommand)
|
|
105
130
|
fail(`unexpected argument "${subcommand}"`);
|
|
@@ -196,7 +221,130 @@ async function backup() {
|
|
|
196
221
|
const path = backupDb(version, PIER_DB);
|
|
197
222
|
process.stdout.write(path ? `backed up ${path}\n` : `no database yet — nothing to back up.\n`);
|
|
198
223
|
}
|
|
199
|
-
|
|
224
|
+
/** Everything after `--` runs with the named secrets in its env — plain values
|
|
225
|
+
* directly, `vt://` records through `vt inject`, which swaps them after the
|
|
226
|
+
* operator's approval. Nothing here prints a value. */
|
|
227
|
+
async function vault(action, argv) {
|
|
228
|
+
const usage = "usage: pier vault run [ENV=NAME | NAME]... -- <command> [args...]";
|
|
229
|
+
const split = argv.indexOf("--");
|
|
230
|
+
const cmd = argv.slice(split + 1);
|
|
231
|
+
if (action !== "run" || split < 2 || !cmd.length)
|
|
232
|
+
die(usage);
|
|
233
|
+
// `NAME` alone is `NAME=NAME`: names are env-var shaped so the common case needs no mapping.
|
|
234
|
+
const wanted = argv.slice(2, split).map((spec) => {
|
|
235
|
+
const parts = spec.split("=");
|
|
236
|
+
const [env, name = env] = parts;
|
|
237
|
+
if (parts.length > 2 || !env || !name || !/^[A-Za-z_][A-Za-z0-9_]*$/.test(env))
|
|
238
|
+
die(usage);
|
|
239
|
+
return [env, name];
|
|
240
|
+
});
|
|
241
|
+
if (!wanted.length)
|
|
242
|
+
die(usage);
|
|
243
|
+
const values = await resolveSecrets([...new Set(wanted.map(([, name]) => name))]);
|
|
244
|
+
return inject(wanted, values, cmd);
|
|
245
|
+
}
|
|
246
|
+
/** `cmd` with each secret in its env; `approve` records go through `vt inject`,
|
|
247
|
+
* which swaps them after approval. Never returns: the child's exit is ours. */
|
|
248
|
+
function inject(wanted, values, cmd) {
|
|
249
|
+
const env = { ...process.env };
|
|
250
|
+
const records = [];
|
|
251
|
+
for (const [envName, name] of wanted) {
|
|
252
|
+
const hit = values[name];
|
|
253
|
+
env[envName] = hit.value;
|
|
254
|
+
if (hit.kind === "record")
|
|
255
|
+
records.push(envName);
|
|
256
|
+
}
|
|
257
|
+
let [file, ...args] = cmd;
|
|
258
|
+
if (records.length) {
|
|
259
|
+
if (!findCommand("vt")) {
|
|
260
|
+
const names = wanted.filter(([envName]) => records.includes(envName)).map(([, name]) => name);
|
|
261
|
+
die(`vault: vt is required for ${names.join(", ")} (approve level) and was not found`);
|
|
262
|
+
}
|
|
263
|
+
// Only the record-carrying variables are swapped; everything else passes through untouched.
|
|
264
|
+
[file, ...args] = ["vt", "inject", "--only-env", records.join(","), "--", ...cmd];
|
|
265
|
+
}
|
|
266
|
+
const child = spawn(file, args, { stdio: "inherit", env });
|
|
267
|
+
for (const signal of ["SIGINT", "SIGTERM"])
|
|
268
|
+
process.on(signal, () => child.kill(signal));
|
|
269
|
+
child.on("error", (err) => die(`vault: ${cmd[0]}: ${err.message}`));
|
|
270
|
+
child.on("exit", (code, signal) => {
|
|
271
|
+
// The shell's convention for a signal death, so a caller sees the same number it would without us.
|
|
272
|
+
process.exit(code ?? 128 + (signal ? osConstants.signals[signal] : 0));
|
|
273
|
+
});
|
|
274
|
+
return new Promise(() => { });
|
|
275
|
+
}
|
|
276
|
+
/** One request to the running Pier over its socket, signed with the caller's
|
|
277
|
+
* session (`PIER_SESSION_ID`, the harness variable mapped by the shim). Not
|
|
278
|
+
* running, silent, unreadable, or an identity or body Pier refuses, is one
|
|
279
|
+
* `pier:` line and exit 2 before any route reads the answer. */
|
|
280
|
+
async function askPier(path, body) {
|
|
281
|
+
const { PIER_SOCK } = await import("./paths.js");
|
|
282
|
+
const answer = await new Promise((done, reject) => {
|
|
283
|
+
let responded = false;
|
|
284
|
+
const req = request({ socketPath: PIER_SOCK, method: "POST", path, headers: { "content-type": "application/json" }, timeout: SOCKET_TIMEOUT_MS }, (res) => {
|
|
285
|
+
responded = true;
|
|
286
|
+
let raw = "";
|
|
287
|
+
const unreadable = () => reject(new Error(`unreadable answer from ${PIER_SOCK} (status ${String(res.statusCode ?? 0)})`));
|
|
288
|
+
res.on("data", (chunk) => (raw += chunk.toString()));
|
|
289
|
+
// A connection cut mid-body reports on the response, and `end` never comes.
|
|
290
|
+
res.on("error", unreadable);
|
|
291
|
+
res.on("end", () => {
|
|
292
|
+
try {
|
|
293
|
+
done({ status: res.statusCode ?? 0, body: JSON.parse(raw) });
|
|
294
|
+
}
|
|
295
|
+
catch {
|
|
296
|
+
unreadable();
|
|
297
|
+
}
|
|
298
|
+
});
|
|
299
|
+
});
|
|
300
|
+
req.on("timeout", () => req.destroy(new Error(`Pier did not answer within ${String(SOCKET_TIMEOUT_MS / 1000)} s`)));
|
|
301
|
+
// A 413 arrives while the body is still being written; the EPIPE after it is not the news.
|
|
302
|
+
req.on("error", (err) => responded || reject(err));
|
|
303
|
+
req.end(JSON.stringify({ ...body, sessionId: process.env.PIER_SESSION_ID }));
|
|
304
|
+
}).catch((err) =>
|
|
305
|
+
// A crash leaves the file with nobody behind it: that is "not running" too.
|
|
306
|
+
err.code === "ENOENT" || err.code === "ECONNREFUSED"
|
|
307
|
+
? fail(`Pier is not running (no ${PIER_SOCK})`)
|
|
308
|
+
: fail(err.message));
|
|
309
|
+
if (answer.status === 400 || answer.status === 403 || answer.status === 413)
|
|
310
|
+
fail(answer.body.error ?? `socket answered ${String(answer.status)}`);
|
|
311
|
+
return answer;
|
|
312
|
+
}
|
|
313
|
+
/** The running Pier's answer for `names`, every name present; any failure is
|
|
314
|
+
* one `vault:` line and exit 2, so an agent reads words, not an empty variable. */
|
|
315
|
+
async function resolveSecrets(names) {
|
|
316
|
+
const { status, body } = await askPier("/resolve", { names });
|
|
317
|
+
if (status === 404)
|
|
318
|
+
die(`vault: ${body.error ?? "unknown name"} — file it at ${body.file ?? "the Console (Settings → Vault)"}`);
|
|
319
|
+
const values = body.values;
|
|
320
|
+
if (status !== 200 || !values)
|
|
321
|
+
die(`vault: ${body.error ?? `socket answered ${String(status)}`}`);
|
|
322
|
+
const missing = names.find((name) => !values[name]);
|
|
323
|
+
if (missing)
|
|
324
|
+
die(`vault: no secret named ${missing}`);
|
|
325
|
+
return values;
|
|
326
|
+
}
|
|
327
|
+
/** `$SLACK_BOT_TOKEN` when set (the re-exec below, or a test); otherwise the
|
|
328
|
+
* vault's `SLACK_TOKEN`. An `approve` record is only readable inside `vt
|
|
329
|
+
* inject`, so the command re-runs itself under it — the agent never sees
|
|
330
|
+
* the vault. Lazy: `--help` and usage errors never touch the socket. */
|
|
331
|
+
async function slack(args) {
|
|
332
|
+
const token = async () => {
|
|
333
|
+
const given = process.env.SLACK_BOT_TOKEN;
|
|
334
|
+
if (given)
|
|
335
|
+
return given;
|
|
336
|
+
const values = await resolveSecrets(["SLACK_TOKEN"]);
|
|
337
|
+
const hit = values.SLACK_TOKEN;
|
|
338
|
+
if (hit.kind === "plain")
|
|
339
|
+
return hit.value;
|
|
340
|
+
// argv[1], not `pier` on PATH: the same build that is running answers.
|
|
341
|
+
return inject([["SLACK_BOT_TOKEN", "SLACK_TOKEN"]], values, [process.execPath, ...process.execArgv, process.argv[1], "slack", ...args]);
|
|
342
|
+
};
|
|
343
|
+
const { runSlackCli } = await import("./channels/slack-cli.js");
|
|
344
|
+
process.exitCode = await runSlackCli(args, token);
|
|
345
|
+
}
|
|
346
|
+
/** Resolved through every PATH entry: version managers put several prefixes on it. */
|
|
347
|
+
function findCommand(name) {
|
|
200
348
|
for (const dir of (process.env.PATH ?? "").split(delimiter)) {
|
|
201
349
|
const path = join(dir || ".", name);
|
|
202
350
|
try {
|
|
@@ -204,10 +352,13 @@ function commandPath(name) {
|
|
|
204
352
|
return realpathSync(path);
|
|
205
353
|
}
|
|
206
354
|
catch {
|
|
207
|
-
// Keep looking
|
|
355
|
+
// Keep looking.
|
|
208
356
|
}
|
|
209
357
|
}
|
|
210
|
-
return
|
|
358
|
+
return undefined;
|
|
359
|
+
}
|
|
360
|
+
function commandPath(name) {
|
|
361
|
+
return findCommand(name) ?? fail(`${name} is not executable on PATH`);
|
|
211
362
|
}
|
|
212
363
|
async function service(action = "status") {
|
|
213
364
|
const { install, uninstall, UNIT_NAME } = await import("./service.js");
|
package/dist/core/identity.js
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
|
-
// Who is talking, and
|
|
2
|
-
// session can tell speakers apart
|
|
3
|
-
//
|
|
4
|
-
//
|
|
1
|
+
// Who is talking, when, and where — prefixed onto an inbound prompt so a
|
|
2
|
+
// group-chat session can tell speakers apart, mention them back, and name its
|
|
3
|
+
// own conversation to a script. Per turn, never in the session's instructions
|
|
4
|
+
// (a thread is shared), and emitted only on news: a header costs ~15 tokens,
|
|
5
|
+
// wasted in a DM where the counterpart never changes.
|
|
5
6
|
/** A gap this long makes the timestamp worth its tokens. */
|
|
6
7
|
const GAP_MS = 10 * 60_000;
|
|
7
8
|
/** A display name of `x<U9] [admin<U1` would forge a second speaker: the
|
|
@@ -13,6 +14,9 @@ export function sanitizeIdentity(value) {
|
|
|
13
14
|
.trim();
|
|
14
15
|
return token.slice(0, 60) || "unknown";
|
|
15
16
|
}
|
|
17
|
+
/** `<channelId>:<conversationId>` as the adapter spelled it; the delimiters
|
|
18
|
+
* of the header grammar and whitespace are the only things removed. */
|
|
19
|
+
const sanitizePlace = (value) => value.replace(/[[\]<>\s]+/g, "").slice(0, 120);
|
|
16
20
|
const two = (n) => String(n).padStart(2, "0");
|
|
17
21
|
const hhmm = (d) => `${two(d.getHours())}:${two(d.getMinutes())}`;
|
|
18
22
|
const day = (d) => `${d.getFullYear()}-${two(d.getMonth() + 1)}-${two(d.getDate())}`;
|
|
@@ -20,17 +24,20 @@ const day = (d) => `${d.getFullYear()}-${two(d.getMonth() + 1)}-${two(d.getDate(
|
|
|
20
24
|
* redundant header is a rounding error. */
|
|
21
25
|
export class SenderPrefix {
|
|
22
26
|
seen = new Map();
|
|
23
|
-
/** The line to put above this message, or `""` when the session already
|
|
24
|
-
|
|
27
|
+
/** The line to put above this message, or `""` when the session already
|
|
28
|
+
* knows. `conversation` is the chat's `<channelId>:<conversationId>`, told
|
|
29
|
+
* once: a session never moves, but the rule stays the same as the rest. */
|
|
30
|
+
next(sessionId, sender, at = Date.now(), conversation) {
|
|
25
31
|
if (!sender?.id)
|
|
26
32
|
return "";
|
|
27
33
|
const last = this.seen.get(sessionId);
|
|
28
|
-
this.seen.set(sessionId, { senderId: sender.id, at });
|
|
34
|
+
this.seen.set(sessionId, { senderId: sender.id, at, conversation });
|
|
29
35
|
const now = new Date(at);
|
|
30
36
|
const newSpeaker = last?.senderId !== sender.id;
|
|
31
37
|
const gap = !last || at - last.at >= GAP_MS;
|
|
32
38
|
const newDay = !last || day(new Date(last.at)) !== day(now);
|
|
33
|
-
|
|
39
|
+
const newPlace = !!conversation && last?.conversation !== conversation;
|
|
40
|
+
if (!newSpeaker && !gap && !newDay && !newPlace)
|
|
34
41
|
return "";
|
|
35
42
|
// The id is the only thing a mention can be built from; an unresolved name
|
|
36
43
|
// is the id, and `U123<U123>` would read as a broken record.
|
|
@@ -38,7 +45,8 @@ export class SenderPrefix {
|
|
|
38
45
|
const label = sanitizeIdentity(sender.name);
|
|
39
46
|
const who = newSpeaker ? (label === id ? `<${id}>` : `${label}<${id}>`) : "";
|
|
40
47
|
const when = gap || newDay ? `${newDay ? `${day(now)} ` : ""}${hhmm(now)}` : "";
|
|
41
|
-
|
|
48
|
+
const where = newPlace ? sanitizePlace(conversation) : "";
|
|
49
|
+
return `[${[who, when, where].filter(Boolean).join(" ")}]`;
|
|
42
50
|
}
|
|
43
51
|
forget(sessionId) {
|
|
44
52
|
this.seen.delete(sessionId);
|
|
@@ -47,17 +55,18 @@ export class SenderPrefix {
|
|
|
47
55
|
export const withPrefix = (prefix, text) => prefix ? `${prefix}\n${text}` : text;
|
|
48
56
|
// Only the shapes `next()` emits, newline included: a human typing
|
|
49
57
|
// `[14:23] on my way` is body text and must come back untouched.
|
|
50
|
-
const HEADER = /^\[(?:([^\n[\]<>]*)<([^\n[\]<>]+)>)? ?((?:\d{4}-\d{2}-\d{2} )?\d{1,2}:\d{2})?\]\n/;
|
|
58
|
+
const HEADER = /^\[(?:([^\n[\]<>]*)<([^\n[\]<>]+)>)? ?((?:\d{4}-\d{2}-\d{2} )?\d{1,2}:\d{2})? ?([a-z]+:[^\s[\]<>]+)?\]\n/;
|
|
51
59
|
/** Read back a header this module wrote: the prefix is for the model, and a
|
|
52
60
|
* surface showing a stored message renders the speaker its own way. */
|
|
53
61
|
export function splitSpeaker(text) {
|
|
54
62
|
const m = HEADER.exec(text);
|
|
55
|
-
if (!m?.[2] && !m?.[3])
|
|
63
|
+
if (!m?.[2] && !m?.[3] && !m?.[4])
|
|
56
64
|
return { text };
|
|
57
65
|
return {
|
|
58
66
|
...(m[1] ? { name: m[1] } : {}),
|
|
59
67
|
...(m[2] ? { id: m[2] } : {}),
|
|
60
68
|
...(m[3] ? { when: m[3] } : {}),
|
|
69
|
+
...(m[4] ? { where: m[4] } : {}),
|
|
61
70
|
text: text.slice(m[0].length),
|
|
62
71
|
};
|
|
63
72
|
}
|
package/dist/core/reply.js
CHANGED
|
@@ -24,10 +24,13 @@ conventions:
|
|
|
24
24
|
including humans talking to each other: stay silent rather than acknowledge
|
|
25
25
|
what was not addressed to you.
|
|
26
26
|
|
|
27
|
-
A message may start with \`[name<id> time]\` — the sender
|
|
28
|
-
typed by them. It appears only on a change — new speaker, a
|
|
29
|
-
new day — so the last one still applies; a gap alone shows as
|
|
30
|
-
\`[14:23]\`. Use that \`id\` to mention someone; never ask for
|
|
27
|
+
A message may start with \`[name<id> time place]\` — the sender and the chat,
|
|
28
|
+
added by Pier, not typed by them. It appears only on a change — new speaker, a
|
|
29
|
+
~10-minute gap, a new day — so the last one still applies; a gap alone shows as
|
|
30
|
+
time only, like \`[14:23]\`. Use that \`id\` to mention someone; never ask for
|
|
31
|
+
their own. \`place\` is \`<platform>:<conversation>\` (Slack:
|
|
32
|
+
\`slack:<channel>/<thread_ts>\`), said once per session: the channel and thread a
|
|
33
|
+
script takes.
|
|
31
34
|
`;
|
|
32
35
|
/** Deployment facts an agent cannot discover: a guessed path is wrong wherever
|
|
33
36
|
* `PIER_HOME` moved and fails as "nothing is configured"; GPT models carry
|
|
@@ -56,14 +59,7 @@ export function originLabel(origin) {
|
|
|
56
59
|
if (origin.kind !== "task-message") {
|
|
57
60
|
return origin.kind === "task-delegation" ? "\u25b6 delegated task" : "\u21a9 task callback";
|
|
58
61
|
}
|
|
59
|
-
|
|
60
|
-
steer: "\u270e steer",
|
|
61
|
-
follow_up: "\uff0b follow-up",
|
|
62
|
-
progress: "\u25c7 progress",
|
|
63
|
-
decision: "\u2753 decision needed",
|
|
64
|
-
reply: "\u21a9 reply",
|
|
65
|
-
};
|
|
66
|
-
return `from a subagent \u00b7 ${kinds[origin.messageKind] ?? origin.messageKind}`;
|
|
62
|
+
return `from a supervisor \u00b7 ${origin.messageKind === "steer" ? "\u270e steer" : "\uff0b follow-up"}`;
|
|
67
63
|
}
|
|
68
64
|
/** Is a turn coming once this note is posted? On IM the note is the only
|
|
69
65
|
* message that turn has to wear the 👀; an error note reports a turn that
|
|
@@ -130,7 +126,12 @@ const MAX_SUGGESTIONS = 5;
|
|
|
130
126
|
/** A deliberate non-answer. Stripped here so an adapter needs no new concept:
|
|
131
127
|
* an empty turn already posts nothing and retires its per-turn UI. The reason
|
|
132
128
|
* stays in the transcript, auditable without being broadcast. */
|
|
133
|
-
|
|
129
|
+
// A model has been seen emitting `<s<U+200B>ilent>`: zero-width characters inside
|
|
130
|
+
// the tag, which would post the literal tag to a channel instead of silence.
|
|
131
|
+
const ZW = String.raw `[\u200B-\u200D\u2060\uFEFF]*`;
|
|
132
|
+
const tag = (literal) => literal.split("").join(ZW);
|
|
133
|
+
const SILENT = new RegExp(`${tag("<silent>")}([\\s\\S]*?)${tag("</silent>")}`, "gi");
|
|
134
|
+
const SILENT_TAG = new RegExp(`<(\\/?)${tag("silent>")}`, "gi");
|
|
134
135
|
/** Why the agent stayed quiet; hidden from the chat, shown on the workbench,
|
|
135
136
|
* where a silent turn must not look like a broken one. */
|
|
136
137
|
export function silentReason(markdown) {
|
|
@@ -193,8 +194,8 @@ export function stableBlockEnd(markdown, from = 0) {
|
|
|
193
194
|
else if (open && run[0] === open[0] && run.length >= open.length && !fence?.[2]?.trim())
|
|
194
195
|
open = "";
|
|
195
196
|
if (!open && (!run || silent)) {
|
|
196
|
-
for (const
|
|
197
|
-
silent = !
|
|
197
|
+
for (const t of line.matchAll(SILENT_TAG))
|
|
198
|
+
silent = !t[1];
|
|
198
199
|
}
|
|
199
200
|
pending = -1;
|
|
200
201
|
prev = line;
|
package/dist/core/router.js
CHANGED
|
@@ -567,7 +567,10 @@ export class Router {
|
|
|
567
567
|
this.refuseDraining(msg.key);
|
|
568
568
|
this.spokenTo?.(session.id);
|
|
569
569
|
const { action, text } = decide(msg, session.state);
|
|
570
|
-
|
|
570
|
+
// A chat is named so the agent can hand it to a script (skills/pier-slack);
|
|
571
|
+
// an alias names nothing a shell could reach.
|
|
572
|
+
const where = isAlias(msg.key) ? undefined : keyOf(msg.key);
|
|
573
|
+
const prompt = withPrefix(this.senders.next(session.id, msg.sender, Date.now(), where), text);
|
|
571
574
|
log.debug(`${action} ${keyOf(msg.key)} → session ${session.id} (${String(prompt.length)} chars)`);
|
|
572
575
|
// A rejected call surfaces on the event stream, never as a throw across the seam.
|
|
573
576
|
session[action](prompt).catch((err) => {
|
package/dist/core/types.js
CHANGED
|
@@ -13,6 +13,13 @@ export const SESSION_TITLE_MAX = 80;
|
|
|
13
13
|
* drift, and boundary validators use isThinkingLevel instead of their own copy. */
|
|
14
14
|
export const THINKING_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
|
|
15
15
|
export const isThinkingLevel = (v) => typeof v === "string" && THINKING_LEVELS.includes(v);
|
|
16
|
+
export class PackageError extends Error {
|
|
17
|
+
reason;
|
|
18
|
+
constructor(reason, message) {
|
|
19
|
+
super(message);
|
|
20
|
+
this.reason = reason;
|
|
21
|
+
}
|
|
22
|
+
}
|
|
16
23
|
// Wire-protocol names, not SDK types — but they are pi-ai's spellings, and a
|
|
17
24
|
// non-Pi backend is bound to them by this seam.
|
|
18
25
|
const PROVIDER_APIS = [
|
package/dist/db.js
CHANGED
|
@@ -272,6 +272,34 @@ const MIGRATIONS = [
|
|
|
272
272
|
-- Every row goes so the next scan re-reads each transcript and fills the table above.
|
|
273
273
|
DELETE FROM session_index;
|
|
274
274
|
`,
|
|
275
|
+
// 23 — the vault: named secrets `pier vault run` injects into one command.
|
|
276
|
+
`
|
|
277
|
+
-- name is an env-var name (^[A-Z][A-Z0-9_]{0,63}$). value is a sealed
|
|
278
|
+
-- envelope (auto) or a vt:// record (approve): the shape is the level.
|
|
279
|
+
CREATE TABLE vault (
|
|
280
|
+
name TEXT PRIMARY KEY,
|
|
281
|
+
value TEXT NOT NULL,
|
|
282
|
+
updated_at INTEGER NOT NULL
|
|
283
|
+
);
|
|
284
|
+
`,
|
|
285
|
+
// 24 — channel credentials move into the vault under fixed names (channels/config.ts).
|
|
286
|
+
`
|
|
287
|
+
-- The blob moves verbatim: same DEK, no decrypt, so this runs locked like
|
|
288
|
+
-- every migration. A name filed in the vault first wins (DO NOTHING); the
|
|
289
|
+
-- channel copy is dropped either way.
|
|
290
|
+
WITH moved(platform, path, name) AS (VALUES
|
|
291
|
+
('telegram', '$.token', 'TELEGRAM_TOKEN'),
|
|
292
|
+
('slack', '$.token', 'SLACK_TOKEN'), ('slack', '$.appToken', 'SLACK_APP_TOKEN'),
|
|
293
|
+
('lark', '$.token', 'LARK_APP_ID'), ('lark', '$.appToken', 'LARK_APP_SECRET'))
|
|
294
|
+
INSERT INTO vault(name, value, updated_at)
|
|
295
|
+
SELECT moved.name, json_extract(channels.json, moved.path), CAST(strftime('%s', 'now') AS INTEGER) * 1000
|
|
296
|
+
FROM moved JOIN channels ON channels.platform = moved.platform
|
|
297
|
+
WHERE json_extract(channels.json, moved.path) <> ''
|
|
298
|
+
ON CONFLICT(name) DO NOTHING;
|
|
299
|
+
UPDATE channels SET json = json_remove(json, '$.token', '$.appToken');
|
|
300
|
+
`,
|
|
301
|
+
// 25 — the mid-run decision channel is gone; a control message is steer or follow_up.
|
|
302
|
+
`DELETE FROM task_messages WHERE json_extract(json, '$.kind') IN ('progress', 'decision', 'reply');`,
|
|
275
303
|
];
|
|
276
304
|
/** `BEGIN IMMEDIATE`: taking the write lock up front turns a race with another
|
|
277
305
|
* Pier process into a wait, where deferred would be SQLITE_BUSY halfway through. */
|
package/dist/extensions/index.js
CHANGED
|
@@ -3,27 +3,8 @@
|
|
|
3
3
|
// either clobbers the user's edits or skips them forever.
|
|
4
4
|
import web from "./web/index.js";
|
|
5
5
|
export const BUNDLED = [
|
|
6
|
-
{
|
|
7
|
-
name: "web",
|
|
8
|
-
summary: "The public web through the provider's own hosted web tools — no extra " +
|
|
9
|
-
"key, no second service, no new dependency.",
|
|
10
|
-
tools: [
|
|
11
|
-
{ name: "web_search", needs: "an authenticated Anthropic or OpenAI model" },
|
|
12
|
-
{ name: "web_fetch", needs: "an authenticated Anthropic model — OpenAI hosts no fetch tool" },
|
|
13
|
-
],
|
|
14
|
-
factory: web,
|
|
15
|
-
},
|
|
6
|
+
{ name: "web", factory: web },
|
|
16
7
|
];
|
|
17
|
-
/** The catalog a surface may show: no Pi types, nothing it cannot render.
|
|
18
|
-
* Half of one list; src/tools.ts has the other. */
|
|
19
|
-
export const bundledInfo = (enabled) => BUNDLED.map(({ name, summary, tools }) => ({
|
|
20
|
-
source: "bundled",
|
|
21
|
-
kind: "extension",
|
|
22
|
-
name,
|
|
23
|
-
summary,
|
|
24
|
-
adds: tools,
|
|
25
|
-
enabled: enabled.includes(name),
|
|
26
|
-
}));
|
|
27
8
|
/** The enabled ones as Pi inline extensions; unknown names are not ours. */
|
|
28
9
|
export const inlineExtensions = (enabled) => BUNDLED.filter((ext) => enabled.includes(ext.name))
|
|
29
10
|
.map(({ name, factory }) => ({ name, factory }));
|