glirastes 0.1.0

package/dist/react/utils/create-tool-result-handler.js

@@ -0,0 +1,166 @@
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function extractUiAction(result) {
+    if (result.uiAction !== undefined)
+        return result.uiAction;
+    if (isRecord(result.data) && result.data.uiAction !== undefined) {
+        return result.data.uiAction;
+    }
+    return undefined;
+}
+function hasSuccessfulResult(result) {
+    if (result.success === true)
+        return true;
+    return isRecord(result.data) && result.data.success === true;
+}
+function safeStringify(value) {
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return '[unserializable]';
+    }
+}
+/**
+ * Create a tool result handler that processes tool outputs for UI-side actions.
+ *
+ * Extracts `uiAction` from tool results, validates against an optional schema,
+ * and routes to the appropriate handler based on action type.
+ *
+ * Supports convention-based entity actions (`{entity}-created`, `{entity}-updated`,
+ * `{entity}-deleted`), `run-client-action`, and custom action handlers.
+ *
+ * @example
+ * ```ts
+ * import { createToolResultHandler } from '../index.js';
+ * import { dispatchAiClientAction } from '../ui/index.js';
+ *
+ * const handleToolResult = createToolResultHandler({
+ *   uiActionSchema: mySchema,
+ *   entityListDestinations: { task: '/tasks', group: '/groups' },
+ *   onNavigate: (dest) => router.push(dest),
+ *   onOpenDetail: (entity, id) => openPanel(entity, id),
+ *   onClientAction: (actionId, payload) => dispatchAiClientAction({ actionId, payload }),
+ *   onSuccess: () => window.dispatchEvent(new CustomEvent('data-refresh')),
+ *   actionHandlers: {
+ *     'set-filters': (action) => {
+ *       window.dispatchEvent(new CustomEvent('ai-set-filters', { detail: action.filters }));
+ *     },
+ *   },
+ * });
+ *
+ * // Wire into AiChatProvider or use in useEffect:
+ * <AiChatProvider onToolResult={handleToolResult} ... />
+ * ```
+ */
+export function createToolResultHandler(config) {
+    const { uiActionSchema, actionHandlers = {}, entityListDestinations = {}, onNavigate, onOpenDetail, onClientAction, onSuccess, toolFallbacks = {}, clientActionDedupe, } = config;
+    const dedupeEnabled = clientActionDedupe?.enabled ?? false;
+    const dedupeWindowMs = clientActionDedupe?.windowMs ?? 1500;
+    const dedupeActionIds = clientActionDedupe?.actionIds ?? ['navigate'];
+    const recentClientActions = new Map();
+    return (toolName, result) => {
+        if (!isRecord(result))
+            return;
+        let handledByAction = false;
+        const uiActionCandidate = extractUiAction(result);
+        if (uiActionCandidate !== undefined) {
+            // Normalize to array for uniform processing (supports compound actions)
+            const candidates = Array.isArray(uiActionCandidate)
+                ? uiActionCandidate
+                : [uiActionCandidate];
+            for (const candidate of candidates) {
+                // Validate if schema provided
+                let uiAction;
+                if (uiActionSchema) {
+                    const parsed = uiActionSchema.safeParse(candidate);
+                    if (!parsed.success) {
+                        console.warn('[AI Chat] Invalid uiAction dropped:', parsed.error.issues);
+                        continue;
+                    }
+                    uiAction = parsed.data;
+                }
+                else {
+                    if (!isRecord(candidate))
+                        continue;
+                    uiAction = candidate;
+                }
+                const actionType = typeof uiAction.type === 'string' ? uiAction.type : '';
+                // Convention-based entity actions: {entity}-{created|updated|deleted}
+                const entityMatch = actionType.match(/^(\w+)-(created|updated|deleted)$/);
+                if (entityMatch) {
+                    const [, entity, action] = entityMatch;
+                    const idKey = `${entity}Id`;
+                    const entityId = uiAction[idKey];
+                    if (action === 'created' && entityListDestinations[entity] && onNavigate) {
+                        onNavigate(entityListDestinations[entity], entity);
+                        handledByAction = true;
+                    }
+                    if (action === 'updated' && typeof entityId === 'string' && onOpenDetail) {
+                        onOpenDetail(entity, entityId);
+                        handledByAction = true;
+                    }
+                    if (action === 'deleted' && entityListDestinations[entity] && onNavigate) {
+                        onNavigate(entityListDestinations[entity], entity);
+                        handledByAction = true;
+                    }
+                }
+                // run-client-action
+                if (actionType === 'run-client-action' && onClientAction) {
+                    const actionId = typeof uiAction.actionId === 'string' ? uiAction.actionId : '';
+                    const payload = isRecord(uiAction.payload) ? uiAction.payload : undefined;
+                    if (actionId) {
+                        if (dedupeEnabled && dedupeActionIds.includes(actionId)) {
+                            const key = `${actionId}:${safeStringify(payload)}`;
+                            const now = Date.now();
+                            const lastSeen = recentClientActions.get(key);
+                            if (lastSeen && now - lastSeen < dedupeWindowMs) {
+                                handledByAction = true;
+                                continue;
+                            }
+                            recentClientActions.set(key, now);
+                        }
+                        onClientAction(actionId, payload);
+                        handledByAction = true;
+                    }
+                }
+                // Built-in navigate: route through onClientAction so consumers
+                // only need useAiClientAction('navigate', ...) — no raw CustomEvent.
+                if (actionType === 'navigate' && onClientAction) {
+                    const path = typeof uiAction.path === 'string' ? uiAction.path : '';
+                    if (path) {
+                        if (dedupeEnabled && dedupeActionIds.includes('navigate')) {
+                            const key = `navigate:${path}`;
+                            const now = Date.now();
+                            const lastSeen = recentClientActions.get(key);
+                            if (lastSeen && now - lastSeen < dedupeWindowMs) {
+                                handledByAction = true;
+                                continue;
+                            }
+                            recentClientActions.set(key, now);
+                        }
+                        onClientAction('navigate', { path });
+                        handledByAction = true;
+                        continue; // skip actionHandlers fallback for navigate
+                    }
+                }
+                // Custom action handlers
+                if (actionHandlers[actionType]) {
+                    actionHandlers[actionType](uiAction);
+                    handledByAction = true;
+                }
+            }
+        }
+        const successful = hasSuccessfulResult(result);
+        // Tool-specific fallback when no action was processed
+        if (!handledByAction && successful && toolFallbacks[toolName]) {
+            toolFallbacks[toolName](result);
+        }
+        // Global success callback
+        if (successful && onSuccess) {
+            onSuccess(toolName, result);
+        }
+    };
+}
+//# sourceMappingURL=create-tool-result-handler.js.map

