@puckeditor/cloud-client 0.8.0-canary.63de6e49 → 0.8.0-canary.672c7a1c

package/dist/{chunk-XI3V7SYA.mjs → chunk-GPNAAQUM.mjs}

@@ -22183,7 +22183,8 @@ async function* iterateSSE(body) {
 
 // src/lib/cloud-api.ts
 var DEFAULT_API_VERSION = "v2";
-var cloudApi = async (path, body, options = {}, onChunk) => {
+var CLOUD_CLIENT_VERSION = true ? "0.8.0-canary.672c7a1c" : "unknown";
+var cloudApi = async (path, body, options = {}, onChunk, forwardHeaders) => {
   const {
     ai = {},
     apiKey = getApiKey(),
@@ -22195,14 +22196,22 @@ var cloudApi = async (path, body, options = {}, onChunk) => {
       "No Puck API key specified. Set the PUCK_API_KEY environment variable, or provide one to the function"
     );
   }
-  const { context, tools = {} } = ai;
+  const { context, tools = {}, designMode } = ai;
   const res = await fetch(`${host}/${path}`, {
-    headers: { "x-api-key": apiKey, "puck-api-version": apiVersion },
+    headers: {
+      "x-api-key": apiKey,
+      "puck-api-version": apiVersion,
+      "x-puck-cloud-client-version": CLOUD_CLIENT_VERSION,
+      ...forwardHeaders?.pluginAiVersion ? { "x-puck-plugin-ai-version": forwardHeaders.pluginAiVersion } : {}
+    },
     method: "post",
     body: JSON.stringify({
       ...body,
       context,
-      tools: prepareUserTools(tools)
+      tools: prepareUserTools(tools),
+      ...designMode ? {
+        designMode
+      } : {}
     })
   });
   if (!res.body) {
@@ -22224,12 +22233,13 @@ var cloudApi = async (path, body, options = {}, onChunk) => {
 };
 
 // src/api/chat.ts
-function chat({ chatId, messages, config: config2, pageData }, options = {}) {
+function chatPrivate({ chatId, messages, config: config2, pageData, mode }, options = {}, forwardHeaders) {
+  const resolvedMode = mode ?? options?.ai?.mode;
   const stream = createUIMessageStream({
     execute: async ({ writer }) => {
       await cloudApi(
         "chat",
-        { chatId, config: config2, messages, pageData },
+        { chatId, config: config2, messages, pageData, mode: resolvedMode },
         options,
         (chunk) => {
           if (chunk.type === "data-finish") {
@@ -22237,7 +22247,29 @@ function chat({ chatId, messages, config: config2, pageData }, options = {}) {
           } else {
             writer.write(chunk);
           }
-        }
+        },
+        forwardHeaders
+      );
+    }
+  });
+  return createUIMessageStreamResponse({ stream });
+}
+function chat({ chatId, messages, config: config2, pageData }, options = {}, forwardHeaders) {
+  const resolvedMode = options?.ai?.mode;
+  const stream = createUIMessageStream({
+    execute: async ({ writer }) => {
+      await cloudApi(
+        "chat",
+        { chatId, config: config2, messages, pageData, mode: resolvedMode },
+        options,
+        (chunk) => {
+          if (chunk.type === "data-finish") {
+            options.ai?.onFinish?.(chunk.data);
+          } else {
+            writer.write(chunk);
+          }
+        },
+        forwardHeaders
       );
     }
   });
@@ -22267,6 +22299,9 @@ async function generate({
       throw new Error(chunk.errorText);
     }
   });
+  if (result === null) {
+    throw new Error("Puck generate did not return any data");
+  }
   return result;
 }
 
@@ -22435,7 +22470,9 @@ var routeRegistry = [
   {
     pattern: "/api/puck/chat",
     methods: {
-      POST: ({ body }, options) => chat(body, options)
+      POST: ({ body, headers }, options) => chatPrivate(body, options, {
+        pluginAiVersion: headers.get("x-puck-plugin-ai-version")
+      })
     }
   }
 ];
@@ -22502,6 +22539,7 @@ var endpoints = ["chat"];
 
 export {
   getApiKey,
+  chatPrivate,
   chat,
   createAttachments,
   getAttachment,

package/dist/experimental.d.mts

@@ -1,5 +1,5 @@
 import { PuckCloudOptions as PuckCloudOptions$1 } from './index.mjs';
-export { ChatParams, Endpoint, GenerateParams, OnFinishCallback, OnFinishResult, UserTool, UserToolRegistry, chat, endpoints, generate, tool } from './index.mjs';
+export { ChatParams, DesignModeOptions, Endpoint, GenerateParams, OnFinishCallback, OnFinishResult, UserTool, UserToolRegistry, chat, endpoints, generate, tool } from './index.mjs';
 import { Data } from '@puckeditor/core';
 import 'zod/v4';
 import 'ai';

package/dist/experimental.d.ts

@@ -1,5 +1,5 @@
 import { PuckCloudOptions as PuckCloudOptions$1 } from './index.js';
-export { ChatParams, Endpoint, GenerateParams, OnFinishCallback, OnFinishResult, UserTool, UserToolRegistry, chat, endpoints, generate, tool } from './index.js';
+export { ChatParams, DesignModeOptions, Endpoint, GenerateParams, OnFinishCallback, OnFinishResult, UserTool, UserToolRegistry, chat, endpoints, generate, tool } from './index.js';
 import { Data } from '@puckeditor/core';
 import 'zod/v4';
 import 'ai';

package/dist/experimental.js

@@ -22226,7 +22226,8 @@ async function* iterateSSE(body) {
 
 // src/lib/cloud-api.ts
 var DEFAULT_API_VERSION = "v2";
-var cloudApi = async (path, body, options = {}, onChunk) => {
+var CLOUD_CLIENT_VERSION = true ? "0.8.0-canary.672c7a1c" : "unknown";
+var cloudApi = async (path, body, options = {}, onChunk, forwardHeaders) => {
   const {
     ai = {},
     apiKey = getApiKey(),
@@ -22238,14 +22239,22 @@ var cloudApi = async (path, body, options = {}, onChunk) => {
       "No Puck API key specified. Set the PUCK_API_KEY environment variable, or provide one to the function"
     );
   }
-  const { context, tools = {} } = ai;
+  const { context, tools = {}, designMode } = ai;
   const res = await fetch(`${host}/${path}`, {
-    headers: { "x-api-key": apiKey, "puck-api-version": apiVersion },
+    headers: {
+      "x-api-key": apiKey,
+      "puck-api-version": apiVersion,
+      "x-puck-cloud-client-version": CLOUD_CLIENT_VERSION,
+      ...forwardHeaders?.pluginAiVersion ? { "x-puck-plugin-ai-version": forwardHeaders.pluginAiVersion } : {}
+    },
     method: "post",
     body: JSON.stringify({
       ...body,
       context,
-      tools: prepareUserTools(tools)
+      tools: prepareUserTools(tools),
+      ...designMode ? {
+        designMode
+      } : {}
     })
   });
   if (!res.body) {
@@ -22267,12 +22276,13 @@ var cloudApi = async (path, body, options = {}, onChunk) => {
 };
 
 // src/api/chat.ts
-function chat({ chatId, messages, config: config2, pageData }, options = {}) {
+function chatPrivate({ chatId, messages, config: config2, pageData, mode }, options = {}, forwardHeaders) {
+  const resolvedMode = mode ?? options?.ai?.mode;
   const stream = createUIMessageStream({
     execute: async ({ writer }) => {
       await cloudApi(
         "chat",
-        { chatId, config: config2, messages, pageData },
+        { chatId, config: config2, messages, pageData, mode: resolvedMode },
         options,
         (chunk) => {
           if (chunk.type === "data-finish") {
@@ -22280,7 +22290,29 @@ function chat({ chatId, messages, config: config2, pageData }, options = {}) {
           } else {
             writer.write(chunk);
           }
-        }
+        },
+        forwardHeaders
+      );
+    }
+  });
+  return createUIMessageStreamResponse({ stream });
+}
+function chat({ chatId, messages, config: config2, pageData }, options = {}, forwardHeaders) {
+  const resolvedMode = options?.ai?.mode;
+  const stream = createUIMessageStream({
+    execute: async ({ writer }) => {
+      await cloudApi(
+        "chat",
+        { chatId, config: config2, messages, pageData, mode: resolvedMode },
+        options,
+        (chunk) => {
+          if (chunk.type === "data-finish") {
+            options.ai?.onFinish?.(chunk.data);
+          } else {
+            writer.write(chunk);
+          }
+        },
+        forwardHeaders
       );
     }
   });
@@ -22796,6 +22828,9 @@ async function generate({
       throw new Error(chunk.errorText);
     }
   });
+  if (result === null) {
+    throw new Error("Puck generate did not return any data");
+  }
   return result;
 }
 
@@ -22826,7 +22861,7 @@ var routeRegistry = [
   {
     pattern: "/api/puck/chat",
     methods: {
-      POST: ({ body }, options) => chat(body, options)
+      POST: ({ body }, options) => chatPrivate(body, options)
     }
   },
   {

package/dist/experimental.mjs

@@ -1,5 +1,6 @@
 import {
   chat,
+  chatPrivate,
   clientTool,
   createAttachments,
   deleteAttachment,
@@ -10,7 +11,7 @@ import {
   getAttachment,
   handlePuckRequest,
   tool
-} from "./chunk-XI3V7SYA.mjs";
+} from "./chunk-GPNAAQUM.mjs";
 import {
   init_react_import
 } from "./chunk-O6DC5HI2.mjs";
@@ -327,7 +328,7 @@ var routeRegistry = [
   {
     pattern: "/api/puck/chat",
     methods: {
-      POST: ({ body }, options) => chat(body, options)
+      POST: ({ body }, options) => chatPrivate(body, options)
     }
   },
   {

package/dist/index.d.mts

@@ -30,10 +30,25 @@ type DataFinish = {
 type OnFinishResult = DataFinish;
 type OnFinishCallback = (result: OnFinishResult) => void;
 type UserToolRegistry = Record<string, UserTool>;
+type DesignModeOptions = {
+    /**
+     * Set to true to allow design-mode requests. Defaults to false.
+     */
+    allowed?: boolean;
+    instructions?: string;
+    /**
+     * Set to true to allow generated components to include scripts. When
+     * disabled, the `script` field is removed from the custom component schema,
+     * so the model never generates it. Defaults to false.
+     */
+    scripts?: boolean;
+};
 type PuckAiOptions = {
     context?: string;
     tools?: UserToolRegistry;
     onFinish?: OnFinishCallback;
+    designMode?: DesignModeOptions;
+    mode?: "assembly" | "design";
 };
 type PuckCloudOptions = {
     ai?: PuckAiOptions;
@@ -49,7 +64,9 @@ type ChatParams = {
     config: Config;
     pageData: Data;
 };
-declare function chat({ chatId, messages, config, pageData }: ChatParams, options?: PuckCloudOptions | undefined): Response;
+declare function chat({ chatId, messages, config, pageData }: ChatParams, options?: PuckCloudOptions | undefined, forwardHeaders?: {
+    pluginAiVersion?: string | null;
+}): Response;
 
 type GenerateParams = {
     prompt: string;
@@ -61,11 +78,11 @@ type GenerateParams = {
     apiKey?: string;
     onFinish?: OnFinishCallback;
 };
-declare function generate({ prompt, config, pageData, context, tools, apiKey, host, onFinish, }: GenerateParams): Promise<null>;
+declare function generate({ prompt, config, pageData, context, tools, apiKey, host, onFinish, }: GenerateParams): Promise<Data>;
 
 declare function puckHandler(request: Request, options?: PuckCloudOptions): Promise<Response>;
 
 declare const endpoints: readonly ["chat"];
 type Endpoint = (typeof endpoints)[number];
 
-export { type ChatParams, type Endpoint, type GenerateParams, type OnFinishCallback, type OnFinishResult, type PuckCloudOptions, type UserTool, type UserToolRegistry, chat, endpoints, generate, puckHandler, tool };
+export { type ChatParams, type DesignModeOptions, type Endpoint, type GenerateParams, type OnFinishCallback, type OnFinishResult, type PuckCloudOptions, type UserTool, type UserToolRegistry, chat, endpoints, generate, puckHandler, tool };

package/dist/index.d.ts

@@ -30,10 +30,25 @@ type DataFinish = {
 type OnFinishResult = DataFinish;
 type OnFinishCallback = (result: OnFinishResult) => void;
 type UserToolRegistry = Record<string, UserTool>;
+type DesignModeOptions = {
+    /**
+     * Set to true to allow design-mode requests. Defaults to false.
+     */
+    allowed?: boolean;
+    instructions?: string;
+    /**
+     * Set to true to allow generated components to include scripts. When
+     * disabled, the `script` field is removed from the custom component schema,
+     * so the model never generates it. Defaults to false.
+     */
+    scripts?: boolean;
+};
 type PuckAiOptions = {
     context?: string;
     tools?: UserToolRegistry;
     onFinish?: OnFinishCallback;
+    designMode?: DesignModeOptions;
+    mode?: "assembly" | "design";
 };
 type PuckCloudOptions = {
     ai?: PuckAiOptions;
@@ -49,7 +64,9 @@ type ChatParams = {
     config: Config;
     pageData: Data;
 };
-declare function chat({ chatId, messages, config, pageData }: ChatParams, options?: PuckCloudOptions | undefined): Response;
+declare function chat({ chatId, messages, config, pageData }: ChatParams, options?: PuckCloudOptions | undefined, forwardHeaders?: {
+    pluginAiVersion?: string | null;
+}): Response;
 
 type GenerateParams = {
     prompt: string;
@@ -61,11 +78,11 @@ type GenerateParams = {
     apiKey?: string;
     onFinish?: OnFinishCallback;
 };
-declare function generate({ prompt, config, pageData, context, tools, apiKey, host, onFinish, }: GenerateParams): Promise<null>;
+declare function generate({ prompt, config, pageData, context, tools, apiKey, host, onFinish, }: GenerateParams): Promise<Data>;
 
 declare function puckHandler(request: Request, options?: PuckCloudOptions): Promise<Response>;
 
 declare const endpoints: readonly ["chat"];
 type Endpoint = (typeof endpoints)[number];
 
-export { type ChatParams, type Endpoint, type GenerateParams, type OnFinishCallback, type OnFinishResult, type PuckCloudOptions, type UserTool, type UserToolRegistry, chat, endpoints, generate, puckHandler, tool };
+export { type ChatParams, type DesignModeOptions, type Endpoint, type GenerateParams, type OnFinishCallback, type OnFinishResult, type PuckCloudOptions, type UserTool, type UserToolRegistry, chat, endpoints, generate, puckHandler, tool };

package/dist/index.js

@@ -22228,7 +22228,8 @@ async function* iterateSSE(body) {
 
 // src/lib/cloud-api.ts
 var DEFAULT_API_VERSION = "v2";
-var cloudApi = async (path, body, options = {}, onChunk) => {
+var CLOUD_CLIENT_VERSION = true ? "0.8.0-canary.672c7a1c" : "unknown";
+var cloudApi = async (path, body, options = {}, onChunk, forwardHeaders) => {
   const {
     ai = {},
     apiKey = getApiKey(),
@@ -22240,14 +22241,22 @@ var cloudApi = async (path, body, options = {}, onChunk) => {
       "No Puck API key specified. Set the PUCK_API_KEY environment variable, or provide one to the function"
     );
   }
-  const { context, tools = {} } = ai;
+  const { context, tools = {}, designMode } = ai;
   const res = await fetch(`${host}/${path}`, {
-    headers: { "x-api-key": apiKey, "puck-api-version": apiVersion },
+    headers: {
+      "x-api-key": apiKey,
+      "puck-api-version": apiVersion,
+      "x-puck-cloud-client-version": CLOUD_CLIENT_VERSION,
+      ...forwardHeaders?.pluginAiVersion ? { "x-puck-plugin-ai-version": forwardHeaders.pluginAiVersion } : {}
+    },
     method: "post",
     body: JSON.stringify({
       ...body,
       context,
-      tools: prepareUserTools(tools)
+      tools: prepareUserTools(tools),
+      ...designMode ? {
+        designMode
+      } : {}
     })
   });
   if (!res.body) {
@@ -22269,12 +22278,13 @@ var cloudApi = async (path, body, options = {}, onChunk) => {
 };
 
 // src/api/chat.ts
-function chat({ chatId, messages, config: config2, pageData }, options = {}) {
+function chatPrivate({ chatId, messages, config: config2, pageData, mode }, options = {}, forwardHeaders) {
+  const resolvedMode = mode ?? options?.ai?.mode;
   const stream = createUIMessageStream({
     execute: async ({ writer }) => {
       await cloudApi(
         "chat",
-        { chatId, config: config2, messages, pageData },
+        { chatId, config: config2, messages, pageData, mode: resolvedMode },
         options,
         (chunk) => {
           if (chunk.type === "data-finish") {
@@ -22282,7 +22292,29 @@ function chat({ chatId, messages, config: config2, pageData }, options = {}) {
           } else {
             writer.write(chunk);
           }
-        }
+        },
+        forwardHeaders
+      );
+    }
+  });
+  return createUIMessageStreamResponse({ stream });
+}
+function chat({ chatId, messages, config: config2, pageData }, options = {}, forwardHeaders) {
+  const resolvedMode = options?.ai?.mode;
+  const stream = createUIMessageStream({
+    execute: async ({ writer }) => {
+      await cloudApi(
+        "chat",
+        { chatId, config: config2, messages, pageData, mode: resolvedMode },
+        options,
+        (chunk) => {
+          if (chunk.type === "data-finish") {
+            options.ai?.onFinish?.(chunk.data);
+          } else {
+            writer.write(chunk);
+          }
+        },
+        forwardHeaders
       );
     }
   });
@@ -22312,6 +22344,9 @@ async function generate({
       throw new Error(chunk.errorText);
     }
   });
+  if (result === null) {
+    throw new Error("Puck generate did not return any data");
+  }
   return result;
 }
 
@@ -22480,7 +22515,9 @@ var routeRegistry = [
   {
     pattern: "/api/puck/chat",
     methods: {
-      POST: ({ body }, options) => chat(body, options)
+      POST: ({ body, headers }, options) => chatPrivate(body, options, {
+        pluginAiVersion: headers.get("x-puck-plugin-ai-version")
+      })
     }
   }
 ];

package/dist/index.mjs

@@ -4,7 +4,7 @@ import {
   generate,
   puckHandler,
   tool
-} from "./chunk-XI3V7SYA.mjs";
+} from "./chunk-GPNAAQUM.mjs";
 import "./chunk-O6DC5HI2.mjs";
 export {
   chat,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@puckeditor/cloud-client",
-  "version": "0.8.0-canary.63de6e49",
+  "version": "0.8.0-canary.672c7a1c",
   "author": "Chris Villa <chris@puckeditor.com>",
   "repository": "puckeditor/puck",
   "bugs": "https://github.com/puckeditor/puck/issues",
@@ -38,7 +38,7 @@
     "dist"
   ],
   "devDependencies": {
-    "@puckeditor/core": "0.22.0-canary.cbf13a0d",
+    "@puckeditor/core": "0.22.0",
     "@types/node": "^24.3.0",
     "ai": "^6.0.191",
     "eslint": "^9.39.4",