@defai.digital/ax-cli 0.0.34 → 0.2.1

package/dist/grok/client.js

@@ -1,58 +1,210 @@
 import OpenAI from "openai";
+import { safeValidateGrokResponse } from "../schemas/api-schemas.js";
+import { ErrorCategory, createErrorMessage } from "../utils/error-handler.js";
+import { GLM_MODELS, DEFAULT_MODEL } from "../constants.js";
+/**
+ * GrokClient - Enhanced client for GLM-4.6 API
+ *
+ * Supports advanced features including:
+ * - Thinking/reasoning mode
+ * - Configurable temperature (0.6-1.0 for GLM-4.6)
+ * - Extended context windows (up to 200K tokens)
+ * - Multiple model support
+ */
 export class GrokClient {
     client;
-    currentModel = "grok-code-fast-1";
+    currentModel;
     defaultMaxTokens;
+    defaultTemperature;
     constructor(apiKey, model, baseURL) {
         this.client = new OpenAI({
             apiKey,
             baseURL: baseURL || process.env.GROK_BASE_URL || "https://api.x.ai/v1",
             timeout: 360000,
         });
+        // Set model with validation
+        this.currentModel = this.validateModel(model || DEFAULT_MODEL);
+        // Get model configuration
+        const modelConfig = GLM_MODELS[this.currentModel];
+        // Set defaults from environment or model config
         const envMax = Number(process.env.GROK_MAX_TOKENS);
-        this.defaultMaxTokens = Number.isFinite(envMax) && envMax > 0 ? envMax : 1536;
-        if (model) {
-            this.currentModel = model;
+        this.defaultMaxTokens = Number.isFinite(envMax) && envMax > 0
+            ? Math.min(envMax, modelConfig.maxOutputTokens)
+            : modelConfig.defaultMaxTokens;
+        const envTemp = Number(process.env.GROK_TEMPERATURE);
+        this.defaultTemperature = Number.isFinite(envTemp) &&
+            envTemp >= modelConfig.temperatureRange.min &&
+            envTemp <= modelConfig.temperatureRange.max
+            ? envTemp
+            : modelConfig.defaultTemperature;
+    }
+    /**
+     * Validate and normalize model name
+     */
+    validateModel(model) {
+        if (model in GLM_MODELS) {
+            return model;
+        }
+        console.warn(`Unknown model "${model}", using default: ${DEFAULT_MODEL}`);
+        return DEFAULT_MODEL;
+    }
+    /**
+     * Validate temperature for current model
+     */
+    validateTemperature(temperature, model) {
+        const config = GLM_MODELS[model];
+        const { min, max } = config.temperatureRange;
+        if (temperature < min || temperature > max) {
+            throw new Error(`Temperature ${temperature} is out of range for model ${model}. ` +
+                `Valid range: ${min} - ${max}`);
+        }
+    }
+    /**
+     * Validate max tokens for current model
+     */
+    validateMaxTokens(maxTokens, model) {
+        const config = GLM_MODELS[model];
+        if (maxTokens > config.maxOutputTokens) {
+            throw new Error(`Max tokens ${maxTokens} exceeds limit for model ${model}. ` +
+                `Maximum: ${config.maxOutputTokens}`);
+        }
+        if (maxTokens < 1) {
+            throw new Error(`Max tokens must be at least 1, got ${maxTokens}`);
+        }
+    }
+    /**
+     * Validate thinking configuration for current model
+     */
+    validateThinking(thinking, model) {
+        if (thinking && thinking.type === "enabled") {
+            const config = GLM_MODELS[model];
+            if (!config.supportsThinking) {
+                throw new Error(`Thinking mode is not supported by model ${model}. ` +
+                    `Use glm-4.6 for thinking capabilities.`);
+            }
         }
     }
     setModel(model) {
-        this.currentModel = model;
+        this.currentModel = this.validateModel(model);
     }
     getCurrentModel() {
         return this.currentModel;
     }
-    async chat(messages, tools, model, searchOptions) {
+    getModelConfig() {
+        return GLM_MODELS[this.currentModel];
+    }
+    /**
+     * Chat completion with GLM-4.6 support
+     *
+     * @param messages - Conversation messages
+     * @param tools - Available tools/functions
+     * @param options - Chat options including temperature, thinking mode, etc.
+     * @returns Promise<GrokResponse>
+     *
+     * @example
+     * ```typescript
+     * const response = await client.chat(messages, tools, {
+     *   model: 'glm-4.6',
+     *   temperature: 0.7,
+     *   thinking: { type: 'enabled' },
+     *   maxTokens: 8192
+     * });
+     * ```
+     */
+    async chat(messages, tools, options) {
         try {
+            // Merge options with defaults
+            const model = this.validateModel(options?.model || this.currentModel);
+            const temperature = options?.temperature ?? this.defaultTemperature;
+            const maxTokens = options?.maxTokens ?? this.defaultMaxTokens;
+            const thinking = options?.thinking;
+            const searchOptions = options?.searchOptions;
+            // Validate parameters
+            this.validateTemperature(temperature, model);
+            this.validateMaxTokens(maxTokens, model);
+            this.validateThinking(thinking, model);
             const requestPayload = {
-                model: model || this.currentModel,
+                model,
                 messages,
                 tools: tools || [],
                 tool_choice: tools && tools.length > 0 ? "auto" : undefined,
-                temperature: 0.7,
-                max_tokens: this.defaultMaxTokens,
+                temperature,
+                max_tokens: maxTokens,
             };
+            // Add GLM-4.6 thinking parameter if specified
+            if (thinking) {
+                requestPayload.thinking = thinking;
+            }
             // Add search parameters if specified
             if (searchOptions?.search_parameters) {
                 requestPayload.search_parameters = searchOptions.search_parameters;
             }
             const response = await this.client.chat.completions.create(requestPayload);
+            // Validate response structure
+            const validationResult = safeValidateGrokResponse(response);
+            if (!validationResult.success) {
+                console.warn(createErrorMessage(ErrorCategory.VALIDATION, 'Grok API response validation', validationResult.error || 'Invalid response structure'));
+                // Return response anyway for backward compatibility, but log warning
+            }
             return response;
         }
         catch (error) {
-            throw new Error(`Grok API error: ${error.message}`);
+            // Enhance error message with context
+            const modelInfo = options?.model || this.currentModel;
+            throw new Error(`Grok API error (model: ${modelInfo}): ${error.message}`);
         }
     }
-    async *chatStream(messages, tools, model, searchOptions) {
+    /**
+     * Streaming chat completion with GLM-4.6 support
+     *
+     * Yields chunks including reasoning_content when thinking is enabled
+     *
+     * @param messages - Conversation messages
+     * @param tools - Available tools/functions
+     * @param options - Chat options including temperature, thinking mode, etc.
+     * @returns AsyncGenerator yielding GLM46StreamChunk
+     *
+     * @example
+     * ```typescript
+     * const stream = client.chatStream(messages, tools, {
+     *   thinking: { type: 'enabled' }
+     * });
+     *
+     * for await (const chunk of stream) {
+     *   if (chunk.choices[0]?.delta?.reasoning_content) {
+     *     console.log('Reasoning:', chunk.choices[0].delta.reasoning_content);
+     *   }
+     *   if (chunk.choices[0]?.delta?.content) {
+     *     console.log('Content:', chunk.choices[0].delta.content);
+     *   }
+     * }
+     * ```
+     */
+    async *chatStream(messages, tools, options) {
         try {
+            // Merge options with defaults
+            const model = this.validateModel(options?.model || this.currentModel);
+            const temperature = options?.temperature ?? this.defaultTemperature;
+            const maxTokens = options?.maxTokens ?? this.defaultMaxTokens;
+            const thinking = options?.thinking;
+            const searchOptions = options?.searchOptions;
+            // Validate parameters
+            this.validateTemperature(temperature, model);
+            this.validateMaxTokens(maxTokens, model);
+            this.validateThinking(thinking, model);
             const requestPayload = {
-                model: model || this.currentModel,
+                model,
                 messages,
                 tools: tools || [],
                 tool_choice: tools && tools.length > 0 ? "auto" : undefined,
-                temperature: 0.7,
-                max_tokens: this.defaultMaxTokens,
+                temperature,
+                max_tokens: maxTokens,
                 stream: true,
             };
+            // Add GLM-4.6 thinking parameter if specified
+            if (thinking) {
+                requestPayload.thinking = thinking;
+            }
             // Add search parameters if specified
             if (searchOptions?.search_parameters) {
                 requestPayload.search_parameters = searchOptions.search_parameters;
@@ -63,9 +215,14 @@ export class GrokClient {
             }
         }
         catch (error) {
-            throw new Error(`Grok API error: ${error.message}`);
+            const modelInfo = options?.model || this.currentModel;
+            throw new Error(`Grok API streaming error (model: ${modelInfo}): ${error.message}`);
         }
     }
+    /**
+     * Search with web context (deprecated - use chat with searchOptions)
+     * @deprecated Use chat() with searchOptions parameter instead
+     */
     async search(query, searchParameters) {
         const searchMessage = {
             role: "user",
@@ -74,7 +231,7 @@ export class GrokClient {
         const searchOptions = {
             search_parameters: searchParameters || { mode: "on" },
         };
-        return this.chat([searchMessage], [], undefined, searchOptions);
+        return this.chat([searchMessage], [], { searchOptions });
     }
 }
 //# sourceMappingURL=client.js.map

package/dist/grok/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/grok/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/grok/client.ts"],"names":[],"mappings":"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"}

package/dist/grok/types.d.ts

@@ -0,0 +1,291 @@
+/**
+ * GLM-4.6 API Type Definitions
+ *
+ * This file contains comprehensive type definitions for GLM-4.6 API features,
+ * including advanced reasoning mode, configurable parameters, and enhanced
+ * response structures.
+ *
+ * @see https://docs.z.ai/guides/llm/glm-4.6
+ */
+import type { GrokTool, GrokToolCall, SearchOptions } from "./client.js";
+/**
+ * Thinking/Reasoning configuration for GLM-4.6
+ *
+ * When enabled, the model will include reasoning_content in responses,
+ * showing the step-by-step thought process before generating the final answer.
+ *
+ * @example
+ * ```typescript
+ * const thinking: ThinkingConfig = { type: "enabled" };
+ * const response = await client.chat(messages, [], { thinking });
+ * ```
+ */
+export interface ThinkingConfig {
+    /**
+     * Enable or disable thinking mode
+     * - "enabled": Include reasoning process in responses
+     * - "disabled": Standard response without reasoning
+     */
+    type: "enabled" | "disabled";
+}
+/**
+ * Comprehensive options for GLM-4.6 chat requests
+ *
+ * Consolidates all available parameters for chat completions,
+ * providing type-safe configuration for GLM-4.6 features.
+ */
+export interface ChatOptions {
+    /**
+     * Model identifier
+     * @default "glm-4.6"
+     * @example "glm-4.6", "grok-code-fast-1"
+     */
+    model?: string;
+    /**
+     * Temperature controls randomness in responses
+     *
+     * - Lower values (0.6): More focused and deterministic
+     * - Higher values (1.0): More creative and diverse
+     *
+     * @default 0.7
+     * @minimum 0.6
+     * @maximum 1.0
+     */
+    temperature?: number;
+    /**
+     * Maximum number of tokens to generate
+     *
+     * GLM-4.6 supports up to 128,000 output tokens
+     *
+     * @default 8192
+     * @maximum 128000
+     */
+    maxTokens?: number;
+    /**
+     * Enable/disable advanced reasoning mode
+     *
+     * When enabled, responses include reasoning_content showing
+     * the model's step-by-step thought process.
+     */
+    thinking?: ThinkingConfig;
+    /**
+     * Search parameters for web-enabled queries
+     */
+    searchOptions?: SearchOptions;
+    /**
+     * Tools/functions available for the model to call
+     */
+    tools?: GrokTool[];
+    /**
+     * Enable streaming responses
+     * @default false
+     */
+    stream?: boolean;
+}
+/**
+ * GLM-4.6 enhanced response structure
+ *
+ * Extends the standard response with reasoning content and
+ * enhanced usage metrics.
+ */
+export interface GLM46Response {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        message: {
+            role: string;
+            content: string | null;
+            /**
+             * Reasoning process (only present when thinking is enabled)
+             * Contains the step-by-step thought process before the final answer
+             */
+            reasoning_content?: string;
+            tool_calls?: GrokToolCall[];
+        };
+        finish_reason: string;
+    }>;
+    /**
+     * Token usage statistics
+     */
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+        /**
+         * Tokens used for reasoning (only when thinking is enabled)
+         */
+        reasoning_tokens?: number;
+    };
+}
+/**
+ * GLM-4.6 streaming response chunk
+ *
+ * Individual chunks received during streaming responses,
+ * including support for reasoning content.
+ */
+export interface GLM46StreamChunk {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        delta: {
+            role?: string;
+            /**
+             * Incremental content from the final response
+             */
+            content?: string;
+            /**
+             * Incremental reasoning content (when thinking is enabled)
+             * Shows the model's thought process as it develops
+             */
+            reasoning_content?: string;
+            tool_calls?: Array<{
+                index: number;
+                id?: string;
+                type?: "function";
+                function?: {
+                    name?: string;
+                    arguments?: string;
+                };
+            }>;
+        };
+        finish_reason?: string | null;
+    }>;
+}
+/**
+ * Type guard to check if a response is a GLM-4.6 response
+ */
+export declare function isGLM46Response(response: unknown): response is GLM46Response;
+/**
+ * Type guard to check if a chunk has reasoning content
+ */
+export declare function hasReasoningContent(chunk: GLM46StreamChunk): chunk is GLM46StreamChunk & {
+    choices: Array<{
+        delta: {
+            reasoning_content: string;
+        };
+    }>;
+};
+/**
+ * GLM-4.6 model configurations
+ *
+ * Defines capabilities and limits for supported models
+ */
+export declare const GLM_MODELS: {
+    readonly "glm-4.6": {
+        readonly contextWindow: 200000;
+        readonly maxOutputTokens: 128000;
+        readonly supportsThinking: true;
+        readonly defaultTemperature: 0.7;
+        readonly temperatureRange: {
+            readonly min: 0.6;
+            readonly max: 1;
+        };
+        readonly tokenEfficiency: 1.3;
+    };
+    readonly "grok-code-fast-1": {
+        readonly contextWindow: 128000;
+        readonly maxOutputTokens: 4096;
+        readonly supportsThinking: false;
+        readonly defaultTemperature: 0.7;
+        readonly temperatureRange: {
+            readonly min: 0;
+            readonly max: 2;
+        };
+        readonly tokenEfficiency: 1;
+    };
+    readonly "glm-4-air": {
+        readonly contextWindow: 128000;
+        readonly maxOutputTokens: 8192;
+        readonly supportsThinking: false;
+        readonly defaultTemperature: 0.7;
+        readonly temperatureRange: {
+            readonly min: 0.6;
+            readonly max: 1;
+        };
+        readonly tokenEfficiency: 1.15;
+    };
+    readonly "glm-4-airx": {
+        readonly contextWindow: 8192;
+        readonly maxOutputTokens: 8192;
+        readonly supportsThinking: false;
+        readonly defaultTemperature: 0.7;
+        readonly temperatureRange: {
+            readonly min: 0.6;
+            readonly max: 1;
+        };
+        readonly tokenEfficiency: 1.1;
+    };
+};
+export type SupportedModel = keyof typeof GLM_MODELS;
+/**
+ * Get model configuration by name
+ */
+export declare function getModelConfig(model: string): {
+    readonly contextWindow: 200000;
+    readonly maxOutputTokens: 128000;
+    readonly supportsThinking: true;
+    readonly defaultTemperature: 0.7;
+    readonly temperatureRange: {
+        readonly min: 0.6;
+        readonly max: 1;
+    };
+    readonly tokenEfficiency: 1.3;
+} | {
+    readonly contextWindow: 128000;
+    readonly maxOutputTokens: 4096;
+    readonly supportsThinking: false;
+    readonly defaultTemperature: 0.7;
+    readonly temperatureRange: {
+        readonly min: 0;
+        readonly max: 2;
+    };
+    readonly tokenEfficiency: 1;
+} | {
+    readonly contextWindow: 128000;
+    readonly maxOutputTokens: 8192;
+    readonly supportsThinking: false;
+    readonly defaultTemperature: 0.7;
+    readonly temperatureRange: {
+        readonly min: 0.6;
+        readonly max: 1;
+    };
+    readonly tokenEfficiency: 1.15;
+} | {
+    readonly contextWindow: 8192;
+    readonly maxOutputTokens: 8192;
+    readonly supportsThinking: false;
+    readonly defaultTemperature: 0.7;
+    readonly temperatureRange: {
+        readonly min: 0.6;
+        readonly max: 1;
+    };
+    readonly tokenEfficiency: 1.1;
+};
+/**
+ * Validate temperature for a given model
+ *
+ * @throws Error if temperature is out of valid range
+ */
+export declare function validateTemperature(temperature: number, model: string): void;
+/**
+ * Validate max tokens for a given model
+ *
+ * @throws Error if maxTokens exceeds model limit
+ */
+export declare function validateMaxTokens(maxTokens: number, model: string): void;
+/**
+ * Validate thinking configuration for a given model
+ *
+ * @throws Error if thinking is not supported by the model
+ */
+export declare function validateThinking(thinking: ThinkingConfig | undefined, model: string): void;
+/**
+ * Create default chat options with sensible defaults
+ */
+export declare function createDefaultChatOptions(model?: string): Required<Omit<ChatOptions, 'thinking' | 'searchOptions' | 'tools'>>;

package/dist/grok/types.js

@@ -0,0 +1,127 @@
+/**
+ * GLM-4.6 API Type Definitions
+ *
+ * This file contains comprehensive type definitions for GLM-4.6 API features,
+ * including advanced reasoning mode, configurable parameters, and enhanced
+ * response structures.
+ *
+ * @see https://docs.z.ai/guides/llm/glm-4.6
+ */
+/**
+ * Type guard to check if a response is a GLM-4.6 response
+ */
+export function isGLM46Response(response) {
+    return (typeof response === 'object' &&
+        response !== null &&
+        'choices' in response &&
+        Array.isArray(response.choices));
+}
+/**
+ * Type guard to check if a chunk has reasoning content
+ */
+export function hasReasoningContent(chunk) {
+    return (chunk.choices.length > 0 &&
+        typeof chunk.choices[0]?.delta?.reasoning_content === 'string' &&
+        chunk.choices[0].delta.reasoning_content.length > 0);
+}
+/**
+ * GLM-4.6 model configurations
+ *
+ * Defines capabilities and limits for supported models
+ */
+export const GLM_MODELS = {
+    "glm-4.6": {
+        contextWindow: 200000, // 200K tokens
+        maxOutputTokens: 128000, // 128K max output
+        supportsThinking: true,
+        defaultTemperature: 0.7,
+        temperatureRange: { min: 0.6, max: 1.0 },
+        tokenEfficiency: 1.3, // 30% more efficient
+    },
+    "grok-code-fast-1": {
+        contextWindow: 128000, // 128K tokens
+        maxOutputTokens: 4096,
+        supportsThinking: false,
+        defaultTemperature: 0.7,
+        temperatureRange: { min: 0.0, max: 2.0 },
+        tokenEfficiency: 1.0,
+    },
+    "glm-4-air": {
+        contextWindow: 128000,
+        maxOutputTokens: 8192,
+        supportsThinking: false,
+        defaultTemperature: 0.7,
+        temperatureRange: { min: 0.6, max: 1.0 },
+        tokenEfficiency: 1.15,
+    },
+    "glm-4-airx": {
+        contextWindow: 8192,
+        maxOutputTokens: 8192,
+        supportsThinking: false,
+        defaultTemperature: 0.7,
+        temperatureRange: { min: 0.6, max: 1.0 },
+        tokenEfficiency: 1.1,
+    },
+};
+/**
+ * Get model configuration by name
+ */
+export function getModelConfig(model) {
+    return GLM_MODELS[model] || GLM_MODELS["glm-4.6"];
+}
+/**
+ * Validate temperature for a given model
+ *
+ * @throws Error if temperature is out of valid range
+ */
+export function validateTemperature(temperature, model) {
+    const config = getModelConfig(model);
+    const { min, max } = config.temperatureRange;
+    if (temperature < min || temperature > max) {
+        throw new Error(`Temperature ${temperature} is out of range for model ${model}. ` +
+            `Valid range: ${min} - ${max}`);
+    }
+}
+/**
+ * Validate max tokens for a given model
+ *
+ * @throws Error if maxTokens exceeds model limit
+ */
+export function validateMaxTokens(maxTokens, model) {
+    const config = getModelConfig(model);
+    if (maxTokens > config.maxOutputTokens) {
+        throw new Error(`Max tokens ${maxTokens} exceeds model limit for ${model}. ` +
+            `Maximum: ${config.maxOutputTokens}`);
+    }
+    if (maxTokens < 1) {
+        throw new Error(`Max tokens must be at least 1, got ${maxTokens}`);
+    }
+}
+/**
+ * Validate thinking configuration for a given model
+ *
+ * @throws Error if thinking is not supported by the model
+ */
+export function validateThinking(thinking, model) {
+    if (thinking && thinking.type === "enabled") {
+        const config = getModelConfig(model);
+        if (!config.supportsThinking) {
+            throw new Error(`Thinking mode is not supported by model ${model}. ` +
+                `Use glm-4.6 for thinking capabilities.`);
+        }
+    }
+}
+/**
+ * Create default chat options with sensible defaults
+ */
+export function createDefaultChatOptions(model) {
+    const modelName = model || "glm-4.6";
+    const config = getModelConfig(modelName);
+    return {
+        model: modelName,
+        temperature: config.defaultTemperature,
+        maxTokens: Math.min(8192, config.maxOutputTokens), // Conservative default
+        stream: false,
+    };
+}
+//# sourceMappingURL=types.js.map