intention-coding 0.2.4 → 0.3.0

package/dist/services/code-generator/enhanced-tools.d.ts

@@ -82,7 +82,7 @@ export declare const UpdateTaskParams: z.ZodObject<{
         test_requirements: z.ZodOptional<z.ZodString>;
         custom_context: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        status?: "pending" | "completed" | "failed" | "in_progress" | "cancelled" | undefined;
+        status?: "pending" | "completed" | "in_progress" | "failed" | "cancelled" | undefined;
         description?: string | undefined;
         priority?: "medium" | "low" | "high" | "critical" | undefined;
         title?: string | undefined;
@@ -94,7 +94,7 @@ export declare const UpdateTaskParams: z.ZodObject<{
         estimated_hours?: number | undefined;
         actual_hours?: number | undefined;
     }, {
-        status?: "pending" | "completed" | "failed" | "in_progress" | "cancelled" | undefined;
+        status?: "pending" | "completed" | "in_progress" | "failed" | "cancelled" | undefined;
         description?: string | undefined;
         priority?: "medium" | "low" | "high" | "critical" | undefined;
         title?: string | undefined;
@@ -109,7 +109,7 @@ export declare const UpdateTaskParams: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     task_id: string;
     updates: {
-        status?: "pending" | "completed" | "failed" | "in_progress" | "cancelled" | undefined;
+        status?: "pending" | "completed" | "in_progress" | "failed" | "cancelled" | undefined;
         description?: string | undefined;
         priority?: "medium" | "low" | "high" | "critical" | undefined;
         title?: string | undefined;
@@ -124,7 +124,7 @@ export declare const UpdateTaskParams: z.ZodObject<{
 }, {
     task_id: string;
     updates: {
-        status?: "pending" | "completed" | "failed" | "in_progress" | "cancelled" | undefined;
+        status?: "pending" | "completed" | "in_progress" | "failed" | "cancelled" | undefined;
         description?: string | undefined;
         priority?: "medium" | "low" | "high" | "critical" | undefined;
         title?: string | undefined;
@@ -147,12 +147,12 @@ export declare const QueueQueryParams: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     limit: number;
     offset: number;
-    status?: "pending" | "completed" | "failed" | "in_progress" | "cancelled" | undefined;
+    status?: "pending" | "completed" | "in_progress" | "failed" | "cancelled" | undefined;
     project_name?: string | undefined;
     priority?: "medium" | "low" | "high" | "critical" | undefined;
     assignee?: string | undefined;
 }, {
-    status?: "pending" | "completed" | "failed" | "in_progress" | "cancelled" | undefined;
+    status?: "pending" | "completed" | "in_progress" | "failed" | "cancelled" | undefined;
     project_name?: string | undefined;
     priority?: "medium" | "low" | "high" | "critical" | undefined;
     assignee?: string | undefined;
@@ -268,7 +268,7 @@ export declare const updateTaskTool: {
             test_requirements: z.ZodOptional<z.ZodString>;
             custom_context: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            status?: "pending" | "completed" | "failed" | "in_progress" | "cancelled" | undefined;
+            status?: "pending" | "completed" | "in_progress" | "failed" | "cancelled" | undefined;
             description?: string | undefined;
             priority?: "medium" | "low" | "high" | "critical" | undefined;
             title?: string | undefined;
@@ -280,7 +280,7 @@ export declare const updateTaskTool: {
             estimated_hours?: number | undefined;
             actual_hours?: number | undefined;
         }, {
-            status?: "pending" | "completed" | "failed" | "in_progress" | "cancelled" | undefined;
+            status?: "pending" | "completed" | "in_progress" | "failed" | "cancelled" | undefined;
             description?: string | undefined;
             priority?: "medium" | "low" | "high" | "critical" | undefined;
             title?: string | undefined;
@@ -295,7 +295,7 @@ export declare const updateTaskTool: {
     }, "strip", z.ZodTypeAny, {
         task_id: string;
         updates: {
-            status?: "pending" | "completed" | "failed" | "in_progress" | "cancelled" | undefined;
+            status?: "pending" | "completed" | "in_progress" | "failed" | "cancelled" | undefined;
             description?: string | undefined;
             priority?: "medium" | "low" | "high" | "critical" | undefined;
             title?: string | undefined;
@@ -310,7 +310,7 @@ export declare const updateTaskTool: {
     }, {
         task_id: string;
         updates: {
-            status?: "pending" | "completed" | "failed" | "in_progress" | "cancelled" | undefined;
+            status?: "pending" | "completed" | "in_progress" | "failed" | "cancelled" | undefined;
             description?: string | undefined;
             priority?: "medium" | "low" | "high" | "critical" | undefined;
             title?: string | undefined;
@@ -344,12 +344,12 @@ export declare const queryTasksTool: {
     }, "strip", z.ZodTypeAny, {
         limit: number;
         offset: number;
-        status?: "pending" | "completed" | "failed" | "in_progress" | "cancelled" | undefined;
+        status?: "pending" | "completed" | "in_progress" | "failed" | "cancelled" | undefined;
         project_name?: string | undefined;
         priority?: "medium" | "low" | "high" | "critical" | undefined;
         assignee?: string | undefined;
     }, {
-        status?: "pending" | "completed" | "failed" | "in_progress" | "cancelled" | undefined;
+        status?: "pending" | "completed" | "in_progress" | "failed" | "cancelled" | undefined;
         project_name?: string | undefined;
         priority?: "medium" | "low" | "high" | "critical" | undefined;
         assignee?: string | undefined;

package/dist/services/image-analysis/config.d.ts

@@ -0,0 +1,14 @@
+export interface ImageAnalysisConfig {
+    prompt?: string;
+    temperature?: number;
+    imagePath?: string;
+    maxTokens?: number;
+    systemPrompt?: string;
+    baseUrl?: string;
+    apiKey?: string;
+    supportedFormats?: string[];
+    maxFileSize?: number;
+}
+export declare const MODEL_NAME = "moonshot-v1-128k-vision-preview";
+export declare const DEFAULT_CONFIG: ImageAnalysisConfig;
+export declare function createConfig(baseConfig?: Partial<ImageAnalysisConfig>): ImageAnalysisConfig;

package/dist/services/image-analysis/factory.d.ts

@@ -0,0 +1,33 @@
+import { ImageAnalysisService } from './image-analysis';
+/**
+ * Creates a new instance of the ImageAnalysisService
+ *
+ * Note: Configuration is now handled by the unified OpenAI service
+ *
+ * @param config - Legacy parameter (ignored, kept for backward compatibility)
+ * @returns A new ImageAnalysisService instance
+ *
+ * @example
+ * ```typescript
+ * const service = createImageAnalysisService();
+ * ```
+ */
+export declare function createImageAnalysisService(config?: any): ImageAnalysisService;
+/**
+ * Default singleton instance of the ImageAnalysisService
+ *
+ * This instance uses the default configuration or environment variables.
+ *
+ * @example
+ * ```typescript
+ * import { imageAnalysisService } from 'src/services/image-analysis';
+ *
+ * const result = await imageAnalysisService.analyzeImage({
+ *   imagePath: '/path/to/image.jpg',
+ *   prompt: 'Describe this image',
+ *   maxTokens: 4000,
+ *   temperature: 0.7
+ * });
+ * ```
+ */
+export declare const imageAnalysisService: ImageAnalysisService;

package/dist/services/image-analysis/image-analysis.d.ts

@@ -0,0 +1,36 @@
+import { ImageAnalysisParams, ImageAnalysisResult } from './types';
+/**
+ * Service for analyzing images using the unified OpenAI service
+ */
+export declare class ImageAnalysisService {
+    /**
+     * Creates a new instance of the ImageAnalysisService
+     */
+    constructor();
+    /**
+     * Analyzes an image using the moonshot-vision model
+     *
+     * @param params - Parameters for the image analysis
+     * @param params.imagePath - Absolute path to the local image file
+     * @param params.prompt - The prompt describing what to analyze in the image
+     * @param params.maxTokens - Maximum tokens to generate (default: 4000)
+     * @param params.temperature - Temperature for generation (default: 0.7)
+     * @param params.systemPrompt - Optional system prompt to set behavior
+     * @returns Analysis result with content, usage statistics, and metadata
+     *
+     * @example
+     * ```typescript
+     * const result = await imageAnalysisService.analyzeImage({
+     *   imagePath: '/path/to/image.jpg',
+     *   prompt: 'Describe this image in detail',
+     *   maxTokens: 4000,
+     *   temperature: 0.7
+     * });
+     *
+     * console.log(result.content);
+     * ```
+     *
+     * @throws {ImageAnalysisError} If the image cannot be analyzed
+     */
+    analyzeImage(params: ImageAnalysisParams): Promise<ImageAnalysisResult>;
+}

package/dist/services/image-analysis/image-encoder.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Utility class for encoding images to base64
+ */
+export declare class ImageEncoder {
+    /**
+     * Encodes an image file to base64 with data URI scheme
+     *
+     * @param imagePath - Absolute path to the image file
+     * @returns Base64 encoded image with data URI scheme
+     * @throws ImageAnalysisError if the file cannot be encoded
+     */
+    static encodeImageToBase64(imagePath: string): Promise<string>;
+    /**
+     * Streams a file to base64 string for memory efficiency
+     *
+     * @param filePath - Path to the file
+     * @returns Base64 encoded string
+     */
+    private static streamToBase64;
+}

package/dist/services/image-analysis/image-validator.d.ts

@@ -0,0 +1,30 @@
+import { ImageFileInfo } from './types';
+/**
+ * Utility class for validating image files
+ */
+export declare class ImageValidator {
+    static readonly SUPPORTED_FORMATS: string[];
+    static readonly MAX_FILE_SIZE: number;
+    /**
+     * Validates an image file
+     *
+     * @param imagePath - Absolute path to the image file
+     * @returns Information about the image file
+     * @throws ImageAnalysisError if the file is invalid
+     */
+    static validateImage(imagePath: string): Promise<ImageFileInfo>;
+    /**
+     * Checks if the image format is supported
+     *
+     * @param format - Image format (extension)
+     * @returns True if the format is supported
+     */
+    static isFormatSupported(format: string): boolean;
+    /**
+     * Gets the MIME type for an image format
+     *
+     * @param format - Image format (extension)
+     * @returns MIME type string
+     */
+    static getMimeType(format: string): string;
+}

package/dist/services/image-analysis/index.d.ts

@@ -0,0 +1,29 @@
+import { ImageAnalysisService } from "./image-analysis";
+import { ImageValidator } from "./image-validator";
+import { ImageEncoder } from "./image-encoder";
+import { ImageAnalysisParams, ImageAnalysisResult, ImageFileInfo, ErrorCodes, ImageAnalysisError } from "./types";
+import { createImageAnalysisService, imageAnalysisService } from "./factory";
+/**
+ * @module ImageAnalysis
+ *
+ * A service for analyzing images using the Moonshot Vision API.
+ * This service allows you to analyze local images with custom prompts
+ * using the moonshot-vision model.
+ *
+ * @example
+ * ```typescript
+ * import { imageAnalysisService } from 'src/services/image-analysis';
+ *
+ * const result = await imageAnalysisService.analyzeImage({
+ *   imagePath: '/path/to/image.jpg',
+ *   prompt: 'Describe this image',
+ *   maxTokens: 4000,
+ *   temperature: 0.7
+ * });
+ *
+ * console.log(result.content);
+ * ```
+ */
+export { ImageAnalysisService, ImageValidator, ImageEncoder, createImageAnalysisService, imageAnalysisService, };
+export { analyzeImageTool, imageAnalysisTools } from "./tools";
+export type { ImageAnalysisParams, ImageAnalysisResult, ImageFileInfo, ErrorCodes, ImageAnalysisError, };

package/dist/services/image-analysis/tools.d.ts

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+/**
+ * Tool for analyzing images using the moonshot-vision model
+ */
+export declare const analyzeImageTool: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{
+        imagePath: z.ZodString;
+        prompt: z.ZodString;
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        systemPrompt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        prompt: string;
+        imagePath: string;
+        temperature?: number | undefined;
+        maxTokens?: number | undefined;
+        systemPrompt?: string | undefined;
+    }, {
+        prompt: string;
+        imagePath: string;
+        temperature?: number | undefined;
+        maxTokens?: number | undefined;
+        systemPrompt?: string | undefined;
+    }>;
+    execute: (args: any) => Promise<string>;
+};
+/**
+ * Export all image analysis tools
+ */
+export declare const imageAnalysisTools: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{
+        imagePath: z.ZodString;
+        prompt: z.ZodString;
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        systemPrompt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        prompt: string;
+        imagePath: string;
+        temperature?: number | undefined;
+        maxTokens?: number | undefined;
+        systemPrompt?: string | undefined;
+    }, {
+        prompt: string;
+        imagePath: string;
+        temperature?: number | undefined;
+        maxTokens?: number | undefined;
+        systemPrompt?: string | undefined;
+    }>;
+    execute: (args: any) => Promise<string>;
+}[];

package/dist/services/image-analysis/types.d.ts

@@ -0,0 +1,154 @@
+import { z } from 'zod';
+/**
+ * Parameters for image analysis requests
+ *
+ * @example
+ * ```typescript
+ * const params: ImageAnalysisParams = {
+ *   imagePath: '/path/to/image.jpg',
+ *   prompt: 'Describe this image in detail',
+ *   maxTokens: 2000,
+ *   temperature: 0.5,
+ *   systemPrompt: 'You are a helpful assistant'
+ * };
+ * ```
+ */
+export declare const ImageAnalysisParams: z.ZodObject<{
+    imagePath: z.ZodEffects<z.ZodString, string, string>;
+    prompt: z.ZodString;
+    maxTokens: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    temperature: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    systemPrompt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    prompt: string;
+    temperature: number;
+    imagePath: string;
+    maxTokens: number;
+    systemPrompt?: string | undefined;
+}, {
+    prompt: string;
+    imagePath: string;
+    temperature?: number | undefined;
+    maxTokens?: number | undefined;
+    systemPrompt?: string | undefined;
+}>;
+export type ImageAnalysisParams = z.infer<typeof ImageAnalysisParams>;
+/**
+ * Result of image analysis
+ *
+ * @example
+ * ```typescript
+ * const result: ImageAnalysisResult = {
+ *   content: 'This is an image of a cat sitting on a windowsill...',
+ *   usage: {
+ *     promptTokens: 100,
+ *     completionTokens: 50,
+ *     totalTokens: 150
+ *   },
+ *   metadata: {
+ *     imagePath: '/path/to/image.jpg',
+ *     imageSize: 1024000,
+ *     imageFormat: 'jpg',
+ *     processingTime: 1500
+ *   }
+ * };
+ * ```
+ */
+export interface ImageAnalysisResult {
+    content: string;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    metadata: {
+        imagePath: string;
+        imageSize: number;
+        imageFormat: string;
+        processingTime: number;
+    };
+}
+/**
+ * Information about an image file
+ */
+export interface ImageFileInfo {
+    exists: boolean;
+    size: number;
+    format: string;
+    isSupported: boolean;
+    mimeType: string;
+}
+/**
+ * Vision API request structure
+ * Note: The model is hardcoded to 'moonshot-v1-8k-vision-preview' and cannot be configured.
+ */
+export interface VisionRequest {
+    model: string;
+    messages: Array<{
+        role: 'user' | 'system';
+        content: Array<{
+            type: 'text' | 'image_url';
+            text?: string;
+            image_url?: {
+                url: string;
+            };
+        }>;
+    }>;
+    max_tokens?: number;
+    temperature?: number;
+}
+/**
+ * Vision API response structure
+ */
+export interface VisionResponse {
+    choices: Array<{
+        message: {
+            content: string;
+            role: string;
+        };
+        finish_reason: string;
+    }>;
+    usage: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+/**
+ * Error codes for image analysis
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await imageAnalysisService.analyzeImage(params);
+ * } catch (error) {
+ *   if (error instanceof ImageAnalysisError) {
+ *     switch (error.code) {
+ *       case ErrorCodes.FILE_NOT_FOUND:
+ *         console.error('Image file not found');
+ *         break;
+ *       case ErrorCodes.API_ERROR:
+ *         console.error('API error:', error.message);
+ *         break;
+ *       // Handle other error codes
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare enum ErrorCodes {
+    FILE_NOT_FOUND = "FILE_NOT_FOUND",
+    UNSUPPORTED_FORMAT = "UNSUPPORTED_FORMAT",
+    FILE_TOO_LARGE = "FILE_TOO_LARGE",
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    API_ERROR = "API_ERROR",
+    VALIDATION_ERROR = "VALIDATION_ERROR"
+}
+/**
+ * Custom error class for image analysis errors
+ */
+export declare class ImageAnalysisError extends Error {
+    code: ErrorCodes;
+    details?: any | undefined;
+    constructor(message: string, code: ErrorCodes, details?: any | undefined);
+}

package/dist/services/image-converter/converter.d.ts

@@ -0,0 +1,84 @@
+export interface ConvertImageOptions {
+    input_path: string;
+    output_format: string;
+    quality?: number;
+    width?: number;
+    height?: number;
+    maintain_aspect_ratio?: boolean;
+    output_path?: string;
+}
+export interface BatchConvertOptions {
+    input_paths: string[];
+    output_format: string;
+    quality?: number;
+    width?: number;
+    height?: number;
+    maintain_aspect_ratio?: boolean;
+    output_directory?: string;
+}
+export interface ConvertResult {
+    output_path: string;
+    file_size: number;
+    dimensions: {
+        width: number;
+        height: number;
+    };
+    format: string;
+}
+export interface BatchConvertResult {
+    success: boolean;
+    output_path?: string;
+    error?: string;
+}
+export interface ImageInfo {
+    format: string;
+    width: number;
+    height: number;
+    channels: number;
+    size: number;
+    space?: string;
+}
+export declare class ImageConverter {
+    private supportedInputFormats;
+    private supportedOutputFormats;
+    constructor();
+    /**
+     * 转换单个图片
+     */
+    convertImage(options: ConvertImageOptions): Promise<ConvertResult>;
+    /**
+     * 批量转换图片
+     */
+    batchConvertImages(options: BatchConvertOptions): Promise<BatchConvertResult[]>;
+    /**
+     * 获取图片信息
+     */
+    getImageInfo(imagePath: string): Promise<ImageInfo>;
+    /**
+     * 获取支持的格式列表
+     */
+    getSupportedFormats(): {
+        input: string[];
+        output: string[];
+    };
+    /**
+     * 转换为SVG格式
+     */
+    private convertToSvg;
+    /**
+     * 转换为ICO格式（简化版本）
+     */
+    private convertToIco;
+    /**
+     * 获取文件格式
+     */
+    private getFileFormat;
+    /**
+     * 生成输出文件路径
+     */
+    private generateOutputPath;
+    /**
+     * 生成输出文件名
+     */
+    private generateOutputFilename;
+}