@salsita-ai/contracts 0.50.0-develop.f101f4c3c9 → 0.50.0-develop.f354d3576d

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 (52) hide show
  1. package/README.md +6 -2
  2. package/dist/assistant/deployment-assistant.d.ts +84 -0
  3. package/dist/assistant/deployment-assistant.js +1 -1
  4. package/dist/assistant/graphql-tools.d.ts +14 -1
  5. package/dist/assistant/graphql-tools.js +1 -1
  6. package/dist/assistant/image-reference.d.ts +10 -0
  7. package/dist/assistant/image-reference.js +1 -0
  8. package/dist/assistant/index.d.ts +4 -4
  9. package/dist/assistant/index.js +1 -1
  10. package/dist/assistant/message-metadata.d.ts +115 -1
  11. package/dist/assistant/message-metadata.js +1 -1
  12. package/dist/chat/api.d.ts +0 -41
  13. package/dist/chat/api.js +1 -1
  14. package/dist/chat/completions/types.d.ts +0 -3
  15. package/dist/chat/completions/types.js +1 -1
  16. package/dist/chat/functions/process.d.ts +1 -2
  17. package/dist/chat/functions/process.js +1 -1
  18. package/dist/chat/index.d.ts +3 -6
  19. package/dist/chat/index.js +1 -1
  20. package/dist/domain/deployments/assistant-limit-domain.d.ts +13 -0
  21. package/dist/domain/deployments/assistant-limit-domain.js +1 -0
  22. package/dist/domain/deployments/customer-domain.d.ts +2 -0
  23. package/dist/domain/deployments/deployment-build-domain.d.ts +9 -0
  24. package/dist/domain/deployments/environment-domain.d.ts +3 -0
  25. package/dist/domain/deployments/index.d.ts +2 -1
  26. package/dist/domain/deployments/index.js +1 -1
  27. package/dist/domain/deployments/oauth-connection-domain.d.ts +0 -7
  28. package/dist/domain/deployments/oauth-connection-domain.js +1 -1
  29. package/dist/domain/product-configurations/configurations-domain.d.ts +2 -7
  30. package/dist/domain/product-configurations/configurations-domain.js +1 -1
  31. package/dist/domain/product-configurations/index.d.ts +1 -1
  32. package/dist/domain/product-configurations/index.js +1 -1
  33. package/dist/webhook/implementation/backend-data-response.d.ts +3 -0
  34. package/dist/webhook/implementation/backend-data-response.js +1 -0
  35. package/dist/webhook/implementation/index.d.ts +0 -1
  36. package/dist/webhook/implementation/index.js +1 -1
  37. package/dist/webhook/implementation/webhook-api-types.d.ts +43 -0
  38. package/dist/webhook/implementation/webhook-routing.d.ts +0 -6
  39. package/dist/webhook/implementation/webhook-routing.js +1 -1
  40. package/dist/webhook/implementation/webhook-tunnel-types.d.ts +9 -0
  41. package/dist/webhook/implementation/webhook-tunnel-types.js +1 -1
  42. package/package.json +2 -2
  43. package/dist/assistant/browser-details-tool.d.ts +0 -16
  44. package/dist/assistant/browser-details-tool.js +0 -1
  45. package/dist/chat/completions/messages.d.ts +0 -3
  46. package/dist/chat/completions/messages.js +0 -1
  47. package/dist/chat/functions/augmentations.d.ts +0 -3
  48. package/dist/chat/functions/augmentations.js +0 -1
  49. package/dist/chat/functions/create.d.ts +0 -5
  50. package/dist/chat/functions/create.js +0 -1
  51. package/dist/webhook/implementation/webhook-client.d.ts +0 -86
  52. package/dist/webhook/implementation/webhook-client.js +0 -1
package/README.md CHANGED
@@ -18,12 +18,16 @@ There is no package-root export. Import from the path that owns the boundary; th
18
18
  | `api` | API access levels, session roles, access/session token payloads, and Studio browser-session response schema. |
19
19
  | `clerk` | Clerk backend client and services and the shared user, invitation, role, and token schemas. |
20
20
  | `domain` | Branded deployment, customer, project, environment, configuration, and revision data: types, schemas, constructors, and the state values clients compare against. |
21
- | `chat` | Chat completion and stream chunks, tool definitions, validation, speech, and embeddings. |
21
+ | `chat` | Chat stream chunks, tool definitions and processing, validation, and embeddings. |
22
22
  | `assistant` | Experimental assistant: shared client-tool definitions, user-message metadata, server-recorded tool errors and the deployment webhook setup shape. |
