@vibesdotdev/chat 0.0.0-stage → 1.0.0-rc.1

package/dist/context/providers/messages/chat-messages.provider.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-messages.provider.descriptor.d.ts","sourceRoot":"","sources":["../../../../src/context/providers/messages/chat-messages.provider.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAWf,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/context/providers/messages/chat-messages.provider.descriptor.js

@@ -0,0 +1,23 @@
+/**
+ * Chat Messages Context Provider Descriptor (`ai/context.provider`).
+ *
+ * Declares the shape of the provider so the runtime knows what staged
+ * input it accepts and what resolved output it produces. Browser and
+ * worker implementations live in sibling `.impl.browser.ts` and
+ * `.impl.worker.ts` files and are registered via loaders.
+ */
+import { chatMessagesStaged, chatMessagesResolved } from "./schemas/index.js";
+const descriptor = {
+    id: 'chat-messages',
+    kind: 'ai/context.provider',
+    contextId: 'chat-messages',
+    name: 'Chat Messages',
+    description: 'Fetches historical chat messages for use as generation context',
+    order: 10,
+    schemas: {
+        staged: chatMessagesStaged,
+        resolved: chatMessagesResolved
+    }
+};
+export default descriptor;
+//# sourceMappingURL=chat-messages.provider.descriptor.js.map

package/dist/context/providers/messages/chat-messages.provider.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-messages.provider.descriptor.js","sourceRoot":"","sources":["../../../../src/context/providers/messages/chat-messages.provider.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE9E,MAAM,UAAU,GAAG;IAClB,EAAE,EAAE,eAAe;IACnB,IAAI,EAAE,qBAA8B;IACpC,SAAS,EAAE,eAAe;IAC1B,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,gEAAgE;IAC7E,KAAK,EAAE,EAAE;IACT,OAAO,EAAE;QACR,MAAM,EAAE,kBAAkB;QAC1B,QAAQ,EAAE,oBAAoB;KAC9B;CACD,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/context/providers/messages/schemas/index.d.ts

