@salsita-ai/contracts 0.50.0-develop.0b927f4a8c → 0.50.0-develop.0d2418cc3b

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 (65) hide show
  1. package/README.md +10 -3
  2. package/dist/api/index.d.ts +1 -0
  3. package/dist/api/index.js +1 -1
  4. package/dist/api/studio-session.d.ts +57 -0
  5. package/dist/api/studio-session.js +1 -0
  6. package/dist/assistant/ban-tool.d.ts +17 -0
  7. package/dist/assistant/ban-tool.js +1 -0
  8. package/dist/assistant/deployment-assistant.d.ts +97 -0
  9. package/dist/assistant/deployment-assistant.js +1 -1
  10. package/dist/assistant/graphql-tools.d.ts +14 -1
  11. package/dist/assistant/graphql-tools.js +1 -1
  12. package/dist/assistant/image-reference.d.ts +10 -0
  13. package/dist/assistant/image-reference.js +1 -0
  14. package/dist/assistant/index.d.ts +5 -4
  15. package/dist/assistant/index.js +1 -1
  16. package/dist/assistant/message-metadata.d.ts +115 -1
  17. package/dist/assistant/message-metadata.js +1 -1
  18. package/dist/chat/api.d.ts +0 -41
  19. package/dist/chat/api.js +1 -1
  20. package/dist/chat/completions/types.d.ts +0 -3
  21. package/dist/chat/completions/types.js +1 -1
  22. package/dist/chat/functions/process.d.ts +1 -2
  23. package/dist/chat/functions/process.js +1 -1
  24. package/dist/chat/index.d.ts +3 -6
  25. package/dist/chat/index.js +1 -1
  26. package/dist/domain/deployments/assistant-limit-domain.d.ts +13 -0
  27. package/dist/domain/deployments/assistant-limit-domain.js +1 -0
  28. package/dist/domain/deployments/customer-domain.d.ts +2 -0
  29. package/dist/domain/deployments/deployment-build-domain.d.ts +10 -0
  30. package/dist/domain/deployments/environment-domain.d.ts +3 -0
  31. package/dist/domain/deployments/index.d.ts +2 -1
  32. package/dist/domain/deployments/index.js +1 -1
  33. package/dist/domain/deployments/oauth-connection-domain.d.ts +0 -7
  34. package/dist/domain/deployments/oauth-connection-domain.js +1 -1
  35. package/dist/domain/index.d.ts +2 -0
  36. package/dist/domain/index.js +1 -1
  37. package/dist/domain/product-configurations/configurations-domain.d.ts +2 -7
  38. package/dist/domain/product-configurations/configurations-domain.js +1 -1
  39. package/dist/domain/product-configurations/index.d.ts +1 -1
  40. package/dist/domain/product-configurations/index.js +1 -1
  41. package/dist/domain/workspace-invitation-role.d.ts +7 -0
  42. package/dist/domain/workspace-invitation-role.js +1 -0
  43. package/dist/domain/workspace-invitation.d.ts +7 -0
  44. package/dist/domain/workspace-invitation.js +1 -0
  45. package/dist/webhook/implementation/backend-data-response.d.ts +3 -0
  46. package/dist/webhook/implementation/backend-data-response.js +1 -0
  47. package/dist/webhook/implementation/index.d.ts +0 -1
  48. package/dist/webhook/implementation/index.js +1 -1
  49. package/dist/webhook/implementation/webhook-api-types.d.ts +58 -1
  50. package/dist/webhook/implementation/webhook-api-types.js +1 -1
  51. package/dist/webhook/implementation/webhook-routing.d.ts +0 -6
  52. package/dist/webhook/implementation/webhook-routing.js +1 -1
  53. package/dist/webhook/implementation/webhook-tunnel-types.d.ts +9 -0
  54. package/dist/webhook/implementation/webhook-tunnel-types.js +1 -1
  55. package/package.json +2 -6
  56. package/dist/assistant/browser-details-tool.d.ts +0 -16
  57. package/dist/assistant/browser-details-tool.js +0 -1
  58. package/dist/chat/completions/messages.d.ts +0 -3
  59. package/dist/chat/completions/messages.js +0 -1
  60. package/dist/chat/functions/augmentations.d.ts +0 -3
  61. package/dist/chat/functions/augmentations.js +0 -1
  62. package/dist/chat/functions/create.d.ts +0 -5
  63. package/dist/chat/functions/create.js +0 -1
  64. package/dist/webhook/implementation/webhook-client.d.ts +0 -86
  65. package/dist/webhook/implementation/webhook-client.js +0 -1
