@dharta/cli 0.6.77

package/dist/commands/parity.js

@@ -0,0 +1,73 @@
+// `dharta dev --release vN` / `--env remote` (RFC 0013 CLI-10): two
+// orthogonal parity axes. --release runs the exact built tree prod
+// serves (transcript-driven debugging: read the transcript with
+// `dharta sessions show`, replay against the same code locally);
+// --env remote binds prod env vars instead of .env. Honest limits:
+// parity of code + config, not infrastructure.
+import { promises as fs } from "node:fs";
+import { randomUUID } from "node:crypto";
+import * as os from "node:os";
+import * as path from "node:path";
+import { spawn } from "node:child_process";
+import { inferAgentSlug } from "../agent.js";
+import { parseReleaseVersion } from "../validators.js";
+// Download + extract the release archive; returns the extracted dir.
+export async function prepareReleaseDir(ctx, releaseVersion, opts = {}) {
+    const version = parseReleaseVersion(releaseVersion, "--release");
+    const slug = await inferAgentSlug(opts);
+    const meta = await ctx.http.request({
+        path: `/api/agents/${encodeURIComponent(slug)}/releases/${encodeURIComponent(version)}/archive`,
+    });
+    const fetchImpl = (opts.fetchImpl ?? globalThis.fetch).bind(globalThis);
+    const res = await fetchReleaseArchive(meta.url, slug, fetchImpl);
+    if (!res.ok) {
+        throw new Error(`Could not download the release archive (HTTP ${res.status}). ` +
+            `Check the version with \`dharta agent releases ${slug}\` and retry.`);
+    }
+    const bytes = Buffer.from(await res.arrayBuffer());
+    const dir = await fs.mkdtemp(path.join(os.tmpdir(), `karta-${slug}-v${meta.version}-`));
+    const tarball = path.join(dir, "release.tar.gz");
+    await fs.writeFile(tarball, bytes);
+    await untar(tarball, dir);
+    await fs.rm(tarball, { force: true });
+    return { dir, version: meta.version, commitSha: meta.commit_sha };
+}
+// Fetch prod env bindings for --env remote. Secrets ride the same D6
+// rails as `dharta env pull --include-secrets`.
+export async function fetchRemoteEnv(ctx, opts = {}) {
+    const slug = await inferAgentSlug(opts);
+    const body = await ctx.http.request({
+        method: "POST",
+        path: `/api/agents/${encodeURIComponent(slug)}/env/pull`,
+        headers: { "Idempotency-Key": randomUUID() },
+        body: { include_secrets: !!opts.includeSecrets },
+    });
+    const values = {};
+    const withheld = [];
+    for (const entry of body.env) {
+        if (entry.withheld)
+            withheld.push(entry.name);
+        else
+            values[entry.name] = entry.value ?? "";
+    }
+    return { values, withheld };
+}
+async function fetchReleaseArchive(url, slug, fetchImpl) {
+    try {
+        return await fetchImpl(url);
+    }
+    catch (error) {
+        throw new Error(`Could not download the release archive from ${url}: ${error.message}. ` +
+            `Check the version with \`dharta agent releases ${slug}\` and retry.`);
+    }
+}
+function untar(tarball, dest) {
+    return new Promise((resolve, reject) => {
+        const proc = spawn("tar", ["-xzf", tarball, "-C", dest], { stdio: "ignore" });
+        proc.on("error", () => reject(new Error("Could not extract the release archive (is `tar` installed?).")));
+        proc.on("close", (code) => code === 0
+            ? resolve()
+            : reject(new Error(`tar exited ${code} extracting the release archive.`)));
+    });
+}
+//# sourceMappingURL=parity.js.map

