@squidcloud/client 1.0.395 → 1.0.396

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 (42) hide show
  1. package/dist/cjs/index.js +1 -1
  2. package/dist/esm/index.js +1 -1
  3. package/dist/internal-common/src/metric-name.d.ts +9 -0
  4. package/dist/internal-common/src/public-types/ai-agent.public-types.d.ts +9 -1
  5. package/dist/internal-common/src/public-types/integration.public-types.d.ts +1 -1
  6. package/dist/internal-common/src/public-types-backend/api-call.public-context.d.ts +30 -0
  7. package/dist/internal-common/src/public-types-backend/mutation.public-context.d.ts +148 -0
  8. package/dist/internal-common/src/public-types-backend/native-query.public-context.d.ts +60 -0
  9. package/dist/internal-common/src/public-types-backend/query.public-context.d.ts +166 -0
  10. package/dist/internal-common/src/types/ai-agent.types.d.ts +159 -0
  11. package/dist/internal-common/src/types/ai-assistant.types.d.ts +1 -0
  12. package/dist/internal-common/src/types/ai-knowledge-base.types.d.ts +151 -0
  13. package/dist/internal-common/src/types/ai-matchmaking.types.d.ts +59 -0
  14. package/dist/internal-common/src/types/backend-function.types.d.ts +1 -0
  15. package/dist/internal-common/src/types/communication.types.d.ts +1 -0
  16. package/dist/internal-common/src/types/document.types.d.ts +1 -0
  17. package/dist/internal-common/src/types/file.types.d.ts +6 -0
  18. package/dist/internal-common/src/types/headers.types.d.ts +17 -0
  19. package/dist/internal-common/src/types/mutation.types.d.ts +1 -0
  20. package/dist/internal-common/src/types/notification.types.d.ts +5 -0
  21. package/dist/internal-common/src/types/observability.types.d.ts +78 -0
  22. package/dist/internal-common/src/types/query.types.d.ts +13 -0
  23. package/dist/internal-common/src/types/secret.types.d.ts +2 -0
  24. package/dist/internal-common/src/types/socket.types.d.ts +1 -0
  25. package/dist/internal-common/src/types/stage.d.ts +9 -0
  26. package/dist/internal-common/src/types/time-units.d.ts +1 -0
  27. package/dist/internal-common/src/types/url-shortener.types.d.ts +41 -0
  28. package/dist/internal-common/src/utils/array.d.ts +7 -0
  29. package/dist/internal-common/src/utils/e2e-test-utils.d.ts +2 -0
  30. package/dist/internal-common/src/utils/global.utils.d.ts +1 -0
  31. package/dist/internal-common/src/utils/http.d.ts +5 -0
  32. package/dist/internal-common/src/utils/lock.manager.d.ts +14 -0
  33. package/dist/internal-common/src/utils/metric-utils.d.ts +4 -0
  34. package/dist/internal-common/src/utils/metrics.types.d.ts +7 -0
  35. package/dist/internal-common/src/utils/object.d.ts +58 -0
  36. package/dist/internal-common/src/utils/serialization.d.ts +11 -0
  37. package/dist/internal-common/src/utils/squid.constants.d.ts +1 -0
  38. package/dist/internal-common/src/utils/trace-id-generator.d.ts +1 -0
  39. package/dist/internal-common/src/utils/validation.d.ts +19 -0
  40. package/dist/internal-common/src/websocket.impl.d.ts +26 -0
  41. package/dist/typescript-client/src/version.d.ts +1 -1
  42. package/package.json +1 -1
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Names of the Squid metrics.
3
+ * Should be in sync with MetricName.kt.
4
+ * See MetricName.kt for documentation on each value.
5
+ */
6
+ export declare const ALL_SQUID_METRIC_NAMES: readonly ["squid_functionExecution_count", "squid_functionExecution_time", "squid_aiChatbotContext_size", "squid_aiChatbotChatInputTokens_count", "squid_aiChatbotChatOutputTokens_count", "squid_aiChatbotChatOutcome_count", "squid_aiImageGeneration_count", "squid_aiImageGeneration_time", "squid_aiRemoveBackground_count", "squid_aiRemoveBackground_time", "squid_aiAudioTranscribe_count", "squid_aiAudioTranscribe_time", "squid_aiAudioCreateSpeech_count", "squid_aiAudioCreateSpeech_time", "squid_aiIntegrationData_count", "squid_aiIntegrationData_time", "squid_aiIntegrationApi_count", "squid_aiIntegrationApi_time", "squid_apiControllerCall_count", "squid_apiControllerCall_time", "squid_aiContextUpsert_count", "squid_aiContextDelete_count", "squid_built_in_db_size", "squid_codeInitialization_count", "squid_codeInitialization_time", "squid_deleteApiKey_count", "squid_deleteApiKey_time", "squid_deleteSecret_count", "squid_deleteSecret_time", "squid_discoverGraphQLConnectionSchema_count", "squid_discoverGraphQLConnectionSchema_time", "squid_discoverOpenApiSchema_count", "squid_discoverOpenApiSchema_time", "squid_discoverOpenApiSchemaFromFile_count", "squid_discoverOpenApiSchemaFromFile_time", "squid_executeBackendFunction_count", "squid_executeBackendFunction_time", "squid_getAiChatbotProfiles_count", "squid_getAiChatbotProfiles_time", "squid_getAllApiKeys_count", "squid_getAllApiKeys_time", "squid_getAllSecrets_count", "squid_getAllSecrets_time", "squid_getAppApiKey_count", "squid_getAppApiKey_time", "squid_getSecret_count", "squid_getSecret_time", "squid_graphql_count", "squid_graphql_time", "squid_graphqlQuery_count", "squid_graphqlQuery_time", "squid_integrationCount_value", "squid_acquireLock_count", "squid_releaseLock_count", "squid_mutate_count", "squid_mutate_time", "squid_metricQuery_count", "squid_metricQuery_time", "squid_metricReport_count", "squid_metricReport_time", "squid_nativeQuery_count", "squid_nativeQuery_time", "squid_openapi_count", "squid_openapi_time", "squid_produceTopicMessage_count", "squid_produceTopicMessage_time", "squid_query_count", "squid_query_time", "squid_registerQuery_count", "squid_registerQuery_time", "squid_rerankChunks_count", "squid_rerankChunks_time", "squid_schedulerJob_count", "squid_schedulerJob_time", "squid_schema_size", "squid_secrets_entries", "squid_storageDeleteFiles_count", "squid_storageDeleteFiles_time", "squid_storageGetDownloadUrl_count", "squid_storageGetDownloadUrl_time", "squid_storageGetFileMetadata_count", "squid_storageGetFileMetadata_time", "squid_storageListDirectoryContents_count", "squid_storageListDirectoryContents_time", "squid_storageUploadFile_count", "squid_storageUploadFile_time", "squid_subscribeToTopic_count", "squid_subscribeToTopic_time", "squid_testGraphQLConnection_count", "squid_testGraphQLConnection_time", "squid_testAgentProtocolConnection_count", "squid_testAgentProtocolConnection_time", "squid_trigger_count", "squid_trigger_time", "squid_upsertApiKey_count", "squid_upsertApiKey_time", "squid_upsertSecret_count", "squid_upsertSecret_time", "squid_vectorChunks_count", "squid_vectorChunks_time", "squid_webhook_count", "squid_webhook_time"];
7
+ export type MetricName = (typeof ALL_SQUID_METRIC_NAMES)[number];
8
+ /** Common prefix for all Squid metrics. */
9
+ export declare const SQUID_METRIC_NAME_PREFIX = "squid_";
@@ -250,7 +250,15 @@ export interface AiAgentMemoryOptions {
250
250
  * - 'read-write': The agent can both read from and write to memory.
251
251
  */
252
252
  memoryMode: 'none' | 'read-only' | 'read-write';
253
- /** A unique id for managing the memory */
253
+ /**
254
+ * A unique ID to store the chat memory.
255
+ *
256
+ * The full chat memory key is constructed as a combination of 'appId', 'agentId', and 'memoryId'.
257
+ * If not provided the Squid client instance ID used as a memoryId.
258
+ *
259
+ * Important: the memory ID should be treated with the same security measures as Access Token because it unblocks
260
+ * direct access to the agent chat history. A good practice is to use a non-trivial and a unique value.
261
+ */
254
262
  memoryId?: string;
255
263
  }
