pi-cursor-sdk 0.2.0 → 0.3.7

package/scripts/cloud-runtime-smoke.mjs

@@ -10,6 +10,7 @@ import { tmpdir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { terminateChild } from "./lib/cursor-child-process.mjs";
+import { ensureBuilt } from "./lib/ensure-built.mjs";
 import { buildCursorSmokeEnv } from "./lib/cursor-smoke-env.mjs";
 import {
 	checkpointCloudSmokeShutdown,
@@ -50,7 +51,7 @@ import { scrubSensitiveText } from "../shared/cursor-sensitive-text.mjs";
 
 const root = resolve(dirname(fileURLToPath(import.meta.url)), "..");
 const EVIDENCE_PATH = join(root, "docs", "evidence", "cursor-cloud-smoke-matrix-latest.json");
-const MODEL = "cursor/composer-2-5";
+const MODEL = "cursor/grok-4.6";
 const CLOUD_RUN_ID_PATTERN = /^run-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 const cloudSmokeShutdown = createCloudSmokeShutdownController((child) => terminateChild(child, { graceMs: 15_000 }));
 const argv = process.argv.slice(2);
@@ -614,6 +615,7 @@ async function main() {
 }
 
 if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+	ensureBuilt();
 	main().catch((error) => {
 		reportFailure(error);
 		process.exit(1);

package/scripts/debug-provider-events.mjs

@@ -23,6 +23,7 @@ import {
 } from "./lib/cursor-child-process.mjs";
 import { scrubSensitiveText } from "../shared/cursor-sensitive-text.mjs";
 import { createScriptFail } from "./lib/cursor-script-fail.mjs";
+import { ensureBuilt } from "./lib/ensure-built.mjs";
 import { serializeCursorSettingSources } from "../shared/cursor-setting-sources.mjs";
 
 function isMainModule() {
@@ -35,7 +36,7 @@ function isMainModule() {
 const require = createRequire(import.meta.url);
 const root = fileURLToPath(new URL("..", import.meta.url));
 const packageJson = require("../package.json");
-const DEFAULT_MODEL = "cursor/composer-2-5";
+const DEFAULT_MODEL = "cursor/grok-4.6";
 const DEFAULT_OUT_BASE = ".debug/cursor-sdk-events";
 const SDK_EVENT_DEBUG_LOG_PREFIX = "[pi-cursor-sdk:sdk-events]";
 const PI_SESSION_SNAPSHOT_ARTIFACT = "pi-session-snapshot.jsonl";
@@ -301,6 +302,7 @@ async function main(argv = process.argv.slice(2), env = process.env) {
 		printHelp();
 		return;
 	}
+	ensureBuilt();
 	console.log(JSON.stringify(await runDebugProviderEvents(args, env)));
 }
 

package/scripts/debug-sdk-events.mjs

@@ -39,7 +39,7 @@ const ARTIFACTS = {
 	summary: "summary.json",
 };
 
-const DEFAULT_MODEL = "composer-2.5";
+const DEFAULT_MODEL = "grok-4.6";
 const RAW_ARTIFACT_WARNING =
 	"Raw artifact files may contain local paths, project text, tool args/results, or secrets from the workspace. Do not commit or share them.";
 

package/scripts/isolated-cursor-smoke.sh

@@ -134,7 +134,7 @@ run_self_test() {
 	env_capture="$temp_dir/fake-pi.env"
 	cat >"$fake_pi" <<EOF_SELFTEST_PI
 #!/usr/bin/env node
-const { writeFileSync } = require("node:fs");
+import { writeFileSync } from "node:fs";
 writeFileSync("$env_capture", Object.entries(process.env).map(([key, value]) => key + "=" + (value ?? "")).join("\\n") + "\\n", "utf8");
 EOF_SELFTEST_PI
 	cat >"$fake_node" <<EOF_SELFTEST_NODE
@@ -359,13 +359,14 @@ log "check: list-models"
 LIST_OUT="$ISOLATED/list-models.txt"
 run_in_dir_capture_combined "list-models" 30 "$PROJECT_DIR" "$LIST_OUT" "${PI_CURSOR_ENV[@]}" \
 	"$PI_BIN" --approve --cursor-no-fast --list-models cursor
+"$RG_BIN" -q "grok-4\\.6" "$LIST_OUT" || fail "grok-4.6 not listed (see $LIST_OUT)"
 "$RG_BIN" -q "composer-2\\.5|composer-2-5" "$LIST_OUT" || fail "composer-2-5 not listed (see $LIST_OUT)"
 
 log "check: basic provider prompt"
 BASIC_DIR="$SESSION_ROOT/basic"
 mkdir -p "$BASIC_DIR"
 run_in_dir_capture_split "basic prompt" "$PI_LIVE_TIMEOUT" "$PROJECT_DIR" "$ISOLATED/basic.stdout.txt" "$ISOLATED/basic.stderr.txt" "${PI_CURSOR_ENV[@]}" \
-	"$PI_BIN" --approve --cursor-no-fast --model cursor/composer-2-5 --session-dir "$BASIC_DIR" --no-tools -p 'Reply exactly: PI_CURSOR_ISOLATED_OK'
+	"$PI_BIN" --approve --cursor-no-fast --model cursor/grok-4.6 --session-dir "$BASIC_DIR" --no-tools -p 'Reply exactly: PI_CURSOR_ISOLATED_OK'
 "$RG_BIN" -q "PI_CURSOR_ISOLATED_OK" "$ISOLATED/basic.stdout.txt" || fail "basic prompt missing PI_CURSOR_ISOLATED_OK"
 validate_replay_jsonl "$BASIC_DIR"
 
@@ -373,14 +374,14 @@ log "check: native replay"
 REPLAY_DIR="$SESSION_ROOT/native-replay"
 mkdir -p "$REPLAY_DIR"
 run_in_dir_capture_split "native replay" "$PI_LIVE_TIMEOUT" "$PROJECT_DIR" "$ISOLATED/replay.stdout.txt" "$ISOLATED/replay.stderr.txt" "${PI_CURSOR_ENV[@]}" PI_CURSOR_NATIVE_TOOL_DISPLAY=1 \
-	"$PI_BIN" --approve --cursor-no-fast --model cursor/composer-2-5 --session-dir "$REPLAY_DIR" -p 'Read ./README.md briefly, then answer README_SEEN=yes if it mentions pi-cursor-sdk.'
+	"$PI_BIN" --approve --cursor-no-fast --model cursor/grok-4.6 --session-dir "$REPLAY_DIR" -p 'Read ./README.md briefly, then answer README_SEEN=yes if it mentions pi-cursor-sdk.'
 validate_replay_jsonl "$REPLAY_DIR"
 
 log "check: plan-strip shim (plan-mode execute reset)"
 PLAN_DIR="$SESSION_ROOT/plan-strip"
 mkdir -p "$PLAN_DIR"
 run_in_dir_capture_split "plan-strip replay" "$PI_LIVE_TIMEOUT" "$PROJECT_DIR" "$ISOLATED/plan.stdout.txt" "$ISOLATED/plan.stderr.txt" "${PI_CURSOR_ENV[@]}" PI_CURSOR_NATIVE_TOOL_DISPLAY=1 \
-	"$PI_BIN" --approve -e "$SHIM_DIR" --cursor-no-fast --model cursor/composer-2-5 --session-dir "$PLAN_DIR" -p 'After reset, read README.md and answer PLAN_STRIP_OK=yes.'
+	"$PI_BIN" --approve -e "$SHIM_DIR" --cursor-no-fast --model cursor/grok-4.6 --session-dir "$PLAN_DIR" -p 'After reset, read README.md and answer PLAN_STRIP_OK=yes.'
 validate_replay_jsonl "$PLAN_DIR"
 
 log "PASS isolated install smoke: $ISOLATED"

package/scripts/lib/cloud-smoke-cleanup-evidence.mjs

@@ -360,7 +360,7 @@ function buildCloudSmokeMatrixEvidence(input, laneProjector, allowDefaultTimesta
 	} = data;
 	const timestamp = data.timestamp ?? (allowDefaultTimestamp ? new Date().toISOString() : undefined);
 	if (schemaVersion !== 1) fail("cloud smoke evidence schemaVersion must be 1");
-	if (model !== "cursor/composer-2-5") fail("cloud smoke evidence model must be cursor/composer-2-5");
+	if (model !== "cursor/grok-4.6") fail("cloud smoke evidence model must be cursor/grok-4.6");
 	if (!Array.isArray(lanes) || lanes.length !== LANE_NAMES.length) fail("cloud smoke evidence lanes must contain the complete required matrix");
 	if (!Array.isArray(cleanup) || cleanup.length === 0) fail("cloud smoke evidence cleanup must be a non-empty array");
 	const projectedLanes = lanes.map((lane, index) => laneProjector(lane, index));

package/scripts/lib/cursor-visual-render.mjs

@@ -66,7 +66,7 @@ header code { color: #d8dee9; }
 <header>
 	<div><strong>pi-cursor-sdk visual smoke</strong> <code>${escapeHtml(options.label)}</code></div>
 	<div>model <code>${escapeHtml(options.model)}</code> · mode <code>${escapeHtml(options.mode)}</code> · cwd <code>${escapeHtml(options.cwd)}</code></div>
-	<div>session <code>${escapeHtml(options.sessionId)}</code> · captured ${new Date().toISOString()}</div>
+	<div>session <code>${escapeHtml(options.sessionId ?? "pi-assigned")}</code> · captured ${new Date().toISOString()}</div>
 </header>
 <div id="terminal"></div>
 <noscript><pre class="fallback">${escapeHtml(plain)}</pre></noscript>

package/scripts/lib/ensure-built.mjs

@@ -0,0 +1,16 @@
+/**
+ * Rebuild dist/ before a launcher loads the repo-root extension, so direct
+ * `node scripts/<launcher>.mjs` invocations can never exercise stale code.
+ */
+
+import { execFileSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+
+export function ensureBuilt() {
+	execFileSync(process.execPath, [fileURLToPath(new URL("../build.mjs", import.meta.url))], {
+		// build.mjs anchors tsc/dist/staging to its cwd; pin it to the repo root so
+		// direct launcher invocations work from any directory.
+		cwd: fileURLToPath(new URL("../..", import.meta.url)),
+		stdio: "inherit",
+	});
+}

package/scripts/lib/local-resume-smoke-harness.mjs

@@ -152,7 +152,7 @@ export function startRpc({
 	baseEnv = process.env,
 }) {
 	const model =
-		process.env.CURSOR_LOCAL_RESUME_SMOKE_MODEL || "cursor/composer-2-5:slow";
+		process.env.CURSOR_LOCAL_RESUME_SMOKE_MODEL || "cursor/grok-4.6:slow";
 	const workspaceDir = join(artifactDir, "workspace");
 	mkdirSync(workspaceDir, { recursive: true });
 	const pi = findPiCommand();

package/scripts/local-resume-smoke.mjs

@@ -26,6 +26,7 @@ import {
 	withRpc,
 	writeTreeCommandExtension,
 } from "./lib/local-resume-smoke-harness.mjs";
+import { ensureBuilt } from "./lib/ensure-built.mjs";
 import { runCleanupSmoke } from "./local-resume-cleanup-smoke.mjs";
 import { writePlatformArtifactBundle } from "./platform-smoke/artifacts.mjs";
 import { LOCAL_RESUME_SUITES } from "./platform-smoke/local-resume-suites.mjs";
@@ -45,7 +46,7 @@ ${npmUsage}
 ${nodeUsage}
 
 Environment:
-  CURSOR_LOCAL_RESUME_SMOKE_MODEL          Cursor model id (default: cursor/composer-2-5:slow).
+  CURSOR_LOCAL_RESUME_SMOKE_MODEL          Cursor model id (default: cursor/grok-4.6:slow).
   CURSOR_LOCAL_RESUME_SMOKE_TIMEOUT_MS     Timeout in ms per model turn (default: 300000).
   CURSOR_LOCAL_RESUME_SMOKE_KEEP_ARTIFACTS Keep temp artifacts when set to 1.
   CURSOR_LOCAL_RESUME_SMOKE_EXTENSION_PATH Packed extension path override (platform runner only).
@@ -627,6 +628,7 @@ function selectedRun() {
 }
 
 if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+	ensureBuilt();
 	const run = selectedRun();
 	run()
 		.catch((error) => {

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

@@ -31,7 +31,7 @@ const CARD_PATTERNS = [
 	{ id: "bridge-read-failure", pattern: /^\s*(?:read \.\/definitely-missing-platform-smoke-file\.txt|ENOENT: no such file)\s*/i },
 	{ id: "bridge-shell-success", pattern: /^\s*bridge visual smoke\s*$/i },
 	{ id: "http1-status", pattern: /\bcursor:local\b.*\bhttp1\b/i },
-	{ id: "footer-status", pattern: /\bcomposer-2-5\b|\bcomposer-2\.5\b/i },
+	{ id: "footer-status", pattern: /\bgrok-4\.6\b|\bcomposer-2-5\b|\bcomposer-2\.5\b/i },
 ];
 
 function cleanLine(line) {

package/scripts/platform-smoke/live-suite-runner.mjs

@@ -17,7 +17,7 @@ import { redactSecrets, writePlatformArtifactBundle } from "./artifacts.mjs";
 import { extractContentText, jsonlHasAssistantFinalTextMarker } from "./jsonl-text.mjs";
 import { getScenario, renderPrompt } from "./scenarios.mjs";
 
-const DEFAULT_MODEL = "cursor/composer-2-5";
+const DEFAULT_MODEL = "cursor/grok-4.6";
 const DEFAULT_WAIT_MS = 240_000;
 const SESSION_JSONL_WAIT_MS = 60_000;
 const COLS = 150;

package/scripts/platform-smoke/render-ansi.mjs

@@ -27,7 +27,7 @@ export async function renderHTML(ansiPath, htmlPath, options = {}) {
 		plain,
 		options: {
 			label: options.label ?? "platform-smoke",
-			model: options.model ?? "cursor/composer-2-5",
+			model: options.model ?? "cursor/grok-4.6",
 			mode: options.mode ?? "agent",
 			cwd: options.cwd ?? process.cwd(),
 			sessionId: options.sessionId ?? "platform-smoke",

package/scripts/platform-smoke/targets.mjs

@@ -413,7 +413,7 @@ export function buildPlatformBuildCommand(targetName, packageName = "pi-cursor-s
 		lines.push(...posixSection("CHECK_PLATFORM_SMOKE_STDERR", 'cat "$PACK_DIR/check-platform-smoke.stderr.txt" 2>/dev/null || true'));
 		lines.push("");
 		lines.push('echo "=== npm test ==="');
-		lines.push('npm test >"$PACK_DIR/npm-test.stdout.txt" 2>"$PACK_DIR/npm-test.stderr.txt"');
+		lines.push('npm test -- --testTimeout=15000 >"$PACK_DIR/npm-test.stdout.txt" 2>"$PACK_DIR/npm-test.stderr.txt"');
 		lines.push("TEST_EXIT=$?");
 		lines.push('echo "PLATFORM_NPM_TEST_EXIT=$TEST_EXIT"');
 		lines.push(...posixSection("NPM_TEST_STDOUT", 'cat "$PACK_DIR/npm-test.stdout.txt" 2>/dev/null || true'));
@@ -662,7 +662,7 @@ async function executeLiveSuite(config, targetName, suiteName, suiteDir, slug, l
 }
 
 function buildLiveSuiteCommand(config, targetName, suiteName, prepDir) {
-	const model = config.cursorModel ?? "cursor/composer-2-5";
+	const model = config.cursorModel ?? "cursor/grok-4.6";
 	const packageName = config.packageName ?? "pi-cursor-sdk";
 	const prepArgs = prepDir ? ` --prep-dir ${platformFor(targetName) === "powershell" ? prepDir : shellQuote(prepDir)}` : "";
 	if (platformFor(targetName) === "powershell") {

package/scripts/prepare.mjs

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+/**
+ * Purpose: Build generated dist output for GitHub/source installs even when Pi invokes npm install --omit=dev.
+ * Responsibilities: Detect missing source-build dependencies via the local node_modules tree, install dev
+ * dependencies with lifecycle scripts disabled, run the canonical build, then prune the dev tree so installs
+ * keep a runtime-only footprint.
+ * Scope: Package install lifecycle only; runtime behavior remains owned by scripts/build.mjs.
+ * Usage: package.json prepare script.
+ */
+
+import { execFile as execFileCallback } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import process from "node:process";
+import { promisify } from "node:util";
+
+const execFile = promisify(execFileCallback);
+
+// Checked as literal node_modules paths: require.resolve() is unusable here because
+// several @earendil-works packages expose import-only "exports" maps and throw
+// ERR_PACKAGE_PATH_NOT_EXPORTED even when installed.
+const REQUIRED_SOURCE_BUILD_MODULES = [
+	"typescript",
+	"typebox",
+	"@earendil-works/pi-ai",
+	"@earendil-works/pi-coding-agent",
+	"@earendil-works/pi-tui",
+];
+
+function hasBuildDependencies() {
+	return REQUIRED_SOURCE_BUILD_MODULES.every((moduleName) =>
+		existsSync(join(process.cwd(), "node_modules", ...moduleName.split("/"), "package.json")),
+	);
+}
+
+async function runNpm(args) {
+	const npmExecPath = process.env.npm_execpath;
+	if (!npmExecPath) {
+		throw new Error(
+			`npm_execpath is not set; run "npm ${args.join(" ")}" manually in ${process.cwd()} and retry.`,
+		);
+	}
+	// No shell: process.execPath runs npm's cli.js directly, which is safe for paths
+	// containing spaces on every platform (shell:true concatenates args unescaped).
+	await execFile(process.execPath, [npmExecPath, ...args], {
+		cwd: process.cwd(),
+		maxBuffer: 20 * 1024 * 1024,
+	});
+}
+
+async function runBuild() {
+	const { stderr, stdout } = await execFile(process.execPath, [join(process.cwd(), "scripts", "build.mjs")], {
+		cwd: process.cwd(),
+		maxBuffer: 20 * 1024 * 1024,
+	});
+	// Forward build output on success too: install-time diagnostics such as the
+	// concurrent-swap race-loss warning are otherwise swallowed.
+	if (stdout) process.stdout.write(stdout);
+	if (stderr) process.stderr.write(stderr);
+}
+
+async function pruneDevDependencies() {
+	await runNpm(["prune", "--omit=dev", "--ignore-scripts"]);
+}
+
+async function pruneQuietly() {
+	try {
+		await pruneDevDependencies();
+	} catch (error) {
+		console.warn(`npm prune failed after a failed build: ${error?.message ?? error}`);
+	}
+}
+
+function reportError(error) {
+	if (error?.stdout) process.stdout.write(error.stdout);
+	if (error?.stderr) process.stderr.write(error.stderr);
+	console.error(error instanceof Error ? error.message : String(error));
+}
+
+async function main() {
+	if (hasBuildDependencies()) {
+		await runBuild();
+		return;
+	}
+	await runNpm(["install", "--include=dev", "--ignore-scripts"]);
+	try {
+		await runBuild();
+	} catch (buildError) {
+		// Report the build first; cleanup can warn afterward but never mask it.
+		reportError(buildError);
+		await pruneQuietly();
+		process.exitCode = 1;
+		return;
+	}
+	// A prune failure after a successful build still fails the install.
+	await pruneDevDependencies();
+}
+
+main().catch((error) => {
+	reportError(error);
+	process.exitCode = 1;
+});

package/scripts/steering-rpc-smoke.mjs

@@ -16,6 +16,7 @@ import {
 } from "./lib/cursor-child-process.mjs";
 import { apiKeySecretsFromProcess } from "./lib/cursor-cli-args.mjs";
 import { buildCursorSmokeEnv, CURSOR_SDK_EVENT_DEBUG_ENV_NAMES } from "./lib/cursor-smoke-env.mjs";
+import { ensureBuilt } from "./lib/ensure-built.mjs";
 import { scrubSensitiveText } from "../shared/cursor-sensitive-text.mjs";
 
 const root = fileURLToPath(new URL("..", import.meta.url));
@@ -170,7 +171,7 @@ function buildPiRpcEnv(baseEnv = process.env, nodePath = process.execPath) {
 }
 
 async function runPiRpcSmoke(sessionDir, piBin) {
-	const args = ["--approve", "-e", root, "--cursor-no-fast", "--model", "cursor/composer-2-5", "--mode", "rpc", "--session-dir", sessionDir];
+	const args = ["--approve", "-e", root, "--cursor-no-fast", "--model", "cursor/grok-4.6", "--mode", "rpc", "--session-dir", sessionDir];
 	const env = buildPiRpcEnv();
 
 	const child = spawn(piBin, args, {
@@ -263,7 +264,7 @@ async function runSelfTest() {
 		const envCapture = join(tempDir, "fake-pi.env");
 		writeFileSync(
 			fakePi,
-			`#!/usr/bin/env node\nconst { writeFileSync } = require("node:fs");\nwriteFileSync(${JSON.stringify(envCapture)}, Object.entries(process.env).map(([key, value]) => key + "=" + (value ?? "")).join("\\n") + "\\n", "utf8");\n`,
+			`#!/usr/bin/env node\nimport { writeFileSync } from "node:fs";\nwriteFileSync(${JSON.stringify(envCapture)}, Object.entries(process.env).map(([key, value]) => key + "=" + (value ?? "")).join("\\n") + "\\n", "utf8");\n`,
 			"utf8",
 		);
 		writeFileSync(fakeNode, `#!/bin/sh\necho fake-node-used > ${JSON.stringify(fakeNodeMarker)}\nexit 99\n`, "utf8");
@@ -332,6 +333,7 @@ async function main() {
 		printHelp();
 		return;
 	}
+	ensureBuilt();
 	if (process.argv.includes("--self-test")) {
 		await runSelfTest();
 		return;

package/scripts/tmux-live-smoke.sh

@@ -243,7 +243,7 @@ exec %s
 		"$TMUX_BIN" capture-pane -pt "$session" >"$capture" 2>/dev/null || true
 		missing=""
 		"$RG_BIN" -q "SUM=42" "$capture" || missing="${missing} SUM=42"
-		"$RG_BIN" -q "\\(cursor\\) composer-2[-.]5" "$capture" || missing="${missing} footer (cursor) composer-2-5"
+		"$RG_BIN" -q "\\(cursor\\) grok-4\\.6" "$capture" || missing="${missing} footer (cursor) grok-4.6"
 		if [[ -z "$missing" ]]; then
 			"$TMUX_BIN" kill-session -t "$session" 2>/dev/null || true
 			log "$name PASS"
@@ -311,14 +311,14 @@ printf '\''%%s\n'\'' "$code" > %q
 model_listed() {
 	local file="$1"
 	if [[ -n "${RG_BIN:-}" ]]; then
-		"$RG_BIN" -q "composer-2\.5" "$file"
+		"$RG_BIN" -q "grok-4\.6" "$file"
 	else
-		grep -q "composer-2\.5" "$file"
+		grep -q "grok-4\.6" "$file"
 	fi
 }
 
 # Capture full catalog then search. Never pipe list-models into rg -q under pipefail.
-capture_and_require_composer_model() {
+capture_and_require_default_model() {
 	local list_cmd=("$@")
 	local models_out="$SMOKE_DIR/prereq.models.txt"
 	local models_err="$SMOKE_DIR/prereq.stderr.txt"
@@ -326,7 +326,7 @@ capture_and_require_composer_model() {
 		fail "pi --list-models cursor failed"
 	fi
 	if ! model_listed "$models_out" && ! model_listed "$models_err"; then
-		fail "cursor/composer-2-5 not listed"
+		fail "cursor/grok-4.6 not listed"
 	fi
 }
 
@@ -343,7 +343,7 @@ run_self_test() {
 	env_capture="$temp_dir/fake-pi.env"
 	cat >"$fake_pi" <<EOF_SELFTEST_PI
 #!/usr/bin/env node
-const { writeFileSync } = require("node:fs");
+import { writeFileSync } from "node:fs";
 writeFileSync("$env_capture", Object.entries(process.env).map(([key, value]) => key + "=" + (value ?? "")).join("\\n") + "\\n", "utf8");
 EOF_SELFTEST_PI
 	cat >"$fake_node" <<EOF_SELFTEST_NODE
@@ -383,7 +383,7 @@ EOF_SELFTEST_NODE
 	if grep -q '^PI_CURSOR_SETTING_SOURCES=' "$env_capture"; then
 		fail "self-test failed: default-settings env did not unset PI_CURSOR_SETTING_SOURCES"
 	fi
-	# Large-catalog prereq: exercise the same capture_and_require_composer_model helper.
+	# Large-catalog prereq: exercise the same capture_and_require_default_model helper.
 	fake_list_pi="$bin_dir/pi-list-models"
 	cat >"$fake_list_pi" <<'EOF_FAKE_LIST'
 #!/usr/bin/env bash
@@ -392,11 +392,11 @@ while [[ $i -lt 20000 ]]; do
 	printf 'cursor/model-%s\n' "$i"
 	i=$((i + 1))
 done
-printf 'cursor/composer-2.5\n'
+printf 'cursor/grok-4.6\n'
 exit 0
 EOF_FAKE_LIST
 	chmod +x "$fake_list_pi"
-	SMOKE_DIR="$temp_dir" capture_and_require_composer_model "$fake_list_pi"
+	SMOKE_DIR="$temp_dir" capture_and_require_default_model "$fake_list_pi"
 	if [[ "$(wc -l <"$temp_dir/prereq.models.txt" | tr -d ' ')" -lt 20000 ]]; then
 		fail "self-test failed: large catalog was truncated before search"
 	fi
@@ -428,7 +428,7 @@ fi
 PI_BASE=(
 	"$PI_BIN" --approve -e "$ROOT"
 	--cursor-no-fast
-	--model cursor/composer-2-5
+	--model cursor/grok-4.6
 )
 
 if [[ -z "${CURSOR_API_KEY:-}" ]]; then
@@ -448,7 +448,7 @@ log "partial live smoke: prereq, basic, default-settings, noninteractive-math, t
 "${BASE_ENV[@]}" "$PI_BIN" --version | tee "$SMOKE_DIR/prereq.pi-version.txt"
 "${BASE_ENV[@]}" "$NPM_BIN" --prefix "$ROOT" ls @cursor/sdk @earendil-works/pi-coding-agent @earendil-works/pi-ai @earendil-works/pi-tui | tee "$SMOKE_DIR/prereq.npm-ls.txt"
 
-capture_and_require_composer_model "${NONE_ENV[@]}" "${PI_BASE[@]}" --list-models cursor
+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" \

package/scripts/visual-tui-smoke-self-test.mjs

@@ -35,7 +35,7 @@ export function runVisualSmokeSelfTest(deps) {
 		const envCapture = join(tempDir, "fake-pi.env");
 		writeFileSync(
 			fakePi,
-			`#!/usr/bin/env node\nconst { writeFileSync } = require("node:fs");\nwriteFileSync(${JSON.stringify(envCapture)}, Object.entries(process.env).map(([key, value]) => key + "=" + (value ?? "")).join("\\n") + "\\n", "utf8");\n`,
+			`#!/usr/bin/env node\nimport { writeFileSync } from "node:fs";\nwriteFileSync(${JSON.stringify(envCapture)}, Object.entries(process.env).map(([key, value]) => key + "=" + (value ?? "")).join("\\n") + "\\n", "utf8");\n`,
 			"utf8",
 		);
 		writeFileSync(fakeNode, `#!/bin/sh\necho fake-node-used > ${shellQuote(fakeNodeMarker)}\nexit 99\n`, "utf8");
@@ -89,6 +89,9 @@ export function runVisualSmokeSelfTest(deps) {
 		assertSelfTest(defaults.get("PI_CURSOR_SETTING_SOURCES") === "none", "setting sources must default to none");
 		assertSelfTest(defaults.get("PI_CURSOR_PI_TOOL_BRIDGE") === "0", "bridge must default off");
 		assertSelfTest(defaults.get("PI_CURSOR_EXPOSE_BUILTIN_TOOLS") === "0", "built-in exposure must default off");
+		assertSelfTest(defaults.get("PI_CODING_AGENT_DIR") === join(tempDir, "pi-agent"), "agent dir must be isolated under out-dir");
+		assertSelfTest(defaults.get("PI_OFFLINE") === "1", "startup network operations must be off");
+		assertSelfTest(defaults.get("PI_SKIP_VERSION_CHECK") === "1", "pi.dev version check must be off");
 		for (const name of DEBUG_ENV_NAMES) {
 			assertSelfTest(plan.clearEnvNames.includes(name), `${name} must be cleared by default`);
 		}

package/scripts/visual-tui-smoke.mjs

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { spawnSync } from "node:child_process";
-import { accessSync, constants, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { accessSync, chmodSync, constants, copyFileSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
 import { delimiter, dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { commonBooleanFlag, commonRepeatStringFlag, parseArgv } from "./lib/cursor-cli-args.mjs";
@@ -15,7 +16,7 @@ const DEFAULT_HEIGHT = 45;
 const DEFAULT_WAIT_MS = 60_000;
 const DEFAULT_STARTUP_MS = 5_000;
 const DEFAULT_HISTORY_LINES = 3_000;
-const DEFAULT_MODEL = "cursor/composer-2-5";
+const DEFAULT_MODEL = "cursor/grok-4.6";
 const DEFAULT_MODE = "plan";
 const DEFAULT_SETTING_SOURCES = "none";
 const DEBUG_ENV_NAMES = CURSOR_SDK_EVENT_DEBUG_ENV_NAMES;
@@ -44,7 +45,7 @@ Common options:
   --model MODEL                 Cursor model. Default: ${DEFAULT_MODEL}.
   --mode agent|plan             Cursor SDK mode. Default: ${DEFAULT_MODE}.
   --session-dir PATH            pi session directory. Default: <out-dir>/<label>.session.
-  --session-id ID               pi session id. Default: visual-<label>-<timestamp>.
+  --session-id ID               pi session id; pass to resume a prior capture session. Default: pi-assigned, so fresh captures avoid the new-session warning line.
   --width N                     PTY columns. Default: ${DEFAULT_WIDTH}.
   --height N                    PTY rows. Default: ${DEFAULT_HEIGHT}.
   --history-lines N             tmux capture history lines. Default: ${DEFAULT_HISTORY_LINES}.
@@ -63,7 +64,11 @@ Native replay isolation defaults:
   PI_CURSOR_SETTING_SOURCES=none
   PI_CURSOR_PI_TOOL_BRIDGE=0
   PI_CURSOR_EXPOSE_BUILTIN_TOOLS=0
+  PI_CODING_AGENT_DIR=<out-dir>/pi-agent  (seeded auth.json + quietStartup; host extensions stay out)
+  PI_OFFLINE=1
+  PI_SKIP_VERSION_CHECK=1
   TERM=xterm-256color
+  tmux starts in --cwd with a non-login shell so a stale tmux-server cwd cannot print getcwd errors
   Debug artifact env is cleared before each run; --event-debug sets a deterministic debug dir.
 
 Artifacts written:
@@ -194,10 +199,26 @@ function parseArgs(argv) {
 	options.safeLabel = sanitizeLabel(options.label);
 	options.outDir ??= resolve(`/tmp/pi-cursor-sdk-visual-smoke-${timestamp()}`);
 	options.sessionDir ??= resolve(options.outDir, `${options.safeLabel}.session`);
-	options.sessionId ??= `visual-${options.safeLabel}-${Date.now()}`;
+	options.agentDir ??= resolve(options.outDir, "pi-agent");
 	return options;
 }
 
+function seedVisualAgentDir(agentDir) {
+	mkdirSync(agentDir, { recursive: true });
+	const srcAuth = join(homedir(), ".pi", "agent", "auth.json");
+	const destAuth = join(agentDir, "auth.json");
+	try {
+		copyFileSync(srcAuth, destAuth);
+		chmodSync(destAuth, 0o600);
+	} catch {
+		// CURSOR_API_KEY remains the fallback when host auth.json is absent.
+	}
+	writeFileSync(
+		join(agentDir, "settings.json"),
+		`${JSON.stringify({ quietStartup: true, enableInstallTelemetry: false })}\n`,
+	);
+}
+
 function sanitizeLabel(label) {
 	const safe = label.trim().replace(/[^A-Za-z0-9_.-]+/g, "-").replace(/^-+|-+$/g, "");
 	return safe || "visual-smoke";
@@ -359,7 +380,13 @@ function buildLaunchPlan(options, commands, shell) {
 		eventDebugDir: options.eventDebug ? resolve(options.outDir, `${options.safeLabel ?? "visual-smoke"}.cursor-sdk-events`) : undefined,
 	});
 	const sealedPath = commands.sealedPath ?? smokeEnvPlan.sealedPath;
-	const envAssignments = smokeEnvPlan.envEntries;
+	const agentDir = options.agentDir ?? resolve(options.outDir, "pi-agent");
+	const envAssignments = [
+		...smokeEnvPlan.envEntries,
+		["PI_CODING_AGENT_DIR", agentDir],
+		["PI_OFFLINE", "1"],
+		["PI_SKIP_VERSION_CHECK", "1"],
+	];
 	const clearEnvNames = smokeEnvPlan.clearEnvNames;
 	const command = [
 		...envAssignments.map(([name, value]) => `${name}=${shellQuote(value)}`),
@@ -370,7 +397,7 @@ function buildLaunchPlan(options, commands, shell) {
 		"--cursor-no-fast",
 		"--cursor-mode", shellQuote(options.mode),
 		"--session-dir", shellQuote(options.sessionDir),
-		"--session-id", shellQuote(options.sessionId),
+		...(options.sessionId ? ["--session-id", shellQuote(options.sessionId)] : []),
 		"--model", shellQuote(options.model),
 	].join(" ");
 	const clearLines = clearEnvNames.map((name) => `unset ${name}`).join("\n");
@@ -397,6 +424,8 @@ function runVisualSmoke(options) {
 
 	mkdirSync(options.outDir, { recursive: true });
 	mkdirSync(options.sessionDir, { recursive: true });
+	options.agentDir ??= resolve(options.outDir, "pi-agent");
+	seedVisualAgentDir(options.agentDir);
 
 	const sessionName = `pi-visual-${options.safeLabel}-${process.pid}`;
 	const bufferName = `pi-visual-prompt-${process.pid}`;
@@ -418,7 +447,22 @@ function runVisualSmoke(options) {
 	const jsonlMtimesBeforeRun = snapshotJsonlMtimes(options.sessionDir);
 	const runStartedAtMs = Date.now();
 	try {
-		const start = run(commands.tmux, ["new-session", "-d", "-s", sessionName, "-x", String(options.width), "-y", String(options.height), "--", shell, "-lc", script]);
+		const start = run(commands.tmux, [
+			"new-session",
+			"-d",
+			"-s",
+			sessionName,
+			"-c",
+			options.cwd,
+			"-x",
+			String(options.width),
+			"-y",
+			String(options.height),
+			"--",
+			shell,
+			"-c",
+			script,
+		]);
 		if (start.status !== 0) throw new Error(`tmux new-session failed: ${start.stderr?.toString().trim() || start.status}`);
 		sessionStarted = true;
 

package/src/bundled-context-windows.ts

@@ -1,4 +1,4 @@
-// Generated from Cursor SDK checkpoint tokenDetails.maxTokens on 2026-08-02.
+// Generated from Cursor SDK checkpoint tokenDetails.maxTokens on 2026-08-18.
 // Refresh with: npm run refresh:cursor-snapshots -- --write --context-windows ~/.pi/agent/cursor-sdk-context-windows.json
 // Keys are current selectable model IDs. Equivalent default :fast/:slow selections
 // collapse to one key; stale and ambiguous aliases are omitted. Values are observed
@@ -6,6 +6,7 @@
 // label when the completed SDK checkpoint reports a different effective limit.
 export const BUNDLED_CONTEXT_WINDOWS = {
 	"default": 200000,
+	"auto-smart": 200000,
 	"claude-fable-5@300k": 300000,
 	"claude-haiku-4-5": 200000,
 	"claude-opus-4-5": 200000,
@@ -17,6 +18,7 @@ export const BUNDLED_CONTEXT_WINDOWS = {
 	"gemini-3.1-pro": 200000,
 	"gemini-3.5-flash": 200000,
 	"gemini-3.6-flash": 200000,
+	"gemini-3.7-flash": 200000,
 	"glm-5.2": 200000,
 	"gpt-5-5@272k": 272000,
 	"gpt-5-mini": 272000,
@@ -29,6 +31,7 @@ export const BUNDLED_CONTEXT_WINDOWS = {
 	"gpt-5.6@1m": 272000,
 	"grok-4.5": 256000,
 	"grok-4.5:slow": 256000,
+	"grok-4.6": 256000,
 	"kimi-k2.7-code": 200000,
 	"kimi-k3": 200000,
 	"opus-4.8@1m": 300000,