@astro-minimax/ai 0.9.0 → 0.9.3

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/server/errors.ts"],"names":[],"mappings":"AAQA,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD,QAAQ,CAYV;AAMD,eAAO,MAAM,MAAM;8BACS,MAAM;8BAEN,MAAM,SAAS,MAAM;0BAEzB,MAAM;0BAEN,MAAM;wBAER,MAAM,SAAS,MAAM;+BAEd,MAAM,SAAS,MAAM;qBAE/B,MAAM;iCAEM,MAAM;wBAEf,MAAM,SAAS,MAAM;CAE1C,CAAC;AAEF,wBAAgB,qBAAqB,IAAI,QAAQ,CAQhD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/server/errors.ts"],"names":[],"mappings":"AAKA,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAElD;AASD,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD,QAAQ,CAYV;AAMD,eAAO,MAAM,MAAM;8BACS,MAAM;8BAEN,MAAM,SAAS,MAAM;0BAEzB,MAAM;0BAEN,MAAM;wBAER,MAAM,SAAS,MAAM;+BAEd,MAAM,SAAS,MAAM;qBAE/B,MAAM;iCAEM,MAAM;wBAEf,MAAM,SAAS,MAAM;CAE1C,CAAC;AAEF,wBAAgB,qBAAqB,IAAI,QAAQ,CAQhD"}

package/dist/server/errors.js

@@ -1,8 +1,14 @@
 import { t } from "../utils/i18n.js";
