@astro-minimax/ai 0.9.0 → 0.9.3

package/dist/extensions/index.js

@@ -0,0 +1,24 @@
+export * from "./types.js";
+import { getExtensionRegistry, resetExtensionRegistry } from "./registry.js";
+import { loadExtensions, loadExtensionsFromGlob, registerBuiltInExtensions } from "./loader.js";
+import {
+  resolveVoiceStyleMode,
+  buildVoiceStylePrompt,
+  buildContextSections,
+  getSemanticFallback,
+  mergeSearchDocuments,
+  mergeFacts
+} from "./injector.js";
+export {
+  buildContextSections,
+  buildVoiceStylePrompt,
+  getExtensionRegistry,
+  getSemanticFallback,
+  loadExtensions,
+  loadExtensionsFromGlob,
+  mergeFacts,
+  mergeSearchDocuments,
+  registerBuiltInExtensions,
+  resetExtensionRegistry,
+  resolveVoiceStyleMode
+};

package/dist/extensions/injector.d.ts

@@ -0,0 +1,14 @@
+import type { LoadedExtensions, VoiceStyleMode, PromptContext } from './types.js';
+import type { ArticleContext } from '../search/types.js';
+import type { Fact } from '../fact-registry/types.js';
+export declare function resolveVoiceStyleMode(query: string, categories: string[], extensions: LoadedExtensions): VoiceStyleMode | null;
+export declare function buildVoiceStylePrompt(mode: VoiceStyleMode | null, extensions: LoadedExtensions): string;
+export declare function buildContextSections(context: PromptContext, extensions: LoadedExtensions): string;
+export declare function getSemanticFallback(query: string, extensions: LoadedExtensions): {
+    query: string;
+    primaryQuery?: string;
+    complexity?: string;
+} | null;
+export declare function mergeSearchDocuments(baseDocuments: ArticleContext[], extensions: LoadedExtensions): ArticleContext[];
+export declare function mergeFacts(baseFacts: Fact[], extensions: LoadedExtensions): Fact[];
+//# sourceMappingURL=injector.d.ts.map

package/dist/extensions/injector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injector.d.ts","sourceRoot":"","sources":["../../src/extensions/injector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,aAAa,EAGd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AAEtD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAAE,EACpB,UAAU,EAAE,gBAAgB,GAC3B,cAAc,GAAG,IAAI,CA+BvB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,cAAc,GAAG,IAAI,EAC3B,UAAU,EAAE,gBAAgB,GAC3B,MAAM,CAyBR;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,gBAAgB,GAC3B,MAAM,CAuCR;AASD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,gBAAgB,GAC3B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAsBtE;AAED,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,cAAc,EAAE,EAC/B,UAAU,EAAE,gBAAgB,GAC3B,cAAc,EAAE,CAkBlB;AAED,wBAAgB,UAAU,CACxB,SAAS,EAAE,IAAI,EAAE,EACjB,UAAU,EAAE,gBAAgB,GAC3B,IAAI,EAAE,CAmBR"}

package/dist/extensions/injector.js

