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

package/dist/chat-modes/helpers.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Chat Mode Runtime Helpers
+ *
+ * Moved from `config/src/ai/chat-modes.ts` per the chat SPEC's
+ * migration debt. These helpers read `chat/mode` runtime descriptors and
+ * normalize/merge/resolve them into the shape consumers expect.
+ *
+ * Import from `@vibesdotdev/chat/chat-modes/helpers`.
+ */
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { ChatModeDescriptor, NormalizedChatMode, ConfiguredChatMode } from '../schemas/chat-mode.ts';
+export type { NormalizedChatMode, ConfiguredChatMode } from '../schemas/chat-mode.ts';
+/**
+ * Read registered modes synchronously through the runtime's typed query.
+ * Only confirmed absence of the kind produces an empty collection.
+ */
+export declare function getRuntimeChatModeDescriptors(runtime: RuntimeRef): ChatModeDescriptor[];
+/** Render mode instructions on the caller's runtime; explicit text keeps precedence. */
+export declare function resolveChatModeSystemPrompt(runtime: RuntimeRef, mode: ChatModeDescriptor | null | undefined): Promise<string | undefined>;
+/**
+ * Normalize runtime descriptors into a flat record keyed by mode id.
+ * Filters out disabled descriptors.
+ */
+export declare function normalizeRuntimeChatModes(descriptors: ChatModeDescriptor[]): Record<string, NormalizedChatMode>;
+/**
+ * Merge runtime-discovered modes with config-manifest modes.
+ * Config modes override runtime modes; disabled config modes remove runtime modes.
+ */
+export declare function mergeChatModes(runtimeModes: Record<string, NormalizedChatMode>, configuredModes: Record<string, ConfiguredChatMode>): Record<string, NormalizedChatMode>;
+/**
+ * Resolve the default chat mode id from a preferred id and the full mode set.
+ * Falls back to the lowest-order enabled mode, then to the preferred id.
+ */
+export declare function resolveDefaultChatModeId(preferredId: string | null, chatModes: Record<string, Pick<ConfiguredChatMode, 'id' | 'enabled' | 'order'>>): string | null;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/chat-modes/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/chat-modes/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAA2C,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE/F,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE1G,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEtF;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,UAAU,GAAG,kBAAkB,EAAE,CAGvF;AAED,wFAAwF;AACxF,wBAAsB,2BAA2B,CAChD,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,GACzC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAY7B;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAyB/G;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC7B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAChD,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GACjD,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAmBpC;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACvC,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC,GAC7E,MAAM,GAAG,IAAI,CAOf"}

package/dist/chat-modes/helpers.js

