@kubuild/ai 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/dist/{chunk-27AY2KBI.js → chunk-3DRAVYU3.js} +173 -46
  2. package/dist/chunk-3DRAVYU3.js.map +1 -0
  3. package/dist/chunk-ILLNRABB.js +24 -0
  4. package/dist/chunk-ILLNRABB.js.map +1 -0
  5. package/dist/{chunk-JY4NHD3Q.js → chunk-T72YWBJS.js} +62 -1
  6. package/dist/chunk-T72YWBJS.js.map +1 -0
  7. package/dist/{chunk-UH24LHRY.js → chunk-YETTTWHI.js} +226 -1
  8. package/dist/chunk-YETTTWHI.js.map +1 -0
  9. package/dist/client/ai-client.d.ts +20 -1
  10. package/dist/client/ai-client.d.ts.map +1 -1
  11. package/dist/client/index.cjs +61 -0
  12. package/dist/client/index.cjs.map +1 -1
  13. package/dist/client/index.js +1 -1
  14. package/dist/core/document-outline.d.ts +60 -0
  15. package/dist/core/document-outline.d.ts.map +1 -0
  16. package/dist/core/index.d.ts +2 -0
  17. package/dist/core/index.d.ts.map +1 -1
  18. package/dist/core/messages.d.ts +18 -0
  19. package/dist/core/messages.d.ts.map +1 -0
  20. package/dist/core/prompt-compiler.d.ts +29 -0
  21. package/dist/core/prompt-compiler.d.ts.map +1 -1
  22. package/dist/index.cjs +261 -2
  23. package/dist/index.cjs.map +1 -1
  24. package/dist/index.js +31 -3
  25. package/dist/react/index.cjs +173 -0
  26. package/dist/react/index.cjs.map +1 -1
  27. package/dist/react/index.d.ts +1 -0
  28. package/dist/react/index.d.ts.map +1 -1
  29. package/dist/react/index.js +112 -1
  30. package/dist/react/index.js.map +1 -1
  31. package/dist/react/use-ai-agent.d.ts +47 -0
  32. package/dist/react/use-ai-agent.d.ts.map +1 -0
  33. package/dist/server/adapters/anthropic.d.ts.map +1 -1
  34. package/dist/server/adapters/custom.d.ts.map +1 -1
  35. package/dist/server/adapters/gemini.d.ts.map +1 -1
  36. package/dist/server/adapters/index.cjs +180 -45
  37. package/dist/server/adapters/index.cjs.map +1 -1
  38. package/dist/server/adapters/index.js +2 -1
  39. package/dist/server/adapters/openai.d.ts +25 -0
  40. package/dist/server/adapters/openai.d.ts.map +1 -1
  41. package/dist/server/agent.d.ts +59 -0
  42. package/dist/server/agent.d.ts.map +1 -0
  43. package/dist/server/engine.d.ts.map +1 -1
  44. package/dist/server/handler.d.ts +10 -1
  45. package/dist/server/handler.d.ts.map +1 -1
  46. package/dist/server/index.cjs +1734 -260
  47. package/dist/server/index.cjs.map +1 -1
  48. package/dist/server/index.d.ts +2 -0
  49. package/dist/server/index.d.ts.map +1 -1
  50. package/dist/server/index.js +1229 -94
  51. package/dist/server/index.js.map +1 -1
  52. package/dist/server/tools/helpers.d.ts +66 -0
  53. package/dist/server/tools/helpers.d.ts.map +1 -0
  54. package/dist/server/tools/index.d.ts +25 -0
  55. package/dist/server/tools/index.d.ts.map +1 -0
  56. package/dist/server/tools/read-tools.d.ts +3 -0
  57. package/dist/server/tools/read-tools.d.ts.map +1 -0
  58. package/dist/server/tools/types.d.ts +51 -0
  59. package/dist/server/tools/types.d.ts.map +1 -0
  60. package/dist/server/tools/write-tools.d.ts +3 -0
  61. package/dist/server/tools/write-tools.d.ts.map +1 -0
  62. package/dist/types.d.ts +193 -2
  63. package/dist/types.d.ts.map +1 -1
  64. package/package.json +5 -5
  65. package/dist/chunk-27AY2KBI.js.map +0 -1
  66. package/dist/chunk-JY4NHD3Q.js.map +0 -1
  67. package/dist/chunk-UH24LHRY.js.map +0 -1
@@ -1,3 +1,139 @@
1
+ // src/core/document-outline.ts
2
+ var LABEL_PROPS = ["text", "label", "title", "heading", "content", "placeholder", "alt", "src"];
3
+ var DEFAULT_LABEL_MAX = 60;
4
+ function truncate(value, max = DEFAULT_LABEL_MAX) {
5
+ const oneLine = value.replace(/\s+/g, " ").trim();
6
+ return oneLine.length > max ? `${oneLine.slice(0, max - 1)}\u2026` : oneLine;
7
+ }
8
+ function getNodeLabel(node, max = DEFAULT_LABEL_MAX) {
9
+ const props = node.props ?? {};
10
+ for (const key of LABEL_PROPS) {
11
+ const value = props[key];
12
+ if (typeof value === "string" && value.trim()) {
13
+ return truncate(value, max);
14
+ }
15
+ }
16
+ return "";
17
+ }
18
+ function isOnPathTo(node, targetId) {
19
+ if (node.id === targetId) return true;
20
+ return (node.children ?? []).some((child) => isOnPathTo(child, targetId));
21
+ }
22
+ function summarizeNodeTree(root, options = {}) {
23
+ const { maxDepth = 3, focusNodeId, maxNodes = 200 } = options;
24
+ const lines = [];
25
+ let emitted = 0;
26
+ let truncated = false;
27
+ const walk = (node, depth) => {
28
+ if (emitted >= maxNodes) {
29
+ truncated = true;
30
+ return;
31
+ }
32
+ const indent = " ".repeat(depth);
33
+ const label = getNodeLabel(node);
34
+ const children = node.children ?? [];
35
+ const parts = [`${indent}- #${node.id} (${node.type})`];
36
+ if (label) parts.push(`"${label}"`);
37
+ if (children.length > 0) parts.push(`[${children.length} children]`);
38
+ if (focusNodeId && node.id === focusNodeId) parts.push("\u2190 SELECTED");
39
+ lines.push(parts.join(" "));
40
+ emitted++;
41
+ if (children.length === 0) return;
42
+ const onFocusPath = Boolean(focusNodeId) && isOnPathTo(node, focusNodeId);
43
+ if (depth + 1 > maxDepth && !onFocusPath) {
44
+ lines.push(`${indent} (+${countDescendants(node)} nested nodes \u2014 use read_node to expand)`);
45
+ return;
46
+ }
47
+ for (const child of children) {
48
+ walk(child, depth + 1);
49
+ }
50
+ };
51
+ walk(root, 0);
52
+ if (truncated) {
53
+ lines.push(` (outline truncated at ${maxNodes} nodes \u2014 use find_nodes to locate specifics)`);
54
+ }
55
+ return lines.join("\n");
56
+ }
57
+ function countDescendants(node) {
58
+ return (node.children ?? []).reduce((total, child) => total + 1 + countDescendants(child), 0);
59
+ }
60
+ function summarizeDocument(document, options = {}) {
61
+ const header = [
62
+ `Title: ${document.metadata?.title || "Untitled Page"}`,
63
+ `Description: ${document.metadata?.description || "N/A"}`
64
+ ].join("\n");
65
+ return `${header}
66
+
67
+ Page outline:
68
+ ${summarizeNodeTree(document.document, options)}`;
69
+ }
70
+ function buildSelectionContext(root, nodeId) {
71
+ const ancestors = [];
72
+ const walk = (node, parent, index) => {
73
+ if (node.id === nodeId) {
74
+ return {
75
+ node,
76
+ ancestors: [...ancestors],
77
+ siblings: parent ? parent.children ?? [] : [node],
78
+ index,
79
+ parentId: parent?.id ?? null
80
+ };
81
+ }
82
+ ancestors.push(node);
83
+ const children = node.children ?? [];
84
+ for (let i = 0; i < children.length; i++) {
85
+ const found = walk(children[i], node, i);
86
+ if (found) return found;
87
+ }
88
+ ancestors.pop();
89
+ return null;
90
+ };
91
+ return walk(root, null, 0);
92
+ }
93
+ function pruneNodeForPrompt(node, maxDepth = 2, depth = 0) {
94
+ const children = node.children ?? [];
95
+ if (children.length === 0) return node;
96
+ if (depth >= maxDepth) {
97
+ return {
98
+ ...node,
99
+ children: [
100
+ {
101
+ id: `${node.id}__collapsed`,
102
+ type: "__collapsed__",
103
+ props: {
104
+ note: `${countDescendants(node)} nested nodes omitted \u2014 call read_node on #${node.id} with includeChildren to expand`
105
+ }
106
+ }
107
+ ]
108
+ };
109
+ }
110
+ return {
111
+ ...node,
112
+ children: children.map((child) => pruneNodeForPrompt(child, maxDepth, depth + 1))
113
+ };
114
+ }
115
+ function formatSelectionContext(context) {
116
+ const path = context.ancestors.map((a) => `#${a.id}(${a.type})`).join(" > ");
117
+ const siblings = context.siblings.map((sibling, i) => {
118
+ const marker = sibling.id === context.node.id ? " \u2190 selected" : "";
119
+ const label = getNodeLabel(sibling);
120
+ return ` [${i}] #${sibling.id} (${sibling.type})${label ? ` "${label}"` : ""}${marker}`;
121
+ }).join("\n");
122
+ return [
123
+ "### Currently Selected Component",
124
+ `Node: #${context.node.id} (${context.node.type})`,
125
+ `Parent: ${context.parentId ? `#${context.parentId}` : "(root)"} \u2014 position ${context.index}`,
126
+ path ? `Path: ${path}` : "",
127
+ "Full node JSON:",
128
+ "```json",
129
+ JSON.stringify(pruneNodeForPrompt(context.node), null, 2),
130
+ "```",
131
+ "Siblings:",
132
+ siblings,
133
+ 'When the user says "this", "ini", "komponen ini" or similar, they mean the selected node above.'
134
+ ].filter(Boolean).join("\n");
135
+ }
136
+
1
137
  // src/core/prompt-compiler.ts
2
138
  function compileComponentCatalog(registry) {
3
139
  if (!registry) return [];
@@ -179,6 +315,86 @@ function buildJsonSchemaForMode(mode) {
179
315
  }
180
316
  return nodeSchema;
181
317
  }
