@blocklet/pages-kit-agents 0.5.12

package/lib/cjs/agents/page-metadata-generator.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generatePageMetadataAgent = void 0;
+const core_1 = require("@aigne/core");
+const zod_1 = require("zod");
+const prompt = `您是一名专业的SEO和内容编辑专家，擅长创建有吸引力和描述性强的页面元数据。
+
+您的职责
+1. 基于已生成的页面内容，创建准确、吸引人的页面标题
+2. 创建简洁而信息丰富的页面描述，适合在搜索结果和社交媒体分享中显示
+3. 确保标题和描述准确反映页面内容
+4. 优化元数据以提高页面的SEO价值
+
+## 输入上下文:
+{{context}}
+
+## 用户指令:
+{{question}}
+
+## 已生成的页面内容:
+{{sectionsData}}
+
+## 要求
+1. 页面标题：简洁有力，准确描述页面内容，长度在5-10个词之间
+2. 页面描述：提供页面内容的简明概述，长度不超过160个字符
+3. 标题和描述必须基于实际生成的页面内容
+4. 标题和描述应使用 {{locale}} 语言
+
+请为以上页面内容生成合适的标题和描述。`;
+exports.generatePageMetadataAgent = core_1.AIAgent.from({
+    name: 'Page Metadata Generator',
+    instructions: prompt,
+    inputSchema: zod_1.z.object({
+        context: zod_1.z.string(),
+        question: zod_1.z.string(),
+        locale: zod_1.z.string(),
+        sectionsData: zod_1.z.string(),
+    }),
+    outputSchema: zod_1.z.object({
+        title: zod_1.z.string().describe('页面标题'),
+        description: zod_1.z.string().describe('页面描述'),
+    }),
+});

package/lib/cjs/agents/page-structure-planner.d.ts

@@ -0,0 +1,55 @@
+import { AIAgent } from '@aigne/core';
+export interface PlanPageStructureInput {
+    context: string;
+    question: string;
+    initialStructurePlan?: Array<{
+        sectionName: string;
+        sectionContentPlan: string;
+    }>;
+    locale: string;
+    outputSchema: any;
+    validationFeedback?: {
+        isValid: boolean;
+        missingSections: string[];
+        duplicateContent: Array<{
+            sections: string[];
+            description: string;
+        }>;
+        feedback: Array<{
+            sectionName: string;
+            feedback: string;
+        }>;
+        generalFeedback: string;
+    };
+}
+export interface PageStructurePlannerOutput {
+    structurePlan: Array<{
+        sectionName: string;
+        sectionContentPlan: string;
+    }>;
+}
+export declare const pageStructurePlannerAgent: AIAgent<{
+    outputSchema: string;
+    context: string;
+    question: string;
+    locale: string;
+    expectedSections: string;
+    initialStructurePlan: {
+        sectionName: string;
+        sectionContentPlan: string;
+    }[];
+    validationFeedback?: {
+        isValid: boolean;
+        missingSections: string[];
+        duplicateContent: {
+            description: string;
+            sections: string[];
+            score: number;
+        }[];
+    } | undefined;
+}, {
+    structurePlan: {
+        sectionName: string;
+        sectionContentPlan: string;
+    }[];
+}>;

