@dharta/cli 0.6.77

package/dist/commands/sessions.js

@@ -0,0 +1,142 @@
+// `dharta sessions [show <id>]`, `dharta ps`, `dharta send "msg"` (RFC 0013
+// CLI-9): prod observability from the terminal. All three resolve the
+// agent's host from the control plane (never client-derived)
+// and speak the same consumer session API everything else speaks.
+// Listing is metadata; transcript content is gated server-side on the
+// org's transcript-access setting.
+import { HttpClient } from "@dharta/sdk";
+import { randomUUID } from "node:crypto";
+import { cliFormatError, cliFormatNetworkError } from "../api-error.js";
+import { inferAgentSlug } from "../agent.js";
+import { runTurn } from "./dev.js";
+import { table } from "../output.js";
+import { normalizeNonBlank, parsePositiveInteger } from "../validators.js";
+async function agentApi(ctx, opts) {
+    const slug = await inferAgentSlug(opts);
+    const shown = await ctx.http.request({
+        path: `/api/agents/${encodeURIComponent(slug)}`,
+    });
+    return {
+        slug,
+        agentUrl: shown.agent_url,
+        http: new HttpClient({
+            apiKey: ctx.apiKey,
+            baseUrl: shown.agent_url,
+            fetch: opts.fetchImpl,
+            formatError: cliFormatError,
+            formatNetworkError: cliFormatNetworkError,
+        }),
+    };
+}
+export async function sessionsListData(ctx, opts = {}, { activeOnly = false } = {}) {
+    const limit = normalizeLimit(opts.limit);
+    const { slug, http } = await agentApi(ctx, opts);
+    const body = await http.request({
+        path: `/v1/sessions${activeOnly ? "?active=true" : ""}`,
+    });
+    return { slug, total: body.total, sessions: limit === undefined ? body.sessions : body.sessions.slice(0, limit) };
+}
+export async function sessionsList(ctx, opts = {}, { activeOnly = false } = {}) {
+    const { slug, total, sessions } = await sessionsListData(ctx, opts, { activeOnly });
+    if (total === 0) {
+        return activeOnly
+            ? `No active sessions on ${slug}.`
+            : `No transcript sessions returned by ${slug}. Smoke-test it with: dharta send "hello", or list historical directory sessions with: dharta directories sessions --agent ${slug}`;
+    }
+    const shown = sessions.length;
+    const rows = table(sessions.map((s) => ({
+        id: s.id,
+        last_active: s.last_message_at,
+        msgs: String(s.message_count),
+        model: s.model ?? "",
+        tokens: String(s.input_tokens + s.output_tokens),
+        user: s.end_user_id ?? "",
+        status: s.status,
+    })));
+    const suffix = shown < total ? ` (showing ${shown})` : "";
+    return `${total} session${total === 1 ? "" : "s"} on ${slug}${suffix}:\n${rows}`;
+}
+export async function sessionsShowData(ctx, sessionId, opts = {}) {
+    const normalizedSessionId = normalizeNonBlank(sessionId, "Session id");
+    const { http } = await agentApi(ctx, opts);
+    const body = await http.request({
+        path: `/v1/sessions/${encodeURIComponent(normalizedSessionId)}/messages`,
+    });
+    return { id: normalizedSessionId, messages: body.messages };
+}
+export async function sessionsShow(ctx, sessionId, opts = {}) {
+    const { messages } = await sessionsShowData(ctx, sessionId, opts);
+    if (messages.length === 0)
+        return "No transcript captured for this session.";
+    return messages.map((t) => `[${t.at}] ${t.role}: ${t.text}`).join("\n");
+}
+// `dharta ps` - the dyno list of an agent platform: sessions active in
+// the last 15 minutes.
+export async function psData(ctx, opts = {}) {
+    return sessionsListData(ctx, opts, { activeOnly: true });
+}
+export async function ps(ctx, opts = {}) {
+    return sessionsList(ctx, opts, { activeOnly: true });
+}
+export function validateSessionsListOptions(opts = {}) {
+    normalizeLimit(opts.limit);
+}
+// `dharta send "message"` - one-shot turn against the DEPLOYED project: the
+// prod smoke test (local one-shot is `dharta dev -m`). By default it opens a
+// fresh session; pass `--session-id` to continue an existing one (multi-turn
+// from the terminal). Tool-permission pauses are auto-denied: a smoke test
+// must never hang waiting for an interactive approval. With `--json` it
+// streams nothing and returns the reply as a single machine-readable payload.
+export async function run(ctx, message, opts = {}) {
+    const normalizedMessage = normalizeNonBlank(message, "message");
+    const requestedSessionId = opts.sessionId === undefined ? undefined : normalizeNonBlank(opts.sessionId, "Session id");
+    const { slug, agentUrl, http } = await agentApi(ctx, opts);
+    const json = opts.json ?? false;
+    const log = json ? () => { } : opts.log ?? ((line) => console.log(line));
+    const userWrite = opts.write ?? ((text) => process.stdout.write(text));
+    let reply = "";
+    // Always capture the reply (so --json can return it); also stream it live
+    // unless we're in single-payload mode.
+    const write = (text) => {
+        reply += text;
+        if (!json)
+            userWrite(text);
+    };
+    let sessionId = requestedSessionId;
+    if (!sessionId) {
+        const session = await http.request({
+            method: "POST",
+            path: "/v1/sessions",
+            body: { metadata: { source: "dharta-run" } },
+            headers: { "Idempotency-Key": randomUUID() },
+        });
+        sessionId = session.id;
+    }
+    log(`Running against ${slug} (session ${sessionId})…`);
+    // runTurn speaks the same consumer protocol the dev REPL uses; the
+    // only difference in prod is the Bearer credential.
+    const base = (opts.fetchImpl ?? globalThis.fetch).bind(globalThis);
+    const authedFetch = (input, init) => base(input, {
+        ...init,
+        headers: { ...init?.headers, Authorization: `Bearer ${ctx.apiKey}` },
+    });
+    const io = {
+        write,
+        log,
+        ask: async () => {
+            log("[run] tool approval requested - auto-denied (run is a non-interactive smoke test)");
+            return "n";
+        },
+    };
+    await runTurn(agentUrl, authedFetch, sessionId, normalizedMessage, io);
+    // The renderer appends one trailing newline to close the streamed line;
+    // drop it from the returned/JSON payload so the reply is exactly the text.
+    const replyText = reply.endsWith("\n") ? reply.slice(0, -1) : reply;
+    return { agent: slug, session_id: sessionId, reply: replyText };
+}
+function normalizeLimit(value) {
+    if (value === undefined)
+        return undefined;
+    return parsePositiveInteger(value, "--limit");
+}
+//# sourceMappingURL=sessions.js.map

package/dist/commands/sessions.js.map

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

package/dist/commands/setup.d.ts

@@ -0,0 +1,28 @@
+import { type DeployMethod } from "../manifest.js";
+import { type GitRunner } from "./deploy.js";
+export type Method = DeployMethod;
+export type CiProvider = "github";
+export interface SetupOptions {
+    cwd?: string;
+    name?: string;
+    enable?: boolean;
+    disable?: boolean;
+    method?: string;
+    ci?: string;
+    yes?: boolean;
+    ask?: (question: string) => Promise<string>;
+    gitRunner?: GitRunner;
+    log?: (line: string) => void;
+}
+export interface SetupResult {
+    folder: string;
+    name: string;
+    deploy: boolean;
+    method: Method;
+    ci?: CiProvider;
+    manifestPath: string;
+    scaffolded: boolean;
+    workflowScaffolded: boolean;
+    gitInitialized: boolean;
+}
+export declare function setup(pathArg: string | undefined, opts?: SetupOptions): Promise<SetupResult>;