23
- | `webhook` | Webhook clients and building blocks, finalization tasks and resources, spreadsheet adapters. |
23
+ | `webhook` | Webhook payloads, responses and routing, finalization tasks and resources, spreadsheet adapters. |
24
+
25
+ The gzip and development-tunnel wire contracts are defined in [Webhook transports](../../../docs/architecture/background-jobs.md#webhook-transports).
24
26
 
25
27
  Runtime schemas and TypeScript types are kept aligned, so a value that passes the schema has the declared type.
26
28
 
29
+ The chat declarations reference OpenAI types in `createEmbedding`, `processToolCalls`, and the shared tool and stream types. `openai` remains a dependency so consumers can resolve those declarations. Completion, speech and message-construction helpers belong to the private backend.
30
+
27
31
  ## Licence
28
32
 
29
33
  Proprietary software of Salsita s.r.o., published under the Salsita SDK License (the `LICENSE` file in this package) and the terms at https://salsita.ai/terms. The published package contains minified code without source maps.
@@ -11,6 +11,28 @@ export declare const ASSISTANT_REASONING_LEVELS: readonly ['low', 'medium', 'hig
11
11
  export type AssistantAiProvider = (typeof ASSISTANT_AI_PROVIDERS)[number];
12
12
  export type AssistantModelTier = (typeof ASSISTANT_MODEL_TIERS)[number];
13
13
  export type AssistantReasoningLevel = (typeof ASSISTANT_REASONING_LEVELS)[number];
14
+ /**
15
+ * The most input tokens a deployment may let a model call of a thread reach before the thread is
16
+ * compacted. It stays under the 272,000 input tokens past which the provider prices a call higher,
17
+ * with room for the reply that crosses the limit.
18
+ */
19
+ export declare const ASSISTANT_MAX_THREAD_SIZE = 192000;
20
+ /** The levels the assistant counts its hourly usage at: the session's user, its client IP and its project. */
21
+ export declare const ASSISTANT_HOURLY_LIMIT_LEVELS: readonly ['sub', 'ip', 'project'];
22
+ export type AssistantHourlyLimitLevel = (typeof ASSISTANT_HOURLY_LIMIT_LEVELS)[number];
23
+ /**
24
+ * The most weighted tokens a deployment may let each level use in a clock hour: five times the
25
+ * server's default. A weighted token is an output-token equivalent; a million of them cost about $10.
26
+ */
27
+ export declare const ASSISTANT_HOURLY_LIMIT_MAXIMA: {
28
+ readonly sub: 5000000;
29
+ readonly ip: 25000000;
30
+ readonly project: 100000000;
31
+ };
32
+ /** Hourly limits a deployment declares, in weighted tokens; a level it leaves out keeps its default. */
33
+ export type AssistantHourlyLimits = {
34
+ readonly [Level in AssistantHourlyLimitLevel]?: number | undefined;
35
+ };
14
36
  /**
15
37
  * The `ai` block of the assistant manifest: which provider, model tier and reasoning level the
16
38
  * deployment's assistant runs with. Authored in the application spec and resolved through its deployment webhook;
@@ -25,22 +47,51 @@ export interface AssistantAiSettings {
25
47
  * user's next message. Defaults to the server's limit; the server also caps it.
26
48
  */
27
49
  readonly maxThreadSize?: number | undefined;
50
+ /**
51
+ * The weighted tokens the session's user, client IP and project may each use in a clock hour before
52
+ * the assistant refuses new messages until the next hour. Defaults to the server's limits; the
53
+ * server also caps them.
54
+ */
55
+ readonly hourlyLimits?: AssistantHourlyLimits | undefined;
28
56
  }
29
57
  export declare const AssistantAiSettings: z.ZodObject<{
30
58
  provider: z.ZodEnum<["openai"]>;
31
59
  model: z.ZodEnum<["frontier", "advanced", "balanced", "fast"]>;
32
60
  reasoning: z.ZodEnum<["low", "medium", "high"]>;
33
61
  maxThreadSize: z.ZodOptional<z.ZodNumber>;
62
+ hourlyLimits: z.ZodOptional<z.ZodObject<{
63
+ sub: z.ZodOptional<z.ZodNumber>;
64
+ ip: z.ZodOptional<z.ZodNumber>;
65
+ project: z.ZodOptional<z.ZodNumber>;
66
+ }, "strict", z.ZodTypeAny, {
67
+ sub?: number | undefined;
68
+ ip?: number | undefined;
69
+ project?: number | undefined;
70
+ }, {
71
+ sub?: number | undefined;
72
+ ip?: number | undefined;
73
+ project?: number | undefined;
74
+ }>>;
34
75
  }, "strict", z.ZodTypeAny, {
35
76
  provider: "openai";
36
77
  model: "advanced" | "balanced" | "fast" | "frontier";
37
78
  reasoning: "high" | "low" | "medium";
38
79
  maxThreadSize?: number | undefined;
80
+ hourlyLimits?: {
81
+ sub?: number | undefined;
82
+ ip?: number | undefined;
83
+ project?: number | undefined;
84
+ } | undefined;
39
85
  }, {
40
86
  provider: "openai";
41
87
  model: "advanced" | "balanced" | "fast" | "frontier";
42
88
  reasoning: "high" | "low" | "medium";
43
89
  maxThreadSize?: number | undefined;
90
+ hourlyLimits?: {
91
+ sub?: number | undefined;
92
+ ip?: number | undefined;
93
+ project?: number | undefined;
94
+ } | undefined;
44
95
  }>;
45
96
  /**
46
97
  * The setup returned by a deployment webhook: GraphQL SDL, SDK-generated prompt, integrator
@@ -62,16 +113,39 @@ export declare const DeploymentAssistant: z.ZodObject<{
62
113
  model: z.ZodEnum<["frontier", "advanced", "balanced", "fast"]>;
63
114
  reasoning: z.ZodEnum<["low", "medium", "high"]>;
64
115
  maxThreadSize: z.ZodOptional<z.ZodNumber>;
116
+ hourlyLimits: z.ZodOptional<z.ZodObject<{
117
+ sub: z.ZodOptional<z.ZodNumber>;
118
+ ip: z.ZodOptional<z.ZodNumber>;
119
+ project: z.ZodOptional<z.ZodNumber>;
120
+ }, "strict", z.ZodTypeAny, {
121
+ sub?: number | undefined;
122
+ ip?: number | undefined;
123
+ project?: number | undefined;
124
+ }, {
125
+ sub?: number | undefined;
126
+ ip?: number | undefined;
127
+ project?: number | undefined;
128
+ }>>;
65
129
  }, "strict", z.ZodTypeAny, {
66
130
  provider: "openai";
67
131
  model: "advanced" | "balanced" | "fast" | "frontier";
68
132
  reasoning: "high" | "low" | "medium";
69
133
  maxThreadSize?: number | undefined;
134
+ hourlyLimits?: {
135
+ sub?: number | undefined;
136
+ ip?: number | undefined;
137
+ project?: number | undefined;
138
+ } | undefined;
70
139
  }, {
71
140
  provider: "openai";
72
141
  model: "advanced" | "balanced" | "fast" | "frontier";
73
142
  reasoning: "high" | "low" | "medium";
74
143
  maxThreadSize?: number | undefined;
144
+ hourlyLimits?: {
145
+ sub?: number | undefined;
146
+ ip?: number | undefined;
147
+ project?: number | undefined;
148
+ } | undefined;
75
149
  }>;
76
150
  }, "strict", z.ZodTypeAny, {
77
151
  sdl: string;
@@ -82,6 +156,11 @@ export declare const DeploymentAssistant: z.ZodObject<{
82
156
  model: "advanced" | "balanced" | "fast" | "frontier";
83
157
  reasoning: "high" | "low" | "medium";
84
158
  maxThreadSize?: number | undefined;
159
+ hourlyLimits?: {
160
+ sub?: number | undefined;
161
+ ip?: number | undefined;
162
+ project?: number | undefined;
163
+ } | undefined;
85
164
  };
86
165
  }, {
87
166
  sdl: string;
@@ -92,5 +171,10 @@ export declare const DeploymentAssistant: z.ZodObject<{
92
171
  model: "advanced" | "balanced" | "fast" | "frontier";
93
172
  reasoning: "high" | "low" | "medium";
94
173
  maxThreadSize?: number | undefined;
174
+ hourlyLimits?: {
175
+ sub?: number | undefined;
176
+ ip?: number | undefined;
177
+ project?: number | undefined;
178
+ } | undefined;
95
179
  };
96
180
  }>;
@@ -1 +1 @@
1
- import{z as t}from"zod";export const ASSISTANT_AI_PROVIDERS=["openai"];export const ASSISTANT_MODEL_TIERS=["frontier","advanced","balanced","fast"];export const ASSISTANT_REASONING_LEVELS=["low","medium","high"];export const AssistantAiSettings=t.object({provider:t.enum(ASSISTANT_AI_PROVIDERS),model:t.enum(ASSISTANT_MODEL_TIERS),reasoning:t.enum(ASSISTANT_REASONING_LEVELS),maxThreadSize:t.number().int().positive().optional()}).strict();export const DeploymentAssistant=t.object({sdl:t.string().min(1),prompt:t.string().min(1),instructions:t.string().min(1).optional(),ai:AssistantAiSettings}).strict();
1
+ import{z as t}from"zod";export const ASSISTANT_AI_PROVIDERS=["openai"];export const ASSISTANT_MODEL_TIERS=["frontier","advanced","balanced","fast"];export const ASSISTANT_REASONING_LEVELS=["low","medium","high"];export const ASSISTANT_MAX_THREAD_SIZE=192e3;export const ASSISTANT_HOURLY_LIMIT_LEVELS=["sub","ip","project"];export const ASSISTANT_HOURLY_LIMIT_MAXIMA={sub:5e6,ip:25e6,project:1e8};let o=t.number().int().positive().optional(),i=t.object({sub:o,ip:o,project:o}).strict();export const AssistantAiSettings=t.object({provider:t.enum(ASSISTANT_AI_PROVIDERS),model:t.enum(ASSISTANT_MODEL_TIERS),reasoning:t.enum(ASSISTANT_REASONING_LEVELS),maxThreadSize:t.number().int().positive().optional(),hourlyLimits:i.optional()}).strict();export const DeploymentAssistant=t.object({sdl:t.string().min(1),prompt:t.string().min(1),instructions:t.string().min(1).optional(),ai:AssistantAiSettings}).strict();
@@ -11,6 +11,8 @@ export interface AssistantGraphQLOperation {
11
11
  * against the configurator's GraphQL schema, each one seeing the changes of the ones before it.
12
12
  */
13
13
  export interface AssistantGraphQLToolInput {
14
+ /** A short name of the call for the user, in their language; the panel shows it on the call's chip. */
15
+ readonly title?: string | null;
14
16
  readonly operations: ReadonlyArray<AssistantGraphQLOperation>;
15
17
  }
16
18
  /**
@@ -19,6 +21,7 @@ export interface AssistantGraphQLToolInput {
19
21
  * out; the tools are not sent as strict schemas, because `variables` is a free-form map.
20
22
  */
21
23
  export declare const AssistantGraphQLToolInput: z.ZodObject<{
24
+ title: z.ZodCatch<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
22
25
  operations: z.ZodArray<z.ZodObject<{
23
26
  query: z.ZodString;
24
27
  variables: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -33,12 +36,14 @@ export declare const AssistantGraphQLToolInput: z.ZodObject<{
33
36
  operationName?: string | null | undefined;
34
37
  }>, "many">;
35
38
  }, "strip", z.ZodTypeAny, {
39
+ title?: string | null | undefined;
36
40
  operations: {
37
41
  query: string;
38
42
  variables?: Record<string, unknown> | null | undefined;
39
43
  operationName?: string | null | undefined;
40
44
  }[];
41
45
  }, {
46
+ title?: unknown;
42
47
  operations: {
43
48
  query: string;
44
49
  variables?: Record<string, unknown> | null | undefined;
@@ -49,7 +54,7 @@ export declare const AssistantGraphQLToolInput: z.ZodObject<{
49
54
  * Client-side tool of the assistant chat that reads the configuration: the browser runs the
50
55
  * operations against the configurator's GraphQL schema from the committed state and discards every
51
56
  * change, so mutations in the list answer "what if" questions. The result is the list of standard
52
- * GraphQL results with `committed: false`.
57
+ * GraphQL results with `committed: false`, followed by the pictures of the screenshots they took.
53
58
  *
54
59
  * The server passes the definition to the model without an implementation, so every call becomes a
55
60
  * client-tool interrupt; the SDK registers the browser implementation via `.client()`.
@@ -57,6 +62,10 @@ export declare const AssistantGraphQLToolInput: z.ZodObject<{
57
62
  export declare const queryTool: import("@tanstack/ai").ToolDefinition<{
58
63
  type: string;
59
64
  properties: {
65
+ title: {
66
+ type: string;
67
+ description: string;
68
+ };
60
69
  operations: {
61
70
  type: string;
62
71
  minItems: number;
@@ -92,6 +101,10 @@ export declare const queryTool: import("@tanstack/ai").ToolDefinition<{
92
101
  export declare const applyTool: import("@tanstack/ai").ToolDefinition<{
93
102
  type: string;
94
103
  properties: {
104
+ title: {
105
+ type: string;
106
+ description: string;
107
+ };
95
108
  operations: {
96
109
  type: string;
97
110
  minItems: number;
@@ -1 +1 @@
1
- import{toolDefinition as e}from"@tanstack/ai";import{z as t}from"zod";export const AssistantGraphQLToolInput=t.object({operations:t.array(t.object({query:t.string(),variables:t.record(t.unknown()).nullish(),operationName:t.string().nullish()})).min(1)});let o={type:"object",properties:{operations:{type:"array",minItems:1,description:"The operations to run, in order. Each one sees the changes of the ones before it.",items:{type:"object",properties:{query:{type:"string",description:"A GraphQL document with exactly one operation, a query or a mutation."},variables:{type:"object",description:"Values of the variables the document declares. Prefer literals written into the document."},operationName:{type:"string",description:"The name of the operation, when the document names it."}},required:["query"]}}},required:["operations"]};export const queryTool=e({name:"query",description:"Reads the open configuration: runs GraphQL operations and returns their results. Changes nothing; mutations run on a copy discarded after the call.",inputSchema:o});export const applyTool=e({name:"apply",description:"Changes the open configuration: runs GraphQL operations and keeps their changes as one undo step. All or nothing: when any operation fails, nothing changes. `committed` says whether the changes were kept.",inputSchema:o});
1
+ import{toolDefinition as e}from"@tanstack/ai";import{z as t}from"zod";export const AssistantGraphQLToolInput=t.object({title:t.string().nullish().catch(void 0),operations:t.array(t.object({query:t.string(),variables:t.record(t.unknown()).nullish(),operationName:t.string().nullish()})).min(1)});let o={type:"object",properties:{title:{type:"string",description:"A short name of this call for the user, two to five words in their language, saying what it does."},operations:{type:"array",minItems:1,description:"The operations to run, in order. Each one sees the changes of the ones before it.",items:{type:"object",properties:{query:{type:"string",description:"A GraphQL document with exactly one operation, a query or a mutation."},variables:{type:"object",description:"Values of the variables the document declares. Prefer literals written into the document."},operationName:{type:"string",description:"The name of the operation, when the document names it."}},required:["query"]}}},required:["operations"]};export const queryTool=e({name:"query",description:"Reads the open configuration: runs GraphQL operations and returns their results. Changes nothing; mutations run on a copy discarded after the call. `errors` say why an operation failed; `warnings` are what its changes would newly cause, and do not make it fail. Screenshots the operations take follow the results as images, each after its label.",inputSchema:o});export const applyTool=e({name:"apply",description:"Changes the open configuration: runs GraphQL operations and keeps their changes as one undo step. All or nothing: when any operation fails, nothing changes. `committed` says whether the changes were kept. `errors` say why an operation failed; `warnings` are what the changes newly cause, and do not stop them. Screenshots the operations take follow the results as images, each after its label.",inputSchema:o});
@@ -0,0 +1,10 @@
1
+ /**
2
+ * The URL an image part carries for an image the browser uploaded, a screenshot in an assistant tool
3
+ * result or an image the user attached to their message: `assistant-image:<imageId>`, the id the
4
+ * server's image upload answered with. The thread stores
5
+ * the reference; the server swaps it for the image only in the copy of the thread sent to the model,
6
+ * and the panel fetches the image by its id.
7
+ */
8
+ export declare const assistantImageReference: (imageId: string) => string;
9
+ /** The image id of an `assistant-image:` reference; `null` for any other URL. */
10
+ export declare const readAssistantImageReference: (url: string) => string | null;
@@ -0,0 +1 @@
1
+ let e="assistant-image:",t=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;export const assistantImageReference=t=>`${e}${t}`;export const readAssistantImageReference=a=>{if(!a.startsWith(e))return null;let s=a.slice(e.length);return t.test(s)?s:null};
@@ -1,8 +1,8 @@
1
- export { browserDetailsTool } from './browser-details-tool.js';
2
- export { ASSISTANT_AI_PROVIDERS, ASSISTANT_MODEL_TIERS, ASSISTANT_REASONING_LEVELS, AssistantAiSettings, DeploymentAssistant, } from './deployment-assistant.js';
1
+ export { ASSISTANT_AI_PROVIDERS, ASSISTANT_HOURLY_LIMIT_LEVELS, ASSISTANT_HOURLY_LIMIT_MAXIMA, ASSISTANT_MODEL_TIERS, ASSISTANT_REASONING_LEVELS, ASSISTANT_MAX_THREAD_SIZE, AssistantAiSettings, DeploymentAssistant, } from './deployment-assistant.js';
3
2
  export { AssistantGraphQLToolInput, applyTool, queryTool } from './graphql-tools.js';
4
3
  export type { AssistantGraphQLOperation } from './graphql-tools.js';
5
- export type { AssistantAiProvider, AssistantModelTier, AssistantReasoningLevel } from './deployment-assistant.js';
6
- export { AssistantMessageMetadata } from './message-metadata.js';
4
+ export type { AssistantAiProvider, AssistantHourlyLimitLevel, AssistantHourlyLimits, AssistantModelTier, AssistantReasoningLevel, } from './deployment-assistant.js';
5
+ export { assistantImageReference, readAssistantImageReference } from './image-reference.js';
6
+ export { AssistantAnnotationPin, AssistantMessageAnnotation, AssistantMessageMetadata } from './message-metadata.js';
7
7
  export { ASSISTANT_TOOL_ERROR_CODES, AssistantToolError } from './tool-error.js';
8
8
  export type { AssistantToolErrorCode } from './tool-error.js';
@@ -1 +1 @@
1
- export{browserDetailsTool}from"./browser-details-tool.js";export{ASSISTANT_AI_PROVIDERS,ASSISTANT_MODEL_TIERS,ASSISTANT_REASONING_LEVELS,AssistantAiSettings,DeploymentAssistant}from"./deployment-assistant.js";export{AssistantGraphQLToolInput,applyTool,queryTool}from"./graphql-tools.js";export{AssistantMessageMetadata}from"./message-metadata.js";export{ASSISTANT_TOOL_ERROR_CODES,AssistantToolError}from"./tool-error.js";
1
+ export{ASSISTANT_AI_PROVIDERS,ASSISTANT_HOURLY_LIMIT_LEVELS,ASSISTANT_HOURLY_LIMIT_MAXIMA,ASSISTANT_MODEL_TIERS,ASSISTANT_REASONING_LEVELS,ASSISTANT_MAX_THREAD_SIZE,AssistantAiSettings,DeploymentAssistant}from"./deployment-assistant.js";export{AssistantGraphQLToolInput,applyTool,queryTool}from"./graphql-tools.js";export{assistantImageReference,readAssistantImageReference}from"./image-reference.js";export{AssistantAnnotationPin,AssistantMessageAnnotation,AssistantMessageMetadata}from"./message-metadata.js";export{ASSISTANT_TOOL_ERROR_CODES,AssistantToolError}from"./tool-error.js";
@@ -1,17 +1,131 @@
1
1
  import { z } from 'zod';
2
+ /**
3
+ * A numbered comment the user pinned onto an annotation. `x` and `y` are where it points, as
4
+ * fractions 0–1 of the annotation image's width and height from its top left corner. Its number, drawn
5
+ * on the image and named in the text for the model, is its position in the annotation's `pins`, from 1.
6
+ */
7
+ export interface AssistantAnnotationPin {
8
+ readonly x: number;
9
+ readonly y: number;
10
+ readonly comment: string;
11
+ }
12
+ export declare const AssistantAnnotationPin: z.ZodObject<{
13
+ x: z.ZodNumber;
14
+ y: z.ZodNumber;
15
+ comment: z.ZodString;
16
+ }, "strip", z.ZodTypeAny, {
17
+ x: number;
18
+ y: number;
19
+ comment: string;
20
+ }, {
21
+ x: number;
22
+ y: number;
23
+ comment: string;
24
+ }>;
25
+ /**
26
+ * An annotation the user attached to a message: a frozen view of their configurator with their marker
27
+ * strokes and numbered pins flattened into one image, which the message references like any attached
28
+ * image, and the comments of the pins, which the image shows only as numbers.
29
+ */
30
+ export interface AssistantMessageAnnotation {
31
+ /** The id of the annotation image, as the message's image part references it. */
32
+ readonly imageId: string;
33
+ readonly pins: ReadonlyArray<AssistantAnnotationPin>;
34
+ }
35
+ export declare const AssistantMessageAnnotation: z.ZodObject<{
36
+ imageId: z.ZodString;
37
+ pins: z.ZodArray<z.ZodObject<{
38
+ x: z.ZodNumber;
39
+ y: z.ZodNumber;
40
+ comment: z.ZodString;
41
+ }, "strip", z.ZodTypeAny, {
42
+ x: number;
43
+ y: number;
44
+ comment: string;
45
+ }, {
46
+ x: number;
47
+ y: number;
48
+ comment: string;
49
+ }>, "many">;
50
+ }, "strip", z.ZodTypeAny, {
51
+ imageId: string;
52
+ pins: {
53
+ x: number;
54
+ y: number;
55
+ comment: string;
56
+ }[];
57
+ }, {
58
+ imageId: string;
59
+ pins: {
60
+ x: number;
61
+ y: number;
62
+ comment: string;
63
+ }[];
64
+ }>;
2
65
  /**
3
66
  * Metadata the assistant chat client attaches to each user message (AG-UI message `metadata`). It is
4
67
  * persisted with the message, and the server shows `changes` to the model in front of the message, so
5
- * the model knows what the user did in the configurator since it last acted.
68
+ * the model knows what the user did in the configurator since it last acted. It also tells the model
69
+ * which language to reply in, on a thread's first user message and wherever `locale` changed, and
70
+ * lists the comments of the message's annotations.
6
71
  */
7
72
  export interface AssistantMessageMetadata {
8
73
  /** The change record since the agent's previous action: a marker or a diff, as the assistant prompt describes it. */
9
74
  readonly changes: string;
75
+ /**
76
+ * The locale the configurator showed when the user sent the message, as its i18n code (e.g. `de` or
77
+ * `de-AT`). Absent on messages from clients and versions that do not send it.
78
+ */
79
+ readonly locale?: string;
80
+ /** The annotations among the message's images, in their order. Absent on messages without any. */
81
+ readonly annotations?: ReadonlyArray<AssistantMessageAnnotation>;
10
82
  }
11
83
  export declare const AssistantMessageMetadata: z.ZodObject<{
12
84
  changes: z.ZodString;
85
+ locale: z.ZodOptional<z.ZodString>;
86
+ annotations: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodObject<{
87
+ imageId: z.ZodString;
88
+ pins: z.ZodArray<z.ZodObject<{
89
+ x: z.ZodNumber;
90
+ y: z.ZodNumber;
91
+ comment: z.ZodString;
92
+ }, "strip", z.ZodTypeAny, {
93
+ x: number;
94
+ y: number;
95
+ comment: string;
96
+ }, {
97
+ x: number;
98
+ y: number;
99
+ comment: string;
100
+ }>, "many">;
101
+ }, "strip", z.ZodTypeAny, {
102
+ imageId: string;
103
+ pins: {
104
+ x: number;
105
+ y: number;
106
+ comment: string;
107
+ }[];
108
+ }, {
109
+ imageId: string;
110
+ pins: {
111
+ x: number;
112
+ y: number;
113
+ comment: string;
114
+ }[];
115
+ }>, "many">>>;
13
116
  }, "strip", z.ZodTypeAny, {
14
117
  changes: string;
118
+ locale?: string | undefined;
119
+ annotations?: {
120
+ imageId: string;
121
+ pins: {
122
+ x: number;
123
+ y: number;
124
+ comment: string;
125
+ }[];
126
+ }[] | undefined;
15
127
  }, {
16
128
  changes: string;
129
+ locale?: string | undefined;
130
+ annotations?: unknown;
17
131
  }>;
@@ -1 +1 @@
1
- import{z as t}from"zod";export const AssistantMessageMetadata=t.object({changes:t.string()});
1
+ import{z as t}from"zod";export const AssistantAnnotationPin=t.object({x:t.number().min(0).max(1),y:t.number().min(0).max(1),comment:t.string()});export const AssistantMessageAnnotation=t.object({imageId:t.string(),pins:t.array(AssistantAnnotationPin)});export const AssistantMessageMetadata=t.object({changes:t.string(),locale:t.string().optional(),annotations:t.array(AssistantMessageAnnotation).optional().catch(void 0)});
@@ -1,45 +1,4 @@
1
1
  import type OpenAI from 'openai';
2
- import type { Uploadable } from 'openai/core/uploads';
3
- /**
4
- * Generate a completion from a prompt and message history
5
- * @param openai OpenAI instance
6
- * @param params completion options
7
- * @param prompt base prompt
8
- * @param messages message history- last message should be user message
9
- * @param tools available functions to call
10
- * @returns
11
- */
12
- export declare const createCompletion: (openai: OpenAI, params: Omit<OpenAI.Chat.Completions.ChatCompletionCreateParams, 'stream' | 'messages'>, prompt: string, messages: OpenAI.ChatCompletionMessageParam[], tools?: OpenAI.ChatCompletionTool[]) => Promise<import("openai/core/streaming.mjs").Stream<OpenAI.ChatCompletionChunk> & {
13
- _request_id?: string | null;
14
- }>;
15
- /**
16
- * Generate a text transcription from an audio file
17
- * @param openai OpenAI instance
18
- * @param params transcription options
19
- * @param file audio file
20
- * @returns
21
- */
22
- export declare const createTranscription: (openai: OpenAI, params: Omit<OpenAI.Audio.Transcriptions.TranscriptionCreateParamsNonStreaming, 'file' | 'model'>, file: Uploadable) => Promise<OpenAI.Audio.Transcription & {
23
- _request_id?: string | null;
24
- }>;
25
- /**
26
- * Generate a speech audio file from a text message
27
- * @param openai OpenAI instance
28
- * @param params speech options
29
- * @param message text message
30
- * @returns
31
- */
32
- export declare const createSpeech: (openai: OpenAI, params: Omit<OpenAI.Audio.Speech.SpeechCreateParams, 'input' | 'model' | 'voice'>, message: string) => Promise<Response>;
33
- /**
34
- * Generate a function call completion from a prompt and message
35
- * @param openai OpenAI instance
36
- * @param params completion options
37
- * @param prompt base prompt
38
- * @param message input message
39
- * @param tools available functions to call
40
- * @returns
41
- */
42
- export declare const createFunctionCallCompletion: (openai: OpenAI, params: Omit<OpenAI.Chat.Completions.ChatCompletionCreateParams, 'stream' | 'messages'>, prompt: string, message: string, tools: OpenAI.ChatCompletionTool[]) => Promise<OpenAI.ChatCompletionMessageFunctionToolCall.Function[]>;
43
2
  /**
44
3
  * Generate an embedding from a text input
45
4
  * @param openai OpenAI instance
package/dist/chat/api.js CHANGED
@@ -1 +1 @@
1
- export const createCompletion=async(e,t,o,c,n)=>e.chat.completions.create({...t,messages:[{role:"system",content:o},...c],...n&&n.length>0?{tools:n,tool_choice:"auto"}:{},stream:!0});export const createTranscription=async(e,t,o)=>e.audio.transcriptions.create({...t,model:"whisper-1",file:o});export const createSpeech=async(e,t,o)=>e.audio.speech.create({...t,input:o,model:"tts-1",voice:"alloy"});export const createFunctionCallCompletion=async(e,t,o,c,n)=>{let a=await e.chat.completions.create({...t,messages:[{role:"system",content:o},{role:"user",content:c}],...n.length>0?{tools:n,tool_choice:1===n.length?n[0]:"auto"}:{}});return a.choices[0]?.message.tool_calls?.filter(e=>"function"===e.type).map(e=>e.function)??[]};export const createEmbedding=async(e,t,o)=>{let c=await e.embeddings.create({model:"text-embedding-3-small",...t,input:o});return c.data[0]?.embedding};
1
+ export const createEmbedding=async(e,d,t)=>{let a=await e.embeddings.create({model:"text-embedding-3-small",...d,input:t});return a.data[0]?.embedding};
@@ -22,7 +22,4 @@ export interface ChatMessageAugmentation {
22
22
  augmentation: Record<string, unknown>;
23
23
  }
24
24
  export type ChatStreamChunk = ChatMessageContentChunk | ChatToolCalls | ChatErrorChunk | ChatMessageAugmentation;
25
- export declare const isChatMessageContentChunk: (chunk: ChatStreamChunk) => chunk is ChatMessageContentChunk;
26
- export declare const isChatMessageAugmentation: (chunk: ChatStreamChunk) => chunk is ChatMessageAugmentation;
27
- export declare const isChatToolCalls: (chunk: ChatStreamChunk) => chunk is ChatToolCalls;
28
25
  export declare const isChatError: (chunk: ChatStreamChunk) => chunk is ChatErrorChunk;
@@ -1 +1 @@
1
- export const ChunkType={content:"content",calls:"calls",error:"error",augment:"augment"};export const isChatMessageContentChunk=t=>t.type===ChunkType.content;export const isChatMessageAugmentation=t=>t.type===ChunkType.augment;export const isChatToolCalls=t=>t.type===ChunkType.calls;export const isChatError=t=>t.type===ChunkType.error;
1
+ export const ChunkType={content:"content",calls:"calls",error:"error",augment:"augment"};export const isChatError=r=>r.type===ChunkType.error;
@@ -1,7 +1,6 @@
1
1
  import type OpenAI from 'openai';
2
2
  import type { Empty } from '../utils/types.js';
3
- import type { ChatExecutableFunction, ChatFunctionDefinition, ChatFunctionResult } from './types.js';
4
- export declare const createCompletionTool: <C extends Empty = Empty, R extends Empty = Empty>({ name, description, parameters, }: OpenAI.FunctionDefinition | ChatFunctionDefinition<C, R, any>) => OpenAI.ChatCompletionFunctionTool;
3
+ import type { ChatExecutableFunction, ChatFunctionResult } from './types.js';
5
4
  /**
6
5
  * Processes tool calls and generates array of return messages.
7
6
  *
@@ -1 +1 @@
1
- export const createCompletionTool=({name:t,description:n,parameters:o})=>({type:"function",function:{name:t,description:n,parameters:o}});export const processToolCalls=async(t,n,o,e)=>{let l=[];for(let r of t){let{id:t}=r,c={tool_call_id:t,role:"tool"};if("function"!==r.type){l.push({...c,content:`Tool call type '${r.type}' is not supported — only function tool calls can be processed by this handler.`});continue}let{function:i}=r;try{let t=n?.find(t=>t.name===i.name);if(!t){l.push({...c,content:`Function \`${i.name}\` not found`});continue}let s=JSON.parse(i.arguments??"{}"),a=t.validate(s);if(a){l.push({...c,content:a});continue}let u=await t.function(s,o);e?.(u,r),l.push({...c,content:u.result})}catch(o){let n=o instanceof Error?o.message:String(o);throw Error(`Call ${t} of function \`${i.name}\` resulted in error: ${n}`)}}return l};
1
+ export const processToolCalls=async(t,n,e,o)=>{let l=[];for(let r of t){let{id:t}=r,c={tool_call_id:t,role:"tool"};if("function"!==r.type){l.push({...c,content:`Tool call type '${r.type}' is not supported — only function tool calls can be processed by this handler.`});continue}let{function:s}=r;try{let t=n?.find(t=>t.name===s.name);if(!t){l.push({...c,content:`Function \`${s.name}\` not found`});continue}let a=JSON.parse(s.arguments??"{}"),i=t.validate(a);if(i){l.push({...c,content:i});continue}let u=await t.function(a,e);o?.(u,r),l.push({...c,content:u.result})}catch(e){let n=e instanceof Error?e.message:String(e);throw Error(`Call ${t} of function \`${s.name}\` resulted in error: ${n}`)}}return l};
@@ -1,10 +1,7 @@
1
- export { createCompletion, createFunctionCallCompletion, createTranscription as createSpeechToTextCompletion, createSpeech as createTextToSpeechCompletion, createEmbedding, } from './api.js';
2
- export { createAssistantMessage, createToolCallResultMessage } from './completions/messages.js';
3
- export { ChunkType, isChatMessageContentChunk, isChatMessageAugmentation, isChatToolCalls, isChatError, } from './completions/types.js';
1
+ export { createEmbedding } from './api.js';
2
+ export { ChunkType, isChatError } from './completions/types.js';
4
3
  export type { ChatMessageContentChunk, ChatToolCalls, ChatErrorChunk, ChatStreamChunk, ChatMessageAugmentation, } from './completions/types.js';
5
4
  export { createValidator } from './functions/validate.js';
6
- export { createChatFunctionDefinition as createFunctionDefintion, createChatExecutableFunction, } from './functions/create.js';
7
- export { simpleAugmentationHandler } from './functions/augmentations.js';
8
- export { processToolCalls, createCompletionTool } from './functions/process.js';
5
+ export { processToolCalls } from './functions/process.js';
9
6
  export type { ChatFunction, ChatExecutableFunction, ChatFunctionDefinition, ChatFunctionResult, } from './functions/types.js';
10
7
  export type { Empty } from './utils/types.js';
@@ -1 +1 @@
1
- export{createCompletion,createFunctionCallCompletion,createTranscription as createSpeechToTextCompletion,createSpeech as createTextToSpeechCompletion,createEmbedding}from"./api.js";export{createAssistantMessage,createToolCallResultMessage}from"./completions/messages.js";export{ChunkType,isChatMessageContentChunk,isChatMessageAugmentation,isChatToolCalls,isChatError}from"./completions/types.js";export{createValidator}from"./functions/validate.js";export{createChatFunctionDefinition as createFunctionDefintion,createChatExecutableFunction}from"./functions/create.js";export{simpleAugmentationHandler}from"./functions/augmentations.js";export{processToolCalls,createCompletionTool}from"./functions/process.js";
1
+ export{createEmbedding}from"./api.js";export{ChunkType,isChatError}from"./completions/types.js";export{createValidator}from"./functions/validate.js";export{processToolCalls}from"./functions/process.js";
@@ -0,0 +1,13 @@
1
+ import { Branded } from '@salsita-ai/common/utils';
2
+ /**
3
+ * How many weighted tokens the conversational assistant may use in a calendar month, set by a super admin in Studio
4
+ * on each environment and each customer. A weighted token is an output-token equivalent at gpt-6.1-sol list prices
5
+ * (1,000,000 is about $10), the same unit as the assistant's hourly limits. Once either the environment's or the
6
+ * customer's cap is used up, the server refuses new user messages until the next month.
7
+ */
8
+ export type AssistantMonthlyLimit = Branded<'AssistantMonthlyLimit', number>;
9
+ export declare const AssistantMonthlyLimit: (limit: number) => AssistantMonthlyLimit;
10
+ /** The cap of an environment nobody configured. */
11
+ export declare const DEFAULT_ENVIRONMENT_ASSISTANT_MONTHLY_LIMIT: AssistantMonthlyLimit;
12
+ /** The cap of a customer nobody configured, across all its environments. */
13
+ export declare const DEFAULT_CUSTOMER_ASSISTANT_MONTHLY_LIMIT: AssistantMonthlyLimit;
@@ -0,0 +1 @@
1
+ import{Branded as t}from"@salsita-ai/common/utils";export const AssistantMonthlyLimit=o=>{if(!Number.isSafeInteger(o)||o<0)throw Error(`Assistant monthly limit must be a non-negative whole number of weighted tokens up to ${Number.MAX_SAFE_INTEGER}, but it is ${o}. Enter 0 to turn the assistant off, or a positive whole number.`);return t(o)};export const DEFAULT_ENVIRONMENT_ASSISTANT_MONTHLY_LIMIT=AssistantMonthlyLimit(5e7);export const DEFAULT_CUSTOMER_ASSISTANT_MONTHLY_LIMIT=AssistantMonthlyLimit(1e8);
@@ -1,5 +1,6 @@
1
1
  import { z } from 'zod';
2
2
  import { Branded, type ValueOf } from '@salsita-ai/common/utils';
3
+ import type { AssistantMonthlyLimit } from './assistant-limit-domain.js';
3
4
  export type CustomerId = Branded<'CustomerId', string>;
4
5
  export declare const CustomerId: (id: string) => CustomerId;
5
6
  export type CustomerName = Branded<'CustomerName', string>;
@@ -64,6 +65,7 @@ export interface Customer {
64
65
  readonly aiPreviewEnabled: boolean;
65
66
  readonly aiAssistantEnabled: boolean;
66
67
  readonly aiImageLimit: number;
68
+ readonly aiAssistantMonthlyLimit: AssistantMonthlyLimit;
67
69
  readonly imageRenderLimitEnabled: boolean;
68
70
  }
69
71
  export {};
@@ -1,4 +1,5 @@
1
1
  import { Branded, type ValueOf } from '@salsita-ai/common/utils';
2
+ import type { ApiTokenId } from './api-token-domain.js';
2
3
  import type { DeploymentId } from './deployment-domain.js';
3
4
  import type { EnvironmentId } from './environment-domain.js';
4
5
  export type DeploymentBuildId = Branded<'DeploymentBuildId', string>;
@@ -58,7 +59,15 @@ export interface DeploymentBuild {
58
59
  readonly status: DeploymentBuildStatus;
59
60
  readonly sourceKey: DeploymentBuildSourceKey | null;
60
61
  readonly sdkVersion: string | null;
62
+ readonly rebuiltFrom: {
63
+ readonly buildId: DeploymentBuildId;
64
+ readonly number: number | null;
65
+ } | null;
61
66
  readonly createdByUserId: string | null;
67
+ readonly apiToken: {
68
+ readonly id: ApiTokenId;
69
+ readonly name: string;
70
+ } | null;
62
71
  readonly deploymentId: DeploymentId | null;
63
72
  readonly error: string | null;
64
73
  readonly createdAt: Date;
@@ -1,4 +1,5 @@
1
1
  import { Branded, type ValueOf } from '@salsita-ai/common/utils';
2
+ import type { AssistantMonthlyLimit } from './assistant-limit-domain.js';
2
3
  import { type CustomerClerkSettings } from './customer-domain.js';
3
4
  import type { AllowedOrigin, DeploymentId, PrivateS3Bucket, PublicS3Bucket } from './deployment-domain.js';
4
5
  import type { ImageRenderLimit } from './image-render-domain.js';
@@ -65,6 +66,7 @@ export interface Environment {
65
66
  readonly allowedOrigins: readonly AllowedOrigin[];
66
67
  readonly sessionLimit: SessionLimit;
67
68
  readonly imageRenderLimit: ImageRenderLimit;
69
+ readonly aiAssistantMonthlyLimit: AssistantMonthlyLimit;
68
70
  readonly publicS3Bucket: PublicS3Bucket;
69
71
  readonly privateS3Bucket: PrivateS3Bucket;
70
72
  readonly serviceName: ServiceName;
@@ -88,6 +90,7 @@ export interface NewEnvironment {
88
90
  readonly allowedOrigins: readonly AllowedOrigin[];
89
91
  readonly sessionLimit: SessionLimit;
90
92
  readonly imageRenderLimit: ImageRenderLimit;
93
+ readonly aiAssistantMonthlyLimit: AssistantMonthlyLimit;
91
94
  readonly publicS3Bucket: PublicS3Bucket;
92
95
  readonly privateS3Bucket: PrivateS3Bucket;
93
96
  readonly serviceName: ServiceName;
@@ -7,8 +7,9 @@ export { DeploymentBuild, DeploymentBuildId, DeploymentBuildMode, DeploymentBuil
7
7
  export { SdkBuilderSetupState } from './sdk-builder-setup-domain.js';
8
8
  export { API_TOKEN_NAME_MAX_LENGTH, ApiTokenId } from './api-token-domain.js';
9
9
  export { CustomerId, CustomerName, type Customer, CustomerClerkPublishableKey, CustomerClerkSecretKey, CustomerClerkJwtSecret, CustomerClerkOAuthBaseUrl, CustomerClerkOAuthClientId, CustomerClerkOAuthClientSecret, type CustomerClerkSettings, CustomerSlug, CustomerType, CustomerTypeSchema, } from './customer-domain.js';
10
- export { OAuthConnectionId, type OAuthConnectionProvider, OAuthRefreshToken, OAuthGrantedScopes, SHAREPOINT_MISSING_TENANT_DOMAIN, SharePointTenantDomainInvalidError, SharePointTenantDomainSchema, type NewOAuthConnection, type OAuthConnection, type SharePointProjectSite, OAUTH_STALE_CONNECTION_CODE, parseRequiredSharePointTenantDomain, parseSharePointTenantDomain, } from './oauth-connection-domain.js';
10
+ export { OAuthConnectionId, type OAuthConnectionProvider, OAuthRefreshToken, OAuthGrantedScopes, SHAREPOINT_MISSING_TENANT_DOMAIN, type NewOAuthConnection, type OAuthConnection, type SharePointProjectSite, OAUTH_STALE_CONNECTION_CODE, parseSharePointTenantDomain, } from './oauth-connection-domain.js';
11
11
  export { type Embeddings } from './embedding-domain.js';
12
12
  export { BucketTimestamp, SessionCount, type SessionBucket, type NewSessionBucket } from './session-domain.js';
13
13
  export { AiImageCount, type NewAiImageBucket } from './ai-image-domain.js';
14
14
  export { ImageRenderCount, ImageRenderLimit, DEFAULT_IMAGE_RENDER_LIMIT, type ImageRenderBucket, type NewImageRenderBucket, } from './image-render-domain.js';
15
+ export { AssistantMonthlyLimit, DEFAULT_ENVIRONMENT_ASSISTANT_MONTHLY_LIMIT, DEFAULT_CUSTOMER_ASSISTANT_MONTHLY_LIMIT, } from './assistant-limit-domain.js';
@@ -1 +1 @@
1
- export{EnvironmentId,EnvironmentName,EnvironmentSlug,EnvironmentType,FrontendUrl,DevelopmentKey,DEFAULT_SESSION_LIMIT,PRODUCTION_ENVIRONMENT_SLUG,SessionLimit,ServerKey,BaseDomain,ServiceName,FrontendBucketName,LambdaFunctionName,TfStateKeyPrefix,DdServiceName}from"./environment-domain.js";export{ConfigurationSchemaId,ConfigurationSchemaJsonSchema,ConfigurationSchemaVersion}from"./configuration-schema-domain.js";export{ApplicationType,AllowedOrigin,ChatConfiguration,DeploymentId,ResourceUrl,LambdaWebhookUrl,PrivateS3Bucket,PrivateDeploymentResourcesPath,PublicS3Bucket,PublicDeploymentResourcesPath,DeploymentApplicationId,OAuthProviderRegistration}from"./deployment-domain.js";export{DEFAULT_PROJECT_ALIAS,ProjectId,ProjectName,ProjectSlug,ProjectCustomDomain,ParamStorePath}from"./project-domain.js";export{OAuthProviderId,OAuthClientId,OAuthClientSecret,OAuthBaseUrl,OAuthProviderName,OAuthScopes}from"./oauth-provider-domain.js";export{DeploymentBuild,DeploymentBuildId,DeploymentBuildMode,DeploymentBuildSourceKey,DeploymentBuildStatus}from"./deployment-build-domain.js";export{SdkBuilderSetupState}from"./sdk-builder-setup-domain.js";export{API_TOKEN_NAME_MAX_LENGTH,ApiTokenId}from"./api-token-domain.js";export{CustomerId,CustomerName,CustomerClerkPublishableKey,CustomerClerkSecretKey,CustomerClerkJwtSecret,CustomerClerkOAuthBaseUrl,CustomerClerkOAuthClientId,CustomerClerkOAuthClientSecret,CustomerSlug,CustomerType,CustomerTypeSchema}from"./customer-domain.js";export{OAuthConnectionId,OAuthRefreshToken,OAuthGrantedScopes,SHAREPOINT_MISSING_TENANT_DOMAIN,SharePointTenantDomainInvalidError,SharePointTenantDomainSchema,OAUTH_STALE_CONNECTION_CODE,parseRequiredSharePointTenantDomain,parseSharePointTenantDomain}from"./oauth-connection-domain.js";export{BucketTimestamp,SessionCount}from"./session-domain.js";export{AiImageCount}from"./ai-image-domain.js";export{ImageRenderCount,ImageRenderLimit,DEFAULT_IMAGE_RENDER_LIMIT}from"./image-render-domain.js";
1
+ export{EnvironmentId,EnvironmentName,EnvironmentSlug,EnvironmentType,FrontendUrl,DevelopmentKey,DEFAULT_SESSION_LIMIT,PRODUCTION_ENVIRONMENT_SLUG,SessionLimit,ServerKey,BaseDomain,ServiceName,FrontendBucketName,LambdaFunctionName,TfStateKeyPrefix,DdServiceName}from"./environment-domain.js";export{ConfigurationSchemaId,ConfigurationSchemaJsonSchema,ConfigurationSchemaVersion}from"./configuration-schema-domain.js";export{ApplicationType,AllowedOrigin,ChatConfiguration,DeploymentId,ResourceUrl,LambdaWebhookUrl,PrivateS3Bucket,PrivateDeploymentResourcesPath,PublicS3Bucket,PublicDeploymentResourcesPath,DeploymentApplicationId,OAuthProviderRegistration}from"./deployment-domain.js";export{DEFAULT_PROJECT_ALIAS,ProjectId,ProjectName,ProjectSlug,ProjectCustomDomain,ParamStorePath}from"./project-domain.js";export{OAuthProviderId,OAuthClientId,OAuthClientSecret,OAuthBaseUrl,OAuthProviderName,OAuthScopes}from"./oauth-provider-domain.js";export{DeploymentBuild,DeploymentBuildId,DeploymentBuildMode,DeploymentBuildSourceKey,DeploymentBuildStatus}from"./deployment-build-domain.js";export{SdkBuilderSetupState}from"./sdk-builder-setup-domain.js";export{API_TOKEN_NAME_MAX_LENGTH,ApiTokenId}from"./api-token-domain.js";export{CustomerId,CustomerName,CustomerClerkPublishableKey,CustomerClerkSecretKey,CustomerClerkJwtSecret,CustomerClerkOAuthBaseUrl,CustomerClerkOAuthClientId,CustomerClerkOAuthClientSecret,CustomerSlug,CustomerType,CustomerTypeSchema}from"./customer-domain.js";export{OAuthConnectionId,OAuthRefreshToken,OAuthGrantedScopes,SHAREPOINT_MISSING_TENANT_DOMAIN,OAUTH_STALE_CONNECTION_CODE,parseSharePointTenantDomain}from"./oauth-connection-domain.js";export{BucketTimestamp,SessionCount}from"./session-domain.js";export{AiImageCount}from"./ai-image-domain.js";export{ImageRenderCount,ImageRenderLimit,DEFAULT_IMAGE_RENDER_LIMIT}from"./image-render-domain.js";export{AssistantMonthlyLimit,DEFAULT_ENVIRONMENT_ASSISTANT_MONTHLY_LIMIT,DEFAULT_CUSTOMER_ASSISTANT_MONTHLY_LIMIT}from"./assistant-limit-domain.js";
@@ -1,4 +1,3 @@
1
- import { z } from 'zod';
2
1
  import { Branded } from '@salsita-ai/common/utils';
3
2
  import { type ProjectId } from './project-domain.js';
4
3
  export type OAuthConnectionId = Branded<'OAuthConnectionId', string>;
@@ -16,13 +15,7 @@ export type OAuthGrantedScopes = Branded<'OAuthGrantedScopes', readonly string[]
16
15
  export declare const OAuthGrantedScopes: (scopes: readonly string[]) => OAuthGrantedScopes;
17
16
  export declare const OAUTH_STALE_CONNECTION_CODE: 'STALE_CONNECTION';
18
17
  export declare const SHAREPOINT_MISSING_TENANT_DOMAIN: 'fill-in-tenant-domain.invalid';
19
- export declare class SharePointTenantDomainInvalidError extends Error {
20
- readonly code: 'tenant_domain_invalid';
21
- constructor(tenantDomain: string, reason: string);
22
- }
23
18
  export declare const parseSharePointTenantDomain: (rawDomain: string) => string | null;
24
- export declare const parseRequiredSharePointTenantDomain: (rawDomain: string) => string;
25
- export declare const SharePointTenantDomainSchema: z.ZodEffects<z.ZodString, string, string>;
26
19
  /**
27
20
  * Per-project SharePoint site binding, independent of the user OAuth
28
21
  * connection model used by Google — Microsoft uses app-only auth
@@ -1 +1 @@
1
- import{validate as n}from"uuid";import{z as o}from"zod";import{Branded as t}from"@salsita-ai/common/utils";export const OAuthConnectionId=o=>{if(!n(o))throw Error(`Invalid OAuthConnection id: ${o}. It must be a valid UUID.`);return t(o)};export const OAuthRefreshToken=n=>t(n);export const OAuthGrantedScopes=n=>t(n);export const OAUTH_STALE_CONNECTION_CODE="STALE_CONNECTION";export const SHAREPOINT_MISSING_TENANT_DOMAIN="fill-in-tenant-domain.invalid";let e=/^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)+$/i;export class SharePointTenantDomainInvalidError extends Error{code="tenant_domain_invalid";constructor(n,o){super(`SharePoint tenant domain '${n}' is invalid. ${o}. Use a verified Azure AD tenant domain, e.g. 'contoso.onmicrosoft.com'.`),this.name="SharePointTenantDomainInvalidError"}}export const parseSharePointTenantDomain=n=>{let o=n.trim().toLowerCase();return o&&e.test(o)?o:null};export const parseRequiredSharePointTenantDomain=n=>{let o=parseSharePointTenantDomain(n);if(null===o)throw new SharePointTenantDomainInvalidError(n,"Expected a domain name");if("fill-in-tenant-domain.invalid"===o)throw new SharePointTenantDomainInvalidError(n,"This value is a migration placeholder");return o};export const SharePointTenantDomainSchema=o.string().transform((n,t)=>{try{return parseRequiredSharePointTenantDomain(n)}catch(n){if(n instanceof SharePointTenantDomainInvalidError)return t.addIssue({code:o.ZodIssueCode.custom,message:"Expected a verified Azure AD tenant domain, e.g. contoso.onmicrosoft.com."}),o.NEVER;throw n}});
1
+ import{validate as t}from"uuid";import{Branded as o}from"@salsita-ai/common/utils";export const OAuthConnectionId=n=>{if(!t(n))throw Error(`Invalid OAuthConnection id: ${n}. It must be a valid UUID.`);return o(n)};export const OAuthRefreshToken=t=>o(t);export const OAuthGrantedScopes=t=>o(t);export const OAUTH_STALE_CONNECTION_CODE="STALE_CONNECTION";export const SHAREPOINT_MISSING_TENANT_DOMAIN="fill-in-tenant-domain.invalid";let n=/^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)+$/i;export const parseSharePointTenantDomain=t=>{let o=t.trim().toLowerCase();return o&&n.test(o)?o:null};
@@ -50,13 +50,8 @@ export interface Revision {
50
50
  configurationId: ConfigurationId;
51
51
  configurationSchemaId: ConfigurationSchemaId;
52
52
  }
53
- export declare const PublishedDataRevisionKind: {
54
- readonly Regular: 'regular';
55
- readonly Chunked: 'chunked';
56
- };
57
- export type PublishedDataRevisionKind = (typeof PublishedDataRevisionKind)[keyof typeof PublishedDataRevisionKind];
58
53
  export interface PublishedDataRevision {
59
- readonly kind: typeof PublishedDataRevisionKind.Regular;
54
+ readonly kind: 'regular';
60
55
  readonly id: PublishedDataRevisionId;
61
56
  readonly finalizationUuid: FinalizationUuid;
62
57
  readonly uploadPath: PublishedDataRevisionUploadPath;
@@ -64,7 +59,7 @@ export interface PublishedDataRevision {
64
59
  readonly data: unknown;
65
60
  }
66
61
  export interface ChunkedPublishedDataRevision {
67
- readonly kind: typeof PublishedDataRevisionKind.Chunked;
62
+ readonly kind: 'chunked';
68
63
  readonly id: PublishedDataRevisionId;
69
64
  readonly finalizationUuid: FinalizationUuid;
70
65
  readonly publishedDataHash: string;
@@ -1 +1 @@
1
- import{validate as t}from"uuid";import{Branded as i}from"@salsita-ai/common/utils";export const ConfigurationId=r=>{if(!t(r))throw Error(`Invalid configuration id: ${r}. It must be a valid UUID.`);return i(r)};export const ConfigurationRootEntityType=t=>i(t);export const RevisionId=r=>{if(!t(r))throw Error(`Invalid revision id: ${r}. It must be a valid UUID.`);return i(r)};export const FinalizationUuid=r=>{if(!t(r))throw Error(`Invalid finalization id: ${r}. It must be a valid UUID.`);return i(r)};export const PublishedDataRevisionId=r=>{if(!t(r))throw Error(`Invalid published data revision id: ${r}. It must be a valid UUID.`);return i(r)};export const PublishedDataRevisionUploadPath=t=>i(t);export const PublishedDataRevisionVersion=t=>i(t);export const PublishedDataChunkId=r=>{if(!t(r))throw Error(`Invalid published data chunk id: ${r}. It must be a valid UUID.`);return i(r)};export const ChunkScope=t=>i(t);let r=/^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;export const ChunkKey=t=>{if(!r.test(t))throw Error(`Invalid chunk key '${t}'. Must be lowercase, start with a letter, and contain only letters, numbers, and hyphens.`);return i(t)};export const FinalizationJobId=t=>i(t);export const ShareId=r=>{if(!t(r))throw Error(`Invalid share id: ${r}. It must be a valid UUID.`);return i(r)};export const PublishedDataRevisionKind={Regular:"regular",Chunked:"chunked"};
1
+ import{validate as t}from"uuid";import{Branded as i}from"@salsita-ai/common/utils";export const ConfigurationId=r=>{if(!t(r))throw Error(`Invalid configuration id: ${r}. It must be a valid UUID.`);return i(r)};export const ConfigurationRootEntityType=t=>i(t);export const RevisionId=r=>{if(!t(r))throw Error(`Invalid revision id: ${r}. It must be a valid UUID.`);return i(r)};export const FinalizationUuid=r=>{if(!t(r))throw Error(`Invalid finalization id: ${r}. It must be a valid UUID.`);return i(r)};export const PublishedDataRevisionId=r=>{if(!t(r))throw Error(`Invalid published data revision id: ${r}. It must be a valid UUID.`);return i(r)};export const PublishedDataRevisionUploadPath=t=>i(t);export const PublishedDataRevisionVersion=t=>i(t);export const PublishedDataChunkId=r=>{if(!t(r))throw Error(`Invalid published data chunk id: ${r}. It must be a valid UUID.`);return i(r)};export const ChunkScope=t=>i(t);let r=/^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;export const ChunkKey=t=>{if(!r.test(t))throw Error(`Invalid chunk key '${t}'. Must be lowercase, start with a letter, and contain only letters, numbers, and hyphens.`);return i(t)};export const FinalizationJobId=t=>i(t);export const ShareId=r=>{if(!t(r))throw Error(`Invalid share id: ${r}. It must be a valid UUID.`);return i(r)};
@@ -1 +1 @@
1
- export { ConfigurationId, ConfigurationRootEntityType, RevisionId, type Revision, type NewRevision, PublishedDataRevisionKind, type PublishedDataRevision, type ChunkedPublishedDataRevision, type AnyPublishedDataRevision, type Configuration, type NewConfiguration, type Entity, FinalizationUuid, type Finalization, type NewFinalization, FinalizationJobId, PublishedDataRevisionId, PublishedDataRevisionUploadPath, PublishedDataRevisionVersion, PublishedDataChunkId, ChunkScope, ChunkKey, type PublishedDataChunk, type NewShare, type Share, ShareId, } from './configurations-domain.js';
1
+ export { ConfigurationId, ConfigurationRootEntityType, RevisionId, type Revision, type NewRevision, type PublishedDataRevision, type ChunkedPublishedDataRevision, type AnyPublishedDataRevision, type Configuration, type NewConfiguration, type Entity, FinalizationUuid, type Finalization, type NewFinalization, FinalizationJobId, PublishedDataRevisionId, PublishedDataRevisionUploadPath, PublishedDataRevisionVersion, PublishedDataChunkId, ChunkScope, ChunkKey, type PublishedDataChunk, type NewShare, type Share, ShareId, } from './configurations-domain.js';
@@ -1 +1 @@
1
- export{ConfigurationId,ConfigurationRootEntityType,RevisionId,PublishedDataRevisionKind,FinalizationUuid,FinalizationJobId,PublishedDataRevisionId,PublishedDataRevisionUploadPath,PublishedDataRevisionVersion,PublishedDataChunkId,ChunkScope,ChunkKey,ShareId}from"./configurations-domain.js";
1
+ export{ConfigurationId,ConfigurationRootEntityType,RevisionId,FinalizationUuid,FinalizationJobId,PublishedDataRevisionId,PublishedDataRevisionUploadPath,PublishedDataRevisionVersion,PublishedDataChunkId,ChunkScope,ChunkKey,ShareId}from"./configurations-domain.js";
@@ -0,0 +1,3 @@
1
+ import type { APIGatewayProxyStructuredResultV2 } from 'aws-lambda';
2
+ import type { FetchBackendDataHandlerResponse } from './webhook-api-types.js';
3
+ export declare const createBackendDataResponse: (result: FetchBackendDataHandlerResponse, acceptEncoding: string | undefined) => Promise<APIGatewayProxyStructuredResultV2>;
@@ -0,0 +1 @@
1
+ export const createBackendDataResponse=async(e,t)=>{let n,r,i,s=JSON.stringify(e),o={"content-type":"application/json",vary:"Accept-Encoding"};if(32768>Buffer.byteLength(s,"utf8")||!((i=(r=(n=(t??"").split(",").map(e=>{let[t,...n]=e.trim().toLowerCase().split(";"),r=n.map(e=>e.trim()).find(e=>e.startsWith("q=")),i=void 0===r?"1":r.slice(2).trim();return{encoding:t?.trim(),quality:/^(?:0(?:\.\d{0,3})?|1(?:\.0{0,3})?)$/.test(i)?Number(i):0}})).filter(e=>"gzip"===e.encoding)).length>0?r:n.filter(e=>"*"===e.encoding)).length>0&&i.every(e=>e.quality>0)))return{statusCode:200,headers:o,body:s};let a=await new Response(new Blob([s]).stream().pipeThrough(new CompressionStream("gzip"))).arrayBuffer(),p=Buffer.from(a).toString("base64");return p.length>=Buffer.byteLength(s,"utf8")?{statusCode:200,headers:o,body:s}:{statusCode:200,headers:{...o,"content-encoding":"gzip"},body:p,isBase64Encoded:!0}};
@@ -1,4 +1,3 @@
1
1
  export { routeWebhookRequests } from './webhook-routing.js';
2
2
  export { TunneledWebhookRequest, TunneledWebhookResponse, WebhookTunnelPollRequest, WebhookTunnelPollResponse, WebhookTunnelRespondRequest, } from './webhook-tunnel-types.js';
3
- export { WebhookClient, createUrlWebhookHttpClient, fetchWebhookHttpClient, type WebhookHttpClient, } from './webhook-client.js';
4
3
  export { AssistantSetupPayload, AssistantSetupResponse, AuthHandlerResponse, AuthUserIdSource, RefreshPayload, CodePayload, AuthPayload, AnonymousPayload, FinalizeWebhookPayload, CallbackPayload, CallbackResponse, FetchBackendDataPayload, FetchBackendDataHandlerResponse, } from './webhook-api-types.js';
@@ -1 +1 @@
1
- export{routeWebhookRequests}from"./webhook-routing.js";export{TunneledWebhookRequest,TunneledWebhookResponse,WebhookTunnelPollRequest,WebhookTunnelPollResponse,WebhookTunnelRespondRequest}from"./webhook-tunnel-types.js";export{WebhookClient,createUrlWebhookHttpClient,fetchWebhookHttpClient}from"./webhook-client.js";export{AssistantSetupPayload,AssistantSetupResponse,AuthHandlerResponse,AuthUserIdSource,RefreshPayload,CodePayload,AuthPayload,AnonymousPayload,FinalizeWebhookPayload,CallbackPayload,CallbackResponse,FetchBackendDataPayload,FetchBackendDataHandlerResponse}from"./webhook-api-types.js";
1
+ export{routeWebhookRequests}from"./webhook-routing.js";export{TunneledWebhookRequest,TunneledWebhookResponse,WebhookTunnelPollRequest,WebhookTunnelPollResponse,WebhookTunnelRespondRequest}from"./webhook-tunnel-types.js";export{AssistantSetupPayload,AssistantSetupResponse,AuthHandlerResponse,AuthUserIdSource,RefreshPayload,CodePayload,AuthPayload,AnonymousPayload,FinalizeWebhookPayload,CallbackPayload,CallbackResponse,FetchBackendDataPayload,FetchBackendDataHandlerResponse}from"./webhook-api-types.js";
@@ -345,16 +345,39 @@ export declare const AssistantSetupResponse: z.ZodObject<{
345
345
  model: z.ZodEnum<["frontier", "advanced", "balanced", "fast"]>;
346
346
  reasoning: z.ZodEnum<["low", "medium", "high"]>;
347
347
  maxThreadSize: z.ZodOptional<z.ZodNumber>;
348
+ hourlyLimits: z.ZodOptional<z.ZodObject<{
349
+ sub: z.ZodOptional<z.ZodNumber>;
350
+ ip: z.ZodOptional<z.ZodNumber>;
351
+ project: z.ZodOptional<z.ZodNumber>;
352
+ }, "strict", z.ZodTypeAny, {
353
+ sub?: number | undefined;
354
+ ip?: number | undefined;
355
+ project?: number | undefined;
356
+ }, {
357
+ sub?: number | undefined;
358
+ ip?: number | undefined;
359
+ project?: number | undefined;
360
+ }>>;
348
361
  }, "strict", z.ZodTypeAny, {
349
362
  provider: "openai";
350
363
  model: "advanced" | "balanced" | "fast" | "frontier";
351
364
  reasoning: "high" | "low" | "medium";
352
365
  maxThreadSize?: number | undefined;
366
+ hourlyLimits?: {
367
+ sub?: number | undefined;
368
+ ip?: number | undefined;
369
+ project?: number | undefined;
370
+ } | undefined;
353
371
  }, {
354
372
  provider: "openai";
355
373
  model: "advanced" | "balanced" | "fast" | "frontier";
356
374
  reasoning: "high" | "low" | "medium";
357
375
  maxThreadSize?: number | undefined;
376
+ hourlyLimits?: {
377
+ sub?: number | undefined;
378
+ ip?: number | undefined;
379
+ project?: number | undefined;
380
+ } | undefined;
358
381
  }>;
359
382
  }, "strict", z.ZodTypeAny, {
360
383
  sdl: string;
@@ -365,6 +388,11 @@ export declare const AssistantSetupResponse: z.ZodObject<{
365
388
  model: "advanced" | "balanced" | "fast" | "frontier";
366
389
  reasoning: "high" | "low" | "medium";
367
390
  maxThreadSize?: number | undefined;
391
+ hourlyLimits?: {
392
+ sub?: number | undefined;
393
+ ip?: number | undefined;
394
+ project?: number | undefined;
395
+ } | undefined;
368
396
  };
369
397
  }, {
370
398
  sdl: string;
@@ -375,6 +403,11 @@ export declare const AssistantSetupResponse: z.ZodObject<{
375
403
  model: "advanced" | "balanced" | "fast" | "frontier";
376
404
  reasoning: "high" | "low" | "medium";
377
405
  maxThreadSize?: number | undefined;
406
+ hourlyLimits?: {
407
+ sub?: number | undefined;
408
+ ip?: number | undefined;
409
+ project?: number | undefined;
410
+ } | undefined;
378
411
  };
379
412
  }>>;
380
413
  threadLock: z.ZodOptional<z.ZodLiteral<"strict">>;
@@ -388,6 +421,11 @@ export declare const AssistantSetupResponse: z.ZodObject<{
388
421
  model: "advanced" | "balanced" | "fast" | "frontier";
389
422
  reasoning: "high" | "low" | "medium";
390
423
  maxThreadSize?: number | undefined;
424
+ hourlyLimits?: {
425
+ sub?: number | undefined;
426
+ ip?: number | undefined;
427
+ project?: number | undefined;
428
+ } | undefined;
391
429
  };
392
430
  } | null;
393
431
  threadLock?: "strict" | undefined;
@@ -401,6 +439,11 @@ export declare const AssistantSetupResponse: z.ZodObject<{
401
439
  model: "advanced" | "balanced" | "fast" | "frontier";
402
440
  reasoning: "high" | "low" | "medium";
403
441
  maxThreadSize?: number | undefined;
442
+ hourlyLimits?: {
443
+ sub?: number | undefined;
444
+ ip?: number | undefined;
445
+ project?: number | undefined;
446
+ } | undefined;
404
447
  };
405
448
  } | null;
406
449
  threadLock?: "strict" | undefined;
@@ -1,14 +1,8 @@
1
1
  import type { APIGatewayProxyEventV2, LambdaFunctionURLResult } from 'aws-lambda';
2
2
  import type { Logger } from '@salsita-ai/common/utils';
3
- import { ApplicationType } from '../../domain/index.js';
4
3
  import { type WebhookFinalizeTaskConfiguration } from '../tasks/index.js';
5
4
  import type { AuthHandlerResponse, CallbackResponse, FetchBackendDataHandlerResponse } from './webhook-api-types.js';
6
5
  import { AssistantSetupPayload, AssistantSetupResponse, AuthPayload, CallbackPayload, FetchBackendDataPayload, FinalizeWebhookPayload } from './webhook-api-types.js';
7
- export declare const getAssistantSetupRoute: () => string;
8
- export declare const getAuthRoute: () => string;
9
- export declare const getFinalizeRoute: (applicationType: ApplicationType) => string;
10
- export declare const getCallbackRoute: () => string;
11
- export declare const getFetchBackendDataRoute: () => string;
12
6
  export declare const handleWebhookSafely: (handler: (e: APIGatewayProxyEventV2) => Promise<LambdaFunctionURLResult>, logger: Logger) => (event: APIGatewayProxyEventV2) => Promise<LambdaFunctionURLResult>;
13
7
  type CallbackHandler = (body: CallbackPayload<Record<string, unknown>, string>, e: APIGatewayProxyEventV2) => Promise<CallbackResponse<Record<string, unknown>>>;
14
8
  type FinalizeHandler = (body: FinalizeWebhookPayload<Record<string, unknown>, {
@@ -1 +1 @@
1
- import{P as o,match as t}from"ts-pattern";import{ApplicationType as r}from"../../domain/index.js";import{validateTaskConfiguration as n}from"../tasks/index.js";import{AssistantSetupPayload as e,AssistantSetupResponse as i,AuthPayload as a,CallbackPayload as s,FetchBackendDataPayload as f,FinalizeWebhookPayload as u}from"./webhook-api-types.js";let c="assistantSetup",h="auth",d="finalize",p="callback",l="fetchBackendData";export const getAssistantSetupRoute=()=>`?o=${c}`;export const getAuthRoute=()=>`?o=${h}`;export const getFinalizeRoute=o=>`?o=${d}&t=${o}`;export const getCallbackRoute=()=>`?o=${p}`;export const getFetchBackendDataRoute=()=>`?o=${l}`;export const handleWebhookSafely=(o,t)=>async r=>{try{return await o(r)}catch(n){let o=`Webhook failed: ${n instanceof Error?n.message:"Unknown error"}`,r="object"==typeof n&&n instanceof Error?n:Error(o);return t.error(o,{},r),{statusCode:500,body:JSON.stringify({message:o})}}};export const routeWebhookRequests=(g,w)=>handleWebhookSafely(async y=>{if(!y.body)throw Error("No body found in the webhook event!");let b=JSON.parse(y.isBase64Encoded?Buffer.from(y.body,"base64").toString():y.body);return t(y.queryStringParameters?.o).with(c,async()=>{if(!g.configurator?.onAssistantSetup)throw Error("Assistant setup operation is not configured for this webhook!");let o=await g.configurator.onAssistantSetup(e.parse(b),y);return{statusCode:200,body:JSON.stringify(i.parse(o))}}).with(h,async()=>{if(w.info("Handling auth operation."),!g.onAuth)throw Error("Auth operation is not configured for this webhook!");let o=a.parse(b);return{statusCode:200,body:JSON.stringify(await g.onAuth(o,y))}}).with(p,async()=>{if(w.info("Handling configurator callback operation."),!g.configurator?.onCallback)throw Error("Auth operation is not configured for this webhook!");let o=s.parse(b);return{statusCode:200,body:JSON.stringify(await g.configurator.onCallback(o,y))}}).with(o.union(void 0,d),()=>t(y.queryStringParameters?.t).with(r.Admin,async()=>{if(w.info("Handling admin finalize operation."),!g.admin?.onFinalize)throw Error("Admin finalize operation is not configured for this webhook!");let o=u.parse(b),t=await g.admin.onFinalize(o,y);return n(t),{statusCode:200,body:JSON.stringify(t)}}).with(o.union(void 0,r.Configurator),async()=>{if(w.info("Handling configurator finalize operation."),!g.configurator?.onFinalize)throw Error("Configurator finalize operation is not configured for this webhook!");let o=u.parse(b),t=await g.configurator.onFinalize(o,y);return n(t),{statusCode:200,body:JSON.stringify(t)}}).otherwise(o=>{throw Error(`Can not parse application type - unknown type: ${o}!`)})).with(l,async()=>{if(w.info("Handling fetch backend data operation."),!g.configurator?.onFetchBackendData)throw Error("Fetch backend data operation is not configured for this webhook!");let o=f.parse(b);return{statusCode:200,body:JSON.stringify(await g.configurator.onFetchBackendData(o,y))}}).otherwise(o=>{throw Error(`Can not parse webhook operation - unknown operation: ${o}!`)})},w);
1
+ import{P as o,match as r}from"ts-pattern";import{ApplicationType as t}from"../../domain/index.js";import{validateTaskConfiguration as n}from"../tasks/index.js";import{createBackendDataResponse as e}from"./backend-data-response.js";import{AssistantSetupPayload as i,AssistantSetupResponse as a,AuthPayload as s,CallbackPayload as f,FetchBackendDataPayload as d,FinalizeWebhookPayload as c}from"./webhook-api-types.js";export const handleWebhookSafely=(o,r)=>async t=>{try{return await o(t)}catch(n){let o=`Webhook failed: ${n instanceof Error?n.message:"Unknown error"}`,t="object"==typeof n&&n instanceof Error?n:Error(o);return r.error(o,{},t),{statusCode:500,body:JSON.stringify({message:o})}}};export const routeWebhookRequests=(h,u)=>handleWebhookSafely(async p=>{if(!p.body)throw Error("No body found in the webhook event!");let w=JSON.parse(p.isBase64Encoded?Buffer.from(p.body,"base64").toString():p.body);return r(p.queryStringParameters?.o).with("assistantSetup",async()=>{if(!h.configurator?.onAssistantSetup)throw Error("Assistant setup operation is not configured for this webhook!");let o=await h.configurator.onAssistantSetup(i.parse(w),p);return{statusCode:200,body:JSON.stringify(a.parse(o))}}).with("auth",async()=>{if(u.info("Handling auth operation."),!h.onAuth)throw Error("Auth operation is not configured for this webhook!");let o=s.parse(w);return{statusCode:200,body:JSON.stringify(await h.onAuth(o,p))}}).with("callback",async()=>{if(u.info("Handling configurator callback operation."),!h.configurator?.onCallback)throw Error("Auth operation is not configured for this webhook!");let o=f.parse(w);return{statusCode:200,body:JSON.stringify(await h.configurator.onCallback(o,p))}}).with(o.union(void 0,"finalize"),()=>r(p.queryStringParameters?.t).with(t.Admin,async()=>{if(u.info("Handling admin finalize operation."),!h.admin?.onFinalize)throw Error("Admin finalize operation is not configured for this webhook!");let o=c.parse(w),r=await h.admin.onFinalize(o,p);return n(r),{statusCode:200,body:JSON.stringify(r)}}).with(o.union(void 0,t.Configurator),async()=>{if(u.info("Handling configurator finalize operation."),!h.configurator?.onFinalize)throw Error("Configurator finalize operation is not configured for this webhook!");let o=c.parse(w),r=await h.configurator.onFinalize(o,p);return n(r),{statusCode:200,body:JSON.stringify(r)}}).otherwise(o=>{throw Error(`Can not parse application type - unknown type: ${o}!`)})).with("fetchBackendData",async()=>{if(u.info("Handling fetch backend data operation."),!h.configurator?.onFetchBackendData)throw Error("Fetch backend data operation is not configured for this webhook!");let o=d.parse(w);return e(await h.configurator.onFetchBackendData(o,p),Object.entries(p.headers).find(([o])=>"accept-encoding"===o.toLowerCase())?.[1])}).otherwise(o=>{throw Error(`Can not parse webhook operation - unknown operation: ${o}!`)})},u);
@@ -28,23 +28,29 @@ export declare const TunneledWebhookResponse: z.ZodObject<{
28
28
  status: z.ZodNumber;
29
29
  headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
30
30
  body: z.ZodString;
31
+ isBase64Encoded: z.ZodOptional<z.ZodBoolean>;
31
32
  }, "strip", z.ZodTypeAny, {
32
33
  status: number;
33
34
  headers?: Record<string, string> | undefined;
34
35
  body: string;
36
+ isBase64Encoded?: boolean | undefined;
35
37
  }, {
36
38
  status: number;
37
39
  headers?: Record<string, string> | undefined;
38
40
  body: string;
41
+ isBase64Encoded?: boolean | undefined;
39
42
  }>;
40
43
  export type TunneledWebhookResponse = z.infer<typeof TunneledWebhookResponse>;
41
44
  /** Payload used to claim a development deployment and wait for its next webhook request. */
42
45
  export declare const WebhookTunnelPollRequest: z.ZodObject<{
43
46
  sessionId: z.ZodString;
47
+ acceptResponseEncoding: z.ZodOptional<z.ZodLiteral<"gzip">>;
44
48
  }, "strip", z.ZodTypeAny, {
45
49
  sessionId: string;
50
+ acceptResponseEncoding?: "gzip" | undefined;
46
51
  }, {
47
52
  sessionId: string;
53
+ acceptResponseEncoding?: "gzip" | undefined;
48
54
  }>;
49
55
  export type WebhookTunnelPollRequest = z.infer<typeof WebhookTunnelPollRequest>;
50
56
  /** Result of waiting for the next tunneled webhook request. */
@@ -98,17 +104,20 @@ export declare const WebhookTunnelRespondRequest: z.ZodObject<{
98
104
  status: z.ZodNumber;
99
105
  headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
100
106
  body: z.ZodString;
107
+ isBase64Encoded: z.ZodOptional<z.ZodBoolean>;
101
108
  }, "strip", z.ZodTypeAny, {
102
109
  sessionId: string;
103
110
  requestId: string;
104
111
  status: number;
105
112
  headers?: Record<string, string> | undefined;
106
113
  body: string;
114
+ isBase64Encoded?: boolean | undefined;
107
115
  }, {
108
116
  sessionId: string;
109
117
  requestId: string;
110
118
  status: number;
111
119
  headers?: Record<string, string> | undefined;
112
120
  body: string;
121
+ isBase64Encoded?: boolean | undefined;
113
122
  }>;
114
123
  export type WebhookTunnelRespondRequest = z.infer<typeof WebhookTunnelRespondRequest>;
@@ -1 +1 @@
1
- import{z as e}from"zod";export const TunneledWebhookRequest=e.object({requestId:e.string(),url:e.string(),method:e.string(),headers:e.record(e.string()),body:e.string().nullable(),deadline:e.number()});export const TunneledWebhookResponse=e.object({status:e.number().int(),headers:e.record(e.string()).optional(),body:e.string()});export const WebhookTunnelPollRequest=e.object({sessionId:e.string()});export const WebhookTunnelPollResponse=e.object({request:TunneledWebhookRequest.nullable()});export const WebhookTunnelRespondRequest=e.object({sessionId:e.string(),requestId:e.string(),status:e.number().int(),headers:e.record(e.string()).optional(),body:e.string()});
1
+ import{z as e}from"zod";export const TunneledWebhookRequest=e.object({requestId:e.string(),url:e.string(),method:e.string(),headers:e.record(e.string()),body:e.string().nullable(),deadline:e.number()});export const TunneledWebhookResponse=e.object({status:e.number().int(),headers:e.record(e.string()).optional(),body:e.string(),isBase64Encoded:e.boolean().optional()});export const WebhookTunnelPollRequest=e.object({sessionId:e.string(),acceptResponseEncoding:e.literal("gzip").optional()});export const WebhookTunnelPollResponse=e.object({request:TunneledWebhookRequest.nullable()});export const WebhookTunnelRespondRequest=e.object({sessionId:e.string(),requestId:e.string(),status:e.number().int(),headers:e.record(e.string()).optional(),body:e.string(),isBase64Encoded:e.boolean().optional()});
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@salsita-ai/contracts",
3
- "version": "0.50.0-develop.f101f4c3c9",
3
+ "version": "0.50.0-develop.f354d3576d",
4
4
  "description": "Shared API, authentication, domain, chat, and webhook contracts for Phoenix.",
5
5
  "keywords": [
6
6
  "salsita",
@@ -54,7 +54,7 @@
54
54
  "uuid": "14.0.0",
55
55
  "valid-url": "1.0.9",
56
56
  "zod": "3.25.76",
57
- "@salsita-ai/common": "0.50.0-develop.f101f4c3c9"
57
+ "@salsita-ai/common": "0.50.0-develop.f354d3576d"
58
58
  },
59
59
  "devDependencies": {
60
60
  "@lingui/core": "5.9.5",
@@ -1,16 +0,0 @@
1
- /**
2
- * Client-side tool of the assistant chat: the browser draws its own details (user agent, viewport,
3
- * pixel ratio, language) onto a canvas and returns the capture as an image content part. It carries
4
- * no domain meaning; it proves that a client tool result reaches the model as an image.
5
- *
6
- * The server passes the definition to the model without an implementation, so every call becomes a
7
- * client-tool interrupt; the SDK registers the browser implementation via `.client()`.
8
- *
9
- * The input schema is plain JSON Schema because `@tanstack/ai` converts only schemas that expose
10
- * `~standard.jsonSchema` (Zod 4.2+), which the workspace's Zod 3 does not.
11
- */
12
- export declare const browserDetailsTool: import("@tanstack/ai").ToolDefinition<{
13
- type: string;
14
- properties: {};
15
- required: never[];
16
- }, undefined, "getBrowserDetails", false, undefined>;
@@ -1 +0,0 @@
1
- import{toolDefinition as e}from"@tanstack/ai";export const browserDetailsTool=e({name:"getBrowserDetails",description:"Call when the user asks about their browser, screen or device. Returns their browser details as an image.",inputSchema:{type:"object",properties:{},required:[]}});
@@ -1,3 +0,0 @@
1
- import type OpenAI from 'openai';
2
- export declare const createAssistantMessage: (content?: string, toolCalls?: OpenAI.Chat.Completions.ChatCompletionMessageToolCall[]) => OpenAI.ChatCompletionAssistantMessageParam;
3
- export declare const createToolCallResultMessage: (content: string, toolCallId: string) => OpenAI.Chat.Completions.ChatCompletionToolMessageParam;
@@ -1 +0,0 @@
1
- export const createAssistantMessage=(t,o)=>({role:"assistant",...t?{content:t}:void 0,...o?{tool_calls:o.filter(t=>"function"===t.type).map(t=>({id:t.id,function:t.function,type:"function"}))}:void 0});export const createToolCallResultMessage=(t,o)=>({role:"tool",content:t,tool_call_id:o});
@@ -1,3 +0,0 @@
1
- import type { Empty } from '../utils/types.js';
2
- import { type ChatFunction } from './types.js';
3
- export declare const simpleAugmentationHandler: <P>(key: keyof P) => ChatFunction<Empty, Empty, P>;
@@ -1 +0,0 @@
1
- export const simpleAugmentationHandler=t=>e=>({result:e[t]?JSON.stringify(e):""});
@@ -1,5 +0,0 @@
1
- import type { JSONSchemaType } from 'ajv';
2
- import type { Empty } from '../utils/types.js';
3
- import type { ChatExecutableFunction, ChatFunction, ChatFunctionDefinition } from './types.js';
4
- export declare const createChatExecutableFunction: <C extends Empty = Empty, R extends Empty = Empty, P = undefined>(name: string, parameters: JSONSchemaType<P> | undefined, func: ChatFunction<C, R, P>) => ChatExecutableFunction<C, R, P>;
5
- export declare const createChatFunctionDefinition: <C extends Empty = Empty, R extends Empty = Empty, P = undefined>(name: string, description: string, parameters: JSONSchemaType<P> | undefined, func: ChatFunction<C, R, P>) => ChatFunctionDefinition<C, R, P>;
@@ -1 +0,0 @@
1
- import{createValidator as t}from"./validate.js";export const createChatExecutableFunction=(e,a,n)=>({name:e,function:n,validate:t(a)});export const createChatFunctionDefinition=(t,e,a,n)=>({description:e,parameters:a,...createChatExecutableFunction(t,a,n)});
@@ -1,86 +0,0 @@
1
- import type { ApplicationType } from '../../domain/index.js';
2
- import { type AssistantSetupPayload, AssistantSetupResponse, type CallbackPayload, CallbackResponse, type FetchBackendDataPayload, type FinalizeWebhookPayload } from './webhook-api-types.js';
3
- export type WebhookHttpClient = (url: string, init: RequestInit) => Promise<Response>;
4
- export declare const fetchWebhookHttpClient: WebhookHttpClient;
5
- export declare const createUrlWebhookHttpClient: (baseUrl: string, httpClient?: WebhookHttpClient) => WebhookHttpClient;
6
- export declare class WebhookClient {
7
- private readonly _httpClient;
8
- constructor(httpClient: WebhookHttpClient);
9
- /** @deprecated Pass createUrlWebhookHttpClient(baseUrl, httpClient) instead. This overload will be removed in a future version. */
10
- constructor(baseUrl: string, httpClient?: WebhookHttpClient);
11
- handleRefreshFlow: (refreshToken: string) => Promise<{
12
- success: true;
13
- data: Record<string, unknown>;
14
- role: "admin" | "anonymous" | "superadmin" | "user";
15
- refreshToken?: string | undefined;
16
- expirationTime?: number | undefined;
17
- scopes?: string[] | undefined;
18
- userId?: string | undefined;
19
- userIdSource?: "clerk" | "custom" | undefined;
20
- } | {
21
- success: false;
22
- }>;
23
- handleCodeFlow: (accessToken: string, refreshToken: string | undefined, idToken: string | undefined) => Promise<{
24
- success: true;
25
- data: Record<string, unknown>;
26
- role: "admin" | "anonymous" | "superadmin" | "user";
27
- refreshToken?: string | undefined;
28
- expirationTime?: number | undefined;
29
- scopes?: string[] | undefined;
30
- userId?: string | undefined;
31
- userIdSource?: "clerk" | "custom" | undefined;
32
- } | {
33
- success: false;
34
- }>;
35
- handleAnonymousFlow: () => Promise<{
36
- success: true;
37
- data: Record<string, unknown>;
38
- role: "admin" | "anonymous" | "superadmin" | "user";
39
- refreshToken?: string | undefined;
40
- expirationTime?: number | undefined;
41
- scopes?: string[] | undefined;
42
- userId?: string | undefined;
43
- userIdSource?: "clerk" | "custom" | undefined;
44
- } | {
45
- success: false;
46
- }>;
47
- finalize: (data: FinalizeWebhookPayload<Record<string, unknown>, {
48
- id: string;
49
- type: string;
50
- }, Record<string, unknown>, Record<string, unknown>>, applicationType: ApplicationType) => Promise<{
51
- dataVersion: 1;
52
- tasks: (import("../tasks/call-lambda-back-task.js").CallLambdaBackTask<Record<string, unknown>, string> | import("../tasks/edit-google-spreadsheet-task.js").EditGoogleSpreadsheetTask | import("../tasks/generate-csv-task.js").GenerateCsvTask | import("../tasks/generate-images-task.js").GenerateImagesTask | import("../tasks/generate-pdf-task.js").GeneratePdfTask | import("../tasks/generate-pdf-task.js").GenerateStaticPdfTask | import("../tasks/send-email-task.js").SendEmailTask | import("../tasks/send-http-task.js").SendHttpRequestTask | import("../tasks/send-email-task.js").SendStaticEmailTask | import("../tasks/woocommerce-add-to-cart-task.js").WooCommerceAddToCartTask | {
53
- type: "GenerateConfigurationLink";
54
- name: string;
55
- frontendUrl: string & import("@salsita-ai/common/utils").Brand<"FrontendUrl">;
56
- expiration?: number | undefined;
57
- access: "o" | "r" | "rr";
58
- configurationId: string & import("@salsita-ai/common/utils").Brand<"ConfigurationId">;
59
- revisionId?: import("../../domain/index.js").RevisionId | undefined;
60
- } | {
61
- type: "PublishRevision";
62
- version: number & import("@salsita-ai/common/utils").Brand<"PublishedDataRevisionVersion">;
63
- revisionId: string & import("@salsita-ai/common/utils").Brand<"RevisionId">;
64
- data: Record<string, unknown>;
65
- } | {
66
- type: "PublishRevisionChunks";
67
- revisionId: string & import("@salsita-ai/common/utils").Brand<"RevisionId">;
68
- chunks: {
69
- key: string & import("@salsita-ai/common/utils").Brand<"ChunkKey">;
70
- scope: string & import("@salsita-ai/common/utils").Brand<"ChunkScope">;
71
- data: Record<string, unknown>;
72
- }[];
73
- publishedDataHash: string;
74
- } | {
75
- type: "PublishRevisionChunksStaged";
76
- revisionId: string & import("@salsita-ai/common/utils").Brand<"RevisionId">;
77
- publishedDataHash: string;
78
- })[];
79
- resources: import("../index.js").FinalizeTaskResource<string>[];
80
- }>;
81
- callback: (payload: CallbackPayload<Record<string, unknown>, string>) => Promise<CallbackResponse<Record<string, unknown>>>;
82
- assistantSetup: (payload: AssistantSetupPayload) => Promise<AssistantSetupResponse>;
83
- fetchBackendData: (payload: FetchBackendDataPayload<Record<string, unknown>, Record<string, unknown>>) => Promise<{
84
- backendData: Record<string, unknown>;
85
- }>;
86
- }
@@ -1 +0,0 @@
1
- import{WebhookFinalizeTaskConfiguration as t}from"../tasks/index.js";import{AssistantSetupResponse as e,AuthHandlerResponse as a,CallbackResponse as o,FetchBackendDataHandlerResponse as i}from"./webhook-api-types.js";import{getAssistantSetupRoute as n,getAuthRoute as r,getCallbackRoute as s,getFetchBackendDataRoute as l,getFinalizeRoute as h}from"./webhook-routing.js";export const fetchWebhookHttpClient=(t,e)=>fetch(t,e);export const createUrlWebhookHttpClient=(t,e=fetchWebhookHttpClient)=>(a,o)=>e(`${t}${a}`,o);export class WebhookClient{_httpClient;constructor(t,e=fetchWebhookHttpClient){this._httpClient="string"==typeof t?createUrlWebhookHttpClient(t,e):t}handleRefreshFlow=async t=>{let e=await this._httpClient(r(),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({type:"refresh",refreshToken:t})});if(!e.ok)throw Error(`Refresh webhook call failed: ${await e.text()}`);return a.parse(await e.json())};handleCodeFlow=async(t,e,o)=>{let i=await this._httpClient(r(),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({type:"code",accessToken:t,refreshToken:e,idToken:o})});if(!i.ok)throw Error(`Refresh webhook call failed: ${await i.text()}`);return a.parse(await i.json())};handleAnonymousFlow=async()=>{let t=await this._httpClient(r(),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({type:"anonymous"})});if(!t.ok)throw Error(`Refresh webhook call failed: ${await t.text()}`);return a.parse(await t.json())};finalize=async(e,a)=>{let o=await this._httpClient(h(a),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(e)});if(!o.ok)throw Error("Lambda call failed: "+await o.text());let i=await o.json();return t.parse(i)};callback=async t=>{let e=await this._httpClient(s(),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t)});if(!e.ok)throw Error("Lambda call failed: "+await e.text());let a=await e.json();return o.parse(a)};assistantSetup=async t=>{let a=await this._httpClient(n(),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t)});if(!a.ok)throw Error(`Assistant setup lambda call failed: ${await a.text()}`);return e.parse(await a.json())};fetchBackendData=async t=>{let e=await this._httpClient(l(),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t)});if(!e.ok)throw Error("Lambda call failed: "+await e.text());return i.parse(await e.json())}}