@vectorize-io/hindsight-client 0.4.19 → 0.4.21

package/generated/sdk.gen.ts

@@ -11,6 +11,9 @@ import type {
   AddBankBackgroundData,
   AddBankBackgroundErrors,
   AddBankBackgroundResponses,
+  AuditLogStatsData,
+  AuditLogStatsErrors,
+  AuditLogStatsResponses,
   CancelOperationData,
   CancelOperationErrors,
   CancelOperationResponses,
@@ -96,6 +99,9 @@ import type {
   GetVersionResponses,
   HealthEndpointHealthGetData,
   HealthEndpointHealthGetResponses,
+  ListAuditLogsData,
+  ListAuditLogsErrors,
+  ListAuditLogsResponses,
   ListBanksData,
   ListBanksErrors,
   ListBanksResponses,
@@ -1226,3 +1232,31 @@ export const fileRetain = <ThrowOnError extends boolean = false>(
       ...options.headers,
     },
   });
+
+/**
+ * List audit logs
+ *
+ * List audit log entries for a bank, ordered by most recent first.
+ */
+export const listAuditLogs = <ThrowOnError extends boolean = false>(
+  options: Options<ListAuditLogsData, ThrowOnError>,
+) =>
+  (options.client ?? client).get<
+    ListAuditLogsResponses,
+    ListAuditLogsErrors,
+    ThrowOnError
+  >({ url: "/v1/default/banks/{bank_id}/audit-logs", ...options });
+
+/**
+ * Audit log statistics
+ *
+ * Get audit log counts grouped by time bucket for charting.
+ */
+export const auditLogStats = <ThrowOnError extends boolean = false>(
+  options: Options<AuditLogStatsData, ThrowOnError>,
+) =>
+  (options.client ?? client).get<
+    AuditLogStatsResponses,
+    AuditLogStatsErrors,
+    ThrowOnError
+  >({ url: "/v1/default/banks/{bank_id}/audit-logs/stats", ...options });

package/generated/types.gen.ts

@@ -40,6 +40,140 @@ export type AsyncOperationSubmitResponse = {
   status: string;
 };
 
+/**
+ * AuditLogEntry
+ *
+ * A single audit log entry.
+ */
+export type AuditLogEntry = {
+  /**
+   * Id
+   */
+  id: string;
+  /**
+   * Action
+   */
+  action: string;
+  /**
+   * Transport
+   */
+  transport: string;
+  /**
+   * Bank Id
+   */
+  bank_id: string | null;
+  /**
+   * Started At
+   */
+  started_at: string | null;
+  /**
+   * Ended At
+   */
+  ended_at: string | null;
+  /**
+   * Duration Ms
+   *
+   * Server-computed duration in milliseconds (started_at → ended_at). Null if not yet completed.
+   */
+  duration_ms?: number | null;
+  /**
+   * Request
+   */
+  request: {
+    [key: string]: unknown;
+  } | null;
+  /**
+   * Response
+   */
+  response: {
+    [key: string]: unknown;
+  } | null;
+  /**
+   * Metadata
+   */
+  metadata: {
+    [key: string]: unknown;
+  };
+};
+
+/**
+ * AuditLogListResponse
+ *
+ * Response model for list audit logs endpoint.
+ */
+export type AuditLogListResponse = {
+  /**
+   * Bank Id
+   */
+  bank_id: string;
+  /**
+   * Total
+   */
+  total: number;
+  /**
+   * Limit
+   */
+  limit: number;
+  /**
+   * Offset
+   */
+  offset: number;
+  /**
+   * Items
+   */
+  items: Array<AuditLogEntry>;
+};
+
+/**
+ * AuditLogStatsBucket
+ *
+ * A single time bucket in audit log stats.
+ */
+export type AuditLogStatsBucket = {
+  /**
+   * Time
+   */
+  time: string;
+  /**
+   * Actions
+   */
+  actions: {
+    [key: string]: number;
+  };
+  /**
+   * Total
+   */
+  total: number;
+};
+
+/**
+ * AuditLogStatsResponse
+ *
+ * Response model for audit log stats endpoint.
+ */
+export type AuditLogStatsResponse = {
+  /**
+   * Bank Id
+   */
+  bank_id: string;
+  /**
+   * Period
+   */
+  period: string;
+  /**
+   * Trunc
+   */
+  trunc: string;
+  /**
+   * Start
+   */
+  start: string;
+  /**
+   * Buckets
+   */
+  buckets: Array<AuditLogStatsBucket>;
+};
+
 /**
  * BackgroundResponse
  *
@@ -1331,6 +1465,24 @@ export type MentalModelTrigger = {
    * If true, refresh this mental model after observations consolidation (real-time mode)
    */
   refresh_after_consolidation?: boolean;
