@ekanos/cli 0.9.0 → 0.11.0

package/dist/commands/reviewers.js

@@ -0,0 +1,162 @@
+import { refreshStoredSession, requireSession, resolveAuthEnvironment, } from '../auth/session.js';
+import { authRequiredError, usageError } from '../errors.js';
+import { addReviewer, listReviewers, removeReviewer, } from '../reviewers-api.js';
+import { resolveSourceTarget } from '../source-target.js';
+export const REVIEWERS_SUBCOMMANDS = ['list', 'add', 'remove'];
+const REACHES = ['source', 'team'];
+/**
+ * `reviewers` — a Source admin names who decides its agents' reply drafts
+ * held under an `approve` policy. A reviewer is one of the Source's own
+ * users, at a reach: `source` (drafts from every team's provided agents) or
+ * `team` (one named team's). `list` shows them; `add` names one; `remove`
+ * takes one off — every reach, or only the named team's with `--team`.
+ */
+export async function runReviewers(ctx, args) {
+    var _a;
+    var _b;
+    const [rawSubcommand, rawEmail, ...extra] = args.positionals;
+    const subcommand = parseSubcommand(rawSubcommand);
+    if (subcommand === 'list') {
+        if (rawEmail !== undefined || args.reach || args.team) {
+            throw usageError('reviewers list takes no arguments.', 'Run "ekanos reviewers list --source <slug>".');
+        }
+    }
+    else if (extra.length > 0) {
+        throw usageError(`Unexpected argument "${extra[0]}".`, 'See "ekanos reviewers --help".');
+    }
+    const email = subcommand === 'list' ? '' : requireEmail(rawEmail, subcommand);
+    const team = args.team === undefined ? undefined : requireTeam(args.team);
+    const reach = subcommand === 'add' ? requireReach(args.reach, email, team) : undefined;
+    if (subcommand === 'remove' && args.reach) {
+        throw usageError('reviewers remove takes no --reach.', `Run "ekanos reviewers remove ${email}" (every reach) or add "--team <slug>" for one team's.`);
+    }
+    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 ReviewersClient(env, resolved.session);
+    const source = resolved.source;
+    if (subcommand === 'list') {
+        const list = await client.call((token) => listReviewers(env.host, token, source));
+        if (list.reviewers.length === 0) {
+            return ctx.succeed(Object.assign({ host: env.host }, list), ctx.ui.result({
+                title: `No reviewers on ${list.source.slug}`,
+                tone: 'warn',
+                notes: [
+                    'Reply drafts under an "approve" policy wait for a named reviewer.',
+                    'Name one: "ekanos reviewers add <email> --reach source".',
+                ],
+            }));
+        }
+        return ctx.succeed(Object.assign({ host: env.host }, list), [
+            ctx.ui.bold(`Reviewers on ${list.source.slug}`),
+            ctx.ui.table(['Email', 'Name', 'Reach', 'Team'], list.reviewers.map(reviewerRow)),
+        ].join('\n'));
+    }
+    if (subcommand === 'add' && reach) {
+        const result = await client.call((token) => addReviewer(env.host, token, source, Object.assign({ email,
+            reach }, (team ? { team } : {}))));
+        const reviewer = result.reviewer;
+        return ctx.succeed(Object.assign({ host: env.host }, result), ctx.ui.result({
+            title: result.created
+                ? `Added ${who(reviewer)} as a reviewer`
+                : `${who(reviewer)} already reviews at that reach`,
+            tone: result.created ? 'ok' : 'warn',
+            rows: [
+                ['Source', source],
+                ['Reach', reachLabel(reviewer)],
+            ],
+            notes: [
+                reviewer.reach === 'source'
+                    ? "Decides drafts from every team's provided agents, in the Source's review queue."
+                    : `Decides ${(_b = (_a = reviewer.team) === null || _a === void 0 ? void 0 : _a.slug) !== null && _b !== void 0 ? _b : 'the team'}'s drafts, from its Approvals inbox or the Source's review queue.`,
+            ],
+        }));
+    }
+    const result = await client.call((token) => removeReviewer(env.host, token, source, Object.assign({ email }, (team ? { team } : {}))));
+    return ctx.succeed(Object.assign({ host: env.host }, result), ctx.ui.result({
+        title: `Removed ${email}${team ? ` from ${team}` : ''}`,
+        rows: [
+            ['Source', source],
+            [
+                'Removed',
+                `${result.removed} reach${result.removed === 1 ? '' : 'es'}`,
+            ],
+        ],
+    }));
+}
+function reviewerRow(reviewer) {
+    var _a;
+    var _b, _c, _d;
+    return [
+        (_b = reviewer.email) !== null && _b !== void 0 ? _b : reviewer.userId,
+        (_c = reviewer.name) !== null && _c !== void 0 ? _c : '—',
+        reviewer.reach,
+        (_d = (_a = reviewer.team) === null || _a === void 0 ? void 0 : _a.slug) !== null && _d !== void 0 ? _d : '—',
+    ];
+}
+function reachLabel(reviewer) {
+    return reviewer.reach === 'team' && reviewer.team
+        ? `team ${reviewer.team.slug} (${reviewer.team.name})`
+        : 'source';
+}
+function who(reviewer) {
+    var _a, _b;
+    return (_b = (_a = reviewer.email) !== null && _a !== void 0 ? _a : reviewer.name) !== null && _b !== void 0 ? _b : reviewer.userId;
+}
+class ReviewersClient {
+    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 reviewers call.`, `Run "ekanos login --host ${this.env.host}" and retry.`);
+    }
+}
+function parseSubcommand(value) {
+    const match = REVIEWERS_SUBCOMMANDS.find((name) => name === value);
+    if (match)
+        return match;
+    throw usageError(value
+        ? `Unknown reviewers subcommand "${value}".`
+        : 'reviewers needs a subcommand.', 'Run one of: ekanos reviewers list, ekanos reviewers add <email> --reach source|team [--team <slug>], ekanos reviewers remove <email> [--team <slug>].');
+}
+function requireEmail(value, subcommand) {
+    const email = value === null || value === void 0 ? void 0 : value.trim().toLowerCase();
+    if (email && /^[^\s@]+@[^\s@]+$/.test(email))
+        return email;
+    throw usageError(value
+        ? `"${value}" is not an email address.`
+        : 'Name the reviewer by email.', subcommand === 'add'
+        ? 'e.g. "ekanos reviewers add ana@example.com --reach source".'
+        : '"ekanos reviewers list" shows who reviews.');
+}
+function requireTeam(value) {
+    const slug = value.trim().toLowerCase();
+    if (/^[a-z0-9][a-z0-9-]*$/.test(slug))
+        return slug;
+    throw usageError(`"${value}" is not a team slug.`, 'Run "ekanos teams list" to see the teams on this Source.');
+}
+function requireReach(value, email, team) {
+    const reach = REACHES.find((entry) => entry === (value === null || value === void 0 ? void 0 : value.trim().toLowerCase()));
+    if (!reach) {
+        throw usageError(value
+            ? `"${value}" is not a reach: use source or team.`
+            : 'Name the reach: --reach source or --reach team.', `e.g. "ekanos reviewers add ${email} --reach source", or "--reach team --team <slug>" for one team's drafts.`);
+    }
+    if (reach === 'team' && !team) {
+        throw usageError('A team-reach reviewer needs --team <slug>.', 'Run "ekanos teams list" to see the teams on this Source.');
+    }
+    if (reach === 'source' && team) {
+        throw usageError('A source-reach reviewer decides for every team; drop --team.', `Run "ekanos reviewers add ${email} --reach source", or use "--reach team --team ${team}".`);
+    }
+    return reach;
+}
+//# sourceMappingURL=reviewers.js.map

