primitive-admin 1.2.0-alpha.2 → 1.2.0-alpha.4

package/dist/src/lib/aggregate-output.d.ts

@@ -0,0 +1,25 @@
+/** One aggregate row as the routes answer it. */
+export interface AggregateOutputRow {
+    group?: Record<string, unknown>;
+    [operationKey: string]: unknown;
+}
+/** What the command asked for: the group levels and its one operation. */
+export interface AggregateOutputRequest {
+    groupBy: string[];
+    op: string;
+    field?: string;
+}
+/** A rendered aggregate: a key/value line, or a ready-to-print table. */
+export type RenderedAggregate = {
+    kind: "scalar";
+    label: string;
+    value: string;
+} | {
+    kind: "table";
+    text: string;
+};
+/**
+ * Render an aggregate's rows for a terminal. `rows` is the route body's
+ * `result`; anything that is not an array renders as no rows.
+ */
+export declare function renderAggregateResult(rows: unknown, request: AggregateOutputRequest): RenderedAggregate;

package/dist/src/lib/aggregate-output.js

@@ -0,0 +1,53 @@
+/**
+ * Human output for `databases records aggregate` and
+ * `documents records aggregate`, shared so the two print alike.
+ *
+ * Both routes answer rows, `{ group, ...operationValues }`. Ungrouped, the one
+ * row's value is printed as a key/value line; grouped, as a table with one
+ * column per row group key and one value column. A `null` group value prints
+ * as `null` so it stays distinct from an empty string (an empty cell); a
+ * `null` operation value prints `—`.
+ */
+import { formatTable } from "./output.js";
+const display = (value) => value === null || value === undefined ? "—" : String(value);
+/**
+ * Render an aggregate's rows for a terminal. `rows` is the route body's
+ * `result`; anything that is not an array renders as no rows.
+ */
+export function renderAggregateResult(rows, request) {
+    const list = Array.isArray(rows) ? rows : [];
+    const operationKey = request.op === "count" ? "count" : `${request.op}_${request.field}`;
+    if (request.groupBy.length === 0) {
+        // The field name is reproduced verbatim in both labels — it is a
+        // user-supplied identifier, and case-folding it produced
+        // `avg(lastvalue)` for `--field lastValue` (issue #2357).
+        return {
+            kind: "scalar",
+            label: request.op === "count"
+                ? "count"
+                : `${request.op.toLowerCase()}(${request.field})`,
+            value: display(list[0]?.[operationKey]),
+        };
+    }
+    const groupKeys = list.length > 0 ? Object.keys(list[0].group ?? {}) : request.groupBy;
+    const valueLabel = request.op === "count"
+        ? "COUNT"
+        : `${request.op.toUpperCase()}(${request.field})`;
+    const table = list.map((row) => {
+        const cells = {};
+        groupKeys.forEach((key, index) => {
+            const value = row.group?.[key];
+            cells[`g${index}`] = value === null || value === undefined ? "null" : String(value);
+        });
+        cells.value = display(row[operationKey]);
+        return cells;
+    });
+    return {
+        kind: "table",
+        text: formatTable(table, [
+            ...groupKeys.map((key, index) => ({ header: key.toUpperCase(), key: `g${index}` })),
+            { header: valueLabel, key: "value" },
+        ]),
+    };
+}
+//# sourceMappingURL=aggregate-output.js.map

