@ekanos/cli 0.10.0 → 0.12.0

package/dist/commands/reviewers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewers.js","sourceRoot":"","sources":["../../src/commands/reviewers.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,oBAAoB,EACpB,cAAc,EACd,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE1D,OAAO,EAEL,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAU,CAAC;AAGxE,MAAM,OAAO,GAA6B,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAa7D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAe,EACf,IAAmB;;;IAEnB,MAAM,CAAC,aAAa,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;IAC7D,MAAM,UAAU,GAAG,eAAe,CAAC,aAAa,CAAC,CAAC;IAElD,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QAC1B,IAAI,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACtD,MAAM,UAAU,CACd,oCAAoC,EACpC,8CAA8C,CAC/C,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,UAAU,CACd,wBAAwB,KAAK,CAAC,CAAC,CAAC,IAAI,EACpC,gCAAgC,CACjC,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1E,MAAM,KAAK,GACT,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3E,IAAI,UAAU,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC1C,MAAM,UAAU,CACd,oCAAoC,EACpC,gCAAgC,KAAK,wDAAwD,CAC9F,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,sBAAsB,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE;QAC3D,UAAU,EAAE,IAAI,CAAC,GAAG;KACrB,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CACxC,GAAG,EACH,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,EACnC,IAAI,CACL,CAAC;IACF,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAE/B,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CACvC,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CACvC,CAAC;QACF,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO,GAAG,CAAC,OAAO,iBACd,IAAI,EAAE,GAAG,CAAC,IAAI,IAAK,IAAI,GACzB,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC;gBACZ,KAAK,EAAE,mBAAmB,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;gBAC5C,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE;oBACL,mEAAmE;oBACnE,0DAA0D;iBAC3D;aACF,CAAC,CACH,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,CAAC,OAAO,iBACd,IAAI,EAAE,GAAG,CAAC,IAAI,IAAK,IAAI,GACzB;YACE,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC/C,GAAG,CAAC,EAAE,CAAC,KAAK,CACV,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,EAClC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,CAChC;SACF,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,KAAK,KAAK,IAAI,KAAK,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CACzC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,kBACjC,KAAK;YACL,KAAK,IACF,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EACzB,CACH,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QACjC,OAAO,GAAG,CAAC,OAAO,iBACd,IAAI,EAAE,GAAG,CAAC,IAAI,IAAK,MAAM,GAC3B,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC;YACZ,KAAK,EAAE,MAAM,CAAC,OAAO;gBACnB,CAAC,CAAC,SAAS,GAAG,CAAC,QAAQ,CAAC,gBAAgB;gBACxC,CAAC,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,gCAAgC;YACpD,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM;YACpC,IAAI,EAAE;gBACJ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAClB,CAAC,OAAO,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;aAChC;YACD,KAAK,EAAE;gBACL,QAAQ,CAAC,KAAK,KAAK,QAAQ;oBACzB,CAAC,CAAC,iFAAiF;oBACnF,CAAC,CAAC,WAAW,MAAA,MAAA,QAAQ,CAAC,IAAI,0CAAE,IAAI,mCAAI,UAAU,mEAAmE;aACpH;SACF,CAAC,CACH,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CACzC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,kBACpC,KAAK,IACF,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EACzB,CACH,CAAC;IACF,OAAO,GAAG,CAAC,OAAO,iBACd,IAAI,EAAE,GAAG,CAAC,IAAI,IAAK,MAAM,GAC3B,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC;QACZ,KAAK,EAAE,WAAW,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;QACvD,IAAI,EAAE;YACJ,CAAC,QAAQ,EAAE,MAAM,CAAC;YAClB;gBACE,SAAS;gBACT,GAAG,MAAM,CAAC,OAAO,SAAS,MAAM,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE;aAC7D;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,QAAwB;;;IAC3C,OAAO;cACL,QAAQ,CAAC,KAAK,mCAAI,QAAQ,CAAC,MAAM;cACjC,QAAQ,CAAC,IAAI,mCAAI,GAAG;QACpB,QAAQ,CAAC,KAAK;cACd,MAAA,QAAQ,CAAC,IAAI,0CAAE,IAAI,mCAAI,GAAG;KAC3B,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,QAAwB;IAC1C,OAAO,QAAQ,CAAC,KAAK,KAAK,MAAM,IAAI,QAAQ,CAAC,IAAI;QAC/C,CAAC,CAAC,QAAQ,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,GAAG;QACtD,CAAC,CAAC,QAAQ,CAAC;AACf,CAAC;AAED,SAAS,GAAG,CAAC,QAAwB;;IACnC,mBAAO,QAAQ,CAAC,KAAK,mCAAI,QAAQ,CAAC,IAAI,mCAAI,QAAQ,CAAC,MAAM,CAAC;AAC5D,CAAC;AAED,MAAM,eAAe;IACnB,YACmB,GAAoB,EAC7B,OAAsB;mBADb,GAAG;uBACZ,OAAO;IACd,CAAC;IAEJ,KAAK,CAAC,IAAI,CACR,IAA6D;QAE7D,IAAI,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAClD,IAAI,MAAM,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;YACrC,IAAI,CAAC,OAAO,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAClE,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC;QAC/C,MAAM,iBAAiB,CACrB,mBAAmB,IAAI,CAAC,GAAG,CAAC,IAAI,0CAA0C,EAC1E,4BAA4B,IAAI,CAAC,GAAG,CAAC,IAAI,cAAc,CACxD,CAAC;IACJ,CAAC;CACF;AAED,SAAS,eAAe,CAAC,KAAyB;IAChD,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;IACnE,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,UAAU,CACd,KAAK;QACH,CAAC,CAAC,iCAAiC,KAAK,IAAI;QAC5C,CAAC,CAAC,+BAA+B,EACnC,uJAAuJ,CACxJ,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,KAAyB,EAAE,UAA4B;IAC3E,MAAM,KAAK,GAAG,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,IAAI,GAAG,WAAW,EAAE,CAAC;IAC1C,IAAI,KAAK,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3D,MAAM,UAAU,CACd,KAAK;QACH,CAAC,CAAC,IAAI,KAAK,4BAA4B;QACvC,CAAC,CAAC,6BAA6B,EACjC,UAAU,KAAK,KAAK;QAClB,CAAC,CAAC,6DAA6D;QAC/D,CAAC,CAAC,4CAA4C,CACjD,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACxC,IAAI,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,MAAM,UAAU,CACd,IAAI,KAAK,uBAAuB,EAChC,0DAA0D,CAC3D,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CACnB,KAAyB,EACzB,KAAa,EACb,IAAwB;IAExB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,MAAK,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,IAAI,GAAG,WAAW,EAAE,CAAA,CAAC,CAAC;IAC7E,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,UAAU,CACd,KAAK;YACH,CAAC,CAAC,IAAI,KAAK,uCAAuC;YAClD,CAAC,CAAC,iDAAiD,EACrD,8BAA8B,KAAK,0EAA0E,CAC9G,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,KAAK,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,UAAU,CACd,4CAA4C,EAC5C,0DAA0D,CAC3D,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,KAAK,QAAQ,IAAI,IAAI,EAAE,CAAC;QAC/B,MAAM,UAAU,CACd,8DAA8D,EAC9D,6BAA6B,KAAK,iDAAiD,IAAI,IAAI,CAC5F,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import type { ReviewerReach, SourceReviewer } from '@ekanos/integration-schema';\n\nimport type { StoredSession } from '../auth/credential-store';\nimport {\n  type AuthEnvironment,\n  refreshStoredSession,\n  requireSession,\n  resolveAuthEnvironment,\n} from '../auth/session';\nimport type { CliContext } from '../context';\nimport { authRequiredError, usageError } from '../errors';\nimport type { ExitCode } from '../exit-codes';\nimport {\n  type ReviewersApiResult,\n  addReviewer,\n  listReviewers,\n  removeReviewer,\n} from '../reviewers-api';\nimport { resolveSourceTarget } from '../source-target';\n\nexport const REVIEWERS_SUBCOMMANDS = ['list', 'add', 'remove'] as const;\ntype ReviewersSubcommand = (typeof REVIEWERS_SUBCOMMANDS)[number];\n\nconst REACHES: readonly ReviewerReach[] = ['source', 'team'];\n\nexport interface ReviewersArgs {\n  host?: string;\n  source?: string;\n  /** `list`, `add <email>`, `remove <email>`. */\n  positionals: readonly string[];\n  reach?: string;\n  team?: string;\n  dir: string;\n  env: Record<string, string | undefined>;\n}\n\n/**\n * `reviewers` — a Source admin names who decides its agents' reply drafts\n * held under an `approve` policy. A reviewer is one of the Source's own\n * users, at a reach: `source` (drafts from every team's provided agents) or\n * `team` (one named team's). `list` shows them; `add` names one; `remove`\n * takes one off — every reach, or only the named team's with `--team`.\n */\nexport async function runReviewers(\n  ctx: CliContext,\n  args: ReviewersArgs,\n): Promise<ExitCode> {\n  const [rawSubcommand, rawEmail, ...extra] = args.positionals;\n  const subcommand = parseSubcommand(rawSubcommand);\n\n  if (subcommand === 'list') {\n    if (rawEmail !== undefined || args.reach || args.team) {\n      throw usageError(\n        'reviewers list takes no arguments.',\n        'Run \"ekanos reviewers list --source <slug>\".',\n      );\n    }\n  } else if (extra.length > 0) {\n    throw usageError(\n      `Unexpected argument \"${extra[0]}\".`,\n      'See \"ekanos reviewers --help\".',\n    );\n  }\n\n  const email = subcommand === 'list' ? '' : requireEmail(rawEmail, subcommand);\n  const team = args.team === undefined ? undefined : requireTeam(args.team);\n  const reach =\n    subcommand === 'add' ? requireReach(args.reach, email, team) : undefined;\n  if (subcommand === 'remove' && args.reach) {\n    throw usageError(\n      'reviewers remove takes no --reach.',\n      `Run \"ekanos reviewers remove ${email}\" (every reach) or add \"--team <slug>\" for one team's.`,\n    );\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 client = new ReviewersClient(env, resolved.session);\n  const source = resolved.source;\n\n  if (subcommand === 'list') {\n    const list = await client.call((token) =>\n      listReviewers(env.host, token, source),\n    );\n    if (list.reviewers.length === 0) {\n      return ctx.succeed(\n        { host: env.host, ...list },\n        ctx.ui.result({\n          title: `No reviewers on ${list.source.slug}`,\n          tone: 'warn',\n          notes: [\n            'Reply drafts under an \"approve\" policy wait for a named reviewer.',\n            'Name one: \"ekanos reviewers add <email> --reach source\".',\n          ],\n        }),\n      );\n    }\n    return ctx.succeed(\n      { host: env.host, ...list },\n      [\n        ctx.ui.bold(`Reviewers on ${list.source.slug}`),\n        ctx.ui.table(\n          ['Email', 'Name', 'Reach', 'Team'],\n          list.reviewers.map(reviewerRow),\n        ),\n      ].join('\\n'),\n    );\n  }\n\n  if (subcommand === 'add' && reach) {\n    const result = await client.call((token) =>\n      addReviewer(env.host, token, source, {\n        email,\n        reach,\n        ...(team ? { team } : {}),\n      }),\n    );\n    const reviewer = result.reviewer;\n    return ctx.succeed(\n      { host: env.host, ...result },\n      ctx.ui.result({\n        title: result.created\n          ? `Added ${who(reviewer)} as a reviewer`\n          : `${who(reviewer)} already reviews at that reach`,\n        tone: result.created ? 'ok' : 'warn',\n        rows: [\n          ['Source', source],\n          ['Reach', reachLabel(reviewer)],\n        ],\n        notes: [\n          reviewer.reach === 'source'\n            ? \"Decides drafts from every team's provided agents, in the Source's review queue.\"\n            : `Decides ${reviewer.team?.slug ?? 'the team'}'s drafts, from its Approvals inbox or the Source's review queue.`,\n        ],\n      }),\n    );\n  }\n\n  const result = await client.call((token) =>\n    removeReviewer(env.host, token, source, {\n      email,\n      ...(team ? { team } : {}),\n    }),\n  );\n  return ctx.succeed(\n    { host: env.host, ...result },\n    ctx.ui.result({\n      title: `Removed ${email}${team ? ` from ${team}` : ''}`,\n      rows: [\n        ['Source', source],\n        [\n          'Removed',\n          `${result.removed} reach${result.removed === 1 ? '' : 'es'}`,\n        ],\n      ],\n    }),\n  );\n}\n\nfunction reviewerRow(reviewer: SourceReviewer): string[] {\n  return [\n    reviewer.email ?? reviewer.userId,\n    reviewer.name ?? '—',\n    reviewer.reach,\n    reviewer.team?.slug ?? '—',\n  ];\n}\n\nfunction reachLabel(reviewer: SourceReviewer): string {\n  return reviewer.reach === 'team' && reviewer.team\n    ? `team ${reviewer.team.slug} (${reviewer.team.name})`\n    : 'source';\n}\n\nfunction who(reviewer: SourceReviewer): string {\n  return reviewer.email ?? reviewer.name ?? reviewer.userId;\n}\n\nclass ReviewersClient {\n  constructor(\n    private readonly env: AuthEnvironment,\n    private session: StoredSession,\n  ) {}\n\n  async call<T>(\n    send: (accessToken: string) => Promise<ReviewersApiResult<T>>,\n  ): Promise<T> {\n    let result = await send(this.session.accessToken);\n    if (result.status === 'unauthorized') {\n      this.session = await refreshStoredSession(this.env, this.session);\n      result = await send(this.session.accessToken);\n    }\n    if (result.status === 'ok') return result.data;\n    throw authRequiredError(\n      `The session for ${this.env.host} could not authorize the reviewers call.`,\n      `Run \"ekanos login --host ${this.env.host}\" and retry.`,\n    );\n  }\n}\n\nfunction parseSubcommand(value: string | undefined): ReviewersSubcommand {\n  const match = REVIEWERS_SUBCOMMANDS.find((name) => name === value);\n  if (match) return match;\n  throw usageError(\n    value\n      ? `Unknown reviewers subcommand \"${value}\".`\n      : 'reviewers needs a subcommand.',\n    'Run one of: ekanos reviewers list, ekanos reviewers add <email> --reach source|team [--team <slug>], ekanos reviewers remove <email> [--team <slug>].',\n  );\n}\n\nfunction requireEmail(value: string | undefined, subcommand: 'add' | 'remove') {\n  const email = value?.trim().toLowerCase();\n  if (email && /^[^\\s@]+@[^\\s@]+$/.test(email)) return email;\n  throw usageError(\n    value\n      ? `\"${value}\" is not an email address.`\n      : 'Name the reviewer by email.',\n    subcommand === 'add'\n      ? 'e.g. \"ekanos reviewers add ana@example.com --reach source\".'\n      : '\"ekanos reviewers list\" shows who reviews.',\n  );\n}\n\nfunction requireTeam(value: string): string {\n  const slug = value.trim().toLowerCase();\n  if (/^[a-z0-9][a-z0-9-]*$/.test(slug)) return slug;\n  throw usageError(\n    `\"${value}\" is not a team slug.`,\n    'Run \"ekanos teams list\" to see the teams on this Source.',\n  );\n}\n\nfunction requireReach(\n  value: string | undefined,\n  email: string,\n  team: string | undefined,\n): ReviewerReach {\n  const reach = REACHES.find((entry) => entry === value?.trim().toLowerCase());\n  if (!reach) {\n    throw usageError(\n      value\n        ? `\"${value}\" is not a reach: use source or team.`\n        : 'Name the reach: --reach source or --reach team.',\n      `e.g. \"ekanos reviewers add ${email} --reach source\", or \"--reach team --team <slug>\" for one team's drafts.`,\n    );\n  }\n  if (reach === 'team' && !team) {\n    throw usageError(\n      'A team-reach reviewer needs --team <slug>.',\n      'Run \"ekanos teams list\" to see the teams on this Source.',\n    );\n  }\n  if (reach === 'source' && team) {\n    throw usageError(\n      'A source-reach reviewer decides for every team; drop --team.',\n      `Run \"ekanos reviewers add ${email} --reach source\", or use \"--reach team --team ${team}\".`,\n    );\n  }\n  return reach;\n}\n"]}

package/dist/commands/routes.d.ts

@@ -0,0 +1,23 @@
+import type { CliContext } from '../context.js';
+import type { ExitCode } from '../exit-codes.js';
+export declare const ROUTES_SUBCOMMANDS: readonly ['list', 'options', 'set', 'remove', 'webhook', 'unrouted', 'replay'];
+export interface RoutesArgs {
+    host?: string;
+    source?: string;
+    /** `list [product]`, `set <product> <value> <team>`, `replay <event-id>`, … */
+    positionals: readonly string[];
+    label?: string;
+    webhook?: string;
+    dir: string;
+    env: Record<string, string | undefined>;
+}
+/**
+ * `routes` — a Source admin's routing of a Source connection's events to
+ * teams (plan 241.4). One Zendesk connected for the whole Source sends every
+ * ticket to one webhook; each ticket's organization decides which team's
+ * agents see it. `set` maps a value to a team, `remove` unmaps it, `options`
+ * lists the values the integration knows (Zendesk's organizations),
+ * `webhook` mints the Source's endpoint URL (shown once), and `unrouted` /
+ * `replay` deal with events no team was mapped to — they started nothing.
+ */
+export declare function runRoutes(ctx: CliContext, args: RoutesArgs): Promise<ExitCode>;

package/dist/commands/routes.js

@@ -0,0 +1,277 @@
+import { refreshStoredSession, requireSession, resolveAuthEnvironment, } from '../auth/session.js';
+import { authRequiredError, usageError } from '../errors.js';
+import { ReplaySchema, RouteListSchema, RouteOptionsSchema, RouteRemoveSchema, RouteSetSchema, RouteWebhookSchema, UnroutedListSchema, routesCall, } from '../routes-api.js';
+import { resolveSourceTarget } from '../source-target.js';
+export const ROUTES_SUBCOMMANDS = [
+    'list',
+    'options',
+    'set',
+    'remove',
+    'webhook',
+    'unrouted',
+    'replay',
+];
+const USAGE = 'Run one of: ekanos routes list [<product>] | options <product> | set <product> <value> <team> [--label <name>] | remove <product> <value> | webhook <product> [--webhook <id>] | unrouted [<product>] | replay <event-id>.';
+/**
+ * `routes` — a Source admin's routing of a Source connection's events to
+ * teams (plan 241.4). One Zendesk connected for the whole Source sends every
+ * ticket to one webhook; each ticket's organization decides which team's
+ * agents see it. `set` maps a value to a team, `remove` unmaps it, `options`
+ * lists the values the integration knows (Zendesk's organizations),
+ * `webhook` mints the Source's endpoint URL (shown once), and `unrouted` /
+ * `replay` deal with events no team was mapped to — they started nothing.
+ */
+export async function runRoutes(ctx, args) {
+    var _a, _b;
+    const [rawSubcommand, ...operands] = args.positionals;
+    const subcommand = parseSubcommand(rawSubcommand);
+    const expected = OPERANDS[subcommand];
+    if (operands.length < expected.min || operands.length > expected.max) {
+        throw usageError(`routes ${subcommand} takes ${expected.usage}.`, `e.g. "ekanos routes ${subcommand} ${expected.example}".`);
+    }
+    const env = resolveAuthEnvironment(ctx, args.host, args.env, {
+        projectDir: args.dir,
+    });
+    const resolved = await resolveSourceTarget(env, requireSession(env.store, env.host), args);
+    const client = new RoutesClient(env, resolved.session);
+    const source = resolved.source;
+    const send = (schema, init) => client.call((token) => routesCall(env.host, token, schema, Object.assign(Object.assign({}, init), { query: Object.assign({ source }, init.query) })));
+    switch (subcommand) {
+        case 'list': {
+            const product = operands[0] ? requireSlug(operands[0]) : undefined;
+            const list = await send(RouteListSchema, {
+                method: 'GET',
+                query: { product },
+            });
+            if (list.routes.length === 0) {
+                return ctx.succeed(Object.assign({ host: env.host }, list), ctx.ui.result({
+                    title: `No routes on ${list.source.slug}${product ? ` for ${product}` : ''}`,
+                    tone: 'warn',
+                    notes: [
+                        "Events on the Source's endpoint stay unrouted — they start nothing — until their value is mapped to a team.",
+                        'Map one: "ekanos routes set <product> <value> <team>".',
+                    ],
+                }));
+            }
+            return ctx.succeed(Object.assign({ host: env.host }, list), [
+                ctx.ui.bold(`Routes on ${list.source.slug}`),
+                ctx.ui.table(['Product', 'Key', 'Value', 'Label', 'Team'], list.routes.map(routeRow)),
+            ].join('\n'));
+        }
+        case 'options': {
+            const product = requireSlug(operands[0]);
+            const result = await send(RouteOptionsSchema, {
+                method: 'GET',
+                path: `/${encodeURIComponent(product)}/options`,
+                query: {},
+            });
+            if (!result.options) {
+                return ctx.succeed(Object.assign({ host: env.host, product }, result), ctx.ui.result({
+                    title: `${product} does not list its ${result.key} values`,
+                    tone: 'warn',
+                    notes: [
+                        `Type the ${result.key} id: "ekanos routes set ${product} <value> <team>".`,
+                    ],
+                }));
+            }
+            return ctx.succeed(Object.assign({ host: env.host, product }, result), [
+                ctx.ui.bold(`${product} ${result.key} values`),
+                ctx.ui.table(['Value', 'Label'], result.options.map((option) => [option.value, option.label])),
+            ].join('\n'));
+        }
+        case 'set': {
+            const product = requireSlug(operands[0]);
+            const value = requireValue(operands[1]);
+            const team = requireSlug(operands[2], 'team');
+            const result = await send(RouteSetSchema, {
+                method: 'PUT',
+                path: `/${encodeURIComponent(product)}`,
+                query: {},
+                body: Object.assign({ value, team }, (args.label ? { label: args.label } : {})),
+            });
+            return ctx.succeed(Object.assign({ host: env.host }, result), ctx.ui.result({
+                title: `Routed ${product} ${result.route.key} ${value} to ${(_a = result.route.team.slug) !== null && _a !== void 0 ? _a : result.route.team.name}`,
+                rows: [
+                    ['Source', source],
+                    ['Label', (_b = result.route.label) !== null && _b !== void 0 ? _b : '—'],
+                    [
+                        'Replaced',
+                        result.replaced ? 'yes (moved from another team)' : 'no',
+                    ],
+                ],
+                notes: [
+                    'New events with this value start that team\'s agents. Earlier unrouted ones: "ekanos routes unrouted" then "ekanos routes replay <event-id>".',
+                ],
+            }));
+        }
+        case 'remove': {
+            const product = requireSlug(operands[0]);
+            const value = requireValue(operands[1]);
+            const result = await send(RouteRemoveSchema, {
+                method: 'DELETE',
+                path: `/${encodeURIComponent(product)}`,
+                query: { value },
+            });
+            return ctx.succeed(Object.assign({ host: env.host }, result), ctx.ui.result({
+                title: `Unmapped ${product} ${value}`,
+                rows: [['Source', source]],
+                notes: ['Its events now stay unrouted and start nothing.'],
+            }));
+        }
+        case 'webhook': {
+            const product = requireSlug(operands[0]);
+            const result = await send(RouteWebhookSchema, {
+                method: 'POST',
+                path: `/${encodeURIComponent(product)}/webhook`,
+                query: { webhook: args.webhook },
+            });
+            return ctx.succeed(Object.assign({ host: env.host, product }, result), ctx.ui.result({
+                title: `Webhook URL for ${product} on ${source} (shown once)`,
+                rows: [
+                    ['Webhook', result.webhookId],
+                    ['URL', result.url],
+                ],
+                notes: [
+                    'Point the vendor at this URL once, for the whole Source. Minting again revokes the previous URL.',
+                    ...(result.signature
+                        ? [
+                            `Deliveries must be signed (${result.signature.header}); the Source connection needs the "${result.signature.secretName}" secret.`,
+                        ]
+                        : []),
+                ],
+            }));
+        }
+        case 'unrouted': {
+            const product = operands[0] ? requireSlug(operands[0]) : undefined;
+            const result = await send(UnroutedListSchema, {
+                method: 'GET',
+                path: '/unrouted',
+                query: { product },
+            });
+            if (result.events.length === 0) {
+                return ctx.succeed(Object.assign({ host: env.host }, result), ctx.ui.result({ title: 'No unrouted events', tone: 'ok' }));
+            }
+            return ctx.succeed(Object.assign({ host: env.host }, result), [
+                ctx.ui.bold('Unrouted events (no team mapped; nothing started)'),
+                ctx.ui.table(['Id', 'Product', 'Event', 'Value', 'Received'], result.events.map((event) => { var _a; return [
+                    event.id,
+                    event.product,
+                    event.eventId,
+                    event.routeValue
+                        ? `${(_a = event.routeKey) !== null && _a !== void 0 ? _a : ''} ${event.routeValue}`.trim()
+                        : '(none)',
+                    event.createdAt,
+                ]; })),
+                'Map the value with "ekanos routes set", then "ekanos routes replay <id>".',
+            ].join('\n'));
+        }
+        case 'replay': {
+            const id = requireEventId(operands[0]);
+            const result = await send(ReplaySchema, {
+                method: 'POST',
+                path: `/unrouted/${encodeURIComponent(id)}/replay`,
+                query: {},
+            });
+            return ctx.succeed(Object.assign({ host: env.host, id }, result), ctx.ui.result({
+                title: result.status === 'routed'
+                    ? `Routed ${id}`
+                    : result.status === 'already-routed'
+                        ? `${id} was already routed`
+                        : `${id} is still unrouted`,
+                tone: result.status === 'unrouted' ? 'warn' : 'ok',
+                notes: result.status === 'unrouted'
+                    ? [
+                        'No team is mapped to its value yet: "ekanos routes set" first.',
+                    ]
+                    : [],
+            }));
+        }
+    }
+}
+const OPERANDS = {
+    list: { min: 0, max: 1, usage: 'an optional product', example: 'zendesk' },
+    options: { min: 1, max: 1, usage: 'a product', example: 'zendesk' },
+    set: {
+        min: 3,
+        max: 3,
+        usage: '<product> <value> <team>',
+        example: 'zendesk 360001234567 first-bank',
+    },
+    remove: {
+        min: 2,
+        max: 2,
+        usage: '<product> <value>',
+        example: 'zendesk 360001234567',
+    },
+    webhook: { min: 1, max: 1, usage: 'a product', example: 'zendesk' },
+    unrouted: {
+        min: 0,
+        max: 1,
+        usage: 'an optional product',
+        example: 'zendesk',
+    },
+    replay: {
+        min: 1,
+        max: 1,
+        usage: 'an event id from "ekanos routes unrouted"',
+        example: '<event-id>',
+    },
+};
+function routeRow(route) {
+    var _a, _b;
+    return [
+        route.product,
+        route.key,
+        route.value,
+        (_a = route.label) !== null && _a !== void 0 ? _a : '—',
+        (_b = route.team.slug) !== null && _b !== void 0 ? _b : route.team.name,
+    ];
+}
+class RoutesClient {
+    constructor(env, session) {
+        this.env = env;
+        this.session = session;
+    }
+    async call(send) {
+        let result = await send(this.session.accessToken);
+        if (result.status === 'unauthorized') {
+            this.session = await refreshStoredSession(this.env, this.session);
+            result = await send(this.session.accessToken);
+        }
+        if (result.status === 'ok')
+            return result.data;
+        throw authRequiredError(`The session for ${this.env.host} could not authorize the routes call.`, `Run "ekanos login --host ${this.env.host}" and retry.`);
+    }
+}
+function parseSubcommand(value) {
+    const match = ROUTES_SUBCOMMANDS.find((name) => name === value);
+    if (match)
+        return match;
+    throw usageError(value
+        ? `Unknown routes subcommand "${value}".`
+        : 'routes needs a subcommand.', USAGE);
+}
+function requireSlug(value, what = 'product') {
+    var _a;
+    const slug = (_a = value === null || value === void 0 ? void 0 : value.trim().toLowerCase()) !== null && _a !== void 0 ? _a : '';
+    if (/^[a-z0-9][a-z0-9-]{0,63}$/.test(slug))
+        return slug;
+    throw usageError(`"${value !== null && value !== void 0 ? value : ''}" is not a ${what} slug.`, what === 'team'
+        ? 'Run "ekanos teams list" to see the teams on this Source.'
+        : 'Run "ekanos catalog" to see what the Source has.');
+}
+function requireValue(value) {
+    var _a;
+    const trimmed = (_a = value === null || value === void 0 ? void 0 : value.trim()) !== null && _a !== void 0 ? _a : '';
+    if (trimmed.length > 0 && trimmed.length <= 200)
+        return trimmed;
+    throw usageError('A route value is 1 to 200 characters.', '"ekanos routes options <product>" lists the values the integration knows.');
+}
+function requireEventId(value) {
+    var _a;
+    const id = (_a = value === null || value === void 0 ? void 0 : value.trim()) !== null && _a !== void 0 ? _a : '';
+    if (/^[0-9a-f-]{36}$/i.test(id))
+        return id;
+    throw usageError(`"${value !== null && value !== void 0 ? value : ''}" is not an event id.`, '"ekanos routes unrouted" lists the events waiting for a mapping.');
+}
+//# sourceMappingURL=routes.js.map

package/dist/commands/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/commands/routes.ts"],"names":[],"mappings":"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","sourcesContent":["import type { z } from 'zod';\n\nimport type { StoredSession } from '../auth/credential-store';\nimport {\n  type AuthEnvironment,\n  refreshStoredSession,\n  requireSession,\n  resolveAuthEnvironment,\n} from '../auth/session';\nimport type { CliContext } from '../context';\nimport { authRequiredError, usageError } from '../errors';\nimport type { ExitCode } from '../exit-codes';\nimport {\n  ReplaySchema,\n  RouteListSchema,\n  RouteOptionsSchema,\n  RouteRemoveSchema,\n  RouteSetSchema,\n  RouteWebhookSchema,\n  type RoutesApiResult,\n  type SourceEventRoute,\n  UnroutedListSchema,\n  routesCall,\n} from '../routes-api';\nimport { resolveSourceTarget } from '../source-target';\n\nexport const ROUTES_SUBCOMMANDS = [\n  'list',\n  'options',\n  'set',\n  'remove',\n  'webhook',\n  'unrouted',\n  'replay',\n] as const;\ntype RoutesSubcommand = (typeof ROUTES_SUBCOMMANDS)[number];\n\nexport interface RoutesArgs {\n  host?: string;\n  source?: string;\n  /** `list [product]`, `set <product> <value> <team>`, `replay <event-id>`, … */\n  positionals: readonly string[];\n  label?: string;\n  webhook?: string;\n  dir: string;\n  env: Record<string, string | undefined>;\n}\n\nconst USAGE =\n  'Run one of: ekanos routes list [<product>] | options <product> | set <product> <value> <team> [--label <name>] | remove <product> <value> | webhook <product> [--webhook <id>] | unrouted [<product>] | replay <event-id>.';\n\n/**\n * `routes` — a Source admin's routing of a Source connection's events to\n * teams (plan 241.4). One Zendesk connected for the whole Source sends every\n * ticket to one webhook; each ticket's organization decides which team's\n * agents see it. `set` maps a value to a team, `remove` unmaps it, `options`\n * lists the values the integration knows (Zendesk's organizations),\n * `webhook` mints the Source's endpoint URL (shown once), and `unrouted` /\n * `replay` deal with events no team was mapped to — they started nothing.\n */\nexport async function runRoutes(\n  ctx: CliContext,\n  args: RoutesArgs,\n): Promise<ExitCode> {\n  const [rawSubcommand, ...operands] = args.positionals;\n  const subcommand = parseSubcommand(rawSubcommand);\n  const expected = OPERANDS[subcommand];\n  if (operands.length < expected.min || operands.length > expected.max) {\n    throw usageError(\n      `routes ${subcommand} takes ${expected.usage}.`,\n      `e.g. \"ekanos routes ${subcommand} ${expected.example}\".`,\n    );\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 client = new RoutesClient(env, resolved.session);\n  const source = resolved.source;\n  const send = <T>(\n    schema: z.ZodType<T>,\n    init: Parameters<typeof routesCall>[3],\n  ) =>\n    client.call((token) =>\n      routesCall(env.host, token, schema, {\n        ...init,\n        query: { source, ...init.query },\n      }),\n    );\n\n  switch (subcommand) {\n    case 'list': {\n      const product = operands[0] ? requireSlug(operands[0]) : undefined;\n      const list = await send(RouteListSchema, {\n        method: 'GET',\n        query: { product },\n      });\n      if (list.routes.length === 0) {\n        return ctx.succeed(\n          { host: env.host, ...list },\n          ctx.ui.result({\n            title: `No routes on ${list.source.slug}${product ? ` for ${product}` : ''}`,\n            tone: 'warn',\n            notes: [\n              \"Events on the Source's endpoint stay unrouted — they start nothing — until their value is mapped to a team.\",\n              'Map one: \"ekanos routes set <product> <value> <team>\".',\n            ],\n          }),\n        );\n      }\n      return ctx.succeed(\n        { host: env.host, ...list },\n        [\n          ctx.ui.bold(`Routes on ${list.source.slug}`),\n          ctx.ui.table(\n            ['Product', 'Key', 'Value', 'Label', 'Team'],\n            list.routes.map(routeRow),\n          ),\n        ].join('\\n'),\n      );\n    }\n\n    case 'options': {\n      const product = requireSlug(operands[0]);\n      const result = await send(RouteOptionsSchema, {\n        method: 'GET',\n        path: `/${encodeURIComponent(product)}/options`,\n        query: {},\n      });\n      if (!result.options) {\n        return ctx.succeed(\n          { host: env.host, product, ...result },\n          ctx.ui.result({\n            title: `${product} does not list its ${result.key} values`,\n            tone: 'warn',\n            notes: [\n              `Type the ${result.key} id: \"ekanos routes set ${product} <value> <team>\".`,\n            ],\n          }),\n        );\n      }\n      return ctx.succeed(\n        { host: env.host, product, ...result },\n        [\n          ctx.ui.bold(`${product} ${result.key} values`),\n          ctx.ui.table(\n            ['Value', 'Label'],\n            result.options.map((option) => [option.value, option.label]),\n          ),\n        ].join('\\n'),\n      );\n    }\n\n    case 'set': {\n      const product = requireSlug(operands[0]);\n      const value = requireValue(operands[1]);\n      const team = requireSlug(operands[2], 'team');\n      const result = await send(RouteSetSchema, {\n        method: 'PUT',\n        path: `/${encodeURIComponent(product)}`,\n        query: {},\n        body: { value, team, ...(args.label ? { label: args.label } : {}) },\n      });\n      return ctx.succeed(\n        { host: env.host, ...result },\n        ctx.ui.result({\n          title: `Routed ${product} ${result.route.key} ${value} to ${result.route.team.slug ?? result.route.team.name}`,\n          rows: [\n            ['Source', source],\n            ['Label', result.route.label ?? '—'],\n            [\n              'Replaced',\n              result.replaced ? 'yes (moved from another team)' : 'no',\n            ],\n          ],\n          notes: [\n            'New events with this value start that team\\'s agents. Earlier unrouted ones: \"ekanos routes unrouted\" then \"ekanos routes replay <event-id>\".',\n          ],\n        }),\n      );\n    }\n\n    case 'remove': {\n      const product = requireSlug(operands[0]);\n      const value = requireValue(operands[1]);\n      const result = await send(RouteRemoveSchema, {\n        method: 'DELETE',\n        path: `/${encodeURIComponent(product)}`,\n        query: { value },\n      });\n      return ctx.succeed(\n        { host: env.host, ...result },\n        ctx.ui.result({\n          title: `Unmapped ${product} ${value}`,\n          rows: [['Source', source]],\n          notes: ['Its events now stay unrouted and start nothing.'],\n        }),\n      );\n    }\n\n    case 'webhook': {\n      const product = requireSlug(operands[0]);\n      const result = await send(RouteWebhookSchema, {\n        method: 'POST',\n        path: `/${encodeURIComponent(product)}/webhook`,\n        query: { webhook: args.webhook },\n      });\n      return ctx.succeed(\n        { host: env.host, product, ...result },\n        ctx.ui.result({\n          title: `Webhook URL for ${product} on ${source} (shown once)`,\n          rows: [\n            ['Webhook', result.webhookId],\n            ['URL', result.url],\n          ],\n          notes: [\n            'Point the vendor at this URL once, for the whole Source. Minting again revokes the previous URL.',\n            ...(result.signature\n              ? [\n                  `Deliveries must be signed (${result.signature.header}); the Source connection needs the \"${result.signature.secretName}\" secret.`,\n                ]\n              : []),\n          ],\n        }),\n      );\n    }\n\n    case 'unrouted': {\n      const product = operands[0] ? requireSlug(operands[0]) : undefined;\n      const result = await send(UnroutedListSchema, {\n        method: 'GET',\n        path: '/unrouted',\n        query: { product },\n      });\n      if (result.events.length === 0) {\n        return ctx.succeed(\n          { host: env.host, ...result },\n          ctx.ui.result({ title: 'No unrouted events', tone: 'ok' }),\n        );\n      }\n      return ctx.succeed(\n        { host: env.host, ...result },\n        [\n          ctx.ui.bold('Unrouted events (no team mapped; nothing started)'),\n          ctx.ui.table(\n            ['Id', 'Product', 'Event', 'Value', 'Received'],\n            result.events.map((event) => [\n              event.id,\n              event.product,\n              event.eventId,\n              event.routeValue\n                ? `${event.routeKey ?? ''} ${event.routeValue}`.trim()\n                : '(none)',\n              event.createdAt,\n            ]),\n          ),\n          'Map the value with \"ekanos routes set\", then \"ekanos routes replay <id>\".',\n        ].join('\\n'),\n      );\n    }\n\n    case 'replay': {\n      const id = requireEventId(operands[0]);\n      const result = await send(ReplaySchema, {\n        method: 'POST',\n        path: `/unrouted/${encodeURIComponent(id)}/replay`,\n        query: {},\n      });\n      return ctx.succeed(\n        { host: env.host, id, ...result },\n        ctx.ui.result({\n          title:\n            result.status === 'routed'\n              ? `Routed ${id}`\n              : result.status === 'already-routed'\n                ? `${id} was already routed`\n                : `${id} is still unrouted`,\n          tone: result.status === 'unrouted' ? 'warn' : 'ok',\n          notes:\n            result.status === 'unrouted'\n              ? [\n                  'No team is mapped to its value yet: \"ekanos routes set\" first.',\n                ]\n              : [],\n        }),\n      );\n    }\n  }\n}\n\nconst OPERANDS: Record<\n  RoutesSubcommand,\n  { min: number; max: number; usage: string; example: string }\n> = {\n  list: { min: 0, max: 1, usage: 'an optional product', example: 'zendesk' },\n  options: { min: 1, max: 1, usage: 'a product', example: 'zendesk' },\n  set: {\n    min: 3,\n    max: 3,\n    usage: '<product> <value> <team>',\n    example: 'zendesk 360001234567 first-bank',\n  },\n  remove: {\n    min: 2,\n    max: 2,\n    usage: '<product> <value>',\n    example: 'zendesk 360001234567',\n  },\n  webhook: { min: 1, max: 1, usage: 'a product', example: 'zendesk' },\n  unrouted: {\n    min: 0,\n    max: 1,\n    usage: 'an optional product',\n    example: 'zendesk',\n  },\n  replay: {\n    min: 1,\n    max: 1,\n    usage: 'an event id from \"ekanos routes unrouted\"',\n    example: '<event-id>',\n  },\n};\n\nfunction routeRow(route: SourceEventRoute): string[] {\n  return [\n    route.product,\n    route.key,\n    route.value,\n    route.label ?? '—',\n    route.team.slug ?? route.team.name,\n  ];\n}\n\nclass RoutesClient {\n  constructor(\n    private readonly env: AuthEnvironment,\n    private session: StoredSession,\n  ) {}\n\n  async call<T>(\n    send: (accessToken: string) => Promise<RoutesApiResult<T>>,\n  ): Promise<T> {\n    let result = await send(this.session.accessToken);\n    if (result.status === 'unauthorized') {\n      this.session = await refreshStoredSession(this.env, this.session);\n      result = await send(this.session.accessToken);\n    }\n    if (result.status === 'ok') return result.data;\n    throw authRequiredError(\n      `The session for ${this.env.host} could not authorize the routes call.`,\n      `Run \"ekanos login --host ${this.env.host}\" and retry.`,\n    );\n  }\n}\n\nfunction parseSubcommand(value: string | undefined): RoutesSubcommand {\n  const match = ROUTES_SUBCOMMANDS.find((name) => name === value);\n  if (match) return match;\n  throw usageError(\n    value\n      ? `Unknown routes subcommand \"${value}\".`\n      : 'routes needs a subcommand.',\n    USAGE,\n  );\n}\n\nfunction requireSlug(value: string | undefined, what = 'product'): string {\n  const slug = value?.trim().toLowerCase() ?? '';\n  if (/^[a-z0-9][a-z0-9-]{0,63}$/.test(slug)) return slug;\n  throw usageError(\n    `\"${value ?? ''}\" is not a ${what} slug.`,\n    what === 'team'\n      ? 'Run \"ekanos teams list\" to see the teams on this Source.'\n      : 'Run \"ekanos catalog\" to see what the Source has.',\n  );\n}\n\nfunction requireValue(value: string | undefined): string {\n  const trimmed = value?.trim() ?? '';\n  if (trimmed.length > 0 && trimmed.length <= 200) return trimmed;\n  throw usageError(\n    'A route value is 1 to 200 characters.',\n    '\"ekanos routes options <product>\" lists the values the integration knows.',\n  );\n}\n\nfunction requireEventId(value: string | undefined): string {\n  const id = value?.trim() ?? '';\n  if (/^[0-9a-f-]{36}$/i.test(id)) return id;\n  throw usageError(\n    `\"${value ?? ''}\" is not an event id.`,\n    '\"ekanos routes unrouted\" lists the events waiting for a mapping.',\n  );\n}\n"]}

package/dist/commands/runs.d.ts

@@ -0,0 +1,42 @@
+import type { CliContext } from '../context.js';
+import type { ExitCode } from '../exit-codes.js';
+export declare const RUNS_SUBCOMMANDS: readonly ['start', 'list', 'show'];
+export declare const APPROVALS_SUBCOMMANDS: readonly ['list', 'approve', 'reject', 'edit'];
+export interface RunsArgs {
+    host?: string;
+    source?: string;
+    positionals: readonly string[];
+    team?: string;
+    agent?: string;
+    prompt?: string;
+    input?: string;
+    follow: boolean;
+    reason?: string;
+    body?: string;
+    dir: string;
+    env: Record<string, string | undefined>;
+    /** Test seam for the `--follow` poll delay. */
+    sleep?: (ms: number) => Promise<void>;
+}
+/**
+ * `runs` — run, list and inspect a team's agents as its Source admin. A run
+ * started here is the app's "Run now": it runs as the agent's creator under
+ * the agent's own grant, policy and approvals (writes still wait for one),
+ * and is attributed to you.
+ */
+export declare function runRuns(ctx: CliContext, args: RunsArgs): Promise<ExitCode>;
+/**
+ * `agents test <key> --team <slug>`: run the template's latest version — its
+ * draft, published or not — on one team, without publishing it. Marked as a
+ * draft test run in the ledger; the team's stored agent still bounds every
+ * tool call, so a draft can narrow what runs but never widen it.
+ */
+export declare function runAgentTest(ctx: CliContext, args: RunsArgs & {
+    key: string | undefined;
+}): Promise<ExitCode>;
+/**
+ * `approvals` — what a team's agent runs are waiting on, and deciding it.
+ * Decided with the authority a team's agent manager has in the app, and
+ * recorded as your decision.
+ */
+export declare function runApprovals(ctx: CliContext, args: RunsArgs): Promise<ExitCode>;