@polpo-ai/tools 0.2.4

package/dist/http-tools.js

@@ -0,0 +1,214 @@
+/**
+ * HTTP/Fetch tools for agent network access.
+ *
+ * Provides structured HTTP capabilities so agents can:
+ * - Fetch web pages and API endpoints
+ * - Make REST API calls (GET, POST, PUT, DELETE, PATCH)
+ * - Download files from URLs
+ *
+ * Uses Node.js native fetch (available since Node 18).
+ * Enforces output size limits and timeout controls.
+ */
+import { writeFileSync, mkdirSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { Type } from "@sinclair/typebox";
+import { resolveAllowedPaths, assertPathAllowed } from "./path-sandbox.js";
+import { assertUrlAllowed } from "./ssrf-guard.js";
+const MAX_RESPONSE_BYTES = 100_000;
+const DEFAULT_TIMEOUT = 30_000;
+// ─── Tool: http_fetch ───
+const HttpFetchSchema = Type.Object({
+    url: Type.String({ description: "URL to fetch (must be http:// or https://)" }),
+    method: Type.Optional(Type.Union([
+        Type.Literal("GET"),
+        Type.Literal("POST"),
+        Type.Literal("PUT"),
+        Type.Literal("DELETE"),
+        Type.Literal("PATCH"),
+        Type.Literal("HEAD"),
+        Type.Literal("OPTIONS"),
+    ], { description: "HTTP method (default: GET)" })),
+    headers: Type.Optional(Type.Record(Type.String(), Type.String(), { description: "Request headers as key-value pairs" })),
+    body: Type.Optional(Type.String({ description: "Request body (for POST/PUT/PATCH). Use JSON string for JSON APIs." })),
+    timeout: Type.Optional(Type.Number({ description: "Timeout in milliseconds (default: 30000)" })),
+});
+function createHttpFetchTool() {
+    return {
+        name: "http_fetch",
+        label: "HTTP Fetch",
+        description: "Make an HTTP request to a URL. Supports all HTTP methods, custom headers, and request bodies. " +
+            "Returns status code, response headers, and body. Use for API calls, fetching web pages, or checking endpoints.",
+        parameters: HttpFetchSchema,
+        async execute(_id, params, signal) {
+            const url = params.url;
+            if (!url.startsWith("http://") && !url.startsWith("https://")) {
+                return {
+                    content: [{ type: "text", text: "Error: URL must start with http:// or https://" }],
+                    details: { error: "invalid_url" },
+                };
+            }
+            try {
+                assertUrlAllowed(url);
+            }
+            catch (err) {
+                return {
+                    content: [{ type: "text", text: `Error: ${err.message}` }],
+                    details: { error: "ssrf_blocked" },
+                };
+            }
+            const method = params.method ?? "GET";
+            const timeout = params.timeout ?? DEFAULT_TIMEOUT;
+            try {
+                const controller = new AbortController();
+                const timer = setTimeout(() => controller.abort(), timeout);
+                // Combine external signal with timeout
+                if (signal) {
+                    signal.addEventListener("abort", () => controller.abort(), { once: true });
+                }
+                const response = await fetch(url, {
+                    method,
+                    headers: params.headers,
+                    body: params.body,
+                    signal: controller.signal,
+                    redirect: "follow",
+                });
+                clearTimeout(timer);
+                const contentType = response.headers.get("content-type") ?? "";
+                const isText = contentType.includes("text") || contentType.includes("json") ||
+                    contentType.includes("xml") || contentType.includes("javascript") ||
+                    contentType.includes("html") || contentType.includes("css") ||
+                    contentType.includes("svg");
+                let body;
+                if (isText) {
+                    const text = await response.text();
+                    body = text.length > MAX_RESPONSE_BYTES
+                        ? text.slice(0, MAX_RESPONSE_BYTES) + `\n[truncated — ${text.length} total bytes]`
+                        : text;
+                }
+                else {
+                    const buffer = await response.arrayBuffer();
+                    body = `[Binary response: ${buffer.byteLength} bytes, content-type: ${contentType}]`;
+                }
+                // Extract relevant response headers
+                const responseHeaders = {};
+                for (const [key, value] of response.headers.entries()) {
+                    if (["content-type", "content-length", "location", "set-cookie",
+                        "cache-control", "x-ratelimit-remaining", "retry-after"].includes(key.toLowerCase())) {
+                        responseHeaders[key] = value;
+                    }
+                }
+                const resultText = [
+                    `Status: ${response.status} ${response.statusText}`,
+                    `Headers: ${JSON.stringify(responseHeaders)}`,
+                    ``,
+                    body,
+                ].join("\n");
+                return {
+                    content: [{ type: "text", text: resultText }],
+                    details: {
+                        url,
+                        method,
+                        status: response.status,
+                        statusText: response.statusText,
+                        headers: responseHeaders,
+                        bodyLength: body.length,
+                    },
+                };
+            }
+            catch (err) {
+                const message = err.name === "AbortError" ? "Request timed out" : err.message;
+                return {
+                    content: [{ type: "text", text: `HTTP error: ${message}` }],
+                    details: { url, method, error: message },
+                };
+            }
+        },
+    };
+}
+// ─── Tool: http_download ───
+const HttpDownloadSchema = Type.Object({
+    url: Type.String({ description: "URL to download from" }),
+    path: Type.String({ description: "Local file path to save the downloaded content" }),
+    headers: Type.Optional(Type.Record(Type.String(), Type.String(), { description: "Optional request headers" })),
+});
+function createHttpDownloadTool(cwd, sandbox) {
+    return {
+        name: "http_download",
+        label: "HTTP Download",
+        description: "Download a file from a URL and save it locally. Use for downloading assets, binaries, or data files.",
+        parameters: HttpDownloadSchema,
+        async execute(_id, params, signal) {
+            const url = params.url;
+            if (!url.startsWith("http://") && !url.startsWith("https://")) {
+                return {
+                    content: [{ type: "text", text: "Error: URL must start with http:// or https://" }],
+                    details: { error: "invalid_url" },
+                };
+            }
+            try {
+                assertUrlAllowed(url);
+            }
+            catch (err) {
+                return {
+                    content: [{ type: "text", text: `Error: ${err.message}` }],
+                    details: { error: "ssrf_blocked" },
+                };
+            }
+            const filePath = resolve(cwd, params.path);
+            assertPathAllowed(filePath, sandbox, "http_download");
+            try {
+                const controller = new AbortController();
+                const timer = setTimeout(() => controller.abort(), 120_000); // 2 min for downloads
+                if (signal) {
+                    signal.addEventListener("abort", () => controller.abort(), { once: true });
+                }
+                const response = await fetch(url, {
+                    headers: params.headers,
+                    signal: controller.signal,
+                    redirect: "follow",
+                });
+                clearTimeout(timer);
+                if (!response.ok) {
+                    return {
+                        content: [{ type: "text", text: `Download failed: ${response.status} ${response.statusText}` }],
+                        details: { url, status: response.status, error: "http_error" },
+                    };
+                }
+                const buffer = Buffer.from(await response.arrayBuffer());
+                mkdirSync(dirname(filePath), { recursive: true });
+                writeFileSync(filePath, buffer);
+                return {
+                    content: [{ type: "text", text: `Downloaded ${buffer.byteLength} bytes to ${filePath}` }],
+                    details: { url, path: filePath, bytes: buffer.byteLength },
+                };
+            }
+            catch (err) {
+                const message = err.name === "AbortError" ? "Download timed out" : err.message;
+                return {
+                    content: [{ type: "text", text: `Download error: ${message}` }],
+                    details: { url, error: message },
+                };
+            }
+        },
+    };
+}
+export const ALL_HTTP_TOOL_NAMES = ["http_fetch", "http_download"];
+/**
+ * Create HTTP tools for network access.
+ *
+ * @param cwd - Working directory for resolving download paths
+ * @param allowedPaths - Sandbox paths for download destination validation
+ * @param allowedTools - Optional filter
+ */
+export function createHttpTools(cwd, allowedPaths, allowedTools) {
+    const sandbox = resolveAllowedPaths(cwd, allowedPaths);
+    const factories = {
+        http_fetch: () => createHttpFetchTool(),
+        http_download: () => createHttpDownloadTool(cwd, sandbox),
+    };
+    const names = allowedTools
+        ? ALL_HTTP_TOOL_NAMES.filter(n => allowedTools.some(a => a.toLowerCase() === n))
+        : ALL_HTTP_TOOL_NAMES;
+    return names.map(n => factories[n]());
+}
+//# sourceMappingURL=http-tools.js.map

package/dist/http-tools.js.map

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

package/dist/image-tools.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Image & video tools for generation and vision/analysis.
+ *
+ * Provides agent capabilities to:
+ * - Generate images from text prompts (image_generate) — via fal.ai
+ * - Generate videos from text prompts (video_generate) — via fal.ai
+ * - Analyze/describe images using vision models (image_analyze) — via OpenAI/Anthropic
+ *
+ * Architecture: direct fetch() to provider REST APIs — zero vendor SDK dependencies.
+ *
+ * Providers:
+ *   Image generation: fal.ai (FLUX models — fal-ai/flux/dev default)
+ *   Video generation: fal.ai (Wan 2.2 — fal-ai/wan/v2.2-1.3b/text-to-video default)
+ *   Vision/analysis:  openai (gpt-4.1-mini), anthropic (Claude)
+ *
+ * Credential resolution order (same as email tools):
+ *   1. Agent vault (per-agent credentials — e.g. service "fal" with key "key")
+ *   2. Environment variables (global fallback)
+ *
+ * Environment variables (fallback):
+ *   FAL_KEY             — fal.ai image/video generation
+ *   OPENAI_API_KEY      — openai vision provider
+ *   ANTHROPIC_API_KEY   — anthropic vision provider
+ */
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import type { ResolvedVault } from "./types.js";
+export type ImageToolName = "image_generate" | "image_analyze" | "video_generate";
+export declare const ALL_IMAGE_TOOL_NAMES: ImageToolName[];
+/**
+ * Create image & video tools for generation, vision analysis, and video creation.
+ *
+ * @param cwd - Working directory for resolving file paths
+ * @param allowedPaths - Sandbox paths for file validation
+ * @param allowedTools - Optional filter — only include tools whose names appear here.
+ *   Supports wildcards expanded upstream (e.g. "image_*", "video_*").
+ * @param vault - Resolved vault for credential resolution (fal-ai, openai, anthropic).
+ *   Credentials are resolved as: vault > environment variable.
+ */
+export declare function createImageTools(cwd: string, allowedPaths?: string[], allowedTools?: string[], vault?: ResolvedVault): AgentTool<any>[];
+//# sourceMappingURL=image-tools.d.ts.map

package/dist/image-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-tools.d.ts","sourceRoot":"","sources":["../src/image-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,6BAA6B,CAAC;AAE9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAykBhD,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,eAAe,GAAG,gBAAgB,CAAC;AAElF,eAAO,MAAM,oBAAoB,EAAE,aAAa,EAA0D,CAAC;AAE3G;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,MAAM,EAAE,EACvB,YAAY,CAAC,EAAE,MAAM,EAAE,EACvB,KAAK,CAAC,EAAE,aAAa,GACpB,SAAS,CAAC,GAAG,CAAC,EAAE,CAclB"}