@vectorize-io/hindsight-client 0.4.21 → 0.4.22

package/dist/index.d.mts

@@ -699,7 +699,7 @@ type CreateMentalModelRequest = {
     /**
      * Trigger settings
      */
-    trigger?: MentalModelTrigger;
+    trigger?: MentalModelTriggerInput;
 };
 /**
  * CreateMentalModelResponse
@@ -916,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
@@ -1372,7 +1388,7 @@ type MentalModelResponse = {
      * Max Tokens
      */
     max_tokens?: number;
-    trigger?: MentalModelTrigger;
+    trigger?: MentalModelTriggerOutput;
     /**
      * Last Refreshed At
      */
@@ -1395,7 +1411,7 @@ type MentalModelResponse = {
  *
  * Trigger settings for a mental model.
  */
-type MentalModelTrigger = {
+type MentalModelTriggerInput = {
     /**
      * Refresh After Consolidation
      *
@@ -1420,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
@@ -1584,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
@@ -1895,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
      *
@@ -2117,11 +2188,22 @@ type SourceFactsIncludeOptions = {
  *
  * Compound AND group: all child filters must match.
  */
-type TagGroupAnd = {
+type TagGroupAndInput = {
     /**
      * And
      */
-    and: Array<TagGroupLeaf | TagGroupAnd | TagGroupOr | TagGroupNot>;
+    and: Array<TagGroupLeaf | TagGroupAndInput | TagGroupOrInput | TagGroupNotInput>;
+};
+/**
+ * TagGroupAnd
+ *
+ * Compound AND group: all child filters must match.
+ */
+type TagGroupAndOutput = {
+    /**
+     * And
+     */
+    and: Array<TagGroupLeaf | TagGroupAndOutput | TagGroupOrOutput | TagGroupNotOutput>;
 };
 /**
  * TagGroupLeaf
@@ -2143,22 +2225,44 @@ type TagGroupLeaf = {
  *
  * Compound NOT group: child filter must NOT match.
  */
-type TagGroupNot = {
+type TagGroupNotInput = {
+    /**
+     * Not
+     */
+    not: TagGroupLeaf | TagGroupAndInput | TagGroupOrInput | TagGroupNotInput;
+};
+/**
+ * TagGroupNot
+ *
+ * Compound NOT group: child filter must NOT match.
+ */
+type TagGroupNotOutput = {
     /**
      * Not
      */
-    not: TagGroupLeaf | TagGroupAnd | TagGroupOr | TagGroupNot;
+    not: TagGroupLeaf | TagGroupAndOutput | TagGroupOrOutput | TagGroupNotOutput;
+};
+/**
+ * TagGroupOr
+ *
+ * Compound OR group: at least one child filter must match.
+ */
+type TagGroupOrInput = {
+    /**
+     * Or
+     */
+    or: Array<TagGroupLeaf | TagGroupAndInput | TagGroupOrInput | TagGroupNotInput>;
 };
 /**
  * TagGroupOr
  *
  * Compound OR group: at least one child filter must match.
  */
-type TagGroupOr = {
+type TagGroupOrOutput = {
     /**
      * Or
      */
-    or: Array<TagGroupLeaf | TagGroupAnd | TagGroupOr | TagGroupNot>;
+    or: Array<TagGroupLeaf | TagGroupAndOutput | TagGroupOrOutput | TagGroupNotOutput>;
 };
 /**
  * TagItem
@@ -2322,7 +2426,7 @@ type UpdateMentalModelRequest = {
     /**
      * Trigger settings
      */
-    trigger?: MentalModelTrigger | null;
+    trigger?: MentalModelTriggerInput | null;
 };
 /**
  * UpdateWebhookRequest

package/dist/index.d.ts

@@ -699,7 +699,7 @@ type CreateMentalModelRequest = {
     /**
      * Trigger settings
      */
-    trigger?: MentalModelTrigger;
+    trigger?: MentalModelTriggerInput;
 };
 /**
  * CreateMentalModelResponse
@@ -916,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
@@ -1372,7 +1388,7 @@ type MentalModelResponse = {
      * Max Tokens
      */
     max_tokens?: number;
-    trigger?: MentalModelTrigger;
+    trigger?: MentalModelTriggerOutput;
     /**
      * Last Refreshed At
      */
@@ -1395,7 +1411,7 @@ type MentalModelResponse = {
  *
  * Trigger settings for a mental model.
  */
-type MentalModelTrigger = {
+type MentalModelTriggerInput = {
     /**
      * Refresh After Consolidation
      *
@@ -1420,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
@@ -1584,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
@@ -1895,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
      *
@@ -2117,11 +2188,22 @@ type SourceFactsIncludeOptions = {
  *
  * Compound AND group: all child filters must match.
  */
-type TagGroupAnd = {
+type TagGroupAndInput = {
     /**
      * And
      */
-    and: Array<TagGroupLeaf | TagGroupAnd | TagGroupOr | TagGroupNot>;
+    and: Array<TagGroupLeaf | TagGroupAndInput | TagGroupOrInput | TagGroupNotInput>;
+};
+/**
+ * TagGroupAnd
+ *
+ * Compound AND group: all child filters must match.
+ */
+type TagGroupAndOutput = {
+    /**
+     * And
+     */
+    and: Array<TagGroupLeaf | TagGroupAndOutput | TagGroupOrOutput | TagGroupNotOutput>;
 };
 /**
  * TagGroupLeaf
@@ -2143,22 +2225,44 @@ type TagGroupLeaf = {
  *
  * Compound NOT group: child filter must NOT match.
  */
-type TagGroupNot = {
+type TagGroupNotInput = {
+    /**
+     * Not
+     */
+    not: TagGroupLeaf | TagGroupAndInput | TagGroupOrInput | TagGroupNotInput;
+};
+/**
+ * TagGroupNot
+ *
+ * Compound NOT group: child filter must NOT match.
+ */
+type TagGroupNotOutput = {
     /**
      * Not
      */
-    not: TagGroupLeaf | TagGroupAnd | TagGroupOr | TagGroupNot;
+    not: TagGroupLeaf | TagGroupAndOutput | TagGroupOrOutput | TagGroupNotOutput;
+};
+/**
+ * TagGroupOr
+ *
+ * Compound OR group: at least one child filter must match.
+ */
+type TagGroupOrInput = {
+    /**
+     * Or
+     */
+    or: Array<TagGroupLeaf | TagGroupAndInput | TagGroupOrInput | TagGroupNotInput>;
 };
 /**
  * TagGroupOr
  *
  * Compound OR group: at least one child filter must match.
  */
-type TagGroupOr = {
+type TagGroupOrOutput = {
     /**
      * Or
      */
-    or: Array<TagGroupLeaf | TagGroupAnd | TagGroupOr | TagGroupNot>;
+    or: Array<TagGroupLeaf | TagGroupAndOutput | TagGroupOrOutput | TagGroupNotOutput>;
 };
 /**
  * TagItem
@@ -2322,7 +2426,7 @@ type UpdateMentalModelRequest = {
     /**
      * Trigger settings
      */
-    trigger?: MentalModelTrigger | null;
+    trigger?: MentalModelTriggerInput | null;
 };
 /**
  * UpdateWebhookRequest

package/generated/types.gen.ts

@@ -729,7 +729,7 @@ export type CreateMentalModelRequest = {
   /**
    * Trigger settings
    */
-  trigger?: MentalModelTrigger;
+  trigger?: MentalModelTriggerInput;
 };
 
 /**
@@ -954,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;
 };
 
 /**
@@ -1434,7 +1450,7 @@ export type MentalModelResponse = {
    * Max Tokens
    */
   max_tokens?: number;
-  trigger?: MentalModelTrigger;
+  trigger?: MentalModelTriggerOutput;
   /**
    * Last Refreshed At
    */
@@ -1458,7 +1474,7 @@ export type MentalModelResponse = {
  *
  * Trigger settings for a mental model.
  */
-export type MentalModelTrigger = {
+export type MentalModelTriggerInput = {
   /**
    * Refresh After Consolidation
    *
@@ -1483,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;
 };
 
 /**
@@ -1652,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;
 };
 
@@ -1975,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
@@ -2206,11 +2282,27 @@ export type SourceFactsIncludeOptions = {
  *
  * Compound AND group: all child filters must match.
  */
-export type TagGroupAnd = {
+export type TagGroupAndInput = {
   /**
    * And
    */
-  and: Array<TagGroupLeaf | TagGroupAnd | TagGroupOr | TagGroupNot>;
+  and: Array<
+    TagGroupLeaf | TagGroupAndInput | TagGroupOrInput | TagGroupNotInput
+  >;
+};
+
+/**
+ * TagGroupAnd
+ *
+ * Compound AND group: all child filters must match.
+ */
+export type TagGroupAndOutput = {
+  /**
+   * And
+   */
+  and: Array<
+    TagGroupLeaf | TagGroupAndOutput | TagGroupOrOutput | TagGroupNotOutput
+  >;
 };
 
 /**
@@ -2234,11 +2326,37 @@ 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;
+};
+
+/**
+ * TagGroupOr
+ *
+ * Compound OR group: at least one child filter must match.
+ */
+export type TagGroupOrInput = {
+  /**
+   * Or
+   */
+  or: Array<
+    TagGroupLeaf | TagGroupAndInput | TagGroupOrInput | TagGroupNotInput
+  >;
 };
 
 /**
@@ -2246,11 +2364,13 @@ export type TagGroupNot = {
  *
  * Compound OR group: at least one child filter must match.
  */
-export type TagGroupOr = {
+export type TagGroupOrOutput = {
   /**
    * Or
    */
-  or: Array<TagGroupLeaf | TagGroupAnd | TagGroupOr | TagGroupNot>;
+  or: Array<
+    TagGroupLeaf | TagGroupAndOutput | TagGroupOrOutput | TagGroupNotOutput
+  >;
 };
 
 /**
@@ -2422,7 +2542,7 @@ export type UpdateMentalModelRequest = {
   /**
    * Trigger settings
    */
-  trigger?: MentalModelTrigger | null;
+  trigger?: MentalModelTriggerInput | null;
 };
 
 /**

package/package.json

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