@vectorize-io/hindsight-client 0.4.19 → 0.4.21

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
  *
@@ -1272,6 +1402,24 @@ 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;
 };
 /**
  * OperationResponse
@@ -1748,6 +1896,24 @@ 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;
+    /**
+     * 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;
 };
 /**
  * ReflectResponse
@@ -2209,6 +2375,20 @@ type ValidationError = {
      * Error Type
      */
     type: string;
+    /**
+     * Input
+     */
+    input?: unknown;
+    /**
+     * Context
+     */
+    ctx?: {
+        [key: string]: unknown;
+    };
+    /**
+     * URL
+     */
+    url?: string;
 };
 /**
  * VersionResponse
@@ -4264,6 +4444,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 {
@@ -5011,9 +5299,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;
@@ -5043,6 +5344,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;
@@ -5071,7 +5373,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 };
 }
 
 /**
@@ -5343,6 +5645,7 @@ declare class HindsightClient {
      * Create a mental model (runs reflect in background).
      */
     createMentalModel(bankId: string, name: string, sourceQuery: string, options?: {
+        id?: string;
         tags?: string[];
         maxTokens?: number;
         trigger?: {
@@ -5379,6 +5682,10 @@ declare class HindsightClient {
      * Delete a mental model.
      */
     deleteMentalModel(bankId: string, mentalModelId: string): Promise<void>;
+    /**
+     * Get the change history of a mental model.
+     */
+    getMentalModelHistory(bankId: string, mentalModelId: string): Promise<any>;
 }
 
 export { type BankConfigResponse, type BankProfileResponse, type Budget, type Client, type CreateBankRequest, type EntityInput, type FileRetainResponse, HindsightClient, type HindsightClientOptions, HindsightError, type ListMemoryUnitsResponse, type MemoryItemInput, type RecallRequest, type RecallResponse, type RecallResult, type ReflectRequest, type ReflectResponse, type RetainRequest, type RetainResponse, createClient, createConfig, sdk_gen as sdk };