@puckeditor/cloud-client 0.8.0-canary.9c5fbcbb → 0.8.0-canary.c7a937d7

package/dist/{chunk-XFKCRMW6.mjs → chunk-G2V2GZEF.mjs}

@@ -22183,7 +22183,7 @@ async function* iterateSSE(body) {
 
 // src/lib/cloud-api.ts
 var DEFAULT_API_VERSION = "v2";
-var CLOUD_CLIENT_VERSION = true ? "0.8.0-canary.9c5fbcbb" : "unknown";
+var CLOUD_CLIENT_VERSION = true ? "0.8.0-canary.c7a937d7" : "unknown";
 var cloudApi = async (path, body, options = {}, onChunk, forwardHeaders) => {
   const {
     ai = {},
@@ -22196,7 +22196,7 @@ var cloudApi = async (path, body, options = {}, onChunk, forwardHeaders) => {
       "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,
@@ -22208,7 +22208,10 @@ var cloudApi = async (path, body, options = {}, onChunk, forwardHeaders) => {
     body: JSON.stringify({
       ...body,
       context,
-      tools: prepareUserTools(tools)
+      tools: prepareUserTools(tools),
+      ...designMode ? {
+        designMode
+      } : {}
     })
   });
   if (!res.body) {
@@ -22230,12 +22233,34 @@ var cloudApi = async (path, body, options = {}, onChunk, forwardHeaders) => {
 };
 
 // src/api/chat.ts
+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, mode: resolvedMode },
+        options,
+        (chunk) => {
+          if (chunk.type === "data-finish") {
+            options.ai?.onFinish?.(chunk.data);
+          } 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 },
+        { chatId, config: config2, messages, pageData, mode: resolvedMode },
         options,
         (chunk) => {
           if (chunk.type === "data-finish") {
@@ -22274,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;
 }
 
@@ -22442,7 +22470,7 @@ var routeRegistry = [
   {
     pattern: "/api/puck/chat",
     methods: {
-      POST: ({ body, headers }, options) => chat(body, options, {
+      POST: ({ body, headers }, options) => chatPrivate(body, options, {
         pluginAiVersion: headers.get("x-puck-plugin-ai-version")
       })
     }
@@ -22511,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,7 @@ async function* iterateSSE(body) {
 
 // src/lib/cloud-api.ts
 var DEFAULT_API_VERSION = "v2";
-var CLOUD_CLIENT_VERSION = true ? "0.8.0-canary.9c5fbcbb" : "unknown";
+var CLOUD_CLIENT_VERSION = true ? "0.8.0-canary.c7a937d7" : "unknown";
 var cloudApi = async (path, body, options = {}, onChunk, forwardHeaders) => {
   const {
     ai = {},
@@ -22239,7 +22239,7 @@ var cloudApi = async (path, body, options = {}, onChunk, forwardHeaders) => {
       "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,
@@ -22251,7 +22251,10 @@ var cloudApi = async (path, body, options = {}, onChunk, forwardHeaders) => {
     body: JSON.stringify({
       ...body,
       context,
-      tools: prepareUserTools(tools)
+      tools: prepareUserTools(tools),
+      ...designMode ? {
+        designMode
+      } : {}
     })
   });
   if (!res.body) {
@@ -22273,12 +22276,34 @@ var cloudApi = async (path, body, options = {}, onChunk, forwardHeaders) => {
 };
 
 // src/api/chat.ts
+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, mode: resolvedMode },
+        options,
+        (chunk) => {
+          if (chunk.type === "data-finish") {
+            options.ai?.onFinish?.(chunk.data);
+          } 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 },
+        { chatId, config: config2, messages, pageData, mode: resolvedMode },
         options,
         (chunk) => {
           if (chunk.type === "data-finish") {
@@ -22803,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;
 }
 
@@ -22833,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-XFKCRMW6.mjs";
+} from "./chunk-G2V2GZEF.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;
@@ -63,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;
@@ -63,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,7 @@ async function* iterateSSE(body) {
 
 // src/lib/cloud-api.ts
 var DEFAULT_API_VERSION = "v2";
-var CLOUD_CLIENT_VERSION = true ? "0.8.0-canary.9c5fbcbb" : "unknown";
+var CLOUD_CLIENT_VERSION = true ? "0.8.0-canary.c7a937d7" : "unknown";
 var cloudApi = async (path, body, options = {}, onChunk, forwardHeaders) => {
   const {
     ai = {},
@@ -22241,7 +22241,7 @@ var cloudApi = async (path, body, options = {}, onChunk, forwardHeaders) => {
       "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,
@@ -22253,7 +22253,10 @@ var cloudApi = async (path, body, options = {}, onChunk, forwardHeaders) => {
     body: JSON.stringify({
       ...body,
       context,
-      tools: prepareUserTools(tools)
+      tools: prepareUserTools(tools),
+      ...designMode ? {
+        designMode
+      } : {}
     })
   });
   if (!res.body) {
@@ -22275,12 +22278,34 @@ var cloudApi = async (path, body, options = {}, onChunk, forwardHeaders) => {
 };
 
 // src/api/chat.ts
+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, mode: resolvedMode },
+        options,
+        (chunk) => {
+          if (chunk.type === "data-finish") {
+            options.ai?.onFinish?.(chunk.data);
+          } 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 },
+        { chatId, config: config2, messages, pageData, mode: resolvedMode },
         options,
         (chunk) => {
           if (chunk.type === "data-finish") {
@@ -22319,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;
 }
 
@@ -22487,7 +22515,7 @@ var routeRegistry = [
   {
     pattern: "/api/puck/chat",
     methods: {
-      POST: ({ body, headers }, 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-XFKCRMW6.mjs";
+} from "./chunk-G2V2GZEF.mjs";
 import "./chunk-O6DC5HI2.mjs";
 export {
   chat,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@puckeditor/cloud-client",
-  "version": "0.8.0-canary.9c5fbcbb",
+  "version": "0.8.0-canary.c7a937d7",
   "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",