package/lib/cjs/agents/page-structure-planner.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pageStructurePlannerAgent = void 0;
+const core_1 = require("@aigne/core");
+const zod_1 = require("zod");
+const logger_js_1 = require("../utils/logger.js");
+/**
+ * 页面结构规划
+ * 基于上下文和输出模式，规划各section显示的内容
+ * 支持根据验证反馈修改方案
+ */
+const prompt = `您是一名有着丰富经验且富有创意的页面结构规划师，擅长分析并规划产品站点的内容结构。
+
+您的职责
+1. 分析用户提供的上下文信息，理解产品的核心功能和价值
+2. 分析输出模式的结构，了解页面可用的各个部分(section)
+3. 为每个section规划合适的内容方向，避免内容重复
+4. 针对不同类型的section提供合适的内容规划
+
+请仔细阅读以下输入信息：
+
+## 输入上下文:
+{{context}}
+
+## 输出结构模式:
+{{outputSchema}}
+
+## 用户指令:
+{{question}}
+
+请注意每个section的描述信息，这将帮助您理解每个section的目的和预期内容。
+
+请按照以下流程工作：
+1. 首先分析上下文，理解产品的核心功能、价值主张和目标用户
+2. 分析输出模式中的sectionsData属性，了解页面包含哪些section
+3. 为每个section规划内容方向，确保各section内容互补而不重复
+4. 返回一个结构化的规划，清楚说明每个section应包含的内容
+5. 如果 Section 中包含列表数据，根据输入上下文中包含的数据，明确指定列表数据的数量，尽可能全的展示上下文中提供的相关数据。
+6. 如果初始结构规划中包含的section，请根据初始结构规划中的内容规划，保持初始结构规划中的内容规划。
+
+针对不同类型的section，考虑以下内容：
+- Hero Section: 应包含产品的核心价值主张和简短描述
+- Feature Section: 应详细说明产品的关键功能和优势
+- FAQ Section: 应包含用户可能提出的问题和相应答案
+- 其他section: 根据section的描述规划合适内容
+
+## 初始结构规划
+{{initialStructurePlan}}
+
+## 上一轮输出的结构规划
+{{structurePlan}}
+
+## 缺失的Section
+{{validationFeedback.missingSections}}
+
+## 内容重复
+{{validationFeedback.duplicateContent}}
+
+请根据上述反馈修改您的结构规划方案，确保:
+1. 包含所有必要的section
+2. 避免不同section之间内容重复
+3. 明确区分各section的内容方向
+4. 遵循section描述中的要求
+
+请为页面的每个section返回一个内容规划，格式为section名称和内容描述, 使用 {{locale}} 语言返回。
+`;
+logger_js_1.logger.info('page structure planner prompt', prompt);
+exports.pageStructurePlannerAgent = core_1.AIAgent.from({
+    name: 'Page Structure Planner',
+    subscribeTopic: [core_1.UserInputTopic, 'revision_request'],
+    publishTopic: (output) => {
+        logger_js_1.logger.info('page structure planner output', JSON.stringify(output.structurePlan));
+        return 'validation_request';
+    },
+    // publishTopic: UserOutputTopic,
+    instructions: prompt,
+    inputSchema: zod_1.z.object({
+        context: zod_1.z.string(),
+        question: zod_1.z.string(),
+        locale: zod_1.z.string(),
+        outputSchema: zod_1.z.string(),
+        expectedSections: zod_1.z.string(),
+        initialStructurePlan: zod_1.z.array(zod_1.z.object({
+            sectionName: zod_1.z.string(),
+            sectionContentPlan: zod_1.z.string(),
+        })),
+        validationFeedback: zod_1.z
+            .object({
+            isValid: zod_1.z.boolean(),
+            missingSections: zod_1.z.array(zod_1.z.string()),
+            duplicateContent: zod_1.z.array(zod_1.z.object({
+                sections: zod_1.z.array(zod_1.z.string()),
+                description: zod_1.z.string(),
+                score: zod_1.z.number(),
+            })),
+        })
+            .optional(),
+    }),
+    outputSchema: zod_1.z.object({
+        structurePlan: zod_1.z.array(zod_1.z.object({
+            sectionName: zod_1.z.string(),
+            sectionContentPlan: zod_1.z.string().describe('该section的内容规划描述'),
+        })),
+    }),
+    includeInputInOutput: true,
+});

package/lib/cjs/agents/page-structure-validator.d.ts

@@ -0,0 +1,30 @@
+import { AIAgent } from '@aigne/core';
+export interface ValidatePageStructureInput {
+    context: string;
+    structurePlan: Array<{
+        sectionName: string;
+        sectionContentPlan: string;
+    }>;
+    expectedSections: string;
+    outputSchema: string;
+}
+export declare const pageStructureValidatorAgent: AIAgent<{
+    outputSchema: string;
+    context: string;
+    question: string;
+    expectedSections: string;
+    structurePlan: {
+        sectionName: string;
+        sectionContentPlan: string;
+    }[];
+}, {
+    validationFeedback: {
+        isValid: boolean;
+        missingSections: string[];
+        duplicateContent: {
+            description: string;
+            sections: string[];
+            score: number;
+        }[];
+    };
+}>;

