@hivemagnus/hivemem-sdk 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to `@hivemagnus/hivemem-sdk`.
 
+## [1.2.0] - 2026-11-12
+
+### Added
+
+- `exportAudit({ after, limit })` reads one page of `GET /v1/audit/export` and returns a
+  `HiveAuditPage` of `HiveAuditRecord` v1 records. New `HiveAuditRecord` and `HiveAuditPage`
+  types.
+
+## [1.1.1] - 2026-11-12
+
+### Fixed
+
+- An error response whose body is not JSON, such as a proxy's HTML 502, is reported with its
+  status and text. The body was read twice, and the second read failed with "Body is unusable".
+  An empty error body is reported as "HiveMem answered HTTP <status>".
+
 ## [1.1.0] - 2026-11-12
 
 ### Added

package/dist/client.d.ts

@@ -1,5 +1,5 @@
 import { ContextPackage } from "./context.js";
-import type { ConclusionPage, ConclusionRecord, HiveMemOptions, KnowledgeSourceSyncResponse, MemoryRecord, PeerCardResponse, QueueJobRecord, QueueStatusResponse, SearchResponse, SessionRecord, WebhookEndpoint, WorkspaceCreateOptions, WorkspaceRecord } from "./types.js";
+import type { ConclusionPage, ConclusionRecord, HiveAuditPage, HiveMemOptions, KnowledgeSourceSyncResponse, MemoryRecord, PeerCardResponse, QueueJobRecord, QueueStatusResponse, SearchResponse, SessionRecord, WebhookEndpoint, WorkspaceCreateOptions, WorkspaceRecord } from "./types.js";
 export declare class HiveMem {
     readonly baseUrl: string;
     token?: string;
@@ -23,6 +23,15 @@ export declare class HiveMem {
      * it unchanged. An archived workspace ID is a 409.
      */
     createWorkspace(workspaceId: string, options?: WorkspaceCreateOptions): Promise<WorkspaceRecord>;
+    /**
+     * One page of the suite audit export (`GET /v1/audit/export`), oldest first. Pass the last
+     * non-null `nextCursor` as `after`; `nextCursor` is null only on an empty page (caught up). Requires an administrator
+     * or an Oathweave service token with `hivemem:audit:read`.
+     */
+    exportAudit(options?: {
+        after?: string;
+        limit?: number;
+    }): Promise<HiveAuditPage>;
     getMemory(memoryId: string, options?: {
         includeHistory?: boolean;
     }): Promise<MemoryRecord>;

package/dist/client.js

@@ -87,14 +87,21 @@ export class HiveMem {
                 if (!response.ok) {
                     let details;
                     let message = response.statusText;
+                    // Read the body once: a proxy's HTML or plain-text error is not JSON, and a second
+                    // read of the same body would fail and hide the status.
+                    const text = await response.text().catch(() => "");
                     try {
-                        details = await response.json();
+                        details = JSON.parse(text);
                         if (details && typeof details === "object" && "detail" in details)
                             message = String(details.detail);
                     }
                     catch {
-                        message = await response.text();
+                        details = undefined;
+                        if (text.trim())
+                            message = text;
                     }
+                    if (!message)
+                        message = `HiveMem answered HTTP ${response.status}`;
                     throw new HiveMemHTTPError(response.status, message, details);
                 }
                 if (response.status === 204)
@@ -118,6 +125,14 @@ export class HiveMem {
     createWorkspace(workspaceId, options = {}) {
         return this.request("POST", "/v1/workspaces", { body: JSON.stringify({ ...options, workspace_id: workspaceId }) });
     }
+    /**
+     * One page of the suite audit export (`GET /v1/audit/export`), oldest first. Pass the last
+     * non-null `nextCursor` as `after`; `nextCursor` is null only on an empty page (caught up). Requires an administrator
+     * or an Oathweave service token with `hivemem:audit:read`.
+     */
+    exportAudit(options = {}) {
+        return this.request("GET", "/v1/audit/export", {}, { after: options.after, limit: options.limit });
+    }
     getMemory(memoryId, options = {}) {
         const params = options.includeHistory ? { include_history: true } : {};
         return this.request("GET", `/v1/memories/${encodeURIComponent(memoryId)}`, {}, params);

package/dist/types.d.ts

@@ -200,6 +200,34 @@ export interface ConclusionPage {
     results: ConclusionRecord[];
     next_cursor: string | null;
 }
+/** HiveAuditRecord v1, the suite audit export record. */
+export interface HiveAuditRecord {
+    id: string;
+    product: "hivemem" | "hiveskills" | "ardentstudio" | "embermend";
+    occurredAt: string;
+    action: string;
+    outcome: "success" | "failure";
+    actor: {
+        type: "user" | "service" | "agent" | "system";
+        id: string;
+        issuer?: string;
+        displayName?: string;
+    };
+    target?: {
+        type?: string;
+        id?: string;
+    };
+    subject?: {
+        actorId?: string;
+        agentRef?: string;
+        nodeId?: string;
+    };
+    details: Record<string, string | number | boolean | null>;
+}
+export interface HiveAuditPage {
+    data: HiveAuditRecord[];
+    nextCursor: string | null;
+}
 export interface WebhookEndpoint {
     id: string;
     owner_agent_id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hivemagnus/hivemem-sdk",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "TypeScript client for HiveMem, the shared long-term memory service for AI agents",
   "keywords": [
     "hivemem",