package/dist/commands/reviewers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewers.js","sourceRoot":"","sources":["../../src/commands/reviewers.ts"],"names":[],"mappings":"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","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/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>;

package/dist/commands/runs.js

@@ -0,0 +1,362 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { refreshStoredSession, requireSession, resolveAuthEnvironment, } from '../auth/session.js';
+import { authRequiredError, usageError, validationError } from '../errors.js';
+import { decideApproval, listApprovals, listRuns, showRun, startRun, } from '../runs-api.js';
+import { resolveSourceTarget } from '../source-target.js';
+export const RUNS_SUBCOMMANDS = ['start', 'list', 'show'];
+export const APPROVALS_SUBCOMMANDS = [
+    'list',
+    'approve',
+    'reject',
+    'edit',
+];
+const FOLLOW_INTERVAL_MS = 2000;
+const FOLLOW_TIMEOUT_MS = 15 * 60 * 1000;
+/**
+ * `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 async function runRuns(ctx, args) {
+    const [rawSubcommand, operand, ...extra] = args.positionals;
+    const subcommand = RUNS_SUBCOMMANDS.find((name) => name === rawSubcommand);
+    if (!subcommand) {
+        throw usageError(rawSubcommand
+            ? `Unknown runs subcommand "${rawSubcommand}".`
+            : 'runs needs a subcommand.', 'Run one of: ekanos runs start <agent> --team <slug> --prompt "…", ekanos runs list --team <slug>, ekanos runs show <run-id> --team <slug>.');
+    }
+    rejectExtra(extra, 'runs');
+    const team = requireTeam(args.team);
+    if (subcommand === 'start') {
+        const agent = requireOperand(operand, 'agent key', 'runs start');
+        return startAndReport(ctx, args, { team, agent, draft: false });
+    }
+    const { env, client, source } = await connect(ctx, args);
+    if (subcommand === 'list') {
+        if (operand)
+            rejectExtra([operand], 'runs list');
+        const list = await client.call((token) => listRuns(env.host, token, { source, team, agent: args.agent }));
+        return ctx.succeed(Object.assign({ host: env.host }, list), list.runs.length === 0
+            ? ctx.ui.result({
+                title: `No runs on ${list.team.slug}${args.agent ? ` for ${args.agent}` : ''}`,
+                tone: 'warn',
+            })
+            : ctx.ui.table(['RUN', 'AGENT', 'STATUS', 'TRIGGER', 'VERSION', 'STARTED'], list.runs.map((run) => [
+                run.id,
+                agentLabel(run.agent),
+                run.status,
+                run.trigger,
+                versionLabel(run),
+                run.startedAt.slice(0, 19).replace('T', ' '),
+            ])));
+    }
+    const runId = requireOperand(operand, 'run id', 'runs show');
+    const detail = await client.call((token) => showRun(env.host, token, { source, team, runId }));
+    return ctx.succeed(Object.assign({ host: env.host }, detail), runDetail(ctx.ui, detail));
+}
+/**
+ * `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 async function runAgentTest(ctx, args) {
+    const agent = requireOperand(args.key, 'agent key', 'agents test');
+    const team = requireTeam(args.team);
+    return startAndReport(ctx, args, { team, agent, draft: true });
+}
+/**
+ * `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 async function runApprovals(ctx, args) {
+    const [rawSubcommand, operand, ...extra] = args.positionals;
+    const subcommand = APPROVALS_SUBCOMMANDS.find((name) => name === rawSubcommand);
+    if (!subcommand) {
+        throw usageError(rawSubcommand
+            ? `Unknown approvals subcommand "${rawSubcommand}".`
+            : 'approvals needs a subcommand.', 'Run one of: ekanos approvals list --team <slug>, ekanos approvals approve|reject <id> --team <slug> [--reason "…"], ekanos approvals edit <id> --team <slug> --body <file>.');
+    }
+    rejectExtra(extra, 'approvals');
+    const team = requireTeam(args.team);
+    if (subcommand === 'list') {
+        if (operand)
+            rejectExtra([operand], 'approvals list');
+        const { env, client, source } = await connect(ctx, args);
+        const list = await client.call((token) => listApprovals(env.host, token, { source, team }));
+        return ctx.succeed(Object.assign({ host: env.host }, list), list.approvals.length === 0
+            ? ctx.ui.result({ title: `Nothing waiting on ${list.team.slug}` })
+            : ctx.ui.result({
+                title: `${list.approvals.length} waiting on ${list.team.slug}`,
+                tone: 'warn',
+                rows: list.approvals.map((approval) => [
+                    approval.id,
+                    approvalLines(approval),
+                ]),
+                notes: [
+                    '"ekanos approvals approve|reject <id> --team <slug>" decides one; "approvals edit <id> --body <file>" edits a reply draft and sends it.',
+                ],
+            }));
+    }
+    const approvalId = requireOperand(operand, 'approval id', `approvals ${subcommand}`);
+    const editedBody = subcommand === 'edit' ? readBodyFile(args.body, args.dir) : undefined;
+    if (subcommand !== 'edit' && args.body) {
+        throw usageError('--body is for "approvals edit".', `Run "ekanos approvals edit ${approvalId} --team ${team} --body <file>".`);
+    }
+    const { env, client, source } = await connect(ctx, args);
+    const decided = await client.call((token) => decideApproval(env.host, token, { source, team, approvalId }, Object.assign(Object.assign({ decision: subcommand === 'reject' ? 'rejected' : 'approved' }, (args.reason ? { reason: args.reason } : {})), (editedBody ? { body: editedBody } : {}))));
+    const approval = decided.approval;
+    return ctx.succeed(Object.assign({ host: env.host }, decided), ctx.ui.result({
+        title: `${approval.status === 'rejected' ? 'Rejected' : editedBody ? 'Edited and approved' : 'Approved'} ${approval.toolName}`,
+        tone: approval.status === 'rejected' ? 'warn' : 'ok',
+        rows: [
+            ['Agent', agentLabel(approval.agent)],
+            ['Run', approval.runId],
+        ],
+        notes: [
+            `The run picks it up now: "ekanos runs show ${approval.runId} --team ${team}".`,
+        ],
+    }));
+}
+async function startAndReport(ctx, args, target) {
+    const body = startBody(args, target);
+    const { env, client, source } = await connect(ctx, args);
+    const started = await client.call((token) => startRun(env.host, token, { source, team: target.team }, body));
+    const startedNote = `${target.draft ? 'Testing' : 'Started'} ${agentLabel(started.agent)} on ${started.team.slug}${started.draftTemplateVersion ? ` (draft v${started.draftTemplateVersion}, unpublished)` : ''}: run ${started.runId}`;
+    if (!args.follow) {
+        return ctx.succeed(Object.assign({ host: env.host }, started), ctx.ui.result({
+            title: startedNote,
+            notes: [
+                `Watch it: "ekanos runs show ${started.runId} --team ${target.team}".`,
+            ],
+        }));
+    }
+    ctx.log(startedNote);
+    const detail = await follow(ctx, args, async (after) => client.call((token) => showRun(env.host, token, {
+        source,
+        team: target.team,
+        runId: started.runId,
+        after,
+    })));
+    return ctx.succeed(Object.assign({ host: env.host, started }, detail), runDetail(ctx.ui, detail));
+}
+/**
+ * Poll the run, printing its status changes, its messages and each tool
+ * call as it lands, until it ends or parks on an approval.
+ */
+async function follow(ctx, args, read) {
+    var _a;
+    const sleep = (_a = args.sleep) !== null && _a !== void 0 ? _a : ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    const seenCalls = new Set();
+    const events = [];
+    let lastEvent;
+    let lastStatus = '';
+    const deadline = Date.now() + FOLLOW_TIMEOUT_MS;
+    for (;;) {
+        const detail = await read(lastEvent);
+        for (const event of detail.events) {
+            events.push(event);
+            lastEvent = event.id;
+            for (const line of eventLines(event.message))
+                ctx.log(`  ${line}`);
+        }
+        for (const call of detail.toolCalls) {
+            if (seenCalls.has(call.toolCallId))
+                continue;
+            seenCalls.add(call.toolCallId);
+            ctx.log(`  ${call.ok === false ? '✗' : '✓'} ${call.toolName} (${call.effect}, ${call.authorizedVia})${call.error ? ` — ${call.error}` : ''}`);
+        }
+        if (detail.run.status !== lastStatus) {
+            lastStatus = detail.run.status;
+            ctx.log(`  status: ${lastStatus}`);
+        }
+        const waiting = detail.approvals.some((approval) => approval.status === 'pending');
+        const ended = ['completed', 'failed', 'cancelled'].includes(detail.run.status);
+        if (ended || waiting || Date.now() > deadline) {
+            return Object.assign(Object.assign({}, detail), { events });
+        }
+        await sleep(FOLLOW_INTERVAL_MS);
+    }
+}
+/** Assistant text and tool calls from one live transcript message. */
+function eventLines(message) {
+    if (!isRecord(message))
+        return [];
+    const content = message.content;
+    if (message.role === 'assistant' && typeof content === 'string') {
+        return content.trim() ? [`agent: ${clip(content)}`] : [];
+    }
+    if (!Array.isArray(content))
+        return [];
+    return content.flatMap((part) => {
+        if (!isRecord(part))
+            return [];
+        if (part.type === 'text' && message.role === 'assistant') {
+            return typeof part.text === 'string' && part.text.trim()
+                ? [`agent: ${clip(part.text)}`]
+                : [];
+        }
+        if (part.type === 'tool-call' && typeof part.toolName === 'string') {
+            return [`→ ${part.toolName}`];
+        }
+        return [];
+    });
+}
+function startBody(args, target) {
+    if (!args.prompt && !args.input) {
+        throw usageError('Give the run a prompt or an input.', `Pass --prompt "…" or --input <file.json>.`);
+    }
+    let input;
+    if (args.input) {
+        const file = path.resolve(args.dir, args.input);
+        let raw;
+        try {
+            raw = fs.readFileSync(file, 'utf8');
+        }
+        catch (_a) {
+            throw usageError(`Cannot read ${file}.`, 'Pass --input <file.json>.');
+        }
+        try {
+            input = JSON.parse(raw);
+        }
+        catch (_b) {
+            throw validationError(`${file} is not valid JSON.`, 'Fix the file, or pass the text with --prompt instead.');
+        }
+    }
+    return Object.assign(Object.assign(Object.assign({ agent: target.agent }, (args.prompt ? { prompt: args.prompt } : {})), (input !== undefined ? { input } : {})), { draft: target.draft });
+}
+function readBodyFile(file, dir) {
+    if (!file) {
+        throw usageError('approvals edit needs the reply to send.', 'Pass --body <file> with the edited reply text.');
+    }
+    const resolved = path.resolve(dir, file);
+    let text;
+    try {
+        text = fs.readFileSync(resolved, 'utf8');
+    }
+    catch (_a) {
+        throw usageError(`Cannot read ${resolved}.`, 'Pass --body <file>.');
+    }
+    if (!text.trim()) {
+        throw validationError(`${resolved} is empty.`, 'Write the reply to send.');
+    }
+    return text;
+}
+function runDetail(ui, detail) {
+    const { run } = detail;
+    const pending = detail.approvals.filter((approval) => approval.status === 'pending');
+    const rows = [
+        ['Agent', agentLabel(run.agent)],
+        ['Status', run.status],
+        ['Trigger', run.trigger],
+        ['Version', versionLabel(run)],
+        ['Started', run.startedAt],
+        ...(run.finishedAt ? [['Finished', run.finishedAt]] : []),
+        ...(run.error ? [['Error', run.error]] : []),
+        [
+            'Tool calls',
+            detail.toolCalls.length === 0
+                ? 'none'
+                : detail.toolCalls.map((call) => `${call.ok === false ? '✗' : '✓'} ${call.toolName} (${call.effect}, ${call.authorizedVia})`),
+        ],
+        ...(pending.length > 0
+            ? [
+                [
+                    'Waiting on',
+                    pending.flatMap((approval) => [
+                        `${approval.id}  ${approval.toolName}${approval.replyDraft ? ' (reply draft)' : ''}`,
+                    ]),
+                ],
+            ]
+            : []),
+        ...(run.output ? [['Output', run.output.split('\n')]] : []),
+    ];
+    return ui.result({
+        title: `Run ${run.id}`,
+        tone: run.status === 'failed'
+            ? 'err'
+            : run.status === 'completed'
+                ? 'ok'
+                : 'warn',
+        rows,
+        notes: pending.length > 0
+            ? [
+                `Decide: "ekanos approvals approve|reject <id> --team ${detail.team.slug}". Full record: --json.`,
+            ]
+            : ['The full transcript and every tool call: --json.'],
+    });
+}
+function approvalLines(approval) {
+    var _a;
+    return [
+        `${approval.toolName} · ${agentLabel(approval.agent)}${approval.replyDraft ? ' · reply draft (editable)' : ''}`,
+        `run ${approval.runId}${approval.expiresAt ? ` · expires ${approval.expiresAt}` : ''}`,
+        clip(JSON.stringify((_a = approval.args) !== null && _a !== void 0 ? _a : null)),
+    ];
+}
+function agentLabel(agent) {
+    var _a;
+    return (_a = agent.templateKey) !== null && _a !== void 0 ? _a : agent.slug;
+}
+function versionLabel(run) {
+    return run.draftTemplateVersion
+        ? `v${run.agentVersion} · draft test of template v${run.draftTemplateVersion}`
+        : `v${run.agentVersion}`;
+}
+function clip(text, max = 200) {
+    const flat = text.replace(/\s+/g, ' ').trim();
+    return flat.length > max ? `${flat.slice(0, max - 1)}…` : flat;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function requireTeam(value) {
+    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 team slug.`
+        : 'Name the team with --team <slug>.', '"ekanos teams list" lists the teams on this Source.');
+}
+function requireOperand(value, what, command) {
+    const trimmed = value === null || value === void 0 ? void 0 : value.trim();
+    if (trimmed)
+        return trimmed;
+    throw usageError(`Name the ${what}.`, `See "ekanos ${command} --help".`);
+}
+function rejectExtra(extra, command) {
+    if (extra.length > 0) {
+        throw usageError(`Unexpected argument "${extra[0]}".`, `See "ekanos ${command.split(' ')[0]} --help".`);
+    }
+}
+async function connect(ctx, args) {
+    const env = resolveAuthEnvironment(ctx, args.host, args.env, {
+        projectDir: args.dir,
+    });
+    const resolved = await resolveSourceTarget(env, requireSession(env.store, env.host), args);
+    return {
+        env,
+        client: new RunsClient(env, resolved.session),
+        source: resolved.source,
+    };
+}
+class RunsClient {
+    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 call.`, `Run "ekanos login --host ${this.env.host}" and retry.`);
+    }
+}
+//# sourceMappingURL=runs.js.map