package/dist/commands/parity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parity.js","sourceRoot":"","sources":["../../src/commands/parity.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,mEAAmE;AACnE,gEAAgE;AAChE,iEAAiE;AACjE,mEAAmE;AACnE,+CAA+C;AAE/C,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,OAAO,EAAE,cAAc,EAA0B,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,qEAAqE;AACrE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,GAAe,EACf,cAAsB,EACtB,OAAyD,EAAE;IAE3D,MAAM,OAAO,GAAG,mBAAmB,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAuD;QACxF,IAAI,EAAE,eAAe,kBAAkB,CAAC,IAAI,CAAC,aAAa,kBAAkB,CAAC,OAAO,CAAC,UAAU;KAChG,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxE,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IACjE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,gDAAgD,GAAG,CAAC,MAAM,KAAK;YAC7D,kDAAkD,IAAI,eAAe,CACxE,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;IAEnD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,IAAI,KAAK,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;IACxF,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IACjD,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACnC,MAAM,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC1B,MAAM,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;AACpE,CAAC;AAED,qEAAqE;AACrE,gDAAgD;AAChD,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAe,EACf,OAAyD,EAAE;IAE3D,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAEhC;QACD,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,eAAe,kBAAkB,CAAC,IAAI,CAAC,WAAW;QACxD,OAAO,EAAE,EAAE,iBAAiB,EAAE,UAAU,EAAE,EAAE;QAC5C,IAAI,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,EAAE;KACjD,CAAC,CAAC;IAEH,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,QAAQ;YAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;;YACzC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;IAC9C,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,GAAW,EAAE,IAAY,EAAE,SAAuB;IACnF,IAAI,CAAC;QACH,OAAO,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,+CAA+C,GAAG,KAAM,KAAe,CAAC,OAAO,IAAI;YACjF,kDAAkD,IAAI,eAAe,CACxE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,KAAK,CAAC,OAAe,EAAE,IAAY;IAC1C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC9E,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CACpB,MAAM,CAAC,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC,CAClF,CAAC;QACF,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CACxB,IAAI,KAAK,CAAC;YACR,CAAC,CAAC,OAAO,EAAE;YACX,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,cAAc,IAAI,kCAAkC,CAAC,CAAC,CAC5E,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/rollback.d.ts

@@ -0,0 +1,21 @@
+import type { CliContext } from "../context.js";
+export interface RollbackResponse {
+    agent: {
+        id: string;
+        slug: string;
+        name: string;
+    };
+    release: {
+        id: string;
+        version: number;
+        status: string;
+        commit_sha: string;
+    };
+    previous_release: {
+        id: string;
+        version: number;
+        status: string;
+    } | null;
+}
+export declare function rollbackData(ctx: CliContext, slug: string, toVersion: number): Promise<RollbackResponse>;
+export declare function rollback(ctx: CliContext, slug: string, toVersion: number): Promise<string>;

package/dist/commands/rollback.js

@@ -0,0 +1,26 @@
+import { randomUUID } from "node:crypto";
+import { validateAgentSlug } from "../agent.js";
+export async function rollbackData(ctx, slug, toVersion) {
+    const normalizedSlug = validateAgentSlug(slug, "agent slug");
+    const normalizedVersion = normalizeRollbackVersion(toVersion);
+    return ctx.http.request({
+        method: "POST",
+        path: `/api/agents/${encodeURIComponent(normalizedSlug)}/rollback`,
+        headers: { "Idempotency-Key": randomUUID() },
+        body: { to_version: normalizedVersion },
+    });
+}
+export async function rollback(ctx, slug, toVersion) {
+    const res = await rollbackData(ctx, slug, toVersion);
+    const prev = res.previous_release
+        ? ` (from v${res.previous_release.version})`
+        : "";
+    return `Rolled back ${res.agent.slug} to v${res.release.version}${prev}.`;
+}
+function normalizeRollbackVersion(toVersion) {
+    if (!Number.isSafeInteger(toVersion) || toVersion <= 0) {
+        throw new Error("version must be a positive whole number.");
+    }
+    return toVersion;
+}
+//# sourceMappingURL=rollback.js.map

package/dist/commands/rollback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollback.js","sourceRoot":"","sources":["../../src/commands/rollback.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAQhD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAe,EACf,IAAY,EACZ,SAAiB;IAEjB,MAAM,cAAc,GAAG,iBAAiB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC7D,MAAM,iBAAiB,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAC;IAC9D,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,CAAmB;QACxC,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,eAAe,kBAAkB,CAAC,cAAc,CAAC,WAAW;QAClE,OAAO,EAAE,EAAE,iBAAiB,EAAE,UAAU,EAAE,EAAE;QAC5C,IAAI,EAAE,EAAE,UAAU,EAAE,iBAAiB,EAAE;KACxC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,GAAe,EACf,IAAY,EACZ,SAAiB;IAEjB,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,GAAG,CAAC,gBAAgB;QAC/B,CAAC,CAAC,WAAW,GAAG,CAAC,gBAAgB,CAAC,OAAO,GAAG;QAC5C,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,eAAe,GAAG,CAAC,KAAK,CAAC,IAAI,QAAQ,GAAG,CAAC,OAAO,CAAC,OAAO,GAAG,IAAI,GAAG,CAAC;AAC5E,CAAC;AAED,SAAS,wBAAwB,CAAC,SAAiB;IACjD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/commands/schedules.d.ts

