@microsoft/agents-hosting-storage-cosmos 1.3.0-beta.14.gf38b0646bb → 1.3.0-beta.21.g7644db8206

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/dist/src/errorHelper.js +20 -20
  2. package/dist/src/errorHelper.js.map +1 -1
  3. package/package.json +2 -2
  4. package/src/errorHelper.ts +20 -20
package/dist/src/errorHelper.js CHANGED
@@ -24,140 +24,140 @@ exports.Errors = {
24
24
  */
25
25
  MissingCosmosDbStorageOptions: {
26
26
  code: -100000,
27
- description: 'CosmosDbPartitionedStorageOptions is required.'
27
+ description: 'CosmosDbPartitionedStorageOptions is required. Provide a valid configuration object with cosmosClientOptions, databaseId, and containerId properties when initializing CosmosDbPartitionedStorage.',
28
28
  },
29
29
  /**
30
30
  * Error thrown when endpoint in cosmosClientOptions is not provided.
31
31
  */
32
32
  MissingCosmosEndpoint: {
33
33
  code: -100001,
34
- description: 'endpoint in cosmosClientOptions is required.'
34
+ description: 'The endpoint property in cosmosClientOptions is required. Provide your Cosmos DB account endpoint URL (e.g., https://your-account.documents.azure.com:443/).',
35
35
  },
36
36
  /**
37
37
  * Error thrown when neither key nor tokenProvider is provided in cosmosClientOptions.
38
38
  */
39
39
  MissingCosmosCredentials: {
40
40
  code: -100002,
41
- description: 'key or tokenProvider in cosmosClientOptions is required.'
41
+ description: 'Authentication credentials are required in cosmosClientOptions. Provide either a key (connection key) or tokenProvider (for token-based authentication).',
42
42
  },
43
43
  /**
44
44
  * Error thrown when databaseId is not provided.
45
45
  */
46
46
  MissingDatabaseId: {
47
47
  code: -100003,
48
- description: 'databaseId for CosmosDB is required.'
48
+ description: 'The databaseId property is required in CosmosDbPartitionedStorageOptions. Specify the name of the Cosmos DB database to use for storage.',
49
49
  },
50
50
  /**
51
51
  * Error thrown when containerId is not provided.
52
52
  */
53
53
  MissingContainerId: {
54
54
  code: -100004,
55
- description: 'containerId for CosmosDB is required.'
55
+ description: 'The containerId property is required in CosmosDbPartitionedStorageOptions. Specify the name of the Cosmos DB container to use for storage.',
56
56
  },
57
57
  /**
58
58
  * Error thrown when compatibilityMode is enabled with a keySuffix.
59
59
  */
60
60
  InvalidCompatibilityModeWithKeySuffix: {
61
61
  code: -100005,
62
- description: 'compatibilityMode cannot be true while using a keySuffix.'
62
+ description: 'Configuration conflict: compatibilityMode cannot be enabled (true) when using a keySuffix. Either disable compatibilityMode or remove the keySuffix from your configuration.',
63
63
  },
64
64
  /**
65
65
  * Error thrown when keySuffix contains invalid Row Key characters.
66
66
  */
67
67
  InvalidKeySuffixCharacters: {
68
68
  code: -100006,
69
- description: 'Cannot use invalid Row Key characters: {keySuffix} in keySuffix'
69
+ description: 'The keySuffix "{keySuffix}" contains invalid characters. Keys cannot contain: \\, ?, /, #, tab, newline, carriage return, or *. Please remove these characters from your keySuffix configuration.',
70
70
  },
71
71
  /**
72
72
  * Error thrown when keys are not provided for reading.
73
73
  */
74
74
  MissingReadKeys: {
75
75
  code: -100007,
76
- description: 'Keys are required when reading.'
76
+ description: 'The keys parameter is required when calling read(). Provide an array of storage keys to read.',
77
77
  },
78
78
  /**
79
79
  * Error thrown when changes are not provided for writing.
80
80
  */
81
81
  MissingWriteChanges: {
82
82
  code: -100008,
83
- description: 'Changes are required when writing.'
83
+ description: 'The changes parameter is required when calling write(). Provide a StoreItems object containing the data to write.',
84
84
  },
85
85
  /**
86
86
  * Error thrown when attempting to use a custom partition key path.
87
87
  */
88
88
  UnsupportedCustomPartitionKeyPath: {
89
89
  code: -100009,
90
- description: 'Custom Partition Key Paths are not supported. {containerId} has a custom Partition Key Path of {partitionKeyPath}.'
90
+ description: 'The container "{containerId}" uses a custom partition key path "{partitionKeyPath}", which is not supported. This storage implementation requires containers to use either "/id" as the partition key path or no partition key (for compatibility mode). Create a new container with the correct partition key configuration.',
91
91
  },
92
92
  /**
93
93
  * Error thrown when the specified container is not found.
94
94
  */
95
95
  ContainerNotFound: {
96
96
  code: -100010,
97
- description: 'Container {containerId} not found.'
97
+ description: 'The Cosmos DB container "{containerId}" was not found and could not be created. Verify the container exists or ensure the client has permissions to create it. If using compatibilityMode, the container must already exist.',
98
98
  },
99
99
  /**
100
100
  * Error thrown when the key parameter is missing in CosmosDbKeyEscape.
101
101
  */
102
102
  MissingKeyParameter: {
103
103
  code: -100011,
104
- description: "The 'key' parameter is required.",
104
+ description: 'The key parameter is required and cannot be null or empty. Provide a valid storage key string.',
105
105
  },
106
106
  /**
107
107
  * Error thrown when there is an error reading from the container (404 Not Found).
108
108
  */
109
109
  ContainerReadNotFound: {
110
110
  code: -100012,
111
- description: 'Not Found'
111
+ description: 'The requested item was not found in the Cosmos DB container. This is typically not an error during read operations.',
112
112
  },
113
113
  /**
114
114
  * Error thrown when there is an error reading from container (400 Bad Request).
115
115
  */
116
116
  ContainerReadBadRequest: {
117
117
  code: -100013,
118
- description: 'Error reading from container. You might be attempting to read from a non-partitioned container or a container that does not use \'/id\' as the partitionKeyPath'
118
+ description: 'Bad request error while reading from the Cosmos DB container. This usually indicates a configuration mismatch: the container may be non-partitioned or uses a partition key path other than "/id". Verify your container\'s partition key configuration matches the storage implementation requirements.',
119
119
  },
120
120
  /**
121
121
  * Error thrown when there is a general error reading from the container.
122
122
  */
123
123
  ContainerReadError: {
124
124
  code: -100014,
125
- description: 'Error reading from container'
125
+ description: 'An unexpected error occurred while reading from the Cosmos DB container. Check the inner exception for details about the specific error.',
126
126
  },
127
127
  /**
128
128
  * Error thrown when there is an error upserting a document.
129
129
  */
130
130
  DocumentUpsertError: {
131
131
  code: -100015,
132
- description: 'Error upserting document'
132
+ description: 'Failed to upsert (insert or update) a document in the Cosmos DB container. This may be due to concurrency conflicts, permission issues, or data size limits. Check the inner exception for specific details.',
133
133
  },
134
134
  /**
135
135
  * Error thrown when there is an error deleting a document (404 Not Found).
136
136
  */
137
137
  DocumentDeleteNotFound: {
138
138
  code: -100016,
139
- description: 'Not Found'
139
+ description: 'The document to delete was not found in the Cosmos DB container. This is typically not an error during delete operations.',
140
140
  },
141
141
  /**
142
142
  * Error thrown when unable to delete a document.
143
143
  */
144
144
  DocumentDeleteError: {
145
145
  code: -100017,
146
- description: 'Unable to delete document'
146
+ description: 'Failed to delete a document from the Cosmos DB container. This may be due to permission issues or network problems. Check the inner exception for specific details.',
147
147
  },
148
148
  /**
149
149
  * Error thrown when failing to initialize CosmosDB database/container.
150
150
  */
151
151
  InitializationError: {
152
152
  code: -100018,
153
- description: 'Failed to initialize Cosmos DB database/container: {databaseId}/{containerId}'
153
+ description: 'Failed to initialize the Cosmos DB database "{databaseId}" and container "{containerId}". Verify your connection credentials, ensure the account exists, and check that the client has appropriate permissions. See the inner exception for specific error details.',
154
154
  },
155
155
  /**
156
156
  * Error thrown when maximum nesting depth is exceeded.
157
157
  */
158
158
  MaxNestingDepthExceeded: {
159
159
  code: -100019,
160
- description: 'Maximum nesting depth of {maxDepth} exceeded. {additionalMessage}'
160
+ description: 'The data structure exceeds the maximum nesting depth of {maxDepth} levels. {additionalMessage} This limit is imposed to prevent stack overflow errors when storing deeply nested objects in Cosmos DB.',
161
161
  }
162
162
  };
