write-language 0.1.3 → 0.1.5

package/src/generation-types.ts

@@ -1,90 +1,90 @@
-// @ts-nocheck
-/**
- * @module research/agents/generate-language-types
- * @description Shared types for the generate-language module.
- */
-
-/** Supported LLM provider identifiers */
-export type LLMProviderName =
-  | "nvidia"
-  | "openrouter"
-  | "anthropic"
-  | "google"
-  | "openai"
-  | "xai"
-  | "groq"
-  | "cloudflare"
-  | "perplexity"
-  | "amazon"
-  | "bedrock"
-  | "togetherai"
-  | (string & {}); // preserve autocomplete while allowing arbitrary strings
-
-/**
- * Configuration options for {@link generateLanguageResponse}.
- */
-export interface GenerateLanguageOptions {
-  /** LLM provider to use */
-  provider: LLMProviderName;
-  /**
-   * API key for the provider.
-   * For `cloudflare`, use the `"apiToken:accountId"` format.
-   * For `amazon`/`bedrock`, use bearer token or `"region:accessKeyId:secretAccessKey"` format.
-   */
-  apiKey?: string;
-  /** Agent prompt template name (default: `"question"`) */
-  agent?: string;
-  /** Specific model ID. Falls back to the provider's registered default. */
-  model?: string;
-  /**
-   * Sampling temperature (0\u20132).
-   * Lower = more deterministic; higher = more creative. Default: `1`
-   */
-  temperature?: number;
-  /** User query text */
-  query?: string;
-  /** Article or document text to process */
-  article?: string;
-  /** Prior conversation history for context-aware agents */
-  chat_history?: string;
-  /** Return `HTML` (`true`) or raw Markdown (`false`). Default: `true` */
-  html?: boolean;
-  /** Truncate the prompt to the model's context window length. Default: `true` */
-  applyContextLimit?: boolean;
-  /** Additional template variables forwarded to the agent prompt */
-  [key: string]: unknown;
-}
-
-/** Return value of {@link generateLanguageResponse} */
-export interface GenerateLanguageResult {
-  /** Generated response in HTML or Markdown format */
-  content?: string;
-  /** Structured data extracted by the agent's `after` callback */
-  extract?: unknown;
-  /** Human-readable error message when generation fails */
-  error?: string;
-}
-
-/** Agent prompt template definition */
-export interface AgentPrompt {
-  name: string;
-  /** Mustache-style template string with `{variableName}` placeholders */
-  template?: string;
-  prompt?: string;
-  /** Called before template substitution to pre-process the prompt */
-  before?: (
-    prompt: string | undefined,
-    options: GenerateLanguageOptions,
-  ) => string;
-  /** Called after generation to extract structured data from the raw reply */
-  after?: (reply: string, options: GenerateLanguageOptions) => unknown;
-  /** Names of registered agent tools to attach to this agent */
-  tools?: string[];
-}
-
-/** A registered agent tool with a name, schema, and async handler */
-export interface AgentTool {
-  name: string;
-  func: (...args: unknown[]) => unknown | Promise<unknown>;
-  [key: string]: unknown;
-}
+// @ts-nocheck
+/**
+ * @module research/agents/generate-language-types
+ * @description Shared types for the generate-language module.
+ */
+
+/** Supported LLM provider identifiers */
+export type LLMProviderName =
+  | "nvidia"
+  | "openrouter"
+  | "anthropic"
+  | "google"
+  | "openai"
+  | "xai"
+  | "groq"
+  | "cloudflare"
+  | "perplexity"
+  | "amazon"
+  | "bedrock"
+  | "togetherai"
+  | (string & {}); // preserve autocomplete while allowing arbitrary strings
+
+/**
+ * Configuration options for {@link generateLanguageResponse}.
+ */
+export interface GenerateLanguageOptions {
+  /** LLM provider to use */
+  provider: LLMProviderName;
+  /**
+   * API key for the provider.
+   * For `cloudflare`, use the `"apiToken:accountId"` format.
+   * For `amazon`/`bedrock`, use bearer token or `"region:accessKeyId:secretAccessKey"` format.
+   */
+  apiKey?: string;
+  /** Agent prompt template name (default: `"question"`) */
+  agent?: string;
+  /** Specific model ID. Falls back to the provider's registered default. */
+  model?: string;
+  /**
+   * Sampling temperature (0\u20132).
+   * Lower = more deterministic; higher = more creative. Default: `1`
+   */
+  temperature?: number;
+  /** User query text */
+  query?: string;
+  /** Article or document text to process */
+  article?: string;
+  /** Prior conversation history for context-aware agents */
+  chat_history?: string;
+  /** Return `HTML` (`true`) or raw Markdown (`false`). Default: `true` */
+  html?: boolean;
+  /** Truncate the prompt to the model's context window length. Default: `true` */
+  applyContextLimit?: boolean;
+  /** Additional template variables forwarded to the agent prompt */
+  [key: string]: unknown;
+}
+
+/** Return value of {@link generateLanguageResponse} */
+export interface GenerateLanguageResult {
+  /** Generated response in HTML or Markdown format */
+  content?: string;
+  /** Structured data extracted by the agent's `after` callback */
+  extract?: unknown;
+  /** Human-readable error message when generation fails */
+  error?: string;
+}
+
+/** Agent prompt template definition */
+export interface AgentPrompt {
+  name: string;
+  /** Mustache-style template string with `{variableName}` placeholders */
+  template?: string;
+  prompt?: string;
+  /** Called before template substitution to pre-process the prompt */
+  before?: (
+    prompt: string | undefined,
+    options: GenerateLanguageOptions,
+  ) => string;
+  /** Called after generation to extract structured data from the raw reply */
+  after?: (reply: string, options: GenerateLanguageOptions) => unknown;
+  /** Names of registered agent tools to attach to this agent */
+  tools?: string[];
+}
+
+/** A registered agent tool with a name, schema, and async handler */
+export interface AgentTool {
+  name: string;
+  func: (...args: unknown[]) => unknown | Promise<unknown>;
+  [key: string]: unknown;
+}