package/dist/react/utils/create-tool-result-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-tool-result-handler.js","sourceRoot":"","sources":["../../../src/react/utils/create-tool-result-handler.ts"],"names":[],"mappings":"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"}

package/dist/react/utils/mention-markup.d.ts

@@ -0,0 +1,13 @@
+import type { Mention, MentionData, MentionSerializationConfig } from '../types.js';
+export declare function stripContextBlocks(text: string): string;
+export declare function inferMentionPrefix(type: string): string;
+export declare function normalizeMentionSlug(value: string): string;
+export type MentionTextSegment = {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'mention';
+    mention: Mention;
+};
+export declare function parseMentionSegments(text: string): MentionTextSegment[];
+export declare function serializeMentionsForSend(text: string, mentions: MentionData[], options?: MentionSerializationConfig): string;

package/dist/react/utils/mention-markup.js

@@ -0,0 +1,111 @@
+const CONTEXT_BLOCK_RE = /<!--\s*context:[\s\S]*?-->\s*/gi;
+const MENTION_MARKER_RE = /\{\{mention:([^:}]+):([^:}]+):([^}]+)\}\}/g;
+function escapeRegex(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+export function stripContextBlocks(text) {
+    return text.replace(CONTEXT_BLOCK_RE, '').trimStart();
+}
+export function inferMentionPrefix(type) {
+    return type === 'task' || type === 'command' ? '/' : '@';
+}
+export function normalizeMentionSlug(value) {
+    return value
+        .toLowerCase()
+        .normalize('NFKD')
+        .replace(/[^\w\s-]/g, '')
+        .trim()
+        .replace(/\s+/g, '-');
+}
+export function parseMentionSegments(text) {
+    const segments = [];
+    let cursor = 0;
+    let match;
+    MENTION_MARKER_RE.lastIndex = 0;
+    while ((match = MENTION_MARKER_RE.exec(text)) !== null) {
+        const [raw, type, id, label] = match;
+        const start = match.index;
+        const end = start + raw.length;
+        if (start > cursor) {
+            segments.push({ kind: 'text', text: text.slice(cursor, start) });
+        }
+        segments.push({
+            kind: 'mention',
+            mention: {
+                id,
+                type,
+                displayName: label,
+                prefix: inferMentionPrefix(type),
+            },
+        });
+        cursor = end;
+    }
+    if (cursor < text.length) {
+        segments.push({ kind: 'text', text: text.slice(cursor) });
+    }
+    return segments;
+}
+function buildContextBlock(mentions, label) {
+    if (mentions.length === 0)
+        return null;
+    const summary = mentions
+        .map((m) => {
+        const displayName = m.displayName ?? m.label ?? m.id;
+        return `${displayName} (ID: ${m.id})`;
+    })
+        .join(', ');
+    return `<!--context:[${label}: ${summary}]--> `;
+}
+export function serializeMentionsForSend(text, mentions, options) {
+    const enabled = options?.enabled ?? true;
+    if (!enabled || mentions.length === 0) {
+        return stripContextBlocks(text);
+    }
+    const cleaned = stripContextBlocks(text);
+    let nextText = cleaned;
+    const serializedMentions = [];
+    for (const mention of mentions) {
+        const id = typeof mention.id === 'string' ? mention.id : '';
+        const type = typeof mention.type === 'string' ? mention.type : '';
+        if (!id || !type)
+            continue;
+        const label = typeof mention.label === 'string'
+            ? mention.label
+            : typeof mention.displayName === 'string'
+                ? mention.displayName
+                : id;
+        const slug = typeof mention.slug === 'string' && mention.slug.trim().length > 0
+            ? mention.slug.trim()
+            : normalizeMentionSlug(label);
+        const prefix = typeof mention.prefix === 'string' && mention.prefix.length > 0
+            ? mention.prefix
+            : inferMentionPrefix(type);
+        const token = `${prefix}${slug}`;
+        const marker = `{{mention:${type}:${id}:${label}}}`;
+        const tokenPattern = new RegExp(`(^|\\s)${escapeRegex(token)}(?=\\s|$)`, 'g');
+        let wasInserted = false;
+        nextText = nextText.replace(tokenPattern, (fullMatch, leading) => {
+            wasInserted = true;
+            return `${leading}${marker}`;
+        });
+        if (wasInserted) {
+            serializedMentions.push({
+                id,
+                type,
+                label,
+                displayName: label,
+                slug,
+                prefix,
+            });
+        }
+    }
+    if (options?.includeContextBlock) {
+        const contextLabel = options.contextLabel ?? 'Referenced entities';
+        const contextBlock = buildContextBlock(serializedMentions, contextLabel);
+        if (contextBlock) {
+            return `${contextBlock}${nextText}`.trim();
+        }
+    }
+    return nextText;
+}
+//# sourceMappingURL=mention-markup.js.map

package/dist/react/utils/mention-markup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention-markup.js","sourceRoot":"","sources":["../../../src/react/utils/mention-markup.ts"],"names":[],"mappings":"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"}

package/dist/react/utils/merge-pipeline-steps.d.ts

@@ -0,0 +1,19 @@
+import type { PipelineStepReport } from '../types.js';
+/**
+ * Merge incoming pipeline steps with existing stable state.
+ *
+ * Handles:
+ * - Synthetic resume steps (step 0 with stop reason after approval waits)
+ * - Timestamp-based conflict resolution for duplicate step numbers
+ * - Stable ordering by step number
+ *
+ * @example
+ * ```tsx
+ * const [stableSteps, setStableSteps] = useState<PipelineStepReport[]>([]);
+ *
+ * useEffect(() => {
+ *   setStableSteps((prev) => mergePipelineSteps(prev, pipelineSteps));
+ * }, [pipelineSteps]);
+ * ```
+ */
+export declare function mergePipelineSteps(previous: PipelineStepReport[], incoming: PipelineStepReport[]): PipelineStepReport[];

package/dist/react/utils/merge-pipeline-steps.js

@@ -0,0 +1,79 @@
+function parseStepTimestamp(value) {
+    const ts = Date.parse(value);
+    return Number.isFinite(ts) ? ts : null;
+}
+/**
+ * Merge incoming pipeline steps with existing stable state.
+ *
+ * Handles:
+ * - Synthetic resume steps (step 0 with stop reason after approval waits)
+ * - Timestamp-based conflict resolution for duplicate step numbers
+ * - Stable ordering by step number
+ *
+ * @example
+ * ```tsx
+ * const [stableSteps, setStableSteps] = useState<PipelineStepReport[]>([]);
+ *
+ * useEffect(() => {
+ *   setStableSteps((prev) => mergePipelineSteps(prev, pipelineSteps));
+ * }, [pipelineSteps]);
+ * ```
+ */
+export function mergePipelineSteps(previous, incoming) {
+    if (incoming.length === 0)
+        return [];
+    const sorted = [...incoming].sort((a, b) => a.stepNumber - b.stepNumber);
+    const previousHasWorkflow = previous.some((step) => step.toolCalls.length > 0 || step.requiresApproval);
+    const firstIncoming = sorted[0];
+    const isSyntheticResumeStep = firstIncoming &&
+        firstIncoming.stepNumber === 0 &&
+        firstIncoming.finishReason === 'stop' &&
+        firstIncoming.toolCalls.length === 0 &&
+        firstIncoming.toolResults === 0 &&
+        !firstIncoming.requiresApproval;
+    // After an approval wait, the server sends a synthetic step 0 with finishReason='stop'.
+    // Instead of replacing previous steps, append it as a final step.
+    if (isSyntheticResumeStep && previousHasWorkflow) {
+        const resolved = previous.map((step) => step.requiresApproval
+            ? { ...step, requiresApproval: false, pendingApprovals: 0 }
+            : step);
+        const alreadyFinalized = resolved.some((step) => step.finishReason === 'stop' && step.toolCalls.length === 0);
+        if (alreadyFinalized)
+            return resolved;
+        return [
+            ...resolved,
+            { ...firstIncoming, stepNumber: resolved.length },
+        ];
+    }
+    // Also clear approval flags when execution continues with tool calls after approval.
+    // This handles cases where followup tools (like suggest_followups) execute after
+    // approval is granted, instead of getting a synthetic resume step.
+    const previousHadApprovals = previous.some((step) => step.requiresApproval);
+    const incomingAllCleared = sorted.every((step) => step.pendingApprovals === 0);
+    const shouldClearFlags = previousHadApprovals && incomingAllCleared && sorted.length > 0;
+    if (shouldClearFlags) {
+        previous = previous.map((step) => step.requiresApproval
+            ? { ...step, requiresApproval: false, pendingApprovals: 0 }
+            : step);
+    }
+    // Standard merge: keep newer timestamps when step numbers collide
+    const mergedByStep = new Map();
+    for (const step of previous)
+        mergedByStep.set(step.stepNumber, step);
+    for (const step of sorted) {
+        const existing = mergedByStep.get(step.stepNumber);
+        if (!existing) {
+            mergedByStep.set(step.stepNumber, step);
+            continue;
+        }
+        const existingTs = parseStepTimestamp(existing.createdAt) ?? 0;
+        const incomingTs = parseStepTimestamp(step.createdAt) ?? 0;
+        if (incomingTs >= existingTs) {
+            mergedByStep.set(step.stepNumber, step);
+        }
+    }
+    return Array.from(mergedByStep.entries())
+        .sort((a, b) => a[0] - b[0])
+        .map(([, step]) => step);
+}
+//# sourceMappingURL=merge-pipeline-steps.js.map

package/dist/react/utils/merge-pipeline-steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-pipeline-steps.js","sourceRoot":"","sources":["../../../src/react/utils/merge-pipeline-steps.ts"],"names":[],"mappings":"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"}

package/dist/react/utils/sanitize-stored-messages.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Sanitize raw stored messages to remove incomplete tool calls that would
+ * cause `AI_MissingToolResultsError` when sent to the API.
+ *
+ * This handles the case where a user closes the chat or refreshes while
+ * a tool approval is pending, leaving orphaned tool calls in the history.
+ *
+ * Call this when loading messages from storage (sessionStorage, localStorage,
+ * or any backend) before passing them to `setMessages()` or the SDK provider.
+ *
+ * @example
+ * ```ts
+ * const sessionAdapter: SessionConfig = {
+ *   load: () => {
+ *     const raw = JSON.parse(sessionStorage.getItem('chat') ?? '[]');
+ *     return sanitizeStoredMessages(raw);
+ *   },
+ *   save: (_, msgs) => sessionStorage.setItem('chat', JSON.stringify(msgs)),
+ *   clear: () => sessionStorage.removeItem('chat'),
+ * };
+ * ```
+ */
+export declare function sanitizeStoredMessages(messages: unknown[]): unknown[];

package/dist/react/utils/sanitize-stored-messages.js

@@ -0,0 +1,50 @@
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+/**
+ * Sanitize raw stored messages to remove incomplete tool calls that would
+ * cause `AI_MissingToolResultsError` when sent to the API.
+ *
+ * This handles the case where a user closes the chat or refreshes while
+ * a tool approval is pending, leaving orphaned tool calls in the history.
+ *
+ * Call this when loading messages from storage (sessionStorage, localStorage,
+ * or any backend) before passing them to `setMessages()` or the SDK provider.
+ *
+ * @example
+ * ```ts
+ * const sessionAdapter: SessionConfig = {
+ *   load: () => {
+ *     const raw = JSON.parse(sessionStorage.getItem('chat') ?? '[]');
+ *     return sanitizeStoredMessages(raw);
+ *   },
+ *   save: (_, msgs) => sessionStorage.setItem('chat', JSON.stringify(msgs)),
+ *   clear: () => sessionStorage.removeItem('chat'),
+ * };
+ * ```
+ */
+export function sanitizeStoredMessages(messages) {
+    return messages
+        .map((message) => {
+        if (!isRecord(message))
+            return message;
+        const parts = Array.isArray(message.parts) ? message.parts : [];
+        const sanitizedParts = parts.filter((part) => {
+            if (!isRecord(part))
+                return true;
+            const partType = typeof part.type === 'string' ? part.type : '';
+            // Remove tool parts stuck in approval-requested state
+            if (partType.startsWith('tool-') && part.state === 'approval-requested') {
+                return false;
+            }
+            return true;
+        });
+        // If all parts were removed, mark for filtering
+        if (sanitizedParts.length === 0 && parts.length > 0) {
+            return null;
+        }
+        return { ...message, parts: sanitizedParts };
+    })
+        .filter((message) => message !== null);
+}
+//# sourceMappingURL=sanitize-stored-messages.js.map

package/dist/react/utils/sanitize-stored-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize-stored-messages.js","sourceRoot":"","sources":["../../../src/react/utils/sanitize-stored-messages.ts"],"names":[],"mappings":"AAAA,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAmB;IACxD,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACf,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC;QAEvC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YAC3C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;YAEjC,MAAM,QAAQ,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAEhE,sDAAsD;YACtD,IAAI,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,KAAK,KAAK,oBAAoB,EAAE,CAAC;gBACxE,OAAO,KAAK,CAAC;YACf,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QAEH,gDAAgD;QAChD,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IAC/C,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;AAC3C,CAAC"}

package/dist/server/adapters/nestjs/chat/ai-chat-auth.guard.d.ts

@@ -0,0 +1,10 @@
+import { CanActivate, ExecutionContext } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+import { type AiChatModuleOptions } from './ai-chat-module-options.interface.js';
+export declare class AiChatAuthGuard implements CanActivate {
+    private readonly options;
+    private readonly moduleRef;
+    private guardInstance;
+    constructor(options: AiChatModuleOptions | null, moduleRef: ModuleRef);
+    canActivate(context: ExecutionContext): Promise<boolean>;
+}

package/dist/server/adapters/nestjs/chat/ai-chat-auth.guard.js

@@ -0,0 +1,40 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { Inject, Injectable, } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+import { AI_CHAT_MODULE_OPTIONS, } from './ai-chat-module-options.interface.js';
+let AiChatAuthGuard = class AiChatAuthGuard {
+    options;
+    moduleRef;
+    guardInstance = null;
+    constructor(options, moduleRef) {
+        this.options = options;
+        this.moduleRef = moduleRef;
+    }
+    async canActivate(context) {
+        if (!this.options) {
+            return false;
+        }
+        if (!this.guardInstance) {
+            this.guardInstance = await this.moduleRef.create(this.options.authGuard);
+        }
+        return this.guardInstance.canActivate(context);
+    }
+};
+AiChatAuthGuard = __decorate([
+    Injectable(),
+    __param(0, Inject(AI_CHAT_MODULE_OPTIONS)),
+    __metadata("design:paramtypes", [Object, ModuleRef])
+], AiChatAuthGuard);
+export { AiChatAuthGuard };
+//# sourceMappingURL=ai-chat-auth.guard.js.map

package/dist/server/adapters/nestjs/chat/ai-chat-auth.guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-chat-auth.guard.js","sourceRoot":"","sources":["../../../../../src/server/adapters/nestjs/chat/ai-chat-auth.guard.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAGL,MAAM,EACN,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EACL,sBAAsB,GAEvB,MAAM,uCAAuC,CAAC;AAGxC,IAAM,eAAe,GAArB,MAAM,eAAe;IAKP;IACA;IALX,aAAa,GAAuB,IAAI,CAAC;IAEjD,YAEmB,OAAmC,EACnC,SAAoB;QADpB,YAAO,GAAP,OAAO,CAA4B;QACnC,cAAS,GAAT,SAAS,CAAW;IACpC,CAAC;IAEJ,KAAK,CAAC,WAAW,CAAC,OAAyB;QACzC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,IAAI,CAAC,aAAa,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC3E,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,OAAO,CAAqB,CAAC;IACrE,CAAC;CACF,CAAA;AAlBY,eAAe;IAD3B,UAAU,EAAE;IAKR,WAAA,MAAM,CAAC,sBAAsB,CAAC,CAAA;6CAEH,SAAS;GAN5B,eAAe,CAkB3B"}

package/dist/server/adapters/nestjs/chat/ai-chat-module-options.interface.d.ts

@@ -0,0 +1,32 @@
+import type { CanActivate, InjectionToken, ModuleMetadata, OptionalFactoryDependency, Type } from '@nestjs/common';
+import type { LanguageModel } from 'ai';
+import type { AuditEmitter } from '../../../../types.js';
+import type { Lancer } from '../../../lancer/index.js';
+export declare const AI_CHAT_MODULE_OPTIONS: unique symbol;
+export interface AiChatModuleFeatures {
+    speechToText?: boolean;
+}
+export interface AiChatModuleOptions {
+    /** Vercel AI SDK LanguageModel — consumer creates and owns this */
+    model: LanguageModel;
+    /** Project-specific system prompt, static string or factory */
+    systemPrompt: string | ((context: {
+        currentDate: string;
+    }) => string);
+    /** NestJS guard class for HTTP authentication */
+    authGuard: Type<CanActivate>;
+    /** Optional feature toggles */
+    features?: AiChatModuleFeatures;
+    /** Max tool-call steps per chat request (default: 4) */
+    maxSteps?: number;
+    /** Unified audit event callback for compliance logging */
+    onAudit?: AuditEmitter;
+    /** Lancer client for runtime prompt overrides (Pro feature) */
+    lancer?: Lancer;
+}
+export interface AiChatModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    /** Factory that returns options or null to disable the module */
+    useFactory: (...args: any[]) => Promise<AiChatModuleOptions | null> | AiChatModuleOptions | null;
+    /** Injection tokens to pass to useFactory */
+    inject?: (InjectionToken | OptionalFactoryDependency)[];
+}

package/dist/server/adapters/nestjs/chat/ai-chat-module-options.interface.js

@@ -0,0 +1,2 @@
+export const AI_CHAT_MODULE_OPTIONS = Symbol('AI_CHAT_MODULE_OPTIONS');
+//# sourceMappingURL=ai-chat-module-options.interface.js.map

package/dist/server/adapters/nestjs/chat/ai-chat-module-options.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-chat-module-options.interface.js","sourceRoot":"","sources":["../../../../../src/server/adapters/nestjs/chat/ai-chat-module-options.interface.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC"}

package/dist/server/adapters/nestjs/chat/ai-chat.controller.d.ts

@@ -0,0 +1,11 @@
+import type { Request, Response } from 'express';
+import { AiChatService } from './ai-chat.service.js';
+import { AiChatRequestDto } from './dto/index.js';
+import { type AiChatModuleOptions } from './ai-chat-module-options.interface.js';
+export declare class AiChatController {
+    private readonly options;
+    private readonly aiChatService;
+    private readonly logger;
+    constructor(options: AiChatModuleOptions | null, aiChatService: AiChatService);
+    chat(dto: AiChatRequestDto, req: Request, res: Response): Promise<void>;
+}