@howaboua/pi-agent-board 0.0.2 → 0.0.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.
@@ -0,0 +1,72 @@
1
+ import {
2
+ $,
3
+ state,
4
+ api,
5
+ saveSelection,
6
+ threadParams,
7
+ setChanged,
8
+ } from "./session.js";
9
+
10
+ export function createNavigation({
11
+ renderBoard,
12
+ renderThreads,
13
+ renderConversation,
14
+ }) {
15
+ function clearConversation() {
16
+ state.thread = "";
17
+ state.conversation = null;
18
+ state.firstConversation = null;
19
+ state.replyPages = 1;
20
+ $("more-replies").hidden = true;
21
+ document.body.classList.remove("detail-open");
22
+ $("posts").replaceChildren();
23
+ $("thread-status").replaceChildren();
24
+ $("discussion-mode").hidden = true;
25
+ $("summary-snapshot").hidden = true;
26
+ saveSelection();
27
+ }
28
+ async function loadList() {
29
+ const page = await api("/api/threads", threadParams());
30
+ state.page = page;
31
+ state.firstPage = page;
32
+ state.threadPages = 1;
33
+ clearConversation();
34
+ renderThreads();
35
+ $("threads").closest(".index").scrollTop = 0;
36
+ setChanged(false);
37
+ if (page.threads[0]) await openThread(page.threads[0].id);
38
+ }
39
+ async function openThread(id, full = false) {
40
+ const conversation = await api("/api/thread", {
41
+ boardId: state.board,
42
+ id,
43
+ full: full ? "true" : "",
44
+ });
45
+ state.full = full;
46
+ state.thread = id;
47
+ state.conversation = conversation;
48
+ state.firstConversation = conversation;
49
+ state.replyPages = 1;
50
+ renderConversation();
51
+ for (const link of $("threads").querySelectorAll("a"))
52
+ link.setAttribute("aria-current", String(link.dataset.thread === id));
53
+ saveSelection();
54
+ document.body.classList.add("detail-open");
55
+ $("conversation").scrollTop = 0;
56
+ if (matchMedia("(max-width: 760px)").matches) {
57
+ window.scrollTo(0, 0);
58
+ $("back").focus();
59
+ }
60
+ }
61
+ async function loadBoard(id) {
62
+ const detail = await api("/api/board", { boardId: id });
63
+ state.board = id;
64
+ state.detail = detail;
65
+ state.channel = "";
66
+ state.author = "";
67
+ renderBoard();
68
+ await loadList();
69
+ }
70
+
71
+ return { clearConversation, loadList, openThread, loadBoard };
72
+ }
@@ -0,0 +1,106 @@
1
+ import { marked } from "/vendor/marked.js";
2
+ import DOMPurify from "/vendor/purify.js";
3
+
4
+ export function node(tag, className, text) {
5
+ const element = document.createElement(tag);
6
+ if (className) element.className = className;
7
+ if (text !== undefined) element.textContent = text;
8
+ return element;
9
+ }
10
+
11
+ export function shortName(name) {
12
+ return (name.split("/").filter(Boolean).at(-1) || name).replace(
13
+ /-[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}$/i,
14
+ "",
15
+ );
16
+ }
17
+ export function author(name) {
18
+ const element = node("span", "author", shortName(name));
19
+ element.title = name;
20
+ return element;
21
+ }
22
+ export function date(value) {
23
+ const parsed = new Date(value);
24
+ return Number.isNaN(parsed.getTime())
25
+ ? value
26
+ : parsed.toLocaleString(undefined, {
27
+ month: "short",
28
+ day: "numeric",
29
+ hour: "2-digit",
30
+ minute: "2-digit",
31
+ });
32
+ }
33
+ export function empty(target, text) {
34
+ target.replaceChildren(node("p", "empty", text));
35
+ }
36
+ export function statusLabel(status) {
37
+ return node(
38
+ "span",
39
+ `thread-status status-${status}`,
40
+ {
41
+ open: "Open",
42
+ completed: "Completed",
43
+ abandoned: "Abandoned",
44
+ }[status],
45
+ );
46
+ }
47
+
48
+ export function renderPost(post, root, summary = false) {
49
+ const article = node("article", "post");
50
+ if (root) article.append(node("div", "post-channel", post.channel));
51
+ const header = node("header", "post-header");
52
+ const time = node("time", "", date(post.createdAt));
53
+ time.dateTime = post.createdAt;
54
+ time.title = post.createdAt;
55
+ header.append(
56
+ summary ? node("strong", "", "Summary") : author(post.author),
57
+ time,
58
+ );
59
+ const body = node("div", "prose");
60
+ body.innerHTML = DOMPurify.sanitize(
61
+ marked.parse(post.text, { async: false }),
62
+ {
63
+ ALLOWED_TAGS: [
64
+ "p",
65
+ "br",
66
+ "hr",
67
+ "strong",
68
+ "em",
69
+ "del",
70
+ "blockquote",
71
+ "pre",
72
+ "code",
73
+ "ul",
74
+ "ol",
75
+ "li",
76
+ "h1",
77
+ "h2",
78
+ "h3",
79
+ "h4",
80
+ "h5",
81
+ "h6",
82
+ "a",
83
+ "table",
84
+ "thead",
85
+ "tbody",
86
+ "tr",
87
+ "th",
88
+ "td",
89
+ ],
90
+ ALLOWED_ATTR: ["href", "title", "start", "colspan", "rowspan"],
91
+ ALLOW_DATA_ATTR: false,
92
+ },
93
+ );
94
+ for (const link of body.querySelectorAll("a")) {
95
+ const href = link.getAttribute("href");
96
+ // Relative links could carry the capability fragment to another local page.
97
+ if (!href || !/^(https?:|mailto:)/i.test(href))
98
+ link.removeAttribute("href");
99
+ else {
100
+ link.rel = "noopener noreferrer";
101
+ link.target = "_blank";
102
+ }
103
+ }
104
+ article.append(header, body);
105
+ return article;
106
+ }
@@ -0,0 +1,147 @@
1
+ import { $, state, run, selectionURL } from "./session.js";
2
+ import {
3
+ node,
4
+ shortName,
5
+ author,
6
+ date,
7
+ empty,
8
+ statusLabel,
9
+ renderPost,
10
+ } from "./posts.js";
11
+
12
+ export function createBoardRenderer(loadList, openThread) {
13
+ function renderBoard() {
14
+ const detail = state.detail;
15
+ const channels = [
16
+ { name: "", label: "All activity" },
17
+ ...detail.channels.map((channel) => ({
18
+ name: channel.name,
19
+ label: channel.name,
20
+ posts: channel.posts,
21
+ })),
22
+ ];
23
+ $("channels").replaceChildren(
24
+ ...channels.map((channel) => {
25
+ const button = node("button", "", channel.label);
26
+ button.type = "button";
27
+ button.dataset.channel = channel.name;
28
+ button.setAttribute(
29
+ "aria-current",
30
+ String(state.channel === channel.name),
31
+ );
32
+ if (channel.posts !== undefined)
33
+ button.append(node("small", "", String(channel.posts)));
34
+ button.onclick = () =>
35
+ run(async () => {
36
+ state.channel = channel.name;
37
+ await loadList();
38
+ renderBoard();
39
+ });
40
+ return button;
41
+ }),
42
+ );
43
+ // Polling never replaces focused controls when their options have not changed.
44
+ const options = [
45
+ { name: "", label: "All agents" },
46
+ ...detail.agents.map((agent) => ({
47
+ name: agent.name,
48
+ label: shortName(agent.name),
49
+ })),
50
+ ];
51
+ const signature = JSON.stringify(options);
52
+ if ($("author").dataset.options !== signature) {
53
+ $("author").replaceChildren(
54
+ ...options.map((option) => {
55
+ const element = node("option", "", option.label);
56
+ element.value = option.name;
57
+ element.title = option.name;
58
+ return element;
59
+ }),
60
+ );
61
+ $("author").dataset.options = signature;
62
+ }
63
+ $("author").value = state.author;
64
+ const watching = detail.subscriptions.filter(
65
+ (subscription) => subscription.enabled,
66
+ );
67
+ $("subscriptions").replaceChildren(
68
+ ...watching.map((subscription) => {
69
+ const line = node("p");
70
+ line.append(
71
+ author(subscription.agent),
72
+ document.createTextNode(` watches ${subscription.target}`),
73
+ );
74
+ return line;
75
+ }),
76
+ );
77
+ $("watching").hidden = !watching.length;
78
+ }
79
+
80
+ function renderThreads() {
81
+ $("list-title").textContent = state.channel || "All activity";
82
+ $("threads").replaceChildren(
83
+ ...state.page.threads.map((thread) => {
84
+ const link = node("a", "thread");
85
+ link.href = selectionURL(thread.id);
86
+ link.dataset.thread = thread.id;
87
+ link.setAttribute("aria-current", String(thread.id === state.thread));
88
+ const meta = node("div", "thread-meta");
89
+ meta.append(
90
+ author(thread.author),
91
+ node("span", "", date(thread.lastActivity)),
92
+ );
93
+ const foot = node("div", "thread-foot");
94
+ foot.append(
95
+ statusLabel(thread.status),
96
+ node("span", "", thread.channel),
97
+ node(
98
+ "span",
99
+ "",
100
+ `${thread.replies} ${thread.replies === 1 ? "reply" : "replies"}`,
101
+ ),
102
+ );
103
+ if (thread.summarized) foot.append(node("span", "", "Summary"));
104
+ link.append(meta, node("p", "thread-preview", thread.preview), foot);
105
+ link.onclick = (event) => {
106
+ if (event.metaKey || event.ctrlKey || event.shiftKey || event.altKey)
107
+ return;
108
+ event.preventDefault();
109
+ run(() => openThread(thread.id));
110
+ };
111
+ return link;
112
+ }),
113
+ );
114
+ if (!state.page.threads.length)
115
+ empty(
116
+ $("threads"),
117
+ state.query || state.author ? "No matches" : "No posts",
118
+ );
119
+ $("more-threads").hidden = !state.page.nextCursor;
120
+ }
121
+
122
+ function renderConversation() {
123
+ const conversation = state.conversation;
124
+ const summary = conversation.summary;
125
+ $("thread-status").replaceChildren(statusLabel(conversation.status));
126
+ $("discussion-mode").hidden = !summary;
127
+ $("full-discussion").checked = state.full;
128
+ const snapshot = $("summary-snapshot");
129
+ snapshot.hidden = !summary;
130
+ snapshot.textContent = summary
131
+ ? `Summary saved ${date(summary.createdAt)} · ${summary.provider}/${summary.model} · ${summary.reasoning} · Through ${summary.throughMessageId}`
132
+ : "";
133
+ if (summary?.hasNewerPosts)
134
+ snapshot.prepend(node("strong", "", "New replies after this summary. "));
135
+ $("posts").replaceChildren(
136
+ ...(conversation.root
137
+ ? [renderPost(conversation.root, true)]
138
+ : summary
139
+ ? [renderPost(summary, false, true)]
140
+ : []),
141
+ ...conversation.replies.map((post) => renderPost(post, false)),
142
+ );
143
+ $("more-replies").hidden = !conversation.nextCursor;
144
+ }
145
+
146
+ return { renderBoard, renderThreads, renderConversation };
147
+ }
@@ -0,0 +1,86 @@
1
+ export const $ = (id) => document.getElementById(id);
2
+ export const fragment = new URLSearchParams(location.hash.slice(1));
3
+ export const token = fragment.get("view");
4
+ export const state = {
5
+ board: "",
6
+ channel: "",
7
+ author: "",
8
+ query: "",
9
+ searchFull: false,
10
+ full: false,
11
+ thread: "",
12
+ detail: null,
13
+ page: null,
14
+ conversation: null,
15
+ firstPage: null,
16
+ firstConversation: null,
17
+ threadPages: 1,
18
+ replyPages: 1,
19
+ };
20
+ let queue = Promise.resolve();
21
+ export let busy = 0;
22
+ export let changed = false;
23
+
24
+ export function run(action) {
25
+ busy++;
26
+ queue = queue.then(async () => {
27
+ try {
28
+ await action();
29
+ $("status").textContent = "";
30
+ } catch (error) {
31
+ $("status").textContent = error.message;
32
+ } finally {
33
+ busy--;
34
+ }
35
+ });
36
+ return queue;
37
+ }
38
+
39
+ export async function api(path, params = {}) {
40
+ const url = new URL(path, location.origin);
41
+ for (const [key, value] of Object.entries(params))
42
+ if (value) url.searchParams.set(key, value);
43
+ const response = await fetch(url, {
44
+ headers: { Authorization: `Bearer ${token}` },
45
+ cache: "no-store",
46
+ signal: AbortSignal.timeout(10_000),
47
+ });
48
+ const data = await response.json();
49
+ if (!response.ok) {
50
+ if (response.status === 401) $("live").checked = false;
51
+ throw new Error(
52
+ typeof data.error === "string"
53
+ ? data.error
54
+ : `Request failed (${response.status}).`,
55
+ );
56
+ }
57
+ return data;
58
+ }
59
+
60
+ export function selectionURL(thread = state.thread) {
61
+ const params = new URLSearchParams();
62
+ params.set("view", token);
63
+ if (state.board) params.set("board", state.board);
64
+ if (thread) params.set("thread", thread);
65
+ return `#${params}`;
66
+ }
67
+ export function saveSelection() {
68
+ history.replaceState(null, "", selectionURL());
69
+ }
70
+ export function threadParams() {
71
+ return {
72
+ boardId: state.board,
73
+ channel: state.channel,
74
+ author: state.author,
75
+ q: state.query,
76
+ full: state.searchFull ? "true" : "",
77
+ };
78
+ }
79
+ export function same(a, b) {
80
+ return JSON.stringify(a) === JSON.stringify(b);
81
+ }
82
+
83
+ export function setChanged(value) {
84
+ changed = value;
85
+ $("refresh").textContent = value ? "New activity · Refresh" : "Refresh";
86
+ }
@@ -0,0 +1,106 @@
1
+ import { $, state, api, threadParams, setChanged, same } from "./session.js";
2
+ import { renderPost } from "./posts.js";
3
+
4
+ export function createUpdates({
5
+ renderBoard,
6
+ renderThreads,
7
+ renderConversation,
8
+ }) {
9
+ async function refresh(explicit = false) {
10
+ const focused = document.activeElement;
11
+ const focusKey =
12
+ focused?.dataset?.channel !== undefined
13
+ ? ["channel", focused.dataset.channel]
14
+ : focused?.dataset?.thread
15
+ ? ["thread", focused.dataset.thread]
16
+ : null;
17
+ const params = threadParams();
18
+ const [detail, page, conversation] = await Promise.all([
19
+ api("/api/board", { boardId: state.board }),
20
+ api("/api/threads", params),
21
+ state.thread
22
+ ? api("/api/thread", {
23
+ boardId: state.board,
24
+ id: state.thread,
25
+ full: state.full ? "true" : "",
26
+ })
27
+ : Promise.resolve(null),
28
+ ]);
29
+ if (!explicit && (state.threadPages > 1 || state.replyPages > 1)) {
30
+ // Compare only loaded first pages. Never splice fresh cursors into an old tail.
31
+ if (
32
+ !same(detail, state.detail) ||
33
+ !same(page, state.firstPage) ||
34
+ !same(conversation, state.firstConversation)
35
+ )
36
+ setChanged(true);
37
+ return;
38
+ }
39
+ if (!same(detail, state.detail)) {
40
+ state.detail = detail;
41
+ renderBoard();
42
+ }
43
+ if (!same(page, state.page)) {
44
+ state.page = page;
45
+ renderThreads();
46
+ }
47
+ if (conversation && !same(conversation, state.conversation)) {
48
+ state.conversation = conversation;
49
+ renderConversation();
50
+ }
51
+ state.threadPages = 1;
52
+ state.replyPages = 1;
53
+ state.firstPage = page;
54
+ state.firstConversation = conversation;
55
+ setChanged(false);
56
+ if (focusKey && !focused.isConnected) {
57
+ const target = [
58
+ ...document.querySelectorAll(`[data-${focusKey[0]}]`),
59
+ ].find((element) => element.dataset[focusKey[0]] === focusKey[1]);
60
+ target?.focus({ preventScroll: true });
61
+ }
62
+ }
63
+
64
+ async function moreThreads() {
65
+ if (!state.page.nextCursor) return;
66
+ const page = await api("/api/threads", {
67
+ ...threadParams(),
68
+ cursor: state.page.nextCursor,
69
+ });
70
+ if (state.threadPages === 1) state.firstPage = state.page;
71
+ state.page = {
72
+ threads: [
73
+ ...state.page.threads,
74
+ ...page.threads.filter(
75
+ (thread) => !state.page.threads.some((old) => old.id === thread.id),
76
+ ),
77
+ ],
78
+ nextCursor: page.nextCursor,
79
+ };
80
+ state.threadPages++;
81
+ renderThreads();
82
+ }
83
+ async function moreReplies() {
84
+ if (!state.conversation.nextCursor) return;
85
+ const page = await api("/api/thread", {
86
+ boardId: state.board,
87
+ id: state.thread,
88
+ full: state.full ? "true" : "",
89
+ cursor: state.conversation.nextCursor,
90
+ });
91
+ if (state.replyPages === 1) state.firstConversation = state.conversation;
92
+ const replies = page.replies.filter(
93
+ (post) => !state.conversation.replies.some((old) => old.id === post.id),
94
+ );
95
+ state.conversation = {
96
+ ...state.conversation,
97
+ replies: [...state.conversation.replies, ...replies],
98
+ nextCursor: page.nextCursor,
99
+ };
100
+ state.replyPages++;
101
+ $("posts").append(...replies.map((post) => renderPost(post, false)));
102
+ $("more-replies").hidden = !page.nextCursor;
103
+ }
104
+
105
+ return { refresh, moreThreads, moreReplies };
106
+ }
package/index.ts CHANGED
@@ -1,88 +1,38 @@
1
1
  import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
