@chatpanel/events 0.101.0 → 0.103.1

package/adapters.js

@@ -1,83 +1 @@
-// Surface adapters — the plugin contract for "this app is driven better by its own data
-// format than by pointer automation".
-//
-// Excalidraw is drawn by writing scene elements, a spreadsheet is filled by addressing
-// cells, a diagram tool by inserting nodes. Each of those is the SAME shape of thing:
-// recognise a page, offer a tool, say how to use it, execute it. That was hardcoded as a
-// list inside one 1,200-line module, which meant every new app edited a shared file and
-// nothing outside the extension could offer one at all.
-//
-// As a plugin contract instead (P15): an adapter is declared, registered with the kernel,
-// and discovered. The desktop and mobile clients get the same registry; a user or a skill
-// can eventually contribute one without touching this code.
-//
-// WHAT IS SHARED IS THE CONTRACT, NOT THE ADAPTER. Recognition and selection are pure and
-// live here; the execution of any real adapter needs a platform (chrome.scripting, CDP)
-// and therefore lives in the client, injected at registration.
-
-export class AdapterError extends Error {
-  constructor(code, message) { super(message); this.name = 'AdapterError'; this.code = code; }
-}
-
-/**
- * Declare an adapter.
- *
- * @param matches  (url, caps) => boolean. Given the URL and whatever capability probe the
- *                 host performed, so an adapter can recognise a self-hosted or embedded
- *                 instance rather than only a known hostname — the reason a hostname table
- *                 was rejected in the first place.
- * @param priority higher wins when two adapters match. Ties break on registration order,
- *                 so the answer is stable rather than dependent on activation timing.
- */
-export function defineAdapter({ id, label, matches, toolSpecs, guidance, execute, priority = 0 }) {
-  if (!id) throw new AdapterError('BAD_ADAPTER', 'adapter.id required');
-  if (typeof matches !== 'function') throw new AdapterError('BAD_ADAPTER', `adapter '${id}': matches required`);
-  if (typeof execute !== 'function') throw new AdapterError('BAD_ADAPTER', `adapter '${id}': execute required`);
-  return Object.freeze({
-    id,
-    label: label || id,
-    matches,
-    priority,
-    toolSpecs: typeof toolSpecs === 'function' ? toolSpecs : () => [],
-    guidance: typeof guidance === 'function' ? guidance : () => '',
-    execute,
-  });
-}
-
-/**
- * The registry a host binds adapters into.
- *
- * Deliberately independent of the kernel: a plugin registers through the kernel and calls
- * `add` from its activate, but a host with no kernel yet can still use this. Coupling them
- * would make the plugin model a prerequisite for a feature rather than a way to build it.
- */
-export function createAdapterRegistry() {
-  const adapters = [];
-  return {
-    /** Register an adapter. Returns its remover, so registration is revertible (P15). */
-    add(adapter) {
-      adapters.push(adapter);
-      return () => {
-        const i = adapters.indexOf(adapter);
-        if (i >= 0) adapters.splice(i, 1);
-      };
-    },
-
-    list: () => [...adapters],
-
-    /**
-     * The adapter for a page, or null.
-     *
-     * A matcher that throws is treated as "no match" rather than taking the page down: one
-     * badly-written adapter must not stop the others being offered, which is the same
-     * isolation rule the source registry follows.
-     */
-    for(url, caps = {}) {
-      const hits = adapters.filter((a) => {
-        try { return !!a.matches(url, caps); } catch { return false; }
-      });
-      if (!hits.length) return null;
-      return hits.sort((a, b) => b.priority - a.priority)[0];
-    },
-  };
-}
+class f extends Error{constructor(t,e){super(e),this.name="AdapterError",this.code=t}}function c({id:r,label:t,matches:e,toolSpecs:o,guidance:n,execute:i,priority:u=0}){if(!r)throw new f("BAD_ADAPTER","adapter.id required");if(typeof e!="function")throw new f("BAD_ADAPTER",`adapter '${r}': matches required`);if(typeof i!="function")throw new f("BAD_ADAPTER",`adapter '${r}': execute required`);return Object.freeze({id:r,label:t||r,matches:e,priority:u,toolSpecs:typeof o=="function"?o:()=>[],guidance:typeof n=="function"?n:()=>"",execute:i})}function p(){const r=[];return{add(t){return r.push(t),()=>{const e=r.indexOf(t);e>=0&&r.splice(e,1)}},list:()=>[...r],for(t,e={}){const o=r.filter(n=>{try{return!!n.matches(t,e)}catch{return!1}});return o.length?o.sort((n,i)=>i.priority-n.priority)[0]:null}}}export{f as AdapterError,p as createAdapterRegistry,c as defineAdapter};

package/adaptive-tool-policy.js

