@polpo-ai/tools 0.2.4

package/dist/adapters/node-filesystem.d.ts

@@ -0,0 +1,12 @@
+import type { FileSystem, FileStat } from "@polpo-ai/core/filesystem";
+export declare class NodeFileSystem implements FileSystem {
+    readFile(path: string): Promise<string>;
+    writeFile(path: string, content: string): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    readdir(path: string): Promise<string[]>;
+    mkdir(path: string): Promise<void>;
+    remove(path: string): Promise<void>;
+    stat(path: string): Promise<FileStat>;
+    rename(oldPath: string, newPath: string): Promise<void>;
+}
+//# sourceMappingURL=node-filesystem.d.ts.map

package/dist/adapters/node-filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-filesystem.d.ts","sourceRoot":"","sources":["../../src/adapters/node-filesystem.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAEtE,qBAAa,cAAe,YAAW,UAAU;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIvC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAStC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIxC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAUrC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG9D"}

package/dist/adapters/node-filesystem.js

@@ -0,0 +1,46 @@
+/**
+ * Node.js FileSystem implementation — wraps node:fs.
+ *
+ * Default implementation for self-hosted mode. Reads/writes to the real filesystem.
+ * Drop-in replacement pattern: swap with AgentFS, SandboxProxyFS, etc.
+ */
+import { readFile, writeFile, mkdir, rm, stat, readdir, rename, access } from "node:fs/promises";
+export class NodeFileSystem {
+    async readFile(path) {
+        return readFile(path, "utf-8");
+    }
+    async writeFile(path, content) {
+        await writeFile(path, content, "utf-8");
+    }
+    async exists(path) {
+        try {
+            await access(path);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async readdir(path) {
+        return readdir(path);
+    }
+    async mkdir(path) {
+        await mkdir(path, { recursive: true });
+    }
+    async remove(path) {
+        await rm(path, { recursive: true, force: true });
+    }
+    async stat(path) {
+        const s = await stat(path);
+        return {
+            size: s.size,
+            isDirectory: s.isDirectory(),
+            isFile: s.isFile(),
+            modifiedAt: s.mtime,
+        };
+    }
+    async rename(oldPath, newPath) {
+        await rename(oldPath, newPath);
+    }
+}
+//# sourceMappingURL=node-filesystem.js.map

package/dist/adapters/node-filesystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-filesystem.js","sourceRoot":"","sources":["../../src/adapters/node-filesystem.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAGjG,MAAM,OAAO,cAAc;IACzB,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,OAAO,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAY,EAAE,OAAe;QAC3C,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY;QACxB,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO;YACL,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE;YAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;YAClB,UAAU,EAAE,CAAC,CAAC,KAAK;SACpB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,OAAe;QAC3C,MAAM,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;CACF"}

package/dist/adapters/node-shell.d.ts

@@ -0,0 +1,5 @@
+import type { Shell, ShellOptions, ShellResult } from "@polpo-ai/core/shell";
+export declare class NodeShell implements Shell {
+    execute(command: string, options?: ShellOptions): Promise<ShellResult>;
+}
+//# sourceMappingURL=node-shell.d.ts.map

package/dist/adapters/node-shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-shell.d.ts","sourceRoot":"","sources":["../../src/adapters/node-shell.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAG7E,qBAAa,SAAU,YAAW,KAAK;IAC/B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;CAsB7E"}

package/dist/adapters/node-shell.js

@@ -0,0 +1,34 @@
+/**
+ * Node.js Shell implementation — wraps execa.
+ *
+ * Default implementation for self-hosted mode. Executes real shell commands.
+ * Drop-in replacement pattern: swap with JustBashShell, SandboxProxyShell, etc.
+ */
+import { execaCommand } from "execa";
+import { bashSafeEnv } from "../safe-env.js";
+export class NodeShell {
+    async execute(command, options) {
+        try {
+            const result = await execaCommand(command, {
+                shell: true,
+                cwd: options?.cwd,
+                env: { ...bashSafeEnv(), ...options?.env },
+                timeout: options?.timeout,
+                reject: false,
+            });
+            return {
+                stdout: result.stdout,
+                stderr: result.stderr,
+                exitCode: result.exitCode ?? 0,
+            };
+        }
+        catch (err) {
+            return {
+                stdout: "",
+                stderr: err.message ?? String(err),
+                exitCode: 1,
+            };
+        }
+    }
+}
+//# sourceMappingURL=node-shell.js.map

package/dist/adapters/node-shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-shell.js","sourceRoot":"","sources":["../../src/adapters/node-shell.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,OAAO,SAAS;IACpB,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,OAAsB;QACnD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE;gBACzC,KAAK,EAAE,IAAI;gBACX,GAAG,EAAE,OAAO,EAAE,GAAG;gBACjB,GAAG,EAAE,EAAE,GAAG,WAAW,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE;gBAC1C,OAAO,EAAE,OAAO,EAAE,OAAO;gBACzB,MAAM,EAAE,KAAK;aACd,CAAC,CAAC;YACH,OAAO;gBACL,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC;aAC/B,CAAC;QACJ,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO;gBACL,MAAM,EAAE,EAAE;gBACV,MAAM,EAAE,GAAG,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC;gBAClC,QAAQ,EAAE,CAAC;aACZ,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/audio-tools.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Audio tools for speech-to-text (STT) and text-to-speech (TTS).
+ *
+ * Provides agent capabilities to:
+ * - Transcribe audio files to text (audio_transcribe)
+ * - Generate speech audio from text (audio_speak)
+ *
+ * Architecture: direct fetch() to provider REST APIs — zero vendor SDK dependencies.
+ *
+ * Supported providers:
+ *   STT: openai (Whisper), deepgram (Nova)
+ *   TTS: openai (gpt-4o-mini-tts / tts-1), deepgram (Aura), elevenlabs, edge (free, local)
+ *
+ * Edge TTS: Uses Microsoft Edge's neural TTS engine via the `edge-tts` CLI.
+ * Free, no API key, ~400 voices in 60+ languages. Auto-selects voice from
+ * language + gender params. Also used as automatic fallback when cloud providers fail.
+ * Install: `pip install edge-tts`
+ *
+ * Credential resolution order (same as email/image tools):
+ *   1. Agent vault (per-agent credentials — e.g. service "openai" key "key")
+ *   2. Environment variables (global fallback)
+ *   3. Edge TTS (automatic fallback — no credentials needed)
+ *
+ * Environment variables (fallback):
+ *   OPENAI_API_KEY    — openai provider (STT + TTS)
+ *   DEEPGRAM_API_KEY  — deepgram provider (STT + TTS)
+ *   ELEVENLABS_API_KEY — elevenlabs provider (TTS)
+ */
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import type { ResolvedVault } from "./types.js";
+export type AudioToolName = "audio_transcribe" | "audio_speak";
+export declare const ALL_AUDIO_TOOL_NAMES: AudioToolName[];
+/**
+ * Create audio tools for speech-to-text and text-to-speech.
+ *
+ * @param cwd - Working directory for resolving file paths
+ * @param allowedPaths - Sandbox paths for file validation
+ * @param allowedTools - Optional filter
+ * @param vault - Resolved vault credentials for credential resolution
+ */
+export declare function createAudioTools(cwd: string, allowedPaths?: string[], allowedTools?: string[], vault?: ResolvedVault): AgentTool<any>[];
+//# sourceMappingURL=audio-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audio-tools.d.ts","sourceRoot":"","sources":["../src/audio-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,6BAA6B,CAAC;AAK9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAimBhD,MAAM,MAAM,aAAa,GAAG,kBAAkB,GAAG,aAAa,CAAC;AAE/D,eAAO,MAAM,oBAAoB,EAAE,aAAa,EAAwC,CAAC;AAEzF;;;;;;;GAOG;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,CAalB"}