@@ -0,0 +1,146 @@
+function resolveVoiceStyleMode(query, categories, extensions) {
+  const voiceStyle = extensions.voiceStyle;
+  if (!voiceStyle || !voiceStyle.modes.length) return null;
+  const lowerQuery = query.toLowerCase();
+  for (const mode of voiceStyle.modes) {
+    if (mode.matchKeywords) {
+      for (const keyword of mode.matchKeywords) {
+        if (lowerQuery.includes(keyword.toLowerCase())) {
+          return mode;
+        }
+      }
+    }
+  }
+  for (const mode of voiceStyle.modes) {
+    if (mode.matchCategories) {
+      for (const category of categories) {
+        if (mode.matchCategories.includes(category)) {
+          return mode;
+        }
+      }
+    }
+  }
+  if (voiceStyle.defaultMode) {
+    return voiceStyle.modes.find((m) => m.id === voiceStyle.defaultMode) ?? null;
+  }
+  return null;
+}
+function buildVoiceStylePrompt(mode, extensions) {
+  const voiceStyle = extensions.voiceStyle;
+  if (!voiceStyle) return "";
+  const lines = ["## \u8BED\u8A00\u98CE\u683C\uFF08L5 style_only\uFF0C\u4EC5\u5F71\u54CD\u8868\u8FBE\uFF09"];
+  if (voiceStyle.overallTone) {
+    lines.push(`\u8BED\u6C14\u57FA\u8C03\uFF1A${voiceStyle.overallTone}`);
+  }
+  if (voiceStyle.frequentExpressions?.length) {
+    const words = voiceStyle.frequentExpressions.slice(0, 6).join("\u3001");
+    lines.push(`\u9AD8\u9891\u8868\u8FBE\uFF1A${words}`);
+  }
+  if (mode) {
+    lines.push("");
+    lines.push(`\u5F53\u524D\u56DE\u7B54\u98CE\u683C\u6A21\u5F0F\uFF1A${mode.description}\uFF08${mode.name}\uFF09`);
+    lines.push("\u672C\u8F6E\u8868\u8FBE\u53C2\u8003\uFF1A");
+    for (const trait of mode.traits.slice(0, 4)) {
+      lines.push(`- ${trait}`);
+    }
+  }
+  return lines.join("\n");
+}
+function buildContextSections(context, extensions) {
+  const sections = [];
+  for (const ctx of extensions.context) {
+    if (ctx.matchCondition) {
+      const { queryPatterns, categories, tags } = ctx.matchCondition;
+      if (queryPatterns?.length) {
+        const matches = queryPatterns.some((p) => p.test(context.userQuery));
+        if (!matches) continue;
+      }
+      if (categories?.length) {
+        const articleCategories = new Set(
+          context.articles.flatMap((a) => a.categories ?? [])
+        );
+        const hasMatch = categories.some((c) => articleCategories.has(c));
+        if (!hasMatch) continue;
+      }
+      if (tags?.length) {
+        const articleTags = new Set(
+          context.articles.flatMap((a) => a.keyPoints ?? [])
+        );
+        const hasMatch = tags.some((t) => articleTags.has(t));
+        if (!hasMatch) continue;
+      }
+    }
+    const content = typeof ctx.content === "function" ? ctx.content(context) : ctx.content;
+    if (content) {
+      sections.push(`## ${ctx.sectionTitle}
+${content}`);
+    }
+  }
+  return sections.join("\n\n");
+}
+function replaceCaptureGroups(template, match) {
+  return template.replace(/\$(\d+)/g, (_, groupIndex) => {
+    const index = parseInt(groupIndex, 10);
+    return match[index] ?? "";
+  });
+}
+function getSemanticFallback(query, extensions) {
+  for (const rule of extensions.semanticFallback) {
+    for (const pattern of rule.patterns) {
+      const match = pattern.exec(query);
+      if (match) {
+        const fallbackQuery = rule.fallbackQuery.includes("$") ? replaceCaptureGroups(rule.fallbackQuery, match) : rule.fallbackQuery;
+        const primaryQuery = rule.primaryQuery?.includes("$") ? replaceCaptureGroups(rule.primaryQuery, match) : rule.primaryQuery;
+        return {
+          query: fallbackQuery,
+          primaryQuery,
+          complexity: rule.complexity
+        };
+      }
+    }
+  }
+  return null;
+}
+function mergeSearchDocuments(baseDocuments, extensions) {
+  const allDocs = [...baseDocuments];
+  for (const [, data] of extensions.searchable) {
+    for (const doc of data.documents) {
+      allDocs.push({
+        title: doc.title,
+        url: doc.url,
+        summary: doc.excerpt,
+        keyPoints: doc.keyPoints ?? [],
+        categories: doc.categories,
+        dateTime: doc.dateTime,
+        score: 0
+      });
+    }
+  }
+  return allDocs;
+}
+function mergeFacts(baseFacts, extensions) {
+  const allFacts = [...baseFacts];
+  for (const [, data] of extensions.facts) {
+    for (const fact of data.facts) {
+      allFacts.push({
+        id: fact.id,
+        category: fact.category,
+        statement: fact.statement,
+        evidence: fact.evidence ?? "",
+        source: "explicit",
+        confidence: fact.confidence,
+        tags: fact.tags,
+        lang: fact.lang
+      });
+    }
+  }
+  return allFacts;
+}
+export {
+  buildContextSections,
+  buildVoiceStylePrompt,
+  getSemanticFallback,
+  mergeFacts,
+  mergeSearchDocuments,
+  resolveVoiceStyleMode
+};

