@blocklet/pages-kit-agents 0.5.41 → 0.5.43

package/lib/esm/utils/component-tuils.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+export declare function getSchemaByComponentIds(sections: {
+    componentId: string;
+    componentName: string;
+    sectionName: string;
+}[]): z.ZodObject<Record<string, any>, "strip", z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+export declare function getComponentsSimpleMetadata(): string;
+export declare function getComponentsMetadata(): string;

package/lib/esm/utils/component-tuils.js

@@ -0,0 +1,136 @@
+import { zodSchemaToJsonSchema } from '@blocklet/pages-kit-block-studio/zod-utils';
+import { z } from 'zod';
+const componentList = [
+    {
+        name: 'HeroV2',
+        id: '1',
+        description: 'Hero 区域，展示核心价值主张，主 CTA',
+        properties: z.object({
+            title: z.string().describe('主标题'),
+            description: z.string().describe('描述'),
+            image: z.string().describe('图片'),
+            buttons: z
+                .array(z.object({
+                text: z.string().describe('按钮文本'),
+                link: z.string().describe('按钮链接'),
+            }))
+                .describe('按钮列表'),
+        }),
+    },
+    {
+        name: 'ContentCards',
+        id: '2',
+        description: 'Hero、Features 、 Benefits、How it Works、',
+        properties: z.object({
+            title: z.string().describe('标题'),
+            description: z.string().describe('描述'),
+            list: z
+                .array(z.object({
+                title: z.string().describe('标题'),
+                description: z.string().describe('描述'),
+                image: z.string().describe('图片'),
+            }))
+                .describe('列表'),
+        }),
+    },
+    {
+        name: 'FAQ',
+        id: '3',
+        description: 'FAQ 区域，展示常见问题及答案',
+        properties: z.object({
+            title: z.string().describe('标题'),
+            list: z
+                .array(z.object({
+                question: z.string().describe('问题'),
+                answer: z.string().describe('答案'),
+            }))
+                .describe('列表'),
+        }),
+    },
+    {
+        name: 'Pricing',
+        id: '4',
+        description: 'Pricing 区域，展示价格方案',
+        properties: z.object({
+            title: z.string().describe('标题'),
+            list: z
+                .array(z.object({
+                title: z.string().describe('标题'),
+                description: z.string().describe('描述'),
+                price: z.string().describe('价格'),
+            }))
+                .describe('列表'),
+        }),
+    },
+    {
+        name: 'CTA',
+        id: '5',
+        description: 'CTA 区域，展示最终行动召唤',
+        properties: z.object({
+            title: z.string().describe('标题'),
+            description: z.string().describe('描述'),
+            buttons: z
+                .array(z.object({
+                text: z.string().describe('按钮文本'),
+                link: z.string().describe('按钮链接'),
+            }))
+                .describe('按钮列表'),
+        }),
+    },
+    {
+        name: 'Logo List',
+        id: '6',
+        description: 'Logo 列表，展示合作伙伴',
+        properties: z.object({
+            title: z.string().describe('标题'),
+            list: z
+                .array(z.object({
+                image: z.string().describe('图片'),
+                name: z.string().describe('名称'),
+                link: z.string().describe('链接'),
+            }))
+                .describe('列表'),
+        }),
+    },
+];
+export function getSchemaByComponentIds(sections) {
+    const schemaObject = {};
+    sections.forEach((section) => {
+        const component = componentList.find((comp) => comp.id === section.componentId);
+        if (component) {
+            schemaObject[section.sectionName] = component.properties;
+        }
+    });
+    return z.object(schemaObject);
+}
+export function getComponentsSimpleMetadata() {
+    return componentList
+        .map((component) => {
+        const context = `
+    ------------------------------------------------------------
+     组件名称：${component.name}
+     组件Id：${component.id}
+     组件描述(适用场景)：${component.description}
+    ------------------------------------------------------------
+    `;
+        return context;
+    })
+        .filter(Boolean)
+        .join('\n');
+}
+export function getComponentsMetadata() {
+    return componentList
+        .map((component) => {
+        const context = `
+    ------------------------------------------------------------
+     组件名称：${component.name}
+     组件Id：${component.id}
+     组件描述(适用场景)：${component.description}
+     组件属性结构：${JSON.stringify(zodSchemaToJsonSchema(component.properties))}
+    ------------------------------------------------------------
+    `;
+        return context;
+    })
+        .filter(Boolean)
+        .join('\n');
+}