@@ -0,0 +1,102 @@
+/**
+ * Chat Mode Runtime Helpers
+ *
+ * Moved from `config/src/ai/chat-modes.ts` per the chat SPEC's
+ * migration debt. These helpers read `chat/mode` runtime descriptors and
+ * normalize/merge/resolve them into the shape consumers expect.
+ *
+ * Import from `@vibesdotdev/chat/chat-modes/helpers`.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+/**
+ * Read registered modes synchronously through the runtime's typed query.
+ * Only confirmed absence of the kind produces an empty collection.
+ */
+export function getRuntimeChatModeDescriptors(runtime) {
+    if (!runtime.hasKind('chat/mode'))
+        return [];
+    return runtime.query('chat/mode').descriptors();
+}
+/** Render mode instructions on the caller's runtime; explicit text keeps precedence. */
+export async function resolveChatModeSystemPrompt(runtime, mode) {
+    if (!mode || mode.enabled === false)
+        return undefined;
+    if (mode.systemPrompt)
+        return mode.systemPrompt;
+    if (!mode.systemPromptManifestId)
+        return undefined;
+    if (!runtime.hasKind('prompts/manifest')) {
+        throw new CapabilityError('Chat mode prompt capability is unavailable.', 'UNAVAILABLE', {
+            reason: 'chat-mode-prompt-unavailable'
+        });
+    }
+    const prompt = await runtime.query('prompts/manifest')
+        .withId(mode.systemPromptManifestId).resolve();
+    return prompt.render();
+}
+/**
+ * Normalize runtime descriptors into a flat record keyed by mode id.
+ * Filters out disabled descriptors.
+ */
+export function normalizeRuntimeChatModes(descriptors) {
+    const entries = [];
+    for (const descriptor of descriptors) {
+        if (!descriptor?.id || descriptor.enabled === false)
+            continue;
+        entries.push([descriptor.id, {
+                id: descriptor.id,
+                name: descriptor.name ?? descriptor.id,
+                description: descriptor.description,
+                icon: descriptor.icon,
+                sourceType: 'local',
+                enabled: true,
+                hidden: descriptor.hidden === true,
+                order: descriptor.order,
+                agentId: descriptor.agentId,
+                providerId: descriptor.providerId,
+                modelId: descriptor.modelId,
+                agents: descriptor.agents,
+                orchestration: descriptor.orchestration,
+                agentResponseModes: descriptor.agentResponseModes,
+                toolApprovalMode: descriptor.toolApprovalMode,
+                tools: descriptor.tools
+            }]);
+    }
+    // fromEntries defines each id as an own key, so an id named `__proto__` stays a key.
+    return Object.fromEntries(entries);
+}
+/**
+ * Merge runtime-discovered modes with config-manifest modes.
+ * Config modes override runtime modes; disabled config modes remove runtime modes.
+ */
+export function mergeChatModes(runtimeModes, configuredModes) {
+    // A Map keeps a mode id named `__proto__` an ordinary key.
+    const merged = new Map(Object.entries(runtimeModes));
+    for (const [modeId, configured] of Object.entries(configuredModes)) {
+        if (configured.enabled === false) {
+            merged.delete(modeId);
+            continue;
+        }
+        const base = merged.get(modeId);
+        const configuredWithoutUndefined = Object.fromEntries(Object.entries(configured).filter(([, value]) => value !== undefined));
+        merged.set(modeId, base
+            ? { ...base, ...configuredWithoutUndefined, id: modeId, sourceType: base.sourceType ?? configured.sourceType ?? 'local', enabled: true }
+            : { ...configuredWithoutUndefined, id: modeId, sourceType: configured.sourceType ?? 'local', enabled: true });
+    }
+    return Object.fromEntries([...merged].filter(([, mode]) => mode.enabled !== false));
+}
+/**
+ * Resolve the default chat mode id from a preferred id and the full mode set.
+ * Falls back to the lowest-order enabled mode, then to the preferred id.
+ */
+export function resolveDefaultChatModeId(preferredId, chatModes) {
+    const modes = Object.values(chatModes).filter((mode) => mode.enabled !== false);
+    if (modes.length === 0)
+        return preferredId;
+    // Own keys only: an id such as `constructor` or `__proto__` is never a mode of the object's prototype.
+    if (preferredId && Object.hasOwn(chatModes, preferredId))
+        return preferredId;
+    const ordered = [...modes].sort((a, b) => (a.order ?? 999) - (b.order ?? 999));
+    return ordered[0]?.id ?? preferredId;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/chat-modes/helpers.js.map

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

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

@@ -0,0 +1,87 @@
+/**
+ * Built-in "Image" chat mode.
+ *
+ * A first-class, persistent chat mode (NOT a prompt-injecting dialog) that
+ * scopes the conversation to image generation. Registered against the
+ * `chat/mode` runtime kind so it is discoverable by the chat mode selector
+ * (`runtime.assets('chat/mode').descriptors()`) alongside other optional modes.
+ *
+ * When active:
+ *  - `tools.allowList: ['generate-image']` restricts the agent to the
+ *    dedicated image tool (not the multipurpose `ai-generate` surface).
+ *    Cloud composition (apps/{ai,chat}-web/vibes.config.ts + ai-tools plugin)
+ *    makes `generate-image` resolvable in cloud scope.
+ *  - The system prompt instructs the agent to (a) treat the active mode as
+ *    "refine the current image", (b) re-issue `generate-image` with an updated
+ *    prompt merging accumulated constraints across turns, and (c) restate the
+ *    full scene each call. The 50-message history window in run-chat-generation
+ *    already feeds prior prompts/results back as context.
+ */
+declare const descriptor: {
+    id: string;
+    kind: "chat/mode";
+    name: string;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    hardware?: string[] | undefined;
+    enabled?: boolean | undefined;
+    priority?: number | undefined;
+    capabilityId?: string | undefined;
+    requiredContext?: string[] | undefined;
+    optionalContext?: string[] | undefined;
+    config?: unknown;
+    retention?: string | {
+        reason: string;
+        maxAgeDays?: number | undefined;
+        maxEntries?: number | undefined;
+        maxBytes?: number | undefined;
+        cascadeFrom?: string | undefined;
+        ageField?: string | undefined;
+        enforcedBy?: string | undefined;
+    } | undefined;
+    icon?: string | undefined;
+    order?: number | undefined;
+    agentId?: string | undefined;
+    providerId?: string | undefined;
+    modelId?: string | undefined;
+    agents?: {
+        agentId: string;
+        responseMode: "always" | "conditional" | "mentioned";
+        order: number;
+        executionConfig: {
+            generationType: "agent" | "text" | "structured";
+            toolsEnabled: boolean;
+            internalLoop: boolean;
+            maxIterations: number;
+            continueEnabled: boolean;
+            orchestratorEnabled: boolean;
+            toolOverrides?: Record<string, {
+                enabled: boolean;
+            }> | undefined;
+        };
+        alias?: string | undefined;
+        responseCondition?: {
+            triggeredBy: "user" | "orchestrator" | "any-agent" | "specific-agent";
+            triggerAgentIds?: string[] | undefined;
+        } | undefined;
+    }[] | undefined;
+    orchestration?: {
+        turnMode: "sequential" | "parallel" | "orchestrated";
+        showIntermediateOutputs: boolean;
+        contextSharing: "none" | "full" | "summary";
+        maxTotalIterations: number;
+    } | undefined;
+    agentResponseModes?: Record<string, "always" | "tagged" | "auto"> | undefined;
+    toolApprovalMode?: "always-approve" | "auto-approve-safe" | "always-ask" | "batch-approve" | "ask-when-declared" | "ask-on-request" | undefined;
+    tools?: {
+        inheritAgentTools?: boolean | undefined;
+        allowList?: string[] | undefined;
+        enabled?: boolean | undefined;
+    } | undefined;
+    systemPrompt?: string | undefined;
+    systemPromptManifestId?: string | undefined;
+    default?: boolean | undefined;
+    hidden?: boolean | undefined;
+};
+export default descriptor;
+//# sourceMappingURL=image.chat-mode.descriptor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"image.chat-mode.descriptor.d.ts","sourceRoot":"","sources":["../../src/chat-modes/image.chat-mode.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAcd,CAAC;AAEH,eAAe,UAAU,CAAC"}

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

@@ -0,0 +1,37 @@
+/**
+ * Built-in "Image" chat mode.
+ *
+ * A first-class, persistent chat mode (NOT a prompt-injecting dialog) that
+ * scopes the conversation to image generation. Registered against the
+ * `chat/mode` runtime kind so it is discoverable by the chat mode selector
+ * (`runtime.assets('chat/mode').descriptors()`) alongside other optional modes.
+ *
+ * When active:
+ *  - `tools.allowList: ['generate-image']` restricts the agent to the
+ *    dedicated image tool (not the multipurpose `ai-generate` surface).
+ *    Cloud composition (apps/{ai,chat}-web/vibes.config.ts + ai-tools plugin)
+ *    makes `generate-image` resolvable in cloud scope.
+ *  - The system prompt instructs the agent to (a) treat the active mode as
+ *    "refine the current image", (b) re-issue `generate-image` with an updated
+ *    prompt merging accumulated constraints across turns, and (c) restate the
+ *    full scene each call. The 50-message history window in run-chat-generation
+ *    already feeds prior prompts/results back as context.
+ */
+import { createChatModeDescriptor } from "../schemas/chat-mode.js";
+const descriptor = createChatModeDescriptor({
+    id: 'image',
+    name: 'Image',
+    description: 'Generate and iteratively refine images with the AI image tool',
+    icon: 'lucide:image',
+    order: 30,
+    toolApprovalMode: 'auto-approve-safe',
+    tools: {
+        enabled: true,
+        inheritAgentTools: false,
+        allowList: ['generate-image']
+    },
+    enabled: true,
+    systemPromptManifestId: 'prompts.manifest.chat.image-mode'
+});
+export default descriptor;
+//# sourceMappingURL=image.chat-mode.descriptor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"image.chat-mode.descriptor.js","sourceRoot":"","sources":["../../src/chat-modes/image.chat-mode.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,MAAM,UAAU,GAAG,wBAAwB,CAAC;IAC3C,EAAE,EAAE,OAAO;IACX,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,+DAA+D;IAC5E,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,EAAE;IACT,gBAAgB,EAAE,mBAAmB;IACrC,KAAK,EAAE;QACN,OAAO,EAAE,IAAI;QACb,iBAAiB,EAAE,KAAK;QACxB,SAAS,EAAE,CAAC,gBAAgB,CAAC;KAC7B;IACD,OAAO,EAAE,IAAI;IACb,sBAAsB,EAAE,kCAAkC;CAC1D,CAAC,CAAC;AAEH,eAAe,UAAU,CAAC"}

package/dist/chat-modes/report.chat-mode.descriptor.d.ts

@@ -0,0 +1,69 @@
+/** Reporting is a preset on an ordinary Chat, not another execution lifecycle. */
+declare const _default: {
+    id: string;
+    kind: "chat/mode";
+    name: string;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    hardware?: string[] | undefined;
+    enabled?: boolean | undefined;
+    priority?: number | undefined;
+    capabilityId?: string | undefined;
+    requiredContext?: string[] | undefined;
+    optionalContext?: string[] | undefined;
+    config?: unknown;
+    retention?: string | {
+        reason: string;
+        maxAgeDays?: number | undefined;
+        maxEntries?: number | undefined;
+        maxBytes?: number | undefined;
+        cascadeFrom?: string | undefined;
+        ageField?: string | undefined;
+        enforcedBy?: string | undefined;
+    } | undefined;
+    icon?: string | undefined;
+    order?: number | undefined;
+    agentId?: string | undefined;
+    providerId?: string | undefined;
+    modelId?: string | undefined;
+    agents?: {
+        agentId: string;
+        responseMode: "always" | "conditional" | "mentioned";
+        order: number;
+        executionConfig: {
+            generationType: "agent" | "text" | "structured";
+            toolsEnabled: boolean;
+            internalLoop: boolean;
+            maxIterations: number;
+            continueEnabled: boolean;
+            orchestratorEnabled: boolean;
+            toolOverrides?: Record<string, {
+                enabled: boolean;
+            }> | undefined;
+        };
+        alias?: string | undefined;
+        responseCondition?: {
+            triggeredBy: "user" | "orchestrator" | "any-agent" | "specific-agent";
+            triggerAgentIds?: string[] | undefined;
+        } | undefined;
+    }[] | undefined;
+    orchestration?: {
+        turnMode: "sequential" | "parallel" | "orchestrated";
+        showIntermediateOutputs: boolean;
+        contextSharing: "none" | "full" | "summary";
+        maxTotalIterations: number;
+    } | undefined;
+    agentResponseModes?: Record<string, "always" | "tagged" | "auto"> | undefined;
+    toolApprovalMode?: "always-approve" | "auto-approve-safe" | "always-ask" | "batch-approve" | "ask-when-declared" | "ask-on-request" | undefined;
+    tools?: {
+        inheritAgentTools?: boolean | undefined;
+        allowList?: string[] | undefined;
+        enabled?: boolean | undefined;
+    } | undefined;
+    systemPrompt?: string | undefined;
+    systemPromptManifestId?: string | undefined;
+    default?: boolean | undefined;
+    hidden?: boolean | undefined;
+};
+export default _default;
+//# sourceMappingURL=report.chat-mode.descriptor.d.ts.map

package/dist/chat-modes/report.chat-mode.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.chat-mode.descriptor.d.ts","sourceRoot":"","sources":["../../src/chat-modes/report.chat-mode.descriptor.ts"],"names":[],"mappings":"AAEA,kFAAkF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAClF,wBASG"}

package/dist/chat-modes/report.chat-mode.descriptor.js

@@ -0,0 +1,13 @@
+import { createChatModeDescriptor } from "../schemas/chat-mode.js";
+/** Reporting is a preset on an ordinary Chat, not another execution lifecycle. */
+export default createChatModeDescriptor({
+    id: 'report',
+    name: 'Report',
+    description: 'Complete a configured verification or curation task and record its evidence',
+    hidden: true,
+    enabled: true,
+    // Preserve the chosen agent's prompt as well as its tools. Delivery guidance
+    // belongs to the configured goal, not a replacement agent persona.
+    tools: { enabled: true, inheritAgentTools: true, allowList: ['chat-session-report'] }
+});
+//# sourceMappingURL=report.chat-mode.descriptor.js.map

package/dist/chat-modes/report.chat-mode.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.chat-mode.descriptor.js","sourceRoot":"","sources":["../../src/chat-modes/report.chat-mode.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,kFAAkF;AAClF,eAAe,wBAAwB,CAAC;IACvC,EAAE,EAAE,QAAQ;IACZ,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,6EAA6E;IAC1F,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE,IAAI;IACb,6EAA6E;IAC7E,mEAAmE;IACnE,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,qBAAqB,CAAC,EAAE;CACrF,CAAC,CAAC"}

package/dist/chat-modes/schemas/config.d.ts

@@ -0,0 +1,233 @@
+import * as z from 'zod/v4';
+/**
+ * Where a Build room's bound code-session executes (WS6). Mirrors
+ * `SessionHostTarget` from `@vibesdotdev/agent-execution/code-session/host-target`
+ * structurally — declared inline so the chat schema does not depend on the
+ * code-session package (RESOLVE, DON'T IMPORT: the runtime resolves the
+ * impl; this is only the persisted binding shape).
+ */
+declare const ChatModeHostTargetSchema: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"cloud">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"host">;
+    hostId: z.ZodString;
+}, z.core.$strip>], "kind">>;
+/**
+ * Per-room/per-mode session overrides (WS6 customization). All optional and
+ * non-breaking: when absent, `run-chat-generation` leaves the mode's own
+ * agent/prompt/tool policy unchanged. When present, they layer ON TOP of the
+ * resolved mode before the loop runs:
+ *   - `agentId` / `promptId` / `loopId` override the resolved agent's
+ *     descriptor selection for the run.
+ *   - `additionalInstructions` APPENDS to the mode's `systemPrompt`.
+ *   - `tools.allowList` REPLACES the mode allow-list threaded into
+ *     `options.toolIds`; `tools.customToolIds` are appended (custom/private
+ *     tools the user bound to the room).
+ *   - `approvalMode` overrides the mode's tool-approval policy for the run.
+ */
+declare const ChatModeSessionOverridesSchema: z.ZodOptional<z.ZodObject<{
+    agentId: z.ZodOptional<z.ZodString>;
+    promptId: z.ZodOptional<z.ZodString>;
+    additionalInstructions: z.ZodOptional<z.ZodString>;
+    tools: z.ZodOptional<z.ZodObject<{
+        allowList: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        customToolIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    approvalMode: z.ZodOptional<z.ZodEnum<{
+        "always-approve": "always-approve";
+        "auto-approve-safe": "auto-approve-safe";
+        "always-ask": "always-ask";
+        "batch-approve": "batch-approve";
+        "ask-when-declared": "ask-when-declared";
+        "ask-on-request": "ask-on-request";
+    }>>;
+    loopId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export declare const ChatModeRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    description: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    sourceType: z.ZodDefault<z.ZodEnum<{
+        local: "local";
+        database: "database";
+    }>>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    order: z.ZodOptional<z.ZodNumber>;
+    agentId: z.ZodOptional<z.ZodString>;
+    providerId: z.ZodOptional<z.ZodString>;
+    modelId: z.ZodOptional<z.ZodString>;
+    agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        agentId: z.ZodString;
+        role: z.ZodOptional<z.ZodString>;
+        order: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    orchestration: z.ZodOptional<z.ZodObject<{
+        strategy: z.ZodDefault<z.ZodEnum<{
+            sequential: "sequential";
+            parallel: "parallel";
+            adaptive: "adaptive";
+        }>>;
+        maxRounds: z.ZodOptional<z.ZodNumber>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    toolApprovalMode: z.ZodDefault<z.ZodEnum<{
+        "always-approve": "always-approve";
+        "auto-approve-safe": "auto-approve-safe";
+        "always-ask": "always-ask";
+        "batch-approve": "batch-approve";
+        "ask-when-declared": "ask-when-declared";
+        "ask-on-request": "ask-on-request";
+    }>>;
+    tools: z.ZodOptional<z.ZodObject<{
+        inheritAgentTools: z.ZodOptional<z.ZodBoolean>;
+        allowList: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    systemPrompt: z.ZodOptional<z.ZodString>;
+    contextSettings: z.ZodOptional<z.ZodObject<{
+        maxMessages: z.ZodDefault<z.ZodNumber>;
+        includeSystemPrompt: z.ZodDefault<z.ZodBoolean>;
+        includeFiles: z.ZodDefault<z.ZodBoolean>;
+        maxContextTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    profileSettings: z.ZodOptional<z.ZodObject<{
+        defaultProfile: z.ZodOptional<z.ZodString>;
+        autoDetectProfile: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    generationConfigId: z.ZodOptional<z.ZodString>;
+    repositoryId: z.ZodOptional<z.ZodString>;
+    hostTarget: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"cloud">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"host">;
+        hostId: z.ZodString;
+    }, z.core.$strip>], "kind">>;
+    sessionOverrides: z.ZodOptional<z.ZodObject<{
+        agentId: z.ZodOptional<z.ZodString>;
+        promptId: z.ZodOptional<z.ZodString>;
+        additionalInstructions: z.ZodOptional<z.ZodString>;
+        tools: z.ZodOptional<z.ZodObject<{
+            allowList: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            customToolIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        approvalMode: z.ZodOptional<z.ZodEnum<{
+            "always-approve": "always-approve";
+            "auto-approve-safe": "auto-approve-safe";
+            "always-ask": "always-ask";
+            "batch-approve": "batch-approve";
+            "ask-when-declared": "ask-when-declared";
+            "ask-on-request": "ask-on-request";
+        }>>;
+        loopId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+    cachedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type ChatModeRecord = z.infer<typeof ChatModeRecordSchema>;
+/** WS6: per-room session overrides layered on top of the resolved mode. */
+export type ChatModeSessionOverrides = z.infer<typeof ChatModeSessionOverridesSchema>;
+/** WS6: persisted execution target for a Build room's code-session. */
+export type ChatModeHostTarget = z.infer<typeof ChatModeHostTargetSchema>;
+export declare const ChatModesConfigSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    description: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    sourceType: z.ZodDefault<z.ZodEnum<{
+        local: "local";
+        database: "database";
+    }>>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    order: z.ZodOptional<z.ZodNumber>;
+    agentId: z.ZodOptional<z.ZodString>;
+    providerId: z.ZodOptional<z.ZodString>;
+    modelId: z.ZodOptional<z.ZodString>;
+    agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        agentId: z.ZodString;
+        role: z.ZodOptional<z.ZodString>;
+        order: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    orchestration: z.ZodOptional<z.ZodObject<{
+        strategy: z.ZodDefault<z.ZodEnum<{
+            sequential: "sequential";
+            parallel: "parallel";
+            adaptive: "adaptive";
+        }>>;
+        maxRounds: z.ZodOptional<z.ZodNumber>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    toolApprovalMode: z.ZodDefault<z.ZodEnum<{
+        "always-approve": "always-approve";
+        "auto-approve-safe": "auto-approve-safe";
+        "always-ask": "always-ask";
+        "batch-approve": "batch-approve";
+        "ask-when-declared": "ask-when-declared";
+        "ask-on-request": "ask-on-request";
+    }>>;
+    tools: z.ZodOptional<z.ZodObject<{
+        inheritAgentTools: z.ZodOptional<z.ZodBoolean>;
+        allowList: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    systemPrompt: z.ZodOptional<z.ZodString>;
+    contextSettings: z.ZodOptional<z.ZodObject<{
+        maxMessages: z.ZodDefault<z.ZodNumber>;
+        includeSystemPrompt: z.ZodDefault<z.ZodBoolean>;
+        includeFiles: z.ZodDefault<z.ZodBoolean>;
+        maxContextTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    profileSettings: z.ZodOptional<z.ZodObject<{
+        defaultProfile: z.ZodOptional<z.ZodString>;
+        autoDetectProfile: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    generationConfigId: z.ZodOptional<z.ZodString>;
+    repositoryId: z.ZodOptional<z.ZodString>;
+    hostTarget: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"cloud">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"host">;
+        hostId: z.ZodString;
+    }, z.core.$strip>], "kind">>;
+    sessionOverrides: z.ZodOptional<z.ZodObject<{
+        agentId: z.ZodOptional<z.ZodString>;
+        promptId: z.ZodOptional<z.ZodString>;
+        additionalInstructions: z.ZodOptional<z.ZodString>;
+        tools: z.ZodOptional<z.ZodObject<{
+            allowList: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            customToolIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        approvalMode: z.ZodOptional<z.ZodEnum<{
+            "always-approve": "always-approve";
+            "auto-approve-safe": "auto-approve-safe";
+            "always-ask": "always-ask";
+            "batch-approve": "batch-approve";
+            "ask-when-declared": "ask-when-declared";
+            "ask-on-request": "ask-on-request";
+        }>>;
+        loopId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+    cachedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>>;
+export type ChatModesConfig = z.infer<typeof ChatModesConfigSchema>;
+export interface RecordManifest<T> {
+    id: string;
+    name: string;
+    description: string;
+    icon: string;
+    version: number;
+    tier: string;
+    category: string;
+    schema: z.ZodType<Record<string, T>>;
+    recordSchema: z.ZodType<T>;
+    storage?: {
+        adapter: string;
+        scope: string;
+        namespace: string;
+    };
+}
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/chat-modes/schemas/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/chat-modes/schemas/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAyC5B;;;;;;GAMG;AACH,QAAA,MAAM,wBAAwB;;;;;4BAKlB,CAAC;AAEb;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,8BAA8B;;;;;;;;;;;;;;;;;kBAcxB,CAAC;AAEb,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8BlB,CAAC;AAEhB,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,2EAA2E;AAC3E,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AACtF,uEAAuE;AACvE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA6C,CAAC;AAChF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,MAAM,WAAW,cAAc,CAAC,CAAC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IACrC,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3B,OAAO,CAAC,EAAE;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;KAClB,CAAC;CACF"}