163
163
  //# sourceMappingURL=errorHelper.js.map
package/dist/src/errorHelper.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"errorHelper.js","sourceRoot":"","sources":["../../src/errorHelper.ts"],"names":[],"mappings":";AAAA,4DAA4D;AAC5D,kCAAkC;;;AAIlC;;;;;;;;;;;;;;GAcG;AACU,QAAA,MAAM,GAA4C;IAC7D;;OAEG;IACH,6BAA6B,EAAE;QAC7B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,gDAAgD;KAC9D;IAED;;OAEG;IACH,qBAAqB,EAAE;QACrB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,8CAA8C;KAC5D;IAED;;OAEG;IACH,wBAAwB,EAAE;QACxB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,0DAA0D;KACxE;IAED;;OAEG;IACH,iBAAiB,EAAE;QACjB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,sCAAsC;KACpD;IAED;;OAEG;IACH,kBAAkB,EAAE;QAClB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,uCAAuC;KACrD;IAED;;OAEG;IACH,qCAAqC,EAAE;QACrC,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,2DAA2D;KACzE;IAED;;OAEG;IACH,0BAA0B,EAAE;QAC1B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,iEAAiE;KAC/E;IAED;;OAEG;IACH,eAAe,EAAE;QACf,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,iCAAiC;KAC/C;IAED;;OAEG;IACH,mBAAmB,EAAE;QACnB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,oCAAoC;KAClD;IAED;;OAEG;IACH,iCAAiC,EAAE;QACjC,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,oHAAoH;KAClI;IAED;;OAEG;IACH,iBAAiB,EAAE;QACjB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,oCAAoC;KAClD;IAED;;OAEG;IACH,mBAAmB,EAAE;QACnB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,kCAAkC;KAChD;IAED;;OAEG;IACH,qBAAqB,EAAE;QACrB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,WAAW;KACzB;IAED;;OAEG;IACH,uBAAuB,EAAE;QACvB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,iKAAiK;KAC/K;IAED;;OAEG;IACH,kBAAkB,EAAE;QAClB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,8BAA8B;KAC5C;IAED;;OAEG;IACH,mBAAmB,EAAE;QACnB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,0BAA0B;KACxC;IAED;;OAEG;IACH,sBAAsB,EAAE;QACtB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,WAAW;KACzB;IAED;;OAEG;IACH,mBAAmB,EAAE;QACnB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,2BAA2B;KACzC;IAED;;OAEG;IACH,mBAAmB,EAAE;QACnB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,+EAA+E;KAC7F;IAED;;OAEG;IACH,uBAAuB,EAAE;QACvB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,mEAAmE;KACjF;CACF,CAAA"}
1
+ {"version":3,"file":"errorHelper.js","sourceRoot":"","sources":["../../src/errorHelper.ts"],"names":[],"mappings":";AAAA,4DAA4D;AAC5D,kCAAkC;;;AAIlC;;;;;;;;;;;;;;GAcG;AACU,QAAA,MAAM,GAA4C;IAC7D;;OAEG;IACH,6BAA6B,EAAE;QAC7B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,oMAAoM;KAClN;IAED;;OAEG;IACH,qBAAqB,EAAE;QACrB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,8JAA8J;KAC5K;IAED;;OAEG;IACH,wBAAwB,EAAE;QACxB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,0JAA0J;KACxK;IAED;;OAEG;IACH,iBAAiB,EAAE;QACjB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,0IAA0I;KACxJ;IAED;;OAEG;IACH,kBAAkB,EAAE;QAClB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,4IAA4I;KAC1J;IAED;;OAEG;IACH,qCAAqC,EAAE;QACrC,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,8KAA8K;KAC5L;IAED;;OAEG;IACH,0BAA0B,EAAE;QAC1B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,mMAAmM;KACjN;IAED;;OAEG;IACH,eAAe,EAAE;QACf,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,+FAA+F;KAC7G;IAED;;OAEG;IACH,mBAAmB,EAAE;QACnB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,mHAAmH;KACjI;IAED;;OAEG;IACH,iCAAiC,EAAE;QACjC,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,+TAA+T;KAC7U;IAED;;OAEG;IACH,iBAAiB,EAAE;QACjB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,8NAA8N;KAC5O;IAED;;OAEG;IACH,mBAAmB,EAAE;QACnB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,gGAAgG;KAC9G;IAED;;OAEG;IACH,qBAAqB,EAAE;QACrB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,qHAAqH;KACnI;IAED;;OAEG;IACH,uBAAuB,EAAE;QACvB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,0SAA0S;KACxT;IAED;;OAEG;IACH,kBAAkB,EAAE;QAClB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,0IAA0I;KACxJ;IAED;;OAEG;IACH,mBAAmB,EAAE;QACnB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,8MAA8M;KAC5N;IAED;;OAEG;IACH,sBAAsB,EAAE;QACtB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,2HAA2H;KACzI;IAED;;OAEG;IACH,mBAAmB,EAAE;QACnB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,qKAAqK;KACnL;IAED;;OAEG;IACH,mBAAmB,EAAE;QACnB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,qQAAqQ;KACnR;IAED;;OAEG;IACH,uBAAuB,EAAE;QACvB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,wMAAwM;KACtN;CACF,CAAA"}
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/package.json",
3
3
  "name": "@microsoft/agents-hosting-storage-cosmos",
