@elizaos/shared 2.0.0-beta.1 → 2.0.3-beta.3

package/contracts/connector-routes.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Zod schemas for connector + provider-switch HTTP routes.
+ *
+ * connector-account-routes.ts already validates body inputs through
+ * its own (file-local) zod schemas; those stay in place and aren't
+ * re-exported here.
+ *
+ * Routes covered:
+ *   POST /api/connectors           { name: string, config: object }
+ *   POST /api/provider/switch
+ *     { provider: string, apiKey?, primaryModel? }
+ */
+import z from "zod";
+export declare const PostConnectorRequestSchema: z.ZodPipe<z.ZodObject<{
+    name: z.ZodString;
+    config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>, z.ZodTransform<{
+    name: string;
+    config: Record<string, unknown>;
+}, {
+    name: string;
+    config: Record<string, unknown>;
+}>>;
+export declare const PostProviderSwitchRequestSchema: z.ZodPipe<z.ZodObject<{
+    provider: z.ZodString;
+    apiKey: z.ZodOptional<z.ZodString>;
+    primaryModel: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodTransform<{
+    primaryModel?: string | undefined;
+    apiKey?: string | undefined;
+    provider: string;
+}, {
+    provider: string;
+    apiKey?: string | undefined;
+    primaryModel?: string | undefined;
+}>>;
+export type PostConnectorRequest = z.infer<typeof PostConnectorRequestSchema>;
+export type PostProviderSwitchRequest = z.infer<typeof PostProviderSwitchRequestSchema>;
+//# sourceMappingURL=connector-routes.d.ts.map

package/contracts/connector-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-routes.d.ts","sourceRoot":"","sources":["../../src/contracts/connector-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,CAAC,MAAM,KAAK,CAAC;AAUpB,eAAO,MAAM,0BAA0B;;;;;;;;;GAanC,CAAC;AAEL,eAAO,MAAM,+BAA+B;;;;;;;;;;;;GAexC,CAAC;AAEL,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,+BAA+B,CACvC,CAAC"}

package/contracts/connector-routes.js

@@ -0,0 +1,50 @@
+/**
+ * Zod schemas for connector + provider-switch HTTP routes.
+ *
+ * connector-account-routes.ts already validates body inputs through
+ * its own (file-local) zod schemas; those stay in place and aren't
+ * re-exported here.
+ *
+ * Routes covered:
+ *   POST /api/connectors           { name: string, config: object }
+ *   POST /api/provider/switch
+ *     { provider: string, apiKey?, primaryModel? }
+ */
+import z from "zod";
+/**
+ * Reserved object keys we never want to allow as connector names —
+ * the server clones config objects defensively, so a `__proto__`
+ * connector name would be ignored or pollute the object's
+ * prototype chain. The wire-level schema rejects upfront.
+ */
+const RESERVED_OBJECT_KEYS = new Set(["__proto__", "constructor", "prototype"]);
+export const PostConnectorRequestSchema = z
+    .object({
+    name: z.string().regex(/\S/, "Missing connector name"),
+    config: z.record(z.string(), z.unknown()),
+})
+    .strict()
+    .transform((value) => ({
+    name: value.name.trim(),
+    config: value.config,
+}))
+    .refine((value) => !RESERVED_OBJECT_KEYS.has(value.name), {
+    message: 'Invalid connector name: "__proto__", "constructor", and "prototype" are reserved',
+});
+export const PostProviderSwitchRequestSchema = z
+    .object({
+    provider: z.string().regex(/\S/, "Missing provider"),
+    apiKey: z.string().max(512, "API key is too long").optional(),
+    primaryModel: z.string().optional(),
+})
+    .strict()
+    .transform((value) => {
+    const apiKey = value.apiKey?.trim();
+    const primaryModel = value.primaryModel?.trim();
+    return {
+        provider: value.provider.trim(),
+        ...(apiKey ? { apiKey } : {}),
+        ...(primaryModel ? { primaryModel } : {}),
+    };
+});
+//# sourceMappingURL=connector-routes.js.map

package/contracts/connector-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-routes.js","sourceRoot":"","sources":["../../src/contracts/connector-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC;AAEhF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC;KACxC,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACtD,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;CAC1C,CAAC;KACD,MAAM,EAAE;KACR,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACrB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;IACvB,MAAM,EAAE,KAAK,CAAC,MAAM;CACrB,CAAC,CAAC;KACF,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;IACxD,OAAO,EACL,kFAAkF;CACrF,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC;KAC7C,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,kBAAkB,CAAC;IACpD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC,QAAQ,EAAE;IAC7D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC;KACD,MAAM,EAAE;KACR,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;IACnB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IACpC,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC;IAChD,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE;QAC/B,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1C,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/contracts/content-pack.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Content Pack manifest and types.
+ *
+ * A content pack bundles visual assets (VRM, background, color scheme),
+ * personality data, and optional stream overlay into a single installable unit.
+ * Packs are loaded from the splash page before first-run setup begins.
+ */
+import type { ThemeDefinition } from "./theme.js";
+export interface ContentPackManifest {
+    /** Unique pack identifier (kebab-case, e.g. "cyberpunk-neon") */
+    id: string;
+    /** Human-readable display name */
+    name: string;
+    /** Semantic version */
+    version: string;
+    /** Optional author or creator name */
+    author?: string;
+    /** Short description shown in the pack browser */
+    description?: string;
+    /** Preview image filename (relative to pack root) */
+    preview?: string;
+    /** Asset declarations — all fields are optional */
+    assets: ContentPackAssets;
+}
+export interface ContentPackAssets {
+    /** VRM avatar model */
+    vrm?: ContentPackVrmAsset;
+    /** Background image filename (relative to pack root) */
+    background?: string;
+    /** Gaussian splat companion world scene filename */
+    world?: string;
+    /** Color scheme overrides (narrow — 6 color fields) */
+    colorScheme?: ContentPackColorScheme;
+    /**
+     * Full theme definition (light + dark palettes, fonts, radii, etc.).
+     * Takes precedence over colorScheme when present.
+     */
+    theme?: ThemeDefinition;
+    /** Stream overlay directory (relative to pack root) */
+    streamOverlay?: string;
+    /** Personality definition (subset of StylePreset) */
+    personality?: ContentPackPersonality;
+}
+export interface ContentPackVrmAsset {
+    /** VRM file path (relative to pack root, typically .vrm or .vrm.gz) */
+    file: string;
+    /** Preview thumbnail path (relative to pack root) */
+    preview?: string;
+    /** Slug used for URL resolution */
+    slug: string;
+}
+export interface ContentPackColorScheme {
+    /** Primary accent color (hex) */
+    accent?: string;
+    /** Background color (hex) */
+    bg?: string;
+    /** Card/surface color (hex) */
+    card?: string;
+    /** Border color (hex) */
+    border?: string;
+    /** Text color (hex) */
+    text?: string;
+    /** Muted text color (hex) */
+    textMuted?: string;
+    /** Additional CSS custom properties (key without --prefix, value) */
+    customProperties?: Record<string, string>;
+}
+export interface ContentPackPersonality {
+    /** Character display name */
+    name?: string;
+    /** Bio lines */
+    bio?: string[];
+    /**
+     * System prompt override.
+     *
+     * SECURITY: intentionally deferred — not wired in applyContentPack().
+     * A remote pack controlling the agent's system prompt is significant
+     * attack surface. Wiring this requires the same trust/review enforcement
+     * as other prompt sources (character editor, config file).
+     */
+    system?: string;
+    /** Catchphrase shown during first-run setup */
+    catchphrase?: string;
+    /** Adjectives describing the character */
+    adjectives?: string[];
+    /** Voice preset ID (e.g. "alice", "brian") */
+    voicePresetId?: string;
+    /** Greeting animation filename */
+    greetingAnimation?: string;
+}
+export interface ResolvedContentPack {
+    manifest: ContentPackManifest;
+    /** Absolute URL or data URL for the VRM model (custom packs) */
+    vrmUrl?: string;
+    /** Bundled avatar index (1-8) — used instead of vrmUrl for built-in characters */
+    avatarIndex?: number;
+    /** Absolute URL for the VRM preview thumbnail */
+    vrmPreviewUrl?: string;
+    /** Absolute URL for the background image */
+    backgroundUrl?: string;
+    /** Absolute URL for the companion world scene */
+    worldUrl?: string;
+    /** Resolved color scheme (same shape, just validated) */
+    colorScheme?: ContentPackColorScheme;
+    /** Absolute path to stream overlay directory */
+    streamOverlayPath?: string;
+    /** Validated personality data */
+    personality?: ContentPackPersonality;
+    /** Where the pack was loaded from */
+    source: ContentPackSource;
+}
+export type ContentPackSource = {
+    kind: "bundled";
+    id: string;
+} | {
+    kind: "file";
+    path: string;
+} | {
+    kind: "url";
+    url: string;
+};
+export interface ContentPackValidationError {
+    field: string;
+    message: string;
+}
+export declare function validateContentPackManifest(data: unknown): ContentPackValidationError[];
+/** Manifest filename expected at the root of a content pack */
+export declare const CONTENT_PACK_MANIFEST_FILENAME = "pack.json";
+/** Maximum pack file size (100 MB) */
+export declare const CONTENT_PACK_MAX_SIZE_BYTES: number;
+//# sourceMappingURL=content-pack.d.ts.map

package/contracts/content-pack.d.ts.map

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

package/contracts/content-pack.js

@@ -0,0 +1,103 @@
+/**
+ * Content Pack manifest and types.
+ *
+ * A content pack bundles visual assets (VRM, background, color scheme),
+ * personality data, and optional stream overlay into a single installable unit.
+ * Packs are loaded from the splash page before first-run setup begins.
+ */
+// ── Validation ──────────────────────────────────────────────────────
+const PACK_ID_PATTERN = /^[a-z0-9][a-z0-9-]*[a-z0-9]$/;
+const HEX_COLOR_PATTERN = /^#[0-9a-fA-F]{3,8}$/;
+export function validateContentPackManifest(data) {
+    const errors = [];
+    if (!data || typeof data !== "object" || Array.isArray(data)) {
+        errors.push({ field: "root", message: "Manifest must be a JSON object" });
+        return errors;
+    }
+    const manifest = data;
+    // Required fields
+    if (typeof manifest.id !== "string" || !manifest.id.trim()) {
+        errors.push({ field: "id", message: "Pack id is required" });
+    }
+    else if (!PACK_ID_PATTERN.test(manifest.id)) {
+        errors.push({
+            field: "id",
+            message: "Pack id must be kebab-case (lowercase letters, numbers, hyphens)",
+        });
+    }
+    if (typeof manifest.name !== "string" || !manifest.name.trim()) {
+        errors.push({ field: "name", message: "Pack name is required" });
+    }
+    if (typeof manifest.version !== "string" || !manifest.version.trim()) {
+        errors.push({ field: "version", message: "Pack version is required" });
+    }
+    // Assets validation
+    const assets = manifest.assets && typeof manifest.assets === "object"
+        ? manifest.assets
+        : null;
+    if (!assets) {
+        errors.push({ field: "assets", message: "Assets object is required" });
+        return errors;
+    }
+    // VRM validation
+    if (assets.vrm != null) {
+        const vrm = typeof assets.vrm === "object" && !Array.isArray(assets.vrm)
+            ? assets.vrm
+            : null;
+        if (!vrm) {
+            errors.push({ field: "assets.vrm", message: "VRM must be an object" });
+        }
+        else {
+            if (typeof vrm.file !== "string" || !vrm.file.trim()) {
+                errors.push({
+                    field: "assets.vrm.file",
+                    message: "VRM file path is required",
+                });
+            }
+            if (typeof vrm.slug !== "string" || !vrm.slug.trim()) {
+                errors.push({
+                    field: "assets.vrm.slug",
+                    message: "VRM slug is required",
+                });
+            }
+        }
+    }
+    // Color scheme validation
+    if (assets.colorScheme != null) {
+        const cs = typeof assets.colorScheme === "object" &&
+            !Array.isArray(assets.colorScheme)
+            ? assets.colorScheme
+            : null;
+        if (!cs) {
+            errors.push({
+                field: "assets.colorScheme",
+                message: "Color scheme must be an object",
+            });
+        }
+        else {
+            for (const key of [
+                "accent",
+                "bg",
+                "card",
+                "border",
+                "text",
+                "textMuted",
+            ]) {
+                if (typeof cs[key] === "string" &&
+                    !HEX_COLOR_PATTERN.test(cs[key])) {
+                    errors.push({
+                        field: `assets.colorScheme.${key}`,
+                        message: `Color value must be a valid hex color (e.g. #ff00ff)`,
+                    });
+                }
+            }
+        }
+    }
+    return errors;
+}
+// ── Constants ───────────────────────────────────────────────────────
+/** Manifest filename expected at the root of a content pack */
+export const CONTENT_PACK_MANIFEST_FILENAME = "pack.json";
+/** Maximum pack file size (100 MB) */
+export const CONTENT_PACK_MAX_SIZE_BYTES = 100 * 1024 * 1024;
+//# sourceMappingURL=content-pack.js.map

package/contracts/conversation-routes.d.ts

@@ -0,0 +1,191 @@
+/**
+ * Zod schemas for the simple conversation HTTP routes.
+ *
+ * The chat-payload routes (`POST /api/conversations/:id/messages`
+ * and the `/messages/stream` SSE variant) use a dedicated
+ * `readChatRequestPayload` helper and aren't migrated here — they
+ * share parsing with other chat endpoints and that helper is the
+ * source of truth.
+ *
+ * Routes covered:
+ *   POST  /api/conversations
+ *     { title?, includeGreeting?, lang?, metadata? }
+ *   POST  /api/conversations/:id/messages/truncate
+ *     { messageId, inclusive? }
+ *   PATCH /api/conversations/:id
+ *     { title?, generate?, metadata? | null }
+ *   POST  /api/conversations/cleanup-empty
+ *     { keepId? }
+ */
+import z from "zod";
+export declare const ConversationScopeSchema: z.ZodEnum<{
+    general: "general";
+    "automation-coordinator": "automation-coordinator";
+    "automation-workflow": "automation-workflow";
+    "automation-workflow-draft": "automation-workflow-draft";
+    "automation-draft": "automation-draft";
+    "page-character": "page-character";
+    "page-apps": "page-apps";
+    "page-connectors": "page-connectors";
+    "page-phone": "page-phone";
+    "page-plugins": "page-plugins";
+    "page-settings": "page-settings";
+    "page-wallet": "page-wallet";
+    "page-browser": "page-browser";
+    "page-automations": "page-automations";
+}>;
+export declare const ConversationAutomationTypeSchema: z.ZodEnum<{
+    coordinator_text: "coordinator_text";
+    workflow: "workflow";
+}>;
+/**
+ * Mirror of `ConversationMetadata` in agent/src/api/server-types.ts.
+ * The server passes through `sanitizeConversationMetadata` which
+ * strips empty / non-string fields, so the schema is permissive on
+ * presence and strict on type.
+ */
+export declare const ConversationMetadataSchema: z.ZodObject<{
+    scope: z.ZodOptional<z.ZodEnum<{
+        general: "general";
+        "automation-coordinator": "automation-coordinator";
+        "automation-workflow": "automation-workflow";
+        "automation-workflow-draft": "automation-workflow-draft";
+        "automation-draft": "automation-draft";
+        "page-character": "page-character";
+        "page-apps": "page-apps";
+        "page-connectors": "page-connectors";
+        "page-phone": "page-phone";
+        "page-plugins": "page-plugins";
+        "page-settings": "page-settings";
+        "page-wallet": "page-wallet";
+        "page-browser": "page-browser";
+        "page-automations": "page-automations";
+    }>>;
+    automationType: z.ZodOptional<z.ZodEnum<{
+        coordinator_text: "coordinator_text";
+        workflow: "workflow";
+    }>>;
+    taskId: z.ZodOptional<z.ZodString>;
+    triggerId: z.ZodOptional<z.ZodString>;
+    workflowId: z.ZodOptional<z.ZodString>;
+    workflowName: z.ZodOptional<z.ZodString>;
+    draftId: z.ZodOptional<z.ZodString>;
+    pageId: z.ZodOptional<z.ZodString>;
+    sourceConversationId: z.ZodOptional<z.ZodString>;
+    terminalBridgeConversationId: z.ZodOptional<z.ZodString>;
+    waifuChatOwnerWallet: z.ZodOptional<z.ZodString>;
+    waifuChatRole: z.ZodOptional<z.ZodEnum<{
+        user: "user";
+        admin: "admin";
+        guest: "guest";
+    }>>;
+}, z.core.$strict>;
+export declare const PostConversationRequestSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    includeGreeting: z.ZodOptional<z.ZodBoolean>;
+    lang: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        scope: z.ZodOptional<z.ZodEnum<{
+            general: "general";
+            "automation-coordinator": "automation-coordinator";
+            "automation-workflow": "automation-workflow";
+            "automation-workflow-draft": "automation-workflow-draft";
+            "automation-draft": "automation-draft";
+            "page-character": "page-character";
+            "page-apps": "page-apps";
+            "page-connectors": "page-connectors";
+            "page-phone": "page-phone";
+            "page-plugins": "page-plugins";
+            "page-settings": "page-settings";
+            "page-wallet": "page-wallet";
+            "page-browser": "page-browser";
+            "page-automations": "page-automations";
+        }>>;
+        automationType: z.ZodOptional<z.ZodEnum<{
+            coordinator_text: "coordinator_text";
+            workflow: "workflow";
+        }>>;
+        taskId: z.ZodOptional<z.ZodString>;
+        triggerId: z.ZodOptional<z.ZodString>;
+        workflowId: z.ZodOptional<z.ZodString>;
+        workflowName: z.ZodOptional<z.ZodString>;
+        draftId: z.ZodOptional<z.ZodString>;
+        pageId: z.ZodOptional<z.ZodString>;
+        sourceConversationId: z.ZodOptional<z.ZodString>;
+        terminalBridgeConversationId: z.ZodOptional<z.ZodString>;
+        waifuChatOwnerWallet: z.ZodOptional<z.ZodString>;
+        waifuChatRole: z.ZodOptional<z.ZodEnum<{
+            user: "user";
+            admin: "admin";
+            guest: "guest";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const PostConversationTruncateRequestSchema: z.ZodPipe<z.ZodObject<{
+    messageId: z.ZodString;
+    inclusive: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>, z.ZodTransform<{
+    inclusive?: boolean | undefined;
+    messageId: string;
+}, {
+    messageId: string;
+    inclusive?: boolean | undefined;
+}>>;
+export declare const PatchConversationRequestSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    generate: z.ZodOptional<z.ZodBoolean>;
+    metadata: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        scope: z.ZodOptional<z.ZodEnum<{
+            general: "general";
+            "automation-coordinator": "automation-coordinator";
+            "automation-workflow": "automation-workflow";
+            "automation-workflow-draft": "automation-workflow-draft";
+            "automation-draft": "automation-draft";
+            "page-character": "page-character";
+            "page-apps": "page-apps";
+            "page-connectors": "page-connectors";
+            "page-phone": "page-phone";
+            "page-plugins": "page-plugins";
+            "page-settings": "page-settings";
+            "page-wallet": "page-wallet";
+            "page-browser": "page-browser";
+            "page-automations": "page-automations";
+        }>>;
+        automationType: z.ZodOptional<z.ZodEnum<{
+            coordinator_text: "coordinator_text";
+            workflow: "workflow";
+        }>>;
+        taskId: z.ZodOptional<z.ZodString>;
+        triggerId: z.ZodOptional<z.ZodString>;
+        workflowId: z.ZodOptional<z.ZodString>;
+        workflowName: z.ZodOptional<z.ZodString>;
+        draftId: z.ZodOptional<z.ZodString>;
+        pageId: z.ZodOptional<z.ZodString>;
+        sourceConversationId: z.ZodOptional<z.ZodString>;
+        terminalBridgeConversationId: z.ZodOptional<z.ZodString>;
+        waifuChatOwnerWallet: z.ZodOptional<z.ZodString>;
+        waifuChatRole: z.ZodOptional<z.ZodEnum<{
+            user: "user";
+            admin: "admin";
+            guest: "guest";
+        }>>;
+    }, z.core.$strict>, z.ZodNull]>>;
+}, z.core.$strict>;
+export declare const PostConversationCleanupEmptyRequestSchema: z.ZodPipe<z.ZodObject<{
+    keepId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodTransform<{
+    keepId: string;
+} | {
+    keepId?: undefined;
+}, {
+    keepId?: string | undefined;
+}>>;
+export type ConversationMetadataInput = z.infer<typeof ConversationMetadataSchema>;
+export type ConversationScope = z.infer<typeof ConversationScopeSchema>;
+export type ConversationAutomationType = z.infer<typeof ConversationAutomationTypeSchema>;
+export type ConversationMetadata = z.infer<typeof ConversationMetadataSchema>;
+export type PostConversationRequest = z.infer<typeof PostConversationRequestSchema>;
+export type PostConversationTruncateRequest = z.infer<typeof PostConversationTruncateRequestSchema>;
+export type PatchConversationRequest = z.infer<typeof PatchConversationRequestSchema>;
+export type PostConversationCleanupEmptyRequest = z.infer<typeof PostConversationCleanupEmptyRequestSchema>;
+//# sourceMappingURL=conversation-routes.d.ts.map

package/contracts/conversation-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-routes.d.ts","sourceRoot":"","sources":["../../src/contracts/conversation-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,CAAC,MAAM,KAAK,CAAC;AAWpB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAelC,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;EAG3C,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAe5B,CAAC;AAEZ,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAO/B,CAAC;AAEZ,eAAO,MAAM,qCAAqC;;;;;;;;;GAS7C,CAAC;AAEN,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAMhC,CAAC;AAEZ,eAAO,MAAM,yCAAyC;;;;;;;;GAQlD,CAAC;AAEL,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,0BAA0B,CAClC,CAAC;AAMF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,gCAAgC,CACxC,CAAC;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAC3C,OAAO,6BAA6B,CACrC,CAAC;AACF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CACnD,OAAO,qCAAqC,CAC7C,CAAC;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAC5C,OAAO,8BAA8B,CACtC,CAAC;AACF,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CACvD,OAAO,yCAAyC,CACjD,CAAC"}

package/contracts/conversation-routes.js

@@ -0,0 +1,106 @@
+/**
+ * Zod schemas for the simple conversation HTTP routes.
+ *
+ * The chat-payload routes (`POST /api/conversations/:id/messages`
+ * and the `/messages/stream` SSE variant) use a dedicated
+ * `readChatRequestPayload` helper and aren't migrated here — they
+ * share parsing with other chat endpoints and that helper is the
+ * source of truth.
+ *
+ * Routes covered:
+ *   POST  /api/conversations
+ *     { title?, includeGreeting?, lang?, metadata? }
+ *   POST  /api/conversations/:id/messages/truncate
+ *     { messageId, inclusive? }
+ *   PATCH /api/conversations/:id
+ *     { title?, generate?, metadata? | null }
+ *   POST  /api/conversations/cleanup-empty
+ *     { keepId? }
+ */
+import z from "zod";
+// Must stay in sync with the `ConversationScope` TS type in
+// `packages/agent/src/api/server-types.ts` and the runtime allowlist
+// `VALID_SCOPES` in `packages/agent/src/api/conversation-metadata.ts`.
+// Develop had a stale short enum here that rejected every `page-*` scope
+// the UI emits (BrowserWorkspaceView, CharacterHubView, etc.), surfacing
+// as "Invalid option: expected one of …" toasts.
+// Exported (alongside ConversationAutomationTypeSchema below) so the
+// schema-vs-type-drift contract test can assert membership equality
+// against the runtime VALID_SCOPES allowlist.
+export const ConversationScopeSchema = z.enum([
+    "general",
+    "automation-coordinator",
+    "automation-workflow",
+    "automation-workflow-draft",
+    "automation-draft",
+    "page-character",
+    "page-apps",
+    "page-connectors",
+    "page-phone",
+    "page-plugins",
+    "page-settings",
+    "page-wallet",
+    "page-browser",
+    "page-automations",
+]);
+export const ConversationAutomationTypeSchema = z.enum([
+    "coordinator_text",
+    "workflow",
+]);
+/**
+ * Mirror of `ConversationMetadata` in agent/src/api/server-types.ts.
+ * The server passes through `sanitizeConversationMetadata` which
+ * strips empty / non-string fields, so the schema is permissive on
+ * presence and strict on type.
+ */
+export const ConversationMetadataSchema = z
+    .object({
+    scope: ConversationScopeSchema.optional(),
+    automationType: ConversationAutomationTypeSchema.optional(),
+    taskId: z.string().optional(),
+    triggerId: z.string().optional(),
+    workflowId: z.string().optional(),
+    workflowName: z.string().optional(),
+    draftId: z.string().optional(),
+    pageId: z.string().optional(),
+    sourceConversationId: z.string().optional(),
+    terminalBridgeConversationId: z.string().optional(),
+    waifuChatOwnerWallet: z.string().optional(),
+    waifuChatRole: z.enum(["admin", "user", "guest"]).optional(),
+})
+    .strict();
+export const PostConversationRequestSchema = z
+    .object({
+    title: z.string().optional(),
+    includeGreeting: z.boolean().optional(),
+    lang: z.string().optional(),
+    metadata: ConversationMetadataSchema.optional(),
+})
+    .strict();
+export const PostConversationTruncateRequestSchema = z
+    .object({
+    messageId: z.string().regex(/\S/, "messageId is required"),
+    inclusive: z.boolean().optional(),
+})
+    .strict()
+    .transform((value) => ({
+    messageId: value.messageId.trim(),
+    ...(value.inclusive !== undefined ? { inclusive: value.inclusive } : {}),
+}));
+export const PatchConversationRequestSchema = z
+    .object({
+    title: z.string().optional(),
+    generate: z.boolean().optional(),
+    metadata: z.union([ConversationMetadataSchema, z.null()]).optional(),
+})
+    .strict();
+export const PostConversationCleanupEmptyRequestSchema = z
+    .object({
+    keepId: z.string().optional(),
+})
+    .strict()
+    .transform((value) => {
+    const trimmed = value.keepId?.trim();
+    return trimmed ? { keepId: trimmed } : {};
+});
+//# sourceMappingURL=conversation-routes.js.map

package/contracts/conversation-routes.js.map

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