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

package/dist/client/citations.js

@@ -0,0 +1,139 @@
+import * as z from 'zod/v4';
+import { CapabilityError, settleNow } from '@vibesdotdev/kernel';
+import { CitationLocateContextSchema, CitationSchema, QuoteSchema } from '@vibesdotdev/shared/citations';
+import { ChatCitationQuerySchema, ChatCitationTargetSchema } from "../schemas/citations.js";
+import { ChatRoomsStateSchema } from "../storage/chat-rooms.storage.schema.js";
+/** Whole-document revisions conservatively invalidate every selected room/message. No body census is needed. */
+export function createLocalChatCitations(runtime, reader) {
+    function scope(expected) {
+        const current = z.string().min(1).safeParse(runtime.invocationWorkspace?.id);
+        if (!current.success)
+            throw refuse('chat-citation-scope-required', 'UNAVAILABLE');
+        if (expected !== undefined && current.data !== expected)
+            throw refuse('chat-citation-scope-mismatch', 'PERMISSION_DENIED');
+        return current.data;
+    }
+    function selected(input) {
+        const citation = CitationSchema.parse(input);
+        scope(citation.scope);
+        if (citation.link.kind !== 'chat' || citation.link.source !== 'chat')
+            throw refuse('chat-citation-kind-invalid', 'INVALID_INPUT');
+        if (citation.revision.scheme !== 'chat-local-document-v1')
+            throw changed();
+        if (citation.anchor !== undefined && citation.anchor.kind !== 'region')
+            throw refuse('chat-citation-anchor-unsupported', 'INVALID_INPUT');
+        const target = settleNow(() => ChatCitationTargetSchema.parse(JSON.parse(citation.link.id)));
+        if (!target.ok || JSON.stringify(target.value) !== citation.link.id)
+            throw refuse('chat-citation-target-invalid', 'INVALID_INPUT');
+        return { citation, target: target.value };
+    }
+    async function read(input) {
+        const { citation, target: [roomId, messageId] } = selected(input);
+        const observed = await (await reader()).readAtRevision(citation.revision.value);
+        if (observed.status === 'not-found')
+            return null;
+        if (observed.status === 'changed' || observed.revision !== citation.revision.value)
+            throw changed();
+        const room = ChatRoomsStateSchema.parse(observed.value).rooms[roomId];
+        if (room && room.id !== roomId)
+            throw refuse('chat-citation-room-invalid', 'INVALID_INPUT');
+        const messages = (room?.items ?? []).flatMap(item => item.type === 'message' ? [item.data] : []);
+        const ids = new Set();
+        for (const message of messages) {
+            if (ids.has(message.id))
+                throw refuse('chat-citation-message-ambiguous', 'INVALID_INPUT');
+            if (message.roomId !== roomId)
+                throw refuse('chat-citation-message-room-mismatch', 'INVALID_INPUT');
+            ids.add(message.id);
+        }
+        let text = '';
+        const segments = [];
+        for (const message of messages) {
+            if (messageId !== null && message.id !== messageId)
+                continue;
+            if (messageId === null)
+                text += `\nMessage ${JSON.stringify({ id: message.id, role: message.role, senderType: message.senderType })}\n`;
+            const start = text.length;
+            text += message.content;
+            segments.push({ id: message.id, start, end: text.length });
+        }
+        return { citation, roomId, messageId, text, segments };
+    }
+    const owner = {
+        async locate(kind, rawQuery, context) {
+            if (kind !== 'chat')
+                throw refuse('chat-citation-kind-invalid', 'INVALID_INPUT');
+            const query = ChatCitationQuerySchema.safeParse(rawQuery);
+            if (!query.success)
+                throw refuse('chat-citation-explicit-selection-required', 'INVALID_INPUT');
+            const binding = CitationLocateContextSchema.parse(context);
+            const currentScope = scope(binding.workspaceId);
+            const metadata = await (await reader()).metadata();
+            if (!metadata)
+                return { status: 'complete', places: [] };
+            const targets = query.data.messageIds
+                ? [...new Set(query.data.messageIds)].map(id => [query.data.roomId, id])
+                : [[query.data.roomId, null]];
+            return { status: 'complete', places: targets.map(target => CitationSchema.parse({
+                    link: { kind: 'chat', source: 'chat', id: JSON.stringify(target), role: 'evidence' }, scope: currentScope,
+                    revision: { scheme: 'chat-local-document-v1', value: metadata.revision }
+                })) };
+        },
+        async metadata(input) {
+            const { citation } = selected(input);
+            const metadata = await (await reader()).metadata();
+            return metadata ? { status: 'current', citation: { ...citation, revision: { ...citation.revision, value: metadata.revision } } } : { status: 'gone' };
+        },
+        async resolve(input) {
+            const current = await read(input);
+            if (!current)
+                return { status: 'gone' };
+            const anchor = current.citation.anchor;
+            if (anchor?.kind === 'region' && anchor.end > current.text.length)
+                throw refuse('chat-citation-anchor-invalid', 'INVALID_INPUT');
+            return { status: 'resolved', text: anchor?.kind === 'region' ? current.text.slice(anchor.start, anchor.end) : current.text, revision: current.citation.revision };
+        },
+        async find(input, text, at) {
+            const { citation } = selected(input);
+            const needle = z.string().min(1).parse(text);
+            const occurrence = z.object({ start: z.number().int().nonnegative() }).optional().parse(at);
+            const current = await owner.resolve(citation);
+            if (current.status !== 'resolved')
+                throw refuse('chat-citation-body-unavailable', 'UNAVAILABLE');
+            const base = citation.anchor?.kind === 'region' ? citation.anchor.start : 0;
+            const anchors = [];
+            if (occurrence) {
+                if (current.text.slice(occurrence.start, occurrence.start + needle.length) === needle)
+                    anchors.push({ kind: 'region', start: base + occurrence.start, end: base + occurrence.start + needle.length });
+                return anchors;
+            }
+            let start = current.text.indexOf(needle);
+            while (start !== -1) {
+                anchors.push({ kind: 'region', start: base + start, end: base + start + needle.length });
+                start = current.text.indexOf(needle, start + 1);
+            }
+            return anchors;
+        },
+        async rootOf(input) {
+            const current = await read(input);
+            if (!current)
+                throw refuse('chat-citation-body-unavailable', 'UNAVAILABLE');
+            const { citation, text, segments } = current;
+            const anchor = citation.anchor;
+            const start = anchor?.kind === 'region' ? anchor.start : 0;
+            const end = anchor?.kind === 'region' ? anchor.end : text.length;
+            const segment = segments.find(part => start >= part.start && end <= part.end);
+            const quote = QuoteSchema.safeParse(input);
+            if (!segment || (quote.success && text.slice(start, end) !== quote.data.text))
+                throw refuse('chat-citation-root-span-invalid', 'INVALID_INPUT');
+            return { ...citation, link: { ...citation.link, id: JSON.stringify([current.roomId, segment.id]) },
+                anchor: { kind: 'region', start: start - segment.start, end: end - segment.start } };
+        }
+    };
+    return owner;
+}
+function changed() { return refuse('citation-revision-changed', 'CONFLICT'); }
+function refuse(reason, code) {
+    return new CapabilityError('The selected Chat citation cannot be read under its owner contract.', code, { reason, retryable: code === 'UNAVAILABLE' || code === 'CONFLICT' });
+}
+//# sourceMappingURL=citations.js.map

