@vectorize-io/hindsight-client 0.4.20 → 0.4.22

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
  *
@@ -595,7 +729,7 @@ export type CreateMentalModelRequest = {
   /**
    * Trigger settings
    */
-  trigger?: MentalModelTrigger;
+  trigger?: MentalModelTriggerInput;
 };
 
 /**
@@ -820,6 +954,22 @@ export type DocumentResponse = {
    * Tags associated with this document
    */
   tags?: Array<string>;
+  /**
+   * Document Metadata
+   *
+   * Document metadata
+   */
+  document_metadata?: {
+    [key: string]: unknown;
+  } | null;
+  /**
+   * Retain Params
+   *
+   * Parameters used during retain
+   */
+  retain_params?: {
+    [key: string]: unknown;
+  } | null;
 };
 
 /**
@@ -1300,7 +1450,7 @@ export type MentalModelResponse = {
    * Max Tokens
    */
   max_tokens?: number;
-  trigger?: MentalModelTrigger;
+  trigger?: MentalModelTriggerOutput;
   /**
    * Last Refreshed At
    */
@@ -1324,7 +1474,7 @@ export type MentalModelResponse = {
  *
  * Trigger settings for a mental model.
  */
-export type MentalModelTrigger = {
+export type MentalModelTriggerInput = {
   /**
    * Refresh After Consolidation
    *
@@ -1349,6 +1499,66 @@ export type MentalModelTrigger = {
    * Exclude specific mental models by ID from the reflect loop.
    */
   exclude_mental_model_ids?: Array<string> | null;
+  /**
+   * Tags Match
+   *
+   * Override how the model's tags filter memories during refresh. If not set, defaults to 'all_strict' when the model has tags (security isolation) or 'any' when the model has no tags. Set to 'any' to include untagged memories alongside tagged ones during refresh.
+   */
+  tags_match?: "any" | "all" | "any_strict" | "all_strict" | null;
+  /**
+   * Tag Groups
+   *
+   * Compound boolean tag expressions to use during refresh instead of the model's own tags. When set, these tag groups are passed to reflect and the model's flat tags are NOT used for filtering. Supports nested and/or/not expressions for complex tag-based scoping.
+   */
+  tag_groups?: Array<
+    TagGroupLeaf | TagGroupAndInput | TagGroupOrInput | TagGroupNotInput
+  > | null;
+};
+
+/**
+ * MentalModelTrigger
+ *
+ * Trigger settings for a mental model.
+ */
+export type MentalModelTriggerOutput = {
+  /**
+   * Refresh After Consolidation
+   *
+   * 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;
+  /**
+   * Tags Match
+   *
+   * Override how the model's tags filter memories during refresh. If not set, defaults to 'all_strict' when the model has tags (security isolation) or 'any' when the model has no tags. Set to 'any' to include untagged memories alongside tagged ones during refresh.
+   */
+  tags_match?: "any" | "all" | "any_strict" | "all_strict" | null;
+  /**
+   * Tag Groups
+   *
+   * Compound boolean tag expressions to use during refresh instead of the model's own tags. When set, these tag groups are passed to reflect and the model's flat tags are NOT used for filtering. Supports nested and/or/not expressions for complex tag-based scoping.
+   */
+  tag_groups?: Array<
+    TagGroupLeaf | TagGroupAndOutput | TagGroupOrOutput | TagGroupNotOutput
+  > | null;
 };
 
 /**
@@ -1518,7 +1728,7 @@ export type RecallRequest = {
    * Compound tag filter using boolean groups. Groups in the list are AND-ed. Each group is a leaf {tags, match} or compound {and: [...]}, {or: [...]}, {not: ...}.
    */
   tag_groups?: Array<
-    TagGroupLeaf | TagGroupAnd | TagGroupOr | TagGroupNot
+    TagGroupLeaf | TagGroupAndInput | TagGroupOrInput | TagGroupNotInput
   > | null;
 };
 
@@ -1841,7 +2051,7 @@ export type ReflectRequest = {
    * Compound tag filter using boolean groups. Groups in the list are AND-ed. Each group is a leaf {tags, match} or compound {and: [...]}, {or: [...]}, {not: ...}.
    */
   tag_groups?: Array<
-    TagGroupLeaf | TagGroupAnd | TagGroupOr | TagGroupNot
+    TagGroupLeaf | TagGroupAndInput | TagGroupOrInput | TagGroupNotInput
   > | null;
   /**
    * Fact Types
@@ -2072,11 +2282,27 @@ export type SourceFactsIncludeOptions = {
  *
  * Compound AND group: all child filters must match.
  */
-export type TagGroupAnd = {
+export type TagGroupAndInput = {
+  /**
+   * And
+   */
+  and: Array<
+    TagGroupLeaf | TagGroupAndInput | TagGroupOrInput | TagGroupNotInput
+  >;
+};
+
+/**
+ * TagGroupAnd
+ *
+ * Compound AND group: all child filters must match.
+ */
+export type TagGroupAndOutput = {
   /**
    * And
    */
-  and: Array<TagGroupLeaf | TagGroupAnd | TagGroupOr | TagGroupNot>;
+  and: Array<
+    TagGroupLeaf | TagGroupAndOutput | TagGroupOrOutput | TagGroupNotOutput
+  >;
 };
 
 /**
@@ -2100,11 +2326,23 @@ export type TagGroupLeaf = {
  *
  * Compound NOT group: child filter must NOT match.
  */
-export type TagGroupNot = {
+export type TagGroupNotInput = {
+  /**
+   * Not
+   */
+  not: TagGroupLeaf | TagGroupAndInput | TagGroupOrInput | TagGroupNotInput;
+};
+
+/**
+ * TagGroupNot
+ *
+ * Compound NOT group: child filter must NOT match.
+ */
+export type TagGroupNotOutput = {
   /**
    * Not
    */
-  not: TagGroupLeaf | TagGroupAnd | TagGroupOr | TagGroupNot;
+  not: TagGroupLeaf | TagGroupAndOutput | TagGroupOrOutput | TagGroupNotOutput;
 };
 
 /**
@@ -2112,11 +2350,27 @@ export type TagGroupNot = {
  *
  * Compound OR group: at least one child filter must match.
  */
-export type TagGroupOr = {
+export type TagGroupOrInput = {
   /**
    * Or
    */
-  or: Array<TagGroupLeaf | TagGroupAnd | TagGroupOr | TagGroupNot>;
+  or: Array<
+    TagGroupLeaf | TagGroupAndInput | TagGroupOrInput | TagGroupNotInput
+  >;
+};
+
+/**
+ * TagGroupOr
+ *
+ * Compound OR group: at least one child filter must match.
+ */
+export type TagGroupOrOutput = {
+  /**
+   * Or
+   */
+  or: Array<
+    TagGroupLeaf | TagGroupAndOutput | TagGroupOrOutput | TagGroupNotOutput
+  >;
 };
 
 /**
@@ -2288,7 +2542,7 @@ export type UpdateMentalModelRequest = {
   /**
    * Trigger settings
    */
-  trigger?: MentalModelTrigger | null;
+  trigger?: MentalModelTriggerInput | null;
 };
 
 /**
@@ -2343,6 +2597,20 @@ export type ValidationError = {
    * Error Type
    */
   type: string;
+  /**
+   * Input
+   */
+  input?: unknown;
+  /**
+   * Context
+   */
+  ctx?: {
+    [key: string]: unknown;
+  };
+  /**
+   * URL
+   */
+  url?: string;
 };
 
 /**
@@ -4854,3 +5122,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.20",
+  "version": "0.4.22",
   "description": "TypeScript client for Hindsight - Semantic memory system with personality-driven thinking",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",