package/dist/extensions/loader.d.ts

@@ -0,0 +1,5 @@
+import type { Extension, LoadedExtensions } from './types.js';
+export declare function loadExtensionsFromGlob(pattern?: string, basePath?: string): Promise<Extension[]>;
+export declare function loadExtensions(pattern?: string, basePath?: string): Promise<LoadedExtensions>;
+export declare function registerBuiltInExtensions(extensions: Extension[]): void;
+//# sourceMappingURL=loader.d.ts.map

package/dist/extensions/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/extensions/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAiB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAK7E,wBAAsB,sBAAsB,CAC1C,OAAO,GAAE,MAAgC,EACzC,QAAQ,GAAE,MAAsB,GAC/B,OAAO,CAAC,SAAS,EAAE,CAAC,CA4BtB;AAED,wBAAsB,cAAc,CAClC,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,gBAAgB,CAAC,CAS3B;AAED,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI,CAMvE"}

package/dist/extensions/loader.js

@@ -0,0 +1,45 @@
+import { getExtensionRegistry } from "./registry.js";
+const DEFAULT_EXTENSIONS_GLOB = "datas/extensions/*.json";
+async function loadExtensionsFromGlob(pattern = DEFAULT_EXTENSIONS_GLOB, basePath = process.cwd()) {
+  const extensions = [];
+  const { glob } = await import("glob");
+  const { readFile } = await import("fs/promises");
+  const { join } = await import("path");
+  const fullPattern = join(basePath, pattern);
+  const files = await glob(fullPattern);
+  for (const file of files) {
+    try {
+      const content = await readFile(file, "utf-8");
+      const parsed = JSON.parse(content);
+      if (parsed.extensions && Array.isArray(parsed.extensions)) {
+        for (const ext of parsed.extensions) {
+          if (ext.enabled !== false) {
+            extensions.push(ext);
+          }
+        }
+      }
+    } catch (err) {
+      console.warn(`[extensions] Failed to load ${file}:`, err);
+    }
+  }
+  return extensions;
+}
+async function loadExtensions(pattern, basePath) {
+  const registry = getExtensionRegistry();
+  const extensions = await loadExtensionsFromGlob(pattern, basePath);
+  for (const ext of extensions) {
+    registry.register(ext);
+  }
+  return registry.getLoadedExtensions();
+}
+function registerBuiltInExtensions(extensions) {
+  const registry = getExtensionRegistry();
+  for (const ext of extensions) {
+    registry.register(ext);
+  }
+}
+export {
+  loadExtensions,
+  loadExtensionsFromGlob,
+  registerBuiltInExtensions
+};

package/dist/extensions/registry.d.ts

@@ -0,0 +1,4 @@
+import type { ExtensionRegistryInterface } from './types.js';
+export declare function getExtensionRegistry(): ExtensionRegistryInterface;
+export declare function resetExtensionRegistry(): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/extensions/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/extensions/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,0BAA0B,EAO3B,MAAM,YAAY,CAAC;AAoKpB,wBAAgB,oBAAoB,IAAI,0BAA0B,CAKjE;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/extensions/registry.js

