@alicloud/agentloop20260520 2.3.8 → 2.4.0

package/dist/models/UpdateContextStoreRequest.d.ts

@@ -1,8 +1,369 @@
 import * as $dara from '@darabonba/typescript';
+export declare 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;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare 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;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare 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;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare 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;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare 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;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare 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;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare 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;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare 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;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare 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;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare 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;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
 export declare 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
@@ -10,12 +371,90 @@ export declare 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;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare 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;
     };
@@ -28,6 +467,16 @@ export declare class UpdateContextStoreRequestConfigSource extends $dara.Model {
     });
 }
 export declare 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.
@@ -40,9 +489,19 @@ export declare class UpdateContextStoreRequestConfig extends $dara.Model {
     };
     /**
      * @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;
     };
@@ -57,12 +516,20 @@ export declare class UpdateContextStoreRequestConfig extends $dara.Model {
 export declare 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
@@ -70,20 +537,23 @@ export declare 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