@@ -0,0 +1,52 @@
+import { type AgentInferOptions } from "../agent.js";
+import type { CliContext } from "../context.js";
+export interface Schedule {
+    id: number;
+    cron: string;
+    timezone: string;
+    initial_message: string;
+    release_version: number | null;
+    budget_cents: number | null;
+    end_user_id: string | null;
+    enabled: boolean;
+    next_fire_at: string | null;
+    last_fired_at: string | null;
+    created_at: string;
+    updated_at: string;
+}
+interface ScheduleEnvelope {
+    schedule: Schedule;
+    changed?: boolean;
+    queued?: boolean;
+}
+export interface ScheduleCreateOptions extends AgentInferOptions {
+    cron?: string;
+    timezone?: string;
+    message?: string;
+    budget?: string;
+    budgetCents?: string;
+    releaseVersion?: string;
+    endUserId?: string;
+    runNow?: boolean;
+}
+export declare function schedulesListData(ctx: CliContext, opts: AgentInferOptions): Promise<{
+    slug: string;
+    data: Schedule[];
+}>;
+export declare function schedulesList(ctx: CliContext, opts: AgentInferOptions): Promise<string>;
+export declare function schedulesCreateData(ctx: CliContext, opts: ScheduleCreateOptions): Promise<{
+    slug: string;
+} & ScheduleEnvelope>;
+export declare function schedulesCreate(ctx: CliContext, opts: ScheduleCreateOptions): Promise<string>;
+export declare function validateSchedulesCreateInput(opts: ScheduleCreateOptions): void;
+export declare function schedulesActionData(ctx: CliContext, id: string, action: "pause" | "resume" | "run", opts: AgentInferOptions): Promise<{
+    slug: string;
+} & ScheduleEnvelope>;
+export declare function schedulesAction(ctx: CliContext, id: string, action: "pause" | "resume" | "run", opts: AgentInferOptions): Promise<string>;
+export declare function schedulesDeleteData(ctx: CliContext, id: string, opts: AgentInferOptions): Promise<{
+    slug: string;
+    id: string;
+    deleted: boolean;
+}>;
+export declare function schedulesDelete(ctx: CliContext, id: string, opts: AgentInferOptions): Promise<string>;
+export {};

package/dist/commands/schedules.js

