polpo-ai 0.1.16

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenPolpo Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,149 @@
+<p align="center">
+  <img src="docs/polpo-banner.png" alt="Polpo — your AI agent that runs the team" width="680" />
+</p>
+
+<p align="center">
+  <strong>Build your AI company.</strong><br/>
+  <sub>Spin up AI agent teams that plan, execute, review their own work, and ping you only when it matters.</sub>
+</p>
+
+<p align="center">
+  <a href="#quick-start">Quick Start</a> &bull;
+  <a href="#how-polpo-is-different">How it's different</a> &bull;
+  <a href="#features">Features</a> &bull;
+  <a href="https://docs.polpo.sh">Docs</a>
+</p>
+
+<p align="center">
+  <img alt="npm" src="https://img.shields.io/npm/v/@polpo-ai/polpo?style=flat-square&color=blue" />
+  <img alt="license" src="https://img.shields.io/github/license/lumea-labs/polpo?style=flat-square" />
+  <img alt="node" src="https://img.shields.io/badge/node-%3E%3D18-brightgreen?style=flat-square" />
+  <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-ESM-blue?style=flat-square" />
+</p>
+
+---
+
+## Why Polpo?
+
+You don't need another AI coding assistant. You need a team that runs without you.
+
+AI agents are great at execution — terrible at finishing real work autonomously. Without oversight they drift, conflict, and stall. You end up babysitting the machines that were supposed to save you time: 4 monitors, 12 terminals, zero confidence anything actually works.
+
+**Polpo gives you an AI company.** Describe what you need and walk away. Polpo assembles the right agents, plans the work, checks every result, retries what's broken, and escalates what it can't fix. It reaches you on Telegram, Slack, or email — only when it matters.
+
+One `npm install`, no hosted platform, no vendor lock-in. Your laptop, your API keys, your rules.
+
+## How Polpo is different
+
+| | What you get | How it works |
+|---|---|---|
+| **Claude Code / Cursor** | A developer | One agent, one chat, one task at a time. You drive. |
+| **OpenClaw** | A personal assistant | Multiple agents, no quality checks. You hope it works. |
+| **Polpo** | **A company** | Multiple agents working as a team — with a manager (Polpo) that plans, delegates, reviews, retries, and reports back. You're the CEO. |
+
+| | | |
+|:---:|---|---|
+| :robot: | **Autonomous** | Builds missions, picks agents, works through queued tasks 24/7. Walk away. |
+| :white_check_mark: | **Reliable** | Every task scored by LLM judges. Below threshold? The agent fixes it. You get results, not retries. |
+| :shield: | **Crash-proof** | Detached processes. Kill Polpo, reboot, lose connection — picks up where it left off. |
+| :bell: | **Proactive** | Reaches you on Slack, Telegram, email, or webhooks. You decide when and how. |
+| :repeat: | **Playbooks** | Define a mission once, run it forever. Schedule it, tweak it, improve it. Your AI company gets better over time. |
+
+## Installation
+
+### One-line install (recommended)
+
+**macOS / Linux / WSL:**
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/lumea-labs/polpo/main/install/install.sh | bash
+```
+
+**Windows (PowerShell):**
+
+```powershell
+irm https://raw.githubusercontent.com/lumea-labs/polpo/main/install/install.ps1 | iex
+```
+
+The installer detects your platform, ensures Node.js >= 18 is available, and installs Polpo globally.
+
+### Manual install
+
+```bash
+npm install -g @polpo-ai/polpo    # or: pnpm add -g @polpo-ai/polpo
+```
+
+### Docker
+
+```bash
+docker run -it -p 3000:3000 -v $(pwd):/workspace lumea-labs/polpo
+```
+
+## Quick Start
+
+### Chat with an agent
+
+```bash
+polpo init && polpo
+```
+
+The setup wizard detects your API keys, picks a model, and creates your first agent. Then you're in the interactive TUI — type what you need, hit Enter, and the agent does it.
+
+### Orchestrate a team
+
+```bash
+polpo init                          # Set up project, agents, and roles
+polpo mission create "Close $1M in revenue this month"
+```
+
+Polpo generates a mission with tasks, dependencies, and agent assignments. Agents execute, LLM judges score every result, and failures retry automatically.
+
+**Monitor** (optional):
+
+```bash
+polpo status -w    # Live dashboard in another terminal
+polpo serve        # HTTP API + Web UI at http://localhost:3000
+```
+
+### Docker
+
+```bash
+docker pull ghcr.io/lumea-labs/polpo:latest
+docker run -it -v $(pwd):/workspace ghcr.io/lumea-labs/polpo:latest
+```
+
+## What your agents can do
+
+Code. Browse the web. Send emails. Generate PDFs, Excel, Word docs. Create images, videos, audio. Search the internet. Talk to your customers. Handle credentials securely. And learn — Polpo creates and installs its own skills over time. Your AI company gets smarter the more you use it.
+
+22+ LLM providers. 70+ tools. 5,000+ community skills. Free default model included.
+
+## Documentation
+
+Full docs at [docs.polpo.sh](https://docs.polpo.sh) — configuration, API reference, guides, and more.
+
+## Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for setup instructions, coding standards, and PR guidelines.
+
+```bash
+git clone https://github.com/lumea-labs/polpo.git
+cd polpo
+pnpm install
+pnpm run build
+pnpm run test -- --run
+```
+
+## Security
+
+If you discover a security vulnerability, please report it responsibly. See [SECURITY.md](SECURITY.md) for details.
+
+## License
+
+[MIT](LICENSE)
+
+---
+
+<p align="center">
+  <sub>Built with tentacles.</sub>
+</p>

package/dist/adapters/claude-sdk.d.ts

@@ -0,0 +1,19 @@
+import type { AgentConfig, AgentActivity, Task } from "../core/types.js";
+import type { AgentAdapter, AgentHandle, SpawnContext } from "../core/adapter.js";
+/**
+ * Claude Agent SDK adapter.
+ * Uses @anthropic-ai/claude-agent-sdk to run Claude Code programmatically.
+ * Full streaming, hooks, activity tracking — no process spawning or stdout parsing.
+ */
+declare class ClaudeSDKAdapter implements AgentAdapter {
+    readonly name = "claude-sdk";
+    spawn(agent: AgentConfig, task: Task, cwd: string, ctx?: SpawnContext): AgentHandle;
+}
+/** Build the prompt string sent to the agent from task data. */
+export declare function buildPrompt(task: Task): string;
+/**
+ * PostToolUse hook callback — tracks file operations.
+ */
+export declare function trackToolUse(input: any, activity: AgentActivity): void;
+export { ClaudeSDKAdapter };
+//# sourceMappingURL=claude-sdk.d.ts.map

package/dist/adapters/claude-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-sdk.d.ts","sourceRoot":"","sources":["../../src/adapters/claude-sdk.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,IAAI,EAAc,MAAM,kBAAkB,CAAC;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAWlF;;;;GAIG;AACH,cAAM,gBAAiB,YAAW,YAAY;IAC5C,QAAQ,CAAC,IAAI,gBAAgB;IAE7B,KAAK,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,YAAY,GAAG,WAAW;CAiHpF;AAED,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAuB9C;AA8ID;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAetE;AAKD,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/adapters/claude-sdk.js

@@ -0,0 +1,288 @@
+import { query } from "@anthropic-ai/claude-agent-sdk";
+import { createActivity, registerAdapter } from "./registry.js";
+import { loadAgentSkills, buildSkillPrompt } from "../llm/skills.js";
+/** Truncate a string for logging. Works on any value — stringifies non-strings. */
+function truncateHook(value, max) {
+    if (value == null)
+        return undefined;
+    const s = typeof value === "string" ? value : JSON.stringify(value);
+    return s.length > max ? s.slice(0, max) + "…[truncated]" : s;
+}
+/**
+ * Claude Agent SDK adapter.
+ * Uses @anthropic-ai/claude-agent-sdk to run Claude Code programmatically.
+ * Full streaming, hooks, activity tracking — no process spawning or stdout parsing.
+ */
+class ClaudeSDKAdapter {
+    name = "claude-sdk";
+    spawn(agent, task, cwd, ctx) {
+        const activity = createActivity();
+        const abortController = new AbortController();
+        let alive = true;
+        const prompt = buildPrompt(task);
+        // Load Polpo skills for this agent
+        const polpoSkills = ctx?.polpoDir
+            ? loadAgentSkills(cwd, ctx.polpoDir, agent.name, agent.skills)
+            : [];
+        // Build allowedTools — ensure "Skill" is included when agent has skills
+        // (Claude's native Skill tool is still useful for runtime skill invocation)
+        let allowedTools = agent.allowedTools;
+        if (agent.skills?.length) {
+            const tools = new Set(allowedTools ?? []);
+            tools.add("Skill");
+            allowedTools = [...tools];
+        }
+        const options = {
+            cwd,
+            abortController,
+            permissionMode: "bypassPermissions",
+            allowDangerouslySkipPermissions: true,
+            persistSession: true,
+            model: agent.model,
+            maxTurns: agent.maxTurns ?? 150,
+            allowedTools,
+            disallowedTools: ["Task", "AskUserQuestion"],
+            hooks: {
+                PostToolUse: [{
+                        hooks: [async (rawInput) => {
+                                const input = rawInput;
+                                trackToolUse(input, activity);
+                                // Capture sessionId from hook input
+                                if (input?.session_id && !activity.sessionId) {
+                                    activity.sessionId = input.session_id;
+                                }
+                                // Persist tool result to transcript
+                                if (handle.onTranscript && input?.tool_name) {
+                                    handle.onTranscript({
+                                        type: "post_tool_use",
+                                        tool: input.tool_name,
+                                        file: input.tool_input?.file_path ?? input.tool_input?.path,
+                                        output: truncateHook(input.tool_output, 2000),
+                                    });
+                                }
+                                return {};
+                            }],
+                    }],
+            },
+        };
+        // Build system prompt: user-defined + Polpo skill content
+        const systemParts = [];
+        if (agent.systemPrompt)
+            systemParts.push(agent.systemPrompt);
+        // Inject loaded skill content directly into the prompt
+        const skillBlock = buildSkillPrompt(polpoSkills);
+        if (skillBlock) {
+            systemParts.push(skillBlock);
+        }
+        // If agent has claude-native skill names (from config) that weren't loaded
+        // as Polpo skills, keep the directive for Claude's Skill tool
+        if (agent.skills?.length) {
+            const loadedNames = new Set(polpoSkills.map(s => s.name));
+            const unloaded = agent.skills.filter(s => !loadedNames.has(s));
+            if (unloaded.length > 0) {
+                systemParts.push(`\nYou also have access to these skills via the Skill tool:\n` +
+                    unloaded.map(s => `- ${s}`).join("\n"));
+            }
+        }
+        if (systemParts.length > 0) {
+            options.systemPrompt = {
+                type: "preset",
+                preset: "claude_code",
+                append: systemParts.join("\n\n"),
+            };
+        }
+        // Add MCP servers if configured
+        if (agent.mcpServers) {
+            options.mcpServers = agent.mcpServers;
+        }
+        const handle = {
+            agentName: agent.name,
+            taskId: task.id,
+            startedAt: new Date().toISOString(),
+            pid: 0,
+            activity,
+            done: null, // set below
+            isAlive: () => alive,
+            kill: () => {
+                abortController.abort();
+                alive = false;
+            },
+        };
+        handle.done = runQuery(prompt, options, activity, handle, () => {
+            alive = false;
+            // Copy sessionId to handle for persistence
+            if (activity.sessionId)
+                handle.sessionId = activity.sessionId;
+        });
+        return handle;
+    }
+}
+/** Build the prompt string sent to the agent from task data. */
+export function buildPrompt(task) {
+    const parts = [`Task: ${task.title}`, ``, task.description];
+    if (task.expectations.length > 0) {
+        parts.push(``, `Acceptance criteria:`);
+        for (const exp of task.expectations) {
+            if (exp.type === "test")
+                parts.push(`- Tests must pass: ${exp.command}`);
+            if (exp.type === "file_exists")
+                parts.push(`- Files must exist: ${exp.paths?.join(", ")}`);
+            if (exp.type === "script")
+                parts.push(`- Script must pass: ${exp.command}`);
+            if (exp.type === "llm_review")
+                parts.push(`- Code review criteria: ${exp.criteria}`);
+        }
+    }
+    parts.push(``, `IMPORTANT — Orchestration contract:`, `- You are being orchestrated by a supervisor. Complete the task autonomously and EXIT.`, `- Do NOT ask clarifying questions. Make reasonable decisions and proceed.`, `- You MUST terminate after completing your work. Never block indefinitely.`, `- If you start a server, dev watcher, or any long-running process, run it DETACHED (background)`, `  and exit immediately. Do NOT wait for it, tail its logs, or keep your session alive.`, `- Example: use \`nohup cmd &\` or spawn detached. Never \`npm start\` in foreground.`, `- Your session has a timeout. If you hang, you will be killed and the task will fail.`);
+    return parts.join("\n");
+}
+/**
+ * Run the Claude Agent SDK query and collect the result.
+ * Streams all messages, tracks activity, persists transcript, and produces a TaskResult.
+ */
+async function runQuery(prompt, options, activity, handle, onFinish) {
+    const start = Date.now();
+    let resultText = "";
+    let errorOccurred = false;
+    let errorMessage = "";
+    try {
+        const q = query({ prompt, options });
+        for await (const message of q) {
+            activity.lastUpdate = new Date().toISOString();
+            processMessage(message, activity);
+            // Persist transcript entry
+            emitTranscript(handle, message);
+            // Capture final result
+            if (message.type === "result") {
+                const result = message;
+                if (result.subtype === "success" && result.result) {
+                    resultText = result.result;
+                }
+                else if (result.subtype !== "success") {
+                    errorOccurred = true;
+                    errorMessage = result.errors?.join("; ") ?? result.subtype;
+                }
+            }
+        }
+    }
+    catch (err) {
+        errorOccurred = true;
+        errorMessage = err instanceof Error ? err.message : String(err);
+    }
+    finally {
+        onFinish();
+    }
+    return {
+        exitCode: errorOccurred ? 1 : 0,
+        stdout: resultText,
+        stderr: errorMessage,
+        duration: Date.now() - start,
+    };
+}
+/**
+ * Emit a transcript entry for persistence.
+ * Extracts meaningful data from SDK messages — text, tool_use, tool_result.
+ */
+function emitTranscript(handle, message) {
+    if (!handle.onTranscript)
+        return;
+    if (message.type === "assistant" && message.message) {
+        const content = message.message.content;
+        if (Array.isArray(content)) {
+            for (const block of content) {
+                if (block.type === "text") {
+                    handle.onTranscript({ type: "assistant", text: block.text });
+                }
+                if (block.type === "tool_use") {
+                    handle.onTranscript({
+                        type: "tool_use",
+                        tool: block.name,
+                        toolId: block.id,
+                        input: block.input,
+                    });
+                }
+            }
+        }
+    }
+    // tool_result comes through as a raw message type not in the SDK union
+    const msgType = message.type;
+    if (msgType === "tool_result") {
+        const msg = message;
+        handle.onTranscript({
+            type: "tool_result",
+            toolId: msg.tool_use_id,
+            content: truncate(typeof msg.content === "string" ? msg.content : JSON.stringify(msg.content), 2000),
+        });
+    }
+    if (message.type === "result") {
+        const result = message;
+        handle.onTranscript({
+            type: "result",
+            subtype: result.subtype,
+            result: truncate(result.result, 1000),
+            errors: result.errors,
+        });
+    }
+}
+function truncate(s, max) {
+    if (!s)
+        return s;
+    return s.length > max ? s.slice(0, max) + "…[truncated]" : s;
+}
+/**
+ * Process an SDK message and update activity tracking.
+ */
+function processMessage(message, activity) {
+    // Capture sessionId from any message that has it
+    const msg = message;
+    if (msg.session_id && !activity.sessionId) {
+        activity.sessionId = msg.session_id;
+    }
+    if (msg.sessionId && !activity.sessionId) {
+        activity.sessionId = msg.sessionId;
+    }
+    // Assistant messages — extract text summary
+    if (message.type === "assistant" && message.message) {
+        const content = message.message.content;
+        if (Array.isArray(content)) {
+            for (const block of content) {
+                if (block.type === "text") {
+                    activity.summary = block.text.slice(0, 200);
+                }
+                if (block.type === "tool_use") {
+                    activity.toolCalls++;
+                    activity.lastTool = block.name;
+                }
+            }
+        }
+    }
+    // Tool progress
+    if (message.type === "tool_progress") {
+        activity.lastTool = message.tool_name;
+    }
+}
+/**
+ * PostToolUse hook callback — tracks file operations.
+ */
+export function trackToolUse(input, activity) {
+    const toolName = input?.tool_name;
+    const toolInput = input?.tool_input;
+    if (!toolName || !toolInput)
+        return;
+    const filePath = (toolInput.file_path ?? toolInput.path ?? toolInput.filePath);
+    if (!filePath)
+        return;
+    if (toolName === "Write") {
+        if (!activity.filesCreated.includes(filePath))
+            activity.filesCreated.push(filePath);
+    }
+    else if (toolName === "Edit") {
+        if (!activity.filesEdited.includes(filePath))
+            activity.filesEdited.push(filePath);
+    }
+    activity.lastFile = filePath;
+}
+// Register this adapter
+registerAdapter("claude-sdk", () => new ClaudeSDKAdapter());
+export { ClaudeSDKAdapter };
+//# sourceMappingURL=claude-sdk.js.map

