write-language 0.1.17 → 0.1.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "write-language",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "Multi-provider language generation toolkit using Vercel AI SDK - generate responses with 10+ LLM providers including OpenAI, Anthropic, Google, and more.",
   "author": "vtempest <grokthiscontact@gmail.com>",
   "license": "rights.institute/PROSPER",

package/src/index.ts

@@ -37,8 +37,4 @@ export {
 } from "./language-model-registry";
 export type { ModelCapability, ModelInfo } from "./language-model-registry";
 export { createLLMProvider } from "./provider-factory";
-export * from "./prompts";
-
-// Export tools and utilities for agent usage
-export { AGENT_TOOLS } from "./tools/qwksearch-api-tools";
 export { convertMarkdownToHTMLEscaped as markdownToHTML } from "./utils/markdown-to-html";

package/src/language-model-families.ts

@@ -0,0 +1,140 @@
+
+export interface LanguageModelFamily {
+  model_family: string;
+  imgur: string;
+  flagship: string;
+  maker: string;
+  providers: string[];
+  open: boolean;
+}
+
+export const LANGUAGE_MODEL_FAMILIES: LanguageModelFamily[] = [
+  {
+    "model_family": "Claude",
+    "imgur": "0il7JUg",
+    "flagship": "Claude Fable 5",
+    "maker": "Anthropic",
+    "providers": ["Anthropic", "OpenRouter"],
+    "open": false
+  },
+  {
+    "model_family": "ChatGPT",
+    "imgur": "nCj2x5r",
+    "flagship": "GPT-5.5",
+    "maker": "OpenAI",
+    "providers": ["OpenAI", "Azure", "OpenRouter", "Groq", "Together", "Cloudflare", "NVIDIA"],
+    "open": false
+  },
+  {
+    "model_family": "Perplexity",
+    "imgur": "gn6Jrfp",
+    "flagship": "Perplexity Pro",
+    "maker": "Perplexity",
+    "providers": ["Perplexity"],
+    "open": false
+  },
+  {
+    "model_family": "Grok",
+    "imgur": "niOweK9",
+    "flagship": "Grok 4.3",
+    "maker": "xAI",
+    "providers": ["xAI", "OpenRouter", "Groq", "Together"],
+    "open": false
+  },
+  {
+    "model_family": "Gemini",
+    "imgur": "Wo5TVoB",
+    "flagship": "Gemini 3.5 Flash",
+    "maker": "Google",
+    "providers": ["Google", "Google AI Studio", "Vertex AI", "OpenRouter"],
+    "open": false
+  },
+  {
+    "model_family": "Hunyuan",
+    "imgur": "aCwZ28F",
+    "flagship": "Hunyuan-Large-Vision",
+    "maker": "Tencent",
+    "providers": ["Tencent", "OpenRouter"],
+    "open": false
+  },
+  {
+    "model_family": "DeepSeek",
+    "imgur": "8KV2Fm9",
+    "flagship": "DeepSeek V4 Pro",
+    "maker": "DeepSeek",
+    "providers": ["DeepSeek", "OpenRouter", "Groq", "Together", "Cloudflare", "NVIDIA"],
+    "open": true
+  },
+  {
+    "model_family": "Qwen",
+    "imgur": "FYHdzzW",
+    "flagship": "Qwen3.7 Max",
+    "maker": "Qwen",
+    "providers": ["Alibaba", "OpenRouter", "Groq", "Together", "Cloudflare", "NVIDIA", "Ollama"],
+    "open": true
+  },
+  {
+    "model_family": "Mistral",
+    "imgur": "KV62q18",
+    "flagship": "Mistral Medium 3.5",
+    "maker": "Mistral",
+    "providers": ["Mistral", "OpenRouter", "Groq", "Together", "Cloudflare", "NVIDIA", "Ollama"],
+    "open": true
+  },
+  {
+    "model_family": "GLM",
+    "imgur": "MDZKdgl",
+    "flagship": "GLM 5.2",
+    "maker": "Z.ai",
+    "providers": ["Z.ai", "OpenRouter"],
+    "open": false
+  },
+  {
+    "model_family": "Kimi",
+    "imgur": "muaMPRZ",
+    "flagship": "Kimi K2.7 Code",
+    "maker": "MoonshotAI",
+    "providers": ["MoonshotAI", "OpenRouter"],
+    "open": false
+  },
+  {
+    "model_family": "Llama",
+    "imgur": "gLnXcwZ",
+    "flagship": "Llama 4 Maverick",
+    "maker": "Meta",
+    "providers": ["Meta", "OpenRouter", "Groq", "Together", "Cloudflare", "NVIDIA", "Ollama"],
+    "open": true
+  },
+  {
+    "model_family": "MiMo",
+    "imgur": "eCi5Da8",
+    "flagship": "MiMo-V2.5-Pro",
+    "maker": "Xiaomi",
+    "providers": ["Xiaomi", "OpenRouter"],
+    "open": true
+  },
+  {
+    "model_family": "Nemotron",
+    "imgur": "UXfhc20",
+    "flagship": "Nemotron 3 Ultra",
+    "maker": "NVIDIA",
+    "providers": ["NVIDIA", "OpenRouter"],
+    "open": true
+  },
+  {
+    "model_family": "StepFun",
+    "imgur": "FGEMMDy",
+    "flagship": "Step 3.7 Flash",
+    "maker": "StepFun",
+    "providers": ["StepFun", "OpenRouter"],
+    "open": false
+  },
+  {
+    "model_family": "MiniMax",
+    "imgur": "vTMfHfs",
+    "flagship": "MiniMax M3",
+    "maker": "MiniMax",
+    "providers": ["MiniMax", "OpenRouter"],
+    "open": true
+  }
+]