@@ -0,0 +1,231 @@
+import { randomUUID } from "node:crypto";
+import { inferAgentSlug } from "../agent.js";
+import { parseDollarAmountToCents } from "../money.js";
+import { fmtTs, table } from "../output.js";
+import { normalizeNonBlank, normalizeTimezone, parsePositiveInteger, parseReleaseVersion } from "../validators.js";
+export async function schedulesListData(ctx, opts) {
+    const slug = await inferAgentSlug(opts);
+    const res = await ctx.http.request({
+        path: `/api/agents/${encodeURIComponent(slug)}/schedules`,
+    });
+    return { slug, data: res.data };
+}
+export async function schedulesList(ctx, opts) {
+    const { slug, data } = await schedulesListData(ctx, opts);
+    if (data.length === 0)
+        return `No schedules for ${slug}. Create one with: dharta schedules create --agent ${slug} --cron '0 9 * * *' --message 'Daily check-in'`;
+    return table(data.map((schedule) => ({
+        id: String(schedule.id),
+        state: schedule.enabled ? "enabled" : "paused",
+        cron: schedule.cron,
+        timezone: schedule.timezone,
+        next: fmtTs(schedule.next_fire_at),
+        budget: formatBudget(schedule.budget_cents),
+    })));
+}
+export async function schedulesCreateData(ctx, opts) {
+    validateSchedulesCreateInput(opts);
+    const cron = opts.cron;
+    const message = opts.message;
+    const slug = await inferAgentSlug(opts);
+    const body = {
+        cron: normalizeRequired(cron, "--cron"),
+        timezone: opts.timezone === undefined ? "UTC" : normalizeTimezone(opts.timezone, "--timezone"),
+        initial_message: normalizeRequired(message, "--message"),
+    };
+    if (opts.budget !== undefined && opts.budgetCents !== undefined) {
+        throw new Error("Use either --budget or --budget-cents, not both.");
+    }
+    if (opts.budget !== undefined)
+        body.budget_cents = parseDollarAmountToCents(opts.budget, "--budget");
+    if (opts.budgetCents !== undefined)
+        body.budget_cents = parsePositiveWholeNumber(opts.budgetCents, "--budget-cents");
+    if (opts.releaseVersion !== undefined)
+        body.release_version = parseReleaseVersion(opts.releaseVersion, "--release-version");
+    if (opts.endUserId !== undefined)
+        body.end_user_id = normalizeRequired(opts.endUserId, "--end-user-id");
+    const res = await ctx.http.request({
+        method: "POST",
+        path: `/api/agents/${encodeURIComponent(slug)}/schedules`,
+        headers: idempotencyHeader(),
+        body: { schedule: body },
+    });
+    if (opts.runNow) {
+        const run = await runScheduleNow(ctx, slug, String(res.schedule.id));
+        return { slug, ...res, queued: run.queued ?? true };
+    }
+    return { slug, ...res };
+}
+export async function schedulesCreate(ctx, opts) {
+    const res = await schedulesCreateData(ctx, opts);
+    return `Created schedule ${res.schedule.id} for ${res.slug}${res.queued ? " and queued one run" : ""}.`;
+}
+export function validateSchedulesCreateInput(opts) {
+    const missing = [
+        opts.cron === undefined ? "--cron <expr>" : null,
+        opts.message === undefined ? "--message <text>" : null,
+    ].filter((flag) => flag !== null);
+    if (missing.length > 0) {
+        throw new Error(`Pass ${formatMissingFlags(missing)}. ` +
+            "Usage: dharta schedules create --cron '0 9 * * *' --message 'Daily check-in'");
+    }
+    const cron = opts.cron;
+    const message = opts.message;
+    validateCron(cron);
+    if (opts.timezone !== undefined)
+        normalizeTimezone(opts.timezone, "--timezone");
+    normalizeRequired(message, "--message");
+    if (opts.budget !== undefined && opts.budgetCents !== undefined) {
+        throw new Error("Use either --budget or --budget-cents, not both.");
+    }
+    if (opts.budget !== undefined)
+        parseDollarAmountToCents(opts.budget, "--budget");
+    if (opts.budgetCents !== undefined)
+        parsePositiveWholeNumber(opts.budgetCents, "--budget-cents");
+    if (opts.releaseVersion !== undefined)
+        parseReleaseVersion(opts.releaseVersion, "--release-version");
+    if (opts.endUserId !== undefined)
+        normalizeRequired(opts.endUserId, "--end-user-id");
+}
+function formatMissingFlags(flags) {
+    return flags.length === 1 ? flags[0] : `${flags.slice(0, -1).join(", ")} and ${flags[flags.length - 1]}`;
+}
+function validateCron(value) {
+    const cron = normalizeRequired(value, "--cron");
+    const fields = cron.split(/\s+/);
+    if (fields.length !== 5 || fields.some((field) => field.length === 0)) {
+        throw new Error("--cron must be a standard 5-field cron expression, e.g. '0 9 * * *'.");
+    }
+    fields.forEach((field, index) => validateCronField(field, CRON_FIELD_SPECS[index]));
+}
+const CRON_FIELD_SPECS = [
+    { name: "minute", min: 0, max: 59, names: {} },
+    { name: "hour", min: 0, max: 23, names: {} },
+    { name: "day-of-month", min: 1, max: 31, names: {} },
+    {
+        name: "month",
+        min: 1,
+        max: 12,
+        names: { jan: 1, feb: 2, mar: 3, apr: 4, may: 5, jun: 6, jul: 7, aug: 8, sep: 9, oct: 10, nov: 11, dec: 12 },
+    },
+    {
+        name: "day-of-week",
+        min: 0,
+        max: 7,
+        names: { sun: 0, mon: 1, tue: 2, wed: 3, thu: 4, fri: 5, sat: 6 },
+    },
+];
+function validateCronField(field, spec) {
+    for (const item of field.split(",")) {
+        if (!item)
+            throw unsupportedCronField(spec);
+        const [base, step, extra] = item.split("/");
+        if (extra !== undefined || !base)
+            throw unsupportedCronField(spec);
+        if (step !== undefined && !/^[1-9]\d*$/.test(step)) {
+            throw new Error(`--cron ${spec.name} field step must be a positive whole number.`);
+        }
+        if (base === "*")
+            continue;
+        const [start, end, extraRange] = base.split("-");
+        if (extraRange !== undefined || !start)
+            throw unsupportedCronField(spec);
+        if (end === undefined) {
+            parseCronToken(start, spec);
+            continue;
+        }
+        if (!end)
+            throw unsupportedCronField(spec);
+        const rangeStart = parseCronToken(start, spec);
+        const rangeEnd = parseCronToken(end, spec);
+        if (rangeStart > rangeEnd) {
+            throw new Error(`--cron ${spec.name} field range must start before it ends.`);
+        }
+    }
+}
+function parseCronToken(token, spec) {
+    const normalized = token.toLowerCase();
+    const named = spec.names[normalized];
+    if (named !== undefined)
+        return named;
+    if (!/^\d+$/.test(token))
+        throw unsupportedCronField(spec);
+    const parsed = Number(token);
+    if (parsed < spec.min || parsed > spec.max) {
+        throw new Error(`--cron ${spec.name} field must be ${spec.min}-${spec.max}.`);
+    }
+    return parsed;
+}
+function unsupportedCronField(spec) {
+    return new Error(`--cron ${spec.name} field is not supported. Use numbers, *, ranges, lists, and steps.`);
+}
+export async function schedulesActionData(ctx, id, action, opts) {
+    const normalizedId = normalizeScheduleId(id);
+    const slug = await inferAgentSlug(opts);
+    const res = action === "run"
+        ? await runScheduleNow(ctx, slug, normalizedId)
+        : await ctx.http.request({
+            method: "POST",
+            path: `/api/agents/${encodeURIComponent(slug)}/schedules/${encodeURIComponent(normalizedId)}/${action}`,
+            headers: idempotencyHeader(),
+        });
+    return { slug, ...res };
+}
+export async function schedulesAction(ctx, id, action, opts) {
+    const res = await schedulesActionData(ctx, id, action, opts);
+    if (action === "run")
+        return `Queued schedule ${res.schedule.id} for ${res.slug}.`;
+    return `${action === "pause" ? "Paused" : "Resumed"} schedule ${res.schedule.id} for ${res.slug}${res.changed ? "" : " (unchanged)"}.`;
+}
+export async function schedulesDeleteData(ctx, id, opts) {
+    const normalizedId = normalizeScheduleId(id);
+    const slug = await inferAgentSlug(opts);
+    await ctx.http.request({
+        method: "DELETE",
+        path: `/api/agents/${encodeURIComponent(slug)}/schedules/${encodeURIComponent(normalizedId)}`,
+        headers: idempotencyHeader(),
+    });
+    return { slug, id: normalizedId, deleted: true };
+}
+export async function schedulesDelete(ctx, id, opts) {
+    const res = await schedulesDeleteData(ctx, id, opts);
+    return `Deleted schedule ${res.id} for ${res.slug}.`;
+}
+function parsePositiveWholeNumber(value, flag) {
+    const normalized = value.trim();
+    if (!/^\d+$/.test(normalized))
+        throw new Error(`${flag} must be a whole number.`);
+    const parsed = Number(normalized);
+    if (!Number.isSafeInteger(parsed) || parsed <= 0) {
+        throw new Error(`${flag} must be a positive whole number.`);
+    }
+    return parsed;
+}
+function formatBudget(cents) {
+    if (cents === null)
+        return "—";
+    return `$${(cents / 100).toFixed(2)}`;
+}
+function idempotencyHeader() {
+    return { "Idempotency-Key": randomUUID() };
+}
+function runScheduleNow(ctx, slug, id) {
+    return ctx.http.request({
+        method: "POST",
+        path: `/api/agents/${encodeURIComponent(slug)}/schedules/${encodeURIComponent(id)}/run`,
+        headers: idempotencyHeader(),
+    });
+}
+function normalizeRequired(value, flag) {
+    const normalized = value.trim();
+    if (!normalized) {
+        throw new Error(`${flag} cannot be blank.`);
+    }
+    return normalized;
+}
+function normalizeScheduleId(id) {
+    const normalized = normalizeNonBlank(id, "Schedule id");
+    parsePositiveInteger(normalized, "Schedule id");
+    return normalized;
+}
+//# sourceMappingURL=schedules.js.map

