@polpo-ai/node 0.11.1

package/dist/core/config.js

@@ -0,0 +1,272 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { getPolpoDir } from "./constants.js";
+const DEFAULT_SETTINGS = {
+    maxRetries: 3,
+    workDir: ".",
+    logLevel: "normal",
+};
+// --- .polpo/polpo.json (persistent project config) ---
+export function loadPolpoConfig(polpoDir) {
+    const filePath = join(polpoDir, "polpo.json");
+    if (!existsSync(filePath))
+        return undefined;
+    try {
+        const raw = JSON.parse(readFileSync(filePath, "utf-8"));
+        return {
+            project: raw.project ?? "",
+            teams: [],
+            settings: raw.settings ?? { maxRetries: 3, workDir: ".", logLevel: "normal" },
+            providers: raw.providers,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+export function savePolpoConfig(polpoDir, config) {
+    if (!existsSync(polpoDir))
+        mkdirSync(polpoDir, { recursive: true });
+    writeFileSync(join(polpoDir, "polpo.json"), JSON.stringify(config, null, 2), "utf-8");
+}
+// --- Validation helpers ---
+export function validateAgents(agents) {
+    for (const agent of agents) {
+        if (!agent.name || typeof agent.name !== "string") {
+            throw new Error("Each agent must have a name");
+        }
+        // Validate allowedPaths
+        if (agent.allowedPaths !== undefined) {
+            if (!Array.isArray(agent.allowedPaths)) {
+                throw new Error(`Agent "${agent.name}": allowedPaths must be an array of strings`);
+            }
+            for (const p of agent.allowedPaths) {
+                if (typeof p !== "string" || p.trim() === "") {
+                    throw new Error(`Agent "${agent.name}": each allowedPaths entry must be a non-empty string`);
+                }
+            }
+        }
+        // Validate browser profile name
+        if (agent.browserProfile !== undefined) {
+            if (typeof agent.browserProfile !== "string" || !/^[a-zA-Z0-9_-]+$/.test(agent.browserProfile)) {
+                throw new Error(`Agent "${agent.name}": browserProfile must contain only letters, numbers, hyphens, underscores`);
+            }
+        }
+        // Vault credentials are now stored in .polpo/vault.enc (encrypted) — no longer inline.
+        // Silently strip any leftover vault field from old configs.
+        if (agent.vault)
+            delete agent.vault;
+        // Validate identity
+        if (agent.identity) {
+            if (agent.identity.responsibilities && !Array.isArray(agent.identity.responsibilities)) {
+                throw new Error(`Agent "${agent.name}": identity.responsibilities must be an array`);
+            }
+        }
+        // Validate reportsTo — self-reference
+        if (agent.reportsTo === agent.name) {
+            throw new Error(`Agent "${agent.name}": cannot report to itself`);
+        }
+    }
+    // Second pass: validate reportsTo references existing agents
+    const agentNames = new Set(agents.map((a) => a.name));
+    for (const agent of agents) {
+        if (agent.reportsTo && !agentNames.has(agent.reportsTo)) {
+            throw new Error(`Agent "${agent.name}": reportsTo "${agent.reportsTo}" does not match any agent`);
+        }
+    }
+    // Detect circular reportsTo chains
+    for (const agent of agents) {
+        if (!agent.reportsTo)
+            continue;
+        const visited = new Set();
+        let current = agent.name;
+        while (current) {
+            if (visited.has(current)) {
+                throw new Error(`Agent "${agent.name}": circular reportsTo chain detected (${[...visited, current].join(" → ")})`);
+            }
+            visited.add(current);
+            const next = agents.find((a) => a.name === current);
+            current = next?.reportsTo;
+        }
+    }
+}
+export function parseProviders(raw) {
+    const providers = {};
+    for (const [name, cfg] of Object.entries(raw)) {
+        if (!cfg || typeof cfg !== "object")
+            continue;
+        const c = cfg;
+        const pc = {};
+        if (typeof c.baseUrl === "string")
+            pc.baseUrl = c.baseUrl;
+        if (typeof c.api === "string")
+            pc.api = c.api;
+        if (Array.isArray(c.models))
+            pc.models = c.models;
+        // Only include if there's actual custom config (not just an empty object)
+        if (pc.baseUrl || pc.api || pc.models) {
+            providers[name] = pc;
+        }
+    }
+    return providers;
+}
+/** Parse orchestratorModel which can be string or ModelConfig */
+function parseOrchestratorModel(raw) {
+    if (raw === undefined || raw === null)
+        return undefined;
+    if (typeof raw === "string")
+        return raw;
+    if (typeof raw === "object") {
+        const obj = raw;
+        const result = {};
+        if (typeof obj.primary === "string")
+            result.primary = obj.primary;
+        if (Array.isArray(obj.fallbacks)) {
+            result.fallbacks = obj.fallbacks.filter((f) => typeof f === "string");
+        }
+        return result;
+    }
+    return undefined;
+}
+function parseSettings(raw) {
+    const settings = {
+        maxRetries: raw?.maxRetries ?? DEFAULT_SETTINGS.maxRetries,
+        workDir: raw?.workDir ?? DEFAULT_SETTINGS.workDir,
+        logLevel: raw?.logLevel ?? DEFAULT_SETTINGS.logLevel,
+    };
+    if (raw?.taskTimeout != null)
+        settings.taskTimeout = raw.taskTimeout;
+    if (raw?.staleThreshold != null)
+        settings.staleThreshold = raw.staleThreshold;
+    if (raw?.orchestratorModel)
+        settings.orchestratorModel = parseOrchestratorModel(raw.orchestratorModel);
+    if (raw?.imageModel && typeof raw.imageModel === "string")
+        settings.imageModel = raw.imageModel;
+    if (raw?.modelAllowlist && typeof raw.modelAllowlist === "object")
+        settings.modelAllowlist = raw.modelAllowlist;
+    if (raw?.enableVolatileTeams != null)
+        settings.enableVolatileTeams = raw.enableVolatileTeams;
+    if (raw?.volatileCleanup)
+        settings.volatileCleanup = raw.volatileCleanup;
+    if (raw?.maxFixAttempts != null)
+        settings.maxFixAttempts = raw.maxFixAttempts;
+    if (raw?.maxQuestionRounds != null)
+        settings.maxQuestionRounds = raw.maxQuestionRounds;
+    if (raw?.maxResolutionAttempts != null)
+        settings.maxResolutionAttempts = raw.maxResolutionAttempts;
+    if (raw?.autoCorrectExpectations != null)
+        settings.autoCorrectExpectations = raw.autoCorrectExpectations;
+    if (raw?.defaultRetryPolicy)
+        settings.defaultRetryPolicy = raw.defaultRetryPolicy;
+    if (raw?.maxAssessmentRetries != null)
+        settings.maxAssessmentRetries = raw.maxAssessmentRetries;
+    if (raw?.maxConcurrency != null)
+        settings.maxConcurrency = raw.maxConcurrency;
+    // Extended settings: notifications, approval gates, escalation, SLA, scheduling, quality
+    if (raw?.approvalGates)
+        settings.approvalGates = raw.approvalGates;
+    if (raw?.notifications)
+        settings.notifications = raw.notifications;
+    if (raw?.escalationPolicy)
+        settings.escalationPolicy = raw.escalationPolicy;
+    if (raw?.sla)
+        settings.sla = raw.sla;
+    if (raw?.enableScheduler != null)
+        settings.enableScheduler = raw.enableScheduler;
+    if (raw?.defaultQualityThreshold != null)
+        settings.defaultQualityThreshold = raw.defaultQualityThreshold;
+    if (raw?.reasoning)
+        settings.reasoning = raw.reasoning;
+    if (raw?.orchestratorSkills)
+        settings.orchestratorSkills = raw.orchestratorSkills;
+    if (raw?.emailAllowedDomains)
+        settings.emailAllowedDomains = raw.emailAllowedDomains;
+    // Storage backend
+    if (raw?.storage && ["file", "sqlite", "postgres"].includes(raw.storage)) {
+        settings.storage = raw.storage;
+    }
+    if (raw?.databaseUrl && typeof raw.databaseUrl === "string") {
+        settings.databaseUrl = raw.databaseUrl;
+    }
+    // Allow DATABASE_URL env var as fallback
+    if (!settings.databaseUrl && process.env.DATABASE_URL) {
+        settings.databaseUrl = process.env.DATABASE_URL;
+    }
+    // Validate: postgres requires databaseUrl
+    if (settings.storage === "postgres" && !settings.databaseUrl) {
+        throw new Error('storage: "postgres" requires a databaseUrl in settings or DATABASE_URL env var');
+    }
+    if (!["quiet", "normal", "verbose"].includes(settings.logLevel)) {
+        throw new Error(`Invalid logLevel "${settings.logLevel}": must be quiet, normal, or verbose`);
+    }
+    return settings;
+}
+/** Load .polpo/.env into process.env (does NOT overwrite existing vars). */
+export function loadEnvFile(polpoDir) {
+    const envPath = join(polpoDir, ".env");
+    if (!existsSync(envPath))
+        return;
+    try {
+        for (const line of readFileSync(envPath, "utf-8").split("\n")) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith("#"))
+                continue;
+            const eq = trimmed.indexOf("=");
+            if (eq === -1)
+                continue;
+            const key = trimmed.slice(0, eq).trim();
+            const val = trimmed.slice(eq + 1).trim().replace(/^["']|["']$/g, "");
+            if (!process.env[key])
+                process.env[key] = val;
+        }
+    }
+    catch { /* ignore */ }
+}
+// --- parseConfig: .polpo/polpo.json only ---
+/**
+ * Load config from workDir. Reads `.polpo/polpo.json` for project config.
+ * Tasks are managed via plans and the task store — not in the config file.
+ */
+export async function parseConfig(workDir) {
+    const polpoDir = getPolpoDir(workDir);
+    // Load .polpo/.env relative to workDir (handles --dir correctly).
+    // The CLI top-level only loads from cwd; this ensures the right .env is used
+    // when workDir differs from cwd.
+    loadEnvFile(polpoDir);
+    const polpoConfig = loadPolpoConfig(polpoDir);
+    if (!polpoConfig) {
+        throw new Error(`No configuration found: missing .polpo/polpo.json in ${workDir}. Run 'polpo create' or 'polpo link --project-id <id>' first.`);
+    }
+    // Teams/agents are no longer read from polpo.json.
+    // They come exclusively from FileAgentStore/FileTeamStore (agents.json / teams.json).
+    // polpo.json only contains: project, settings, providers.
+    const settings = parseSettings(polpoConfig.settings ?? {});
+    const providers = polpoConfig.providers
+        ? parseProviders(polpoConfig.providers)
+        : undefined;
+    return {
+        version: "1",
+        project: polpoConfig.project,
+        teams: [], // populated by syncConfigCache() from TeamStore/AgentStore
+        tasks: [],
+        settings,
+        providers: providers && Object.keys(providers).length > 0 ? providers : undefined,
+    };
+}
+// --- Default config generator ---
+export function generatePolpoConfigDefault(projectName, options) {
+    const settings = { ...DEFAULT_SETTINGS };
+    if (options?.model) {
+        settings.orchestratorModel = options.model;
+    }
+    const config = {
+        project: projectName,
+        teams: [],
+        settings: settings,
+    };
+    if (options?.providers && Object.keys(options.providers).length > 0) {
+        config.providers = options.providers;
+    }
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/constants.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared constants — single source of truth for default values
+ * used across CLI and server.
+ */
+/** Default port for the Polpo HTTP server. */
+export declare const DEFAULT_SERVER_PORT = 3890;
+/** Default host for the Polpo HTTP server. */
+export declare const DEFAULT_SERVER_HOST = "127.0.0.1";
+export { POLPO_DIR_NAME, getPolpoDir, getGlobalPolpoDir } from "@polpo-ai/file-stores";
+//# sourceMappingURL=constants.d.ts.map

package/dist/core/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAG/C,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/core/constants.js

@@ -0,0 +1,11 @@
+/**
+ * Shared constants — single source of truth for default values
+ * used across CLI and server.
+ */
+/** Default port for the Polpo HTTP server. */
+export const DEFAULT_SERVER_PORT = 3890;
+/** Default host for the Polpo HTTP server. */
+export const DEFAULT_SERVER_HOST = "127.0.0.1";
+// .polpo directory layout helpers — canonical home is @polpo-ai/file-stores
+export { POLPO_DIR_NAME, getPolpoDir, getGlobalPolpoDir } from "@polpo-ai/file-stores";
+//# sourceMappingURL=constants.js.map

package/dist/core/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8CAA8C;AAC9C,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAExC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAC;AAE/C,4EAA4E;AAC5E,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/core/deadlock-resolver.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Deadlock resolution: LLM-powered dependency unblocking.
+ *
+ * When a plan task fails and blocks downstream dependents, the resolver
+ * analyzes the failure and decides whether blocked tasks can proceed
+ * (absorb), whether the failed dep should be retried, or whether the
+ * chain should be failed.
+ */
+import type { Task } from "@polpo-ai/core/types";
+import type { Orchestrator } from "./orchestrator.js";
+export interface BlockageInfo {
+    task: Task;
+    failedDeps: Task[];
+    missingDeps: string[];
+}
+export interface BlockageAnalysis {
+    resolvable: BlockageInfo[];
+    unresolvable: BlockageInfo[];
+}
+/** Whether an async resolution is currently in progress. */
+export declare function isResolving(): boolean;
+/**
+ * Classify each pending task's blockage: resolvable (failed deps) vs
+ * unresolvable (missing deps). Follows cascade chains to root failures.
+ */
+export declare function analyzeBlockedTasks(pending: Task[], allTasks: Task[]): BlockageAnalysis;
+/**
+ * Async deadlock resolution. For each resolvable blockage, calls LLM
+ * to decide action (absorb/retry/fail) and applies the decision.
+ *
+ * Pattern: fire-and-forget from tick(), results applied via registry.updateTask()
+ * and picked up on next tick.
+ */
+export declare function resolveDeadlock(analysis: BlockageAnalysis, orchestrator: Orchestrator): Promise<void>;
+//# sourceMappingURL=deadlock-resolver.d.ts.map

package/dist/core/deadlock-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadlock-resolver.d.ts","sourceRoot":"","sources":["../../src/core/deadlock-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAe,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAetD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,EAAE,IAAI,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,YAAY,EAAE,YAAY,EAAE,CAAC;CAC9B;AAYD,4DAA4D;AAC5D,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAwCvF;AAwBD;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,gBAAgB,EAC1B,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,IAAI,CAAC,CA2Df"}