@5ss/ai-tools 2.11.1

package/dist/gotenberg-NuJjxyln.js

@@ -0,0 +1,291 @@
+import { t as ToolError } from "./errors-DoSpNHvs.js";
+import { n as defineModule, r as defineTool } from "./define-CvpJ_pNP.js";
+import { n as requireAuth } from "./provider-CgDAlg6K.js";
+import { t as artifactRefSchema } from "./artifact-D064mHfK.js";
+import { t as HttpService } from "./http-service-DDNCO1s4.js";
+import { a as toArrayBuffer } from "./bytes-BxpimpQx.js";
+import { m as s3AuthSchema, p as S3Client } from "./s3-CsOaPWMP.js";
+import { n as runBatchItems, t as batchResultSchema } from "./batch-Co1ujeAW.js";
+import { z } from "zod";
+//#region src/vendors/gotenberg/contracts.ts
+const MAX_HTML_CHARS = 2e6;
+const gotenbergAuthSchema = z.object({
+	gotenberg_base_url: z.url().describe("Self-hosted Gotenberg origin, for example http://localhost:3000"),
+	gotenberg_api_username: z.string().min(1).optional().describe("Optional basic-auth username"),
+	gotenberg_api_password: z.string().min(1).optional().describe("Optional basic-auth password"),
+	storage: s3AuthSchema.describe("Object storage for rendered ArtifactRef output")
+});
+const gotenbergViewportSchema = z.object({
+	width: z.int().min(1).max(8e3).describe("Viewport width in CSS pixels"),
+	height: z.int().min(1).max(8e3).describe("Viewport height in CSS pixels"),
+	device_scale_factor: z.number().min(.1).max(4).optional().describe("Device scale factor (default 1)")
+});
+const gotenbergRenderSourceSchema = z.object({
+	html: z.string().min(1).max(MAX_HTML_CHARS).optional().describe("HTML document body to render"),
+	url: z.url().optional().describe("Absolute http(s) URL to open and render")
+}).refine((v) => Boolean(v.html?.trim() || v.url), { message: "Provide html or url" }).refine((v) => !(v.html && v.url), { message: "Provide only one of html or url" });
+const gotenbergRenderPdfInputSchema = z.object({
+	source: gotenbergRenderSourceSchema.describe("HTML string or URL to print"),
+	output_key: z.string().min(1).optional().describe("Object key for the PDF. Defaults under renders/"),
+	filename: z.string().min(1).optional().describe("Display filename for the result ArtifactRef")
+});
+const gotenbergRenderScreenshotInputSchema = z.object({
+	source: gotenbergRenderSourceSchema.describe("HTML string or URL to capture"),
+	output_key: z.string().min(1).optional().describe("Object key for the PNG. Defaults under renders/"),
+	filename: z.string().min(1).optional().describe("Display filename for the result ArtifactRef"),
+	viewport: gotenbergViewportSchema.optional().describe("Optional screenshot viewport")
+});
+const gotenbergRenderOutputSchema = z.object({
+	result: artifactRefSchema,
+	kind: z.enum(["pdf", "screenshot"])
+});
+/** Office document → PDF via LibreOffice (not HTML print). */
+const gotenbergConvertPathSchema = z.enum(["office-to-pdf"]).describe("Closed conversion path");
+const gotenbergConvertInputSchema = z.object({
+	source: artifactRefSchema.describe("Input artifact in object storage (office document)"),
+	path: gotenbergConvertPathSchema.default("office-to-pdf").describe("Conversion path (currently office-to-pdf only)"),
+	output_key: z.string().min(1).optional().describe("Object key for the PDF result. Defaults to source key with .pdf extension"),
+	filename: z.string().min(1).optional().describe("Upload filename when source has none")
+});
+const gotenbergConvertOutputSchema = z.object({
+	source: artifactRefSchema,
+	result: artifactRefSchema,
+	path: gotenbergConvertPathSchema
+});
+const MAX_BATCH_CONVERT = 10;
+const gotenbergConvertBatchInputSchema = z.object({ items: z.array(gotenbergConvertInputSchema).min(1).max(10).describe(`Conversions to run (max 10)`) });
+//#endregion
+//#region src/vendors/gotenberg/domain.ts
+/**
+* Gotenberg form/path helpers (no HTTP).
+*/
+function appendSource(form, source) {
+	if (source.html) {
+		const bytes = new TextEncoder().encode(source.html);
+		const blob = new Blob([toArrayBuffer(bytes)], { type: "text/html" });
+		form.append("files", blob, "index.html");
+		return;
+	}
+	if (source.url) {
+		form.append("url", source.url);
+		return;
+	}
+	throw new ToolError("Provide html or url", { code: "bad_input" });
+}
+function htmlPath(kind, source) {
+	if (source.html) return kind === "pdf" ? "/forms/chromium/convert/html" : "/forms/chromium/screenshot/html";
+	return kind === "pdf" ? "/forms/chromium/convert/url" : "/forms/chromium/screenshot/url";
+}
+function defaultRenderKey(kind, outputKey) {
+	if (outputKey) return outputKey;
+	const stamp = Date.now();
+	return kind === "pdf" ? `renders/${stamp}.pdf` : `renders/${stamp}.png`;
+}
+/** LibreOffice route — office suite docs → PDF. */
+const LIBREOFFICE_CONVERT_PATH = "/forms/libreoffice/convert";
+function basenameFromKey(key) {
+	const parts = key.replace(/\/+$/, "").split("/");
+	const last = parts[parts.length - 1];
+	return last && last.length > 0 ? last : "document";
+}
+function officeUploadName(source, filename) {
+	if (filename && filename.trim().length > 0) return filename.trim();
+	if (source.filename && source.filename.trim().length > 0) return source.filename.trim();
+	return basenameFromKey(source.key);
+}
+function officeToPdfResultKey(sourceKey, outputKey) {
+	if (outputKey) return outputKey;
+	return `${sourceKey.replace(/\.[^./]+$/, "")}.pdf`;
+}
+function guessOfficeMediaType(filename, hint) {
+	if (hint && hint.length > 0) return hint;
+	const lower = filename.toLowerCase();
+	if (lower.endsWith(".docx")) return "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
+	if (lower.endsWith(".doc")) return "application/msword";
+	if (lower.endsWith(".pptx")) return "application/vnd.openxmlformats-officedocument.presentationml.presentation";
+	if (lower.endsWith(".ppt")) return "application/vnd.ms-powerpoint";
+	if (lower.endsWith(".xlsx")) return "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+	if (lower.endsWith(".xls")) return "application/vnd.ms-excel";
+	if (lower.endsWith(".odt")) return "application/vnd.oasis.opendocument.text";
+	if (lower.endsWith(".odp")) return "application/vnd.oasis.opendocument.presentation";
+	if (lower.endsWith(".ods")) return "application/vnd.oasis.opendocument.spreadsheet";
+	if (lower.endsWith(".rtf")) return "application/rtf";
+	if (lower.endsWith(".csv")) return "text/csv";
+	if (lower.endsWith(".txt")) return "text/plain";
+	return "application/octet-stream";
+}
+//#endregion
+//#region src/vendors/gotenberg/client.ts
+/**
+* Gotenberg vendor client.
+* Chromium: HTML/URL → PDF or screenshot.
+* LibreOffice: office documents → PDF (file convert).
+* Host: `new GotenbergClient(auth)`. Agent tools: `fromContext(ctx)`.
+*/
+var GotenbergClient = class GotenbergClient {
+	#auth;
+	#http;
+	#storage;
+	constructor(auth, options = {}) {
+		const parsed = gotenbergAuthSchema.safeParse(auth);
+		if (!parsed.success) throw new ToolError("Invalid Gotenberg auth credentials", {
+			code: "bad_auth",
+			details: { issues: parsed.error.issues.map((issue) => issue.message) }
+		});
+		this.#auth = parsed.data;
+		const headers = {};
+		if (this.#auth.gotenberg_api_username && this.#auth.gotenberg_api_password) headers["Authorization"] = `Basic ${btoa(`${this.#auth.gotenberg_api_username}:${this.#auth.gotenberg_api_password}`)}`;
+		this.#http = new HttpService({
+			...options,
+			baseURL: this.#auth.gotenberg_base_url,
+			headers,
+			label: "Gotenberg"
+		});
+		this.#storage = new S3Client(this.#auth.storage, options);
+	}
+	static fromContext(ctx) {
+		const auth = requireAuth(ctx, gotenbergAuthSchema);
+		return new GotenbergClient(auth, {
+			...ctx.fetch && { fetch: ctx.fetch },
+			...ctx.signal && { signal: ctx.signal }
+		});
+	}
+	/** Chromium HTML/URL → PDF; store result in object storage. */
+	async renderPdf(input) {
+		return this.#renderAndStore("pdf", input);
+	}
+	/** Chromium HTML/URL → PNG screenshot; store result in object storage. */
+	async renderScreenshot(input) {
+		return this.#renderAndStore("screenshot", input);
+	}
+	/**
+	* LibreOffice convert: office document in object storage → PDF ArtifactRef.
+	* Path: office-to-pdf only (docx/pptx/xlsx/odt/…). Not for HTML layout print.
+	*/
+	async convert(input) {
+		if (input.source.store !== "object") throw new ToolError("Gotenberg convert requires source.store \"object\"", { code: "bad_input" });
+		const bytes = await this.#storage.getBytes(input.source.key);
+		const filename = officeUploadName(input.source, input.filename);
+		const mediaType = guessOfficeMediaType(filename, input.source.media_type);
+		const form = new FormData();
+		const blob = new Blob([toArrayBuffer(bytes)], { type: mediaType });
+		form.append("files", blob, filename);
+		const { bytes: outBytes } = await this.#http.bytes("POST", LIBREOFFICE_CONVERT_PATH, {
+			label: "Gotenberg libreoffice convert",
+			body: form
+		});
+		const resultKey = officeToPdfResultKey(input.source.key, input.output_key);
+		const resultName = filename.replace(/\.[^./]+$/, "") + ".pdf";
+		await this.#storage.putBytes(resultKey, outBytes, "application/pdf");
+		const result = artifactRefSchema.parse({
+			store: "object",
+			key: resultKey,
+			media_type: "application/pdf",
+			filename: resultName,
+			byte_length: outBytes.byteLength
+		});
+		return gotenbergConvertOutputSchema.parse({
+			source: input.source,
+			result,
+			path: "office-to-pdf"
+		});
+	}
+	async convertBatch(input) {
+		return runBatchItems(input.items, (item) => this.convert(item));
+	}
+	async #renderAndStore(kind, input) {
+		const form = new FormData();
+		appendSource(form, input.source);
+		if (kind === "screenshot" && "viewport" in input && input.viewport) {
+			form.append("width", String(input.viewport.width));
+			form.append("height", String(input.viewport.height));
+			if (input.viewport.device_scale_factor !== void 0) form.append("deviceScaleFactor", String(input.viewport.device_scale_factor));
+		}
+		const path = htmlPath(kind, input.source);
+		const { bytes } = await this.#http.bytes("POST", path, {
+			label: `Gotenberg ${kind}`,
+			body: form
+		});
+		const mediaType = kind === "pdf" ? "application/pdf" : "image/png";
+		const key = defaultRenderKey(kind, input.output_key);
+		const filename = input.filename ?? (kind === "pdf" ? "render.pdf" : "render.png");
+		await this.#storage.putBytes(key, bytes, mediaType);
+		const result = artifactRefSchema.parse({
+			store: "object",
+			key,
+			media_type: mediaType,
+			filename,
+			byte_length: bytes.byteLength
+		});
+		return gotenbergRenderOutputSchema.parse({
+			result,
+			kind
+		});
+	}
+};
+//#endregion
+//#region src/vendors/gotenberg/module.ts
+const gotenbergConvertBatchOutputSchema = batchResultSchema(gotenbergConvertOutputSchema);
+const gotenbergRenderPdfTool = defineTool({
+	id: "gotenberg-render-pdf",
+	name: "gotenbergRenderPdf",
+	description: "Render HTML or a URL to a PDF via Chromium. Writes the PDF to object storage and returns an ArtifactRef. Prefer for web layouts; use convert for office documents.",
+	inputSchema: gotenbergRenderPdfInputSchema,
+	outputSchema: gotenbergRenderOutputSchema,
+	sideEffect: "write",
+	runtime: "both",
+	execute: async (input, ctx) => GotenbergClient.fromContext(ctx).renderPdf(input)
+});
+const gotenbergRenderScreenshotTool = defineTool({
+	id: "gotenberg-render-screenshot",
+	name: "gotenbergRenderScreenshot",
+	description: "Capture a PNG screenshot of HTML or a URL via Chromium. Writes the image to object storage and returns an ArtifactRef.",
+	inputSchema: gotenbergRenderScreenshotInputSchema,
+	outputSchema: gotenbergRenderOutputSchema,
+	sideEffect: "write",
+	runtime: "both",
+	execute: async (input, ctx) => GotenbergClient.fromContext(ctx).renderScreenshot(input)
+});
+const gotenbergConvertTool = defineTool({
+	id: "gotenberg-convert",
+	name: "gotenbergConvert",
+	description: "Convert an office document ArtifactRef to PDF (path office-to-pdf: docx, pptx, xlsx, odt, …). Not for HTML print layouts. Writes PDF to object storage.",
+	inputSchema: gotenbergConvertInputSchema,
+	outputSchema: gotenbergConvertOutputSchema,
+	sideEffect: "write",
+	runtime: "both",
+	execute: async (input, ctx) => GotenbergClient.fromContext(ctx).convert(input)
+});
+const gotenbergConvertBatchTool = defineTool({
+	id: "gotenberg-convert-batch",
+	name: "gotenbergConvertBatch",
+	description: "Convert up to 10 office document ArtifactRefs to PDF. Per-item success or error without aborting the batch.",
+	inputSchema: gotenbergConvertBatchInputSchema,
+	outputSchema: gotenbergConvertBatchOutputSchema,
+	sideEffect: "write",
+	runtime: "both",
+	execute: async (input, ctx) => GotenbergClient.fromContext(ctx).convertBatch(input)
+});
+const gotenbergModule = defineModule({
+	id: "gotenberg",
+	title: "Gotenberg",
+	description: "Gotenberg tools for HTML or URL rendering and office-document-to-PDF conversion. Each successful output is a final ArtifactRef; use the specific render or convert action matching the source format.",
+	runtime: "both",
+	auth: {
+		type: "custom",
+		schema: gotenbergAuthSchema
+	},
+	categories: ["documents", "convert"],
+	classification: "standard",
+	tags: ["libreoffice", "pdf"],
+	tools: [
+		gotenbergRenderPdfTool,
+		gotenbergRenderScreenshotTool,
+		gotenbergConvertTool,
+		gotenbergConvertBatchTool
+	]
+});
+//#endregion
+export { gotenbergRenderSourceSchema as _, gotenbergRenderScreenshotTool as a, MAX_HTML_CHARS as c, gotenbergConvertInputSchema as d, gotenbergConvertOutputSchema as f, gotenbergRenderScreenshotInputSchema as g, gotenbergRenderPdfInputSchema as h, gotenbergRenderPdfTool as i, gotenbergAuthSchema as l, gotenbergRenderOutputSchema as m, gotenbergConvertTool as n, GotenbergClient as o, gotenbergConvertPathSchema as p, gotenbergModule as r, MAX_BATCH_CONVERT as s, gotenbergConvertBatchTool as t, gotenbergConvertBatchInputSchema as u, gotenbergViewportSchema as v };
+
+//# sourceMappingURL=gotenberg-NuJjxyln.js.map

