@chatpanel/events 0.97.0 → 0.98.1

package/model-picker.js

@@ -102,9 +102,9 @@ export function groupModels(models, { selectedId = '' } = {}) {
   if (agents.length) {
     sections.push({
       key: 'agents',
-      // Naming phase 1 (naming-revamp.md): the CLI coding agents are HARNESSES — a runtime one
+      // Naming (naming-revamp.md): the CLI coding agents are AGENT TOOLS — a runtime one
       // of the user's own agents can be given as its engine. The key and kind are code.
-      label: 'Harnesses',
+      label: 'Agent Tools',
       kind: 'agent',
       items: agents.slice().sort(availableFirst).map(decorate),
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chatpanel/events",
-  "version": "0.97.0",
+  "version": "0.98.1",
   "description": "The canonical ChatPanel event-log and capability contracts — typed durable facts, clock-free deterministic linearization, schema upcasting, and the invariants the replay harness asserts. Pure, dependency-free ESM shared by the ChatPanel extension, gateway and bridge.",
   "type": "module",
   "main": "index.js",

package/recruit.js

@@ -143,7 +143,7 @@ export function needForJob(job, { reach = 'any' } = {}) {
   const capabilities = [];
   const why = [];
   if (tools.length || grants.length) { capabilities.push('tools'); why.push('the job uses tools'); }
-  if (harness) why.push(`a work grant (${grants.filter((g) => WORK_GRANTS.includes(g)).join(', ')}) needs a harness`);
+  if (harness) why.push(`a work grant (${grants.filter((g) => WORK_GRANTS.includes(g)).join(', ')}) needs an agent tool`);
   const r = REACH_RANK[reach] != null ? reach : 'any';
   if (r !== 'any') why.push(`reach ≤ ${r} (the project's privacy setting)`);
   return { capabilities, harness, reach: r, why };
@@ -155,7 +155,7 @@ const meets = (row, need, policy) => {
   const why = [];
   if (row.available === false) why.push('unavailable right now');
   if (REACH_RANK[row.reach] > REACH_RANK[need.reach]) why.push(`reach ${row.reach} exceeds ${need.reach}`);
-  if (need.harness && row.engine.kind !== 'harness') why.push('not a harness');
+  if (need.harness && row.engine.kind !== 'harness') why.push('not an agent tool');
   const missing = need.capabilities.filter((c) => !row.capabilities.includes(c));
   // A harness brings its own tools; the capability list of a bridge agent is the host's guess.
   if (missing.length && !(row.engine.kind === 'harness' && missing.every((c) => c === 'tools'))) why.push(`lacks ${missing.join(', ')}`);
@@ -222,7 +222,7 @@ export function routeFor(agent, job, { rows = [], summary = null, need = null, r
   const policy = spec.policy || {};
   const rejected = [];
   const cleared = list.filter((r) => { const why = meets(r, n, policy); if (why.length) rejected.push(`${r.key}: ${why.join('; ')}`); return !why.length; });
-  if (!cleared.length) return none([`no engine clears ${n.harness ? 'a harness with ' : ''}${n.capabilities.join(', ') || 'the requirements'}${n.reach !== 'any' ? ` within reach ${n.reach}` : ''}${policy.prefer ? ` under ${policy.prefer}` : ''}`, ...rejected.slice(0, 4)]);
+  if (!cleared.length) return none([`no engine clears ${n.harness ? 'an agent tool with ' : ''}${n.capabilities.join(', ') || 'the requirements'}${n.reach !== 'any' ? ` within reach ${n.reach}` : ''}${policy.prefer ? ` under ${policy.prefer}` : ''}`, ...rejected.slice(0, 4)]);
   const ordered = orderByPolicy(cleared, policy.prefer || 'balanced', summary);
   let pick = ordered[0];
   let exploration = false;

package/team-board.js

@@ -104,6 +104,7 @@ export function foldBoard(state, ev) {
   if (type === 'board.thread' && p.thread?.id) {
     if (!s.threads.some((t) => t.id === p.thread.id)) s.threads.push({ ...p.thread });
   } else if (type === 'board.post' && p.post?.id) {
+    if (Array.isArray(s.removed) && s.removed.includes(p.post.threadId)) return s;
     if (!s.posts.some((x) => x.id === p.post.id)) s.posts.push({ ...p.post });
     const t = s.threads.find((x) => x.id === p.post.threadId);
     if (t) { t.lastAt = p.post.at; t.lastBy = p.post.by; t.posts = (t.posts || 0) + 1; }
@@ -113,6 +114,13 @@ export function foldBoard(state, ev) {
   } else if (type === 'board.thread-status' && p.threadId) {
     const t = s.threads.find((x) => x.id === p.threadId);
     if (t) { t.status = p.status; if (p.status !== 'waiting') t.waitingOn = null; if (p.holder) t.holder = p.holder; }
+  } else if (type === 'board.thread-removed' && p.threadId) {
+    // A person took the thread off the board: it and its posts go, and its id is kept so a
+    // post a member still makes in it (its runner did not see the removal) lands nowhere.
+    s.threads = s.threads.filter((x) => x.id !== p.threadId);
+    s.posts = s.posts.filter((x) => x.threadId !== p.threadId);
+    if (!Array.isArray(s.removed)) s.removed = [];
+    if (!s.removed.includes(p.threadId)) s.removed.push(p.threadId);
   }
   return s;
 }
@@ -123,7 +131,7 @@ export function foldBoard(state, ev) {
  * stays: a finding is a post of kind `finding` in its task's thread.
  */
 export function createBoard({ now = () => Date.now(), newId = null, state = null, onEvent = null } = {}) {
-  const st = state && Array.isArray(state.threads) ? { threads: state.threads.map((t) => ({ ...t })), posts: (state.posts || []).map((x) => ({ ...x })) } : emptyBoardState();
+  const st = state && Array.isArray(state.threads) ? { threads: state.threads.map((t) => ({ ...t })), posts: (state.posts || []).map((x) => ({ ...x })), ...(Array.isArray(state.removed) && state.removed.length ? { removed: [...state.removed] } : {}) } : emptyBoardState();
   const listeners = new Set();
   let seq = st.posts.length + st.threads.length;
   const mk = (prefix) => (newId ? newId(prefix) : `${prefix}_${(++seq).toString(36)}${Math.random().toString(36).slice(2, 6)}`);
@@ -181,6 +189,20 @@ export function createBoard({ now = () => Date.now(), newId = null, state = null
       say('board.thread-status', { threadId, status, ...extra });
       return t;
     },
+    /**
+     * A person takes a thread off the board (from either client — the store appends the
+     * event, the running client's tail applies it here). Its posts go with it; a member's
+     * later post in it lands nowhere. A waiting ask is not removed: answer it or stop the run.
+     */
+    removeThread(threadId, { by = PERSON } = {}) {
+      const t = threadOf(threadId);
+      if (!t || (t.kind === 'ask' && t.status === 'waiting')) return null;
+      st.threads = st.threads.filter((x) => x.id !== threadId);
+      st.posts = st.posts.filter((x) => x.threadId !== threadId);
+      (st.removed ||= []).push(threadId);
+      say('board.thread-removed', { threadId, by });
+      return t;
+    },
     /**
      * A member is stuck: open an ask thread (status `waiting`) with the question as its
      * first post. The runner waits on it; a person answers from either client.
@@ -208,7 +230,7 @@ export function createBoard({ now = () => Date.now(), newId = null, state = null
     /** Every ask still waiting — what a client pins at the top. */
     waiting: () => st.threads.filter((t) => t.kind === 'ask' && t.status === 'waiting').map((t) => ({ ...t })),
     /** The whole board, for the run record and for a resume. */
-    state: () => ({ threads: st.threads.map((t) => ({ ...t })), posts: st.posts.map((x) => ({ ...x })) }),
+    state: () => ({ threads: st.threads.map((t) => ({ ...t })), posts: st.posts.map((x) => ({ ...x })), ...(st.removed?.length ? { removed: [...st.removed] } : {}) }),
 
     // ── findings, as before: a finding is a post in its task's thread ──
     add(list, { by = null } = {}) {

package/team-record.js

@@ -99,7 +99,7 @@ export function foldRun(run, ev) {
       if (p.checkpoint) run.checkpoint = p.checkpoint;
       break;
     case 'run.stop-requested': run.stopRequested = at; break;
-    case 'board.thread': case 'board.post': case 'board.decision': case 'board.thread-status':
+    case 'board.thread': case 'board.post': case 'board.decision': case 'board.thread-status': case 'board.thread-removed':
       run.threads = foldBoard(run.threads || emptyBoardState(), ev);
       if (type === 'board.thread-status' && p.status !== 'waiting' && run.status === 'waiting' && !(run.threads.threads || []).some((t) => t.kind === 'ask' && t.status === 'waiting')) run.status = 'answered';
       break;

package/team-trail.js

@@ -16,6 +16,7 @@ export function teamLine(ev) {
     case 'run.resumed': return { type: 'status', text: `team ${ev.team} resumed${(ev.carried || []).length ? ` (${ev.carried.length} task${ev.carried.length === 1 ? '' : 's'} carried over)` : ''}` };
     case 'board.post': return ev.post && ev.post.kind !== 'finding' ? { type: 'status', text: `${ev.post.by} ${ev.post.replyTo ? 'replied' : 'posted'} (${ev.post.kind}): ${String(ev.post.text || '').slice(0, 120)}` } : null;
     case 'board.decision': return { type: 'status', text: `${ev.by || 'someone'} ${ev.status} a post` };
+    case 'board.thread-removed': return { type: 'status', text: `${ev.by || 'someone'} removed a thread from the board` };
     case 'task.note': return { type: 'status', text: `${role}: ${ev.text}` };
     case 'task.handoff': return { type: 'status', text: `${role} handed off ${ev.from ? `from ${ev.from} ` : ''}to ${ev.to} by ${ev.by || 'person'}${ev.reason ? ` — ${ev.reason}` : ''}` };
     case 'task.step': return null;
@@ -63,6 +64,7 @@ export function teamLanes(prev, ev) {
     case 'task.waiting': if (lanes.tasks[ev.taskId]) lanes.tasks[ev.taskId] = { ...lanes.tasks[ev.taskId], status: 'waiting', waitingOn: ev.threadId }; lanes.waiting = [...(lanes.waiting || []), ev.threadId]; break;
     case 'task.done': case 'task.failed': if (lanes.tasks[ev.taskId]) lanes.tasks[ev.taskId] = { ...lanes.tasks[ev.taskId], status: ev.status || 'ok', ms: ev.ms }; break;
     case 'board.thread-status': if (ev.status !== 'waiting' && lanes.waiting) lanes.waiting = lanes.waiting.filter((x) => x !== ev.threadId); break;
+    case 'board.thread-removed': if (lanes.waiting) lanes.waiting = lanes.waiting.filter((x) => x !== ev.threadId); break;
     case 'run.waiting': lanes.waiting = [...(lanes.waiting || []), ev.threadId]; break;
     case 'run.done': lanes.status = ev.status; lanes.usage = ev.usage; break;
     default: break;