@lingxiao-office/sdk 1.0.0

package/dist/tools/implementations/OfficeAssetTool.js

@@ -0,0 +1,210 @@
+import { z } from 'zod';
+import { basename, dirname, extname, join, resolve } from 'path';
+import { mkdirSync } from 'fs';
+import { Tool } from '../Tool.js';
+import { resolveTaskWritePath, lockedAtomicWriteBuffer } from './utils.js';
+import { slugFileName } from './OfficeXmlBuilder.js';
+import { checkUrlNotPrivate } from './WebCommon.js';
+import { getScopedProxyFetch } from '../../core/ProxyConfig.js';
+const SearchSchema = z.object({
+    action: z.literal('search'),
+    provider: z.enum(['pexels', 'unsplash']).default('pexels'),
+    query: z.string(),
+    orientation: z.enum(['landscape', 'portrait', 'square']).default('landscape'),
+    per_page: z.number().int().min(1).max(20).default(8),
+});
+const DownloadSchema = z.object({
+    action: z.literal('download_url'),
+    url: z.string().url(),
+    output_path: z.string().optional(),
+    filename: z.string().optional(),
+    attribution: z.string().optional(),
+});
+const SuggestSchema = z.object({
+    action: z.literal('suggest_queries'),
+    topic: z.string(),
+    audience: z.string().optional(),
+    style: z.enum(['corporate', 'technology', 'finance', 'healthcare', 'industrial', 'education', 'abstract']).default('corporate'),
+});
+const OfficeAssetSchema = z.discriminatedUnion('action', [SearchSchema, DownloadSchema, SuggestSchema]);
+function env(name) {
+    return process.env[name] || process.env[`LINGXIAO_${name}`];
+}
+function toolFetch(input, init) {
+    const scopedFetch = getScopedProxyFetch('tools') || fetch;
+    return scopedFetch(input, init);
+}
+function extensionFromContentType(contentType, url) {
+    const ext = extname(new URL(url).pathname).toLowerCase();
+    if (['.png', '.jpg', '.jpeg', '.webp', '.gif'].includes(ext))
+        return ext;
+    const mediaType = contentType?.split(';', 1)[0]?.trim().toLowerCase();
+    if (mediaType === 'image/png')
+        return '.png';
+    if (mediaType === 'image/webp')
+        return '.webp';
+    if (mediaType === 'image/gif')
+        return '.gif';
+    return '.jpg';
+}
+function imageMimeFromExt(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    if (ext === '.png')
+        return 'image/png';
+    if (ext === '.webp')
+        return 'image/webp';
+    if (ext === '.gif')
+        return 'image/gif';
+    return 'image/jpeg';
+}
+function defaultAssetDir(context) {
+    if (context?.sessionId) {
+        return `.lingxiao/sessions/${context.sessionId}/scratchpad/assets`;
+    }
+    return '.lingxiao/assets';
+}
+function buildQuerySuggestions(topic, audience, style) {
+    const base = topic.trim();
+    const modifier = audience ? `${audience} ` : '';
+    const styleMap = {
+        corporate: ['executive meeting', 'team collaboration', 'modern office', 'business strategy'],
+        technology: ['data center', 'software team', 'AI interface', 'network infrastructure'],
+        finance: ['financial dashboard', 'market analysis', 'boardroom', 'risk management'],
+        healthcare: ['clinical operations', 'healthcare technology', 'care team', 'medical research'],
+        industrial: ['manufacturing floor', 'logistics operations', 'industrial automation', 'quality control'],
+        education: ['learning workshop', 'research team', 'digital classroom', 'knowledge sharing'],
+        abstract: ['abstract gradient', 'geometric texture', 'minimal background', 'data visualization'],
+    };
+    return styleMap[style].map(item => `${modifier}${base} ${item}`.trim());
+}
+export class OfficeAssetTool extends Tool {
+    name = '__office_delegate_assets';
+    description = `办公素材工具：为 PPTX/DOCX/Canvas 搜索授权图库素材。
+
+三个动作：
+- search：搜索 Pexels/Unsplash 图库，返回图片 URL 列表
+- download_url：下载远程图片到当前 session 目录
+- suggest_queries：根据主题生成推荐搜索词
+
+使用流程：先 suggest_queries 获取搜索建议 → 再 search 搜索 → 再 download_url 下载 → 最后用 image_path 嵌入文档。`;
+    parameters = OfficeAssetSchema;
+    async execute(args, context) {
+        const params = args;
+        if (params.action === 'suggest_queries') {
+            return {
+                success: true,
+                data: {
+                    topic: params.topic,
+                    queries: buildQuerySuggestions(params.topic, params.audience, params.style),
+                },
+            };
+        }
+        if (params.action === 'search') {
+            try {
+                if (params.provider === 'pexels') {
+                    const key = env('PEXELS_API_KEY');
+                    if (!key) {
+                        return { success: false, data: null, error: '缺少 PEXELS_API_KEY 或 LINGXIAO_PEXELS_API_KEY' };
+                    }
+                    const url = new URL('https://api.pexels.com/v1/search');
+                    url.searchParams.set('query', params.query);
+                    url.searchParams.set('orientation', params.orientation);
+                    url.searchParams.set('per_page', String(params.per_page));
+                    const res = await toolFetch(url, { headers: { Authorization: key } });
+                    if (!res.ok)
+                        return { success: false, data: null, error: `Pexels search failed: ${res.status} ${await res.text()}` };
+                    const json = await res.json();
+                    return {
+                        success: true,
+                        data: {
+                            provider: 'pexels',
+                            query: params.query,
+                            license_note: 'Pexels content requires following Pexels API guidelines and photographer credit where possible.',
+                            items: (json.photos || []).map((p) => ({
+                                id: p.id,
+                                title: p.alt || params.query,
+                                photographer: p.photographer,
+                                attribution: `Photo by ${p.photographer} on Pexels`,
+                                pageUrl: p.url,
+                                thumbUrl: p.src?.medium,
+                                downloadUrl: p.src?.large2x || p.src?.large || p.src?.original,
+                            })),
+                        },
+                    };
+                }
+                const key = env('UNSPLASH_ACCESS_KEY');
+                if (!key) {
+                    return { success: false, data: null, error: '缺少 UNSPLASH_ACCESS_KEY 或 LINGXIAO_UNSPLASH_ACCESS_KEY' };
+                }
+                const url = new URL('https://api.unsplash.com/search/photos');
+                url.searchParams.set('query', params.query);
+                url.searchParams.set('orientation', params.orientation);
+                url.searchParams.set('per_page', String(params.per_page));
+                const res = await toolFetch(url, { headers: { Authorization: `Client-ID ${key}`, 'Accept-Version': 'v1' } });
+                if (!res.ok)
+                    return { success: false, data: null, error: `Unsplash search failed: ${res.status} ${await res.text()}` };
+                const json = await res.json();
+                return {
+                    success: true,
+                    data: {
+                        provider: 'unsplash',
+                        query: params.query,
+                        license_note: 'Unsplash API requires following API Guidelines, including attribution and hotlinking rules where applicable.',
+                        items: (json.results || []).map((p) => ({
+                            id: p.id,
+                            title: p.alt_description || p.description || params.query,
+                            photographer: p.user?.name,
+                            attribution: `Photo by ${p.user?.name || 'Unsplash contributor'} on Unsplash`,
+                            pageUrl: p.links?.html,
+                            thumbUrl: p.urls?.small,
+                            downloadUrl: p.urls?.regular || p.urls?.full,
+                        })),
+                    },
+                };
+            }
+            catch (error) {
+                return { success: false, data: null, error: `ERROR: ${error instanceof Error ? error.message : String(error)}` };
+            }
+        }
+        try {
+            const [notPrivate, privateReason] = await checkUrlNotPrivate(params.url);
+            if (!notPrivate) {
+                return { success: false, data: null, error: `SSRF 防护 - ${privateReason}` };
+            }
+            const res = await toolFetch(params.url);
+            if (!res.ok) {
+                return { success: false, data: null, error: `下载失败: ${res.status} ${res.statusText}` };
+            }
+            const contentType = res.headers.get('content-type');
+            const ext = extensionFromContentType(contentType, params.url);
+            const filename = params.filename
+                ? `${slugFileName(params.filename.replace(ext, ''), 'asset')}${ext}`
+                : `${slugFileName(basename(new URL(params.url).pathname, ext) || 'asset', 'asset')}${ext}`;
+            const output = params.output_path || join(defaultAssetDir(context), filename);
+            const outputPath = resolveTaskWritePath(context?.workspace, output, context?.sessionId, context?.taskWriteScope);
+            const buffer = Buffer.from(await res.arrayBuffer());
+            mkdirSync(dirname(outputPath), { recursive: true });
+            await lockedAtomicWriteBuffer(outputPath, buffer, { createDirs: true });
+            let attributionPath;
+            if (params.attribution) {
+                attributionPath = `${outputPath}.attribution.txt`;
+                await lockedAtomicWriteBuffer(attributionPath, Buffer.from(params.attribution, 'utf-8'), { createDirs: true });
+            }
+            return {
+                success: true,
+                data: {
+                    path: resolve(outputPath),
+                    size: buffer.length,
+                    mimeType: imageMimeFromExt(outputPath),
+                    attribution: params.attribution,
+                    attributionPath,
+                },
+            };
+        }
+        catch (error) {
+            return { success: false, data: null, error: `ERROR: ${error instanceof Error ? error.message : String(error)}` };
+        }
+    }
+}
+export default OfficeAssetTool;
+//# sourceMappingURL=OfficeAssetTool.js.map