@@ -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>;
@@ -53,11 +54,20 @@ export declare const DeploymentBuildStatus: ((value: string) => DeploymentBuildS
53
54
  export interface DeploymentBuild {
54
55
  readonly id: DeploymentBuildId;
55
56
  readonly environmentId: EnvironmentId;
57
+ readonly number: number | null;
56
58
  readonly mode: DeploymentBuildMode;
57
59
  readonly status: DeploymentBuildStatus;
58
60
  readonly sourceKey: DeploymentBuildSourceKey | null;
59
61
  readonly sdkVersion: string | null;
62
+ readonly rebuiltFrom: {
63
+ readonly buildId: DeploymentBuildId;
64
+ readonly number: number | null;
65
+ } | null;
60
66
  readonly createdByUserId: string | null;
67
+ readonly apiToken: {
68
+ readonly id: ApiTokenId;
69
+ readonly name: string;
70
+ } | null;
61
71
  readonly deploymentId: DeploymentId | null;
62
72
  readonly error: string | null;
63
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};
@@ -1,3 +1,5 @@
1
1
  export * from './deployments/index.js';
2
2
  export * from './feedback/index.js';
3
3
  export * from './product-configurations/index.js';
4
+ export { WorkspaceInvitationStatus } from './workspace-invitation.js';
5
+ export { WorkspaceInvitationRole } from './workspace-invitation-role.js';
@@ -1 +1 @@
1
- export*from"./deployments/index.js";export*from"./feedback/index.js";export*from"./product-configurations/index.js";
1
+ export*from"./deployments/index.js";export*from"./feedback/index.js";export*from"./product-configurations/index.js";export{WorkspaceInvitationStatus}from"./workspace-invitation.js";export{WorkspaceInvitationRole}from"./workspace-invitation-role.js";
@@ -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,7 @@
1
+ /** Workspace access granted on acceptance; first-owner invitations always grant SuperAdmin. */
2
+ export declare const WorkspaceInvitationRole: {
3
+ readonly User: 'user';
4
+ readonly Admin: 'admin';
5
+ readonly SuperAdmin: 'superadmin';
6
+ };
7
+ export type WorkspaceInvitationRole = (typeof WorkspaceInvitationRole)[keyof typeof WorkspaceInvitationRole];
@@ -0,0 +1 @@
1
+ export const WorkspaceInvitationRole={User:"user",Admin:"admin",SuperAdmin:"superadmin"};
@@ -0,0 +1,7 @@
1
+ /** Lifecycle of an email invitation, with expiry derived from its current deadline. */
2
+ export declare const WorkspaceInvitationStatus: {
3
+ readonly Pending: 'pending';
4
+ readonly Expired: 'expired';
5
+ readonly Accepted: 'accepted';
6
+ readonly Revoked: 'revoked';
7
+ };
@@ -0,0 +1 @@
1
+ export const WorkspaceInvitationStatus={Pending:"pending",Expired:"expired",Accepted:"accepted",Revoked:"revoked"};
@@ -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";
@@ -330,7 +330,11 @@ export declare const AssistantSetupPayload: z.ZodObject<{
330
330
  access: "o" | "r" | "rr";
331
331
  }>;
332
332
  export type AssistantSetupPayload = z.infer<typeof AssistantSetupPayload>;
333
- /** A deployment's assistant setup, or a session for which no assistant is available. */
333
+ /**
334
+ * A deployment's assistant setup, or a session for which no assistant is available. `threadLock`
335
+ * is outside the setup a thread is bound to: `'strict'` asks a development environment to lock a
336
+ * thread when the setup changes, as every other environment always does.
337
+ */
334
338
  export declare const AssistantSetupResponse: z.ZodObject<{
335
339
  setup: z.ZodNullable<z.ZodObject<{
336
340
  sdl: z.ZodString;
@@ -340,14 +344,40 @@ export declare const AssistantSetupResponse: z.ZodObject<{
340
344
  provider: z.ZodEnum<["openai"]>;
341
345
  model: z.ZodEnum<["frontier", "advanced", "balanced", "fast"]>;
342
346
  reasoning: z.ZodEnum<["low", "medium", "high"]>;
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
+ }>>;
343
361
  }, "strict", z.ZodTypeAny, {
344
362
  provider: "openai";
345
363
  model: "advanced" | "balanced" | "fast" | "frontier";
346
364
  reasoning: "high" | "low" | "medium";
365
+ maxThreadSize?: number | undefined;
366
+ hourlyLimits?: {
367
+ sub?: number | undefined;
368
+ ip?: number | undefined;
369
+ project?: number | undefined;
370
+ } | undefined;
347
371
  }, {
348
372
  provider: "openai";
349
373
  model: "advanced" | "balanced" | "fast" | "frontier";
350
374
  reasoning: "high" | "low" | "medium";
375
+ maxThreadSize?: number | undefined;
376
+ hourlyLimits?: {
377
+ sub?: number | undefined;
378
+ ip?: number | undefined;
379
+ project?: number | undefined;
380
+ } | undefined;
351
381
  }>;
352
382
  }, "strict", z.ZodTypeAny, {
353
383
  sdl: string;
@@ -357,6 +387,12 @@ export declare const AssistantSetupResponse: z.ZodObject<{
357
387
  provider: "openai";
358
388
  model: "advanced" | "balanced" | "fast" | "frontier";
359
389
  reasoning: "high" | "low" | "medium";
390
+ maxThreadSize?: number | undefined;
391
+ hourlyLimits?: {
392
+ sub?: number | undefined;
393
+ ip?: number | undefined;
394
+ project?: number | undefined;
395
+ } | undefined;
360
396
  };
361
397
  }, {
362
398
  sdl: string;
@@ -366,8 +402,15 @@ export declare const AssistantSetupResponse: z.ZodObject<{
366
402
  provider: "openai";
367
403
  model: "advanced" | "balanced" | "fast" | "frontier";
368
404
  reasoning: "high" | "low" | "medium";
405
+ maxThreadSize?: number | undefined;
406
+ hourlyLimits?: {
407
+ sub?: number | undefined;
408
+ ip?: number | undefined;
409
+ project?: number | undefined;
410
+ } | undefined;
369
411
  };
370
412
  }>>;
413
+ threadLock: z.ZodOptional<z.ZodLiteral<"strict">>;
371
414
  }, "strict", z.ZodTypeAny, {
372
415
  setup: {
373
416
  sdl: string;
@@ -377,8 +420,15 @@ export declare const AssistantSetupResponse: z.ZodObject<{
377
420
  provider: "openai";
378
421
  model: "advanced" | "balanced" | "fast" | "frontier";
379
422
  reasoning: "high" | "low" | "medium";
423
+ maxThreadSize?: number | undefined;
424
+ hourlyLimits?: {
425
+ sub?: number | undefined;
426
+ ip?: number | undefined;
427
+ project?: number | undefined;
428
+ } | undefined;
380
429
  };
381
430
  } | null;
431
+ threadLock?: "strict" | undefined;
382
432
  }, {
383
433
  setup: {
384
434
  sdl: string;
@@ -388,7 +438,14 @@ export declare const AssistantSetupResponse: z.ZodObject<{
388
438
  provider: "openai";
389
439
  model: "advanced" | "balanced" | "fast" | "frontier";
390
440
  reasoning: "high" | "low" | "medium";
441
+ maxThreadSize?: number | undefined;
442
+ hourlyLimits?: {
443
+ sub?: number | undefined;
444
+ ip?: number | undefined;
445
+ project?: number | undefined;
446
+ } | undefined;
391
447
  };
392
448
  } | null;
449
+ threadLock?: "strict" | undefined;
393
450
  }>;