package/dist/commands/schedules.js.map

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

package/dist/commands/scopes.d.ts

@@ -0,0 +1,3 @@
+export declare const SENSITIVE_API_KEY_SCOPES: Set<string>;
+export declare function formatScopes(scopes: readonly string[], separator?: string): string;
+export declare function formatApiKeyExpiry(expiresAt: string | null | undefined): string;

package/dist/commands/scopes.js

@@ -0,0 +1,21 @@
+export const SENSITIVE_API_KEY_SCOPES = new Set([
+    "env:secrets:read",
+    "source_archives:read",
+    "workspace_tokens:create",
+    "workspace:read",
+    "audit_log:export",
+    "members:invite",
+    "members:write",
+    "members:owner_role:write",
+    "agents:delete",
+    "keys:write",
+    "model_keys:write",
+]);
+export function formatScopes(scopes, separator = ", ") {
+    return scopes.join(separator);
+}
+export function formatApiKeyExpiry(expiresAt) {
+    const normalized = expiresAt?.trim();
+    return normalized ? normalized : "none - revocable on the dashboard keys page";
+}
+//# sourceMappingURL=scopes.js.map

package/dist/commands/scopes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopes.js","sourceRoot":"","sources":["../../src/commands/scopes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC;IAC9C,kBAAkB;IAClB,sBAAsB;IACtB,yBAAyB;IACzB,gBAAgB;IAChB,kBAAkB;IAClB,gBAAgB;IAChB,eAAe;IACf,0BAA0B;IAC1B,eAAe;IACf,YAAY;IACZ,kBAAkB;CACnB,CAAC,CAAC;AAEH,MAAM,UAAU,YAAY,CAAC,MAAyB,EAAE,SAAS,GAAG,IAAI;IACtE,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,SAAoC;IACrE,MAAM,UAAU,GAAG,SAAS,EAAE,IAAI,EAAE,CAAC;IACrC,OAAO,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,6CAA6C,CAAC;AACjF,CAAC"}