256
264
  /**
@@ -12,7 +12,7 @@ export declare const AUTH_INTEGRATION_TYPES: readonly ["auth0", "jwt_rsa", "jwt_
12
12
  /** Supported integration types for GraphQL-based services. */
13
13
  export declare const GRAPHQL_INTEGRATION_TYPES: readonly ["graphql", "linear"];
14
14
  /** Supported integration types for HTTP-based services. */
15
- export declare const HTTP_INTEGRATION_TYPES: readonly ["api", "confluence"];
15
+ export declare const HTTP_INTEGRATION_TYPES: readonly ["api"];
16
16
  /** Represents a supported integration type identifier, such as 'postgres', 'auth0', or 's3'. */
17
17
  export type IntegrationType = (typeof INTEGRATION_TYPES)[number];
18
18
  /** Supported schema types for integrations */
@@ -0,0 +1,30 @@
1
+ import { ApiOptions } from '../public-types/api-client.public-types';
2
+ import { ApiEndpointId, HttpMethod } from '../public-types/api.public-types';
3
+ import { IntegrationId } from '../public-types/communication.public-types';
4
+ /** The headers of an API call. */
5
+ export type ApiHeaders = Record<string, string | number | boolean>;
6
+ /** The context of an API call. */
7
+ export declare class ApiCallContext {
8
+ readonly integrationId: IntegrationId;
9
+ readonly endpointId: ApiEndpointId;
10
+ readonly url: string;
11
+ readonly method: HttpMethod;
12
+ readonly body: unknown;
13
+ readonly options: ApiOptions;
14
+ }
15
+ /**
16
+ * Represents a request to call an API through a specified integration and endpoint.
17
+ * Includes optional method override and additional request options.
18
+ */
19
+ export interface CallApiRequest<BodyType = any> {
20
+ /** The identifier of the integration through which the API is called. */
21
+ integrationId: IntegrationId;
22
+ /** Target API endpoint to invoke. */
23
+ endpointId: ApiEndpointId;
24
+ /** Optional request payload. */
25
+ body?: BodyType;
26
+ /** Optional HTTP method override. Default is POST. */
27
+ overrideMethod?: HttpMethod;
28
+ /** Additional request options. */
29
+ options: ApiOptions;
30
+ }
@@ -0,0 +1,148 @@
1
+ import { SquidDocIdObj, SquidDocument } from '../public-types/document.public-types';
2
+ import { Paths } from '../public-types/typescript.public-types';
3
+ /**
4
+ * The mutation type.
5
+ * @category Database
6
+ */
7
+ export declare const MUTATION_TYPES: readonly ["insert", "update", "delete"];
8
+ /**
9
+ * @category Database
10
+ */
11
+ export type MutationType = (typeof MUTATION_TYPES)[number];
12
+ interface BaseMutation {
13
+ type: MutationType;
14
+ squidDocIdObj: SquidDocIdObj;
15
+ }
16
+ /**
17
+ * A mutation on a document.
18
+ * @category Database
19
+ */
20
+ export type Mutation<T = any> = UpdateMutation<T> | InsertMutation<T> | DeleteMutation;
21
+ /**
22
+ * Represents a delete mutation on a document.
23
+ * @category Database
24
+ */
25
+ export interface DeleteMutation extends BaseMutation {
26
+ /** Specifies that the mutation is a deletion. */
27
+ type: 'delete';
28
+ }
29
+ /**
30
+ * Represents an update mutation on a document.
31
+ * @category Database
32
+ */
33
+ export interface UpdateMutation<T = any> extends BaseMutation {
34
+ /** Specifies that the mutation is an update. */
35
+ type: 'update';
36
+ /** The updated properties */
37
+ properties: {
38
+ [key in keyof T & string]?: Array<PropertyMutation<T[key]>>;
39
+ };
40
+ }
41
+ /**
42
+ * Represents an insert mutation on a document.
43
+ * @category Database
44
+ */
45
+ export interface InsertMutation<T = any> extends BaseMutation {
46
+ /** Specifies that the mutation is an insertion. */
47
+ type: 'insert';
48
+ /** The inserted document */
49
+ properties: T;
50
+ }
51
+ /**
52
+ * A representation of a single property update.
53
+ * @category Database
54
+ */
55
+ export type PropertyMutation<Value = any> = ApplyNumericFnPropertyMutation | ApplyStringFnPropertyMutation | ValueUpdatePropertyMutation<Value> | RemovePropertyMutation;
56
+ /**
57
+ * A value update property mutation.
58
+ * @category Database
59
+ */
60
+ export interface ValueUpdatePropertyMutation<Value = any> {
61
+ /** Specifies that the mutation updates a value. */
62
+ type: 'update';
63
+ /** New value to be set. */
64
+ value: Value;
65
+ }
66
+ /**
67
+ * Applying a numeric function to a property.
68
+ * @category Database
69
+ */
70
+ export interface ApplyNumericFnPropertyMutation {
71
+ /** Specifies that the mutation applies a numeric function. */
72
+ type: 'applyNumericFn';
73
+ /** Numeric function to apply. */
74
+ fn: 'increment';
75
+ /** Value to use in the numeric function. */
76
+ value: number;
77
+ }
78
+ /**
79
+ * A property update that removes a property from a document.
80
+ * @category Database
81
+ */
82
+ export interface RemovePropertyMutation {
83
+ /** Specifies that the mutation removes a property. */
84
+ type: 'removeProperty';
85
+ }
86
+ interface ApplyExtendString {
87
+ /** Specifies that the mutation applies a string function. */
88
+ type: 'applyStringFn';
89
+ /** String function to extend the existing string. */
90
+ fn: 'extendString';
91
+ /** String value to append. */
92
+ value: string;
93
+ }
94
+ interface ApplyTrimString {
95
+ /** Specifies that the mutation applies a string function. */
96
+ type: 'applyStringFn';
97
+ /** String function to trim the existing string. */
98
+ fn: 'trim';
99
+ }
100
+ /**
101
+ * A property mutation that modifies a string.
102
+ * @category Database
103
+ */
104
+ export type ApplyStringFnPropertyMutation = ApplyExtendString | ApplyTrimString;
105
+ /**
106
+ * The before and after documents of a document change.
107
+ * @category Database
108
+ */
109
+ export interface BeforeAndAfterDocs<T = SquidDocument> {
110
+ /** Document state before the mutation. */
111
+ before: T | undefined;
112
+ /** Document state after the mutation. */
113
+ after: T | undefined;
114
+ }
115
+ /**
116
+ * The mutation context that will be provided to the security function.
117
+ * @category Database
118
+ */
119
+ export declare class MutationContext<T = any> {
120
+ readonly mutation: Mutation<T>;
121
+ readonly beforeAndAfterDocs: BeforeAndAfterDocs<T>;
122
+ readonly serverTimeStamp: Date;
123
+ /**
124
+ * Returns the type of the mutation (insert, update, or delete).
125
+ */
126
+ getMutationType(): MutationType;
127
+ /**
128
+ * Returns the state of the document before the mutation was applied.
129
+ */
130
+ get before(): T | undefined;
131
+ /**
132
+ * Returns the state of the document after the mutation was applied.
133
+ */
134
+ get after(): T | undefined;
135
+ /** Returns true if the mutation affects the provided path. */
136
+ affectsPath(path: Paths<T>): boolean;
137
+ /**
138
+ * Find all affected paths starting from a root path.
139
+ *
140
+ * @example
141
+ * doc before - { a: { b: 1, c: 2 }, d: 3 }
142
+ * doc after - { a: { b: 1, c: 3 }, d: 4 }
143
+ * doc.affectedPaths('a') // ['a.c']
144
+ */
145
+ affectedPaths(startingRoot?: Paths<T> | string): Array<Paths<T>>;
146
+ private checkPath;
147
+ }
148
+ export {};
@@ -0,0 +1,60 @@
1
+ import { IntegrationId } from '../public-types/communication.public-types';
2
+ /**
3
+ * Represents the type of native query request, either relational, elastic or MongoDB.
4
+ * @category Database
5
+ */
6
+ export type NativeQueryRequestType = 'relational' | 'mongo' | 'elasticsearch';
7
+ interface BaseNativeQueryContext {
8
+ /** Type of the native query request. */
9
+ type: NativeQueryRequestType;
10
+ /** Identifier for the integration. */
11
+ integrationId: IntegrationId;
12
+ }
13
+ /**
14
+ * Context for executing a relational database query.
15
+ * @category Database
16
+ */
17
+ export interface RelationalNativeQueryContext extends BaseNativeQueryContext {
18
+ /** Specifies that the query is for a relational database. */
19
+ type: 'relational';
20
+ /** SQL query string to be executed. */
21
+ query: string;
22
+ /** Parameters to be used in the query. */
23
+ params: Record<string, any>;
24
+ }
25
+ /**
26
+ * Context for executing a MongoDB query.
27
+ * @category Database
28
+ */
29
+ export interface MongoNativeQueryContext extends BaseNativeQueryContext {
30
+ /** Specifies that the query is for a Mongo database. */
31
+ type: 'mongo';
32
+ /** Name of the MongoDB collection to query. */
33
+ collectionName: string;
34
+ /** Array of aggregation pipeline stages. */
35
+ aggregationPipeline: Array<any | undefined>;
36
+ }
37
+ /**
38
+ * Context for executing an Elasticsearch query.
39
+ * @category Database
40
+ */
41
+ export interface ElasticsearchNativeQueryContext {
42
+ /** Specifies that the query is for an Elasticsearch database. */
43
+ type: 'elasticsearch';
44
+ /** Elasticsearch index to query. */
45
+ index: string;
46
+ /** Elasticsearch query string. */
47
+ endpoint?: string;
48
+ /** HTTP method to use for the request. */
49
+ method?: 'GET' | 'POST';
50
+ /** Body of the request. */
51
+ body: Record<string, any>;
52
+ /** Headers to include in the request. */
53
+ integrationId: IntegrationId;
54
+ }
55
+ /**
56
+ * Union type representing either a relational or MongoDB native query context.
57
+ * @category Database
58
+ */
59
+ export type NativeQueryContext = RelationalNativeQueryContext | MongoNativeQueryContext | ElasticsearchNativeQueryContext;
60
+ export {};
@@ -0,0 +1,166 @@
1
+ import { IntegrationId } from '../public-types/communication.public-types';
2
+ import { CollectionName, DocumentData } from '../public-types/document.public-types';
3
+ import { FieldSort, Operator, Query, SimpleCondition } from '../public-types/query.public-types';
4
+ import { DeepRecord, FieldOf, PartialBy, Paths } from '../public-types/typescript.public-types';
5
+ /**
6
+ * Represents the Squid query context.
7
+ * Passed to methods that require query details, such as those annotated with the `@secureCollection` annotation.
8
+ * @category Database
9
+ */
10
+ export declare class QueryContext<T extends DocumentData = any> {
11
+ readonly query: Query<T>;
12
+ /**
13
+ * The ID of the integration being queried.
14
+ */
15
+ get integrationId(): IntegrationId;
16
+ /**
17
+ * The name of the collection being queried.
18
+ */
19
+ get collectionName(): CollectionName;
20
+ /**
21
+ * The query limit if one exists, -1 otherwise.
22
+ */
23
+ get limit(): number;
24
+ /**
25
+ * Verifies that the query's sort order aligns with the provided field sorts. The fields specified in the `sorts`
26
+ * parameter must appear in the exact order at the beginning of the query's sort sequence. The query can include
27
+ * additional fields in its sort order, but only after the specified sorts.
28
+ *
29
+ * @param sorts An array of field sorts.
30
+ * @returns Whether the query's sorts matches the provided field sorts.
31
+ */
32
+ sortedBy(sorts: Array<PartialBy<FieldSort<T>, 'asc'>>): boolean;
33
+ /**
34
+ * Verifies that the query's sort order exactly matches the provided field sorts. The fields specified in the
35
+ * `sorts` parameter must appear in the exact order in the query's sort sequence. No additional sorts may be present
36
+ * in the query.
37
+ *
38
+ * @param sorts An array of field sorts.
39
+ * @returns Whether the query's sorts exactly match the provided field sorts.
40
+ */
41
+ sortedByExact(sorts: Array<PartialBy<FieldSort<T>, 'asc'>>): boolean;
42
+ /**
43
+ * Verifies that the query is a subquery of the specified condition. A subquery is defined as a query that evaluates
44
+ * to a subset of the results that would be obtained by applying the parent condition. The subquery may also include
45
+ * additional conditions, as these only narrow the result set.
46
+ *
47
+ * @param fieldName The name of the field for the condition.
48
+ * @param operator The operator of the condition.
49
+ * @param value The value of the condition.
50
+ * @returns Whether the query is a subquery of the parent condition.
51
+ */
52
+ isSubqueryOf<F extends Paths<T>, O extends AllOperators>(fieldName: F, operator: O, value: GenericValue<T, F, O> | null): boolean;
53
+ /**
54
+ * Verifies that the query is a subquery of the specified condition. A subquery is defined as a query that evaluates
55
+ * to a subset of the results that would be obtained by applying the parent condition. The subquery may also include
56
+ * additional conditions, as these only narrow the result set.
57
+ *
58
+ * @param condition The condition to validate.
59
+ * @returns Whether the query is a subquery of the parent condition.
60
+ */
61
+ isSubqueryOfCondition(condition: GeneralCondition<T>): boolean;
62
+ /**
63
+ * Verifies that the query is a subquery of the specified conditions. A subquery is defined as a query that evaluates
64
+ * to a subset of the results that would be obtained by applying the parent conditions. The subquery may also include
65
+ * additional conditions, as these only narrow the result set.
66
+ *
67
+ * @param conditions The conditions to validate.
68
+ * @returns Whether the query includes subquery of the parent conditions.
69
+ */
70
+ isSubqueryOfConditions(conditions: GeneralConditions<T>): boolean;
71
+ /**
72
+ * Verifies that the query is a subquery of the specified query. A subquery is defined as a query that evaluates
73
+ * to a subset of the results that obtained for the parent query, including sorts and limits.
74
+ *
75
+ * @param query The query to validate.
76
+ * @returns Whether the query is a subquery of the parent query.
77
+ */
78
+ isSubqueryOfQuery(query: Query<T>): boolean;
79
+ /**
80
+ * Returns all conditions that apply to any of the specified field names. This method
81
+ * provides a convenient way to retrieve all conditions that involve a specific set of fields.
82
+ *
83
+ * @param fieldNames The field names for which to retrieve conditions.
84
+ * @returns An array of conditions that involve any of the specified field names.
85
+ */
86
+ getConditionsFor<K extends Paths<T>>(...fieldNames: Array<K>): ContextConditions<T, K>;
87
+ /**
88
+ * Returns all conditions that apply to the specified field name. This method provides
89
+ * a convenient way to retrieve all conditions that involve a specific field.
90
+ *
91
+ * @param fieldName The field name for which to retrieve conditions.
92
+ * @returns An array of conditions that involve the specified field name.
93
+ */
94
+ getConditionsForField<K extends Paths<T>>(fieldName: K): ContextConditions<T>;
95
+ /**
96
+ * Returns true if the given document can be a result of the query.
97
+ * The method does not account for limit and sort order.
98
+ */
99
+ documentMatchesQuery(doc: DocumentData): boolean;
100
+ }
101
+ /**
102
+ * A list of context conditions.
103
+ * @category Database
104
+ */
105
+ export type ContextConditions<Doc extends DocumentData = any, F extends Paths<Doc> = Paths<Doc>> = Array<ContextCondition<Doc, F>>;
106
+ /**
107
+ * A Context condition - a condition that replaces multiple '==' or '!=' conditions with 'in' and 'not in'.
108
+ * @category Database
109
+ */
110
+ export type ContextCondition<Doc extends DocumentData = any, F extends Paths<Doc> = Paths<Doc>> = InContextCondition<Doc, F> | NotInContextCondition<Doc, F> | OtherContextCondition<Doc, F>;
111
+ /**
112
+ * A condition using the 'in' operator to match values within a set.
113
+ * @category Database
114
+ */
115
+ export interface InContextCondition<Doc extends DocumentData = any, F extends Paths<Doc> = Paths<Doc>> extends SimpleCondition<Doc, F, 'in'> {
116
+ /** Specifies the 'in' operator to check if a value exists within an array. */
117
+ operator: 'in';
118
+ /** An array of values to match against the field. */
119
+ value: Array<FieldOf<DeepRecord<Doc>, Paths<Doc>> | any>;
120
+ }
121
+ /**
122
+ * A condition using the 'not in' operator to exclude values within a set.
123
+ * @category Database
124
+ */
125
+ export interface NotInContextCondition<Doc extends DocumentData = any, F extends Paths<Doc> = Paths<Doc>> extends SimpleCondition<Doc, F, 'not in'> {
126
+ /** Specifies the 'not in' operator to check if a value does not exist within an array. */
127
+ operator: 'not in';
128
+ /** An array of values to exclude from the field. */
129
+ value: Array<FieldOf<DeepRecord<Doc>, Paths<Doc>> | any>;
130
+ }
131
+ /**
132
+ * A condition using operators other than 'in' or 'not in' for field comparisons.
133
+ * @category Database
134
+ */
135
+ export interface OtherContextCondition<Doc extends DocumentData = any, F extends Paths<Doc> = Paths<Doc>> extends SimpleCondition<Doc, F, Exclude<ContextOperator, 'in' | 'not in'>> {
136
+ /** The operator to use for the comparison, excluding 'in' and 'not in'. */
137
+ operator: Exclude<ContextOperator, 'in' | 'not in'>;
138
+ /** The value to compare against the field. */
139
+ value: FieldOf<DeepRecord<Doc>, Paths<Doc>> | any;
140
+ }
141
+ /**
142
+ * A condition that includes all operators, including 'in' and 'not in', for general use.
143
+ * @category Database
144
+ */
145
+ export interface GeneralCondition<Doc extends DocumentData = any, F extends Paths<Doc> = Paths<Doc>> extends SimpleCondition<Doc, F, AllOperators> {
146
+ /** The operator to apply to the condition, including all possible operators. */
147
+ operator: AllOperators;
148
+ /** The value to use in the condition comparison. */
149
+ value: any;
150
+ }
151
+ /**
152
+ * A list of general conditions.
153
+ * @category Database
154
+ */
155
+ export type GeneralConditions<Doc extends DocumentData = any, F extends Paths<Doc> = Paths<Doc>> = Array<GeneralCondition<Doc, F>>;
156
+ /**
157
+ * @category Database
158
+ */
159
+ export type ContextOperator = Exclude<Operator, '==' | '!='> | 'in' | 'not in';
160
+ type AllOperators = Operator | 'in' | 'not in';
161
+ /**
162
+ * A generic value that can exist in a query.
163
+ * @category Database
164
+ */
165
+ export type GenericValue<Doc = any, F extends Paths<Doc> = Paths<Doc>, O extends AllOperators = any> = O extends 'in' ? Array<DeepRecord<Doc>[F]> | null : O extends 'not in' ? Array<DeepRecord<Doc>[F]> | null : DeepRecord<Doc>[F] | null;
166
+ export {};
@@ -0,0 +1,159 @@
1
+ import { AgentContextRequest, AiAgent, AiAgentContext, AiAnnotation, AiAudioCreateSpeechOptions, AiChatOptions, AiGenerateImageOptions, AiSearchOptions, AiSearchResultChunk, AllAiAgentChatOptions, ApplicationAiSettings } from '../public-types/ai-agent.public-types';
2
+ import { AiChatModelName, AiEmbeddingsModelName, AiProviderType } from '../public-types/ai-common.public-types';
3
+ import { AiContextMetadata, AiContextMetadataFilter } from '../public-types/ai-knowledge-base.public-types';
4
+ import { AiAgentId, AiKnowledgeBaseId, AppId, ClientRequestId } from '../public-types/communication.public-types';
5
+ import { JobId } from '../public-types/job.public-types';
6
+ import { SecretKey } from '../public-types/secret.public-types';
7
+ /** Specification for an AI model, defining its operational parameters. */
8
+ export type AiModelSpec = {
9
+ /** Maximum tokens the model can generate in a single response. */
10
+ maxOutputTokens: number;
11
+ /** Total context window size: input (aka prompt) + output (aka completion) tokens combined. */
12
+ contextWindowTokens: number;
13
+ };
14
+ /** Map of AI model details by model name. */
15
+ export declare const AI_VENDOR_MODEL_SPECS: Record<AiChatModelName, AiModelSpec>;
16
+ /** Map of embedding AI model specs by model name. */
17
+ export declare const AI_VENDOR_EMBEDDING_MODEL_SPECS: Record<AiEmbeddingsModelName, AiModelSpec>;
18
+ export interface AiChatRequest {
19
+ agentId: AiAgentId;
20
+ clientRequestId: ClientRequestId;
21
+ prompt?: string;
22
+ options?: AllAiAgentChatOptions;
23
+ jobId: JobId;
24
+ }
25
+ export interface AiAskRequest {
26
+ agentId: AiAgentId;
27
+ prompt?: string;
28
+ options?: AllAiAgentChatOptions;
29
+ jobId: JobId;
30
+ }
31
+ export interface AiGenerateImageRequest {
32
+ prompt: string;
33
+ options: AiGenerateImageOptions;
34
+ }
35
+ export interface AiAskQuestionInternalRequest {
36
+ appId: AppId;
37
+ prompt: string;
38
+ options: AiChatOptions;
39
+ }
40
+ export interface AiAskQuestionInternalResponse {
41
+ answer: string;
42
+ }
43
+ export interface AiContextSizeRequest {
44
+ appId: AppId;
45
+ agentId: AiAgentId;
46
+ }
47
+ export interface AiContextSizeResponse {
48
+ sizeBytes: number;
49
+ }
50
+ export interface AiAskResponse {
51
+ responseString: string;
52
+ annotations?: Record<string, AiAnnotation>;
53
+ }
54
+ export interface AiAskWithVoiceResponse {
55
+ responseString: string;
56
+ voiceResponse: AiAudioCreateSpeechResponse;
57
+ annotations?: Record<string, AiAnnotation>;
58
+ }
59
+ export interface AiTranscribeAndAskWithVoiceResponse {
60
+ transcribedPrompt: string;
61
+ responseString: string;
62
+ voiceResponse: AiAudioCreateSpeechResponse;
63
+ annotations?: Record<string, AiAnnotation>;
64
+ }
65
+ export interface AiTranscribeAndChatResponse {
66
+ transcribedPrompt: string;
67
+ }
68
+ export interface AiSearchRequest {
69
+ options: AiSearchOptions;
70
+ agentId: AiAgentId;
71
+ }
72
+ export interface AiSearchResponse {
73
+ chunks: Array<AiSearchResultChunk>;
74
+ }
75
+ export interface AiAudioCreateSpeechResponse {
76
+ mimeType: string;
77
+ extension: string;
78
+ base64File: string;
79
+ }
80
+ export interface AiAudioCreateSpeechRequest {
81
+ input: string;
82
+ options: AiAudioCreateSpeechOptions;
83
+ }
84
+ export interface GetAgentRequest {
85
+ agentId: AiAgentId;
86
+ }
87
+ export interface GetAgentResponse {
88
+ agent: AiAgent | undefined;
89
+ }
90
+ export interface GetAgentContextRequest {
91
+ agentId: AiAgentId;
92
+ contextId: string;
93
+ }
94
+ export interface ConnectAgentKnowledgeBaseRequest {
95
+ agentId: AiAgentId;
96
+ knowledgeBaseId: AiKnowledgeBaseId;
97
+ description: string;
98
+ }
99
+ export interface DisconnectAgentKnowledgeBaseRequest {
100
+ agentId: AiAgentId;
101
+ knowledgeBaseId: AiKnowledgeBaseId;
102
+ }
103
+ export interface DeleteAgentRequest {
104
+ agentId: AiAgentId;
105
+ }
106
+ export interface ListAgentContextsRequest {
107
+ agentId: AiAgentId;
108
+ }
109
+ export interface ListAgentContextsResponse {
110
+ contexts: Array<AiAgentContext>;
111
+ }
112
+ export interface DeleteAgentContextsRequest {
113
+ agentId: AiAgentId;
114
+ contextIds: Array<string>;
115
+ }
116
+ export interface UpsertAgentContextsRequest {
117
+ agentId: AiAgentId;
118
+ contextRequests: Array<AgentContextRequest>;
119
+ }
120
+ export interface UpsertAgentCustomGuardrailsRequest {
121
+ agentId: AiAgentId;
122
+ customGuardrail: string;
123
+ }
124
+ export interface DeleteAgentCustomGuardrailsRequest {
125
+ agentId: AiAgentId;
126
+ }
127
+ export interface ProvideAgentFeedbackRequest {
128
+ agentId: AiAgentId;
129
+ feedback: string;
130
+ }
131
+ export interface ResetAgentFeedbackRequest {
132
+ agentId: AiAgentId;
133
+ }
134
+ export interface ListAgentsResponse {
135
+ agents: Array<AiAgent>;
136
+ }
137
+ export interface GetApplicationAiSettingsResponse {
138
+ settings: ApplicationAiSettings;
139
+ }
140
+ export interface GetApplicationAiSettingsResponse {
141
+ settings: ApplicationAiSettings;
142
+ }
143
+ export interface SetApplicationAiSettingsRequest {
144
+ settings: ApplicationAiSettings;
145
+ }
146
+ export interface SetAiProviderApiKeySecretRequest {
147
+ providerType: AiProviderType;
148
+ secretKey: SecretKey | undefined;
149
+ }
150
+ export interface SetAiProviderApiKeySecretResponse {
151
+ settings: ApplicationAiSettings;
152
+ }
153
+ export declare function validateAiContextMetadata(metadata: AiContextMetadata): void;
154
+ export declare function validateAiContextMetadataFilter(filter: AiContextMetadataFilter): void;
155
+ export declare const METADATA_SERVICE_FUNCTION_NAME = "default:metadata";
156
+ export interface UpdateApplicationAiSettingsWebhookPayload {
157
+ appId: AppId;
158
+ aiSettings: ApplicationAiSettings;
159
+ }