pi-agent-browser-native 0.2.17 → 0.2.19

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 ## Unreleased
 
+## 0.2.19 - 2026-05-03
+
+### Fixed
+- resolve relative Pi package sources from the settings file directory in `pi-agent-browser-doctor`, so global settings that point at a local checkout are detected correctly
+
+## 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.19",
   "description": "pi extension that exposes agent-browser as a native tool for browser automation",
   "type": "module",
   "author": "Mitch Fultz (https://github.com/fitchmultz)",

package/scripts/doctor.mjs

@@ -125,7 +125,7 @@ function isPathLikeSource(source) {
 	return source.startsWith("/") || source.startsWith("./") || source.startsWith("../") || source.startsWith("~");
 }
 
-function sourceLooksLikeThisPackage(source, cwd) {
+function sourceLooksLikeThisPackage(source, cwd, sourceBaseDir = cwd) {
 	const text = String(source ?? "").trim();
 	if (text.length === 0) return false;
 	if (/^npm:pi-agent-browser-native(?:@|$)/.test(text)) return true;
@@ -133,12 +133,13 @@ function sourceLooksLikeThisPackage(source, cwd) {
 	if (text.includes(REPO_URL_FRAGMENT)) return true;
 
 	if (!isPathLikeSource(text)) return false;
-	const resolvedSource = resolve(cwd, expandUserPath(text));
+	const resolvedSource = resolve(sourceBaseDir, expandUserPath(text));
 	const cwdEntrypoint = resolve(cwd, EXTENSION_ENTRYPOINT);
 	const packageEntrypoint = resolve(THIS_PACKAGE_ROOT, EXTENSION_ENTRYPOINT);
 	return (
 		resolvedSource === cwd ||
 		resolvedSource === cwdEntrypoint ||
+		resolvedSource === THIS_PACKAGE_ROOT ||
 		resolvedSource === packageEntrypoint ||
 		isInsidePath(cwdEntrypoint, resolvedSource) ||
 		isInsidePath(packageEntrypoint, resolvedSource)
@@ -223,15 +224,16 @@ function entrySource(entry) {
 
 function collectSettingsSources(settings, settingsPath, cwd) {
 	const sources = [];
+	const sourceBaseDir = dirname(settingsPath);
 	for (const [index, entry] of arrayEntries(settings?.packages)) {
 		const source = entrySource(entry);
-		if (sourceLooksLikeThisPackage(source, cwd)) {
+		if (sourceLooksLikeThisPackage(source, cwd, sourceBaseDir)) {
 			sources.push({ kind: "package", source: String(source), location: `${settingsPath} packages[${index}]` });
 		}
 	}
 	for (const [index, entry] of arrayEntries(settings?.extensions)) {
 		const source = entrySource(entry);
-		if (sourceLooksLikeThisPackage(source, cwd)) {
+		if (sourceLooksLikeThisPackage(source, cwd, sourceBaseDir)) {
 			sources.push({ kind: "extension", source: String(source), location: `${settingsPath} extensions[${index}]` });
 		}
 	}