@nanocollective/roster 0.1.0-beta.2 → 0.1.0-beta.21

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.
Files changed (99) hide show
  1. package/README.md +8 -0
  2. package/dist/agents-POITEZRI.js +232 -0
  3. package/dist/chunk-FF2WBNNW.js +370 -0
  4. package/dist/chunk-GDAJPOHK.js +562 -0
  5. package/dist/cli.js +3187 -1105
  6. package/dist/compose-5DBEHSEV.js +17 -0
  7. package/dist/connectors-5E5ZMGZV.js +23 -0
  8. package/dist/worker/assets/assets/css/base.css +21 -2
  9. package/dist/worker/assets/assets/css/brain.css +20 -0
  10. package/dist/worker/assets/assets/css/connectors.css +50 -0
  11. package/dist/worker/assets/assets/css/home.css +141 -54
  12. package/dist/worker/assets/assets/css/inbox.css +11 -0
  13. package/dist/worker/assets/assets/css/layout.css +6 -0
  14. package/dist/worker/assets/assets/css/markdown.css +21 -0
  15. package/dist/worker/assets/assets/css/routines.css +40 -0
  16. package/dist/worker/assets/assets/js/api.js +33 -0
  17. package/dist/worker/assets/assets/js/app.js +47 -3
  18. package/dist/worker/assets/assets/js/homesort.js +28 -21
  19. package/dist/worker/assets/assets/js/icons.js +4 -0
  20. package/dist/worker/assets/assets/js/md.js +7 -2
  21. package/dist/worker/assets/assets/js/refcard.js +216 -0
  22. package/dist/worker/assets/assets/js/refresh.js +4 -2
  23. package/dist/worker/assets/assets/js/report.js +51 -0
  24. package/dist/worker/assets/assets/js/state.js +14 -1
  25. package/dist/worker/assets/assets/js/views/connectors.js +290 -0
  26. package/dist/worker/assets/assets/js/views/home.js +368 -152
  27. package/dist/worker/assets/assets/js/views/inbox.js +68 -16
  28. package/dist/worker/assets/assets/js/views/org.js +2 -0
  29. package/dist/worker/assets/assets/js/views/people.js +103 -0
  30. package/dist/worker/assets/assets/js/views/routines.js +378 -0
  31. package/dist/worker/assets/index.html +8 -0
  32. package/dist/worker/index.js +3972 -963
  33. package/docs/README.md +2 -0
  34. package/docs/architecture.md +23 -4
  35. package/docs/commands.md +111 -9
  36. package/docs/concepts.md +2 -1
  37. package/docs/connectors.md +157 -0
  38. package/docs/cost.md +1 -1
  39. package/docs/developing.md +3 -3
  40. package/docs/doctor-codes.md +8 -2
  41. package/docs/export.md +4 -3
  42. package/docs/extending.md +1 -1
  43. package/docs/getting-started.md +19 -2
  44. package/docs/hosting.md +42 -3
  45. package/docs/memory.md +3 -2
  46. package/docs/org-yaml.md +58 -5
  47. package/docs/portal.md +37 -6
  48. package/docs/prompts.md +3 -2
  49. package/docs/routines.md +65 -0
  50. package/docs/security.md +35 -4
  51. package/docs/session-workflow.md +31 -8
  52. package/docs/staff-yaml.md +7 -3
  53. package/docs/troubleshooting.md +1 -1
  54. package/docs/upgrading.md +1 -1
  55. package/docs/writing-a-charter.md +1 -1
  56. package/package.json +2 -1
  57. package/templates/brain/.gitattributes +3 -0
  58. package/templates/brain/.github/workflows/%%STAFF%%-daily.yaml +24 -15
  59. package/templates/brain/.github/workflows/%%STAFF%%-mention.yaml +12 -10
  60. package/templates/brain/CHARTER.md +2 -2
  61. package/templates/brain/STATE.md +16 -0
  62. package/templates/brain/memory/INDEX.md +1 -1
  63. package/templates/brain/staff.yaml +3 -0
  64. package/templates/ops/.gitattributes +3 -0
  65. package/templates/ops/.github/workflows/session.yaml +74 -13
  66. package/templates/ops/agents.mjs +38 -11
  67. package/templates/ops/compose.mjs +60 -2
  68. package/templates/ops/connectors.mjs +722 -0
  69. package/templates/ops/org/operating.md +10 -0
  70. package/templates/ops/org/voice.md +21 -3
  71. package/templates/ops/prompts/_identity.md +20 -0
  72. package/templates/ops/prompts/daily.md +70 -19
  73. package/templates/ops/prompts/mention.md +7 -2
  74. package/templates/ops/status-week.mjs +169 -0
  75. package/templates/portal/css/base.css +21 -2
  76. package/templates/portal/css/brain.css +20 -0
  77. package/templates/portal/css/connectors.css +50 -0
  78. package/templates/portal/css/home.css +141 -54
  79. package/templates/portal/css/inbox.css +11 -0
  80. package/templates/portal/css/layout.css +6 -0
  81. package/templates/portal/css/markdown.css +21 -0
  82. package/templates/portal/css/routines.css +40 -0
  83. package/templates/portal/index.html +8 -0
  84. package/templates/portal/js/api.js +33 -0
  85. package/templates/portal/js/app.js +47 -3
  86. package/templates/portal/js/homesort.js +28 -21
  87. package/templates/portal/js/icons.js +4 -0
  88. package/templates/portal/js/md.js +7 -2
  89. package/templates/portal/js/refcard.js +216 -0
  90. package/templates/portal/js/refresh.js +4 -2
  91. package/templates/portal/js/report.js +51 -0
  92. package/templates/portal/js/state.js +14 -1
  93. package/templates/portal/js/views/connectors.js +290 -0
  94. package/templates/portal/js/views/home.js +368 -152
  95. package/templates/portal/js/views/inbox.js +68 -16
  96. package/templates/portal/js/views/org.js +2 -0
  97. package/templates/portal/js/views/people.js +103 -0
  98. package/templates/portal/js/views/routines.js +378 -0
  99. package/templates/skill/SKILL.md +115 -0