package/lib/esm/utils/file-utils.d.ts

@@ -3,3 +3,26 @@
  * and generating a list of all HTML files in each subfolder
  */
 export declare function updateFileList(): Promise<void>;
+/**
+ * File content information interface
+ */
+export interface FileContent {
+    filePath: string;
+    fileName: string;
+    content: string;
+}
+/**
+ * Recursively reads files matching a pattern from a directory and its subdirectories
+ * @param dirPath - The directory path to search in
+ * @param pattern - String or RegExp pattern to match file names
+ * @param options - Optional configuration
+ * @returns Promise<FileContent[]> - Array of file content objects
+ */
+export declare function readFilesByPattern(dirPath: string, pattern: string | RegExp, options?: {
+    recursive?: boolean;
+}): Promise<FileContent[]>;
+export declare function readFileByPath(filePath: string): Promise<string>;
+/**
+ * Save content to a file, creating directories if needed
+ */
+export declare function saveFileByPath(filePath: string, content: string): Promise<void>;

package/lib/esm/utils/file-utils.js

@@ -103,3 +103,77 @@ const FILE_LIST_DATA = [];`);
         console.error('Error updating file list:', error);
     }
 }
+/**
+ * Recursively reads files matching a pattern from a directory and its subdirectories
+ * @param dirPath - The directory path to search in
+ * @param pattern - String or RegExp pattern to match file names
+ * @param options - Optional configuration
+ * @returns Promise<FileContent[]> - Array of file content objects
+ */
+export async function readFilesByPattern(dirPath, pattern, options = { recursive: true }) {
+    const results = [];
+    // Convert string pattern to RegExp if needed
+    const regex = typeof pattern === 'string' ? new RegExp(pattern) : pattern;
+    /**
+     * Recursively process directory
+     */
+    async function processDirectory(currentPath) {
+        try {
+            const entries = await fs.readdir(currentPath, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(currentPath, entry.name);
+                if (entry.isDirectory() && options.recursive) {
+                    // Recursively process subdirectory
+                    await processDirectory(fullPath);
+                }
+                else if (entry.isFile() && regex.test(entry.name)) {
+                    // Read file content if it matches the pattern
+                    try {
+                        const content = await fs.readFile(fullPath, 'utf8');
+                        results.push({
+                            filePath: fullPath,
+                            fileName: entry.name,
+                            content,
+                        });
+                    }
+                    catch (fileError) {
+                        // Ignore individual file read errors and continue
+                        console.warn(`Warning: Failed to read file ${fullPath}:`, fileError);
+                    }
+                }
+            }
+        }
+        catch (dirError) {
+            // Ignore directory read errors and continue
+            console.warn(`Warning: Failed to read directory ${currentPath}:`, dirError);
+        }
+    }
+    // Check if the directory exists before processing
+    if (!existsSync(dirPath)) {
+        console.warn(`Warning: Directory ${dirPath} does not exist`);
+        return results;
+    }
+    await processDirectory(dirPath);
+    return results;
+}
+// 读取文件内容
+export async function readFileByPath(filePath) {
+    try {
+        const absolutePath = path.resolve(process.cwd(), filePath);
+        const content = await fs.readFile(absolutePath, 'utf-8');
+        return content;
+    }
+    catch (error) {
+        throw new Error(`无法读取文件 "${filePath}": ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Save content to a file, creating directories if needed
+ */
+export async function saveFileByPath(filePath, content) {
+    const pathModule = await import('path');
+    const fsModule = await import('fs/promises');
+    const dir = pathModule.dirname(filePath);
+    await fsModule.mkdir(dir, { recursive: true });
+    await fsModule.writeFile(filePath, content, 'utf8');
+}