@@ -0,0 +1,144 @@
+function compilePatterns(patterns) {
+  const compiled = [];
+  const errors = [];
+  for (const pattern of patterns) {
+    try {
+      if (pattern instanceof RegExp) {
+        compiled.push(pattern);
+      } else if (typeof pattern === "string") {
+        compiled.push(new RegExp(pattern, "i"));
+      } else {
+        errors.push(`Invalid pattern type: ${typeof pattern}`);
+      }
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      errors.push(`Failed to compile pattern "${pattern}": ${msg}`);
+    }
+  }
+  return { compiled, errors };
+}
+function mergeVoiceStyleData(existing, newData, newPriority) {
+  if (!existing) {
+    return { ...newData, _highestPriority: newPriority };
+  }
+  const mergedModes = [...existing.modes];
+  const existingModeIds = new Set(existing.modes.map((m) => m.id));
+  for (const mode of newData.modes) {
+    if (!existingModeIds.has(mode.id)) {
+      mergedModes.push(mode);
+    }
+  }
+  const existingPriority = existing._highestPriority ?? 0;
+  return {
+    modes: mergedModes,
+    defaultMode: newData.defaultMode ?? existing.defaultMode,
+    overallTone: newPriority >= existingPriority ? newData.overallTone ?? existing.overallTone : existing.overallTone,
+    frequentExpressions: [
+      ...existing.frequentExpressions ?? [],
+      ...newData.frequentExpressions ?? []
+    ].slice(0, 10),
+    _highestPriority: Math.max(existingPriority, newPriority)
+  };
+}
+class ExtensionRegistry {
+  extensions = /* @__PURE__ */ new Map();
+  loadedCache = null;
+  register(extension) {
+    if (this.extensions.has(extension.id)) {
+      console.warn(`[extensions] Extension "${extension.id}" already registered, overwriting`);
+    }
+    this.extensions.set(extension.id, extension);
+    this.loadedCache = null;
+  }
+  unregister(id) {
+    this.extensions.delete(id);
+    this.loadedCache = null;
+  }
+  get(id) {
+    return this.extensions.get(id);
+  }
+  getAll() {
+    return Array.from(this.extensions.values()).filter((ext) => ext.enabled !== false).sort((a, b) => b.priority - a.priority);
+  }
+  getByType(type) {
+    return this.getAll().filter((ext) => ext.type === type);
+  }
+  getLoadedExtensions() {
+    if (this.loadedCache) {
+      return this.loadedCache;
+    }
+    const result = {
+      searchable: /* @__PURE__ */ new Map(),
+      facts: /* @__PURE__ */ new Map(),
+      context: [],
+      voiceStyle: null,
+      semanticFallback: []
+    };
+    const sorted = this.getAll();
+    for (const ext of sorted) {
+      switch (ext.type) {
+        case "searchable": {
+          result.searchable.set(ext.id, ext.data);
+          break;
+        }
+        case "facts": {
+          result.facts.set(ext.id, ext.data);
+          break;
+        }
+        case "context": {
+          result.context.push(ext.data);
+          break;
+        }
+        case "voice-style": {
+          result.voiceStyle = mergeVoiceStyleData(
+            result.voiceStyle,
+            ext.data,
+            ext.priority
+          );
+          break;
+        }
+        case "semantic-fallback": {
+          const rulesData = ext.data;
+          for (const rule of rulesData.rules) {
+            const { compiled, errors } = compilePatterns(rule.patterns);
+            if (errors.length > 0) {
+              for (const err of errors) {
+                console.warn(`[extensions] ${ext.id}/${rule.id}: ${err}`);
+              }
+            }
+            if (compiled.length > 0) {
+              result.semanticFallback.push({
+                id: rule.id,
+                patterns: compiled,
+                fallbackQuery: rule.fallbackQuery,
+                primaryQuery: rule.primaryQuery,
+                complexity: rule.complexity
+              });
+            }
+          }
+          break;
+        }
+      }
+    }
+    this.loadedCache = result;
+    return result;
+  }
+  clear() {
+    this.extensions.clear();
+    this.loadedCache = null;
+  }
+}
+let globalRegistry = null;
+function getExtensionRegistry() {
+  if (!globalRegistry) {
+    globalRegistry = new ExtensionRegistry();
+  }
+  return globalRegistry;
+}
+function resetExtensionRegistry() {
+  globalRegistry = null;
+}
+export {
+  getExtensionRegistry,
+  resetExtensionRegistry
+};

package/dist/extensions/types.d.ts

