@salsita-ai/contracts 0.50.0-develop.db8514eccf → 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/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/package.json

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