@poncho-ai/harness 0.15.0 → 0.16.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @poncho-ai/harness@0.15.0 build /home/runner/work/poncho-ai/poncho-ai/packages/harness
+> @poncho-ai/harness@0.16.0 build /Users/cesar/Dev/latitude/poncho-ai/packages/harness
 > tsup src/index.ts --format esm --dts
 
 CLI Building entry: src/index.ts
@@ -7,8 +7,8 @@
 CLI tsup v8.5.1
 CLI Target: es2022
 ESM Build start
-ESM dist/index.js 182.55 KB
-ESM ⚡️ Build success in 144ms
+ESM dist/index.js 185.71 KB
+ESM ⚡️ Build success in 140ms
 DTS Build start
-DTS ⚡️ Build success in 6528ms
-DTS dist/index.d.ts 22.34 KB
+DTS ⚡️ Build success in 7525ms
+DTS dist/index.d.ts 22.38 KB

package/.turbo/turbo-lint.log

@@ -0,0 +1,6 @@
+
+> @poncho-ai/harness@0.11.2 lint /Users/cesar/Dev/latitude/poncho-ai/packages/harness
+> eslint src/
+
+sh: eslint: command not found
+ ELIFECYCLE  Command failed.

package/.turbo/turbo-test.log

@@ -0,0 +1,139 @@
+
+> @poncho-ai/harness@0.14.2 test /Users/cesar/Dev/latitude/poncho-ai/packages/harness
+> vitest
+
+
+ RUN  v1.6.1 /Users/cesar/Dev/latitude/poncho-ai/packages/harness
+
+[event] step:completed {"type":"step:completed","step":1,"duration":1}
+ ✓ test/telemetry.test.ts  (3 tests) 3ms
+[event] step:started {"type":"step:started","step":2}
+ ✓ test/schema-converter.test.ts  (27 tests) 16ms
+stdout | test/mcp.test.ts > mcp bridge protocol transports > discovers and calls tools over streamable HTTP
+[poncho][mcp] {"event":"catalog.loaded","server":"remote","discoveredCount":1}
+[poncho][mcp] {"event":"tools.selected","requestedPatternCount":1,"registeredCount":1,"filteredByPolicyCount":0,"filteredByIntentCount":0}
+
+ ✓ test/agent-parser.test.ts  (10 tests) 17ms
+ ✓ test/memory.test.ts  (4 tests) 16ms
+stdout | test/mcp.test.ts > mcp bridge protocol transports > selects discovered tools by requested patterns
+[poncho][mcp] {"event":"catalog.loaded","server":"remote","discoveredCount":2}
+[poncho][mcp] {"event":"tools.selected","requestedPatternCount":1,"registeredCount":1,"filteredByPolicyCount":0,"filteredByIntentCount":1}
+[poncho][mcp] {"event":"tools.selected","requestedPatternCount":1,"registeredCount":2,"filteredByPolicyCount":0,"filteredByIntentCount":0}
+
+stdout | test/mcp.test.ts > mcp bridge protocol transports > skips discovery when bearer token env value is missing
+[poncho][mcp] {"event":"tools.selected","requestedPatternCount":1,"registeredCount":0,"filteredByPolicyCount":0,"filteredByIntentCount":0}
+
+stderr | test/mcp.test.ts > mcp bridge protocol transports > skips discovery when bearer token env value is missing
+[poncho][mcp] {"event":"auth.token_missing","server":"remote","tokenEnv":"MISSING_TOKEN_ENV"}
+
+stdout | test/mcp.test.ts > mcp bridge protocol transports > returns actionable errors for 403 permission failures
+[poncho][mcp] {"event":"catalog.loaded","server":"remote","discoveredCount":1}
+[poncho][mcp] {"event":"tools.selected","requestedPatternCount":1,"registeredCount":1,"filteredByPolicyCount":0,"filteredByIntentCount":0}
+
+ ✓ test/mcp.test.ts  (6 tests) 97ms
+ ✓ test/state.test.ts  (5 tests) 217ms
+ ✓ test/agent-identity.test.ts  (2 tests) 15ms
+ ✓ test/model-factory.test.ts  (4 tests) 3ms
+stdout | test/harness.test.ts > agent harness > registers default filesystem tools
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > disables write_file by default in production environment
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > allows disabling built-in tools via poncho.config.js
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > supports per-environment tool overrides
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > supports per-environment tool overrides
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > does not auto-register exported tool objects from skill scripts
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > refreshes skill metadata and tools in development mode
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > refreshes skill metadata and tools in development mode
+[poncho][mcp] {"event":"tools.cleared","reason":"skills:changed","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > refreshes skill metadata and tools in development mode
+[poncho][mcp] {"event":"tools.cleared","reason":"activate:beta","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > prunes removed active skills after refresh in development mode
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+[poncho][mcp] {"event":"tools.cleared","reason":"activate:obsolete","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > prunes removed active skills after refresh in development mode
+[poncho][mcp] {"event":"tools.cleared","reason":"skills:changed","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > does not refresh skills outside development mode
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > clears active skills when skill metadata changes in development mode
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+[poncho][mcp] {"event":"tools.cleared","reason":"activate:alpha","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > clears active skills when skill metadata changes in development mode
+[poncho][mcp] {"event":"tools.cleared","reason":"skills:changed","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > lists skill scripts through list_skill_scripts
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > runs JavaScript/TypeScript skill scripts through run_skill_script
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > runs AGENT-scope scripts from root scripts directory
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > blocks path traversal in run_skill_script
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > requires allowed-tools entries for non-standard script directories
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > registers MCP tools dynamically for stacked active skills and supports deactivation
+[poncho][mcp] {"event":"catalog.loaded","server":"remote","discoveredCount":2}
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+[poncho][mcp] {"event":"tools.selected","requestedPatternCount":1,"registeredCount":1,"filteredByPolicyCount":0,"filteredByIntentCount":1}
+[poncho][mcp] {"event":"tools.refreshed","reason":"activate:skill-a","requestedPatterns":["remote/a"],"registeredCount":1,"activeSkills":["skill-a"]}
+
+stdout | test/harness.test.ts > agent harness > registers MCP tools dynamically for stacked active skills and supports deactivation
+[poncho][mcp] {"event":"tools.selected","requestedPatternCount":2,"registeredCount":2,"filteredByPolicyCount":0,"filteredByIntentCount":0}
+[poncho][mcp] {"event":"tools.refreshed","reason":"activate:skill-b","requestedPatterns":["remote/a","remote/b"],"registeredCount":2,"activeSkills":["skill-a","skill-b"]}
+[poncho][mcp] {"event":"tools.selected","requestedPatternCount":1,"registeredCount":1,"filteredByPolicyCount":0,"filteredByIntentCount":1}
+[poncho][mcp] {"event":"tools.refreshed","reason":"deactivate:skill-a","requestedPatterns":["remote/b"],"registeredCount":1,"activeSkills":["skill-b"]}
+
+stdout | test/harness.test.ts > agent harness > supports flat tool access config format
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > flat tool access takes priority over legacy defaults
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > byEnvironment overrides flat tool access
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > registerTools skips tools disabled via config
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > approval access level registers the tool but marks it for approval
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > tools without approval config do not require approval
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > allows in-flight MCP calls to finish after skill deactivation
+[poncho][mcp] {"event":"catalog.loaded","server":"remote","discoveredCount":1}
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+[poncho][mcp] {"event":"tools.selected","requestedPatternCount":1,"registeredCount":1,"filteredByPolicyCount":0,"filteredByIntentCount":0}
+[poncho][mcp] {"event":"tools.refreshed","reason":"activate:skill-slow","requestedPatterns":["remote/slow"],"registeredCount":1,"activeSkills":["skill-slow"]}
+[poncho][mcp] {"event":"tools.cleared","reason":"deactivate:skill-slow","requestedPatterns":[]}
+
+ ✓ test/harness.test.ts  (25 tests) 365ms
+
+ Test Files  9 passed (9)
+      Tests  86 passed (86)
+   Start at  13:30:36
+   Duration  2.19s (transform 1.11s, setup 0ms, collect 2.81s, tests 749ms, environment 5ms, prepare 1.23s)
+

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @poncho-ai/harness
 
+## 0.16.0
+
+### Minor Changes
+
+- [`12f2845`](https://github.com/cesr/poncho-ai/commit/12f28457c20e650640ff2a1c1dbece2a6e4a9ddd) Thanks [@cesr](https://github.com/cesr)! - Add browser storage persistence (cookies/localStorage survive restarts via configured storage provider) and new `browser_content` tool for fast text extraction from pages.
+
+## 0.15.1
+
+### Patch Changes
+
+- Fix browser session reconnection, tab lifecycle management, and web UI panel state handling.
+
+- Updated dependencies []:
+  - @poncho-ai/sdk@1.1.1
+
 ## 0.15.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -486,6 +486,7 @@ declare class AgentHarness {
     private registerSkillTools;
     private refreshSkillsIfChanged;
     initialize(): Promise<void>;
+    private buildBrowserStoragePersistence;
     private initBrowserTools;
     /** Conversation ID of the currently executing run (set during run, cleared after). */
     private _currentRunConversationId?;

package/dist/index.js

@@ -3290,6 +3290,85 @@ var AgentHarness = class {
       );
     }
   }
+  async buildBrowserStoragePersistence(config, sessionId) {
+    const provider = config.storage?.provider ?? config.state?.provider ?? "local";
+    const stateKey = `poncho:browser:state:${sessionId}`;
+    if (provider === "memory") return void 0;
+    if (provider === "local") {
+      const { resolve: pathResolve } = await import("path");
+      const { homedir: home } = await import("os");
+      const stateDir = pathResolve(home(), ".poncho", "browser-state");
+      const filePath = pathResolve(stateDir, `${sessionId}.json`);
+      return {
+        async save(json) {
+          const { mkdir: mkdir5, writeFile: writeFile6 } = await import("fs/promises");
+          await mkdir5(stateDir, { recursive: true });
+          await writeFile6(filePath, json, "utf8");
+        },
+        async load() {
+          const { readFile: readFile8 } = await import("fs/promises");
+          try {
+            return await readFile8(filePath, "utf8");
+          } catch {
+            return void 0;
+          }
+        }
+      };
+    }
+    if (provider === "upstash") {
+      const urlEnv = config.storage?.urlEnv ?? (process.env.UPSTASH_REDIS_REST_URL ? "UPSTASH_REDIS_REST_URL" : "KV_REST_API_URL");
+      const tokenEnv = config.storage?.tokenEnv ?? (process.env.UPSTASH_REDIS_REST_TOKEN ? "UPSTASH_REDIS_REST_TOKEN" : "KV_REST_API_TOKEN");
+      const baseUrl = (process.env[urlEnv] ?? "").replace(/\/+$/, "");
+      const token = process.env[tokenEnv] ?? "";
+      if (!baseUrl || !token) return void 0;
+      const headers = { Authorization: `Bearer ${token}`, "Content-Type": "application/json" };
+      return {
+        async save(json) {
+          await fetch(`${baseUrl}/set/${encodeURIComponent(stateKey)}/${encodeURIComponent(json)}`, { method: "POST", headers });
+        },
+        async load() {
+          const res = await fetch(`${baseUrl}/get/${encodeURIComponent(stateKey)}`, { headers });
+          if (!res.ok) return void 0;
+          const body = await res.json();
+          return body.result ?? void 0;
+        }
+      };
+    }
+    if (provider === "redis") {
+      const urlEnv = config.storage?.urlEnv ?? "REDIS_URL";
+      const url = process.env[urlEnv] ?? "";
+      if (!url) return void 0;
+      let clientPromise;
+      const getClient = () => {
+        if (!clientPromise) {
+          clientPromise = (async () => {
+            try {
+              const mod = await import("redis");
+              const c = mod.createClient({ url });
+              await c.connect();
+              return c;
+            } catch {
+              return void 0;
+            }
+          })();
+        }
+        return clientPromise;
+      };
+      return {
+        async save(json) {
+          const c = await getClient();
+          if (c) await c.set(stateKey, json);
+        },
+        async load() {
+          const c = await getClient();
+          if (!c) return void 0;
+          const val = await c.get(stateKey);
+          return val ?? void 0;
+        }
+      };
+    }
+    return void 0;
+  }
   async initBrowserTools(config) {
     const spec = ["@poncho-ai", "browser"].join("/");
     let browserMod;
@@ -3318,9 +3397,14 @@ var AgentHarness = class {
       );
     }
     this._browserMod = browserMod;
-    const browserCfg = typeof config.browser === "object" ? config.browser : {};
+    const browserCfg = typeof config.browser === "object" ? { ...config.browser } : {};
     const agentId = this.parsedAgent?.frontmatter.id ?? this.parsedAgent?.frontmatter.name ?? "default";
-    const session = new browserMod.BrowserSession(`poncho-${agentId}`, browserCfg);
+    const sessionId = `poncho-${agentId}`;
+    const storagePersistence = await this.buildBrowserStoragePersistence(config, sessionId);
+    if (storagePersistence) {
+      browserCfg.storagePersistence = storagePersistence;
+    }
+    const session = new browserMod.BrowserSession(sessionId, browserCfg);
     this._browserSession = session;
     const tools = browserMod.createBrowserTools(
       () => session,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poncho-ai/harness",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Agent execution runtime - conversation loop, tool dispatch, streaming",
   "repository": {
     "type": "git",
@@ -31,7 +31,7 @@
     "redis": "^5.10.0",
     "yaml": "^2.4.0",
     "zod": "^3.22.0",
-    "@poncho-ai/sdk": "1.1.0"
+    "@poncho-ai/sdk": "1.1.1"
   },
   "devDependencies": {
     "@types/mustache": "^4.2.6",

package/src/harness.ts

@@ -914,6 +914,94 @@ export class AgentHarness {
     }
   }
 
+  private async buildBrowserStoragePersistence(
+    config: PonchoConfig,
+    sessionId: string,
+  ): Promise<{ save(json: string): Promise<void>; load(): Promise<string | undefined> } | undefined> {
+    const provider = config.storage?.provider ?? (config.state as Record<string, unknown> | undefined)?.provider as string | undefined ?? "local";
+    const stateKey = `poncho:browser:state:${sessionId}`;
+
+    if (provider === "memory") return undefined;
+
+    if (provider === "local") {
+      const { resolve: pathResolve } = await import("node:path");
+      const { homedir: home } = await import("node:os");
+      const stateDir = pathResolve(home(), ".poncho", "browser-state");
+      const filePath = pathResolve(stateDir, `${sessionId}.json`);
+      return {
+        async save(json: string) {
+          const { mkdir, writeFile } = await import("node:fs/promises");
+          await mkdir(stateDir, { recursive: true });
+          await writeFile(filePath, json, "utf8");
+        },
+        async load() {
+          const { readFile } = await import("node:fs/promises");
+          try { return await readFile(filePath, "utf8"); } catch { return undefined; }
+        },
+      };
+    }
+
+    if (provider === "upstash") {
+      const urlEnv = config.storage?.urlEnv ?? (process.env.UPSTASH_REDIS_REST_URL ? "UPSTASH_REDIS_REST_URL" : "KV_REST_API_URL");
+      const tokenEnv = config.storage?.tokenEnv ?? (process.env.UPSTASH_REDIS_REST_TOKEN ? "UPSTASH_REDIS_REST_TOKEN" : "KV_REST_API_TOKEN");
+      const baseUrl = (process.env[urlEnv] ?? "").replace(/\/+$/, "");
+      const token = process.env[tokenEnv] ?? "";
+      if (!baseUrl || !token) return undefined;
+      const headers = { Authorization: `Bearer ${token}`, "Content-Type": "application/json" };
+      return {
+        async save(json: string) {
+          await fetch(`${baseUrl}/set/${encodeURIComponent(stateKey)}/${encodeURIComponent(json)}`, { method: "POST", headers });
+        },
+        async load() {
+          const res = await fetch(`${baseUrl}/get/${encodeURIComponent(stateKey)}`, { headers });
+          if (!res.ok) return undefined;
+          const body = await res.json() as { result?: string | null };
+          return body.result ?? undefined;
+        },
+      };
+    }
+
+    if (provider === "redis") {
+      const urlEnv = config.storage?.urlEnv ?? "REDIS_URL";
+      const url = process.env[urlEnv] ?? "";
+      if (!url) return undefined;
+      let clientPromise: Promise<{ get(k: string): Promise<string | null>; set(k: string, v: string): Promise<unknown> } | undefined> | undefined;
+      const getClient = () => {
+        if (!clientPromise) {
+          clientPromise = (async () => {
+            try {
+              const mod = (await import("redis")) as unknown as {
+                createClient: (opts: { url: string }) => {
+                  connect(): Promise<unknown>;
+                  get(k: string): Promise<string | null>;
+                  set(k: string, v: string): Promise<unknown>;
+                };
+              };
+              const c = mod.createClient({ url });
+              await c.connect();
+              return c;
+            } catch { return undefined; }
+          })();
+        }
+        return clientPromise;
+      };
+      return {
+        async save(json: string) {
+          const c = await getClient();
+          if (c) await c.set(stateKey, json);
+        },
+        async load() {
+          const c = await getClient();
+          if (!c) return undefined;
+          const val = await c.get(stateKey);
+          return val ?? undefined;
+        },
+      };
+    }
+
+    return undefined;
+  }
+
   private async initBrowserTools(config: PonchoConfig): Promise<void> {
     const spec = ["@poncho-ai", "browser"].join("/");
     let browserMod: {
@@ -947,9 +1035,16 @@ export class AgentHarness {
     }
 
     this._browserMod = browserMod;
-    const browserCfg = typeof config.browser === "object" ? config.browser : {};
+    const browserCfg: Record<string, unknown> = typeof config.browser === "object" ? { ...config.browser } : {};
     const agentId = this.parsedAgent?.frontmatter.id ?? this.parsedAgent?.frontmatter.name ?? "default";
-    const session = new browserMod.BrowserSession(`poncho-${agentId}`, browserCfg);
+    const sessionId = `poncho-${agentId}`;
+
+    const storagePersistence = await this.buildBrowserStoragePersistence(config, sessionId);
+    if (storagePersistence) {
+      browserCfg.storagePersistence = storagePersistence;
+    }
+
+    const session = new browserMod.BrowserSession(sessionId, browserCfg);
     this._browserSession = session;
 
     const tools = browserMod.createBrowserTools(