@standardagents/groq 0.0.1-dev.ffffff

package/README.md

@@ -0,0 +1,7 @@
+# @standardagents/groq
+
+Stub prerelease package for Standard Agents Groq provider publishing setup.
+
+Current bootstrap version: `0.0.1-dev.ffffff`
+
+This package will be wired into the normal monorepo release flow after trusted publishing is configured.

package/dist/index.d.ts

@@ -0,0 +1,73 @@
+import { LLMProviderInterface, ProviderFactoryConfig, ProviderModelInfo, ModelCapabilities, ProviderRequest, InspectedRequest, ProviderResponse, ProviderStreamChunk, ProviderFactoryWithOptions } from '@standardagents/spec';
+import { z } from 'zod';
+
+declare const groqProviderOptions: z.ZodObject<{
+    citation_options: z.ZodOptional<z.ZodEnum<{
+        enabled: "enabled";
+        disabled: "disabled";
+    }>>;
+    disable_tool_validation: z.ZodOptional<z.ZodBoolean>;
+    include_reasoning: z.ZodOptional<z.ZodBoolean>;
+    reasoning_effort: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        default: "default";
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>>;
+    reasoning_format: z.ZodOptional<z.ZodEnum<{
+        hidden: "hidden";
+        raw: "raw";
+        parsed: "parsed";
+    }>>;
+    user: z.ZodOptional<z.ZodString>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    service_tier: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        on_demand: "on_demand";
+        flex: "flex";
+        performance: "performance";
+    }>>;
+    search_settings: z.ZodOptional<z.ZodObject<{
+        include_domains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        exclude_domains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$loose>>;
+    compound_custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    documents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        json: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+}, z.core.$loose>;
+type GroqProviderOptions = z.infer<typeof groqProviderOptions>;
+
+declare class GroqProvider implements LLMProviderInterface {
+    readonly name = "groq";
+    readonly specificationVersion: "1";
+    private client;
+    private readonly config;
+    private static readonly modelsCacheTtl;
+    private static modelsCache;
+    private static modelsCacheTime;
+    constructor(config: ProviderFactoryConfig);
+    private getClient;
+    supportsModel(_modelId: string): boolean;
+    getIcon(modelId?: string): string;
+    getModels(filter?: string): Promise<ProviderModelInfo[]>;
+    private filterModels;
+    getModelCapabilities(modelId: string): Promise<ModelCapabilities | null>;
+    private buildChatParams;
+    inspectRequest(request: ProviderRequest): Promise<InspectedRequest>;
+    generate(request: ProviderRequest): Promise<ProviderResponse>;
+    stream(request: ProviderRequest): Promise<AsyncIterable<ProviderStreamChunk>>;
+    private toProviderError;
+}
+
+/**
+ * Groq provider factory for Standard Agents.
+ *
+ * Uses Groq's official `groq-sdk` and Chat Completions API.
+ */
+declare const groq: ProviderFactoryWithOptions<typeof groqProviderOptions>;
+
+export { GroqProvider, type GroqProviderOptions, groq, groqProviderOptions };