package/dist/src/lib/aggregate-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate-output.js","sourceRoot":"","sources":["../../../src/lib/aggregate-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAoB1C,MAAM,OAAO,GAAG,CAAC,KAAc,EAAU,EAAE,CACzC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAE9D;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAa,EACb,OAA+B;IAE/B,MAAM,IAAI,GAAyB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,MAAM,YAAY,GAChB,OAAO,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,EAAE,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAEtE,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,iEAAiE;QACjE,yDAAyD;QACzD,0DAA0D;QAC1D,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,KAAK,EACH,OAAO,CAAC,EAAE,KAAK,OAAO;gBACpB,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,IAAI,OAAO,CAAC,KAAK,GAAG;YACrD,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC;SACxC,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACvF,MAAM,UAAU,GACd,OAAO,CAAC,EAAE,KAAK,OAAO;QACpB,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC;IACtD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC7B,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YAC/B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;YAC/B,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC,GAAG,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtF,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;QACzC,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;IACH,OAAO;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,WAAW,CAAC,KAAK,EAAE;YACvB,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,IAAI,KAAK,EAAE,EAAE,CAAC,CAAC;YACnF,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE;SACrC,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/src/lib/api-client.d.ts

@@ -1,5 +1,17 @@
 import { type ListEnvelope } from "./paginate.js";
 import { type GlobalAppRef, type WorkflowUsageReport } from "./workflow-usage.js";
+/**
+ * #4262 — an agent prompt's test case: its `[test.agent]` block on the wire.
+ * `agentHistory` is JSON text; context and the expected call are parsed.
+ */
+export interface AgentTestCaseWireFields {
+    agentHistory?: string | null;
+    agentContext?: Record<string, any> | null;
+    agentTimezone?: string | null;
+    agentLocale?: string | null;
+    agentExpectedToolCall?: Record<string, any> | null;
+    agentExpectedNoToolCall?: boolean | null;
+}
 /**
  * Metadata for a single bucket blob, as returned by the metadata endpoint
  * `GET blob-buckets/:bucketId/blobs/:blobId/metadata`. Mirrors the published
@@ -1358,7 +1370,7 @@ export declare class ApiClient {
         evaluatorConfigId?: string;
         /** The sidecar's file name — the case's identity (#2896). */
         key?: string;
