@ekanos/cli 0.14.0 → 0.16.0

package/dist/commands/team-agent-readiness.js

@@ -1,47 +1,18 @@
+import { cli } from '../invocation.js';
 import { scopeFix, scopeHiddenWords } from './scope-notice.js';
-/**
- * "Is this agent live on this team, and if not, why?" — one answer for
- * `teams agents show` and the summary line of `teams agents list`, built only
- * from what the host already reports (CLI audit 2026-10-19, §3).
- *
- * Live is: on, on a published version, every connection it needs made,
- * access confirmed by the person it runs as, at least one trigger on, and
- * every trigger's events able to reach it. Each gap is a step with one fix,
- * in the order they have to be done; the first step's fix is "Next".
- *
- * An agent HELD on an earlier version (a newer one reaches further than the
- * person it runs as confirmed) is still live — it runs the version it is on
- * — so the hold is not a step: it is `pending`, said beside "Live", and its
- * confirm command is "Next" once nothing else is.
- */
-const CLI = 'npx @ekanos/cli';
 export function agentReadiness(entry, target) {
     var _a;
-    var _b, _c;
+    var _b;
     const steps = readinessSteps(entry, target);
-    const pending = pendingUpdate(entry, target);
     return {
         live: steps.length === 0,
         steps,
-        pending,
-        next: (_c = (_b = (_a = steps[0]) === null || _a === void 0 ? void 0 : _a.fix) !== null && _b !== void 0 ? _b : pending === null || pending === void 0 ? void 0 : pending.fix) !== null && _c !== void 0 ? _c : null,
-    };
-}
-/** The update a held agent waits for, and who confirms it. */
-function pendingUpdate(entry, { team, source }) {
-    var _a, _b;
-    const agent = entry.agent;
-    if (!(agent === null || agent === void 0 ? void 0 : agent.held))
-        return null;
-    const who = (_a = agent.runsAs) !== null && _a !== void 0 ? _a : 'the person it runs as';
-    return {
-        problem: `held on v${(_b = agent.version) !== null && _b !== void 0 ? _b : '?'}: v${agent.held.waiting} ${describeHold(agent.held)}, and waits for ${who} to confirm`,
-        // Only that person can confirm, signed in as themselves.
-        fix: `${who} runs: ${CLI} teams agents confirm ${team} ${entry.key} --source ${source}  (or confirms in the app: Agents › ${entry.name} › Setup)`,
+        next: (_b = (_a = steps[0]) === null || _a === void 0 ? void 0 : _a.fix) !== null && _b !== void 0 ? _b : null,
     };
 }
 /**
- * What a waiting version adds over the one running, in words:
+ * What a newer version adds over the one a team runs, in words (a publish's
+ * report of the teams pinned to another version):
  * "adds zendesk_update_ticket; lets zendesk_add_tag run without approval".
  */
 export function describeHold(hold) {
@@ -68,8 +39,8 @@ export function describeHold(hold) {
     return parts.length > 0 ? parts.join('; ') : 'reaches further';
 }
 function readinessSteps(entry, { team, source }) {
-    var _a, _b, _c, _d, _e, _f;
-    const enable = `${CLI} teams agents enable ${team} ${entry.key} --source ${source}`;
+    var _a, _b, _c, _d, _e;
+    const enable = `${cli()} teams agents enable ${team} ${entry.key} --source ${source}`;
     const agent = entry.agent;
     if (!agent)
         return [{ problem: `off for ${team}`, fix: enable }];
@@ -81,40 +52,40 @@ function readinessSteps(entry, { team, source }) {
         // A team testing a draft runs it only when started by hand.
         steps.push({
             problem: `testing unpublished draft v${(_a = agent.version) !== null && _a !== void 0 ? _a : '?'}: its triggers do not start it`,
-            fix: `${CLI} agents publish ${entry.key} --source ${source}`,
+            fix: `${cli()} agents publish ${entry.key} --source ${source}`,
         });
     }
     else if (agent.version === null) {
         steps.push({
             problem: 'no published version',
-            fix: `${CLI} agents publish ${entry.key} --source ${source}`,
+            fix: `${cli()} agents publish ${entry.key} --source ${source}`,
         });
     }
     for (const item of agent.missing) {
         steps.push({
             problem: `${item.name}: ${REASON_WORDS[(_b = item.reason) !== null && _b !== void 0 ? _b : 'not_connected']}`,
-            fix: (_c = requirementFix(item, team, source)) !== null && _c !== void 0 ? _c : `${CLI} teams mcp status ${team} ${item.key} --source ${source}`,
+            fix: (_c = requirementFix(item, team, source)) !== null && _c !== void 0 ? _c : `${cli()} teams mcp status ${team} ${item.key} --source ${source}`,
         });
     }
     if (!agent.accessConfirmed) {
-        const who = (_d = agent.runsAs) !== null && _d !== void 0 ? _d : 'the person it runs as';
         steps.push({
-            problem: `${who} has not confirmed it may use their connections`,
-            // Only that person can confirm, signed in as themselves.
-            fix: `${who} runs: ${CLI} teams agents confirm ${team} ${entry.key} --source ${source}  (or confirms in the app: Agents › ${entry.name} › Setup)`,
+            problem: 'nobody has confirmed what it may use',
+            // Whoever sets it up confirms, as themselves: the Source admin here,
+            // or a team manager in the app (plan 247.2).
+            fix: `${cli()} teams agents confirm ${team} ${entry.key} --source ${source}  (or a team manager confirms in the app: Agents › ${entry.name} › Setup)`,
         });
     }
     if (!agent.triggers.some((trigger) => trigger.enabled)) {
         steps.push({
             problem: 'no trigger is on, so it only runs when started by hand',
-            fix: `${CLI} teams triggers add ${team} ${entry.key} event <event-id> --source ${source}  (event ids: ${CLI} catalog --source ${source})`,
+            fix: `${cli()} teams triggers add ${team} ${entry.key} event <event-id> --source ${source}  (event ids: ${cli()} catalog --source ${source})`,
         });
     }
-    for (const channel of (_e = agent.channels) !== null && _e !== void 0 ? _e : []) {
+    for (const channel of (_d = agent.channels) !== null && _d !== void 0 ? _d : []) {
         if (channel.ready)
             continue;
         steps.push({
-            problem: (_f = channel.problem) !== null && _f !== void 0 ? _f : `${channel.name} not ready`,
+            problem: (_e = channel.problem) !== null && _e !== void 0 ? _e : `${channel.name} not ready`,
             fix: channelFix(channel, team, source),
         });
     }
@@ -133,38 +104,50 @@ export function requirementFix(item, team, source) {
         return null;
     switch (item.reason) {
         case 'no_route':
-            return `${CLI} routes set ${item.key} <value> ${team} --source ${source}  (values: ${CLI} routes options ${item.key} --source ${source})`;
+            return `${cli()} routes set ${item.key} <value> ${team} --source ${source}  (values: ${cli()} routes options ${item.key} --source ${source})`;
         case 'source_not_connected':
-            return `${CLI} apps connect ${item.key} --source ${source}`;
+            return `${cli()} apps connect ${item.key} --source ${source}`;
         case 'source_not_entitled':
-            return `a super-admin enables it for the Source (${CLI} sources products --source ${source})`;
+            return `a super-admin enables it for the Source (${cli()} sources products --source ${source})`;
         case 'source_unsupported':
-            return `set connections.${item.key}.owner to "team" in agent.json, then ${CLI} agents apply`;
+            return `set connections.${item.key}.owner to "team" in agent.json, then ${cli()} agents apply`;
         default:
             if (item.connected)
                 return null;
             // A per-person product is the runs-as person's connection, not the
             // caller's: connecting your own leaves the agent missing it.
             return item.via === 'person' && item.viaDetail
-                ? `${CLI} teams connect ${team} ${item.key} --as ${item.viaDetail} --source ${source}`
-                : `${CLI} teams connect ${team} ${item.key} --source ${source}`;
+                ? `${cli()} teams connect ${team} ${item.key} --as ${item.viaDetail} --source ${source}`
+                : `${cli()} teams connect ${team} ${item.key} --source ${source}`;
     }
 }
-/** The one command that makes a channel ready, or the app step. */
+/**
+ * The one command that makes a channel ready. An older host sends no
+ * `arrival`: the channel's key (`<product>:webhook`, `<product>:route`,
+ * `<product>:<connection>`) still says which command it is.
+ */
 export function channelFix(channel, team, source) {
-    switch (channel.arrival) {
+    var _a, _b;
+    const suffix = channel.key.includes(':') ? channel.key.split(':')[1] : null;
+    const arrival = (_a = channel.arrival) !== null && _a !== void 0 ? _a : (suffix === 'webhook'
+        ? 'team-webhook'
+        : suffix === 'route'
+            ? 'source-route'
+            : 'install');
+    switch (arrival) {
         case 'team-webhook':
-            return `${CLI} teams webhook ${team} ${channel.product} --source ${source}`;
+            return `${cli()} teams webhook ${team} ${channel.product} --source ${source}`;
         case 'source-route':
             return channel.webhook
-                ? `${CLI} routes set ${channel.product} <value> ${team} --source ${source}  (values: ${CLI} routes options ${channel.product} --source ${source})`
-                : `${CLI} routes webhook ${channel.product} --source ${source}`;
-        default:
-            return channel.connectionId
-                ? `${CLI} teams connect ${team} ${channel.product} --connection ${channel.connectionId} --source ${source}`
-                : channel.key === 'slack' || channel.key === 'linear-app'
-                    ? `${CLI} teams connect ${team} ${channel.key} --source ${source}`
-                    : `install it on the agent's Triggers tab in the app`;
+                ? `${cli()} routes set ${channel.product} <value> ${team} --source ${source}  (values: ${cli()} routes options ${channel.product} --source ${source})`
+                : `${cli()} routes webhook ${channel.product} --source ${source}`;
+        default: {
+            if (channel.key === 'slack' || channel.key === 'linear-app') {
+                return `${cli()} teams connect ${team} ${channel.key} --source ${source}`;
+            }
+            const connection = (_b = channel.connectionId) !== null && _b !== void 0 ? _b : suffix;
+            return `${cli()} teams connect ${team} ${channel.product}${connection ? ` --connection ${connection}` : ''} --source ${source}`;
+        }
     }
 }
 /** How the events of a ready channel reach the agent. */
@@ -178,23 +161,16 @@ export function reachedVia(channel) {
             return `${channel.name} installed`;
     }
 }
-/** A fix as a line: a command is run in the terminal, an app step is not. */
+/** A fix as a line: a command is run in the terminal; anything else is a person's step. */
 export function fixLine(fix) {
-    return fix.startsWith(CLI) ? `in your terminal: ${fix}` : fix;
+    return fix.startsWith(cli()) ? `in your terminal: ${fix}` : fix;
 }
-/**
- * "Live: yes" or "Live: no — N steps left", and an update waiting for
- * confirmation: "Live: yes (on v4; v5 waiting for confirmation)".
- */
-export function liveLine(readiness, agent) {
-    var _a;
+/** "Live: yes" or "Live: no — N steps left". */
+export function liveLine(readiness) {
     const left = readiness.steps.length;
-    const held = (agent === null || agent === void 0 ? void 0 : agent.held)
-        ? ` (on v${(_a = agent.version) !== null && _a !== void 0 ? _a : '?'}; v${agent.held.waiting} waiting for confirmation)`
-        : '';
     return readiness.live
-        ? `Live: yes${held}`
-        : `Live: no — ${left} step${left === 1 ? '' : 's'} left${held}`;
+        ? 'Live: yes'
+        : `Live: no — ${left} step${left === 1 ? '' : 's'} left`;
 }
 /**
  * One line per product, per trigger, then Live and Next. A product the
@@ -202,7 +178,7 @@ export function liveLine(readiness, agent) {
  * the team cannot see it there (`scope`, the team's scopes).
  */
 export function describeAgentReadiness(entry, target, readiness, activity, scope) {
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d;
     const agent = entry.agent;
     if (!agent) {
         return [
@@ -215,11 +191,9 @@ export function describeAgentReadiness(entry, target, readiness, activity, scope
         `${entry.key} on ${target.team}`,
         agent.draft
             ? `draft v${(_b = agent.version) !== null && _b !== void 0 ? _b : '?'} (testing, unpublished)`
-            : agent.held
-                ? `held on v${(_c = agent.version) !== null && _c !== void 0 ? _c : '?'}, v${agent.held.waiting} waiting for confirmation`
-                : `v${(_d = agent.version) !== null && _d !== void 0 ? _d : '?'} (${agent.pinned ? 'pinned' : 'following'})`,
+            : `v${(_c = agent.version) !== null && _c !== void 0 ? _c : '?'} (${agent.pinned ? 'pinned' : 'following'})`,
         ...(agent.status === 'active' ? [] : [agent.status]),
-        `runs as ${(_e = agent.runsAs) !== null && _e !== void 0 ? _e : 'nobody'}`,
+        `runs as ${(_d = agent.runsAs) !== null && _d !== void 0 ? _d : 'nobody'}`,
         agent.accessConfirmed ? '✓ access confirmed' : '✗ access not confirmed',
     ].join(' · ');
     const width = Math.max(8, ...agent.requirements.map((item) => item.key.length));
@@ -229,7 +203,7 @@ export function describeAgentReadiness(entry, target, readiness, activity, scope
         var _a;
         const fix = item.connected
             ? null
-            : ((_a = requirementFix(item, target.team, target.source)) !== null && _a !== void 0 ? _a : `${CLI} teams mcp status ${target.team} ${item.key} --source ${target.source}`);
+            : ((_a = requirementFix(item, target.team, target.source)) !== null && _a !== void 0 ? _a : `${cli()} teams mcp status ${target.team} ${item.key} --source ${target.source}`);
         const hidden = item.hiddenByScope && scope
             ? [
                 `${indent}! ${scopeHiddenWords(scope)}`,
@@ -292,18 +266,11 @@ export function describeAgentReadiness(entry, target, readiness, activity, scope
                 : []),
         ];
     });
-    const update = readiness.pending
-        ? [
-            `  ${pad('update')}  ${readiness.pending.problem}`,
-            `${indent}→ ${readiness.pending.fix}`,
-        ]
-        : [];
     return [
         head,
         ...products,
         ...(agent.triggers.length > 0 ? triggers : [`  ${pad('triggers')}  none`]),
-        ...update,
-        `  ${liveLine(readiness, agent)}`,
+        `  ${liveLine(readiness)}`,
         ...(readiness.next ? [`  Next: ${readiness.next}`] : []),
     ].join('\n');
 }

package/dist/commands/team-agent-readiness.js.map

@@ -1 +1 @@
-{"version":3,"file":"team-agent-readiness.js","sourceRoot":"","sources":["../../src/commands/team-agent-readiness.ts"],"names":[],"mappings":"AASA,OAAO,EAAmB,QAAQ,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE7E;;;;;;;;;;;;;;GAcG;AAEH,MAAM,GAAG,GAAG,iBAAiB,CAAC;AA0B9B,MAAM,UAAU,cAAc,CAC5B,KAAqB,EACrB,MAAuB;;;IAEvB,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC7C,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC;QACxB,KAAK;QACL,OAAO;QACP,IAAI,cAAE,MAAA,KAAK,CAAC,CAAC,CAAC,0CAAE,GAAG,mCAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,GAAG,mCAAI,IAAI;KAC5C,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,SAAS,aAAa,CACpB,KAAqB,EACrB,EAAE,IAAI,EAAE,MAAM,EAAmB;;IAEjC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,IAAI,EAAC,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,IAAI,CAAA;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,GAAG,SAAG,KAAK,CAAC,MAAM,mCAAI,uBAAuB,CAAC;IACpD,OAAO;QACL,OAAO,EAAE,YAAY,MAAA,KAAK,CAAC,OAAO,mCAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB,GAAG,aAAa;QAChI,yDAAyD;QACzD,GAAG,EAAE,GAAG,GAAG,UAAU,GAAG,yBAAyB,IAAI,IAAI,KAAK,CAAC,GAAG,aAAa,MAAM,uCAAuC,KAAK,CAAC,IAAI,WAAW;KAClJ,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAmB;IAC9C,MAAM,IAAI,GAAG;QACX,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,KAAK;YAC3B,CAAC,CAAC,CAAC,yCAAyC,CAAC;YAC7C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,WAAW;gBAC/B,CAAC,CAAC,CAAC,yCAAyC,CAAC;gBAC7C,CAAC,CAAC,EAAE,CAAC;QACT,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,eAAe,CAAC;QACtE,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK;KACnB,CAAC;IACF,MAAM,OAAO,GAAG;QACd,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1C,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK;KACtB,CAAC;IACF,MAAM,KAAK,GAAG;QACZ,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YACpB,CAAC,CAAC,CAAC,QAAQ,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC;YACrD,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IACF,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC;AACjE,CAAC;AAED,SAAS,cAAc,CACrB,KAAqB,EACrB,EAAE,IAAI,EAAE,MAAM,EAAmB;;IAEjC,MAAM,MAAM,GAAG,GAAG,GAAG,wBAAwB,IAAI,IAAI,KAAK,CAAC,GAAG,aAAa,MAAM,EAAE,CAAC;IACpF,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;IACjE,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,QAAQ,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,4DAA4D;QAC5D,KAAK,CAAC,IAAI,CAAC;YACT,OAAO,EAAE,8BAA8B,MAAA,KAAK,CAAC,OAAO,mCAAI,GAAG,gCAAgC;YAC3F,GAAG,EAAE,GAAG,GAAG,mBAAmB,KAAK,CAAC,GAAG,aAAa,MAAM,EAAE;SAC7D,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC;YACT,OAAO,EAAE,sBAAsB;YAC/B,GAAG,EAAE,GAAG,GAAG,mBAAmB,KAAK,CAAC,GAAG,aAAa,MAAM,EAAE;SAC7D,CAAC,CAAC;IACL,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC;YACT,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,KAAK,YAAY,OAAC,IAAI,CAAC,MAAM,mCAAI,eAAe,CAAC,EAAE;YACxE,GAAG,QACD,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,mCAClC,GAAG,GAAG,qBAAqB,IAAI,IAAI,IAAI,CAAC,GAAG,aAAa,MAAM,EAAE;SACnE,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;QAC3B,MAAM,GAAG,SAAG,KAAK,CAAC,MAAM,mCAAI,uBAAuB,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC;YACT,OAAO,EAAE,GAAG,GAAG,iDAAiD;YAChE,yDAAyD;YACzD,GAAG,EAAE,GAAG,GAAG,UAAU,GAAG,yBAAyB,IAAI,IAAI,KAAK,CAAC,GAAG,aAAa,MAAM,uCAAuC,KAAK,CAAC,IAAI,WAAW;SAClJ,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC;YACT,OAAO,EAAE,wDAAwD;YACjE,GAAG,EAAE,GAAG,GAAG,uBAAuB,IAAI,IAAI,KAAK,CAAC,GAAG,8BAA8B,MAAM,iBAAiB,GAAG,qBAAqB,MAAM,GAAG;SAC1I,CAAC,CAAC;IACL,CAAC;IACD,KAAK,MAAM,OAAO,UAAI,KAAK,CAAC,QAAQ,mCAAI,EAAE,EAAE,CAAC;QAC3C,IAAI,OAAO,CAAC,KAAK;YAAE,SAAS;QAC5B,KAAK,CAAC,IAAI,CAAC;YACT,OAAO,QAAE,OAAO,CAAC,OAAO,mCAAI,GAAG,OAAO,CAAC,IAAI,YAAY;YACvD,GAAG,EAAE,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAGrB;IACF,aAAa,EAAE,eAAe;IAC9B,QAAQ,EAAE,2DAA2D;IACrE,kBAAkB,EAAE,wDAAwD;IAC5E,mBAAmB,EAAE,2CAA2C;IAChE,oBAAoB,EAAE,mCAAmC;CAC1D,CAAC;AAEF,uEAAuE;AACvE,MAAM,UAAU,cAAc,CAC5B,IAAiB,EACjB,IAAY,EACZ,MAAc;IAEd,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IACrC,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,UAAU;YACb,OAAO,GAAG,GAAG,eAAe,IAAI,CAAC,GAAG,YAAY,IAAI,aAAa,MAAM,cAAc,GAAG,mBAAmB,IAAI,CAAC,GAAG,aAAa,MAAM,GAAG,CAAC;QAC5I,KAAK,sBAAsB;YACzB,OAAO,GAAG,GAAG,iBAAiB,IAAI,CAAC,GAAG,aAAa,MAAM,EAAE,CAAC;QAC9D,KAAK,qBAAqB;YACxB,OAAO,4CAA4C,GAAG,8BAA8B,MAAM,GAAG,CAAC;QAChG,KAAK,oBAAoB;YACvB,OAAO,mBAAmB,IAAI,CAAC,GAAG,wCAAwC,GAAG,eAAe,CAAC;QAC/F;YACE,IAAI,IAAI,CAAC,SAAS;gBAAE,OAAO,IAAI,CAAC;YAChC,mEAAmE;YACnE,6DAA6D;YAC7D,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,IAAI,IAAI,CAAC,SAAS;gBAC5C,CAAC,CAAC,GAAG,GAAG,kBAAkB,IAAI,IAAI,IAAI,CAAC,GAAG,SAAS,IAAI,CAAC,SAAS,aAAa,MAAM,EAAE;gBACtF,CAAC,CAAC,GAAG,GAAG,kBAAkB,IAAI,IAAI,IAAI,CAAC,GAAG,aAAa,MAAM,EAAE,CAAC;IACtE,CAAC;AACH,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,UAAU,CACxB,OAA2B,EAC3B,IAAY,EACZ,MAAc;IAEd,QAAQ,OAAO,CAAC,OAAO,EAAE,CAAC;QACxB,KAAK,cAAc;YACjB,OAAO,GAAG,GAAG,kBAAkB,IAAI,IAAI,OAAO,CAAC,OAAO,aAAa,MAAM,EAAE,CAAC;QAC9E,KAAK,cAAc;YACjB,OAAO,OAAO,CAAC,OAAO;gBACpB,CAAC,CAAC,GAAG,GAAG,eAAe,OAAO,CAAC,OAAO,YAAY,IAAI,aAAa,MAAM,cAAc,GAAG,mBAAmB,OAAO,CAAC,OAAO,aAAa,MAAM,GAAG;gBAClJ,CAAC,CAAC,GAAG,GAAG,mBAAmB,OAAO,CAAC,OAAO,aAAa,MAAM,EAAE,CAAC;QACpE;YACE,OAAO,OAAO,CAAC,YAAY;gBACzB,CAAC,CAAC,GAAG,GAAG,kBAAkB,IAAI,IAAI,OAAO,CAAC,OAAO,iBAAiB,OAAO,CAAC,YAAY,aAAa,MAAM,EAAE;gBAC3G,CAAC,CAAC,OAAO,CAAC,GAAG,KAAK,OAAO,IAAI,OAAO,CAAC,GAAG,KAAK,YAAY;oBACvD,CAAC,CAAC,GAAG,GAAG,kBAAkB,IAAI,IAAI,OAAO,CAAC,GAAG,aAAa,MAAM,EAAE;oBAClE,CAAC,CAAC,mDAAmD,CAAC;IAC9D,CAAC;AACH,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,UAAU,CAAC,OAA2B;IACpD,QAAQ,OAAO,CAAC,OAAO,EAAE,CAAC;QACxB,KAAK,cAAc;YACjB,OAAO,cAAc,CAAC;QACxB,KAAK,cAAc;YACjB,OAAO,wBAAwB,CAAC;QAClC;YACE,OAAO,GAAG,OAAO,CAAC,IAAI,YAAY,CAAC;IACvC,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AAChE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CACtB,SAAyB,EACzB,KAAsE;;IAEtE,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;IACpC,MAAM,IAAI,GAAG,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,IAAI;QACtB,CAAC,CAAC,SAAS,MAAA,KAAK,CAAC,OAAO,mCAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,4BAA4B;QACnF,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,SAAS,CAAC,IAAI;QACnB,CAAC,CAAC,YAAY,IAAI,EAAE;QACpB,CAAC,CAAC,cAAc,IAAI,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,EAAE,CAAC;AACpE,CAAC;AAcD;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAqB,EACrB,MAAuB,EACvB,SAAyB,EACzB,QAAuB,EACvB,KAAkB;;IAElB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,GAAG,KAAK,CAAC,GAAG,OAAO,MAAM,CAAC,IAAI,aAAa,MAAA,KAAK,CAAC,gBAAgB,mCAAI,GAAG,YAAY;YACpF,KAAK,QAAQ,CAAC,SAAS,CAAC,EAAE;YAC1B,WAAW,SAAS,CAAC,IAAI,EAAE;SAC5B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,MAAM,IAAI,GAAG;QACX,GAAG,KAAK,CAAC,GAAG,OAAO,MAAM,CAAC,IAAI,EAAE;QAChC,KAAK,CAAC,KAAK;YACT,CAAC,CAAC,UAAU,MAAA,KAAK,CAAC,OAAO,mCAAI,GAAG,yBAAyB;YACzD,CAAC,CAAC,KAAK,CAAC,IAAI;gBACV,CAAC,CAAC,YAAY,MAAA,KAAK,CAAC,OAAO,mCAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,2BAA2B;gBACrF,CAAC,CAAC,IAAI,MAAA,KAAK,CAAC,OAAO,mCAAI,GAAG,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,GAAG;QAC3E,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACpD,WAAW,MAAA,KAAK,CAAC,MAAM,mCAAI,QAAQ,EAAE;QACrC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,wBAAwB;KACxE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEd,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,CAAC,EACD,GAAG,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CACrD,CAAC;IACF,MAAM,GAAG,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAErC,MAAM,QAAQ,GAAG,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS;YACxB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,OAAC,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,mCACjD,GAAG,GAAG,qBAAqB,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,aAAa,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACpF,MAAM,MAAM,GACV,IAAI,CAAC,aAAa,IAAI,KAAK;YACzB,CAAC,CAAC;gBACE,GAAG,MAAM,KAAK,gBAAgB,CAAC,KAAK,CAAC,EAAE;gBACvC,GAAG,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,KAAK,kCAAO,MAAM,KAAE,OAAO,EAAE,IAAI,CAAC,GAAG,IAAG,CAAC,EAAE;aAC3E;YACH,CAAC,CAAC,EAAE,CAAC;QACT,OAAO;YACL,KAAK,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,YAAY,CAAC,IAAI,CAAC,EAAE;YAC3C,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,GAAG,MAAM;SACV,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CACxB,CAAC,EACD,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CACnB,CAAC,OAAO,EAAE,EAAE,kBAAC,OAAC,OAAO,CAAC,OAAO,mCAAI,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,GAAA,CACtD,CACF,CAAC;IACF,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;;;QACzD,MAAM,KAAK,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,OAAC,OAAO,CAAC,OAAO,mCAAI,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACjE,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO,CAAC,KAAK,KAAK,KAAK,IAAI,QAAQ,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,OAAC,KAAK,CAAC,QAAQ,mCAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,kBACxD,SAAS,CAAC,QAAQ,CAAC,QAAQ,OAAC,OAAO,CAAC,OAAO,mCAAI,OAAO,CAAC,IAAI,CAAC,GAAA,CAC7D,CAAC;QACF,MAAM,KAAK,GAAG,OAAO;YACnB,CAAC,CAAC,OAAO,CAAC,KAAK;gBACb,CAAC,CAAC,gBAAgB,UAAU,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,mBAAmB,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG;gBACpH,CAAC,CAAC,KAAK,MAAA,OAAO,CAAC,OAAO,mCAAI,GAAG,OAAO,CAAC,IAAI,YAAY,EAAE;YACzD,CAAC,CAAC,KAAK,MAAA,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,mCAAI,WAAW,EAAE,CAAC;QACtD,mEAAmE;QACnE,gEAAgE;QAChE,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO;YAC/B,CAAC,CAAC,OAAC,QAAQ,CAAC,MAAM,mCAAI,EAAE,CAAC,CAAC,MAAM,CAC5B,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO,CAC7C;YACH,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO;YAC7B,CAAC,CAAC,MAAA,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,0CAAE,IAAI,CAAC,CAAC,CAAC;YAC3D,CAAC,CAAC,MAAA,QAAQ,CAAC,IAAI,0CAAE,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAChE,MAAM,KAAK,GAAG;YACZ,KAAK;YACL,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,QAAQ,CAAC,MAAM;gBACpC,CAAC,CAAC;oBACE,SAAS;wBACP,CAAC,CAAC,cAAc,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC,MAAM,EAAE;wBAC1D,CAAC,CAAC,cAAc;iBACnB;gBACH,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,KAAK;gBACP,CAAC,CAAC;oBACE,OAAO;wBACL,CAAC,CAAC,YAAY,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE;wBACnD,CAAC,CAAC,YAAY;iBACjB;gBACH,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;QACF,OAAO;YACL,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;YAC3C,GAAG,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK;gBAC3B,CAAC,CAAC;oBACE,GAAG,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE;iBACzE;gBACH,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO;QAC9B,CAAC,CAAC;YACE,KAAK,GAAG,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE;YAClD,GAAG,MAAM,KAAK,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE;SACtC;QACH,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;QACL,IAAI;QACJ,GAAG,QAAQ;QACX,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC1E,GAAG,MAAM;QACT,KAAK,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE;QACjC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACzD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,aAAa,GAA2B;IAC5C,MAAM,EAAE,iBAAiB;IACzB,QAAQ,EAAE,sBAAsB;IAChC,OAAO,EAAE,8BAA8B;CACxC,CAAC;AAEF,SAAS,YAAY,CAAC,IAAiB;;IACrC,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,SAAS;YACnB,CAAC,CAAC,wBAAwB;YAC1B,CAAC,CAAC,4BAA4B,CAAC;IACnC,CAAC;IACD,MAAM,GAAG,GACP,IAAI,CAAC,GAAG,KAAK,QAAQ;QACnB,CAAC,CAAC,uBAAuB;QACzB,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,QAAQ;YACrB,CAAC,CAAC,OAAO,MAAA,IAAI,CAAC,SAAS,mCAAI,oBAAoB,wBAAwB;YACvE,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,MAAM;gBACnB,CAAC,CAAC,qBAAqB;gBACvB,CAAC,CAAC,IAAI,CAAC;IACf,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,MAAM,MAAM,GACV,IAAI,CAAC,GAAG,KAAK,QAAQ,IAAI,IAAI,CAAC,SAAS;YACrC,CAAC,CAAC,cAAc,IAAI,CAAC,SAAS,EAAE;YAChC,CAAC,CAAC,EAAE,CAAC;QACT,MAAM,QAAQ,GACZ,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,eAAe;YAC5C,CAAC,CAAC,KAAK,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG;YACnC,CAAC,CAAC,EAAE,CAAC;QACT,OAAO,KAAK,GAAG,aAAH,GAAG,cAAH,GAAG,GAAI,WAAW,GAAG,MAAM,GAAG,QAAQ,EAAE,CAAC;IACvD,CAAC;IACD,MAAM,MAAM,GAAG,YAAY,OAAC,IAAI,CAAC,MAAM,mCAAI,eAAe,CAAC,CAAC;IAC5D,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;AACrF,CAAC","sourcesContent":["import type {\n  AgentRunSummary,\n  ChannelRequirement,\n  Requirement,\n  TeamAgentEntry,\n  TeamAgentHold,\n  TeamIntegrationEvent,\n} from '@ekanos/integration-schema';\n\nimport { type ScopeFacts, scopeFix, scopeHiddenWords } from './scope-notice';\n\n/**\n * \"Is this agent live on this team, and if not, why?\" — one answer for\n * `teams agents show` and the summary line of `teams agents list`, built only\n * from what the host already reports (CLI audit 2026-10-19, §3).\n *\n * Live is: on, on a published version, every connection it needs made,\n * access confirmed by the person it runs as, at least one trigger on, and\n * every trigger's events able to reach it. Each gap is a step with one fix,\n * in the order they have to be done; the first step's fix is \"Next\".\n *\n * An agent HELD on an earlier version (a newer one reaches further than the\n * person it runs as confirmed) is still live — it runs the version it is on\n * — so the hold is not a step: it is `pending`, said beside \"Live\", and its\n * confirm command is \"Next\" once nothing else is.\n */\n\nconst CLI = 'npx @ekanos/cli';\n\nexport interface ReadinessStep {\n  /** What is missing, in words. */\n  problem: string;\n  /** The one command (or app step) that fixes it. */\n  fix: string;\n}\n\nexport interface AgentReadiness {\n  live: boolean;\n  steps: ReadinessStep[];\n  /**\n   * An update waiting for the runs-as person's confirmation; the agent runs\n   * its current version meanwhile. Null when none.\n   */\n  pending: ReadinessStep | null;\n  /** The first step's fix, else the pending update's; null when neither. */\n  next: string | null;\n}\n\nexport interface ReadinessTarget {\n  team: string;\n  source: string;\n}\n\nexport function agentReadiness(\n  entry: TeamAgentEntry,\n  target: ReadinessTarget,\n): AgentReadiness {\n  const steps = readinessSteps(entry, target);\n  const pending = pendingUpdate(entry, target);\n  return {\n    live: steps.length === 0,\n    steps,\n    pending,\n    next: steps[0]?.fix ?? pending?.fix ?? null,\n  };\n}\n\n/** The update a held agent waits for, and who confirms it. */\nfunction pendingUpdate(\n  entry: TeamAgentEntry,\n  { team, source }: ReadinessTarget,\n): ReadinessStep | null {\n  const agent = entry.agent;\n  if (!agent?.held) return null;\n  const who = agent.runsAs ?? 'the person it runs as';\n  return {\n    problem: `held on v${agent.version ?? '?'}: v${agent.held.waiting} ${describeHold(agent.held)}, and waits for ${who} to confirm`,\n    // Only that person can confirm, signed in as themselves.\n    fix: `${who} runs: ${CLI} teams agents confirm ${team} ${entry.key} --source ${source}  (or confirms in the app: Agents › ${entry.name} › Setup)`,\n  };\n}\n\n/**\n * What a waiting version adds over the one running, in words:\n * \"adds zendesk_update_ticket; lets zendesk_add_tag run without approval\".\n */\nexport function describeHold(hold: TeamAgentHold): string {\n  const adds = [\n    ...(hold.adds.scope === 'all'\n      ? ['every tool of the products it can reach']\n      : hold.adds.scope === 'read_only'\n        ? ['every read of the products it can reach']\n        : []),\n    ...hold.adds.products.map((product) => `${product.name} (every tool)`),\n    ...hold.adds.tools,\n  ];\n  const loosens = [\n    ...(hold.loosens.writes ? ['writes'] : []),\n    ...(hold.loosens.reads ? ['reads'] : []),\n    ...hold.loosens.tools,\n  ];\n  const parts = [\n    ...(adds.length > 0 ? [`adds ${adds.join(', ')}`] : []),\n    ...(loosens.length > 0\n      ? [`lets ${loosens.join(', ')} run without approval`]\n      : []),\n  ];\n  return parts.length > 0 ? parts.join('; ') : 'reaches further';\n}\n\nfunction readinessSteps(\n  entry: TeamAgentEntry,\n  { team, source }: ReadinessTarget,\n): ReadinessStep[] {\n  const enable = `${CLI} teams agents enable ${team} ${entry.key} --source ${source}`;\n  const agent = entry.agent;\n  if (!agent) return [{ problem: `off for ${team}`, fix: enable }];\n  if (agent.status !== 'active') {\n    return [{ problem: `${agent.status} for ${team}`, fix: enable }];\n  }\n\n  const steps: ReadinessStep[] = [];\n  if (agent.draft) {\n    // A team testing a draft runs it only when started by hand.\n    steps.push({\n      problem: `testing unpublished draft v${agent.version ?? '?'}: its triggers do not start it`,\n      fix: `${CLI} agents publish ${entry.key} --source ${source}`,\n    });\n  } else if (agent.version === null) {\n    steps.push({\n      problem: 'no published version',\n      fix: `${CLI} agents publish ${entry.key} --source ${source}`,\n    });\n  }\n  for (const item of agent.missing) {\n    steps.push({\n      problem: `${item.name}: ${REASON_WORDS[item.reason ?? 'not_connected']}`,\n      fix:\n        requirementFix(item, team, source) ??\n        `${CLI} teams mcp status ${team} ${item.key} --source ${source}`,\n    });\n  }\n  if (!agent.accessConfirmed) {\n    const who = agent.runsAs ?? 'the person it runs as';\n    steps.push({\n      problem: `${who} has not confirmed it may use their connections`,\n      // Only that person can confirm, signed in as themselves.\n      fix: `${who} runs: ${CLI} teams agents confirm ${team} ${entry.key} --source ${source}  (or confirms in the app: Agents › ${entry.name} › Setup)`,\n    });\n  }\n  if (!agent.triggers.some((trigger) => trigger.enabled)) {\n    steps.push({\n      problem: 'no trigger is on, so it only runs when started by hand',\n      fix: `${CLI} teams triggers add ${team} ${entry.key} event <event-id> --source ${source}  (event ids: ${CLI} catalog --source ${source})`,\n    });\n  }\n  for (const channel of agent.channels ?? []) {\n    if (channel.ready) continue;\n    steps.push({\n      problem: channel.problem ?? `${channel.name} not ready`,\n      fix: channelFix(channel, team, source),\n    });\n  }\n  return steps;\n}\n\nexport const REASON_WORDS: Record<\n  NonNullable<Requirement['reason']>,\n  string\n> = {\n  not_connected: 'not connected',\n  no_route: 'no route maps the Source connection’s events to this team',\n  source_unsupported: 'the integration no longer supports a Source connection',\n  source_not_entitled: 'the product is not enabled for the Source',\n  source_not_connected: 'the Source connection is not made',\n};\n\n/** The one command that makes a requirement, or null when none can. */\nexport function requirementFix(\n  item: Requirement,\n  team: string,\n  source: string,\n): string | null {\n  if (item.kind === 'mcp') return null;\n  switch (item.reason) {\n    case 'no_route':\n      return `${CLI} routes set ${item.key} <value> ${team} --source ${source}  (values: ${CLI} routes options ${item.key} --source ${source})`;\n    case 'source_not_connected':\n      return `${CLI} apps connect ${item.key} --source ${source}`;\n    case 'source_not_entitled':\n      return `a super-admin enables it for the Source (${CLI} sources products --source ${source})`;\n    case 'source_unsupported':\n      return `set connections.${item.key}.owner to \"team\" in agent.json, then ${CLI} agents apply`;\n    default:\n      if (item.connected) return null;\n      // A per-person product is the runs-as person's connection, not the\n      // caller's: connecting your own leaves the agent missing it.\n      return item.via === 'person' && item.viaDetail\n        ? `${CLI} teams connect ${team} ${item.key} --as ${item.viaDetail} --source ${source}`\n        : `${CLI} teams connect ${team} ${item.key} --source ${source}`;\n  }\n}\n\n/** The one command that makes a channel ready, or the app step. */\nexport function channelFix(\n  channel: ChannelRequirement,\n  team: string,\n  source: string,\n): string {\n  switch (channel.arrival) {\n    case 'team-webhook':\n      return `${CLI} teams webhook ${team} ${channel.product} --source ${source}`;\n    case 'source-route':\n      return channel.webhook\n        ? `${CLI} routes set ${channel.product} <value> ${team} --source ${source}  (values: ${CLI} routes options ${channel.product} --source ${source})`\n        : `${CLI} routes webhook ${channel.product} --source ${source}`;\n    default:\n      return channel.connectionId\n        ? `${CLI} teams connect ${team} ${channel.product} --connection ${channel.connectionId} --source ${source}`\n        : channel.key === 'slack' || channel.key === 'linear-app'\n          ? `${CLI} teams connect ${team} ${channel.key} --source ${source}`\n          : `install it on the agent's Triggers tab in the app`;\n  }\n}\n\n/** How the events of a ready channel reach the agent. */\nexport function reachedVia(channel: ChannelRequirement): string {\n  switch (channel.arrival) {\n    case 'team-webhook':\n      return 'team webhook';\n    case 'source-route':\n      return 'Source webhook, routed';\n    default:\n      return `${channel.name} installed`;\n  }\n}\n\n/** A fix as a line: a command is run in the terminal, an app step is not. */\nexport function fixLine(fix: string): string {\n  return fix.startsWith(CLI) ? `in your terminal: ${fix}` : fix;\n}\n\n/**\n * \"Live: yes\" or \"Live: no — N steps left\", and an update waiting for\n * confirmation: \"Live: yes (on v4; v5 waiting for confirmation)\".\n */\nexport function liveLine(\n  readiness: AgentReadiness,\n  agent?: { version: number | null; held?: TeamAgentHold | null } | null,\n): string {\n  const left = readiness.steps.length;\n  const held = agent?.held\n    ? ` (on v${agent.version ?? '?'}; v${agent.held.waiting} waiting for confirmation)`\n    : '';\n  return readiness.live\n    ? `Live: yes${held}`\n    : `Live: no — ${left} step${left === 1 ? '' : 's'} left${held}`;\n}\n\n/* ---------------------------------------------------------------------- */\n/* teams agents show                                                       */\n/* ---------------------------------------------------------------------- */\n\n/** What happened lately, read alongside the agent; each part optional. */\nexport interface AgentActivity {\n  /** The agent's recent runs, newest first. */\n  runs: AgentRunSummary[] | null;\n  /** The team's recent integration events, newest first. */\n  events: TeamIntegrationEvent[] | null;\n}\n\n/**\n * One line per product, per trigger, then Live and Next. A product the\n * team's product scopes hide from it in the app says so — connected or not,\n * the team cannot see it there (`scope`, the team's scopes).\n */\nexport function describeAgentReadiness(\n  entry: TeamAgentEntry,\n  target: ReadinessTarget,\n  readiness: AgentReadiness,\n  activity: AgentActivity,\n  scope?: ScopeFacts,\n): string {\n  const agent = entry.agent;\n  if (!agent) {\n    return [\n      `${entry.key} on ${target.team} · off · v${entry.publishedVersion ?? '?'} published`,\n      `  ${liveLine(readiness)}`,\n      `  Next: ${readiness.next}`,\n    ].join('\\n');\n  }\n\n  const head = [\n    `${entry.key} on ${target.team}`,\n    agent.draft\n      ? `draft v${agent.version ?? '?'} (testing, unpublished)`\n      : agent.held\n        ? `held on v${agent.version ?? '?'}, v${agent.held.waiting} waiting for confirmation`\n        : `v${agent.version ?? '?'} (${agent.pinned ? 'pinned' : 'following'})`,\n    ...(agent.status === 'active' ? [] : [agent.status]),\n    `runs as ${agent.runsAs ?? 'nobody'}`,\n    agent.accessConfirmed ? '✓ access confirmed' : '✗ access not confirmed',\n  ].join(' · ');\n\n  const width = Math.max(\n    8,\n    ...agent.requirements.map((item) => item.key.length),\n  );\n  const pad = (label: string) => label.padEnd(width);\n  const indent = ' '.repeat(width + 4);\n\n  const products = agent.requirements.flatMap((item) => {\n    const fix = item.connected\n      ? null\n      : (requirementFix(item, target.team, target.source) ??\n        `${CLI} teams mcp status ${target.team} ${item.key} --source ${target.source}`);\n    const hidden =\n      item.hiddenByScope && scope\n        ? [\n            `${indent}! ${scopeHiddenWords(scope)}`,\n            `${indent}→ ${fixLine(scopeFix(scope, { ...target, product: item.key }))}`,\n          ]\n        : [];\n    return [\n      `  ${pad(item.key)}  ${productState(item)}`,\n      ...(fix ? [`${indent}→ ${fixLine(fix)}`] : []),\n      ...hidden,\n    ];\n  });\n\n  const nameWidth = Math.max(\n    0,\n    ...agent.triggers.map(\n      (trigger) => (trigger.eventId ?? trigger.type).length,\n    ),\n  );\n  const triggers = agent.triggers.flatMap((trigger, index) => {\n    const label = index === 0 ? pad('triggers') : pad('');\n    const name = (trigger.eventId ?? trigger.type).padEnd(nameWidth);\n    if (!trigger.enabled) return [`  ${label}  ${name} (off)`];\n    const channel = (agent.channels ?? []).find((candidate) =>\n      candidate.triggers.includes(trigger.eventId ?? trigger.type),\n    );\n    const reach = channel\n      ? channel.ready\n        ? `✓ reachable (${reachedVia(channel)}${channel.lastDeliveryAt ? `, last delivery ${channel.lastDeliveryAt}` : ''})`\n        : `✗ ${channel.problem ?? `${channel.name} not ready`}`\n      : `✓ ${TRIGGER_REACH[trigger.type] ?? 'reachable'}`;\n    // An event trigger's runs are the ones its own events started; any\n    // other trigger's, the agent's latest run of that trigger type.\n    const ownEvents = trigger.eventId\n      ? (activity.events ?? []).filter(\n          (event) => event.eventId === trigger.eventId,\n        )\n      : [];\n    const lastEvent = ownEvents[0];\n    const lastRun = trigger.eventId\n      ? ownEvents.find((event) => event.runs.length > 0)?.runs[0]\n      : activity.runs?.find((run) => run.trigger === trigger.type);\n    const known = trigger.eventId ? activity.events : activity.runs;\n    const facts = [\n      reach,\n      ...(trigger.eventId && activity.events\n        ? [\n            lastEvent\n              ? `last event ${lastEvent.receivedAt} ${lastEvent.status}`\n              : 'no event yet',\n          ]\n        : []),\n      ...(known\n        ? [\n            lastRun\n              ? `last run ${lastRun.startedAt} ${lastRun.status}`\n              : 'no run yet',\n          ]\n        : []),\n    ];\n    return [\n      `  ${label}  ${name}  ${facts.join(' · ')}`,\n      ...(channel && !channel.ready\n        ? [\n            `${indent}→ ${fixLine(channelFix(channel, target.team, target.source))}`,\n          ]\n        : []),\n    ];\n  });\n\n  const update = readiness.pending\n    ? [\n        `  ${pad('update')}  ${readiness.pending.problem}`,\n        `${indent}→ ${readiness.pending.fix}`,\n      ]\n    : [];\n\n  return [\n    head,\n    ...products,\n    ...(agent.triggers.length > 0 ? triggers : [`  ${pad('triggers')}  none`]),\n    ...update,\n    `  ${liveLine(readiness, agent)}`,\n    ...(readiness.next ? [`  Next: ${readiness.next}`] : []),\n  ].join('\\n');\n}\n\nconst TRIGGER_REACH: Record<string, string> = {\n  manual: 'started by hand',\n  schedule: 'runs on its schedule',\n  webhook: 'reachable at its trigger URL',\n};\n\nfunction productState(item: Requirement): string {\n  if (item.kind === 'mcp') {\n    return item.connected\n      ? '✓ MCP server connected'\n      : '✗ MCP server not signed in';\n  }\n  const via =\n    item.via === 'source'\n      ? 'via Source connection'\n      : item.via === 'person'\n        ? `via ${item.viaDetail ?? 'the runs-as person'}'s personal connection`\n        : item.via === 'team'\n          ? 'via team connection'\n          : null;\n  if (item.connected) {\n    const routes =\n      item.via === 'source' && item.viaDetail\n        ? ` · routes: ${item.viaDetail}`\n        : '';\n    const fallback =\n      item.reason && item.reason !== 'not_connected'\n        ? ` (${REASON_WORDS[item.reason]})`\n        : '';\n    return `✓ ${via ?? 'connected'}${routes}${fallback}`;\n  }\n  const reason = REASON_WORDS[item.reason ?? 'not_connected'];\n  return `✗ ${via ? `${via} — ` : ''}${reason}${item.required ? '' : ' (optional)'}`;\n}\n"]}
+{"version":3,"file":"team-agent-readiness.js","sourceRoot":"","sources":["../../src/commands/team-agent-readiness.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  AgentRunSummary,\n  ChannelRequirement,\n  Requirement,\n  TeamAgentEntry,\n  TeamAgentHold,\n  TeamIntegrationEvent,\n} from '@ekanos/integration-schema';\n\nimport { cli } from '../invocation';\nimport { type ScopeFacts, scopeFix, scopeHiddenWords } from './scope-notice';\n\n/**\n * \"Is this agent live on this team, and if not, why?\" — one answer for\n * `teams agents show` and the summary line of `teams agents list`, built only\n * from what the host already reports (CLI audit 2026-10-19, §3).\n *\n * Live is: on, on a published version, every connection it needs made,\n * access confirmed by someone who sets it up (a team manager or the Source\n * admin, plan 247.2), at least one trigger on, and every trigger's events\n * able to reach it. Each gap is a step with one fix, in the order they have\n * to be done; the first step's fix is \"Next\". A publish holds no team, so\n * there is no update waiting.\n */\n\nexport interface ReadinessStep {\n  /** What is missing, in words. */\n  problem: string;\n  /** The one command (or app step) that fixes it. */\n  fix: string;\n}\n\nexport interface AgentReadiness {\n  live: boolean;\n  steps: ReadinessStep[];\n  /** The first step's fix; null when there is none. */\n  next: string | null;\n}\n\nexport interface ReadinessTarget {\n  team: string;\n  source: string;\n}\n\nexport function agentReadiness(\n  entry: TeamAgentEntry,\n  target: ReadinessTarget,\n): AgentReadiness {\n  const steps = readinessSteps(entry, target);\n  return {\n    live: steps.length === 0,\n    steps,\n    next: steps[0]?.fix ?? null,\n  };\n}\n\n/**\n * What a newer version adds over the one a team runs, in words (a publish's\n * report of the teams pinned to another version):\n * \"adds zendesk_update_ticket; lets zendesk_add_tag run without approval\".\n */\nexport function describeHold(hold: TeamAgentHold): string {\n  const adds = [\n    ...(hold.adds.scope === 'all'\n      ? ['every tool of the products it can reach']\n      : hold.adds.scope === 'read_only'\n        ? ['every read of the products it can reach']\n        : []),\n    ...hold.adds.products.map((product) => `${product.name} (every tool)`),\n    ...hold.adds.tools,\n  ];\n  const loosens = [\n    ...(hold.loosens.writes ? ['writes'] : []),\n    ...(hold.loosens.reads ? ['reads'] : []),\n    ...hold.loosens.tools,\n  ];\n  const parts = [\n    ...(adds.length > 0 ? [`adds ${adds.join(', ')}`] : []),\n    ...(loosens.length > 0\n      ? [`lets ${loosens.join(', ')} run without approval`]\n      : []),\n  ];\n  return parts.length > 0 ? parts.join('; ') : 'reaches further';\n}\n\nfunction readinessSteps(\n  entry: TeamAgentEntry,\n  { team, source }: ReadinessTarget,\n): ReadinessStep[] {\n  const enable = `${cli()} teams agents enable ${team} ${entry.key} --source ${source}`;\n  const agent = entry.agent;\n  if (!agent) return [{ problem: `off for ${team}`, fix: enable }];\n  if (agent.status !== 'active') {\n    return [{ problem: `${agent.status} for ${team}`, fix: enable }];\n  }\n\n  const steps: ReadinessStep[] = [];\n  if (agent.draft) {\n    // A team testing a draft runs it only when started by hand.\n    steps.push({\n      problem: `testing unpublished draft v${agent.version ?? '?'}: its triggers do not start it`,\n      fix: `${cli()} agents publish ${entry.key} --source ${source}`,\n    });\n  } else if (agent.version === null) {\n    steps.push({\n      problem: 'no published version',\n      fix: `${cli()} agents publish ${entry.key} --source ${source}`,\n    });\n  }\n  for (const item of agent.missing) {\n    steps.push({\n      problem: `${item.name}: ${REASON_WORDS[item.reason ?? 'not_connected']}`,\n      fix:\n        requirementFix(item, team, source) ??\n        `${cli()} teams mcp status ${team} ${item.key} --source ${source}`,\n    });\n  }\n  if (!agent.accessConfirmed) {\n    steps.push({\n      problem: 'nobody has confirmed what it may use',\n      // Whoever sets it up confirms, as themselves: the Source admin here,\n      // or a team manager in the app (plan 247.2).\n      fix: `${cli()} teams agents confirm ${team} ${entry.key} --source ${source}  (or a team manager confirms in the app: Agents › ${entry.name} › Setup)`,\n    });\n  }\n  if (!agent.triggers.some((trigger) => trigger.enabled)) {\n    steps.push({\n      problem: 'no trigger is on, so it only runs when started by hand',\n      fix: `${cli()} teams triggers add ${team} ${entry.key} event <event-id> --source ${source}  (event ids: ${cli()} catalog --source ${source})`,\n    });\n  }\n  for (const channel of agent.channels ?? []) {\n    if (channel.ready) continue;\n    steps.push({\n      problem: channel.problem ?? `${channel.name} not ready`,\n      fix: channelFix(channel, team, source),\n    });\n  }\n  return steps;\n}\n\nexport const REASON_WORDS: Record<\n  NonNullable<Requirement['reason']>,\n  string\n> = {\n  not_connected: 'not connected',\n  no_route: 'no route maps the Source connection’s events to this team',\n  source_unsupported: 'the integration no longer supports a Source connection',\n  source_not_entitled: 'the product is not enabled for the Source',\n  source_not_connected: 'the Source connection is not made',\n};\n\n/** The one command that makes a requirement, or null when none can. */\nexport function requirementFix(\n  item: Requirement,\n  team: string,\n  source: string,\n): string | null {\n  if (item.kind === 'mcp') return null;\n  switch (item.reason) {\n    case 'no_route':\n      return `${cli()} routes set ${item.key} <value> ${team} --source ${source}  (values: ${cli()} routes options ${item.key} --source ${source})`;\n    case 'source_not_connected':\n      return `${cli()} apps connect ${item.key} --source ${source}`;\n    case 'source_not_entitled':\n      return `a super-admin enables it for the Source (${cli()} sources products --source ${source})`;\n    case 'source_unsupported':\n      return `set connections.${item.key}.owner to \"team\" in agent.json, then ${cli()} agents apply`;\n    default:\n      if (item.connected) return null;\n      // A per-person product is the runs-as person's connection, not the\n      // caller's: connecting your own leaves the agent missing it.\n      return item.via === 'person' && item.viaDetail\n        ? `${cli()} teams connect ${team} ${item.key} --as ${item.viaDetail} --source ${source}`\n        : `${cli()} teams connect ${team} ${item.key} --source ${source}`;\n  }\n}\n\n/**\n * The one command that makes a channel ready. An older host sends no\n * `arrival`: the channel's key (`<product>:webhook`, `<product>:route`,\n * `<product>:<connection>`) still says which command it is.\n */\nexport function channelFix(\n  channel: ChannelRequirement,\n  team: string,\n  source: string,\n): string {\n  const suffix = channel.key.includes(':') ? channel.key.split(':')[1] : null;\n  const arrival =\n    channel.arrival ??\n    (suffix === 'webhook'\n      ? 'team-webhook'\n      : suffix === 'route'\n        ? 'source-route'\n        : 'install');\n  switch (arrival) {\n    case 'team-webhook':\n      return `${cli()} teams webhook ${team} ${channel.product} --source ${source}`;\n    case 'source-route':\n      return channel.webhook\n        ? `${cli()} routes set ${channel.product} <value> ${team} --source ${source}  (values: ${cli()} routes options ${channel.product} --source ${source})`\n        : `${cli()} routes webhook ${channel.product} --source ${source}`;\n    default: {\n      if (channel.key === 'slack' || channel.key === 'linear-app') {\n        return `${cli()} teams connect ${team} ${channel.key} --source ${source}`;\n      }\n      const connection = channel.connectionId ?? suffix;\n      return `${cli()} teams connect ${team} ${channel.product}${connection ? ` --connection ${connection}` : ''} --source ${source}`;\n    }\n  }\n}\n\n/** How the events of a ready channel reach the agent. */\nexport function reachedVia(channel: ChannelRequirement): string {\n  switch (channel.arrival) {\n    case 'team-webhook':\n      return 'team webhook';\n    case 'source-route':\n      return 'Source webhook, routed';\n    default:\n      return `${channel.name} installed`;\n  }\n}\n\n/** A fix as a line: a command is run in the terminal; anything else is a person's step. */\nexport function fixLine(fix: string): string {\n  return fix.startsWith(cli()) ? `in your terminal: ${fix}` : fix;\n}\n\n/** \"Live: yes\" or \"Live: no — N steps left\". */\nexport function liveLine(readiness: AgentReadiness): string {\n  const left = readiness.steps.length;\n  return readiness.live\n    ? 'Live: yes'\n    : `Live: no — ${left} step${left === 1 ? '' : 's'} left`;\n}\n\n/* ---------------------------------------------------------------------- */\n/* teams agents show                                                       */\n/* ---------------------------------------------------------------------- */\n\n/** What happened lately, read alongside the agent; each part optional. */\nexport interface AgentActivity {\n  /** The agent's recent runs, newest first. */\n  runs: AgentRunSummary[] | null;\n  /** The team's recent integration events, newest first. */\n  events: TeamIntegrationEvent[] | null;\n}\n\n/**\n * One line per product, per trigger, then Live and Next. A product the\n * team's product scopes hide from it in the app says so — connected or not,\n * the team cannot see it there (`scope`, the team's scopes).\n */\nexport function describeAgentReadiness(\n  entry: TeamAgentEntry,\n  target: ReadinessTarget,\n  readiness: AgentReadiness,\n  activity: AgentActivity,\n  scope?: ScopeFacts,\n): string {\n  const agent = entry.agent;\n  if (!agent) {\n    return [\n      `${entry.key} on ${target.team} · off · v${entry.publishedVersion ?? '?'} published`,\n      `  ${liveLine(readiness)}`,\n      `  Next: ${readiness.next}`,\n    ].join('\\n');\n  }\n\n  const head = [\n    `${entry.key} on ${target.team}`,\n    agent.draft\n      ? `draft v${agent.version ?? '?'} (testing, unpublished)`\n      : `v${agent.version ?? '?'} (${agent.pinned ? 'pinned' : 'following'})`,\n    ...(agent.status === 'active' ? [] : [agent.status]),\n    `runs as ${agent.runsAs ?? 'nobody'}`,\n    agent.accessConfirmed ? '✓ access confirmed' : '✗ access not confirmed',\n  ].join(' · ');\n\n  const width = Math.max(\n    8,\n    ...agent.requirements.map((item) => item.key.length),\n  );\n  const pad = (label: string) => label.padEnd(width);\n  const indent = ' '.repeat(width + 4);\n\n  const products = agent.requirements.flatMap((item) => {\n    const fix = item.connected\n      ? null\n      : (requirementFix(item, target.team, target.source) ??\n        `${cli()} teams mcp status ${target.team} ${item.key} --source ${target.source}`);\n    const hidden =\n      item.hiddenByScope && scope\n        ? [\n            `${indent}! ${scopeHiddenWords(scope)}`,\n            `${indent}→ ${fixLine(scopeFix(scope, { ...target, product: item.key }))}`,\n          ]\n        : [];\n    return [\n      `  ${pad(item.key)}  ${productState(item)}`,\n      ...(fix ? [`${indent}→ ${fixLine(fix)}`] : []),\n      ...hidden,\n    ];\n  });\n\n  const nameWidth = Math.max(\n    0,\n    ...agent.triggers.map(\n      (trigger) => (trigger.eventId ?? trigger.type).length,\n    ),\n  );\n  const triggers = agent.triggers.flatMap((trigger, index) => {\n    const label = index === 0 ? pad('triggers') : pad('');\n    const name = (trigger.eventId ?? trigger.type).padEnd(nameWidth);\n    if (!trigger.enabled) return [`  ${label}  ${name} (off)`];\n    const channel = (agent.channels ?? []).find((candidate) =>\n      candidate.triggers.includes(trigger.eventId ?? trigger.type),\n    );\n    const reach = channel\n      ? channel.ready\n        ? `✓ reachable (${reachedVia(channel)}${channel.lastDeliveryAt ? `, last delivery ${channel.lastDeliveryAt}` : ''})`\n        : `✗ ${channel.problem ?? `${channel.name} not ready`}`\n      : `✓ ${TRIGGER_REACH[trigger.type] ?? 'reachable'}`;\n    // An event trigger's runs are the ones its own events started; any\n    // other trigger's, the agent's latest run of that trigger type.\n    const ownEvents = trigger.eventId\n      ? (activity.events ?? []).filter(\n          (event) => event.eventId === trigger.eventId,\n        )\n      : [];\n    const lastEvent = ownEvents[0];\n    const lastRun = trigger.eventId\n      ? ownEvents.find((event) => event.runs.length > 0)?.runs[0]\n      : activity.runs?.find((run) => run.trigger === trigger.type);\n    const known = trigger.eventId ? activity.events : activity.runs;\n    const facts = [\n      reach,\n      ...(trigger.eventId && activity.events\n        ? [\n            lastEvent\n              ? `last event ${lastEvent.receivedAt} ${lastEvent.status}`\n              : 'no event yet',\n          ]\n        : []),\n      ...(known\n        ? [\n            lastRun\n              ? `last run ${lastRun.startedAt} ${lastRun.status}`\n              : 'no run yet',\n          ]\n        : []),\n    ];\n    return [\n      `  ${label}  ${name}  ${facts.join(' · ')}`,\n      ...(channel && !channel.ready\n        ? [\n            `${indent}→ ${fixLine(channelFix(channel, target.team, target.source))}`,\n          ]\n        : []),\n    ];\n  });\n\n  return [\n    head,\n    ...products,\n    ...(agent.triggers.length > 0 ? triggers : [`  ${pad('triggers')}  none`]),\n    `  ${liveLine(readiness)}`,\n    ...(readiness.next ? [`  Next: ${readiness.next}`] : []),\n  ].join('\\n');\n}\n\nconst TRIGGER_REACH: Record<string, string> = {\n  manual: 'started by hand',\n  schedule: 'runs on its schedule',\n  webhook: 'reachable at its trigger URL',\n};\n\nfunction productState(item: Requirement): string {\n  if (item.kind === 'mcp') {\n    return item.connected\n      ? '✓ MCP server connected'\n      : '✗ MCP server not signed in';\n  }\n  const via =\n    item.via === 'source'\n      ? 'via Source connection'\n      : item.via === 'person'\n        ? `via ${item.viaDetail ?? 'the runs-as person'}'s personal connection`\n        : item.via === 'team'\n          ? 'via team connection'\n          : null;\n  if (item.connected) {\n    const routes =\n      item.via === 'source' && item.viaDetail\n        ? ` · routes: ${item.viaDetail}`\n        : '';\n    const fallback =\n      item.reason && item.reason !== 'not_connected'\n        ? ` (${REASON_WORDS[item.reason]})`\n        : '';\n    return `✓ ${via ?? 'connected'}${routes}${fallback}`;\n  }\n  const reason = REASON_WORDS[item.reason ?? 'not_connected'];\n  return `✗ ${via ? `${via} — ` : ''}${reason}${item.required ? '' : ' (optional)'}`;\n}\n"]}

package/dist/commands/team-agents-agents.d.ts

@@ -3,13 +3,16 @@ import type { CliContext } from '../context.js';
 import type { ExitCode } from '../exit-codes.js';
 import { type TeamAgentRun } from './team-agents.js';
 /**
- * `ekanos teams agents list|show|enable|confirm|disable|pin|unpin|policy|skills` —
+ * `ekanos teams agents list|show|create|apply|enable|confirm|disable|archive|unarchive|pin|unpin|policy|skills|tags` —
  * a team's provided agents, turned on, versioned, given an approval policy
- * and skills by the Source admin. `enable|pin … --draft` puts one team on
+ * and skills by the Source admin; and the team's own and personal agents,
+ * made and changed from an agent.json with `create|apply`
+ * (team-agents-define.ts), turned on with `enable`. A personal agent is
+ * listed and shown to everyone, and changed by its creator alone. `enable|pin … --draft` puts one team on
  * the template's latest, unpublished version to test it there before
- * publishing. `confirm` (and `--confirm-access`) is the one thing only the
- * person the agent runs as can do: consent, as themselves, that it may use
- * their connections in runs no one watches.
+ * publishing. `confirm` (and `--confirm-access`) records the caller's own
+ * confirmation that it may use its connections in runs no one watches:
+ * whoever sets an agent up confirms it (plan 247.2), never a member.
  * `show` answers "is this agent live, and if not, why?" for one agent; `list`
  * ends each agent with the same verdict.
  */