@lotagate/cli 0.1.25 → 0.1.27

package/dist/application/protocol/document-host-tool-definitions.js

@@ -1 +0,0 @@
-const k=["pdf","pptx","excel","docs"],t={path:n("Workspace-relative or absolute document path."),handleId:n("Document handle returned by the open tool."),outputPath:n("Optional workspace-relative output path.")},m=[a("pdf.open","Open a PDF document and return a governed document handle.",{path:t.path},["path"]),a("pdf.create","Create a new PDF document at the requested path.",{path:t.path,title:n("Optional document title.")},["path"]),a("pdf.inspect","Inspect PDF metadata and page count.",{handleId:t.handleId},["handleId"]),a("pdf.validate","Validate the PDF signature and readable structure.",{path:t.path},["path"]),a("pdf.readText","Extract bounded text from selected PDF pages.",{handleId:t.handleId,pages:o("Optional zero-based page numbers.")},["handleId"]),a("pdf.render","Render selected PDF pages to image artifacts.",{handleId:t.handleId,pages:o("Optional zero-based page numbers."),outputPath:t.outputPath},["handleId"]),a("pdf.extractTables","Extract table-like text from selected PDF pages.",{handleId:t.handleId,pages:o("Optional zero-based page numbers.")},["handleId"]),a("pdf.recognizeText","Recognize text from selected PDF pages with bounded line metadata.",{handleId:t.handleId,pages:o("Optional zero-based page numbers."),language:n("Optional BCP-47 OCR language tag.")},["handleId"]),a("pdf.search","Search PDF text and return bounded page matches.",{handleId:t.handleId,query:n("Text to find."),pages:o("Optional zero-based page numbers."),maxResults:d("Maximum matches to return.")},["handleId","query"]),a("pdf.extractImages","Extract embedded PDF images to a workspace directory.",{handleId:t.handleId,outputPath:t.outputPath,pages:o("Optional zero-based page numbers.")},["handleId","outputPath"]),a("pdf.manageBookmarks","Read or update PDF outline bookmarks.",{handleId:t.handleId,operation:l(["list","add","update","delete"],"Bookmark operation."),bookmark:i("Bookmark definition for add, update, or delete.")},["handleId","operation"]),a("pdf.extractLinks","Extract links from selected PDF pages.",{handleId:t.handleId,pages:o("Optional zero-based page numbers.")},["handleId"]),a("pdf.extractAnnotations","Extract annotations from a PDF.",{handleId:t.handleId,pages:o("Optional zero-based page numbers.")},["handleId"]),a("pdf.manageAttachments","List, extract, attach, or remove PDF file attachments.",{handleId:t.handleId,operation:l(["list","extract","attach","delete"],"Attachment operation."),outputPath:t.outputPath,sourcePath:t.path,name:n("Attachment name.")},["handleId","operation"]),a("pdf.flattenForms","Flatten PDF form fields into page content.",{handleId:t.handleId,outputPath:t.outputPath},["handleId"]),a("pdf.optimize","Optimize a PDF into a separate output artifact.",{handleId:t.handleId,outputPath:t.outputPath,options:i("Optimization options.")},["handleId","outputPath"]),a("pdf.addPageNumbers","Add page numbers to a PDF into a separate output artifact.",{handleId:t.handleId,outputPath:t.outputPath,options:i("Page number placement and formatting options.")},["handleId","outputPath"]),a("pdf.insertPages","Insert pages from another PDF before a page index.",{handleId:t.handleId,sourcePath:t.path,beforePage:d("Zero-based insertion page.")},["handleId","sourcePath","beforePage"]),a("pdf.deletePages","Delete selected pages from a PDF.",{handleId:t.handleId,pages:o("Zero-based page numbers.")},["handleId","pages"]),a("pdf.reorderPages","Reorder all PDF pages using a zero-based permutation.",{handleId:t.handleId,order:o("Complete zero-based page permutation.")},["handleId","order"]),a("pdf.rotatePages","Rotate selected PDF pages.",{handleId:t.handleId,pages:o("Zero-based page numbers."),degrees:l(["90","180","270"],"Clockwise rotation.")},["handleId","pages","degrees"]),a("pdf.merge","Merge PDFs into a new output document.",{paths:h("Input PDF paths."),outputPath:t.outputPath},["paths","outputPath"]),a("pdf.split","Split selected PDF pages into a new output document.",{handleId:t.handleId,pages:o("Zero-based page numbers."),outputPath:t.outputPath},["handleId","pages","outputPath"]),a("pdf.addText","Add positioned text to a PDF page.",{handleId:t.handleId,page:d("Zero-based page number."),text:n("Text to add."),x:d("Horizontal PDF coordinate."),y:d("Vertical PDF coordinate.")},["handleId","page","text","x","y"]),a("pdf.addImage","Add an image to a PDF page.",{handleId:t.handleId,page:d("Zero-based page number."),imagePath:t.path,x:d("Horizontal PDF coordinate."),y:d("Vertical PDF coordinate."),width:d("Image width."),height:d("Image height.")},["handleId","page","imagePath","x","y","width","height"]),a("pdf.annotate","Add a PDF annotation.",{handleId:t.handleId,page:d("Zero-based page number."),text:n("Annotation text."),x:d("Horizontal PDF coordinate."),y:d("Vertical PDF coordinate.")},["handleId","page","text","x","y"]),a("pdf.readForm","Read PDF form fields.",{handleId:t.handleId},["handleId"]),a("pdf.fillForm","Fill PDF form fields.",{handleId:t.handleId,values:i("Field names and values.")},["handleId","values"]),a("pdf.redact","Redact selected rectangular areas in a PDF.",{handleId:t.handleId,areas:x("Page and rectangle definitions.")},["handleId","areas"]),a("pdf.save","Save changes to an opened PDF document.",{handleId:t.handleId,outputPath:t.outputPath},["handleId"]),a("pdf.close","Close an opened PDF document handle.",{handleId:t.handleId},["handleId"])],g=u("pptx","slide",[["duplicateSlide","Duplicate a presentation slide."],["importSlides","Import slides from another presentation."],["arrangeElements","Align, distribute, group, or reorder slide elements."],["findReplace","Find and replace text across presentation slides."],["extractText","Extract bounded text from selected presentation slides."],["manageMedia","List, insert, update, or delete presentation media."],["manageHyperlinks","List, set, or clear presentation hyperlinks."],["manageTransitions","Inspect or update slide transitions."],["manageLayouts","List or apply presentation slide layouts."],["readSlide","Read slide text and element metadata."],["addSlide","Add a slide."],["deleteSlide","Delete a slide."],["reorderSlides","Reorder slides."],["updateSlide","Update slide metadata."],["addElement","Add a slide element."],["updateElement","Update a slide element."],["deleteElement","Delete a slide element."],["setTheme","Set the presentation theme."],["setNotes","Set speaker notes."],["render","Render slides to image artifacts."],["exportPdf","Export the presentation as PDF."]]),I=u("excel","range",[["find","Find text or values in a workbook."],["manageNamedRange","Create, inspect, update, or delete a workbook named range."],["setDataValidation","Set or clear data validation on a worksheet range."],["managePivotTable","Create, refresh, inspect, or delete a pivot table."],["readFormulas","Read formulas and calculated values from a worksheet range."],["manageConditionalFormatting","List, set, or clear conditional formatting rules."],["manageSheetView","Inspect or update worksheet view settings."],["manageComments","List, add, update, or delete cell comments."],["manageProtection","Inspect, protect, or unprotect workbook or worksheet protection."],["readRange","Read a worksheet range."],["writeRange","Write values to a worksheet range."],["clearRange","Clear a worksheet range."],["addSheet","Add a worksheet."],["updateSheet","Rename or update a worksheet."],["deleteSheet","Delete a worksheet."],["editRows","Insert or delete worksheet rows."],["editColumns","Insert or delete worksheet columns."],["formatRange","Format a worksheet range."],["manageTable","Create or update a table."],["manageChart","Create or update a chart."],["sortRange","Sort a worksheet range."],["filterRange","Apply or clear a worksheet filter."],["recalculate","Recalculate workbook formulas."],["render","Render a worksheet to an image artifact."],["importCsv","Import CSV data into a worksheet."],["exportCsv","Export a worksheet as CSV."],["exportPdf","Export a workbook or worksheet as PDF."]]),f=u("docs","content",[["manageTable","Create, inspect, update, or delete a document table."],["manageImage","Insert, inspect, update, or delete a document image."],["fillTemplate","Fill tagged document content controls from structured values."],["updateFields","Update document fields."],["inspectStructure","Read document paragraphs, headings, tables, and sections."],["manageBookmarks","List, add, update, or delete document bookmarks."],["manageHyperlinks","List, add, update, or delete document hyperlinks."],["manageLists","Inspect or apply document list formatting."],["manageFootnotes","List, add, or delete document footnotes."],["readContent","Read document content and structure."],["insertContent","Insert content at a document position."],["updateContent","Update a document range."],["deleteContent","Delete a document range."],["findReplace","Find and replace document text."],["setStyles","Apply document styles."],["setSection","Update section settings."],["setHeaderFooter","Update a header or footer."],["manageComments","Create or update document comments."],["manageRevisions","Inspect or manage document revisions."],["render","Render document pages to image artifacts."],["exportPdf","Export the document as PDF."]]),F=[...m,...g,...I,...f];function u(e,s,p){return[a(`${e}.open`,`Open a ${e.toUpperCase()} document and return a governed document handle.`,{path:t.path},["path"]),a(`${e}.create`,`Create a new ${e.toUpperCase()} document at the requested path.`,{path:t.path,title:n("Optional document title.")},["path"]),a(`${e}.inspect`,`Inspect ${e.toUpperCase()} metadata.`,{handleId:t.handleId},["handleId"]),a(`${e}.validate`,`Validate ${e.toUpperCase()} structure.`,{path:t.path},["path"]),...p.map(([r,c])=>a(`${e}.${r}`,c,P(e,r,s),b(r))),a(`${e}.save`,`Save changes to an opened ${e.toUpperCase()} document.`,{handleId:t.handleId,outputPath:t.outputPath},["handleId"]),a(`${e}.close`,`Close an opened ${e.toUpperCase()} document handle.`,{handleId:t.handleId},["handleId"])]}function P(e,s,p){const r={handleId:t.handleId,outputPath:t.outputPath,sourcePath:t.path,sheet:n("Worksheet name."),sheetName:n("New worksheet name."),slide:d("Zero-based slide number."),pages:o("Optional zero-based item indexes."),range:n(`Target ${p} reference.`),start:d("Document character start."),end:d("Document character end."),find:n("Text to find."),replace:n("Replacement text."),content:n("Text or serialized content."),text:n("Text value."),values:i("Structured values."),options:i("Format-specific options."),operation:n("Format-specific operation."),name:n("Named item identifier."),formula:n("Formula or source expression."),formula1:n("Primary validation formula."),formula2:n("Secondary validation formula."),index:d("Zero-based item index."),position:d("Zero-based destination position."),elementIds:h("Element identifiers."),alignment:l(["left","center","right","top","middle","bottom"],"Alignment operation."),distribution:l(["horizontal","vertical"],"Distribution direction."),imagePath:t.path,mediaPath:t.path,width:d("Width in document units."),height:d("Height in document units."),altText:n("Alternative text."),tableName:n("Table or pivot table name."),sourceRange:n("Source worksheet range."),query:n("Search query."),maxResults:d("Maximum result count."),rowStart:d("Zero-based first row."),rowCount:d("Maximum rows."),columnStart:d("Zero-based first column."),columnCount:d("Maximum columns."),bookmark:i("Bookmark definition."),property:n("Property name."),expected:n("Expected value."),level:d("List or outline level."),target:n("Bookmark, hyperlink, or list target."),address:n("Hyperlink destination."),password:n("Protection password when required."),kind:n("Protection target kind."),style:n("Document style name."),listType:l(["bullet","number"],"List type."),effect:d("PowerPoint transition effect code.")};return e==="pptx"&&(r.elementId=n("Slide element identifier.")),r}function b(e){return e==="readSlide"?["handleId","slide"]:e==="readRange"||e==="writeRange"||e==="clearRange"||e==="formatRange"?["handleId","range"]:e==="duplicateSlide"?["handleId","slide"]:e==="importSlides"?["handleId","sourcePath"]:e==="arrangeElements"?["handleId","slide","elementIds","operation"]:e==="findReplace"?["handleId","find","replace"]:e==="find"?["handleId","query"]:e==="setDataValidation"?["handleId","range","operation"]:e==="manageNamedRange"||e==="setDataValidation"||e==="managePivotTable"||e==="manageTable"||e==="manageImage"?["handleId","operation"]:e==="fillTemplate"?["handleId","values"]:e==="updateFields"?["handleId"]:e==="extractText"?["handleId"]:e==="readFormulas"?["handleId","range"]:e==="manageMedia"||e==="manageHyperlinks"||e==="manageTransitions"||e==="manageLayouts"||e==="manageConditionalFormatting"||e==="manageSheetView"||e==="manageComments"||e==="manageProtection"||e==="manageBookmarks"||e==="manageLists"||e==="manageFootnotes"||e==="inspectStructure"?["handleId","operation"]:e==="exportCsv"||e==="exportPdf"||e==="render"?["handleId"]:["handleId"]}function a(e,s,p,r){return{type:"function",function:{name:e,description:s,parameters:{type:"object",properties:p,required:r,additionalProperties:!1}}}}function n(e){return{type:"string",description:e}}function d(e){return{type:"number",description:e}}function l(e,s){return{type:"string",enum:[...e],description:s}}function o(e){return{type:"array",items:{type:"integer"},description:e}}function h(e){return{type:"array",items:{type:"string"},description:e}}function i(e){return{type:"object",additionalProperties:!0,description:e}}function x(e){return{type:"array",items:{type:"object",additionalProperties:!0},description:e}}export{k as DOCUMENT_FORMATS,F as DOCUMENT_TOOL_DEFINITIONS};