package/src/index.ts

@@ -1,40 +1,44 @@
-/**
- * @fileoverview Language Generation Module
- *
- * Centralized exports for AI language model response generation using Vercel AI SDK.
- * Provides prompt templates, model registries, provider factories, and response
- * generation functions for 10+ LLM providers.
- *
- * @module language-generation
- * @author ai-research-agent contributors
- */
-
-export {
-  generateLanguageResponse,
-  convertMarkdownToHTMLEscaped,
-} from "./generate-response";
-
-export type {
-  LLMProviderName,
-  GenerateLanguageOptions,
-  GenerateLanguageResult,
-} from "./generate-response";
-
-export type {
-  AgentPrompt,
-  AgentTool,
-} from "./generation-types";
-
-export { AGENT_PROMPTS, extractJSONFromLanguageReply } from "./prompt-templates";
-export {
-  LANGUAGE_MODELS,
-  LANGUAGE_PROVIDERS,
-  getModelsByProvider,
-  getAllModels,
-  getModelsByCapability,
-  getTextOnlyModels,
-  getMultimodalModels,
-} from "./language-model-registry";
-export type { ModelCapability, ModelInfo } from "./language-model-registry";
-export { createLLMProvider } from "./provider-factory";
-export * from "./prompts";
+/**
+ * @fileoverview Language Generation Module
+ *
+ * Centralized exports for AI language model response generation using Vercel AI SDK.
+ * Provides prompt templates, model registries, provider factories, and response
+ * generation functions for 10+ LLM providers.
+ *
+ * @module language-generation
+ * @author ai-research-agent contributors
+ */
+
+export {
+  generateLanguageResponse,
+  convertMarkdownToHTMLEscaped,
+} from "./generate-response";
+
+export type {
+  LLMProviderName,
+  GenerateLanguageOptions,
+  GenerateLanguageResult,
+} from "./generate-response";
+
+export type {
+  AgentPrompt,
+  AgentTool,
+} from "./generation-types";
+
+export { AGENT_PROMPTS, extractJSONFromLanguageReply } from "./prompt-templates";
+export {
+  LANGUAGE_MODELS,
+  LANGUAGE_PROVIDERS,
+  getModelsByProvider,
+  getAllModels,
+  getModelsByCapability,
+  getTextOnlyModels,
+  getMultimodalModels,
+} 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";