@chatpanel/events 0.77.0 → 0.78.1

package/index.js

@@ -192,7 +192,7 @@ export { recipeToolProvider, recipeToolSpec, describeRecipeForApproval, RECIPE_T
 // Agent teams (F8): a team is data, a run is a turn of turns under a budget, members talk
 // through a typed board, nothing lands without a person.
 export { createBudget, validateBudget, normalizeBudget, usageOf, BudgetError, BUDGET_DIMENSIONS } from './budget.js';
-export { defineTeam, validateTeam, normalizeTeam, normalizeGrants, grantAllows, describeRole, TeamError, ROLE_MODES, MERGE_POLICIES, PLAN_MODES, GRANTABLE } from './team.js';
+export { defineTeam, validateTeam, normalizeTeam, normalizeGrants, grantAllows, describeRole, TeamError, ROLE_MODES, MERGE_POLICIES, PLAN_MODES, GRANTABLE, STARTER_TEAMS, starterTeams, blankTeam, teamFromForm, slugTeamName } from './team.js';
 export { fixedPlan, parsePlan, plannerPrompt, waves, breakCycles, TEAM_PLAN_SCHEMA } from './team-plan.js';
 export { createBoard, parseFindings, boardText, findingsInstruction, toBriefClaims, FINDINGS_SCHEMA, FINDING_KINDS } from './team-board.js';
 export { runTeam, dryRunTeam, TeamRunError, RUN_STATUSES } from './team-run.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chatpanel/events",
-  "version": "0.77.0",
+  "version": "0.78.1",
   "description": "The canonical ChatPanel event-log and capability contracts \u2014 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/team-tool.js

@@ -11,7 +11,7 @@
 // receive the host's toolset narrowed to their grants, and the host builds that from the
 // same providers this tool is a member of.
 
-import { validateTeam, normalizeTeam, describeRole, TEAM_NAME_RE } from './team.js';
+import { validateTeam, normalizeTeam, describeRole, slugTeamName } from './team.js';
 import { dryRunTeam } from './team-run.js';
 
 export const TEAM_TOOL_NAME = 'team';
@@ -31,7 +31,7 @@ export function teamToolSpec(teams) {
       + 'Actions: {"action":"run","name":"<team>","request":"<what to do>"} runs one (streams; may take a while); '
       + '{"action":"dry_run","name":"<team>","request":"…"} shows roles, models, tools and budget without running; '
       + '{"action":"save","team":{…}} proposes a NEW team after a task that would benefit from several roles — the user approves it on a card. '
-      + 'A team: {"name":"research","description":"…","roles":[{"id":"researcher","prompt":"…","prefer":"balanced","grants":["data","web"]},{"id":"writer","prompt":"…","prefer":"strong","grants":["none"]}],"merge":"judge","judge":"writer","budget":{"tokens":40000,"ms":300000}}. '
+      + 'A team: {"name":"research" (a short identifier: letters, digits, - _; used as /research),"description":"…","roles":[{"id":"researcher","prompt":"…","prefer":"balanced","grants":["data","web"]},{"id":"writer","prompt":"…","prefer":"strong","grants":["none"]}],"merge":"judge","judge":"writer","budget":{"tokens":40000,"ms":300000}}. '
       + 'grants: none | data | web | history | mcp | mcp:<server>. merge: judge | converge | concat | first. A budget is required.',
     parameters: {
       type: 'object',
@@ -78,10 +78,10 @@ export function teamToolProvider({ teams = [], run = null, appoint = null, confi
       const action = String(input?.action || '');
 
       if (action === 'save') {
-        const team = input?.team;
+        // A name in prose ("Research Team") becomes the /command it will be run by.
+        const team = input?.team && typeof input.team === 'object' ? { ...input.team, name: slugTeamName(input.team.name) } : input?.team;
         const v = validateTeam(team);
-        if (!v.ok) return json({ error: 'The team is not valid.', problems: v.errors, hint: 'A team needs a name, roles with prompts and grants, and a budget.' });
-        if (!TEAM_NAME_RE.test(team.name)) return json({ error: 'name must be a short identifier.' });
+        if (!v.ok) return json({ error: 'The team is not valid.', problems: v.errors, hint: 'A team needs a name (letters, digits, - _), roles with prompts and grants, and a budget such as {"tokens":40000,"ms":300000}.' });
         if (byName.has(team.name)) return json({ error: `A team named "${team.name}" already exists. Pick another name.` });
         if (!confirmSave || !saveTeam) return json({ error: 'Saving a team needs the user\'s approval, which this surface cannot ask for. Describe the team and suggest saving it from the side panel or the desktop.' });
         const norm = normalizeTeam(team);

package/team.js

@@ -121,3 +121,87 @@ export function describeRole(r) {
   const grants = (r.grants || ['none']).join(', ');
   return `${r.name || r.id} — ${who}${r.mode && r.mode !== 'model' ? ` (${r.mode})` : ''} · tools: ${grants}`;
 }
+
+// ── Starters and the editor's form ───────────────────────────────────────────────────────
+//
+// A team is usually proposed in conversation, but a person's first team should not depend
+// on a model deciding to propose one. Both clients' Settings → Teams offer these as "Add
+// starter" and edit them on the same form as a blank team; `teamFromForm` is the one shaping
+// of that form into a team, so a field's meaning does not differ between clients.
+
+export const STARTER_TEAMS = Object.freeze([
+  {
+    name: 'research',
+    description: 'Research a question from the web and your own notes, then write it up.',
+    plan: 'fixed', merge: 'judge', judge: 'writer',
+    roles: [
+      { id: 'researcher', prompt: 'Research the request thoroughly. Search the web and the user\'s own history. Report each fact as a finding with where it came from; note disagreements between sources.', prefer: 'balanced', grants: ['web', 'data'] },
+      { id: 'writer', prompt: 'Write the answer the user asked for from the board\'s findings, citing them. Say plainly what was not found.', prefer: 'strong', grants: ['none'] },
+    ],
+    budget: { tokens: 40000, ms: 300000 },
+  },
+  {
+    name: 'review',
+    description: 'Two independent reads of a draft, reconciled into one set of comments.',
+    plan: 'fixed', merge: 'converge',
+    roles: [
+      { id: 'editor', prompt: 'Read the draft as an editor: structure, clarity, what is missing. One finding per issue, with the passage it refers to.', prefer: 'strong', grants: ['none'] },
+      { id: 'checker', prompt: 'Read the draft as a fact-checker: every claim that could be wrong, with what you checked against. Use the user\'s history and the web.', prefer: 'balanced', grants: ['data', 'web'] },
+    ],
+    budget: { tokens: 30000, ms: 240000 },
+  },
+]);
+
+/**
+ * A name as typed → the identifier a `/command` needs: "Research Team" → "research-team".
+ * Used by the tool's save and by the form, so a model that names a team in prose is not
+ * bounced for it; what cannot be shaped (nothing left) still fails validation.
+ */
+export function slugTeamName(name) {
+  return String(name || '').trim().toLowerCase().replace(/[^a-z0-9_-]+/g, '-').replace(/^[^a-z]+/, '').replace(/-+$/, '').slice(0, 64);
+}
+
+/** Fresh copies — a starter is a template, never the stored record. */
+export function starterTeams() {
+  return STARTER_TEAMS.map((t) => ({ ...t, roles: t.roles.map((r) => ({ ...r, grants: [...r.grants] })), budget: { ...t.budget } }));
+}
+
+/** A blank team for the editor: one role, the smallest budget that is still a budget. */
+export function blankTeam() {
+  return { name: '', description: '', plan: 'fixed', merge: 'concat', judge: null, roles: [{ id: 'role1', prompt: '', prefer: 'balanced', grants: ['none'] }], budget: { tokens: 20000, ms: 300000 } };
+}
+
+/**
+ * The editor's form → a team, or the errors. Grants come as text ("web, data, mcp:srv"),
+ * the budget as numbers that may be blank; a blank judge under `merge: judge` is the last
+ * role, which is the writer in every starter.
+ */
+export function teamFromForm(form) {
+  const roles = (Array.isArray(form.roles) ? form.roles : []).map((r) => ({
+    id: String(r.id || '').trim(),
+    name: String(r.name || '').trim() || undefined,
+    prompt: String(r.prompt || ''),
+    prefer: r.prefer || 'balanced',
+    ...(r.model ? { model: String(r.model) } : {}),
+    grants: String(Array.isArray(r.grants) ? r.grants.join(',') : r.grants || 'none').split(/[,\s]+/).map((g) => g.trim()).filter(Boolean),
+  }));
+  const budget = {};
+  for (const k of ['tokens', 'calls', 'ms', 'usd']) {
+    const v = Number(form.budget?.[k]);
+    if (form.budget?.[k] !== '' && form.budget?.[k] != null && Number.isFinite(v) && v > 0) budget[k] = v;
+  }
+  const merge = form.merge || 'concat';
+  const team = {
+    name: slugTeamName(form.name),
+    description: String(form.description || '').trim(),
+    plan: form.plan || 'fixed',
+    merge,
+    judge: merge === 'judge' ? (form.judge || roles[roles.length - 1]?.id || null) : null,
+    roles,
+    budget,
+    enabled: form.enabled !== false,
+    ...(form.createdAt ? { createdAt: form.createdAt } : {}),
+  };
+  const v = validateTeam(team);
+  return v.ok ? { ok: true, team: normalizeTeam(team) } : { ok: false, errors: v.errors };
+}