intention-coding 0.2.4 → 0.2.5

package/dist/prompt/{change-analysis.md → change-analysis.ts}

@@ -1,4 +1,4 @@
-请分析本次代码变更，并与需求进行对比，确保实现的完整性。
+export const changeAnalysisPrompt = `请分析本次代码变更，并与需求进行对比，确保实现的完整性。
 
 请按以下步骤进行分析：
 
@@ -50,4 +50,4 @@
 - 后续开发建议
 - 测试建议
 
-请确保所有表格上下对齐，内容详实准确。
+请确保所有表格上下对齐，内容详实准确。`;

package/dist/services/change-summarizer/prompt/change-analysis.d.ts

@@ -0,0 +1 @@
+export declare const changeAnalysisPrompt = "\u8BF7\u5206\u6790\u672C\u6B21\u4EE3\u7801\u53D8\u66F4\uFF0C\u5E76\u4E0E\u9700\u6C42\u8FDB\u884C\u5BF9\u6BD4\uFF0C\u786E\u4FDD\u5B9E\u73B0\u7684\u5B8C\u6574\u6027\u3002\n\n\u8BF7\u6309\u4EE5\u4E0B\u6B65\u9AA4\u8FDB\u884C\u5206\u6790\uFF1A\n\n## 1. \u4EE3\u7801\u53D8\u66F4\u603B\u7ED3\n\u5206\u6790git diff\u5185\u5BB9\uFF0C\u603B\u7ED3\uFF1A\n- \u65B0\u589E\u6587\u4EF6\u53CA\u5176\u529F\u80FD\n- \u4FEE\u6539\u6587\u4EF6\u53CA\u53D8\u66F4\u5185\u5BB9\n- \u5220\u9664\u6587\u4EF6\u53CA\u539F\u56E0\n- \u4E3B\u8981\u529F\u80FD\u6A21\u5757\u53D8\u66F4\n\n## 2. \u63A5\u53E3\u4E0E\u9700\u6C42\u5BF9\u5E94\u5173\u7CFB\u8868\n\u6839\u636E\u4EE3\u7801\u53D8\u66F4\uFF0C\u751F\u6210\u63A5\u53E3\u4E0E\u9700\u6C42\u5BF9\u5E94\u5173\u7CFB\u8868\uFF1A\n\n| \u9700\u6C42\u529F\u80FD | \u5B9E\u73B0\u63A5\u53E3 | \u8BF7\u6C42\u65B9\u5F0F | URL | \u53D8\u66F4\u72B6\u6001 |\n|---------|---------|---------|-----|----------|\n| [\u9700\u6C42\u529F\u80FD\u63CF\u8FF0] | [Controller.method] | [GET/POST/PUT/DELETE] | [/api/path] | [\u65B0\u589E/\u4FEE\u6539/\u5220\u9664] |\n\n## 3. \u6838\u5FC3\u903B\u8F91\u65B9\u6CD5\u8868\n\u5206\u6790\u6838\u5FC3\u4E1A\u52A1\u903B\u8F91\u65B9\u6CD5\uFF1A\n\n| \u65B9\u6CD5\u540D\u79F0 | \u6240\u5C5E\u7C7B | \u529F\u80FD\u8BF4\u660E | \u53D8\u66F4\u72B6\u6001 |\n|---------|-------|---------|----------|\n| [methodName] | [ClassName] | [\u529F\u80FD\u63CF\u8FF0] | [\u65B0\u589E/\u4FEE\u6539/\u5220\u9664] |\n\n## 4. \u524D\u7AEF\u9875\u9762\u4E0E\u63A5\u53E3\u5BF9\u5E94\u5173\u7CFB\u8868\n\u5206\u6790\u524D\u7AEF\u9875\u9762\u53D8\u66F4\uFF1A\n\n| \u9875\u9762\u540D\u79F0 | \u8C03\u7528\u63A5\u53E3 | \u7EC4\u4EF6\u540D\u79F0 | \u8DEF\u7531\u8DEF\u5F84 | \u53D8\u66F4\u72B6\u6001 |\n|---------|---------|---------|---------|----------|\n| [\u9875\u9762\u540D\u79F0] | [Controller.method] | [ComponentName] | [/path] | [\u65B0\u589E/\u4FEE\u6539/\u5220\u9664] |\n\n## 5. \u524D\u7AEF\u6838\u5FC3\u7EC4\u4EF6\u8868\n\u5206\u6790\u524D\u7AEF\u7EC4\u4EF6\u53D8\u66F4\uFF1A\n\n| \u7EC4\u4EF6\u540D\u79F0 | \u6240\u5C5E\u9875\u9762 | \u529F\u80FD\u8BF4\u660E | \u53D8\u66F4\u72B6\u6001 |\n|---------|---------|---------|----------|\n| [ComponentName] | [PageName] | [\u529F\u80FD\u63CF\u8FF0] | [\u65B0\u589E/\u4FEE\u6539/\u5220\u9664] |\n\n## 6. \u9700\u6C42\u5B8C\u6574\u6027\u68C0\u67E5\n\u5BF9\u6BD4\u539F\u59CB\u9700\u6C42\uFF0C\u68C0\u67E5\uFF1A\n- \u2705 \u5DF2\u5B8C\u6210\u7684\u529F\u80FD\n- \u26A0\uFE0F  \u90E8\u5206\u5B8C\u6210\u7684\u529F\u80FD\n- \u274C \u672A\u5B9E\u73B0\u7684\u529F\u80FD\n- \uD83D\uDD04 \u9700\u8981\u8FDB\u4E00\u6B65\u5B8C\u5584\u7684\u529F\u80FD\n\n## 7. \u5EFA\u8BAE\u4E0E\u603B\u7ED3\n- \u5B9E\u73B0\u8D28\u91CF\u8BC4\u4F30\n- \u6F5C\u5728\u95EE\u9898\u8BC6\u522B\n- \u540E\u7EED\u5F00\u53D1\u5EFA\u8BAE\n- \u6D4B\u8BD5\u5EFA\u8BAE\n\n\u8BF7\u786E\u4FDD\u6240\u6709\u8868\u683C\u4E0A\u4E0B\u5BF9\u9F50\uFF0C\u5185\u5BB9\u8BE6\u5B9E\u51C6\u786E\u3002";

