@dharta/cli 0.6.77

package/dist/commands/caps.js

@@ -0,0 +1,213 @@
+import { randomUUID } from "node:crypto";
+import { parseDollarAmountToCents } from "../money.js";
+export async function capsBudgetData(ctx) {
+    return ctx.http.request({ path: "/api/limits/budget" });
+}
+export async function capsBudget(ctx) {
+    const { budget, usage } = await capsBudgetData(ctx);
+    const hasBudget = budget.max_cost_cents !== null;
+    return [
+        `Monthly budget: ${formatMoney(budget.max_cost_cents)}`,
+        `Usage this period: ${formatMoney(usage.period_cost_cents)}`,
+        `Hard stop: ${hasBudget ? (budget.stop_usage ? "enabled" : "disabled") : "not active (no monthly budget)"}`,
+        `Alerts: ${hasBudget ? (budget.alerts_enabled ? `enabled at ${budget.alert_threshold_pct}%` : "disabled") : "not active (no monthly budget)"}`,
+    ].join("\n");
+}
+export async function capsBudgetSetData(ctx, opts) {
+    validateBudgetSetOptions(opts);
+    const body = {
+        max_cost_cents: dollarsToCents(opts.amount),
+    };
+    const stopUsage = stopUsageOption(opts);
+    if (stopUsage !== undefined)
+        body.stop_usage = stopUsage;
+    const alertsEnabled = alertsOption(opts);
+    if (alertsEnabled !== undefined)
+        body.alerts_enabled = alertsEnabled;
+    if (opts.alertThreshold !== undefined) {
+        body.alert_threshold_pct = parseWholeNumberInRange(opts.alertThreshold, "--alert-threshold", 0, 100);
+    }
+    if (opts.recipientUserId?.length) {
+        body.additional_recipient_user_ids = opts.recipientUserId.map((id) => parsePositiveWholeNumber(id, "--recipient-user-id"));
+    }
+    return ctx.http.request({
+        method: "PATCH",
+        path: "/api/limits/budget",
+        headers: { "Idempotency-Key": randomUUID() },
+        body,
+    });
+}
+export async function capsBudgetSet(ctx, opts) {
+    const { budget } = await capsBudgetSetData(ctx, opts);
+    return `Monthly budget set to ${formatMoney(budget.max_cost_cents)}${budget.stop_usage ? " (usage stops at the limit)" : ""}.`;
+}
+export async function capsInstanceData(ctx, instance) {
+    const normalizedInstance = normalizeRequired(instance, "instance id");
+    return ctx.http.request({ path: `/api/limits/instances/${encodeURIComponent(normalizedInstance)}/cap` });
+}
+export async function capsInstance(ctx, instance) {
+    const normalizedInstance = normalizeRequired(instance, "instance id");
+    return formatEntityCap(await capsInstanceData(ctx, normalizedInstance), `Instance ${normalizedInstance}`);
+}
+export async function capsInstanceSetData(ctx, instance, opts) {
+    const normalizedInstance = normalizeRequired(instance, "instance id");
+    validateCapSetOptions(opts);
+    return ctx.http.request({
+        method: "PATCH",
+        path: `/api/limits/instances/${encodeURIComponent(normalizedInstance)}/cap`,
+        headers: { "Idempotency-Key": randomUUID() },
+        body: capBody(opts),
+    });
+}
+export async function capsInstanceSet(ctx, instance, opts) {
+    const normalizedInstance = normalizeRequired(instance, "instance id");
+    const result = await capsInstanceSetData(ctx, normalizedInstance, opts);
+    return capSetMessage(`Instance ${normalizedInstance}`, result.cap, result.changed);
+}
+export async function capsEndUserData(ctx, endUserId) {
+    const normalizedEndUserId = normalizeRequired(endUserId, "end-user id");
+    return ctx.http.request({ path: `/api/limits/end_users/${encodeURIComponent(normalizedEndUserId)}/cap` });
+}
+export async function capsEndUser(ctx, endUserId) {
+    const normalizedEndUserId = normalizeRequired(endUserId, "end-user id");
+    return formatEntityCap(await capsEndUserData(ctx, normalizedEndUserId), `End-user ${normalizedEndUserId}`);
+}
+export async function capsEndUserSetData(ctx, endUserId, opts) {
+    const normalizedEndUserId = normalizeRequired(endUserId, "end-user id");
+    validateCapSetOptions(opts);
+    return ctx.http.request({
+        method: "PATCH",
+        path: `/api/limits/end_users/${encodeURIComponent(normalizedEndUserId)}/cap`,
+        headers: { "Idempotency-Key": randomUUID() },
+        body: capBody(opts),
+    });
+}
+export async function capsEndUserSet(ctx, endUserId, opts) {
+    const normalizedEndUserId = normalizeRequired(endUserId, "end-user id");
+    const result = await capsEndUserSetData(ctx, normalizedEndUserId, opts);
+    return capSetMessage(`End-user ${normalizedEndUserId}`, result.cap, result.changed);
+}
+export async function capsSeatData(ctx, instance, endUserId) {
+    const normalizedInstance = normalizeRequired(instance, "instance id");
+    const normalizedEndUserId = normalizeRequired(endUserId, "end-user id");
+    return ctx.http.request({
+        path: `/api/limits/instances/${encodeURIComponent(normalizedInstance)}/seat_cap?end_user_id=${encodeURIComponent(normalizedEndUserId)}`,
+    });
+}
+export async function capsSeat(ctx, instance, endUserId) {
+    const normalizedInstance = normalizeRequired(instance, "instance id");
+    const normalizedEndUserId = normalizeRequired(endUserId, "end-user id");
+    return formatEntityCap(await capsSeatData(ctx, normalizedInstance, normalizedEndUserId), `Seat ${normalizedEndUserId} on ${normalizedInstance}`);
+}
+export async function capsSeatSetData(ctx, instance, endUserId, opts) {
+    const normalizedInstance = normalizeRequired(instance, "instance id");
+    const normalizedEndUserId = normalizeRequired(endUserId, "end-user id");
+    validateCapSetOptions(opts);
+    return ctx.http.request({
+        method: "PATCH",
+        path: `/api/limits/instances/${encodeURIComponent(normalizedInstance)}/seat_cap`,
+        headers: { "Idempotency-Key": randomUUID() },
+        body: { ...capBody(opts), end_user_id: normalizedEndUserId },
+    });
+}
+export async function capsSeatSet(ctx, instance, endUserId, opts) {
+    const normalizedInstance = normalizeRequired(instance, "instance id");
+    const normalizedEndUserId = normalizeRequired(endUserId, "end-user id");
+    const result = await capsSeatSetData(ctx, normalizedInstance, normalizedEndUserId, opts);
+    return capSetMessage(`Seat ${normalizedEndUserId} on ${normalizedInstance}`, result.cap, result.changed);
+}
+function dollarsToCents(value) {
+    if (value === undefined) {
+        throw new Error("Pass --amount <dollars>. Usage: dharta caps budget set --amount 250");
+    }
+    return parseDollarAmountToCents(value, "--amount");
+}
+export function validateBudgetSetOptions(opts) {
+    dollarsToCents(opts.amount);
+    stopUsageOption(opts);
+    alertsOption(opts);
+    if (opts.alertThreshold !== undefined) {
+        parseWholeNumberInRange(opts.alertThreshold, "--alert-threshold", 0, 100);
+    }
+    for (const id of opts.recipientUserId ?? []) {
+        parsePositiveWholeNumber(id, "--recipient-user-id");
+    }
+}
+export function validateCapSetOptions(opts) {
+    capBody(opts);
+}
+function capBody(opts) {
+    if (opts.clear && opts.amount)
+        throw new Error("Use either --amount or --clear, not both.");
+    if (opts.clear)
+        return { clear: true };
+    if (!opts.amount)
+        throw new Error("Pass --amount <dollars> or --clear.");
+    return { cap_cents: dollarsToCents(opts.amount) };
+}
+function parseWholeNumberInRange(value, flag, min, max) {
+    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 < min || parsed > max) {
+        throw new Error(`${flag} must be a whole number from ${min} to ${max}.`);
+    }
+    return parsed;
+}
+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 stopUsageOption(opts) {
+    if (opts.hardStop && opts.soft)
+        throw new Error("Use either --hard-stop or --soft, not both.");
+    if (opts.hardStop)
+        return true;
+    if (opts.soft)
+        return false;
+    return undefined;
+}
+function alertsOption(opts) {
+    if (opts.enableAlerts && opts.disableAlerts) {
+        throw new Error("Use either --enable-alerts or --disable-alerts, not both.");
+    }
+    if (opts.enableAlerts)
+        return true;
+    if (opts.disableAlerts)
+        return false;
+    return undefined;
+}
+function formatMoney(cents) {
+    if (cents === null)
+        return "unlimited";
+    return `$${(cents / 100).toFixed(2)}`;
+}
+function formatMicros(micros) {
+    return `$${(micros / 100_000_000).toFixed(4)}`;
+}
+function formatEntityCap(result, label) {
+    return [
+        `${label}`,
+        `Spend this period: ${formatMicros(result.spend_micros)}`,
+        `Cap: ${result.cap ? formatMoney(result.cap.cap_cents) : "none"}`,
+    ].join("\n");
+}
+function capSetMessage(label, cap, changed) {
+    const state = cap ? formatMoney(cap.cap_cents) : "cleared";
+    return `${label} cap ${state}${changed === false ? " (unchanged)" : ""}.`;
+}
+function normalizeRequired(value, label) {
+    const normalized = value.trim();
+    if (!normalized) {
+        throw new Error(`${label} cannot be blank.`);
+    }
+    return normalized;
+}
+//# sourceMappingURL=caps.js.map

