@salsita-ai/contracts 0.50.0-develop.eb204e0da4 → 0.50.0-develop.f03b563886

package/README.md

@@ -19,7 +19,7 @@ There is no package-root export. Import from the path that owns the boundary; th
 | `clerk`     | Clerk backend client and services and the shared user, invitation, role, and token schemas.                                                                       |
 | `domain`    | Branded deployment, customer, project, environment, configuration, and revision data: types, schemas, constructors, and the state values clients compare against. |
 | `chat`      | Chat completion and stream chunks, tool definitions, validation, speech, and embeddings.                                                                          |
-| `assistant` | Experimental assistant: shared client-tool definitions and user-message metadata.                                                                                 |
+| `assistant` | Experimental assistant: shared client-tool definitions, user-message metadata, server-recorded tool errors and the deployment webhook setup shape.                |
 | `webhook`   | Webhook clients and building blocks, finalization tasks and resources, spreadsheet adapters.                                                                      |
 
 Runtime schemas and TypeScript types are kept aligned, so a value that passes the schema has the declared type.

package/dist/assistant/browser-details-tool.js

@@ -1 +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:[]}});
+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:[]}});

package/dist/assistant/deployment-assistant.d.ts

@@ -13,32 +13,39 @@ export type AssistantModelTier = (typeof ASSISTANT_MODEL_TIERS)[number];
 export type AssistantReasoningLevel = (typeof ASSISTANT_REASONING_LEVELS)[number];
 /**
  * The `ai` block of the assistant manifest: which provider, model tier and reasoning level the
- * deployment's assistant runs with. Authored in the application spec, sent when a deployment is
- * prepared and stored with it; the server has no defaults for any of the three.
+ * deployment's assistant runs with. Authored in the application spec and resolved through its deployment webhook;
+ * the server has no defaults for any of the three.
  */
 export interface AssistantAiSettings {
     readonly provider: AssistantAiProvider;
     readonly model: AssistantModelTier;
     readonly reasoning: AssistantReasoningLevel;
+    /**
+     * How many input tokens a model call of a thread may reach before the thread is compacted on the
+     * user's next message. Defaults to the server's limit; the server also caps it.
+     */
+    readonly maxThreadSize?: number | undefined;
 }
 export declare const AssistantAiSettings: z.ZodObject<{
     provider: z.ZodEnum<["openai"]>;
     model: z.ZodEnum<["frontier", "advanced", "balanced", "fast"]>;
     reasoning: z.ZodEnum<["low", "medium", "high"]>;
+    maxThreadSize: z.ZodOptional<z.ZodNumber>;
 }, "strict", z.ZodTypeAny, {
     provider: "openai";
     model: "advanced" | "balanced" | "fast" | "frontier";
     reasoning: "high" | "low" | "medium";
+    maxThreadSize?: number | undefined;
 }, {
     provider: "openai";
     model: "advanced" | "balanced" | "fast" | "frontier";
     reasoning: "high" | "low" | "medium";
+    maxThreadSize?: number | undefined;
 }>;
 /**
- * What a deployment registers for its assistant: the GraphQL SDL generated from the manifest, the
- * prompt the SDK generates for its own version, the integrator's instructions and the AI settings.
- * The server stores it with the deployment and builds every run's system prompt from it; a
- * deployment that registers none has no assistant.
+ * The setup returned by a deployment webhook: GraphQL SDL, SDK-generated prompt, integrator
+ * instructions and AI settings. The server caches validated answers and builds run prompts from
+ * them; a null setup means the assistant is unavailable for that session.
  */
 export interface DeploymentAssistant {
     readonly sdl: string;
@@ -54,14 +61,17 @@ export declare const DeploymentAssistant: z.ZodObject<{
         provider: z.ZodEnum<["openai"]>;
         model: z.ZodEnum<["frontier", "advanced", "balanced", "fast"]>;
         reasoning: z.ZodEnum<["low", "medium", "high"]>;
+        maxThreadSize: z.ZodOptional<z.ZodNumber>;
     }, "strict", z.ZodTypeAny, {
         provider: "openai";
         model: "advanced" | "balanced" | "fast" | "frontier";
         reasoning: "high" | "low" | "medium";
+        maxThreadSize?: number | undefined;
     }, {
         provider: "openai";
         model: "advanced" | "balanced" | "fast" | "frontier";
         reasoning: "high" | "low" | "medium";
+        maxThreadSize?: number | undefined;
     }>;
 }, "strict", z.ZodTypeAny, {
     sdl: string;
@@ -71,6 +81,7 @@ export declare const DeploymentAssistant: z.ZodObject<{
         provider: "openai";
         model: "advanced" | "balanced" | "fast" | "frontier";
         reasoning: "high" | "low" | "medium";
+        maxThreadSize?: number | undefined;
     };
 }, {
     sdl: string;
@@ -80,5 +91,6 @@ export declare const DeploymentAssistant: z.ZodObject<{
         provider: "openai";
         model: "advanced" | "balanced" | "fast" | "frontier";
         reasoning: "high" | "low" | "medium";
+        maxThreadSize?: number | undefined;
     };
 }>;