394
451
  export type AssistantSetupResponse = z.infer<typeof AssistantSetupResponse>;
@@ -1 +1 @@
1
- import{z as o}from"zod";import{usingType as n}from"@salsita-ai/common/utils";import{AccessLevel as e,SessionRole as t}from"../../api/index.js";import{DeploymentAssistant as r}from"../../assistant/index.js";import{ConfigurationId as s,DeploymentId as a,FrontendUrl as i,RevisionId as l}from"../../domain/index.js";import{CallLambdaBackResourceType as c}from"../tasks/index.js";export const CallbackPayload=o.object({replayData:o.record(o.unknown()),resources:o.record(o.object({type:o.literal(c.Link),link:o.string()}))});export const CallbackResponse=o.object({result:o.record(o.unknown()).optional()});export const AuthUserIdSource=o.enum(["clerk","custom"]);export const AuthHandlerResponse=o.discriminatedUnion("success",[o.object({success:o.literal(!0),data:o.record(o.unknown()),role:o.nativeEnum(t),refreshToken:o.string().optional(),expirationTime:o.number().optional(),scopes:o.array(o.string()).optional(),userId:o.string().optional(),userIdSource:AuthUserIdSource.optional()}),o.object({success:o.literal(!1)})]);export const RefreshPayload=o.object({type:o.literal("refresh"),refreshToken:o.string()});export const CodePayload=o.object({type:o.literal("code"),accessToken:o.string(),refreshToken:o.string().optional(),idToken:o.string().optional()});export const AnonymousPayload=o.object({type:o.literal("anonymous")});export const AuthPayload=o.union([RefreshPayload,CodePayload,AnonymousPayload]);export const FinalizeWebhookPayload=o.object({configurationId:o.string().transform(n(s)),revisionId:o.string().transform(n(l)),deploymentId:o.string().transform(n(a)),frontendUrl:o.string().transform(n(i)),rootEntityType:o.string(),entities:o.array(o.object({type:o.string(),id:o.string()}).and(o.record(o.unknown()))),modelVersion:o.number().positive(),data:o.record(o.unknown()),frontendData:o.record(o.unknown()).optional(),locale:o.string(),sessionRole:o.nativeEnum(t),sessionPayload:o.record(o.unknown()),publishedAdminRevisionPath:o.string().optional(),publishedChunkUrls:o.record(o.string()).optional(),chunksUploadUrl:o.string().optional(),connectedProviderAccessTokens:o.record(o.string()).optional()});export const FetchBackendDataPayload=o.object({deploymentId:o.string().transform(n(a)),frontendUrl:o.string().transform(n(i)),frontendData:o.record(o.unknown()).optional(),sessionRole:o.nativeEnum(t),sessionPayload:o.record(o.unknown()),publishedAdminRevisionPath:o.string().optional(),publishedChunkUrls:o.record(o.string()).optional()});export const FetchBackendDataHandlerResponse=o.object({backendData:o.record(o.unknown())});export const AssistantSetupPayload=o.object({deploymentId:o.string().transform(n(a)),sessionRole:o.nativeEnum(t),sessionPayload:o.record(o.unknown()),sub:o.string().optional(),access:o.nativeEnum(e)});export const AssistantSetupResponse=o.object({setup:r.nullable()}).strict();
1
+ import{z as o}from"zod";import{usingType as n}from"@salsita-ai/common/utils";import{AccessLevel as e,SessionRole as t}from"../../api/index.js";import{DeploymentAssistant as r}from"../../assistant/index.js";import{ConfigurationId as s,DeploymentId as a,FrontendUrl as i,RevisionId as l}from"../../domain/index.js";import{CallLambdaBackResourceType as c}from"../tasks/index.js";export const CallbackPayload=o.object({replayData:o.record(o.unknown()),resources:o.record(o.object({type:o.literal(c.Link),link:o.string()}))});export const CallbackResponse=o.object({result:o.record(o.unknown()).optional()});export const AuthUserIdSource=o.enum(["clerk","custom"]);export const AuthHandlerResponse=o.discriminatedUnion("success",[o.object({success:o.literal(!0),data:o.record(o.unknown()),role:o.nativeEnum(t),refreshToken:o.string().optional(),expirationTime:o.number().optional(),scopes:o.array(o.string()).optional(),userId:o.string().optional(),userIdSource:AuthUserIdSource.optional()}),o.object({success:o.literal(!1)})]);export const RefreshPayload=o.object({type:o.literal("refresh"),refreshToken:o.string()});export const CodePayload=o.object({type:o.literal("code"),accessToken:o.string(),refreshToken:o.string().optional(),idToken:o.string().optional()});export const AnonymousPayload=o.object({type:o.literal("anonymous")});export const AuthPayload=o.union([RefreshPayload,CodePayload,AnonymousPayload]);export const FinalizeWebhookPayload=o.object({configurationId:o.string().transform(n(s)),revisionId:o.string().transform(n(l)),deploymentId:o.string().transform(n(a)),frontendUrl:o.string().transform(n(i)),rootEntityType:o.string(),entities:o.array(o.object({type:o.string(),id:o.string()}).and(o.record(o.unknown()))),modelVersion:o.number().positive(),data:o.record(o.unknown()),frontendData:o.record(o.unknown()).optional(),locale:o.string(),sessionRole:o.nativeEnum(t),sessionPayload:o.record(o.unknown()),publishedAdminRevisionPath:o.string().optional(),publishedChunkUrls:o.record(o.string()).optional(),chunksUploadUrl:o.string().optional(),connectedProviderAccessTokens:o.record(o.string()).optional()});export const FetchBackendDataPayload=o.object({deploymentId:o.string().transform(n(a)),frontendUrl:o.string().transform(n(i)),frontendData:o.record(o.unknown()).optional(),sessionRole:o.nativeEnum(t),sessionPayload:o.record(o.unknown()),publishedAdminRevisionPath:o.string().optional(),publishedChunkUrls:o.record(o.string()).optional()});export const FetchBackendDataHandlerResponse=o.object({backendData:o.record(o.unknown())});export const AssistantSetupPayload=o.object({deploymentId:o.string().transform(n(a)),sessionRole:o.nativeEnum(t),sessionPayload:o.record(o.unknown()),sub:o.string().optional(),access:o.nativeEnum(e)});export const AssistantSetupResponse=o.object({setup:r.nullable(),threadLock:o.literal("strict").optional()}).strict();
@@ -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.0b927f4a8c",
3
+ "version": "0.50.0-develop.0d2418cc3b",
4
4
  "description": "Shared API, authentication, domain, chat, and webhook contracts for Phoenix.",
