@polpo-ai/core 0.5.14 → 0.5.16

package/LICENSE

@@ -1,21 +1,13 @@
-MIT License
+Copyright 2026-present Lumea Labs
 
-Copyright (c) 2026 OpenPolpo Contributors
+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
 
-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:
+    http://www.apache.org/licenses/LICENSE-2.0
 
-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.
+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/README.md

@@ -10,4 +10,4 @@ npm install @polpo-ai/core
 
 ## License
 
-MIT
+Apache 2.0

package/dist/adapter.d.ts

@@ -63,7 +63,7 @@ export interface SpawnContext {
     fs?: FileSystem;
     /** Shell implementation — created by the orchestrator, passed down to tools. */
     shell?: Shell;
-    /** LLM gateway configuration — passed per-request for multi-tenant support. */
+    /** LLM gateway configuration — passed per-request for gateway routing. */
     gatewayConfig?: unknown;
 }
 //# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -1 +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;AACzF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;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;IACjF,qFAAqF;IACrF,EAAE,CAAC,EAAE,UAAU,CAAC;IAChB,gFAAgF;IAChF,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,+EAA+E;IAC/E,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB"}
+{"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;AACzF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;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;IACjF,qFAAqF;IACrF,EAAE,CAAC,EAAE,UAAU,CAAC;IAChB,gFAAgF;IAChF,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,0EAA0E;IAC1E,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB"}

package/dist/agent-prompt.d.ts

@@ -2,7 +2,7 @@
  * Build the system prompt for an agent.
  *
  * Pure logic — no runtime dependencies (Node.js, pi-ai, filesystem).
- * Used by both self-hosted (src/adapters/engine.ts) and cloud (handler.ts).
+ * Used by any runtime (self-hosted or managed).
  *
  * Includes: preamble, identity, responsibilities, tone, personality, hierarchy,
  * custom systemPrompt, and optionally skills (if provided).

package/dist/assessment-orchestrator.d.ts

@@ -13,7 +13,7 @@ import type { Task, TaskResult, ModelConfig } from "./types.js";
  * OrchestratorContext (to avoid modifying the shared interface).
  *
  * Shell layer creates these from Node.js APIs (node:fs, node:path);