package/dist/gotenberg-NuJjxyln.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gotenberg-NuJjxyln.js","names":["#auth","#http","#storage","#renderAndStore"],"sources":["../src/vendors/gotenberg/contracts.ts","../src/vendors/gotenberg/domain.ts","../src/vendors/gotenberg/client.ts","../src/vendors/gotenberg/module.ts"],"sourcesContent":["import { z } from 'zod'\n\nimport { artifactRefSchema } from '../../shared/artifact'\nimport { s3AuthSchema } from '../s3'\n\nexport const MAX_HTML_CHARS = 2_000_000\n\nexport const gotenbergAuthSchema = z.object({\n\tgotenberg_base_url: z.url().describe('Self-hosted Gotenberg origin, for example http://localhost:3000'),\n\tgotenberg_api_username: z.string().min(1).optional().describe('Optional basic-auth username'),\n\tgotenberg_api_password: z.string().min(1).optional().describe('Optional basic-auth password'),\n\tstorage: s3AuthSchema.describe('Object storage for rendered ArtifactRef output')\n})\n\nexport type GotenbergAuth = z.infer<typeof gotenbergAuthSchema>\n\nexport const gotenbergViewportSchema = z.object({\n\twidth: z.int().min(1).max(8_000).describe('Viewport width in CSS pixels'),\n\theight: z.int().min(1).max(8_000).describe('Viewport height in CSS pixels'),\n\tdevice_scale_factor: z.number().min(0.1).max(4).optional().describe('Device scale factor (default 1)')\n})\n\nexport const gotenbergRenderSourceSchema = z\n\t.object({\n\t\thtml: z.string().min(1).max(MAX_HTML_CHARS).optional().describe('HTML document body to render'),\n\t\turl: z.url().optional().describe('Absolute http(s) URL to open and render')\n\t})\n\t.refine((v) => Boolean(v.html?.trim() || v.url), {\n\t\tmessage: 'Provide html or url'\n\t})\n\t.refine((v) => !(v.html && v.url), {\n\t\tmessage: 'Provide only one of html or url'\n\t})\n\nexport const gotenbergRenderPdfInputSchema = z.object({\n\tsource: gotenbergRenderSourceSchema.describe('HTML string or URL to print'),\n\toutput_key: z.string().min(1).optional().describe('Object key for the PDF. Defaults under renders/'),\n\tfilename: z.string().min(1).optional().describe('Display filename for the result ArtifactRef')\n})\n\nexport const gotenbergRenderScreenshotInputSchema = z.object({\n\tsource: gotenbergRenderSourceSchema.describe('HTML string or URL to capture'),\n\toutput_key: z.string().min(1).optional().describe('Object key for the PNG. Defaults under renders/'),\n\tfilename: z.string().min(1).optional().describe('Display filename for the result ArtifactRef'),\n\tviewport: gotenbergViewportSchema.optional().describe('Optional screenshot viewport')\n})\n\nexport const gotenbergRenderOutputSchema = z.object({\n\tresult: artifactRefSchema,\n\tkind: z.enum(['pdf', 'screenshot'])\n})\n\n/** Office document → PDF via LibreOffice (not HTML print). */\nexport const gotenbergConvertPathSchema = z.enum(['office-to-pdf']).describe('Closed conversion path')\n\nexport const gotenbergConvertInputSchema = z.object({\n\tsource: artifactRefSchema.describe('Input artifact in object storage (office document)'),\n\tpath: gotenbergConvertPathSchema.default('office-to-pdf').describe('Conversion path (currently office-to-pdf only)'),\n\toutput_key: z\n\t\t.string()\n\t\t.min(1)\n\t\t.optional()\n\t\t.describe('Object key for the PDF result. Defaults to source key with .pdf extension'),\n\tfilename: z.string().min(1).optional().describe('Upload filename when source has none')\n})\n\nexport const gotenbergConvertOutputSchema = z.object({\n\tsource: artifactRefSchema,\n\tresult: artifactRefSchema,\n\tpath: gotenbergConvertPathSchema\n})\n\nexport const MAX_BATCH_CONVERT = 10\n\nexport const gotenbergConvertBatchInputSchema = z.object({\n\titems: z\n\t\t.array(gotenbergConvertInputSchema)\n\t\t.min(1)\n\t\t.max(MAX_BATCH_CONVERT)\n\t\t.describe(`Conversions to run (max ${MAX_BATCH_CONVERT})`)\n})\n\nexport type GotenbergViewport = z.infer<typeof gotenbergViewportSchema>\nexport type GotenbergRenderSource = z.infer<typeof gotenbergRenderSourceSchema>\nexport type GotenbergRenderPdfInput = z.infer<typeof gotenbergRenderPdfInputSchema>\nexport type GotenbergRenderScreenshotInput = z.infer<typeof gotenbergRenderScreenshotInputSchema>\nexport type GotenbergRenderOutput = z.infer<typeof gotenbergRenderOutputSchema>\nexport type GotenbergConvertPath = z.infer<typeof gotenbergConvertPathSchema>\nexport type GotenbergConvertInput = z.infer<typeof gotenbergConvertInputSchema>\nexport type GotenbergConvertOutput = z.infer<typeof gotenbergConvertOutputSchema>\nexport type GotenbergConvertBatchInput = z.infer<typeof gotenbergConvertBatchInputSchema>\n","/**\n * Gotenberg form/path helpers (no HTTP).\n */\n\nimport { ToolError } from '../../core/errors'\nimport type { ArtifactRef } from '../../shared/artifact'\nimport { toArrayBuffer } from '../../shared/bytes'\nimport type { GotenbergRenderSource } from './contracts'\n\nexport function appendSource(form: FormData, source: GotenbergRenderSource): void {\n\tif (source.html) {\n\t\tconst bytes = new TextEncoder().encode(source.html)\n\t\tconst blob = new Blob([toArrayBuffer(bytes)], { type: 'text/html' })\n\t\tform.append('files', blob, 'index.html')\n\t\treturn\n\t}\n\tif (source.url) {\n\t\tform.append('url', source.url)\n\t\treturn\n\t}\n\tthrow new ToolError('Provide html or url', { code: 'bad_input' })\n}\n\nexport function htmlPath(kind: 'pdf' | 'screenshot', source: GotenbergRenderSource): string {\n\tif (source.html) {\n\t\treturn kind === 'pdf' ? '/forms/chromium/convert/html' : '/forms/chromium/screenshot/html'\n\t}\n\treturn kind === 'pdf' ? '/forms/chromium/convert/url' : '/forms/chromium/screenshot/url'\n}\n\nexport function defaultRenderKey(kind: 'pdf' | 'screenshot', outputKey: string | undefined): string {\n\tif (outputKey) return outputKey\n\tconst stamp = Date.now()\n\treturn kind === 'pdf' ? `renders/${stamp}.pdf` : `renders/${stamp}.png`\n}\n\n/** LibreOffice route — office suite docs → PDF. */\nexport const LIBREOFFICE_CONVERT_PATH = '/forms/libreoffice/convert'\n\nexport function basenameFromKey(key: string): string {\n\tconst parts = key.replace(/\\/+$/, '').split('/')\n\tconst last = parts[parts.length - 1]\n\treturn last && last.length > 0 ? last : 'document'\n}\n\nexport function officeUploadName(source: ArtifactRef, filename?: string): string {\n\tif (filename && filename.trim().length > 0) return filename.trim()\n\tif (source.filename && source.filename.trim().length > 0) return source.filename.trim()\n\treturn basenameFromKey(source.key)\n}\n\nexport function officeToPdfResultKey(sourceKey: string, outputKey: string | undefined): string {\n\tif (outputKey) return outputKey\n\tconst base = sourceKey.replace(/\\.[^./]+$/, '')\n\treturn `${base}.pdf`\n}\n\nexport function guessOfficeMediaType(filename: string, hint?: string): string {\n\tif (hint && hint.length > 0) return hint\n\tconst lower = filename.toLowerCase()\n\tif (lower.endsWith('.docx')) return 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'\n\tif (lower.endsWith('.doc')) return 'application/msword'\n\tif (lower.endsWith('.pptx')) return 'application/vnd.openxmlformats-officedocument.presentationml.presentation'\n\tif (lower.endsWith('.ppt')) return 'application/vnd.ms-powerpoint'\n\tif (lower.endsWith('.xlsx')) return 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'\n\tif (lower.endsWith('.xls')) return 'application/vnd.ms-excel'\n\tif (lower.endsWith('.odt')) return 'application/vnd.oasis.opendocument.text'\n\tif (lower.endsWith('.odp')) return 'application/vnd.oasis.opendocument.presentation'\n\tif (lower.endsWith('.ods')) return 'application/vnd.oasis.opendocument.spreadsheet'\n\tif (lower.endsWith('.rtf')) return 'application/rtf'\n\tif (lower.endsWith('.csv')) return 'text/csv'\n\tif (lower.endsWith('.txt')) return 'text/plain'\n\treturn 'application/octet-stream'\n}\n","/**\n * Gotenberg vendor client.\n * Chromium: HTML/URL → PDF or screenshot.\n * LibreOffice: office documents → PDF (file convert).\n * Host: `new GotenbergClient(auth)`. Agent tools: `fromContext(ctx)`.\n */\n\nimport { ToolError } from '../../core/errors'\nimport { requireAuth } from '../../core/provider'\nimport type { ToolContext } from '../../core/types'\nimport { artifactRefSchema } from '../../shared/artifact'\nimport { runBatchItems } from '../../shared/batch'\nimport { toArrayBuffer } from '../../shared/bytes'\nimport { HttpService } from '../../transport/http-service'\nimport type { HttpServiceOptions } from '../../transport/http-service'\nimport { S3Client } from '../s3'\nimport type {\n\tGotenbergAuth,\n\tGotenbergConvertBatchInput,\n\tGotenbergConvertInput,\n\tGotenbergConvertOutput,\n\tGotenbergRenderOutput,\n\tGotenbergRenderPdfInput,\n\tGotenbergRenderScreenshotInput\n} from './contracts'\nimport { gotenbergAuthSchema, gotenbergConvertOutputSchema, gotenbergRenderOutputSchema } from './contracts'\nimport {\n\tappendSource,\n\tdefaultRenderKey,\n\tguessOfficeMediaType,\n\thtmlPath,\n\tLIBREOFFICE_CONVERT_PATH,\n\tofficeToPdfResultKey,\n\tofficeUploadName\n} from './domain'\n\nexport type GotenbergClientOptions = Pick<HttpServiceOptions, 'fetch' | 'signal'>\n\nexport class GotenbergClient {\n\treadonly #auth: GotenbergAuth\n\treadonly #http: HttpService\n\treadonly #storage: S3Client\n\n\tconstructor(auth: GotenbergAuth, options: GotenbergClientOptions = {}) {\n\t\tconst parsed = gotenbergAuthSchema.safeParse(auth)\n\t\tif (!parsed.success) {\n\t\t\tthrow new ToolError('Invalid Gotenberg auth credentials', {\n\t\t\t\tcode: 'bad_auth',\n\t\t\t\tdetails: { issues: parsed.error.issues.map((issue) => issue.message) }\n\t\t\t})\n\t\t}\n\t\tthis.#auth = parsed.data\n\t\tconst headers: Record<string, string> = {}\n\t\tif (this.#auth.gotenberg_api_username && this.#auth.gotenberg_api_password) {\n\t\t\tconst token = btoa(`${this.#auth.gotenberg_api_username}:${this.#auth.gotenberg_api_password}`)\n\t\t\theaders['Authorization'] = `Basic ${token}`\n\t\t}\n\t\tthis.#http = new HttpService({\n\t\t\t...options,\n\t\t\tbaseURL: this.#auth.gotenberg_base_url,\n\t\t\theaders,\n\t\t\tlabel: 'Gotenberg'\n\t\t})\n\t\tthis.#storage = new S3Client(this.#auth.storage, options)\n\t}\n\n\tstatic fromContext(ctx: ToolContext): GotenbergClient {\n\t\tconst auth = requireAuth(ctx, gotenbergAuthSchema)\n\t\treturn new GotenbergClient(auth, {\n\t\t\t...(ctx.fetch && { fetch: ctx.fetch }),\n\t\t\t...(ctx.signal && { signal: ctx.signal })\n\t\t})\n\t}\n\n\t/** Chromium HTML/URL → PDF; store result in object storage. */\n\tasync renderPdf(input: GotenbergRenderPdfInput): Promise<GotenbergRenderOutput> {\n\t\treturn this.#renderAndStore('pdf', input)\n\t}\n\n\t/** Chromium HTML/URL → PNG screenshot; store result in object storage. */\n\tasync renderScreenshot(input: GotenbergRenderScreenshotInput): Promise<GotenbergRenderOutput> {\n\t\treturn this.#renderAndStore('screenshot', input)\n\t}\n\n\t/**\n\t * LibreOffice convert: office document in object storage → PDF ArtifactRef.\n\t * Path: office-to-pdf only (docx/pptx/xlsx/odt/…). Not for HTML layout print.\n\t */\n\tasync convert(input: GotenbergConvertInput): Promise<GotenbergConvertOutput> {\n\t\tif (input.source.store !== 'object') {\n\t\t\tthrow new ToolError('Gotenberg convert requires source.store \"object\"', { code: 'bad_input' })\n\t\t}\n\t\t// path is a closed enum (office-to-pdf); future paths branch here.\n\n\t\tconst bytes = await this.#storage.getBytes(input.source.key)\n\t\tconst filename = officeUploadName(input.source, input.filename)\n\t\tconst mediaType = guessOfficeMediaType(filename, input.source.media_type)\n\n\t\tconst form = new FormData()\n\t\tconst blob = new Blob([toArrayBuffer(bytes)], { type: mediaType })\n\t\tform.append('files', blob, filename)\n\n\t\tconst { bytes: outBytes } = await this.#http.bytes('POST', LIBREOFFICE_CONVERT_PATH, {\n\t\t\tlabel: 'Gotenberg libreoffice convert',\n\t\t\tbody: form\n\t\t})\n\n\t\tconst resultKey = officeToPdfResultKey(input.source.key, input.output_key)\n\t\tconst resultName = filename.replace(/\\.[^./]+$/, '') + '.pdf'\n\t\tawait this.#storage.putBytes(resultKey, outBytes, 'application/pdf')\n\n\t\tconst result = artifactRefSchema.parse({\n\t\t\tstore: 'object',\n\t\t\tkey: resultKey,\n\t\t\tmedia_type: 'application/pdf',\n\t\t\tfilename: resultName,\n\t\t\tbyte_length: outBytes.byteLength\n\t\t})\n\n\t\treturn gotenbergConvertOutputSchema.parse({\n\t\t\tsource: input.source,\n\t\t\tresult,\n\t\t\tpath: 'office-to-pdf'\n\t\t})\n\t}\n\n\tasync convertBatch(input: GotenbergConvertBatchInput) {\n\t\treturn runBatchItems(input.items, (item) => this.convert(item))\n\t}\n\n\tasync #renderAndStore(\n\t\tkind: 'pdf' | 'screenshot',\n\t\tinput: GotenbergRenderPdfInput | GotenbergRenderScreenshotInput\n\t): Promise<GotenbergRenderOutput> {\n\t\tconst form = new FormData()\n\t\tappendSource(form, input.source)\n\t\tif (kind === 'screenshot' && 'viewport' in input && input.viewport) {\n\t\t\tform.append('width', String(input.viewport.width))\n\t\t\tform.append('height', String(input.viewport.height))\n\t\t\tif (input.viewport.device_scale_factor !== undefined) {\n\t\t\t\tform.append('deviceScaleFactor', String(input.viewport.device_scale_factor))\n\t\t\t}\n\t\t}\n\n\t\tconst path = htmlPath(kind, input.source)\n\t\tconst { bytes } = await this.#http.bytes('POST', path, {\n\t\t\tlabel: `Gotenberg ${kind}`,\n\t\t\tbody: form\n\t\t})\n\n\t\tconst mediaType = kind === 'pdf' ? 'application/pdf' : 'image/png'\n\t\tconst key = defaultRenderKey(kind, input.output_key)\n\t\tconst filename = input.filename ?? (kind === 'pdf' ? 'render.pdf' : 'render.png')\n\t\tawait this.#storage.putBytes(key, bytes, mediaType)\n\n\t\tconst result = artifactRefSchema.parse({\n\t\t\tstore: 'object',\n\t\t\tkey,\n\t\t\tmedia_type: mediaType,\n\t\t\tfilename,\n\t\t\tbyte_length: bytes.byteLength\n\t\t})\n\t\treturn gotenbergRenderOutputSchema.parse({ result, kind })\n\t}\n}\n","import { defineModule, defineTool } from '../../core/define'\nimport { batchResultSchema } from '../../shared/batch'\nimport { GotenbergClient } from './client'\nimport {\n\tgotenbergAuthSchema,\n\tgotenbergConvertBatchInputSchema,\n\tgotenbergConvertInputSchema,\n\tgotenbergConvertOutputSchema,\n\tgotenbergRenderOutputSchema,\n\tgotenbergRenderPdfInputSchema,\n\tgotenbergRenderScreenshotInputSchema\n} from './contracts'\n\nconst gotenbergConvertBatchOutputSchema = batchResultSchema(gotenbergConvertOutputSchema)\n\nexport const gotenbergRenderPdfTool = defineTool({\n\tid: 'gotenberg-render-pdf',\n\tname: 'gotenbergRenderPdf',\n\tdescription:\n\t\t'Render HTML or a URL to a PDF via Chromium. Writes the PDF to object storage and returns an ArtifactRef. Prefer for web layouts; use convert for office documents.',\n\tinputSchema: gotenbergRenderPdfInputSchema,\n\toutputSchema: gotenbergRenderOutputSchema,\n\tsideEffect: 'write',\n\truntime: 'both',\n\texecute: async (input, ctx) => GotenbergClient.fromContext(ctx).renderPdf(input)\n})\n\nexport const gotenbergRenderScreenshotTool = defineTool({\n\tid: 'gotenberg-render-screenshot',\n\tname: 'gotenbergRenderScreenshot',\n\tdescription:\n\t\t'Capture a PNG screenshot of HTML or a URL via Chromium. Writes the image to object storage and returns an ArtifactRef.',\n\tinputSchema: gotenbergRenderScreenshotInputSchema,\n\toutputSchema: gotenbergRenderOutputSchema,\n\tsideEffect: 'write',\n\truntime: 'both',\n\texecute: async (input, ctx) => GotenbergClient.fromContext(ctx).renderScreenshot(input)\n})\n\nexport const gotenbergConvertTool = defineTool({\n\tid: 'gotenberg-convert',\n\tname: 'gotenbergConvert',\n\tdescription:\n\t\t'Convert an office document ArtifactRef to PDF (path office-to-pdf: docx, pptx, xlsx, odt, …). Not for HTML print layouts. Writes PDF to object storage.',\n\tinputSchema: gotenbergConvertInputSchema,\n\toutputSchema: gotenbergConvertOutputSchema,\n\tsideEffect: 'write',\n\truntime: 'both',\n\texecute: async (input, ctx) => GotenbergClient.fromContext(ctx).convert(input)\n})\n\nexport const gotenbergConvertBatchTool = defineTool({\n\tid: 'gotenberg-convert-batch',\n\tname: 'gotenbergConvertBatch',\n\tdescription:\n\t\t'Convert up to 10 office document ArtifactRefs to PDF. Per-item success or error without aborting the batch.',\n\tinputSchema: gotenbergConvertBatchInputSchema,\n\toutputSchema: gotenbergConvertBatchOutputSchema,\n\tsideEffect: 'write',\n\truntime: 'both',\n\texecute: async (input, ctx) => GotenbergClient.fromContext(ctx).convertBatch(input)\n})\n\nexport const gotenbergModule = defineModule({\n\tid: 'gotenberg',\n\ttitle: 'Gotenberg',\n\tdescription:\n\t\t'Gotenberg tools for HTML or URL rendering and office-document-to-PDF conversion. Each successful output is a final ArtifactRef; use the specific render or convert action matching the source format.',\n\truntime: 'both',\n\tauth: { type: 'custom', schema: gotenbergAuthSchema },\n\tcategories: ['documents', 'convert'],\n\tclassification: 'standard',\n\ttags: ['libreoffice', 'pdf'],\n\ttools: [gotenbergRenderPdfTool, gotenbergRenderScreenshotTool, gotenbergConvertTool, gotenbergConvertBatchTool]\n})\n"],"mappings":"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"}