package/dist/tools/implementations/OfficeAssetTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OfficeAssetTool.js","sourceRoot":"","sources":["../../../src/tools/implementations/OfficeAssetTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAqC,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC3B,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC1D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IAC7E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;CACrD,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;IACjC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC;IACpC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;CAChI,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,CAAC,CAAC,kBAAkB,CAAC,QAAQ,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC;AAIxG,SAAS,GAAG,CAAC,IAAY;IACvB,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,SAAS,CAAC,KAAwB,EAAE,IAAkB;IAC7D,MAAM,WAAW,GAAG,mBAAmB,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC;IAC1D,OAAO,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,wBAAwB,CAAC,WAA0B,EAAE,GAAW;IACvE,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACzD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACzE,MAAM,SAAS,GAAG,WAAW,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACtE,IAAI,SAAS,KAAK,WAAW;QAAE,OAAO,MAAM,CAAC;IAC7C,IAAI,SAAS,KAAK,YAAY;QAAE,OAAO,OAAO,CAAC;IAC/C,IAAI,SAAS,KAAK,WAAW;QAAE,OAAO,MAAM,CAAC;IAC7C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAgB;IACxC,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,WAAW,CAAC;IACvC,IAAI,GAAG,KAAK,OAAO;QAAE,OAAO,YAAY,CAAC;IACzC,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,WAAW,CAAC;IACvC,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,SAAS,eAAe,CAAC,OAAqB;IAC5C,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;QACvB,OAAO,sBAAsB,OAAO,CAAC,SAAS,oBAAoB,CAAC;IACrE,CAAC;IACD,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa,EAAE,QAA4B,EAAE,KAAa;IACvF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC1B,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,MAAM,QAAQ,GAA6B;QACzC,SAAS,EAAE,CAAC,mBAAmB,EAAE,oBAAoB,EAAE,eAAe,EAAE,mBAAmB,CAAC;QAC5F,UAAU,EAAE,CAAC,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,wBAAwB,CAAC;QACtF,OAAO,EAAE,CAAC,qBAAqB,EAAE,iBAAiB,EAAE,WAAW,EAAE,iBAAiB,CAAC;QACnF,UAAU,EAAE,CAAC,qBAAqB,EAAE,uBAAuB,EAAE,WAAW,EAAE,kBAAkB,CAAC;QAC7F,UAAU,EAAE,CAAC,qBAAqB,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,iBAAiB,CAAC;QACvG,SAAS,EAAE,CAAC,mBAAmB,EAAE,eAAe,EAAE,mBAAmB,EAAE,mBAAmB,CAAC;QAC3F,QAAQ,EAAE,CAAC,mBAAmB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,CAAC;KACjG,CAAC;IACF,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,QAAQ,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,OAAO,eAAgB,SAAQ,IAAI;IAC9B,IAAI,GAAG,0BAA0B,CAAC;IAClC,WAAW,GAAG;;;;;;;uFAO8D,CAAC;IAC7E,UAAU,GAAG,iBAAiB,CAAC;IAExC,KAAK,CAAC,OAAO,CAAC,IAAa,EAAE,OAAqB;QAChD,MAAM,MAAM,GAAG,IAAwB,CAAC;QACxC,IAAI,MAAM,CAAC,MAAM,KAAK,iBAAiB,EAAE,CAAC;YACxC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE;oBACJ,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,OAAO,EAAE,qBAAqB,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC;iBAC5E;aACF,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;oBACjC,MAAM,GAAG,GAAG,GAAG,CAAC,gBAAgB,CAAC,CAAC;oBAClC,IAAI,CAAC,GAAG,EAAE,CAAC;wBACT,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;oBAC9F,CAAC;oBACD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,kCAAkC,CAAC,CAAC;oBACxD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;oBAC5C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;oBACxD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;oBAC1D,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;oBACtE,IAAI,CAAC,GAAG,CAAC,EAAE;wBAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,yBAAyB,GAAG,CAAC,MAAM,IAAI,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC;oBACrH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAA2K,CAAC;oBACvM,OAAO;wBACL,OAAO,EAAE,IAAI;wBACb,IAAI,EAAE;4BACJ,QAAQ,EAAE,QAAQ;4BAClB,KAAK,EAAE,MAAM,CAAC,KAAK;4BACnB,YAAY,EAAE,iGAAiG;4BAC/G,KAAK,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gCACrC,EAAE,EAAE,CAAC,CAAC,EAAE;gCACR,KAAK,EAAE,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,KAAK;gCAC5B,YAAY,EAAE,CAAC,CAAC,YAAY;gCAC5B,WAAW,EAAE,YAAY,CAAC,CAAC,YAAY,YAAY;gCACnD,OAAO,EAAE,CAAC,CAAC,GAAG;gCACd,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM;gCACvB,WAAW,EAAE,CAAC,CAAC,GAAG,EAAE,OAAO,IAAI,CAAC,CAAC,GAAG,EAAE,KAAK,IAAI,CAAC,CAAC,GAAG,EAAE,QAAQ;6BAC/D,CAAC,CAAC;yBACJ;qBACF,CAAC;gBACJ,CAAC;gBAED,MAAM,GAAG,GAAG,GAAG,CAAC,qBAAqB,CAAC,CAAC;gBACvC,IAAI,CAAC,GAAG,EAAE,CAAC;oBACT,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,uDAAuD,EAAE,CAAC;gBACxG,CAAC;gBACD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,wCAAwC,CAAC,CAAC;gBAC9D,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC5C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;gBACxD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAC1D,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,aAAa,GAAG,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC7G,IAAI,CAAC,GAAG,CAAC,EAAE;oBAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,2BAA2B,GAAG,CAAC,MAAM,IAAI,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC;gBACvH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAA0N,CAAC;gBACtP,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,IAAI,EAAE;wBACJ,QAAQ,EAAE,UAAU;wBACpB,KAAK,EAAE,MAAM,CAAC,KAAK;wBACnB,YAAY,EAAE,8GAA8G;wBAC5H,KAAK,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;4BACtC,EAAE,EAAE,CAAC,CAAC,EAAE;4BACR,KAAK,EAAE,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC,WAAW,IAAI,MAAM,CAAC,KAAK;4BACzD,YAAY,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI;4BAC1B,WAAW,EAAE,YAAY,CAAC,CAAC,IAAI,EAAE,IAAI,IAAI,sBAAsB,cAAc;4BAC7E,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI;4BACtB,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK;4BACvB,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI;yBAC7C,CAAC,CAAC;qBACJ;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;YACnH,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzE,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,aAAa,EAAE,EAAE,CAAC;YAC7E,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC;YACxF,CAAC;YACD,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YACpD,MAAM,GAAG,GAAG,wBAAwB,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;YAC9D,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ;gBAC9B,CAAC,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,GAAG,GAAG,EAAE;gBACpE,CAAC,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,OAAO,CAAC,GAAG,GAAG,EAAE,CAAC;YAC7F,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;YAC9E,MAAM,UAAU,GAAG,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;YACjH,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YACpD,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,MAAM,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;YACxE,IAAI,eAAmC,CAAC;YACxC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBACvB,eAAe,GAAG,GAAG,UAAU,kBAAkB,CAAC;gBAClD,MAAM,uBAAuB,CAAC,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;YACjH,CAAC;YACD,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE;oBACJ,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC;oBACzB,IAAI,EAAE,MAAM,CAAC,MAAM;oBACnB,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAAC;oBACtC,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,eAAe;iBAChB;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACnH,CAAC;IACH,CAAC;CACF;AAED,eAAe,eAAe,CAAC"}

