@salsita-ai/contracts 0.50.0-develop.da8d27f5d7 → 0.50.0-develop.dbf0122072

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 and the tool error the server records.                                              |
 | `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/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/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/package.json

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