@@ -0,0 +1,63 @@
+import * as z from 'zod/v4';
+export declare const chatMessagesStaged: z.ZodObject<{
+    type: z.ZodDefault<z.ZodLiteral<"chat-messages">>;
+    chatRoomId: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    beforeMessageId: z.ZodOptional<z.ZodString>;
+    messageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const chatMessagesResolvedItem: z.ZodObject<{
+    id: z.ZodString;
+    chatRoomId: z.ZodString;
+    senderType: z.ZodEnum<{
+        agent: "agent";
+        user: "user";
+        system: "system";
+    }>;
+    messageType: z.ZodString;
+    content: z.ZodString;
+    userId: z.ZodNullable<z.ZodString>;
+    agentId: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export declare const chatMessagesResolved: z.ZodObject<{
+    chatRoomId: z.ZodString;
+    messages: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        chatRoomId: z.ZodString;
+        senderType: z.ZodEnum<{
+            agent: "agent";
+            user: "user";
+            system: "system";
+        }>;
+        messageType: z.ZodString;
+        content: z.ZodString;
+        userId: z.ZodNullable<z.ZodString>;
+        agentId: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ChatMessagesStaged = z.infer<typeof chatMessagesStaged>;
+export type ChatMessagesResolvedItem = z.infer<typeof chatMessagesResolvedItem>;
+export type ChatMessagesResolved = z.infer<typeof chatMessagesResolved>;
+import type { JsonObject } from '@vibesdotdev/kernel/schemas/json';
+export interface LLMChainMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    additionalKwargs?: JsonObject;
+}
+export interface ListMessagesResponseItem {
+    id: string;
+    chatRoomId: string;
+    senderType: 'user' | 'agent' | 'system';
+    messageType: string;
+    content?: string | null;
+    userId?: string | null;
+    agentId?: string | null;
+    createdAt: string;
+}
+export interface ListMessagesResponse {
+    messages?: ListMessagesResponseItem[];
+    items?: ListMessagesResponseItem[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/context/providers/messages/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/context/providers/messages/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,eAAO,MAAM,kBAAkB;;;;;;iBAM7B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;iBASnC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;iBAG/B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACpE,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAChF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,UAAU,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAwB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACtC,KAAK,CAAC,EAAE,wBAAwB,EAAE,CAAC;CACnC"}

package/dist/context/providers/messages/schemas/index.js

@@ -0,0 +1,23 @@
+import * as z from 'zod/v4';
+export const chatMessagesStaged = z.object({
+    type: z.literal('chat-messages').default('chat-messages'),
+    chatRoomId: z.string().uuid(),
+    limit: z.number().int().min(1).max(500).default(50),
+    beforeMessageId: z.string().uuid().optional(),
+    messageIds: z.array(z.string().uuid()).optional()
+});
+export const chatMessagesResolvedItem = z.object({
+    id: z.string().uuid(),
+    chatRoomId: z.string().uuid(),
+    senderType: z.enum(['user', 'agent', 'system']),
+    messageType: z.string(),
+    content: z.string(),
+    userId: z.string().nullable(),
+    agentId: z.string().nullable(),
+    createdAt: z.iso.datetime()
+});
+export const chatMessagesResolved = z.object({
+    chatRoomId: z.string().uuid(),
+    messages: z.array(chatMessagesResolvedItem)
+});
+//# sourceMappingURL=index.js.map

package/dist/context/providers/messages/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/context/providers/messages/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;IACzD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACnD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IAC7C,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACrB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC7B,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC/C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;CAC3B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC7B,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC;CAC3C,CAAC,CAAC"}

package/dist/contracts/composer-action.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The `chat/composer.action` descriptor contract: schema, types and the pure
+ * factory a feature uses to author one. Zod and types only; the kind and its
+ * resolution live in `../surface/composer-actions.ts`.
+ */
+import * as z from 'zod/v4';
+export declare const CHAT_COMPOSER_ACTION_KIND = "chat/composer.action";
+export declare const ChatComposerActionDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    hardware: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    priority: z.ZodOptional<z.ZodNumber>;
+    capabilityId: z.ZodOptional<z.ZodString>;
+    requiredContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optionalContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    config: z.ZodOptional<z.ZodUnknown>;
+    retention: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        maxAgeDays: z.ZodOptional<z.ZodNumber>;
+        maxEntries: z.ZodOptional<z.ZodNumber>;
+        maxBytes: z.ZodOptional<z.ZodNumber>;
+        cascadeFrom: z.ZodOptional<z.ZodString>;
+        ageField: z.ZodOptional<z.ZodString>;
+        reason: z.ZodString;
+        enforcedBy: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    kind: z.ZodLiteral<"chat/composer.action">;
+    label: z.ZodOptional<z.ZodString>;
+    icon: z.ZodString;
+    command: z.ZodOptional<z.ZodString>;
+    dialog: z.ZodOptional<z.ZodString>;
+    widgetId: z.ZodOptional<z.ZodString>;
+    event: z.ZodOptional<z.ZodString>;
+    insertText: z.ZodOptional<z.ZodString>;
+    roomMode: z.ZodOptional<z.ZodEnum<{
+        standard: "standard";
+        multi: "multi";
+    }>>;
+    requiresRoom: z.ZodDefault<z.ZodBoolean>;
+    requiresAgent: z.ZodDefault<z.ZodBoolean>;
+    surfaces: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type ChatComposerActionDescriptor = z.infer<typeof ChatComposerActionDescriptorSchema>;
+export type ChatComposerActionDescriptorInput = z.input<typeof ChatComposerActionDescriptorSchema>;
+export declare function createChatComposerActionDescriptor(input: Omit<ChatComposerActionDescriptorInput, 'kind'> & {
+    kind?: typeof CHAT_COMPOSER_ACTION_KIND;
+}): ChatComposerActionDescriptor;
+//# sourceMappingURL=composer-action.d.ts.map

package/dist/contracts/composer-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer-action.d.ts","sourceRoot":"","sources":["../../src/contracts/composer-action.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B,eAAO,MAAM,yBAAyB,yBAAyB,CAAC;AAEhE,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAa7C,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAC9F,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAEnG,wBAAgB,kCAAkC,CACjD,KAAK,EAAE,IAAI,CAAC,iCAAiC,EAAE,MAAM,CAAC,GAAG;IACxD,IAAI,CAAC,EAAE,OAAO,yBAAyB,CAAC;CACxC,GACC,4BAA4B,CAU9B"}

package/dist/contracts/composer-action.js

@@ -0,0 +1,35 @@
+/**
+ * The `chat/composer.action` descriptor contract: schema, types and the pure
+ * factory a feature uses to author one. Zod and types only; the kind and its
+ * resolution live in `../surface/composer-actions.ts`.
+ */
+import * as z from 'zod/v4';
+import { RuntimeDescriptorSchema } from '@vibesdotdev/kernel/schemas/descriptor';
+import { chatRoomSurfaceModeSchema } from "../schemas/common.js";
+export const CHAT_COMPOSER_ACTION_KIND = 'chat/composer.action';
+export const ChatComposerActionDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal(CHAT_COMPOSER_ACTION_KIND),
+    label: z.string().min(1).optional(),
+    icon: z.string().min(1),
+    command: z.string().min(1).optional(),
+    dialog: z.string().min(1).optional(),
+    widgetId: z.string().min(1).optional(),
+    event: z.string().min(1).optional(),
+    insertText: z.string().optional(),
+    roomMode: chatRoomSurfaceModeSchema.optional(),
+    requiresRoom: z.boolean().default(false),
+    requiresAgent: z.boolean().default(false),
+    surfaces: z.array(z.string().min(1)).default(['svelte'])
+});
+export function createChatComposerActionDescriptor(input) {
+    const result = ChatComposerActionDescriptorSchema.safeParse({
+        ...input,
+        kind: CHAT_COMPOSER_ACTION_KIND
+    });
+    if (!result.success) {
+        const issues = result.error.issues.map((issue) => `${issue.path.join('.')}: ${issue.message}`);
+        throw new Error(`Invalid chat/composer.action descriptor '${input.id}': ${issues.join(', ')}`);
+    }
+    return result.data;
+}
+//# sourceMappingURL=composer-action.js.map

package/dist/contracts/composer-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer-action.js","sourceRoot":"","sources":["../../src/contracts/composer-action.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,MAAM,CAAC,MAAM,yBAAyB,GAAG,sBAAsB,CAAC;AAEhE,MAAM,CAAC,MAAM,kCAAkC,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAChF,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAAC;IAC1C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACrC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,QAAQ,EAAE,yBAAyB,CAAC,QAAQ,EAAE;IAC9C,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACxC,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACzC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC;CACxD,CAAC,CAAC;AAKH,MAAM,UAAU,kCAAkC,CACjD,KAEC;IAED,MAAM,MAAM,GAAG,kCAAkC,CAAC,SAAS,CAAC;QAC3D,GAAG,KAAK;QACR,IAAI,EAAE,yBAAyB;KAC/B,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/F,MAAM,IAAI,KAAK,CAAC,4CAA4C,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACpB,CAAC"}

package/dist/contracts/dialog-widget.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The `chat/dialog.widget` descriptor contract: schema, types and the pure
+ * factory a feature uses to author one. Zod and types only; the kind and its
+ * resolution live in `../surface/dialog-widgets.ts`.
+ */
+import * as z from 'zod/v4';
+export declare const CHAT_DIALOG_WIDGET_KIND = "chat/dialog.widget";
+export declare const ChatDialogWidgetDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    hardware: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    priority: z.ZodOptional<z.ZodNumber>;
+    capabilityId: z.ZodOptional<z.ZodString>;
+    requiredContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optionalContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    config: z.ZodOptional<z.ZodUnknown>;
+    retention: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        maxAgeDays: z.ZodOptional<z.ZodNumber>;
+        maxEntries: z.ZodOptional<z.ZodNumber>;
+        maxBytes: z.ZodOptional<z.ZodNumber>;
+        cascadeFrom: z.ZodOptional<z.ZodString>;
+        ageField: z.ZodOptional<z.ZodString>;
+        reason: z.ZodString;
+        enforcedBy: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    kind: z.ZodLiteral<"chat/dialog.widget">;
+    dialog: z.ZodString;
+    actionId: z.ZodOptional<z.ZodString>;
+    event: z.ZodOptional<z.ZodString>;
+    implementationId: z.ZodOptional<z.ZodString>;
+    requiresRoom: z.ZodDefault<z.ZodBoolean>;
+    surfaces: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type ChatDialogWidgetDescriptor = z.infer<typeof ChatDialogWidgetDescriptorSchema>;
+export type ChatDialogWidgetDescriptorInput = z.input<typeof ChatDialogWidgetDescriptorSchema>;
+export declare function createChatDialogWidgetDescriptor(input: Omit<ChatDialogWidgetDescriptorInput, 'kind'> & {
+    kind?: typeof CHAT_DIALOG_WIDGET_KIND;
+}): ChatDialogWidgetDescriptor;
+//# sourceMappingURL=dialog-widget.d.ts.map

package/dist/contracts/dialog-widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog-widget.d.ts","sourceRoot":"","sources":["../../src/contracts/dialog-widget.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAE5D,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQ3C,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAC1F,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CACpD,OAAO,gCAAgC,CACvC,CAAC;AAEF,wBAAgB,gCAAgC,CAC/C,KAAK,EAAE,IAAI,CAAC,+BAA+B,EAAE,MAAM,CAAC,GAAG;IACtD,IAAI,CAAC,EAAE,OAAO,uBAAuB,CAAC;CACtC,GACC,0BAA0B,CAY5B"}

package/dist/contracts/dialog-widget.js

@@ -0,0 +1,31 @@
+/**
+ * The `chat/dialog.widget` descriptor contract: schema, types and the pure
+ * factory a feature uses to author one. Zod and types only; the kind and its
+ * resolution live in `../surface/dialog-widgets.ts`.
+ */
+import * as z from 'zod/v4';
+import { RuntimeDescriptorSchema } from '@vibesdotdev/kernel/schemas/descriptor';
+export const CHAT_DIALOG_WIDGET_KIND = 'chat/dialog.widget';
+export const ChatDialogWidgetDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal(CHAT_DIALOG_WIDGET_KIND),
+    dialog: z.string().min(1),
+    actionId: z.string().min(1).optional(),
+    event: z.string().min(1).optional(),
+    implementationId: z.string().min(1).optional(),
+    requiresRoom: z.boolean().default(false),
+    surfaces: z.array(z.string().min(1)).default(['svelte'])
+});
+export function createChatDialogWidgetDescriptor(input) {
+    const result = ChatDialogWidgetDescriptorSchema.safeParse({
+        ...input,
+        kind: CHAT_DIALOG_WIDGET_KIND
+    });
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((issue) => `${issue.path.join('.')}: ${issue.message}`)
+            .join(', ');
+        throw new Error(`Invalid chat/dialog.widget descriptor '${input.id}': ${issues}`);
+    }
+    return result.data;
+}
+//# sourceMappingURL=dialog-widget.js.map