package/lib/esm/workflow-agents/reflection-agent.d.ts

@@ -0,0 +1,16 @@
+import { Agent, type AgentInvokeOptions, type AgentOptions, type AgentProcessResult, type Message } from '@aigne/core';
+import type { PromiseOrValue } from '@aigne/core/utils/type-utils.js';
+export interface ReflectionAgentOptions<I extends Message = Message, RO extends Message = Message> extends AgentOptions<I, I> {
+    editor: Agent<I, I>;
+    reviewer: Agent<I, RO>;
+    isApproved?: (result: RO) => PromiseOrValue<boolean>;
+    maxIterations?: number;
+}
+export declare class ReflectionAgent<I extends Message = Message, RO extends Message = Message> extends Agent<I, I> {
+    constructor(options: ReflectionAgentOptions<I, RO>);
+    editor: Agent<I, I>;
+    reviewer: Agent<I, RO>;
+    isApproved?: (result: RO) => PromiseOrValue<boolean>;
+    maxIterations: number;
+    process(input: I, options: AgentInvokeOptions): Promise<AgentProcessResult<I>>;
+}

package/lib/esm/workflow-agents/reflection-agent.js

@@ -0,0 +1,34 @@
+import { Agent } from '@aigne/core';
+const DEFAULT_MAX_ITERATIONS = 3;
+export class ReflectionAgent extends Agent {
+    constructor(options) {
+        super(options);
+        this.editor = options.editor;
+        this.reviewer = options.reviewer;
+        this.isApproved = options.isApproved;
+        this.maxIterations = options.maxIterations ?? DEFAULT_MAX_ITERATIONS;
+    }
+    editor;
+    reviewer;
+    isApproved;
+    maxIterations;
+    async process(input, options) {
+        let previousResult = input;
+        let reviewResult;
+        let iterations = 0;
+        // 先执行一次 editor，确保有结果
+        previousResult = await options.context.invoke(this.editor, previousResult);
+        do {
+            reviewResult = await options.context.invoke(this.reviewer, previousResult);
+            const isApproved = await this.isApproved?.(reviewResult);
+            if (isApproved === true) {
+                return previousResult;
+            }
+            previousResult = await options.context.invoke(this.editor, {
+                ...previousResult,
+                ...reviewResult,
+            });
+        } while (++iterations < this.maxIterations);
+        return previousResult;
+    }
+}

package/lib/types/agents/template-designer.d.ts

@@ -0,0 +1,13 @@
+import { AIAgent } from '@aigne/core';
+/**
+ * 用于设计页面结构的 workflow
+ * 1. AI 根据拿到的 collectorResult 和 componentList，生成一个页面设计模板，需要用 ASCII 图画出来，给到用户确认
+ * 2. 用户确认后，AI 保存页面设计模板，并返回页面设计模板
+ */
+export declare const designerAgent: AIAgent<{
+    collectResult: string;
+}, {
+    ascii: string;
+    $message: string;
+    filteredComponentList: string[];
+}>;

package/lib/types/agents/template-generator.d.ts

@@ -0,0 +1,18 @@
+import { FunctionAgent } from '@aigne/core';
+import { ReflectionAgent } from '../workflow-agents/reflection-agent.js';
+export declare const generatorAgentWithReflection: ReflectionAgent<{
+    ascii: string;
+    collectResult: string;
+    $message: string;
+    filteredComponentList: string[];
+    feedback?: string | null | undefined;
+}, {
+    isApproved: boolean;
+    feedback: string;
+}>;
+export declare const saveYamlAgent: FunctionAgent<{
+    $message: string;
+    yaml: string;
+}, {
+    $message: string;
+} & import("@aigne/core").Message>;