package/dist/commands/caps.js.map

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

package/dist/commands/create.d.ts

@@ -0,0 +1,22 @@
+import { type HarnessType } from "../harnesses.js";
+export interface CreateOptions {
+    cwd?: string;
+    name?: string;
+    template?: string;
+    harness?: string;
+    harnessVersion?: string;
+    baseUrl: string;
+    fetchImpl?: typeof fetch;
+    log?: (line: string) => void;
+}
+export interface CreateResult {
+    folder: string;
+    name: string;
+    template: string;
+    harness: HarnessType;
+    harnessVersion?: string;
+    instructionFile: "CLAUDE.md" | "AGENTS.md";
+    manifestPath: string;
+    files: string[];
+}
+export declare function create(pathArg: string | undefined, opts: CreateOptions): Promise<CreateResult>;

package/dist/commands/create.js

@@ -0,0 +1,76 @@
+import { promises as fs } from "node:fs";
+import * as path from "node:path";
+import { renderManifest } from "../manifest.js";
+import { scaffoldTemplate } from "../scaffold.js";
+import { deriveSlug } from "../agent.js";
+import { normalizeNonBlank } from "../validators.js";
+import { DEFAULT_CREATE_HARNESS, hasAgentMarker, parseHarnessType } from "../harnesses.js";
+export async function create(pathArg, opts) {
+    const cwd = path.resolve(opts.cwd ?? ".");
+    const log = opts.log ?? ((line) => console.error(line));
+    const pathInput = pathArg === undefined ? undefined : normalizeNonBlank(pathArg, "path");
+    const targetDir = path.resolve(cwd, pathInput ?? ".");
+    const rel = path.relative(cwd, targetDir) || ".";
+    const name = opts.name === undefined ? deriveSlug(path.basename(targetDir)) : normalizeNonBlank(opts.name, "--name");
+    const template = opts.template === undefined ? undefined : normalizeNonBlank(opts.template, "--template");
+    const harness = parseHarnessType(opts.harness, "--harness") ?? DEFAULT_CREATE_HARNESS;
+    const harnessVersion = opts.harnessVersion === undefined
+        ? undefined
+        : normalizeNonBlank(opts.harnessVersion, "--harness-version");
+    // Echo what the user typed (a clean `lifecoach`) in messages rather than the
+    // resolved ../../ path when they pass an absolute or distant target.
+    const shown = pathInput && pathInput !== "." ? pathInput : null;
+    const here = shown ?? "this folder";
+    const at = shown ? ` ${shown}` : "";
+    await validateTargetDirectory(targetDir, here);
+    // One agent per folder: a marker means an agent already lives here - that's
+    // setup's job, not create's. Refuse rather than scaffold over it.
+    if (hasAgentMarker(targetDir)) {
+        throw new Error(`An agent already exists in ${here}. Configure it with \`dharta setup${at}\` instead.`);
+    }
+    // Scaffold the template (CLAUDE.md / .claude / .gitignore - never dharta.toml,
+    // which we own below).
+    const scaffold = await scaffoldTemplate(targetDir, {
+        template,
+        harness,
+        baseUrl: opts.baseUrl,
+        fetchImpl: opts.fetchImpl,
+        log,
+    });
+    // Write the self-documenting manifest. A brand-new agent is deploy = false
+    // (the D6 fail-safe); `dharta setup --enable` flips the gate when you're ready.
+    const manifestPath = path.join(targetDir, "dharta.toml");
+    await fs.writeFile(manifestPath, renderManifest({ name, deploy: false, harness, harnessVersion }));
+    const files = [...scaffold.files, "dharta.toml"];
+    log(`Created ${harness} agent '${name}' in ${here} from the '${scaffold.template}' template ` +
+        `(${files.join(", ")}).`);
+    log(`Next: edit ${scaffold.instructionFile}, chat locally with \`dharta dev${at}\`, then \`dharta setup${at}\` to set the deploy gate + delivery method.`);
+    return {
+        folder: rel,
+        name,
+        template: scaffold.template,
+        harness,
+        harnessVersion,
+        instructionFile: scaffold.instructionFile,
+        manifestPath,
+        files,
+    };
+}
+async function validateTargetDirectory(targetDir, label) {
+    try {
+        const stat = await fs.stat(targetDir);
+        if (!stat.isDirectory()) {
+            throw new Error(`Cannot create agent in ${label}: expected a directory, got a file.`);
+        }
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ENOENT")
+            return;
+        if (code === "ENOTDIR") {
+            throw new Error(`Cannot create agent in ${label}: a parent path is not a directory.`);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/create.js.map

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

package/dist/commands/deploy.d.ts

@@ -0,0 +1,45 @@
+import type { CliContext } from "../context.js";
+export interface GitResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+}
+export type GitRunner = (args: string[], opts?: {
+    env?: Record<string, string>;
+    stream?: boolean;
+}) => Promise<GitResult>;
+export declare const INLINE_CREDENTIAL_HELPER = "!f() { echo username=karta; echo \"password=$DHARTA_GIT_PASSWORD\"; }; f";
+export interface DeployOptions {
+    dir?: string;
+    mode?: "git" | "folder";
+    reconcileSource?: boolean;
+    gitRunner?: GitRunner;
+    log?: (line: string) => void;
+    fetchImpl?: typeof fetch;
+    detectLocalVersion?: (type: string) => Promise<string | null>;
+    confirm?: (question: string) => Promise<boolean>;
+    requestId?: string;
+}
+export interface DeployFolderResult {
+    accepted: true;
+    phase?: "publication";
+    state?: "pending";
+    agent: {
+        id: number;
+        slug: string;
+        name: string;
+    };
+    release: {
+        version: number;
+        status: string;
+        harness_slug: string | null;
+        harness_version: string | null;
+    };
+}
+export declare function deploy(ctx: CliContext, slug?: string, opts?: DeployOptions): Promise<DeployFolderResult | undefined>;
+export declare function inferMode(dir: string, git?: GitRunner): Promise<"git" | "folder">;
+export declare function rejectOverlappingAgentRoots(agentDir: string, git: GitRunner): Promise<void>;
+export declare function validateDeployDir(dir: string): void;
+export declare function repositoryHintFromRemote(url: string): string | undefined;
+export declare function isAppleMetadata(relPath: string): boolean;
+export declare const defaultGitRunner: GitRunner;