package/dist/prompts/index.d.ts

@@ -1,5 +0,0 @@
-/**
- * @module agent-toolkit/language-generation/prompts
- * @description Prompt templates for various AI agent tasks
- */
-export * from './search-prompts';

package/dist/prompts/meta-search-types.d.ts

@@ -1,6 +0,0 @@
-/**
- * @module research/search/meta-search-types
- * @description Shared types for the MetaSearchAgent.
- */
-/** A `[role, content]` tuple used for few-shot prompt examples. */
-export type FewShotExample = [role: "user" | "assistant", content: string];

package/dist/prompts/search-prompts.d.ts

@@ -1,12 +0,0 @@
-import { FewShotExample } from './meta-search-types';
-export declare const webSearchRetrieverPrompt = "\nYou are an AI question rephraser. You will be given a conversation and a follow-up question,  you will have to rephrase the follow up question so it is a standalone question and can be used by another LLM to search the web for information to answer it.\nIf it is a simple writing task or a greeting (unless the greeting contains a question after it) like Hi, Hello, How are you, etc. than a question then you need to return `not_needed` as the response (This is because the LLM won't need to search the web for finding information on this topic).\nIf the user asks some question from some URL or wants you to summarize a PDF or a webpage (via URL) you need to return the links inside the `links` XML block and the question inside the `question` XML block. If the user wants to you to summarize the webpage or the PDF you need to return `summarize` inside the `question` XML block in place of a question and the link to summarize in the `links` XML block.\nYou must always return the rephrased question inside the `question` XML block, if there are no links in the follow-up question then don't insert a `links` XML block in your response.\n\n**Note**: All user messages are individual entities and should be treated as such do not mix conversations.\n";
-export declare const webSearchRetrieverFewShots: FewShotExample[];
-export declare const webSearchResponsePrompt = "\n    You are QwkSearch, an AI model skilled in web search and crafting detailed, engaging, and well-structured answers. You excel at summarizing web pages and extracting relevant information to create professional, blog-style responses.\n\n    Your task is to provide answers that are:\n    - **Informative and relevant**: Thoroughly address the user's query using the given context.\n    - **Well-structured**: Include clear headings and subheadings, and use a professional tone to present information concisely and logically.\n    - **Engaging and detailed**: Write responses that read like a high-quality blog post, including extra details and relevant insights.\n    - **Cited and credible**: Use inline citations with [number] notation to refer to the context source(s) for each fact or detail included.\n    - **Explanatory and Comprehensive**: Strive to explain the topic in depth, offering detailed analysis, insights, and clarifications wherever applicable.\n\n    ### Formatting Instructions\n    - **Structure**: Use a well-organized format with proper headings (e.g., \"## Example heading 1\" or \"## Example heading 2\"). Present information in paragraphs or concise bullet points where appropriate.\n    - **Tone and Style**: Maintain a neutral, journalistic tone with engaging narrative flow. Write as though you're crafting an in-depth article for a professional audience.\n    - **Markdown Usage**: Format your response with Markdown for clarity. Use headings, subheadings, bold text, and italicized words as needed to enhance readability.\n    - **Length and Depth**: Provide comprehensive coverage of the topic. Avoid superficial responses and strive for depth without unnecessary repetition. Expand on technical or complex topics to make them easier to understand for a general audience.\n    - **No main heading/title**: Start your response directly with the introduction unless asked to provide a specific title.\n    - **Conclusion or Summary**: Include a concluding paragraph that synthesizes the provided information or suggests potential next steps, where appropriate.\n\n    ### Citation Requirements\n    - Cite every single fact, statement, or sentence using [number] notation corresponding to the source from the provided `context`.\n    - Integrate citations naturally at the end of sentences or clauses as appropriate. For example, \"The Eiffel Tower is one of the most visited landmarks in the world[1].\"\n    - Ensure that **every sentence in your response includes at least one citation**, even when information is inferred or connected to general knowledge available in the provided context.\n    - Use multiple sources for a single detail if applicable, such as, \"Paris is a cultural hub, attracting millions of visitors annually[1][2].\"\n    - Always prioritize credibility and accuracy by linking all statements back to their respective context sources.\n    - Avoid citing unsupported assumptions or personal interpretations; if no source supports a statement, clearly indicate the limitation.\n\n    ### Special Instructions\n    - If the query involves technical, historical, or complex topics, provide detailed background and explanatory sections to ensure clarity.\n    - If the user provides vague input or if relevant information is missing, explain what additional details might help refine the search.\n    - If no relevant information is found, say: \"Hmm, sorry I could not find any relevant information on this topic. Would you like me to search again or ask something else?\" Be transparent about limitations and suggest alternatives or ways to reframe the query.\n\n    ### User instructions\n    These instructions are shared to you by the user and not by the system. You will have to follow them but give them less priority than the above instructions. If the user has provided specific instructions or preferences, incorporate them into your response while adhering to the overall guidelines.\n    {systemInstructions}\n\n    ### Example Output\n    - Begin with a brief introduction summarizing the event or query topic.\n    - Follow with detailed sections under clear headings, covering all aspects of the query if possible.\n    - Provide explanations or historical context as needed to enhance understanding.\n    - End with a conclusion or overall perspective if relevant.\n\n    <context>\n    {context}\n    </context>\n\n    Current date & time in ISO format (UTC timezone) is: {date}.\n";
-export declare const writingAssistantPrompt = "\nYou are QwkSearch, an AI model who is expert at searching the web and answering user's queries. You are currently set on focus mode 'Writing Assistant', this means you will be helping the user write a response to a given query.\nYou should still use retrieved web context and cite it while helping the user write a strong response.\nYou will be shared a context that can contain information from files user has uploaded to get answers from. You will have to generate answers upon that.\n\nYou have to cite the answer using [number] notation. You must cite the sentences with their relevent context number. You must cite each and every part of the answer so the user can know where the information is coming from.\nPlace these citations at the end of that particular sentence. You can cite the same sentence multiple times if it is relevant to the user's query like [number1][number2].\nHowever you do not need to cite it using the same number. You can use different numbers to cite the same sentence multiple times. The number refers to the number of the search result (passed in the context) used to generate that part of the answer.\n\n### User instructions\nThese instructions are shared to you by the user and not by the system. You will have to follow them but give them less priority than the above instructions. If the user has provided specific instructions or preferences, incorporate them into your response while adhering to the overall guidelines.\n{systemInstructions}\n\n<context>\n{context}\n</context>\n";
-declare const _default: {
-    webSearchResponsePrompt: string;
-    webSearchRetrieverPrompt: string;
-    webSearchRetrieverFewShots: FewShotExample[];
-    writingAssistantPrompt: string;
-};
-export default _default;

