@ekanos/cli 0.10.0 → 0.12.0

package/dist/commands/team-agents-triggers.js

@@ -0,0 +1,251 @@
+import { TeamAgentLinkAddResultSchema, TeamAgentLinkListSchema, TeamAgentRowRemoveResultSchema, TeamAgentTriggerAddResultSchema, TeamAgentTriggerListSchema, } from '@ekanos/integration-schema';
+import { usageError } from '../errors.js';
+import { call } from '../teams-api.js';
+import { requireOperand, usageFor } from './team-agents.js';
+/**
+ * `ekanos teams triggers list|add|remove` and `ekanos teams links
+ * list|add|remove` — a team agent's triggers and outgoing links, set up by
+ * the Source admin. When the template keeps an area, the host shows the
+ * effective rows and refuses changes with the command that hands the area
+ * to the team.
+ */
+export async function runTeamTriggers(ctx, run) {
+    var _a;
+    const team = requireOperand(run.operands[0], 'team slug', 'triggers');
+    const key = requireOperand(run.operands[1], 'agent key', 'triggers');
+    const base = agentPath(team, key);
+    switch (run.verb) {
+        case 'list': {
+            noExtra(run.operands, 2, 'triggers');
+            const list = await send(run, TeamAgentTriggerListSchema, 'GET', `${base}/triggers`);
+            return ctx.succeed(Object.assign({ host: run.host }, list), ctx.ui.result({
+                title: list.triggers.length === 0
+                    ? `${list.agent.slug} on ${list.team.slug} has no triggers`
+                    : `Triggers of ${list.agent.slug} on ${list.team.slug}`,
+                tone: list.triggers.length === 0 ? 'warn' : 'ok',
+                rows: list.triggers.map((trigger) => [
+                    trigger.id,
+                    describeTrigger(trigger),
+                ]),
+                notes: list.teamOwned
+                    ? [
+                        '"ekanos teams triggers add <team> <key> manual|schedule|webhook|event …" adds one.',
+                    ]
+                    : [
+                        `These follow the template. To let the team change them: ekanos agents overrides ${key} enable triggers`,
+                    ],
+            }));
+        }
+        case 'add': {
+            const body = triggerBody(run, team, key);
+            const added = await send(run, TeamAgentTriggerAddResultSchema, 'POST', `${base}/triggers`, body);
+            const rows = [
+                ['Trigger', added.trigger.id],
+                ['Fires on', describeTrigger(added.trigger)],
+            ];
+            if (added.webhook) {
+                rows.push(['URL', added.webhook.url]);
+                rows.push(['Bearer token', added.webhook.token]);
+            }
+            return ctx.succeed(Object.assign({ host: run.host }, added), ctx.ui.result({
+                title: `Added a ${added.trigger.type} trigger to ${added.agent.slug} on ${added.team.slug}`,
+                tone: added.webhook ? 'warn' : 'ok',
+                rows,
+                notes: added.webhook
+                    ? [
+                        'The URL and token are shown once and cannot be read again. POST JSON to the URL with "Authorization: Bearer <token>".',
+                    ]
+                    : [],
+            }));
+        }
+        case 'remove': {
+            const id = (_a = run.operands[2]) === null || _a === void 0 ? void 0 : _a.trim();
+            if (!id) {
+                throw usageError('Name the trigger to remove.', `List them: ekanos teams triggers list ${team} ${key}`);
+            }
+            noExtra(run.operands, 3, 'triggers');
+            const removed = await send(run, TeamAgentRowRemoveResultSchema, 'DELETE', `${base}/triggers/${encodeURIComponent(id)}`);
+            return ctx.succeed(Object.assign({ host: run.host }, removed), ctx.ui.result({
+                title: `Removed trigger ${removed.removed} from ${removed.agent.slug}`,
+            }));
+        }
+        default:
+            throw usageError(`Unknown teams triggers subcommand "${run.verb}".`, usageFor('triggers'));
+    }
+}
+export async function runTeamLinks(ctx, run) {
+    var _a;
+    const team = requireOperand(run.operands[0], 'team slug', 'links');
+    const from = requireOperand(run.operands[1], 'agent key', 'links');
+    const base = agentPath(team, from);
+    switch (run.verb) {
+        case 'list': {
+            noExtra(run.operands, 2, 'links');
+            const list = await send(run, TeamAgentLinkListSchema, 'GET', `${base}/links`);
+            return ctx.succeed(Object.assign({ host: run.host }, list), ctx.ui.result({
+                title: list.links.length === 0
+                    ? `${list.agent.slug} on ${list.team.slug} has no links`
+                    : `Links from ${list.agent.slug} on ${list.team.slug}`,
+                tone: list.links.length === 0 ? 'warn' : 'ok',
+                rows: list.links.map((link) => [link.id, describeLink(link)]),
+                notes: list.teamOwned
+                    ? []
+                    : [
+                        `These follow the template. To let the team change them: ekanos agents overrides ${from} enable links`,
+                    ],
+            }));
+        }
+        case 'add': {
+            const to = requireOperand(run.operands[2], 'agent key to link to', 'links');
+            noExtra(run.operands, 3, 'links');
+            const kind = flag(run, 'kind');
+            if (kind !== 'talk' && kind !== 'delegate') {
+                throw usageError('Say what kind of link: --kind talk|delegate.', usageFor('links'));
+            }
+            const mode = flag(run, 'mode');
+            if (mode !== undefined && mode !== 'await' && mode !== 'handoff') {
+                throw usageError('--mode is await or handoff.', usageFor('links'));
+            }
+            if (mode !== undefined && kind === 'talk') {
+                throw usageError('Only a delegate link takes --mode.', usageFor('links'));
+            }
+            const body = Object.assign({ to,
+                kind }, (mode ? { mode } : {}));
+            const added = await send(run, TeamAgentLinkAddResultSchema, 'POST', `${base}/links`, body);
+            return ctx.succeed(Object.assign({ host: run.host }, added), ctx.ui.result({
+                title: `Linked ${added.agent.slug} → ${added.link.to.slug} on ${added.team.slug}`,
+                rows: [
+                    ['Link', added.link.id],
+                    ['Kind', describeLink(added.link)],
+                ],
+            }));
+        }
+        case 'remove': {
+            const id = (_a = run.operands[2]) === null || _a === void 0 ? void 0 : _a.trim();
+            if (!id) {
+                throw usageError('Name the link to remove.', `List them: ekanos teams links list ${team} ${from}`);
+            }
+            noExtra(run.operands, 3, 'links');
+            const removed = await send(run, TeamAgentRowRemoveResultSchema, 'DELETE', `${base}/links/${encodeURIComponent(id)}`);
+            return ctx.succeed(Object.assign({ host: run.host }, removed), ctx.ui.result({
+                title: `Removed link ${removed.removed} from ${removed.agent.slug}`,
+            }));
+        }
+        default:
+            throw usageError(`Unknown teams links subcommand "${run.verb}".`, usageFor('links'));
+    }
+}
+function triggerBody(run, team, key) {
+    var _a, _b;
+    var _c, _d;
+    const type = (_a = run.operands[2]) === null || _a === void 0 ? void 0 : _a.trim().toLowerCase();
+    const prompt = (_c = flag(run, 'prompt')) !== null && _c !== void 0 ? _c : '';
+    switch (type) {
+        case 'manual':
+            noExtra(run.operands, 3, 'triggers');
+            return { type: 'manual', promptTemplate: prompt };
+        case 'schedule': {
+            noExtra(run.operands, 3, 'triggers');
+            const cron = flag(run, 'cron');
+            if (!cron || !prompt) {
+                throw usageError('A schedule needs --cron and --prompt.', `e.g. ekanos teams triggers add ${team} ${key} schedule --cron "0 9 * * 1-5" --timezone America/Los_Angeles --prompt "Summarize yesterday's tickets"`);
+            }
+            return {
+                type: 'schedule',
+                scheduleCron: cron,
+                timezone: (_d = flag(run, 'timezone')) !== null && _d !== void 0 ? _d : 'UTC',
+                promptTemplate: prompt,
+            };
+        }
+        case 'webhook':
+            noExtra(run.operands, 3, 'triggers');
+            if (!prompt) {
+                throw usageError('A webhook needs --prompt: what to do with each request.', `e.g. ekanos teams triggers add ${team} ${key} webhook --prompt "Triage this alert: {{body.title}}"`);
+            }
+            return { type: 'webhook', promptTemplate: prompt };
+        case 'event':
+        case 'integration_event': {
+            const eventId = (_b = run.operands[3]) === null || _b === void 0 ? void 0 : _b.trim();
+            if (!eventId) {
+                throw usageError('Name the event, e.g. zendesk.ticket_created.', `e.g. ekanos teams triggers add ${team} ${key} event zendesk.ticket_created --filter '{"priority":["urgent"]}'`);
+            }
+            noExtra(run.operands, 4, 'triggers');
+            return {
+                type: 'integration_event',
+                eventId,
+                filter: parseFilter(flag(run, 'filter')),
+                promptTemplate: prompt,
+            };
+        }
+        case 'slack':
+        case 'linear':
+            throw usageError(`A ${type} trigger is connected in the app, where the team picks its workspace and channels.`, 'Open the agent in the app and add it under Triggers.');
+        default:
+            throw usageError(type ? `Unknown trigger type "${type}".` : 'Name the trigger type.', usageFor('triggers'));
+    }
+}
+function parseFilter(raw) {
+    if (!raw)
+        return {};
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (_a) {
+        throw usageError('--filter must be a JSON object.', `e.g. --filter '{"priority":["urgent","high"]}'`);
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        throw usageError('--filter must be a JSON object.', `e.g. --filter '{"priority":["urgent","high"]}'`);
+    }
+    const filter = {};
+    for (const [name, value] of Object.entries(parsed)) {
+        if (typeof value === 'string' ||
+            typeof value === 'boolean' ||
+            (Array.isArray(value) && value.every((item) => typeof item === 'string'))) {
+            filter[name] = value;
+            continue;
+        }
+        throw usageError(`--filter field "${name}" must be a string, a boolean or a list of strings.`, `e.g. --filter '{"priority":["urgent","high"]}'`);
+    }
+    return filter;
+}
+function describeTrigger(trigger) {
+    var _a, _b, _c;
+    const what = trigger.type === 'schedule'
+        ? `schedule ${(_a = trigger.scheduleCron) !== null && _a !== void 0 ? _a : ''} (${(_b = trigger.timezone) !== null && _b !== void 0 ? _b : 'UTC'})`
+        : trigger.type === 'integration_event'
+            ? `event ${(_c = trigger.eventId) !== null && _c !== void 0 ? _c : ''}${trigger.filter && Object.keys(trigger.filter).length > 0 ? ` ${JSON.stringify(trigger.filter)}` : ''}`
+            : trigger.type;
+    const tags = [
+        trigger.owner === 'template' ? 'from template' : 'team',
+        trigger.active ? 'on' : 'off',
+    ];
+    return `${what} · ${tags.join(' · ')}`;
+}
+function describeLink(link) {
+    var _a;
+    const kind = link.kind === 'delegate' ? `delegate (${(_a = link.mode) !== null && _a !== void 0 ? _a : 'await'})` : 'talk';
+    const tags = [
+        link.owner === 'template' ? 'from template' : 'team',
+        ...(link.active ? [] : ['inactive']),
+    ];
+    return `${kind} → ${link.to.slug} · ${tags.join(' · ')}`;
+}
+function agentPath(team, key) {
+    return `/api/partner/teams/${encodeURIComponent(team)}/agents/${encodeURIComponent(key)}`;
+}
+function flag(run, name) {
+    var _a;
+    const value = (_a = run.args.flags) === null || _a === void 0 ? void 0 : _a[name];
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
+function noExtra(operands, count, area) {
+    const extra = operands[count];
+    if (extra !== undefined) {
+        throw usageError(`Unexpected argument "${extra}".`, usageFor(area));
+    }
+}
+function send(run, schema, method, path, body) {
+    return run.client.call((token) => call(run.host, token, schema, { method, path, source: run.source, body }));
+}
+//# sourceMappingURL=team-agents-triggers.js.map

package/dist/commands/team-agents-triggers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-agents-triggers.js","sourceRoot":"","sources":["../../src/commands/team-agents-triggers.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  type TeamAgentLink,\n  type TeamAgentLinkAddRequest,\n  TeamAgentLinkAddResultSchema,\n  TeamAgentLinkListSchema,\n  TeamAgentRowRemoveResultSchema,\n  type TeamAgentTrigger,\n  type TeamAgentTriggerAddRequest,\n  TeamAgentTriggerAddResultSchema,\n  TeamAgentTriggerListSchema,\n} from '@ekanos/integration-schema';\nimport type { z } from 'zod';\n\nimport type { CliContext } from '../context';\nimport { usageError } from '../errors';\nimport type { ExitCode } from '../exit-codes';\nimport { call } from '../teams-api';\nimport { type TeamAgentRun, requireOperand, usageFor } from './team-agents';\n\n/**\n * `ekanos teams triggers list|add|remove` and `ekanos teams links\n * list|add|remove` — a team agent's triggers and outgoing links, set up by\n * the Source admin. When the template keeps an area, the host shows the\n * effective rows and refuses changes with the command that hands the area\n * to the team.\n */\n\nexport async function runTeamTriggers(\n  ctx: CliContext,\n  run: TeamAgentRun,\n): Promise<ExitCode> {\n  const team = requireOperand(run.operands[0], 'team slug', 'triggers');\n  const key = requireOperand(run.operands[1], 'agent key', 'triggers');\n  const base = agentPath(team, key);\n\n  switch (run.verb) {\n    case 'list': {\n      noExtra(run.operands, 2, 'triggers');\n      const list = await send(\n        run,\n        TeamAgentTriggerListSchema,\n        'GET',\n        `${base}/triggers`,\n      );\n      return ctx.succeed(\n        { host: run.host, ...list },\n        ctx.ui.result({\n          title:\n            list.triggers.length === 0\n              ? `${list.agent.slug} on ${list.team.slug} has no triggers`\n              : `Triggers of ${list.agent.slug} on ${list.team.slug}`,\n          tone: list.triggers.length === 0 ? 'warn' : 'ok',\n          rows: list.triggers.map((trigger) => [\n            trigger.id,\n            describeTrigger(trigger),\n          ]),\n          notes: list.teamOwned\n            ? [\n                '\"ekanos teams triggers add <team> <key> manual|schedule|webhook|event …\" adds one.',\n              ]\n            : [\n                `These follow the template. To let the team change them: ekanos agents overrides ${key} enable triggers`,\n              ],\n        }),\n      );\n    }\n    case 'add': {\n      const body = triggerBody(run, team, key);\n      const added = await send(\n        run,\n        TeamAgentTriggerAddResultSchema,\n        'POST',\n        `${base}/triggers`,\n        body,\n      );\n      const rows: Array<[string, string]> = [\n        ['Trigger', added.trigger.id],\n        ['Fires on', describeTrigger(added.trigger)],\n      ];\n      if (added.webhook) {\n        rows.push(['URL', added.webhook.url]);\n        rows.push(['Bearer token', added.webhook.token]);\n      }\n      return ctx.succeed(\n        { host: run.host, ...added },\n        ctx.ui.result({\n          title: `Added a ${added.trigger.type} trigger to ${added.agent.slug} on ${added.team.slug}`,\n          tone: added.webhook ? 'warn' : 'ok',\n          rows,\n          notes: added.webhook\n            ? [\n                'The URL and token are shown once and cannot be read again. POST JSON to the URL with \"Authorization: Bearer <token>\".',\n              ]\n            : [],\n        }),\n      );\n    }\n    case 'remove': {\n      const id = run.operands[2]?.trim();\n      if (!id) {\n        throw usageError(\n          'Name the trigger to remove.',\n          `List them: ekanos teams triggers list ${team} ${key}`,\n        );\n      }\n      noExtra(run.operands, 3, 'triggers');\n      const removed = await send(\n        run,\n        TeamAgentRowRemoveResultSchema,\n        'DELETE',\n        `${base}/triggers/${encodeURIComponent(id)}`,\n      );\n      return ctx.succeed(\n        { host: run.host, ...removed },\n        ctx.ui.result({\n          title: `Removed trigger ${removed.removed} from ${removed.agent.slug}`,\n        }),\n      );\n    }\n    default:\n      throw usageError(\n        `Unknown teams triggers subcommand \"${run.verb}\".`,\n        usageFor('triggers'),\n      );\n  }\n}\n\nexport async function runTeamLinks(\n  ctx: CliContext,\n  run: TeamAgentRun,\n): Promise<ExitCode> {\n  const team = requireOperand(run.operands[0], 'team slug', 'links');\n  const from = requireOperand(run.operands[1], 'agent key', 'links');\n  const base = agentPath(team, from);\n\n  switch (run.verb) {\n    case 'list': {\n      noExtra(run.operands, 2, 'links');\n      const list = await send(\n        run,\n        TeamAgentLinkListSchema,\n        'GET',\n        `${base}/links`,\n      );\n      return ctx.succeed(\n        { host: run.host, ...list },\n        ctx.ui.result({\n          title:\n            list.links.length === 0\n              ? `${list.agent.slug} on ${list.team.slug} has no links`\n              : `Links from ${list.agent.slug} on ${list.team.slug}`,\n          tone: list.links.length === 0 ? 'warn' : 'ok',\n          rows: list.links.map((link) => [link.id, describeLink(link)]),\n          notes: list.teamOwned\n            ? []\n            : [\n                `These follow the template. To let the team change them: ekanos agents overrides ${from} enable links`,\n              ],\n        }),\n      );\n    }\n    case 'add': {\n      const to = requireOperand(\n        run.operands[2],\n        'agent key to link to',\n        'links',\n      );\n      noExtra(run.operands, 3, 'links');\n      const kind = flag(run, 'kind');\n      if (kind !== 'talk' && kind !== 'delegate') {\n        throw usageError(\n          'Say what kind of link: --kind talk|delegate.',\n          usageFor('links'),\n        );\n      }\n      const mode = flag(run, 'mode');\n      if (mode !== undefined && mode !== 'await' && mode !== 'handoff') {\n        throw usageError('--mode is await or handoff.', usageFor('links'));\n      }\n      if (mode !== undefined && kind === 'talk') {\n        throw usageError(\n          'Only a delegate link takes --mode.',\n          usageFor('links'),\n        );\n      }\n      const body: TeamAgentLinkAddRequest = {\n        to,\n        kind,\n        ...(mode ? { mode } : {}),\n      };\n      const added = await send(\n        run,\n        TeamAgentLinkAddResultSchema,\n        'POST',\n        `${base}/links`,\n        body,\n      );\n      return ctx.succeed(\n        { host: run.host, ...added },\n        ctx.ui.result({\n          title: `Linked ${added.agent.slug} → ${added.link.to.slug} on ${added.team.slug}`,\n          rows: [\n            ['Link', added.link.id],\n            ['Kind', describeLink(added.link)],\n          ],\n        }),\n      );\n    }\n    case 'remove': {\n      const id = run.operands[2]?.trim();\n      if (!id) {\n        throw usageError(\n          'Name the link to remove.',\n          `List them: ekanos teams links list ${team} ${from}`,\n        );\n      }\n      noExtra(run.operands, 3, 'links');\n      const removed = await send(\n        run,\n        TeamAgentRowRemoveResultSchema,\n        'DELETE',\n        `${base}/links/${encodeURIComponent(id)}`,\n      );\n      return ctx.succeed(\n        { host: run.host, ...removed },\n        ctx.ui.result({\n          title: `Removed link ${removed.removed} from ${removed.agent.slug}`,\n        }),\n      );\n    }\n    default:\n      throw usageError(\n        `Unknown teams links subcommand \"${run.verb}\".`,\n        usageFor('links'),\n      );\n  }\n}\n\nfunction triggerBody(\n  run: TeamAgentRun,\n  team: string,\n  key: string,\n): TeamAgentTriggerAddRequest {\n  const type = run.operands[2]?.trim().toLowerCase();\n  const prompt = flag(run, 'prompt') ?? '';\n  switch (type) {\n    case 'manual':\n      noExtra(run.operands, 3, 'triggers');\n      return { type: 'manual', promptTemplate: prompt };\n    case 'schedule': {\n      noExtra(run.operands, 3, 'triggers');\n      const cron = flag(run, 'cron');\n      if (!cron || !prompt) {\n        throw usageError(\n          'A schedule needs --cron and --prompt.',\n          `e.g. ekanos teams triggers add ${team} ${key} schedule --cron \"0 9 * * 1-5\" --timezone America/Los_Angeles --prompt \"Summarize yesterday's tickets\"`,\n        );\n      }\n      return {\n        type: 'schedule',\n        scheduleCron: cron,\n        timezone: flag(run, 'timezone') ?? 'UTC',\n        promptTemplate: prompt,\n      };\n    }\n    case 'webhook':\n      noExtra(run.operands, 3, 'triggers');\n      if (!prompt) {\n        throw usageError(\n          'A webhook needs --prompt: what to do with each request.',\n          `e.g. ekanos teams triggers add ${team} ${key} webhook --prompt \"Triage this alert: {{body.title}}\"`,\n        );\n      }\n      return { type: 'webhook', promptTemplate: prompt };\n    case 'event':\n    case 'integration_event': {\n      const eventId = run.operands[3]?.trim();\n      if (!eventId) {\n        throw usageError(\n          'Name the event, e.g. zendesk.ticket_created.',\n          `e.g. ekanos teams triggers add ${team} ${key} event zendesk.ticket_created --filter '{\"priority\":[\"urgent\"]}'`,\n        );\n      }\n      noExtra(run.operands, 4, 'triggers');\n      return {\n        type: 'integration_event',\n        eventId,\n        filter: parseFilter(flag(run, 'filter')),\n        promptTemplate: prompt,\n      };\n    }\n    case 'slack':\n    case 'linear':\n      throw usageError(\n        `A ${type} trigger is connected in the app, where the team picks its workspace and channels.`,\n        'Open the agent in the app and add it under Triggers.',\n      );\n    default:\n      throw usageError(\n        type ? `Unknown trigger type \"${type}\".` : 'Name the trigger type.',\n        usageFor('triggers'),\n      );\n  }\n}\n\nfunction parseFilter(\n  raw: string | undefined,\n): Record<string, string | boolean | string[]> {\n  if (!raw) return {};\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch {\n    throw usageError(\n      '--filter must be a JSON object.',\n      `e.g. --filter '{\"priority\":[\"urgent\",\"high\"]}'`,\n    );\n  }\n  if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {\n    throw usageError(\n      '--filter must be a JSON object.',\n      `e.g. --filter '{\"priority\":[\"urgent\",\"high\"]}'`,\n    );\n  }\n  const filter: Record<string, string | boolean | string[]> = {};\n  for (const [name, value] of Object.entries(parsed)) {\n    if (\n      typeof value === 'string' ||\n      typeof value === 'boolean' ||\n      (Array.isArray(value) && value.every((item) => typeof item === 'string'))\n    ) {\n      filter[name] = value as string | boolean | string[];\n      continue;\n    }\n    throw usageError(\n      `--filter field \"${name}\" must be a string, a boolean or a list of strings.`,\n      `e.g. --filter '{\"priority\":[\"urgent\",\"high\"]}'`,\n    );\n  }\n  return filter;\n}\n\nfunction describeTrigger(trigger: TeamAgentTrigger): string {\n  const what =\n    trigger.type === 'schedule'\n      ? `schedule ${trigger.scheduleCron ?? ''} (${trigger.timezone ?? 'UTC'})`\n      : trigger.type === 'integration_event'\n        ? `event ${trigger.eventId ?? ''}${trigger.filter && Object.keys(trigger.filter).length > 0 ? ` ${JSON.stringify(trigger.filter)}` : ''}`\n        : trigger.type;\n  const tags = [\n    trigger.owner === 'template' ? 'from template' : 'team',\n    trigger.active ? 'on' : 'off',\n  ];\n  return `${what} · ${tags.join(' · ')}`;\n}\n\nfunction describeLink(link: TeamAgentLink): string {\n  const kind =\n    link.kind === 'delegate' ? `delegate (${link.mode ?? 'await'})` : 'talk';\n  const tags = [\n    link.owner === 'template' ? 'from template' : 'team',\n    ...(link.active ? [] : ['inactive']),\n  ];\n  return `${kind} → ${link.to.slug} · ${tags.join(' · ')}`;\n}\n\nfunction agentPath(team: string, key: string): string {\n  return `/api/partner/teams/${encodeURIComponent(team)}/agents/${encodeURIComponent(key)}`;\n}\n\nfunction flag(run: TeamAgentRun, name: string): string | undefined {\n  const value = run.args.flags?.[name];\n  return typeof value === 'string' && value.trim() ? value.trim() : undefined;\n}\n\nfunction noExtra(\n  operands: readonly string[],\n  count: number,\n  area: 'triggers' | 'links',\n) {\n  const extra = operands[count];\n  if (extra !== undefined) {\n    throw usageError(`Unexpected argument \"${extra}\".`, usageFor(area));\n  }\n}\n\nfunction send<T>(\n  run: TeamAgentRun,\n  schema: z.ZodType<T>,\n  method: 'GET' | 'POST' | 'DELETE',\n  path: string,\n  body?: unknown,\n): Promise<T> {\n  return run.client.call((token) =>\n    call(run.host, token, schema, { method, path, source: run.source, body }),\n  );\n}\n"]}

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