318
+ function formatComponentCatalog(catalog) {
319
+ return catalog.map((c) => {
320
+ let desc = `- **${c.type}** (${c.category}): ${c.label}`;
321
+ if (c.description) desc += ` - ${c.description}`;
322
+ desc += ` | acceptsChildren: ${c.acceptsChildren}`;
323
+ if (c.allowedChildren && c.allowedChildren.length > 0) {
324
+ desc += ` | allowedChildren: [${c.allowedChildren.join(", ")}]`;
325
+ }
326
+ if (c.props && c.props.length > 0) {
327
+ const propList = c.props.map((p) => {
328
+ let pStr = `${p.name} (${p.type})`;
329
+ if (p.options) pStr += `[${p.options.map(String).join("|")}]`;
330
+ return pStr;
331
+ }).join(", ");
332
+ desc += ` | props: { ${propList} }`;
333
+ }
334
+ return desc;
335
+ }).join("\n");
336
+ }
337
+ var AGENT_INSTRUCTIONS = `You are the KUBUILD page-editing agent. You edit an existing page by calling tools \u2014 you never output page JSON directly.
338
+
339
+ ### HOW YOU WORK
340
+ 1. The page outline below is your map. It shows every node's id, type and label, but not its props or styles.
341
+ 2. To see a node's actual props/styles, call read_node. To locate nodes by type or text, call find_nodes. Never guess a node id \u2014 every id you pass must come from the outline or from a tool result.
342
+ 3. Make the change with the smallest tool that expresses it, then stop and summarize what you changed, in the user's language.
343
+
344
+ ### SURGICAL EDIT RULE (the most important rule)
345
+ Change only what the user asked for.
346
+ - Changing text/label/href/src -> update_node_props on that one node.
347
+ - Changing color/spacing/size/alignment -> update_node_styles on that one node.
348
+ - Adding something new -> insert_component (a single element) or insert_section (a whole new section).
349
+ - replace_node is a last resort, only when a node's children genuinely must be restructured. Never use it to change a prop or a style.
350
+ - Never rebuild a section, and never touch nodes the user did not ask about. If an instruction is ambiguous about scope, edit the narrowest node that satisfies it and say so in your summary.
351
+
352
+ ### DESTRUCTIVE ACTIONS
353
+ delete_node and replace_node destroy user content. Only call them when the user asked unambiguously (e.g. "hapus section harga"). If the request is broad or vague ("bersihkan halaman ini", "hapus yang tidak perlu"), do not call them \u2014 ask the user which nodes to remove instead.
354
+
355
+ ### STYLING RULES
356
+ - styles values are CSS primitives (strings/numbers). Use breakpoint ('base' | 'desktop' | 'tablet' | 'mobile') for normal styling and state (':hover', ':focus', ':active') for interactive states. Never nest a pseudo-class inside a breakpoint layer.
357
+ - Only use component types that exist in the catalog below, and respect acceptsChildren/allowedChildren.
358
+ - Never emit scripts, javascript: URIs, or event-handler attributes.
359
+
360
+ ### WHEN A TOOL FAILS
361
+ A tool result with "ok": false means your input was wrong (unknown node id, invalid type, disallowed nesting). Read the error, fix your arguments, and retry \u2014 do not repeat the identical call, and do not give up silently.`;
362
+ function buildAgentSystemPrompt(options) {
363
+ const { catalog, document, selectedNodeId, prefix, stylePreference, additionalContext } = options;
364
+ const selection = selectedNodeId ? buildSelectionContext(document.document, selectedNodeId) : null;
365
+ const sections = [];
366
+ if (prefix) sections.push(prefix);
367
+ sections.push(AGENT_INSTRUCTIONS);
368
+ sections.push(
369
+ `### REGISTERED COMPONENT CATALOG
370
+ ${formatComponentCatalog(catalog) || "(Standard core components: page, section, container, columns, heading, paragraph, text, button, input, textarea, select, image, video, icon, badge, code-block)"}`
371
+ );
372
+ sections.push(`### CURRENT PAGE
373
+ ${summarizeDocument(document, { focusNodeId: selectedNodeId })}`);
374
+ if (selection) {
375
+ sections.push(formatSelectionContext(selection));
376
+ } else if (selectedNodeId) {
377
+ sections.push(
378
+ `### Selection
379
+ The editor reported node "${selectedNodeId}" as selected, but it is not present in the current page. Ignore it and ask the user what to target.`
380
+ );
381
+ } else {
382
+ sections.push(
383
+ '### Selection\nNo component is selected on the canvas. If the user says "this", ask which component they mean instead of guessing.'
384
+ );
385
+ }
386
+ if (stylePreference) {
387
+ sections.push(
388
+ `### Style Preference
389
+ "${stylePreference}" \u2014 follow this aesthetic for anything you create or restyle.`
390
+ );
391
+ }
392
+ if (additionalContext) {
393
+ sections.push(`### Additional Context
394
+ ${additionalContext}`);
395
+ }
396
+ return sections.join("\n\n");
397
+ }
182
398
 
183
399
  // src/core/normalizer.ts