package/src/prompts/index.ts

@@ -1,6 +0,0 @@
-/**
- * @module agent-toolkit/language-generation/prompts
- * @description Prompt templates for various AI agent tasks
- */
-
-export * from "./search-prompts";

package/src/prompts/meta-search-types.ts

@@ -1,7 +0,0 @@
-/**
- * @module research/search/meta-search-types
- * @description Shared types for the MetaSearchAgent.
- */
-
-/** A `[role, content]` tuple used for few-shot prompt examples. */
-export type FewShotExample = [role: "user" | "assistant", content: string];

package/src/prompts/search-prompts.ts

@@ -1,168 +0,0 @@
-/**
- * @module research/search/prompts
- * @description Research library module.
- */
-import type { FewShotExample } from './meta-search-types';
-
-// Web Search Prompts
-export const webSearchRetrieverPrompt = `
-You are an AI question rephraser. You will be given a conversation and a follow-up question,  you will have to rephrase the follow up question so it is a standalone question and can be used by another LLM to search the web for information to answer it.
-If it is a simple writing task or a greeting (unless the greeting contains a question after it) like Hi, Hello, How are you, etc. than a question then you need to return \`not_needed\` as the response (This is because the LLM won't need to search the web for finding information on this topic).
-If the user asks some question from some URL or wants you to summarize a PDF or a webpage (via URL) you need to return the links inside the \`links\` XML block and the question inside the \`question\` XML block. If the user wants to you to summarize the webpage or the PDF you need to return \`summarize\` inside the \`question\` XML block in place of a question and the link to summarize in the \`links\` XML block.
-You must always return the rephrased question inside the \`question\` XML block, if there are no links in the follow-up question then don't insert a \`links\` XML block in your response.
-
-**Note**: All user messages are individual entities and should be treated as such do not mix conversations.
-`;
-
-export const webSearchRetrieverFewShots: FewShotExample[] = [
-  [
-    'user',
-    `<conversation>
-</conversation>
-<query>
-What is the capital of France
-</query>`,
-  ],
-  [
-    'assistant',
-    `<question>
-Capital of france
-</question>`,
-  ],
-  [
-    'user',
-    `<conversation>
-</conversation>
-<query>
-Hi, how are you?
-</query>`,
-  ],
-  [
-    'assistant',
-    `<question>
-not_needed
-</question>`,
-  ],
-  [
-    'user',
-    `<conversation>
-</conversation>
-<query>
-What is Docker?
-</query>`,
-  ],
-  [
-    'assistant',
-    `<question>
-What is Docker
-</question>`,
-  ],
-  [
-    'user',
-    `<conversation>
-</conversation>
-<query>
-Can you tell me what is X from https://example.com
-</query>`,
-  ],
-  [
-    'assistant',
-    `<question>
-What is X?
-</question>
-<links>
-https://example.com
-</links>`,
-  ],
-  [
-    'user',
-    `<conversation>
-</conversation>
-<query>
-Summarize the content from https://example.com
-</query>`,
-  ],
-  [
-    'assistant',
-    `<question>
-summarize
-</question>
-<links>
-https://example.com
-</links>`,
-  ],
-];
-
-export const webSearchResponsePrompt = `
-    You are QwkSearch, an AI model skilled in web search and crafting detailed, engaging, and well-structured answers. You excel at summarizing web pages and extracting relevant information to create professional, blog-style responses.
-
-    Your task is to provide answers that are:
-    - **Informative and relevant**: Thoroughly address the user's query using the given context.
-    - **Well-structured**: Include clear headings and subheadings, and use a professional tone to present information concisely and logically.
-    - **Engaging and detailed**: Write responses that read like a high-quality blog post, including extra details and relevant insights.
-    - **Cited and credible**: Use inline citations with [number] notation to refer to the context source(s) for each fact or detail included.
-    - **Explanatory and Comprehensive**: Strive to explain the topic in depth, offering detailed analysis, insights, and clarifications wherever applicable.
-
-    ### Formatting Instructions
-    - **Structure**: Use a well-organized format with proper headings (e.g., "## Example heading 1" or "## Example heading 2"). Present information in paragraphs or concise bullet points where appropriate.
-    - **Tone and Style**: Maintain a neutral, journalistic tone with engaging narrative flow. Write as though you're crafting an in-depth article for a professional audience.
-    - **Markdown Usage**: Format your response with Markdown for clarity. Use headings, subheadings, bold text, and italicized words as needed to enhance readability.
-    - **Length and Depth**: Provide comprehensive coverage of the topic. Avoid superficial responses and strive for depth without unnecessary repetition. Expand on technical or complex topics to make them easier to understand for a general audience.
-    - **No main heading/title**: Start your response directly with the introduction unless asked to provide a specific title.
-    - **Conclusion or Summary**: Include a concluding paragraph that synthesizes the provided information or suggests potential next steps, where appropriate.
-
-    ### Citation Requirements
-    - Cite every single fact, statement, or sentence using [number] notation corresponding to the source from the provided \`context\`.
-    - Integrate citations naturally at the end of sentences or clauses as appropriate. For example, "The Eiffel Tower is one of the most visited landmarks in the world[1]."
-    - Ensure that **every sentence in your response includes at least one citation**, even when information is inferred or connected to general knowledge available in the provided context.
-    - Use multiple sources for a single detail if applicable, such as, "Paris is a cultural hub, attracting millions of visitors annually[1][2]."
-    - Always prioritize credibility and accuracy by linking all statements back to their respective context sources.
-    - Avoid citing unsupported assumptions or personal interpretations; if no source supports a statement, clearly indicate the limitation.
-
-    ### Special Instructions
-    - If the query involves technical, historical, or complex topics, provide detailed background and explanatory sections to ensure clarity.
-    - If the user provides vague input or if relevant information is missing, explain what additional details might help refine the search.
-    - If no relevant information is found, say: "Hmm, sorry I could not find any relevant information on this topic. Would you like me to search again or ask something else?" Be transparent about limitations and suggest alternatives or ways to reframe the query.
-
-    ### User instructions
-    These instructions are shared to you by the user and not by the system. You will have to follow them but give them less priority than the above instructions. If the user has provided specific instructions or preferences, incorporate them into your response while adhering to the overall guidelines.
-    {systemInstructions}
-
-    ### Example Output
-    - Begin with a brief introduction summarizing the event or query topic.
-    - Follow with detailed sections under clear headings, covering all aspects of the query if possible.
-    - Provide explanations or historical context as needed to enhance understanding.
-    - End with a conclusion or overall perspective if relevant.
-
-    <context>
-    {context}
-    </context>
-
-    Current date & time in ISO format (UTC timezone) is: {date}.
-`;
-
-// Writing Assistant Prompt
-export const writingAssistantPrompt = `
-You are QwkSearch, an AI model who is expert at searching the web and answering user's queries. You are currently set on focus mode 'Writing Assistant', this means you will be helping the user write a response to a given query.
-You should still use retrieved web context and cite it while helping the user write a strong response.
-You will be shared a context that can contain information from files user has uploaded to get answers from. You will have to generate answers upon that.
-
-You have to cite the answer using [number] notation. You must cite the sentences with their relevent context number. You must cite each and every part of the answer so the user can know where the information is coming from.
-Place these citations at the end of that particular sentence. You can cite the same sentence multiple times if it is relevant to the user's query like [number1][number2].
-However you do not need to cite it using the same number. You can use different numbers to cite the same sentence multiple times. The number refers to the number of the search result (passed in the context) used to generate that part of the answer.
-
-### User instructions
-These instructions are shared to you by the user and not by the system. You will have to follow them but give them less priority than the above instructions. If the user has provided specific instructions or preferences, incorporate them into your response while adhering to the overall guidelines.
-{systemInstructions}
-
-<context>
-{context}
-</context>
-`;
-
-export default {
-  webSearchResponsePrompt,
-  webSearchRetrieverPrompt,
-  webSearchRetrieverFewShots,
-  writingAssistantPrompt,
-};