@hivemagnus/hivemem-sdk 1.1.1 → 1.2.0

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 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

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

@@ -125,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.1",
+  "version": "1.2.0",
   "description": "TypeScript client for HiveMem, the shared long-term memory service for AI agents",
   "keywords": [
     "hivemem",