pi-cursor-sdk 0.4.0 → 0.5.2

package/node_modules/hono/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hono",
-  "version": "4.13.9",
+  "version": "4.13.13",
   "description": "Web framework built on Web Standards",
   "main": "dist/cjs/index.js",
   "type": "module",
@@ -11,29 +11,31 @@
     "!dist/**/*.tsbuildinfo"
   ],
   "scripts": {
-    "test": "tsc -p tsconfig.spec.json && vitest --run",
-    "test:watch": "vitest --watch",
+    "test": "tsc -p tsconfig.spec.json && vp test --run",
+    "test:watch": "vp test --watch",
     "test:deno": "deno test --allow-read --allow-env --allow-write --allow-net -c runtime-tests/deno/deno.json runtime-tests/deno && deno test --no-lock -c runtime-tests/deno-jsx/deno.precompile.json runtime-tests/deno-jsx && deno test --no-lock -c runtime-tests/deno-jsx/deno.react-jsx.json runtime-tests/deno-jsx",
-    "test:bun": "bun test --jsx-import-source ../../src/jsx runtime-tests/bun/*",
-    "test:fastly": "vitest --run --project fastly",
-    "test:node": "vitest --run --project node",
-    "test:workerd": "vitest --run --project workerd",
-    "test:lambda": "vitest --run --project lambda",
-    "test:lambda-edge": "vitest --run --project lambda-edge",
-    "test:all": "bun run test && bun test:deno && bun test:bun",
-    "lint": "eslint src runtime-tests build perf-measures benchmarks",
-    "lint:fix": "eslint src runtime-tests build perf-measures benchmarks --fix",
-    "format": "prettier --check --cache \"src/**/*.{js,ts,tsx}\" \"runtime-tests/**/*.{js,ts,tsx}\" \"build/**/*.{js,ts,tsx}\" \"perf-measures/**/*.{js,ts,tsx}\" \"benchmarks/**/*.{js,ts,tsx}\"",
-    "format:fix": "prettier --write --cache --cache-strategy metadata \"src/**/*.{js,ts,tsx}\" \"runtime-tests/**/*.{js,ts,tsx}\" \"build/**/*.{js,ts,tsx}\" \"perf-measures/**/*.{js,ts,tsx}\" \"benchmarks/**/*.{js,ts,tsx}\"",
+    "test:bun": "bun test --jsx-import-source ../../src/jsx runtime-tests/bun",
+    "test:fastly": "vp test --run --project fastly",
+    "test:node": "vp test --run --project node",
+    "test:workerd": "vp test --run --project workerd",
+    "test:all": "pnpm run test && pnpm run test:deno && pnpm run test:bun",
+    "check": "vp check",
+    "check:fix": "vp check --fix",
+    "lint": "vp lint src runtime-tests build perf-measures benchmarks adapters",
+    "lint:fix": "vp lint --fix src runtime-tests build perf-measures benchmarks adapters",
+    "format": "vp fmt --check \"src/**/*.{js,ts,tsx}\" \"runtime-tests/**/*.{js,ts,tsx}\" \"build/**/*.{js,ts,tsx}\" \"perf-measures/**/*.{js,ts,tsx}\" \"benchmarks/**/*.{js,ts,tsx}\" \"adapters/**/*.{js,ts,tsx}\"",
+    "format:fix": "vp fmt \"src/**/*.{js,ts,tsx}\" \"runtime-tests/**/*.{js,ts,tsx}\" \"build/**/*.{js,ts,tsx}\" \"perf-measures/**/*.{js,ts,tsx}\" \"benchmarks/**/*.{js,ts,tsx}\" \"adapters/**/*.{js,ts,tsx}\"",
     "editorconfig-checker": "editorconfig-checker",
     "copy:package.cjs.json": "cp ./package.cjs.json ./dist/cjs/package.json && cp ./package.cjs.json ./dist/types/package.json",
-    "build": "bun run --shell bun remove-dist && bun ./build/build.ts && bun run copy:package.cjs.json",
-    "postbuild": "publint",
-    "watch": "bun run --shell bun remove-dist && bun ./build/build.ts --watch && bun run copy:package.cjs.json",
-    "coverage": "vitest --run --coverage",
-    "prerelease": "bun test:deno && bun run build",
+    "build": "pnpm run remove-dist && vp pack && pnpm run copy:package.cjs.json && publint",
+    "watch": "pnpm run remove-dist && vp pack --watch && pnpm run copy:package.cjs.json",
+    "coverage": "vp test --run --coverage",
+    "prerelease": "pnpm run test:deno && pnpm run build",
     "release": "np --no-publish",
-    "remove-dist": "rm -rf dist"
+    "remove-dist": "rm -rf dist",
+    "build:adapters": "pnpm -r --filter \"./adapters/*\" run build",
+    "test:adapters": "pnpm -r --filter \"./adapters/*\" run test",
+    "release:adapter": "node ./build/release-adapter.ts"
   },
   "exports": {
     ".": {
@@ -101,6 +103,11 @@
       "import": "./dist/helper/route/index.js",
       "require": "./dist/cjs/helper/route/index.js"
     },
+    "./mount": {
+      "types": "./dist/types/middleware/mount/index.d.ts",
+      "import": "./dist/middleware/mount/index.js",
+      "require": "./dist/cjs/middleware/mount/index.js"
+    },
     "./cookie": {
       "types": "./dist/types/helper/cookie/index.d.ts",
       "import": "./dist/helper/cookie/index.js",
@@ -455,6 +462,9 @@
       "route": [
         "./dist/types/helper/route"
       ],
+      "mount": [
+        "./dist/types/middleware/mount"
+      ],
       "cookie": [
         "./dist/types/helper/cookie"
       ],
@@ -674,32 +684,30 @@
     "nodejs"
   ],
   "devDependencies": {
-    "@hono/eslint-config": "^2.1.1",
     "@hono/node-server": "^2.0.12",
     "@types/jsdom": "^21.1.7",
     "@types/node": "^24.3.0",
     "@types/ws": "^8.18.1",
     "@typescript/native-preview": "7.0.0-dev.20260210.1",
-    "@vitest/coverage-v8": "^4.1.7",
+    "@vitest/coverage-v8": "5.0.1",
     "bun-types": "^1.2.20",
     "editorconfig-checker": "6.2.0",
     "esbuild": "^0.27.1",
-    "eslint": "^9.39.3",
     "jsdom": "22.1.0",
     "msw": "^2.6.0",
     "np": "11.2.1",
-    "oxc-parser": "^0.96.0",
     "pkg-pr-new": "^0.0.53",
-    "prettier": "3.7.4",
     "publint": "0.3.15",
+    "rolldown": "^1.2.10",
     "typescript": "^6.0.3",
     "vite-plugin-fastly-js-compute": "^0.4.2",
-    "vitest": "^4.1.9",
+    "vite-plus": "1.0.0",
+    "vitest": "5.0.1",
     "wrangler": "4.107.0",
     "ws": "^8.21.0",
     "zod": "^3.23.8"
   },
-  "packageManager": "bun@1.2.20",
+  "packageManager": "pnpm@12.6.0",
   "engines": {
     "node": ">=16.9.0"
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-cursor-sdk",
-  "version": "0.4.0",
+  "version": "0.5.2",
   "description": "pi provider extension backed by @cursor/sdk local and cloud agents",
   "author": "Mitch Fultz (https://github.com/fitchmultz)",
   "license": "MIT",
@@ -120,7 +120,7 @@
     "node": ">=24"
   },
   "scripts": {
-    "check:compat": "npm run build && npm run verify && node --test test/native-provider.test.mjs",
+    "check:compat": "npm run build && npm run verify && node --test test/ci-compatibility.test.mjs test/native-provider.test.mjs test/native-cursor-flow.test.mjs test/native-cursor-prompt.test.mjs",
     "build": "node ./scripts/build.mjs",
     "prepare": "node ./scripts/prepare.mjs",
     "typecheck": "npm run typecheck:src && npm run typecheck:tests && npm run typecheck:replay-compile",
@@ -161,11 +161,11 @@
     "smoke:platform:all": "npm run smoke:platform:doctor && node scripts/platform-smoke.mjs run --target macos,ubuntu,windows-native"
   },
   "dependencies": {
-    "@cursor/sdk": "1.0.32",
-    "@hono/node-server": "2.1.1",
-    "@modelcontextprotocol/hono": "2.0.1",
-    "@modelcontextprotocol/server": "2.1.0",
-    "hono": "4.13.9"
+    "@cursor/sdk": "1.0.36",
+    "@hono/node-server": "2.1.3",
+    "@modelcontextprotocol/hono": "2.0.2",
+    "@modelcontextprotocol/server": "2.3.1",
+    "hono": "4.13.13"
   },
   "bundledDependencies": [
     "@hono/node-server",
@@ -180,18 +180,20 @@
     "typebox": "*"
   },
   "devDependencies": {
-    "@earendil-works/pi-ai": "0.87.1",
-    "@earendil-works/pi-coding-agent": "0.87.1",
-    "@earendil-works/pi-tui": "0.87.1",
-    "@modelcontextprotocol/client": "2.1.0",
-    "@types/node": "24.19.0",
+    "@connectrpc/connect": "2.2.0",
+    "@earendil-works/pi-ai": "1.0.4",
+    "@earendil-works/pi-coding-agent": "1.0.4",
+    "@earendil-works/pi-tui": "1.0.4",
+    "@modelcontextprotocol/client": "2.3.1",
+    "@types/node": "24.19.1",
     "@typescript/typescript6": "6.0.2",
     "@xterm/xterm": "6.0.0",
     "node-pty": "1.1.0",
     "playwright": "1.63.0",
-    "typebox": "1.3.34",
+    "typebox": "1.3.36",
     "typescript": "7.0.2",
-    "vitest": "5.0.2"
+    "vitest": "5.0.3",
+    "yaml": "2.9.0"
   },
   "pi": {
     "extensions": [

package/scripts/cloud-runtime-smoke.mjs

@@ -84,14 +84,16 @@ class SmokeFailure extends Error {
 }
 
 function printHelp() {
-	console.log(`Required live Cursor cloud release smoke for pi-cursor-sdk.
+	console.log(`Explicit Cursor Cloud-focused live smoke for pi-cursor-sdk.
+
+No paid Cloud testing for generic PRs/releases. Only PRs/issues explicitly focused on Cursor Cloud may select necessary focused Cloud proof after offline checks and retained-evidence reuse. Automated Cursor PR reviews continue unchanged. The multi-lane matrix is optional, not an unconditional ship gate; no automatic paid retries.
 
 Usage:
   npm run smoke:cloud
   npm run smoke:cloud:context
   node scripts/cloud-runtime-smoke.mjs [--context-matrix]
 
-The no-flag release gate creates and deletes one private throwaway GitHub repository and runs named lanes for cancel, explicit repo/startingRef branch reporting, direct push, missing branch failure, lifecycle delete, and account-conditional artifacts/raw usage. It requires current gh auth with private-repo create/push/delete access and Cursor Cloud access to that repository.
+The optional no-flag matrix creates and deletes one private throwaway GitHub repository and runs named lanes for cancel, explicit repo/startingRef branch reporting, direct push, missing branch failure, lifecycle delete, and account-conditional artifacts/raw usage. It requires current gh auth with private-repo create/push/delete access and Cursor Cloud access to that repository.
 
 Environment:
   CURSOR_API_KEY                    Required for cloud runs and verified agent cleanup.

package/scripts/lib/cursor-sdk-output-filter.d.mts

@@ -1,5 +1,6 @@
 export {
 	CURSOR_SDK_STARTUP_NOISE_PATTERNS,
+	withCursorSdkOutputNoticeHandler,
 	installCursorSdkOutputFilter,
 	isCursorSdkOutputSuppressed,
 	isCursorSdkStartupNoise,

package/scripts/lib/cursor-sdk-output-filter.mjs

@@ -1,5 +1,6 @@
 export {
 	CURSOR_SDK_STARTUP_NOISE_PATTERNS,
+	withCursorSdkOutputNoticeHandler,
 	installCursorSdkOutputFilter,
 	isCursorSdkOutputSuppressed,
 	isCursorSdkStartupNoise,

package/scripts/local-resume-smoke.mjs

@@ -473,7 +473,7 @@ async function runFallbackSmoke() {
 			const fallback = await promptAndRead({
 				rpc,
 				artifactDir: artifactRoot,
-				message: "What exact LOCAL_FALLBACK marker is visible after the missing local agent fallback? Reply exactly MARKER=<marker> if visible, otherwise NO_MARKER.",
+				message: "Repeat the exact LOCAL_FALLBACK marker from my immediately previous message in this conversation. Use only conversation history; do not use tools or inspect files. Reply exactly MARKER=<marker> if that prior message is present, otherwise NO_MARKER.",
 				timeoutMs,
 				seenMetadata,
 			});

package/scripts/platform-smoke/artifacts.mjs

@@ -324,7 +324,13 @@ function compressPlatformArtifactBundle(bundle) {
 	if (!validatePlatformArtifactBundle(bundle)) throw new Error("platform artifact bundle exceeds decoded limits");
 	const serialized = Buffer.from(JSON.stringify(bundle));
 	if (serialized.length > MAX_INFLATED_BUNDLE_JSON_BYTES) throw new Error("platform artifact bundle exceeds inflated JSON limit");
-	const compressed = gzipSync(serialized, { level: 9 });
+	let compressed;
+	try {
+		compressed = gzipSync(serialized, { level: 9, maxOutputLength: MAX_COMPRESSED_BUNDLE_BYTES });
+	} catch (error) {
+		if (error?.code === "ERR_BUFFER_TOO_LARGE") throw new Error("platform artifact bundle exceeds compressed limit");
+		throw error;
+	}
 	if (compressed.length > MAX_COMPRESSED_BUNDLE_BYTES) throw new Error("platform artifact bundle exceeds compressed limit");
 	return compressed;
 }

package/scripts/platform-smoke/card-detect.mjs

@@ -8,7 +8,6 @@
 
 import { writeFileSync, mkdirSync } from "node:fs";
 import { resolve } from "node:path";
-import { stripVTControlCharacters } from "node:util";
 import { matchesWrappedLineAt } from "./wrapped-line-match.mjs";
 
 const CARD_PATTERNS = [
@@ -35,21 +34,16 @@ const CARD_PATTERNS = [
 	{ id: "footer-status", pattern: /\bgrok-4\.6\b|\bcomposer-2-5\b|\bcomposer-2\.5\b/i },
 ];
 
-function cleanLine(line) {
-	return stripVTControlCharacters(line).replace(/\r/g, "");
-}
-
 function matchesCardAt(lines, index, card) {
 	return matchesWrappedLineAt(lines, index, card.pattern, card.wrappedPattern);
 }
 
 /**
- * Detect stable rendered evidence regions in terminal text.
+ * Detect stable evidence regions in canonical rendered xterm buffer lines.
  *
  * Returns an array of { id, label, startLine, endLine }.
  */
-export function detectCards(txtContent) {
-	const lines = txtContent.split("\n").map(cleanLine);
+export function detectCards(lines) {
 	const cards = [];
 	const seen = new Set();
 

package/scripts/platform-smoke/targets.mjs

@@ -23,7 +23,7 @@ export { isSafePlatformBundlePath as isSafeBundlePath } from "./artifacts.mjs";
 import { getScenario } from "./scenarios.mjs";
 import { warmupLease, runOnLease, stopLease } from "./crabbox-runner.mjs";
 import { renderAll } from "./render-ansi.mjs";
-import { assertRequiredCards, detectCards, writeCardArtifacts } from "./card-detect.mjs";
+import { assertRequiredCards } from "./card-detect.mjs";
 import { collectVisualEvidence } from "./visual-evidence.mjs";
 import { extractContentText, extractFinalTextContent } from "./jsonl-text.mjs";
 import { executeLocalResumeSuite } from "./local-resume-runner.mjs";
@@ -531,7 +531,6 @@ async function executeLiveSuite(config, targetName, suiteName, suiteDir, slug, l
 	const terminalAnsi = resolve(liveArtifactDir, "terminal.ansi");
 	const terminalTxt = resolve(liveArtifactDir, "terminal.txt");
 	let renderResult = { pngOk: false };
-	let cards = [];
 	if (existsSync(terminalAnsi)) {
 		renderResult = await renderAll(terminalAnsi, liveArtifactDir, {
 			label: `${targetName}-${suiteName}`,
@@ -540,17 +539,12 @@ async function executeLiveSuite(config, targetName, suiteName, suiteDir, slug, l
 			sessionId: `${targetName}-${suiteName}`,
 		});
 	}
-	if (existsSync(terminalTxt)) {
-		cards = detectCards(readFileSync(terminalTxt, "utf8"));
-		writeCardArtifacts(liveArtifactDir, cards);
-	}
 
 	const statusPath = resolve(liveArtifactDir, "live-status.json");
 	const status = readJson(statusPath);
 	const terminalText = existsSync(terminalTxt) ? readFileSync(terminalTxt, "utf8") : "";
 	const jsonlPath = resolve(liveArtifactDir, "session.jsonl");
 	const jsonlRaw = existsSync(jsonlPath) ? readFileSync(jsonlPath, "utf8") : "";
-	const cardChecks = assertRequiredCards(liveArtifactDir, cards, scenario?.requiredCards ?? []);
 	const jsonlToolNames = collectJsonlToolNames(jsonlRaw);
 	const jsonlResults = collectJsonlToolResults(jsonlRaw);
 	const usageChecks = collectUsageChecks(jsonlRaw);
@@ -586,14 +580,13 @@ async function executeLiveSuite(config, targetName, suiteName, suiteDir, slug, l
 		{ id: "bridge-diagnostic-request-resolved", fn: () => bridgeDiagnostics.some((event) => event.event === "request_resolved") },
 	] : [];
 	const visualEvidenceSpecs = scenario?.visualEvidence ?? [];
-	const visualEvidence = existsSync(resolve(liveArtifactDir, "terminal.html"))
-		? await collectVisualEvidence({
-			htmlPath: resolve(liveArtifactDir, "terminal.html"),
-			pngPath: resolve(liveArtifactDir, "terminal.full.png"),
-			outDir: liveArtifactDir,
-			specs: visualEvidenceSpecs,
-		})
-		: { ok: false, checks: [{ id: "visual-html-present", ok: false, error: "terminal.html missing" }] };
+	const visualEvidence = await collectVisualEvidence({
+		htmlPath: resolve(liveArtifactDir, "terminal.html"),
+		pngPath: resolve(liveArtifactDir, "terminal.full.png"),
+		outDir: liveArtifactDir,
+		specs: visualEvidenceSpecs,
+	});
+	const cardChecks = assertRequiredCards(liveArtifactDir, visualEvidence.cards, scenario?.requiredCards ?? []);
 	const visualEvidenceResultChecks = visualEvidenceSpecs
 		.filter((spec) => spec.jsonlResultId)
 		.map((spec) => ({

package/scripts/platform-smoke/visual-evidence.mjs

@@ -2,6 +2,7 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 import { matchesWrappedLineAt } from "./wrapped-line-match.mjs";
+import { detectCards, writeCardArtifacts } from "./card-detect.mjs";
 
 function pngSize(path) {
 	try {
@@ -39,6 +40,7 @@ export function findVisualEvidenceItems(lines, specs = []) {
 
 export async function collectVisualEvidence({ htmlPath, pngPath, outDir, specs = [] }) {
 	mkdirSync(outDir, { recursive: true });
+	let cards = [];
 	const evidence = {
 		ok: false,
 		htmlPath,
@@ -52,8 +54,9 @@ export async function collectVisualEvidence({ htmlPath, pngPath, outDir, specs =
 
 	if (!existsSync(htmlPath)) {
 		evidence.checks.push({ id: "visual-html-present", ok: false, error: "terminal.html missing" });
+		writeCardArtifacts(outDir, cards);
 		writeFileSync(resolve(outDir, "visual-evidence.json"), JSON.stringify(evidence, null, 2));
-		return evidence;
+		return { ...evidence, cards };
 	}
 
 	let browser;
@@ -99,6 +102,7 @@ export async function collectVisualEvidence({ htmlPath, pngPath, outDir, specs =
 			}
 			return out;
 		});
+		cards = detectCards(lines);
 
 		for (const item of findVisualEvidenceItems(lines, specs)) {
 			if (item.ok) {
@@ -133,6 +137,7 @@ export async function collectVisualEvidence({ htmlPath, pngPath, outDir, specs =
 		evidence.checks.push({ id: `visual-evidence-${item.id}`, ok: item.ok === true, line: item.line, screenshot: item.screenshot, pattern: item.pattern, error: item.error });
 	}
 	evidence.ok = evidence.checks.every((check) => check.ok);
+	writeCardArtifacts(outDir, cards);
 	writeFileSync(resolve(outDir, "visual-evidence.json"), JSON.stringify(evidence, null, 2));
-	return evidence;
+	return { ...evidence, cards };
 }

package/scripts/tmux-live-smoke.sh

@@ -35,6 +35,10 @@ trap cleanup EXIT
 print_help() {
 	printf '%s\n' 'Partial live smoke runner for pi-cursor-sdk (subset of docs/cursor-live-smoke-checklist.md).
 
+Use offline checks and retained evidence first. This multi-check helper is optional;
+prefer one meaningful changed-behavior check on a representative environment.
+Every direct prompt is a single attempt; no automatic paid retries.
+
 Usage:
   ./scripts/tmux-live-smoke.sh
   SMOKE_DIR=/tmp/pi-cursor-smoke ./scripts/tmux-live-smoke.sh
@@ -51,7 +55,7 @@ Prerequisites:
 
 Coverage:
   - prereq model listing
-  - basic non-interactive prompt (retry-empty-output; strict output assertion)
+  - basic non-interactive prompt (single attempt; no automatic paid retries)
   - default ambient settings prompt (strict; no retry)
   - simple non-interactive math prompt (strict; no retry)
   - interactive TUI math/footer polling with cleanup
@@ -68,7 +72,7 @@ Not covered here:
 
 Options:
   -h, --help                    Show this help.
-  --self-test                   Run sealed PATH/env probes without live Cursor auth.
+  --self-test                   Run sealed PATH/env and single-attempt probes without live Cursor auth.
 
 Exit codes:
   0  all partial checks passed
@@ -110,103 +114,27 @@ assert_file_contains() {
 	fi
 }
 
-is_empty_retryable_exit() {
-	local code="$1"
-	local stdout="$2"
-	[[ ! -s "$stdout" && ( "$code" == "0" || "$code" == "124" || "$code" == "137" || "$code" == "143" ) ]]
-}
-
-run_direct_attempt() {
-	local name="$1"
-	local timeout_secs="$2"
-	local stdout="$3"
-	local stderr="$4"
-	shift 4
-	rm -f "$stdout" "$stderr"
-
-	if run_with_timeout "$timeout_secs" "$@" </dev/null >"$stdout" 2>"$stderr"; then
-		return 0
-	fi
-	return $?
-}
-
-run_direct_fail() {
-	local name="$1"
-	local code="$2"
-	local stdout="$3"
-	local stderr="$4"
-	local label="$5"
-	if [[ "$code" != "0" ]]; then
-		cat "$stderr" >&2 || true
-		fail "$name exited $code"
-	fi
-	printf '[smoke] %s missing %s in %s\n' "$name" "$label" "$stdout" >&2
-	printf '[smoke] %s stdout tail:\n' "$name" >&2
-	tail_file "$stdout" 120 >&2
-	printf '[smoke] %s stderr tail:\n' "$name" >&2
-	tail_file "$stderr" 80 >&2
-	fail "$name missing ${label}"
-}
-
 run_direct() {
 	local name="$1"
 	local timeout_secs="$2"
-	local policy="$3"
-	local expected_pattern="$4"
-	local expected_label="$5"
-	shift 5
+	local expected_pattern="$3"
+	local expected_label="$4"
+	shift 4
 	local stdout="$SMOKE_DIR/${name}.stdout.txt"
 	local stderr="$SMOKE_DIR/${name}.stderr.txt"
 	local code=0
 
-	if run_direct_attempt "$name" "$timeout_secs" "$stdout" "$stderr" "$@"; then
+	if run_with_timeout "$timeout_secs" "$@" </dev/null >"$stdout" 2>"$stderr"; then
 		code=0
 	else
 		code=$?
 	fi
-	if [[ "$code" == "0" ]] && "$RG_BIN" -q "$expected_pattern" "$stdout"; then
-		log "$name PASS"
-		return 0
+	if [[ "$code" != "0" ]]; then
+		cat "$stderr" >&2 || true
+		fail "$name exited $code"
 	fi
-
-	case "$policy" in
-		strict)
-			run_direct_fail "$name" "$code" "$stdout" "$stderr" "$expected_label"
-			;;
-		retry-empty-output)
-			local first_stdout="$SMOKE_DIR/${name}.attempt1.stdout.txt"
-			local first_stderr="$SMOKE_DIR/${name}.attempt1.stderr.txt"
-			if ! is_empty_retryable_exit "$code" "$stdout"; then
-				run_direct_fail "$name" "$code" "$stdout" "$stderr" "$expected_label"
-			fi
-			mv "$stdout" "$first_stdout" 2>/dev/null || true
-			mv "$stderr" "$first_stderr" 2>/dev/null || true
-			log "$name retrying once after empty output with exit $code"
-			if run_direct_attempt "$name" "$timeout_secs" "$stdout" "$stderr" "$@"; then
-				local retry_code=0
-				if "$RG_BIN" -q "$expected_pattern" "$stdout"; then
-					log "$name PASS after retry (first exit $code; first stderr: $first_stderr)"
-					return 0
-				fi
-				printf '[smoke] %s retry exited %s but still missed %s\n' "$name" "$retry_code" "$expected_label" >&2
-			else
-				local retry_code=$?
-				printf '[smoke] %s retry exited %s after first empty output exit %s\n' "$name" "$retry_code" "$code" >&2
-			fi
-			printf '[smoke] %s first stdout tail:\n' "$name" >&2
-			tail_file "$first_stdout" 80 >&2
-			printf '[smoke] %s first stderr tail:\n' "$name" >&2
-			tail_file "$first_stderr" 80 >&2
-			printf '[smoke] %s retry stdout tail:\n' "$name" >&2
-			tail_file "$stdout" 120 >&2
-			printf '[smoke] %s retry stderr tail:\n' "$name" >&2
-			tail_file "$stderr" 80 >&2
-			fail "$name retry failed after empty output"
-			;;
-		*)
-			fail "$name unknown run_direct policy: $policy (expected strict or retry-empty-output)"
-			;;
-	esac
+	assert_file_contains "$name" "$stdout" "$expected_pattern" "$expected_label"
+	log "$name PASS"
 }
 
 quote_command() {
@@ -401,6 +329,45 @@ EOF_FAKE_LIST
 		fail "self-test failed: large catalog was truncated before search"
 	fi
 
+	# Exercise the real single-attempt path using an offline counting command.
+	local fake_direct="$bin_dir/direct" case_name exit_code output result
+	cat >"$fake_direct" <<'EOF_FAKE_DIRECT'
+#!/usr/bin/env bash
+printf 'called\n' >> "$1"
+printf 'retained stderr\n' >&2
+printf '%s' "$3"
+exit "$2"
+EOF_FAKE_DIRECT
+	chmod +x "$fake_direct"
+	for case_name in empty nonzero success; do
+		exit_code=0
+		output=""
+		[[ "$case_name" != "nonzero" ]] || exit_code=42
+		[[ "$case_name" == "empty" ]] || output="DIRECT_OK"
+		if ( SMOKE_DIR="$temp_dir" run_direct "$case_name" 10 DIRECT_OK DIRECT_OK "$fake_direct" "$temp_dir/$case_name.count" "$exit_code" "$output" ) >"$temp_dir/$case_name.result" 2>&1; then
+			result=0
+		else
+			result=$?
+		fi
+		[[ "$(wc -l <"$temp_dir/$case_name.count" | tr -d ' ')" == "1" ]] || fail "self-test failed: $case_name repeated the command"
+		[[ -f "$temp_dir/$case_name.stdout.txt" ]] || fail "self-test failed: $case_name lost stdout artifact"
+		grep -qx 'retained stderr' "$temp_dir/$case_name.stderr.txt" || fail "self-test failed: $case_name lost stderr artifact"
+		case "$case_name" in
+			empty)
+				[[ "$result" == "1" && ! -s "$temp_dir/$case_name.stdout.txt" ]] || fail "self-test failed: empty output did not fail"
+				grep -q 'missing DIRECT_OK' "$temp_dir/$case_name.result" || fail "self-test failed: empty output lost marker failure"
+				;;
+			nonzero)
+				[[ "$result" == "1" ]] || fail "self-test failed: nonzero command did not fail"
+				grep -q 'exited 42' "$temp_dir/$case_name.result" || fail "self-test failed: command exit code was lost"
+				;;
+			success)
+				[[ "$result" == "0" ]] || fail "self-test failed: valid output did not pass"
+				;;
+		esac
+		[[ "$case_name" == "empty" ]] || grep -qx DIRECT_OK "$temp_dir/$case_name.stdout.txt" || fail "self-test failed: $case_name lost output"
+	done
+
 	printf '[smoke] self-test PASS\n'
 }
 
@@ -451,19 +418,19 @@ log "partial live smoke: prereq, basic, default-settings, noninteractive-math, t
 capture_and_require_default_model "${NONE_ENV[@]}" "${PI_BASE[@]}" --list-models cursor
 log "prereq PASS"
 
-run_direct basic 600 retry-empty-output "PI_CURSOR_SMOKE_OK" "PI_CURSOR_SMOKE_OK" \
+run_direct basic 600 "PI_CURSOR_SMOKE_OK" "PI_CURSOR_SMOKE_OK" \
 	"${NONE_ENV[@]}" "${PI_BASE[@]}" \
 	--session-dir "$SMOKE_DIR/basic" \
 	--no-tools \
 	-p 'Live smoke. Reply exactly: PI_CURSOR_SMOKE_OK'
 
-run_direct default-settings 300 strict "PRODUCT=42" "PRODUCT=42" \
+run_direct default-settings 300 "PRODUCT=42" "PRODUCT=42" \
 	"${DEFAULT_ENV[@]}" "${PI_BASE[@]}" \
 	--session-dir "$SMOKE_DIR/default-settings" \
 	--no-tools \
 	-p 'Default settings smoke. Include PRODUCT=42 in the final answer.'
 
-run_direct noninteractive-math 300 strict "SUM=42" "SUM=42" \
+run_direct noninteractive-math 300 "SUM=42" "SUM=42" \
 	"${NONE_ENV[@]}" "${PI_BASE[@]}" \
 	--session-dir "$SMOKE_DIR/noninteractive-math" \
 	--no-tools \

package/shared/cursor-sdk-output-filter.d.mts

@@ -1,5 +1,8 @@
 export declare const CURSOR_SDK_STARTUP_NOISE_PATTERNS: readonly string[];
+export type CursorSdkCapabilityNotice = "outsidePlugin" | "parserUnavailable";
+export type CursorSdkOutputNoticeHandler = (kind: CursorSdkCapabilityNotice, message: string) => void | boolean;
 export declare function isCursorSdkOutputSuppressed(): boolean;
 export declare function suppressCursorSdkOutput<T>(operation: () => T): T;
+export declare function withCursorSdkOutputNoticeHandler<T>(handler: CursorSdkOutputNoticeHandler | undefined, operation: () => T): T;
 export declare function isCursorSdkStartupNoise(text: string): boolean;
 export declare function installCursorSdkOutputFilter(): () => void;