chat-agent-toolkit 1.2.426 → 1.2.428

package/README.md

@@ -24,6 +24,10 @@
 </p>
 <!-- template-git-repo:badges:end -->
 
+<!-- skills:install:start -->
+**🤖 Agent skill** — `npx skills@latest add https://github.com/OpenSourceAGI/qwksearch-research-agent --skill chat-agent-toolkit` ([what it covers](../../skills/chat-agent-toolkit/SKILL.md))
+<!-- skills:install:end -->
+
 Multi-provider AI agent toolkit for generating language responses, searching the web, extracting page content, and managing long-term memory across 10+ LLM providers.
 
 Built on top of the [Vercel AI SDK](https://sdk.vercel.ai) and [Mastra](https://mastra.ai) framework, with a small registry of pre-tuned agent prompts (research, summarization, citation answering, query resolution, knowledge-graph extraction, etc.) and tool wrappers around the [QwkSearch](https://qwksearch.com) API.

package/dist/chat-agent-toolkit/src/tools/qwksearch-api-tools.d.ts

@@ -81,8 +81,8 @@ export declare const AGENT_TOOLS: ({
         bypassCaptcha: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         sessionId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         format: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-            html: "html";
             json: "json";
+            html: "html";
         }>>>;
         scraperUrl: z.ZodOptional<z.ZodString>;
         scraperApiKey: z.ZodOptional<z.ZodString>;

package/dist/chat-agent-toolkit/src/tools/search/meta-search-types.d.ts

@@ -23,7 +23,12 @@ export interface DrainableEmitter extends EventEmitter {
 export interface MetaSearchAgentType {
     searchAndAnswer: (message: string, history: ChatTurnMessage[], llm: LanguageModel, optimizationMode: "speed" | "balanced" | "quality", fileIds: string[], systemInstructions: string, category?: string, sourceExtractionEnabled?: boolean, thinkingTimeLimit?: number, 
     /** User-authored replacement for the focus mode's query-expansion prompt. */
-    queryExpansionPrompt?: string) => Promise<DrainableEmitter>;
+    queryExpansionPrompt?: string, 
+    /**
+     * Rephrase the message with the LLM before searching. Off by default: the
+     * message is searched as typed, which saves a model round trip.
+     */
+    queryExpansionEnabled?: boolean) => Promise<DrainableEmitter>;
 }
 /** Emitted on the EventEmitter data channel to report live search progress. */
 export interface SearchingEvent {

package/dist/chat-agent-toolkit/src/tools/search/metaSearchAgent.d.ts

@@ -6,16 +6,35 @@ declare class MetaSearchAgent implements MetaSearchAgentType {
     private config;
     constructor(config: Config);
     /**
-     * Rephrases the user's query into a standalone search question (and any
-     * URLs to summarize), runs the web search, and returns the documents to
-     * use as answer context.
+     * Asks the LLM to rephrase the message into a standalone search question,
+     * and to pick out any URLs to summarize. This is a full model round trip
+     * before the search can start, so it only runs when query expansion is on.
+     */
+    private expandQuery;
+    /**
+     * Runs the web search and returns its results as answer-context documents:
+     * each one the result's title and search snippet, nothing fetched yet.
+     *
+     * The message is searched as typed unless `queryExpansionEnabled` is set,
+     * in which case the LLM rephrases it first (see {@link expandQuery}).
+     * `fromLinks` marks documents built from URLs in the message rather than a
+     * search, which already carry their pages' text.
      */
     private retrieveSearchDocs;
+    /**
+     * Replaces the search snippets of the top web results with text fetched
+     * from their pages, in place, when the user has turned source extraction on
+     * or set a thinking-time budget. Uploaded files are left alone.
+     *
+     * This runs after the result list has been sent to the client, so the
+     * sources appear while the pages are still loading.
+     */
+    private extractTopSources;
     /**
      * Runs the full search-and-answer pipeline, emitting "sources",
      * "response", "searching", "end", and "error" events on the emitter.
      */
     private runPipeline;
-    searchAndAnswer(message: string, history: ChatTurnMessage[], llm: LanguageModel, optimizationMode: "speed" | "balanced" | "quality", fileIds: string[], systemInstructions: string, category?: string, sourceExtractionEnabled?: boolean, thinkingTimeLimit?: number, queryExpansionPrompt?: string): Promise<EventEmitter<any>>;
+    searchAndAnswer(message: string, history: ChatTurnMessage[], llm: LanguageModel, optimizationMode: "speed" | "balanced" | "quality", fileIds: string[], systemInstructions: string, category?: string, sourceExtractionEnabled?: boolean, thinkingTimeLimit?: number, queryExpansionPrompt?: string, queryExpansionEnabled?: boolean): Promise<EventEmitter<any>>;
 }
 export default MetaSearchAgent;