+  /**
+   * Fact Types
+   *
+   * Filter which fact types are retrieved during reflect. None means all types (world, experience, observation).
+   */
+  fact_types?: Array<"world" | "experience" | "observation"> | null;
+  /**
+   * Exclude Mental Models
+   *
+   * If true, exclude all mental models from the reflect loop (skip search_mental_models tool).
+   */
+  exclude_mental_models?: boolean;
+  /**
+   * Exclude Mental Model Ids
+   *
+   * Exclude specific mental models by ID from the reflect loop.
+   */
+  exclude_mental_model_ids?: Array<string> | null;
 };
 
 /**
@@ -1825,6 +1977,24 @@ export type ReflectRequest = {
   tag_groups?: Array<
     TagGroupLeaf | TagGroupAnd | TagGroupOr | TagGroupNot
   > | null;
+  /**
+   * Fact Types
+   *
+   * Filter which fact types are retrieved during reflect. None means all types (world, experience, observation).
+   */
+  fact_types?: Array<"world" | "experience" | "observation"> | null;
+  /**
+   * Exclude Mental Models
+   *
+   * If true, exclude all mental models from the reflect loop (skip search_mental_models tool).
+   */
+  exclude_mental_models?: boolean;
+  /**
+   * Exclude Mental Model Ids
+   *
+   * Exclude specific mental models by ID from the reflect loop.
+   */
+  exclude_mental_model_ids?: Array<string> | null;
 };
 
 /**
@@ -2307,6 +2477,20 @@ export type ValidationError = {
    * Error Type
    */
   type: string;
+  /**
+   * Input
+   */
+  input?: unknown;
+  /**
+   * Context
+   */
+  ctx?: {
+    [key: string]: unknown;
+  };
+  /**
+   * URL
+   */
+  url?: string;
 };
 
 /**
@@ -4818,3 +5002,127 @@ export type FileRetainResponses = {
 
 export type FileRetainResponse2 =
   FileRetainResponses[keyof FileRetainResponses];
+
+export type ListAuditLogsData = {
+  body?: never;
+  headers?: {
+    /**
+     * Authorization
+     */
+    authorization?: string | null;
+  };
+  path: {
+    /**
+     * Bank Id
+     */
+    bank_id: string;
+  };
+  query?: {
+    /**
+     * Action
+     *
+     * Filter by action type
+     */
+    action?: string | null;
+    /**
+     * Transport
+     *
+     * Filter by transport (http, mcp, system)
+     */
+    transport?: string | null;
+    /**
+     * Start Date
+     *
+     * Filter from this ISO datetime (inclusive)
+     */
+    start_date?: string | null;
+    /**
+     * End Date
+     *
+     * Filter until this ISO datetime (exclusive)
+     */
+    end_date?: string | null;
+    /**
+     * Limit
+     *
+     * Max items to return
+     */
+    limit?: number;
+    /**
+     * Offset
+     *
+     * Offset for pagination
+     */
+    offset?: number;
+  };
+  url: "/v1/default/banks/{bank_id}/audit-logs";
+};
+
+export type ListAuditLogsErrors = {
+  /**
+   * Validation Error
+   */
+  422: HttpValidationError;
+};
+
+export type ListAuditLogsError = ListAuditLogsErrors[keyof ListAuditLogsErrors];
+
+export type ListAuditLogsResponses = {
+  /**
+   * Successful Response
+   */
+  200: AuditLogListResponse;
+};
+
+export type ListAuditLogsResponse =
+  ListAuditLogsResponses[keyof ListAuditLogsResponses];
+
+export type AuditLogStatsData = {
+  body?: never;
+  headers?: {
+    /**
+     * Authorization
+     */
+    authorization?: string | null;
+  };
+  path: {
+    /**
+     * Bank Id
+     */
+    bank_id: string;
+  };
+  query?: {
+    /**
+     * Action
+     *
+     * Filter by action type
+     */
+    action?: string | null;
+    /**
+     * Period
+     *
+     * Time period: 1d, 7d, or 30d
+     */
+    period?: string;
+  };
+  url: "/v1/default/banks/{bank_id}/audit-logs/stats";
+};
+
+export type AuditLogStatsErrors = {
+  /**
+   * Validation Error
+   */
+  422: HttpValidationError;
+};
+
+export type AuditLogStatsError = AuditLogStatsErrors[keyof AuditLogStatsErrors];
+
+export type AuditLogStatsResponses = {
+  /**
+   * Successful Response
+   */
+  200: AuditLogStatsResponse;
+};
+
+export type AuditLogStatsResponse2 =
+  AuditLogStatsResponses[keyof AuditLogStatsResponses];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectorize-io/hindsight-client",
-  "version": "0.4.19",
+  "version": "0.4.21",
   "description": "TypeScript client for Hindsight - Semantic memory system with personality-driven thinking",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/src/index.ts

@@ -628,6 +628,7 @@ export class HindsightClient {
         name: string,
         sourceQuery: string,
         options?: {
+            id?: string;
             tags?: string[];
             maxTokens?: number;
             trigger?: { refreshAfterConsolidation?: boolean };
@@ -637,6 +638,7 @@ export class HindsightClient {
             client: this.client,
             path: { bank_id: bankId },
             body: {
+                id: options?.id,
                 name,
                 source_query: sourceQuery,
                 tags: options?.tags,
@@ -726,6 +728,18 @@ export class HindsightClient {
             throw new Error(`deleteMentalModel failed: ${JSON.stringify(response.error)}`);
         }
     }
+
+    /**
+     * Get the change history of a mental model.
+     */
+    async getMentalModelHistory(bankId: string, mentalModelId: string): Promise<any> {
+        const response = await sdk.getMentalModelHistory({
+            client: this.client,
+            path: { bank_id: bankId, mental_model_id: mentalModelId },
+        });
+
+        return this.validateResponse(response, 'getMentalModelHistory');
+    }
 }
 
 // Re-export types for convenience