@polpo-ai/core 0.1.0

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/dist/adapter.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Agent adapter type definitions.
+ * Pure interfaces — no runtime dependencies.
+ *
+ * SpawnContext uses generic types for vault/whatsapp to avoid
+ * coupling @polpo-ai/core to specific runtime implementations.
+ */
+import type { AgentActivity, TaskResult, TaskOutcome, ReasoningLevel } from "./types.js";
+/**
+ * Handle returned by the engine after spawning an agent.
+ * The orchestrator uses this to monitor and control the agent.
+ */
+export interface AgentHandle {
+    /** Agent name from config */
+    agentName: string;
+    /** Task ID this handle is working on */
+    taskId: string;
+    /** When the agent was started */
+    startedAt: string;
+    /** Process ID (0 when running in-process) */
+    pid: number;
+    /** Session ID — for reading conversation transcripts */
+    sessionId?: string;
+    /** Live activity data — updated in place by the engine */
+    activity: AgentActivity;
+    /** Resolves when the agent finishes (success or failure) */
+    done: Promise<TaskResult>;
+    /** Check if the agent is still running */
+    isAlive(): boolean;
+    /** Kill the agent process */
+    kill(): void;
+    /**
+     * Transcript callback — set by the runner to persist every agent message.
+     * The engine calls this for each message/event (assistant text, tool use, tool result, etc.)
+     */
+    onTranscript?: (entry: Record<string, unknown>) => void;
+    /**
+     * Auto-collected outcomes from tool executions.
+     * Populated by the engine when tools produce files, media, or other artifacts.
+     * The runner reads this after completion and stores them on the run record.
+     */
+    outcomes?: TaskOutcome[];
+}
+/** Extra context passed to the engine at spawn time. */
+export interface SpawnContext {
+    /** Absolute path to the .polpo directory. Used for skill loading, logs, etc. */
+    polpoDir: string;
+    /** Per-task output directory (.polpo/output/<taskId>/). Agents write deliverables here. */
+    outputDir?: string;
+    /** Email domain allowlist — restricts email_send tool to these domains. */
+    emailAllowedDomains?: string[];
+    /** Global reasoning level from settings — used as fallback when agent doesn't specify one. */
+    reasoning?: ReasoningLevel;
+    /** Encrypted vault store — runtime-specific, provided by the shell layer. */
+    vaultStore?: unknown;
+    /** WhatsApp message store — runtime-specific, provided by the shell layer. */
+    whatsappStore?: unknown;
+    /** WhatsApp send function — runtime-specific, provided by the shell layer. */
+    whatsappSendMessage?: (jid: string, text: string) => Promise<string | undefined>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEzF;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,QAAQ,EAAE,aAAa,CAAC;IACxB,4DAA4D;IAC5D,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1B,0CAA0C;IAC1C,OAAO,IAAI,OAAO,CAAC;IACnB,6BAA6B;IAC7B,IAAI,IAAI,IAAI,CAAC;IACb;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACxD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB,2FAA2F;IAC3F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,8FAA8F;IAC9F,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,6EAA6E;IAC7E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,8EAA8E;IAC9E,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAClF"}

package/dist/adapter.js

@@ -0,0 +1,9 @@
+/**
+ * Agent adapter type definitions.
+ * Pure interfaces — no runtime dependencies.
+ *
+ * SpawnContext uses generic types for vault/whatsapp to avoid
+ * coupling @polpo-ai/core to specific runtime implementations.
+ */
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/agent-manager.d.ts

@@ -0,0 +1,36 @@
+import type { OrchestratorContext } from "./orchestrator-context.js";
+import type { AgentConfig, Team } from "./types.js";
+/**
+ * Manages multi-team agent topology: CRUD operations on teams and agents,
+ * volatile (mission-tied) agents, and config persistence.
+ */
+export declare class AgentManager {
+    private ctx;
+    constructor(ctx: OrchestratorContext);
+    /**
+     * Persist the current teams to polpo.json, excluding volatile agents.
+     * Merges into the existing file config to preserve providers/settings
+     * that may have been edited outside the runtime.
+     */
+    private persistConfig;
+    /** Returns true if a team had ONLY volatile agents (should not be persisted). */
+    private isVolatileOnlyTeam;
+    getTeams(): Team[];
+    getTeam(name?: string): Team | undefined;
+    /** Get the default (first) team, creating one if none exist. */
+    getDefaultTeam(): Team;
+    addTeam(team: Team): Promise<void>;
+    removeTeam(name: string): Promise<boolean>;
+    renameTeam(oldName: string, newName: string): Promise<void>;
+    /** Get ALL agents across all teams (flattened). */
+    getAgents(): AgentConfig[];
+    /** Find an agent by name across all teams. */
+    findAgent(name: string): AgentConfig | undefined;
+    /** Find which team an agent belongs to. */
+    findAgentTeam(name: string): Team | undefined;
+    addAgent(agent: AgentConfig, teamName?: string): Promise<void>;
+    removeAgent(name: string): Promise<boolean>;
+    addVolatileAgent(agent: AgentConfig, group: string): Promise<void>;
+    cleanupVolatileAgents(group: string): Promise<number>;
+}
+//# sourceMappingURL=agent-manager.d.ts.map

package/dist/agent-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-manager.d.ts","sourceRoot":"","sources":["../src/agent-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGpD;;;GAGG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,mBAAmB;IAE5C;;;;OAIG;YACW,aAAa;IAc3B,iFAAiF;IACjF,OAAO,CAAC,kBAAkB;IAQ1B,QAAQ,IAAI,IAAI,EAAE;IAIlB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAMxC,gEAAgE;IAChE,cAAc,IAAI,IAAI;IAShB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAUlC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAc1C,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAejE,mDAAmD;IACnD,SAAS,IAAI,WAAW,EAAE;IAI1B,8CAA8C;IAC9C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIhD,2CAA2C;IAC3C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIvC,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB9D,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB3C,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAclE,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAc5D"}

package/dist/agent-manager.js

@@ -0,0 +1,176 @@
+import { getAllAgents, findAgent, findAgentTeam } from "./types.js";
+/**
+ * Manages multi-team agent topology: CRUD operations on teams and agents,
+ * volatile (mission-tied) agents, and config persistence.
+ */
+export class AgentManager {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    /**
+     * Persist the current teams to polpo.json, excluding volatile agents.
+     * Merges into the existing file config to preserve providers/settings
+     * that may have been edited outside the runtime.
+     */
+    async persistConfig() {
+        if (!this.ctx.loadConfig || !this.ctx.saveConfig)
+            return;
+        const existing = this.ctx.loadConfig();
+        if (!existing)
+            return; // no polpo.json to update (e.g. headless / test mode)
+        // Strip volatile agents from each team; drop empty teams that only had volatile agents
+        existing.teams = this.ctx.config.teams.map(t => ({
+            ...t,
+            agents: t.agents.filter(a => !a.volatile),
+        })).filter(t => t.agents.length > 0 || !this.isVolatileOnlyTeam(t.name));
+        this.ctx.saveConfig(existing);
+    }
+    /** Returns true if a team had ONLY volatile agents (should not be persisted). */
+    isVolatileOnlyTeam(teamName) {
+        const team = this.ctx.config.teams.find(t => t.name === teamName);
+        if (!team)
+            return false;
+        return team.agents.length > 0 && team.agents.every(a => a.volatile);
+    }
+    // ── Team-level operations ──
+    getTeams() {
+        return this.ctx.config?.teams ?? [];
+    }
+    getTeam(name) {
+        if (!this.ctx.config)
+            return undefined;
+        if (!name)
+            return this.ctx.config.teams[0];
+        return this.ctx.config.teams.find(t => t.name === name);
+    }
+    /** Get the default (first) team, creating one if none exist. */
+    getDefaultTeam() {
+        if (!this.ctx.config)
+            return { name: "default", agents: [] };
+        if (this.ctx.config.teams.length === 0) {
+            const team = { name: "default", agents: [] };
+            this.ctx.config.teams.push(team);
+        }
+        return this.ctx.config.teams[0];
+    }
+    async addTeam(team) {
+        if (!this.ctx.config)
+            throw new Error("Orchestrator not initialized");
+        const existing = this.ctx.config.teams.find(t => t.name === team.name);
+        if (existing)
+            throw new Error(`Team "${team.name}" already exists`);
+        this.ctx.config.teams.push(team);
+        await this.ctx.registry.setState({ teams: this.ctx.config.teams });
+        await this.persistConfig();
+        this.ctx.emitter.emit("log", { level: "info", message: `Team added: ${team.name}` });
+    }
+    async removeTeam(name) {
+        if (!this.ctx.config)
+            throw new Error("Orchestrator not initialized");
+        const idx = this.ctx.config.teams.findIndex(t => t.name === name);
+        if (idx < 0)
+            return false;
+        if (this.ctx.config.teams.length === 1) {
+            throw new Error("Cannot remove the last team");
+        }
+        this.ctx.config.teams.splice(idx, 1);
+        await this.ctx.registry.setState({ teams: this.ctx.config.teams });
+        await this.persistConfig();
+        this.ctx.emitter.emit("log", { level: "info", message: `Team removed: ${name}` });
+        return true;
+    }
+    async renameTeam(oldName, newName) {
+        if (!this.ctx.config)
+            throw new Error("Orchestrator not initialized");
+        const team = this.ctx.config.teams.find(t => t.name === oldName);
+        if (!team)
+            throw new Error(`Team "${oldName}" not found`);
+        if (this.ctx.config.teams.some(t => t.name === newName)) {
+            throw new Error(`Team "${newName}" already exists`);
+        }
+        team.name = newName;
+        await this.ctx.registry.setState({ teams: this.ctx.config.teams });
+        await this.persistConfig();
+        this.ctx.emitter.emit("log", { level: "info", message: `Team renamed: "${oldName}" → "${newName}"` });
+    }
+    // ── Agent-level operations ──
+    /** Get ALL agents across all teams (flattened). */
+    getAgents() {
+        return getAllAgents(this.ctx.config?.teams ?? []);
+    }
+    /** Find an agent by name across all teams. */
+    findAgent(name) {
+        return findAgent(this.ctx.config?.teams ?? [], name);
+    }
+    /** Find which team an agent belongs to. */
+    findAgentTeam(name) {
+        return findAgentTeam(this.ctx.config?.teams ?? [], name);
+    }
+    async addAgent(agent, teamName) {
+        if (!this.ctx.config)
+            throw new Error("Orchestrator not initialized");
+        // Globally unique names across all teams
+        const existing = this.findAgent(agent.name);
+        if (existing)
+            throw new Error(`Agent "${agent.name}" already exists`);
+        const team = teamName
+            ? this.ctx.config.teams.find(t => t.name === teamName)
+            : this.getDefaultTeam();
+        if (!team)
+            throw new Error(`Team "${teamName}" not found`);
+        if (!agent.createdAt)
+            agent.createdAt = new Date().toISOString();
+        team.agents.push(agent);
+        await this.ctx.registry.setState({ teams: this.ctx.config.teams });
+        if (!agent.volatile)
+            await this.persistConfig();
+        this.ctx.emitter.emit("log", { level: "info", message: `Agent added: ${agent.name} (team: ${team.name})` });
+    }
+    async removeAgent(name) {
+        if (!this.ctx.config)
+            throw new Error("Orchestrator not initialized");
+        for (const team of this.ctx.config.teams) {
+            const idx = team.agents.findIndex(a => a.name === name);
+            if (idx >= 0) {
+                const wasVolatile = team.agents[idx].volatile;
+                team.agents.splice(idx, 1);
+                await this.ctx.registry.setState({ teams: this.ctx.config.teams });
+                if (!wasVolatile)
+                    await this.persistConfig();
+                this.ctx.emitter.emit("log", { level: "info", message: `Agent removed: ${name} (team: ${team.name})` });
+                return true;
+            }
+        }
+        return false;
+    }
+    async addVolatileAgent(agent, group) {
+        if (!this.ctx.config)
+            throw new Error("Orchestrator not initialized");
+        const existing = this.findAgent(agent.name);
+        if (existing)
+            return;
+        // Volatile agents go to the default (first) team
+        const team = this.getDefaultTeam();
+        const volatileAgent = { ...agent, volatile: true, missionGroup: group, createdAt: agent.createdAt ?? new Date().toISOString() };
+        team.agents.push(volatileAgent);
+        await this.ctx.registry.setState({ teams: this.ctx.config.teams });
+        this.ctx.emitter.emit("log", { level: "info", message: `Volatile agent added: ${agent.name} for ${group}` });
+    }
+    async cleanupVolatileAgents(group) {
+        if (!this.ctx.config)
+            return 0;
+        let removed = 0;
+        for (const team of this.ctx.config.teams) {
+            const before = team.agents.length;
+            team.agents = team.agents.filter(a => !(a.volatile && a.missionGroup === group));
+            removed += before - team.agents.length;
+        }
+        if (removed > 0) {
+            await this.ctx.registry.setState({ teams: this.ctx.config.teams });
+            this.ctx.emitter.emit("log", { level: "debug", message: `Cleaned up ${removed} volatile agent(s) from ${group}` });
+        }
+        return removed;
+    }
+}
+//# sourceMappingURL=agent-manager.js.map

package/dist/agent-manager.js.map

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

package/dist/approval-manager.d.ts

@@ -0,0 +1,49 @@
+import type { OrchestratorContext } from "./orchestrator-context.js";
+import type { ApprovalStore } from "./approval-store.js";
+import type { ApprovalRequest, ApprovalStatus } from "./types.js";
+import type { NotificationRouterPort } from "./notification-router-port.js";
+/**
+ * Manages approval gates — both automatic (condition-based) and human (blocking).
+ *
+ * Automatic gates evaluate a condition against the hook payload and either
+ * allow or block the operation immediately.
+ *
+ * Human gates pause the operation (task enters "awaiting_approval"),
+ * emit a notification event, and wait for external resolution (API call,
+ * TUI action, or timeout).
+ */
+export declare class ApprovalManager {
+    private ctx;
+    private store;
+    private timers;
+    private notificationRouter?;
+    private registeredGateRules;
+    constructor(ctx: OrchestratorContext, store: ApprovalStore);
+    /** Wire the notification router so per-gate notifyChannels work. */
+    setNotificationRouter(router: NotificationRouterPort): void;
+    /** Initialize: register hooks for all configured approval gates. */
+    init(): Promise<void>;
+    private ensureGateNotificationRules;
+    private registerGate;
+    private createRequest;
+    approve(requestId: string, resolvedBy?: string, note?: string): Promise<ApprovalRequest | null>;
+    reject(requestId: string, feedback: string, resolvedBy?: string): Promise<ApprovalRequest | null>;
+    canReject(requestId: string): Promise<{
+        allowed: boolean;
+        rejectionCount: number;
+        maxRejections: number;
+    }>;
+    private resolve;
+    private resolveTimeout;
+    getPending(): Promise<ApprovalRequest[]>;
+    getAll(status?: ApprovalStatus): Promise<ApprovalRequest[]>;
+    getRequest(id: string): Promise<ApprovalRequest | undefined>;
+    private startTimer;
+    private clearTimer;
+    private evaluateCondition;
+    private isRecord;
+    private extractTaskId;
+    private extractMissionId;
+    dispose(): void;
+}
+//# sourceMappingURL=approval-manager.d.ts.map

package/dist/approval-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-manager.d.ts","sourceRoot":"","sources":["../src/approval-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAgB,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEhF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAE5E;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAMxB,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,KAAK;IANf,OAAO,CAAC,MAAM,CAAoD;IAClE,OAAO,CAAC,kBAAkB,CAAC,CAAyB;IACpD,OAAO,CAAC,mBAAmB,CAAqB;gBAGtC,GAAG,EAAE,mBAAmB,EACxB,KAAK,EAAE,aAAa;IAG9B,oEAAoE;IACpE,qBAAqB,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI;IAW3D,oEAAoE;IAC9D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB3B,OAAO,CAAC,2BAA2B;IAoCnC,OAAO,CAAC,YAAY;IAiDpB,OAAO,CAAC,aAAa;IAgBf,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAI/F,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IA8CjG,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;YAclG,OAAO;YAsCP,cAAc;IAyBtB,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAIxC,MAAM,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAI3D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAMlE,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,gBAAgB;IAUxB,OAAO,IAAI,IAAI;CAOhB"}