package/lib/cjs/agents/page-structure-validator.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pageStructureValidatorAgent = void 0;
+const core_1 = require("@aigne/core");
+const zod_1 = require("zod");
+const logger_js_1 = require("../utils/logger.js");
+/**
+ * 验证页面结构规划
+ * 检查是否包含所有必要section，以及是否存在信息重复
+ */
+const prompt = `您是一名页面结构规划审核专家，擅长分析内容规划的完整性和有效性。
+
+您的职责
+1. 检查页面结构规划是否涵盖了所有必要的section
+2. 分析各section内容规划之间是否存在内容重复
+3. 确保内容规划与section描述相符
+4. 提出需要改进的具体方向
+
+## 输入上下文:
+{{context}}
+
+## 用户指令:
+{{question}}
+
+## 初始结构规划
+{{initialStructurePlan}}
+
+## 页面结构规划
+{{structurePlan}}
+
+## 预期包含的Sections
+{{expectedSections}}
+
+## 输出模式（包含section描述）
+{{outputSchema}}
+
+请按照以下流程工作：
+1. 缺失项检查：检查是否所有预期 section 都在结构规划中出现，若缺失，请列出具体缺失项
+2. 重复项检查（请严格遵循以下判断标准）：
+    仅当同时满足以下所有条件时，才应将两个 section 判定为重复：
+
+    - 两个 section 中的信息核心完全一致，所讲述的功能点在语义上为同一项；
+    - 内容的细节程度相近，未体现出明显的层级差异（如简要 vs. 深度展开）；
+    - 两者目的用途相同（例如都是介绍某个功能，而不是一个概览一个详细讲解）；
+    - 信息之间缺乏新增认知价值或应用角度。
+
+    否则，即使关键词或主题类似，也不应判定为重复。
+
+   - 以下情况 **不构成重复**，请避免误判：
+     2.1 Section A 是简要罗列某些信息，Section B 对该信息进行详细展开；
+     2.2 两个 section 提及了相同的信息，但该信息在两个 section 中都不是核心内容；
+     2.3 两个 section 使用了相同的信息或关键词，但服务于不同的核心功能或描述重点。     
+
+      【重复示例】
+      - Section A: 简要展示 5 个工作流特性（并发、顺序、路由等）
+      - Section B: 逐一讲解这 5 个工作流的结构与代码
+      → 非重复（简要 vs. 详细）
+
+      - Section A: 展示并发、顺序、路由工作流的用法
+      - Section B: 以不同方式再次展示这 3 个相同工作流及其用途
+      → 可判定为重复（内容本质一致）
+
+    特别注意：
+    - 如 FeatureList 是特性的简要展示，而 FeatureDetailSection 是详细介绍该特性的实际应用场景，这种搭配为常见的“概览 + 深度讲解”模式，**属于结构合理、信息递进，不应视为重复**。
+
+
+3. 检查上下文中主要的信息在规划中是否有缺失
+4. 检查section规划是否与section描述（如果有）相符
+5. 如果 section 中包含列表数据，检查描述中是否指定具体的数量，指定的数量是否尽可能包含了上下文中所有相关数据。
+6. 如果初始结构规划中包含的section，请根据初始结构规划中的内容规划，保持初始结构规划中的内容规划。
+
+请注意，您的职责是审核和提供反馈，而不是重写或修改结构规划。`;
+logger_js_1.logger.info('page structure validator prompt', prompt);
+exports.pageStructureValidatorAgent = core_1.AIAgent.from({
+    name: 'Page Structure Validator',
+    subscribeTopic: 'validation_request',
+    publishTopic: (output) => {
+        logger_js_1.logger.info('page structure validator feedback', JSON.stringify(output.validationFeedback));
+        const isInvalid = output.validationFeedback.missingSections?.length > 0 ||
+            (output.validationFeedback.duplicateContent?.length > 0 &&
+                output.validationFeedback.duplicateContent.some((item) => item.score > 75));
+        return isInvalid ? 'revision_request' : core_1.UserOutputTopic;
+    },
+    instructions: prompt,
+    inputSchema: zod_1.z.object({
+        structurePlan: zod_1.z.array(zod_1.z.object({
+            sectionName: zod_1.z.string(),
+            sectionContentPlan: zod_1.z.string(),
+        })),
+        expectedSections: zod_1.z.string(),
+        outputSchema: zod_1.z.string(),
+        context: zod_1.z.string(),
+        question: zod_1.z.string(),
+    }),
+    outputSchema: zod_1.z.object({
+        validationFeedback: zod_1.z.object({
+            isValid: zod_1.z.boolean().describe(`
+            当出现下面两种场景的时候返回 false：
+            1. 存在严重重复的内容，duplicateContent 中存在重复内容得分大于 75 的场景
+            2. 缺失了重要的 section，missingSections 中存在缺失的 section
+
+            请特别注意：
+            - 仅当重复评分超过 75 且符合所有重复标准时，才可将 isValid 设为 false。
+
+            其他场景都返回 true
+            `),
+            missingSections: zod_1.z.array(zod_1.z.string()).describe('缺失的section列表'),
+            duplicateContent: zod_1.z
+                .array(zod_1.z.object({
+                sections: zod_1.z.array(zod_1.z.string()).describe('存在内容重复的section列表'),
+                description: zod_1.z.string().describe('内容重复的描述'),
+                score: zod_1.z.number().describe(`
+                【重复判断参考评分】
+                0~30：结构或信息逻辑相近，但内容展开和聚焦点完全不同
+                31~60：存在信息重合，但表达方式和内容深度有明显差异
+                61~75：较大信息重叠但结构差异仍存在（注意此时仍不算“严重重复”）
+                76~100：表达几乎一致，属于严重重复内容
+              `),
+            }))
+                .describe('存在内容重复的section组'),
+        }),
+    }),
+    includeInputInOutput: true,
+});