package/dist/http/index.d.ts

@@ -0,0 +1,47 @@
+import { n as ToolErrorCode } from "../errors-aKhko9T1.js";
+import { a as HttpQueryResult, i as HttpCallOptions, n as HttpBytesOptions, o as HttpService, r as HttpBytesResult, s as HttpServiceOptions, t as HttpBody } from "../http-service-T7E5UjP8.js";
+//#region src/transport/aws-service.d.ts
+type AwsCredentials = {
+  accessKeyId: string;
+  secretAccessKey: string;
+  region: string;
+  /** AWS service name for SigV4 (s3, textract, sqs, …). */
+  service: string;
+  sessionToken?: string;
+};
+type AwsServiceOptions = AwsCredentials & HttpServiceOptions;
+/**
+ * Same surface as HttpService (query/bytes/get/post/…).
+ * Outbound requests are SigV4-signed; retries off (agent owns retry).
+ */
+declare class AwsService extends HttpService {
+  #private;
+  constructor(options: AwsServiceOptions);
+  /** Query-string presign (does not perform the request). */
+  sign(url: string, options?: {
+    method?: string;
+    signQuery?: boolean;
+  }): Promise<{
+    url: string;
+    method: string;
+  }>;
+}
+//#endregion
+//#region src/transport/errors.d.ts
+type StatusThrowOptions = {
+  allowStatuses?: readonly number[];
+  /** When true, non-2xx does not throw. */
+  noThrow?: boolean;
+};
+/** Map common HTTP status codes to stable ToolError codes. */
+declare function httpErrorCode(status: number): ToolErrorCode;
+declare function throwHttpStatus(operation: string, status: number, retryAfterMs?: number): never;
+/** Parse Retry-After header (seconds or HTTP-date) into milliseconds when possible. */
+declare function retryAfterMsFromHeader(value: string | null): number | undefined;
+/** Default: throw ToolError on non-2xx (404 → not_found). */
+declare function assertHttpStatusOk(label: string, status: number, headers: Headers, options?: StatusThrowOptions): void;
+/** Map ofetch / AbortError / unknown network failures to ToolError. */
+declare function mapTransportNetworkError(error: unknown, label: string): never;
+//#endregion
+export { type HttpBytesOptions as AwsBytesOptions, type HttpBytesOptions, type HttpBytesResult as AwsBytesResult, type HttpBytesResult, type HttpCallOptions as AwsCallOptions, type HttpCallOptions, type AwsCredentials, type HttpQueryResult as AwsQueryResult, type HttpQueryResult, AwsService, type AwsServiceOptions, type HttpBody, HttpService, type HttpServiceOptions, type StatusThrowOptions, assertHttpStatusOk, httpErrorCode, mapTransportNetworkError, retryAfterMsFromHeader, throwHttpStatus };
+//# sourceMappingURL=index.d.ts.map

