@firstlovecenter/ai-chat 0.2.3 → 0.6.0

package/dist/{types-DNwFvL-C.d.cts → types-CQntnyDJ.d.cts}

@@ -1,4 +1,5 @@
 import { GoogleAuth } from 'google-auth-library';
+import { ZodType } from 'zod';
 
 /**
  * Tool typing for the agent loop.
@@ -39,8 +40,16 @@ type ToolResult = {
         message: string;
     };
 };
+
 type ToolDefinition<I = unknown, S = unknown> = {
     schema: ToolSchema;
+    /**
+     * Optional Zod schema for the same input. Required by the Vercel AI SDK
+     * route (which needs Zod to feed `tool({ parameters })`); the custom
+     * SSE route ignores it. Tools registered without a `zodSchema` will
+     * cause `buildVercelTools` to throw at config time.
+     */
+    zodSchema?: ZodType<I>;
     execute(input: I, ctx: ToolContext<S>): Promise<ToolResult>;
 };
 /** The terminal tool that closes the agent loop. The host's tool registry MUST include it. */
@@ -130,16 +139,26 @@ type ChatMessage = {
     createdAt: Date;
 };
 /**
- * Singleton row controlling the active tool-calling provider, the Vertex
- * region, and which chat UI (Custom vs. Vercel) renders globally. All three
+ * Singleton row controlling global AI runtime settings. All open-string
  * fields are validated at runtime against the registries the host configures
  * — they are not enums in the package's types so consumers can register
  * additional providers / interfaces without a schema change.
+ *
+ * `maxOutputTokens` caps both the agent loop's per-turn output AND each
+ * narrator's prose pass. Reasoning models (e.g. `xai/grok-4.1-fast-reasoning`)
+ * charge internal thinking against this budget — set it generously when
+ * those are in use.
+ *
+ * `rolePrompt` is the persona the assistant adopts. When non-null, it
+ * takes precedence over the host's static `rolePrompt` configureAiChat
+ * option, so admins can edit live in the settings UI.
  */
 type AiSettings = {
     toolProvider: string;
     gcpLocation: string;
     chatInterface: string;
+    maxOutputTokens: number;
+    rolePrompt: string | null;
     updatedAt: Date | null;
     updatedByUserId: number | null;
 };
@@ -233,6 +252,9 @@ type AiSettingsPatch = {
     toolProvider?: string;
     gcpLocation?: string;
     chatInterface?: string;
+    maxOutputTokens?: number;
+    /** Pass `null` to clear back to the host's static fallback. */
+    rolePrompt?: string | null;
 };
 /**
  * The whole reason this package is ORM-agnostic. Implemented by:

package/dist/{types-DNwFvL-C.d.ts → types-CQntnyDJ.d.ts}

@@ -1,4 +1,5 @@
 import { GoogleAuth } from 'google-auth-library';
+import { ZodType } from 'zod';
 
 /**
  * Tool typing for the agent loop.
@@ -39,8 +40,16 @@ type ToolResult = {
         message: string;
     };
 };
+
 type ToolDefinition<I = unknown, S = unknown> = {
     schema: ToolSchema;
+    /**
+     * Optional Zod schema for the same input. Required by the Vercel AI SDK
+     * route (which needs Zod to feed `tool({ parameters })`); the custom
+     * SSE route ignores it. Tools registered without a `zodSchema` will
+     * cause `buildVercelTools` to throw at config time.
+     */
+    zodSchema?: ZodType<I>;
     execute(input: I, ctx: ToolContext<S>): Promise<ToolResult>;
 };
 /** The terminal tool that closes the agent loop. The host's tool registry MUST include it. */
@@ -130,16 +139,26 @@ type ChatMessage = {
     createdAt: Date;
 };
 /**
- * Singleton row controlling the active tool-calling provider, the Vertex
- * region, and which chat UI (Custom vs. Vercel) renders globally. All three
+ * Singleton row controlling global AI runtime settings. All open-string
  * fields are validated at runtime against the registries the host configures
  * — they are not enums in the package's types so consumers can register
  * additional providers / interfaces without a schema change.
+ *
+ * `maxOutputTokens` caps both the agent loop's per-turn output AND each
+ * narrator's prose pass. Reasoning models (e.g. `xai/grok-4.1-fast-reasoning`)
+ * charge internal thinking against this budget — set it generously when
+ * those are in use.
+ *
+ * `rolePrompt` is the persona the assistant adopts. When non-null, it
+ * takes precedence over the host's static `rolePrompt` configureAiChat
+ * option, so admins can edit live in the settings UI.
  */
 type AiSettings = {
     toolProvider: string;
     gcpLocation: string;
     chatInterface: string;
+    maxOutputTokens: number;
+    rolePrompt: string | null;
     updatedAt: Date | null;
     updatedByUserId: number | null;
 };
@@ -233,6 +252,9 @@ type AiSettingsPatch = {
     toolProvider?: string;
     gcpLocation?: string;
     chatInterface?: string;
+    maxOutputTokens?: number;
+    /** Pass `null` to clear back to the host's static fallback. */
+    rolePrompt?: string | null;
 };
 /**
  * The whole reason this package is ORM-agnostic. Implemented by: