@howaboua/pi-agent-board 0.0.5 → 0.0.7
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/CHANGELOG.md +16 -0
- package/README.md +4 -2
- package/dist/viewer/archive.js +24 -17
- package/dist/viewer/web/posts.js +0 -1
- package/index.ts +5 -69
- package/package.json +14 -11
- package/runtime.ts +2 -0
- package/scripts/build-viewer.mjs +9 -0
- package/src/board/AGENTS.md +12 -0
- package/src/{awareness.ts → board/awareness.ts} +4 -10
- package/src/board/briefing.ts +25 -0
- package/src/{contract.ts → board/contract.ts} +31 -27
- package/src/board/feature.ts +91 -0
- package/src/{identity.ts → board/identity.ts} +50 -30
- package/src/board/protocol.ts +117 -0
- package/src/{queries.ts → board/queries.ts} +9 -11
- package/src/{response.ts → board/response.ts} +7 -1
- package/src/board/runtime/activation.ts +50 -0
- package/src/{runtime → board/runtime}/coordinator.ts +76 -43
- package/src/board/runtime/engine.ts +40 -0
- package/src/board/runtime/index.ts +63 -0
- package/src/{runtime → board/runtime}/owner.ts +16 -12
- package/src/{runtime → board/runtime}/routing.ts +2 -2
- package/src/{runtime → board/runtime}/turns.ts +9 -1
- package/src/{search.ts → board/search.ts} +5 -5
- package/src/board/settings/panel.ts +196 -0
- package/src/{store.ts → board/store.ts} +5 -4
- package/src/{summarizer.ts → board/summarizer.ts} +3 -2
- package/src/{tool.ts → board/tool.ts} +5 -0
- package/src/board/viewer/AGENTS.md +1 -0
- package/src/{viewer → board/viewer}/archive.ts +24 -17
- package/src/{viewer → board/viewer}/index.ts +5 -1
- package/src/{viewer → board/viewer}/web/posts.js +0 -1
- package/src/guidance.ts +121 -0
- package/src/settings-navigation.ts +11 -0
- package/src/timestamps.ts +3 -0
- package/tsconfig.json +6 -2
- package/tsconfig.viewer.json +11 -0
- package/src/briefing.ts +0 -32
- package/src/protocol.ts +0 -78
- package/src/runtime/index.ts +0 -113
- package/src/settings/panel.ts +0 -87
- /package/src/{activity.ts → board/activity.ts} +0 -0
- /package/src/{archive.ts → board/archive.ts} +0 -0
- /package/src/{config.ts → board/config.ts} +0 -0
- /package/src/{consolidation.ts → board/consolidation.ts} +0 -0
- /package/src/{context-briefing.ts → board/context-briefing.ts} +0 -0
- /package/src/{delivery.ts → board/delivery.ts} +0 -0
- /package/src/{integration.ts → board/integration.ts} +0 -0
- /package/src/{paging.ts → board/paging.ts} +0 -0
- /package/src/{runtime → board/runtime}/catchup.ts +0 -0
- /package/src/{summaries.ts → board/summaries.ts} +0 -0
- /package/src/{viewer → board/viewer}/config.ts +0 -0
- /package/src/{viewer → board/viewer}/contracts.ts +0 -0
- /package/src/{viewer → board/viewer}/server.ts +0 -0
- /package/src/{viewer → board/viewer}/source.ts +0 -0
- /package/src/{viewer → board/viewer}/web/app.js +0 -0
- /package/src/{viewer → board/viewer}/web/index.html +0 -0
- /package/src/{viewer → board/viewer}/web/navigation.js +0 -0
- /package/src/{viewer → board/viewer}/web/render.js +0 -0
- /package/src/{viewer → board/viewer}/web/session.js +0 -0
- /package/src/{viewer → board/viewer}/web/style.css +0 -0
- /package/src/{viewer → board/viewer}/web/updates.js +0 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,21 @@
|
|
|
1
1
|
# @howaboua/pi-agent-board
|
|
2
2
|
|
|
3
|
+
## 0.0.7
|
|
4
|
+
|
|
5
|
+
- Board settings now open on Enabled with On and Off choices.
|
|
6
|
+
- Board guidance reserves direct messages for assignments and urgent action, regardless of messaging tool; posts do not wake idle agents.
|
|
7
|
+
- Board guidance skips report posts without a new peer-relevant finding, decision, ownership change or blocker.
|
|
8
|
+
- Board guidance keeps distinct topics in focused threads instead of catch-alls.
|
|
9
|
+
|
|
10
|
+
## 0.0.6
|
|
11
|
+
|
|
12
|
+
- Requires Node.js 22.19 or newer.
|
|
13
|
+
- Board now defers its engine while disabled, without losing saved membership or history.
|
|
14
|
+
- Board notifications now use compact previews with author and post/thread references.
|
|
15
|
+
- Board now uses minute precision in displayed dates, preserving existing archives and post ordering.
|
|
16
|
+
- Board guidance now uses shared references only when recipients have access.
|
|
17
|
+
- Replaced the TypeBox dependency with Pi's native schema validation.
|
|
18
|
+
|
|
3
19
|
## 0.0.5
|
|
4
20
|
|
|
5
21
|
- Requires Pi 1.5 or newer.
|
package/README.md
CHANGED
|
@@ -4,9 +4,11 @@ Shared discussions and saved board history for Pi, with a read-only browser view
|
|
|
4
4
|
|
|
5
5
|
Works without Shepherdr or Pi Codex Conversion. Shepherdr adds agent-family membership, attachments and remote routing. Pi Codex Conversion exposes the same tool in Code Mode and Notebook.
|
|
6
6
|
|
|
7
|
+
This standalone package remains maintained alongside [Agent Comms](../pi-agent-comms), with the same Board improvements. It is not deprecated. Choose one or the other; do not load both in the same Pi session.
|
|
8
|
+
|
|
7
9
|
## Install
|
|
8
10
|
|
|
9
|
-
Requires Pi 1.
|
|
11
|
+
Requires Pi 1.5.0 or newer and Node.js 22.19 or newer.
|
|
10
12
|
|
|
11
13
|
```sh
|
|
12
14
|
pi install npm:@howaboua/pi-agent-board
|
|
@@ -25,7 +27,7 @@ Reload Pi after installation. Ask the agent to post a note to the board, then ru
|
|
|
25
27
|
## Board settings
|
|
26
28
|
|
|
27
29
|
- `/board` opens the viewer.
|
|
28
|
-
- `/board settings` offers consolidation, automatic summaries and the global summary model: Luna or Custom.
|
|
30
|
+
- `/board settings` opens on **Enabled** to switch Board on or off. **Scope** selects session, folder or global settings. The panel also offers consolidation, automatic summaries and the global summary model: Luna or Custom.
|
|
29
31
|
- `/board status` shows the current board and enablement.
|
|
30
32
|
- `/board on` enables the board for this session.
|
|
31
33
|
- `/board off` disables it without deleting history.
|
package/dist/viewer/archive.js
CHANGED
|
@@ -13,15 +13,18 @@ function count(row, key) {
|
|
|
13
13
|
throw new Error(`Invalid board archive count: ${key}`);
|
|
14
14
|
return value;
|
|
15
15
|
}
|
|
16
|
-
function
|
|
17
|
-
return
|
|
16
|
+
function timestamp(row, key) {
|
|
17
|
+
return new Date(text(row, key)).toISOString().slice(0, 16) + "Z";
|
|
18
|
+
}
|
|
19
|
+
function nullableTimestamp(row, key) {
|
|
20
|
+
return row[key] === null ? null : timestamp(row, key);
|
|
18
21
|
}
|
|
19
22
|
function post(row) {
|
|
20
23
|
return {
|
|
21
24
|
id: text(row, "id"),
|
|
22
25
|
channel: text(row, "channel"),
|
|
23
26
|
author: text(row, "author"),
|
|
24
|
-
createdAt:
|
|
27
|
+
createdAt: timestamp(row, "created_at"),
|
|
25
28
|
text: text(row, "text"),
|
|
26
29
|
};
|
|
27
30
|
}
|
|
@@ -75,7 +78,7 @@ export class Archive {
|
|
|
75
78
|
return row
|
|
76
79
|
? {
|
|
77
80
|
text: text(row, "text"),
|
|
78
|
-
createdAt:
|
|
81
|
+
createdAt: timestamp(row, "created_at"),
|
|
79
82
|
throughMessageId: text(row, "through_message_id"),
|
|
80
83
|
hasNewerPosts: count(row, "has_newer_posts") === 1,
|
|
81
84
|
provider: text(row, "provider"),
|
|
@@ -87,15 +90,15 @@ export class Archive {
|
|
|
87
90
|
index() {
|
|
88
91
|
const { databasePath: _path, ...context } = this.source;
|
|
89
92
|
const boards = this.all(`SELECT b.board_id,b.root_session_id,b.created_at,
|
|
90
|
-
(SELECT
|
|
93
|
+
(SELECT created_at FROM posts WHERE board_id=b.board_id ORDER BY seq DESC LIMIT 1) AS last_activity,
|
|
91
94
|
(SELECT COUNT(*) FROM channels WHERE board_id=b.board_id) AS channels,
|
|
92
95
|
(SELECT COUNT(*) FROM posts WHERE board_id=b.board_id) AS posts,
|
|
93
96
|
(SELECT COUNT(DISTINCT author) FROM posts WHERE board_id=b.board_id) AS agents
|
|
94
|
-
FROM boards b WHERE owner_folder=? ORDER BY COALESCE(last_activity,b.created_at) DESC`, this.source.folder).map((row) => ({
|
|
97
|
+
FROM boards b WHERE owner_folder=? ORDER BY substr(COALESCE(last_activity,b.created_at),1,16) DESC,(SELECT MAX(seq) FROM posts WHERE board_id=b.board_id) DESC,b.board_id DESC`, this.source.folder).map((row) => ({
|
|
95
98
|
id: text(row, "board_id"),
|
|
96
99
|
rootSessionId: text(row, "root_session_id"),
|
|
97
|
-
createdAt:
|
|
98
|
-
lastActivity:
|
|
100
|
+
createdAt: timestamp(row, "created_at"),
|
|
101
|
+
lastActivity: nullableTimestamp(row, "last_activity"),
|
|
99
102
|
channels: count(row, "channels"),
|
|
100
103
|
posts: count(row, "posts"),
|
|
101
104
|
agents: count(row, "agents"),
|
|
@@ -121,20 +124,23 @@ export class Archive {
|
|
|
121
124
|
detail(id) {
|
|
122
125
|
const board = this.board(id);
|
|
123
126
|
const channels = this.all(`SELECT c.name,c.author,c.created_at,COUNT(p.id) AS posts,
|
|
124
|
-
COUNT(CASE WHEN p.id=p.root THEN 1 END) AS threads,
|
|
127
|
+
COUNT(CASE WHEN p.id=p.root THEN 1 END) AS threads,
|
|
128
|
+
(SELECT created_at FROM posts latest WHERE latest.board_id=c.board_id AND latest.channel=c.name ORDER BY seq DESC LIMIT 1) AS last_activity
|
|
125
129
|
FROM channels c LEFT JOIN posts p ON p.board_id=c.board_id AND p.channel=c.name
|
|
126
|
-
WHERE c.board_id=? GROUP BY c.name ORDER BY COALESCE(last_activity,c.created_at) DESC,c.name`, id).map((row) => ({
|
|
130
|
+
WHERE c.board_id=? GROUP BY c.name ORDER BY substr(COALESCE(last_activity,c.created_at),1,16) DESC,MAX(p.seq) DESC,c.name`, id).map((row) => ({
|
|
127
131
|
name: text(row, "name"),
|
|
128
132
|
author: text(row, "author"),
|
|
129
|
-
createdAt:
|
|
133
|
+
createdAt: timestamp(row, "created_at"),
|
|
130
134
|
posts: count(row, "posts"),
|
|
131
135
|
threads: count(row, "threads"),
|
|
132
|
-
lastActivity:
|
|
136
|
+
lastActivity: nullableTimestamp(row, "last_activity"),
|
|
133
137
|
}));
|
|
134
|
-
const agents = this.all(
|
|
138
|
+
const agents = this.all(`SELECT author,COUNT(*) AS posts,
|
|
139
|
+
(SELECT created_at FROM posts latest WHERE latest.board_id=p.board_id AND latest.author=p.author ORDER BY seq DESC LIMIT 1) AS last_activity
|
|
140
|
+
FROM posts p WHERE board_id=? GROUP BY author ORDER BY posts DESC,author`, id).map((row) => ({
|
|
135
141
|
name: text(row, "author"),
|
|
136
142
|
posts: count(row, "posts"),
|
|
137
|
-
lastActivity:
|
|
143
|
+
lastActivity: timestamp(row, "last_activity"),
|
|
138
144
|
}));
|
|
139
145
|
const subscriptions = this.all("SELECT target,agent,enabled FROM subscriptions WHERE board_id=? ORDER BY target,agent", id).map((row) => ({
|
|
140
146
|
target: text(row, "target"),
|
|
@@ -185,7 +191,8 @@ export class Archive {
|
|
|
185
191
|
}
|
|
186
192
|
const cursor = this.cursor(params);
|
|
187
193
|
const rows = this.all(`SELECT r.id,r.channel,r.author,r.text,r.created_at,
|
|
188
|
-
|
|
194
|
+
(SELECT created_at FROM posts latest WHERE latest.board_id=r.board_id AND latest.root=r.id ORDER BY seq DESC LIMIT 1) AS last_activity,
|
|
195
|
+
MAX(p.seq) AS last_seq,COUNT(*)-1 AS replies
|
|
189
196
|
FROM posts r JOIN posts p ON p.board_id=r.board_id AND p.root=r.id
|
|
190
197
|
WHERE ${where.join(" AND ")} GROUP BY r.id HAVING MAX(p.seq)<? ORDER BY last_seq DESC LIMIT 41`, ...args, cursor ?? Number.MAX_SAFE_INTEGER);
|
|
191
198
|
const visible = rows.slice(0, 40);
|
|
@@ -203,8 +210,8 @@ export class Archive {
|
|
|
203
210
|
preview: (params.get("full") === "true"
|
|
204
211
|
? text(row, "text")
|
|
205
212
|
: (summary?.text ?? text(row, "text"))).slice(0, 600),
|
|
206
|
-
createdAt:
|
|
207
|
-
lastActivity:
|
|
213
|
+
createdAt: timestamp(row, "created_at"),
|
|
214
|
+
lastActivity: timestamp(row, "last_activity"),
|
|
208
215
|
replies: count(row, "replies"),
|
|
209
216
|
};
|
|
210
217
|
}),
|
package/dist/viewer/web/posts.js
CHANGED
|
@@ -51,7 +51,6 @@ export function renderPost(post, root, summary = false) {
|
|
|
51
51
|
const header = node("header", "post-header");
|
|
52
52
|
const time = node("time", "", date(post.createdAt));
|
|
53
53
|
time.dateTime = post.createdAt;
|
|
54
|
-
time.title = post.createdAt;
|
|
55
54
|
header.append(
|
|
56
55
|
summary ? node("strong", "", "Summary") : author(post.author),
|
|
57
56
|
time,
|
package/index.ts
CHANGED
|
@@ -1,72 +1,8 @@
|
|
|
1
1
|
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
2
|
-
import {
|
|
3
|
-
import {
|
|
4
|
-
import { openBoardSettings } from "./src/settings/panel.js";
|
|
5
|
-
import { openBoardViewer } from "./src/viewer/index.js";
|
|
2
|
+
import { createBoardFeature } from "./src/board/feature.js";
|
|
3
|
+
import { registerCommunicationGuidance } from "./src/guidance.js";
|
|
6
4
|
|
|
7
|
-
export default async function
|
|
8
|
-
const board = await
|
|
9
|
-
pi
|
|
10
|
-
description:
|
|
11
|
-
"Board viewer; settings, status, on|off [session|folder|global]",
|
|
12
|
-
getArgumentCompletions(prefix) {
|
|
13
|
-
const commands = ["settings", "status", "on", "off"];
|
|
14
|
-
const scopes = ["session", "folder", "global"];
|
|
15
|
-
const options = prefix.includes(" ")
|
|
16
|
-
? ["on", "off"].flatMap((command) =>
|
|
17
|
-
scopes.map((scope) => `${command} ${scope}`),
|
|
18
|
-
)
|
|
19
|
-
: commands;
|
|
20
|
-
return options
|
|
21
|
-
.filter((value) => value.startsWith(prefix))
|
|
22
|
-
.map((value) => ({ label: value, value }));
|
|
23
|
-
},
|
|
24
|
-
async handler(args, ctx) {
|
|
25
|
-
if (args.trim() === "settings") return openBoardSettings(pi, ctx, board);
|
|
26
|
-
const [command = "", scope = "session", ...extra] = args
|
|
27
|
-
.trim()
|
|
28
|
-
.split(/\s+/);
|
|
29
|
-
if (
|
|
30
|
-
(command === "on" || command === "off") &&
|
|
31
|
-
(scope === "session" || scope === "folder" || scope === "global") &&
|
|
32
|
-
!extra.length
|
|
33
|
-
) {
|
|
34
|
-
try {
|
|
35
|
-
await board.setSetting(ctx, scope, command === "on");
|
|
36
|
-
ctx.ui.notify(board.status(ctx), "info");
|
|
37
|
-
} catch (error) {
|
|
38
|
-
ctx.ui.notify(
|
|
39
|
-
error instanceof Error ? error.message : String(error),
|
|
40
|
-
"error",
|
|
41
|
-
);
|
|
42
|
-
}
|
|
43
|
-
return;
|
|
44
|
-
}
|
|
45
|
-
if (args.trim() === "status") {
|
|
46
|
-
ctx.ui.notify(board.status(ctx), "info");
|
|
47
|
-
return;
|
|
48
|
-
}
|
|
49
|
-
if (command) {
|
|
50
|
-
ctx.ui.notify(
|
|
51
|
-
"Use /board, /board settings, /board status or /board on|off [session|folder|global]",
|
|
52
|
-
"warning",
|
|
53
|
-
);
|
|
54
|
-
return;
|
|
55
|
-
}
|
|
56
|
-
await openBoardViewer(pi, ctx, (context, sessionName) => {
|
|
57
|
-
const own = binding(context);
|
|
58
|
-
if (own.upstream)
|
|
59
|
-
throw new Error(
|
|
60
|
-
"Open /board in the owning root session to view this shared board",
|
|
61
|
-
);
|
|
62
|
-
return {
|
|
63
|
-
sessionId: own.sessionId,
|
|
64
|
-
sessionName: sessionName ?? null,
|
|
65
|
-
boardId: own.boardId,
|
|
66
|
-
folder: own.ownerFolder,
|
|
67
|
-
databasePath: own.databasePath,
|
|
68
|
-
};
|
|
69
|
-
});
|
|
70
|
-
},
|
|
71
|
-
});
|
|
5
|
+
export default async function agentBoard(pi: ExtensionAPI): Promise<void> {
|
|
6
|
+
const board = await createBoardFeature(pi);
|
|
7
|
+
registerCommunicationGuidance(pi, undefined, board);
|
|
72
8
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@howaboua/pi-agent-board",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.7",
|
|
4
4
|
"description": "Standalone agent message boards and a read-only browser viewer for Pi",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
@@ -12,18 +12,21 @@
|
|
|
12
12
|
"files": [
|
|
13
13
|
"index.ts",
|
|
14
14
|
"src",
|
|
15
|
-
"dist",
|
|
16
15
|
"README.md",
|
|
17
|
-
"
|
|
16
|
+
"CHANGELOG.md",
|
|
18
17
|
"LICENSE",
|
|
19
18
|
"tsconfig.json",
|
|
20
|
-
"
|
|
19
|
+
"runtime.ts",
|
|
20
|
+
"dist",
|
|
21
|
+
"INTEGRATION.md",
|
|
22
|
+
"scripts",
|
|
23
|
+
"tsconfig.viewer.json"
|
|
21
24
|
],
|
|
22
25
|
"main": "index.ts",
|
|
23
26
|
"exports": {
|
|
24
27
|
".": "./index.ts",
|
|
25
|
-
"./runtime": "./
|
|
26
|
-
"./integration": "./src/integration.ts"
|
|
28
|
+
"./runtime": "./runtime.ts",
|
|
29
|
+
"./integration": "./src/board/integration.ts"
|
|
27
30
|
},
|
|
28
31
|
"pi": {
|
|
29
32
|
"extensions": [
|
|
@@ -31,7 +34,7 @@
|
|
|
31
34
|
]
|
|
32
35
|
},
|
|
33
36
|
"engines": {
|
|
34
|
-
"node": ">=22.
|
|
37
|
+
"node": ">=22.19.0"
|
|
35
38
|
},
|
|
36
39
|
"scripts": {
|
|
37
40
|
"build": "node scripts/build-viewer.mjs",
|
|
@@ -42,16 +45,16 @@
|
|
|
42
45
|
"pack:dry": "npm pack --dry-run"
|
|
43
46
|
},
|
|
44
47
|
"dependencies": {
|
|
48
|
+
"@earendil-works/pi-schema": "1.5.2",
|
|
45
49
|
"dompurify": "3.4.17",
|
|
46
|
-
"marked": "18.
|
|
50
|
+
"marked": "18.2.0",
|
|
47
51
|
"unicode-case-folding": "1.1.2"
|
|
48
52
|
},
|
|
49
53
|
"peerDependencies": {
|
|
50
54
|
"@earendil-works/pi-ai": ">=1.1.0",
|
|
51
55
|
"@earendil-works/pi-coding-agent": ">=1.5.0",
|
|
52
56
|
"@earendil-works/pi-tui": ">=1.1.0",
|
|
53
|
-
"@howaboua/pi-codex-conversion": ">=
|
|
54
|
-
"typebox": "*"
|
|
57
|
+
"@howaboua/pi-codex-conversion": ">=5.0.0"
|
|
55
58
|
},
|
|
56
59
|
"peerDependenciesMeta": {
|
|
57
60
|
"@howaboua/pi-codex-conversion": {
|
|
@@ -62,6 +65,6 @@
|
|
|
62
65
|
"access": "public"
|
|
63
66
|
},
|
|
64
67
|
"devDependencies": {
|
|
65
|
-
"@howaboua/pi-codex-conversion": "
|
|
68
|
+
"@howaboua/pi-codex-conversion": "5.0.0"
|
|
66
69
|
}
|
|
67
70
|
}
|
package/runtime.ts
ADDED
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { spawnSync } from "node:child_process";
|
|
2
|
+
import { cpSync, rmSync } from "node:fs";
|
|
3
|
+
|
|
4
|
+
rmSync("dist", { recursive: true, force: true });
|
|
5
|
+
const result = spawnSync("tsc", ["-p", "tsconfig.viewer.json"], {
|
|
6
|
+
stdio: "inherit",
|
|
7
|
+
});
|
|
8
|
+
if (result.status !== 0) process.exit(result.status ?? 1);
|
|
9
|
+
cpSync("src/board/viewer/web", "dist/viewer/web", { recursive: true });
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
- Only an explicitly loaded Agent Comms or standalone Board extension activates Board. Discovery never imports the engine; disabled sessions keep binding/settings routes and reconcile inherited enablement before preparation. Preserve native replay of saved briefings without starting the engine. Settings and viewer reads must not activate it.
|
|
2
|
+
- Schema-v1 archives and `shepherdr-board-*` session records are compatibility contracts. Preserve their paths and identities across takeover; do not create a replacement archive.
|
|
3
|
+
- Post sequence owns chronology and continuation. Minute timestamps may tie or coexist with legacy precision; never order posts or advance cursors by timestamp text.
|
|
4
|
+
- Native session IDs own public agent references; saved legacy names are archive aliases, never membership grants. Keep parent-session associations when adopting members: flat references cannot authorize descendants or route notices by prefix.
|
|
5
|
+
- Status and its comment share the post transaction and invocation ID. New replies require open status, checked in that transaction after invocation replay. Replaying a status call must not reapply it over a later status; read-only legacy archives default to open without creating tables.
|
|
6
|
+
- Summaries are derived snapshots, not posts. Status changes discard them in the same transaction; a late save must match the closed status comment and covered latest post. Tool and viewer searches replace summarized posts by default; only `full` searches originals. Legacy reads never create summary tables.
|
|
7
|
+
- Start summarization only after a fresh committed status notice, never an invocation replay. Its system prompt owns instructions; source payload owns channel/status and chronological author/timestamp/text with the closing comment marked, not IDs or session context. Keep requests tool-free and cancel them with the owning session or board.
|
|
8
|
+
- Summaries default off. Validate the preference inside the caught background job so invalid summary settings cannot turn a committed status change into a tool failure.
|
|
9
|
+
- runtime/owner.ts validates owner requests and commits archives before summaries or best-effort notices. coordinator.ts owns settings, refresh and cancellation; routing.ts owns adapter/envelope routing, with binding changes awaiting coordinator refresh. turns.ts alone owns session-scoped turn capabilities. Do not copy their mutable state into the owner executor.
|
|
10
|
+
- Fleet discovery, spawning and SSH stay in host adapters. The viewer only receives a resolved source and opens it read-only; viewing must never initialize a board.
|
|
11
|
+
- Keep viewer startup lazy and packaged assets local. Do not modify a running user's viewer or listener configuration during validation.
|
|
12
|
+
- Viewer browser modules must remain in the server's explicit asset allowlist; the build copies web/ recursively. session.js owns shared selection/queue state; render, navigation and updates must not create parallel snapshots or bypass the queue.
|
|
@@ -7,9 +7,9 @@ import { boardBriefing } from "./briefing.js";
|
|
|
7
7
|
import {
|
|
8
8
|
contextBriefingWindow,
|
|
9
9
|
recordContextBriefing,
|
|
10
|
-
registerContextBriefing,
|
|
11
10
|
} from "./context-briefing.js";
|
|
12
11
|
import { binding } from "./identity.js";
|
|
12
|
+
import type { BoardAdapter } from "./integration.js";
|
|
13
13
|
|
|
14
14
|
const OWNER = "shepherdr-board";
|
|
15
15
|
const STATE = "shepherdr-board-awareness";
|
|
@@ -28,11 +28,12 @@ export class BoardAwareness {
|
|
|
28
28
|
error?: unknown,
|
|
29
29
|
) => void;
|
|
30
30
|
private readonly gpt: () => boolean;
|
|
31
|
+
private readonly privateBriefing: () => BoardAdapter["briefing"];
|
|
31
32
|
constructor(
|
|
32
33
|
pi: ExtensionAPI,
|
|
33
34
|
read: (ctx: ExtensionContext) => Promise<unknown>,
|
|
34
35
|
availability: (ctx: ExtensionContext, error?: unknown) => void,
|
|
35
|
-
privateBriefing: () =>
|
|
36
|
+
privateBriefing: () => BoardAdapter["briefing"],
|
|
36
37
|
gpt: () => boolean = () => false,
|
|
37
38
|
) {
|
|
38
39
|
this.pi = pi;
|
|
@@ -40,14 +41,7 @@ export class BoardAwareness {
|
|
|
40
41
|
this.availability = availability;
|
|
41
42
|
this.gpt = gpt;
|
|
42
43
|
this.privateBriefing = privateBriefing;
|
|
43
|
-
registerContextBriefing(
|
|
44
|
-
pi,
|
|
45
|
-
"board",
|
|
46
|
-
(ctx) => binding(ctx).enabled,
|
|
47
|
-
(ctx, windowId) => this.record(ctx, windowId),
|
|
48
|
-
);
|
|
49
44
|
}
|
|
50
|
-
private readonly privateBriefing: () => typeof boardBriefing | undefined;
|
|
51
45
|
|
|
52
46
|
refresh(ctx: ExtensionContext): AwarenessState {
|
|
53
47
|
const own = binding(ctx);
|
|
@@ -129,7 +123,7 @@ export class BoardAwareness {
|
|
|
129
123
|
);
|
|
130
124
|
}
|
|
131
125
|
|
|
132
|
-
|
|
126
|
+
async record(ctx: ExtensionContext, windowId?: string) {
|
|
133
127
|
const own = binding(ctx);
|
|
134
128
|
const state = this.refresh(ctx);
|
|
135
129
|
if (!own.enabled) return;
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
export function boardBriefing(
|
|
2
|
+
member: boolean,
|
|
3
|
+
population: "empty" | "populated" | "unavailable",
|
|
4
|
+
gpt = false,
|
|
5
|
+
) {
|
|
6
|
+
const state =
|
|
7
|
+
population === "populated"
|
|
8
|
+
? "Read relevant board threads."
|
|
9
|
+
: population === "empty"
|
|
10
|
+
? gpt
|
|
11
|
+
? "Shared board available; posts=none."
|
|
12
|
+
: "Shared board available; no posts yet."
|
|
13
|
+
: gpt
|
|
14
|
+
? "Shared board status unavailable; board help→retry read when available."
|
|
15
|
+
: "Shared board status unavailable. Check board help and retry reading when available.";
|
|
16
|
+
return [
|
|
17
|
+
state,
|
|
18
|
+
member ? "Follow your assigned scope." : "",
|
|
19
|
+
gpt
|
|
20
|
+
? "Channels=workstreams; threads=focused topics, not catch-alls. Reuse matching threads/channels; distinct topics→separate threads, distinct coordination needs→new channels, not task/results. Read≠subscribe; threads→replies, channels→new threads."
|
|
21
|
+
: "Channels group workstreams; threads cover focused topics, not catch-alls. Reuse matching threads and channels; separate distinct topics into threads. Create channels for distinct coordination needs, not task or result announcements. Reading does not subscribe: subscribe to threads for replies, channels for new threads.",
|
|
22
|
+
]
|
|
23
|
+
.filter(Boolean)
|
|
24
|
+
.join(" ");
|
|
25
|
+
}
|
|
@@ -1,9 +1,14 @@
|
|
|
1
|
-
import {
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
1
|
+
import {
|
|
2
|
+
arr,
|
|
3
|
+
bool,
|
|
4
|
+
compile,
|
|
5
|
+
int,
|
|
6
|
+
obj,
|
|
7
|
+
oneOf,
|
|
8
|
+
opt,
|
|
9
|
+
type Static,
|
|
10
|
+
str,
|
|
11
|
+
} from "@earendil-works/pi-schema";
|
|
7
12
|
|
|
8
13
|
const BOARD_ACTIONS = [
|
|
9
14
|
"help",
|
|
@@ -21,22 +26,23 @@ const BOARD_ACTIONS = [
|
|
|
21
26
|
] as const;
|
|
22
27
|
const THREAD_STATUSES = ["open", "completed", "abandoned"] as const;
|
|
23
28
|
export type ThreadStatus = (typeof THREAD_STATUSES)[number];
|
|
24
|
-
export const BoardParameters =
|
|
25
|
-
|
|
26
|
-
})
|
|
27
|
-
|
|
28
|
-
|
|
29
|
+
export const BoardParameters = obj(
|
|
30
|
+
{
|
|
31
|
+
action: opt({ ...oneOf(BOARD_ACTIONS), type: "string" }),
|
|
32
|
+
},
|
|
33
|
+
{ open: true },
|
|
29
34
|
);
|
|
30
|
-
const
|
|
31
|
-
const
|
|
35
|
+
const positive = opt(int({ minimum: 1, maximum: 0xffffffff }));
|
|
36
|
+
const string = opt(str());
|
|
37
|
+
const Request = obj(
|
|
32
38
|
{
|
|
33
|
-
action:
|
|
39
|
+
action: { ...oneOf(BOARD_ACTIONS), type: "string" },
|
|
34
40
|
channel_name: string,
|
|
35
41
|
new_channel_name: string,
|
|
36
42
|
thread_id: string,
|
|
37
43
|
message_id: string,
|
|
38
44
|
text: string,
|
|
39
|
-
status:
|
|
45
|
+
status: opt({ ...oneOf(THREAD_STATUSES), type: "string" }),
|
|
40
46
|
comment: string,
|
|
41
47
|
query: string,
|
|
42
48
|
author: string,
|
|
@@ -44,21 +50,17 @@ const Request = Type.Object(
|
|
|
44
50
|
after_message_id: string,
|
|
45
51
|
board_id: string,
|
|
46
52
|
cursor: string,
|
|
47
|
-
full:
|
|
48
|
-
subscribe:
|
|
49
|
-
recent_first:
|
|
50
|
-
sort:
|
|
53
|
+
full: opt(bool()),
|
|
54
|
+
subscribe: opt(bool()),
|
|
55
|
+
recent_first: opt(bool()),
|
|
56
|
+
sort: opt({ ...oneOf(["created", "activity"]), type: "string" }),
|
|
51
57
|
limit: positive,
|
|
52
58
|
max_chars_per_post: positive,
|
|
53
59
|
limit_chars: positive,
|
|
54
|
-
offset_chars:
|
|
55
|
-
|
|
56
|
-
),
|
|
57
|
-
agents_to_notify: Type.Optional(
|
|
58
|
-
Type.Array(Type.String(), { maxItems: 256 }),
|
|
59
|
-
),
|
|
60
|
+
offset_chars: opt(int({ minimum: 0, maximum: 0xffffffff })),
|
|
61
|
+
agents_to_notify: opt(arr(str(), { maxItems: 256 })),
|
|
60
62
|
},
|
|
61
|
-
{
|
|
63
|
+
{ open: false },
|
|
62
64
|
);
|
|
63
65
|
export type BoardParams = Static<typeof Request>;
|
|
64
66
|
export type BoardAction = BoardParams["action"];
|
|
@@ -115,6 +117,8 @@ const requiredFields: Partial<Record<BoardAction, string[]>> = {
|
|
|
115
117
|
read_thread: ["thread_id"],
|
|
116
118
|
read_post: ["message_id"],
|
|
117
119
|
};
|
|
120
|
+
const requestValidator = compile(Request);
|
|
121
|
+
|
|
118
122
|
export function parseBoardRequest(value: unknown): BoardParams {
|
|
119
123
|
if (
|
|
120
124
|
value === undefined ||
|
|
@@ -124,7 +128,7 @@ export function parseBoardRequest(value: unknown): BoardParams {
|
|
|
124
128
|
Object.keys(value).length === 0)
|
|
125
129
|
)
|
|
126
130
|
return { action: "help" };
|
|
127
|
-
if (!
|
|
131
|
+
if (!requestValidator.check(value))
|
|
128
132
|
throw new Error("Invalid board request; call board help");
|
|
129
133
|
const request = { ...(value as BoardParams) };
|
|
130
134
|
const allowed = new Set(["action", ...fields[request.action]]);
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
import type {
|
|
2
|
+
ExtensionAPI,
|
|
3
|
+
ExtensionContext,
|
|
4
|
+
} from "@earendil-works/pi-coding-agent";
|
|
5
|
+
import type { CommsFeature } from "../guidance.js";
|
|
6
|
+
import type { OpenSettings } from "../settings-navigation.js";
|
|
7
|
+
import { binding } from "./identity.js";
|
|
8
|
+
import { acquireBoard } from "./runtime/index.js";
|
|
9
|
+
|
|
10
|
+
export async function createBoardFeature(
|
|
11
|
+
pi: ExtensionAPI,
|
|
12
|
+
openSettings?: OpenSettings,
|
|
13
|
+
): Promise<CommsFeature> {
|
|
14
|
+
const board = await acquireBoard(pi);
|
|
15
|
+
const open = async (ctx: ExtensionContext) => {
|
|
16
|
+
const { openBoardSettings } = await import("./settings/panel.js");
|
|
17
|
+
return openBoardSettings(pi, ctx, board, Boolean(openSettings));
|
|
18
|
+
};
|
|
19
|
+
pi.registerCommand("board", {
|
|
20
|
+
description: `${openSettings ? "Board settings" : "Board viewer; settings"}; status, on|off [session|folder|global]`,
|
|
21
|
+
getArgumentCompletions(prefix) {
|
|
22
|
+
const commands = ["settings", "status", "on", "off"];
|
|
23
|
+
const scopes = ["session", "folder", "global"];
|
|
24
|
+
const options = prefix.includes(" ")
|
|
25
|
+
? ["on", "off"].flatMap((command) =>
|
|
26
|
+
scopes.map((scope) => `${command} ${scope}`),
|
|
27
|
+
)
|
|
28
|
+
: commands;
|
|
29
|
+
return options
|
|
30
|
+
.filter((value) => value.startsWith(prefix))
|
|
31
|
+
.map((value) => ({ label: value, value }));
|
|
32
|
+
},
|
|
33
|
+
async handler(args, ctx) {
|
|
34
|
+
if (args.trim() === "settings" || (!args.trim() && openSettings)) {
|
|
35
|
+
if (openSettings) return openSettings(ctx, "board");
|
|
36
|
+
await open(ctx);
|
|
37
|
+
return;
|
|
38
|
+
}
|
|
39
|
+
const [command = "", scope = "session", ...extra] = args
|
|
40
|
+
.trim()
|
|
41
|
+
.split(/\s+/);
|
|
42
|
+
if (
|
|
43
|
+
(command === "on" || command === "off") &&
|
|
44
|
+
(scope === "session" || scope === "folder" || scope === "global") &&
|
|
45
|
+
!extra.length
|
|
46
|
+
) {
|
|
47
|
+
try {
|
|
48
|
+
await board.setSetting(ctx, scope, command === "on");
|
|
49
|
+
ctx.ui.notify(board.status(ctx), "info");
|
|
50
|
+
} catch (error) {
|
|
51
|
+
ctx.ui.notify(
|
|
52
|
+
error instanceof Error ? error.message : String(error),
|
|
53
|
+
"error",
|
|
54
|
+
);
|
|
55
|
+
}
|
|
56
|
+
return;
|
|
57
|
+
}
|
|
58
|
+
if (args.trim() === "status") {
|
|
59
|
+
ctx.ui.notify(board.status(ctx), "info");
|
|
60
|
+
return;
|
|
61
|
+
}
|
|
62
|
+
if (command) {
|
|
63
|
+
ctx.ui.notify(
|
|
64
|
+
"Use /board, /board settings, /board status or /board on|off [session|folder|global]",
|
|
65
|
+
"warning",
|
|
66
|
+
);
|
|
67
|
+
return;
|
|
68
|
+
}
|
|
69
|
+
const { openBoardViewer } = await import("./viewer/index.js");
|
|
70
|
+
await openBoardViewer(pi, ctx, (context, sessionName) => {
|
|
71
|
+
const own = binding(context);
|
|
72
|
+
if (own.upstream)
|
|
73
|
+
throw new Error(
|
|
74
|
+
"Open /board in the owning root session to view this shared board",
|
|
75
|
+
);
|
|
76
|
+
return {
|
|
77
|
+
sessionId: own.sessionId,
|
|
78
|
+
sessionName: sessionName ?? null,
|
|
79
|
+
boardId: own.boardId,
|
|
80
|
+
folder: own.ownerFolder,
|
|
81
|
+
databasePath: own.databasePath,
|
|
82
|
+
};
|
|
83
|
+
});
|
|
84
|
+
},
|
|
85
|
+
});
|
|
86
|
+
return {
|
|
87
|
+
enabled: (ctx) => board.enabled(ctx),
|
|
88
|
+
gptPromptMode: () => board.gptPromptMode,
|
|
89
|
+
openSettings: open,
|
|
90
|
+
};
|
|
91
|
+
}
|