xhs-operator 1.0.0-beta.1

package/dist/actions/publish.js

@@ -0,0 +1,135 @@
+// ============================================================
+// Publish Action — Note publishing to XHS Creator Center
+// ============================================================
+import { BehaviorHumanizer } from '../risk/behavior-humanizer.js';
+import { QuotaExceededError } from '../risk/rate-guard.js';
+import { randomBetween } from '../utils/helpers.js';
+const CREATOR_PUBLISH_URL = 'https://creator.xiaohongshu.com/publish/publish';
+export class PublishAction {
+    runtime;
+    fingerprintGuard;
+    rateGuard;
+    humanizer;
+    constructor(runtime, fingerprintGuard, rateGuard) {
+        this.runtime = runtime;
+        this.fingerprintGuard = fingerprintGuard;
+        this.rateGuard = rateGuard;
+        this.humanizer = new BehaviorHumanizer();
+    }
+    /**
+     * Publish a note with images to XHS.
+     */
+    async publishNote(account, note, images) {
+        // Check publish quota
+        const quota = this.rateGuard.checkQuota(account.id, 'publish');
+        if (!quota.allowed) {
+            throw new QuotaExceededError(quota.resetAt);
+        }
+        const page = await this.runtime.browser.newPage({
+            cookieFile: account.sessionFile,
+            proxy: account.proxy,
+        });
+        try {
+            // Apply fingerprint
+            await this.fingerprintGuard.applyFingerprint(page, account.id);
+            // Navigate to creator center
+            await page.navigate(CREATOR_PUBLISH_URL);
+            await this.humanizer.waitRandom(2000, 4000);
+            // Upload images
+            await this.uploadImages(page, images);
+            // Fill title
+            await this.humanizer.typeHuman(page, '#title-input', note.title, {
+                wpm: randomBetween(60, 120),
+            });
+            await this.humanizer.waitRandom(500, 1000);
+            // Fill body
+            await this.humanizer.typeHuman(page, '#content-textarea', note.body, {
+                wpm: randomBetween(50, 100),
+            });
+            await this.humanizer.waitRandom(800, 1500);
+            // Add hashtags
+            for (const tag of note.hashtags) {
+                await this.addHashtag(page, tag);
+                await this.humanizer.waitRandom(300, 800);
+            }
+            // Preview and submit
+            await this.humanizer.waitRandom(1000, 2000);
+            await this.humanizer.clickNatural(page, '[data-testid="publish-btn"]');
+            // Wait for publish confirmation
+            const result = await this.waitForPublishSuccess(page);
+            // Record action
+            this.rateGuard.recordAction(account.id, 'publish', result.noteId);
+            return result;
+        }
+        catch (error) {
+            this.rateGuard.recordFailure(account.id);
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+        finally {
+            await page.close();
+        }
+    }
+    async uploadImages(page, images) {
+        for (const [idx, _img] of images.entries()) {
+            // Find upload input and trigger file selection
+            // In a real implementation, this would use the file chooser API
+            await page.waitForSelector('input[type="file"]', { timeout: 10000 });
+            // Simulated: openclaw browser API handles file buffer upload
+            await page.evaluate(`
+        document.querySelector('input[type="file"]').dispatchEvent(new Event('change'));
+      `);
+            if (idx < images.length - 1) {
+                await this.humanizer.waitRandom(800, 1500);
+            }
+        }
+        // Wait for upload completion
+        await this.humanizer.waitRandom(2000, 4000);
+    }
+    async addHashtag(page, tag) {
+        // Type # to trigger hashtag picker
+        await page.keyboard.type('#');
+        await this.humanizer.waitRandom(200, 500);
+        // Type tag name
+        for (const char of tag) {
+            await page.keyboard.type(char);
+            await this.humanizer.waitRandom(50, 150);
+        }
+        await this.humanizer.waitRandom(500, 1000);
+        // Select first suggestion
+        const suggestion = await page.$('.hashtag-suggestion-item');
+        if (suggestion) {
+            await suggestion.click();
+        }
+        else {
+            await page.keyboard.press('Enter');
+        }
+    }
+    async waitForPublishSuccess(page, timeoutMs = 30000) {
+        const start = Date.now();
+        while (Date.now() - start < timeoutMs) {
+            const url = page.url();
+            // Check for success redirect
+            if (url.includes('/publish/success') || url.includes('noteId=')) {
+                const noteIdMatch = url.match(/noteId=([a-f0-9]+)/);
+                return {
+                    success: true,
+                    noteId: noteIdMatch?.[1],
+                    url: noteIdMatch ? `https://www.xiaohongshu.com/explore/${noteIdMatch[1]}` : undefined,
+                    publishedAt: new Date(),
+                };
+            }
+            // Check for error messages
+            const errorEl = await page.$('.publish-error, .error-message');
+            if (errorEl) {
+                const errorText = await errorEl.textContent();
+                return { success: false, error: errorText || 'Unknown publish error' };
+            }
+            await this.humanizer.waitRandom(500, 1000);
+        }
+        return { success: false, error: 'Publish timeout' };
+    }
+}
+//# sourceMappingURL=publish.js.map

package/dist/actions/publish.js.map

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

package/dist/actions/scrape.d.ts

@@ -0,0 +1,21 @@
+import type { OpenClawRuntime, Account, AccountMetrics, NoteMetric } from '../types/index.js';
+import { FingerprintGuard } from '../risk/fingerprint-guard.js';
+export declare class ScrapeAction {
+    private runtime;
+    private fingerprintGuard;
+    private humanizer;
+    constructor(runtime: OpenClawRuntime, fingerprintGuard: FingerprintGuard);
+    /**
+     * Scrape complete account metrics from the Creator Center.
+     */
+    scrapeAccountMetrics(account: Account): Promise<AccountMetrics>;
+    /**
+     * Scrape a single note's detailed metrics.
+     */
+    scrapeNoteDetail(account: Account, noteId: string): Promise<NoteMetric | null>;
+    private scrapeOverview;
+    private scrapeNotesList;
+    private extractNoteMetricFromCard;
+    private scrapeNoteMetric;
+}
+//# sourceMappingURL=scrape.d.ts.map

package/dist/actions/scrape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrape.d.ts","sourceRoot":"","sources":["../../src/actions/scrape.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EACf,OAAO,EACP,cAAc,EACd,UAAU,EAEX,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAMhE,qBAAa,YAAY;IAIrB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,gBAAgB;IAJ1B,OAAO,CAAC,SAAS,CAAoB;gBAG3B,OAAO,EAAE,eAAe,EACxB,gBAAgB,EAAE,gBAAgB;IAK5C;;OAEG;IACG,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IAgCrE;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;YAiBtE,cAAc;YAiBd,eAAe;YAsBf,yBAAyB;YAyBzB,gBAAgB;CA0B/B"}

package/dist/actions/scrape.js

@@ -0,0 +1,145 @@
+// ============================================================
+// Scrape Action — Data collection from XHS Creator Center
+// ============================================================
+import { BehaviorHumanizer } from '../risk/behavior-humanizer.js';
+import { sanitizePageContent } from '../utils/helpers.js';
+const CREATOR_HOME_URL = 'https://creator.xiaohongshu.com/creator/home';
+const CREATOR_NOTES_URL = 'https://creator.xiaohongshu.com/creator/notes';
+export class ScrapeAction {
+    runtime;
+    fingerprintGuard;
+    humanizer;
+    constructor(runtime, fingerprintGuard) {
+        this.runtime = runtime;
+        this.fingerprintGuard = fingerprintGuard;
+        this.humanizer = new BehaviorHumanizer();
+    }
+    /**
+     * Scrape complete account metrics from the Creator Center.
+     */
+    async scrapeAccountMetrics(account) {
+        const page = await this.runtime.browser.newPage({
+            cookieFile: account.sessionFile,
+            proxy: account.proxy,
+        });
+        try {
+            await this.fingerprintGuard.applyFingerprint(page, account.id);
+            // Navigate to creator home
+            await page.navigate(CREATOR_HOME_URL);
+            await this.humanizer.waitRandom(2000, 4000);
+            // Scrape overview metrics
+            const overview = await this.scrapeOverview(page);
+            // Navigate to notes list
+            await page.navigate(CREATOR_NOTES_URL);
+            await this.humanizer.waitRandom(2000, 4000);
+            // Scrape individual note metrics
+            const notes = await this.scrapeNotesList(page);
+            return {
+                ...overview,
+                notes,
+            };
+        }
+        finally {
+            await page.close();
+        }
+    }
+    /**
+     * Scrape a single note's detailed metrics.
+     */
+    async scrapeNoteDetail(account, noteId) {
+        const page = await this.runtime.browser.newPage({
+            cookieFile: account.sessionFile,
+            proxy: account.proxy,
+        });
+        try {
+            await this.fingerprintGuard.applyFingerprint(page, account.id);
+            await page.navigate(`https://creator.xiaohongshu.com/creator/notes/${noteId}`);
+            await this.humanizer.waitRandom(2000, 4000);
+            return this.scrapeNoteMetric(page, noteId);
+        }
+        finally {
+            await page.close();
+        }
+    }
+    async scrapeOverview(page) {
+        // Try to extract from the page DOM
+        const extractNumber = async (selector) => {
+            const el = await page.$(selector);
+            if (!el)
+                return 0;
+            const text = sanitizePageContent((await el.textContent()) || '0');
+            return parseInt(text.replace(/[^0-9]/g, ''), 10) || 0;
+        };
+        return {
+            fans: await extractNumber('.fans-count, [data-type="fans"]'),
+            follows: await extractNumber('.follows-count, [data-type="follows"]'),
+            likes: await extractNumber('.likes-count, [data-type="likes"]'),
+            collects: await extractNumber('.collects-count, [data-type="collects"]'),
+        };
+    }
+    async scrapeNotesList(page) {
+        const notes = [];
+        // Scroll to load notes
+        for (let i = 0; i < 3; i++) {
+            const cards = await page.$$('.note-item, [data-type="note-row"]');
+            for (const card of cards) {
+                const noteId = await card.getAttribute('data-note-id');
+                if (!noteId || notes.some((n) => n.noteId === noteId))
+                    continue;
+                const metric = await this.extractNoteMetricFromCard(card, noteId);
+                if (metric)
+                    notes.push(metric);
+            }
+            // Scroll for more
+            await this.humanizer.browseRandomly(page, 2);
+        }
+        return notes;
+    }
+    async extractNoteMetricFromCard(card, noteId) {
+        try {
+            const rawText = sanitizePageContent((await card.textContent()) || '');
+            // Parse numbers from the card text (simplified extraction)
+            const numbers = rawText.match(/\d+/g)?.map(Number) || [];
+            return {
+                noteId,
+                title: rawText.slice(0, 50),
+                views: numbers[0] || 0,
+                likes: numbers[1] || 0,
+                comments: numbers[2] || 0,
+                collects: numbers[3] || 0,
+                publishedAt: new Date(),
+                ctr: numbers[0] && numbers[4] ? numbers[0] / numbers[4] : 0,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    async scrapeNoteMetric(page, noteId) {
+        try {
+            const extractNumber = async (selector) => {
+                const el = await page.$(selector);
+                if (!el)
+                    return 0;
+                const text = sanitizePageContent((await el.textContent()) || '0');
+                return parseInt(text.replace(/[^0-9]/g, ''), 10) || 0;
+            };
+            const titleEl = await page.$('.note-title, h1');
+            const title = sanitizePageContent((await titleEl?.textContent()) || '');
+            return {
+                noteId,
+                title,
+                views: await extractNumber('.views-count, [data-type="views"]'),
+                likes: await extractNumber('.likes-count, [data-type="likes"]'),
+                comments: await extractNumber('.comments-count, [data-type="comments"]'),
+                collects: await extractNumber('.collects-count, [data-type="collects"]'),
+                publishedAt: new Date(),
+                ctr: 0,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=scrape.js.map

package/dist/actions/scrape.js.map

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

package/dist/agents/copywriter.d.ts

@@ -0,0 +1,21 @@
+import type { OpenClawRuntime, NoteGenerateRequest, NoteContent, NoteMetric } from '../types/index.js';
+export declare class Copywriter {
+    private runtime;
+    constructor(runtime: OpenClawRuntime);
+    /**
+     * Generate a complete XHS note (title, body, hashtags, cover text).
+     */
+    generateNote(req: NoteGenerateRequest): Promise<NoteContent>;
+    /**
+     * Generate a personalized comment for an interaction task.
+     */
+    generateComment(noteTitle: string, noteExcerpt: string): Promise<string>;
+    /**
+     * Analyze past note performance to suggest the best topic.
+     */
+    analyzeTopPerformingTopics(notes: NoteMetric[]): Promise<string>;
+    private buildSystemPrompt;
+    private buildContentPrompt;
+    private parseNoteContent;
+}
+//# sourceMappingURL=copywriter.d.ts.map

package/dist/agents/copywriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copywriter.d.ts","sourceRoot":"","sources":["../../src/agents/copywriter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,WAAW,EAGX,UAAU,EACX,MAAM,mBAAmB,CAAC;AAgB3B,qBAAa,UAAU;IACT,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,eAAe;IAE5C;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAclE;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoB9E;;OAEG;IACG,0BAA0B,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBtE,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,gBAAgB;CAmBzB"}

package/dist/agents/copywriter.js

@@ -0,0 +1,115 @@
+// ============================================================
+// Copywriter Agent — AI-powered content generation for XHS
+// ============================================================
+import { sanitizePageContent } from '../utils/helpers.js';
+const STYLE_PROMPTS = {
+    lifestyle: `你是小红书生活方式博主。标题要有场景感+情绪词，正文结构：HOOK开头 → 故事 → 产品/体验 → CTA互动引导。结尾用评论区提问引发互动。`,
+    tutorial: `你是小红书教程类博主。标题用数字列表+结果导向，正文结构：痛点引入 → 分步骤教程 → Tips补充。结尾提醒收藏备用。`,
+    review: `你是小红书测评博主。标题用对比型/结论先行，正文结构：开箱体验 → 详细测评 → 优缺点总结。结尾引导点赞收藏。`,
+    vlog: `你是小红书vlog博主。标题用地点/事件型，正文按时间线叙事。结尾引导关注看后续。`,
+};
+const TONE_MODIFIERS = {
+    casual: '语气轻松活泼，像朋友聊天一样自然。适当使用口语化表达。',
+    professional: '语气专业可信，数据支撑观点。保持权威但不生硬。',
+    trendy: '紧跟潮流热梗，使用当下流行语和网络用语。活泼有趣。',
+};
+export class Copywriter {
+    runtime;
+    constructor(runtime) {
+        this.runtime = runtime;
+    }
+    /**
+     * Generate a complete XHS note (title, body, hashtags, cover text).
+     */
+    async generateNote(req) {
+        const systemPrompt = this.buildSystemPrompt(req.style, req.tone);
+        const userPrompt = this.buildContentPrompt(req);
+        const result = await this.runtime.ai.completion({
+            model: 'claude-sonnet-4-20250514',
+            system: systemPrompt,
+            prompt: userPrompt,
+            responseFormat: 'json',
+        });
+        return this.parseNoteContent(result);
+    }
+    /**
+     * Generate a personalized comment for an interaction task.
+     */
+    async generateComment(noteTitle, noteExcerpt) {
+        const sanitizedTitle = sanitizePageContent(noteTitle);
+        const sanitizedExcerpt = sanitizePageContent(noteExcerpt);
+        const result = await this.runtime.ai.completion({
+            model: 'claude-sonnet-4-20250514',
+            system: `你是一个真实的小红书用户。根据笔记内容生成一条自然、真诚的评论。
+要求：
+- 10-50字之间
+- 表达真实感受或提问
+- 不要用模板化语言
+- 可以适当用emoji但不要过多
+- 不要用"博主"这样的称呼`,
+            prompt: `笔记标题：${sanitizedTitle}\n笔记内容摘要：${sanitizedExcerpt}\n\n请生成一条评论：`,
+            responseFormat: 'text',
+        });
+        return result.trim();
+    }
+    /**
+     * Analyze past note performance to suggest the best topic.
+     */
+    async analyzeTopPerformingTopics(notes) {
+        if (notes.length === 0)
+            return '日常分享';
+        // Sort by engagement (likes + comments + collects)
+        const sorted = [...notes].sort((a, b) => (b.likes + b.comments + b.collects) - (a.likes + a.comments + a.collects));
+        const topNotes = sorted.slice(0, 5);
+        const titles = topNotes.map((n) => n.title).join('\n');
+        const result = await this.runtime.ai.completion({
+            model: 'claude-sonnet-4-20250514',
+            system: '你是数据分析师，根据历史高互动笔记标题分析内容方向。',
+            prompt: `以下是近期互动最高的笔记标题：\n${titles}\n\n请推荐一个今天适合发布的话题方向（只输出话题关键词，不要其他内容）：`,
+            responseFormat: 'text',
+        });
+        return result.trim();
+    }
+    buildSystemPrompt(style, tone) {
+        return `${STYLE_PROMPTS[style]}\n${TONE_MODIFIERS[tone]}\n\n请以JSON格式返回，包含以下字段：
+{
+  "title": "笔记标题（≤20字，含关键词）",
+  "body": "笔记正文",
+  "hashtags": ["话题标签1", "话题标签2", ...],
+  "coverText": "封面文字（≤10字）"
+}`;
+    }
+    buildContentPrompt(req) {
+        const parts = [
+            `主题：${req.topic}`,
+            `关键词：${req.keywords.join('、')}`,
+            `字数范围：${req.wordCount[0]}-${req.wordCount[1]}字`,
+        ];
+        if (req.includeEmoji)
+            parts.push('正文中适当使用emoji');
+        if (req.includeHashtags)
+            parts.push('生成3-5个相关话题标签');
+        return parts.join('\n');
+    }
+    parseNoteContent(raw) {
+        try {
+            const parsed = JSON.parse(raw);
+            return {
+                title: String(parsed.title || '').slice(0, 20),
+                body: String(parsed.body || ''),
+                hashtags: Array.isArray(parsed.hashtags) ? parsed.hashtags.map(String) : [],
+                coverText: String(parsed.coverText || '').slice(0, 10),
+            };
+        }
+        catch {
+            // Fallback: treat the whole response as the body
+            return {
+                title: raw.slice(0, 20),
+                body: raw,
+                hashtags: [],
+                coverText: '',
+            };
+        }
+    }
+}
+//# sourceMappingURL=copywriter.js.map

package/dist/agents/copywriter.js.map

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

package/dist/agents/image-composer.d.ts

@@ -0,0 +1,26 @@
+import type { OpenClawRuntime, NoteContent, ImageComposerConfig } from '../types/index.js';
+export declare class ImageComposer {
+    private runtime;
+    constructor(runtime: OpenClawRuntime);
+    /**
+     * Compose a cover image for a note.
+     */
+    composeCoverImage(content: NoteContent, config: ImageComposerConfig): Promise<Buffer>;
+    /**
+     * Generate an AI image based on note content.
+     */
+    generateAIImage(content: NoteContent): Promise<Buffer>;
+    /**
+     * Fetch base image from configured source.
+     */
+    private fetchBaseImage;
+    /**
+     * Overlay text on the image using Sharp.
+     */
+    private overlayText;
+    /**
+     * Add a subtle brand watermark.
+     */
+    private addWatermark;
+}
+//# sourceMappingURL=image-composer.d.ts.map

package/dist/agents/image-composer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-composer.d.ts","sourceRoot":"","sources":["../../src/agents/image-composer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,mBAAmB,EAEpB,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,aAAa;IACZ,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,eAAe;IAE5C;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAe3F;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAS5D;;OAEG;YACW,cAAc;IAK5B;;OAEG;YACW,WAAW;IA0CzB;;OAEG;YACW,YAAY;CAiB3B"}

package/dist/agents/image-composer.js

@@ -0,0 +1,103 @@
+// ============================================================
+// Image Composer — Cover image generation and composition
+// ============================================================
+export class ImageComposer {
+    runtime;
+    constructor(runtime) {
+        this.runtime = runtime;
+    }
+    /**
+     * Compose a cover image for a note.
+     */
+    async composeCoverImage(content, config) {
+        // Step 1: Get base image
+        const baseImage = await this.fetchBaseImage(content, config);
+        // Step 2: Overlay text (cover text)
+        const composed = await this.overlayText(baseImage, content.coverText, config);
+        // Step 3: Add watermark if brand colors are configured
+        if (config.brandColors.length > 0) {
+            return this.addWatermark(composed, config);
+        }
+        return composed;
+    }
+    /**
+     * Generate an AI image based on note content.
+     */
+    async generateAIImage(content) {
+        const prompt = `小红书风格封面图，主题：${content.title}，风格清新自然，高质量`;
+        return this.runtime.ai.imageGeneration({
+            prompt,
+            size: '1080x1440', // 3:4 ratio for XHS
+            style: 'natural',
+        });
+    }
+    /**
+     * Fetch base image from configured source.
+     */
+    async fetchBaseImage(content, config) {
+        // Default: generate with AI
+        return this.generateAIImage(content);
+    }
+    /**
+     * Overlay text on the image using Sharp.
+     */
+    async overlayText(imageBuffer, text, config) {
+        // Dynamic import for sharp (heavy dependency)
+        const sharp = (await import('sharp')).default;
+        if (!text || !config.textOverlay)
+            return imageBuffer;
+        const { position, textColor, backgroundColor, padding } = config.textOverlay;
+        const fontSize = config.coverTemplate?.fontSize ?? 48;
+        // Create text SVG overlay
+        const svgWidth = 1080;
+        const svgHeight = 200;
+        const y = position === 'top' ? padding : position === 'center' ? 600 : 1200;
+        const bgRect = backgroundColor
+            ? `<rect x="0" y="0" width="${svgWidth}" height="${svgHeight}" fill="${backgroundColor}" opacity="0.7"/>`
+            : '';
+        const svg = `
+      <svg width="${svgWidth}" height="${svgHeight}">
+        ${bgRect}
+        <text x="${svgWidth / 2}" y="${svgHeight / 2 + fontSize / 3}"
+          font-size="${fontSize}" fill="${textColor}"
+          text-anchor="middle" font-family="sans-serif" font-weight="bold">
+          ${escapeXml(text)}
+        </text>
+      </svg>
+    `;
+        return sharp(imageBuffer)
+            .composite([{
+                input: Buffer.from(svg),
+                top: y,
+                left: 0,
+            }])
+            .toBuffer();
+    }
+    /**
+     * Add a subtle brand watermark.
+     */
+    async addWatermark(imageBuffer, config) {
+        const sharp = (await import('sharp')).default;
+        const color = config.brandColors[0] || '#ffffff';
+        const svg = `
+      <svg width="200" height="40">
+        <rect x="0" y="0" width="200" height="40" fill="${color}" opacity="0.3" rx="8"/>
+      </svg>
+    `;
+        return sharp(imageBuffer)
+            .composite([{
+                input: Buffer.from(svg),
+                gravity: 'southeast',
+            }])
+            .toBuffer();
+    }
+}
+function escapeXml(text) {
+    return text
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+//# sourceMappingURL=image-composer.js.map

package/dist/agents/image-composer.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}