package/dist/client/citations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"citations.js","sourceRoot":"","sources":["../../src/client/citations.ts"],"names":[],"mappings":"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"}

package/dist/client/client.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Local Chat Client — in-process `chat/client` implementation.
+ *
+ * Backs the `chat/client` runtime kind's local variant. Resolves chat
+ * storage through runtime manifests (so CLI/TUI/desktop use local SQLite
+ * via `storage` without HTTP). Consumers never construct this
+ * directly — the canonical `RuntimeChatClient` resolves this variant when
+ * the caller's runtime scope matches (cli/tui/bridge).
+ *
+ * The `runtime` and AI handles are held privately: they back the local
+ * execution path but are not part of the public `ChatClient` contract.
+ */
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { ChatClient, ChatConversationStartInput, ChatConversationStartResult, ChatComposerOptions, ChatComposerOptionsRequest, ChatFolderListResult, ChatFolder, ChatFolderCreateInput, ChatFolderBatchMoveInput, ChatFolderUpdateInput, ChatFolderMoveInput, ChatFoldersCollection, ChatRoomsCollection, ChatSearchCollection } from './contracts.ts';
+import type { LocalChatConfiguration } from './schemas/runtime.ts';
+import type { ChatStorage } from './schemas/storage.ts';
+import { type ChatRoomHandleFactory } from './rooms.ts';
+import { ChatSessionsClient } from './sessions.ts';
+import type { CitationOwner } from '@vibesdotdev/shared/citations';
+export declare class LocalChatClient implements ChatClient {
+    private readonly localOptions;
+    readonly citations: CitationOwner;
+    loading: boolean;
+    ready: boolean;
+    error: Error | null;
+    rooms: ChatRoomsCollection;
+    readonly sessions: ChatSessionsClient;
+    folders: ChatFoldersCollection;
+    search: ChatSearchCollection;
+    config: LocalChatConfiguration;
+    private readonly runtime;
+    private storage?;
+    constructor(runtime: VibesRuntime, localOptions?: {
+        storage?: ChatStorage;
+        createHandle?: ChatRoomHandleFactory;
+    });
+    load(): Promise<void>;
+    getComposerOptions(_options?: ChatComposerOptionsRequest): Promise<ChatComposerOptions>;
+    startConversation(input: ChatConversationStartInput): Promise<ChatConversationStartResult>;
+    dispose(): void;
+}
+export declare class LocalChatFoldersCollection implements ChatFoldersCollection {
+    private readonly storage;
+    constructor(storage: ChatStorage);
+    moveRooms(input: ChatFolderBatchMoveInput): Promise<void>;
+    list(): Promise<ChatFolderListResult>;
+    create(input: ChatFolderCreateInput): Promise<ChatFolder>;
+    update(id: string, patch: ChatFolderUpdateInput): Promise<ChatFolder>;
+    remove(id: string): Promise<void>;
+    moveRoom(input: ChatFolderMoveInput): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAA6E,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnI,OAAO,KAAK,EACX,UAAU,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,0BAA0B,EAC1B,oBAAoB,EACpB,UAAU,EACV,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EAGrB,mBAAmB,EACnB,oBAAoB,EACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAqB,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAA2B,KAAK,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAGnE,qBAAa,eAAgB,YAAW,UAAU;IAed,OAAO,CAAC,QAAQ,CAAC,YAAY;IAdhE,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,OAAO,UAAS;IAChB,KAAK,UAAS;IACd,KAAK,EAAE,KAAK,GAAG,IAAI,CAAQ;IAE3B,KAAK,EAAE,mBAAmB,CAAiC;IAC3D,QAAQ,CAAC,QAAQ,qBAAgC;IACjD,OAAO,EAAE,qBAAqB,CAAmC;IACjE,MAAM,EAAE,oBAAoB,CAAkC;IAC9D,MAAM,EAAE,sBAAsB,CAAgB;IAE9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,OAAO,CAAC,CAAc;gBAElB,OAAO,EAAE,YAAY,EAAmB,YAAY,GAAE;QAAE,OAAO,CAAC,EAAE,WAAW,CAAC;QAAC,YAAY,CAAC,EAAE,qBAAqB,CAAA;KAAO;IAWhI,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BrB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAKvF,iBAAiB,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAYhG,OAAO,IAAI,IAAI;CAGf;AAwDD,qBAAa,0BAA2B,YAAW,qBAAqB;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,WAAW;IAC3C,SAAS,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAEzD,IAAI,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAIrC,MAAM,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC;IAOzD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC;IAKrE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CAGzD"}

package/dist/client/client.js

@@ -0,0 +1,232 @@
+/**
+ * Local Chat Client — in-process `chat/client` implementation.
+ *
+ * Backs the `chat/client` runtime kind's local variant. Resolves chat
+ * storage through runtime manifests (so CLI/TUI/desktop use local SQLite
+ * via `storage` without HTTP). Consumers never construct this
+ * directly — the canonical `RuntimeChatClient` resolves this variant when
+ * the caller's runtime scope matches (cli/tui/bridge).
+ *
+ * The `runtime` and AI handles are held privately: they back the local
+ * execution path but are not part of the public `ChatClient` contract.
+ */
+import { ConfigManifest } from '@vibesdotdev/config/manifest/config-manifest';
+import { CapabilityError, CaughtFailureSchema, isCapabilityError, valueFreeFailure } from '@vibesdotdev/kernel';
+import { resolveChatStorage } from "./_internal/storage.js";
+import { ChatRoomsCollectionImpl } from "./rooms.js";
+import { loadRuntimeChatComposerOptions } from "./composer-options.js";
+import { titleFromFirstMessage } from "./room-helpers.js";
+import { ChatSessionsClient } from "./sessions.js";
+import { CHAT_UI_CONFIG_MANIFEST_ID } from "../config/chat-ui.config.descriptor.js";
+import { createLocalChatCitations } from "./citations.js";
+export class LocalChatClient {
+    localOptions;
+    citations;
+    loading = false;
+    ready = false;
+    error = null;
+    rooms = new UnloadedRoomsCollection();
+    sessions = new ChatSessionsClient(this);
+    folders = new UnloadedFoldersCollection();
+    search = new UnloadedSearchCollection();
+    config = { ui: null };
+    runtime;
+    storage;
+    constructor(runtime, localOptions = {}) {
+        this.localOptions = localOptions;
+        this.runtime = runtime;
+        this.citations = createLocalChatCitations(runtime, async () => {
+            if (!this.ready)
+                await this.load();
+            if (!this.storage?.documentRevisions)
+                throw new CapabilityError('The selected Chat storage exposes no authoritative document revisions.', 'UNAVAILABLE', {
+                    reason: 'chat-citation-revision-unavailable'
+                });
+            return this.storage.documentRevisions();
+        });
+    }
+    async load() {
+        this.loading = true;
+        this.error = null;
+        try {
+            const storage = this.localOptions.storage ?? await resolveChatStorage(this.runtime);
+            this.storage = storage;
+            this.rooms = new ChatRoomsCollectionImpl(storage, this.runtime, this.localOptions.createHandle);
+            this.folders = new LocalChatFoldersCollection(storage);
+            this.search = new LocalChatSearchCollection(storage);
+            // Only an unregistered manifest means configuration is absent.
+            // A registered owner's refusal must not become default settings.
+            this.config.ui =
+                this.runtime.hasKind('config/manifest') && ConfigManifest.isRegistered(this.runtime, CHAT_UI_CONFIG_MANIFEST_ID)
+                    ? ConfigManifest.forRuntime(this.runtime, CHAT_UI_CONFIG_MANIFEST_ID)
+                    : null;
+            this.ready = true;
+        }
+        catch (error) {
+            const failure = CaughtFailureSchema.parse(error);
+            this.error = isCapabilityError(failure) ? failure : new CapabilityError('Local Chat client could not load', 'UNAVAILABLE', { reason: 'chat-client-load-failed', details: valueFreeFailure(failure) });
+            this.ready = false;
+            throw this.error;
+        }
+        finally {
+            this.loading = false;
+        }
+    }
+    async getComposerOptions(_options) {
+        if (!this.ready)
+            await this.load();
+        return loadRuntimeChatComposerOptions(this.runtime, this.folders.list());
+    }
+    async startConversation(input) {
+        if (!this.ready)
+            await this.load();
+        const room = await this.rooms.create({
+            ...input.room,
+            title: !input.room?.title || input.room.title === 'New Conversation'
+                ? titleFromFirstMessage(input.message.content)
+                : input.room.title
+        });
+        return { room, completion: room.send(input.message) };
+    }
+    dispose() {
+        this.ready = false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Sentinel collection (throws on use before load)
+class UnloadedRoomsCollection {
+    error() {
+        throw new Error('Chat client is not loaded. Call load() first.');
+    }
+    list() {
+        return this.error();
+    }
+    get(_id) {
+        return this.error();
+    }
+    create() {
+        return this.error();
+    }
+    createOrGet() {
+        return this.error();
+    }
+    remove(_id) {
+        return this.error();
+    }
+    fork(_sourceRoomId, _upToMessageId) {
+        return this.error();
+    }
+    getActiveId() {
+        return this.error();
+    }
+    setActiveId(_id) {
+        return this.error();
+    }
+    subscribe(_cb) {
+        return this.error();
+    }
+}
+class UnloadedFoldersCollection {
+    moveRooms(_input) { return this.error(); }
+    create(_input) { return this.error(); }
+    update(_id, _input) { return this.error(); }
+    remove(_id) { return this.error(); }
+    error() {
+        throw new Error('Chat client is not loaded. Call load() first.');
+    }
+    list() {
+        return this.error();
+    }
+    moveRoom(_input) {
+        return this.error();
+    }
+}
+export class LocalChatFoldersCollection {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    async moveRooms(input) { await this.storage.mutateFolders({ type: 'moveMany', input }); }
+    async list() {
+        return this.storage.listFolders();
+    }
+    async create(input) {
+        const now = new Date().toISOString();
+        const folder = { ...input, id: crypto.randomUUID(), createdAt: now, updatedAt: now };
+        await this.storage.mutateFolders({ type: 'create', folder });
+        return (await this.list()).folders.find((item) => item.id === folder.id);
+    }
+    async update(id, patch) {
+        await this.storage.mutateFolders({ type: 'update', id, patch });
+        return (await this.list()).folders.find((item) => item.id === id);
+    }
+    async remove(id) {
+        await this.storage.mutateFolders({ type: 'remove', id });
+    }
+    async moveRoom(input) {
+        await this.storage.mutateFolders({ type: 'move', input });
+    }
+}
+class UnloadedSearchCollection {
+    error() {
+        throw new Error('Chat client is not loaded. Call load() first.');
+    }
+    messages(_input) {
+        return this.error();
+    }
+}
+class LocalChatSearchCollection {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    async messages(input) {
+        const query = input.query.trim().toLowerCase();
+        if (!query)
+            return [];
+        const rooms = Object.values(await this.storage.getRooms())
+            .filter((room) => !input.chatRoomId || room.id === input.chatRoomId)
+            .sort((left, right) => String(right.updatedAt ?? '').localeCompare(String(left.updatedAt ?? '')));
+        const limit = input.limit ?? 10;
+        const offset = input.offset ?? 0;
+        const results = [];
+        let skipped = 0;
+        let matched = 0;
+        for (const room of rooms) {
+            const matchingMessages = [];
+            for (const item of room.items ?? []) {
+                if (item.type !== 'message')
+                    continue;
+                const message = item.data;
+                const content = message.content;
+                if (!content.toLowerCase().includes(query))
+                    continue;
+                if (skipped < offset) {
+                    skipped += 1;
+                    continue;
+                }
+                matchingMessages.push({
+                    id: message.id,
+                    content: message.content,
+                    senderType: message.senderType,
+                    createdAt: message.createdAt
+                });
+                matched += 1;
+                if (matched >= limit)
+                    break;
+            }
+            if (matchingMessages.length > 0) {
+                results.push({
+                    id: room.id,
+                    title: room.title,
+                    updatedAt: room.updatedAt,
+                    matchingMessages
+                });
+            }
+            if (matched >= limit)
+                break;
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,gBAAgB,EAAqB,MAAM,qBAAqB,CAAC;AAsBnI,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAA8B,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AACpF,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAI1D,MAAM,OAAO,eAAe;IAeyB;IAd3C,SAAS,CAAgB;IAClC,OAAO,GAAG,KAAK,CAAC;IAChB,KAAK,GAAG,KAAK,CAAC;IACd,KAAK,GAAiB,IAAI,CAAC;IAE3B,KAAK,GAAwB,IAAI,uBAAuB,EAAE,CAAC;IAClD,QAAQ,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACjD,OAAO,GAA0B,IAAI,yBAAyB,EAAE,CAAC;IACjE,MAAM,GAAyB,IAAI,wBAAwB,EAAE,CAAC;IAC9D,MAAM,GAA2B,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IAE7B,OAAO,CAAe;IAC/B,OAAO,CAAe;IAE9B,YAAY,OAAqB,EAAmB,eAAgF,EAAE;QAAlF,iBAAY,GAAZ,YAAY,CAAsE;QACrI,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,wBAAwB,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;YAC7D,IAAI,CAAC,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,iBAAiB;gBAAE,MAAM,IAAI,eAAe,CAAC,wEAAwE,EAAE,aAAa,EAAE;oBACxJ,MAAM,EAAE,oCAAoC;iBAC5C,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;QACzC,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI;QACT,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC;YACJ,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,IAAI,MAAM,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YACvB,IAAI,CAAC,KAAK,GAAG,IAAI,uBAAuB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;YAChG,IAAI,CAAC,OAAO,GAAG,IAAI,0BAA0B,CAAC,OAAO,CAAC,CAAC;YACvD,IAAI,CAAC,MAAM,GAAG,IAAI,yBAAyB,CAAC,OAAO,CAAC,CAAC;YACrD,+DAA+D;YAC/D,iEAAiE;YACjE,IAAI,CAAC,MAAM,CAAC,EAAE;gBACb,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,cAAc,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,0BAA0B,CAAC;oBAC/G,CAAC,CAAC,cAAc,CAAC,UAAU,CAAoB,IAAI,CAAC,OAAO,EAAE,0BAA0B,CAAC;oBACxF,CAAC,CAAC,IAAI,CAAC;YACT,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACjD,IAAI,CAAC,KAAK,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,eAAe,CACtE,kCAAkC,EAAE,aAAa,EACjD,EAAE,MAAM,EAAE,yBAAyB,EAAE,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAAE,CACzE,CAAC;YACF,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;YACnB,MAAM,IAAI,CAAC,KAAK,CAAC;QAClB,CAAC;gBAAS,CAAC;YACV,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACtB,CAAC;IACF,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,QAAqC;QAC7D,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACnC,OAAO,8BAA8B,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,KAAiC;QACxD,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;YACpC,GAAG,KAAK,CAAC,IAAI;YACb,KAAK,EACJ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,kBAAkB;gBAC5D,CAAC,CAAC,qBAAqB,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;gBAC9C,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK;SACpB,CAAC,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;IACvD,CAAC;IAED,OAAO;QACN,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACpB,CAAC;CACD;AAED,8EAA8E;AAC9E,kDAAkD;AAElD,MAAM,uBAAuB;IACpB,KAAK;QACZ,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAClE,CAAC;IACD,IAAI;QACH,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IACD,GAAG,CAAC,GAAW;QACd,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IACD,MAAM;QACL,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IACD,WAAW;QACV,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IACD,MAAM,CAAC,GAAW;QACjB,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IACD,IAAI,CAAC,aAAqB,EAAE,cAAuB;QAClD,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IACD,WAAW;QACV,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IACD,WAAW,CAAC,GAAkB;QAC7B,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IACD,SAAS,CACR,GAAgG;QAEhG,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACD;AAED,MAAM,yBAAyB;IAC9B,SAAS,CAAC,MAAgC,IAAmB,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACnF,MAAM,CAAC,MAA6B,IAAyB,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACnF,MAAM,CAAC,GAAW,EAAE,MAA6B,IAAyB,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAChG,MAAM,CAAC,GAAW,IAAmB,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACnD,KAAK;QACZ,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAClE,CAAC;IACD,IAAI;QACH,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IACD,QAAQ,CAAC,MAA2B;QACnC,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACD;AAED,MAAM,OAAO,0BAA0B;IACT;IAA7B,YAA6B,OAAoB;QAApB,YAAO,GAAP,OAAO,CAAa;IAAG,CAAC;IACrD,KAAK,CAAC,SAAS,CAAC,KAA+B,IAAmB,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAElI,KAAK,CAAC,IAAI;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAA4B;QACxC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;QACrF,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7D,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAE,CAAC;IAC3E,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,KAA4B;QACpD,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAChE,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAE,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACtB,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAA0B;QACxC,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,CAAC;CACD;AAED,MAAM,wBAAwB;IACrB,KAAK;QACZ,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAClE,CAAC;IACD,QAAQ,CAAC,MAA8B;QACtC,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACD;AAED,MAAM,yBAAyB;IACD;IAA7B,YAA6B,OAAoB;QAApB,YAAO,GAAP,OAAO,CAAa;IAAG,CAAC;IAErD,KAAK,CAAC,QAAQ,CAAC,KAA6B;QAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC/C,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAC;QAEtB,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;aACxD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,UAAU,CAAC;aACnE,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACrB,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CACzE,CAAC;QACH,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;QACjC,MAAM,OAAO,GAAkC,EAAE,CAAC;QAClD,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAC1B,MAAM,gBAAgB,GAAG,EAAE,CAAC;YAC5B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;gBACrC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;oBAAE,SAAS;gBACtC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC;gBAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;gBAChC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;oBAAE,SAAS;gBACrD,IAAI,OAAO,GAAG,MAAM,EAAE,CAAC;oBACtB,OAAO,IAAI,CAAC,CAAC;oBACb,SAAS;gBACV,CAAC;gBACD,gBAAgB,CAAC,IAAI,CAAC;oBACrB,EAAE,EAAE,OAAO,CAAC,EAAE;oBACd,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;iBAC5B,CAAC,CAAC;gBACH,OAAO,IAAI,CAAC,CAAC;gBACb,IAAI,OAAO,IAAI,KAAK;oBAAE,MAAM;YAC7B,CAAC;YACD,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjC,OAAO,CAAC,IAAI,CAAC;oBACZ,EAAE,EAAE,IAAI,CAAC,EAAE;oBACX,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,gBAAgB;iBAChB,CAAC,CAAC;YACJ,CAAC;YACD,IAAI,OAAO,IAAI,KAAK;gBAAE,MAAM;QAC7B,CAAC;QAED,OAAO,OAAO,CAAC;IAChB,CAAC;CACD"}

package/dist/client/composer-options.d.ts

@@ -0,0 +1,64 @@
+import { type RuntimeRef, type VibesRuntime } from '@vibesdotdev/kernel';
+import type { ChatComposerOptions, ChatFolderListResult } from './schemas/contracts.ts';
+/**
+ * Compose the chat launch catalog from its runtime owners.
+ *
+ * AI owns models, Tools owns agent descriptors, and Chat owns folders. The
+ * aggregate stays resilient per source while naming every degraded dependency
+ * so UI surfaces never disguise an outage as an intentionally empty picker.
+ */
+export declare function loadRuntimeChatComposerOptions(runtime: VibesRuntime, folders: ChatFolderListResult | Promise<ChatFolderListResult>): Promise<ChatComposerOptions>;
+/**
+ * Resilient, transport-neutral composition for chat launch catalogs.
+ *
+ * The owning surface supplies request-scoped API clients when identity is
+ * involved; consumer/local runtimes supply descriptor-backed promises. Chat
+ * owns only the aggregate contract and degraded-source semantics.
+ */
+export declare function composeChatComposerOptions(input: {
+    /** The runtime each unavailable source is reported on; the `degraded` list names them either way. */
+    runtime?: RuntimeRef;
+    models: ChatComposerOptions['models'] | Promise<ChatComposerOptions['models']>;
+    agents: ChatComposerOptions['agents'] | Promise<ChatComposerOptions['agents']>;
+    folders: ChatFolderListResult | Promise<ChatFolderListResult>;
+}): Promise<ChatComposerOptions>;
+/**
+ * Merge a catalog that is partitioned by access-controlled sources.
+ *
+ * A user may be allowed to read their own and public records while a system
+ * source is forbidden. One rejected partition must not erase the records the
+ * runtime successfully returned. When every source fails we reject so the
+ * composer can still report the owning catalog as degraded.
+ */
+export declare function mergeAvailableChatCatalogSources<T>(sources: readonly (readonly T[] | PromiseLike<readonly T[]>)[], options?: {
+    runtime?: RuntimeRef;
+}): Promise<T[]>;
+/**
+ * Chat offers a model only on positive evidence that it converses: a chat
+ * model type, or a chat/text-generation capability when the type is unset.
+ * An unclassified model is not evidence (rerankers and embedders arrive that way).
+ */
+export declare function isChatComposerModel(model: {
+    modelType?: string | null;
+    capabilities?: readonly string[];
+}): boolean;
+/**
+ * Chat models come from the provider-connections owner, the same per-connection
+ * catalog execution plans against: each configured connection's models appear
+ * once under that connection, carrying its name and the provider's wire id.
+ * A runtime without that owner answers from its AI client's model collection.
+ */
+export declare function listRuntimeChatModels(runtime: VibesRuntime): Promise<ChatComposerOptions['models']>;
+export declare function listRuntimeChatAgents(runtime: VibesRuntime, query?: string): Promise<ChatComposerOptions['agents']>;
+/**
+ * List public descriptor-owned Chat agents without requiring a persisted agent
+ * row. Cloud surfaces merge these with their request-scoped remote catalogs so
+ * system agents remain discoverable from the runtime source of truth.
+ */
+export declare function listPublicRuntimeChatAgents(runtime: VibesRuntime): Promise<ChatComposerOptions['agents']>;
+/**
+ * Public marketplace teammates. Discovery is additive: a missing marketplace
+ * client or empty catalog is not a degraded agents source.
+ */
+export declare function listCommunityChatAgents(runtime: RuntimeRef, query?: string): Promise<ChatComposerOptions['agents']>;
+//# sourceMappingURL=composer-options.d.ts.map

package/dist/client/composer-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer-options.d.ts","sourceRoot":"","sources":["../../src/client/composer-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmD,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAW1H,OAAO,KAAK,EACX,mBAAmB,EAEnB,oBAAoB,EACpB,MAAM,wBAAwB,CAAC;AAuBhC;;;;;;GAMG;AACH,wBAAsB,8BAA8B,CACnD,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,GAC3D,OAAO,CAAC,mBAAmB,CAAC,CA4B9B;AAED;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAAC,KAAK,EAAE;IACvD,qGAAqG;IACrG,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/E,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/E,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC9D,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA8B/B;AAED;;;;;;;GAOG;AACH,wBAAsB,gCAAgC,CAAC,CAAC,EACvD,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,EAAE,GAAG,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,EAC9D,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,UAAU,CAAA;CAAO,GACpC,OAAO,CAAC,CAAC,EAAE,CAAC,CAiBd;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IAC1C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC,GAAG,OAAO,CAIV;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAC1C,OAAO,EAAE,YAAY,GACnB,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAuBxC;AA6BD,wBAAsB,qBAAqB,CAC1C,OAAO,EAAE,YAAY,EACrB,KAAK,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CA0CxC;AA+BD;;;;GAIG;AACH,wBAAsB,2BAA2B,CAChD,OAAO,EAAE,YAAY,GACnB,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAkBxC;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC5C,OAAO,EAAE,UAAU,EACnB,KAAK,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAsCxC"}