@@ -0,0 +1,31 @@
+import type { CliContext } from '../context.js';
+import type { ExitCode } from '../exit-codes.js';
+import { TeamsClient, type TeamsArgs } from './teams.js';
+/**
+ * `ekanos teams agents|triggers|links|mcp …` — a Source admin setting up a
+ * team's agents from the terminal, acting on that team through the partner
+ * API (`/api/partner/teams/<team>/agents/*`, `/mcp/*`). Every write goes
+ * through the same checks the app's agent pages make and leaves an Admin
+ * Audit row naming the person.
+ *
+ * The shape is always `teams <area> <verb> <team> [<agent-key> …]`.
+ */
+export declare const TEAM_AGENT_AREAS: readonly ['agents', 'triggers', 'links', 'mcp'];
+export type TeamAgentArea = (typeof TEAM_AGENT_AREAS)[number];
+export declare function isTeamAgentArea(value: string | undefined): value is TeamAgentArea;
+/** What every area handler gets: an authorized client and its operands. */
+export interface TeamAgentRun {
+    args: TeamsArgs;
+    client: TeamsClient;
+    host: string;
+    /** The Source slug, for `?source=`. */
+    source: string;
+    /** The verb. */
+    verb: string;
+    /** Everything after the verb: `<team> [<key> …]`. */
+    operands: readonly string[];
+}
+export declare function runTeamAgentCommands(ctx: CliContext, args: TeamsArgs): Promise<ExitCode>;
+export declare function usageFor(area: TeamAgentArea): string;
+/** A slug operand (team, agent key, server key), or a usage error naming it. */
+export declare function requireOperand(value: string | undefined, what: string, area: TeamAgentArea): string;