@@ -1,45 +1 @@
-const INVALID_PARAMS_RE = /\b(?:invalid request parameters|-32602)\b/i;
-
-export function resultText(result) {
-  if (typeof result === 'string') return result;
-  if (!result || typeof result !== 'object') return '';
-  if (typeof result.text === 'string') return result.text;
-  try {
-    return JSON.stringify(result);
-  } catch {
-    return String(result);
-  }
-}
-
-export function isInvalidToolParametersResult(result) {
-  return INVALID_PARAMS_RE.test(resultText(result));
-}
-
-export function adaptiveToolRetryHint(name) {
-  const tool = String(name || 'this tool');
-  return [
-    `Do not retry ${tool} with the same arguments.`,
-    'Match the user request to the tool domain first: Hacker News requests should use Hacker News tools, Confluence requests should use Confluence tools, and Jira requests should use Jira tools.',
-    'If the right tool is unavailable, answer with the exact tool error instead of trying unrelated tools.',
-  ].join(' ');
-}
-
-export function createAdaptiveToolPolicy() {
-  const suppressed = new Set();
-
-  return {
-    isSuppressed(name) {
-      return suppressed.has(String(name || ''));
-    },
-    recordResult(name, result) {
-      const toolName = String(name || '');
-      if (toolName && isInvalidToolParametersResult(result)) suppressed.add(toolName);
-    },
-    filterOpenAITools(specs = []) {
-      return (specs || []).filter((spec) => !suppressed.has(spec?.function?.name));
-    },
-    filterAnthropicTools(specs = []) {
-      return (specs || []).filter((spec) => !suppressed.has(spec?.name));
-    },
-  };
-}
+const n=/\b(?:invalid request parameters|-32602)\b/i;function s(t){if(typeof t=="string")return t;if(!t||typeof t!="object")return"";if(typeof t.text=="string")return t.text;try{return JSON.stringify(t)}catch{return String(t)}}function i(t){return n.test(s(t))}function a(t){return[`Do not retry ${String(t||"this tool")} with the same arguments.`,"Match the user request to the tool domain first: Hacker News requests should use Hacker News tools, Confluence requests should use Confluence tools, and Jira requests should use Jira tools.","If the right tool is unavailable, answer with the exact tool error instead of trying unrelated tools."].join(" ")}function u(){const t=new Set;return{isSuppressed(e){return t.has(String(e||""))},recordResult(e,o){const r=String(e||"");r&&i(o)&&t.add(r)},filterOpenAITools(e=[]){return(e||[]).filter(o=>!t.has(o?.function?.name))},filterAnthropicTools(e=[]){return(e||[]).filter(o=>!t.has(o?.name))}}}export{a as adaptiveToolRetryHint,u as createAdaptiveToolPolicy,i as isInvalidToolParametersResult,s as resultText};

package/agent.js

