@vectorize-io/hindsight-client 0.4.20 → 0.4.22

package/dist/index.d.mts

@@ -32,6 +32,136 @@ type AsyncOperationSubmitResponse = {
      */
     status: string;
 };
+/**
+ * AuditLogEntry
+ *
+ * A single audit log entry.
+ */
+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.
+ */
+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.
+ */
+type AuditLogStatsBucket = {
+    /**
+     * Time
+     */
+    time: string;
+    /**
+     * Actions
+     */
+    actions: {
+        [key: string]: number;
+    };
+    /**
+     * Total
+     */
+    total: number;
+};
+/**
+ * AuditLogStatsResponse
+ *
+ * Response model for audit log stats endpoint.
+ */
+type AuditLogStatsResponse = {
+    /**
+     * Bank Id
+     */
+    bank_id: string;
+    /**
+     * Period
+     */
+    period: string;
+    /**
+     * Trunc
+     */
+    trunc: string;
+    /**
+     * Start
+     */
+    start: string;
+    /**
+     * Buckets
+     */
+    buckets: Array<AuditLogStatsBucket>;
+};
 /**
  * BackgroundResponse
  *
@@ -569,7 +699,7 @@ type CreateMentalModelRequest = {
     /**
      * Trigger settings
      */
-    trigger?: MentalModelTrigger;
+    trigger?: MentalModelTriggerInput;
 };
 /**
  * CreateMentalModelResponse
@@ -786,6 +916,22 @@ 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;
 };
 /**
  * EntityDetailResponse
@@ -1242,7 +1388,7 @@ type MentalModelResponse = {
      * Max Tokens
      */
     max_tokens?: number;
-    trigger?: MentalModelTrigger;
+    trigger?: MentalModelTriggerOutput;
     /**
      * Last Refreshed At
      */