package/dist/commands/team-agents.js

@@ -0,0 +1,71 @@
+import { requireSession, resolveAuthEnvironment } from '../auth/session.js';
+import { usageError } from '../errors.js';
+import { resolveSourceTarget } from '../source-target.js';
+import { runTeamAgentsArea } from './team-agents-agents.js';
+import { runTeamMcp } from './team-agents-mcp.js';
+import { runTeamLinks, runTeamTriggers } from './team-agents-triggers.js';
+import { TeamsClient } from './teams.js';
+/**
+ * `ekanos teams agents|triggers|links|mcp …` — a Source admin setting up a
+ * team's agents from the terminal, acting on that team through the partner
+ * API (`/api/partner/teams/<team>/agents/*`, `/mcp/*`). Every write goes
+ * through the same checks the app's agent pages make and leaves an Admin
+ * Audit row naming the person.
+ *
+ * The shape is always `teams <area> <verb> <team> [<agent-key> …]`.
+ */
+export const TEAM_AGENT_AREAS = ['agents', 'triggers', 'links', 'mcp'];
+export function isTeamAgentArea(value) {
+    return TEAM_AGENT_AREAS.some((area) => area === value);
+}
+export async function runTeamAgentCommands(ctx, args) {
+    const [area, verb, ...operands] = args.positionals;
+    if (!isTeamAgentArea(area)) {
+        throw usageError(`Unknown teams area "${area !== null && area !== void 0 ? area : ''}".`, 'See "ekanos teams --help".');
+    }
+    if (!verb) {
+        throw usageError(`teams ${area} needs a subcommand.`, usageFor(area));
+    }
+    const env = resolveAuthEnvironment(ctx, args.host, args.env, {
+        projectDir: args.dir,
+    });
+    const resolved = await resolveSourceTarget(env, requireSession(env.store, env.host), args);
+    const run = {
+        args,
+        client: new TeamsClient(env, resolved.session),
+        host: env.host,
+        source: resolved.source,
+        verb,
+        operands,
+    };
+    switch (area) {
+        case 'agents':
+            return runTeamAgentsArea(ctx, run);
+        case 'triggers':
+            return runTeamTriggers(ctx, run);
+        case 'links':
+            return runTeamLinks(ctx, run);
+        case 'mcp':
+            return runTeamMcp(ctx, run);
+    }
+}
+export function usageFor(area) {
+    switch (area) {
+        case 'agents':
+            return 'Run one of: ekanos teams agents list <team> | enable <team> <key> [--as <member-email>] | disable <team> <key> | pin <team> <key> <version> | unpin <team> <key> | policy <team> <key> [set <tool> auto|approve | unset <tool> | --reads auto|approve --writes auto|approve].';
+        case 'triggers':
+            return 'Run one of: ekanos teams triggers list <team> <key> | add <team> <key> <manual|schedule|webhook|event> … | remove <team> <key> <trigger-id>.';
+        case 'links':
+            return 'Run one of: ekanos teams links list <team> <key> | add <team> <from-key> <to-key> --kind talk|delegate [--mode await|handoff] | remove <team> <from-key> <link-id>.';
+        case 'mcp':
+            return 'Run one of: ekanos teams mcp list <team> | add <team> <server-key> --url <url> [--auth none|token|oauth] [--name <name>] | status <team> <server-key> | token <team> <server-key> (hidden input at your terminal) | effect <team> <server-key> <tool> read|write.';
+    }
+}
+/** A slug operand (team, agent key, server key), or a usage error naming it. */
+export function requireOperand(value, what, area) {
+    const slug = value === null || value === void 0 ? void 0 : value.trim().toLowerCase();
+    if (slug && /^[a-z0-9][a-z0-9-]*$/.test(slug))
+        return slug;
+    throw usageError(value ? `"${value}" is not a ${what}.` : `Name the ${what}.`, usageFor(area));
+}
+//# sourceMappingURL=team-agents.js.map

