@alicloud/agentloop20260520 2.3.8 → 2.4.0

package/src/models/UpdateContextStoreRequest.ts

@@ -2,10 +2,545 @@
 import * as $dara from '@darabonba/typescript';
 
 
+export class UpdateContextStoreRequestConfigAudit extends $dara.Model {
+  /**
+   * @remarks
+   * Specifies whether to write item events for dropped candidates during retrieval. Default value: false.
+   * 
+   * @example
+   * false
+   */
+  droppedCandidates?: boolean;
+  /**
+   * @remarks
+   * The recording mode for retrieval queries. Valid values: raw (plaintext) and hash (HMAC only). Default value: raw.
+   * 
+   * @example
+   * raw
+   */
+  queryMode?: string;
+  /**
+   * @remarks
+   * The number of days to retain audit logs. Valid values: 1 to 180. Default value: 30.
+   * 
+   * @example
+   * 30
+   */
+  retentionDays?: number;
+  static names(): { [key: string]: string } {
+    return {
+      droppedCandidates: 'droppedCandidates',
+      queryMode: 'queryMode',
+      retentionDays: 'retentionDays',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      droppedCandidates: 'boolean',
+      queryMode: 'string',
+      retentionDays: 'number',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class UpdateContextStoreRequestConfigExtractionPolicyModel extends $dara.Model {
+  /**
+   * @remarks
+   * The name of the extraction model. Currently, only qwen3.8-flash is supported, which uses internal platform credentials.
+   * 
+   * @example
+   * qwen3.8-flash
+   */
+  name?: string;
+  static names(): { [key: string]: string } {
+    return {
+      name: 'name',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      name: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class UpdateContextStoreRequestConfigExtractionPolicy extends $dara.Model {
+  /**
+   * @remarks
+   * The list of memory categories.
+   * 
+   * @example
+   * ["preference","profile"]
+   */
+  categories?: string[];
+  /**
+   * @remarks
+   * The custom extraction instructions. This parameter is required when preset is set to custom. Length: 1 to 8000 characters.
+   * 
+   * @example
+   * Extract only user product preferences
+   */
+  customInstructions?: string;
+  /**
+   * @remarks
+   * The list of exclusion rules. Content that matches these rules is not extracted.
+   * 
+   * @example
+   * ["Password", "ID number"]
+   */
+  excludeRules?: string[];
+  /**
+   * @remarks
+   * The extraction model configuration.
+   */
+  model?: UpdateContextStoreRequestConfigExtractionPolicyModel;
+  /**
+   * @remarks
+   * The preset policy. Valid values: fact, toc-profile, tob-digital-twin, and custom. Default value: fact.
+   * 
+   * @example
+   * fact
+   */
+  preset?: string;
+  static names(): { [key: string]: string } {
+    return {
+      categories: 'categories',
+      customInstructions: 'customInstructions',
+      excludeRules: 'excludeRules',
+      model: 'model',
+      preset: 'preset',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      categories: { 'type': 'array', 'itemType': 'string' },
+      customInstructions: 'string',
+      excludeRules: { 'type': 'array', 'itemType': 'string' },
+      model: UpdateContextStoreRequestConfigExtractionPolicyModel,
+      preset: 'string',
+    };
+  }
+
+  validate() {
+    if(Array.isArray(this.categories)) {
+      $dara.Model.validateArray(this.categories);
+    }
+    if(Array.isArray(this.excludeRules)) {
+      $dara.Model.validateArray(this.excludeRules);
+    }
+    if(this.model && typeof (this.model as any).validate === 'function') {
+      (this.model as any).validate();
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class UpdateContextStoreRequestConfigScopePolicy extends $dara.Model {
+  /**
+   * @remarks
+   * The list of scope fields where at least one must be non-empty. Valid values for elements: userId, agentId, appId, and runId.
+   * 
+   * @example
+   * ["userId"]
+   */
+  requiredAnyOf?: string[];
+  static names(): { [key: string]: string } {
+    return {
+      requiredAnyOf: 'requiredAnyOf',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      requiredAnyOf: { 'type': 'array', 'itemType': 'string' },
+    };
+  }
+
+  validate() {
+    if(Array.isArray(this.requiredAnyOf)) {
+      $dara.Model.validateArray(this.requiredAnyOf);
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class UpdateContextStoreRequestConfigSourceDatasetCustomFields extends $dara.Model {
+  /**
+   * @remarks
+   * The description of the field. This parameter is required when usage is set to extraction-input.
+   * 
+   * @example
+   * Customer tier
+   */
+  description?: string;
+  /**
+   * @remarks
+   * Specifies whether the field is sensitive.
+   * 
+   * @example
+   * false
+   */
+  sensitive?: boolean;
+  /**
+   * @remarks
+   * The name of the source field.
+   * 
+   * @example
+   * customerTier
+   */
+  sourceField?: string;
+  /**
+   * @remarks
+   * The target path for writing, such as metadata.customerTier.
+   * 
+   * @example
+   * metadata.customerTier
+   */
+  target?: string;
+  /**
+   * @remarks
+   * The usage of the field. Valid values: extraction-input (participates in extraction) and ignore (ignored).
+   * 
+   * @example
+   * extraction-input
+   */
+  usage?: string;
+  static names(): { [key: string]: string } {
+    return {
+      description: 'description',
+      sensitive: 'sensitive',
+      sourceField: 'sourceField',
+      target: 'target',
+      usage: 'usage',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      description: 'string',
+      sensitive: 'boolean',
+      sourceField: 'string',
+      target: 'string',
+      usage: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class UpdateContextStoreRequestConfigSourceDatasetFilter extends $dara.Model {
+  /**
+   * @remarks
+   * The subset of the Pipeline where clause, which is pushed down to SQL.
+   * 
+   * @example
+   * appId = \\"crm-service\\"
+   */
+  where?: string;
+  static names(): { [key: string]: string } {
+    return {
+      where: 'where',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      where: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class UpdateContextStoreRequestConfigSourceDataset extends $dara.Model {
+  /**
+   * @remarks
+   * The list of custom field declarations. If specified, the entire list is overwritten.
+   */
+  customFields?: UpdateContextStoreRequestConfigSourceDatasetCustomFields[];
+  /**
+   * @remarks
+   * The row filter conditions.
+   */
+  filter?: UpdateContextStoreRequestConfigSourceDatasetFilter;
+  /**
+   * @remarks
+   * The polling interval in seconds. Valid values: 60 to 3600.
+   * 
+   * @example
+   * 300
+   */
+  pollIntervalSeconds?: number;
+  static names(): { [key: string]: string } {
+    return {
+      customFields: 'customFields',
+      filter: 'filter',
+      pollIntervalSeconds: 'pollIntervalSeconds',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      customFields: { 'type': 'array', 'itemType': UpdateContextStoreRequestConfigSourceDatasetCustomFields },
+      filter: UpdateContextStoreRequestConfigSourceDatasetFilter,
+      pollIntervalSeconds: 'number',
+    };
+  }
+
+  validate() {
+    if(Array.isArray(this.customFields)) {
+      $dara.Model.validateArray(this.customFields);
+    }
+    if(this.filter && typeof (this.filter as any).validate === 'function') {
+      (this.filter as any).validate();
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class UpdateContextStoreRequestConfigSourceTrajectoryFilter extends $dara.Model {
+  /**
+   * @remarks
+   * The list of agent names. An explicitly empty list returns a 400 error.
+   * 
+   * @example
+   * ["sales-copilot"]
+   */
+  agentNames?: string[];
+  /**
+   * @remarks
+   * Specifies whether to exclude degraded trajectories. Default value: false (degraded trajectories are included).
+   * 
+   * @example
+   * false
+   */
+  excludeDegraded?: boolean;
+  /**
+   * @remarks
+   * The minimum number of steps. The value must be greater than or equal to 0.
+   * 
+   * @example
+   * 2
+   */
+  minStepCount?: number;
+  /**
+   * @remarks
+   * The native Simple Log Service (SLS) query statement, which is ANDed with the preceding conditions.
+   * 
+   * @example
+   * tool_names:"search_order"
+   */
+  query?: string;
+  /**
+   * @remarks
+   * The list of service names. A single trailing asterisk (*) is supported. An explicitly empty list returns a 400 error.
+   * 
+   * @example
+   * ["crm-service","app-*"]
+   */
+  serviceNames?: string[];
+  static names(): { [key: string]: string } {
+    return {
+      agentNames: 'agentNames',
+      excludeDegraded: 'excludeDegraded',
+      minStepCount: 'minStepCount',
+      query: 'query',
+      serviceNames: 'serviceNames',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      agentNames: { 'type': 'array', 'itemType': 'string' },
+      excludeDegraded: 'boolean',
+      minStepCount: 'number',
+      query: 'string',
+      serviceNames: { 'type': 'array', 'itemType': 'string' },
+    };
+  }
+
+  validate() {
+    if(Array.isArray(this.agentNames)) {
+      $dara.Model.validateArray(this.agentNames);
+    }
+    if(Array.isArray(this.serviceNames)) {
+      $dara.Model.validateArray(this.serviceNames);
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class UpdateContextStoreRequestConfigSourceTrajectoryScopeMapping extends $dara.Model {
+  /**
+   * @remarks
+   * The JSONPath expression for agentId. Default value: $.agent_name.
+   * 
+   * @example
+   * $.agent_name
+   */
+  agentId?: string;
+  /**
+   * @remarks
+   * The JSONPath expression for appId. Default value: $.service_names[0].
+   * 
+   * @example
+   * $.service_names[0]
+   */
+  appId?: string;
+  /**
+   * @remarks
+   * The JSONPath expression for runId. Default value: $.trajectory_id.
+   * 
+   * @example
+   * $.trajectory_id
+   */
+  runId?: string;
+  /**
+   * @remarks
+   * The JSONPath expression for userId. By default, this field is not mapped.
+   * 
+   * @example
+   * $.trajectory_extensions.user_id
+   */
+  userId?: string;
+  static names(): { [key: string]: string } {
+    return {
+      agentId: 'agentId',
+      appId: 'appId',
+      runId: 'runId',
+      userId: 'userId',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      agentId: 'string',
+      appId: 'string',
+      runId: 'string',
+      userId: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class UpdateContextStoreRequestConfigSourceTrajectory extends $dara.Model {
+  /**
+   * @remarks
+   * The trajectory filter conditions. Conditions are combined with AND, and elements within a list are combined with OR.
+   */
+  filter?: UpdateContextStoreRequestConfigSourceTrajectoryFilter;
+  /**
+   * @remarks
+   * The name of the trajectory Logstore. Default value: agent-trajectory. This parameter cannot be modified after creation.
+   * 
+   * @example
+   * agent-trajectory
+   */
+  logstore?: string;
+  /**
+   * @remarks
+   * The polling interval in seconds. Valid values: 60 to 3600.
+   * 
+   * @example
+   * 300
+   */
+  pollIntervalSeconds?: number;
+  /**
+   * @remarks
+   * The scope field mapping. The value is a JSONPath expression. Only the $.a.b and $.a[0] formats are supported.
+   */
+  scopeMapping?: UpdateContextStoreRequestConfigSourceTrajectoryScopeMapping;
+  static names(): { [key: string]: string } {
+    return {
+      filter: 'filter',
+      logstore: 'logstore',
+      pollIntervalSeconds: 'pollIntervalSeconds',
+      scopeMapping: 'scopeMapping',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      filter: UpdateContextStoreRequestConfigSourceTrajectoryFilter,
+      logstore: 'string',
+      pollIntervalSeconds: 'number',
+      scopeMapping: UpdateContextStoreRequestConfigSourceTrajectoryScopeMapping,
+    };
+  }
+
+  validate() {
+    if(this.filter && typeof (this.filter as any).validate === 'function') {
+      (this.filter as any).validate();
+    }
+    if(this.scopeMapping && typeof (this.scopeMapping as any).validate === 'function') {
+      (this.scopeMapping as any).validate();
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
 export class UpdateContextStoreRequestConfigSource extends $dara.Model {
   /**
    * @remarks
-   * The AgentSpace where the trace data source resides. Cross-AgentSpace access is not supported. If specified, the value must be the same as the path AgentSpace. Otherwise, a 400 parameter error is returned. The AgentSpace cannot be changed after creation.
+   * The AgentSpace where the trace data source is located. Cross-AgentSpace is not supported in the current phase. If specified, it must be equal to the path AgentSpace; otherwise, a 400 parameter error is returned. The AgentSpace cannot be changed after creation.
    * 
    * @example
    * my-agent-space
@@ -13,27 +548,140 @@ export class UpdateContextStoreRequestConfigSource extends $dara.Model {
   agentSpace?: string;
   /**
    * @remarks
-   * The start time for data backfill, in ISO 8601 UTC format.
+   * The updatable items for the Dataset data source. The datasetName cannot be changed after creation.
+   */
+  dataset?: UpdateContextStoreRequestConfigSourceDataset;
+  /**
+   * @remarks
+   * The start time for data backfill in ISO 8601 UTC format.
    * 
    * @example
    * 2026-01-01T00:00:00Z
    */
   startTime?: string;
+  /**
+   * @remarks
+   * The updatable items for the trajectory data source. The source.type cannot be changed after creation.
+   */
+  trajectory?: UpdateContextStoreRequestConfigSourceTrajectory;
   static names(): { [key: string]: string } {
     return {
       agentSpace: 'agentSpace',
+      dataset: 'dataset',
       startTime: 'startTime',
+      trajectory: 'trajectory',
     };
   }
 
   static types(): { [key: string]: any } {
     return {
       agentSpace: 'string',
+      dataset: UpdateContextStoreRequestConfigSourceDataset,
       startTime: 'string',
+      trajectory: UpdateContextStoreRequestConfigSourceTrajectory,
     };
   }
 
   validate() {
+    if(this.dataset && typeof (this.dataset as any).validate === 'function') {
+      (this.dataset as any).validate();
+    }
+    if(this.trajectory && typeof (this.trajectory as any).validate === 'function') {
+      (this.trajectory as any).validate();
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class UpdateContextStoreRequestConfigStoragePolicy extends $dara.Model {
+  /**
+   * @remarks
+   * The allowed storage actions. Default value: all actions, including ADD, UPDATE, MERGE, and DELETE.
+   * 
+   * @example
+   * ["ADD","UPDATE","MERGE","DELETE"]
+   */
+  allowedActions?: string[];
+  /**
+   * @remarks
+   * Specifies whether to enable deduplication in event mode. Default value: true.
+   * 
+   * @example
+   * true
+   */
+  dedupe?: boolean;
+  /**
+   * @remarks
+   * Specifies whether to enable manual edit protection. Default value: true. When enabled, automatic extraction does not overwrite manually modified memories.
+   * 
+   * @example
+   * true
+   */
+  humanEditProtection?: boolean;
+  /**
+   * @remarks
+   * The merge key for upsert operations. Valid values: factKey, semantic, and both. Default value: semantic.
+   * 
+   * @example
+   * semantic
+   */
+  mergeKey?: string;
+  /**
+   * @remarks
+   * The storage mode. Valid values: event (event append) and upsert (merge update). Default value: upsert.
+   * 
+   * @example
+   * upsert
+   */
+  mode?: string;
+  /**
+   * @remarks
+   * The similarity threshold for semantic merging. Valid values: 0 to 1. Default value: 0.4.
+   * 
+   * @example
+   * 0.4
+   */
+  similarityThreshold?: number;
+  /**
+   * @remarks
+   * The number of days before a memory expires. A value of 0 indicates that the memory never expires.
+   * 
+   * @example
+   * 0
+   */
+  ttlDays?: number;
+  static names(): { [key: string]: string } {
+    return {
+      allowedActions: 'allowedActions',
+      dedupe: 'dedupe',
+      humanEditProtection: 'humanEditProtection',
+      mergeKey: 'mergeKey',
+      mode: 'mode',
+      similarityThreshold: 'similarityThreshold',
+      ttlDays: 'ttlDays',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      allowedActions: { 'type': 'array', 'itemType': 'string' },
+      dedupe: 'boolean',
+      humanEditProtection: 'boolean',
+      mergeKey: 'string',
+      mode: 'string',
+      similarityThreshold: 'number',
+      ttlDays: 'number',
+    };
+  }
+
+  validate() {
+    if(Array.isArray(this.allowedActions)) {
+      $dara.Model.validateArray(this.allowedActions);
+    }
     super.validate();
   }
 
@@ -43,6 +691,16 @@ export class UpdateContextStoreRequestConfigSource extends $dara.Model {
 }
 
 export class UpdateContextStoreRequestConfig extends $dara.Model {
+  /**
+   * @remarks
+   * The audit configuration.
+   */
+  audit?: UpdateContextStoreRequestConfigAudit;
+  /**
+   * @remarks
+   * The extraction policy for the memory type.
+   */
+  extractionPolicy?: UpdateContextStoreRequestConfigExtractionPolicy;
   /**
    * @remarks
    * The metadata field mapping. The key is the business field and the value is the storage field.
@@ -53,30 +711,60 @@ export class UpdateContextStoreRequestConfig extends $dara.Model {
   metadataField?: { [key: string]: string };
   /**
    * @remarks
-   * The datasource config, which serves only as the root identifier of the data source.
+   * The scope constraint policy.
+   */
+  scopePolicy?: UpdateContextStoreRequestConfigScopePolicy;
+  /**
+   * @remarks
+   * The datasource config, which serves only as the root identity for the data source.
    */
   source?: UpdateContextStoreRequestConfigSource;
+  /**
+   * @remarks
+   * The storage policy for the memory type.
+   */
+  storagePolicy?: UpdateContextStoreRequestConfigStoragePolicy;
   static names(): { [key: string]: string } {
     return {
+      audit: 'audit',
+      extractionPolicy: 'extractionPolicy',
       metadataField: 'metadataField',
+      scopePolicy: 'scopePolicy',
       source: 'source',
+      storagePolicy: 'storagePolicy',
     };
   }
 
   static types(): { [key: string]: any } {
     return {
+      audit: UpdateContextStoreRequestConfigAudit,
+      extractionPolicy: UpdateContextStoreRequestConfigExtractionPolicy,
       metadataField: { 'type': 'map', 'keyType': 'string', 'valueType': 'string' },
+      scopePolicy: UpdateContextStoreRequestConfigScopePolicy,
       source: UpdateContextStoreRequestConfigSource,
+      storagePolicy: UpdateContextStoreRequestConfigStoragePolicy,
     };
   }
 
   validate() {
+    if(this.audit && typeof (this.audit as any).validate === 'function') {
+      (this.audit as any).validate();
+    }
+    if(this.extractionPolicy && typeof (this.extractionPolicy as any).validate === 'function') {
+      (this.extractionPolicy as any).validate();
+    }
     if(this.metadataField) {
       $dara.Model.validateMap(this.metadataField);
     }
+    if(this.scopePolicy && typeof (this.scopePolicy as any).validate === 'function') {
+      (this.scopePolicy as any).validate();
+    }
     if(this.source && typeof (this.source as any).validate === 'function') {
       (this.source as any).validate();
     }
+    if(this.storagePolicy && typeof (this.storagePolicy as any).validate === 'function') {
+      (this.storagePolicy as any).validate();
+    }
     super.validate();
   }
 
@@ -88,12 +776,20 @@ export class UpdateContextStoreRequestConfig extends $dara.Model {
 export class UpdateContextStoreRequest extends $dara.Model {
   /**
    * @remarks
-   * The context store configuration. If specified, the entire configuration is overwritten. If not specified, the existing configuration is retained.
+   * The description of the policy change. A new policy version is written when policy fields in the configuration change.
+   * 
+   * @example
+   * Relax similarity threshold
+   */
+  changeNote?: string;
+  /**
+   * @remarks
+   * The context library configuration. If specified, the entire configuration is overwritten. If not specified, the original configuration is retained.
    */
   config?: UpdateContextStoreRequestConfig;
   /**
    * @remarks
-   * The type of the context store. This value typically cannot be changed after creation. This field is provided only for exception correction.
+   * The context library type. This field is typically immutable after creation and is provided only for exception correction.
    * 
    * @example
    * experience
@@ -101,20 +797,23 @@ export class UpdateContextStoreRequest extends $dara.Model {
   contextType?: string;
   /**
    * @remarks
-   * The description of the context store, which helps business users understand its purpose.
+   * The description of the context library, which helps business users understand its purpose.
    * 
    * @example
-   * 我的上下文库
+   * My context library
    */
   description?: string;
   /**
+   * @remarks
+   * The running status. Valid values: Active and Paused. For the memory type, pausing stops data source reading and extraction. For the experience Dataset follow type, pausing retains submitted and in-flight checkpoints, and resuming continues processing new records without skipping history from the current time. If you update only the status, you do not need to pass back the source.
+   * 
    * @example
-   * Paused
+   * Active
    */
   status?: string;
   /**
    * @remarks
-   * The idempotency token. A unique string generated by the client to ensure that the update operation is idempotent.
+   * The idempotency token. It is a unique string generated by the client to ensure the idempotence of the update operation.
    * 
    * @example
    * a1b2c3d4-1234-5678-90ab-cdef12345678
@@ -122,6 +821,7 @@ export class UpdateContextStoreRequest extends $dara.Model {
   clientToken?: string;
   static names(): { [key: string]: string } {
     return {
+      changeNote: 'changeNote',
       config: 'config',
       contextType: 'contextType',
       description: 'description',
@@ -132,6 +832,7 @@ export class UpdateContextStoreRequest extends $dara.Model {
 
   static types(): { [key: string]: any } {
     return {
+      changeNote: 'string',
       config: UpdateContextStoreRequestConfig,
       contextType: 'string',
       description: 'string',