@dharta/cli 0.6.77

package/dist/commands/analytics.js.map

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

package/dist/commands/api.d.ts

@@ -0,0 +1,19 @@
+import type { CliContext } from "../context.js";
+export interface ApiOptions {
+    field?: string[];
+    rawField?: string[];
+    header?: string[];
+    bodyStdin?: boolean;
+    body?: string;
+}
+export declare function api(ctx: CliContext, methodOrPath: string | undefined, pathArg: string | undefined, opts: ApiOptions): Promise<{
+    status: number;
+    body: unknown;
+    text: string;
+}>;
+export declare function validateApiRequest(methodOrPath: string | undefined, pathArg: string | undefined, opts: ApiOptions): {
+    method: string;
+    path: string;
+};
+export declare function prepareApiOptions(opts: ApiOptions, read?: () => Promise<string>): Promise<ApiOptions>;
+export declare function formatApiResult(result: Awaited<ReturnType<typeof api>>): string;

package/dist/commands/api.js

@@ -0,0 +1,278 @@
+import { randomUUID } from "node:crypto";
+import { cliFormatError } from "../api-error.js";
+import { closestChoice } from "../validators.js";
+const METHOD_NAMES = ["GET", "POST", "PUT", "PATCH", "DELETE"];
+const METHODS = new Set(METHOD_NAMES);
+const READ_ALLOWLIST = [
+    /^\/me(?:[?#]|$)/,
+    /^\/version(?:[?#]|$)/,
+    /^\/agent_templates(?:[?#]|$)/,
+    /^\/api\/billing(?:[?#]|$)/,
+    /^\/api\/usage(?:[?#]|$)/,
+    /^\/api\/analytics\/(?:agents|users|instances|sessions|models|cost)(?:[?#]|$)/,
+    /^\/api\/audit_events(?:\.csv)?(?:[?#]|$)/,
+    /^\/api\/members(?:[?#]|$)/,
+    /^\/api\/kartas(?:[?#]|$)/,
+    /^\/api\/kartas\/[^/?#]+(?:[?#]|$)/,
+    /^\/api\/agents(?:[?#]|$)/,
+    /^\/api\/agents\/[a-z0-9][a-z0-9-]{0,62}(?:[?#]|$)/,
+    /^\/api\/agents\/[a-z0-9][a-z0-9-]{0,62}\/invocations(?:[?#]|$)/,
+    /^\/api\/agents\/[a-z0-9][a-z0-9-]{0,62}\/logs(?:[?#]|$)/,
+    /^\/api\/agents\/[a-z0-9][a-z0-9-]{0,62}\/env(?:[?#]|$)/,
+    /^\/api\/agents\/[a-z0-9][a-z0-9-]{0,62}\/releases(?:[?#]|$)/,
+    /^\/api\/agents\/[a-z0-9][a-z0-9-]{0,62}\/appearance(?:[?#]|$)/,
+    /^\/api\/agents\/[a-z0-9][a-z0-9-]{0,62}\/schedules(?:[?#]|$)/,
+    /^\/api\/agents\/[a-z0-9][a-z0-9-]{0,62}\/directories\/(?:instances|end_users|sessions)(?:[?#]|$)/,
+    /^\/api\/agents\/[a-z0-9][a-z0-9-]{0,62}\/embed_keys(?:[?#]|$)/,
+    /^\/api\/limits\/budget(?:[?#]|$)/,
+    /^\/api\/limits\/instances\/[^/?#]+\/(?:cap|seat_cap)(?:[?#]|$)/,
+    /^\/api\/limits\/end_users\/[^/?#]+\/cap(?:[?#]|$)/,
+    /^\/api\/webhook_endpoints(?:[?#]|$)/,
+    /^\/api_keys(?:[?#]|$)/,
+    /^\/model_keys(?:[?#]|$)/,
+];
+const WRITE_ALLOWLIST = [
+    { methods: ["PATCH"], pattern: /^\/api\/kartas\/[^/?#]+(?:[?#]|$)/ },
+    { methods: ["POST"], pattern: /^\/api\/kartas\/[^/?#]+\/members(?:[?#]|$)/ },
+    { methods: ["PATCH", "DELETE"], pattern: /^\/api\/kartas\/[^/?#]+\/members\/[^/?#]+(?:[?#]|$)/ },
+    { methods: ["POST"], pattern: /^\/api\/agents\/[a-z0-9][a-z0-9-]{0,62}\/embed_keys(?:[?#]|$)/ },
+    { methods: ["PATCH", "DELETE"], pattern: /^\/api\/agents\/[a-z0-9][a-z0-9-]{0,62}\/embed_keys\/[^/?#]+(?:[?#]|$)/ },
+    { methods: ["POST"], pattern: /^\/api\/agents\/[a-z0-9][a-z0-9-]{0,62}\/embed_keys\/[^/?#]+\/(?:rotate|disable|enable)(?:[?#]|$)/ },
+    { methods: ["PATCH"], pattern: /^\/api\/agents\/[a-z0-9][a-z0-9-]{0,62}\/appearance(?:[?#]|$)/ },
+    { methods: ["PUT", "DELETE"], pattern: /^\/api\/agents\/[a-z0-9][a-z0-9-]{0,62}\/env\/[^/?#]+(?:[?#]|$)/ },
+    { methods: ["POST"], pattern: /^\/api\/agents\/[a-z0-9][a-z0-9-]{0,62}\/env\/pull(?:[?#]|$)/ },
+    { methods: ["PATCH"], pattern: /^\/api\/agents\/[a-z0-9][a-z0-9-]{0,62}\/(?:serving|dashboard_edits|model)(?:[?#]|$)/ },
+    { methods: ["PATCH"], pattern: /^\/api\/agents\/[a-z0-9][a-z0-9-]{0,62}\/workspace_inspectable(?:[?#]|$)/ },
+    { methods: ["DELETE"], pattern: /^\/api\/agents\/[a-z0-9][a-z0-9-]{0,62}(?:[?#]|$)/ },
+    { methods: ["POST"], pattern: /^\/api\/members\/invitations(?:[?#]|$)/ },
+    { methods: ["PATCH", "DELETE"], pattern: /^\/api\/members\/[^/?#]+(?:[?#]|$)/ },
+    { methods: ["POST"], pattern: /^\/api\/agents\/[a-z0-9][a-z0-9-]{0,62}\/schedules(?:[?#]|$)/ },
+    { methods: ["DELETE"], pattern: /^\/api\/agents\/[a-z0-9][a-z0-9-]{0,62}\/schedules\/[^/?#]+(?:[?#]|$)/ },
+    { methods: ["POST"], pattern: /^\/api\/agents\/[a-z0-9][a-z0-9-]{0,62}\/schedules\/[^/?#]+\/(?:pause|resume|run)(?:[?#]|$)/ },
+    { methods: ["POST"], pattern: /^\/api\/agents\/[a-z0-9][a-z0-9-]{0,62}\/releases\/v?\d+\/activate(?:[?#]|$)/ },
+    { methods: ["POST"], pattern: /^\/api\/agents\/[a-z0-9][a-z0-9-]{0,62}\/rollback(?:[?#]|$)/ },
+    { methods: ["POST"], pattern: /^\/api\/agents\/[a-z0-9][a-z0-9-]{0,62}\/workspace_tokens(?:[?#]|$)/ },
+    { methods: ["PATCH"], pattern: /^\/api\/limits\/budget(?:[?#]|$)/ },
+    { methods: ["PATCH"], pattern: /^\/api\/limits\/instances\/[^/?#]+\/(?:cap|seat_cap)(?:[?#]|$)/ },
+    { methods: ["PATCH"], pattern: /^\/api\/limits\/end_users\/[^/?#]+\/cap(?:[?#]|$)/ },
+    { methods: ["POST"], pattern: /^\/api\/webhook_endpoints(?:[?#]|$)/ },
+    { methods: ["PATCH", "DELETE"], pattern: /^\/api\/webhook_endpoints\/[^/?#]+(?:[?#]|$)/ },
+    { methods: ["POST"], pattern: /^\/api\/webhook_endpoints\/[^/?#]+\/enable(?:[?#]|$)/ },
+    { methods: ["POST"], pattern: /^\/api_keys(?:[?#]|$)/ },
+    { methods: ["PATCH", "DELETE"], pattern: /^\/api_keys\/[^/?#]+(?:[?#]|$)/ },
+    { methods: ["POST"], pattern: /^\/model_keys(?:[?#]|$)/ },
+    { methods: ["DELETE"], pattern: /^\/model_keys\/[^/?#]+(?:[?#]|$)/ },
+];
+export async function api(ctx, methodOrPath, pathArg, opts) {
+    const { method, path } = validateApiRequest(methodOrPath, pathArg, opts);
+    const headers = parseHeaders(opts.header ?? []);
+    const body = await buildBody(opts);
+    if (body !== undefined && !hasHeader(headers, "content-type")) {
+        headers["Content-Type"] = "application/json";
+    }
+    if (method !== "GET" && !hasHeader(headers, "idempotency-key")) {
+        headers["Idempotency-Key"] = randomUUID();
+    }
+    const res = await ctx.http.raw(path, { method, headers, body });
+    const text = await res.text();
+    const parsed = parseMaybeJson(text);
+    if (!res.ok) {
+        throw cliFormatError(res.status, parsed);
+    }
+    return {
+        status: res.status,
+        body: parsed,
+        text,
+    };
+}
+export function validateApiRequest(methodOrPath, pathArg, opts) {
+    const { method, path } = normalizeTarget(methodOrPath, pathArg, hasFields(opts));
+    if (method === "GET" && hasFields(opts)) {
+        throw new Error("GET requests cannot include --field, --raw-field, or --body-stdin. Use POST, PUT, or PATCH for request bodies.");
+    }
+    assertAllowlisted(method, path);
+    parseHeaders(opts.header ?? []);
+    validateBodyFields(opts);
+    return { method, path };
+}
+export async function prepareApiOptions(opts, read = readStdin) {
+    parseHeaders(opts.header ?? []);
+    validateBodyFields(opts);
+    if (!opts.bodyStdin)
+        return opts;
+    const body = await read();
+    if (body.length === 0)
+        throw new Error("--body-stdin was set, but stdin was empty.");
+    return { ...opts, body, bodyStdin: false };
+}
+export function formatApiResult(result) {
+    if (result.status === 204 || result.text.length === 0)
+        return "";
+    return typeof result.body === "string" ? result.body : JSON.stringify(result.body, null, 2);
+}
+function normalizeTarget(methodOrPath, pathArg, hasBodyFields) {
+    const first = methodOrPath?.trim();
+    const second = pathArg?.trim();
+    if (!first) {
+        throw new Error("Usage: dharta api [METHOD] /path");
+    }
+    let method;
+    let path;
+    const maybeMethod = first.toUpperCase();
+    if (METHODS.has(maybeMethod) && !second) {
+        throw new Error("Usage: dharta api [METHOD] /path");
+    }
+    if (METHODS.has(maybeMethod)) {
+        method = maybeMethod;
+        path = second;
+    }
+    else if (second) {
+        const suggestion = closestChoice(maybeMethod, METHOD_NAMES);
+        throw new Error(`Unknown API method ${maybeMethod}. Allowed methods: ${METHOD_NAMES.join(", ")}.` +
+            (suggestion ? ` Did you mean ${suggestion}?` : ""));
+    }
+    else {
+        method = hasBodyFields ? "POST" : "GET";
+        path = first;
+    }
+    if (!path.startsWith("/")) {
+        throw new Error("API path must start with '/', e.g. /me or /api/agents/support-bot");
+    }
+    if (/^\/\//.test(path) || /^[a-z][a-z0-9+.-]*:\/\//i.test(path)) {
+        throw new Error("API path must be relative to the Dharta API host.");
+    }
+    return { method, path };
+}
+function assertAllowlisted(method, path) {
+    if (method === "GET" && READ_ALLOWLIST.some((pattern) => pattern.test(path)))
+        return;
+    if (method !== "GET" && WRITE_ALLOWLIST.some((entry) => entry.methods.includes(method) && entry.pattern.test(path)))
+        return;
+    const suggestion = apiRouteSuggestion(path);
+    throw new Error("`dharta api` only allows documented public read endpoints and curated scoped writes. " +
+        "Use the matching `karta <command>` for unsupported writes." +
+        (suggestion ? ` Did you mean ${method} ${suggestion}?` : ""));
+}
+function apiRouteSuggestion(path) {
+    const replacements = [
+        [/^\/analytics(?=\/|[?#]|$)/, "/api/analytics"],
+        [/^\/billing(?=\/|[?#]|$)/, "/api/billing"],
+        [/^\/limits(?=\/|[?#]|$)/, "/api/limits"],
+        [/^\/members(?=\/|[?#]|$)/, "/api/members"],
+        [/^\/usage(?=\/|[?#]|$)/, "/api/usage"],
+        [/^\/webhook_endpoints(?=\/|[?#]|$)/, "/api/webhook_endpoints"],
+    ];
+    for (const [pattern, replacement] of replacements) {
+        if (pattern.test(path))
+            return path.replace(pattern, replacement);
+    }
+    return null;
+}
+function hasFields(opts) {
+    return (opts.field?.length ?? 0) > 0 || (opts.rawField?.length ?? 0) > 0 || !!opts.bodyStdin || opts.body !== undefined;
+}
+function hasStructuredFields(opts) {
+    return (opts.field?.length ?? 0) > 0 || (opts.rawField?.length ?? 0) > 0;
+}
+function validateBodyFields(opts) {
+    if (opts.bodyStdin && hasStructuredFields(opts)) {
+        throw new Error("Use either --body-stdin or --field/--raw-field, not both.");
+    }
+    for (const raw of opts.field ?? [])
+        splitAssignment(raw, "--field");
+    for (const raw of opts.rawField ?? [])
+        splitAssignment(raw, "--raw-field");
+}
+async function buildBody(opts) {
+    if (opts.body !== undefined)
+        return opts.body;
+    const fields = {};
+    for (const raw of opts.field ?? []) {
+        const [key, value] = splitAssignment(raw, "--field");
+        fields[key] = coerceField(value);
+    }
+    for (const raw of opts.rawField ?? []) {
+        const [key, value] = splitAssignment(raw, "--raw-field");
+        fields[key] = value;
+    }
+    if (Object.keys(fields).length > 0)
+        return JSON.stringify(fields);
+    if (opts.bodyStdin)
+        return readStdin();
+    return undefined;
+}
+function parseHeaders(input) {
+    const headers = {};
+    for (const raw of input) {
+        const idx = raw.indexOf(":");
+        if (idx <= 0)
+            throw new Error(`Invalid --header '${raw}'. Use 'Name: value'.`);
+        const key = raw.slice(0, idx).trim();
+        const value = raw.slice(idx + 1).trim();
+        if (!key || !value)
+            throw new Error(`Invalid --header '${raw}'. Use 'Name: value'.`);
+        const lower = key.toLowerCase();
+        if (lower === "authorization" || lower === "host" || lower.startsWith("x-forwarded-")) {
+            throw new Error(`Unsafe --header '${key}' cannot be overridden. The CLI manages auth and connection headers.`);
+        }
+        headers[key] = value;
+    }
+    if (Object.keys(headers).length > 0)
+        return headers;
+    return {};
+}
+function hasHeader(headers, name) {
+    const normalized = name.toLowerCase();
+    return Object.keys(headers).some((key) => key.toLowerCase() === normalized);
+}
+function splitAssignment(raw, flag) {
+    const idx = raw.indexOf("=");
+    if (idx <= 0)
+        throw new Error(`Invalid ${flag} '${raw}'. Use key=value.`);
+    const key = raw.slice(0, idx).trim();
+    if (!key)
+        throw new Error(`Invalid ${flag} '${raw}'. Use key=value.`);
+    return [key, raw.slice(idx + 1)];
+}
+function coerceField(value) {
+    if (value === "true")
+        return true;
+    if (value === "false")
+        return false;
+    if (value === "null")
+        return null;
+    if (/^-?\d+(?:\.\d+)?$/.test(value))
+        return Number(value);
+    if (/^[\[{]/.test(value)) {
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            return value;
+        }
+    }
+    return value;
+}
+function parseMaybeJson(text) {
+    if (!text)
+        return null;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+async function readStdin() {
+    if (process.stdin.isTTY) {
+        throw new Error("No piped input. Usage: echo '{\"name\":\"Example\"}' | dharta api POST /api/agents/support-bot/embed_keys --body-stdin");
+    }
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(Buffer.from(chunk));
+    const text = Buffer.concat(chunks).toString("utf8");
+    if (text.length === 0)
+        throw new Error("--body-stdin was set, but stdin was empty.");
+    return text;
+}
+//# sourceMappingURL=api.js.map

package/dist/commands/api.js.map

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

package/dist/commands/appearance.d.ts

@@ -0,0 +1,19 @@
+import { type AgentInferOptions } from "../agent.js";
+import type { CliContext } from "../context.js";
+export interface AppearanceEnvelope {
+    agent: {
+        id: string;
+        slug: string;
+        name: string;
+    };
+    appearance: Record<string, unknown>;
+    resolved_appearance: Record<string, unknown>;
+}
+export interface AppearanceOptions extends AgentInferOptions {
+    file?: string;
+}
+export declare function appearanceGetData(ctx: CliContext, opts: AgentInferOptions): Promise<AppearanceEnvelope>;
+export declare function appearanceGet(ctx: CliContext, opts: AgentInferOptions): Promise<string>;
+export declare function appearanceSetData(ctx: CliContext, opts: AppearanceOptions): Promise<AppearanceEnvelope>;
+export declare function appearanceSet(ctx: CliContext, opts: AppearanceOptions): Promise<string>;
+export declare function validateAppearanceSetInput(opts: AppearanceOptions): Promise<void>;

package/dist/commands/appearance.js

@@ -0,0 +1,63 @@
+import { randomUUID } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { inferAgentSlug } from "../agent.js";
+import { normalizeNonBlank } from "../validators.js";
+export async function appearanceGetData(ctx, opts) {
+    const slug = await inferAgentSlug(opts);
+    return ctx.http.request({
+        path: `/api/agents/${encodeURIComponent(slug)}/appearance`,
+    });
+}
+export async function appearanceGet(ctx, opts) {
+    const res = await appearanceGetData(ctx, opts);
+    return JSON.stringify(res.appearance, null, 2);
+}
+export async function appearanceSetData(ctx, opts) {
+    await validateAppearanceSetInput(opts);
+    if (!opts.file)
+        throw new Error("Pass --file <file>. Usage: dharta appearance set --file appearance.json");
+    const slug = await inferAgentSlug(opts);
+    const appearance = await readAppearanceFile(opts.file);
+    return ctx.http.request({
+        method: "PATCH",
+        path: `/api/agents/${encodeURIComponent(slug)}/appearance`,
+        headers: { "Idempotency-Key": randomUUID() },
+        body: { appearance },
+    });
+}
+export async function appearanceSet(ctx, opts) {
+    const res = await appearanceSetData(ctx, opts);
+    return `Saved appearance for ${res.agent.slug}.`;
+}
+export async function validateAppearanceSetInput(opts) {
+    if (!opts.file)
+        throw new Error("Pass --file <file>. Usage: dharta appearance set --file appearance.json");
+    await readAppearanceFile(opts.file);
+}
+async function readAppearanceFile(file) {
+    const normalized = normalizeNonBlank(file, "--file");
+    let text;
+    try {
+        text = await readFile(normalized, "utf8");
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ENOENT")
+            throw new Error(`Cannot read --file ${normalized}: file does not exist.`);
+        if (code === "EISDIR")
+            throw new Error(`Cannot read --file ${normalized}: expected a file, got a directory.`);
+        throw new Error(`Cannot read --file ${normalized}: ${error.message}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        throw new Error(`--file ${normalized} must contain valid JSON.`);
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error(`--file ${normalized} must contain a JSON object.`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=appearance.js.map

package/dist/commands/appearance.js.map

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

package/dist/commands/artifact.d.ts

@@ -0,0 +1,33 @@
+import type { Command } from "commander";
+export declare function artifact(args: string[]): Promise<void>;
+export interface LegacyArtifactPutOptions {
+    key: string;
+    kind: string;
+    title: string;
+    entrypoint: string;
+    render?: string[];
+    evidence?: string[];
+    provenance?: string;
+    continuation?: string[];
+}
+export interface ArtifactV2PutOptions {
+    id: string;
+    title: string;
+    root: string;
+    entry?: string;
+    run?: string;
+    typeId?: string;
+    inputs?: string[];
+    agentActivation?: AgentArtifactActivationOptions;
+}
+export interface AgentArtifactActivationOptions {
+    authorities?: string[];
+    budgetCents: string | number;
+    lifetimeSeconds: string | number;
+    descendantCeiling: string | number;
+    activationMode: string;
+    visibility: string;
+}
+export type ArtifactPutOptions = LegacyArtifactPutOptions | ArtifactV2PutOptions;
+export declare function artifactPutArgs(opts: ArtifactPutOptions): string[];
+export declare function registerArtifactCommands(program: Command): void;