package/dist/commands/team-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-agents.js","sourceRoot":"","sources":["../../src/commands/team-agents.ts"],"names":[],"mappings":"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","sourcesContent":["import { requireSession, resolveAuthEnvironment } from '../auth/session';\nimport type { CliContext } from '../context';\nimport { usageError } from '../errors';\nimport type { ExitCode } from '../exit-codes';\nimport { resolveSourceTarget } from '../source-target';\nimport { runTeamAgentsArea } from './team-agents-agents';\nimport { runTeamMcp } from './team-agents-mcp';\nimport { runTeamLinks, runTeamTriggers } from './team-agents-triggers';\nimport { TeamsClient, type TeamsArgs } from './teams';\n\n/**\n * `ekanos teams agents|triggers|links|mcp …` — a Source admin setting up a\n * team's agents from the terminal, acting on that team through the partner\n * API (`/api/partner/teams/<team>/agents/*`, `/mcp/*`). Every write goes\n * through the same checks the app's agent pages make and leaves an Admin\n * Audit row naming the person.\n *\n * The shape is always `teams <area> <verb> <team> [<agent-key> …]`.\n */\n\nexport const TEAM_AGENT_AREAS = ['agents', 'triggers', 'links', 'mcp'] as const;\nexport type TeamAgentArea = (typeof TEAM_AGENT_AREAS)[number];\n\nexport function isTeamAgentArea(\n  value: string | undefined,\n): value is TeamAgentArea {\n  return TEAM_AGENT_AREAS.some((area) => area === value);\n}\n\n/** What every area handler gets: an authorized client and its operands. */\nexport interface TeamAgentRun {\n  args: TeamsArgs;\n  client: TeamsClient;\n  host: string;\n  /** The Source slug, for `?source=`. */\n  source: string;\n  /** The verb. */\n  verb: string;\n  /** Everything after the verb: `<team> [<key> …]`. */\n  operands: readonly string[];\n}\n\nexport async function runTeamAgentCommands(\n  ctx: CliContext,\n  args: TeamsArgs,\n): Promise<ExitCode> {\n  const [area, verb, ...operands] = args.positionals;\n  if (!isTeamAgentArea(area)) {\n    throw usageError(\n      `Unknown teams area \"${area ?? ''}\".`,\n      'See \"ekanos teams --help\".',\n    );\n  }\n  if (!verb) {\n    throw usageError(`teams ${area} needs a subcommand.`, usageFor(area));\n  }\n\n  const env = resolveAuthEnvironment(ctx, args.host, args.env, {\n    projectDir: args.dir,\n  });\n  const resolved = await resolveSourceTarget(\n    env,\n    requireSession(env.store, env.host),\n    args,\n  );\n  const run: TeamAgentRun = {\n    args,\n    client: new TeamsClient(env, resolved.session),\n    host: env.host,\n    source: resolved.source,\n    verb,\n    operands,\n  };\n\n  switch (area) {\n    case 'agents':\n      return runTeamAgentsArea(ctx, run);\n    case 'triggers':\n      return runTeamTriggers(ctx, run);\n    case 'links':\n      return runTeamLinks(ctx, run);\n    case 'mcp':\n      return runTeamMcp(ctx, run);\n  }\n}\n\nexport function usageFor(area: TeamAgentArea): string {\n  switch (area) {\n    case 'agents':\n      return 'Run one of: ekanos teams agents list <team> | enable <team> <key> [--as <member-email>] | disable <team> <key> | pin <team> <key> <version> | unpin <team> <key> | policy <team> <key> [set <tool> auto|approve | unset <tool> | --reads auto|approve --writes auto|approve].';\n    case 'triggers':\n      return 'Run one of: ekanos teams triggers list <team> <key> | add <team> <key> <manual|schedule|webhook|event> … | remove <team> <key> <trigger-id>.';\n    case 'links':\n      return 'Run one of: ekanos teams links list <team> <key> | add <team> <from-key> <to-key> --kind talk|delegate [--mode await|handoff] | remove <team> <from-key> <link-id>.';\n    case 'mcp':\n      return 'Run one of: ekanos teams mcp list <team> | add <team> <server-key> --url <url> [--auth none|token|oauth] [--name <name>] | status <team> <server-key> | token <team> <server-key> (hidden input at your terminal) | effect <team> <server-key> <tool> read|write.';\n  }\n}\n\n/** A slug operand (team, agent key, server key), or a usage error naming it. */\nexport function requireOperand(\n  value: string | undefined,\n  what: string,\n  area: TeamAgentArea,\n): string {\n  const slug = value?.trim().toLowerCase();\n  if (slug && /^[a-z0-9][a-z0-9-]*$/.test(slug)) return slug;\n  throw usageError(\n    value ? `\"${value}\" is not a ${what}.` : `Name the ${what}.`,\n    usageFor(area),\n  );\n}\n"]}

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

