@puckeditor/cloud-client 0.8.2 → 0.9.0-canary.50fad349

package/dist/{chunk-CVAUWBJD.mjs → chunk-TWV5OYHJ.mjs}

@@ -13,6 +13,9 @@ var tool = (t) => t;
 // src/api/chat.ts
 init_react_import();
 
+// src/lib/stream-cloud-api.ts
+init_react_import();
+
 // ../../node_modules/.pnpm/ai@6.0.230_zod@4.3.6/node_modules/ai/dist/index.mjs
 init_react_import();
 
@@ -20961,14 +20964,14 @@ function createUIMessageStreamResponse({
   status,
   statusText,
   headers,
-  stream,
+  stream: stream2,
   consumeSseStream
 }) {
-  let sseStream = stream.pipeThrough(new JsonToSseTransformStream());
+  let sseStream = stream2.pipeThrough(new JsonToSseTransformStream());
   if (consumeSseStream) {
-    const [stream1, stream2] = sseStream.tee();
+    const [stream1, stream22] = sseStream.tee();
     sseStream = stream1;
-    consumeSseStream({ stream: stream2 });
+    consumeSseStream({ stream: stream22 });
   }
   return new Response(sseStream.pipeThrough(new TextEncoderStream()), {
     status,
@@ -21185,7 +21188,7 @@ function createStreamingUIMessageState({
   };
 }
 function processUIMessageStream({
-  stream,
+  stream: stream2,
   messageMetadataSchema,
   dataPartSchemas,
   runUpdateMessageJob,
@@ -21193,7 +21196,7 @@ function processUIMessageStream({
   onToolCall,
   onData
 }) {
-  return stream.pipeThrough(
+  return stream2.pipeThrough(
     new TransformStream({
       async transform(chunk, controller) {
         await runUpdateMessageJob(async ({ state, write }) => {
@@ -21740,7 +21743,7 @@ function handleUIMessageStreamFinish({
   onStepFinish,
   onFinish,
   onError,
-  stream
+  stream: stream2
 }) {
   let lastMessage = originalMessages == null ? void 0 : originalMessages[originalMessages.length - 1];
   if ((lastMessage == null ? void 0 : lastMessage.role) !== "assistant") {
@@ -21749,7 +21752,7 @@ function handleUIMessageStreamFinish({
     messageId = lastMessage.id;
   }
   let isAborted2 = false;
-  const idInjectedStream = stream.pipeThrough(
+  const idInjectedStream = stream2.pipeThrough(
     new TransformStream({
       transform(chunk, controller) {
         if (chunk.type === "start") {
@@ -21850,7 +21853,7 @@ function createUIMessageStream({
 }) {
   let controller;
   const ongoingStreamPromises = [];
-  const stream = new ReadableStream({
+  const stream2 = new ReadableStream({
     start(controllerArg) {
       controller = controllerArg;
     }
@@ -21917,7 +21920,7 @@ function createUIMessageStream({
     }
   });
   return handleUIMessageStreamFinish({
-    stream,
+    stream: stream2,
     messageId: generateId2(),
     originalMessages,
     onStepFinish,
@@ -22363,27 +22366,33 @@ var processUserTool = async ({
   }
 };
 
-// src/lib/iterate-sse.ts
+// ../utils/lib/iterate-sse.ts
 init_react_import();
 async function* iterateSSE(body) {
   const reader = body.getReader();
   const dec = new TextDecoder();
   let buf = "";
-  while (true) {
-    const { done, value } = await reader.read();
-    if (done) break;
-    buf += dec.decode(value, { stream: true });
-    let idx;
-    while ((idx = buf.indexOf("\n\n")) >= 0) {
-      const chunk = buf.slice(0, idx).trim();
-      buf = buf.slice(idx + 2);
-      if (!chunk) continue;
-      const line = chunk.startsWith("data: ") ? chunk.slice(6) : chunk;
-      try {
-        yield JSON.parse(line);
-      } catch {
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buf += dec.decode(value, { stream: true });
+      let idx;
+      while ((idx = buf.indexOf("\n\n")) >= 0) {
+        const chunk = buf.slice(0, idx).trim();
+        buf = buf.slice(idx + 2);
+        if (!chunk) continue;
+        const line = chunk.startsWith("data: ") ? chunk.slice(6) : chunk;
+        try {
+          yield JSON.parse(line);
+        } catch {
+        }
       }
     }
+  } finally {
+    reader.cancel().catch(() => {
+    });
+    reader.releaseLock();
   }
 }
 
@@ -22414,7 +22423,7 @@ var DEFAULT_V2_MODELS = {
   assembly: "openai/gpt-5.4-mini",
   design: "openai/gpt-5.6-luna"
 };
-var CLOUD_CLIENT_VERSION = true ? "0.8.2" : "unknown";
+var CLOUD_CLIENT_VERSION = true ? "0.9.0-canary.50fad349" : "unknown";
 var cloudApi = async (path, body, options = {}, onChunk, forwardHeaders) => {
   const {
     ai = {},
@@ -22475,19 +22484,18 @@ var cloudApi = async (path, body, options = {}, onChunk, forwardHeaders) => {
   return res;
 };
 
-// src/api/chat.ts
+// src/lib/stream-cloud-api.ts
 var handleStreamError = (error48) => {
   console.error(error48);
   return error48 instanceof Error ? error48.message : "An error occurred.";
 };
-function chatPrivate({ chatId, messages, config: config2, pageData, mode }, options = {}, forwardHeaders) {
-  const resolvedMode = mode ?? options?.ai?.mode;
-  const stream = createUIMessageStream({
+var streamCloudApi = (path, body, options = {}, forwardHeaders) => {
+  const stream2 = createUIMessageStream({
     onError: handleStreamError,
     execute: async ({ writer }) => {
       await cloudApi(
-        "chat",
-        { chatId, config: config2, messages, pageData, mode: resolvedMode },
+        path,
+        body,
         options,
         (chunk) => {
           if (chunk.type === "data-finish") {
@@ -22500,29 +22508,24 @@ function chatPrivate({ chatId, messages, config: config2, pageData, mode }, opti
       );
     }
   });
-  return createUIMessageStreamResponse({ stream });
+  return createUIMessageStreamResponse({ stream: stream2 });
+};
+
+// src/api/chat.ts
+function chatPrivate({ chatId, messages, config: config2, pageData, mode }, options = {}, forwardHeaders) {
+  return streamCloudApi(
+    "chat",
+    { chatId, config: config2, messages, pageData, mode: mode ?? options?.ai?.mode },
+    options,
+    forwardHeaders
+  );
 }
 function chat({ chatId, messages, config: config2, pageData }, options = {}, forwardHeaders) {
-  const resolvedMode = options?.ai?.mode;
-  const stream = createUIMessageStream({
-    onError: handleStreamError,
-    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 });
+  return chatPrivate(
+    { chatId, messages, config: config2, pageData },
+    options,
+    forwardHeaders
+  );
 }
 
 // src/api/generate.ts
@@ -22576,6 +22579,36 @@ init_react_import();
 // src/routes.ts
 init_react_import();
 
+// src/api/stream.ts
+init_react_import();
+function stream(params, options = {}, forwardHeaders) {
+  const { prompt, config: config2, pageData, context, mode } = params ?? {};
+  const { ai } = options;
+  if (!prompt) {
+    return Response.json({ error: "A prompt is required" }, { status: 400 });
+  }
+  const designAllowed = ai?.designMode?.allowed === true;
+  const requestedMode = ai?.mode ?? mode;
+  return streamCloudApi(
+    "generate",
+    {
+      prompt,
+      config: config2 ?? { components: {} },
+      pageData,
+      mode: requestedMode === "design" && designAllowed ? "design" : "assembly",
+      stream: true
+    },
+    {
+      ...options,
+      ai: {
+        ...ai,
+        context: ai?.context ?? context
+      }
+    },
+    forwardHeaders
+  );
+}
+
 // src/api/attachments.ts
 init_react_import();
 var DEFAULT_HOST = "https://cloud.puckeditor.com/api";
@@ -22713,6 +22746,14 @@ var matchRoute = (pattern, pathname) => {
   return params;
 };
 var routeRegistry = [
+  {
+    pattern: "/api/puck/stream",
+    methods: {
+      POST: ({ body, headers }, options) => stream(body, options, {
+        pluginAiVersion: headers.get("x-puck-plugin-ai-version")
+      })
+    }
+  },
   {
     pattern: "/api/puck/chat/tool",
     methods: {
@@ -22800,12 +22841,13 @@ async function puckHandler(request, options = {}) {
 }
 
 // src/index.ts
-var endpoints = ["chat"];
+var endpoints = ["chat", "stream"];
 
 export {
   getApiKey,
   chatPrivate,
   chat,
+  stream,
   createAttachments,
   getAttachment,
   deleteAttachment,

package/dist/experimental.js

@@ -56,6 +56,9 @@ init_react_import();
 // src/api/chat.ts
 init_react_import();
 
+// src/lib/stream-cloud-api.ts
+init_react_import();
+
 // ../../node_modules/.pnpm/ai@6.0.230_zod@4.3.6/node_modules/ai/dist/index.mjs
 init_react_import();
 
@@ -21004,14 +21007,14 @@ function createUIMessageStreamResponse({
   status,
   statusText,
   headers,
-  stream,
+  stream: stream2,
   consumeSseStream
 }) {
-  let sseStream = stream.pipeThrough(new JsonToSseTransformStream());
+  let sseStream = stream2.pipeThrough(new JsonToSseTransformStream());
   if (consumeSseStream) {
-    const [stream1, stream2] = sseStream.tee();
+    const [stream1, stream22] = sseStream.tee();
     sseStream = stream1;
-    consumeSseStream({ stream: stream2 });
+    consumeSseStream({ stream: stream22 });
   }
   return new Response(sseStream.pipeThrough(new TextEncoderStream()), {
     status,
@@ -21228,7 +21231,7 @@ function createStreamingUIMessageState({
   };
 }
 function processUIMessageStream({
-  stream,
+  stream: stream2,
   messageMetadataSchema,
   dataPartSchemas,
   runUpdateMessageJob,
@@ -21236,7 +21239,7 @@ function processUIMessageStream({
   onToolCall,
   onData
 }) {
-  return stream.pipeThrough(
+  return stream2.pipeThrough(
     new TransformStream({
       async transform(chunk, controller) {
         await runUpdateMessageJob(async ({ state, write }) => {
@@ -21783,7 +21786,7 @@ function handleUIMessageStreamFinish({
   onStepFinish,
   onFinish,
   onError,
-  stream
+  stream: stream2
 }) {
   let lastMessage = originalMessages == null ? void 0 : originalMessages[originalMessages.length - 1];
   if ((lastMessage == null ? void 0 : lastMessage.role) !== "assistant") {
@@ -21792,7 +21795,7 @@ function handleUIMessageStreamFinish({
     messageId = lastMessage.id;
   }
   let isAborted2 = false;
-  const idInjectedStream = stream.pipeThrough(
+  const idInjectedStream = stream2.pipeThrough(
     new TransformStream({
       transform(chunk, controller) {
         if (chunk.type === "start") {
@@ -21893,7 +21896,7 @@ function createUIMessageStream({
 }) {
   let controller;
   const ongoingStreamPromises = [];
-  const stream = new ReadableStream({
+  const stream2 = new ReadableStream({
     start(controllerArg) {
       controller = controllerArg;
     }
@@ -21960,7 +21963,7 @@ function createUIMessageStream({
     }
   });
   return handleUIMessageStreamFinish({
-    stream,
+    stream: stream2,
     messageId: generateId2(),
     originalMessages,
     onStepFinish,
@@ -22406,27 +22409,33 @@ var processUserTool = async ({
   }
 };
 
-// src/lib/iterate-sse.ts
+// ../utils/lib/iterate-sse.ts
 init_react_import();
 async function* iterateSSE(body) {
   const reader = body.getReader();
   const dec = new TextDecoder();
   let buf = "";
-  while (true) {
-    const { done, value } = await reader.read();
-    if (done) break;
-    buf += dec.decode(value, { stream: true });
-    let idx;
-    while ((idx = buf.indexOf("\n\n")) >= 0) {
-      const chunk = buf.slice(0, idx).trim();
-      buf = buf.slice(idx + 2);
-      if (!chunk) continue;
-      const line = chunk.startsWith("data: ") ? chunk.slice(6) : chunk;
-      try {
-        yield JSON.parse(line);
-      } catch {
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buf += dec.decode(value, { stream: true });
+      let idx;
+      while ((idx = buf.indexOf("\n\n")) >= 0) {
+        const chunk = buf.slice(0, idx).trim();
+        buf = buf.slice(idx + 2);
+        if (!chunk) continue;
+        const line = chunk.startsWith("data: ") ? chunk.slice(6) : chunk;
+        try {
+          yield JSON.parse(line);
+        } catch {
+        }
       }
     }
+  } finally {
+    reader.cancel().catch(() => {
+    });
+    reader.releaseLock();
   }
 }
 
@@ -22457,7 +22466,7 @@ var DEFAULT_V2_MODELS = {
   assembly: "openai/gpt-5.4-mini",
   design: "openai/gpt-5.6-luna"
 };
-var CLOUD_CLIENT_VERSION = true ? "0.8.2" : "unknown";
+var CLOUD_CLIENT_VERSION = true ? "0.9.0-canary.50fad349" : "unknown";
 var cloudApi = async (path, body, options = {}, onChunk, forwardHeaders) => {
   const {
     ai = {},
@@ -22518,19 +22527,18 @@ var cloudApi = async (path, body, options = {}, onChunk, forwardHeaders) => {
   return res;
 };
 
-// src/api/chat.ts
+// src/lib/stream-cloud-api.ts
 var handleStreamError = (error48) => {
   console.error(error48);
   return error48 instanceof Error ? error48.message : "An error occurred.";
 };
-function chatPrivate({ chatId, messages, config: config2, pageData, mode }, options = {}, forwardHeaders) {
-  const resolvedMode = mode ?? options?.ai?.mode;
-  const stream = createUIMessageStream({
+var streamCloudApi = (path, body, options = {}, forwardHeaders) => {
+  const stream2 = createUIMessageStream({
     onError: handleStreamError,
     execute: async ({ writer }) => {
       await cloudApi(
-        "chat",
-        { chatId, config: config2, messages, pageData, mode: resolvedMode },
+        path,
+        body,
         options,
         (chunk) => {
           if (chunk.type === "data-finish") {
@@ -22543,29 +22551,54 @@ function chatPrivate({ chatId, messages, config: config2, pageData, mode }, opti
       );
     }
   });
-  return createUIMessageStreamResponse({ stream });
+  return createUIMessageStreamResponse({ stream: stream2 });
+};
+
+// src/api/chat.ts
+function chatPrivate({ chatId, messages, config: config2, pageData, mode }, options = {}, forwardHeaders) {
+  return streamCloudApi(
+    "chat",
+    { chatId, config: config2, messages, pageData, mode: mode ?? options?.ai?.mode },
+    options,
+    forwardHeaders
+  );
 }
 function chat({ chatId, messages, config: config2, pageData }, options = {}, forwardHeaders) {
-  const resolvedMode = options?.ai?.mode;
-  const stream = createUIMessageStream({
-    onError: handleStreamError,
-    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 });
+  return chatPrivate(
+    { chatId, messages, config: config2, pageData },
+    options,
+    forwardHeaders
+  );
+}
+
+// src/api/stream.ts
+init_react_import();
+function stream(params, options = {}, forwardHeaders) {
+  const { prompt, config: config2, pageData, context, mode } = params ?? {};
+  const { ai } = options;
+  if (!prompt) {
+    return Response.json({ error: "A prompt is required" }, { status: 400 });
+  }
+  const designAllowed = ai?.designMode?.allowed === true;
+  const requestedMode = ai?.mode ?? mode;
+  return streamCloudApi(
+    "generate",
+    {
+      prompt,
+      config: config2 ?? { components: {} },
+      pageData,
+      mode: requestedMode === "design" && designAllowed ? "design" : "assembly",
+      stream: true
+    },
+    {
+      ...options,
+      ai: {
+        ...ai,
+        context: ai?.context ?? context
+      }
+    },
+    forwardHeaders
+  );
 }
 
 // src/api/attachments.ts
@@ -23100,10 +23133,18 @@ async function generate({
 }
 
 // src/index.ts
-var endpoints = ["chat"];
+var endpoints = ["chat", "stream"];
 
 // src/experimental.ts
 var routeRegistry = [
+  {
+    pattern: "/api/puck/stream",
+    methods: {
+      POST: ({ body, headers }, options) => stream(body, options, {
+        pluginAiVersion: headers.get("x-puck-plugin-ai-version")
+      })
+    }
+  },
   {
     pattern: "/api/puck/chat/tool",
     methods: {

package/dist/experimental.mjs

@@ -10,8 +10,9 @@ import {
   getApiKey,
   getAttachment,
   handlePuckRequest,
+  stream,
   tool
-} from "./chunk-CVAUWBJD.mjs";
+} from "./chunk-TWV5OYHJ.mjs";
 import {
   init_react_import
 } from "./chunk-O6DC5HI2.mjs";
@@ -306,6 +307,14 @@ var getPublishedPageData = async ({
 
 // src/experimental.ts
 var routeRegistry = [
+  {
+    pattern: "/api/puck/stream",
+    methods: {
+      POST: ({ body, headers }, options) => stream(body, options, {
+        pluginAiVersion: headers.get("x-puck-plugin-ai-version")
+      })
+    }
+  },
   {
     pattern: "/api/puck/chat/tool",
     methods: {

package/dist/index.d.mts

@@ -722,7 +722,7 @@ declare function generate({ prompt, config, pageData, context, tools, mode, desi
 
 declare function puckHandler(request: Request, options?: PuckCloudOptions): Promise<Response>;
 
-declare const endpoints: readonly ["chat"];
+declare const endpoints: readonly ["chat", "stream"];
 type Endpoint = (typeof endpoints)[number];
 
 export { type ChatParams, type DesignModeOptions, type Endpoint, type GenerateParams, type OnFinishCallback, type OnFinishResult, type PuckAiModel, type PuckAiProviderOptions, type PuckCloudOptions, type UserTool, type UserToolRegistry, chat, endpoints, generate, puckHandler, tool };

package/dist/index.d.ts

@@ -722,7 +722,7 @@ declare function generate({ prompt, config, pageData, context, tools, mode, desi
 
 declare function puckHandler(request: Request, options?: PuckCloudOptions): Promise<Response>;
 
-declare const endpoints: readonly ["chat"];
+declare const endpoints: readonly ["chat", "stream"];
 type Endpoint = (typeof endpoints)[number];
 
 export { type ChatParams, type DesignModeOptions, type Endpoint, type GenerateParams, type OnFinishCallback, type OnFinishResult, type PuckAiModel, type PuckAiProviderOptions, type PuckCloudOptions, type UserTool, type UserToolRegistry, chat, endpoints, generate, puckHandler, tool };

package/dist/index.js

@@ -58,6 +58,9 @@ var tool = (t) => t;
 // src/api/chat.ts
 init_react_import();
 
+// src/lib/stream-cloud-api.ts
+init_react_import();
+
 // ../../node_modules/.pnpm/ai@6.0.230_zod@4.3.6/node_modules/ai/dist/index.mjs
 init_react_import();
 
@@ -21006,14 +21009,14 @@ function createUIMessageStreamResponse({
   status,
   statusText,
   headers,
-  stream,
+  stream: stream2,
   consumeSseStream
 }) {
-  let sseStream = stream.pipeThrough(new JsonToSseTransformStream());
+  let sseStream = stream2.pipeThrough(new JsonToSseTransformStream());
   if (consumeSseStream) {
-    const [stream1, stream2] = sseStream.tee();
+    const [stream1, stream22] = sseStream.tee();
     sseStream = stream1;
-    consumeSseStream({ stream: stream2 });
+    consumeSseStream({ stream: stream22 });
   }
   return new Response(sseStream.pipeThrough(new TextEncoderStream()), {
     status,
@@ -21230,7 +21233,7 @@ function createStreamingUIMessageState({
   };
 }
 function processUIMessageStream({
-  stream,
+  stream: stream2,
   messageMetadataSchema,
   dataPartSchemas,
   runUpdateMessageJob,
@@ -21238,7 +21241,7 @@ function processUIMessageStream({
   onToolCall,
   onData
 }) {
-  return stream.pipeThrough(
+  return stream2.pipeThrough(
     new TransformStream({
       async transform(chunk, controller) {
         await runUpdateMessageJob(async ({ state, write }) => {
@@ -21785,7 +21788,7 @@ function handleUIMessageStreamFinish({
   onStepFinish,
   onFinish,
   onError,
-  stream
+  stream: stream2
 }) {
   let lastMessage = originalMessages == null ? void 0 : originalMessages[originalMessages.length - 1];
   if ((lastMessage == null ? void 0 : lastMessage.role) !== "assistant") {
@@ -21794,7 +21797,7 @@ function handleUIMessageStreamFinish({
     messageId = lastMessage.id;
   }
   let isAborted2 = false;
-  const idInjectedStream = stream.pipeThrough(
+  const idInjectedStream = stream2.pipeThrough(
     new TransformStream({
       transform(chunk, controller) {
         if (chunk.type === "start") {
@@ -21895,7 +21898,7 @@ function createUIMessageStream({
 }) {
   let controller;
   const ongoingStreamPromises = [];
-  const stream = new ReadableStream({
+  const stream2 = new ReadableStream({
     start(controllerArg) {
       controller = controllerArg;
     }
@@ -21962,7 +21965,7 @@ function createUIMessageStream({
     }
   });
   return handleUIMessageStreamFinish({
-    stream,
+    stream: stream2,
     messageId: generateId2(),
     originalMessages,
     onStepFinish,
@@ -22408,27 +22411,33 @@ var processUserTool = async ({
   }
 };
 
-// src/lib/iterate-sse.ts
+// ../utils/lib/iterate-sse.ts
 init_react_import();
 async function* iterateSSE(body) {
   const reader = body.getReader();
   const dec = new TextDecoder();
   let buf = "";
-  while (true) {
-    const { done, value } = await reader.read();
-    if (done) break;
-    buf += dec.decode(value, { stream: true });
-    let idx;
-    while ((idx = buf.indexOf("\n\n")) >= 0) {
-      const chunk = buf.slice(0, idx).trim();
-      buf = buf.slice(idx + 2);
-      if (!chunk) continue;
-      const line = chunk.startsWith("data: ") ? chunk.slice(6) : chunk;
-      try {
-        yield JSON.parse(line);
-      } catch {
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buf += dec.decode(value, { stream: true });
+      let idx;
+      while ((idx = buf.indexOf("\n\n")) >= 0) {
+        const chunk = buf.slice(0, idx).trim();
+        buf = buf.slice(idx + 2);
+        if (!chunk) continue;
+        const line = chunk.startsWith("data: ") ? chunk.slice(6) : chunk;
+        try {
+          yield JSON.parse(line);
+        } catch {
+        }
       }
     }
+  } finally {
+    reader.cancel().catch(() => {
+    });
+    reader.releaseLock();
   }
 }
 
@@ -22459,7 +22468,7 @@ var DEFAULT_V2_MODELS = {
   assembly: "openai/gpt-5.4-mini",
   design: "openai/gpt-5.6-luna"
 };
-var CLOUD_CLIENT_VERSION = true ? "0.8.2" : "unknown";
+var CLOUD_CLIENT_VERSION = true ? "0.9.0-canary.50fad349" : "unknown";
 var cloudApi = async (path, body, options = {}, onChunk, forwardHeaders) => {
   const {
     ai = {},
@@ -22520,19 +22529,18 @@ var cloudApi = async (path, body, options = {}, onChunk, forwardHeaders) => {
   return res;
 };
 
-// src/api/chat.ts
+// src/lib/stream-cloud-api.ts
 var handleStreamError = (error48) => {
   console.error(error48);
   return error48 instanceof Error ? error48.message : "An error occurred.";
 };
-function chatPrivate({ chatId, messages, config: config2, pageData, mode }, options = {}, forwardHeaders) {
-  const resolvedMode = mode ?? options?.ai?.mode;
-  const stream = createUIMessageStream({
+var streamCloudApi = (path, body, options = {}, forwardHeaders) => {
+  const stream2 = createUIMessageStream({
     onError: handleStreamError,
     execute: async ({ writer }) => {
       await cloudApi(
-        "chat",
-        { chatId, config: config2, messages, pageData, mode: resolvedMode },
+        path,
+        body,
         options,
         (chunk) => {
           if (chunk.type === "data-finish") {
@@ -22545,29 +22553,24 @@ function chatPrivate({ chatId, messages, config: config2, pageData, mode }, opti
       );
     }
   });
-  return createUIMessageStreamResponse({ stream });
+  return createUIMessageStreamResponse({ stream: stream2 });
+};
+
+// src/api/chat.ts
+function chatPrivate({ chatId, messages, config: config2, pageData, mode }, options = {}, forwardHeaders) {
+  return streamCloudApi(
+    "chat",
+    { chatId, config: config2, messages, pageData, mode: mode ?? options?.ai?.mode },
+    options,
+    forwardHeaders
+  );
 }
 function chat({ chatId, messages, config: config2, pageData }, options = {}, forwardHeaders) {
-  const resolvedMode = options?.ai?.mode;
-  const stream = createUIMessageStream({
-    onError: handleStreamError,
-    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 });
+  return chatPrivate(
+    { chatId, messages, config: config2, pageData },
+    options,
+    forwardHeaders
+  );
 }
 
 // src/api/generate.ts
@@ -22621,6 +22624,36 @@ init_react_import();
 // src/routes.ts
 init_react_import();
 
+// src/api/stream.ts
+init_react_import();
+function stream(params, options = {}, forwardHeaders) {
+  const { prompt, config: config2, pageData, context, mode } = params ?? {};
+  const { ai } = options;
+  if (!prompt) {
+    return Response.json({ error: "A prompt is required" }, { status: 400 });
+  }
+  const designAllowed = ai?.designMode?.allowed === true;
+  const requestedMode = ai?.mode ?? mode;
+  return streamCloudApi(
+    "generate",
+    {
+      prompt,
+      config: config2 ?? { components: {} },
+      pageData,
+      mode: requestedMode === "design" && designAllowed ? "design" : "assembly",
+      stream: true
+    },
+    {
+      ...options,
+      ai: {
+        ...ai,
+        context: ai?.context ?? context
+      }
+    },
+    forwardHeaders
+  );
+}
+
 // src/api/attachments.ts
 init_react_import();
 var DEFAULT_HOST = "https://cloud.puckeditor.com/api";
@@ -22758,6 +22791,14 @@ var matchRoute = (pattern, pathname) => {
   return params;
 };
 var routeRegistry = [
+  {
+    pattern: "/api/puck/stream",
+    methods: {
+      POST: ({ body, headers }, options) => stream(body, options, {
+        pluginAiVersion: headers.get("x-puck-plugin-ai-version")
+      })
+    }
+  },
   {
     pattern: "/api/puck/chat/tool",
     methods: {
@@ -22845,7 +22886,7 @@ async function puckHandler(request, options = {}) {
 }
 
 // src/index.ts
-var endpoints = ["chat"];
+var endpoints = ["chat", "stream"];
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   chat,

package/dist/index.mjs

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@puckeditor/cloud-client",
-  "version": "0.8.2",
+  "version": "0.9.0-canary.50fad349",
   "author": "Chris Villa <chris@puckeditor.com>",
   "repository": "puckeditor/puck",
   "bugs": "https://github.com/puckeditor/puck/issues",
@@ -44,9 +44,9 @@
     "vite-tsconfig-paths": "^5.1.4",
     "vitest": "^4.1.0",
     "zod": "^4.1.12",
-    "eslint-config-custom": "0.8.2",
-    "tsconfig": "0.8.2",
-    "tsup-config": "0.8.2"
+    "eslint-config-custom": "0.9.0-canary.50fad349",
+    "tsconfig": "0.9.0-canary.50fad349",
+    "tsup-config": "0.9.0-canary.50fad349"
   },
   "scripts": {
     "lint": "eslint \"**/*.ts*\"",