@howaboua/pi-agent-comms 0.0.0-stage → 0.0.1-dev.14.1.g7d1d3da173aa
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/INTEGRATION.md +31 -0
- package/LICENSE +21 -0
- package/PCC-INTEGRATION.md +17 -0
- package/README.md +53 -2
- package/dist/viewer/archive.js +249 -0
- package/dist/viewer/config.js +85 -0
- package/dist/viewer/contracts.js +1 -0
- package/dist/viewer/server.js +177 -0
- package/dist/viewer/source.js +29 -0
- package/dist/viewer/web/app.js +88 -0
- package/dist/viewer/web/index.html +41 -0
- package/dist/viewer/web/navigation.js +72 -0
- package/dist/viewer/web/posts.js +105 -0
- package/dist/viewer/web/render.js +147 -0
- package/dist/viewer/web/session.js +86 -0
- package/dist/viewer/web/style.css +517 -0
- package/dist/viewer/web/updates.js +106 -0
- package/docs/BOARD-CHANGELOG.md +49 -0
- package/docs/BOARD.md +124 -0
- package/docs/NOTES-CHANGELOG.md +127 -0
- package/docs/NOTES.md +122 -0
- package/index.ts +21 -0
- package/package.json +75 -5
- package/src/board/AGENTS.md +12 -0
- package/src/board/activity.ts +274 -0
- package/src/board/archive.ts +118 -0
- package/src/board/awareness.ts +179 -0
- package/src/board/briefing.ts +25 -0
- package/src/board/config.ts +192 -0
- package/src/board/consolidation.ts +32 -0
- package/src/board/context-briefing.ts +245 -0
- package/src/board/contract.ts +254 -0
- package/src/board/delivery.ts +85 -0
- package/src/board/feature.ts +91 -0
- package/src/board/identity.ts +238 -0
- package/src/board/integration.ts +55 -0
- package/src/board/paging.ts +54 -0
- package/src/board/protocol.ts +78 -0
- package/src/board/queries.ts +168 -0
- package/src/board/response.ts +82 -0
- package/src/board/runtime/activation.ts +50 -0
- package/src/board/runtime/catchup.ts +96 -0
- package/src/board/runtime/coordinator.ts +311 -0
- package/src/board/runtime/engine.ts +40 -0
- package/src/board/runtime/index.ts +63 -0
- package/src/board/runtime/owner.ts +168 -0
- package/src/board/runtime/routing.ts +152 -0
- package/src/board/runtime/turns.ts +109 -0
- package/src/board/search.ts +95 -0
- package/src/board/settings/panel.ts +193 -0
- package/src/board/store.ts +427 -0
- package/src/board/summaries.ts +124 -0
- package/src/board/summarizer.ts +201 -0
- package/src/board/tool.ts +27 -0
- package/src/board/viewer/AGENTS.md +1 -0
- package/src/board/viewer/archive.ts +308 -0
- package/src/board/viewer/config.ts +111 -0
- package/src/board/viewer/contracts.ts +98 -0
- package/src/board/viewer/index.ts +162 -0
- package/src/board/viewer/server.ts +204 -0
- package/src/board/viewer/source.ts +33 -0
- package/src/board/viewer/web/app.js +88 -0
- package/src/board/viewer/web/index.html +41 -0
- package/src/board/viewer/web/navigation.js +72 -0
- package/src/board/viewer/web/posts.js +105 -0
- package/src/board/viewer/web/render.js +147 -0
- package/src/board/viewer/web/session.js +86 -0
- package/src/board/viewer/web/style.css +517 -0
- package/src/board/viewer/web/updates.js +106 -0
- package/src/guidance.ts +121 -0
- package/src/notes/AGENTS.md +27 -0
- package/src/notes/activation.ts +150 -0
- package/src/notes/agent-identity.ts +221 -0
- package/src/notes/attachment-sharing.ts +165 -0
- package/src/notes/attachment-snapshot.ts +113 -0
- package/src/notes/binding-startup.ts +30 -0
- package/src/notes/bridge.ts +130 -0
- package/src/notes/compaction-projection.ts +88 -0
- package/src/notes/context-owner.ts +99 -0
- package/src/notes/context-sharing.ts +178 -0
- package/src/notes/extension-hooks.ts +200 -0
- package/src/notes/extension-sharing.ts +133 -0
- package/src/notes/feature.ts +168 -0
- package/src/notes/fresh-checkpoint.ts +143 -0
- package/src/notes/fresh-notes.ts +323 -0
- package/src/notes/history-search-protocol.ts +39 -0
- package/src/notes/history-search-pruning.mjs +120 -0
- package/src/notes/history-search-worker.mjs +258 -0
- package/src/notes/history-search.ts +269 -0
- package/src/notes/history-windows.ts +221 -0
- package/src/notes/history.ts +158 -0
- package/src/notes/idle-admission.ts +201 -0
- package/src/notes/index.ts +125 -0
- package/src/notes/integrations.ts +174 -0
- package/src/notes/lifecycle.ts +308 -0
- package/src/notes/model-role-config.ts +79 -0
- package/src/notes/model-role-screen.ts +74 -0
- package/src/notes/model-roles.ts +225 -0
- package/src/notes/note-query.ts +148 -0
- package/src/notes/note-result.ts +88 -0
- package/src/notes/note-save-marker.ts +128 -0
- package/src/notes/notes-lookup.ts +115 -0
- package/src/notes/notes.ts +302 -0
- package/src/notes/query-executor.ts +242 -0
- package/src/notes/query-input.ts +126 -0
- package/src/notes/remote.ts +376 -0
- package/src/notes/rollover.ts +224 -0
- package/src/notes/saved-session-access.ts +117 -0
- package/src/notes/saved-session-index.mjs +83 -0
- package/src/notes/saved-session.mjs +241 -0
- package/src/notes/saved-session.ts +51 -0
- package/src/notes/saved-sharing-records.ts +135 -0
- package/src/notes/session-pruning-content.ts +237 -0
- package/src/notes/session-pruning-plan.ts +243 -0
- package/src/notes/session-pruning-policy.ts +20 -0
- package/src/notes/session-pruning-screen.ts +204 -0
- package/src/notes/session-pruning-source.ts +44 -0
- package/src/notes/session-pruning-transaction.ts +141 -0
- package/src/notes/session-pruning.ts +155 -0
- package/src/notes/settings-command.ts +95 -0
- package/src/notes/settings-controls.ts +199 -0
- package/src/notes/settings-screen.ts +113 -0
- package/src/notes/settings.ts +287 -0
- package/src/notes/shared-notes.ts +411 -0
- package/src/notes/shared-session-reader.ts +143 -0
- package/src/notes/sharing-service.ts +282 -0
- package/src/notes/sqlite.mjs +33 -0
- package/src/notes/store.ts +283 -0
- package/src/notes/task-boundary.ts +37 -0
- package/src/notes/tool-contracts.ts +312 -0
- package/src/notes/tools.ts +148 -0
- package/src/notes/tree-archive-manifest.mjs +27 -0
- package/src/notes/tree-archive.ts +129 -0
- package/src/notes/tree-checkpoint.ts +170 -0
- package/src/notes/tree-handoff-read.ts +192 -0
- package/src/notes/window-checkpoint.ts +105 -0
- package/src/notes/window-message.ts +185 -0
- package/src/notes/windows.ts +272 -0
- package/src/settings-navigation.ts +11 -0
- package/src/timestamps.ts +3 -0
- package/tsconfig.json +9 -0
|
@@ -0,0 +1,105 @@
|
|
|
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
|
+
header.append(
|
|
55
|
+
summary ? node("strong", "", "Summary") : author(post.author),
|
|
56
|
+
time,
|
|
57
|
+
);
|
|
58
|
+
const body = node("div", "prose");
|
|
59
|
+
body.innerHTML = DOMPurify.sanitize(
|
|
60
|
+
marked.parse(post.text, { async: false }),
|
|
61
|
+
{
|
|
62
|
+
ALLOWED_TAGS: [
|
|
63
|
+
"p",
|
|
64
|
+
"br",
|
|
65
|
+
"hr",
|
|
66
|
+
"strong",
|
|
67
|
+
"em",
|
|
68
|
+
"del",
|
|
69
|
+
"blockquote",
|
|
70
|
+
"pre",
|
|
71
|
+
"code",
|
|
72
|
+
"ul",
|
|
73
|
+
"ol",
|
|
74
|
+
"li",
|
|
75
|
+
"h1",
|
|
76
|
+
"h2",
|
|
77
|
+
"h3",
|
|
78
|
+
"h4",
|
|
79
|
+
"h5",
|
|
80
|
+
"h6",
|
|
81
|
+
"a",
|
|
82
|
+
"table",
|
|
83
|
+
"thead",
|
|
84
|
+
"tbody",
|
|
85
|
+
"tr",
|
|
86
|
+
"th",
|
|
87
|
+
"td",
|
|
88
|
+
],
|
|
89
|
+
ALLOWED_ATTR: ["href", "title", "start", "colspan", "rowspan"],
|
|
90
|
+
ALLOW_DATA_ATTR: false,
|
|
91
|
+
},
|
|
92
|
+
);
|
|
93
|
+
for (const link of body.querySelectorAll("a")) {
|
|
94
|
+
const href = link.getAttribute("href");
|
|
95
|
+
// Relative links could carry the capability fragment to another local page.
|
|
96
|
+
if (!href || !/^(https?:|mailto:)/i.test(href))
|
|
97
|
+
link.removeAttribute("href");
|
|
98
|
+
else {
|
|
99
|
+
link.rel = "noopener noreferrer";
|
|
100
|
+
link.target = "_blank";
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
article.append(header, body);
|
|
104
|
+
return article;
|
|
105
|
+
}
|
|
@@ -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
|
+
}
|