@polpo-ai/node 0.11.1

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2026-present Lumea Labs
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/dist/adapters/engine.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Task-spawn shared helpers — prompt building, spawn preparation, tool
+ * building, and outcome collection for the task runtime.
+ *
+ * The agentic loop itself lives in loop-engine.ts (spawnLoopEngine, driven
+ * by @polpo-ai/core's LoopRunner/PipelineExecutor). The legacy manual
+ * streamText loop that used to live here was removed once spawnLoopEngine
+ * reached behavioral parity (see engine-behavior.test.ts).
+ */
+import type { AgentConfig, AgentActivity, Task, TaskOutcome } from "@polpo-ai/core/types";
+import type { SpawnContext } from "../core/adapter.js";
+/** Create a fresh AgentActivity object */
+export declare function createActivity(): AgentActivity;
+import { resolveModel } from "../llm/pi-client.js";
+import type { FileSystem } from "@polpo-ai/core/filesystem";
+import type { Shell } from "@polpo-ai/core/shell";
+import type { PolpoTool } from "@polpo-ai/core";
+/**
+ * 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;
+/**
+ * Build the user prompt from task data.
+ */
+export declare function buildPrompt(task: Task): string;
+export interface SpawnPrep {
+    model: ReturnType<typeof resolveModel>;
+    polpoDir: string;
+    fs: FileSystem;
+    shell: Shell;
+    outputDir?: string;
+    effectiveAllowedPaths?: string[];
+    systemPrompt: string;
+    providerOptions?: Record<string, Record<string, any>>;
+    hasExtendedTools: boolean;
+    browserProfileDir: string;
+    maxTurns: number;
+}
+export declare function prepareSpawn(agentConfig: AgentConfig, cwd: string, ctx?: SpawnContext): SpawnPrep;
+/**
+ * Resolve the agent vault and build the full PolpoTool set (core tools plus
+ * extended categories when requested via allowedTools). Async because vault
+ * resolution hits the store.
+ */
+export declare function buildAgentTools(agentConfig: AgentConfig, cwd: string, prep: SpawnPrep, ctx?: SpawnContext): Promise<PolpoTool[]>;
+/**
+ * Create a TaskOutcome from a `register_outcome` tool call.
+ * Returns undefined for any other tool — outcome registration is explicit only.
+ */
+export declare function collectOutcome(toolName: string, details: Record<string, unknown>): TaskOutcome | undefined;
+//# 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;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAe,MAAM,sBAAsB,CAAC;AACvG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,0CAA0C;AAC1C,wBAAgB,cAAc,IAAI,aAAa,CAQ9C;AAED,OAAO,EAAE,YAAY,EAAwD,MAAM,qBAAqB,CAAC;AAIzG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAGlD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AA+LhD;;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,CAiCzI;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAmD9C;AAUD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,UAAU,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IACtD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,YAAY,GAAG,SAAS,CAoFjG;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,WAAW,EACxB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,SAAS,EACf,GAAG,CAAC,EAAE,YAAY,GACjB,OAAO,CAAC,SAAS,EAAE,CAAC,CA+BtB;AA6BD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,GAAG,SAAS,CAsB1G"}

package/dist/adapters/engine.js

@@ -0,0 +1,316 @@
+/**
+ * Task-spawn shared helpers — prompt building, spawn preparation, tool
+ * building, and outcome collection for the task runtime.
+ *
+ * The agentic loop itself lives in loop-engine.ts (spawnLoopEngine, driven
+ * by @polpo-ai/core's LoopRunner/PipelineExecutor). The legacy manual
+ * streamText loop that used to live here was removed once spawnLoopEngine
+ * reached behavioral parity (see engine-behavior.test.ts).
+ */
+import { resolveAgentVault } from "../vault/index.js";
+import { buildAgentSystemPrompt } from "@polpo-ai/core";
+/** Create a fresh AgentActivity object */
+export function createActivity() {
+    return {
+        filesCreated: [],
+        filesEdited: [],
+        toolCalls: 0,
+        totalTokens: 0,
+        lastUpdate: new Date().toISOString(),
+    };
+}
+import { join, resolve, sep } from "node:path";
+import { resolveModel, enforceModelAllowlist, mapReasoningToProviderOptions } from "../llm/pi-client.js";
+import { createSystemTools, createAllTools } from "@polpo-ai/tools";
+import { NodeFileSystem } from "./node-filesystem.js";
+import { NodeShell } from "./node-shell.js";
+import { loadAgentSkills } from "../llm/skills.js";
+import { nanoid } from "nanoid";
+function resolvePromptAllowedPaths(cwd, allowedPaths) {
+    const configured = Array.isArray(allowedPaths)
+        ? allowedPaths.filter((path) => typeof path === "string" && path.trim().length > 0)
+        : [];
+    const paths = configured.length > 0 ? configured : [cwd];
+    return [...new Set(paths.map((path) => resolve(cwd, path)))];
+}
+function buildFilesystemWorkspaceSection(cwd, allowedPaths) {
+    const resolvedCwd = resolve(cwd);
+    const resolvedAllowedPaths = resolvePromptAllowedPaths(resolvedCwd, allowedPaths);
+    return [
+        "## Filesystem Workspace",
+        "",
+        `Your working directory is \`${resolvedCwd}\`.`,
+        "",
+        "File tools (`read`, `write`, `edit`, `ls`, `glob`, `grep`) can only access these directories:",
+        ...resolvedAllowedPaths.map((path) => `- \`${path}\``),
+        "",
+        "Use relative paths or paths inside the directories above. Do not create project files under `/tmp`, `/home`, or other locations unless that exact directory is listed above.",
+        "Bash commands start in the working directory, but files created outside the allowed directories may not be readable or editable by later file tools.",
+        "If a requested path is outside the allowed directories, adapt it to the working directory or explain that `allowedPaths` must be changed first.",
+    ].join("\n");
+}
+/**
+ * Build an "## Available Tools" section for the agent's system prompt.
+ *
+ * Lists every tool the agent has access to, grouped by category, so the agent
+ * knows its full capabilities upfront. Without this, the agent only discovers
+ * tools through the LLM tool-calling protocol and may resort to shell commands,
+ * npm installs, or manual workarounds for capabilities it already has.
+ *
+ * Mirrors the orchestrator-side `describeAgentCapabilities()` in prompts.ts
+ * but is more detailed — written for the agent itself, not the orchestrator.
+ */
+function describeToolsForAgent(agent) {
+    const lines = ["## Available Tools", ""];
+    // --- Core tools (always present) ---
+    lines.push("**Core (always available):**", "- `read` — read file contents (supports offset/limit for large files)", "- `write` — create or overwrite files", "- `edit` — surgical string replacement in files (preferred over rewriting entire files)", "- `bash` — execute shell commands (30s default timeout; pass explicit timeout for long commands)", "- `glob` — find files by pattern (e.g. `**/*.ts`)", "- `grep` — search file contents by regex", "- `ls` — list directory contents", "- `http_fetch` — make HTTP requests (GET, POST, PUT, DELETE)", "- `http_download` — download files from URLs", "- `register_outcome` — declare task deliverables (files, URLs, text, data)", "- `vault_get` — retrieve stored credentials/secrets", "- `vault_list` — list available vault entries");
+    // --- Extended tools (only if configured in allowedTools) ---
+    const allowed = agent.allowedTools ?? [];
+    const hasPattern = (prefix) => allowed.some(t => t.toLowerCase().startsWith(prefix));
+    const extended = [];
+    if (hasPattern("browser_")) {
+        extended.push("", "**Browser (agent-browser):**", "- `browser_navigate` — open a URL", "- `browser_snapshot` — capture page accessibility snapshot", "- `browser_click` / `browser_fill` / `browser_select` — interact with page elements", "- `browser_eval` — run JavaScript in the page", "- `browser_screenshot` — take a screenshot", "- Plus: browser_scroll, browser_back, browser_forward, browser_wait, browser_tabs, browser_tab_new, browser_tab_close, browser_tab_switch, browser_pdf, browser_drag, browser_hover, browser_keypress", "Use browser tools instead of curl/wget for pages that require JavaScript rendering or authentication.");
+    }
+    if (hasPattern("email_")) {
+        extended.push("", "**Email:**", "- `email_send` — send an email (WARNING: irreversible side effect)", "- `email_draft` — create a draft without sending", "- `email_list` — list inbox messages", "- `email_read` — read a specific email (includes attachment metadata; set download_attachments=true to save all)", "- `email_download_attachment` — download a specific attachment by part number", "- `email_search` — search emails by sender, recipient, subject, date range, body, or answered status", "- `email_count` — count emails matching filters without downloading content (returns total and unread counts)", "- `email_verify` — verify SMTP connection and credentials", "ALWAYS use these tools for email operations. Never use bash/curl to send emails.");
+    }
+    if (hasPattern("image_")) {
+        extended.push("", "**Image:**", "- `image_generate` — generate images with AI (fal.ai FLUX)", "- `image_analyze` — analyze/describe images with vision models");
+    }
+    if (hasPattern("video_")) {
+        extended.push("", "**Video:**", "- `video_generate` — generate video with AI (fal.ai Wan 2.2)");
+    }
+    if (hasPattern("audio_")) {
+        extended.push("", "**Audio:**", "- `audio_transcribe` — speech-to-text (Whisper / Deepgram Nova)", "- `audio_speak` — text-to-speech (OpenAI / Deepgram / ElevenLabs / Edge)");
+    }
+    if (hasPattern("excel_")) {
+        extended.push("", "**Excel:**", "- `excel_read` — read spreadsheet data", "- `excel_write` — write/create spreadsheets", "- `excel_query` — query spreadsheet data with SQL-like syntax", "- `excel_info` — get spreadsheet metadata", "Use these instead of installing npm packages for spreadsheet operations.");
+    }
+    if (hasPattern("pdf_")) {
+        extended.push("", "**PDF:**", "- `pdf_read` — extract text from PDFs", "- `pdf_create` — create PDF documents", "- `pdf_merge` — merge multiple PDFs", "- `pdf_info` — get PDF metadata", "Use these instead of installing npm packages for PDF operations.");
+    }
+    if (hasPattern("docx_")) {
+        extended.push("", "**Word Documents:**", "- `docx_read` — read .docx file contents", "- `docx_create` — create .docx documents");
+    }
+    if (hasPattern("search_")) {
+        extended.push("", "**Web Search (Exa AI):**", "- `search_web` — search the web for information", "- `search_find_similar` — find pages similar to a given URL", "Use these for research instead of scraping or manual browsing.");
+    }
+    if (extended.length > 0) {
+        lines.push(...extended);
+    }
+    // --- Ink Hub tools (always available when polpoDir exists) ---
+    lines.push("", "**Ink Hub (package registry — always available):**", "- `ink_search` — search the Ink Hub for available packages (playbooks, agents, companies)", "- `ink_browse` — list packages currently installed in this project", "- `ink_add` — install packages from a GitHub source (e.g. 'lumea-labs/ink-registry')", "- `ink_remove` — remove an installed registry source and uninstall its packages", "- `ink_update` — update installed registries by pulling the latest from git", "Use ink tools to find and install reusable playbooks, agent configs, and company setups.", "The official registry is 'lumea-labs/ink-registry'.");
+    // --- Guidance ---
+    lines.push("", "**IMPORTANT:** ALWAYS prefer your available tools over shell commands, npm installs, or manual workarounds.", "For example: use `email_send` not `curl`; use `pdf_read` not `pip install PyPDF2`; use `excel_read` not `npm install xlsx`.", "If a task requires a capability you don't have listed above, use `bash` as a fallback.");
+    return lines.join("\n");
+}
+/**
+ * Build the system prompt for the agent, including loaded skills.
+ */
+export function buildSystemPrompt(agent, cwd, polpoDir, outputDir, allowedPaths) {
+    // Load skills (sync, Node.js filesystem)
+    const skills = polpoDir
+        ? loadAgentSkills(cwd, polpoDir, agent.name, agent.skills)
+        : [];
+    // Core prompt: identity, responsibilities, tone, personality, hierarchy, systemPrompt, skills
+    // Shared agent loop logic (lives in @polpo-ai/core).
+    const parts = [buildAgentSystemPrompt(agent, { skills })];
+    // Shell-specific sections below (tools, cwd, sandbox paths)
+    // Available tools — enumerate what the agent can use so it doesn't resort to
+    // shell scripts, npm installs, or manual workarounds for capabilities it already has.
+    const toolSection = describeToolsForAgent(agent);
+    if (toolSection)
+        parts.push("", toolSection);
+    // Working directory and sandbox boundaries — tell the agent exactly where it can operate.
+    parts.push("", buildFilesystemWorkspaceSection(cwd, allowedPaths));
+    // Output directory for task deliverables
+    if (outputDir) {
+        parts.push("", "## Output Directory", `Your task output directory is: ${outputDir}`, "Write all deliverable files (reports, images, data exports, etc.) to this directory.", "When you register an outcome with register_outcome, use paths inside this directory.", "This directory is pre-created and writable. Other tasks have separate output directories.");
+    }
+    return parts.join("\n");
+}
+/**
+ * Build the user prompt 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.`, `- Your session has a timeout. If you hang, you will be killed and the task will fail.`, ``, `CRITICAL — Bash tool rules:`, `- The bash tool has a default timeout of 30 seconds. Commands that exceed it are killed.`, `- For long commands (npm install, builds, etc.), pass an explicit timeout: {"command": "...", "timeout": 120000}`, `- NEVER run a server or long-lived process in the foreground. It will block forever and kill your session.`, `- To start a background server, ALWAYS use this exact pattern:`, `  {"command": "nohup python3 server.py > /tmp/server.log 2>&1 & echo \"PID=$!\"", "timeout": 5000}`, `  Then verify separately: {"command": "sleep 2 && curl -s --max-time 5 http://127.0.0.1:PORT/", "timeout": 10000}`, `- NEVER combine server start + verification in one command (e.g. "cmd & sleep 2 && lsof" WILL hang).`, `- NEVER use "lsof" or "netstat" to check if a server is running. Use "curl" instead.`, `- NEVER use "tail -f", "watch", or any command that runs forever.`, `- If a command times out, do NOT retry the same command. Analyze why it hung and fix the approach.`, ``, `CRITICAL — Outcome tracking:`, `When you produce artifacts (files, reports, data), the orchestrator attaches them to`, `task-done notifications (Telegram, Slack, etc.) and approval reviews.`, `Outcomes are NEVER auto-collected — you MUST explicitly register every deliverable.`, ``, `Use the register_outcome tool to declare artifacts as task outcomes:`, `  register_outcome({type: 'file', label: 'Sales Report', path: 'output/report.pdf'})`, `  register_outcome({type: 'media', label: 'Chart', path: 'charts/revenue.png'})`, `  register_outcome({type: 'url', label: 'Staging Deploy', url: 'https://staging.example.com'})`, `  register_outcome({type: 'text', label: 'Summary', text: 'Revenue increased 23%...'})`, `  register_outcome({type: 'json', label: 'Metrics', data: {revenue: 1234, growth: 0.23}})`, ``, `RULES:`, `  - ALWAYS call register_outcome for every artifact you produce — files, reports, screenshots,`, `    downloads, generated media, transcriptions, analysis results, URLs, data summaries`, `  - Producing a file (via write, pdf_create, bash, etc.) does NOT auto-register it as an outcome`, `  - Only register final deliverables — not intermediate/temporary files`, `  - If the task has expectedOutcomes defined, ensure you register matching outcomes`);
+    return parts.join("\n");
+}
+export function prepareSpawn(agentConfig, cwd, ctx) {
+    // Enforce model allowlist (throws if model not allowed)
+    if (agentConfig.model) {
+        enforceModelAllowlist(agentConfig.model);
+    }
+    // Resolve model
+    const model = resolveModel(agentConfig.model, { gateway: ctx?.gatewayConfig });
+    // polpoDir must always be provided via SpawnContext.
+    // Fallback to join(cwd, ".polpo") is WRONG when settings.workDir points to a
+    // subdirectory — cwd would be e.g. /project/packages/app while .polpo/ lives
+    // at /project/.polpo/.  Throw early to catch misconfiguration.
+    if (!ctx?.polpoDir) {
+        throw new Error("spawnEngine: ctx.polpoDir is required (cannot derive .polpo from cwd when settings.workDir is set)");
+    }
+    const polpoDir = ctx.polpoDir;
+    // Extract fs/shell from context — safety fallback to NodeFileSystem/NodeShell
+    // In practice the orchestrator (or runner subprocess) always provides them via SpawnContext.
+    const fs = ctx?.fs ?? new NodeFileSystem();
+    const shell = ctx?.shell ?? new NodeShell();
+    // Browser profile directory for agent-browser persistent state (cookies, auth, localStorage)
+    const browserProfileDir = join(polpoDir, "browser-profiles", agentConfig.browserProfile || agentConfig.name);
+    // Check if extended tools (browser, email, image, video, audio, excel, pdf, docx) are requested via allowedTools
+    // Note: vault tools are now core — always available, no need to check here.
+    const hasExtendedTools = agentConfig.allowedTools?.some(t => {
+        const lc = t.toLowerCase();
+        return lc.startsWith("browser_") || lc.startsWith("email_")
+            || lc.startsWith("image_") || lc.startsWith("video_") || lc.startsWith("audio_")
+            || lc.startsWith("excel_") || lc.startsWith("pdf_") || lc.startsWith("docx_")
+            || lc.startsWith("search_");
+    }) ?? false;
+    // Derive output directory from context (per-task output dir for deliverables)
+    const outputDir = ctx?.outputDir;
+    // Build effective allowed paths, preserving the resolveAllowedPaths default behavior.
+    //
+    // When allowedPaths is NOT configured (the common case), we leave it undefined so
+    // resolveAllowedPaths defaults to [cwd]. But outputDir (.polpo/output/<taskId>)
+    // may live outside cwd when settings.workDir points to a subdirectory, so we
+    // must add it explicitly in that case.
+    //
+    // When allowedPaths IS configured, we append outputDir so the agent can write
+    // deliverables regardless of its sandbox.
+    //
+    // BUG FIX: Previously, `agentConfig.allowedPaths ?? []` turned undefined into [],
+    // producing [outputDir] as the ONLY allowed path — locking the agent out of its
+    // own working directory.
+    let effectiveAllowedPaths;
+    if (agentConfig.allowedPaths) {
+        // Explicit sandbox — append outputDir so deliverables are always writable
+        effectiveAllowedPaths = [...agentConfig.allowedPaths, ...(outputDir ? [outputDir] : [])];
+    }
+    else if (outputDir && !outputDir.startsWith(cwd + sep) && outputDir !== cwd) {
+        // No explicit sandbox, but outputDir is outside cwd — add both
+        effectiveAllowedPaths = [cwd, outputDir];
+    }
+    else {
+        // No explicit sandbox, outputDir under cwd (or absent) — let resolveAllowedPaths default to [cwd]
+        effectiveAllowedPaths = undefined;
+    }
+    // Resolve reasoning level: agent config > global settings (via SpawnContext) > "off"
+    const thinkingLevel = agentConfig.reasoning ?? ctx?.reasoning ?? "off";
+    // Build the system prompt once for reuse in both the agent loop and context compaction
+    const systemPrompt = buildSystemPrompt(agentConfig, cwd, ctx?.polpoDir, outputDir, effectiveAllowedPaths);
+    // Track turns for maxTurns enforcement
+    const maxTurns = agentConfig.maxTurns ?? 150;
+    // Provider options for reasoning/thinking
+    // Cast needed: mapReasoningToProviderOptions returns Record<string, Record<string, unknown>>
+    // but AI SDK expects Record<string, JSONObject> (JSONValue values). The values are always
+    // JSON-serializable (numbers, strings, objects), so this cast is safe.
+    const providerOptions = mapReasoningToProviderOptions(model.provider, thinkingLevel, model.maxTokens);
+    return {
+        model, polpoDir, fs, shell, outputDir, effectiveAllowedPaths,
+        systemPrompt, providerOptions, hasExtendedTools, browserProfileDir, maxTurns,
+    };
+}
+/**
+ * Resolve the agent vault and build the full PolpoTool set (core tools plus
+ * extended categories when requested via allowedTools). Async because vault
+ * resolution hits the store.
+ */
+export async function buildAgentTools(agentConfig, cwd, prep, ctx) {
+    const vaultEntries = await ctx?.vaultStore?.getAllForAgent(agentConfig.name);
+    const vault = resolveAgentVault(vaultEntries);
+    let allPolpoTools = createSystemTools(cwd, agentConfig.allowedTools, prep.effectiveAllowedPaths, prep.outputDir, vault, prep.fs, prep.shell);
+    if (prep.hasExtendedTools) {
+        allPolpoTools = await createAllTools({
+            cwd,
+            allowedTools: agentConfig.allowedTools,
+            allowedPaths: prep.effectiveAllowedPaths,
+            browserSession: agentConfig.name,
+            browserProfileDir: prep.browserProfileDir,
+            vault,
+            emailAllowedDomains: agentConfig.emailAllowedDomains ?? ctx?.emailAllowedDomains,
+            outputDir: prep.outputDir,
+            fs: prep.fs,
+            shell: prep.shell,
+            memoryStore: ctx?.memoryStore,
+            agentName: agentConfig.name,
+            // Per-modality models from agent config. When undefined, the
+            // tool layer applies its own DEFAULT_*_MODEL.
+            imageModel: agentConfig.image_model,
+            videoModel: agentConfig.video_model,
+            visionModel: agentConfig.vision_model,
+            transcribeModel: agentConfig.transcribe_model,
+            ttsModel: agentConfig.tts_model,
+        });
+    }
+    return allPolpoTools;
+}
+// ─── Outcome Collection ────���────────────────────────
+//
+// Outcomes are ONLY created via the `register_outcome` tool.
+// The agent explicitly decides what artifacts are deliverables.
+// No auto-collection from other tools — producing files and
+// declaring outcomes are two separate responsibilities.
+/** MIME type inference from file extension. */
+const EXT_MIME = {
+    ".mp3": "audio/mpeg", ".wav": "audio/wav", ".ogg": "audio/ogg", ".flac": "audio/flac",
+    ".png": "image/png", ".jpg": "image/jpeg", ".jpeg": "image/jpeg", ".webp": "image/webp", ".gif": "image/gif",
+    ".pdf": "application/pdf",
+    ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    ".xls": "application/vnd.ms-excel",
+    ".csv": "text/csv",
+    ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    ".json": "application/json",
+    ".txt": "text/plain",
+    ".html": "text/html",
+    ".zip": "application/zip",
+};
+function guessMime(filePath) {
+    const ext = filePath.slice(filePath.lastIndexOf(".")).toLowerCase();
+    return EXT_MIME[ext];
+}
+/**
+ * Create a TaskOutcome from a `register_outcome` tool call.
+ * Returns undefined for any other tool — outcome registration is explicit only.
+ */
+export function collectOutcome(toolName, details) {
+    if (toolName !== "register_outcome" || !details.outcomeType || !details.outcomeLabel) {
+        return undefined;
+    }
+    const outcome = {
+        id: nanoid(),
+        type: details.outcomeType,
+        label: details.outcomeLabel,
+        producedBy: "register_outcome",
+        producedAt: new Date().toISOString(),
+    };
+    if (details.path) {
+        outcome.path = details.path;
+        outcome.mimeType = details.outcomeMimeType ?? guessMime(details.path);
+        if (details.outcomeSize !== undefined)
+            outcome.size = details.outcomeSize;
+    }
+    if (details.outcomeText)
+        outcome.text = details.outcomeText;
+    if (details.outcomeUrl)
+        outcome.url = details.outcomeUrl;
+    if (details.outcomeData !== undefined)
+        outcome.data = details.outcomeData;
+    if (details.outcomeTags)
+        outcome.tags = details.outcomeTags;
+    return outcome;
+}
+//# sourceMappingURL=engine.js.map

package/dist/adapters/engine.js.map

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

package/dist/adapters/index.d.ts

@@ -0,0 +1,2 @@
+export { spawnLoopEngine, spawnLoopEngine as spawnEngine } from "./loop-engine.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,eAAe,IAAI,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,4 @@
+// spawnEngine is a compatibility alias: the legacy manual loop was removed
+// after spawnLoopEngine reached behavioral parity (engine-behavior.test.ts).
+export { spawnLoopEngine, spawnLoopEngine as spawnEngine } from "./loop-engine.js";
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,6EAA6E;AAC7E,OAAO,EAAE,eAAe,EAAE,eAAe,IAAI,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/adapters/loop-engine.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Loop-engine — the task runtime driven by the core loop system.
+ *
+ * Same external contract as spawnEngine (AgentHandle in, TaskResult out),
+ * but the agentic loop is @polpo-ai/core's LoopRunner instead of a manual
+ * for-loop, and agents with configured loops get the full graph runtime:
+ *
+ * - No loop config on the agent  → one implicit "default" loop, behavior
+ *   identical to the legacy engine (proven by the parity suite).
+ * - defaultLoop/loops on the agent → the selected loop's overlays apply
+ *   (tools subset, systemPrompt, model, maxTurns), same merge semantics
+ *   as chat completions (buildLoopStepAgent).
+ * - assignedLoops + project loop graph (.polpo/loops/<name>.json) → the
+ *   PipelineExecutor drives the step graph: agent steps are independent
+ *   LLM sessions communicating through the context bag, tool steps run
+ *   deterministically without an LLM turn.
+ *
+ * Setup semantics (model resolution, sandbox paths, system prompt, tool
+ * building) are shared with the legacy engine via prepareSpawn/
+ * buildAgentTools so the two stay byte-identical during the migration.
+ *
+ * Known deliberate differences from the legacy engine:
+ * - In a turn with MULTIPLE tool calls, transcript order is
+ *   use,use,...,result,result (the model step completes before execution)
+ *   instead of use,result interleaved. Single-call turns are identical.
+ */
+import type { AgentConfig, Task } from "@polpo-ai/core/types";
+import type { AgentHandle, SpawnContext } from "../core/adapter.js";
+/**
+ * Spawn an agent on the loop runtime.
+ *
+ * Drop-in replacement for spawnEngine: same signature, same AgentHandle
+ * contract, same activity/transcript/outcome semantics.
+ */
+export declare function spawnLoopEngine(agentConfig: AgentConfig, task: Task, cwd: string, ctx?: SpawnContext): AgentHandle;
+//# sourceMappingURL=loop-engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loop-engine.d.ts","sourceRoot":"","sources":["../../src/adapters/loop-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAc,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AA+HpE;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,YAAY,GAAG,WAAW,CAyblH"}