package/dist/http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/transport/aws-service.ts","../../src/transport/errors.ts"],"mappings":";;;KAWY;EACX;EACA;EACA;;EAEA;EACA;;KAGW,oBAAoB,iBAAiB;;;;;cAapC,mBAAmB;;EAI/B,YAAY,SAAS;;EA4Bf,KACL,aACA;IAAW;IAAiB;MAC1B;IAAU;IAAa;;;;;KC1Df;EACX;;EAEA;;;iBAIe,cAAc,iBAAiB;iBAS/B,gBAAgB,mBAAmB,gBAAgB;;iBAanD,uBAAuB;;iBAavB,mBACf,eACA,gBACA,SAAS,SACT,UAAS;;iBA8BM,yBAAyB,gBAAgB"}

package/dist/http/index.js

@@ -0,0 +1,3 @@
+import { a as retryAfterMsFromHeader, i as mapTransportNetworkError, n as assertHttpStatusOk, o as throwHttpStatus, r as httpErrorCode, t as HttpService } from "../http-service-DDNCO1s4.js";
+import { t as AwsService } from "../aws-service-msttbPrz.js";
+export { AwsService, HttpService, assertHttpStatusOk, httpErrorCode, mapTransportNetworkError, retryAfterMsFromHeader, throwHttpStatus };