package/dist/contracts/dialog-widget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog-widget.js","sourceRoot":"","sources":["../../src/contracts/dialog-widget.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAEjF,MAAM,CAAC,MAAM,uBAAuB,GAAG,oBAAoB,CAAC;AAE5D,MAAM,CAAC,MAAM,gCAAgC,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAC9E,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC;IACxC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC9C,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACxC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC;CACxD,CAAC,CAAC;AAOH,MAAM,UAAU,gCAAgC,CAC/C,KAEC;IAED,MAAM,MAAM,GAAG,gCAAgC,CAAC,SAAS,CAAC;QACzD,GAAG,KAAK;QACR,IAAI,EAAE,uBAAuB;KAC7B,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aAChC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;aAC3D,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,0CAA0C,KAAK,CAAC,EAAE,MAAM,MAAM,EAAE,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACpB,CAAC"}

package/dist/docs/chat.docs.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs-contracts';
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=chat.docs.descriptor.d.ts.map

package/dist/docs/chat.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/chat.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAqCvE,QAAA,MAAM,UAAU,EAAE,mBAejB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/chat.docs.descriptor.js

@@ -0,0 +1,52 @@
+const chatMarkdown = `---
+title: Chat
+summary: Sessions, threads, messages, history, and image mode.
+parent: 
+order: 4
+---
+
+# Chat
+
+Sessions, threads, messages, history, and image mode. Chat surfaces are runtime-backed; a \`ChatRoom\` drives a run via \`room.send()\` and streams results back.
+
+## When to use
+
+Reach for chat when your app needs persistent, multi-participant conversations — human or agent — with streamed responses, threaded replies, and durable history rather than a one-shot AI call.
+
+## How it resolves
+
+The semantic Chat client is registered as \`runtime/client\` id \`chat\`. Its \`chat/client\` factories select transport and storage through runtime scope:
+
+\`\`\`ts
+// \`runtime\` is the VibesRuntime you were handed: \`context.runtime\` in a tool, command or job, or the plugin's \`RuntimeRef\`.
+import { getVibesChatClient } from '@vibesdotdev/chat/client';
+const chat = await getVibesChatClient(runtime);
+\`\`\`
+
+:::card{title="In this section"}
+- [\`chat.sessions\`](chat.sessions) — Chat Sessions
+- [\`chat.messages\`](chat.messages) — Chat Messages
+- [\`chat.threads\`](chat.threads) — Chat Threads
+- [\`chat.history\`](chat.history) — Chat History
+- [\`chat.image-mode\`](chat.image-mode) — Image Generation Mode
+- [\`chat.moderation\`](chat.moderation) — Chat Moderation
+:::
+`;
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'chat',
+    title: 'Chat',
+    summary: "Sessions, threads, messages, history, and image mode.",
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: chatMarkdown
+    },
+    order: 4,
+    tags: ['chat', 'overview'],
+    surfaces: ['web', 'in-app'],
+    hardware: ['consumer', 'cloud'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=chat.docs.descriptor.js.map

package/dist/docs/chat.docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.docs.descriptor.js","sourceRoot":"","sources":["../../src/docs/chat.docs.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCpB,CAAC;AAEF,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,MAAM;IACV,KAAK,EAAE,MAAM;IACb,OAAO,EAAE,uDAAuD;IAChE,IAAI,EAAE;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,YAAY;KACpB;IACD,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC;IAC1B,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC;IAC3B,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/chat.history.docs.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs-contracts';
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=chat.history.docs.descriptor.d.ts.map

package/dist/docs/chat.history.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.history.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/chat.history.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAuHvE,QAAA,MAAM,UAAU,EAAE,mBAgBjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/chat.history.docs.descriptor.js

@@ -0,0 +1,135 @@
+const markdown = `---
+title: Chat History
+summary: Retrieve and paginate room message history
+tags: [chat, history, retrieval, pagination, messages]
+parent: chat
+order: 4
+surfaces: [cli, web, in-app]
+hardware: [consumer, cloud]
+---
+
+# Chat History
+
+A room's history is its ordered list of \`UnifiedChatMessage\` records. You read
+and paginate it through \`room.messages\`, the \`ChatRoomMessages\` collection on
+every \`ChatRoom\` handle. There is no separate history service — \`list()\` plus
+cursor pagination is the whole surface.
+
+## Get the room handle
+
+Acquire the runtime chat client, then resolve a room. \`room.messages\` is the
+message collection for that room.
+
+:::usage{language="ts"}
+import { getVibesChatClient } from '@vibesdotdev/chat/client';
+
+const chat = await getVibesChatClient(runtime);
+const room = await chat.rooms.get(roomId);
+if (!room) throw new Error('room not found');
+
+// Most recent messages (defaults to the last \`limit\`)
+const recent = await room.messages.list({ limit: 50 });
+:::
+
+\`list()\` resolves to a plain \`UnifiedChatMessage[]\` in chronological order
+(oldest → newest). Each message exposes \`id\`, \`role\` (\`'system' | 'user' |
+'assistant'\`), \`senderType\`, \`content\`, \`createdAt\`, and optional
+\`updatedAt\`.
+
+## Pagination
+
+Paging is cursor-based. The \`cursor\` is a message \`id\`, and \`direction\` selects
+which side of that cursor to read. With no \`cursor\`, \`list()\` returns the last
+\`limit\` messages.
+
+:::usage{language="ts"}
+// First page: the most recent 50 messages
+const page = await room.messages.list({ limit: 50 });
+
+// Older messages — page backwards from the oldest id we have
+const older = await room.messages.list({
+  limit: 50,
+  cursor: page[0]?.id,
+  direction: 'before'
+});
+
+// Newer messages — page forwards from the newest id we have
+const newer = await room.messages.list({
+  limit: 50,
+  cursor: page[page.length - 1]?.id,
+  direction: 'after'
+});
+:::
+
+\`list()\` options:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| \`limit\` | number | Max messages to return |
+| \`cursor\` | string | Message id to page from |
+| \`direction\` | \`'before' \\| 'after'\` | Read older or newer than the cursor |
+
+## Reading a single message
+
+:::usage{language="ts"}
+const message = await room.messages.get(messageId);
+if (message) {
+  console.log(message.role, message.content, message.createdAt);
+}
+:::
+
+## Live updates
+
+\`subscribe()\` fires whenever the room's message list changes, so a history
+view stays current without re-fetching.
+
+:::usage{language="ts"}
+const unsubscribe = room.messages.subscribe((messages) => {
+  // \`messages\` is the full UnifiedChatMessage[] for the room
+  render(messages);
+});
+
+// later
+unsubscribe();
+:::
+
+## Clearing history
+
+\`clear()\` removes every message in the room. There is no built-in archive,
+export, import, or full-text search on \`ChatRoomMessages\` — compose those in
+your application from \`list()\` if you need them.
+
+:::usage{language="ts"}
+await room.messages.clear();
+:::
+
+## Related descriptors
+
+:::descriptor{kind="docs/topic" id="chat.sessions"}
+:::
+
+:::descriptor{kind="docs/topic" id="chat.messages"}
+:::
+
+:::descriptor{kind="docs/topic" id="knowledge.search"}
+:::
+`;
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'chat.history',
+    title: 'Chat History',
+    summary: 'Retrieve and paginate room message history',
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: markdown
+    },
+    parent: 'chat',
+    order: 4,
+    tags: ['chat', 'history', 'retrieval', 'pagination', 'messages'],
+    surfaces: ['cli', 'web', 'in-app'],
+    hardware: ['consumer', 'cloud'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=chat.history.docs.descriptor.js.map

package/dist/docs/chat.history.docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.history.docs.descriptor.js","sourceRoot":"","sources":["../../src/docs/chat.history.docs.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmHhB,CAAC;AAEF,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,cAAc;IAClB,KAAK,EAAE,cAAc;IACrB,OAAO,EAAE,4CAA4C;IACrD,IAAI,EAAE;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,QAAQ;KAChB;IACD,MAAM,EAAE,MAAM;IACd,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,CAAC;IAChE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC;IAClC,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/chat.image-mode.docs.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs-contracts';
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=chat.image-mode.docs.descriptor.d.ts.map

package/dist/docs/chat.image-mode.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.image-mode.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/chat.image-mode.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAyDvE,QAAA,MAAM,UAAU,EAAE,mBAgBjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/chat.image-mode.docs.descriptor.js

@@ -0,0 +1,73 @@
+const markdown = `---
+title: Image Generation Mode
+summary: Generate and iteratively refine images directly in a chat room
+tags: [chat, image, generation, modes, generate-image, tool-card]
+parent: chat
+order: 6
+surfaces: [web, in-app]
+hardware: [consumer, cloud]
+---
+
+# Image Generation Mode
+
+Image mode turns a chat room into an image studio. When active, the agent is
+scoped to the dedicated \`generate-image\` tool and renders results inline as a
+first-class image card — no separate dialog, no prompt injection.
+
+> **Not \`ai-generate\`.** The multipurpose \`ai-generate\` tool remains for
+> text/audio/embeddings and MCP-style clients. Image mode's allowList and
+> system prompt both use **\`generate-image\`** only.
+
+## How it works
+
+- **Mode**: \`image\` is a built-in \`chat/mode\` descriptor with
+  \`tools.allowList: ['generate-image']\`, \`toolApprovalMode: 'auto-approve-safe'\`,
+  and a refine-across-turns system prompt. Select it from the chat mode
+  selector like any other mode.
+- **Tool**: the agent calls \`generate-image\` with a full-scene \`prompt\`.
+  The cloud image tool returns images inline (\`url\` or \`base64\`) because
+  workerd has no filesystem.
+- **Capture**: \`run-chat-generation\` records tool calls and tool results into
+  \`metadata.toolCalls\`, streamed over SSE. ai-web emits a dedicated
+  \`tool_result\` event so the generated image reaches chat.
+- **Render**: chat-web's \`ChatMessageCard\` renders an \`ImageGenerationToolCard\`
+  (from \`@vibesdotdev/chat/svelte\`) showing the prompt, a loading skeleton
+  while running, and the inline image when complete.
+
+## Multi-turn refinement
+
+The mode prompt instructs the agent to treat the conversation as iterative
+refinement of one evolving image: carry forward the established scene, merge the
+latest instruction into a full updated prompt, and restate the complete scene
+each call. The 50-message history window feeds prior prompts and results back as
+context.
+
+## Requirements
+
+- The acting agent must have \`generate-image\` resolvable (the mode's allowList
+  scopes which tools it may use, but the tool must be registered). Both
+  \`ai-web\` and \`chat-web\` compose \`@vibesdotdev/ai/tools-impl/plugin\` so the
+  image tool resolves in cloud scope.
+- An image-capable provider/model must be configured (e.g. a DigitalOcean
+  SD3.5 or OpenAI image model). If no image provider resolves at cold start,
+  generation will error.
+`;
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'chat.image-mode',
+    title: 'Image Generation Mode',
+    summary: 'Generate and iteratively refine images directly in a chat room',
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: markdown
+    },
+    parent: 'chat',
+    order: 6,
+    tags: ['chat', 'image', 'generation', 'modes', 'generate-image', 'tool-card'],
+    surfaces: ['web', 'in-app'],
+    hardware: ['consumer', 'cloud'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=chat.image-mode.docs.descriptor.js.map

package/dist/docs/chat.image-mode.docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.image-mode.docs.descriptor.js","sourceRoot":"","sources":["../../src/docs/chat.image-mode.docs.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqDhB,CAAC;AAEF,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,iBAAiB;IACrB,KAAK,EAAE,uBAAuB;IAC9B,OAAO,EAAE,gEAAgE;IACzE,IAAI,EAAE;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,QAAQ;KAChB;IACD,MAAM,EAAE,MAAM;IACd,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,gBAAgB,EAAE,WAAW,CAAC;IAC7E,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC;IAC3B,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/chat.messages.docs.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs-contracts';
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=chat.messages.docs.descriptor.d.ts.map

package/dist/docs/chat.messages.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.messages.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/chat.messages.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAiMvE,QAAA,MAAM,UAAU,EAAE,mBAgBjB,CAAC;AAEF,eAAe,UAAU,CAAC"}