- * cloud/test environments can provide stubs or omit them.
+ * remote/test environments can provide stubs or omit them.
  */
 export interface AssessmentPorts {
     /** Check if a file path exists (sync). Maps to node:fs existsSync. */

package/dist/assessor.d.ts

@@ -5,7 +5,7 @@ import type { Task, TaskExpectation, TaskMetric, AssessmentResult, CheckResult,
  * Runtime dependencies for the assessment pipeline.
  *
  * The shell layer (Node.js) provides NodeFileSystem + NodeShell.
- * The cloud layer provides SandboxProxyFS + SandboxProxyShell.
+ * Remote environments provide SandboxProxyFS + SandboxProxyShell.
  * Tests can provide mocks/stubs.
  */
 export interface AssessmentDeps {

package/dist/filesystem.d.ts

@@ -4,8 +4,8 @@
  * Decouples tools from node:fs so they can work on any backend:
  *   - NodeFileSystem:     node:fs (self-hosted, default)
  *   - AgentFS:            SQLite virtual filesystem (future)
- *   - SandboxProxyFS:     Daytona sandbox.fs proxy (cloud)
- *   - S3/R2:              Object storage (future)
+ *   - SandboxProxyFS:     Remote sandbox filesystem proxy
+ *   - S3:                 Object storage adapter
  */
 export interface FileSystem {
     /** Read file contents as UTF-8 string. */

package/dist/filesystem.js

@@ -4,8 +4,8 @@
  * Decouples tools from node:fs so they can work on any backend:
  *   - NodeFileSystem:     node:fs (self-hosted, default)
  *   - AgentFS:            SQLite virtual filesystem (future)
- *   - SandboxProxyFS:     Daytona sandbox.fs proxy (cloud)
- *   - S3/R2:              Object storage (future)
+ *   - SandboxProxyFS:     Remote sandbox filesystem proxy
+ *   - S3:                 Object storage adapter
  */
 export {};
 //# sourceMappingURL=filesystem.js.map

package/dist/model-spec.d.ts

@@ -3,7 +3,7 @@
  *
  * Parses "provider:model" or "provider/model" strings into { provider, modelId }.
  * Auto-infers provider from well-known model prefixes.
- * Used by both self-hosted (src/llm/pi-client.ts) and cloud (handler.ts).
+ * Used by any runtime.
  */
 export interface ParsedModelSpec {
     provider: string;
@@ -24,7 +24,7 @@ export interface ParsedModelSpec {
 export declare function parseModelSpec(spec?: string, fallback?: string): ParsedModelSpec;
 /**
  * Map of known providers → environment variable name for API keys.
- * Used by both self-hosted and cloud for BYOK resolution.
+ * Used for provider API key resolution.
  */
 export declare const PROVIDER_ENV_MAP: Record<string, string>;
 //# sourceMappingURL=model-spec.d.ts.map

package/dist/model-spec.js

@@ -3,7 +3,7 @@
  *
  * Parses "provider:model" or "provider/model" strings into { provider, modelId }.
  * Auto-infers provider from well-known model prefixes.
- * Used by both self-hosted (src/llm/pi-client.ts) and cloud (handler.ts).
+ * Used by any runtime.
  */
 /**
  * Well-known model prefixes → provider mapping.
@@ -77,7 +77,7 @@ export function parseModelSpec(spec, fallback) {
 }
 /**
  * Map of known providers → environment variable name for API keys.
- * Used by both self-hosted and cloud for BYOK resolution.
+ * Used for provider API key resolution.
  */
 export const PROVIDER_ENV_MAP = {
     openai: "OPENAI_API_KEY",

package/dist/run-store.d.ts

@@ -13,7 +13,7 @@ export interface RunRecord {
     result?: TaskResult;
     /** Outcomes auto-collected during execution (files, media, text artifacts). */
     outcomes?: TaskOutcome[];
-    /** Full runner configuration (used by cloud runners that read config from DB instead of file). */
+    /** Full runner configuration (used by runners that read config from DB instead of file). */
     config?: RunnerConfig;
     configPath: string;
 }

package/dist/run-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-store.d.ts","sourceRoot":"","sources":["../src/run-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEvF,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEtE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,kGAAkG;IAClG,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,mFAAmF;IACnF,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IACtD,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAC/D,aAAa,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACtC,eAAe,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACxC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC/B"}
+{"version":3,"file":"run-store.d.ts","sourceRoot":"","sources":["../src/run-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEvF,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEtE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,4FAA4F;IAC5F,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,mFAAmF;IACnF,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IACtD,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAC/D,aAAa,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACtC,eAAe,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACxC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC/B"}

package/dist/shell.d.ts

@@ -4,7 +4,7 @@
  * Decouples tools from child_process so they can work on any backend:
  *   - NodeShell:          child_process.exec (self-hosted, default)
  *   - JustBashShell:      just-bash in-process (serverless, edge)
- *   - SandboxProxyShell:  Daytona sandbox.process proxy (cloud)
+ *   - SandboxProxyShell:  Remote sandbox process proxy
  */
 export interface Shell {
     /** Execute a command and return the result. */

package/dist/shell.js

@@ -4,7 +4,7 @@
  * Decouples tools from child_process so they can work on any backend:
  *   - NodeShell:          child_process.exec (self-hosted, default)
  *   - JustBashShell:      just-bash in-process (serverless, edge)
- *   - SandboxProxyShell:  Daytona sandbox.process proxy (cloud)
+ *   - SandboxProxyShell:  Remote sandbox process proxy
  */
 export {};
 //# sourceMappingURL=shell.js.map

package/dist/skills-reader.d.ts

@@ -3,7 +3,7 @@
  *
  * Uses FileSystem abstraction so it works on any backend:
  *   - NodeFileSystem (self-hosted)
- *   - SandboxProxyFS (cloud, lazy)
+ *   - SandboxProxyFS (remote, lazy)
  *
  * Write operations (install, remove, create, assign) stay in the shell
  * because they use git clone, symlinks, and other Node-specific ops.
@@ -46,7 +46,7 @@ export declare function extractSkillBody(content: string): string;
 export declare function buildSkillPrompt(skills: LoadedSkill[]): string;
 /**
  * Discover ALL available skills from the project's .polpo/skills/ directory.
- * Cloud version — no global ~/.polpo/ (not available in sandbox).
+ * Remote version — no global ~/.polpo/ (not available in sandbox).
  */
 export declare function discoverSkills(fs: FileSystem, polpoDir: string, globalPolpoDir?: string): Promise<SkillInfo[]>;
 /**

package/dist/skills-reader.js

@@ -3,7 +3,7 @@
  *
  * Uses FileSystem abstraction so it works on any backend:
  *   - NodeFileSystem (self-hosted)
- *   - SandboxProxyFS (cloud, lazy)
+ *   - SandboxProxyFS (remote, lazy)
  *
  * Write operations (install, remove, create, assign) stay in the shell
  * because they use git clone, symlinks, and other Node-specific ops.
@@ -120,7 +120,7 @@ async function scanSkillsDir(fs, dir, source) {
 }
 /**
  * Discover ALL available skills from the project's .polpo/skills/ directory.
- * Cloud version — no global ~/.polpo/ (not available in sandbox).
+ * Remote version — no global ~/.polpo/ (not available in sandbox).
  */
 export async function discoverSkills(fs, polpoDir, globalPolpoDir) {
     const seen = new Set();

package/dist/spawner.d.ts

@@ -2,7 +2,7 @@
  * Spawner — abstraction for launching agent runner processes.
  *
  * Node.js uses NodeSpawner (child_process.spawn).
- * Cloud uses SandboxSpawner (Daytona sandbox).
+ * Remote environments use SandboxSpawner.
  *
  * Same pattern as FileSystem and Shell — pure interface in core,
  * runtime implementations in the shell layer.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polpo-ai/core",
-  "version": "0.5.14",
+  "version": "0.5.16",
   "description": "Pure business logic, types, schemas, and store interfaces for the Polpo AI agent orchestration platform",
   "type": "module",
   "main": "dist/index.js",
@@ -212,7 +212,7 @@
     "dist",
     "README.md"
   ],
-  "license": "MIT",
+  "license": "Apache-2.0",
   "keywords": [
     "polpo",
     "ai-agents",