package/lib/cjs/agents/sample-html-generator.d.ts

@@ -0,0 +1,6 @@
+import { AIAgent } from '@aigne/core';
+export declare const sampleHtmlGeneratorAgent: AIAgent<{
+    jsonData: string;
+}, {
+    html: string;
+}>;

package/lib/cjs/agents/sample-html-generator.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sampleHtmlGeneratorAgent = void 0;
+const core_1 = require("@aigne/core");
+const zod_1 = require("zod");
+const prompt = `
+  根据下面内容生成一个 HTML 静态网页
+  1. 原样展示 json 中文案，不要做任何修改
+  2. 强调超大字体或数字突出核心要点，画面中有超大视觉元素强调重点，与小元素的比例形成反差
+  3. 简洁的勾线图形化作为数据可视化或者配图元素
+  4. 运用高亮色自身透明度渐变制造科技感，但是不同高亮色不要互相渐变
+  5. 不需要动画效果
+  6. 尽可能少的为了样式添加依赖，只是需要直观将 json 中文案通过合适的布局展示出来
+  7. 使用HTML5、TailwindCSS 3.0+（通过CDN引入）和必要的JavaScript
+  8. 使用专业图标库如Font Awesome或Material Icons（通过CDN引入）
+  9. 避免使用emoji作为主要图标
+  10. json 中的所有内容都要展示，不要有遗漏
+  11. json 中 sectionsData 对象里的每个属性，对应 html 中的一块内容
+
+
+  JSON 数据:
+  <<<
+  {{jsonData}}
+  >>>
+  `;
+exports.sampleHtmlGeneratorAgent = core_1.AIAgent.from({
+    name: 'Sample HTML Generator',
+    instructions: prompt,
+    inputSchema: zod_1.z.object({
+        jsonData: zod_1.z.string(),
+    }),
+    outputSchema: zod_1.z.object({
+        html: zod_1.z.string(),
+    }),
+});

package/lib/cjs/agents/section-content-generator.d.ts

@@ -0,0 +1,19 @@
+import { AIAgent } from '@aigne/core';
+interface GenerateSectionContentInput {
+    context: string;
+    question: string;
+    locale: string;
+    sectionName: string;
+    sectionSchema: any;
+    sectionPlan: string;
+    generatedSections: string;
+}
+export declare function createSectionContentAgent(input: GenerateSectionContentInput): Promise<AIAgent<{
+    context: string;
+    question: string;
+    locale: string;
+    sectionName: string;
+    sectionPlan: string;
+    generatedSections: string;
+}, import("@aigne/core").Message>>;
+export {};

