@salsita-ai/contracts 0.50.0-develop.bfba230ad7 → 0.50.0-develop.d6ed5efd42

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/deployment-assistant.d.ts

@@ -13,8 +13,8 @@ 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;
@@ -35,10 +35,9 @@ export declare const AssistantAiSettings: z.ZodObject<{
     reasoning: "high" | "low" | "medium";
 }>;
 /**
- * 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;

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/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/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/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,95 @@ 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. */
+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"]>;
+        }, "strict", z.ZodTypeAny, {
+            provider: "openai";
+            model: "advanced" | "balanced" | "fast" | "frontier";
+            reasoning: "high" | "low" | "medium";
+        }, {
+            provider: "openai";
+            model: "advanced" | "balanced" | "fast" | "frontier";
+            reasoning: "high" | "low" | "medium";
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        sdl: string;
+        prompt: string;
+        instructions?: string | undefined;
+        ai: {
+            provider: "openai";
+            model: "advanced" | "balanced" | "fast" | "frontier";
+            reasoning: "high" | "low" | "medium";
+        };
+    }, {
+        sdl: string;
+        prompt: string;
+        instructions?: string | undefined;
+        ai: {
+            provider: "openai";
+            model: "advanced" | "balanced" | "fast" | "frontier";
+            reasoning: "high" | "low" | "medium";
+        };
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    setup: {
+        sdl: string;
+        prompt: string;
+        instructions?: string | undefined;
+        ai: {
+            provider: "openai";
+            model: "advanced" | "balanced" | "fast" | "frontier";
+            reasoning: "high" | "low" | "medium";
+        };
+    } | null;
+}, {
+    setup: {
+        sdl: string;
+        prompt: string;
+        instructions?: string | undefined;
+        ai: {
+            provider: "openai";
+            model: "advanced" | "balanced" | "fast" | "frontier";
+            reasoning: "high" | "low" | "medium";
+        };
+    } | null;
+}>;
+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()}).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.bfba230ad7",
+  "version": "0.50.0-develop.d6ed5efd42",
   "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.bfba230ad7"
+    "@salsita-ai/common": "0.50.0-develop.d6ed5efd42"
   },
   "devDependencies": {
     "@lingui/core": "5.9.5",