@kubuild/ai 0.8.0 → 0.8.2

package/dist/types.d.cts

@@ -0,0 +1,463 @@
+import type { Node, PageDocument, DocumentMetadata } from '@kubuild/schema';
+import type { DocumentSecurityLimits } from '@kubuild/core';
+export type AiGenerationMode = 'full-page' | 'section' | 'refactor' | 'chat' | 'agent' | 'plan';
+/** Plain text content block. */
+export interface AiTextBlock {
+    type: 'text';
+    text: string;
+}
+/**
+ * A tool invocation requested by the model (STORA-530). Provider-agnostic shape: the
+ * OpenAI adapter maps this to `assistant.tool_calls`, Anthropic to a `tool_use` block.
+ */
+export interface AiToolUseBlock {
+    type: 'tool_use';
+    /** Provider-issued call id — echoed back on the matching `tool_result`. */
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+/** The host's answer to an `AiToolUseBlock`, fed back into the next model turn. */
+export interface AiToolResultBlock {
+    type: 'tool_result';
+    /** Must match the `id` of the `tool_use` block being answered. */
+    toolUseId: string;
+    /** Serialized result payload (JSON string for structured results). */
+    content: string;
+    /** True when the tool failed — the model is expected to self-correct and retry. */
+    isError?: boolean;
+}
+export type AiContentBlock = AiTextBlock | AiToolUseBlock | AiToolResultBlock;
+export interface AiChatMessage {
+    role: 'user' | 'assistant' | 'system';
+    /**
+     * Either a plain string (every pre-STORA-530 call site) or a list of content blocks
+     * carrying tool calls/results. Adapters that don't support tool calling only ever see
+     * the string form, since `tools` is never passed to them.
+     */
+    content: string | AiContentBlock[];
+    timestamp?: number;
+}
+export interface AiChatRequest {
+    messages: AiChatMessage[];
+    currentDocument?: PageDocument;
+    selectedNodeId?: string;
+    /**
+     * Extra host/user instructions, appended AFTER the built-in system prompt (never
+     * replacing it — the base prompt carries the output-format, safety and tool rules).
+     * Over HTTP, `createAiHandler` caps its length and can disable it entirely
+     * (`allowClientInstructions` / `maxClientInstructionsLength`).
+     */
+    instructions?: string;
+    /** @deprecated Alias of `instructions` — appended, never a replacement for the base prompt. */
+    systemPrompt?: string;
+}
+export interface AiChatResponse {
+    message: AiChatMessage;
+}
+export interface PlannedSection {
+    type: string;
+    title: string;
+    prompt: string;
+}
+export interface PagePlan {
+    title?: string;
+    description?: string;
+    pageStyles?: Node['styles'];
+    sections?: PlannedSection[];
+    /**
+     * `true` when the model's plan could not be parsed and the engine substituted its
+     * generic default plan (hero/features/testimonials/cta/footer). The plan is still
+     * usable, but hosts should tell the user it is not tailored to their prompt.
+     */
+    usedFallback?: boolean;
+}
+export interface AiPlanPageRequest {
+    prompt: string;
+    stylePreference?: string;
+    tone?: string;
+    locale?: string;
+    sectionCount?: number | {
+        min?: number;
+        max?: number;
+    };
+    conversationHistory?: AiChatMessage[];
+    /**
+     * Extra host/user instructions, appended AFTER the built-in system prompt (never
+     * replacing it — the base prompt carries the output-format, safety and tool rules).
+     * Over HTTP, `createAiHandler` caps its length and can disable it entirely
+     * (`allowClientInstructions` / `maxClientInstructionsLength`).
+     */
+    instructions?: string;
+}
+export interface AiGeneratePageRequest {
+    prompt: string;
+    stylePreference?: string;
+    tone?: string;
+    locale?: string;
+    metadata?: Partial<DocumentMetadata>;
+    stream?: boolean;
+    /** Prior conversation history from chat mode so generator keeps full context. */
+    conversationHistory?: AiChatMessage[];
+    /** Desired number of sections or range. */
+    sectionCount?: number | {
+        min?: number;
+        max?: number;
+    };
+    /** Pre-confirmed plan to generate directly without re-planning. */
+    plan?: PagePlan;
+    /**
+     * Extra host/user instructions, appended AFTER the built-in system prompt (never
+     * replacing it — the base prompt carries the output-format, safety and tool rules).
+     * Over HTTP, `createAiHandler` caps its length and can disable it entirely
+     * (`allowClientInstructions` / `maxClientInstructionsLength`).
+     */
+    instructions?: string;
+}
+export interface AiGenerateSectionRequest {
+    prompt: string;
+    stylePreference?: string;
+    targetSectionType?: string;
+    parentContext?: string;
+    /**
+     * Extra host/user instructions, appended AFTER the built-in system prompt (never
+     * replacing it — the base prompt carries the output-format, safety and tool rules).
+     * Over HTTP, `createAiHandler` caps its length and can disable it entirely
+     * (`allowClientInstructions` / `maxClientInstructionsLength`).
+     */
+    instructions?: string;
+}
+export interface AiRefactorNodeRequest {
+    node: Node;
+    instruction: string;
+    stylePreference?: string;
+    /**
+     * Extra host/user instructions, appended AFTER the built-in system prompt (never
+     * replacing it — the base prompt carries the output-format, safety and tool rules).
+     * Over HTTP, `createAiHandler` caps its length and can disable it entirely
+     * (`allowClientInstructions` / `maxClientInstructionsLength`).
+     */
+    instructions?: string;
+}
+export type AiStreamEvent = {
+    type: 'status';
+    message: string;
+} | {
+    type: 'metadata';
+    metadata: DocumentMetadata;
+    rootPageNode: Node;
+} | {
+    type: 'section';
+    index: number;
+    total: number;
+    section: Node;
+} | {
+    type: 'complete';
+    document: PageDocument;
+}
+/**
+ * Token-level chat streaming (STORA-515). `delta` is the newly-arrived text fragment,
+ * `content` is the full accumulated assistant message so far — consumers that only
+ * care about the running text (e.g. rendering a live-updating bubble) can just use
+ * `content` and ignore `delta`.
+ */
+ | {
+    type: 'chat-chunk';
+    delta: string;
+    content: string;
+}
+/** Terminal event for a chat stream — mirrors `complete` for `streamPage`. */
+ | {
+    type: 'chat-complete';
+    message: AiChatMessage;
+}
+/** Agent mode (STORA-530): a new reasoning step has begun. */
+ | {
+    type: 'agent-step';
+    step: number;
+    maxSteps: number;
+}
+/** Agent mode: the model asked to run a tool. */
+ | {
+    type: 'tool-call';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+/** Agent mode: the tool finished (or failed — the model then self-corrects). */
+ | {
+    type: 'tool-result';
+    id: string;
+    name: string;
+    ok: boolean;
+    summary: string;
+}
+/** Agent mode terminal event: the patch the client replays through the store. */
+ | {
+    type: 'agent-complete';
+    result: AiAgentRunResult;
+} | {
+    type: 'error';
+    error: {
+        code: string;
+        message: string;
+    };
+};
+export interface AiStreamCallbacks {
+    onStatus?: (message: string) => void;
+    onMetadata?: (metadata: DocumentMetadata, rootPage: Node) => void;
+    onSection?: (section: Node, index: number, total: number) => void;
+    onComplete?: (document: PageDocument) => void;
+    /** Fired for every partial chunk of a streaming chat response (STORA-515/516). */
+    onChatChunk?: (delta: string, content: string) => void;
+    /** Fired once, when a streaming chat response has finished assembling. */
+    onChatComplete?: (message: AiChatMessage) => void;
+    /** Agent mode (STORA-530). */
+    onAgentStep?: (step: number, maxSteps: number) => void;
+    onToolCall?: (call: {
+        id: string;
+        name: string;
+        input: Record<string, unknown>;
+    }) => void;
+    onToolResult?: (result: {
+        id: string;
+        name: string;
+        ok: boolean;
+        summary: string;
+    }) => void;
+    onAgentComplete?: (result: AiAgentRunResult) => void;
+    onError?: (error: Error) => void;
+}
+export interface AiErrorDetail {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+export interface AiGenerateResponse<T = PageDocument | Node> {
+    success: boolean;
+    data?: T;
+    error?: AiErrorDetail;
+    rawModelResponse?: string;
+    usage?: {
+        promptTokens?: number;
+        completionTokens?: number;
+    };
+    /**
+     * `true` when `success` is true but the engine had to substitute a default result
+     * (currently: `planPage` when the model's plan JSON could not be parsed).
+     */
+    usedFallback?: boolean;
+    /** Non-fatal diagnostics for a successful response (e.g. `PLAN_FALLBACK`). */
+    warnings?: AiErrorDetail[];
+}
+export interface AiCompiledComponentProp {
+    name: string;
+    type: string;
+    defaultValue?: unknown;
+    options?: unknown[];
+    description?: string;
+}
+export interface AiCompiledComponentSpec {
+    type: string;
+    label: string;
+    category: string;
+    description?: string;
+    acceptsChildren: boolean;
+    allowedChildren?: string[];
+    disallowedParents?: string[];
+    defaultProps?: Record<string, unknown>;
+    props?: AiCompiledComponentProp[];
+}
+/**
+ * A tool the model may call (STORA-530). `inputSchema` is a JSON Schema object describing
+ * the tool's arguments — passed through verbatim to the provider (OpenAI
+ * `function.parameters`, Anthropic `input_schema`, Gemini `parameters`).
+ */
+export interface AiToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+export type AiToolChoice = 'auto' | 'none' | 'required' | {
+    name: string;
+};
+export interface AiProviderGenerateParams {
+    systemPrompt: string;
+    userPrompt: string;
+    messages?: AiChatMessage[];
+    jsonSchema?: Record<string, unknown>;
+    signal?: AbortSignal;
+    /**
+     * Tools the model may call this turn. Adapters that don't implement tool calling ignore
+     * this field entirely, so passing it can never break an older adapter — but the agent
+     * loop refuses to run against such an adapter (see `KubuildAiAgent`).
+     */
+    tools?: AiToolDefinition[];
+    toolChoice?: AiToolChoice;
+    /** Overrides the adapter's configured sampling temperature for this call. */
+    temperature?: number;
+}
+/** Why the model stopped generating — drives the agent loop's continue/stop decision. */
+export type AiStopReason = 'stop' | 'tool_calls' | 'length' | 'content_filter' | 'unknown';
+export interface AiProviderGenerateResult {
+    text: string;
+    usage?: {
+        promptTokens?: number;
+        completionTokens?: number;
+    };
+    /**
+     * Tool invocations requested by the model. Non-empty only when `params.tools` was given
+     * and the adapter supports tool calling.
+     */
+    toolCalls?: AiToolUseBlock[];
+    stopReason?: AiStopReason;
+}
+export interface AiProviderAdapter {
+    readonly name: string;
+    /**
+     * Whether this adapter forwards `params.tools` to its provider and parses tool calls
+     * back out (STORA-530). Adapters predating tool calling simply omit it, which reads as
+     * `false` — `KubuildAiAgent` refuses to start rather than silently running a tool-less
+     * loop that can never edit anything.
+     */
+    readonly supportsTools?: boolean;
+    generate(params: AiProviderGenerateParams): Promise<AiProviderGenerateResult>;
+    /**
+     * Optional token-level streaming variant (STORA-515). Adapters whose provider API
+     * supports incremental streaming (OpenAI, Anthropic, Gemini) should implement this as
+     * an async generator that `yield`s each text delta as it arrives over the wire, and
+     * `return`s the final `AiProviderGenerateResult` (full text + usage, mirroring
+     * `generate`) once the stream ends.
+     *
+     * Adapters that omit this are treated by `KubuildAiEngine` as non-streaming-capable:
+     * the engine falls back to a single `generate()` call and emits the whole response as
+     * one chunk through the same streaming interface, so callers never need to branch on
+     * adapter capability themselves.
+     */
+    generateStream?(params: AiProviderGenerateParams): AsyncGenerator<string, AiProviderGenerateResult, void>;
+}
+export interface ComponentDefinitionLike {
+    type: string;
+    label?: string;
+    category?: string;
+    description?: string;
+    acceptsChildren?: boolean;
+    allowedChildren?: string[];
+    disallowedParents?: string[];
+    defaultProps?: Record<string, unknown>;
+    propFields?: Array<{
+        name: string;
+        label?: string;
+        type?: string;
+        defaultValue?: unknown;
+        options?: Array<{
+            label: string;
+            value: unknown;
+        }>;
+        description?: string;
+    }>;
+}
+export interface ComponentRegistryLike {
+    list(): ComponentDefinitionLike[];
+    get?(type: string): ComponentDefinitionLike | undefined;
+    has?(type: string): boolean;
+}
+export interface KubuildAiEngineOptions {
+    registry?: ComponentRegistryLike;
+    adapter: AiProviderAdapter;
+    securityLimits?: DocumentSecurityLimits;
+    systemPromptPrefix?: string;
+    /** Agent loop step ceiling (STORA-530). Default: 8. */
+    maxAgentSteps?: number;
+    debug?: boolean;
+    logger?: (level: 'info' | 'warn' | 'error' | 'debug', message: string, meta?: unknown) => void;
+}
+/**
+ * A single, surgical document mutation produced by an agent tool call. Deliberately
+ * mirrors the editor store's existing action surface (`updateNodeProps`,
+ * `updateNodeStyle`, `insertComponent`, `moveComponent`, `deleteComponent`,
+ * `duplicateComponent`, `replaceNodeSubtree`) so the client can replay a whole run
+ * through the exact same code path manual editing uses — and therefore inherit
+ * `DocumentHistoryManager` undo for free.
+ *
+ * The agent never returns a whole regenerated document; it returns a list of these.
+ */
+export type AgentOp = {
+    kind: 'update-props';
+    nodeId: string;
+    props: Record<string, unknown>;
+    merge: boolean;
+} | {
+    kind: 'update-styles';
+    nodeId: string;
+    styles: Record<string, unknown>;
+    /** Set for a breakpoint layer write. Mutually exclusive with `state`. */
+    breakpoint?: 'base' | 'desktop' | 'tablet' | 'mobile';
+    /** Set for a pseudo-state layer write (e.g. ':hover'). Mutually exclusive with `breakpoint`. */
+    state?: string;
+    merge: boolean;
+} | {
+    kind: 'insert-node';
+    parentId: string;
+    index?: number;
+    node: Node;
+} | {
+    kind: 'move-node';
+    nodeId: string;
+    targetParentId: string;
+    index?: number;
+} | {
+    kind: 'delete-node';
+    nodeId: string;
+} | {
+    kind: 'duplicate-node';
+    nodeId: string;
+    targetParentId?: string;
+    index?: number;
+} | {
+    kind: 'replace-node';
+    nodeId: string;
+    node: Node;
+};
+/** An `AgentOp` plus the metadata the review UI needs before the user hits Apply. */
+export interface AgentOpRecord {
+    id: string;
+    op: AgentOp;
+    /** Human-readable one-liner, e.g. `Update props of tombol "cta-btn"`. */
+    summary: string;
+    /**
+     * True for ops that can destroy user content (`delete-node`, `replace-node`). The
+     * editor never auto-applies these, even with auto-apply turned on.
+     */
+    destructive: boolean;
+}
+export interface AiAgentRequest {
+    messages: AiChatMessage[];
+    /** The canvas document the agent reasons about and mutates a snapshot of. */
+    document: PageDocument;
+    selectedNodeId?: string;
+    /**
+     * Extra host/user instructions, appended AFTER the built-in system prompt (never
+     * replacing it — the base prompt carries the output-format, safety and tool rules).
+     * Over HTTP, `createAiHandler` caps its length and can disable it entirely
+     * (`allowClientInstructions` / `maxClientInstructionsLength`).
+     */
+    instructions?: string;
+    /** @deprecated Alias of `instructions` — appended, never a replacement for the base prompt. */
+    systemPrompt?: string;
+    stylePreference?: string;
+    /** Overrides the engine's configured step ceiling for this run. */
+    maxSteps?: number;
+}
+export interface AiAgentRunResult {
+    ops: AgentOpRecord[];
+    /** The agent's closing natural-language message. */
+    summary: string;
+    stepsUsed: number;
+    stoppedBy: 'complete' | 'max-steps' | 'aborted' | 'error';
+    usage?: {
+        promptTokens?: number;
+        completionTokens?: number;
+    };
+}
+//# sourceMappingURL=types.d.cts.map

package/dist/types.d.cts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubuild/ai",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "Component-aware AI generation engine and adapters for KUBUILD",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -8,29 +8,54 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     },
     "./server": {
-      "types": "./dist/server/index.d.ts",
-      "import": "./dist/server/index.js",
-      "require": "./dist/server/index.cjs"
+      "import": {
+        "types": "./dist/server/index.d.ts",
+        "default": "./dist/server/index.js"
+      },
+      "require": {
+        "types": "./dist/server/index.d.cts",
+        "default": "./dist/server/index.cjs"
+      }
     },
     "./client": {
-      "types": "./dist/client/index.d.ts",
-      "import": "./dist/client/index.js",
-      "require": "./dist/client/index.cjs"
+      "import": {
+        "types": "./dist/client/index.d.ts",
+        "default": "./dist/client/index.js"
+      },
+      "require": {
+        "types": "./dist/client/index.d.cts",
+        "default": "./dist/client/index.cjs"
+      }
     },
     "./react": {
-      "types": "./dist/react/index.d.ts",
-      "import": "./dist/react/index.js",
-      "require": "./dist/react/index.cjs"
+      "import": {
+        "types": "./dist/react/index.d.ts",
+        "default": "./dist/react/index.js"
+      },
+      "require": {
+        "types": "./dist/react/index.d.cts",
+        "default": "./dist/react/index.cjs"
+      }
     },
     "./adapters": {
-      "types": "./dist/server/adapters/index.d.ts",
-      "import": "./dist/server/adapters/index.js",
-      "require": "./dist/server/adapters/index.cjs"
+      "import": {
+        "types": "./dist/server/adapters/index.d.ts",
+        "default": "./dist/server/adapters/index.js"
+      },
+      "require": {
+        "types": "./dist/server/adapters/index.d.cts",
+        "default": "./dist/server/adapters/index.cjs"
+      }
     }
   },
   "files": [
@@ -58,12 +83,12 @@
   "author": "KUBUILD",
   "license": "MIT",
   "dependencies": {
-    "@kubuild/core": "0.8.0",
-    "@kubuild/schema": "0.8.0"
+    "@kubuild/core": "0.8.2",
+    "@kubuild/schema": "0.8.2"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
-    "@kubuild/components": "0.8.0"
+    "@kubuild/components": "0.8.2"
   },
   "peerDependenciesMeta": {
     "@kubuild/components": {
@@ -75,17 +100,17 @@
   },
   "devDependencies": {
     "@types/node": "^26.2.0",
-    "@types/react": "^19.2.18",
+    "@types/react": "^19.3.0",
     "@types/react-test-renderer": "^18.3.0",
-    "react": "^19.2.8",
-    "react-test-renderer": "^19.2.0",
+    "react": "^19.3.0",
+    "react-test-renderer": "^19.3.0",
     "tsup": "^8.3.6",
     "typescript": "^6.0.0",
     "vitest": "^3.0.5",
-    "@kubuild/components": "0.8.0"
+    "@kubuild/components": "0.8.2"
   },
   "scripts": {
-    "build": "tsup && tsc --emitDeclarationOnly",
+    "build": "tsup && tsc --emitDeclarationOnly && node ../../scripts/emit-cjs-dts.mjs",
     "dev": "tsup --watch",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src",