@@ -0,0 +1,51 @@
+import type { CliContext } from '../context.js';
+import type { ExitCode } from '../exit-codes.js';
+import type { TeamsClient } from './teams.js';
+/**
+ * Onboarding a team from the terminal, for the Source admin: `teams create`,
+ * `teams members list|invite|role|remove`, `teams roles list` and
+ * `teams connect`. Parsed before any session is touched (`parseOnboarding`)
+ * so a usage error never costs a network round-trip, then run against the
+ * session `runTeams` resolved.
+ */
+export declare const ONBOARDING_SUBCOMMANDS: readonly ['create', 'members', 'roles', 'connect'];
+export type OnboardingSubcommand = (typeof ONBOARDING_SUBCOMMANDS)[number];
+export interface OnboardingFlags {
+    slug?: string;
+    owner?: string;
+    role?: string;
+    yes: boolean;
+}
+export type OnboardingPlan = {
+    kind: 'create';
+    name: string;
+    slug?: string;
+    ownerEmail?: string;
+} | {
+    kind: 'members-list';
+    team: string;
+} | {
+    kind: 'members-invite';
+    team: string;
+    email: string;
+    role: string;
+} | {
+    kind: 'members-role';
+    team: string;
+    email: string;
+    role: string;
+} | {
+    kind: 'members-remove';
+    team: string;
+    email: string;
+} | {
+    kind: 'roles-list';
+    team: string;
+} | {
+    kind: 'connect';
+    team: string;
+    product: string;
+};
+export declare function isOnboardingSubcommand(value: string): value is OnboardingSubcommand;
+export declare function parseOnboarding(subcommand: OnboardingSubcommand, rest: readonly string[], flags: OnboardingFlags): OnboardingPlan;
+export declare function runOnboarding(ctx: CliContext, client: TeamsClient, host: string, source: string, plan: OnboardingPlan): Promise<ExitCode>;