@salsita-ai/contracts 0.50.0-develop.b9eb39baf0 → 0.50.0-develop.bb1eefaada

package/README.md

@@ -15,7 +15,7 @@ There is no package-root export. Import from the path that owns the boundary; th
 
 | Entry point | Boundary it defines                                                                                                                                               |
 | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `api`       | API access levels, session roles, and access and session token payloads.                                                                                          |
+| `api`       | API access levels, session roles, access/session token payloads, and Studio browser-session response schema.                                                      |
 | `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.                                                                          |

package/dist/api/index.d.ts

@@ -2,3 +2,4 @@ export { AccessLevel } from './access-level.js';
 export { SessionRole } from './session-role.js';
 export { type SessionTokenPayload } from './session-token.js';
 export { type AccessTokenPayload } from './access-token.js';
+export { StudioSession } from './studio-session.js';

package/dist/api/index.js

@@ -1 +1 @@
-export{AccessLevel}from"./access-level.js";export{SessionRole}from"./session-role.js";
+export{AccessLevel}from"./access-level.js";export{SessionRole}from"./session-role.js";export{StudioSession}from"./studio-session.js";

package/dist/api/studio-session.d.ts

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+/** Account and current memberships of a fixed-lifetime Studio browser session; grants no workspace API access. */
+export declare const StudioSession: z.ZodObject<{
+    userId: z.ZodString;
+    expiresAt: z.ZodNumber;
+    workspaces: z.ZodArray<z.ZodObject<{
+        customerId: z.ZodString;
+        slug: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodNativeEnum<{
+            readonly Standard: 'standard';
+            readonly SdkBuilder: 'sdk_builder';
+        }>;
+        role: z.ZodEnum<["user", "admin", "superadmin"]>;
+        tags: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        customerId: string;
+        slug: string;
+        name: string;
+        type: "sdk_builder" | "standard";
+        role: "admin" | "superadmin" | "user";
+        tags: string[];
+    }, {
+        customerId: string;
+        slug: string;
+        name: string;
+        type: "sdk_builder" | "standard";
+        role: "admin" | "superadmin" | "user";
+        tags: string[];
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    userId: string;
+    expiresAt: number;
+    workspaces: {
+        customerId: string;
+        slug: string;
+        name: string;
+        type: "sdk_builder" | "standard";
+        role: "admin" | "superadmin" | "user";
+        tags: string[];
+    }[];
+}, {
+    userId: string;
+    expiresAt: number;
+    workspaces: {
+        customerId: string;
+        slug: string;
+        name: string;
+        type: "sdk_builder" | "standard";
+        role: "admin" | "superadmin" | "user";
+        tags: string[];
+    }[];
+}>;
+export type StudioSession = z.infer<typeof StudioSession>;

package/dist/api/studio-session.js

@@ -0,0 +1 @@
+import{z as r}from"zod";import{CustomerTypeSchema as s}from"../domain/index.js";export const StudioSession=r.object({userId:r.string().uuid(),expiresAt:r.number(),workspaces:r.array(r.object({customerId:r.string().uuid(),slug:r.string(),name:r.string(),type:s,role:r.enum(["user","admin","superadmin"]),tags:r.array(r.string())}))});

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.b9eb39baf0",
+  "version": "0.50.0-develop.bb1eefaada",
   "description": "Shared API, authentication, domain, chat, and webhook contracts for Phoenix.",
   "keywords": [
     "salsita",
@@ -48,23 +48,19 @@
     "@tanstack/ai": "0.64.0",
     "@types/aws-lambda": "8.10.133",
     "ajv": "8.20.0",
-    "http-errors": "2.0.1",
     "jose": "6.2.3",
-    "lodash-es": "4.18.1",
     "openai": "7.23.0",
     "ts-pattern": "5.9.0",
     "uuid": "14.0.0",
     "valid-url": "1.0.9",
     "zod": "3.25.76",
-    "@salsita-ai/common": "0.50.0-develop.b9eb39baf0"
+    "@salsita-ai/common": "0.50.0-develop.bb1eefaada"
   },
   "devDependencies": {
     "@lingui/core": "5.9.5",
     "@swc/cli": "0.8.1",
     "@swc/core": "1.15.40",
-    "@types/http-errors": "2.0.5",
     "@types/json-schema": "7.0.15",
-    "@types/lodash-es": "4.17.12",
     "@types/valid-url": "1.0.7",
     "eslint": "9.39.4",
     "prettier": "3.8.3",