package/dist/tools/implementations/OfficeOpsTool.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../Tool.js';
+export declare class OfficeOpsTool extends Tool {
+    readonly name = "office_ops";
+    readonly description = "\u7EDF\u4E00 Office \u64CD\u4F5C\u5165\u53E3\uFF1Aaction=\"validate\" \u505A\u6587\u6863\u9A8C\u6536\uFF1Baction=\"runtime\" \u8FD0\u884C OOXML/LibreOffice/PDF \u8F85\u52A9\u64CD\u4F5C\uFF1Baction=\"review\" \u505A\u7248\u672C\u5BF9\u6BD4\u3001\u5BA1\u9605\u6E05\u5355\u548C Word \u6279\u6CE8/\u4FEE\u8BA2\uFF1Baction=\"assets\" \u641C\u7D22\u6216\u4E0B\u8F7D\u529E\u516C\u7D20\u6750\uFF1Baction=\"excel_analysis\" \u505A\u5DE5\u4F5C\u7C3F\u7ED3\u6784/\u516C\u5F0F/\u9519\u8BEF\u5355\u5143\u683C\u5206\u6790\uFF1Baction=\"pdf_ocr_pipeline\" \u89C4\u5212\u6216\u6267\u884C PDF \u8F6C\u56FE/OCR \u524D\u7F6E\u7BA1\u7EBF\uFF1Baction=\"render_qa\" \u89C4\u5212\u6216\u6267\u884C PPTX/PDF \u9AD8\u4FDD\u771F\u6E32\u67D3\u9A8C\u6536\u3002runtime/review/assets \u7684\u539F\u5B50\u52A8\u4F5C\u653E\u5728 office_action \u5B57\u6BB5\uFF0C\u4F8B\u5982 {action:\"runtime\", office_action:\"list\"}\u3002\u751F\u6210/\u7F16\u8F91\u5177\u4F53\u6587\u6863\u4ECD\u4F7F\u7528 generate_/edit_ \u683C\u5F0F\u5DE5\u5177\u3002";
+    readonly parameters: z.ZodObject<{
+        action: z.ZodEnum<{
+            runtime: "runtime";
+            review: "review";
+            assets: "assets";
+            validate: "validate";
+            excel_analysis: "excel_analysis";
+            pdf_ocr_pipeline: "pdf_ocr_pipeline";
+            render_qa: "render_qa";
+        }>;
+        office_action: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        input_path: z.ZodOptional<z.ZodString>;
+        input_dir: z.ZodOptional<z.ZodString>;
+        output_path: z.ZodOptional<z.ZodString>;
+        output_dir: z.ZodOptional<z.ZodString>;
+        output_prefix: z.ZodOptional<z.ZodString>;
+        execute: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        timeout_seconds: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$loose>;
+    private readonly delegates;
+    execute(args: unknown, context?: ToolContext): Promise<ToolResult>;
+    private excelAnalysis;
+    private pdfOcrPipeline;
+    private renderQa;
+}
+export default OfficeOpsTool;
+//# sourceMappingURL=OfficeOpsTool.d.ts.map

package/dist/tools/implementations/OfficeOpsTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OfficeOpsTool.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/OfficeOpsTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AA6DrE,qBAAa,aAAc,SAAQ,IAAI;IACrC,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,o/BAA8Z;IAClb,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;;;sBAAmB;IAEtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAKxB;IAEI,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;YAyB1D,aAAa;YA4Db,cAAc;YAqCd,QAAQ;CAwCvB;AAED,eAAe,aAAa,CAAC"}

package/dist/tools/implementations/OfficeOpsTool.js

@@ -0,0 +1,221 @@
+import { z } from 'zod';
+import { Tool } from '../Tool.js';
+import { ValidateOfficeTool } from './ValidateOfficeTool.js';
+import { OfficeRuntimeTool } from './OfficeRuntimeTool.js';
+import { OfficeReviewTool } from './OfficeReviewTool.js';
+import { OfficeAssetTool } from './OfficeAssetTool.js';
+import { detectFormat, parseFile } from './FileParser.js';
+import { resolveWorkspacePath } from './utils.js';
+import { resolveOfficeRuntimePaths } from './office/OfficeRuntime.js';
+import { cellDisplayValue, readWorkbook, workbookSheetNames } from './office/ExcelWorkbook.js';
+const OfficeOpsSchema = z.object({
+    action: z.enum(['validate', 'runtime', 'review', 'assets', 'excel_analysis', 'pdf_ocr_pipeline', 'render_qa']).describe('Office operation group to run.'),
+    office_action: z.string().optional().describe('Sub-action for runtime, review, or assets operations. Example: runtime+list, runtime+unpack_ooxml, assets+search, review+compare.'),
+    path: z.string().optional().describe('validate: Office/PDF path to validate. input_path is also accepted and normalized to path.'),
+    input_path: z.string().optional().describe('Office/PDF input path for analysis and QA actions. Relative paths resolve against workspace.'),
+    input_dir: z.string().optional().describe('runtime pack_ooxml: input unpacked OOXML directory.'),
+    output_path: z.string().optional().describe('runtime pack_ooxml: output Office file path.'),
+    output_dir: z.string().optional().describe('Optional output directory for render/OCR pipeline actions.'),
+    output_prefix: z.string().optional().describe('Optional thumbnail prefix for render QA.'),
+    execute: z.boolean().optional().default(false).describe('For pipeline/QA actions, run available render/conversion helpers instead of returning a plan only.'),
+    timeout_seconds: z.number().int().min(1).max(600).optional().default(60),
+}).passthrough().superRefine((value, ctx) => {
+    const hasInput = Boolean(value.path || value.input_path);
+    if (value.action === 'validate' && !hasInput) {
+        ctx.addIssue({ code: 'custom', path: ['input_path'], message: 'action=validate requires path or input_path' });
+    }
+    if ((value.action === 'excel_analysis' || value.action === 'pdf_ocr_pipeline' || value.action === 'render_qa') && !value.input_path) {
+        ctx.addIssue({ code: 'custom', path: ['input_path'], message: `action=${value.action} requires input_path` });
+    }
+    if ((value.action === 'runtime' || value.action === 'review' || value.action === 'assets') && !value.office_action) {
+        ctx.addIssue({ code: 'custom', path: ['office_action'], message: `action=${value.action} requires office_action` });
+    }
+});
+const RENDER_QA_EXECUTABLE_FORMATS = new Set(['pptx', 'pdf']);
+function hasFormula(value) {
+    return Boolean(value && typeof value === 'object' && ('formula' in value || 'sharedFormula' in value));
+}
+function hasCellError(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    if ('error' in value)
+        return true;
+    if ('result' in value)
+        return hasCellError(value.result);
+    return false;
+}
+export class OfficeOpsTool extends Tool {
+    name = 'office_ops';
+    description = '统一 Office 操作入口：action="validate" 做文档验收；action="runtime" 运行 OOXML/LibreOffice/PDF 辅助操作；action="review" 做版本对比、审阅清单和 Word 批注/修订；action="assets" 搜索或下载办公素材；action="excel_analysis" 做工作簿结构/公式/错误单元格分析；action="pdf_ocr_pipeline" 规划或执行 PDF 转图/OCR 前置管线；action="render_qa" 规划或执行 PPTX/PDF 高保真渲染验收。runtime/review/assets 的原子动作放在 office_action 字段，例如 {action:"runtime", office_action:"list"}。生成/编辑具体文档仍使用 generate_/edit_ 格式工具。';
+    parameters = OfficeOpsSchema;
+    delegates = {
+        validate: new ValidateOfficeTool(),
+        runtime: new OfficeRuntimeTool(),
+        review: new OfficeReviewTool(),
+        assets: new OfficeAssetTool(),
+    };
+    async execute(args, context) {
+        const parsed = OfficeOpsSchema.safeParse(args);
+        if (!parsed.success) {
+            return { success: false, data: null, error: `ERROR: ${parsed.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join('; ')}` };
+        }
+        const { action, office_action, ...rest } = parsed.data;
+        if (action === 'excel_analysis') {
+            return this.excelAnalysis(parsed.data, context);
+        }
+        if (action === 'pdf_ocr_pipeline') {
+            return this.pdfOcrPipeline(parsed.data, context);
+        }
+        if (action === 'render_qa') {
+            return this.renderQa(parsed.data, context);
+        }
+        const delegate = this.delegates[action];
+        const delegateArgs = {
+            ...rest,
+            ...(action === 'validate' && !rest.path && rest.input_path ? { path: rest.input_path } : {}),
+            ...(office_action ? { action: office_action } : {}),
+        };
+        return delegate.execute(delegateArgs, context);
+    }
+    async excelAnalysis(input, context) {
+        if (!input.input_path) {
+            return { success: false, data: null, error: 'ERROR: input_path is required for office_ops(action="excel_analysis").' };
+        }
+        const path = resolveWorkspacePath(context?.workspace, input.input_path, context?.sessionId);
+        try {
+            const workbook = await readWorkbook(path);
+            const sheets = workbook.worksheets.map((sheet) => {
+                const rows = sheet.rowCount;
+                const columns = sheet.columnCount;
+                let formulaCount = 0;
+                let errorCount = 0;
+                const errorCells = [];
+                sheet.eachRow((row) => {
+                    row.eachCell((cell) => {
+                        if (hasFormula(cell.value))
+                            formulaCount += 1;
+                        if (hasCellError(cell.value)) {
+                            errorCount += 1;
+                            if (errorCells.length < 20)
+                                errorCells.push(cell.address);
+                        }
+                    });
+                });
+                const firstRow = sheet.getRow(1);
+                const headerRow = Array.from({ length: Math.min(columns, 12) }, (_, index) => {
+                    return cellDisplayValue(firstRow.getCell(index + 1));
+                }).filter(Boolean);
+                return {
+                    name: sheet.name,
+                    ref: sheet.dimensions ? `${sheet.dimensions.top}:${sheet.dimensions.bottom}` : null,
+                    rows,
+                    columns,
+                    formulaCount,
+                    errorCount,
+                    errorCells,
+                    headerRow,
+                    tableCandidate: rows > 1 && columns > 1 && headerRow.length >= Math.min(columns, 3),
+                };
+            });
+            return {
+                success: true,
+                data: {
+                    path,
+                    workbook: {
+                        sheetCount: workbook.worksheets.length,
+                        sheetNames: workbookSheetNames(workbook),
+                        sheets,
+                        totalFormulas: sheets.reduce((sum, sheet) => sum + sheet.formulaCount, 0),
+                        totalErrors: sheets.reduce((sum, sheet) => sum + sheet.errorCount, 0),
+                    },
+                    recommendedVerification: [
+                        'Run office_ops(action="runtime", office_action="xlsx_recalc", input_path=...) after formula edits.',
+                        'Use tableCandidate/headerRow to verify data regions before chart or pivot work.',
+                    ],
+                },
+            };
+        }
+        catch (error) {
+            return { success: false, data: null, error: error instanceof Error ? error.message : String(error) };
+        }
+    }
+    async pdfOcrPipeline(input, context) {
+        if (!input.input_path) {
+            return { success: false, data: null, error: 'ERROR: input_path is required for office_ops(action="pdf_ocr_pipeline").' };
+        }
+        const path = resolveWorkspacePath(context?.workspace, input.input_path, context?.sessionId);
+        const parsed = await parseFile(path, 'preview');
+        const runtime = resolveOfficeRuntimePaths();
+        const plan = [
+            'Inspect PDF text layer and page count.',
+            'When hasTextLayer=false or imageOnly=true, convert pages to PNG with office_ops(action="runtime", office_action="pdf_to_images").',
+            'Run OCR on generated page images and keep OCR text plus image paths as evidence_refs.',
+            'Treat missing OCR output as needs_ocr/inconclusive for text acceptance.',
+        ];
+        let conversion = null;
+        if (input.execute) {
+            conversion = await this.delegates.runtime.execute({
+                action: 'pdf_to_images',
+                input_path: input.input_path,
+                output_dir: input.output_dir,
+                timeout_seconds: input.timeout_seconds,
+            }, context);
+        }
+        return {
+            success: true,
+            data: {
+                path,
+                format: detectFormat(path),
+                runtime,
+                pdf: parsed.metadata || {},
+                verdict: parsed.metadata?.hasTextLayer ? 'text_layer_available' : 'needs_ocr',
+                plan,
+                executed: Boolean(input.execute),
+                conversion,
+            },
+        };
+    }
+    async renderQa(input, context) {
+        if (!input.input_path) {
+            return { success: false, data: null, error: 'ERROR: input_path is required for office_ops(action="render_qa").' };
+        }
+        const path = resolveWorkspacePath(context?.workspace, input.input_path, context?.sessionId);
+        const format = detectFormat(path);
+        const preview = await parseFile(path, 'preview');
+        const plan = format === 'pptx'
+            ? ['Generate slide thumbnail grid.', 'Compare slide count/text/visual density against acceptance criteria.', 'Attach thumbnail path to evidence_refs.']
+            : format === 'pdf'
+                ? ['Convert PDF pages to images.', 'Inspect page count/text layer and OCR needs.', 'Attach rendered page image paths to evidence_refs.']
+                : ['Use parse/inspect output for structure QA.', 'For high-fidelity QA, convert to PDF or screenshots before final acceptance.'];
+        let render = null;
+        if (input.execute && format === 'pptx') {
+            render = await this.delegates.runtime.execute({
+                action: 'pptx_thumbnail',
+                input_path: input.input_path,
+                output_prefix: input.output_prefix,
+                timeout_seconds: input.timeout_seconds,
+            }, context);
+        }
+        else if (input.execute && format === 'pdf') {
+            render = await this.delegates.runtime.execute({
+                action: 'pdf_to_images',
+                input_path: input.input_path,
+                output_dir: input.output_dir,
+                timeout_seconds: input.timeout_seconds,
+            }, context);
+        }
+        return {
+            success: true,
+            data: {
+                path,
+                format,
+                previewMetadata: preview.metadata || {},
+                plan,
+                executed: Boolean(input.execute && RENDER_QA_EXECUTABLE_FORMATS.has(format)),
+                render,
+            },
+        };
+    }
+}
+export default OfficeOpsTool;
+//# sourceMappingURL=OfficeOpsTool.js.map

package/dist/tools/implementations/OfficeOpsTool.js.map

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

package/dist/tools/implementations/OfficeReviewTool.d.ts

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../Tool.js';
+export declare class OfficeReviewTool extends Tool {
+    readonly name = "__office_delegate_review";
+    readonly description = "Office review loop tool. Compare DOCX/PPTX/PDF/HTML/text versions, create auditable review manifests, and write native Word comments/tracked revisions with element_id and optional target_text anchors.";
+    readonly parameters: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        action: z.ZodLiteral<"compare">;
+        before_path: z.ZodString;
+        after_path: z.ZodString;
+        output_path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"create_review_manifest">;
+        target_path: z.ZodString;
+        comments: z.ZodArray<z.ZodObject<{
+            author: z.ZodString;
+            severity: z.ZodOptional<z.ZodEnum<{
+                info: "info";
+                critical: "critical";
+                minor: "minor";
+                major: "major";
+            }>>;
+            status: z.ZodOptional<z.ZodEnum<{
+                open: "open";
+                resolved: "resolved";
+            }>>;
+            comment: z.ZodString;
+            anchor: z.ZodOptional<z.ZodObject<{
+                element_id: z.ZodOptional<z.ZodString>;
+                page: z.ZodOptional<z.ZodNumber>;
+                slide: z.ZodOptional<z.ZodNumber>;
+                text: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        output_path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"apply_docx_comments">;
+        target_path: z.ZodString;
+        output_path: z.ZodOptional<z.ZodString>;
+        comments: z.ZodArray<z.ZodObject<{
+            author: z.ZodString;
+            severity: z.ZodOptional<z.ZodEnum<{
+                info: "info";
+                critical: "critical";
+                minor: "minor";
+                major: "major";
+            }>>;
+            status: z.ZodOptional<z.ZodEnum<{
+                open: "open";
+                resolved: "resolved";
+            }>>;
+            comment: z.ZodString;
+            initials: z.ZodOptional<z.ZodString>;
+            anchor: z.ZodObject<{
+                element_id: z.ZodOptional<z.ZodString>;
+                page: z.ZodOptional<z.ZodNumber>;
+                slide: z.ZodOptional<z.ZodNumber>;
+                text: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"apply_docx_revisions">;
+        target_path: z.ZodString;
+        output_path: z.ZodOptional<z.ZodString>;
+        revisions: z.ZodArray<z.ZodObject<{
+            element_id: z.ZodString;
+            target_text: z.ZodOptional<z.ZodString>;
+            replacement_text: z.ZodString;
+            author: z.ZodString;
+            initials: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>], "action">;
+    execute(args: unknown, context?: ToolContext): Promise<ToolResult>;
+}
+export default OfficeReviewTool;
+//# sourceMappingURL=OfficeReviewTool.d.ts.map

package/dist/tools/implementations/OfficeReviewTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OfficeReviewTool.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/OfficeReviewTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAgErE,qBAAa,gBAAiB,SAAQ,IAAI;IACxC,QAAQ,CAAC,IAAI,8BAA8B;IAC3C,QAAQ,CAAC,WAAW,8MAA8M;IAClO,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCAAsB;IAEnC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CA2DzE;AAeD,eAAe,gBAAgB,CAAC"}