aui-agent-builder 0.4.2 → 0.4.4

package/dist/api-client/mock-db-client.js

@@ -0,0 +1,345 @@
+/**
+ * Mock DB service client — the per-agent mock database-as-a-service used to
+ * give an agent under construction a controllable read/write data backend.
+ *
+ * Wraps the management + runtime planes of `mock-db-service`:
+ *
+ *   POST   /api/agents/{agentId}                          → provision (returns keys once)
+ *   GET    /api/agents/{agentId}/describe                 → schema + endpoints
+ *   POST   /api/agents/{agentId}/collections              → create collection
+ *   GET    /api/agents/{agentId}/collections              → list collections
+ *   POST   /api/agents/{agentId}/collections/{name}/rows  → seed base rows
+ *   POST   /api/agents/{agentId}/endpoints                → create endpoint
+ *   GET    /api/agents/{agentId}/endpoints                → list endpoints
+ *   POST   /api/agents/{agentId}/apis/{slug}/execute      → runtime call (test)
+ *   GET    /api/agents/{agentId}/sessions/{key}           → inspect a session overlay
+ *   DELETE /api/agents/{agentId}/sessions/{key}           → reset a session
+ *   POST   /api/agents/{agentId}/rotate-mgmt-key          → mint a new management key
+ *   POST   /api/agents/{agentId}/rotate-runtime-key       → mint a new runtime key
+ *   GET    /api/agents/{agentId}/export                   → export schema + data + endpoints
+ *   DELETE /api/agents/{agentId}                          → delete the mock DB
+ *
+ * ─── Authentication ─────────────────────────────────────────────────────
+ *
+ * Three modes (the service supports all three — see its lib/auth.ts):
+ *
+ *   - "token"   — `Authorization: Bearer <AUI token>` + `X-AUI-Account-Id` +
+ *                 `X-AUI-Api-Url`. Used for the FIRST provision (bootstrap)
+ *                 and as a fallback when no management key is stored yet. The
+ *                 service verifies the token against Apollo (the caller must
+ *                 have access to the agent's account). Sent first-party from
+ *                 the CLI — never forwarded by a coding agent.
+ *   - "mgmt"    — `X-Mgmt-Key: <managementKey>` only. Agent-scoped; no AUI
+ *                 token transmitted. Preferred for all management after the
+ *                 first provision.
+ *   - "runtime" — `Authorization: Bearer <runtimeKey>` + `X-Session-Key`.
+ *                 What the deployed agent uses; the CLI uses it to test
+ *                 endpoints under a session.
+ *
+ * The auth MODE is chosen by the service layer per operation; this client
+ * only translates a `MockDbAuth` into the right headers.
+ *
+ * ─── Telemetry ──────────────────────────────────────────────────────────
+ *
+ * Every call captures the request (for `aui curl`) and attaches a redacted,
+ * replayable curl + HTTP status/body/duration onto the active OTel span —
+ * the same pattern as `api-client/apollo-client.ts`. Best-effort; the
+ * telemetry path never throws.
+ */
+import fetch, { FetchTimeoutError } from "../utils/fetch-with-timeout.js";
+import { randomUUID } from "node:crypto";
+import { getMockDbBaseUrl } from "../config/index.js";
+import { captureRequest, formatAsCurlSafe } from "../utils/request-capture.js";
+import { trace } from "@opentelemetry/api";
+import { AUIAPIError } from "./index.js";
+/**
+ * Thin HTTP client for the mock-db service. Stateless apart from the base
+ * URL it was constructed with; auth is supplied per call.
+ */
+export class MockDbClient {
+    base;
+    constructor(options) {
+        this.base = (options.baseUrl ?? getMockDbBaseUrl(options.environment)).replace(/\/+$/, "");
+    }
+    // ─── Auth header translation ───
+    authHeaders(auth) {
+        if (auth.mode === "token") {
+            const h = {
+                Authorization: `Bearer ${auth.authToken}`,
+                "X-AUI-Account-Id": auth.accountId,
+                "X-AUI-Api-Url": auth.apiUrl,
+            };
+            if (auth.organizationId)
+                h["organization-id"] = auth.organizationId;
+            return h;
+        }
+        if (auth.mode === "mgmt") {
+            return { "X-Mgmt-Key": auth.managementKey };
+        }
+        // runtime
+        const h = {
+            Authorization: `Bearer ${auth.runtimeKey}`,
+        };
+        if (auth.sessionKey)
+            h["X-Session-Key"] = auth.sessionKey;
+        return h;
+    }
+    // ─── Endpoints ───
+    async provision(agentId, auth) {
+        return this.request({
+            name: "mockdb_provision",
+            label: "mockdb provision",
+            method: "POST",
+            path: `/api/agents/${encodeURIComponent(agentId)}`,
+            auth,
+        });
+    }
+    async describe(agentId, auth) {
+        return this.request({
+            name: "mockdb_describe",
+            label: "mockdb describe",
+            method: "GET",
+            path: `/api/agents/${encodeURIComponent(agentId)}/describe`,
+            auth,
+        });
+    }
+    async createCollection(agentId, auth, body) {
+        return this.request({
+            name: "mockdb_create_collection",
+            label: "mockdb create collection",
+            method: "POST",
+            path: `/api/agents/${encodeURIComponent(agentId)}/collections`,
+            auth,
+            body,
+        });
+    }
+    async listCollections(agentId, auth) {
+        return this.request({
+            name: "mockdb_list_collections",
+            label: "mockdb list collections",
+            method: "GET",
+            path: `/api/agents/${encodeURIComponent(agentId)}/collections`,
+            auth,
+        });
+    }
+    async seedRows(agentId, auth, collection, rows) {
+        return this.request({
+            name: "mockdb_seed_rows",
+            label: "mockdb seed rows",
+            method: "POST",
+            path: `/api/agents/${encodeURIComponent(agentId)}/collections/${encodeURIComponent(collection)}/rows`,
+            auth,
+            body: { rows },
+        });
+    }
+    async createEndpoint(agentId, auth, body) {
+        return this.request({
+            name: "mockdb_create_endpoint",
+            label: "mockdb create endpoint",
+            method: "POST",
+            path: `/api/agents/${encodeURIComponent(agentId)}/endpoints`,
+            auth,
+            body,
+        });
+    }
+    async listEndpoints(agentId, auth) {
+        return this.request({
+            name: "mockdb_list_endpoints",
+            label: "mockdb list endpoints",
+            method: "GET",
+            path: `/api/agents/${encodeURIComponent(agentId)}/endpoints`,
+            auth,
+        });
+    }
+    async execute(agentId, slug, auth, body) {
+        return this.request({
+            name: "mockdb_execute",
+            label: "mockdb execute",
+            method: "POST",
+            path: `/api/agents/${encodeURIComponent(agentId)}/apis/${encodeURIComponent(slug)}/execute`,
+            auth,
+            body,
+        });
+    }
+    async inspectSession(agentId, auth, sessionKey) {
+        return this.request({
+            name: "mockdb_inspect_session",
+            label: "mockdb inspect session",
+            method: "GET",
+            path: `/api/agents/${encodeURIComponent(agentId)}/sessions/${encodeURIComponent(sessionKey)}`,
+            auth,
+        });
+    }
+    async resetSession(agentId, auth, sessionKey) {
+        return this.request({
+            name: "mockdb_reset_session",
+            label: "mockdb reset session",
+            method: "DELETE",
+            path: `/api/agents/${encodeURIComponent(agentId)}/sessions/${encodeURIComponent(sessionKey)}`,
+            auth,
+        });
+    }
+    async rotateMgmtKey(agentId, auth) {
+        return this.request({
+            name: "mockdb_rotate_mgmt_key",
+            label: "mockdb rotate mgmt key",
+            method: "POST",
+            path: `/api/agents/${encodeURIComponent(agentId)}/rotate-mgmt-key`,
+            auth,
+        });
+    }
+    async rotateRuntimeKey(agentId, auth) {
+        return this.request({
+            name: "mockdb_rotate_runtime_key",
+            label: "mockdb rotate runtime key",
+            method: "POST",
+            path: `/api/agents/${encodeURIComponent(agentId)}/rotate-runtime-key`,
+            auth,
+        });
+    }
+    async exportAgent(agentId, auth) {
+        return this.request({
+            name: "mockdb_export",
+            label: "mockdb export",
+            method: "GET",
+            path: `/api/agents/${encodeURIComponent(agentId)}/export`,
+            auth,
+        });
+    }
+    async deleteAgent(agentId, auth) {
+        return this.request({
+            name: "mockdb_delete",
+            label: "mockdb delete",
+            method: "DELETE",
+            path: `/api/agents/${encodeURIComponent(agentId)}`,
+            auth,
+        });
+    }
+    // ─── Core request + telemetry ───
+    async request(input) {
+        const url = `${this.base}${input.path}`;
+        const headers = {
+            accept: "application/json",
+            "content-type": "application/json",
+            "x-aui-client": "mock-db-service-cli",
+            "x-trace-id": randomUUID(),
+            ...this.authHeaders(input.auth),
+        };
+        const init = { method: input.method, headers };
+        if (input.body !== undefined)
+            init.body = JSON.stringify(input.body);
+        const startedAt = Date.now();
+        let response;
+        try {
+            response = await fetch(url, init);
+        }
+        catch (error) {
+            const networkErr = error instanceof FetchTimeoutError
+                ? error
+                : new Error(`Network error: ${error instanceof Error ? error.message : "Connection failed"}`);
+            this.attachTelemetry({
+                name: input.name,
+                label: input.label,
+                method: input.method,
+                url,
+                headers,
+                requestBody: input.body,
+                responseText: networkErr.message,
+                status: 0,
+                success: false,
+                durationMs: Date.now() - startedAt,
+            });
+            throw networkErr;
+        }
+        const responseText = await response.text().catch(() => "");
+        this.attachTelemetry({
+            name: input.name,
+            label: input.label,
+            method: input.method,
+            url,
+            headers,
+            requestBody: input.body,
+            responseText,
+            status: response.status,
+            success: response.ok,
+            durationMs: Date.now() - startedAt,
+        });
+        if (!response.ok) {
+            let errorBody;
+            try {
+                errorBody = JSON.parse(responseText);
+            }
+            catch {
+                errorBody = responseText || null;
+            }
+            throw new AUIAPIError(response.status, `${input.label}: ${response.statusText}`, errorBody);
+        }
+        if (!responseText)
+            return {};
+        try {
+            return JSON.parse(responseText);
+        }
+        catch {
+            return responseText;
+        }
+    }
+    /**
+     * Capture the request for `aui curl` and attach a redacted curl repro +
+     * HTTP fields onto the active span. Best-effort; never throws.
+     */
+    attachTelemetry(input) {
+        captureRequest({
+            timestamp: new Date().toISOString(),
+            method: input.method,
+            url: input.url,
+            headers: input.headers,
+            body: input.requestBody,
+            status: input.status,
+            responseBody: input.responseText,
+            label: input.label,
+            success: input.success,
+        });
+        try {
+            const span = trace.getActiveSpan();
+            if (!span)
+                return;
+            const MAX = 32 * 1024;
+            const truncatedResponse = input.responseText.length > MAX
+                ? input.responseText.slice(0, MAX) +
+                    `... [truncated ${input.responseText.length - MAX} bytes]`
+                : input.responseText;
+            const curl = formatAsCurlSafe({
+                timestamp: new Date().toISOString(),
+                method: input.method,
+                url: input.url,
+                headers: input.headers,
+                body: input.requestBody,
+                status: input.status,
+                responseBody: input.responseText,
+                label: input.label,
+                success: input.success,
+            }, { maxBodyBytes: MAX });
+            const eventAttrs = {
+                "http.method": input.method,
+                "http.url": input.url,
+                [`${input.name}.success`]: input.success,
+                [`${input.name}.duration_ms`]: input.durationMs,
+                [`${input.name}.response_body`]: truncatedResponse,
+                "aui.curl_repro": curl,
+            };
+            if (input.status > 0)
+                eventAttrs["http.status_code"] = input.status;
+            span.addEvent(`http.${input.name}`, eventAttrs);
+            span.setAttribute("aui.curl_repro", curl);
+            span.setAttribute("http.method", input.method);
+            span.setAttribute("http.url", input.url);
+            span.setAttribute("http.response_body", truncatedResponse);
+            if (input.status > 0)
+                span.setAttribute("http.status_code", input.status);
+        }
+        catch {
+            // Telemetry must never break the call path.
+        }
+    }
+}
+//# sourceMappingURL=mock-db-client.js.map