@@ -0,0 +1,126 @@
+import type { ArticleContext, ProjectContext } from '../search/types.js';
+export type ExtensionType = 'searchable' | 'facts' | 'context' | 'voice-style' | 'semantic-fallback';
+export interface ExtensionSearchDocument {
+    id: string;
+    title: string;
+    url: string;
+    excerpt: string;
+    content: string;
+    categories: string[];
+    dateTime: number;
+    keyPoints?: string[];
+}
+export interface SearchableData {
+    documents: ExtensionSearchDocument[];
+    reranking?: {
+        positiveTerms?: string[];
+        negativeTerms?: string[];
+        categoryBoost?: Record<string, number>;
+    };
+}
+export interface FactEntry {
+    id: string;
+    category: string;
+    statement: string;
+    evidence?: string;
+    confidence: number;
+    tags: string[];
+    lang: string;
+    attributes?: Record<string, unknown>;
+}
+export interface FactsData {
+    facts: FactEntry[];
+    categories?: CategoryDefinition[];
+}
+export interface CategoryDefinition {
+    id: string;
+    name: string;
+    keywords: string[];
+}
+export interface PromptContext {
+    userQuery: string;
+    lang: string;
+    articles: ArticleContext[];
+    projects: ProjectContext[];
+}
+export interface ContextData {
+    sectionTitle: string;
+    content: string | ((context: PromptContext) => string);
+    position: 'before-articles' | 'after-articles' | 'before-facts' | 'after-facts';
+    matchCondition?: {
+        queryPatterns?: RegExp[];
+        categories?: string[];
+        tags?: string[];
+    };
+}
+export interface VoiceStyleMode {
+    id: string;
+    name: string;
+    description: string;
+    matchKeywords?: string[];
+    matchCategories?: string[];
+    traits: string[];
+}
+export interface VoiceStyleData {
+    modes: VoiceStyleMode[];
+    defaultMode?: string;
+    overallTone?: string;
+    frequentExpressions?: string[];
+    _highestPriority?: number;
+}
+export interface SemanticFallbackRule {
+    id: string;
+    patterns: RegExp[];
+    fallbackQuery: string;
+    primaryQuery?: string;
+    complexity?: 'simple' | 'moderate' | 'complex';
+}
+export interface SemanticFallbackData {
+    rules: SemanticFallbackRule[];
+}
+export type ExtensionData = SearchableData | FactsData | ContextData | VoiceStyleData | SemanticFallbackData;
+export interface Extension<T extends ExtensionData = ExtensionData> {
+    id: string;
+    type: ExtensionType;
+    name: string;
+    description?: string;
+    enabled?: boolean;
+    priority: number;
+    data: T;
+}
+export interface ExtensionFile {
+    $schema: string;
+    version: number;
+    extensions: Extension[];
+}
+export interface LoadedExtensions {
+    searchable: Map<string, SearchableData>;
+    facts: Map<string, FactsData>;
+    context: ContextData[];
+    voiceStyle: VoiceStyleData | null;
+    semanticFallback: SemanticFallbackRule[];
+}
+export interface ExtensionContext {
+    userQuery: string;
+    lang: string;
+    articles: ArticleContext[];
+    projects: ProjectContext[];
+    abortSignal?: AbortSignal;
+}
+export interface ExtensionResult<T = unknown> {
+    extensionId: string;
+    timestamp: number;
+    data: T | null;
+    error?: string;
+    cacheHit: boolean;
+}
+export interface ExtensionRegistryInterface {
+    register<T extends ExtensionData>(extension: Extension<T>): void;
+    unregister(id: string): void;
+    get<T extends ExtensionData>(id: string): Extension<T> | undefined;
+    getAll(): Extension[];
+    getByType(type: ExtensionType): Extension[];
+    getLoadedExtensions(): LoadedExtensions;
+    clear(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/extensions/types.d.ts.map

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

package/dist/fact-registry/prompt-injector.d.ts

@@ -1,4 +1,4 @@
-import type { Fact } from './types.js';
+import type { Fact } from "./types.js";
 /**
  * Formats matched facts into a prompt section ready for injection.
  * Groups facts by category with clear structure.

package/dist/fact-registry/prompt-injector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-injector.d.ts","sourceRoot":"","sources":["../../src/fact-registry/prompt-injector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAgB,MAAM,YAAY,CAAC;AAgCrD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,IAAI,GAAE,MAAa,GAAG,MAAM,CA+B3E"}
+{"version":3,"file":"prompt-injector.d.ts","sourceRoot":"","sources":["../../src/fact-registry/prompt-injector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAgB,MAAM,YAAY,CAAC;AAgCrD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,IAAI,GAAE,MAAa,GAAG,MAAM,CA+B3E"}

package/dist/fact-registry/prompt-injector.js

@@ -1,3 +1,4 @@
+import { getLang } from "../utils/i18n.js";
 const CATEGORY_LABELS = {
   zh: {
     author: "\u5173\u4E8E\u4F5C\u8005",
@@ -26,7 +27,7 @@ const SECTION_TEXT = {
 };
 function buildFactSection(facts, lang = "zh") {
   if (!facts.length) return "";
-  const l = lang === "zh" ? "zh" : "en";
+  const l = getLang(lang);
   const labels = CATEGORY_LABELS[l];
   const text = SECTION_TEXT[l];
   const grouped = /* @__PURE__ */ new Map();

package/dist/index.d.ts

@@ -6,7 +6,6 @@
  *
  * @packageDocumentation
  */
-export * from './providers/index.js';
 export * from './provider-manager/index.js';
 export * from './middleware/index.js';
 export * from './cache/index.js';
@@ -15,6 +14,8 @@ export * from './intelligence/index.js';
 export * from './prompt/index.js';
 export * from './data/index.js';
 export * from './fact-registry/index.js';
-export * from './stream/index.js';
 export * from './server/index.js';
+export * from './structured-output/index.js';
+export * from './extensions/index.js';
+export * from './tools/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,sBAAsB,CAAC;AAGrC,cAAc,6BAA6B,CAAC;AAG5C,cAAc,uBAAuB,CAAC;AAGtC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,6BAA6B,CAAC;AAG5C,cAAc,uBAAuB,CAAC;AAGtC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,mBAAmB,CAAC;AAElC,cAAc,8BAA8B,CAAC;AAE7C,cAAc,uBAAuB,CAAC;AAEtC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,4 +1,3 @@
-export * from "./providers/index.js";
 export * from "./provider-manager/index.js";
 export * from "./middleware/index.js";
 export * from "./cache/index.js";
@@ -7,5 +6,7 @@ export * from "./intelligence/index.js";
 export * from "./prompt/index.js";
 export * from "./data/index.js";
 export * from "./fact-registry/index.js";
-export * from "./stream/index.js";
 export * from "./server/index.js";
+export * from "./structured-output/index.js";
+export * from "./extensions/index.js";
+export * from "./tools/index.js";

package/dist/intelligence/citation-guard.d.ts

@@ -1,29 +1,18 @@
 import type { ArticleContext, ProjectContext } from '../search/types.js';
 import type { CitationGuardPreflight, CitationGuardAction } from './types.js';
 export type AnswerMode = 'fact' | 'count' | 'list' | 'opinion' | 'recommendation' | 'unknown' | 'general';
-/**
- * Resolves the expected answer mode from the user query.
- * Helps the system decide how to structure the response.
- */
 export declare function resolveAnswerMode(query: string): AnswerMode;
-/**
- * Pre-flight check: if the user is asking about something that can be
- * answered directly from the available context without an LLM, return it.
- * This prevents hallucination for specific factual queries.
- */
+export declare function buildUnknownRefusal(query: string, lang?: string): string;
 export declare function getCitationGuardPreflight(params: {
     userQuery: string;
     articles: ArticleContext[];
     projects: ProjectContext[];
     lang?: string;
 }): CitationGuardPreflight | null;
-/**
- * Creates a transform stream that monitors the AI output for hallucinated references.
- * Rewrites or suppresses fabricated article/project links.
- */
 export declare function createCitationGuardTransform(params: {
     articles: ArticleContext[];
     projects: ProjectContext[];
+    siteUrl?: string;
     onApplied?: (result: {
         actions: CitationGuardAction[];
     }) => void;

package/dist/intelligence/citation-guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"citation-guard.d.ts","sourceRoot":"","sources":["../../src/intelligence/citation-guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAS9E,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAC;AAgB1G;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAS3D;AAoBD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,sBAAsB,GAAG,IAAI,CAuBhC;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACnD,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,mBAAmB,EAAE,CAAA;KAAE,KAAK,IAAI,CAAC;CAClE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,KAAK,cAAc,CAAC,MAAM,CAAC,CAuD7D"}
+{"version":3,"file":"citation-guard.d.ts","sourceRoot":"","sources":["../../src/intelligence/citation-guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAU9E,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAC;AAkB1G,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAW3D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAa,GAAG,MAAM,CAuB9E;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,sBAAsB,GAAG,IAAI,CAsBhC;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACnD,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,mBAAmB,EAAE,CAAA;KAAE,KAAK,IAAI,CAAC;CAClE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,KAAK,cAAc,CAAC,MAAM,CAAC,CAsE7D"}