glirastes 0.1.0

package/dist/server/adapters/nextjs/create-ai-chat-handler.d.ts

@@ -0,0 +1,78 @@
+import type { PiiShield } from '../../../types.js';
+import type { AiChatHandlerConfig, IntentRoutingResult, PipelineStepReport, PipelineResult, StepLimitSource } from './types.js';
+/**
+ * Callback that the consumer provides to stream the AI response.
+ * Receives the prepared context and returns a Response.
+ *
+ * This decouples the adapter from the `ai` SDK — the consumer
+ * calls streamText() themselves with full type safety.
+ */
+export interface StreamHandlerContext {
+    /** AI tools (output of toolsToAiTools, RBAC-filtered) */
+    tools: Record<string, unknown>;
+    /** Processed messages (after guardrails, sliced to context window) */
+    messages: unknown[];
+    /** Resolved system prompt string */
+    systemPrompt: string;
+    /** Resolved model (static or from model selector) */
+    model: unknown;
+    /** Max steps (explicit/module/safety-resolved) */
+    maxSteps: number;
+    /** Source used to resolve maxSteps */
+    stepLimitSource: StepLimitSource;
+    /** Whether to emit `data-step-report` events */
+    emitStepReports: boolean;
+    /** Optional per-step callback */
+    onStepReport?: (report: PipelineStepReport) => void;
+    /** Max output tokens */
+    maxOutputTokens: number;
+    /** Temperature */
+    temperature: number;
+    /** Max context messages for model-message preparation */
+    maxContextMessages: number;
+    /** Model tier from intent routing or pipeline */
+    modelTier?: string;
+    /** Intent routing result (legacy mode) */
+    routing?: IntentRoutingResult;
+    /** Pipeline result (pipeline mode) */
+    pipelineResult?: PipelineResult;
+    /** PII shield context for response de-anonymization */
+    piiShield?: {
+        shield: PiiShield;
+        sessionId: string;
+    };
+}
+/**
+ * Extended config that adds an optional streamHandler for full AI SDK control.
+ *
+ * When `streamHandler` is not provided, a built-in default is used that:
+ * - Converts UI messages to model messages via `prepareModelMessages()`
+ * - Wraps SDK tools via `wrapToolsForVercelAi()`
+ * - Calls `streamText()` and returns `createUIMessageStreamResponse()`
+ */
+export interface AiChatHandlerFullConfig extends AiChatHandlerConfig {
+    /**
+     * Custom stream handler. Receives prepared context, returns Response.
+     * This is where the consumer calls streamText() / toDataStreamResponse().
+     *
+     * When omitted, the built-in default handler is used.
+     */
+    streamHandler?: (ctx: StreamHandlerContext) => Promise<Response>;
+}
+/**
+ * Creates a complete Next.js App Router POST handler for AI chat.
+ *
+ * Supports two modes:
+ *
+ * **Pipeline mode** (Pro): When `pipeline` is provided, uses the server-pro
+ * pipeline for guardrails, intent classification, tool selection, and model
+ * selection.
+ *
+ * **Legacy mode**: When no `pipeline` is provided, uses the original
+ * `guardrails` + `intentRouter` flow.
+ *
+ * The SDK does not perform authentication or authorization. Tools forward the
+ * caller's cookies to backend APIs via `runtime.cookieHeader`; permission
+ * checks happen on the backend.
+ */
+export declare function createAiChatHandler(config: AiChatHandlerFullConfig): (req: Request) => Promise<Response>;