package/dist/http-service-DDNCO1s4.js

@@ -0,0 +1,254 @@
+import { t as ToolError } from "./errors-DoSpNHvs.js";
+import { isError, isNumber, trimEnd } from "es-toolkit";
+import { FetchError, createFetch } from "ofetch";
+//#region src/transport/errors.ts
+/**
+* HTTP status / network → ToolError for HttpService and AwsService.
+*/
+/** Map common HTTP status codes to stable ToolError codes. */
+function httpErrorCode(status) {
+	if (status === 401) return "bad_auth";
+	if (status === 403) return "forbidden";
+	if (status === 404) return "not_found";
+	if (status === 429) return "rate_limited";
+	if (status === 413) return "too_large";
+	return "upstream";
+}
+function throwHttpStatus(operation, status, retryAfterMs) {
+	const code = httpErrorCode(status);
+	throw new ToolError(`${operation} failed with HTTP ${status}`, {
+		code,
+		retryable: status >= 500 || status === 429,
+		details: {
+			status,
+			...retryAfterMs !== void 0 && { retry_after_ms: retryAfterMs }
+		}
+	});
+}
+/** Parse Retry-After header (seconds or HTTP-date) into milliseconds when possible. */
+function retryAfterMsFromHeader(value) {
+	if (value === null || value.length === 0) return void 0;
+	const asSeconds = Number.parseInt(value, 10);
+	if (Number.isFinite(asSeconds) && asSeconds >= 0) return asSeconds * 1e3;
+	const asDate = Date.parse(value);
+	if (Number.isFinite(asDate)) {
+		const delta = asDate - Date.now();
+		return delta > 0 ? delta : 0;
+	}
+}
+/** Default: throw ToolError on non-2xx (404 → not_found). */
+function assertHttpStatusOk(label, status, headers, options = {}) {
+	if (options.noThrow === true) return;
+	if (status >= 200 && status < 300) return;
+	if (options.allowStatuses && options.allowStatuses.includes(status)) return;
+	if (status === 404) throw new ToolError("Not found", {
+		code: "not_found",
+		details: { status }
+	});
+	throwHttpStatus(label, status, retryAfterMsFromHeader(headers.get("retry-after")));
+}
+/** True if error or any nested `cause` is an AbortError (ofetch wraps abort in FetchError). */
+function isAbortErrorChain(error) {
+	let current = error;
+	const seen = /* @__PURE__ */ new Set();
+	while (current !== void 0 && current !== null && !seen.has(current)) {
+		seen.add(current);
+		if (isError(current) && (current.name === "AbortError" || current.name === "TimeoutError")) return true;
+		if (isError(current) && "cause" in current) {
+			current = current.cause;
+			continue;
+		}
+		break;
+	}
+	return false;
+}
+/** Map ofetch / AbortError / unknown network failures to ToolError. */
+function mapTransportNetworkError(error, label) {
+	if (error instanceof ToolError) throw error;
+	if (isAbortErrorChain(error)) throw new ToolError(`${label} request was aborted`, {
+		code: "timeout",
+		retryable: true,
+		cause: error
+	});
+	if (error instanceof FetchError) {
+		const status = error.statusCode ?? error.response?.status;
+		if (isNumber(status) && Number.isFinite(status)) throwHttpStatus(label, status, retryAfterMsFromHeader(error.response?.headers.get("retry-after") ?? null));
+		throw new ToolError(error.message || `${label} request failed`, {
+			code: "upstream",
+			retryable: true,
+			cause: error
+		});
+	}
+	throw new ToolError(`${label} request failed`, {
+		code: "upstream",
+		retryable: true,
+		cause: error
+	});
+}
+//#endregion
+//#region src/transport/http-service.ts
+/**
+* Shared HTTP transport (ofetch under the hood).
+* Product clients construct this and call query/bytes/get/post/….
+*/
+/**
+* HTTP client: query (parsed), bytes, get/post/put/patch/delete/head.
+* Non-2xx → ToolError by default.
+*/
+var HttpService = class {
+	#http;
+	#defaultLabel;
+	#defaultSignal;
+	constructor(options = {}) {
+		this.#defaultLabel = options.label ?? "HTTP";
+		this.#defaultSignal = options.signal;
+		this.#http = createOfetch(options);
+	}
+	/** Shared ofetch.raw + status assert + error map. */
+	async #raw(method, path, options, extra) {
+		const label = options.label ?? this.#defaultLabel;
+		try {
+			const res = await this.#http.raw(path, {
+				signal: this.#defaultSignal ?? null,
+				method,
+				...options,
+				...extra
+			});
+			assertHttpStatusOk(label, res.status, res.headers, options);
+			return {
+				status: res.status,
+				ok: res.ok,
+				headers: res.headers,
+				url: res.url,
+				data: res._data
+			};
+		} catch (error) {
+			mapTransportNetworkError(error, label);
+		}
+	}
+	/** Parsed body (JSON/text). ofetch parses JSON responses by default. */
+	async query(method, path, options = {}) {
+		return this.#raw(method, path, options);
+	}
+	/**
+	* Binary body. `maxBytes` switches to streaming and cancels before an
+	* oversized response is materialized.
+	*/
+	async bytes(method, path, options = {}) {
+		const { maxBytes, ...requestOptions } = options;
+		if (maxBytes !== void 0 && (!Number.isSafeInteger(maxBytes) || maxBytes < 0)) throw new ToolError("Response byte limit must be a non-negative safe integer", { code: "bad_input" });
+		const res = await this.#raw(method, path, requestOptions, { responseType: maxBytes === void 0 ? "arrayBuffer" : "stream" });
+		if (maxBytes === void 0) return {
+			...res,
+			bytes: new Uint8Array(res.data)
+		};
+		const label = options.label ?? this.#defaultLabel;
+		try {
+			const bytes = await readBoundedBytes(res.data, res.headers, maxBytes, label);
+			return {
+				...res,
+				bytes
+			};
+		} catch (error) {
+			mapTransportNetworkError(error, label);
+		}
+	}
+	get(path, options = {}) {
+		return this.query("GET", path, options);
+	}
+	post(path, body, options = {}) {
+		return this.query("POST", path, body === void 0 ? options : {
+			...options,
+			body
+		});
+	}
+	put(path, body, options = {}) {
+		return this.query("PUT", path, body === void 0 ? options : {
+			...options,
+			body
+		});
+	}
+	patch(path, body, options = {}) {
+		return this.query("PATCH", path, body === void 0 ? options : {
+			...options,
+			body
+		});
+	}
+	delete(path, options = {}) {
+		return this.query("DELETE", path, options);
+	}
+	head(path, options = {}) {
+		return this.query("HEAD", path, options);
+	}
+};
+function isReadableByteStream(value) {
+	return value instanceof ReadableStream;
+}
+function contentLength(headers) {
+	const value = headers.get("content-length");
+	if (value === null || !/^\d+$/.test(value)) return void 0;
+	const parsed = Number(value);
+	return Number.isSafeInteger(parsed) ? parsed : void 0;
+}
+function responseTooLarge(label, maxBytes, observedBytes) {
+	throw new ToolError(`${label} response exceeds byte limit`, {
+		code: "too_large",
+		details: {
+			max_bytes: maxBytes,
+			content_length: observedBytes
+		}
+	});
+}
+async function readBoundedBytes(data, headers, maxBytes, label) {
+	const declaredLength = contentLength(headers);
+	if (declaredLength !== void 0 && declaredLength > maxBytes) {
+		if (isReadableByteStream(data)) try {
+			await data.cancel();
+		} catch {}
+		responseTooLarge(label, maxBytes, declaredLength);
+	}
+	if (data === null || data === void 0) return /* @__PURE__ */ new Uint8Array();
+	if (!isReadableByteStream(data)) throw new ToolError(`${label} returned an invalid byte stream`, { code: "upstream" });
+	const reader = data.getReader();
+	const chunks = [];
+	let total = 0;
+	try {
+		while (true) {
+			const chunk = await reader.read();
+			if (chunk.done) break;
+			if (!(chunk.value instanceof Uint8Array)) throw new ToolError(`${label} returned an invalid byte chunk`, { code: "upstream" });
+			total += chunk.value.byteLength;
+			if (total > maxBytes) {
+				try {
+					await reader.cancel();
+				} catch {}
+				responseTooLarge(label, maxBytes, declaredLength ?? total);
+			}
+			chunks.push(chunk.value);
+		}
+	} finally {
+		reader.releaseLock();
+	}
+	const bytes = new Uint8Array(total);
+	let offset = 0;
+	for (const chunk of chunks) {
+		bytes.set(chunk, offset);
+		offset += chunk.byteLength;
+	}
+	return bytes;
+}
+function createOfetch(options) {
+	const defaults = {
+		...options,
+		retry: false,
+		ignoreResponseError: true
+	};
+	if (defaults.baseURL) defaults.baseURL = trimEnd(defaults.baseURL, "/");
+	const createOptions = { defaults };
+	if (options.fetch) Object.assign(createOptions, { fetch: options.fetch });
+	return createFetch(createOptions);
+}
+//#endregion
+export { retryAfterMsFromHeader as a, mapTransportNetworkError as i, assertHttpStatusOk as n, throwHttpStatus as o, httpErrorCode as r, HttpService as t };
+
+//# sourceMappingURL=http-service-DDNCO1s4.js.map