@ekanos/cli 0.13.0 → 0.15.0

package/dist/commands/teams-overview.d.ts

@@ -0,0 +1,11 @@
+import type { CliContext } from '../context.js';
+import type { ExitCode } from '../exit-codes.js';
+import type { TeamsClient } from './teams.js';
+/**
+ * `ekanos teams show <team>` with no product: one screen per team (CLI audit
+ * P1-7) — its members, one line per Integration the Source has enabled (whose
+ * connection, or the step to make it), and one line per provided agent with
+ * the same verdict as `teams agents show`. Reads the team list, the Source
+ * catalog, the team's agents, and each enabled Integration's status.
+ */
+export declare function runTeamOverview(ctx: CliContext, client: TeamsClient, host: string, source: string, team: string): Promise<ExitCode>;

package/dist/commands/teams-overview.js

@@ -0,0 +1,160 @@
+import { SourceCatalogSchema, TeamAgentListSchema, } from '@ekanos/integration-schema';
+import { notFoundError } from '../errors.js';
+import { call, listTeams, showTeamIntegration } from '../teams-api.js';
+import { scopeFix, scopeHiddenWords } from './scope-notice.js';
+import { REASON_WORDS, agentReadiness, liveLine, requirementFix, } from './team-agent-readiness.js';
+/**
+ * `ekanos teams show <team>` with no product: one screen per team (CLI audit
+ * P1-7) — its members, one line per Integration the Source has enabled (whose
+ * connection, or the step to make it), and one line per provided agent with
+ * the same verdict as `teams agents show`. Reads the team list, the Source
+ * catalog, the team's agents, and each enabled Integration's status.
+ */
+export async function runTeamOverview(ctx, client, host, source, team) {
+    var _a;
+    var _b;
+    const [teams, catalog, agents] = await Promise.all([
+        client.call((token) => listTeams(host, token, source)),
+        client.call((token) => call(host, token, SourceCatalogSchema, {
+            method: 'GET',
+            path: '/api/partner/catalog',
+            source,
+        })),
+        client.call((token) => call(host, token, TeamAgentListSchema, {
+            method: 'GET',
+            path: `/api/partner/teams/${encodeURIComponent(team)}/agents`,
+            source,
+        })),
+    ]);
+    const ref = teams.teams.find((entry) => entry.slug === team);
+    if (!ref) {
+        throw notFoundError(`No team "${team}" on ${teams.source.slug}.`, 'Run "ekanos teams list" to see the teams on this Source.');
+    }
+    const integrations = catalog.products.filter((product) => product.kind === 'integration' && product.availability === 'enabled');
+    const statuses = await inBatches(integrations, 4, (product) => client.call((token) => showTeamIntegration(host, token, {
+        source,
+        team,
+        product: product.slug,
+    })));
+    // What the team's agents need of each product, and whose connection it is.
+    const needs = new Map();
+    for (const entry of agents.agents) {
+        for (const item of (_b = (_a = entry.agent) === null || _a === void 0 ? void 0 : _a.requirements) !== null && _b !== void 0 ? _b : []) {
+            if (item.kind === 'product' && !needs.has(item.key)) {
+                needs.set(item.key, item);
+            }
+        }
+    }
+    const target = { team, source };
+    const agentRows = agents.agents.map((entry) => { var _a; return ({
+        key: entry.key,
+        name: entry.name,
+        on: ((_a = entry.agent) === null || _a === void 0 ? void 0 : _a.status) === 'active',
+        readiness: agentReadiness(entry, target),
+    }); });
+    const integrationRows = integrations.map((product, index) => ({
+        slug: product.slug,
+        name: product.name,
+        line: withScope(integrationLine(product, statuses[index], needs.get(product.slug), target), statuses[index], Object.assign(Object.assign({}, target), { product: product.slug })),
+    }));
+    const width = Math.max(8, ...integrations.map((product) => product.slug.length), ...agents.agents.map((entry) => entry.key.length));
+    const pad = (label) => label.padEnd(width);
+    const live = agentRows.filter((row) => row.readiness.live).length;
+    return ctx.succeed({
+        host,
+        team: { slug: ref.slug, name: ref.name, memberCount: ref.memberCount },
+        integrations: integrationRows.map((row, index) => { var _a; return ({
+            slug: row.slug,
+            name: row.name,
+            status: statuses[index],
+            agentsNeed: (_a = needs.get(row.slug)) !== null && _a !== void 0 ? _a : null,
+        }); }),
+        agents: agentRows,
+    }, [
+        `${ref.name} (${ref.slug}) · ${ref.memberCount} member${ref.memberCount === 1 ? '' : 's'} · ${agentRows.filter((row) => row.on).length} agent${agentRows.filter((row) => row.on).length === 1 ? '' : 's'} on, ${live} live`,
+        '',
+        'Integrations',
+        ...(integrationRows.length === 0
+            ? ['  none enabled for the Source']
+            : integrationRows.flatMap((row) => [
+                `  ${pad(row.slug)}  ${row.line.state}`,
+                ...(row.line.fix ? [`  ${pad('')}  → ${row.line.fix}`] : []),
+            ])),
+        '',
+        'Agents',
+        ...(agentRows.length === 0
+            ? ['  none provided']
+            : agentRows.map((row) => `  ${pad(row.key)}  ${liveLine(row.readiness)}${row.readiness.next ? ` · Next: ${row.readiness.next}` : ''}`)),
+        '',
+        `"ekanos teams agents show ${team} <key>" explains one agent; "ekanos teams show ${team} <product>" one integration.`,
+    ].join('\n'));
+}
+function integrationLine(product, status, need, target) {
+    var _a;
+    if ((need === null || need === void 0 ? void 0 : need.owner) === 'source' || (need === null || need === void 0 ? void 0 : need.via) === 'source') {
+        const problem = need.reason && need.reason !== 'not_connected'
+            ? REASON_WORDS[need.reason]
+            : null;
+        const state = !need.connected
+            ? `✗ via Source connection — ${problem !== null && problem !== void 0 ? problem : REASON_WORDS.not_connected}`
+            : need.via === 'source'
+                ? `✓ via Source connection${need.viaDetail ? ` · routes: ${need.viaDetail}` : ''}`
+                : `! via team connection (${problem !== null && problem !== void 0 ? problem : 'the Source connection is not used'})`;
+        return {
+            state,
+            fix: need.connected && need.via === 'source'
+                ? null
+                : requirementFix(need, target.team, target.source),
+        };
+    }
+    if (!product.requiresActivation) {
+        return { state: '✓ works as shipped', fix: null };
+    }
+    if (product.scope === 'user') {
+        const person = (need === null || need === void 0 ? void 0 : need.via) === 'person' && need.viaDetail
+            ? need.connected
+                ? ` · ✓ ${need.viaDetail} connected (an agent runs as them)`
+                : ` · ✗ ${need.viaDetail} not connected (an agent runs as them)`
+            : '';
+        return {
+            state: `personal: each person connects their own${person}`,
+            fix: need && !need.connected
+                ? requirementFix(need, target.team, target.source)
+                : null,
+        };
+    }
+    const webhooks = status.teamApps.flatMap((app) => app.webhooks);
+    const made = webhooks.filter((webhook) => webhook.endpoint).length;
+    const webhookNote = webhooks.length > 0 ? ` · webhook URL ${made}/${webhooks.length} made` : '';
+    if (status.activation) {
+        const by = (_a = status.activation.activatedBy) === null || _a === void 0 ? void 0 : _a.email;
+        return {
+            state: `✓ connected${status.activation.activatedAt ? ` ${status.activation.activatedAt.slice(0, 10)}` : ''}${by ? ` by ${by}` : ''}${webhookNote}`,
+            fix: null,
+        };
+    }
+    return {
+        state: `✗ not connected${webhookNote}`,
+        fix: `npx @ekanos/cli teams connect ${target.team} ${product.slug} --source ${target.source}`,
+    };
+}
+/** A product the team's scopes hide from it in the app says so, whatever else is true. */
+function withScope(line, status, target) {
+    var _a;
+    var _b;
+    if (!((_a = status.scope) === null || _a === void 0 ? void 0 : _a.hidden))
+        return line;
+    return {
+        state: `${line.state} · ! ${scopeHiddenWords(status.scope)}`,
+        fix: (_b = line.fix) !== null && _b !== void 0 ? _b : scopeFix(status.scope, target),
+    };
+}
+/** Each item through `read`, at most `size` at a time, in order. */
+async function inBatches(items, size, read) {
+    const results = [];
+    for (let start = 0; start < items.length; start += size) {
+        results.push(...(await Promise.all(items.slice(start, start + size).map(read))));
+    }
+    return results;
+}
+//# sourceMappingURL=teams-overview.js.map

