@meistrari/chat-nuxt 4.11.0-rc.2 → 4.11.0-rc.4

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@meistrari/chat-nuxt",
   "configKey": "chatNuxt",
-  "version": "4.11.0-rc.2",
+  "version": "4.11.0-rc.4",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "unknown"

package/dist/runtime/embed/components/mobile/chat-mobile-shell.d.vue.ts

@@ -72,8 +72,8 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {
     copyLink: () => any;
     debug: () => any;
     selectConversation: (id: string) => any;
-    settings: () => any;
     send: (content: string, files: FileUploadInput[], agentInputs?: TelaAgentExecutionInput[] | undefined) => any;
+    settings: () => any;
     selectExecutionProfile: (profile: ChatExecutionProfile) => any;
     tabChange: (tab: TopbarTab) => any;
     newConversation: (groupId?: string | null | undefined) => any;
@@ -94,8 +94,8 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {
     onCopyLink?: (() => any) | undefined;
     onDebug?: (() => any) | undefined;
     onSelectConversation?: ((id: string) => any) | undefined;
-    onSettings?: (() => any) | undefined;
     onSend?: ((content: string, files: FileUploadInput[], agentInputs?: TelaAgentExecutionInput[] | undefined) => any) | undefined;
+    onSettings?: (() => any) | undefined;
     onSelectExecutionProfile?: ((profile: ChatExecutionProfile) => any) | undefined;
     "onUpdate:selectedModel"?: ((value: string | null) => any) | undefined;
     "onUpdate:selectedReasoningEffort"?: ((value: any) => any) | undefined;

package/dist/runtime/embed/components/mobile/chat-mobile-shell.vue.d.ts

@@ -72,8 +72,8 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {
     copyLink: () => any;
     debug: () => any;
     selectConversation: (id: string) => any;
-    settings: () => any;
     send: (content: string, files: FileUploadInput[], agentInputs?: TelaAgentExecutionInput[] | undefined) => any;
+    settings: () => any;
     selectExecutionProfile: (profile: ChatExecutionProfile) => any;
     tabChange: (tab: TopbarTab) => any;
     newConversation: (groupId?: string | null | undefined) => any;
@@ -94,8 +94,8 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {
     onCopyLink?: (() => any) | undefined;
     onDebug?: (() => any) | undefined;
     onSelectConversation?: ((id: string) => any) | undefined;
-    onSettings?: (() => any) | undefined;
     onSend?: ((content: string, files: FileUploadInput[], agentInputs?: TelaAgentExecutionInput[] | undefined) => any) | undefined;
+    onSettings?: (() => any) | undefined;
     onSelectExecutionProfile?: ((profile: ChatExecutionProfile) => any) | undefined;
     "onUpdate:selectedModel"?: ((value: string | null) => any) | undefined;
     "onUpdate:selectedReasoningEffort"?: ((value: any) => any) | undefined;

package/dist/runtime/types/schemas/chat/v3.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { type V5SessionEvent } from '../integrations/agent-events';
 /**
  * Chat API v3 (`/v3/chat`): the conversational surface over agent-api v5 events-v1.
  * The chat-api owns the thread; agent-api owns the session and its history.
@@ -123,11 +124,65 @@ export declare const CHAT_V3_MESSAGE_PAGE: {
     readonly default: 30;
     readonly max: 100;
 };
-/** A message's text; above the inline limit agent-api keeps it in Vault and the event points at it. */
+/** How many files one message carries; with the message they stay within agent-api's batch. */
+export declare const CHAT_V3_FILES_PER_MESSAGE = 10;
+/** The largest file a message carries, as the largest artifact agent-api publishes. */
+export declare const CHAT_V3_FILE_BYTES: number;
+export declare const CHAT_V3_FILE_NAME_CHARS = 255;
+/** `POST /files`: the file about to be uploaded, before its bytes. */
+export declare const chatV3CreateFileSchema: z.ZodObject<{
+    name: z.ZodString;
+    size: z.ZodNumber;
+    contentType: z.ZodString;
+}, z.core.$strict>;
+export type ChatV3CreateFile = z.infer<typeof chatV3CreateFileSchema>;
+/** A file in Vault, ready to go with a message: only its reference travels to agent-api. */
+export declare const chatV3FileSchema: z.ZodObject<{
+    vaultReference: z.ZodString;
+    name: z.ZodString;
+    size: z.ZodNumber;
+    contentType: z.ZodString;
+}, z.core.$strip>;
+export type ChatV3File = z.infer<typeof chatV3FileSchema>;
+/**
+ * A file created in Vault and waiting for its bytes: the browser sends them straight to
+ * `uploadUrl` with a `PUT` and the same `Content-Type`, before it expires. They never pass
+ * through chat-api.
+ */
+export declare const chatV3FileUploadSchema: z.ZodObject<{
+    vaultReference: z.ZodString;
+    name: z.ZodString;
+    size: z.ZodNumber;
+    contentType: z.ZodString;
+    uploadUrl: z.ZodString;
+    expiresAt: z.ZodString;
+}, z.core.$strip>;
+export type ChatV3FileUpload = z.infer<typeof chatV3FileUploadSchema>;
+/**
+ * A message's text, and the files sent with it. Above the inline limit agent-api keeps the text in
+ * Vault and the event points at it; each file goes as an `input` the agent finds in `attachments/`.
+ */
 export declare const chatV3SendMessageSchema: z.ZodObject<{
     text: z.ZodString;
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        vaultReference: z.ZodString;
+    }, z.core.$strict>>>;
 }, z.core.$strict>;
 export type ChatV3SendMessage = z.infer<typeof chatV3SendMessageSchema>;
+/** Text sent into a running turn; files go only with a queued message. */
+export declare const chatV3SteerMessageSchema: z.ZodObject<{
+    text: z.ZodString;
+}, z.core.$strict>;
+export type ChatV3SteerMessage = z.infer<typeof chatV3SteerMessageSchema>;
+/**
+ * The answers to the agent's question, by question id: free text, or the `value` of the option
+ * chosen. agent-api checks them against the question, and their size, and opens the next turn
+ * with them.
+ */
+export declare const chatV3AnswerSchema: z.ZodObject<{
+    answers: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>;
+export type ChatV3Answer = z.infer<typeof chatV3AnswerSchema>;
 /** Cancels the running turn; the turnId comes from the message that started it. */
 export declare const chatV3CancelTurnSchema: z.ZodObject<{
     turnId: z.ZodString;
@@ -149,6 +204,42 @@ export declare const chatV3MessageStatusSchema: z.ZodEnum<{
     uncertain: "uncertain";
 }>;
 export type ChatV3MessageStatus = z.infer<typeof chatV3MessageStatusSchema>;
+/**
+ * A question the agent asked (`ask_user`), answered by its `toolCallId`. `answeredBy` is the
+ * message that answered it; nothing else tracks whether the agent still waits. One too long for
+ * agent-api to keep inline has no questions and cannot be answered (`answerable`).
+ */
+export declare const chatV3QuestionSchema: z.ZodObject<{
+    eventId: z.ZodString;
+    toolCallId: z.ZodString;
+    requestId: z.ZodString;
+    prompt: z.ZodNullable<z.ZodString>;
+    questions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodEnum<{
+            text: "text";
+            single_select: "single_select";
+        }>;
+        placeholder: z.ZodOptional<z.ZodString>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>>;
+    answerable: z.ZodBoolean;
+    answeredBy: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ChatV3Question = z.infer<typeof chatV3QuestionSchema>;
+/**
+ * The question of a `user_input.requested` event as the agent asked it, from the event's text
+ * (`{ prompt, questions }`). One kept without its text, or whose text does not read as a question,
+ * is shown but cannot be answered: agent-api could not check its answers.
+ */
+export declare function questionOfEvent(event: V5SessionEvent): ChatV3Question | null;
 /**
  * One message of the user and the agent's reply to it, rebuilt from the session's events on
  * every read. `text` is `null` while it is only in Vault (`textInVault`); `reply` is the
@@ -174,6 +265,31 @@ export declare const chatV3MessageSchema: z.ZodObject<{
     textInVault: z.ZodBoolean;
     reply: z.ZodString;
     createdAt: z.ZodString;
+    fileCount: z.ZodNumber;
+    question: z.ZodNullable<z.ZodObject<{
+        eventId: z.ZodString;
+        toolCallId: z.ZodString;
+        requestId: z.ZodString;
+        prompt: z.ZodNullable<z.ZodString>;
+        questions: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            type: z.ZodEnum<{
+                text: "text";
+                single_select: "single_select";
+            }>;
+            placeholder: z.ZodOptional<z.ZodString>;
+            options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>>;
+        }, z.core.$loose>>;
+        answerable: z.ZodBoolean;
+        answeredBy: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ChatV3Message = z.infer<typeof chatV3MessageSchema>;
 export declare const chatV3MessageListQuerySchema: z.ZodObject<{
@@ -206,6 +322,31 @@ export declare const chatV3MessageListSchema: z.ZodObject<{
         textInVault: z.ZodBoolean;
         reply: z.ZodString;
         createdAt: z.ZodString;
+        fileCount: z.ZodNumber;
+        question: z.ZodNullable<z.ZodObject<{
+            eventId: z.ZodString;
+            toolCallId: z.ZodString;
+            requestId: z.ZodString;
+            prompt: z.ZodNullable<z.ZodString>;
+            questions: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                required: z.ZodOptional<z.ZodBoolean>;
+                type: z.ZodEnum<{
+                    text: "text";
+                    single_select: "single_select";
+                }>;
+                placeholder: z.ZodOptional<z.ZodString>;
+                options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    value: z.ZodString;
+                    label: z.ZodString;
+                    description: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>>;
+            }, z.core.$loose>>;
+            answerable: z.ZodBoolean;
+            answeredBy: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     nextCursor: z.ZodNullable<z.ZodString>;
     eventCursor: z.ZodNullable<z.ZodString>;

package/dist/runtime/types/schemas/chat/v3.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { v5ArtifactPageSchema, v5EventIdSchema, v5HarnessSchema, v5Limits, v5SessionEventSchema, v5TurnIdSchema } from '../integrations/agent-events';
+import { parseV5EventHint, v5ArtifactPageSchema, v5EventIdSchema, v5HarnessSchema, v5Limits, v5SessionEventSchema, v5TurnIdSchema, v5UserInputRequestSchema, v5VaultReferenceSchema } from '../integrations/agent-events';
 /**
  * Chat API v3 (`/v3/chat`): the conversational surface over agent-api v5 events-v1.
  * The chat-api owns the thread; agent-api owns the session and its history.
@@ -79,9 +79,53 @@ export const chatV3ThreadListSchema = z.object({
     nextCursor: z.string().uuid().nullable(),
 });
 export const CHAT_V3_MESSAGE_PAGE = { default: 30, max: 100 };
-/** A message's text; above the inline limit agent-api keeps it in Vault and the event points at it. */
+/** How many files one message carries; with the message they stay within agent-api's batch. */
+export const CHAT_V3_FILES_PER_MESSAGE = 10;
+/** The largest file a message carries, as the largest artifact agent-api publishes. */
+export const CHAT_V3_FILE_BYTES = 100 * 1024 * 1024;
+export const CHAT_V3_FILE_NAME_CHARS = 255;
+/** `POST /files`: the file about to be uploaded, before its bytes. */
+export const chatV3CreateFileSchema = z.object({
+    name: z.string().trim().min(1).max(CHAT_V3_FILE_NAME_CHARS),
+    size: z.number().int().min(1).max(CHAT_V3_FILE_BYTES),
+    contentType: z.string().trim().min(1).max(255),
+}).strict();
+/** A file in Vault, ready to go with a message: only its reference travels to agent-api. */
+export const chatV3FileSchema = z.object({
+    vaultReference: v5VaultReferenceSchema,
+    name: z.string(),
+    size: z.number().int().nonnegative(),
+    contentType: z.string(),
+});
+/**
+ * A file created in Vault and waiting for its bytes: the browser sends them straight to
+ * `uploadUrl` with a `PUT` and the same `Content-Type`, before it expires. They never pass
+ * through chat-api.
+ */
+export const chatV3FileUploadSchema = chatV3FileSchema.extend({
+    uploadUrl: z.string().url(),
+    expiresAt: z.string(),
+});
+/**
+ * A message's text, and the files sent with it. Above the inline limit agent-api keeps the text in
+ * Vault and the event points at it; each file goes as an `input` the agent finds in `attachments/`.
+ */
 export const chatV3SendMessageSchema = z.object({
     text: z.string().min(1).max(v5Limits.messageTextChars),
+    files: z.array(z.object({ vaultReference: v5VaultReferenceSchema }).strict()).max(CHAT_V3_FILES_PER_MESSAGE).optional(),
+}).strict();
+/** Text sent into a running turn; files go only with a queued message. */
+export const chatV3SteerMessageSchema = z.object({
+    text: z.string().min(1).max(v5Limits.messageTextChars),
+}).strict();
+/**
+ * The answers to the agent's question, by question id: free text, or the `value` of the option
+ * chosen. agent-api checks them against the question, and their size, and opens the next turn
+ * with them.
+ */
+export const chatV3AnswerSchema = z.object({
+    answers: z.record(z.string().min(1), z.string())
+        .refine(answers => Object.keys(answers).length > 0, { message: 'Answer at least one question.' }),
 }).strict();
 /** Cancels the running turn; the turnId comes from the message that started it. */
 export const chatV3CancelTurnSchema = z.object({ turnId: v5TurnIdSchema }).strict();
@@ -92,6 +136,50 @@ export const chatV3MessageReceiptSchema = z.object({
     status: z.string(),
 });
 export const chatV3MessageStatusSchema = z.enum(['queued', 'running', 'completed', 'failed', 'cancelled', 'uncertain']);
+/**
+ * A question the agent asked (`ask_user`), answered by its `toolCallId`. `answeredBy` is the
+ * message that answered it; nothing else tracks whether the agent still waits. One too long for
+ * agent-api to keep inline has no questions and cannot be answered (`answerable`).
+ */
+export const chatV3QuestionSchema = z.object({
+    eventId: v5EventIdSchema,
+    toolCallId: z.string(),
+    /** What `user_input.resolved` names it by. */
+    requestId: z.string(),
+    prompt: z.string().nullable(),
+    questions: v5UserInputRequestSchema.shape.questions,
+    answerable: z.boolean(),
+    answeredBy: v5EventIdSchema.nullable(),
+});
+/**
+ * The question of a `user_input.requested` event as the agent asked it, from the event's text
+ * (`{ prompt, questions }`). One kept without its text, or whose text does not read as a question,
+ * is shown but cannot be answered: agent-api could not check its answers.
+ */
+export function questionOfEvent(event) {
+    const hint = event.type === 'user_input.requested' ? parseV5EventHint('user_input.requested', event.hint) : null;
+    if (!hint || !event.toolCallId)
+        return null;
+    const asked = hint.contentOmitted !== true && event.text !== null ? parseQuestion(event.text) : null;
+    return {
+        eventId: event.eventId,
+        toolCallId: event.toolCallId,
+        requestId: hint.requestId,
+        prompt: asked?.prompt ?? null,
+        questions: asked?.questions ?? [],
+        answerable: asked !== null && asked.questions.length > 0,
+        answeredBy: null,
+    };
+}
+function parseQuestion(text) {
+    try {
+        const parsed = v5UserInputRequestSchema.safeParse(JSON.parse(text));
+        return parsed.success ? parsed.data : null;
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * One message of the user and the agent's reply to it, rebuilt from the session's events on
  * every read. `text` is `null` while it is only in Vault (`textInVault`); `reply` is the
@@ -106,6 +194,10 @@ export const chatV3MessageSchema = z.object({
     textInVault: z.boolean(),
     reply: z.string(),
     createdAt: z.string(),
+    /** Files sent with the message. agent-api keeps no name for them, so only how many. */
+    fileCount: z.number().int().nonnegative(),
+    /** What the agent asked while answering, if it did: its turn ended waiting for the answer. */
+    question: chatV3QuestionSchema.nullable(),
 });
 export const chatV3MessageListQuerySchema = z.object({
     /** Exclusive cursor: the `nextCursor` of the previous page, which reads older messages. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meistrari/chat-nuxt",
-  "version": "4.11.0-rc.2",
+  "version": "4.11.0-rc.4",
   "type": "module",
   "exports": {
     ".": {