package/dist/assistant/deployment-assistant.js

@@ -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)}).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();
+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();

package/dist/assistant/graphql-tools.js

@@ -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:"Runs GraphQL operations against the open configuration and returns their results. Nothing is changed: mutations in the list are applied to a temporary copy that is discarded after the call, which shows what a change would do.",inputSchema:o});export const applyTool=e({name:"apply",description:"Runs GraphQL operations against the open configuration and keeps their changes as one undo step. All or nothing: when any operation fails, nothing is changed. The result says whether the changes were committed.",inputSchema:o});
+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});

package/dist/assistant/index.d.ts

@@ -4,3 +4,5 @@ export { AssistantGraphQLToolInput, applyTool, queryTool } from './graphql-tools
 export type { AssistantGraphQLOperation } from './graphql-tools.js';
 export type { AssistantAiProvider, AssistantModelTier, AssistantReasoningLevel } from './deployment-assistant.js';
 export { AssistantMessageMetadata } from './message-metadata.js';
+export { ASSISTANT_TOOL_ERROR_CODES, AssistantToolError } from './tool-error.js';
+export type { AssistantToolErrorCode } from './tool-error.js';

package/dist/assistant/index.js

@@ -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{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";

package/dist/assistant/message-metadata.d.ts

@@ -1,17 +1,17 @@
 import { z } from 'zod';
 /**
  * Metadata the assistant chat client attaches to each user message (AG-UI message `metadata`). It is
- * persisted with the message, and the server shows `sentAt` to the model next to the message so the
- * model knows when each message was written — the seed of the per-turn history diff.
+ * persisted with the message, and the server shows `changes` to the model in front of the message, so
+ * the model knows what the user did in the configurator since it last acted.
  */
 export interface AssistantMessageMetadata {
-    /** Client send time of the user message, as an ISO 8601 timestamp with offset. */
-    readonly sentAt: string;
+    /** The change record since the agent's previous action: a marker or a diff, as the assistant prompt describes it. */
+    readonly changes: string;
 }
 export declare const AssistantMessageMetadata: z.ZodObject<{
-    sentAt: z.ZodString;
+    changes: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    sentAt: string;
+    changes: string;
 }, {
-    sentAt: string;
+    changes: string;
 }>;

package/dist/assistant/message-metadata.js

@@ -1 +1 @@
-import{z as t}from"zod";export const AssistantMessageMetadata=t.object({sentAt:t.string().datetime({offset:!0})});
+import{z as t}from"zod";export const AssistantMessageMetadata=t.object({changes:t.string()});

package/dist/assistant/tool-error.d.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+/**
+ * Why the server recorded an error in place of the result of an assistant tool call:
+ * - `cancelled`: the user stopped the reply while the call was waiting for its result
+ * - `no_result`: the thread stopped waiting for the call when the user wrote a new message
+ * - `tool_budget`: the reply had used its tool calls for one user message, so the call was not run
+ */
+export declare const ASSISTANT_TOOL_ERROR_CODES: readonly ['cancelled', 'no_result', 'tool_budget'];
+export type AssistantToolErrorCode = (typeof ASSISTANT_TOOL_ERROR_CODES)[number];
+/**
+ * An error in place of the result of an assistant tool call. `error` is text for the model, in the
+ * `{ error }` form TanStack AI itself records for a tool that threw or was cancelled. `code` is set
+ * on the errors the server records and tells the assistant panel what to say to the user; it is
+ * read as any string, so a panel older than the server shows a code it does not know as a general
+ * failure.
+ */
+export interface AssistantToolError {
+    readonly error: string;
+    readonly code?: string | undefined;
+}
+export declare const AssistantToolError: z.ZodObject<{
+    error: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    error: string;
+    code?: string | undefined;
+}, {
+    error: string;
+    code?: string | undefined;
+}>;

package/dist/assistant/tool-error.js

@@ -0,0 +1 @@
+import{z as o}from"zod";export const ASSISTANT_TOOL_ERROR_CODES=["cancelled","no_result","tool_budget"];export const AssistantToolError=o.object({error:o.string(),code:o.string().optional()});

package/dist/domain/deployments/api-token-domain.d.ts

@@ -1,4 +1,9 @@
 import { Branded } from '@salsita-ai/common/utils';
+/**
+ * How long the name of an API token may be. A builder gives the name when approving `phoenix login` in Studio, and
+ * the CLI sends it back with `POST /auth/token`, so Studio and both server inputs apply this one limit.
+ */
+export declare const API_TOKEN_NAME_MAX_LENGTH = 100;
 /**
  * Identifies one API token: a long-lived, revocable credential that authenticates calls to the Phoenix API on
  * behalf of the user who approved it. The id names the token in revocation and in the request session; it is

package/dist/domain/deployments/api-token-domain.js

@@ -1 +1 @@
-import{validate as o}from"uuid";import{Branded as i}from"@salsita-ai/common/utils";export const ApiTokenId=r=>{if(!o(r))throw Error(`Invalid API token id: ${r}. It must be a valid UUID.`);return i(r)};
+import{validate as o}from"uuid";import{Branded as t}from"@salsita-ai/common/utils";export const API_TOKEN_NAME_MAX_LENGTH=100;export const ApiTokenId=r=>{if(!o(r))throw Error(`Invalid API token id: ${r}. It must be a valid UUID.`);return t(r)};

package/dist/domain/deployments/deployment-domain.d.ts

@@ -86,6 +86,7 @@ export interface Deployment {
     readonly id: DeploymentId;
     readonly environmentId: EnvironmentId;
     readonly isActive: boolean;
+    readonly assistantEnabled: boolean;
     readonly resourcesUrl: ResourceUrl;
     readonly useAuthHook: boolean;
     readonly lambdaWebhookUrl: LambdaWebhookUrl | null;
@@ -107,6 +108,7 @@ export interface NewDeployment {
     readonly id: DeploymentId;
     readonly environmentId: EnvironmentId;
     readonly isActive: boolean;
+    readonly assistantEnabled: boolean;
     readonly resourcesUrl: ResourceUrl;
     readonly useAuthHook: boolean;
     readonly lambdaWebhookUrl: LambdaWebhookUrl | null;

package/dist/domain/deployments/index.d.ts

@@ -5,7 +5,7 @@ export { DEFAULT_PROJECT_ALIAS, ProjectId, ProjectName, ProjectSlug, ProjectCust
 export { OAuthProviderId, OAuthClientId, OAuthClientSecret, OAuthBaseUrl, type OAuthProvider, 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 { ApiTokenId } from './api-token-domain.js';
+export { API_TOKEN_NAME_MAX_LENGTH, ApiTokenId } from './api-token-domain.js';
 export { CustomerId, CustomerName, type Customer, CustomerClerkPublishableKey, CustomerClerkSecretKey, CustomerClerkJwtSecret, CustomerClerkOAuthBaseUrl, CustomerClerkOAuthClientId, CustomerClerkOAuthClientSecret, type CustomerClerkSettings, CustomerSlug, CustomerType, CustomerTypeSchema, } from './customer-domain.js';
 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';
 export { type Embeddings } from './embedding-domain.js';

package/dist/domain/deployments/index.js

@@ -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{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";
+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";

package/dist/domain/feedback/feedback-domain.d.ts

@@ -44,10 +44,11 @@ export declare const FeedbackSource: ((value: string) => FeedbackSource) & {
     readonly Cli: 'cli';
 };
 /**
- * Longest feedback message the server stores. Studio and the CLI check it before sending, so a sender learns about
- * the limit without a round trip.
+ * Longest feedback message the server stores. It leaves room for a full report: the error output and a condensed
+ * conversation log of the coding agent that wrote it. Studio and the CLI check it before sending, so a sender learns
+ * about the limit without a round trip.
  */
-export declare const FEEDBACK_MESSAGE_MAX_LENGTH = 5000;
+export declare const FEEDBACK_MESSAGE_MAX_LENGTH = 100000;
 /**
  * Longest contact detail a sender may leave with CLI feedback when they want a reply.
  */

package/dist/domain/feedback/feedback-domain.js

@@ -1 +1 @@
-import{validate as e}from"uuid";import{z as t}from"zod";import{Branded as o}from"@salsita-ai/common/utils";export const FeedbackId=t=>{if(!e(t))throw Error(`Invalid feedback id: ${t}. It must be a valid UUID.`);return o(t)};let r={Bug:"bug",Idea:"idea",Other:"other"};export const FeedbackTypeSchema=t.nativeEnum(r);export const FeedbackType=Object.assign(e=>{let t=FeedbackTypeSchema.safeParse(e);if(!t.success)throw Error(`Invalid feedback type: ${e}. It must be one of ${Object.values(r).join(", ")}.`);return t.data},r);let a={Studio:"studio",Cli:"cli"};export const FeedbackSourceSchema=t.nativeEnum(a);export const FeedbackSource=Object.assign(e=>{let t=FeedbackSourceSchema.safeParse(e);if(!t.success)throw Error(`Invalid feedback source: ${e}. It must be one of ${Object.values(a).join(", ")}.`);return t.data},a);export const FEEDBACK_MESSAGE_MAX_LENGTH=5e3;export const FEEDBACK_CONTACT_MAX_LENGTH=200;
+import{validate as e}from"uuid";import{z as t}from"zod";import{Branded as o}from"@salsita-ai/common/utils";export const FeedbackId=t=>{if(!e(t))throw Error(`Invalid feedback id: ${t}. It must be a valid UUID.`);return o(t)};let r={Bug:"bug",Idea:"idea",Other:"other"};export const FeedbackTypeSchema=t.nativeEnum(r);export const FeedbackType=Object.assign(e=>{let t=FeedbackTypeSchema.safeParse(e);if(!t.success)throw Error(`Invalid feedback type: ${e}. It must be one of ${Object.values(r).join(", ")}.`);return t.data},r);let a={Studio:"studio",Cli:"cli"};export const FeedbackSourceSchema=t.nativeEnum(a);export const FeedbackSource=Object.assign(e=>{let t=FeedbackSourceSchema.safeParse(e);if(!t.success)throw Error(`Invalid feedback source: ${e}. It must be one of ${Object.values(a).join(", ")}.`);return t.data},a);export const FEEDBACK_MESSAGE_MAX_LENGTH=1e5;export const FEEDBACK_CONTACT_MAX_LENGTH=200;

package/dist/webhook/implementation/index.d.ts

@@ -1,4 +1,4 @@
 export { routeWebhookRequests } from './webhook-routing.js';
 export { TunneledWebhookRequest, TunneledWebhookResponse, WebhookTunnelPollRequest, WebhookTunnelPollResponse, WebhookTunnelRespondRequest, } from './webhook-tunnel-types.js';
 export { WebhookClient, createUrlWebhookHttpClient, fetchWebhookHttpClient, type WebhookHttpClient, } from './webhook-client.js';
-export { AuthHandlerResponse, AuthUserIdSource, RefreshPayload, CodePayload, AuthPayload, AnonymousPayload, FinalizeWebhookPayload, CallbackPayload, CallbackResponse, FetchBackendDataPayload, FetchBackendDataHandlerResponse, } from './webhook-api-types.js';
+export { AssistantSetupPayload, AssistantSetupResponse, AuthHandlerResponse, AuthUserIdSource, RefreshPayload, CodePayload, AuthPayload, AnonymousPayload, FinalizeWebhookPayload, CallbackPayload, CallbackResponse, FetchBackendDataPayload, FetchBackendDataHandlerResponse, } from './webhook-api-types.js';

package/dist/webhook/implementation/index.js

@@ -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{AuthHandlerResponse,AuthUserIdSource,RefreshPayload,CodePayload,AuthPayload,AnonymousPayload,FinalizeWebhookPayload,CallbackPayload,CallbackResponse,FetchBackendDataPayload,FetchBackendDataHandlerResponse}from"./webhook-api-types.js";
+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";

package/dist/webhook/implementation/webhook-api-types.d.ts

@@ -300,3 +300,109 @@ export declare const FetchBackendDataHandlerResponse: z.ZodObject<{
 }, {
     backendData: Record<string, unknown>;
 }>;
+/** Session inputs used by the lambda to resolve the assistant setup. */
+export declare const AssistantSetupPayload: z.ZodObject<{
+    deploymentId: z.ZodEffects<z.ZodString, DeploymentId, string>;
+    sessionRole: z.ZodNativeEnum<{
+        readonly Anonymous: 'anonymous';
+        readonly User: 'user';
+        readonly Admin: 'admin';
+        readonly SuperAdmin: 'superadmin';
+    }>;
+    sessionPayload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    sub: z.ZodOptional<z.ZodString>;
+    access: z.ZodNativeEnum<{
+        readonly Owner: 'o';
+        readonly ReadRevision: 'rr';
+        readonly Read: 'r';
+    }>;
+}, "strip", z.ZodTypeAny, {
+    deploymentId: string & import("@salsita-ai/common/utils").Brand<"DeploymentId">;
+    sessionRole: "admin" | "anonymous" | "superadmin" | "user";
+    sessionPayload: Record<string, unknown>;
+    sub?: string | undefined;
+    access: "o" | "r" | "rr";
+}, {
+    deploymentId: string;
+    sessionRole: "admin" | "anonymous" | "superadmin" | "user";
+    sessionPayload: Record<string, unknown>;
+    sub?: string | undefined;
+    access: "o" | "r" | "rr";
+}>;
+export type AssistantSetupPayload = z.infer<typeof AssistantSetupPayload>;
+/**
+ * A deployment's assistant setup, or a session for which no assistant is available. `threadLock`
+ * is outside the setup a thread is bound to: `'strict'` asks a development environment to lock a
+ * thread when the setup changes, as every other environment always does.
+ */
+export declare const AssistantSetupResponse: z.ZodObject<{
+    setup: z.ZodNullable<z.ZodObject<{
+        sdl: z.ZodString;
+        prompt: z.ZodString;
+        instructions: z.ZodOptional<z.ZodString>;
+        ai: z.ZodObject<{
+            provider: z.ZodEnum<["openai"]>;
+            model: z.ZodEnum<["frontier", "advanced", "balanced", "fast"]>;
+            reasoning: z.ZodEnum<["low", "medium", "high"]>;
+            maxThreadSize: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            provider: "openai";
+            model: "advanced" | "balanced" | "fast" | "frontier";
+            reasoning: "high" | "low" | "medium";
+            maxThreadSize?: number | undefined;
+        }, {
+            provider: "openai";
+            model: "advanced" | "balanced" | "fast" | "frontier";
+            reasoning: "high" | "low" | "medium";
+            maxThreadSize?: number | undefined;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        sdl: string;
+        prompt: string;
+        instructions?: string | undefined;
+        ai: {
+            provider: "openai";
+            model: "advanced" | "balanced" | "fast" | "frontier";
+            reasoning: "high" | "low" | "medium";
+            maxThreadSize?: number | undefined;
+        };
+    }, {
+        sdl: string;
+        prompt: string;
+        instructions?: string | undefined;
+        ai: {
+            provider: "openai";
+            model: "advanced" | "balanced" | "fast" | "frontier";
+            reasoning: "high" | "low" | "medium";
+            maxThreadSize?: number | undefined;
+        };
+    }>>;
+    threadLock: z.ZodOptional<z.ZodLiteral<"strict">>;
+}, "strict", z.ZodTypeAny, {
+    setup: {
+        sdl: string;
+        prompt: string;
+        instructions?: string | undefined;
+        ai: {
+            provider: "openai";
+            model: "advanced" | "balanced" | "fast" | "frontier";
+            reasoning: "high" | "low" | "medium";
+            maxThreadSize?: number | undefined;
+        };
+    } | null;
+    threadLock?: "strict" | undefined;
+}, {
+    setup: {
+        sdl: string;
+        prompt: string;
+        instructions?: string | undefined;
+        ai: {
+            provider: "openai";
+            model: "advanced" | "balanced" | "fast" | "frontier";
+            reasoning: "high" | "low" | "medium";
+            maxThreadSize?: number | undefined;
+        };
+    } | null;
+    threadLock?: "strict" | undefined;
+}>;
+export type AssistantSetupResponse = z.infer<typeof AssistantSetupResponse>;

package/dist/webhook/implementation/webhook-api-types.js

@@ -1 +1 @@
-import{z as o}from"zod";import{usingType as n}from"@salsita-ai/common/utils";import{SessionRole as e}from"../../api/index.js";import{ConfigurationId as r,DeploymentId as t,FrontendUrl as s,RevisionId as a}from"../../domain/index.js";import{CallLambdaBackResourceType as i}from"../tasks/index.js";export const CallbackPayload=o.object({replayData:o.record(o.unknown()),resources:o.record(o.object({type:o.literal(i.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(e),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(r)),revisionId:o.string().transform(n(a)),deploymentId:o.string().transform(n(t)),frontendUrl:o.string().transform(n(s)),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(e),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(t)),frontendUrl:o.string().transform(n(s)),frontendData:o.record(o.unknown()).optional(),sessionRole:o.nativeEnum(e),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())});
+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();

package/dist/webhook/implementation/webhook-client.d.ts

@@ -1,5 +1,5 @@
 import type { ApplicationType } from '../../domain/index.js';
-import { type CallbackPayload, CallbackResponse, type FetchBackendDataPayload, type FinalizeWebhookPayload } from './webhook-api-types.js';
+import { type AssistantSetupPayload, AssistantSetupResponse, type CallbackPayload, CallbackResponse, type FetchBackendDataPayload, type FinalizeWebhookPayload } from './webhook-api-types.js';
 export type WebhookHttpClient = (url: string, init: RequestInit) => Promise<Response>;
 export declare const fetchWebhookHttpClient: WebhookHttpClient;
 export declare const createUrlWebhookHttpClient: (baseUrl: string, httpClient?: WebhookHttpClient) => WebhookHttpClient;
@@ -79,6 +79,7 @@ export declare class WebhookClient {
         resources: import("../index.js").FinalizeTaskResource<string>[];
     }>;
     callback: (payload: CallbackPayload<Record<string, unknown>, string>) => Promise<CallbackResponse<Record<string, unknown>>>;
+    assistantSetup: (payload: AssistantSetupPayload) => Promise<AssistantSetupResponse>;
     fetchBackendData: (payload: FetchBackendDataPayload<Record<string, unknown>, Record<string, unknown>>) => Promise<{
         backendData: Record<string, unknown>;
     }>;

package/dist/webhook/implementation/webhook-client.js

@@ -1 +1 @@
-import{WebhookFinalizeTaskConfiguration as t}from"../tasks/index.js";import{AuthHandlerResponse as e,CallbackResponse as o,FetchBackendDataHandlerResponse as a}from"./webhook-api-types.js";import{getAuthRoute as i,getCallbackRoute as n,getFetchBackendDataRoute as r,getFinalizeRoute as s}from"./webhook-routing.js";export const fetchWebhookHttpClient=(t,e)=>fetch(t,e);export const createUrlWebhookHttpClient=(t,e=fetchWebhookHttpClient)=>(o,a)=>e(`${t}${o}`,a);export class WebhookClient{_httpClient;constructor(t,e=fetchWebhookHttpClient){this._httpClient="string"==typeof t?createUrlWebhookHttpClient(t,e):t}handleRefreshFlow=async t=>{let o=await this._httpClient(i(),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({type:"refresh",refreshToken:t})});if(!o.ok)throw Error(`Refresh webhook call failed: ${await o.text()}`);return e.parse(await o.json())};handleCodeFlow=async(t,o,a)=>{let n=await this._httpClient(i(),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({type:"code",accessToken:t,refreshToken:o,idToken:a})});if(!n.ok)throw Error(`Refresh webhook call failed: ${await n.text()}`);return e.parse(await n.json())};handleAnonymousFlow=async()=>{let t=await this._httpClient(i(),{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 e.parse(await t.json())};finalize=async(e,o)=>{let a=await this._httpClient(s(o),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(e)});if(!a.ok)throw Error("Lambda call failed: "+await a.text());let i=await a.json();return t.parse(i)};callback=async t=>{let e=await this._httpClient(n(),{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)};fetchBackendData=async t=>{let e=await this._httpClient(r(),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t)});if(!e.ok)throw Error("Lambda call failed: "+await e.text());return a.parse(await e.json())}}
+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())}}

package/dist/webhook/implementation/webhook-routing.d.ts

@@ -3,7 +3,8 @@ import type { Logger } from '@salsita-ai/common/utils';
 import { ApplicationType } from '../../domain/index.js';
 import { type WebhookFinalizeTaskConfiguration } from '../tasks/index.js';
 import type { AuthHandlerResponse, CallbackResponse, FetchBackendDataHandlerResponse } from './webhook-api-types.js';
-import { AuthPayload, CallbackPayload, FetchBackendDataPayload, FinalizeWebhookPayload } from './webhook-api-types.js';
+import { AssistantSetupPayload, AssistantSetupResponse, AuthPayload, CallbackPayload, FetchBackendDataPayload, FinalizeWebhookPayload } from './webhook-api-types.js';
+export declare const getAssistantSetupRoute: () => string;
 export declare const getAuthRoute: () => string;
 export declare const getFinalizeRoute: (applicationType: ApplicationType) => string;
 export declare const getCallbackRoute: () => string;
@@ -18,6 +19,7 @@ type AuthHandler = (body: AuthPayload, e: APIGatewayProxyEventV2) => Promise<Aut
 type FetchBackendDataHandler = (body: FetchBackendDataPayload<Record<string, unknown>, Record<string, unknown>>, e: APIGatewayProxyEventV2) => Promise<FetchBackendDataHandlerResponse>;
 export declare const routeWebhookRequests: (handlers: {
     configurator?: {
+        onAssistantSetup?: (body: AssistantSetupPayload, e: APIGatewayProxyEventV2) => Promise<AssistantSetupResponse>;
         onFetchBackendData?: FetchBackendDataHandler;
         onCallback?: CallbackHandler;
         onFinalize?: FinalizeHandler;

package/dist/webhook/implementation/webhook-routing.js

@@ -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{AuthPayload as e,CallbackPayload as a,FetchBackendDataPayload as i,FinalizeWebhookPayload as s}from"./webhook-api-types.js";let f="auth",c="finalize",d="callback",h="fetchBackendData";export const getAuthRoute=()=>`?o=${f}`;export const getFinalizeRoute=o=>`?o=${c}&t=${o}`;export const getCallbackRoute=()=>`?o=${d}`;export const getFetchBackendDataRoute=()=>`?o=${h}`;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=(u,l)=>handleWebhookSafely(async p=>{if(!p.body)throw Error("No body found in the webhook event!");let g=JSON.parse(p.isBase64Encoded?Buffer.from(p.body,"base64").toString():p.body);return t(p.queryStringParameters?.o).with(f,async()=>{if(l.info("Handling auth operation."),!u.onAuth)throw Error("Auth operation is not configured for this webhook!");let o=e.parse(g);return{statusCode:200,body:JSON.stringify(await u.onAuth(o,p))}}).with(d,async()=>{if(l.info("Handling configurator callback operation."),!u.configurator?.onCallback)throw Error("Auth operation is not configured for this webhook!");let o=a.parse(g);return{statusCode:200,body:JSON.stringify(await u.configurator.onCallback(o,p))}}).with(o.union(void 0,c),()=>t(p.queryStringParameters?.t).with(r.Admin,async()=>{if(l.info("Handling admin finalize operation."),!u.admin?.onFinalize)throw Error("Admin finalize operation is not configured for this webhook!");let o=s.parse(g),t=await u.admin.onFinalize(o,p);return n(t),{statusCode:200,body:JSON.stringify(t)}}).with(o.union(void 0,r.Configurator),async()=>{if(l.info("Handling configurator finalize operation."),!u.configurator?.onFinalize)throw Error("Configurator finalize operation is not configured for this webhook!");let o=s.parse(g),t=await u.configurator.onFinalize(o,p);return n(t),{statusCode:200,body:JSON.stringify(t)}}).otherwise(o=>{throw Error(`Can not parse application type - unknown type: ${o}!`)})).with(h,async()=>{if(l.info("Handling fetch backend data operation."),!u.configurator?.onFetchBackendData)throw Error("Fetch backend data operation is not configured for this webhook!");let o=i.parse(g);return{statusCode:200,body:JSON.stringify(await u.configurator.onFetchBackendData(o,p))}}).otherwise(o=>{throw Error(`Can not parse webhook operation - unknown operation: ${o}!`)})},l);
+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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salsita-ai/contracts",
-  "version": "0.50.0-develop.eb204e0da4",
+  "version": "0.50.0-develop.f03b563886",
   "description": "Shared API, authentication, domain, chat, and webhook contracts for Phoenix.",
   "keywords": [
     "salsita",
@@ -56,7 +56,7 @@
     "uuid": "14.0.0",
     "valid-url": "1.0.9",
     "zod": "3.25.76",
-    "@salsita-ai/common": "0.50.0-develop.eb204e0da4"
+    "@salsita-ai/common": "0.50.0-develop.f03b563886"
   },
   "devDependencies": {
     "@lingui/core": "5.9.5",