package/dist/commands/teams-overview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teams-overview.js","sourceRoot":"","sources":["../../src/commands/teams-overview.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  type CatalogProduct,\n  type Requirement,\n  SourceCatalogSchema,\n  TeamAgentListSchema,\n  type TeamIntegrationStatus,\n} from '@ekanos/integration-schema';\n\nimport type { CliContext } from '../context';\nimport { notFoundError } from '../errors';\nimport type { ExitCode } from '../exit-codes';\nimport { call, listTeams, showTeamIntegration } from '../teams-api';\nimport { scopeFix, scopeHiddenWords } from './scope-notice';\nimport {\n  REASON_WORDS,\n  agentReadiness,\n  liveLine,\n  requirementFix,\n} from './team-agent-readiness';\nimport type { TeamsClient } from './teams';\n\n/**\n * `ekanos teams show <team>` with no product: one screen per team (CLI audit\n * P1-7) — its members, one line per Integration the Source has enabled (whose\n * connection, or the step to make it), and one line per provided agent with\n * the same verdict as `teams agents show`. Reads the team list, the Source\n * catalog, the team's agents, and each enabled Integration's status.\n */\nexport async function runTeamOverview(\n  ctx: CliContext,\n  client: TeamsClient,\n  host: string,\n  source: string,\n  team: string,\n): Promise<ExitCode> {\n  const [teams, catalog, agents] = await Promise.all([\n    client.call((token) => listTeams(host, token, source)),\n    client.call((token) =>\n      call(host, token, SourceCatalogSchema, {\n        method: 'GET',\n        path: '/api/partner/catalog',\n        source,\n      }),\n    ),\n    client.call((token) =>\n      call(host, token, TeamAgentListSchema, {\n        method: 'GET',\n        path: `/api/partner/teams/${encodeURIComponent(team)}/agents`,\n        source,\n      }),\n    ),\n  ]);\n  const ref = teams.teams.find((entry) => entry.slug === team);\n  if (!ref) {\n    throw notFoundError(\n      `No team \"${team}\" on ${teams.source.slug}.`,\n      'Run \"ekanos teams list\" to see the teams on this Source.',\n    );\n  }\n\n  const integrations = catalog.products.filter(\n    (product) =>\n      product.kind === 'integration' && product.availability === 'enabled',\n  );\n  const statuses = await inBatches(integrations, 4, (product) =>\n    client.call((token) =>\n      showTeamIntegration(host, token, {\n        source,\n        team,\n        product: product.slug,\n      }),\n    ),\n  );\n\n  // What the team's agents need of each product, and whose connection it is.\n  const needs = new Map<string, Requirement>();\n  for (const entry of agents.agents) {\n    for (const item of entry.agent?.requirements ?? []) {\n      if (item.kind === 'product' && !needs.has(item.key)) {\n        needs.set(item.key, item);\n      }\n    }\n  }\n\n  const target = { team, source };\n  const agentRows = agents.agents.map((entry) => ({\n    key: entry.key,\n    name: entry.name,\n    on: entry.agent?.status === 'active',\n    readiness: agentReadiness(entry, target),\n  }));\n  const integrationRows = integrations.map((product, index) => ({\n    slug: product.slug,\n    name: product.name,\n    line: withScope(\n      integrationLine(\n        product,\n        statuses[index]!,\n        needs.get(product.slug),\n        target,\n      ),\n      statuses[index]!,\n      { ...target, product: product.slug },\n    ),\n  }));\n\n  const width = Math.max(\n    8,\n    ...integrations.map((product) => product.slug.length),\n    ...agents.agents.map((entry) => entry.key.length),\n  );\n  const pad = (label: string) => label.padEnd(width);\n  const live = agentRows.filter((row) => row.readiness.live).length;\n\n  return ctx.succeed(\n    {\n      host,\n      team: { slug: ref.slug, name: ref.name, memberCount: ref.memberCount },\n      integrations: integrationRows.map((row, index) => ({\n        slug: row.slug,\n        name: row.name,\n        status: statuses[index],\n        agentsNeed: needs.get(row.slug) ?? null,\n      })),\n      agents: agentRows,\n    },\n    [\n      `${ref.name} (${ref.slug}) · ${ref.memberCount} member${ref.memberCount === 1 ? '' : 's'} · ${agentRows.filter((row) => row.on).length} agent${agentRows.filter((row) => row.on).length === 1 ? '' : 's'} on, ${live} live`,\n      '',\n      'Integrations',\n      ...(integrationRows.length === 0\n        ? ['  none enabled for the Source']\n        : integrationRows.flatMap((row) => [\n            `  ${pad(row.slug)}  ${row.line.state}`,\n            ...(row.line.fix ? [`  ${pad('')}  → ${row.line.fix}`] : []),\n          ])),\n      '',\n      'Agents',\n      ...(agentRows.length === 0\n        ? ['  none provided']\n        : agentRows.map(\n            (row) =>\n              `  ${pad(row.key)}  ${liveLine(row.readiness)}${row.readiness.next ? ` · Next: ${row.readiness.next}` : ''}`,\n          )),\n      '',\n      `\"ekanos teams agents show ${team} <key>\" explains one agent; \"ekanos teams show ${team} <product>\" one integration.`,\n    ].join('\\n'),\n  );\n}\n\nfunction integrationLine(\n  product: CatalogProduct,\n  status: TeamIntegrationStatus,\n  need: Requirement | undefined,\n  target: { team: string; source: string },\n): { state: string; fix: string | null } {\n  if (need?.owner === 'source' || need?.via === 'source') {\n    const problem =\n      need.reason && need.reason !== 'not_connected'\n        ? REASON_WORDS[need.reason]\n        : null;\n    const state = !need.connected\n      ? `✗ via Source connection — ${problem ?? REASON_WORDS.not_connected}`\n      : need.via === 'source'\n        ? `✓ via Source connection${need.viaDetail ? ` · routes: ${need.viaDetail}` : ''}`\n        : `! via team connection (${problem ?? 'the Source connection is not used'})`;\n    return {\n      state,\n      fix:\n        need.connected && need.via === 'source'\n          ? null\n          : requirementFix(need, target.team, target.source),\n    };\n  }\n  if (!product.requiresActivation) {\n    return { state: '✓ works as shipped', fix: null };\n  }\n  if (product.scope === 'user') {\n    const person =\n      need?.via === 'person' && need.viaDetail\n        ? need.connected\n          ? ` · ✓ ${need.viaDetail} connected (an agent runs as them)`\n          : ` · ✗ ${need.viaDetail} not connected (an agent runs as them)`\n        : '';\n    return {\n      state: `personal: each person connects their own${person}`,\n      fix:\n        need && !need.connected\n          ? requirementFix(need, target.team, target.source)\n          : null,\n    };\n  }\n  const webhooks = status.teamApps.flatMap((app) => app.webhooks);\n  const made = webhooks.filter((webhook) => webhook.endpoint).length;\n  const webhookNote =\n    webhooks.length > 0 ? ` · webhook URL ${made}/${webhooks.length} made` : '';\n  if (status.activation) {\n    const by = status.activation.activatedBy?.email;\n    return {\n      state: `✓ connected${status.activation.activatedAt ? ` ${status.activation.activatedAt.slice(0, 10)}` : ''}${by ? ` by ${by}` : ''}${webhookNote}`,\n      fix: null,\n    };\n  }\n  return {\n    state: `✗ not connected${webhookNote}`,\n    fix: `npx @ekanos/cli teams connect ${target.team} ${product.slug} --source ${target.source}`,\n  };\n}\n\n/** A product the team's scopes hide from it in the app says so, whatever else is true. */\nfunction withScope(\n  line: { state: string; fix: string | null },\n  status: TeamIntegrationStatus,\n  target: { team: string; source: string; product: string },\n): { state: string; fix: string | null } {\n  if (!status.scope?.hidden) return line;\n  return {\n    state: `${line.state} · ! ${scopeHiddenWords(status.scope)}`,\n    fix: line.fix ?? scopeFix(status.scope, target),\n  };\n}\n\n/** Each item through `read`, at most `size` at a time, in order. */\nasync function inBatches<T, R>(\n  items: T[],\n  size: number,\n  read: (item: T) => Promise<R>,\n): Promise<R[]> {\n  const results: R[] = [];\n  for (let start = 0; start < items.length; start += size) {\n    results.push(\n      ...(await Promise.all(items.slice(start, start + size).map(read))),\n    );\n  }\n  return results;\n}\n"]}

package/dist/commands/teams-scope.d.ts

@@ -0,0 +1,10 @@
+import type { CliContext } from '../context.js';
+import type { ExitCode } from '../exit-codes.js';
+import { type TeamsArgs } from './teams.js';
+/**
+ * `teams scope show|set <team>` — which of the Source's product scopes a team
+ * holds, and so which products it sees in the app. `set` replaces them
+ * (names or ids); taking one away can hide products the team uses, so that
+ * needs `--yes`. The Source's scopes and their products: `sources scopes`.
+ */
+export declare function runTeamScope(ctx: CliContext, args: TeamsArgs, rest: readonly string[]): Promise<ExitCode>;

package/dist/commands/teams-scope.js

@@ -0,0 +1,109 @@
+import { requireSession, resolveAuthEnvironment } from '../auth/session.js';
+import { invalidStateError, usageError } from '../errors.js';
+import { resolveSourceTarget } from '../source-target.js';
+import { setTeamScopes, showTeamScopes } from '../teams-api.js';
+import { TeamsClient } from './teams.js';
+const USAGE = 'Run "ekanos teams scope show <team>" or "ekanos teams scope set <team> <scope> [<scope>…] [--yes]".';
+/**
+ * `teams scope show|set <team>` — which of the Source's product scopes a team
+ * holds, and so which products it sees in the app. `set` replaces them
+ * (names or ids); taking one away can hide products the team uses, so that
+ * needs `--yes`. The Source's scopes and their products: `sources scopes`.
+ */
+export async function runTeamScope(ctx, args, rest) {
+    const [verb, rawTeam, ...scopes] = rest;
+    if (verb !== 'show' && verb !== 'set') {
+        throw usageError(verb
+            ? `Unknown teams scope subcommand "${verb}".`
+            : 'teams scope needs a subcommand.', USAGE);
+    }
+    const team = rawTeam === null || rawTeam === void 0 ? void 0 : rawTeam.trim().toLowerCase();
+    if (!team || !/^[a-z0-9][a-z0-9-]*$/.test(team)) {
+        throw usageError(rawTeam
+            ? `"${rawTeam}" is not a team slug.`
+            : `teams scope ${verb} needs a team.`, USAGE);
+    }
+    if (verb === 'show' && scopes.length > 0) {
+        throw usageError(`Unexpected argument "${scopes[0]}".`, USAGE);
+    }
+    if (verb === 'set' && scopes.length === 0) {
+        throw usageError('Name the scope (or scopes) the team should hold.', `"ekanos sources scopes" lists them, e.g. "ekanos teams scope set ${team} Gold".`);
+    }
+    const env = resolveAuthEnvironment(ctx, args.host, args.env, {
+        projectDir: args.dir,
+    });
+    const resolved = await resolveSourceTarget(env, requireSession(env), args);
+    const client = new TeamsClient(env, resolved.session);
+    const target = { source: resolved.source, team };
+    const current = await client.call((token) => showTeamScopes(env.host, token, target));
+    if (verb === 'show') {
+        return ctx.succeed(Object.assign({ host: env.host }, current), describe(ctx.ui, current, resolved.source));
+    }
+    const wanted = scopes.map((scope) => scope.trim().toLowerCase());
+    const dropped = current.scopes.filter((scope) => !wanted.includes(scope.name.toLowerCase()) && !wanted.includes(scope.id));
+    if (dropped.length > 0 && !args.yes) {
+        throw invalidStateError(`${team} would no longer hold ${dropped.map((scope) => scope.name).join(', ')}: any product only ${dropped.length === 1 ? 'it shows' : 'they show'} disappears from the team in the app.`, `Re-run with --yes: ekanos teams scope set ${team} ${scopes.map(quote).join(' ')} --source ${resolved.source} --yes`);
+    }
+    const result = await client.call((token) => setTeamScopes(env.host, token, target, scopes));
+    return ctx.succeed(Object.assign({ host: env.host }, result), [
+        ctx.ui.result({
+            title: `${result.team.slug} holds ${names(result.scopes)}`,
+            tone: result.hidden.length > 0 ? 'warn' : 'ok',
+            rows: [
+                ['Before', names(result.before)],
+                ...(result.hidden.length > 0
+                    ? [
+                        [
+                            'No longer sees',
+                            result.hidden.map((product) => product.slug),
+                        ],
+                    ]
+                    : []),
+            ],
+        }),
+        describe(ctx.ui, result, resolved.source),
+    ].join('\n\n'));
+}
+function describe(ui, scopes, source) {
+    var _a, _b;
+    if (scopes.state === 'unscoped') {
+        return ui.result({
+            title: `${scopes.team.slug} sees every product ${scopes.source.slug} has`,
+            rows: [['Scopes', `none: ${scopes.source.slug} has no product scopes`]],
+        });
+    }
+    if (scopes.state === 'locked_out') {
+        return ui.result({
+            title: `${scopes.team.slug} sees no product in the app`,
+            tone: 'warn',
+            rows: [['Scopes', `none of ${scopes.source.slug}'s`]],
+            notes: [
+                `Give it one: ekanos teams scope set ${scopes.team.slug} <scope> --source ${source} ("ekanos sources scopes" lists them).`,
+            ],
+        });
+    }
+    return ui.result({
+        title: `What ${scopes.team.slug} sees in the app`,
+        rows: [
+            ['Scopes', names(scopes.scopes)],
+            [
+                'Products',
+                ((_a = scopes.products) !== null && _a !== void 0 ? _a : []).length > 0
+                    ? ((_b = scopes.products) !== null && _b !== void 0 ? _b : []).map((product) => product.slug)
+                    : 'none',
+            ],
+        ],
+        notes: [
+            `"ekanos sources scopes add <scope> <product>" shows a product to every team on a scope.`,
+        ],
+    });
+}
+function names(scopes) {
+    return scopes.length > 0
+        ? scopes.map((scope) => scope.name).join(', ')
+        : 'no scope';
+}
+function quote(name) {
+    return /^[A-Za-z0-9._-]+$/.test(name) ? name : `"${name}"`;
+}
+//# sourceMappingURL=teams-scope.js.map

package/dist/commands/teams-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teams-scope.js","sourceRoot":"","sources":["../../src/commands/teams-scope.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TeamScopes } from '@ekanos/integration-schema';\n\nimport { requireSession, resolveAuthEnvironment } from '../auth/session';\nimport type { CliContext } from '../context';\nimport { invalidStateError, usageError } from '../errors';\nimport type { ExitCode } from '../exit-codes';\nimport { resolveSourceTarget } from '../source-target';\nimport { setTeamScopes, showTeamScopes } from '../teams-api';\nimport type { Ui } from '../ui';\nimport { TeamsClient, type TeamsArgs } from './teams';\n\nconst USAGE =\n  'Run \"ekanos teams scope show <team>\" or \"ekanos teams scope set <team> <scope> [<scope>…] [--yes]\".';\n\n/**\n * `teams scope show|set <team>` — which of the Source's product scopes a team\n * holds, and so which products it sees in the app. `set` replaces them\n * (names or ids); taking one away can hide products the team uses, so that\n * needs `--yes`. The Source's scopes and their products: `sources scopes`.\n */\nexport async function runTeamScope(\n  ctx: CliContext,\n  args: TeamsArgs,\n  rest: readonly string[],\n): Promise<ExitCode> {\n  const [verb, rawTeam, ...scopes] = rest;\n  if (verb !== 'show' && verb !== 'set') {\n    throw usageError(\n      verb\n        ? `Unknown teams scope subcommand \"${verb}\".`\n        : 'teams scope needs a subcommand.',\n      USAGE,\n    );\n  }\n  const team = rawTeam?.trim().toLowerCase();\n  if (!team || !/^[a-z0-9][a-z0-9-]*$/.test(team)) {\n    throw usageError(\n      rawTeam\n        ? `\"${rawTeam}\" is not a team slug.`\n        : `teams scope ${verb} needs a team.`,\n      USAGE,\n    );\n  }\n  if (verb === 'show' && scopes.length > 0) {\n    throw usageError(`Unexpected argument \"${scopes[0]}\".`, USAGE);\n  }\n  if (verb === 'set' && scopes.length === 0) {\n    throw usageError(\n      'Name the scope (or scopes) the team should hold.',\n      `\"ekanos sources scopes\" lists them, e.g. \"ekanos teams scope set ${team} Gold\".`,\n    );\n  }\n\n  const env = resolveAuthEnvironment(ctx, args.host, args.env, {\n    projectDir: args.dir,\n  });\n  const resolved = await resolveSourceTarget(env, requireSession(env), args);\n  const client = new TeamsClient(env, resolved.session);\n  const target = { source: resolved.source, team };\n\n  const current = await client.call((token) =>\n    showTeamScopes(env.host, token, target),\n  );\n  if (verb === 'show') {\n    return ctx.succeed(\n      { host: env.host, ...current },\n      describe(ctx.ui, current, resolved.source),\n    );\n  }\n\n  const wanted = scopes.map((scope) => scope.trim().toLowerCase());\n  const dropped = current.scopes.filter(\n    (scope) =>\n      !wanted.includes(scope.name.toLowerCase()) && !wanted.includes(scope.id),\n  );\n  if (dropped.length > 0 && !args.yes) {\n    throw invalidStateError(\n      `${team} would no longer hold ${dropped.map((scope) => scope.name).join(', ')}: any product only ${dropped.length === 1 ? 'it shows' : 'they show'} disappears from the team in the app.`,\n      `Re-run with --yes: ekanos teams scope set ${team} ${scopes.map(quote).join(' ')} --source ${resolved.source} --yes`,\n    );\n  }\n\n  const result = await client.call((token) =>\n    setTeamScopes(env.host, token, target, scopes),\n  );\n  return ctx.succeed(\n    { host: env.host, ...result },\n    [\n      ctx.ui.result({\n        title: `${result.team.slug} holds ${names(result.scopes)}`,\n        tone: result.hidden.length > 0 ? 'warn' : 'ok',\n        rows: [\n          ['Before', names(result.before)],\n          ...(result.hidden.length > 0\n            ? ([\n                [\n                  'No longer sees',\n                  result.hidden.map((product) => product.slug),\n                ],\n              ] as Array<[string, string[]]>)\n            : []),\n        ],\n      }),\n      describe(ctx.ui, result, resolved.source),\n    ].join('\\n\\n'),\n  );\n}\n\nfunction describe(ui: Ui, scopes: TeamScopes, source: string): string {\n  if (scopes.state === 'unscoped') {\n    return ui.result({\n      title: `${scopes.team.slug} sees every product ${scopes.source.slug} has`,\n      rows: [['Scopes', `none: ${scopes.source.slug} has no product scopes`]],\n    });\n  }\n  if (scopes.state === 'locked_out') {\n    return ui.result({\n      title: `${scopes.team.slug} sees no product in the app`,\n      tone: 'warn',\n      rows: [['Scopes', `none of ${scopes.source.slug}'s`]],\n      notes: [\n        `Give it one: ekanos teams scope set ${scopes.team.slug} <scope> --source ${source} (\"ekanos sources scopes\" lists them).`,\n      ],\n    });\n  }\n  return ui.result({\n    title: `What ${scopes.team.slug} sees in the app`,\n    rows: [\n      ['Scopes', names(scopes.scopes)],\n      [\n        'Products',\n        (scopes.products ?? []).length > 0\n          ? (scopes.products ?? []).map((product) => product.slug)\n          : 'none',\n      ],\n    ],\n    notes: [\n      `\"ekanos sources scopes add <scope> <product>\" shows a product to every team on a scope.`,\n    ],\n  });\n}\n\nfunction names(scopes: Array<{ name: string }>): string {\n  return scopes.length > 0\n    ? scopes.map((scope) => scope.name).join(', ')\n    : 'no scope';\n}\n\nfunction quote(name: string): string {\n  return /^[A-Za-z0-9._-]+$/.test(name) ? name : `\"${name}\"`;\n}\n"]}

