chat-agent-toolkit 1.2.367 → 1.2.369

package/src/tools/search/search-handlers.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @module research/search/index
+ * @description Research library module.
+ *
+ * Note: To use these search handlers, you need to provide search functions
+ * (searchSearxng, searchTavily, etc.) from search-web-api package.
+ */
+import MetaSearchAgent from "./metaSearchAgent";
+import type { Config } from "./meta-search-types";
+/**
+ * Creates search handler instances with provided search functions.
+ * Pass in search functions from extract-webpage to enable web search.
+ */
+export declare const createSearchHandlers: (searchFunctions?: Partial<Config>) => {
+    webSearch: MetaSearchAgent;
+    academicSearch: MetaSearchAgent;
+    writingAssistant: MetaSearchAgent;
+    wolframAlphaSearch: MetaSearchAgent;
+    youtubeSearch: MetaSearchAgent;
+    redditSearch: MetaSearchAgent;
+};
+/**
+ * Default search handlers without search functions.
+ * These will not perform actual web searches unless search functions are added to the Config.
+ * @deprecated Use createSearchHandlers() with search functions instead
+ */
+export declare const searchHandlers: {
+    webSearch: MetaSearchAgent;
+    academicSearch: MetaSearchAgent;
+    writingAssistant: MetaSearchAgent;
+    wolframAlphaSearch: MetaSearchAgent;
+    youtubeSearch: MetaSearchAgent;
+    redditSearch: MetaSearchAgent;
+};

package/src/tools/search/suggestionGeneratorAgent.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @module research/chains/suggestionGeneratorAgent
+ * @description Generates follow-up question suggestions from a conversation
+ * using the Vercel AI SDK.
+ */
+import { type LanguageModel } from "ai";
+import type { ChatTurnMessage } from "./meta-search-types";
+type SuggestionGeneratorInput = {
+    chat_history: ChatTurnMessage[];
+    maxQuestions?: number;
+    /**
+     * Optional user-authored replacement for {@link followUpSuggestionsPrompt}
+     * (edited in Settings → Search Settings). Blank or whitespace-only values
+     * fall back to the built-in template.
+     */
+    promptTemplate?: string;
+};
+declare const generateSuggestions: (input: SuggestionGeneratorInput, llm: LanguageModel) => Promise<string[]>;
+export default generateSuggestions;

package/src/tools/search/titleGeneratorAgent.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @module research/chains/titleGeneratorAgent
+ * @description Generates a short, human-friendly title summarising a chat
+ * conversation using the Vercel AI SDK. Used to give conversations with
+ * multiple turns a meaningful title instead of the truncated first message.
+ */
+import { type LanguageModel } from "ai";
+import type { ChatTurnMessage } from "./meta-search-types";
+type TitleGeneratorInput = {
+    chat_history: ChatTurnMessage[];
+};
+declare const generateTitle: (input: TitleGeneratorInput, llm: LanguageModel) => Promise<string>;
+export default generateTitle;

package/src/utils/chat-helpers.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Chat history formatting utilities
+ */
+type ChatHistoryMessage = {
+    content?: unknown;
+    role?: string;
+    type?: string;
+};
+export declare const formatChatHistoryAsString: (history: ChatHistoryMessage[]) => string;
+export {};

package/src/utils/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @fileoverview Barrel export for shared utility modules (chat history helpers and LLM output parsers).
+ */
+export * from './chat-helpers';
+export * from './outputParser';

package/src/utils/outputParser.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @module agent-toolkit/utils/outputParser
+ * @description Parsers that extract values from XML-tagged sections of LLM
+ * output (e.g. `<links>...</links>`, `<question>...</question>`).
+ */
+interface LineListOutputParserArgs {
+    key?: string;
+}
+export declare class LineListOutputParser {
+    private key;
+    constructor(args?: LineListOutputParserArgs);
+    parse(text: string): Promise<string[]>;
+}
+interface LineOutputParserArgs {
+    key?: string;
+}
+export declare class LineOutputParser {
+    private key;
+    constructor(args?: LineOutputParserArgs);
+    parse(text: string): Promise<string | undefined>;
+}
+export default LineOutputParser;