package/lib/cjs/agents/section-content-generator.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSectionContentAgent = createSectionContentAgent;
+const core_1 = require("@aigne/core");
+const zod_utils_1 = require("@blocklet/pages-kit-block-studio/zod-utils");
+const zod_1 = require("zod");
+const logger_js_1 = require("../utils/logger.js");
+async function createSectionContentAgent(input) {
+    const prompt = `您是一名有着丰富经验且富有创意的设计师，擅长产品站点的内容创作。
+
+您的职责
+1. 为页面中生成高质量内容
+2. 严格按照提供的数据格式生成内容
+3. 保持语气、风格和术语的一致性
+4. 生成引人入胜、信息丰富的内容
+5. 避免与已生成的其他section内容重复
+
+
+针对不同类型的 section，考虑以下内容：
+
+## Hero Section
+
+Hero Section 中的标题必须能充分描述上下文中的产品，标题应该是描述，而不是口号，让用户打开网页第一眼就知道了产品是什么，能帮助用户做什么。
+
+HeroSection 中的描述可以包含两点信息：
+- 我们的产品如何工作的
+- 支撑标题中的描述，让它更可信
+
+## Feature Section
+
+功能的信息应该和 Hero 中的信息相关，能支撑 Hero 中描述能为用户提供的价值。
+功能区域的标题应该是简短的价值主张，不要使用模糊的语言。
+功能区域的描述应该简明扼要地描述该功能，并可选择解决异议（如果这些异议很重要，通常会阻止人们购买）
+如果需要展示功能的示例代码或 flowchart 信息，请使用 markdown 格式展示，并返回 context 中完整的代码块，不要删减。
+
+FAQ 中的问答应该包含用户常关心的问题，并给出答案，如果有相关的链接也请以 markdown 格式返回这些链接。
+最少显示 4 个问答
+
+
+
+## 输入上下文:
+{{context}}
+
+## 用户指令:
+{{question}}
+
+## 当前section信息
+Section名称: {{sectionName}}
+Section计划: {{sectionPlan}}
+
+注意：Section计划是对这个 section 需要展示的内容和风格的要求，您需要根据这个要求来生成面向用户，对用户阅读友好的内容，不要直接重复 section 计划中的要求。
+
+## 数据格式要求
+${JSON.stringify((0, zod_utils_1.zodSchemaToJsonSchema)(input.sectionSchema))}
+
+## 已生成的其他section内容
+{{generatedSections}}
+
+
+## 内容生成要求
+1. 仅生成当前指定section的内容
+2. 避免与已生成的section内容重复
+3. 内容要围绕section计划描述的主题展开
+4. 上下文中有相关图片时返回图片链接，如果没有相关的图片不要随便使用其他图片
+5. 如果数组类型确实没有数据，请返回空数组
+6. 内容需符合提供的数据格式要求
+
+## 内容质量要求
+1. 采用清晰、有吸引力的表达方式，语言专业但不过度夸张
+2. 使用文案技巧：价值驱动、问题导向、CTA 引导
+3. 所有功能点请用主动语态、动词开头表达
+4. 结合卖点与用户痛点
+5. 文案不要太短，不少于 15 字每句，尽量细化内容亮点
+6. 标题要简短、有吸引力，不要使用模糊的语言，在大部分屏幕中一行可以显示
+7. 描述要简明扼要，不要使用模糊的语言，不要超过 100 个字
+
+## output 数据要求
+1. 上下文中有相关图片时返回图片链接，如果没有相关的图片不要随便使用其他图片，返回 undefined 即可。
+2. 如果数组类型确实没有数据，请返回空数组。
+
+请为 {{sectionName}} 生成符合上述要求的内容，使用 {{locale}} 语言。`;
+    logger_js_1.logger.info(`section content generator prompt for ${input.sectionName}`, prompt);
+    const agent = core_1.AIAgent.from({
+        name: 'Section Content Generator',
+        instructions: prompt,
+        inputSchema: zod_1.z.object({
+            context: zod_1.z.string(),
+            question: zod_1.z.string(),
+            locale: zod_1.z.string(),
+            sectionName: zod_1.z.string(),
+            sectionPlan: zod_1.z.string(),
+            generatedSections: zod_1.z.string(),
+        }),
+        outputSchema: input.sectionSchema,
+    });
+    return agent;
+}

package/lib/cjs/index.d.ts

@@ -0,0 +1,7 @@
+export {};
+export { default as generatePageContentMultiAgent, generateSingleSectionContent, } from './agents/multi-agent-page-writer';
+export * from './agents/page-metadata-generator';
+export * from './agents/page-structure-planner';
+export * from './agents/page-structure-validator';
+export * from './agents/section-content-generator';
+export * from './utils/index';

package/lib/cjs/index.js

@@ -0,0 +1,30 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSingleSectionContent = exports.generatePageContentMultiAgent = void 0;
+// Export all agents
+var multi_agent_page_writer_1 = require("./agents/multi-agent-page-writer");
+Object.defineProperty(exports, "generatePageContentMultiAgent", { enumerable: true, get: function () { return __importDefault(multi_agent_page_writer_1).default; } });
+Object.defineProperty(exports, "generateSingleSectionContent", { enumerable: true, get: function () { return multi_agent_page_writer_1.generateSingleSectionContent; } });
+__exportStar(require("./agents/page-metadata-generator"), exports);
+__exportStar(require("./agents/page-structure-planner"), exports);
+__exportStar(require("./agents/page-structure-validator"), exports);
+__exportStar(require("./agents/section-content-generator"), exports);
+// Export utilities that might be useful for consumers
+__exportStar(require("./utils/index"), exports);