package/dist/commands/teams.d.ts

@@ -4,11 +4,11 @@ import { type AuthEnvironment } from '../auth/session.js';
 import type { CliContext } from '../context.js';
 import type { ExitCode } from '../exit-codes.js';
 import { type TeamsApiResult } from '../teams-api.js';
-export declare const TEAMS_SUBCOMMANDS: readonly ["list", "show", "app", "webhook", "create", "members", "roles", "connect"];
+export declare const TEAMS_SUBCOMMANDS: readonly ["list", "show", "app", "webhook", "events", "scope", "create", "rename", "members", "roles", "connect", "disconnect"];
 export interface TeamsArgs {
     host?: string;
     source?: string;
-    /** `list`, `show <team> <product>`, `app set <team> <product>`, `webhook <team> <product> [<id>]`. */
+    /** `list`, `show <team> [<product>]`, `app set <team> <product>`, `webhook <team> <product> [<id>]`. */
     positionals: readonly string[];
     connection?: string;
     /** `create --slug`, `create --owner <email>`, `members invite --role`. */
@@ -22,6 +22,8 @@ export interface TeamsArgs {
     noOpen?: boolean;
     /** `connect --link-only`: print the team's page, as before connect did the work. */
     linkOnly?: boolean;
+    /** `connect --reconnect`: connect again though it reads as connected. */
+    reconnect?: boolean;
     /** Test seams for `connect`: the wait between polls, and the browser opener. */
     pollDelayMs?: number;
     openUrl?: (url: string) => void;

package/dist/commands/teams.js

@@ -1,15 +1,34 @@
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { loginHint } from '../auth/host-trust.js';
 import { refreshStoredSession, requireSession, resolveAuthEnvironment, } from '../auth/session.js';
 import { authRequiredError, invalidStateError, usageError, validationError, } from '../errors.js';
+import { ensureSecretsDir, writeSecretFile } from '../secret-file.js';
 import { resolveSourceTarget } from '../source-target.js';
 import { listTeams, mintTeamWebhook, setTeamApp, showTeamIntegration, } from '../teams-api.js';
 import { promptHidden, promptLine } from './apps.js';
+import { scopeHiddenLines } from './scope-notice.js';
 import { isTeamAgentArea, runTeamAgentCommands } from './team-agents.js';
+import { runTeamEvents } from './teams-events.js';
 import { ONBOARDING_SUBCOMMANDS, isOnboardingSubcommand, parseOnboarding, runOnboarding, } from './teams-onboard.js';
+import { runTeamOverview } from './teams-overview.js';
+import { runTeamScope } from './teams-scope.js';
 export const TEAMS_SUBCOMMANDS = [
     'list',
     'show',
     'app',
     'webhook',
+    'events',
+    'scope',
     ...ONBOARDING_SUBCOMMANDS,
 ];
 /**
@@ -30,12 +49,18 @@ export async function runTeams(ctx, args) {
         return runTeamAgentCommands(ctx, args);
     }
     const subcommand = parseSubcommand(rawSubcommand);
+    if (subcommand === 'events') {
+        return runTeamEvents(ctx, args, rest);
+    }
+    if (subcommand === 'scope') {
+        return runTeamScope(ctx, args, rest);
+    }
     if (isOnboardingSubcommand(subcommand)) {
         const plan = parseOnboarding(subcommand, rest, Object.assign(Object.assign({}, args), { as: typeof ((_a = args.flags) === null || _a === void 0 ? void 0 : _a.as) === 'string' ? args.flags.as : undefined }));
         const env = resolveAuthEnvironment(ctx, args.host, args.env, {
             projectDir: args.dir,
         });
-        const resolved = await resolveSourceTarget(env, requireSession(env.store, env.host), args);
+        const resolved = await resolveSourceTarget(env, requireSession(env), args);
         return runOnboarding(ctx, args, new TeamsClient(env, resolved.session), env.host, resolved.source, plan);
     }
     if (subcommand === 'app' && rest[0] !== 'set') {
@@ -48,7 +73,11 @@ export async function runTeams(ctx, args) {
         throw usageError('teams list takes no arguments.', 'Run "ekanos teams list --source <slug>".');
     }
     const team = subcommand === 'list' ? '' : requireSlug(operands[0], 'team');
-    const product = subcommand === 'list' ? '' : requireSlug(operands[1], 'product');
+    // `teams show <team>` alone is the team's overview.
+    const overview = subcommand === 'show' && operands[1] === undefined;
+    const product = subcommand === 'list' || overview
+        ? ''
+        : requireSlug(operands[1], 'product');
     const extra = operands.slice(subcommand === 'webhook' ? 3 : 2);
     const appEdits = subcommand === 'app' ? parseAppEdits(args.flags) : null;
     if (subcommand !== 'list' && extra.length > 0) {
@@ -60,7 +89,7 @@ export async function runTeams(ctx, args) {
     const env = resolveAuthEnvironment(ctx, args.host, args.env, {
         projectDir: args.dir,
     });
-    const resolved = await resolveSourceTarget(env, requireSession(env.store, env.host), args);
+    const resolved = await resolveSourceTarget(env, requireSession(env), args);
     const client = new TeamsClient(env, resolved.session);
     const source = resolved.source;
     if (subcommand === 'list') {
@@ -77,17 +106,20 @@ export async function runTeams(ctx, args) {
                     `${entry.name} · ${entry.memberCount} member${entry.memberCount === 1 ? '' : 's'}`,
                 ]),
                 notes: [
-                    '"ekanos teams show <team> <product>" shows a team\'s setup.',
+                    '"ekanos teams show <team>" shows a team\'s setup; add a product for its checklist.',
                 ],
             }));
     }
+    if (overview) {
+        return runTeamOverview(ctx, client, env.host, source, team);
+    }
     const target = { source, team, product };
     const status = await client.call((token) => showTeamIntegration(env.host, token, target));
     if (subcommand === 'show') {
         return ctx.succeed(Object.assign({ host: env.host }, status), checklist(status).join('\n'));
     }
     if (!status.enabled) {
-        throw invalidStateError(`"${product}" is not enabled on ${status.source.slug}.`, '"ekanos catalog" lists what this Source has; Ekanos enables a product for a Source.');
+        throw invalidStateError(`"${product}" is not enabled on ${status.source.slug}.`, `"ekanos sources products --source ${status.source.slug}" shows what it has; only a super-admin enables a product for a Source (in /admin).`);
     }
     if (subcommand === 'app' && appEdits) {
         return setApp(ctx, args, client, env.host, target, status, appEdits);
@@ -242,19 +274,29 @@ async function mintWebhook(ctx, args, client, host, target, status, requested) {
     if (webhook.endpoint && !args.yes) {
         throw invalidStateError(`${target.team} already has a live URL for ${webhook.webhookId} (${webhook.endpoint.tokenPrefix}…). A new one revokes it, and the provider's webhook stops working until you paste the new URL there.`, `Re-run with --yes when you are ready to update the provider: ekanos teams webhook ${target.team} ${target.product} ${webhook.webhookId} --yes`);
     }
+    // The URL carries its token, so it goes to a 0600 file, never the output.
+    const secrets = ensureSecretsDir(args.env);
     const minted = await client.call((token) => mintTeamWebhook(host, token, target, webhook.webhookId));
-    return ctx.succeed(Object.assign({ host }, minted), ctx.ui.result({
+    const { url } = minted, rest = __rest(minted, ["url"]);
+    const secretFile = writeSecretFile(secrets, {
+        owner: target.team,
+        what: `${target.product}-${webhook.webhookId}-webhook-url`,
+        purpose: `Webhook URL for team ${target.team}'s ${status.product.name} (${webhook.webhookId}). Paste it into ${status.product.name}'s webhook settings for this team; the token is part of the URL.`,
+        values: [['WEBHOOK_URL', url]],
+        again: `ekanos teams webhook ${target.team} ${target.product} ${webhook.webhookId} --yes`,
+    });
+    return ctx.succeed(Object.assign(Object.assign({ host }, rest), { secretFile }), ctx.ui.result({
         title: `Webhook URL for ${target.team} · ${webhook.webhookId}`,
         tone: 'warn',
         rows: [
-            ['URL', minted.url],
+            ['URL', `saved to ${secretFile} (readable only by you)`],
             [
                 'Paste it into',
                 `${status.product.name}'s webhook settings for this team`,
             ],
         ],
         notes: [
-            'This URL is shown once and cannot be read again. Paste it now.',
+            'The URL carries its token, so it is shown nowhere else and cannot be read again. Copy it from that file into the provider yourself — not into a chat or an agent session — then delete the file.',
             ...(minted.replaced
                 ? ['The previous URL is revoked: the provider must use this one.']
                 : []),
@@ -270,10 +312,12 @@ export function checklist(status) {
         `  ${mark(status.enabled)} Enabled on the Source`,
     ];
     if (!status.enabled) {
-        lines.push('    "ekanos catalog" lists what this Source has; Ekanos enables a product for a Source.');
+        lines.push(`    "ekanos sources products --source ${status.source.slug}" shows what it has; only a super-admin enables a product for a Source (in /admin).`);
         return lines;
     }
     const target = { team: status.team.slug, product: status.product.slug };
+    lines.push(...scopeHiddenLines(status.scope, Object.assign(Object.assign({}, target), { source: status.source.slug })).map((line) => `  ${line}`));
+    lines.push(...connectionLines(status));
     for (const app of status.teamApps) {
         lines.push(`  Team app: ${app.label} (${app.connectionId})`);
         if ((_a = app.setup) === null || _a === void 0 ? void 0 : _a.consoleUrl)
@@ -300,11 +344,11 @@ export function checklist(status) {
         }
         lines.push(app.connection
             ? `    ${mark(true)} Connected ${day(app.connection.connectedAt)}${app.connection.connectedBy ? ` by ${who(app.connection.connectedBy)}` : ''}`
-            : `    ${mark(false)} Connected: a team member clicks Connect at ${status.connectUrl}`);
+            : `    ${mark(false)} Connected: not yet\n      → in your terminal: ${connectCommand(status, app.connectionId)}`);
     }
     lines.push(status.activation
         ? `  ${mark(true)} Activated for the team${status.activation.activatedAt ? ` ${day(status.activation.activatedAt)}` : ''}${status.activation.activatedBy ? ` by ${who(status.activation.activatedBy)}` : ''}`
-        : `  ${mark(false)} Activated: a team member connects at ${status.connectUrl}`);
+        : `  ${mark(false)} Activated: not yet\n    → in your terminal: ${connectCommand(status)}`);
     lines.push(`  Team page: ${status.connectUrl}`);
     if (status.agentEvents.length > 0) {
         lines.push('  Agent events it offers:');
@@ -312,6 +356,61 @@ export function checklist(status) {
     }
     return lines;
 }
+/**
+ * Each OAuth connection in one line — connected, or installed for a named
+ * one, with its app's credentials and webhook URL — and which of the team's
+ * agents wait on it. A named connection an agent's trigger needs and the team
+ * has not installed is the gap no other line names: the trigger is stored
+ * and on, and nothing ever reaches it.
+ */
+function connectionLines(status) {
+    var _a, _b, _c, _d;
+    const connections = (_a = status.connections) !== null && _a !== void 0 ? _a : [];
+    if (connections.length === 0)
+        return [];
+    const lines = ['  Connections:'];
+    for (const entry of connections) {
+        const named = entry.connectionId !== 'default';
+        const app = status.teamApps.find((candidate) => candidate.connectionId === entry.connectionId);
+        const webhooks = (_b = app === null || app === void 0 ? void 0 : app.webhooks) !== null && _b !== void 0 ? _b : [];
+        const steps = [
+            ...(entry.credentialsSaved === null
+                ? []
+                : [
+                    `app credentials ${entry.credentialsSaved ? 'saved' : 'not saved'}`,
+                ]),
+            named
+                ? entry.connected
+                    ? `installed ${day((_c = entry.connectedAt) !== null && _c !== void 0 ? _c : '')}`
+                    : 'not installed'
+                : entry.connected
+                    ? `connected ${day((_d = entry.connectedAt) !== null && _d !== void 0 ? _d : '')}`
+                    : 'not connected',
+            ...(webhooks.length > 0
+                ? [
+                    webhooks.every((webhook) => webhook.endpoint)
+                        ? 'webhook URL made'
+                        : 'no webhook URL',
+                ]
+                : []),
+        ];
+        const ready = entry.connected &&
+            entry.credentialsSaved !== false &&
+            webhooks.every((webhook) => webhook.endpoint);
+        lines.push(`    ${mark(ready)} ${entry.label} (${entry.connectionId}): ${steps.join(' · ')}${entry.connectedBy ? ` by ${who(entry.connectedBy)}` : ''}`);
+        if (entry.neededBy.length > 0) {
+            lines.push(`      Needed by: ${entry.neededBy.map((need) => `${need.agent} (${need.triggers.join(', ')})`).join(', ')}`);
+        }
+        if (!entry.connected) {
+            lines.push(`      → in your terminal: ${connectCommand(status, entry.connectionId)}`);
+        }
+    }
+    return lines;
+}
+/** The command that connects the team, for a hint: `--connection` only for a named one. */
+function connectCommand(status, connectionId = 'default') {
+    return `npx @ekanos/cli teams connect ${status.team.slug} ${status.product.slug}${connectionId === 'default' ? '' : ` --connection ${connectionId}`} --source ${status.source.slug}`;
+}
 function appWalkthrough(status, app) {
     var _a, _b;
     const lines = [
@@ -337,7 +436,7 @@ function nextSteps(status, app, target) {
             .map((webhook) => `Next: "ekanos teams webhook ${target.team} ${target.product} ${webhook.webhookId}" for the provider's webhook URL.`),
         ...(app.connection
             ? []
-            : [`Then a team member clicks Connect at ${status.connectUrl}`]),
+            : [`Then connect it: ${connectCommand(status, app.connectionId)}`]),
     ];
 }
 export function chooseApp(status, connection) {
@@ -369,7 +468,7 @@ export class TeamsClient {
         }
         if (result.status === 'ok')
             return result.data;
-        throw authRequiredError(`The session for ${this.env.host} could not authorize the teams call.`, `Run "ekanos login --host ${this.env.host}" and retry.`);
+        throw authRequiredError(`The session for ${this.env.host} could not authorize the teams call.`, loginHint(this.env));
     }
 }
 export function canPrompt(ctx, args) {
@@ -382,7 +481,7 @@ function parseSubcommand(value) {
         return match;
     throw usageError(value
         ? `Unknown teams subcommand "${value}".`
-        : 'teams needs a subcommand.', 'Run one of: ekanos teams list, ekanos teams create <name>, ekanos teams members list <team>, ekanos teams roles list <team>, ekanos teams connect <team> <product>, ekanos teams show <team> <product>, ekanos teams app set <team> <product>, ekanos teams webhook <team> <product> [<webhook-id>], ekanos teams agents|triggers|links|mcp ….');
+        : 'teams needs a subcommand.', 'Run one of: ekanos teams list, ekanos teams create <name>, ekanos teams rename <team> <name>, ekanos teams members list <team>, ekanos teams roles list <team>, ekanos teams connect <team> <product>, ekanos teams disconnect <team> <product> --yes, ekanos teams show <team> [<product>], ekanos teams app set <team> <product>, ekanos teams webhook <team> <product> [<webhook-id>], ekanos teams events <team> [<product>], ekanos teams scope show|set <team> …, ekanos teams agents|triggers|links|mcp ….');
 }
 function requireSlug(value, what) {
     const slug = value === null || value === void 0 ? void 0 : value.trim().toLowerCase();