@salsita-ai/contracts 0.50.0-develop.b335a15889 → 0.50.0-develop.bc08a38ffe

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

@@ -20,19 +20,27 @@ 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;
 }>;
 /**
  * The setup returned by a deployment webhook: GraphQL SDL, SDK-generated prompt, integrator
@@ -53,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;
@@ -70,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;
@@ -79,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/webhook/implementation/webhook-api-types.d.ts

@@ -330,7 +330,11 @@ export declare const AssistantSetupPayload: z.ZodObject<{
     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. */
+/**
+ * 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;
@@ -340,14 +344,17 @@ export declare const AssistantSetupResponse: 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;
@@ -357,6 +364,7 @@ export declare const AssistantSetupResponse: z.ZodObject<{
             provider: "openai";
             model: "advanced" | "balanced" | "fast" | "frontier";
             reasoning: "high" | "low" | "medium";
+            maxThreadSize?: number | undefined;
         };
     }, {
         sdl: string;
@@ -366,8 +374,10 @@ export declare const AssistantSetupResponse: z.ZodObject<{
             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;
@@ -377,8 +387,10 @@ export declare const AssistantSetupResponse: z.ZodObject<{
             provider: "openai";
             model: "advanced" | "balanced" | "fast" | "frontier";
             reasoning: "high" | "low" | "medium";
+            maxThreadSize?: number | undefined;
         };
     } | null;
+    threadLock?: "strict" | undefined;
 }, {
     setup: {
         sdl: string;
@@ -388,7 +400,9 @@ export declare const AssistantSetupResponse: z.ZodObject<{
             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{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();
+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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salsita-ai/contracts",
-  "version": "0.50.0-develop.b335a15889",
+  "version": "0.50.0-develop.bc08a38ffe",
   "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.b335a15889"
+    "@salsita-ai/common": "0.50.0-develop.bc08a38ffe"
   },
   "devDependencies": {
     "@lingui/core": "5.9.5",