184
400
  import {
@@ -430,9 +646,18 @@ function normalizeAndValidateRefactoredNode(rawJson, originalNode, securityLimit
430
646
  }
431
647
 
432
648
  export {
649
+ getNodeLabel,
650
+ summarizeNodeTree,
651
+ countDescendants,
652
+ summarizeDocument,
653
+ buildSelectionContext,
654
+ pruneNodeForPrompt,
655
+ formatSelectionContext,
433
656
  compileComponentCatalog,
434
657
  buildSystemPrompt,
435
658
  buildJsonSchemaForMode,
659
+ formatComponentCatalog,
660
+ buildAgentSystemPrompt,
436
661
  extractJsonFromResponse,
437
662
  normalizeStyles,
438
663
  normalizeNodeTree,
@@ -440,4 +665,4 @@ export {
440
665
  normalizeAndValidateSectionNode,
441
666
  normalizeAndValidateRefactoredNode
442
667
  };
443
- //# sourceMappingURL=chunk-UH24LHRY.js.map
668
+ //# sourceMappingURL=chunk-YETTTWHI.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/core/document-outline.ts","../src/core/prompt-compiler.ts","../src/core/normalizer.ts"],"sourcesContent":["import type { Node, PageDocument } from '@kubuild/schema';\n\n/**\n * Props that carry user-visible text, ordered by how well they identify a node. Used to\n * label outline rows so the model can say \"the CTA button\" instead of guessing from ids.\n * Matches the prop names the component definitions in `@kubuild/components` actually use\n * (`label` on button/checkbox/file-upload, `text`/`content` on text nodes, `title` on\n * section-ish components, `src`/`alt` on media).\n */\nconst LABEL_PROPS = ['text', 'label', 'title', 'heading', 'content', 'placeholder', 'alt', 'src'];\n\nconst DEFAULT_LABEL_MAX = 60;\n\n/** Trims a value to a single short line — outlines must stay cheap in tokens. */\nfunction truncate(value: string, max = DEFAULT_LABEL_MAX): string {\n const oneLine = value.replace(/\\s+/g, ' ').trim();\n return oneLine.length > max ? `${oneLine.slice(0, max - 1)}…` : oneLine;\n}\n\n/**\n * Best-effort human label for a node, derived from its text-carrying props. Returns an\n * empty string when the node has none (layout containers, mostly).\n */\nexport function getNodeLabel(node: Node, max = DEFAULT_LABEL_MAX): string {\n const props = node.props ?? {};\n for (const key of LABEL_PROPS) {\n const value = props[key];\n if (typeof value === 'string' && value.trim()) {\n return truncate(value, max);\n }\n }\n return '';\n}\n\nexport interface DocumentOutlineOptions {\n /** How deep to walk before collapsing into a `(+N nested)` marker. Default: 3. */\n maxDepth?: number;\n /**\n * When set, the branch containing this node is always expanded in full regardless of\n * `maxDepth`, and the node itself is marked with `← SELECTED`. This is what makes\n * \"user selected a component on the canvas\" legible to the model.\n */\n focusNodeId?: string;\n /** Hard ceiling on emitted rows, so a huge page can't blow up the prompt. Default: 200. */\n maxNodes?: number;\n}\n\nfunction isOnPathTo(node: Node, targetId: string): boolean {\n if (node.id === targetId) return true;\n return (node.children ?? []).some((child) => isOnPathTo(child, targetId));\n}\n\n/**\n * Renders a compact, indented outline of a node tree (STORA-530).\n *\n * This is the agent's *default* view of the document: one line per node with id, type,\n * label and child count — never full props/styles. Detail is fetched on demand via the\n * `read_node` tool, which keeps per-step prompt cost roughly constant no matter how big\n * the page is. `engine.buildChatPrompt`'s depth-1 section summary can't do this: nested\n * nodes were invisible to the model, so it could never target them.\n */\nexport function summarizeNodeTree(root: Node, options: DocumentOutlineOptions = {}): string {\n const { maxDepth = 3, focusNodeId, maxNodes = 200 } = options;\n const lines: string[] = [];\n let emitted = 0;\n let truncated = false;\n\n const walk = (node: Node, depth: number): void => {\n if (emitted >= maxNodes) {\n truncated = true;\n return;\n }\n\n const indent = ' '.repeat(depth);\n const label = getNodeLabel(node);\n const children = node.children ?? [];\n const parts = [`${indent}- #${node.id} (${node.type})`];\n if (label) parts.push(`\"${label}\"`);\n if (children.length > 0) parts.push(`[${children.length} children]`);\n if (focusNodeId && node.id === focusNodeId) parts.push('← SELECTED');\n lines.push(parts.join(' '));\n emitted++;\n\n if (children.length === 0) return;\n\n // The focused branch stays fully expanded even past maxDepth — the model needs to see\n // what it's being asked to edit, and its siblings, to make a surgical change.\n const onFocusPath = Boolean(focusNodeId) && isOnPathTo(node, focusNodeId!);\n if (depth + 1 > maxDepth && !onFocusPath) {\n lines.push(`${indent} (+${countDescendants(node)} nested nodes — use read_node to expand)`);\n return;\n }\n\n for (const child of children) {\n walk(child, depth + 1);\n }\n };\n\n walk(root, 0);\n\n if (truncated) {\n lines.push(` (outline truncated at ${maxNodes} nodes — use find_nodes to locate specifics)`);\n }\n\n return lines.join('\\n');\n}\n\n/** Total number of descendants below a node (not counting the node itself). */\nexport function countDescendants(node: Node): number {\n return (node.children ?? []).reduce((total, child) => total + 1 + countDescendants(child), 0);\n}\n\n/** Outline of a whole `PageDocument`, prefixed with its metadata. */\nexport function summarizeDocument(\n document: PageDocument,\n options: DocumentOutlineOptions = {},\n): string {\n const header = [\n `Title: ${document.metadata?.title || 'Untitled Page'}`,\n `Description: ${document.metadata?.description || 'N/A'}`,\n ].join('\\n');\n return `${header}\\n\\nPage outline:\\n${summarizeNodeTree(document.document, options)}`;\n}\n\nexport interface SelectionContext {\n node: Node;\n /** Root-first chain of ancestors, excluding the node itself. */\n ancestors: Node[];\n /** The node's siblings, in document order, including the node itself. */\n siblings: Node[];\n index: number;\n parentId: string | null;\n}\n\n/**\n * Resolves everything the agent needs to know about the canvas selection (STORA-530).\n *\n * Sending only `selectedNodeId` — what `engine.buildChatPrompt` does today — tells the\n * model an id but not what the node *is*, what it lives inside, or what sits next to it,\n * so it can't judge whether an instruction like \"make this wider\" belongs on the node or\n * on its parent container. Returns `null` when the id isn't in the tree.\n */\nexport function buildSelectionContext(root: Node, nodeId: string): SelectionContext | null {\n const ancestors: Node[] = [];\n\n const walk = (node: Node, parent: Node | null, index: number): SelectionContext | null => {\n if (node.id === nodeId) {\n return {\n node,\n ancestors: [...ancestors],\n siblings: parent ? (parent.children ?? []) : [node],\n index,\n parentId: parent?.id ?? null,\n };\n }\n ancestors.push(node);\n const children = node.children ?? [];\n for (let i = 0; i < children.length; i++) {\n const found = walk(children[i], node, i);\n if (found) return found;\n }\n ancestors.pop();\n return null;\n };\n\n return walk(root, null, 0);\n}\n\n/**\n * Depth-limits a node before it is serialized into a prompt. A selected section can carry\n * hundreds of descendants; dumping all of them would defeat the point of the outline.\n * Children below `maxDepth` are replaced by a marker node telling the model to call\n * `read_node` if it needs them.\n */\nexport function pruneNodeForPrompt(node: Node, maxDepth = 2, depth = 0): Node {\n const children = node.children ?? [];\n if (children.length === 0) return node;\n\n if (depth >= maxDepth) {\n return {\n ...node,\n children: [\n {\n id: `${node.id}__collapsed`,\n type: '__collapsed__',\n props: {\n note: `${countDescendants(node)} nested nodes omitted — call read_node on #${node.id} with includeChildren to expand`,\n },\n },\n ],\n };\n }\n\n return {\n ...node,\n children: children.map((child) => pruneNodeForPrompt(child, maxDepth, depth + 1)),\n };\n}\n\n/** Renders a `SelectionContext` as the prompt block describing the current selection. */\nexport function formatSelectionContext(context: SelectionContext): string {\n const path = context.ancestors.map((a) => `#${a.id}(${a.type})`).join(' > ');\n const siblings = context.siblings\n .map((sibling, i) => {\n const marker = sibling.id === context.node.id ? ' ← selected' : '';\n const label = getNodeLabel(sibling);\n return ` [${i}] #${sibling.id} (${sibling.type})${label ? ` \"${label}\"` : ''}${marker}`;\n })\n .join('\\n');\n\n return [\n '### Currently Selected Component',\n `Node: #${context.node.id} (${context.node.type})`,\n `Parent: ${context.parentId ? `#${context.parentId}` : '(root)'} — position ${context.index}`,\n path ? `Path: ${path}` : '',\n 'Full node JSON:',\n '```json',\n JSON.stringify(pruneNodeForPrompt(context.node), null, 2),\n '```',\n 'Siblings:',\n siblings,\n 'When the user says \"this\", \"ini\", \"komponen ini\" or similar, they mean the selected node above.',\n ]\n .filter(Boolean)\n .join('\\n');\n}\n","import type { PageDocument } from '@kubuild/schema';\nimport type {\n AiCompiledComponentSpec,\n AiCompiledComponentProp,\n ComponentRegistryLike,\n ComponentDefinitionLike,\n AiGenerationMode,\n} from '../types';\nimport {\n buildSelectionContext,\n formatSelectionContext,\n summarizeDocument,\n} from './document-outline';\n\nexport function compileComponentCatalog(\n registry?: ComponentRegistryLike,\n): AiCompiledComponentSpec[] {\n if (!registry) return [];\n\n const definitions = registry.list();\n return definitions.map((def: ComponentDefinitionLike) => {\n const props: AiCompiledComponentProp[] = [];\n\n if (def.propFields && Array.isArray(def.propFields)) {\n for (const field of def.propFields) {\n props.push({\n name: field.name,\n type: field.type || 'string',\n defaultValue: field.defaultValue,\n options: field.options?.map((o) => o.value),\n description: field.description,\n });\n }\n }\n\n return {\n type: def.type,\n label: def.label || def.type,\n category: def.category || 'custom',\n description: def.description,\n acceptsChildren: def.acceptsChildren ?? false,\n allowedChildren: def.allowedChildren,\n disallowedParents: def.disallowedParents,\n defaultProps: def.defaultProps,\n props: props.length > 0 ? props : undefined,\n };\n });\n}\n\nexport function buildSystemPrompt(options: {\n catalog: AiCompiledComponentSpec[];\n mode: AiGenerationMode;\n prefix?: string;\n stylePreference?: string;\n}): string {\n const { catalog, mode, prefix, stylePreference } = options;\n\n const catalogSummary = catalog\n .map((c) => {\n let desc = `- **${c.type}** (${c.category}): ${c.label}`;\n if (c.description) desc += ` - ${c.description}`;\n desc += ` | acceptsChildren: ${c.acceptsChildren}`;\n if (c.allowedChildren && c.allowedChildren.length > 0) {\n desc += ` | allowedChildren: [${c.allowedChildren.join(', ')}]`;\n }\n if (c.props && c.props.length > 0) {\n const propList = c.props\n .map((p) => {\n let pStr = `${p.name} (${p.type})`;\n if (p.options) pStr += `[${p.options.map(String).join('|')}]`;\n return pStr;\n })\n .join(', ');\n desc += ` | props: { ${propList} }`;\n }\n return desc;\n })\n .join('\\n');\n\n let modeInstructions = '';\n if (mode === 'full-page') {\n modeInstructions = `\nYou must generate a complete, valid KUBUILD PageDocument JSON with this exact structure:\n{\n \"schema\": \"stora.page\",\n \"version\": \"1.0.0\",\n \"metadata\": {\n \"title\": \"<Page Title>\",\n \"description\": \"<Page Description>\",\n \"tags\": [\"<tag1>\", \"<tag2>\"],\n \"category\": \"<category>\"\n },\n \"document\": {\n \"id\": \"root-page\",\n \"type\": \"page\",\n \"styles\": {\n \"base\": {\n \"backgroundColor\": \"#ffffff\",\n \"fontFamily\": \"Inter, system-ui, sans-serif\",\n \"color\": \"#111827\",\n \"minHeight\": \"100vh\"\n }\n },\n \"children\": [\n // Sections here...\n ]\n }\n}\n`;\n } else if (mode === 'section') {\n modeInstructions = `\nYou must generate a single valid KUBUILD section Node JSON with this structure:\n{\n \"id\": \"section_<unique_suffix>\",\n \"type\": \"section\",\n \"styles\": {\n \"base\": {\n \"paddingTop\": \"64px\",\n \"paddingBottom\": \"64px\",\n \"paddingLeft\": \"24px\",\n \"paddingRight\": \"24px\"\n }\n },\n \"children\": [\n // Container and child nodes...\n ]\n}\n`;\n } else if (mode === 'refactor') {\n modeInstructions = `\nYou must refactor the provided KUBUILD Node based on the user's instructions.\nReturn ONLY the updated Node JSON while maintaining structural integrity.\n`;\n }\n\n const styleGuide = stylePreference\n ? `\\nUser Style Preference: \"${stylePreference}\". Follow this visual aesthetic closely.`\n : '\\nStyle with modern, clean, high-conversion design patterns (accessible contrast, harmonious spacing, beautiful typography, subtle shadows/borders).';\n\n return `${prefix ? prefix + '\\n\\n' : ''}You are an expert web designer and KUBUILD architecture generator.\nKUBUILD is a component-driven visual website builder. Your job is to output pure, valid JSON (and NOTHING ELSE) matching the KUBUILD schema and the registered component definitions.\n\n### RULES & CONSTRAINTS:\n1. Output MUST be valid JSON only. No markdown fences, no explanatory text, no HTML tags outside html-embed.\n2. Only use component types listed in the Component Catalog below. Do NOT invent new component types.\n3. Obey \\`acceptsChildren\\` and \\`allowedChildren\\`:\n - Layout hierarchy: \\`page\\` -> \\`section\\` -> \\`container\\` or \\`columns\\` -> content components (\\`heading\\`, \\`paragraph\\`, \\`button\\`, \\`image\\`, \\`form\\`, etc.).\n - Leaf components (e.g. \\`button\\`, \\`input\\`, \\`heading\\`, \\`text\\`, \\`badge\\`) must have \\`acceptsChildren: false\\` and empty or omitted \\`children\\`.\n4. Every node MUST have a unique string \\`id\\` (e.g. \"hero-section\", \"hero-title\", \"cta-btn\").\n5. Responsive & Interactive State Styling:\n - Use the \\`styles\\` object with breakpoint keys: \\`base\\` (all viewports/desktop), and optionally \\`tablet\\` or \\`mobile\\`.\n - In \\`base\\`, \\`tablet\\`, and \\`mobile\\`, values MUST be CSS primitives (strings or numbers, e.g. \"backgroundColor\": \"#3b82f6\"). NEVER put nested objects or \":hover\" inside \"base\"!\n - For hover, active, or interactive pseudo-classes, use \\`styles.states\\` with pseudo-class keys (e.g. \\`\":hover\"\\`), like:\n \"styles\": {\n \"base\": { \"backgroundColor\": \"#3b82f6\", \"color\": \"#ffffff\" },\n \"states\": {\n \":hover\": { \"backgroundColor\": \"#2563eb\" }\n }\n }\n6. NEVER include dangerous scripts, \\`javascript:\\` URIs, or malicious payload attributes.\n${styleGuide}\n\n### OUTPUT SPECIFICATION:\n${modeInstructions}\n\n### REGISTERED COMPONENT CATALOG:\n${catalogSummary || '(Standard core components: page, section, container, columns, heading, paragraph, text, button, input, textarea, select, image, video, icon, badge, code-block)'}\n`;\n}\n\nexport function buildJsonSchemaForMode(mode: AiGenerationMode): Record<string, unknown> {\n const nodeSchema: Record<string, unknown> = {\n type: 'object',\n required: ['id', 'type'],\n properties: {\n id: { type: 'string' },\n type: { type: 'string' },\n props: { type: 'object' },\n styles: {\n type: 'object',\n properties: {\n base: { type: 'object' },\n tablet: { type: 'object' },\n mobile: { type: 'object' },\n states: { type: 'object' },\n },\n },\n children: {\n type: 'array',\n items: { $ref: '#' },\n },\n },\n };\n\n if (mode === 'full-page') {\n return {\n type: 'object',\n required: ['schema', 'version', 'document'],\n properties: {\n schema: { type: 'string', const: 'stora.page' },\n version: { type: 'string', const: '1.0.0' },\n metadata: {\n type: 'object',\n properties: {\n title: { type: 'string' },\n description: { type: 'string' },\n tags: { type: 'array', items: { type: 'string' } },\n category: { type: 'string' },\n },\n },\n document: nodeSchema,\n },\n };\n }\n\n return nodeSchema;\n}\n\n\n/**\n * Renders the component catalog as the compact reference block shared by every prompt.\n * Extracted from `buildSystemPrompt` so the agent prompt (STORA-530) reuses the exact\n * same catalog rendering instead of drifting into a second format.\n */\nexport function formatComponentCatalog(catalog: AiCompiledComponentSpec[]): string {\n return catalog\n .map((c) => {\n let desc = `- **${c.type}** (${c.category}): ${c.label}`;\n if (c.description) desc += ` - ${c.description}`;\n desc += ` | acceptsChildren: ${c.acceptsChildren}`;\n if (c.allowedChildren && c.allowedChildren.length > 0) {\n desc += ` | allowedChildren: [${c.allowedChildren.join(', ')}]`;\n }\n if (c.props && c.props.length > 0) {\n const propList = c.props\n .map((p) => {\n let pStr = `${p.name} (${p.type})`;\n if (p.options) pStr += `[${p.options.map(String).join('|')}]`;\n return pStr;\n })\n .join(', ');\n desc += ` | props: { ${propList} }`;\n }\n return desc;\n })\n .join('\\n');\n}\n\nexport interface BuildAgentSystemPromptOptions {\n catalog: AiCompiledComponentSpec[];\n document: PageDocument;\n selectedNodeId?: string;\n prefix?: string;\n stylePreference?: string;\n /** Extra host/product context appended verbatim. */\n additionalContext?: string;\n}\n\nconst AGENT_INSTRUCTIONS = `You are the KUBUILD page-editing agent. You edit an existing page by calling tools — you never output page JSON directly.\n\n### HOW YOU WORK\n1. The page outline below is your map. It shows every node's id, type and label, but not its props or styles.\n2. To see a node's actual props/styles, call read_node. To locate nodes by type or text, call find_nodes. Never guess a node id — every id you pass must come from the outline or from a tool result.\n3. Make the change with the smallest tool that expresses it, then stop and summarize what you changed, in the user's language.\n\n### SURGICAL EDIT RULE (the most important rule)\nChange only what the user asked for.\n- Changing text/label/href/src -> update_node_props on that one node.\n- Changing color/spacing/size/alignment -> update_node_styles on that one node.\n- Adding something new -> insert_component (a single element) or insert_section (a whole new section).\n- replace_node is a last resort, only when a node's children genuinely must be restructured. Never use it to change a prop or a style.\n- Never rebuild a section, and never touch nodes the user did not ask about. If an instruction is ambiguous about scope, edit the narrowest node that satisfies it and say so in your summary.\n\n### DESTRUCTIVE ACTIONS\ndelete_node and replace_node destroy user content. Only call them when the user asked unambiguously (e.g. \"hapus section harga\"). If the request is broad or vague (\"bersihkan halaman ini\", \"hapus yang tidak perlu\"), do not call them — ask the user which nodes to remove instead.\n\n### STYLING RULES\n- styles values are CSS primitives (strings/numbers). Use breakpoint ('base' | 'desktop' | 'tablet' | 'mobile') for normal styling and state (':hover', ':focus', ':active') for interactive states. Never nest a pseudo-class inside a breakpoint layer.\n- Only use component types that exist in the catalog below, and respect acceptsChildren/allowedChildren.\n- Never emit scripts, javascript: URIs, or event-handler attributes.\n\n### WHEN A TOOL FAILS\nA tool result with \"ok\": false means your input was wrong (unknown node id, invalid type, disallowed nesting). Read the error, fix your arguments, and retry — do not repeat the identical call, and do not give up silently.`;\n\n/**\n * System prompt for agent mode (STORA-530).\n *\n * Deliberately different from `buildSystemPrompt`: the agent does NOT emit document JSON.\n * It reads the page through tools and edits through tools, so the prompt's job is to\n * establish (a) the outline as the shared map, (b) the selection as the default target,\n * and (c) the surgical-edit discipline — the whole point of the feature is that asking to\n * recolor one button must not regenerate its section.\n *\n * The catalog goes before the volatile per-turn context so the stable prefix stays\n * prompt-cacheable across the steps of a run.\n */\nexport function buildAgentSystemPrompt(options: BuildAgentSystemPromptOptions): string {\n const { catalog, document, selectedNodeId, prefix, stylePreference, additionalContext } = options;\n\n const selection = selectedNodeId\n ? buildSelectionContext(document.document, selectedNodeId)\n : null;\n\n const sections: string[] = [];\n\n if (prefix) sections.push(prefix);\n\n sections.push(AGENT_INSTRUCTIONS);\n\n sections.push(\n `### REGISTERED COMPONENT CATALOG\\n${\n formatComponentCatalog(catalog) ||\n '(Standard core components: page, section, container, columns, heading, paragraph, text, button, input, textarea, select, image, video, icon, badge, code-block)'\n }`,\n );\n\n sections.push(`### CURRENT PAGE\\n${summarizeDocument(document, { focusNodeId: selectedNodeId })}`);\n\n if (selection) {\n sections.push(formatSelectionContext(selection));\n } else if (selectedNodeId) {\n sections.push(\n `### Selection\\nThe editor reported node \"${selectedNodeId}\" as selected, but it is not present in the current page. Ignore it and ask the user what to target.`,\n );\n } else {\n sections.push(\n '### Selection\\nNo component is selected on the canvas. If the user says \"this\", ask which component they mean instead of guessing.',\n );\n }\n\n if (stylePreference) {\n sections.push(\n `### Style Preference\\n\"${stylePreference}\" — follow this aesthetic for anything you create or restyle.`,\n );\n }\n\n if (additionalContext) {\n sections.push(`### Additional Context\\n${additionalContext}`);\n }\n\n return sections.join('\\n\\n');\n}\n","import {\n PageDocument,\n PageDocumentSchema,\n DocumentMetadata,\n DocumentMetadataSchema,\n Node,\n NodeSchema,\n CURRENT_SCHEMA_VERSION,\n SCHEMA_NAME,\n} from '@kubuild/schema';\nimport {\n validateDocument,\n validateDocumentSecurity,\n DocumentSecurityLimits,\n} from '@kubuild/core';\n\nexport function extractJsonFromResponse(raw: string): unknown {\n let cleaned = raw.trim();\n // Strip Markdown code blocks if present (```json ... ``` or ``` ...)\n if (cleaned.startsWith('```')) {\n const firstNewline = cleaned.indexOf('\\n');\n if (firstNewline !== -1) {\n cleaned = cleaned.slice(firstNewline + 1);\n }\n if (cleaned.endsWith('```')) {\n cleaned = cleaned.slice(0, cleaned.length - 3).trim();\n }\n }\n\n // Find the outermost JSON object bounds if there is extraneous text\n const firstBrace = cleaned.indexOf('{');\n const lastBrace = cleaned.lastIndexOf('}');\n if (firstBrace !== -1 && lastBrace !== -1 && lastBrace > firstBrace) {\n cleaned = cleaned.slice(firstBrace, lastBrace + 1);\n }\n\n try {\n return JSON.parse(cleaned);\n } catch (err: unknown) {\n const msg = err instanceof Error ? err.message : String(err);\n throw new Error(`Failed to parse AI response as JSON: ${msg}. Response was: ${raw.slice(0, 200)}...`);\n }\n}\n\nexport function normalizeStyles(rawStyles: unknown): Node['styles'] {\n if (!rawStyles || typeof rawStyles !== 'object' || Array.isArray(rawStyles)) {\n return undefined;\n }\n\n const raw = rawStyles as Record<string, unknown>;\n const result: Record<string, unknown> = {};\n const states: Record<string, Record<string, unknown>> = {};\n\n // Existing states\n if (raw.states && typeof raw.states === 'object' && !Array.isArray(raw.states)) {\n for (const [stateKey, stateVal] of Object.entries(raw.states as Record<string, unknown>)) {\n if (stateVal && typeof stateVal === 'object' && !Array.isArray(stateVal)) {\n states[stateKey] = { ...(stateVal as Record<string, unknown>) };\n }\n }\n }\n\n const knownBreakpoints = ['base', 'desktop', 'tablet', 'mobile'];\n const hasBreakpoint = Object.keys(raw).some((k) => knownBreakpoints.includes(k));\n\n if (!hasBreakpoint) {\n // If AI output flat CSS properties without 'base' wrapper\n const baseStyles: Record<string, unknown> = {};\n for (const [key, value] of Object.entries(raw)) {\n if (key === 'states') continue;\n if (key.startsWith(':') || key === 'hover' || key === 'focus' || key === 'active') {\n const stateKey = key.startsWith(':') ? key : `:${key}`;\n if (value && typeof value === 'object' && !Array.isArray(value)) {\n states[stateKey] = { ...(states[stateKey] || {}), ...(value as Record<string, unknown>) };\n }\n } else if (typeof value !== 'object' || value === null) {\n baseStyles[key] = value;\n }\n }\n if (Object.keys(baseStyles).length > 0) {\n result.base = baseStyles;\n }\n } else {\n for (const bp of knownBreakpoints) {\n const bpVal = raw[bp];\n if (bpVal && typeof bpVal === 'object' && !Array.isArray(bpVal)) {\n const cleanBp: Record<string, unknown> = {};\n for (const [key, value] of Object.entries(bpVal as Record<string, unknown>)) {\n if (key.startsWith(':') || key === 'hover' || key === 'focus' || key === 'active') {\n const stateKey = key.startsWith(':') ? key : `:${key}`;\n if (value && typeof value === 'object' && !Array.isArray(value)) {\n states[stateKey] = { ...(states[stateKey] || {}), ...(value as Record<string, unknown>) };\n }\n } else if (typeof value !== 'object' || value === null) {\n cleanBp[key] = value;\n }\n }\n if (Object.keys(cleanBp).length > 0) {\n result[bp] = cleanBp;\n }\n }\n }\n\n // Also extract any pseudo-classes at top level\n for (const [key, value] of Object.entries(raw)) {\n if (knownBreakpoints.includes(key) || key === 'states') continue;\n if (key.startsWith(':') || key === 'hover' || key === 'focus' || key === 'active') {\n const stateKey = key.startsWith(':') ? key : `:${key}`;\n if (value && typeof value === 'object' && !Array.isArray(value)) {\n states[stateKey] = { ...(states[stateKey] || {}), ...(value as Record<string, unknown>) };\n }\n }\n }\n }\n\n // Clean and sanitize states: each state can only have primitives\n const cleanStates: Record<string, Record<string, unknown>> = {};\n for (const [stateKey, stateDef] of Object.entries(states)) {\n const cleanDef: Record<string, unknown> = {};\n for (const [propKey, propVal] of Object.entries(stateDef)) {\n if (typeof propVal !== 'object' || propVal === null) {\n cleanDef[propKey] = propVal;\n }\n }\n if (Object.keys(cleanDef).length > 0) {\n cleanStates[stateKey] = cleanDef;\n }\n }\n\n if (Object.keys(cleanStates).length > 0) {\n result.states = cleanStates;\n }\n\n return Object.keys(result).length > 0 ? (result as Node['styles']) : undefined;\n}\n\nexport function normalizeNodeTree(\n node: unknown,\n usedIds: Set<string> = new Set(),\n depth = 0,\n): Node {\n if (!node || typeof node !== 'object') {\n throw new Error(`Invalid node at depth ${depth}: must be an object`);\n }\n\n const raw = node as Record<string, unknown>;\n const type = typeof raw.type === 'string' && raw.type.trim() ? raw.type.trim() : 'container';\n\n // Ensure deterministic, unique ID\n let id = typeof raw.id === 'string' && raw.id.trim() ? raw.id.trim() : '';\n if (!id || usedIds.has(id)) {\n let counter = 1;\n let candidate = `${type}-${counter}`;\n while (usedIds.has(candidate)) {\n counter++;\n candidate = `${type}-${counter}`;\n }\n id = candidate;\n }\n usedIds.add(id);\n\n // Normalize props\n const props =\n raw.props && typeof raw.props === 'object' && !Array.isArray(raw.props)\n ? { ...(raw.props as Record<string, unknown>) }\n : {};\n\n // Fix common LLM prop quirks:\n // e.g. heading level passed as string \"1\" instead of number 1\n if (type === 'heading' && typeof props.level === 'string') {\n const parsedLevel = parseInt(props.level, 10);\n if (!isNaN(parsedLevel) && parsedLevel >= 1 && parsedLevel <= 6) {\n props.level = parsedLevel;\n }\n }\n\n // Normalize styles\n const styles = normalizeStyles(raw.styles);\n\n // Normalize children recursively\n let children: Node[] | undefined = undefined;\n if (Array.isArray(raw.children)) {\n children = raw.children\n .filter((c) => c && typeof c === 'object')\n .map((c) => normalizeNodeTree(c, usedIds, depth + 1));\n }\n\n return {\n id,\n type,\n props: Object.keys(props).length > 0 ? props : undefined,\n styles,\n children,\n };\n}\n\nexport function normalizeAndValidatePageDocument(\n rawJson: unknown,\n securityLimits?: DocumentSecurityLimits,\n): PageDocument {\n if (!rawJson || typeof rawJson !== 'object') {\n throw new Error('AI output must be a JSON object');\n }\n\n const obj = rawJson as Record<string, unknown>;\n\n // Case 1: AI returned directly a page node instead of PageDocument\n let docObject: Record<string, unknown>;\n if (obj.type === 'page' && !obj.document) {\n docObject = {\n schema: SCHEMA_NAME,\n version: CURRENT_SCHEMA_VERSION,\n metadata: {\n title: (typeof obj.props === 'object' && obj.props !== null && (obj.props as Record<string, unknown>).title) || 'AI Generated Page',\n description: 'Generated by KUBUILD AI',\n },\n document: obj,\n };\n } else {\n docObject = {\n schema: SCHEMA_NAME,\n version: typeof obj.version === 'string' ? obj.version : CURRENT_SCHEMA_VERSION,\n metadata: typeof obj.metadata === 'object' && obj.metadata !== null\n ? obj.metadata\n : { title: 'AI Generated Page', description: 'Generated by KUBUILD AI' },\n document: obj.document || obj,\n };\n }\n\n // Normalize the node tree and ensure IDs\n const usedIds = new Set<string>();\n const normalizedRoot = normalizeNodeTree(docObject.document, usedIds);\n\n if (normalizedRoot.type !== 'page') {\n normalizedRoot.type = 'page';\n }\n\n const parsedMetadata = DocumentMetadataSchema.parse({\n title: 'AI Generated Page',\n description: 'Generated by KUBUILD AI',\n author: 'KUBUILD AI',\n tags: ['ai-generated'],\n category: 'general',\n version: '1.0.0',\n ...(typeof docObject.metadata === 'object' && docObject.metadata !== null\n ? (docObject.metadata as Record<string, unknown>)\n : {}),\n });\n\n const finalDocument: PageDocument = {\n schema: SCHEMA_NAME,\n version: CURRENT_SCHEMA_VERSION,\n metadata: parsedMetadata,\n document: normalizedRoot as PageDocument['document'],\n };\n\n // 1. Zod Schema parse\n const parsed = PageDocumentSchema.safeParse(finalDocument);\n if (!parsed.success) {\n const issues = parsed.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join('; ');\n throw new Error(`Document schema validation failed: ${issues}`);\n }\n\n // 2. Core document and security validation\n const validationResult = validateDocument(finalDocument, { securityLimits });\n if (!validationResult.valid) {\n const errorMsgs = validationResult.errors.map((e) => `${e.code}: ${e.message} (${e.path})`).join('; ');\n throw new Error(`Document validation failed: ${errorMsgs}`);\n }\n\n return parsed.data;\n}\n\nexport function normalizeAndValidateSectionNode(\n rawJson: unknown,\n securityLimits?: DocumentSecurityLimits,\n): Node {\n if (!rawJson || typeof rawJson !== 'object') {\n throw new Error('AI output must be a JSON object');\n }\n\n const usedIds = new Set<string>();\n const normalized = normalizeNodeTree(rawJson, usedIds);\n\n if (normalized.type !== 'section') {\n // If AI wrapped it or returned another root, enforce section\n normalized.type = 'section';\n }\n\n const parsed = NodeSchema.safeParse(normalized);\n if (!parsed.success) {\n const issues = parsed.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join('; ');\n throw new Error(`Section node schema validation failed: ${issues}`);\n }\n\n // Security check\n const secCheck = validateDocumentSecurity({ document: normalized }, securityLimits);\n if (!secCheck.safe) {\n const issues = secCheck.errors.map((e) => `${e.code}: ${e.message}`).join('; ');\n throw new Error(`Section security check failed: ${issues}`);\n }\n\n return parsed.data;\n}\n\nexport function normalizeAndValidateRefactoredNode(\n rawJson: unknown,\n originalNode: Node,\n securityLimits?: DocumentSecurityLimits,\n): Node {\n if (!rawJson || typeof rawJson !== 'object') {\n throw new Error('AI output must be a JSON object');\n }\n\n const usedIds = new Set<string>();\n const normalized = normalizeNodeTree(rawJson, usedIds);\n\n // Preserve original ID and type if AI changed them accidentally\n normalized.id = originalNode.id;\n normalized.type = originalNode.type;\n\n const parsed = NodeSchema.safeParse(normalized);\n if (!parsed.success) {\n const issues = parsed.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join('; ');\n throw new Error(`Refactored node schema validation failed: ${issues}`);\n }\n\n const secCheck = validateDocumentSecurity({ document: normalized }, securityLimits);\n if (!secCheck.safe) {\n const issues = secCheck.errors.map((e) => `${e.code}: ${e.message}`).join('; ');\n throw new Error(`Refactored node security check failed: ${issues}`);\n }\n\n return parsed.data;\n}\n"],"mappings":"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","names":[]}
@@ -1,14 +1,22 @@
1
1
  import type { PageDocument, Node } from '@kubuild/schema';
2
- import type { AiGeneratePageRequest, AiGenerateSectionRequest, AiRefactorNodeRequest, AiChatRequest, AiChatResponse, AiChatMessage, AiStreamCallbacks } from '../types';
2
+ import type { AiAgentRequest, AiAgentRunResult, AiGeneratePageRequest, AiGenerateSectionRequest, AiRefactorNodeRequest, AiChatRequest, AiChatResponse, AiChatMessage, AiStreamCallbacks } from '../types';
3
3
  export interface AiClientOptions {
4
4
  endpoint: string;
5
5
  headers?: Record<string, string> | (() => Promise<Record<string, string>> | Record<string, string>);
6
6
  fetch?: typeof fetch;
7
+ /**
8
+ * Forwarded to every request (STORA-530). Hosts whose AI endpoint authenticates with
9
+ * HttpOnly cookies rather than a bearer header need `'include'` here — cross-origin
10
+ * `fetch` omits cookies by default, so without it the proxy endpoint sees an
11
+ * unauthenticated request no matter what the browser has stored.
12
+ */
13
+ credentials?: RequestCredentials;
7
14
  }
8
15
  export declare class KubuildAiClient {
9
16
  private endpoint;
10
17
  private headers?;
11
18
  private fetchFn;
19
+ private credentials?;
12
20
  constructor(options: AiClientOptions);
13
21
  private resolveHeaders;
14
22
  private sendRequest;
@@ -45,6 +53,17 @@ export declare class KubuildAiClient {
45
53
  chatStream(params: AiChatRequest, callbacks?: Pick<AiStreamCallbacks, 'onChatChunk' | 'onChatComplete' | 'onError'>, options?: {
46
54
  signal?: AbortSignal;
47
55
  }): Promise<AiChatMessage>;
56
+ /**
57
+ * Runs an agent turn over SSE (STORA-530).
58
+ *
59
+ * Streams the agent's progress — each reasoning step, each tool call and its result —
60
+ * through `callbacks`, and resolves with the run's `AiAgentRunResult`. The resolved value
61
+ * carries the `ops` the editor replays; nothing is applied to any document by this call.
62
+ * Reuses the same `consumeSse` transport as `streamPage`/`chatStream`.
63
+ */
64
+ runAgent(params: AiAgentRequest, callbacks?: Pick<AiStreamCallbacks, 'onAgentStep' | 'onToolCall' | 'onToolResult' | 'onAgentComplete' | 'onError'>, options?: {
65
+ signal?: AbortSignal;
66
+ }): Promise<AiAgentRunResult>;
48
67
  generateSection(params: AiGenerateSectionRequest, options?: {
49
68
  signal?: AbortSignal;
50
69
  }): Promise<Node>;
@@ -1 +1 @@
1
- {"version":3,"file":"ai-client.d.ts","sourceRoot":"","sources":["../../src/client/ai-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,aAAa,EAEb,iBAAiB,EAElB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EACJ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtB,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAC,CAA6B;IAC7C,OAAO,CAAC,OAAO,CAAe;gBAElB,OAAO,EAAE,eAAe;YAStB,cAAc;YAQd,WAAW;IA6BzB;;OAEG;IACG,YAAY,CAChB,MAAM,EAAE,qBAAqB,EAC7B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,YAAY,CAAC;IAUxB;;;;;;;;;OASG;YACW,UAAU;IA0CxB;;;OAGG;IACG,UAAU,CACd,MAAM,EAAE,qBAAqB,EAC7B,SAAS,CAAC,EAAE,iBAAiB,EAC7B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,YAAY,CAAC;IAmDxB;;;;;OAKG;IACG,UAAU,CACd,MAAM,EAAE,aAAa,EACrB,SAAS,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,gBAAgB,GAAG,SAAS,CAAC,EACjF,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,aAAa,CAAC;IA+CnB,eAAe,CACnB,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,IAAI,CAAC;IAUV,YAAY,CAChB,MAAM,EAAE,qBAAqB,EAC7B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,IAAI,CAAC;IAUV,IAAI,CACR,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,cAAc,CAAC;CAS3B;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe,CAExE"}
1
+ {"version":3,"file":"ai-client.d.ts","sourceRoot":"","sources":["../../src/client/ai-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,aAAa,EAEb,iBAAiB,EAElB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EACJ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtB,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAC,CAA6B;IAC7C,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,WAAW,CAAC,CAAqB;gBAE7B,OAAO,EAAE,eAAe;YAUtB,cAAc;YAQd,WAAW;IA8BzB;;OAEG;IACG,YAAY,CAChB,MAAM,EAAE,qBAAqB,EAC7B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,YAAY,CAAC;IAUxB;;;;;;;;;OASG;YACW,UAAU;IA0CxB;;;OAGG;IACG,UAAU,CACd,MAAM,EAAE,qBAAqB,EAC7B,SAAS,CAAC,EAAE,iBAAiB,EAC7B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,YAAY,CAAC;IAoDxB;;;;;OAKG;IACG,UAAU,CACd,MAAM,EAAE,aAAa,EACrB,SAAS,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,gBAAgB,GAAG,SAAS,CAAC,EACjF,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,aAAa,CAAC;IAgDzB;;;;;;;OAOG;IACG,QAAQ,CACZ,MAAM,EAAE,cAAc,EACtB,SAAS,CAAC,EAAE,IAAI,CACd,iBAAiB,EACjB,aAAa,GAAG,YAAY,GAAG,cAAc,GAAG,iBAAiB,GAAG,SAAS,CAC9E,EACD,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,gBAAgB,CAAC;IAyDtB,eAAe,CACnB,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,IAAI,CAAC;IAUV,YAAY,CAChB,MAAM,EAAE,qBAAqB,EAC7B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,IAAI,CAAC;IAUV,IAAI,CACR,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,cAAc,CAAC;CAS3B;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe,CAExE"}
@@ -30,6 +30,7 @@ var KubuildAiClient = class {
30
30
  endpoint;
31
31
  headers;
32
32
  fetchFn;
33
+ credentials;
33
34
  constructor(options) {
34
35
  if (!options.endpoint) {
35
36
  throw new Error("KubuildAiClient requires an endpoint URL");
@@ -37,6 +38,7 @@ var KubuildAiClient = class {
37
38
  this.endpoint = options.endpoint;
38
39
  this.headers = options.headers;
39
40
  this.fetchFn = options.fetch || globalThis.fetch.bind(globalThis);
41
+ this.credentials = options.credentials;
40
42
  }
41
43
  async resolveHeaders() {
42
44
  if (!this.headers) return {};
@@ -54,6 +56,7 @@ var KubuildAiClient = class {
54
56
  ...dynamicHeaders
55
57
  },
56
58
  body: JSON.stringify(body),
59
+ credentials: this.credentials,
57
60
  signal
58
61
  });
59
62
  const json = await res.json();
@@ -138,6 +141,7 @@ var KubuildAiClient = class {
138
141
  stream: true,
139
142
  ...params
140
143
  }),
144
+ credentials: this.credentials,
141
145
  signal: options?.signal
142
146
  });
143
147
  if (!res.ok) {
@@ -188,6 +192,7 @@ var KubuildAiClient = class {
188
192
  stream: true,
189
193
  ...params
190
194
  }),
195
+ credentials: this.credentials,
191
196
  signal: options?.signal
192
197
  });
193
198
  if (!res.ok) {
@@ -215,6 +220,62 @@ var KubuildAiClient = class {
215
220
  }
216
221
  return finalMessage;
217
222
  }
223
+ /**
224
+ * Runs an agent turn over SSE (STORA-530).
225
+ *
226
+ * Streams the agent's progress — each reasoning step, each tool call and its result —
227
+ * through `callbacks`, and resolves with the run's `AiAgentRunResult`. The resolved value
228
+ * carries the `ops` the editor replays; nothing is applied to any document by this call.
229
+ * Reuses the same `consumeSse` transport as `streamPage`/`chatStream`.
230
+ */
231
+ async runAgent(params, callbacks, options) {
232
+ const dynamicHeaders = await this.resolveHeaders();
233
+ const res = await this.fetchFn(this.endpoint, {
234
+ method: "POST",
235
+ headers: {
236
+ "Content-Type": "application/json",
237
+ ...dynamicHeaders
238
+ },
239
+ body: JSON.stringify({
240
+ mode: "agent",
241
+ stream: true,
242
+ ...params
243
+ }),
244
+ credentials: this.credentials,
245
+ signal: options?.signal
246
+ });
247
+ if (!res.ok) {
248
+ const errText = await res.text().catch(() => "");
249
+ const err = new Error(`Agent run failed [${res.status} ${res.statusText}]: ${errText}`);
250
+ callbacks?.onError?.(err);
251
+ throw err;
252
+ }
253
+ let finalResult = null;
254
+ let streamError = null;
255
+ await this.consumeSse(res, (event) => {
256
+ if (event.type === "agent-step") {
257
+ callbacks?.onAgentStep?.(event.step, event.maxSteps);
258
+ } else if (event.type === "tool-call") {
259
+ callbacks?.onToolCall?.({ id: event.id, name: event.name, input: event.input });
260
+ } else if (event.type === "tool-result") {
261
+ callbacks?.onToolResult?.({
262
+ id: event.id,
263
+ name: event.name,
264
+ ok: event.ok,
265
+ summary: event.summary
266
+ });
267
+ } else if (event.type === "agent-complete") {
268
+ finalResult = event.result;
269
+ callbacks?.onAgentComplete?.(event.result);
270
+ } else if (event.type === "error") {
271
+ streamError = new Error(event.error.message || "Agent error");
272
+ streamError.code = event.error.code;
273
+ callbacks?.onError?.(streamError);
274
+ }
275
+ });
276
+ if (finalResult) return finalResult;
277
+ throw streamError ?? new Error("Agent stream ended without a result");
278
+ }
218
279
  async generateSection(params, options) {
219
280
  return this.sendRequest(
220
281
  {
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/client/index.ts","../../src/client/ai-client.ts"],"sourcesContent":["export * from './ai-client';\n","import type { PageDocument, Node } from '@kubuild/schema';\nimport type {\n AiGeneratePageRequest,\n AiGenerateSectionRequest,\n AiRefactorNodeRequest,\n AiChatRequest,\n AiChatResponse,\n AiChatMessage,\n AiGenerateResponse,\n AiStreamCallbacks,\n AiStreamEvent,\n} from '../types';\n\nexport interface AiClientOptions {\n endpoint: string;\n headers?:\n | Record<string, string>\n | (() => Promise<Record<string, string>> | Record<string, string>);\n fetch?: typeof fetch;\n}\n\nexport class KubuildAiClient {\n private endpoint: string;\n private headers?: AiClientOptions['headers'];\n private fetchFn: typeof fetch;\n\n constructor(options: AiClientOptions) {\n if (!options.endpoint) {\n throw new Error('KubuildAiClient requires an endpoint URL');\n }\n this.endpoint = options.endpoint;\n this.headers = options.headers;\n this.fetchFn = options.fetch || globalThis.fetch.bind(globalThis);\n }\n\n private async resolveHeaders(): Promise<Record<string, string>> {\n if (!this.headers) return {};\n if (typeof this.headers === 'function') {\n return await this.headers();\n }\n return this.headers;\n }\n\n private async sendRequest<T>(\n body: Record<string, unknown>,\n signal?: AbortSignal,\n ): Promise<T> {\n const dynamicHeaders = await this.resolveHeaders();\n\n const res = await this.fetchFn(this.endpoint, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n ...dynamicHeaders,\n },\n body: JSON.stringify(body),\n signal,\n });\n\n const json = (await res.json()) as AiGenerateResponse<T>;\n\n if (!res.ok || !json.success || !json.data) {\n const errMessage = json?.error?.message || `HTTP ${res.status}: ${res.statusText}`;\n const error = new Error(errMessage);\n (error as unknown as { code?: string; details?: unknown }).code = json?.error?.code;\n (error as unknown as { code?: string; details?: unknown }).details = json?.error?.details;\n throw error;\n }\n\n return json.data;\n }\n\n /**\n * Standard single-pass full page generator (non-streaming).\n */\n async generatePage(\n params: AiGeneratePageRequest,\n options?: { signal?: AbortSignal },\n ): Promise<PageDocument> {\n return this.sendRequest<PageDocument>(\n {\n mode: 'full-page',\n ...params,\n },\n options?.signal,\n );\n }\n\n /**\n * Low-level SSE frame consumer shared by every streaming method on this client\n * (`streamPage`, `chatStream`) — one transport implementation, reused rather than\n * duplicated per stream \"flavor\" (STORA-515).\n *\n * Reads `res.body`, decodes `data: <json>\\n\\n` frames into `AiStreamEvent`s, and\n * invokes `onEvent` for each one in arrival order. If `onEvent` throws (the\n * conventional way callers signal a fatal `error` event), the throw propagates out of\n * this method after the reader lock is released.\n */\n private async consumeSse(\n res: Response,\n onEvent: (event: AiStreamEvent) => void,\n ): Promise<void> {\n if (!res.body) {\n throw new Error('Response body is null, cannot stream');\n }\n\n const reader = res.body.getReader();\n const decoder = new TextDecoder();\n let buffer = '';\n\n try {\n while (true) {\n const { done, value } = await reader.read();\n if (done) break;\n\n buffer += decoder.decode(value, { stream: true });\n const parts = buffer.split('\\n\\n');\n buffer = parts.pop() || '';\n\n for (const part of parts) {\n const lines = part.split('\\n');\n for (const line of lines) {\n if (line.startsWith('data: ')) {\n let event: AiStreamEvent;\n try {\n event = JSON.parse(line.slice(6).trim()) as AiStreamEvent;\n } catch {\n // Ignore incomplete or non-JSON data frames\n continue;\n }\n onEvent(event);\n }\n }\n }\n }\n } finally {\n reader.releaseLock();\n }\n }\n\n /**\n * Progressive section streamer (SSE).\n * Calls callbacks on each event (status, metadata, section, complete).\n */\n async streamPage(\n params: AiGeneratePageRequest,\n callbacks?: AiStreamCallbacks,\n options?: { signal?: AbortSignal },\n ): Promise<PageDocument> {\n const dynamicHeaders = await this.resolveHeaders();\n\n const res = await this.fetchFn(this.endpoint, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n ...dynamicHeaders,\n },\n body: JSON.stringify({\n mode: 'full-page',\n stream: true,\n ...params,\n }),\n signal: options?.signal,\n });\n\n if (!res.ok) {\n const errText = await res.text().catch(() => '');\n const err = new Error(`Streaming failed [${res.status} ${res.statusText}]: ${errText}`);\n callbacks?.onError?.(err);\n throw err;\n }\n\n let finalDoc: PageDocument | null = null;\n\n await this.consumeSse(res, (event) => {\n if (event.type === 'status') {\n callbacks?.onStatus?.(event.message);\n } else if (event.type === 'metadata') {\n callbacks?.onMetadata?.(event.metadata, event.rootPageNode);\n } else if (event.type === 'section') {\n callbacks?.onSection?.(event.section, event.index, event.total);\n } else if (event.type === 'complete') {\n finalDoc = event.document;\n callbacks?.onComplete?.(event.document);\n } else if (event.type === 'error') {\n const err = new Error(event.error.message || 'Stream error');\n (err as unknown as { code?: string }).code = event.error.code;\n callbacks?.onError?.(err);\n throw err;\n }\n });\n\n if (!finalDoc) {\n throw new Error('Stream ended without receiving complete document');\n }\n\n return finalDoc;\n }\n\n /**\n * Token-level streaming chat (STORA-515). Calls `onChatChunk` for every partial chunk\n * as it arrives and resolves with the fully assembled assistant `AiChatMessage` once\n * the stream's terminal `chat-complete` event is received. Reuses the exact same SSE\n * transport as `streamPage` via `consumeSse` — no separate parsing path.\n */\n async chatStream(\n params: AiChatRequest,\n callbacks?: Pick<AiStreamCallbacks, 'onChatChunk' | 'onChatComplete' | 'onError'>,\n options?: { signal?: AbortSignal },\n ): Promise<AiChatMessage> {\n const dynamicHeaders = await this.resolveHeaders();\n\n const res = await this.fetchFn(this.endpoint, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n ...dynamicHeaders,\n },\n body: JSON.stringify({\n mode: 'chat',\n stream: true,\n ...params,\n }),\n signal: options?.signal,\n });\n\n if (!res.ok) {\n const errText = await res.text().catch(() => '');\n const err = new Error(`Chat streaming failed [${res.status} ${res.statusText}]: ${errText}`);\n callbacks?.onError?.(err);\n throw err;\n }\n\n let finalMessage: AiChatMessage | null = null;\n\n await this.consumeSse(res, (event) => {\n if (event.type === 'chat-chunk') {\n callbacks?.onChatChunk?.(event.delta, event.content);\n } else if (event.type === 'chat-complete') {\n finalMessage = event.message;\n callbacks?.onChatComplete?.(event.message);\n } else if (event.type === 'error') {\n const err = new Error(event.error.message || 'Stream error');\n (err as unknown as { code?: string }).code = event.error.code;\n callbacks?.onError?.(err);\n throw err;\n }\n });\n\n if (!finalMessage) {\n throw new Error('Chat stream ended without receiving a complete message');\n }\n\n return finalMessage;\n }\n\n async generateSection(\n params: AiGenerateSectionRequest,\n options?: { signal?: AbortSignal },\n ): Promise<Node> {\n return this.sendRequest<Node>(\n {\n mode: 'section',\n ...params,\n },\n options?.signal,\n );\n }\n\n async refactorNode(\n params: AiRefactorNodeRequest,\n options?: { signal?: AbortSignal },\n ): Promise<Node> {\n return this.sendRequest<Node>(\n {\n mode: 'refactor',\n ...params,\n },\n options?.signal,\n );\n }\n\n async chat(\n params: AiChatRequest,\n options?: { signal?: AbortSignal },\n ): Promise<AiChatResponse> {\n return this.sendRequest<AiChatResponse>(\n {\n mode: 'chat',\n ...params,\n },\n options?.signal,\n );\n }\n}\n\nexport function createAiClient(options: AiClientOptions): KubuildAiClient {\n return new KubuildAiClient(options);\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../../src/client/index.ts","../../src/client/ai-client.ts"],"sourcesContent":["export * from './ai-client';\n","import type { PageDocument, Node } from '@kubuild/schema';\nimport type {\n AiAgentRequest,\n AiAgentRunResult,\n AiGeneratePageRequest,\n AiGenerateSectionRequest,\n AiRefactorNodeRequest,\n AiChatRequest,\n AiChatResponse,\n AiChatMessage,\n AiGenerateResponse,\n AiStreamCallbacks,\n AiStreamEvent,\n} from '../types';\n\nexport interface AiClientOptions {\n endpoint: string;\n headers?:\n | Record<string, string>\n | (() => Promise<Record<string, string>> | Record<string, string>);\n fetch?: typeof fetch;\n /**\n * Forwarded to every request (STORA-530). Hosts whose AI endpoint authenticates with\n * HttpOnly cookies rather than a bearer header need `'include'` here — cross-origin\n * `fetch` omits cookies by default, so without it the proxy endpoint sees an\n * unauthenticated request no matter what the browser has stored.\n */\n credentials?: RequestCredentials;\n}\n\nexport class KubuildAiClient {\n private endpoint: string;\n private headers?: AiClientOptions['headers'];\n private fetchFn: typeof fetch;\n private credentials?: RequestCredentials;\n\n constructor(options: AiClientOptions) {\n if (!options.endpoint) {\n throw new Error('KubuildAiClient requires an endpoint URL');\n }\n this.endpoint = options.endpoint;\n this.headers = options.headers;\n this.fetchFn = options.fetch || globalThis.fetch.bind(globalThis);\n this.credentials = options.credentials;\n }\n\n private async resolveHeaders(): Promise<Record<string, string>> {\n if (!this.headers) return {};\n if (typeof this.headers === 'function') {\n return await this.headers();\n }\n return this.headers;\n }\n\n private async sendRequest<T>(\n body: Record<string, unknown>,\n signal?: AbortSignal,\n ): Promise<T> {\n const dynamicHeaders = await this.resolveHeaders();\n\n const res = await this.fetchFn(this.endpoint, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n ...dynamicHeaders,\n },\n body: JSON.stringify(body),\n credentials: this.credentials,\n signal,\n });\n\n const json = (await res.json()) as AiGenerateResponse<T>;\n\n if (!res.ok || !json.success || !json.data) {\n const errMessage = json?.error?.message || `HTTP ${res.status}: ${res.statusText}`;\n const error = new Error(errMessage);\n (error as unknown as { code?: string; details?: unknown }).code = json?.error?.code;\n (error as unknown as { code?: string; details?: unknown }).details = json?.error?.details;\n throw error;\n }\n\n return json.data;\n }\n\n /**\n * Standard single-pass full page generator (non-streaming).\n */\n async generatePage(\n params: AiGeneratePageRequest,\n options?: { signal?: AbortSignal },\n ): Promise<PageDocument> {\n return this.sendRequest<PageDocument>(\n {\n mode: 'full-page',\n ...params,\n },\n options?.signal,\n );\n }\n\n /**\n * Low-level SSE frame consumer shared by every streaming method on this client\n * (`streamPage`, `chatStream`) — one transport implementation, reused rather than\n * duplicated per stream \"flavor\" (STORA-515).\n *\n * Reads `res.body`, decodes `data: <json>\\n\\n` frames into `AiStreamEvent`s, and\n * invokes `onEvent` for each one in arrival order. If `onEvent` throws (the\n * conventional way callers signal a fatal `error` event), the throw propagates out of\n * this method after the reader lock is released.\n */\n private async consumeSse(\n res: Response,\n onEvent: (event: AiStreamEvent) => void,\n ): Promise<void> {\n if (!res.body) {\n throw new Error('Response body is null, cannot stream');\n }\n\n const reader = res.body.getReader();\n const decoder = new TextDecoder();\n let buffer = '';\n\n try {\n while (true) {\n const { done, value } = await reader.read();\n if (done) break;\n\n buffer += decoder.decode(value, { stream: true });\n const parts = buffer.split('\\n\\n');\n buffer = parts.pop() || '';\n\n for (const part of parts) {\n const lines = part.split('\\n');\n for (const line of lines) {\n if (line.startsWith('data: ')) {\n let event: AiStreamEvent;\n try {\n event = JSON.parse(line.slice(6).trim()) as AiStreamEvent;\n } catch {\n // Ignore incomplete or non-JSON data frames\n continue;\n }\n onEvent(event);\n }\n }\n }\n }\n } finally {\n reader.releaseLock();\n }\n }\n\n /**\n * Progressive section streamer (SSE).\n * Calls callbacks on each event (status, metadata, section, complete).\n */\n async streamPage(\n params: AiGeneratePageRequest,\n callbacks?: AiStreamCallbacks,\n options?: { signal?: AbortSignal },\n ): Promise<PageDocument> {\n const dynamicHeaders = await this.resolveHeaders();\n\n const res = await this.fetchFn(this.endpoint, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n ...dynamicHeaders,\n },\n body: JSON.stringify({\n mode: 'full-page',\n stream: true,\n ...params,\n }),\n credentials: this.credentials,\n signal: options?.signal,\n });\n\n if (!res.ok) {\n const errText = await res.text().catch(() => '');\n const err = new Error(`Streaming failed [${res.status} ${res.statusText}]: ${errText}`);\n callbacks?.onError?.(err);\n throw err;\n }\n\n let finalDoc: PageDocument | null = null;\n\n await this.consumeSse(res, (event) => {\n if (event.type === 'status') {\n callbacks?.onStatus?.(event.message);\n } else if (event.type === 'metadata') {\n callbacks?.onMetadata?.(event.metadata, event.rootPageNode);\n } else if (event.type === 'section') {\n callbacks?.onSection?.(event.section, event.index, event.total);\n } else if (event.type === 'complete') {\n finalDoc = event.document;\n callbacks?.onComplete?.(event.document);\n } else if (event.type === 'error') {\n const err = new Error(event.error.message || 'Stream error');\n (err as unknown as { code?: string }).code = event.error.code;\n callbacks?.onError?.(err);\n throw err;\n }\n });\n\n if (!finalDoc) {\n throw new Error('Stream ended without receiving complete document');\n }\n\n return finalDoc;\n }\n\n /**\n * Token-level streaming chat (STORA-515). Calls `onChatChunk` for every partial chunk\n * as it arrives and resolves with the fully assembled assistant `AiChatMessage` once\n * the stream's terminal `chat-complete` event is received. Reuses the exact same SSE\n * transport as `streamPage` via `consumeSse` — no separate parsing path.\n */\n async chatStream(\n params: AiChatRequest,\n callbacks?: Pick<AiStreamCallbacks, 'onChatChunk' | 'onChatComplete' | 'onError'>,\n options?: { signal?: AbortSignal },\n ): Promise<AiChatMessage> {\n const dynamicHeaders = await this.resolveHeaders();\n\n const res = await this.fetchFn(this.endpoint, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n ...dynamicHeaders,\n },\n body: JSON.stringify({\n mode: 'chat',\n stream: true,\n ...params,\n }),\n credentials: this.credentials,\n signal: options?.signal,\n });\n\n if (!res.ok) {\n const errText = await res.text().catch(() => '');\n const err = new Error(`Chat streaming failed [${res.status} ${res.statusText}]: ${errText}`);\n callbacks?.onError?.(err);\n throw err;\n }\n\n let finalMessage: AiChatMessage | null = null;\n\n await this.consumeSse(res, (event) => {\n if (event.type === 'chat-chunk') {\n callbacks?.onChatChunk?.(event.delta, event.content);\n } else if (event.type === 'chat-complete') {\n finalMessage = event.message;\n callbacks?.onChatComplete?.(event.message);\n } else if (event.type === 'error') {\n const err = new Error(event.error.message || 'Stream error');\n (err as unknown as { code?: string }).code = event.error.code;\n callbacks?.onError?.(err);\n throw err;\n }\n });\n\n if (!finalMessage) {\n throw new Error('Chat stream ended without receiving a complete message');\n }\n\n return finalMessage;\n }\n\n /**\n * Runs an agent turn over SSE (STORA-530).\n *\n * Streams the agent's progress — each reasoning step, each tool call and its result —\n * through `callbacks`, and resolves with the run's `AiAgentRunResult`. The resolved value\n * carries the `ops` the editor replays; nothing is applied to any document by this call.\n * Reuses the same `consumeSse` transport as `streamPage`/`chatStream`.\n */\n async runAgent(\n params: AiAgentRequest,\n callbacks?: Pick<\n AiStreamCallbacks,\n 'onAgentStep' | 'onToolCall' | 'onToolResult' | 'onAgentComplete' | 'onError'\n >,\n options?: { signal?: AbortSignal },\n ): Promise<AiAgentRunResult> {\n const dynamicHeaders = await this.resolveHeaders();\n\n const res = await this.fetchFn(this.endpoint, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n ...dynamicHeaders,\n },\n body: JSON.stringify({\n mode: 'agent',\n stream: true,\n ...params,\n }),\n credentials: this.credentials,\n signal: options?.signal,\n });\n\n if (!res.ok) {\n const errText = await res.text().catch(() => '');\n const err = new Error(`Agent run failed [${res.status} ${res.statusText}]: ${errText}`);\n callbacks?.onError?.(err);\n throw err;\n }\n\n let finalResult: AiAgentRunResult | null = null;\n let streamError: Error | null = null;\n\n await this.consumeSse(res, (event) => {\n if (event.type === 'agent-step') {\n callbacks?.onAgentStep?.(event.step, event.maxSteps);\n } else if (event.type === 'tool-call') {\n callbacks?.onToolCall?.({ id: event.id, name: event.name, input: event.input });\n } else if (event.type === 'tool-result') {\n callbacks?.onToolResult?.({\n id: event.id,\n name: event.name,\n ok: event.ok,\n summary: event.summary,\n });\n } else if (event.type === 'agent-complete') {\n finalResult = event.result;\n callbacks?.onAgentComplete?.(event.result);\n } else if (event.type === 'error') {\n // The agent emits `agent-complete` before `error`, so ops produced before a\n // mid-run failure survive. Record the error instead of throwing out of the SSE\n // reader, and let the terminal result (if any) decide what the caller sees.\n streamError = new Error(event.error.message || 'Agent error');\n (streamError as unknown as { code?: string }).code = event.error.code;\n callbacks?.onError?.(streamError);\n }\n });\n\n if (finalResult) return finalResult;\n throw streamError ?? new Error('Agent stream ended without a result');\n }\n\n async generateSection(\n params: AiGenerateSectionRequest,\n options?: { signal?: AbortSignal },\n ): Promise<Node> {\n return this.sendRequest<Node>(\n {\n mode: 'section',\n ...params,\n },\n options?.signal,\n );\n }\n\n async refactorNode(\n params: AiRefactorNodeRequest,\n options?: { signal?: AbortSignal },\n ): Promise<Node> {\n return this.sendRequest<Node>(\n {\n mode: 'refactor',\n ...params,\n },\n options?.signal,\n );\n }\n\n async chat(\n params: AiChatRequest,\n options?: { signal?: AbortSignal },\n ): Promise<AiChatResponse> {\n return this.sendRequest<AiChatResponse>(\n {\n mode: 'chat',\n ...params,\n },\n options?.signal,\n );\n }\n}\n\nexport function createAiClient(options: AiClientOptions): KubuildAiClient {\n return new KubuildAiClient(options);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC8BO,IAAM,kBAAN,MAAsB;AAAA,EACnB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAER,YAAY,SAA0B;AACpC,QAAI,CAAC,QAAQ,UAAU;AACrB,YAAM,IAAI,MAAM,0CAA0C;AAAA,IAC5D;AACA,SAAK,WAAW,QAAQ;AACxB,SAAK,UAAU,QAAQ;AACvB,SAAK,UAAU,QAAQ,SAAS,WAAW,MAAM,KAAK,UAAU;AAChE,SAAK,cAAc,QAAQ;AAAA,EAC7B;AAAA,EAEA,MAAc,iBAAkD;AAC9D,QAAI,CAAC,KAAK,QAAS,QAAO,CAAC;AAC3B,QAAI,OAAO,KAAK,YAAY,YAAY;AACtC,aAAO,MAAM,KAAK,QAAQ;AAAA,IAC5B;AACA,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAc,YACZ,MACA,QACY;AACZ,UAAM,iBAAiB,MAAM,KAAK,eAAe;AAEjD,UAAM,MAAM,MAAM,KAAK,QAAQ,KAAK,UAAU;AAAA,MAC5C,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,GAAG;AAAA,MACL;AAAA,MACA,MAAM,KAAK,UAAU,IAAI;AAAA,MACzB,aAAa,KAAK;AAAA,MAClB;AAAA,IACF,CAAC;AAED,UAAM,OAAQ,MAAM,IAAI,KAAK;AAE7B,QAAI,CAAC,IAAI,MAAM,CAAC,KAAK,WAAW,CAAC,KAAK,MAAM;AAC1C,YAAM,aAAa,MAAM,OAAO,WAAW,QAAQ,IAAI,MAAM,KAAK,IAAI,UAAU;AAChF,YAAM,QAAQ,IAAI,MAAM,UAAU;AAClC,MAAC,MAA0D,OAAO,MAAM,OAAO;AAC/E,MAAC,MAA0D,UAAU,MAAM,OAAO;AAClF,YAAM;AAAA,IACR;AAEA,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,aACJ,QACA,SACuB;AACvB,WAAO,KAAK;AAAA,MACV;AAAA,QACE,MAAM;AAAA,QACN,GAAG;AAAA,MACL;AAAA,MACA,SAAS;AAAA,IACX;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAc,WACZ,KACA,SACe;AACf,QAAI,CAAC,IAAI,MAAM;AACb,YAAM,IAAI,MAAM,sCAAsC;AAAA,IACxD;AAEA,UAAM,SAAS,IAAI,KAAK,UAAU;AAClC,UAAM,UAAU,IAAI,YAAY;AAChC,QAAI,SAAS;AAEb,QAAI;AACF,aAAO,MAAM;AACX,cAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,KAAK;AAC1C,YAAI,KAAM;AAEV,kBAAU,QAAQ,OAAO,OAAO,EAAE,QAAQ,KAAK,CAAC;AAChD,cAAM,QAAQ,OAAO,MAAM,MAAM;AACjC,iBAAS,MAAM,IAAI,KAAK;AAExB,mBAAW,QAAQ,OAAO;AACxB,gBAAM,QAAQ,KAAK,MAAM,IAAI;AAC7B,qBAAW,QAAQ,OAAO;AACxB,gBAAI,KAAK,WAAW,QAAQ,GAAG;AAC7B,kBAAI;AACJ,kBAAI;AACF,wBAAQ,KAAK,MAAM,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC;AAAA,cACzC,QAAQ;AAEN;AAAA,cACF;AACA,sBAAQ,KAAK;AAAA,YACf;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF,UAAE;AACA,aAAO,YAAY;AAAA,IACrB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,WACJ,QACA,WACA,SACuB;AACvB,UAAM,iBAAiB,MAAM,KAAK,eAAe;AAEjD,UAAM,MAAM,MAAM,KAAK,QAAQ,KAAK,UAAU;AAAA,MAC5C,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,GAAG;AAAA,MACL;AAAA,MACA,MAAM,KAAK,UAAU;AAAA,QACnB,MAAM;AAAA,QACN,QAAQ;AAAA,QACR,GAAG;AAAA,MACL,CAAC;AAAA,MACD,aAAa,KAAK;AAAA,MAClB,QAAQ,SAAS;AAAA,IACnB,CAAC;AAED,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,UAAU,MAAM,IAAI,KAAK,EAAE,MAAM,MAAM,EAAE;AAC/C,YAAM,MAAM,IAAI,MAAM,qBAAqB,IAAI,MAAM,IAAI,IAAI,UAAU,MAAM,OAAO,EAAE;AACtF,iBAAW,UAAU,GAAG;AACxB,YAAM;AAAA,IACR;AAEA,QAAI,WAAgC;AAEpC,UAAM,KAAK,WAAW,KAAK,CAAC,UAAU;AACpC,UAAI,MAAM,SAAS,UAAU;AAC3B,mBAAW,WAAW,MAAM,OAAO;AAAA,MACrC,WAAW,MAAM,SAAS,YAAY;AACpC,mBAAW,aAAa,MAAM,UAAU,MAAM,YAAY;AAAA,MAC5D,WAAW,MAAM,SAAS,WAAW;AACnC,mBAAW,YAAY,MAAM,SAAS,MAAM,OAAO,MAAM,KAAK;AAAA,MAChE,WAAW,MAAM,SAAS,YAAY;AACpC,mBAAW,MAAM;AACjB,mBAAW,aAAa,MAAM,QAAQ;AAAA,MACxC,WAAW,MAAM,SAAS,SAAS;AACjC,cAAM,MAAM,IAAI,MAAM,MAAM,MAAM,WAAW,cAAc;AAC3D,QAAC,IAAqC,OAAO,MAAM,MAAM;AACzD,mBAAW,UAAU,GAAG;AACxB,cAAM;AAAA,MACR;AAAA,IACF,CAAC;AAED,QAAI,CAAC,UAAU;AACb,YAAM,IAAI,MAAM,kDAAkD;AAAA,IACpE;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,WACJ,QACA,WACA,SACwB;AACxB,UAAM,iBAAiB,MAAM,KAAK,eAAe;AAEjD,UAAM,MAAM,MAAM,KAAK,QAAQ,KAAK,UAAU;AAAA,MAC5C,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,GAAG;AAAA,MACL;AAAA,MACA,MAAM,KAAK,UAAU;AAAA,QACnB,MAAM;AAAA,QACN,QAAQ;AAAA,QACR,GAAG;AAAA,MACL,CAAC;AAAA,MACD,aAAa,KAAK;AAAA,MAClB,QAAQ,SAAS;AAAA,IACnB,CAAC;AAED,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,UAAU,MAAM,IAAI,KAAK,EAAE,MAAM,MAAM,EAAE;AAC/C,YAAM,MAAM,IAAI,MAAM,0BAA0B,IAAI,MAAM,IAAI,IAAI,UAAU,MAAM,OAAO,EAAE;AAC3F,iBAAW,UAAU,GAAG;AACxB,YAAM;AAAA,IACR;AAEA,QAAI,eAAqC;AAEzC,UAAM,KAAK,WAAW,KAAK,CAAC,UAAU;AACpC,UAAI,MAAM,SAAS,cAAc;AAC/B,mBAAW,cAAc,MAAM,OAAO,MAAM,OAAO;AAAA,MACrD,WAAW,MAAM,SAAS,iBAAiB;AACzC,uBAAe,MAAM;AACrB,mBAAW,iBAAiB,MAAM,OAAO;AAAA,MAC3C,WAAW,MAAM,SAAS,SAAS;AACjC,cAAM,MAAM,IAAI,MAAM,MAAM,MAAM,WAAW,cAAc;AAC3D,QAAC,IAAqC,OAAO,MAAM,MAAM;AACzD,mBAAW,UAAU,GAAG;AACxB,cAAM;AAAA,MACR;AAAA,IACF,CAAC;AAED,QAAI,CAAC,cAAc;AACjB,YAAM,IAAI,MAAM,wDAAwD;AAAA,IAC1E;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,SACJ,QACA,WAIA,SAC2B;AAC3B,UAAM,iBAAiB,MAAM,KAAK,eAAe;AAEjD,UAAM,MAAM,MAAM,KAAK,QAAQ,KAAK,UAAU;AAAA,MAC5C,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,GAAG;AAAA,MACL;AAAA,MACA,MAAM,KAAK,UAAU;AAAA,QACnB,MAAM;AAAA,QACN,QAAQ;AAAA,QACR,GAAG;AAAA,MACL,CAAC;AAAA,MACD,aAAa,KAAK;AAAA,MAClB,QAAQ,SAAS;AAAA,IACnB,CAAC;AAED,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,UAAU,MAAM,IAAI,KAAK,EAAE,MAAM,MAAM,EAAE;AAC/C,YAAM,MAAM,IAAI,MAAM,qBAAqB,IAAI,MAAM,IAAI,IAAI,UAAU,MAAM,OAAO,EAAE;AACtF,iBAAW,UAAU,GAAG;AACxB,YAAM;AAAA,IACR;AAEA,QAAI,cAAuC;AAC3C,QAAI,cAA4B;AAEhC,UAAM,KAAK,WAAW,KAAK,CAAC,UAAU;AACpC,UAAI,MAAM,SAAS,cAAc;AAC/B,mBAAW,cAAc,MAAM,MAAM,MAAM,QAAQ;AAAA,MACrD,WAAW,MAAM,SAAS,aAAa;AACrC,mBAAW,aAAa,EAAE,IAAI,MAAM,IAAI,MAAM,MAAM,MAAM,OAAO,MAAM,MAAM,CAAC;AAAA,MAChF,WAAW,MAAM,SAAS,eAAe;AACvC,mBAAW,eAAe;AAAA,UACxB,IAAI,MAAM;AAAA,UACV,MAAM,MAAM;AAAA,UACZ,IAAI,MAAM;AAAA,UACV,SAAS,MAAM;AAAA,QACjB,CAAC;AAAA,MACH,WAAW,MAAM,SAAS,kBAAkB;AAC1C,sBAAc,MAAM;AACpB,mBAAW,kBAAkB,MAAM,MAAM;AAAA,MAC3C,WAAW,MAAM,SAAS,SAAS;AAIjC,sBAAc,IAAI,MAAM,MAAM,MAAM,WAAW,aAAa;AAC5D,QAAC,YAA6C,OAAO,MAAM,MAAM;AACjE,mBAAW,UAAU,WAAW;AAAA,MAClC;AAAA,IACF,CAAC;AAED,QAAI,YAAa,QAAO;AACxB,UAAM,eAAe,IAAI,MAAM,qCAAqC;AAAA,EACtE;AAAA,EAEA,MAAM,gBACJ,QACA,SACe;AACf,WAAO,KAAK;AAAA,MACV;AAAA,QACE,MAAM;AAAA,QACN,GAAG;AAAA,MACL;AAAA,MACA,SAAS;AAAA,IACX;AAAA,EACF;AAAA,EAEA,MAAM,aACJ,QACA,SACe;AACf,WAAO,KAAK;AAAA,MACV;AAAA,QACE,MAAM;AAAA,QACN,GAAG;AAAA,MACL;AAAA,MACA,SAAS;AAAA,IACX;AAAA,EACF;AAAA,EAEA,MAAM,KACJ,QACA,SACyB;AACzB,WAAO,KAAK;AAAA,MACV;AAAA,QACE,MAAM;AAAA,QACN,GAAG;AAAA,MACL;AAAA,MACA,SAAS;AAAA,IACX;AAAA,EACF;AACF;AAEO,SAAS,eAAe,SAA2C;AACxE,SAAO,IAAI,gBAAgB,OAAO;AACpC;","names":[]}
@@ -1,7 +1,7 @@
1
1
  import {
2
2
  KubuildAiClient,
3
3
  createAiClient
4
- } from "../chunk-JY4NHD3Q.js";
4
+ } from "../chunk-T72YWBJS.js";
5
5
  export {
6
6
  KubuildAiClient,
7
7
  createAiClient