@meistrari/chat-nuxt 4.10.0-rc.6 → 4.10.0-rc.8

package/dist/module.json

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

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

@@ -10,12 +10,12 @@ type __VLS_Props = {
     userImage?: string;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
-    select: (id: string) => any;
     close: () => any;
+    select: (id: string) => any;
     newConvo: (groupId?: string | null | undefined) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    onSelect?: ((id: string) => any) | undefined;
     onClose?: (() => any) | undefined;
+    onSelect?: ((id: string) => any) | undefined;
     onNewConvo?: ((groupId?: string | null | undefined) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

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

@@ -10,12 +10,12 @@ type __VLS_Props = {
     userImage?: string;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
-    select: (id: string) => any;
     close: () => any;
+    select: (id: string) => any;
     newConvo: (groupId?: string | null | undefined) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    onSelect?: ((id: string) => any) | undefined;
     onClose?: (() => any) | undefined;
+    onSelect?: ((id: string) => any) | undefined;
     onNewConvo?: ((groupId?: string | null | undefined) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

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

@@ -64,11 +64,11 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {
     "update:selectedReasoningEffort": (value: any) => any;
 } & {
     delete: () => any;
-    cancel: () => any;
     rename: () => any;
     duplicate: () => any;
     export: () => any;
     copyLink: () => any;
+    cancel: () => any;
     debug: () => any;
     selectConversation: (id: string) => any;
     settings: () => any;
@@ -86,11 +86,11 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {
     "update:workspaceSheetOpen": (value: boolean) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     onDelete?: (() => any) | undefined;
-    onCancel?: (() => any) | undefined;
     onRename?: (() => any) | undefined;
     onDuplicate?: (() => any) | undefined;
     onExport?: (() => any) | undefined;
     onCopyLink?: (() => any) | undefined;
+    onCancel?: (() => any) | undefined;
     onDebug?: (() => any) | undefined;
     onSelectConversation?: ((id: string) => any) | undefined;
     onSettings?: (() => any) | undefined;

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

@@ -64,11 +64,11 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {
     "update:selectedReasoningEffort": (value: any) => any;
 } & {
     delete: () => any;
-    cancel: () => any;
     rename: () => any;
     duplicate: () => any;
     export: () => any;
     copyLink: () => any;
+    cancel: () => any;
     debug: () => any;
     selectConversation: (id: string) => any;
     settings: () => any;
@@ -86,11 +86,11 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {
     "update:workspaceSheetOpen": (value: boolean) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     onDelete?: (() => any) | undefined;
-    onCancel?: (() => any) | undefined;
     onRename?: (() => any) | undefined;
     onDuplicate?: (() => any) | undefined;
     onExport?: (() => any) | undefined;
     onCopyLink?: (() => any) | undefined;
+    onCancel?: (() => any) | undefined;
     onDebug?: (() => any) | undefined;
     onSelectConversation?: ((id: string) => any) | undefined;
     onSettings?: (() => any) | undefined;

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

@@ -1,10 +1,10 @@
 import { z } from 'zod';
 /**
  * Chat API v3 (`/v3/chat`): the conversational surface over agent-api v5 events-v1.
- * The chat-api owns the conversation; agent-api owns the session and its history.
+ * The chat-api owns the thread; agent-api owns the session and its history.
  */
 export declare const CHAT_V3_CONTRACT_VERSION = "events-v1";
-/** Where the agent of the request stands in the v5 catalog. */
+/** Where the agent of the request stands in agent-api, where the agent lives. */
 export declare const chatV3AgentStatusSchema: z.ZodEnum<{
     ready: "ready";
     not_requested: "not_requested";
@@ -53,3 +53,161 @@ export declare const chatV3ConfigurationSchema: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type ChatV3Configuration = z.infer<typeof chatV3ConfigurationSchema>;
+export declare const CHAT_V3_TITLE_CHARS = 200;
+export declare const CHAT_V3_CREATION_KEY_CHARS = 128;
+export declare const CHAT_V3_THREAD_PAGE: {
+    readonly default: 30;
+    readonly max: 100;
+};
+/** A thread as the chat owns it: access and title here, history in the agent-api session. */
+export declare const chatV3ThreadSchema: z.ZodObject<{
+    threadId: z.ZodString;
+    agentId: z.ZodString;
+    sessionId: z.ZodString;
+    title: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type ChatV3Thread = z.infer<typeof chatV3ThreadSchema>;
+/** The session behind a thread, read live from agent-api; `null` when agent-api no longer has it. */
+export declare const chatV3SessionSummarySchema: z.ZodNullable<z.ZodObject<{
+    status: z.ZodString;
+    harness: z.ZodString;
+    model: z.ZodNullable<z.ZodString>;
+    reasoningEffort: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>>;
+export declare const chatV3ThreadDetailSchema: z.ZodObject<{
+    threadId: z.ZodString;
+    agentId: z.ZodString;
+    sessionId: z.ZodString;
+    title: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    session: z.ZodNullable<z.ZodObject<{
+        status: z.ZodString;
+        harness: z.ZodString;
+        model: z.ZodNullable<z.ZodString>;
+        reasoningEffort: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ChatV3ThreadDetail = z.infer<typeof chatV3ThreadDetailSchema>;
+/** Creation also opens the agent-api session; send an `Idempotency-Key` header to retry safely. */
+export declare const chatV3CreateThreadSchema: z.ZodObject<{
+    agentId: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ChatV3CreateThread = z.infer<typeof chatV3CreateThreadSchema>;
+export declare const chatV3UpdateThreadSchema: z.ZodObject<{
+    title: z.ZodString;
+}, z.core.$strict>;
+export type ChatV3UpdateThread = z.infer<typeof chatV3UpdateThreadSchema>;
+export declare const chatV3ThreadListQuerySchema: z.ZodObject<{
+    agentId: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+    before: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+export type ChatV3ThreadListQuery = z.infer<typeof chatV3ThreadListQuerySchema>;
+export declare const chatV3ThreadListSchema: z.ZodObject<{
+    threads: z.ZodArray<z.ZodObject<{
+        threadId: z.ZodString;
+        agentId: z.ZodString;
+        sessionId: z.ZodString;
+        title: z.ZodString;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ChatV3ThreadList = z.infer<typeof chatV3ThreadListSchema>;
+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. */
+export declare const chatV3SendMessageSchema: z.ZodObject<{
+    text: z.ZodString;
+}, z.core.$strict>;
+export type ChatV3SendMessage = z.infer<typeof chatV3SendMessageSchema>;
+/** Cancels the running turn; the turnId comes from the message that started it. */
+export declare const chatV3CancelTurnSchema: z.ZodObject<{
+    turnId: z.ZodString;
+}, z.core.$strict>;
+export type ChatV3CancelTurn = z.infer<typeof chatV3CancelTurnSchema>;
+/** The answer of every write: agent-api admitted the user event. `messageId` is its v5 eventId. */
+export declare const chatV3MessageReceiptSchema: z.ZodObject<{
+    messageId: z.ZodString;
+    turnId: z.ZodNullable<z.ZodString>;
+    status: z.ZodString;
+}, z.core.$strip>;
+export type ChatV3MessageReceipt = z.infer<typeof chatV3MessageReceiptSchema>;
+export declare const chatV3MessageStatusSchema: z.ZodEnum<{
+    running: "running";
+    completed: "completed";
+    failed: "failed";
+    cancelled: "cancelled";
+    queued: "queued";
+    uncertain: "uncertain";
+}>;
+export type ChatV3MessageStatus = z.infer<typeof chatV3MessageStatusSchema>;
+/**
+ * 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
+ * canonical text the agent stored so far, without the live drafts.
+ */
+export declare const chatV3MessageSchema: z.ZodObject<{
+    messageId: z.ZodString;
+    turnId: z.ZodNullable<z.ZodString>;
+    mode: z.ZodEnum<{
+        queue: "queue";
+        steer: "steer";
+        answer: "answer";
+    }>;
+    status: z.ZodEnum<{
+        running: "running";
+        completed: "completed";
+        failed: "failed";
+        cancelled: "cancelled";
+        queued: "queued";
+        uncertain: "uncertain";
+    }>;
+    text: z.ZodNullable<z.ZodString>;
+    textInVault: z.ZodBoolean;
+    reply: z.ZodString;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export type ChatV3Message = z.infer<typeof chatV3MessageSchema>;
+export declare const chatV3MessageListQuerySchema: z.ZodObject<{
+    before: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+export type ChatV3MessageListQuery = z.infer<typeof chatV3MessageListQuerySchema>;
+/**
+ * The latest messages, oldest first. `eventCursor` is the last event the page was built from:
+ * open the event stream with it as `Last-Event-ID` and nothing falls between the two.
+ */
+export declare const chatV3MessageListSchema: z.ZodObject<{
+    messages: z.ZodArray<z.ZodObject<{
+        messageId: z.ZodString;
+        turnId: z.ZodNullable<z.ZodString>;
+        mode: z.ZodEnum<{
+            queue: "queue";
+            steer: "steer";
+            answer: "answer";
+        }>;
+        status: z.ZodEnum<{
+            running: "running";
+            completed: "completed";
+            failed: "failed";
+            cancelled: "cancelled";
+            queued: "queued";
+            uncertain: "uncertain";
+        }>;
+        text: z.ZodNullable<z.ZodString>;
+        textInVault: z.ZodBoolean;
+        reply: z.ZodString;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+    eventCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ChatV3MessageList = z.infer<typeof chatV3MessageListSchema>;

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

@@ -1,15 +1,15 @@
 import { z } from 'zod';
-import { v5HarnessSchema } from '../integrations/agent-events';
+import { v5EventIdSchema, v5HarnessSchema, v5Limits, v5TurnIdSchema } from '../integrations/agent-events';
 /**
  * Chat API v3 (`/v3/chat`): the conversational surface over agent-api v5 events-v1.
- * The chat-api owns the conversation; agent-api owns the session and its history.
+ * The chat-api owns the thread; agent-api owns the session and its history.
  */
 export const CHAT_V3_CONTRACT_VERSION = 'events-v1';
-/** Where the agent of the request stands in the v5 catalog. */
+/** Where the agent of the request stands in agent-api, where the agent lives. */
 export const chatV3AgentStatusSchema = z.enum([
-    /** No `telaAgentId` on the request: nothing to resolve yet. */
+    /** No `agentId` on the request: nothing to look up yet. */
     'not_requested',
-    /** Tela knows the agent, but the v5 catalog does not: Tela has to create it there. */
+    /** agent-api has no such agent in the caller's workspace. */
     'not_in_catalog',
     /** In the catalog without a publication: `POST /v5/agents/snapshots` first. */
     'not_published',
@@ -35,3 +35,89 @@ export const chatV3ConfigurationSchema = z.object({
         eventsPerRequest: z.number().int().positive(),
     }),
 });
+export const CHAT_V3_TITLE_CHARS = 200;
+export const CHAT_V3_CREATION_KEY_CHARS = 128;
+export const CHAT_V3_THREAD_PAGE = { default: 30, max: 100 };
+/**
+ * The agent's id in agent-api, the only one the chat uses. Lowercased, as agent-api and Postgres
+ * write uuids, so the same agent always compares equal.
+ */
+const agentIdSchema = z.string().uuid().transform(id => id.toLowerCase());
+/** A thread as the chat owns it: access and title here, history in the agent-api session. */
+export const chatV3ThreadSchema = z.object({
+    threadId: z.string().uuid(),
+    agentId: z.string().uuid(),
+    sessionId: z.string().uuid(),
+    title: z.string(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+});
+/** The session behind a thread, read live from agent-api; `null` when agent-api no longer has it. */
+export const chatV3SessionSummarySchema = z.object({
+    status: z.string(),
+    harness: z.string(),
+    model: z.string().nullable(),
+    reasoningEffort: z.string().nullable(),
+}).nullable();
+export const chatV3ThreadDetailSchema = chatV3ThreadSchema.extend({ session: chatV3SessionSummarySchema });
+/** Creation also opens the agent-api session; send an `Idempotency-Key` header to retry safely. */
+export const chatV3CreateThreadSchema = z.object({
+    agentId: agentIdSchema,
+    title: z.string().trim().max(CHAT_V3_TITLE_CHARS).optional(),
+}).strict();
+export const chatV3UpdateThreadSchema = z.object({
+    title: z.string().trim().max(CHAT_V3_TITLE_CHARS),
+}).strict();
+export const chatV3ThreadListQuerySchema = z.object({
+    agentId: agentIdSchema.optional(),
+    /** Exclusive cursor: the last `threadId` of the previous page. */
+    before: z.string().uuid().optional(),
+    limit: z.coerce.number().int().min(1).max(CHAT_V3_THREAD_PAGE.max).default(CHAT_V3_THREAD_PAGE.default),
+}).strict();
+export const chatV3ThreadListSchema = z.object({
+    threads: z.array(chatV3ThreadSchema),
+    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. */
+export const chatV3SendMessageSchema = z.object({
+    text: z.string().min(1).max(v5Limits.messageTextChars),
+}).strict();
+/** Cancels the running turn; the turnId comes from the message that started it. */
+export const chatV3CancelTurnSchema = z.object({ turnId: v5TurnIdSchema }).strict();
+/** The answer of every write: agent-api admitted the user event. `messageId` is its v5 eventId. */
+export const chatV3MessageReceiptSchema = z.object({
+    messageId: v5EventIdSchema,
+    turnId: v5TurnIdSchema.nullable(),
+    status: z.string(),
+});
+export const chatV3MessageStatusSchema = z.enum(['queued', 'running', 'completed', 'failed', 'cancelled', 'uncertain']);
+/**
+ * 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
+ * canonical text the agent stored so far, without the live drafts.
+ */
+export const chatV3MessageSchema = z.object({
+    messageId: v5EventIdSchema,
+    turnId: v5TurnIdSchema.nullable(),
+    mode: z.enum(['queue', 'steer', 'answer']),
+    status: chatV3MessageStatusSchema,
+    text: z.string().nullable(),
+    textInVault: z.boolean(),
+    reply: z.string(),
+    createdAt: z.string(),
+});
+export const chatV3MessageListQuerySchema = z.object({
+    /** Exclusive cursor: the `nextCursor` of the previous page, which reads older messages. */
+    before: v5EventIdSchema.optional(),
+    limit: z.coerce.number().int().min(1).max(CHAT_V3_MESSAGE_PAGE.max).default(CHAT_V3_MESSAGE_PAGE.default),
+}).strict();
+/**
+ * The latest messages, oldest first. `eventCursor` is the last event the page was built from:
+ * open the event stream with it as `Last-Event-ID` and nothing falls between the two.
+ */
+export const chatV3MessageListSchema = z.object({
+    messages: z.array(chatV3MessageSchema),
+    nextCursor: v5EventIdSchema.nullable(),
+    eventCursor: v5EventIdSchema.nullable(),
+});

package/package.json

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