@@ -1,256 +1,3 @@
-// An AGENT, as data — the pool an org recruits from. Nothing runs here.
-//
-// A team's roles were inlined: each carried its own prompt, tier and grants, so the same
-// "researcher" existed once per team and an edit landed in one of them. An agent is the role
-// definition promoted out of the team (F8 §8 A1, architecture-pillars.md §9): a persistent
-// identity — name, purpose, prompt, skills, grants, egress class, ENGINE, memory namespace —
-// with a scorecard the runner writes and the store attests (scorecard.js). One agent stands
-// in many teams; a team's role says `agent: <id>` and `resolveTeam` fills the role from the
-// pool at run time, so the runner (team-run.js) is unchanged.
-//
-// The engine is a field on the card, never a nav item: `model` / `harness` / `auto` /
-// `assistant` (engine.js). The built-in ASSISTANT is the agent behind every plain chat: its
-// engine is whichever model the chat is on, which is why `engineOf` takes the chat's model.
-//
-// Trust is derived, never declared (the team.js rule): `builtin` only when the host says so.
-// Grants are the team's vocabulary (team.js GRANT_RE), including the work grants a harness
-// engine may hold; `page` is never grantable. The pool is shared through the client-prefs
-// document (`agents` section) like teams, skills and recipes.
+import{normalizeGrants as k,GRANT_RE as E,TeamError as A,normalizeTeam as x,slugTeamName as I}from"./team.js";import{normalizeEngineSpec as l,validateEngineSpec as N,describeEngine as O,engineRef as $,tierOf as B}from"./engine.js";const _=/^[a-z][a-z0-9_-]{0,63}$/i,u=Object.freeze(["jobs","meetings","notes"]),m=Object.freeze(["redacted","delegated"]),j=32,g="assistant";class z extends Error{constructor(r,t){super(t),this.name="AgentError",this.code=r}}const d=e=>e!==null&&typeof e=="object"&&!Array.isArray(e),h=(e,r,t)=>[...new Set((Array.isArray(e)?e:typeof e=="string"?e.split(/[,\s]+/):[]).map(o=>String(o||"").trim().slice(0,r)).filter(Boolean))].slice(0,t);function S(e){const r=[];if(!d(e))return{ok:!1,errors:["agent must be an object"]};_.test(String(e.id||""))||r.push("id: a short identifier (letters, digits, _ -)"),String(e.name||e.id||"").trim()||r.push("name: what to call it"),!String(e.prompt||"").trim()&&String(e.id)!==g&&r.push("prompt: what this agent does"),r.push(...N(e.engine,"engine"));const t=(Array.isArray(e.grants)?e.grants:[]).filter(o=>!E.test(String(o)));return t.length&&r.push(`grants: not grantable: ${t.join(", ")}${t.some(o=>/^page/.test(String(o)))?" (a tab is one person's; an agent may not act on it)":""}`),e.egress!==void 0&&e.egress!==null&&!m.includes(e.egress)&&r.push(`egress: one of ${m.join(", ")}`),e.appliesTo!==void 0&&(!Array.isArray(e.appliesTo)||e.appliesTo.some(o=>!u.includes(o)))&&r.push(`appliesTo: a list of ${u.join(", ")}`),e.skills!==void 0&&!Array.isArray(e.skills)&&typeof e.skills!="string"&&r.push("skills: a list of skill names"),{ok:r.length===0,errors:r}}function f(e,{builtin:r=!1}={}){const t=S(e);if(!t.ok)throw new z("INVALID",t.errors.join("; "));const o=String(e.id);return{id:o,name:String(e.name||o).trim().slice(0,60),purpose:String(e.purpose||"").trim().slice(0,300),prompt:String(e.prompt||"").trim().slice(0,8e3),skills:h(e.skills,80,j),grants:k(e.grants),engine:l(e.engine),...m.includes(e.egress)?{egress:e.egress}:{},appliesTo:Array.isArray(e.appliesTo)&&e.appliesTo.length?[...new Set(e.appliesTo.filter(i=>u.includes(i)))]:["jobs"],memoryScope:String(e.memoryScope||"").trim().slice(0,120)||`agent:${o}`,...e.workdir?{workdir:String(e.workdir).trim().slice(0,400)}:{},createdBy:String(e.createdBy||"person").slice(0,80),enabled:e.enabled!==!1,...e.origin&&d(e.origin)?{origin:{...e.origin}}:{},...r?{builtin:!0}:{},...e.createdAt?{createdAt:e.createdAt}:{}}}function Y(e,r){return Object.freeze(f(e,r))}function D({grants:e=["data","web","history","mcp"]}={}){return Y({id:g,name:"Assistant",purpose:"The chat itself: answers, uses the tools you connected, remembers what you tell it.",prompt:"",engine:"assistant",grants:e,appliesTo:["jobs","meetings","notes"],createdBy:"chatpanel"},{builtin:!0})}function P(e,{chatModel:r=null}={}){const t=e||{};if(t.engine!==void 0&&t.engine!==null){const i=l(t.engine);return i.kind!=="assistant"?i:r?l(typeof r=="string"?r:{kind:"model",providerId:r.providerId,model:r.model||r.id}):{kind:"auto",policy:{prefer:"balanced"}}}return t.model?l({kind:"model",model:t.model}):{kind:"auto",policy:{prefer:{cheap:"cheapest-that-clears",strong:"best-quality",balanced:"balanced"}[t.prefer]||"balanced"}}}function C(e,r){const t=e||{};return`${t.name||t.id} — ${O(t.engine,r)} · tools: ${(t.grants||["none"]).join(", ")}${t.skills?.length?` · skills: ${t.skills.join(", ")}`:""}`}function L(e){return I(e)}function J(e,r=[],{chatModel:t=null,targetFor:o=null}={}){const i=x(e),p=new Map((Array.isArray(r)?r:[]).filter(n=>n&&n.id).map(n=>[String(n.id),n])),b={},T=i.roles.map(n=>{if(!n.agent)return n;const c=p.get(n.agent)||(n.agent===g?D():null);if(!c)throw new A("NO_AGENT",`role "${n.id}" names agent "${n.agent}", which is not in the pool`);const s=f(c,{builtin:!!c.builtin});if(s.enabled===!1)throw new A("NO_AGENT",`agent "${s.id}" is disabled`);b[n.id]=s;const a=P(n.engine?{engine:n.engine}:s,{chatModel:t}),y=$(a)?o?o(a,s):a.kind==="harness"?a.harnessId:a.model:null,v=Array.isArray(n.grants)?s.grants.includes("none")?["none"]:k(n.grants.filter(w=>s.grants.includes(w)||w.startsWith("mcp:")&&s.grants.includes("mcp"))):s.grants,R=[s.prompt,n.prompt?`In this team: ${n.prompt}`:""].filter(Boolean).join(`
 
-import { normalizeGrants, GRANT_RE, TeamError, normalizeTeam, slugTeamName } from './team.js';
-import { normalizeEngineSpec, validateEngineSpec, describeEngine, engineRef, tierOf } from './engine.js';
-
-export const AGENT_ID_RE = /^[a-z][a-z0-9_-]{0,63}$/i;
-export const APPLIES_TO = Object.freeze(['jobs', 'meetings', 'notes']);
-export const EGRESS_CLASSES = Object.freeze(['redacted', 'delegated']);
-export const MAX_SKILLS = 32;
-export const ASSISTANT_ID = 'assistant';
-
-export class AgentError extends Error {
-  constructor(code, message) { super(message); this.name = 'AgentError'; this.code = code; }
-}
-
-const isRecord = (v) => v !== null && typeof v === 'object' && !Array.isArray(v);
-const list = (xs, n, max) => [...new Set((Array.isArray(xs) ? xs : typeof xs === 'string' ? xs.split(/[,\s]+/) : []).map((x) => String(x || '').trim().slice(0, n)).filter(Boolean))].slice(0, max);
-
-export function validateAgent(agent) {
-  const errors = [];
-  if (!isRecord(agent)) return { ok: false, errors: ['agent must be an object'] };
-  if (!AGENT_ID_RE.test(String(agent.id || ''))) errors.push('id: a short identifier (letters, digits, _ -)');
-  if (!String(agent.name || agent.id || '').trim()) errors.push('name: what to call it');
-  if (!String(agent.prompt || '').trim() && String(agent.id) !== ASSISTANT_ID) errors.push('prompt: what this agent does');
-  errors.push(...validateEngineSpec(agent.engine, 'engine'));
-  const bad = (Array.isArray(agent.grants) ? agent.grants : []).filter((g) => !GRANT_RE.test(String(g)));
-  if (bad.length) errors.push(`grants: not grantable: ${bad.join(', ')}${bad.some((g) => /^page/.test(String(g))) ? ' (a tab is one person\'s; an agent may not act on it)' : ''}`);
-  if (agent.egress !== undefined && agent.egress !== null && !EGRESS_CLASSES.includes(agent.egress)) errors.push(`egress: one of ${EGRESS_CLASSES.join(', ')}`);
-  if (agent.appliesTo !== undefined && (!Array.isArray(agent.appliesTo) || agent.appliesTo.some((a) => !APPLIES_TO.includes(a)))) errors.push(`appliesTo: a list of ${APPLIES_TO.join(', ')}`);
-  if (agent.skills !== undefined && !Array.isArray(agent.skills) && typeof agent.skills !== 'string') errors.push('skills: a list of skill names');
-  return { ok: errors.length === 0, errors };
-}
-
-/**
- * The stored form. Defaults filled, grants normalized, engine normalized, trust derived. The
- * memory namespace defaults to the agent's own (`agent:<id>`); a team may point several
- * agents at one shared namespace by naming it.
- */
-export function normalizeAgent(agent, { builtin = false } = {}) {
-  const v = validateAgent(agent);
-  if (!v.ok) throw new AgentError('INVALID', v.errors.join('; '));
-  const id = String(agent.id);
-  return {
-    id,
-    name: String(agent.name || id).trim().slice(0, 60),
-    purpose: String(agent.purpose || '').trim().slice(0, 300),
-    prompt: String(agent.prompt || '').trim().slice(0, 8000),
-    skills: list(agent.skills, 80, MAX_SKILLS),
-    grants: normalizeGrants(agent.grants),
-    engine: normalizeEngineSpec(agent.engine),
-    ...(EGRESS_CLASSES.includes(agent.egress) ? { egress: agent.egress } : {}),
-    appliesTo: Array.isArray(agent.appliesTo) && agent.appliesTo.length ? [...new Set(agent.appliesTo.filter((a) => APPLIES_TO.includes(a)))] : ['jobs'],
-    memoryScope: String(agent.memoryScope || '').trim().slice(0, 120) || `agent:${id}`,
-    ...(agent.workdir ? { workdir: String(agent.workdir).trim().slice(0, 400) } : {}),
-    createdBy: String(agent.createdBy || 'person').slice(0, 80),
-    enabled: agent.enabled !== false,
-    ...(agent.origin && isRecord(agent.origin) ? { origin: { ...agent.origin } } : {}),
-    ...(builtin ? { builtin: true } : {}),
-    ...(agent.createdAt ? { createdAt: agent.createdAt } : {}),
-  };
-}
-
-export function defineAgent(agent, opts) { return Object.freeze(normalizeAgent(agent, opts)); }
-
-/**
- * The built-in Assistant — the agent behind every plain chat. Its engine is the chat's model
- * (`engineOf` resolves it); its grants are whatever the chat has; it applies everywhere.
- */
-export function assistantAgent({ grants = ['data', 'web', 'history', 'mcp'] } = {}) {
-  return defineAgent({
-    id: ASSISTANT_ID, name: 'Assistant', purpose: 'The chat itself: answers, uses the tools you connected, remembers what you tell it.',
-    prompt: '', engine: 'assistant', grants, appliesTo: ['jobs', 'meetings', 'notes'], createdBy: 'chatpanel',
-  }, { builtin: true });
-}
-
-/**
- * WHAT RUNS this agent's turns, resolved: the Assistant's engine is the chat's model (the
- * host passes `chatModel` as `{ providerId?, model }` or a string), which is why the
- * Assistant has no engine of its own. Everything else returns its normalized spec. A legacy
- * role (no `engine`) reads as `model` when it pins one, else `auto` at its tier.
- */
-export function engineOf(agentOrRole, { chatModel = null } = {}) {
-  const a = agentOrRole || {};
-  if (a.engine !== undefined && a.engine !== null) {
-    const s = normalizeEngineSpec(a.engine);
-    if (s.kind !== 'assistant') return s;
-    if (chatModel) return normalizeEngineSpec(typeof chatModel === 'string' ? chatModel : { kind: 'model', providerId: chatModel.providerId, model: chatModel.model || chatModel.id });
-    return { kind: 'auto', policy: { prefer: 'balanced' } };
-  }
-  if (a.model) return normalizeEngineSpec({ kind: 'model', model: a.model });
-  const prefer = { cheap: 'cheapest-that-clears', strong: 'best-quality', balanced: 'balanced' }[a.prefer] || 'balanced';
-  return { kind: 'auto', policy: { prefer } };
-}
-
-/** The capability strip's first column (§8): what kind of thing this agent is, in a word. */
-export function describeAgent(agent, opts) {
-  const a = agent || {};
-  return `${a.name || a.id} — ${describeEngine(a.engine, opts)} · tools: ${(a.grants || ['none']).join(', ')}${a.skills?.length ? ` · skills: ${a.skills.join(', ')}` : ''}`;
-}
-
-export function slugAgentId(name) { return slugTeamName(name); }
-
-/**
- * A team as the runner needs it: every role that says `agent` is filled from the pool —
- * prompt, grants, skills, engine, working directory — and the role's own fields narrow it.
- *
- *   • prompt   the agent's, then the role's ("In this team: …") when the role adds one
- *   • grants   the agent's, narrowed to the role's when the role lists any (a team may not
- *              widen an agent; it may lend less)
- *   • engine   the role's override when it has one, else the agent's, with the Assistant
- *              resolved to `chatModel`; `prefer` follows for today's appointers
- *   • model    what `callModel` is handed — `targetFor(engine)` when the host maps engines
- *              to its target ids (the extension's endpoint ids, the desktop's gateway ids),
- *              else the harness id or the model name
- *
- * A role naming an agent not in the pool throws NO_AGENT: a team is not run with a hole in
- * it. Returns the normalized team plus `agents` — the resolved cards, by role id.
- */
-export function resolveTeam(team, pool = [], { chatModel = null, targetFor = null } = {}) {
-  const t = normalizeTeam(team);
-  const byId = new Map((Array.isArray(pool) ? pool : []).filter((a) => a && a.id).map((a) => [String(a.id), a]));
-  const agents = {};
-  const roles = t.roles.map((r) => {
-    if (!r.agent) return r;
-    const raw = byId.get(r.agent) || (r.agent === ASSISTANT_ID ? assistantAgent() : null);
-    if (!raw) throw new TeamError('NO_AGENT', `role "${r.id}" names agent "${r.agent}", which is not in the pool`);
-    const a = normalizeAgent(raw, { builtin: !!raw.builtin });
-    if (a.enabled === false) throw new TeamError('NO_AGENT', `agent "${a.id}" is disabled`);
-    agents[r.id] = a;
-    const engine = engineOf(r.engine ? { engine: r.engine } : a, { chatModel });
-    const ref = engineRef(engine);
-    const target = ref ? (targetFor ? targetFor(engine, a) : (engine.kind === 'harness' ? engine.harnessId : engine.model)) : null;
-    const grants = !Array.isArray(r.grants) ? a.grants
-      : a.grants.includes('none') ? ['none']
-        : normalizeGrants(r.grants.filter((g) => a.grants.includes(g) || (g.startsWith('mcp:') && a.grants.includes('mcp'))));
-    const prompt = [a.prompt, r.prompt ? `In this team: ${r.prompt}` : ''].filter(Boolean).join('\n\n').slice(0, 8000);
-    return {
-      ...r,
-      name: r.name === r.id ? a.name : r.name,
-      prompt,
-      grants,
-      engine,
-      prefer: engine.kind === 'auto' ? tierOf(engine) : r.prefer,
-      ...(target ? { model: r.model || target } : {}),
-      ...(a.skills.length ? { skills: [...a.skills] } : {}),
-      ...(a.workdir ? { workdir: a.workdir } : {}),
-      ...(a.egress ? { egress: a.egress } : {}),
-      ...(a.memoryScope ? { memoryScope: a.memoryScope } : {}),
-    };
-  });
-  return { ...t, roles, agents };
-}
-
-// ── The standing org and the editor's form ────────────────────────────────────────────────
-//
-// "ChatPanel Engineering" (architecture-pillars.md §12.2) — the first standing agents,
-// offered as starters the way `research` and `review` are for teams. Every Implementer is
-// this ONE card with a different working directory: the org repo's `agents/*.json` (§14.3)
-// is where a company keeps one per repo. Engines are `auto` / `harness:<id>` so a starter
-// does not name a provider a person may not have; the Harness engines say `claude` because
-// that is the bridge's id for Claude Code and the pilot's choice — change it on the card.
-
-export const STARTER_AGENTS = Object.freeze([
-  // The EXECUTIVE holds a goal (project-run.js): it posts the jobs, recruits for each from
-  // the pool, runs the recruited as a team, reads what came back, posts the follow-ups, asks
-  // the stakeholder where the gate says a person decides, and closes when done-when holds.
-  // A person is the stakeholder by default; this is the manager they delegate the running to.
-  { id: 'executive', name: 'Executive', purpose: 'Runs a project: posts the jobs for the goal, recruits from the pool, reads the results, posts follow-ups, asks before spending or changing scope, closes when done-when holds.',
-    prompt: 'You are the Executive. You hold one goal and its done-when. Break the goal into jobs a stranger could act on, each naming the skills and tools it needs; prefer jobs that run at the same time and use dependsOn only when one truly needs another\'s result. Read every result against done-when as written — say it holds only when it does on the results as they are, not as they could be. Post follow-up jobs only for what would move done-when. Say plainly what was not found. You never do a job yourself and never create an agent, tool or skill without a person\'s approval.',
-    skills: ['planning', 'management'], grants: ['none'], engine: { kind: 'auto', policy: { prefer: 'best-quality' } }, appliesTo: ['jobs'] },
-  { id: 'architect', name: 'Architect', purpose: 'Reads the docs and the repos; writes the project page and the jobs.',
-    prompt: 'You are the Architect. Read the feature doc, ROADMAP.md, naming-revamp.md and architecture-pillars.md before deciding anything. Write the project page (goal, done-when, budget) and post one job per repo that must change, saying which repo and what the guard is. Propose a new agent type only when no one in the pool fits. Never run a shell.',
-    skills: [], grants: ['data', 'history'], engine: { kind: 'auto', policy: { prefer: 'best-quality' } }, appliesTo: ['jobs'] },
-  { id: 'implementer', name: 'Implementer', purpose: 'Builds one job on a branch in one repo; runs the guard; posts on the thread. Never pushes to main, never publishes.',
-    prompt: 'You are an Implementer. Work only in the repository you were given, on the branch named for this job. Read the job thread first. Make the change, run the repository\'s guard (tools/test-*.mjs or npm test) until it passes, commit with a message that says what and why, and post a summary with the diff stat on the job thread. Do not push to main, do not publish, do not touch another repository.',
-    skills: [], grants: ['shell', 'fs:write', 'scm:read', 'scm:push', 'scm:pr'], engine: { kind: 'harness', harnessId: 'claude' }, appliesTo: ['jobs'] },
-  { id: 'reviewer', name: 'Reviewer', purpose: 'Reads the branch diff; posts findings on the thread. Approve or reject is a person\'s.',
-    prompt: 'You are the Reviewer. Read the diff of the job\'s branch against its base. Post each finding as a reply on the job thread: what, where (file:line), why it matters, what to do instead. Do not edit files. Do not approve or reject — say what you found and let a person decide.',
-    skills: ['review'], grants: ['shell', 'scm:read'], engine: { kind: 'harness', harnessId: 'claude' }, appliesTo: ['jobs'] },
-  { id: 'tester', name: 'Tester', purpose: 'Runs the repository\'s guard on the branch; reports the result. No writes.',
-    prompt: 'You are the Tester. Check out the job\'s branch in its worktree and run the repository\'s guard (tools/test-*.mjs, npm test, the build). Report pass/fail with the failing output verbatim. Do not change any file.',
-    skills: [], grants: ['shell', 'scm:read'], engine: { kind: 'harness', harnessId: 'claude' }, appliesTo: ['jobs'] },
-  { id: 'librarian', name: 'Librarian', purpose: 'Before every job: what was already done for this, and where.',
-    prompt: 'You are the Librarian. Before a job starts, search the runs, boards, briefs and docs for work that already covers it. Reply on the job thread with "already done in …" pointers and what could be reused or extended. Never do the job yourself.',
-    skills: [], grants: ['data', 'history'], engine: { kind: 'auto', policy: { prefer: 'cheapest-that-clears' } }, appliesTo: ['jobs'] },
-  { id: 'scribe', name: 'Scribe', purpose: 'Writes what the run taught into the roadmap and the status row — proposed, a person lands it.',
-    prompt: 'You are the Scribe. From the run\'s board and scorecards, write the "what this run taught" paragraph for the feature doc, the ROADMAP.md entry and the IMPLEMENTATION-STATUS.md row. Post them as a proposal on the thread; a person lands them. Say plainly what did not work.',
-    skills: [], grants: ['data', 'history'], engine: { kind: 'auto', policy: { prefer: 'balanced' } }, appliesTo: ['jobs', 'notes'] },
-  { id: 'release', name: 'Release', purpose: 'Version bump and changelog on the merged branch; asks before publish or push.',
-    prompt: 'You are Release. On the merged branch: bump the version, write the changelog line, run the guard. Before `npm publish` or any `git push`, stop and ask on the thread — a person answers. Never publish or push without that answer.',
-    skills: [], grants: ['shell', 'fs:write', 'scm:read', 'scm:push'], engine: { kind: 'harness', harnessId: 'claude' }, appliesTo: ['jobs'] },
-]);
-
-/** Fresh copies — a starter is a template, never the stored record. */
-export function starterAgents() {
-  return STARTER_AGENTS.map((a) => JSON.parse(JSON.stringify(a)));
-}
-
-/** A blank agent for the editor. */
-export function blankAgent() {
-  return { id: '', name: '', purpose: '', prompt: '', skills: [], grants: ['none'], engine: { kind: 'auto', policy: { prefer: 'balanced' } }, appliesTo: ['jobs'], memoryScope: '' };
-}
-
-/**
- * The editor's form → an agent, or the errors. Grants and skills come as text ("web, data",
- * "review, graphify"); the engine as the form's own shape (`{ kind, model, providerId,
- * harnessId, prefer }`) or a string; a blank id is slugged from the name.
- */
-export function agentFromForm(form) {
-  const f = form || {};
-  const id = String(f.id || '').trim() || slugAgentId(f.name);
-  const engine = isRecord(f.engine)
-    ? (f.engine.kind === 'auto' ? { kind: 'auto', policy: { prefer: f.engine.prefer || f.engine.policy?.prefer || 'balanced', ...(f.engine.policy || {}) } } : f.engine)
-    : f.engine;
-  const agent = {
-    id,
-    name: String(f.name || '').trim() || id,
-    purpose: String(f.purpose || '').trim(),
-    prompt: String(f.prompt || ''),
-    skills: list(f.skills, 80, MAX_SKILLS),
-    grants: list(f.grants, 80, 32).length ? list(f.grants, 80, 32) : ['none'],
-    engine,
-    ...(f.egress ? { egress: f.egress } : {}),
-    appliesTo: Array.isArray(f.appliesTo) && f.appliesTo.length ? f.appliesTo : ['jobs'],
-    ...(f.memoryScope ? { memoryScope: f.memoryScope } : {}),
-    ...(f.workdir ? { workdir: f.workdir } : {}),
-    createdBy: f.createdBy || 'person',
-    enabled: f.enabled !== false,
-    ...(f.origin && isRecord(f.origin) ? { origin: f.origin } : {}),
-    ...(f.createdAt ? { createdAt: f.createdAt } : {}),
-  };
-  const v = validateAgent(agent);
-  return v.ok ? { ok: true, agent: normalizeAgent(agent) } : { ok: false, errors: v.errors };
-}
-
-/** Which agents apply to jobs — the pool a job board recruits from. */
-export function poolFor(agents, surface = 'jobs') {
-  return (Array.isArray(agents) ? agents : []).filter((a) => a && a.enabled !== false && (Array.isArray(a.appliesTo) ? a.appliesTo : ['jobs']).includes(surface));
-}
+`).slice(0,8e3);return{...n,name:n.name===n.id?s.name:n.name,prompt:R,grants:v,engine:a,prefer:a.kind==="auto"?B(a):n.prefer,...y?{model:n.model||y}:{},...s.skills.length?{skills:[...s.skills]}:{},...s.workdir?{workdir:s.workdir}:{},...s.egress?{egress:s.egress}:{},...s.memoryScope?{memoryScope:s.memoryScope}:{}}});return{...i,roles:T,agents:b}}const G=Object.freeze([{id:"executive",name:"Executive",purpose:"Runs a project: posts the jobs for the goal, recruits from the pool, reads the results, posts follow-ups, asks before spending or changing scope, closes when done-when holds.",prompt:"You are the Executive. You hold one goal and its done-when. Break the goal into jobs a stranger could act on, each naming the skills and tools it needs; prefer jobs that run at the same time and use dependsOn only when one truly needs another's result. Read every result against done-when as written — say it holds only when it does on the results as they are, not as they could be. Post follow-up jobs only for what would move done-when. Say plainly what was not found. You never do a job yourself and never create an agent, tool or skill without a person's approval.",skills:["planning","management"],grants:["none"],engine:{kind:"auto",policy:{prefer:"best-quality"}},appliesTo:["jobs"]},{id:"architect",name:"Architect",purpose:"Reads the docs and the repos; writes the project page and the jobs.",prompt:"You are the Architect. Read the feature doc, ROADMAP.md, naming-revamp.md and architecture-pillars.md before deciding anything. Write the project page (goal, done-when, budget) and post one job per repo that must change, saying which repo and what the guard is. Propose a new agent type only when no one in the pool fits. Never run a shell.",skills:[],grants:["data","history"],engine:{kind:"auto",policy:{prefer:"best-quality"}},appliesTo:["jobs"]},{id:"implementer",name:"Implementer",purpose:"Builds one job on a branch in one repo; runs the guard; posts on the thread. Never pushes to main, never publishes.",prompt:"You are an Implementer. Work only in the repository you were given, on the branch named for this job. Read the job thread first. Make the change, run the repository's guard (tools/test-*.mjs or npm test) until it passes, commit with a message that says what and why, and post a summary with the diff stat on the job thread. Do not push to main, do not publish, do not touch another repository.",skills:[],grants:["shell","fs:write","scm:read","scm:push","scm:pr"],engine:{kind:"harness",harnessId:"claude"},appliesTo:["jobs"]},{id:"reviewer",name:"Reviewer",purpose:"Reads the branch diff; posts findings on the thread. Approve or reject is a person's.",prompt:"You are the Reviewer. Read the diff of the job's branch against its base. Post each finding as a reply on the job thread: what, where (file:line), why it matters, what to do instead. Do not edit files. Do not approve or reject — say what you found and let a person decide.",skills:["review"],grants:["shell","scm:read"],engine:{kind:"harness",harnessId:"claude"},appliesTo:["jobs"]},{id:"tester",name:"Tester",purpose:"Runs the repository's guard on the branch; reports the result. No writes.",prompt:"You are the Tester. Check out the job's branch in its worktree and run the repository's guard (tools/test-*.mjs, npm test, the build). Report pass/fail with the failing output verbatim. Do not change any file.",skills:[],grants:["shell","scm:read"],engine:{kind:"harness",harnessId:"claude"},appliesTo:["jobs"]},{id:"librarian",name:"Librarian",purpose:"Before every job: what was already done for this, and where.",prompt:'You are the Librarian. Before a job starts, search the runs, boards, briefs and docs for work that already covers it. Reply on the job thread with "already done in …" pointers and what could be reused or extended. Never do the job yourself.',skills:[],grants:["data","history"],engine:{kind:"auto",policy:{prefer:"cheapest-that-clears"}},appliesTo:["jobs"]},{id:"scribe",name:"Scribe",purpose:"Writes what the run taught into the roadmap and the status row — proposed, a person lands it.",prompt:`You are the Scribe. From the run's board and scorecards, write the "what this run taught" paragraph for the feature doc, the ROADMAP.md entry and the IMPLEMENTATION-STATUS.md row. Post them as a proposal on the thread; a person lands them. Say plainly what did not work.`,skills:[],grants:["data","history"],engine:{kind:"auto",policy:{prefer:"balanced"}},appliesTo:["jobs","notes"]},{id:"release",name:"Release",purpose:"Version bump and changelog on the merged branch; asks before publish or push.",prompt:"You are Release. On the merged branch: bump the version, write the changelog line, run the guard. Before `npm publish` or any `git push`, stop and ask on the thread — a person answers. Never publish or push without that answer.",skills:[],grants:["shell","fs:write","scm:read","scm:push"],engine:{kind:"harness",harnessId:"claude"},appliesTo:["jobs"]}]);function M(){return G.map(e=>JSON.parse(JSON.stringify(e)))}function V(){return{id:"",name:"",purpose:"",prompt:"",skills:[],grants:["none"],engine:{kind:"auto",policy:{prefer:"balanced"}},appliesTo:["jobs"],memoryScope:""}}function K(e){const r=e||{},t=String(r.id||"").trim()||L(r.name),o=d(r.engine)&&r.engine.kind==="auto"?{kind:"auto",policy:{prefer:r.engine.prefer||r.engine.policy?.prefer||"balanced",...r.engine.policy||{}}}:r.engine,i={id:t,name:String(r.name||"").trim()||t,purpose:String(r.purpose||"").trim(),prompt:String(r.prompt||""),skills:h(r.skills,80,j),grants:h(r.grants,80,32).length?h(r.grants,80,32):["none"],engine:o,...r.egress?{egress:r.egress}:{},appliesTo:Array.isArray(r.appliesTo)&&r.appliesTo.length?r.appliesTo:["jobs"],...r.memoryScope?{memoryScope:r.memoryScope}:{},...r.workdir?{workdir:r.workdir}:{},createdBy:r.createdBy||"person",enabled:r.enabled!==!1,...r.origin&&d(r.origin)?{origin:r.origin}:{},...r.createdAt?{createdAt:r.createdAt}:{}},p=S(i);return p.ok?{ok:!0,agent:f(i)}:{ok:!1,errors:p.errors}}function U(e,r="jobs"){return(Array.isArray(e)?e:[]).filter(t=>t&&t.enabled!==!1&&(Array.isArray(t.appliesTo)?t.appliesTo:["jobs"]).includes(r))}export{_ as AGENT_ID_RE,u as APPLIES_TO,g as ASSISTANT_ID,z as AgentError,m as EGRESS_CLASSES,j as MAX_SKILLS,G as STARTER_AGENTS,K as agentFromForm,D as assistantAgent,V as blankAgent,Y as defineAgent,C as describeAgent,P as engineOf,f as normalizeAgent,U as poolFor,J as resolveTeam,L as slugAgentId,M as starterAgents,S as validateAgent};

package/attribution.js

@@ -1,132 +1 @@
-// AUTHORSHIP — who wrote which run of a document, and the versions you can go back to.
-//
-// Moved here from the extension's `notes-provenance.js` unchanged in behaviour. It was
-// always platform-free: a run-list `[{ len, author, at }]` that sums to the body length and
-// shifts naturally as text is inserted or deleted, with no absolute offsets to fix up. The
-// desktop needed exactly the same answers, and a second implementation of "who wrote this"
-// would have disagreed with the first on precisely the edits that matter.
-//
-// WHY RUNS AND NOT OFFSETS. An offset-based ledger has to be repaired after every edit, and
-// the repair is where the bugs live. A run-list is repaired BY the edit: replacing [s,e)
-// with n characters is a splice, and everything after it moves without being touched.
-//
-// The versioning half is new here and belongs beside it, because a version snapshot carries
-// its ledger — restoring a body without its attribution would silently reattribute an
-// agent's paragraphs to the person who pressed Restore.
-
-export const HUMAN = 'You';
-
-export function blankAttribution(len, author = HUMAN, at = 0) {
-  return len > 0 ? [{ len, author, at }] : [];
-}
-
-// The minimal replaced range: [start,end) of `prev` became `insLen` new chars in `next`.
-export function diffRange(prev, next) {
-  const max = Math.min(prev.length, next.length);
-  let s = 0; while (s < max && prev[s] === next[s]) s++;
-  let e = 0; while (e < max - s && prev[prev.length - 1 - e] === next[next.length - 1 - e]) e++;
-  return { start: s, end: prev.length - e, insLen: next.length - s - e };
-}
-
-export function mergeRuns(runs) {
-  const out = [];
-  for (const r of runs) {
-    if (!r.len) continue;
-    const last = out[out.length - 1];
-    if (last && last.author === r.author && last.at === r.at) last.len += r.len;
-    else out.push({ len: r.len, author: r.author, at: r.at });
-  }
-  return out;
-}
-
-export function spliceAttribution(runs, start, end, insLen, author, at) {
-  const before = [], after = [];
-  let pos = 0;
-  for (const r of runs) {
-    const rStart = pos, rEnd = pos + r.len;
-    if (rEnd <= start) before.push(r);
-    else if (rStart >= end) after.push(r);
-    else {
-      if (rStart < start) before.push({ len: start - rStart, author: r.author, at: r.at });
-      if (rEnd > end) after.push({ len: rEnd - end, author: r.author, at: r.at });
-    }
-    pos = rEnd;
-  }
-  return mergeRuns([...before, ...(insLen ? [{ len: insLen, author, at }] : []), ...after]);
-}
-
-// Attribute the diff prev→next to `author`. Returns the updated run-list (unchanged
-// reference-wise only when there was no change).
-export function applyAttribution(runs, prev, next, author, at) {
-  const cur = Array.isArray(runs) && runs.length ? runs : blankAttribution(prev.length);
-  const { start, end, insLen } = diffRange(prev, next);
-  if (start === end && !insLen) return cur; // no change
-  return spliceAttribution(cur, start, end, insLen, author, at);
-}
-
-export function attributionSummary(runs) {
-  const by = new Map();
-  let total = 0;
-  for (const r of runs || []) { by.set(r.author, (by.get(r.author) || 0) + r.len); total += r.len; }
-  return {
-    by: [...by.entries()].map(([author, chars]) => ({ author, chars })).sort((a, b) => b.chars - a.chars),
-    total,
-  };
-}
-
-// Adopt a stored ledger only if it still matches the body length (a note edited by an
-// older build, or imported, won't have one) — otherwise seed the whole body as You.
-export function normalizeAttribution(runs, bodyLen, at) {
-  if (Array.isArray(runs) && runs.length && runs.reduce((n, r) => n + (r.len || 0), 0) === bodyLen) return mergeRuns(runs);
-  return blankAttribution(bodyLen, HUMAN, at);
-}
-
-// ---------------------------------------------------------------------------
-// Versions — the snapshots you can go back to
-// ---------------------------------------------------------------------------
-
-/** Forty is what the extension keeps. Enough to undo an afternoon, bounded enough to store. */
-export const MAX_VERSIONS = 40;
-
-/**
- * Append a snapshot of `body` and its ledger, and return the new list.
- *
- * Two rules, both about not filling the list with noise:
- *   · a body identical to the newest snapshot is not a new version;
- *   · a ledger that does not sum to this body's length is not this body's ledger, so it is
- *     seeded blank rather than carried across — a mismatched ledger would make a later
- *     restore attribute the wrong spans to the wrong authors.
- */
-export function pushVersion(versions, { body, attribution = null, by = HUMAN, label = '', at = Date.now() } = {}) {
-  const list = Array.isArray(versions) ? versions : [];
-  const text = String(body ?? '');
-  const last = list[list.length - 1];
-  if (last && last.body === text) return list;
-  const ledger = (Array.isArray(attribution) && attribution.reduce((n, r) => n + (r.len || 0), 0) === text.length)
-    ? attribution
-    : blankAttribution(text.length, by, at);
-  return [...list, { body: text, attribution: ledger, at, by, label: label || by }].slice(-MAX_VERSIONS);
-}
-
-/**
- * Restore version `index`, keeping the current draft as a snapshot first so the restore is
- * itself undoable.
- *
- * The guard against re-snapshotting matters more than it looks: flipping between two
- * versions (A→B→A→B) would otherwise push an identical "Before restore" row every time and
- * push the version you were trying to reach off the end of a bounded list.
- */
-export function restoreVersion(versions, index, { currentBody, currentAttribution = null, at = Date.now(), label = 'Before restore' } = {}) {
-  const list = Array.isArray(versions) ? versions : [];
-  const target = list[index];
-  if (!target) return null;
-  const draft = String(currentBody ?? '');
-  const next = list.some((v) => v.body === draft)
-    ? list
-    : pushVersion(list, { body: draft, attribution: currentAttribution, by: HUMAN, label, at });
-  return {
-    body: target.body,
-    attribution: normalizeAttribution(target.attribution, target.body.length, target.at || at),
-    versions: next,
-  };
-}
+const x="You";function f(r,n="You",e=0){return r>0?[{len:r,author:n,at:e}]:[]}function A(r,n){const e=Math.min(r.length,n.length);let t=0;for(;t<e&&r[t]===n[t];)t++;let o=0;for(;o<e-t&&r[r.length-1-o]===n[n.length-1-o];)o++;return{start:t,end:r.length-o,insLen:n.length-t-o}}function g(r){const n=[];for(const e of r){if(!e.len)continue;const t=n[n.length-1];t&&t.author===e.author&&t.at===e.at?t.len+=e.len:n.push({len:e.len,author:e.author,at:e.at})}return n}function y(r,n,e,t,o,s){const i=[],l=[];let a=0;for(const u of r){const c=a,h=a+u.len;h<=n?i.push(u):c>=e?l.push(u):(c<n&&i.push({len:n-c,author:u.author,at:u.at}),h>e&&l.push({len:h-e,author:u.author,at:u.at})),a=h}return g([...i,...t?[{len:t,author:o,at:s}]:[],...l])}function m(r,n,e,t,o){const s=Array.isArray(r)&&r.length?r:f(n.length),{start:i,end:l,insLen:a}=A(n,e);return i===l&&!a?s:y(s,i,l,a,t,o)}function M(r){const n=new Map;let e=0;for(const t of r||[])n.set(t.author,(n.get(t.author)||0)+t.len),e+=t.len;return{by:[...n.entries()].map(([t,o])=>({author:t,chars:o})).sort((t,o)=>o.chars-t.chars),total:e}}function p(r,n,e){return Array.isArray(r)&&r.length&&r.reduce((t,o)=>t+(o.len||0),0)===n?g(r):f(n,"You",e)}const b=40;function d(r,{body:n,attribution:e=null,by:t="You",label:o="",at:s=Date.now()}={}){const i=Array.isArray(r)?r:[],l=String(n??""),a=i[i.length-1];if(a&&a.body===l)return i;const u=Array.isArray(e)&&e.reduce((c,h)=>c+(h.len||0),0)===l.length?e:f(l.length,t,s);return[...i,{body:l,attribution:u,at:s,by:t,label:o||t}].slice(-b)}function N(r,n,{currentBody:e,currentAttribution:t=null,at:o=Date.now(),label:s="Before restore"}={}){const i=Array.isArray(r)?r:[],l=i[n];if(!l)return null;const a=String(e??""),u=i.some(c=>c.body===a)?i:d(i,{body:a,attribution:t,by:"You",label:s,at:o});return{body:l.body,attribution:p(l.attribution,l.body.length,l.at||o),versions:u}}export{x as HUMAN,b as MAX_VERSIONS,m as applyAttribution,M as attributionSummary,f as blankAttribution,A as diffRange,g as mergeRuns,p as normalizeAttribution,d as pushVersion,N as restoreVersion,y as spliceAttribution};