@@ -0,0 +1,290 @@
1
+ /* The Connectors screen: outside services the staff can use in their runs.
2
+ *
3
+ * What is connected, as cards, and what can be, as a grid. Picking one opens a sheet with how
4
+ * to get its key, the key, who gets it, and Save. A key is checked with the service before it is
5
+ * stored, goes to GitHub as a secret, and is never shown again. A service that only signs in
6
+ * (Notion) signs in through the hosted portal instead.
7
+ */
8
+
9
+ import { getConnectors, post } from "../api.js";
10
+ import { sheet } from "../dialog.js";
11
+ import { el } from "../dom.js";
12
+ import { icon } from "../icons.js";
13
+ import { render } from "../router.js";
14
+
15
+ /* The last answer, so a repaint after Save does not flash an empty screen. */
16
+ let last = null;
17
+
18
+ export function viewConnectors(m) {
19
+ m.append(el("h1", { textContent: "Connectors" }));
20
+ const notice = signInNotice();
21
+ if (notice) m.append(notice);
22
+ const body = el("div");
23
+ m.append(body);
24
+ if (last) draw(body, last);
25
+ else body.append(el("p", { className: "sub", textContent: "Loading…" }));
26
+ getConnectors()
27
+ .then((d) => {
28
+ if (d.error) throw new Error(d.error);
29
+ last = d;
30
+ body.replaceChildren();
31
+ draw(body, d);
32
+ })
33
+ .catch((err) => body.replaceChildren(el("p", { className: "err", textContent: String(err.message || err) })));
34
+ }
35
+
36
+ /** A sign-in that came back with a problem says so once, from the URL it came back to. */
37
+ function signInNotice() {
38
+ const q = (location.hash.split("?")[1] ?? "");
39
+ const e = new URLSearchParams(q).get("e");
40
+ if (!e) return null;
41
+ history.replaceState?.(null, "", location.hash.replace(/\?.*$/, ""));
42
+ return el("p", { className: "err connerr", textContent: e });
43
+ }
44
+
45
+ function draw(body, d) {
46
+ const have = new Set(d.connectors.map((c) => c.catalogue ?? c.id));
47
+
48
+ if (d.connectors.length) {
49
+ const list = el("div", { className: "connlist" });
50
+ for (const c of d.connectors) list.append(row(c, d));
51
+ body.append(el("h2", { className: "connhead", textContent: "Connected" }), list);
52
+ }
53
+
54
+ const grid = el("div", { className: "conngrid" });
55
+ for (const e of d.catalogue) {
56
+ if (have.has(e.id)) continue;
57
+ // One Notion, whichever this portal can do: signing in where it keeps sign-ins, a key elsewhere.
58
+ if (e.auth === "oauth" && !d.signIn) continue;
59
+ if (e.id === "notion-key" && d.signIn && !have.has("notion-key")) continue;
60
+ const card = el("button", { className: "conncard" }, [
61
+ el("span", { className: "connicon" }, [icon("plug")]),
62
+ el("span", {}, [el("b", { textContent: shortName(e) }), el("small", { textContent: e.summary })]),
63
+ ]);
64
+ card.onclick = () => open(e, null, d);
65
+ grid.append(card);
66
+ }
67
+ body.append(el("h2", { className: "connhead", textContent: d.connectors.length ? "Add another" : "Add a service" }), grid);
68
+ }
69
+
70
+ /** "Notion (integration key)" is only Notion where it is the one Notion on offer. */
71
+ function shortName(e) {
72
+ return e.name.replace(/ \(.*\)$/, "");
73
+ }
74
+
75
+ function row(c, d) {
76
+ const e = d.catalogue.find((x) => x.id === (c.catalogue ?? c.id));
77
+ const status = c.problem
78
+ ? el("span", { className: "chip hot", textContent: "Needs fixing" })
79
+ : c.auth === "oauth"
80
+ ? c.signedIn
81
+ ? el("span", { className: "chip ok", textContent: "Signed in" })
82
+ : el("span", { className: "chip warm", textContent: "Not signed in" })
83
+ : c.keys === "stored"
84
+ ? el("span", { className: "chip ok", textContent: "Key stored" })
85
+ : c.keys === "unknown"
86
+ ? el("span", { className: "chip", textContent: "Key not checked" })
87
+ : el("span", { className: "chip warm", textContent: c.keys === "partial" ? "Key on some repos" : "No key" });
88
+
89
+ const who = el("div", { className: "connwho" });
90
+ for (const h of c.staff) who.append(el("span", { className: "chip", textContent: h }));
91
+ if (c.readOnly) who.append(el("span", { className: "chip cool", textContent: "read only" }));
92
+
93
+ const edit = el("button", { className: "ghbtn", textContent: "Edit" });
94
+ edit.onclick = () => open(e ?? custom(c), c, d);
95
+ edit.disabled = !d.canWrite || !e;
96
+ const remove = el("button", { className: "ghbtn", textContent: "Remove" });
97
+ remove.disabled = !d.canWrite;
98
+ remove.onclick = () => confirmRemove(c, remove);
99
+
100
+ return el("div", { className: "connrow" }, [
101
+ el("span", { className: "connicon" }, [icon("plug")]),
102
+ el("div", { className: "conntext" }, [
103
+ el("b", { textContent: c.name }),
104
+ c.problem ? el("span", { className: "err", textContent: c.problem }) : who,
105
+ ]),
106
+ status,
107
+ el("div", { className: "row connacts" }, [edit, remove]),
108
+ ]);
109
+ }
110
+
111
+ /** A hand-written connector the catalogue does not describe: editable in org.yaml only. */
112
+ function custom(c) {
113
+ return { id: c.id, name: c.name, fields: [], steps: [], auth: c.auth };
114
+ }
115
+
116
+ async function confirmRemove(c, btn) {
117
+ if (btn.dataset.sure !== "1") {
118
+ btn.dataset.sure = "1";
119
+ btn.textContent = "Remove " + c.name + "?";
120
+ btn.classList.add("danger");
121
+ return;
122
+ }
123
+ btn.disabled = true;
124
+ btn.textContent = "Removing…";
125
+ try {
126
+ await post({ id: c.id }, "/api/connectors/remove");
127
+ last = null;
128
+ render();
129
+ } catch (err) {
130
+ btn.textContent = String(err.message || err);
131
+ }
132
+ }
133
+
134
+ /* --------------------------------- the sheet --------------------------------- */
135
+
136
+ function open(e, c, d) {
137
+ let box = null;
138
+ const node = form(e, c, d, () => box?.close());
139
+ box = sheet({ node, onClose: () => {} });
140
+ if (!box) document.querySelector("#main")?.append(node);
141
+ }
142
+
143
+ function form(e, c, d, close) {
144
+ const out = el("div", { className: "connform" });
145
+ out.append(el("h2", { className: "sheettitle", textContent: (c ? "" : "Connect ") + shortName(e) }));
146
+ if (!c) out.append(el("p", { className: "sub", textContent: e.summary }));
147
+
148
+ const oauth = e.auth === "oauth";
149
+ if (!c && e.steps.length && !oauth) {
150
+ const ol = el("ol", { className: "connsteps" });
151
+ for (const s of e.steps) ol.append(el("li", { textContent: s }));
152
+ out.append(ol);
153
+ if (e.link) {
154
+ out.append(
155
+ el("a", { className: "ghbtn", href: e.link, target: "_blank", rel: "noopener", textContent: "Open " + shortName(e) }),
156
+ );
157
+ }
158
+ }
159
+
160
+ const fields = el("div", { className: "setupform" });
161
+ const inputs = {};
162
+ for (const f of e.fields) {
163
+ const input = el("input", {
164
+ type: f.secret ? "password" : "text",
165
+ autocomplete: "off",
166
+ spellcheck: false,
167
+ placeholder: f.secret && c ? "Leave empty to keep the stored key" : f.required ? "" : "Optional",
168
+ value: f.secret ? "" : (c?.settings?.[f.id] ?? ""),
169
+ });
170
+ inputs[f.id] = { input, f };
171
+ fields.append(el("label", { className: "field" }, [el("span", { textContent: f.label }), input]));
172
+ }
173
+ if (e.fields.length) out.append(fields);
174
+
175
+ const checked = el("div", { className: "conncheck" });
176
+ const secretInputs = Object.values(inputs).filter((x) => x.f.secret);
177
+ if (e.canCheck && secretInputs.length) {
178
+ const check = el("button", { className: "ghbtn", textContent: "Check key" });
179
+ check.onclick = async () => {
180
+ check.disabled = true;
181
+ check.textContent = "Checking…";
182
+ try {
183
+ const r = await post({ id: e.id, values: valuesOf(inputs) }, "/api/connectors/check");
184
+ checked.replaceChildren(result(r));
185
+ } catch (err) {
186
+ checked.replaceChildren(el("p", { className: "err", textContent: String(err.message || err) }));
187
+ } finally {
188
+ check.disabled = false;
189
+ check.textContent = "Check key";
190
+ }
191
+ };
192
+ out.append(el("div", { className: "row" }, [check]), checked);
193
+ }
194
+
195
+ const picked = new Set(c ? c.staff : (e.suggest ?? []).filter((h) => d.staff.some((s) => s.handle === h)));
196
+ if (!picked.size && d.staff.length === 1) picked.add(d.staff[0].handle);
197
+ const who = el("div", { className: "connstaff" });
198
+ for (const s of d.staff) {
199
+ const box = el("input", { type: "checkbox", checked: picked.has(s.handle) });
200
+ box.onchange = () => (box.checked ? picked.add(s.handle) : picked.delete(s.handle));
201
+ who.append(el("label", { className: "conntick" }, [box, el("span", { textContent: s.name })]));
202
+ }
203
+ out.append(el("h3", { className: "connsub", textContent: "Who can use it" }), who);
204
+
205
+ let ro = null;
206
+ if (e.readOnly) {
207
+ ro = el("input", { type: "checkbox", checked: Boolean(c?.readOnly) });
208
+ out.append(el("label", { className: "conntick" }, [ro, el("span", { textContent: "Read only" })]));
209
+ }
210
+
211
+ const status = el("div");
212
+ const cancel = el("button", { className: "ghbtn", textContent: "Cancel" });
213
+ cancel.onclick = close;
214
+ const save = el("button", { className: "ghbtn primary" });
215
+
216
+ if (oauth && !c?.signedIn) {
217
+ save.textContent = "Sign in to " + e.name;
218
+ save.disabled = !d.signIn || !d.canWrite;
219
+ if (!d.signIn) {
220
+ out.append(el("p", { className: "sub", textContent: "Signing in needs the hosted portal." }));
221
+ }
222
+ save.onclick = async () => {
223
+ if (!picked.size) return status.replaceChildren(el("p", { className: "err", textContent: "Pick at least one staff member." }));
224
+ save.disabled = true;
225
+ save.textContent = "Opening " + e.name + "…";
226
+ try {
227
+ const r = await post({ id: e.id, staff: [...picked], readOnly: Boolean(ro?.checked) }, "/api/connectors/signin");
228
+ location.href = r.url;
229
+ } catch (err) {
230
+ save.disabled = false;
231
+ save.textContent = "Sign in to " + e.name;
232
+ status.replaceChildren(el("p", { className: "err", textContent: String(err.message || err) }));
233
+ }
234
+ };
235
+ } else {
236
+ save.textContent = "Save";
237
+ save.disabled = !d.canWrite;
238
+ save.onclick = async () => {
239
+ if (!picked.size) return status.replaceChildren(el("p", { className: "err", textContent: "Pick at least one staff member." }));
240
+ save.disabled = true;
241
+ save.textContent = "Saving…";
242
+ try {
243
+ await post(
244
+ {
245
+ id: e.id,
246
+ staff: [...picked],
247
+ readOnly: Boolean(ro?.checked),
248
+ settings: settingsOf(inputs),
249
+ values: valuesOf(inputs, true),
250
+ },
251
+ "/api/connectors/save",
252
+ );
253
+ last = null;
254
+ close();
255
+ render();
256
+ } catch (err) {
257
+ save.disabled = false;
258
+ save.textContent = "Save";
259
+ status.replaceChildren(el("p", { className: "err", textContent: String(err.message || err) }));
260
+ }
261
+ };
262
+ }
263
+
264
+ out.append(status, el("div", { className: "row connfoot" }, [save, cancel]));
265
+ if (!d.canWrite) out.append(el("p", { className: "sub", textContent: "You are view-only, so you cannot change connectors." }));
266
+ return out;
267
+ }
268
+
269
+ function result(r) {
270
+ if (r.state === "ok") return el("p", { className: "okline", textContent: "The key works." });
271
+ if (r.state === "limited") return el("p", { className: "okline", textContent: r.note });
272
+ if (r.state === "rejected") return el("p", { className: "err", textContent: r.note });
273
+ return el("p", { className: "sub", textContent: r.note });
274
+ }
275
+
276
+ /** Every field's value, for checking; only the keys, for storing. */
277
+ function valuesOf(inputs, keysOnly = false) {
278
+ const out = {};
279
+ for (const [id, { input, f }] of Object.entries(inputs)) {
280
+ if (keysOnly && !f.secret) continue;
281
+ out[id] = String(input.value ?? "").trim();
282
+ }
283
+ return out;
284
+ }
285
+
286
+ function settingsOf(inputs) {
287
+ const out = {};
288
+ for (const [id, { input, f }] of Object.entries(inputs)) if (!f.secret) out[id] = String(input.value ?? "").trim();
289
+ return out;
290
+ }