package/dist/commands/sessions.d.ts

@@ -0,0 +1,53 @@
+import type { CliContext } from "../context.js";
+import { type AgentInferOptions } from "../agent.js";
+export interface SessionsOptions extends AgentInferOptions {
+    fetchImpl?: typeof fetch;
+    write?: (text: string) => void;
+    log?: (line: string) => void;
+    limit?: string;
+}
+export interface SessionRow {
+    id: string;
+    created_at: string;
+    last_message_at: string;
+    message_count: number;
+    model: string | null;
+    input_tokens: number;
+    output_tokens: number;
+    status: string;
+    end_user_id: string | null;
+}
+export interface TranscriptTurn {
+    role: string;
+    text: string;
+    at: string;
+}
+export interface SessionsListData {
+    slug: string;
+    total: number;
+    sessions: SessionRow[];
+}
+export declare function sessionsListData(ctx: CliContext, opts?: SessionsOptions, { activeOnly }?: {
+    activeOnly?: boolean | undefined;
+}): Promise<SessionsListData>;
+export declare function sessionsList(ctx: CliContext, opts?: SessionsOptions, { activeOnly }?: {
+    activeOnly?: boolean | undefined;
+}): Promise<string>;
+export declare function sessionsShowData(ctx: CliContext, sessionId: string, opts?: SessionsOptions): Promise<{
+    id: string;
+    messages: TranscriptTurn[];
+}>;
+export declare function sessionsShow(ctx: CliContext, sessionId: string, opts?: SessionsOptions): Promise<string>;
+export declare function psData(ctx: CliContext, opts?: SessionsOptions): Promise<SessionsListData>;
+export declare function ps(ctx: CliContext, opts?: SessionsOptions): Promise<string>;
+export declare function validateSessionsListOptions(opts?: Pick<SessionsOptions, "limit">): void;
+export interface RunOptions extends SessionsOptions {
+    sessionId?: string;
+    json?: boolean;
+}
+export interface RunResult {
+    agent: string;
+    session_id: string;
+    reply: string;
+}
+export declare function run(ctx: CliContext, message: string, opts?: RunOptions): Promise<RunResult>;