package/dist/api-client/mock-db-client.js.map

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

package/dist/commands/agents.d.ts

@@ -29,10 +29,10 @@ export interface AgentsOptions {
     category?: string;
     /**
      * After `--create`, auto-import the freshly created agent's latest
-     * draft into this directory. When omitted, the import targets the
-     * current working directory (`.`). Only the records-mode `--create`
-     * flow produces a v1.0 draft to import; bundle-mode / template
-     * creates skip the auto-import (nothing to snapshot yet).
+     * draft into this directory. When omitted, the import targets a new
+     * `./<agent-name>` folder. Bundle-mode creation (the only mode now)
+     * provisions a draft via Apollo and imports it; template creates skip
+     * the auto-import (templates aren't runtime agents).
      */
     dir?: string;
     networkId?: string;
@@ -47,23 +47,17 @@ export interface AgentsOptions {
     allVersions?: boolean;
     yes?: boolean;
     /**
-     * Opt into `bundle_mode=true` on `--create` (the new push/pull blob
-     * endpoints). NOT the default: a fresh bundle-mode agent has no version
-     * and no records to snapshot, so the auto-draft step (`source=agent-scope`)
-     * cannot run and the agent also can't be imported via `/pull` until it
-     * has had at least one push. Use this only when you specifically want a
-     * blob-mode agent and will seed it via `--from-template` / push yourself.
-     * Mutually exclusive with `--records-mode`.
+     * Explicit form of the now-default bundle-mode `--create` (the Apollo
+     * provisioning endpoint). Every agent is created in bundle mode now, so
+     * this flag is redundant; it's kept (hidden) only for back-compat.
      */
     bundleMode?: boolean;
     /**
-     * Force `bundle_mode=false` on `--create` (records mode). This is the
-     * default for regular agents — it's what lets `aui agents --create`
-     * auto-create the v1.0 draft from the agent scope. Mutually exclusive
-     * with `--bundle-mode` and rejected when paired with `--template`
-     * (templates are blob-mode-only).
+     * RECORDS-MODE CREATION RETIRED — moved to bundle-mode creation.
+     * The `--records-mode` flag (force `bundle_mode=false`, legacy per-entity
+     * create chain) was removed from the command. The field is kept commented
+     * for historical reference only; nothing reads it anymore.
      */
-    recordsMode?: boolean;
     /**
      * Create a template (kind=template) instead of a regular agent.
      *

package/dist/commands/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/commands/agents.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAsCH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA8ED,wBAAsB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAy3DvE;AA+fD;;;;GAIG;AACH;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;OAKG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;IAC9B;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,MAAM,EACzB,QAAQ,GAAE,2BAAgC,GACzC,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAuIxD"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/commands/agents.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAsCH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IAEH;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA8ED,wBAAsB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA42DvE;AA+fD;;;;GAIG;AACH;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;OAKG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;IAC9B;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,MAAM,EACzB,QAAQ,GAAE,2BAAgC,GACzC,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAuIxD"}