package/src/utils/provider-image-cropper.d.ts

@@ -0,0 +1,127 @@
+/**
+ * @fileoverview Crops a single provider's icon out of a shared sprite-sheet image.
+ *
+ * The sprite sheet is a 6-column by 4-row grid of provider logos; each provider's
+ * grid position is looked up in `PROVIDERS` and rendered onto a canvas, which can
+ * then be returned as a canvas, Blob, or data URL.
+ */
+declare const PROVIDERS: {
+    readonly openrouter: {
+        readonly row: 0;
+        readonly col: 0;
+    };
+    readonly tongyi: {
+        readonly row: 0;
+        readonly col: 1;
+    };
+    readonly ollama: {
+        readonly row: 0;
+        readonly col: 2;
+    };
+    readonly huggingface: {
+        readonly row: 0;
+        readonly col: 3;
+    };
+    readonly localai: {
+        readonly row: 0;
+        readonly col: 4;
+    };
+    readonly openllm: {
+        readonly row: 0;
+        readonly col: 5;
+    };
+    readonly zhipu: {
+        readonly row: 1;
+        readonly col: 0;
+    };
+    readonly replicate: {
+        readonly row: 1;
+        readonly col: 1;
+    };
+    readonly azure: {
+        readonly row: 1;
+        readonly col: 2;
+    };
+    readonly anthropic: {
+        readonly row: 1;
+        readonly col: 3;
+    };
+    readonly groq: {
+        readonly row: 1;
+        readonly col: 4;
+    };
+    readonly sagemaker: {
+        readonly row: 1;
+        readonly col: 5;
+    };
+    readonly "01ai": {
+        readonly row: 2;
+        readonly col: 0;
+    };
+    readonly bedrock: {
+        readonly row: 2;
+        readonly col: 1;
+    };
+    readonly openai: {
+        readonly row: 2;
+        readonly col: 2;
+    };
+    readonly cohere: {
+        readonly row: 2;
+        readonly col: 3;
+    };
+    readonly together: {
+        readonly row: 2;
+        readonly col: 4;
+    };
+    readonly xorbits: {
+        readonly row: 2;
+        readonly col: 5;
+    };
+    readonly wenxin: {
+        readonly row: 3;
+        readonly col: 0;
+    };
+    readonly moonshot: {
+        readonly row: 3;
+        readonly col: 1;
+    };
+    readonly gemini: {
+        readonly row: 3;
+        readonly col: 2;
+    };
+    readonly mistral: {
+        readonly row: 3;
+        readonly col: 3;
+    };
+    readonly jina: {
+        readonly row: 3;
+        readonly col: 4;
+    };
+    readonly chatglm: {
+        readonly row: 3;
+        readonly col: 5;
+    };
+};
+export type Provider = keyof typeof PROVIDERS;
+/**
+ * Returns a cropped canvas containing just the provider box.
+ */
+export declare function cropProvider(image: HTMLImageElement | ImageBitmap, provider: Provider): Promise<HTMLCanvasElement>;
+/**
+ * Returns the provider image as a Blob.
+ */
+export declare function cropProviderAsBlob(image: HTMLImageElement | ImageBitmap, provider: Provider, type?: "image/png" | "image/jpeg" | "image/webp", quality?: number): Promise<Blob>;
+/**
+ * Returns the provider image as a data URL.
+ */
+export declare function cropProviderAsDataURL(image: HTMLImageElement | ImageBitmap, provider: Provider, type?: "image/png" | "image/jpeg" | "image/webp", quality?: number): Promise<string>;
+/**
+ * Helper to load and crop in one call.
+ */
+export declare function getProviderImage(spriteSheetUrl: string, provider: Provider): Promise<HTMLCanvasElement>;
+/**
+ * Get all available provider names.
+ */
+export declare function getProviderNames(): Provider[];
+export {};