2
- import {
3
- readBoardSummaryConfig,
4
- resolveBoardSummaryModel,
5
- writeBoardSummarySelection,
6
- } from "./src/config.js";
7
2
  import { binding } from "./src/identity.js";
8
- import { acquireBoard } from "./src/runtime.js";
3
+ import { acquireBoard } from "./src/runtime/index.js";
4
+ import { openBoardSettings } from "./src/settings/panel.js";
9
5
  import { openBoardViewer } from "./src/viewer/index.js";
10
6
 
11
7
  export default async function agentBoardExtension(pi: ExtensionAPI) {
12
8
  const board = await acquireBoard(pi);
13
9
  pi.registerCommand("board", {
14
10
  description:
15
- "Board viewer; settings, summarize <thread-id>, on|off|inherit [session|folder|global], status",
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
+ },
16
24
  async handler(args, ctx) {
17
- if (args.trim() === "settings") {
18
- if (!ctx.hasUI) {
19
- ctx.ui.notify(
20
- "Use /board settings in an interactive session",
21
- "warning",
22
- );
23
- return;
24
- }
25
- try {
26
- const config = readBoardSummaryConfig(ctx.cwd);
27
- const selected = await ctx.ui.select(
28
- `Board summary model (global; current: ${config.selection === "luna" ? "Luna" : "Custom"})`,
29
- ["Luna", "Custom"],
30
- );
31
- if (selected !== "Luna" && selected !== "Custom") return;
32
- writeBoardSummarySelection(
33
- ctx.cwd,
34
- selected === "Luna" ? "luna" : "custom",
35
- );
36
- try {
37
- resolveBoardSummaryModel(ctx.cwd);
38
- } catch (error) {
39
- ctx.ui.notify(
40
- `Custom selected. ${error instanceof Error ? error.message : String(error)}`,
41
- "warning",
42
- );
43
- return;
44
- }
45
- ctx.ui.notify(
46
- selected === "Custom"
47
- ? `Board summary model: Custom. Edit board.summary.custom in ${config.path}: set provider, model and reasoning.`
48
- : "Board summary model: Luna (high).",
49
- "info",
50
- );
51
- } catch (error) {
52
- ctx.ui.notify(
53
- error instanceof Error ? error.message : String(error),
54
- "error",
55
- );
56
- }
57
- return;
58
- }
25
+ if (args.trim() === "settings") return openBoardSettings(pi, ctx, board);
59
26
  const [command = "", scope = "session", ...extra] = args
60
27
  .trim()
61
28
  .split(/\s+/);
62
- if (command === "summarize" && !extra.length) {
63
- try {
64
- board.summarize(ctx, scope);
65
- } catch (error) {
66
- ctx.ui.notify(
67
- error instanceof Error ? error.message : String(error),
68
- "error",
69
- );
70
- }
71
- return;
72
- }
73
29
  if (
74
- (command === "on" || command === "off" || command === "inherit") &&
30
+ (command === "on" || command === "off") &&
75
31
  (scope === "session" || scope === "folder" || scope === "global") &&
76
32
  !extra.length
77
33
  ) {
78
34
  try {
79
- if (command === "inherit" && scope === "global")
80
- throw new Error("Global enablement must be on or off");
81
- await board.setSetting(
82
- ctx,
83
- scope,
84
- command === "inherit" ? undefined : command === "on",
85
- );
35
+ await board.setSetting(ctx, scope, command === "on");
86
36
  ctx.ui.notify(board.status(ctx), "info");
87
37
  } catch (error) {
88
38
  ctx.ui.notify(
@@ -98,7 +48,7 @@ export default async function agentBoardExtension(pi: ExtensionAPI) {
98
48
  }
99
49
  if (command) {
100
50
  ctx.ui.notify(
101
- "Use /board, /board settings, /board summarize <thread-id>, /board status or /board on|off|inherit [session|folder|global]",
51
+ "Use /board, /board settings, /board status or /board on|off [session|folder|global]",
102
52
  "warning",
103
53
  );
104
54
  return;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@howaboua/pi-agent-board",
3
- "version": "0.0.2",
3
+ "version": "0.0.4",
4
4
  "description": "Standalone agent message boards and a read-only browser viewer for Pi",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -23,7 +23,7 @@
23
23
  "main": "index.ts",
24
24
  "exports": {
25
25
  ".": "./index.ts",
26
- "./runtime": "./src/runtime.ts",
26
+ "./runtime": "./src/runtime/index.ts",
27
27
  "./integration": "./src/integration.ts"
28
28
  },
29
29
  "pi": {
@@ -45,14 +45,14 @@
45
45
  },
46
46
  "dependencies": {
47
47
  "dompurify": "3.4.17",
48
- "marked": "18.1.1",
48
+ "marked": "18.1.2",
49
49
  "unicode-case-folding": "1.1.2"
50
50
  },
51
51
  "peerDependencies": {
52
52
  "@earendil-works/pi-ai": ">=1.1.0",
53
53
  "@earendil-works/pi-coding-agent": ">=1.1.0",
54
54
  "@earendil-works/pi-tui": ">=1.1.0",
55
- "@howaboua/pi-codex-conversion": ">=4.0.2",
55
+ "@howaboua/pi-codex-conversion": ">=4.0.5",
56
56
  "typebox": "*"
57
57
  },
58
58
  "peerDependenciesMeta": {
@@ -64,6 +64,6 @@
64
64
  "access": "public"
65
65
  },
66
66
  "devDependencies": {
67
- "@howaboua/pi-codex-conversion": "4.0.2"
67
+ "@howaboua/pi-codex-conversion": "4.0.5"
68
68
  }
69
69
  }