4
- "version": "1.3.0-beta.14.gf38b0646bb",
4
+ "version": "1.3.0-beta.21.g7644db8206",
5
5
  "homepage": "https://github.com/microsoft/Agents-for-js",
6
6
  "repository": {
7
7
  "type": "git",
@@ -17,7 +17,7 @@
17
17
  "types": "dist/src/index.d.ts",
18
18
  "dependencies": {
19
19
  "@azure/cosmos": "^4.9.0",
20
- "@microsoft/agents-hosting": "1.3.0-beta.14.gf38b0646bb"
20
+ "@microsoft/agents-hosting": "1.3.0-beta.21.g7644db8206"
21
21
  },
22
22
  "license": "MIT",
23
23
  "files": [
package/src/errorHelper.ts CHANGED
@@ -24,7 +24,7 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
24
24
  */
25
25
  MissingCosmosDbStorageOptions: {
26
26
  code: -100000,
27
- description: 'CosmosDbPartitionedStorageOptions is required.'
27
+ description: 'CosmosDbPartitionedStorageOptions is required. Provide a valid configuration object with cosmosClientOptions, databaseId, and containerId properties when initializing CosmosDbPartitionedStorage.',
28
28
  },
29
29
 
30
30
  /**
@@ -32,7 +32,7 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
32
32
  */
33
33
  MissingCosmosEndpoint: {
34
34
  code: -100001,
35
- description: 'endpoint in cosmosClientOptions is required.'
35
+ description: 'The endpoint property in cosmosClientOptions is required. Provide your Cosmos DB account endpoint URL (e.g., https://your-account.documents.azure.com:443/).',
36
36
  },
37
37
 
38
38
  /**
@@ -40,7 +40,7 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
40
40
  */
41
41
  MissingCosmosCredentials: {
42
42
  code: -100002,
43
- description: 'key or tokenProvider in cosmosClientOptions is required.'
43
+ description: 'Authentication credentials are required in cosmosClientOptions. Provide either a key (connection key) or tokenProvider (for token-based authentication).',
44
44
  },
45
45
 
46
46
  /**
@@ -48,7 +48,7 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
48
48
  */
49
49
  MissingDatabaseId: {
50
50
  code: -100003,
51
- description: 'databaseId for CosmosDB is required.'
51
+ description: 'The databaseId property is required in CosmosDbPartitionedStorageOptions. Specify the name of the Cosmos DB database to use for storage.',
52
52
  },
53
53
 
54
54
  /**
@@ -56,7 +56,7 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
56
56
  */
57
57
  MissingContainerId: {
58
58
  code: -100004,
59
- description: 'containerId for CosmosDB is required.'
59
+ description: 'The containerId property is required in CosmosDbPartitionedStorageOptions. Specify the name of the Cosmos DB container to use for storage.',
60
60
  },
61
61
 
62
62
  /**
@@ -64,7 +64,7 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
64
64
  */
65
65
  InvalidCompatibilityModeWithKeySuffix: {
66
66
  code: -100005,
67
- description: 'compatibilityMode cannot be true while using a keySuffix.'
67
+ description: 'Configuration conflict: compatibilityMode cannot be enabled (true) when using a keySuffix. Either disable compatibilityMode or remove the keySuffix from your configuration.',
68
68
  },
69
69
 
70
70
  /**
@@ -72,7 +72,7 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
72
72
  */
73
73
  InvalidKeySuffixCharacters: {
74
74
  code: -100006,
75
- description: 'Cannot use invalid Row Key characters: {keySuffix} in keySuffix'
75
+ description: 'The keySuffix "{keySuffix}" contains invalid characters. Keys cannot contain: \\, ?, /, #, tab, newline, carriage return, or *. Please remove these characters from your keySuffix configuration.',
76
76
  },
77
77
 
78
78
  /**
@@ -80,7 +80,7 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
80
80
  */
81
81
  MissingReadKeys: {
82
82
  code: -100007,
83
- description: 'Keys are required when reading.'
83
+ description: 'The keys parameter is required when calling read(). Provide an array of storage keys to read.',
84
84
  },
85
85
 
86
86
  /**
@@ -88,7 +88,7 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
88
88
  */
89
89
  MissingWriteChanges: {
90
90
  code: -100008,
91
- description: 'Changes are required when writing.'
91
+ description: 'The changes parameter is required when calling write(). Provide a StoreItems object containing the data to write.',
92
92
  },
93
93
 
94
94
  /**
@@ -96,7 +96,7 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
96
96
  */
97
97
  UnsupportedCustomPartitionKeyPath: {
98
98
  code: -100009,
99
- description: 'Custom Partition Key Paths are not supported. {containerId} has a custom Partition Key Path of {partitionKeyPath}.'
99
+ description: 'The container "{containerId}" uses a custom partition key path "{partitionKeyPath}", which is not supported. This storage implementation requires containers to use either "/id" as the partition key path or no partition key (for compatibility mode). Create a new container with the correct partition key configuration.',
100
100
  },
101
101
 
102
102
  /**
@@ -104,7 +104,7 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
104
104
  */
105
105
  ContainerNotFound: {
106
106
  code: -100010,
107
- description: 'Container {containerId} not found.'
107
+ description: 'The Cosmos DB container "{containerId}" was not found and could not be created. Verify the container exists or ensure the client has permissions to create it. If using compatibilityMode, the container must already exist.',
108
108
  },
109
109
 
110
110
  /**
@@ -112,7 +112,7 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
112
112
  */
113
113
  MissingKeyParameter: {
114
114
  code: -100011,
115
- description: "The 'key' parameter is required.",
115
+ description: 'The key parameter is required and cannot be null or empty. Provide a valid storage key string.',
116
116
  },
117
117
 
118
118
  /**
@@ -120,7 +120,7 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
120
120
  */
121
121
  ContainerReadNotFound: {
122
122
  code: -100012,
123
- description: 'Not Found'
123
+ description: 'The requested item was not found in the Cosmos DB container. This is typically not an error during read operations.',
124
124
  },
125
125
 
126
126
  /**
@@ -128,7 +128,7 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
128
128
  */
129
129
  ContainerReadBadRequest: {
130
130
  code: -100013,
131
- description: 'Error reading from container. You might be attempting to read from a non-partitioned container or a container that does not use \'/id\' as the partitionKeyPath'
131
+ description: 'Bad request error while reading from the Cosmos DB container. This usually indicates a configuration mismatch: the container may be non-partitioned or uses a partition key path other than "/id". Verify your container\'s partition key configuration matches the storage implementation requirements.',
132
132
  },
133
133
 
134
134
  /**
@@ -136,7 +136,7 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
136
136
  */
137
137
  ContainerReadError: {
138
138
  code: -100014,
139
- description: 'Error reading from container'
139
+ description: 'An unexpected error occurred while reading from the Cosmos DB container. Check the inner exception for details about the specific error.',
140
140
  },
141
141
 
142
142
  /**
@@ -144,7 +144,7 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
144
144
  */
145
145
  DocumentUpsertError: {
146
146
  code: -100015,
147
- description: 'Error upserting document'
147
+ description: 'Failed to upsert (insert or update) a document in the Cosmos DB container. This may be due to concurrency conflicts, permission issues, or data size limits. Check the inner exception for specific details.',
148
148
  },
149
149
 
150
150
  /**
@@ -152,7 +152,7 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
152
152
  */
153
153
  DocumentDeleteNotFound: {
154
154
  code: -100016,
155
- description: 'Not Found'
155
+ description: 'The document to delete was not found in the Cosmos DB container. This is typically not an error during delete operations.',
156
156
  },
157
157
 
158
158
  /**
@@ -160,7 +160,7 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
160
160
  */
161
161
  DocumentDeleteError: {
162
162
  code: -100017,
163
- description: 'Unable to delete document'
163
+ description: 'Failed to delete a document from the Cosmos DB container. This may be due to permission issues or network problems. Check the inner exception for specific details.',
164
164
  },
165
165
 
166
166
  /**
@@ -168,7 +168,7 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
168
168
  */
169
169
  InitializationError: {
170
170
  code: -100018,
171
- description: 'Failed to initialize Cosmos DB database/container: {databaseId}/{containerId}'
171
+ description: 'Failed to initialize the Cosmos DB database "{databaseId}" and container "{containerId}". Verify your connection credentials, ensure the account exists, and check that the client has appropriate permissions. See the inner exception for specific error details.',
172
172
  },
173
173
 
174
174
  /**
@@ -176,6 +176,6 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
176
176
  */
177
177
  MaxNestingDepthExceeded: {
178
178
  code: -100019,
179
- description: 'Maximum nesting depth of {maxDepth} exceeded. {additionalMessage}'
179
+ description: 'The data structure exceeds the maximum nesting depth of {maxDepth} levels. {additionalMessage} This limit is imposed to prevent stack overflow errors when storing deeply nested objects in Cosmos DB.',
180
180
  }
181
181
  }