-const CORS_HEADERS = {
-  "Content-Type": "application/json",
-  "Access-Control-Allow-Origin": "*"
-};
+let _allowedOrigin = "*";
+function setCorsOrigin(origin) {
+  _allowedOrigin = origin;
+}
+function corsHeaders() {
+  return {
+    "Content-Type": "application/json",
+    "Access-Control-Allow-Origin": _allowedOrigin
+  };
+}
 function chatError(code, error, status, options) {
   const body = {
     error,
@@ -10,7 +16,7 @@ function chatError(code, error, status, options) {
     retryable: options?.retryable ?? false,
     retryAfter: options?.retryAfter
   };
-  const headers = { ...CORS_HEADERS };
+  const headers = { ...corsHeaders() };
   if (options?.retryAfter) {
     headers["Retry-After"] = String(options.retryAfter);
   }
@@ -33,7 +39,7 @@ const errors = {
 function corsPreflightResponse() {
   return new Response(null, {
     headers: {
-      "Access-Control-Allow-Origin": "*",
+      "Access-Control-Allow-Origin": _allowedOrigin,
       "Access-Control-Allow-Methods": "POST, OPTIONS",
       "Access-Control-Allow-Headers": "Content-Type, x-session-id"
     }
@@ -42,5 +48,6 @@ function corsPreflightResponse() {
 export {
   chatError,
   corsPreflightResponse,
-  errors
+  errors,
+  setCorsOrigin
 };

package/dist/server/index.d.ts

@@ -1,9 +1,7 @@
 export { handleChatRequest } from './chat-handler.js';
-export { initializeMetadata, resetMetadataInit } from './metadata-init.js';
+export { initializeMetadata } from './metadata-init.js';
+export { applyAiConfigDefaults } from './env-config.js';
 export { errors, corsPreflightResponse, chatError } from './errors.js';
-export { notifyAiChat } from './notify.js';
-export type { ChatNotifyOptions } from './notify.js';
-export { writeSearchStatus, writeGeneratingStatus, writeDoneStatus, writeSourceArticles, writeTextChunk, writeFinish, streamLLMResponse, streamMockFallback, streamCachedResponse, } from './stream-helpers.js';
 export { createChatStatusData, isChatStatusData, } from './types.js';
 export type { ChatContext, ArticleChatContext, ChatRequestBody, ChatHandlerEnv, ChatHandlerOptions, ChatStatusData, ChatStatusStage, ChatErrorResponse, MetadataConfig, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,cAAc,GACf,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/server/index.js

@@ -1,39 +1,18 @@
 import { handleChatRequest } from "./chat-handler.js";
-import { initializeMetadata, resetMetadataInit } from "./metadata-init.js";
+import { initializeMetadata } from "./metadata-init.js";
+import { applyAiConfigDefaults } from "./env-config.js";
 import { errors, corsPreflightResponse, chatError } from "./errors.js";
-import { notifyAiChat } from "./notify.js";
-import {
-  writeSearchStatus,
-  writeGeneratingStatus,
-  writeDoneStatus,
-  writeSourceArticles,
-  writeTextChunk,
-  writeFinish,
-  streamLLMResponse,
-  streamMockFallback,
-  streamCachedResponse
-} from "./stream-helpers.js";
 import {
   createChatStatusData,
   isChatStatusData
 } from "./types.js";
 export {
+  applyAiConfigDefaults,
   chatError,
   corsPreflightResponse,
   createChatStatusData,
   errors,
   handleChatRequest,
   initializeMetadata,
-  isChatStatusData,
-  notifyAiChat,
-  resetMetadataInit,
-  streamCachedResponse,
-  streamLLMResponse,
-  streamMockFallback,
-  writeDoneStatus,
-  writeFinish,
-  writeGeneratingStatus,
-  writeSearchStatus,
-  writeSourceArticles,
-  writeTextChunk
+  isChatStatusData
 };

package/dist/server/metadata-init.d.ts

@@ -1,11 +1,16 @@
-import type { MetadataConfig, ChatHandlerEnv } from './types.js';
-/**
- * Initializes AI metadata: loads summaries, author context, voice profile,
- * and builds search indices. Safe to call multiple times (idempotent).
- */
+import type { MetadataConfig, ChatHandlerEnv } from "./types.js";
 export declare function initializeMetadata(config: MetadataConfig, env?: ChatHandlerEnv): void;
 /**
  * Resets initialization state (for testing).
  */
 export declare function resetMetadataInit(): void;
+/**
+ * Loads extensions from datas/extensions/*.json
+ * Returns the loaded extensions for use in chat pipeline.
+ */
+export declare function initializeExtensions(basePath?: string): Promise<void>;
+/**
+ * Checks if extensions have been loaded.
+ */
+export declare function areExtensionsLoaded(): boolean;
 //# sourceMappingURL=metadata-init.d.ts.map

package/dist/server/metadata-init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata-init.d.ts","sourceRoot":"","sources":["../../src/server/metadata-init.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjE;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,cAAc,GAAG,IAAI,CAsCrF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}
+{"version":3,"file":"metadata-init.d.ts","sourceRoot":"","sources":["../../src/server/metadata-init.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AASjE,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,cAAc,EACtB,GAAG,CAAC,EAAE,cAAc,GACnB,IAAI,CAgEN;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAMxC;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAU3E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C"}

package/dist/server/metadata-init.js

@@ -1,49 +1,93 @@
 import {
-  preloadMetadata,
-  getAuthorContext,
-  getAllSummaries,
+  preloadKnowledgeBundle,
+  getKnowledgeBundle
+} from "../data/index.js";
+import {
   initArticleIndex,
-  initProjectIndex
-} from "../index.js";
+  initProjectIndex,
+  initArticleChunks
+} from "../search/index.js";
+import { getExtensionRegistry } from "../extensions/index.js";
+import { safeJoinUrl } from "../utils/url.js";
 let initialized = false;
+let extensionsLoaded = false;
+let initializedBundleRef = null;
+let initializedSiteUrl = "";
 function initializeMetadata(config, env) {
-  if (initialized) return;
-  initialized = true;
-  preloadMetadata({
-    summaries: config.summaries,
-    authorContext: config.authorContext,
-    voiceProfile: config.voiceProfile,
-    factRegistry: config.factRegistry ?? null,
-    vectorIndex: config.vectorIndex ?? null
-  });
-  const authorCtx = getAuthorContext();
-  const allSummaries = getAllSummaries();
-  const summaryMap = new Map(allSummaries.map((s) => [s.slug, s]));
   const siteUrl = config.siteUrl ?? env?.SITE_URL ?? "";
-  const articleDocs = (authorCtx?.posts ?? []).map((post) => {
-    const summary = summaryMap.get(post.id);
-    const baseUrl = post.url?.startsWith("http") ? "" : siteUrl;
-    return {
-      id: post.id,
-      title: post.title,
-      url: post.url ? `${baseUrl}${post.url}` : `${siteUrl}/${post.id}`,
-      excerpt: post.summary || summary?.summary || "",
-      content: [...post.keyPoints ?? [], ...summary?.keyPoints ?? []].join(" "),
-      categories: [post.category].filter(Boolean),
-      tags: post.tags ?? [],
-      keyPoints: [...post.keyPoints ?? [], ...summary?.keyPoints ?? []],
-      dateTime: post.date ? new Date(post.date).getTime() : 0,
-      lang: post.lang,
-      summary: summary?.summary
-    };
-  });
+  const bundleRef = config.knowledgeBundle;
+  if (initialized && initializedBundleRef === bundleRef && initializedSiteUrl === siteUrl) {
+    return;
+  }
+  initialized = true;
+  initializedBundleRef = bundleRef;
+  initializedSiteUrl = siteUrl;
+  preloadKnowledgeBundle(
+    config.knowledgeBundle
+  );
+  const knowledgeBundle = getKnowledgeBundle();
+  if (!knowledgeBundle) return;
+  const articleDocs = knowledgeBundle.corpus.documents.map(
+    (doc) => ({
+      id: doc.id,
+      title: doc.title,
+      url: safeJoinUrl(siteUrl, doc.url ?? `/${doc.id}`),
+      excerpt: doc.summary,
+      content: doc.keyPoints.join(" "),
+      categories: [doc.category].filter(Boolean),
+      tags: doc.tags ?? [],
+      keyPoints: doc.keyPoints ?? [],
+      dateTime: doc.publishedAt ? new Date(doc.publishedAt).getTime() : 0,
+      lang: doc.lang,
+      summary: doc.summary,
+      readingTime: doc.readingTime
+    })
+  );
   initArticleIndex(articleDocs);
   initProjectIndex([]);
+  const chunksData = Object.fromEntries(
+    knowledgeBundle.passages.passages.reduce(
+      (map, passage) => {
+        const list = map.get(passage.documentId) ?? [];
+        list.push({
+          id: passage.id,
+          postId: passage.documentId,
+          heading: passage.heading,
+          content: passage.text,
+          position: passage.position,
+          tokenCount: passage.tokenCount,
+          headers: passage.headers
+        });
+        map.set(passage.documentId, list);
+        return map;
+      },
+      /* @__PURE__ */ new Map()
+    )
+  );
+  initArticleChunks(chunksData);
 }
 function resetMetadataInit() {
   initialized = false;
+  extensionsLoaded = false;
+  initializedBundleRef = null;
+  initializedSiteUrl = "";
+  getExtensionRegistry().clear();
+}
+async function initializeExtensions(basePath) {
+  if (extensionsLoaded) return;
+  extensionsLoaded = true;
+  try {
+    const { loadExtensions } = await import("../extensions/loader.js");
+    await loadExtensions("datas/extensions/*.json", basePath);
+  } catch {
+  }
+}
+function areExtensionsLoaded() {
+  return extensionsLoaded;
 }
 export {
+  areExtensionsLoaded,
+  initializeExtensions,
   initializeMetadata,
   resetMetadataInit
 };

package/dist/server/notify.d.ts

@@ -1,14 +1,15 @@
-import { type NotifyResult, type ArticleRef, type ModelInfo, type TokenUsage, type PhaseTiming } from '@astro-minimax/notify';
-import type { UIMessage } from 'ai';
-interface NotifyEnv {
-    NOTIFY_TELEGRAM_BOT_TOKEN?: string;
-    NOTIFY_TELEGRAM_CHAT_ID?: string;
-    NOTIFY_WEBHOOK_URL?: string;
-    NOTIFY_RESEND_API_KEY?: string;
-    NOTIFY_RESEND_FROM?: string;
-    NOTIFY_RESEND_TO?: string;
-    SITE_URL?: string;
-    [key: string]: unknown;
+import type { UIMessage } from "ai";
+import type { NotifyArticleRef as ArticleRef, NotifyModelInfo as ModelInfo, NotifyTokenUsage as TokenUsage, PhaseTiming } from "./types.js";
+type NotifyEnv = Record<string, unknown>;
+interface NotifyResult {
+    event: "comment" | "ai-chat";
+    success: boolean;
+    results: Array<{
+        channel: "telegram" | "webhook" | "email";
+        success: boolean;
+        error?: string;
+        duration?: number;
+    }>;
 }
 export interface ChatNotifyOptions {
     env: NotifyEnv;

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

@@ -1 +1 @@
-{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../src/server/notify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC7J,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAEpC,UAAU,SAAS;IACjB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAiDD,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,SAAS,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,UAAU,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAkCrF"}
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../src/server/notify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,KAAK,EACV,gBAAgB,IAAI,UAAU,EAC9B,eAAe,IAAI,SAAS,EAC5B,gBAAgB,IAAI,UAAU,EAC9B,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEzC,UAAU,YAAY;IACpB,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,KAAK,CAAC;QACb,OAAO,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;QAC1C,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;CACJ;AAkED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,SAAS,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,UAAU,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA4C9B"}

package/dist/server/notify.js

@@ -1,33 +1,23 @@
-import { createNotifier } from "@astro-minimax/notify";
-let notifierInstance = null;
-function getNotifier(env) {
-  if (notifierInstance) return notifierInstance;
-  const hasConfig = env.NOTIFY_TELEGRAM_BOT_TOKEN || env.NOTIFY_WEBHOOK_URL || env.NOTIFY_RESEND_API_KEY;
-  if (!hasConfig) {
-    console.warn("[notify] No notification providers configured. Missing environment variables: NOTIFY_TELEGRAM_BOT_TOKEN, NOTIFY_WEBHOOK_URL, or NOTIFY_RESEND_API_KEY");
+async function loadNotifyRuntime() {
+  try {
+    return await import("@astro-minimax/notify");
+  } catch (error) {
+    if (error instanceof Error && "code" in error && error.code === "ERR_MODULE_NOT_FOUND") {
+      return null;
+    }
+    throw error;
+  }
+}
+async function createEnvNotifier(env) {
+  const runtime = await loadNotifyRuntime();
+  if (!runtime) {
     return null;
   }
-  const providers = [];
-  if (env.NOTIFY_TELEGRAM_BOT_TOKEN && env.NOTIFY_TELEGRAM_CHAT_ID) providers.push("telegram");
-  if (env.NOTIFY_WEBHOOK_URL) providers.push("webhook");
-  if (env.NOTIFY_RESEND_API_KEY && env.NOTIFY_RESEND_FROM && env.NOTIFY_RESEND_TO) providers.push("email");
-  console.log(`[notify] Initializing notifier with providers: ${providers.join(", ") || "none"}`);
-  notifierInstance = createNotifier({
-    telegram: env.NOTIFY_TELEGRAM_BOT_TOKEN && env.NOTIFY_TELEGRAM_CHAT_ID ? {
-      botToken: env.NOTIFY_TELEGRAM_BOT_TOKEN,
-      chatId: env.NOTIFY_TELEGRAM_CHAT_ID
-    } : void 0,
-    webhook: env.NOTIFY_WEBHOOK_URL ? {
-      url: env.NOTIFY_WEBHOOK_URL
-    } : void 0,
-    email: env.NOTIFY_RESEND_API_KEY && env.NOTIFY_RESEND_FROM && env.NOTIFY_RESEND_TO ? {
-      provider: "resend",
-      apiKey: env.NOTIFY_RESEND_API_KEY,
-      from: env.NOTIFY_RESEND_FROM,
-      to: env.NOTIFY_RESEND_TO
-    } : void 0
-  });
-  return notifierInstance;
+  const config = runtime.createNotifyConfigFromEnv(env);
+  if (!config.telegram && !config.webhook && !config.email) {
+    return null;
+  }
+  return runtime.createNotifier(config);
 }
 function getMessageText(message) {
   if (Array.isArray(message.parts)) {
@@ -36,30 +26,38 @@ function getMessageText(message) {
   return "";
 }
 function notifyAiChat(options) {
-  const { env, sessionId, messages, aiResponse, referencedArticles, model, usage, timing } = options;
-  const notifier = getNotifier(env);
-  if (!notifier) {
-    console.warn("[notify] AI chat notification skipped: no notifier available. Check environment variables.");
-    return Promise.resolve(null);
-  }
-  const userMessages = messages.filter((m) => m.role === "user");
-  const lastUserMessage = userMessages[userMessages.length - 1];
-  if (!lastUserMessage) {
-    console.warn("[notify] AI chat notification skipped: no user message found in messages array");
-    return Promise.resolve(null);
-  }
-  const userMessage = getMessageText(lastUserMessage);
-  const roundNumber = userMessages.length;
-  return notifier.aiChat({
+  const {
+    env,
     sessionId,
-    roundNumber,
-    userMessage,
-    aiResponse: aiResponse?.slice(0, 500),
+    messages,
+    aiResponse,
     referencedArticles,
     model,
     usage,
-    timing,
-    siteUrl: env.SITE_URL
+    timing
+  } = options;
+  return createEnvNotifier(env).then((notifier) => {
+    if (!notifier) {
+      return null;
+    }
+    const userMessages = messages.filter((m) => m.role === "user");
+    const lastUserMessage = userMessages[userMessages.length - 1];
+    if (!lastUserMessage) {
+      return null;
+    }
+    const userMessage = getMessageText(lastUserMessage);
+    const roundNumber = userMessages.length;
+    return notifier.aiChat({
+      sessionId,
+      roundNumber,
+      userMessage,
+      aiResponse: aiResponse?.slice(0, 500),
+      referencedArticles,
+      model,
+      usage,
+      timing,
+      siteUrl: env.SITE_URL
+    });
   }).catch((error) => {
     console.error("[notify] AI chat notification failed:", error);
     return null;

package/dist/server/prompt-runtime.d.ts

@@ -0,0 +1,60 @@
+import type { ChatContext } from "./types.js";
+import type { PhaseTiming } from "./types.js";
+import type { ProviderAdapter } from "../provider-manager/types.js";
+import type { LoadedExtensions } from "../extensions/types.js";
+import type { SourceSelection } from "../search/types.js";
+import { getCitationGuardPreflight } from "../intelligence/index.js";
+import { searchArticles, searchProjects } from "../search/index.js";
+interface BuildRuntimeSystemPromptArgs {
+    env: Record<string, unknown>;
+    lang: string;
+    searchQuery: string;
+    relatedArticles: ReturnType<typeof searchArticles>;
+    relatedProjects: ReturnType<typeof searchProjects>;
+    evidenceSection?: string;
+    factSection?: string;
+    answerMode?: "fact" | "count" | "list" | "opinion" | "recommendation" | "unknown" | "general";
+    extensions: LoadedExtensions;
+    cacheKey: string | null;
+    voiceStylePrompt?: string;
+    chunksSection?: string;
+    preferInjectedChunks?: boolean;
+}
+export interface PromptAssemblyArgs {
+    env: Record<string, unknown>;
+    latestText: string;
+    context: ChatContext;
+    lang: string;
+    evidenceAnalysisTimeout: number;
+    timing: PhaseTiming & Record<string, number | undefined>;
+    adapter: ProviderAdapter | null;
+    hasRealProvider: boolean;
+    extensions: LoadedExtensions;
+    cacheKey: string | null;
+    searchQuery: string;
+    relatedArticles: ReturnType<typeof searchArticles>;
+    relatedProjects: ReturnType<typeof searchProjects>;
+    budget: {
+        analysisMaxTokens: number;
+    };
+    answerMode: "fact" | "count" | "list" | "opinion" | "recommendation" | "unknown" | "general";
+}
+export interface PromptAssemblyResult {
+    systemPrompt: string;
+    preflight: ReturnType<typeof getCitationGuardPreflight>;
+    unknownRefusal: {
+        text: string;
+        isUnknown: boolean;
+    } | null;
+    selectedSources: SourceSelection[];
+}
+export declare function resolvePromptGuards(args: {
+    latestText: string;
+    relatedArticles: ReturnType<typeof searchArticles>;
+    relatedProjects: ReturnType<typeof searchProjects>;
+    lang: string;
+}): Pick<PromptAssemblyResult, 'preflight' | 'unknownRefusal'>;
+export declare function buildRuntimeSystemPrompt(args: BuildRuntimeSystemPromptArgs): string;
+export declare function assemblePromptRuntime(args: PromptAssemblyArgs): Promise<PromptAssemblyResult>;
+export {};
+//# sourceMappingURL=prompt-runtime.d.ts.map

package/dist/server/prompt-runtime.d.ts.map

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