package/dist/application/protocol/document-host-tool-executor.d.ts

@@ -1,49 +0,0 @@
-import type { ToolDefinition } from '@lotagate/sdk';
-import type { ToolExecutionContext, ToolExecutor, ToolInfo, ToolResult } from '@lotagate/agent-sdk';
-import type { ToolActivityObserver } from '../../ports/tool-activity.js';
-import { type DocumentFormat } from './document-host-tool-definitions.js';
-export type DocumentHostTool = 'document';
-export interface DocumentHostRequest {
-    version: 1;
-    type: 'host.request';
-    requestId: string;
-    tool: DocumentHostTool;
-    sessionId: string;
-    runId: string;
-    action: string;
-    params: Record<string, unknown>;
-    executionBoundary: 'host';
-    hostFallback: 'deny';
-    projectRoot?: string;
-    executionCwd?: string;
-    executionWorkspaceId?: string;
-}
-export interface DocumentHostResponse {
-    version: 1;
-    type: 'host.response';
-    requestId: string;
-    tool: DocumentHostTool;
-    ok: boolean;
-    result?: unknown;
-    error?: {
-        code: string;
-        category: string;
-        message: string;
-        retryable: boolean;
-    };
-}
-export type DocumentHostInvoker = (request: DocumentHostRequest, signal?: AbortSignal) => Promise<DocumentHostResponse>;
-export declare function documentToolDefinitions(): readonly ToolDefinition[];
-export declare function documentToolDefinitionsForFormats(formats: readonly DocumentFormat[]): readonly ToolDefinition[];
-export declare class DocumentHostToolExecutor implements ToolExecutor {
-    private readonly options;
-    private readonly definitions;
-    constructor(options: {
-        request: DocumentHostInvoker;
-        formats?: readonly DocumentFormat[];
-        onActivity?: ToolActivityObserver;
-    });
-    listTools(): readonly ToolDefinition[];
-    getToolInfo(toolName: string): ToolInfo | undefined;
-    execute(toolName: string, input: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
-}

package/dist/application/protocol/document-host-tool-executor.js

@@ -1,2 +0,0 @@
-import{randomUUID as a}from"node:crypto";import{DOCUMENT_TOOL_DEFINITIONS as i}from"./document-host-tool-definitions.js";function l(){return i}function c(o){const e=new Set(o.map(r=>`${r}.`));return i.filter(r=>[...e].some(t=>u(r)?.startsWith(t)===!0))}class p{options;definitions;constructor(e){this.options=e,this.definitions=e.formats===void 0?i:c(e.formats)}listTools(){return this.definitions}getToolInfo(e){if(!this.definitions.some(t=>u(t)===e))return;const r=/\.(?:open|inspect|validate|readText|readSlide|readRange|readContent|extractTables|recognizeText|search|extractImages|extractLinks|extractAnnotations|readForm|find|readFormulas|inspectStructure|manageRevisions)$/u.test(e);return{toolName:e,source:"custom",executorId:"desktop-document-host",metadata:{risk:r?"read":"unknown"}}}async execute(e,r,t){if(!this.definitions.some(n=>u(n)===e))return{content:`Unknown document tool: ${e}`,isError:!0};const s=this.options.onActivity?.start({key:`${t.runId}:${e}`,toolName:e,source:"custom",label:e.replace(/\./u," ")});try{const n=await this.options.request({version:1,type:"host.request",requestId:a(),tool:"document",sessionId:t.sessionId,runId:t.runId,action:e,params:r,executionBoundary:"host",hostFallback:"deny",...t.workspaceRoot===void 0?{}:{projectRoot:t.workspaceRoot},...t.cwd===void 0?{}:{executionCwd:t.cwd}},t.signal);return n.ok?(s?.complete(!1),{content:d(n.result,t.maxResultBytes),isError:!1,metadata:{document:!0}}):(s?.complete(!0),{content:n.error?.message??"Desktop rejected the document action.",isError:!0,metadata:{code:n.error?.code??"DOCUMENT_HOST_ERROR",retryable:n.error?.retryable??!1}})}catch(n){return s?.complete(!0),{content:n instanceof Error?n.message:"Document host request failed.",isError:!0}}}}function u(o){return"function"in o?o.function.name:void 0}function d(o,e){const r=typeof o=="string"?o:JSON.stringify(o??null);return Buffer.byteLength(r,"utf8")<=e?r:`${r.slice(0,Math.max(0,e-12))}
-[truncated]`}export{p as DocumentHostToolExecutor,l as documentToolDefinitions,c as documentToolDefinitionsForFormats};