package/dist/services/claude-code/index.d.ts

@@ -109,25 +109,25 @@ export declare const claudeCodeSessions: {
                 start: z.ZodOptional<z.ZodString>;
                 end: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
-                start?: string | undefined;
                 end?: string | undefined;
-            }, {
                 start?: string | undefined;
+            }, {
                 end?: string | undefined;
+                start?: string | undefined;
             }>>;
             sizeLimit: z.ZodOptional<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
             project?: string | undefined;
             dateRange?: {
-                start?: string | undefined;
                 end?: string | undefined;
+                start?: string | undefined;
             } | undefined;
             sizeLimit?: number | undefined;
         }, {
             project?: string | undefined;
             dateRange?: {
-                start?: string | undefined;
                 end?: string | undefined;
+                start?: string | undefined;
             } | undefined;
             sizeLimit?: number | undefined;
         }>>;
@@ -148,8 +148,8 @@ export declare const claudeCodeSessions: {
         filter?: {
             project?: string | undefined;
             dateRange?: {
-                start?: string | undefined;
                 end?: string | undefined;
+                start?: string | undefined;
             } | undefined;
             sizeLimit?: number | undefined;
         } | undefined;
@@ -165,8 +165,8 @@ export declare const claudeCodeSessions: {
         filter?: {
             project?: string | undefined;
             dateRange?: {
-                start?: string | undefined;
                 end?: string | undefined;
+                start?: string | undefined;
             } | undefined;
             sizeLimit?: number | undefined;
         } | 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/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Export all services
+ */
+export * from './image-analysis';
+export { imageAnalysisTools } from './image-analysis/tools';

package/dist/{services → utils}/openai-service.d.ts

@@ -18,12 +18,42 @@ export declare const OpenAIParams: z.ZodObject<{
     temperature?: number | undefined;
     system_prompt?: string | undefined;
 }>;
+export declare const VisionParams: z.ZodObject<{
+    prompt: z.ZodString;
+    image_base64: z.ZodString;
+    model: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    max_tokens: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    temperature: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    system_prompt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    prompt: string;
+    model: string;
+    max_tokens: number;
+    temperature: number;
+    image_base64: string;
+    system_prompt?: string | undefined;
+}, {
+    prompt: string;
+    image_base64: string;
+    model?: string | undefined;
+    max_tokens?: number | undefined;
+    temperature?: number | undefined;
+    system_prompt?: string | undefined;
+}>;
 export type OpenAIParams = z.infer<typeof OpenAIParams>;
+export type VisionParams = z.infer<typeof VisionParams>;
 export declare class OpenAIService {
     private apiKey;
     private baseUrl;
     constructor(apiKey?: string, baseUrl?: string);
     generateText(params: OpenAIParams): Promise<string>;
     generateStream(params: OpenAIParams): Promise<AsyncIterable<string>>;
+    /**
+     * Analyze an image using vision capabilities
+     *
+     * @param params - Vision analysis parameters
+     * @returns Analysis result content
+     */
+    analyzeImage(params: VisionParams): Promise<string>;
 }
 export declare const openAIService: OpenAIService;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "intention-coding",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "软件工程化的需求分析，功能设计，代码编写，测试运行和发布部署",
   "type": "module",
   "exports": {