-    }): Promise<any>;
+    } & AgentTestCaseWireFields): Promise<any>;
     updateTestCase(appId: string, blockType: "prompt" | "integration" | "workflow" | "script", blockId: string, testCaseId: string, payload: {
         name?: string;
         description?: string | null;
@@ -1371,7 +1383,7 @@ export declare class ApiClient {
         evaluatorConfigId?: string | null;
         /** The sidecar's file name, on a create-or-rename backfill (#2896). */
         key?: string;
-    }): Promise<any>;
+    } & AgentTestCaseWireFields): Promise<any>;
     deleteTestCase(appId: string, blockType: "prompt" | "integration" | "workflow" | "script", blockId: string, testCaseId: string): Promise<void>;
     listTestCaseAttachments(appId: string, blockType: "prompt" | "integration" | "workflow" | "script", blockId: string, testCaseId: string): Promise<{
         attachments: Array<{
@@ -1863,7 +1875,7 @@ export declare class ApiClient {
         limit?: number;
         cursor?: string;
         direction?: number;
-    }, token?: string, options?: {
+    }, options?: {
         timing?: boolean;
     }): Promise<any>;
     /**
@@ -1881,11 +1893,6 @@ export declare class ApiClient {
         imported: number;
         failed: number;
     }>;
-    /**
-     * Make a request using a specific JWT token instead of the CLI's credentials.
-     * Used for executing operations as a different user.
-     */
-    requestWithToken<T = any>(path: string, token: string, options?: RequestInit): Promise<T>;
     listDatabaseIndexes(appId: string, databaseId: string, modelName?: string): Promise<any>;
     registerDatabaseIndex(appId: string, databaseId: string, data: {
         modelName: string;
@@ -2285,14 +2292,14 @@ export declare class ApiClient {
         limit?: number;
         cursor?: string;
         /** #3764 — the format the caller believes this document has. */
-        documentFormat?: 1 | 2;
+        documentFormat?: 1 | 2 | 3;
     }): Promise<ListEnvelope>;
     /**
      * Count records in a document model (issue #1964 Phase 3). Returns `{ count }`.
      */
     countDocumentRecords(appId: string, documentId: string, modelName: string, queryOptions?: {
         filter?: Record<string, any>;
-        documentFormat?: 1 | 2;
+        documentFormat?: 1 | 2 | 3;
     }): Promise<{
         count: number;
     }>;
@@ -2314,7 +2321,7 @@ export declare class ApiClient {
         groupBy?: string[];
         filter?: Record<string, any>;
     }, extra?: {
-        documentFormat?: 1 | 2;
+        documentFormat?: 1 | 2 | 3;
     }): Promise<{
         result: unknown;
     }>;
@@ -2323,6 +2330,12 @@ export declare class ApiClient {
      * record/model/blob counts, approximate size, and last-modified timestamp.
      */
     getDocumentStats(appId: string, documentId: string): Promise<any>;
+    /**
+     * A record-log document's room (#4306): `GET documents/:id/room` →
+     * `{ ok, appId, documentId, documentFormat, room }`, `room` null for a
+     * format that has no record room. App admins only.
+     */
+    getDocumentRoom(appId: string, documentId: string): Promise<any>;
     /**
      * A large document's snapshot builds, newest first, one page (#3432).
      * `GET documents/:id/snapshots` → `{ items, hasMore, nextCursor? }`.
@@ -2399,7 +2412,7 @@ export declare class ApiClient {
         data: Record<string, unknown>;
         options?: Record<string, unknown>;
     }, extra?: {
-        documentFormat?: 1 | 2;
+        documentFormat?: 1 | 2 | 3;
     }): Promise<{
         record: unknown;
     }>;
@@ -2412,7 +2425,7 @@ export declare class ApiClient {
         data: Record<string, unknown>;
         options?: Record<string, unknown>;
     }, extra?: {
-        documentFormat?: 1 | 2;
+        documentFormat?: 1 | 2 | 3;
     }): Promise<{
         record: unknown;
     }>;
@@ -2422,7 +2435,7 @@ export declare class ApiClient {
      * a silent no-op per the facade contract. Returns `{ deleted: true }`.
      */
     deleteDocumentRecord(appId: string, documentId: string, modelName: string, recordId: string, extra?: {
-        documentFormat?: 1 | 2;
+        documentFormat?: 1 | 2 | 3;
     }): Promise<{
         deleted: boolean;
     }>;
@@ -2433,7 +2446,7 @@ export declare class ApiClient {
      * `{ applied, added, updated, deleted }`.
      */
     bulkDocumentRecords(appId: string, documentId: string, operations: Array<Record<string, unknown>>, extra?: {
-        documentFormat?: 1 | 2;
+        documentFormat?: 1 | 2 | 3;
     }): Promise<{
         applied: number;
         added: Array<{
@@ -2457,7 +2470,7 @@ export declare class ApiClient {
         documentId?: string;
         tags?: string[];
         createdBy?: string;
-        documentFormat?: 1 | 2;
+        documentFormat?: 1 | 2 | 3;
     }): Promise<any>;
     listDocumentPermissions(appId: string, documentId: string): Promise<any[]>;
     grantDocumentPermission(appId: string, documentId: string, permissions: Array<{

package/dist/src/lib/api-client.js

@@ -11,6 +11,15 @@ import { drainAppsUntilConverged, } from "./workflow-usage.js";
  * fewest round trips the contract allows; a larger value is clamped there.
  */
 const ADMIN_INVENTORY_PAGE_SIZE = 100;
+/** The agent block's wire keys, in the surface's order. */
+const AGENT_TEST_CASE_WIRE_KEYS = [
+    "agentHistory",
+    "agentContext",
+    "agentTimezone",
+    "agentLocale",
+    "agentExpectedToolCall",
+    "agentExpectedNoToolCall",
+];
 export class ApiError extends Error {
     statusCode;
     code;
@@ -1529,6 +1538,13 @@ export class ApiClient {
         if (payload.expectedJsonSubset) {
             serverPayload.expectedJsonSubset = payload.expectedJsonSubset;
         }
+        // #4262 — an agent case's `[test.agent]` keys, each when the caller set it:
+        // presence, not truthiness, so `agentExpectedNoToolCall: false` travels. A
+        // chat case sets none, and its body is unchanged.
+        for (const key of AGENT_TEST_CASE_WIRE_KEYS) {
+            if (payload[key] !== undefined)
+                serverPayload[key] = payload[key];
+        }
         return this.post(`/admin/api/apps/${appId}/blocks/${blockType}/${blockId}/test-cases`, serverPayload);
     }
     async updateTestCase(appId, blockType, blockId, testCaseId, payload) {
@@ -1563,6 +1579,11 @@ export class ApiClient {
         }
         if (payload.key !== undefined)
             serverPayload.key = payload.key;
+        // #4262 — as on create; an explicit `null` clears the field.
+        for (const key of AGENT_TEST_CASE_WIRE_KEYS) {
+            if (payload[key] !== undefined)
+                serverPayload[key] = payload[key];
+        }
         return this.patch(`/admin/api/apps/${appId}/blocks/${blockType}/${blockId}/test-cases/${testCaseId}`, serverPayload);
     }
     async deleteTestCase(appId, blockType, blockId, testCaseId) {
@@ -2140,19 +2161,12 @@ export class ApiClient {
      * else (a `count`, an `aggregate`, a mutation, a `returnField: "all"`
      * pipeline) is returned exactly as the server sent it.
      */
-    async executeDatabaseOperation(appId, databaseId, operationName, data, token, options) {
+    async executeDatabaseOperation(appId, databaseId, operationName, data, options) {
         const path = `/app/${appId}/api/databases/${databaseId}/operations/${encodeURIComponent(operationName)}/execute`;
         const extraHeaders = {};
         if (options?.timing) {
             extraHeaders["X-Timing"] = "true";
         }
-        if (token) {
-            return normalizeDatabaseOperationResult(await this.requestWithToken(path, token, {
-                method: "POST",
-                body: JSON.stringify(data || {}),
-                headers: extraHeaders,
-            }));
-        }
         return normalizeDatabaseOperationResult(await this.request(path, {
             method: "POST",
             body: JSON.stringify(data || {}),
@@ -2171,26 +2185,6 @@ export class ApiClient {
     async executeBatch(appId, databaseId, operationName, batch) {
         return this.post(`/app/${appId}/api/databases/${databaseId}/operations/${encodeURIComponent(operationName)}/batch`, { batch });
     }
-    /**
-     * Make a request using a specific JWT token instead of the CLI's credentials.
-     * Used for executing operations as a different user.
-     */
-    async requestWithToken(path, token, options = {}) {
-        const credentials = await this.ensureAuthenticated();
-        const url = `${credentials.serverUrl}${path}`;
-        const headers = {
-            Authorization: `Bearer ${token}`,
-            "Content-Type": "application/json",
-            ...(options.headers || {}),
-        };
-        const response = await fetchWithTLS(url, { ...options, headers });
-        const text = await response.text();
-        if (!response.ok) {
-            const parsed = parseErrorResponse(response, text, path);
-            throw new ApiError(parsed.message, response.status, parsed.code, parsed.details);
-        }
-        return text ? JSON.parse(text) : null;
-    }
     // ============================================
     // DATABASE INDEXES
     // ============================================
@@ -2796,6 +2790,14 @@ export class ApiClient {
     async getDocumentStats(appId, documentId) {
         return this.get(`/app/${appId}/api/documents/${documentId}/stats`);
     }
+    /**
+     * A record-log document's room (#4306): `GET documents/:id/room` →
+     * `{ ok, appId, documentId, documentFormat, room }`, `room` null for a
+     * format that has no record room. App admins only.
+     */
+    async getDocumentRoom(appId, documentId) {
+        return this.get(`/app/${appId}/api/documents/${documentId}/room`);
+    }
     /**
      * A large document's snapshot builds, newest first, one page (#3432).
      * `GET documents/:id/snapshots` → `{ items, hasMore, nextCursor? }`.