@@ -1265,7 +1411,7 @@ type MentalModelResponse = {
  *
  * Trigger settings for a mental model.
  */
-type MentalModelTrigger = {
+type MentalModelTriggerInput = {
     /**
      * Refresh After Consolidation
      *
@@ -1290,6 +1436,61 @@ 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.
+ */
+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;
 };
 /**
  * OperationResponse
@@ -1454,7 +1655,7 @@ 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> | null;
+    tag_groups?: Array<TagGroupLeaf | TagGroupAndInput | TagGroupOrInput | TagGroupNotInput> | null;
 };
 /**
  * RecallResponse
@@ -1765,7 +1966,7 @@ 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> | null;
+    tag_groups?: Array<TagGroupLeaf | TagGroupAndInput | TagGroupOrInput | TagGroupNotInput> | null;
     /**
      * Fact Types
      *
@@ -1987,11 +2188,22 @@ type SourceFactsIncludeOptions = {
  *
  * Compound AND group: all child filters must match.
  */
-type TagGroupAnd = {
+type TagGroupAndInput = {
+    /**
+     * And
+     */
+    and: Array<TagGroupLeaf | TagGroupAndInput | TagGroupOrInput | TagGroupNotInput>;
+};
+/**
+ * TagGroupAnd
+ *
+ * Compound AND group: all child filters must match.
+ */
+type TagGroupAndOutput = {
     /**
      * And
      */
-    and: Array<TagGroupLeaf | TagGroupAnd | TagGroupOr | TagGroupNot>;
+    and: Array<TagGroupLeaf | TagGroupAndOutput | TagGroupOrOutput | TagGroupNotOutput>;
 };
 /**
  * TagGroupLeaf
@@ -2013,22 +2225,44 @@ type TagGroupLeaf = {
  *
  * Compound NOT group: child filter must NOT match.
  */
-type TagGroupNot = {
+type TagGroupNotInput = {
     /**
      * Not
      */
-    not: TagGroupLeaf | TagGroupAnd | TagGroupOr | TagGroupNot;
+    not: TagGroupLeaf | TagGroupAndInput | TagGroupOrInput | TagGroupNotInput;
+};
+/**
+ * TagGroupNot
+ *
+ * Compound NOT group: child filter must NOT match.
+ */
+type TagGroupNotOutput = {
+    /**
+     * Not
+     */
+    not: TagGroupLeaf | TagGroupAndOutput | TagGroupOrOutput | TagGroupNotOutput;
 };
 /**
  * TagGroupOr
  *
  * Compound OR group: at least one child filter must match.
  */
-type TagGroupOr = {
+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.
+ */
+type TagGroupOrOutput = {
+    /**
+     * Or
+     */
+    or: Array<TagGroupLeaf | TagGroupAndOutput | TagGroupOrOutput | TagGroupNotOutput>;
 };
 /**
  * TagItem
@@ -2192,7 +2426,7 @@ type UpdateMentalModelRequest = {
     /**
      * Trigger settings
      */
-    trigger?: MentalModelTrigger | null;
+    trigger?: MentalModelTriggerInput | null;
 };
 /**
  * UpdateWebhookRequest
@@ -2245,6 +2479,20 @@ type ValidationError = {
      * Error Type
      */
     type: string;
+    /**
+     * Input
+     */
+    input?: unknown;
+    /**
+     * Context
+     */
+    ctx?: {
+        [key: string]: unknown;
+    };
+    /**
+     * URL
+     */
+    url?: string;
 };
 /**
  * VersionResponse
@@ -4300,6 +4548,114 @@ type FileRetainResponses = {
      */
     200: FileRetainResponse;
 };
+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";
+};
+type ListAuditLogsErrors = {
+    /**
+     * Validation Error
+     */
+    422: HttpValidationError;
+};
+type ListAuditLogsResponses = {
+    /**
+     * Successful Response
+     */
+    200: AuditLogListResponse;
+};
+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";
+};
+type AuditLogStatsErrors = {
+    /**
+     * Validation Error
+     */
+    422: HttpValidationError;
+};
+type AuditLogStatsResponses = {
+    /**
+     * Successful Response
+     */
+    200: AuditLogStatsResponse;
+};
 
 type AuthToken = string | undefined;
 interface Auth {
@@ -5047,9 +5403,22 @@ declare const retainMemories: <ThrowOnError extends boolean = false>(options: Op
  * - Only parsers enabled on the server may be requested; others return HTTP 400.
  */
 declare const fileRetain: <ThrowOnError extends boolean = false>(options: Options<FileRetainData, ThrowOnError>) => RequestResult<FileRetainResponses, FileRetainErrors, ThrowOnError, "fields">;
+/**
+ * List audit logs
+ *
+ * List audit log entries for a bank, ordered by most recent first.
+ */
+declare const listAuditLogs: <ThrowOnError extends boolean = false>(options: Options<ListAuditLogsData, ThrowOnError>) => RequestResult<ListAuditLogsResponses, ListAuditLogsErrors, ThrowOnError, "fields">;
+/**
+ * Audit log statistics
+ *
+ * Get audit log counts grouped by time bucket for charting.
+ */
+declare const auditLogStats: <ThrowOnError extends boolean = false>(options: Options<AuditLogStatsData, ThrowOnError>) => RequestResult<AuditLogStatsResponses, AuditLogStatsErrors, ThrowOnError, "fields">;
 
 type sdk_gen_Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = Options<TData, ThrowOnError>;
 declare const sdk_gen_addBankBackground: typeof addBankBackground;
+declare const sdk_gen_auditLogStats: typeof auditLogStats;
 declare const sdk_gen_cancelOperation: typeof cancelOperation;
 declare const sdk_gen_clearBankMemories: typeof clearBankMemories;
 declare const sdk_gen_clearMemoryObservations: typeof clearMemoryObservations;
@@ -5079,6 +5448,7 @@ declare const sdk_gen_getObservationHistory: typeof getObservationHistory;
 declare const sdk_gen_getOperationStatus: typeof getOperationStatus;
 declare const sdk_gen_getVersion: typeof getVersion;
 declare const sdk_gen_healthEndpointHealthGet: typeof healthEndpointHealthGet;
+declare const sdk_gen_listAuditLogs: typeof listAuditLogs;
 declare const sdk_gen_listBanks: typeof listBanks;
 declare const sdk_gen_listDirectives: typeof listDirectives;
 declare const sdk_gen_listDocuments: typeof listDocuments;
@@ -5107,7 +5477,7 @@ declare const sdk_gen_updateDocument: typeof updateDocument;
 declare const sdk_gen_updateMentalModel: typeof updateMentalModel;
 declare const sdk_gen_updateWebhook: typeof updateWebhook;
 declare namespace sdk_gen {
-  export { type sdk_gen_Options as Options, sdk_gen_addBankBackground as addBankBackground, sdk_gen_cancelOperation as cancelOperation, sdk_gen_clearBankMemories as clearBankMemories, sdk_gen_clearMemoryObservations as clearMemoryObservations, sdk_gen_clearObservations as clearObservations, sdk_gen_createDirective as createDirective, sdk_gen_createMentalModel as createMentalModel, sdk_gen_createOrUpdateBank as createOrUpdateBank, sdk_gen_createWebhook as createWebhook, sdk_gen_deleteBank as deleteBank, sdk_gen_deleteDirective as deleteDirective, sdk_gen_deleteDocument as deleteDocument, sdk_gen_deleteMentalModel as deleteMentalModel, sdk_gen_deleteWebhook as deleteWebhook, sdk_gen_fileRetain as fileRetain, sdk_gen_getAgentStats as getAgentStats, sdk_gen_getBankConfig as getBankConfig, sdk_gen_getBankProfile as getBankProfile, sdk_gen_getChunk as getChunk, sdk_gen_getDirective as getDirective, sdk_gen_getDocument as getDocument, sdk_gen_getEntity as getEntity, sdk_gen_getGraph as getGraph, sdk_gen_getMemory as getMemory, sdk_gen_getMentalModel as getMentalModel, sdk_gen_getMentalModelHistory as getMentalModelHistory, sdk_gen_getObservationHistory as getObservationHistory, sdk_gen_getOperationStatus as getOperationStatus, sdk_gen_getVersion as getVersion, sdk_gen_healthEndpointHealthGet as healthEndpointHealthGet, sdk_gen_listBanks as listBanks, sdk_gen_listDirectives as listDirectives, sdk_gen_listDocuments as listDocuments, sdk_gen_listEntities as listEntities, sdk_gen_listMemories as listMemories, sdk_gen_listMentalModels as listMentalModels, sdk_gen_listOperations as listOperations, sdk_gen_listTags as listTags, sdk_gen_listWebhookDeliveries as listWebhookDeliveries, sdk_gen_listWebhooks as listWebhooks, sdk_gen_metricsEndpointMetricsGet as metricsEndpointMetricsGet, sdk_gen_recallMemories as recallMemories, sdk_gen_recoverConsolidation as recoverConsolidation, sdk_gen_reflect as reflect, sdk_gen_refreshMentalModel as refreshMentalModel, sdk_gen_regenerateEntityObservations as regenerateEntityObservations, sdk_gen_resetBankConfig as resetBankConfig, sdk_gen_retainMemories as retainMemories, sdk_gen_retryOperation as retryOperation, sdk_gen_triggerConsolidation as triggerConsolidation, sdk_gen_updateBank as updateBank, sdk_gen_updateBankConfig as updateBankConfig, sdk_gen_updateBankDisposition as updateBankDisposition, sdk_gen_updateDirective as updateDirective, sdk_gen_updateDocument as updateDocument, sdk_gen_updateMentalModel as updateMentalModel, sdk_gen_updateWebhook as updateWebhook };
+  export { type sdk_gen_Options as Options, sdk_gen_addBankBackground as addBankBackground, sdk_gen_auditLogStats as auditLogStats, sdk_gen_cancelOperation as cancelOperation, sdk_gen_clearBankMemories as clearBankMemories, sdk_gen_clearMemoryObservations as clearMemoryObservations, sdk_gen_clearObservations as clearObservations, sdk_gen_createDirective as createDirective, sdk_gen_createMentalModel as createMentalModel, sdk_gen_createOrUpdateBank as createOrUpdateBank, sdk_gen_createWebhook as createWebhook, sdk_gen_deleteBank as deleteBank, sdk_gen_deleteDirective as deleteDirective, sdk_gen_deleteDocument as deleteDocument, sdk_gen_deleteMentalModel as deleteMentalModel, sdk_gen_deleteWebhook as deleteWebhook, sdk_gen_fileRetain as fileRetain, sdk_gen_getAgentStats as getAgentStats, sdk_gen_getBankConfig as getBankConfig, sdk_gen_getBankProfile as getBankProfile, sdk_gen_getChunk as getChunk, sdk_gen_getDirective as getDirective, sdk_gen_getDocument as getDocument, sdk_gen_getEntity as getEntity, sdk_gen_getGraph as getGraph, sdk_gen_getMemory as getMemory, sdk_gen_getMentalModel as getMentalModel, sdk_gen_getMentalModelHistory as getMentalModelHistory, sdk_gen_getObservationHistory as getObservationHistory, sdk_gen_getOperationStatus as getOperationStatus, sdk_gen_getVersion as getVersion, sdk_gen_healthEndpointHealthGet as healthEndpointHealthGet, sdk_gen_listAuditLogs as listAuditLogs, sdk_gen_listBanks as listBanks, sdk_gen_listDirectives as listDirectives, sdk_gen_listDocuments as listDocuments, sdk_gen_listEntities as listEntities, sdk_gen_listMemories as listMemories, sdk_gen_listMentalModels as listMentalModels, sdk_gen_listOperations as listOperations, sdk_gen_listTags as listTags, sdk_gen_listWebhookDeliveries as listWebhookDeliveries, sdk_gen_listWebhooks as listWebhooks, sdk_gen_metricsEndpointMetricsGet as metricsEndpointMetricsGet, sdk_gen_recallMemories as recallMemories, sdk_gen_recoverConsolidation as recoverConsolidation, sdk_gen_reflect as reflect, sdk_gen_refreshMentalModel as refreshMentalModel, sdk_gen_regenerateEntityObservations as regenerateEntityObservations, sdk_gen_resetBankConfig as resetBankConfig, sdk_gen_retainMemories as retainMemories, sdk_gen_retryOperation as retryOperation, sdk_gen_triggerConsolidation as triggerConsolidation, sdk_gen_updateBank as updateBank, sdk_gen_updateBankConfig as updateBankConfig, sdk_gen_updateBankDisposition as updateBankDisposition, sdk_gen_updateDirective as updateDirective, sdk_gen_updateDocument as updateDocument, sdk_gen_updateMentalModel as updateMentalModel, sdk_gen_updateWebhook as updateWebhook };
 }
 
 /**