pi-agent-browser-native 0.2.17 → 0.2.18

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## Unreleased
 
+## 0.2.18 - 2026-05-03
+
+### Fixed
+- persist oversized parse-failure spill files when Pi provides a session directory without a session file
+- isolate the opt-in real-upstream download contract test from the user's global Downloads folder and avoid killing unrelated `agent-browser` processes
+
+### Changed
+- clarified the README and repo guidance for the current published package state
+- marked the completed implementation plan as superseded so current design guidance stays canonical
+- tightened the implicit-session idle-timeout helper to return milliseconds as a number and convert to an environment string only at the process boundary
+
 ## 0.2.17 - 2026-05-03
 
 ### Fixed

package/README.md

@@ -4,9 +4,9 @@ Native `pi` integration for [`agent-browser`](https://agent-browser.dev/).
 
 ## Status
 
-Early working scaffold.
+Published pre-1.0 package.
 
-The package scaffold, native `agent_browser` tool, local typecheck/test setup, and release/package verification workflow are in place.
+The native `agent_browser` tool, local verification workflow, package-content checks, and release checks are in place. Package install is the default path; checkout loading is for development and validation.
 
 ## Goal
 
@@ -45,7 +45,7 @@ A native `pi` integration can improve on the current skill by adding:
 
 ## Install and try
 
-The product direction is package-first. Prefer the package source once a release exists, while keeping the local-checkout flow for current development and pre-release validation.
+The product direction is package-first. Prefer the package source for normal use; keep the local-checkout flow for development and pre-release validation.
 
 ### Preferred package install
 

package/extensions/agent-browser/index.ts

@@ -1216,17 +1216,12 @@ function buildSessionDetailFields(sessionName: string | undefined, usedImplicitS
 function getPersistentSessionArtifactStore(ctx: {
 	sessionManager: {
 		getSessionDir?: () => string;
-		getSessionFile?: () => string | undefined;
 		getSessionId: () => string | undefined;
 	};
 }): PersistentSessionArtifactStore | undefined {
-	const sessionFile = typeof ctx.sessionManager.getSessionFile === "function" ? ctx.sessionManager.getSessionFile() : undefined;
 	const sessionDir = typeof ctx.sessionManager.getSessionDir === "function" ? ctx.sessionManager.getSessionDir() : undefined;
 	const sessionId = ctx.sessionManager.getSessionId();
-	if (!sessionFile || !sessionDir || !sessionId) {
-		return undefined;
-	}
-	return { sessionDir, sessionId };
+	return sessionDir && sessionId ? { sessionDir, sessionId } : undefined;
 }
 
 async function preserveParseFailureOutput(options: {
@@ -1360,7 +1355,7 @@ export default function agentBrowserExtension(pi: ExtensionAPI) {
 	const ephemeralSessionSeed = createEphemeralSessionSeed();
 	const hasBraveApiKey = hasUsableBraveApiKey();
 	const toolPromptGuidelines = buildToolPromptGuidelines({ includeBraveSearch: hasBraveApiKey });
-	const implicitSessionIdleTimeoutMs = getImplicitSessionIdleTimeoutMs();
+	const implicitSessionIdleTimeoutMs = String(getImplicitSessionIdleTimeoutMs());
 	const implicitSessionCloseTimeoutMs = getImplicitSessionCloseTimeoutMs();
 	let managedSessionActive = false;
 	let managedSessionBaseName = createImplicitSessionName(undefined, process.cwd(), ephemeralSessionSeed);

package/extensions/agent-browser/lib/runtime.ts

@@ -421,12 +421,10 @@ function parseTimeoutMs(rawValue: string | undefined, minimumValue: number): num
 	return parsedValue;
 }
 
-export function getImplicitSessionIdleTimeoutMs(env: NodeJS.ProcessEnv = process.env): string {
-	return String(
-		parseTimeoutMs(env[IMPLICIT_SESSION_IDLE_TIMEOUT_ENV], 0) ??
-			parseTimeoutMs(env[AGENT_BROWSER_IDLE_TIMEOUT_ENV], 0) ??
-			DEFAULT_IMPLICIT_SESSION_IDLE_TIMEOUT_MS,
-	);
+export function getImplicitSessionIdleTimeoutMs(env: NodeJS.ProcessEnv = process.env): number {
+	return parseTimeoutMs(env[IMPLICIT_SESSION_IDLE_TIMEOUT_ENV], 0) ??
+		parseTimeoutMs(env[AGENT_BROWSER_IDLE_TIMEOUT_ENV], 0) ??
+		DEFAULT_IMPLICIT_SESSION_IDLE_TIMEOUT_MS;
 }
 
 export function getImplicitSessionCloseTimeoutMs(env: NodeJS.ProcessEnv = process.env): number {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-agent-browser-native",
-  "version": "0.2.17",
+  "version": "0.2.18",
   "description": "pi extension that exposes agent-browser as a native tool for browser automation",
   "type": "module",
   "author": "Mitch Fultz (https://github.com/fitchmultz)",