5
5
  "keywords": [
6
6
  "salsita",
@@ -48,23 +48,19 @@
48
48
  "@tanstack/ai": "0.64.0",
49
49
  "@types/aws-lambda": "8.10.133",
50
50
  "ajv": "8.20.0",
51
- "http-errors": "2.0.1",
52
51
  "jose": "6.2.3",
53
- "lodash-es": "4.18.1",
54
52
  "openai": "7.23.0",
55
53
  "ts-pattern": "5.9.0",
56
54
  "uuid": "14.0.0",
57
55
  "valid-url": "1.0.9",
58
56
  "zod": "3.25.76",
59
- "@salsita-ai/common": "0.50.0-develop.0b927f4a8c"
57
+ "@salsita-ai/common": "0.50.0-develop.0d2418cc3b"
60
58
  },
61
59
  "devDependencies": {
62
60
  "@lingui/core": "5.9.5",
63
61
  "@swc/cli": "0.8.1",
64
62
  "@swc/core": "1.15.40",
65
- "@types/http-errors": "2.0.5",
66
63
  "@types/json-schema": "7.0.15",
67
- "@types/lodash-es": "4.17.12",
68
64
  "@types/valid-url": "1.0.7",
69
65
  "eslint": "9.39.4",
70
66
  "prettier": "3.8.3",
@@ -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:"Captures the user's browser details (user agent, viewport size, device pixel ratio, language) 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)});