@astro-minimax/ai 0.9.0 → 0.9.3

package/dist/provider-manager/manager.d.ts

@@ -1,4 +1,5 @@
 import type { ProviderAdapter, ProviderManagerEnv, ProviderManagerOptions, ProviderStatus, StreamTextOptions, StreamTextResult } from './types.js';
+import { MockAdapter } from './mock.js';
 export declare class ProviderManager {
     private providers;
     private mockAdapter;
@@ -12,7 +13,15 @@ export declare class ProviderManager {
     hasProviders(): boolean;
     getProviderCount(): number;
     getAvailableAdapter(): Promise<ProviderAdapter | null>;
+    /**
+     * Returns all available adapters in priority order.
+     * Used for implementing multi-provider failover in streaming contexts.
+     */
+    getAvailableAdapters(): Promise<ProviderAdapter[]>;
+    /**
+     * Returns the mock adapter for fallback scenarios.
+     */
+    getMockAdapter(): MockAdapter;
 }
 export declare function getProviderManager(env: ProviderManagerEnv, options?: ProviderManagerOptions): ProviderManager;
-export declare function resetProviderManager(): void;
 //# sourceMappingURL=manager.d.ts.map

package/dist/provider-manager/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/provider-manager/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEf,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AAMpB,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,OAAO,CAA0L;gBAE7L,GAAG,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,sBAAsB;IAcrE,OAAO,CAAC,mBAAmB;IAyB3B,OAAO,CAAC,aAAa;IAWf,oBAAoB,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IASvD,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqCvE,iBAAiB,IAAI,cAAc,EAAE;IAWrC,YAAY,IAAI,OAAO;IAIvB,gBAAgB,IAAI,MAAM;IAIpB,mBAAmB,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;CAG7D;AAID,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,eAAe,CAK7G;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/provider-manager/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEf,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,OAAO,CAA0L;gBAE7L,GAAG,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,sBAAsB;IAcrE,OAAO,CAAC,mBAAmB;IAyB3B,OAAO,CAAC,aAAa;IAWf,oBAAoB,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IASvD,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2CvE,iBAAiB,IAAI,cAAc,EAAE;IAWrC,YAAY,IAAI,OAAO;IAIvB,gBAAgB,IAAI,MAAM;IAIpB,mBAAmB,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAI5D;;;OAGG;IACG,oBAAoB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAUxD;;OAEG;IACH,cAAc,IAAI,WAAW;CAG9B;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,kBAAkB,EACvB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,eAAe,CAEjB"}

package/dist/provider-manager/manager.js

@@ -60,11 +60,16 @@ class ProviderManager {
     let lastProviderId = null;
     let lastError = null;
     for (const provider of this.providers) {
+      const wasInRecovery = provider.isInRecovery?.() ?? false;
       const isAvailable = await provider.isAvailable();
       if (!isAvailable) continue;
       try {
         const result = await provider.streamText(options);
         provider.recordSuccess();
+        if (wasInRecovery) {
+          provider.markAsRecovered?.();
+          this.options.onHealthChange?.(provider.id, true);
+        }
         if (lastProviderId && lastProviderId !== provider.id) {
           this.options.onProviderSwitch?.(lastProviderId, provider.id, "fallback success");
         }
@@ -104,19 +109,30 @@ class ProviderManager {
   async getAvailableAdapter() {
     return this.getAvailableProvider();
   }
-}
-let managerInstance = null;
-function getProviderManager(env, options) {
-  if (!managerInstance) {
-    managerInstance = new ProviderManager(env, options);
+  /**
+   * Returns all available adapters in priority order.
+   * Used for implementing multi-provider failover in streaming contexts.
+   */
+  async getAvailableAdapters() {
+    const available = [];
+    for (const provider of this.providers) {
+      if (await provider.isAvailable()) {
+        available.push(provider);
+      }
+    }
+    return available;
+  }
+  /**
+   * Returns the mock adapter for fallback scenarios.
+   */
+  getMockAdapter() {
+    return this.mockAdapter;
   }
-  return managerInstance;
 }
-function resetProviderManager() {
-  managerInstance = null;
+function getProviderManager(env, options) {
+  return new ProviderManager(env, options);
 }
 export {
   ProviderManager,
-  getProviderManager,
-  resetProviderManager
+  getProviderManager
 };

package/dist/provider-manager/openai.d.ts

@@ -1,5 +1,5 @@
-import type { OpenAIProviderConfig, StreamTextOptions, StreamTextResult } from './types.js';
-import { BaseProviderAdapter } from './base.js';
+import type { OpenAIProviderConfig, StreamTextOptions, StreamTextResult } from "./types.js";
+import { BaseProviderAdapter } from "./base.js";
 export declare class OpenAIAdapter extends BaseProviderAdapter {
     readonly id: string;
     readonly type: "openai";

package/dist/provider-manager/openai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/provider-manager/openai.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAgDhD,qBAAa,aAAc,SAAQ,mBAAmB;IACpD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,OAAO,CAAC,QAAQ,CAA4C;IAC5D,OAAO,CAAC,MAAM,CAAuB;gBAEzB,MAAM,EAAE,oBAAoB;IAuBlC,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyCvE,SAAS,IAAI,oBAAoB;IAIjC,WAAW,IAAI;QAAE,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;KAAE;CAGzD"}
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/provider-manager/openai.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AA0DhD,qBAAa,aAAc,SAAQ,mBAAmB;IACpD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,OAAO,CAAC,QAAQ,CAA4C;IAC5D,OAAO,CAAC,MAAM,CAAuB;gBAEzB,MAAM,EAAE,oBAAoB;IAuBlC,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoDvE,SAAS,IAAI,oBAAoB;IAIjC,WAAW,IAAI;QAAE,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;KAAE;CAGzD"}

package/dist/provider-manager/openai.js

@@ -14,14 +14,19 @@ async function setupGlobalProxy() {
   try {
     const undici = await import("undici");
     if (typeof undici.setGlobalDispatcher !== "function" || typeof undici.ProxyAgent !== "function") {
-      console.log("[OpenAIAdapter] undici APIs not available, skipping proxy setup (likely Edge Runtime)");
+      console.log(
+        "[OpenAIAdapter] undici APIs not available, skipping proxy setup (likely Edge Runtime)"
+      );
       return;
     }
     undici.setGlobalDispatcher(new undici.ProxyAgent(proxyUrl));
     console.log("[OpenAIAdapter] Global proxy dispatcher set:", proxyUrl);
     proxyInitialized = true;
   } catch (e) {
-    console.log("[OpenAIAdapter] Proxy setup skipped:", e instanceof Error ? e.message : String(e));
+    console.log(
+      "[OpenAIAdapter] Proxy setup skipped:",
+      e instanceof Error ? e.message : String(e)
+    );
   }
 }
 let proxySetupPromise = null;
@@ -43,7 +48,7 @@ class OpenAIAdapter extends BaseProviderAdapter {
   config;
   constructor(config) {
     super({
-      unhealthyThreshold: config.maxRetries ? config.maxRetries + 2 : 3
+      unhealthyThreshold: config.unhealthyThreshold ?? 3
     });
     this.id = config.id;
     this.weight = config.weight ?? 100;
@@ -63,7 +68,16 @@ class OpenAIAdapter extends BaseProviderAdapter {
   }
   async streamText(options) {
     await ensureProxySetup();
-    const { system, messages, temperature = 0.7, maxOutputTokens, topP, abortSignal, onError } = options;
+    const {
+      system,
+      messages,
+      temperature = 0.7,
+      maxOutputTokens,
+      topP,
+      abortSignal,
+      onError,
+      tools
+    } = options;
     const abortController = new AbortController();
     const timeoutId = setTimeout(() => abortController.abort(), this.timeout);
     if (abortSignal) {
@@ -77,6 +91,7 @@ class OpenAIAdapter extends BaseProviderAdapter {
         temperature,
         maxOutputTokens,
         topP,
+        tools,
         abortSignal: abortController.signal,
         onError: ({ error }) => {
           onError?.(error instanceof Error ? error : new Error(String(error)));

package/dist/provider-manager/types.d.ts

@@ -3,28 +3,24 @@
  *
  * Supports multiple provider types with priority-based fallback.
  */
-import type { UIMessage } from 'ai';
+import type { UIMessage, ToolSet } from "ai";
 /**
  * Base configuration shared by all provider types.
  */
 export interface BaseProviderConfig {
-    /** Unique identifier for this provider instance */
     id: string;
-    /** Provider type */
-    type: 'openai' | 'workers';
-    /** Priority weight (higher = more preferred). Default: 100 */
+    type: "openai" | "workers";
     weight?: number;
-    /** Default model for chat */
     model: string;
-    /** Model for keyword extraction (optional, defaults to model) */
     keywordModel?: string;
-    /** Model for evidence analysis (optional, defaults to keywordModel) */
     evidenceModel?: string;
-    /** Request timeout in milliseconds. Default: 30000 */
     timeout?: number;
-    /** Max retries on failure. Default: 0 (no retry, fallback to next provider) */
-    maxRetries?: number;
-    /** Enable this provider. Default: true */
+    /**
+     * Number of consecutive failures before marking provider unhealthy.
+     * Default: 3. Note: This is NOT retry count - provider will be skipped
+     * after this many failures, not retried.
+     */
+    unhealthyThreshold?: number;
     enabled?: boolean;
 }
 /**
@@ -32,7 +28,7 @@ export interface BaseProviderConfig {
  * Supports DeepSeek, Moonshot, Qwen, OpenAI, and any OpenAI-compatible API.
  */
 export interface OpenAIProviderConfig extends BaseProviderConfig {
-    type: 'openai';
+    type: "openai";
     /** API base URL (e.g., https://api.deepseek.com/v1) */
     baseURL: string;
     /** API key */
@@ -43,7 +39,7 @@ export interface OpenAIProviderConfig extends BaseProviderConfig {
  * Uses AI binding directly from the Cloudflare environment.
  */
 export interface WorkersAIProviderConfig extends BaseProviderConfig {
-    type: 'workers';
+    type: "workers";
     /** AI binding name in Cloudflare environment. Default: 'minimaxAI' */
     bindingName: string;
 }
@@ -95,7 +91,7 @@ export interface ProviderStatus {
     /** Provider ID */
     id: string;
     /** Provider type */
-    type: 'openai' | 'workers' | 'mock';
+    type: string;
     /** Priority weight */
     weight: number;
     /** Whether the provider is enabled */
@@ -127,6 +123,8 @@ export interface StreamTextOptions {
     userQuestion?: string;
     /** Callback for errors during streaming */
     onError?: (error: Error) => void;
+    /** Tools for function calling */
+    tools?: ToolSet;
 }
 /**
  * Result from streamText operation.
@@ -175,39 +173,21 @@ export interface ProviderManagerOptions {
  * All provider types must implement this interface.
  */
 export interface ProviderAdapter {
-    /** Provider identifier */
     readonly id: string;
-    /** Provider type */
-    readonly type: 'openai' | 'workers' | 'mock';
-    /** Priority weight */
+    readonly type: string;
     readonly weight: number;
-    /** Default model */
     readonly model: string;
-    /** Model for keyword extraction */
     readonly keywordModel: string;
-    /** Model for evidence analysis */
     readonly evidenceModel: string;
-    /** Request timeout in ms */
     readonly timeout: number;
-    /**
-     * Check if this provider is currently available and healthy.
-     */
     isAvailable(): Promise<boolean>;
-    /**
-     * Stream text generation.
-     */
+    isInRecovery?(): boolean;
+    canAttemptRecovery?(): boolean;
+    markAsRecovered?(): void;
+    resetHealth?(): void;
     streamText(options: StreamTextOptions): Promise<StreamTextResult>;
-    /**
-     * Get current health status.
-     */
     getHealth(): ProviderHealth;
-    /**
-     * Record a successful request.
-     */
     recordSuccess(): void;
-    /**
-     * Record a failed request.
-     */
     recordFailure(error: Error): void;
     getProvider(): {
         chatModel: (model: string) => unknown;

package/dist/provider-manager/types.d.ts.map

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

package/dist/provider-manager/workers.d.ts

@@ -1,5 +1,5 @@
-import type { WorkersAIProviderConfig, StreamTextOptions, StreamTextResult, ProviderManagerEnv } from './types.js';
-import { BaseProviderAdapter } from './base.js';
+import type { WorkersAIProviderConfig, StreamTextOptions, StreamTextResult, ProviderManagerEnv } from "./types.js";
+import { BaseProviderAdapter } from "./base.js";
 export declare class WorkersAIAdapter extends BaseProviderAdapter {
     readonly id: string;
     readonly type: "workers";

package/dist/provider-manager/workers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workers.d.ts","sourceRoot":"","sources":["../../src/provider-manager/workers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACnH,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,qBAAa,gBAAiB,SAAQ,mBAAmB;IACvD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAGzB,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,MAAM,CAA0B;gBAE5B,MAAM,EAAE,uBAAuB,EAAE,GAAG,EAAE,kBAAkB;IAqB9D,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyCvE,SAAS,IAAI,uBAAuB;IAIpC,WAAW,IAAI;QAAE,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;KAAE;CAKzD"}
+{"version":3,"file":"workers.d.ts","sourceRoot":"","sources":["../../src/provider-manager/workers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,qBAAa,gBAAiB,SAAQ,mBAAmB;IACvD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,MAAM,CAA0B;gBAE5B,MAAM,EAAE,uBAAuB,EAAE,GAAG,EAAE,kBAAkB;IAwB9D,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoDvE,SAAS,IAAI,uBAAuB;IAIpC,WAAW,IAAI;QAAE,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;KAAE;CAMzD"}

package/dist/provider-manager/workers.js

@@ -9,12 +9,11 @@ class WorkersAIAdapter extends BaseProviderAdapter {
   keywordModel;
   evidenceModel;
   timeout;
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   provider;
   config;
   constructor(config, env) {
     super({
-      unhealthyThreshold: config.maxRetries ? config.maxRetries + 2 : 3
+      unhealthyThreshold: config.unhealthyThreshold ?? 3
     });
     this.id = config.id;
     this.weight = config.weight ?? 90;
@@ -25,12 +24,23 @@ class WorkersAIAdapter extends BaseProviderAdapter {
     this.config = config;
     const binding = env[config.bindingName];
     if (!binding) {
-      throw new Error(`Workers AI binding '${config.bindingName}' not found in environment`);
+      throw new Error(
+        `Workers AI binding '${config.bindingName}' not found in environment`
+      );
     }
     this.provider = createWorkersAI({ binding });
   }
   async streamText(options) {
-    const { system, messages, temperature = 0.7, maxOutputTokens, topP, abortSignal, onError } = options;
+    const {
+      system,
+      messages,
+      temperature = 0.7,
+      maxOutputTokens,
+      topP,
+      abortSignal,
+      onError,
+      tools
+    } = options;
     const abortController = new AbortController();
     const timeoutId = setTimeout(() => abortController.abort(), this.timeout);
     if (abortSignal) {
@@ -45,6 +55,7 @@ class WorkersAIAdapter extends BaseProviderAdapter {
         temperature,
         maxOutputTokens,
         topP,
+        tools,
         abortSignal: abortController.signal,
         onError: ({ error }) => {
           onError?.(error instanceof Error ? error : new Error(String(error)));

package/dist/query/followup.d.ts

@@ -0,0 +1,7 @@
+import type { SearchContextReuseParams } from "./types.js";
+export declare function isLikelyFollowUp(message: string): boolean;
+export declare function hasNewSignificantTokens(currentQuery: string, cachedQuery: string): boolean;
+export declare function hasQueryOverlap(currentQuery: string, cachedQuery: string): boolean;
+export declare function shouldReuseSearchContext(params: SearchContextReuseParams): boolean;
+export declare function buildLocalSearchQuery(latestText: string): string;
+//# sourceMappingURL=followup.d.ts.map

package/dist/query/followup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"followup.d.ts","sourceRoot":"","sources":["../../src/query/followup.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAI3D,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAUzD;AAED,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,OAAO,CAOT;AAED,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,OAAO,CAKT;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAST;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/dist/query/followup.js

@@ -0,0 +1,46 @@
+import { tokenize, normalizeText } from "../utils/text.js";
+import { CACHE } from "../constants.js";
+const MAX_FOLLOW_UP_LENGTH = 48;
+function isLikelyFollowUp(message) {
+  const text = message.trim();
+  if (!text || text.length > MAX_FOLLOW_UP_LENGTH) return false;
+  const hasTerminalPunctuation = /[?？!！。.…]$/.test(text);
+  const wordCount = text.split(/\s+/).filter(Boolean).length;
+  if (text.length <= 16) return true;
+  if (!/\s/.test(text) && text.length <= 24) return true;
+  return hasTerminalPunctuation && wordCount <= 6 && text.length <= 36;
+}
+function hasNewSignificantTokens(currentQuery, cachedQuery) {
+  const currentTokens = new Set(tokenize(currentQuery));
+  const cachedTokens = new Set(tokenize(cachedQuery));
+  const newTokens = [...currentTokens].filter(
+    (t) => !cachedTokens.has(t) && t.length >= 2
+  );
+  return newTokens.length > 0;
+}
+function hasQueryOverlap(currentQuery, cachedQuery) {
+  const currentTokens = tokenize(currentQuery);
+  const cachedNorm = normalizeText(cachedQuery);
+  if (!currentTokens.length || !cachedNorm) return false;
+  return currentTokens.some((t) => cachedNorm.includes(t));
+}
+function shouldReuseSearchContext(params) {
+  const { latestText, cachedContext, userTurnCount, now } = params;
+  if (!cachedContext) return false;
+  if (userTurnCount <= 1) return false;
+  if (now - cachedContext.updatedAt > CACHE.SESSION_TTL * 1e3) return false;
+  if (!isLikelyFollowUp(latestText)) return false;
+  if (!hasQueryOverlap(latestText, cachedContext.query)) return false;
+  if (hasNewSignificantTokens(latestText, cachedContext.query)) return false;
+  return true;
+}
+function buildLocalSearchQuery(latestText) {
+  return tokenize(latestText).join(" ");
+}
+export {
+  buildLocalSearchQuery,
+  hasNewSignificantTokens,
+  hasQueryOverlap,
+  isLikelyFollowUp,
+  shouldReuseSearchContext
+};

package/dist/query/intent.d.ts

@@ -0,0 +1,6 @@
+import type { ArticleContext } from "../search/types.js";
+import type { QueryIntentCategory } from "./types.js";
+export declare function classifyIntent(query: string): QueryIntentCategory;
+export declare function rankArticlesByIntent(query: string, articles: ArticleContext[]): ArticleContext[];
+export declare function rankArticlesByCategory(intent: QueryIntentCategory, articles: ArticleContext[]): ArticleContext[];
+//# sourceMappingURL=intent.d.ts.map

package/dist/query/intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../src/query/intent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AA+FtD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAoBjE;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,cAAc,EAAE,GACzB,cAAc,EAAE,CAGlB;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,EAAE,cAAc,EAAE,GACzB,cAAc,EAAE,CAgClB"}

package/dist/query/intent.js

@@ -0,0 +1,137 @@
+const INTENT_KEYWORDS = {
+  setup: [
+    "\u642D\u5EFA",
+    "\u521B\u5EFA",
+    "\u5B89\u88C5",
+    "install",
+    "setup",
+    "create",
+    "init",
+    "scaffold",
+    "\u65B0\u5EFA",
+    "\u5F00\u59CB"
+  ],
+  config: [
+    "\u914D\u7F6E",
+    "\u8BBE\u7F6E",
+    "config",
+    "settings",
+    "\u73AF\u5883\u53D8\u91CF",
+    ".env",
+    "wrangler",
+    "tsconfig",
+    "\u4E3B\u9898\u8272",
+    "\u989C\u8272"
+  ],
+  content: [
+    "\u6587\u7AE0",
+    "\u535A\u5BA2",
+    "\u5199\u4F5C",
+    "markdown",
+    "mdx",
+    "\u6807\u7B7E",
+    "\u5206\u7C7B",
+    "\u6458\u8981",
+    "\u5C01\u9762",
+    "\u7FFB\u8BD1"
+  ],
+  feature: [
+    "\u529F\u80FD",
+    "\u7279\u6027",
+    "feature",
+    "\u652F\u6301",
+    "AI",
+    "RAG",
+    "\u641C\u7D22",
+    "\u8BC4\u8BBA",
+    "RSS",
+    "\u6697\u8272",
+    "\u6DF1\u8272"
+  ],
+  deployment: [
+    "\u90E8\u7F72",
+    "deploy",
+    "cloudflare",
+    "vercel",
+    "netlify",
+    "build",
+    "\u6784\u5EFA",
+    "CI",
+    "CD"
+  ],
+  troubleshooting: [
+    "\u62A5\u9519",
+    "\u9519\u8BEF",
+    "error",
+    "bug",
+    "\u95EE\u9898",
+    "\u4E0D\u5DE5\u4F5C",
+    "\u5931\u8D25",
+    "fail",
+    "\u4FEE\u590D",
+    "fix"
+  ],
+  general: []
+};
+function countKeywordHits(text, keywords) {
+  if (!text) return 0;
+  const lower = text.toLowerCase();
+  return keywords.reduce(
+    (hits, kw) => hits + (lower.includes(kw.toLowerCase()) ? 1 : 0),
+    0
+  );
+}
+function isRecent(dateTime) {
+  if (!dateTime || !Number.isFinite(dateTime)) return false;
+  return Date.now() - dateTime <= 365 * 24 * 60 * 60 * 1e3;
+}
+function classifyIntent(query) {
+  const q = query.toLowerCase();
+  const scores = {};
+  for (const [intent, keywords] of Object.entries(INTENT_KEYWORDS)) {
+    if (intent === "general") continue;
+    const score = keywords.reduce(
+      (acc, kw) => acc + (q.includes(kw.toLowerCase()) ? 1 : 0),
+      0
+    );
+    if (score > 0) scores[intent] = score;
+  }
+  const sorted = Object.entries(scores).sort(
+    (a, b) => b[1] - a[1]
+  );
+  return sorted[0]?.[0] || "general";
+}
+function rankArticlesByIntent(query, articles) {
+  const intent = classifyIntent(query);
+  return rankArticlesByCategory(intent, articles);
+}
+function rankArticlesByCategory(intent, articles) {
+  if (intent === "general" || articles.length <= 1) return articles;
+  const keywords = INTENT_KEYWORDS[intent];
+  if (!keywords.length) return articles;
+  const scored = articles.map((article, index) => {
+    const titleHit = countKeywordHits(article.title, keywords) > 0 ? 3 : 0;
+    const categoryHit = (article.categories ?? []).some(
+      (c) => countKeywordHits(c, keywords) > 0
+    ) ? 2 : 0;
+    const summaryHit = countKeywordHits(article.summary, keywords) > 0 ? 2 : 0;
+    const keyPointHit = article.keyPoints.some(
+      (kp) => countKeywordHits(kp, keywords) > 0
+    ) ? 1 : 0;
+    const recentHit = isRecent(article.dateTime) ? 1 : 0;
+    return {
+      article,
+      index,
+      score: titleHit + categoryHit + summaryHit + keyPointHit + recentHit
+    };
+  });
+  const maxScore = Math.max(...scored.map((s) => s.score), 0);
+  if (maxScore === 0) return articles;
+  scored.sort((a, b) => b.score - a.score || a.index - b.index);
+  return scored.map((s) => s.article);
+}
+export {
+  classifyIntent,
+  rankArticlesByCategory,
+  rankArticlesByIntent
+};

package/dist/query/types.d.ts

@@ -0,0 +1,8 @@
+export type QueryIntentCategory = "setup" | "config" | "content" | "feature" | "deployment" | "troubleshooting" | "general";
+export interface SearchContextReuseParams {
+    latestText: string;
+    cachedContext: import("../search/types.js").CachedSearchContext | undefined;
+    userTurnCount: number;
+    now: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/query/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAC3B,OAAO,GACP,QAAQ,GACR,SAAS,GACT,SAAS,GACT,YAAY,GACZ,iBAAiB,GACjB,SAAS,CAAC;AAEd,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,OAAO,oBAAoB,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC5E,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb"}