package/dist/adapters/claude-sdk.js.map

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

package/dist/adapters/engine.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Polpo Engine — the built-in agentic runtime.
+ *
+ * Uses @mariozechner/pi-agent-core Agent class for the agentic loop,
+ * with pi-ai for multi-provider LLM abstraction.
+ * Works with any LLM provider (Anthropic, OpenAI, Google, Groq, etc.)
+ */
+import type { AgentConfig, AgentActivity, Task } from "../core/types.js";
+import type { AgentHandle, SpawnContext } from "../core/adapter.js";
+/** Create a fresh AgentActivity object */
+export declare function createActivity(): AgentActivity;
+/**
+ * Build the system prompt for the agent, including loaded skills.
+ */
+export declare function buildSystemPrompt(agent: AgentConfig, cwd: string, polpoDir?: string, outputDir?: string, allowedPaths?: string[]): string;
+/**
+ * Spawn an agent using Polpo's built-in engine (Pi Agent).
+ *
+ * This is the default execution path — used when no adapter is specified
+ * on an agent config.
+ */
+export declare function spawnEngine(agentConfig: AgentConfig, task: Task, cwd: string, ctx?: SpawnContext): AgentHandle;
+//# sourceMappingURL=engine.d.ts.map

package/dist/adapters/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/adapters/engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,IAAI,EAAwC,MAAM,kBAAkB,CAAC;AAC/G,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGpE,0CAA0C;AAC1C,wBAAgB,cAAc,IAAI,aAAa,CAQ9C;AA8KD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CA6GzI;AA0DD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,YAAY,GAAG,WAAW,CAyQ9G"}