@kubuild/ai 0.3.0

package/dist/server/adapters/stream-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-utils.d.ts","sourceRoot":"","sources":["../../../src/server/adapters/stream-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAuB,gBAAgB,CACrC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,MAAM,CAAC,EAAE,WAAW,GACnB,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CA8BpC"}

package/dist/server/engine.d.ts

@@ -0,0 +1,59 @@
+import { PageDocument, Node } from '@kubuild/schema';
+import type { KubuildAiEngineOptions, AiGeneratePageRequest, AiGenerateSectionRequest, AiRefactorNodeRequest, AiChatRequest, AiChatResponse, AiGenerateResponse, AiStreamEvent } from '../types';
+export declare class KubuildAiEngine {
+    private options;
+    private catalog;
+    constructor(options: KubuildAiEngineOptions);
+    get adapterName(): string;
+    refreshCatalog(): void;
+    private log;
+    generatePage(request: AiGeneratePageRequest, context?: {
+        signal?: AbortSignal;
+    }): Promise<AiGenerateResponse<PageDocument>>;
+    generateSection(request: AiGenerateSectionRequest, context?: {
+        signal?: AbortSignal;
+    }): Promise<AiGenerateResponse<Node>>;
+    refactorNode(request: AiRefactorNodeRequest, context?: {
+        signal?: AbortSignal;
+    }): Promise<AiGenerateResponse<Node>>;
+    /**
+     * Progressive Section Streaming Generator.
+     * Emits structured SSE events: status -> metadata -> section (one by one) -> complete.
+     */
+    streamPage(request: AiGeneratePageRequest, context?: {
+        signal?: AbortSignal;
+    }): AsyncIterable<AiStreamEvent>;
+    /**
+     * Builds the system/user prompt pair shared by `chat()` and `chatStream()` — the exact
+     * same document/selection grounding is used regardless of whether the response is
+     * streamed token-by-token or returned as a single request/response (STORA-515).
+     */
+    private buildChatPrompt;
+    /**
+     * Conversational Assistant / Q&A.
+     * Can discuss web design, explain KUBUILD components, review current page,
+     * suggest improvements, or recommend copywriting.
+     *
+     * Single request/response — unchanged since before STORA-515. See `chatStream()` for
+     * the token-level streaming variant.
+     */
+    chat(request: AiChatRequest, context?: {
+        signal?: AbortSignal;
+    }): Promise<AiGenerateResponse<AiChatResponse>>;
+    /**
+     * Token-level streaming variant of `chat()` (STORA-515). Emits `chat-chunk` events as
+     * partial text arrives, then a terminal `chat-complete` event with the fully assembled
+     * assistant message — the same `AsyncIterable<AiStreamEvent>` mechanism `streamPage`
+     * already uses, so it can be piped over SSE by `createAiHandler`/consumed by
+     * `KubuildAiClient` with no separate transport.
+     *
+     * When the configured adapter does not implement `generateStream` (e.g. the generic
+     * custom/HTTP adapter), this falls back to a single non-streaming `generate()` call and
+     * emits the entire response as one `chat-chunk`, so callers never see an error just
+     * because the underlying provider can't stream — only a less granular update cadence.
+     */
+    chatStream(request: AiChatRequest, context?: {
+        signal?: AbortSignal;
+    }): AsyncIterable<AiStreamEvent>;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/server/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/server/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,IAAI,EAA4C,MAAM,iBAAiB,CAAC;AAC/F,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,aAAa,EACb,cAAc,EAEd,kBAAkB,EAElB,aAAa,EACd,MAAM,UAAU,CAAC;AA0BlB,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,OAAO,CAA4B;gBAE/B,OAAO,EAAE,sBAAsB;IAQ3C,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,cAAc,IAAI,IAAI;IAItB,OAAO,CAAC,GAAG;IASL,YAAY,CAChB,OAAO,EAAE,qBAAqB,EAC9B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAkEtC,eAAe,CACnB,OAAO,EAAE,wBAAwB,EACjC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAuD9B,YAAY,CAChB,OAAO,EAAE,qBAAqB,EAC9B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IA+CpC;;;OAGG;IACI,UAAU,CACf,OAAO,EAAE,qBAAqB,EAC9B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,aAAa,CAAC,aAAa,CAAC;IAiN/B;;;;OAIG;IACH,OAAO,CAAC,eAAe;IA4CvB;;;;;;;OAOG;IACG,IAAI,CACR,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC;IAsD9C;;;;;;;;;;;OAWG;IACI,UAAU,CACf,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,aAAa,CAAC,aAAa,CAAC;CA4EhC"}

package/dist/server/handler.d.ts

@@ -0,0 +1,66 @@
+import type { KubuildAiEngine } from './engine';
+import type { PageDocument } from '@kubuild/schema';
+import type { AiGeneratePageRequest, AiRefactorNodeRequest, AiChatMessage, AiGenerateResponse, AiGenerationMode } from '../types';
+export interface AiApiRequestBody {
+    mode?: AiGenerationMode;
+    prompt?: string;
+    stylePreference?: string;
+    tone?: string;
+    locale?: string;
+    metadata?: AiGeneratePageRequest['metadata'];
+    targetSectionType?: string;
+    parentContext?: string;
+    node?: AiRefactorNodeRequest['node'];
+    instruction?: string;
+    stream?: boolean;
+    messages?: AiChatMessage[];
+    currentDocument?: PageDocument;
+    selectedNodeId?: string;
+}
+export declare function processAiRequest(engine: KubuildAiEngine, body: unknown, signal?: AbortSignal): Promise<{
+    status: number;
+    response: AiGenerateResponse<unknown>;
+}>;
+/**
+ * Options for {@link createAiHandler} (STORA-519).
+ */
+export interface CreateAiHandlerOptions {
+    /**
+     * Optional hook invoked with the raw incoming `Request` before it ever reaches the
+     * engine/provider — the place to plug in host-owned auth and/or rate-limiting without
+     * forking the handler.
+     *
+     * - Return a `Response` (or a Promise resolving to one) to reject/short-circuit the
+     *   request — e.g. `new Response(..., { status: 401 })` or `429` — that response is
+     *   returned as-is and the engine/provider is never invoked.
+     * - Return `void`/`undefined` (or a Promise resolving to that) to allow the request to
+     *   continue through the normal handler logic unchanged.
+     *
+     * Omitting this option entirely preserves the exact pre-STORA-519 behavior.
+     */
+    beforeRequest?: (request: Request) => Promise<Response | void> | Response | void;
+}
+/**
+ * Creates a standard Web Fetch API Request handler with optional SSE streaming support.
+ *
+ * Plug-and-play for Next.js App Router (route.ts), SvelteKit, Remix, Astro, Bun, etc.
+ *
+ * Example:
+ * ```ts
+ * export const POST = createAiHandler(engine);
+ * ```
+ *
+ * Example with an auth/rate-limit hook (STORA-519):
+ * ```ts
+ * export const POST = createAiHandler(engine, {
+ *   beforeRequest: async (request) => {
+ *     if (!isAuthorized(request)) {
+ *       return new Response('Unauthorized', { status: 401 });
+ *     }
+ *     // returning nothing lets the request proceed as normal
+ *   },
+ * });
+ * ```
+ */
+export declare function createAiHandler(engine: KubuildAiEngine, options?: CreateAiHandlerOptions): (request: Request) => Promise<Response>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/server/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/server/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EACV,qBAAqB,EAErB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAC7C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,YAAY,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,OAAO,EACb,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC,CA0IpE;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC;CAClF;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,sBAAsB,IACzE,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CAqLnD"}