free-pi-cli 0.6.1 → 0.6.3

package/dist/index.js

@@ -30,4 +30,4 @@ if (err) {
   console.error(err);
   process.exit(1);
 }
-await import("./main-zv5s2zn8.js");
+await import("./main-q0zat1nk.js");

package/dist/{main-zv5s2zn8.js → main-q0zat1nk.js}

@@ -5,8 +5,10 @@ import {
 } from "./index-n5qs9pq1.js";
 
 // src/main.ts
-import { realpathSync as realpathSync3, writeFileSync as writeFileSync3 } from "node:fs";
-import { dirname as dirname10, join as join11 } from "node:path";
+import { spawn as spawn3 } from "node:child_process";
+import { realpathSync as realpathSync5, writeFileSync as writeFileSync3 } from "node:fs";
+import { homedir as homedir7 } from "node:os";
+import { dirname as dirname11, join as join13 } from "node:path";
 
 // src/browser.ts
 import { spawn } from "node:child_process";
@@ -29,6 +31,8 @@ function buildOpenCommand(url, platform) {
       windowsVerbatimArguments: true
     };
   }
+  if (platform === "android")
+    return { command: "termux-open-url", args: [url] };
   return { command: platform === "darwin" ? "open" : "xdg-open", args: [url] };
 }
 function openBrowser(url, platform = process.platform, spawnImpl = spawn, exitWaitMs = 2000) {
@@ -14410,7 +14414,8 @@ var GuestStartRequestSchema = exports_external.object({
 });
 var ExperimentVariantSchema = exports_external.enum(["control", "treatment"]);
 var ExperimentAssignmentSchema = exports_external.object({
-  guest_handoff: ExperimentVariantSchema.optional()
+  guest_handoff: ExperimentVariantSchema.optional(),
+  first_task: ExperimentVariantSchema.optional()
 });
 var GuestStartResponseSchema = exports_external.object({
   token: exports_external.string(),
@@ -14432,7 +14437,7 @@ var ReturnBonusTelemetrySchema = exports_external.object({
   type: exports_external.enum(["card_shown", "credits_back"])
 });
 var ExperimentExposureSchema = exports_external.object({
-  experiment: exports_external.enum(["resume_on_launch"]),
+  experiment: exports_external.enum(["resume_on_launch", "retain.first_task"]),
   event: exports_external.enum(["offer_shown", "offer_accepted"])
 });
 var ReturnBonusSurfaceSchema = exports_external.object({
@@ -14626,6 +14631,18 @@ var ConfigSchema = exports_external.object({
   emailProviderUrl: exports_external.string().optional(),
   hiveEnabled: exports_external.boolean().default(false),
   providerOrder: exports_external.array(exports_external.string()).optional(),
+  openrouterFlashProviderOrder: exports_external.array(exports_external.string()).default([
+    "streamlake/fp8",
+    "deepinfra/fp8",
+    "gmicloud/fp8",
+    "digitalocean"
+  ]),
+  openrouterFlashProviderIgnore: exports_external.array(exports_external.string()).default(["baidu", "relace"]),
+  openrouterFlashMaxPricePrompt: exports_external.string().default("0.12"),
+  openrouterFlashMaxPriceCompletion: exports_external.string().default("0.25"),
+  openrouterSessionPinTtlSeconds: exports_external.number().int().min(1).default(1800),
+  costAlertMultiplier: exports_external.number().int().min(1).default(2),
+  costAlertMinHours: exports_external.number().int().min(1).default(7),
   tierNewMaxDays: exports_external.number().int().default(30),
   tierYoungMaxDays: exports_external.number().int().default(365),
   tierCapNewUsd: exports_external.number().default(0.45),
@@ -14710,6 +14727,12 @@ function envList(value) {
   const items = value.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
   return items.length > 0 ? items : undefined;
 }
+function envDecimalString(value) {
+  if (value === undefined || value.trim() === "")
+    return;
+  const t = value.trim();
+  return /^\d+(\.\d+)?$/.test(t) ? t : undefined;
+}
 function loadConfig(env = process.env) {
   return ConfigSchema.parse({
     perUserDailyCapUsd: envNumber(env.PER_USER_DAILY_CAP_USD),
@@ -14742,6 +14765,13 @@ function loadConfig(env = process.env) {
     emailProviderUrl: env.EMAIL_PROVIDER_URL?.trim() || undefined,
     hiveEnabled: envBoolean(env.HIVE_ENABLED),
     providerOrder: envList(env.PROVIDER_ORDER),
+    openrouterFlashProviderOrder: envList(env.OPENROUTER_FLASH_PROVIDER_ORDER),
+    openrouterFlashProviderIgnore: envList(env.OPENROUTER_FLASH_PROVIDER_IGNORE),
+    openrouterFlashMaxPricePrompt: envDecimalString(env.OPENROUTER_FLASH_MAX_PRICE_PROMPT),
+    openrouterFlashMaxPriceCompletion: envDecimalString(env.OPENROUTER_FLASH_MAX_PRICE_COMPLETION),
+    openrouterSessionPinTtlSeconds: envNumber(env.OPENROUTER_SESSION_PIN_TTL_SECONDS),
+    costAlertMultiplier: envNumber(env.COST_ALERT_MULTIPLIER),
+    costAlertMinHours: envNumber(env.COST_ALERT_MIN_HOURS),
     tierNewMaxDays: envNumber(env.TIER_NEW_MAX_DAYS),
     tierYoungMaxDays: envNumber(env.TIER_YOUNG_MAX_DAYS),
     tierCapNewUsd: envNumber(env.TIER_CAP_NEW_USD),
@@ -15029,7 +15059,7 @@ var HiveClassifyResponseSchema = exports_external.object({
 // package.json
 var package_default = {
   name: "free-pi-cli",
-  version: "0.6.1",
+  version: "0.6.3",
   description: "Free, ad-supported distribution of the pi coding agent. Inference paid for by ads.",
   license: "MIT",
   type: "module",
@@ -15768,6 +15798,34 @@ function createAdsExtension(opts) {
 import { dirname as dirname8, join as join10, resolve as resolve3 } from "node:path";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 
+// src/output-limit.ts
+var MAX_OUTPUT_TOKENS = 8192;
+var OUTPUT_LIMIT_MESSAGE = "This tool call was cut off by the output limit before it finished. It either did not run or ran with incomplete content, " + "so a file may be partly written. Check what was written, then redo the work in smaller parts " + "(for example write the first part, then add the rest with edit).";
+function createOutputLimitExtension() {
+  let truncated = new Set;
+  return {
+    name: "free-pi-output-limit",
+    factory(pi) {
+      pi.on("message_end", (event) => {
+        const msg = event.message;
+        if (msg.role === "assistant") {
+          const calls = (msg.content ?? []).filter((c) => c.type === "toolCall" && c.id);
+          const last = msg.content?.[msg.content.length - 1];
+          const atCap = (msg.usage?.output ?? 0) >= MAX_OUTPUT_TOKENS && last?.type === "toolCall" && last.id;
+          truncated = new Set(msg.stopReason === "length" ? calls.map((c) => c.id) : atCap ? [last.id] : []);
+          return;
+        }
+        if (msg.role !== "toolResult" || !msg.toolCallId || !truncated.has(msg.toolCallId))
+          return;
+        truncated.delete(msg.toolCallId);
+        return {
+          message: { ...event.message, content: [{ type: "text", text: OUTPUT_LIMIT_MESSAGE }], isError: true }
+        };
+      });
+    }
+  };
+}
+
 // src/provider.ts
 var PROVIDER_NAME = "free-pi";
 var DEFENSE_PROVIDER_NAME = "free-pi-defense";
@@ -15798,7 +15856,7 @@ function buildProviderConfig(baseUrl, jwt2, sessionId, models, name = PROVIDER_N
       input: ["text"],
       cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
       contextWindow: 1048576,
-      maxTokens: 8192
+      maxTokens: MAX_OUTPUT_TOKENS
     }))
   };
 }
@@ -20440,6 +20498,12 @@ You can run free-pi in more than one terminal. If a previous session is stuck,
 \`/buy-credits\` opens the buy page in your browser. The free allowance spends
 first. Purchased credits cover use beyond it and do not expire.
 
+## Model and restarting
+\`/model\` shows the current model and lets you switch it; the model can change
+during a session. Credits are free-pi's usage unit, not model tokens. To
+restart, exit and run \`npx free-pi-cli\` again; \`--continue\` resumes the last
+session.
+
 ## Commands
 - \`/usage\` — spend and remaining budget today
 - \`/support\` — visit today's advertiser
@@ -20771,8 +20835,40 @@ import { join as join5 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 import {
   createBashToolDefinition,
+  createLocalPowerShellOperations,
   createReadToolDefinition
 } from "@earendil-works/pi-coding-agent";
+
+// src/windows-shell.ts
+import { getPowerShellConfig, getShellConfig } from "@earendil-works/pi-coding-agent";
+var works = (f) => () => {
+  try {
+    f();
+    return true;
+  } catch {
+    return false;
+  }
+};
+var defaultHasBash = works(() => getShellConfig());
+var defaultHasPowerShell = works(() => getPowerShellConfig());
+function detectShell(p = {}) {
+  if ((p.platform ?? process.platform) !== "win32")
+    return "posix";
+  if ((p.hasBash ?? defaultHasBash)())
+    return "bash";
+  return (p.hasPowerShell ?? defaultHasPowerShell)() ? "powershell" : "none";
+}
+function shellPromptLine(kind) {
+  if (kind === "bash") {
+    return "Environment: Windows with a bash shell (usually Git Bash). The bash tool runs POSIX shell syntax with forward slashes; Git Bash writes drive paths as /c/Users/...";
+  }
+  if (kind === "powershell") {
+    return "Environment: Windows without bash. The bash tool runs its command in PowerShell, so write PowerShell syntax (Get-ChildItem, $env:VAR, ;) and Windows paths like C:\\Users\\..., never POSIX shell syntax.";
+  }
+  return;
+}
+
+// src/tool-aliases.ts
 function aliasArgs(input, key, aliases) {
   if (!input || typeof input !== "object" || key in input)
     return input;
@@ -20800,6 +20896,8 @@ function normalizeShellPath(input, platform = process.platform, home = homedir2(
 }
 function createToolAliasesExtension(opts = {}) {
   const { sandbox } = opts;
+  const powershell = (opts.shell ?? detectShell()) === "powershell";
+  const psOps = powershell ? createLocalPowerShellOperations() : undefined;
   return {
     name: "free-pi-tool-aliases",
     factory: (pi) => {
@@ -20808,6 +20906,10 @@ function createToolAliasesExtension(opts = {}) {
       const read = createReadToolDefinition(cwd);
       pi.registerTool({
         ...bash,
+        ...powershell ? {
+          description: bash.description.replaceAll("bash", "PowerShell"),
+          promptSnippet: bash.promptSnippet?.replaceAll("bash", "PowerShell")
+        } : {},
         prepareArguments: (a) => aliasArgs(bash.prepareArguments ? bash.prepareArguments(a) : a, "command", ["cmd"]),
         execute: async (id, params, signal, onUpdate, ctx) => {
           const s = pi.getSettings();
@@ -20816,7 +20918,8 @@ function createToolAliasesExtension(opts = {}) {
           if (taken.mode === "none")
             throw new Error("Hive: no approval was recorded for this shell command, so it did not run.");
           if (taken.mode === "unsandboxed") {
-            return createBashToolDefinition(cwd, { commandPrefix: s.shellCommandPrefix, shellPath }).execute(id, params, signal, onUpdate, ctx);
+            const operations = powershell && !shellPath ? psOps : undefined;
+            return createBashToolDefinition(cwd, { commandPrefix: s.shellCommandPrefix, shellPath, operations }).execute(id, params, signal, onUpdate, ctx);
           }
           try {
             return await createBashToolDefinition(cwd, { commandPrefix: s.shellCommandPrefix, shellPath: taken.shell, spawnHook: taken.hook }).execute(id, params, signal, onUpdate, ctx);
@@ -20938,7 +21041,18 @@ var AGENT_RULES = `## Working rules
   or full error output, or try a different approach. Do not re-read a file you already read
   unless it has changed.
 - Before saying a task is done, check the result the user will see: run the program, open
-  the output, or run the specific test. Say plainly what you checked and what you did not.`;
+  the output, or run the specific test. Say plainly what you checked and what you did not.
+- End every turn with a short visible status: done, blocked and why, or the exact step that
+  failed. Never an empty reply.
+- For questions about free-pi itself (model, credits, limits, commands, restart), call the
+  ${DOCS_TOOL_NAME} tool instead of searching files. Credits are free-pi's usage unit, not model tokens.
+  To restart, run npx free-pi-cli.
+- Write files longer than about 300 lines in parts, not one huge write.
+- Never print whole env, config or credential files. Search for the specific name and never
+  echo secret values.
+- Ask before irreversible actions outside the project: deleting other tools' config or
+  credentials, system or boot settings, bulk permission changes, remote root sessions.
+- After finishing a task, suggest one concrete next step.`;
 
 // src/tool-guard.ts
 async function reportToolGuardTrigger(opts, toolName) {
@@ -21158,6 +21272,24 @@ function mergeAttribution(a, b) {
 
 // src/changelog.ts
 var CHANGELOG_HIGHLIGHTS = [
+  {
+    version: "0.6.3",
+    highlights: [
+      "When your version is older than the minimum, free-pi now updates itself and restarts in the same folder, instead of asking you to run a command."
+    ]
+  },
+  {
+    version: "0.6.2",
+    highlights: [
+      "Clearer status at the end of each turn, and a suggested next step.",
+      "Questions about free-pi are answered from the built-in docs.",
+      "Large files are written in parts, and credential files are never printed.",
+      "The agent asks before risky actions.",
+      "Tool calls cut off by the output limit are retried in parts.",
+      "/login reports failures clearly, and opens the browser on Termux.",
+      "Windows: the bash tool falls back to PowerShell when bash is missing."
+    ]
+  },
   {
     version: "0.6.1",
     highlights: [
@@ -21468,7 +21600,8 @@ async function startGuestSession(baseUrl, consentVersion, attribution = {}) {
     token: parsed.token,
     allowance_usd: parsed.allowance_usd,
     remaining_usd: parsed.remaining_usd,
-    guestHandoffVariant: parsed.experiments?.guest_handoff
+    guestHandoffVariant: parsed.experiments?.guest_handoff,
+    firstTaskVariant: parsed.experiments?.first_task
   };
 }
 async function reportFunnelEvent(baseUrl, event, opts = {}) {
@@ -21825,6 +21958,7 @@ async function clearPendingLogin(credentialsPath) {
 var LOGIN_REWARD_LINE = "Sign in with GitHub to get 15,000 free credits a day";
 var LOGIN_WAITING_LINE = "Waiting for GitHub…";
 var LOGIN_TIMEOUT_LINE = "GitHub sign-in timed out. Run /login to try again.";
+var BROWSER_FAILED_LINE = "Couldn't open a browser here. Open the URL above yourself and enter the code.";
 function formatDeviceCodePrompt(device, variant) {
   const value = isHandoffTreatment(variant) ? LOGIN_VALUE_LINE : LOGIN_REWARD_LINE;
   return [
@@ -21866,8 +22000,8 @@ async function runDeviceLogin(deps, attribution = {}) {
       jwt: deps.jwt,
       fetchImpl: deps.fetchImpl
     });
-  } else if (!copied) {
-    deps.log(HEADLESS_FALLBACK_LINE);
+  } else {
+    deps.log(copied ? BROWSER_FAILED_LINE : `${BROWSER_FAILED_LINE} ${HEADLESS_FALLBACK_LINE}`);
   }
   await submitConsent(deps.baseUrl, device.session_id, CONSENT_VERSION, attribution);
   const expiresInMs = (device.expires_in ?? 900) * 1000;
@@ -22050,7 +22184,8 @@ async function runLogin(opts, ctx) {
       ctx.ui.notify(LOGIN_TIMEOUT_LINE, "warning");
       return;
     }
-    ctx.ui.notify("Couldn't finish GitHub sign-in. Run /login to try again.", "error");
+    const reason = err instanceof Error && err.message ? ` (${err.message})` : "";
+    ctx.ui.notify(`Couldn't finish GitHub sign-in${reason}. Run /login to try again.`, "error");
   }
 }
 function installLoginHandler(mode, opts) {
@@ -24251,7 +24386,8 @@ function buildRuntimeOptions(opts, sessionId) {
   });
   const todoToolExtension = createTodoToolExtension();
   const shellSandbox = opts.shellSandbox ?? createShellSandbox();
-  const toolAliasesExtension = createToolAliasesExtension({ sandbox: shellSandbox });
+  const shell = opts.shell ?? detectShell();
+  const toolAliasesExtension = createToolAliasesExtension({ sandbox: shellSandbox, shell });
   const mcpExtension = { name: "pi-mcp", factory: createMcpExtension() };
   const codemodeExtension = { name: "pi-codemode", factory: createCodemodeExtension({ models: false }) };
   const toolSearchExtension = { name: "pi-tool-search", factory: createToolSearchExtension() };
@@ -24271,6 +24407,7 @@ function buildRuntimeOptions(opts, sessionId) {
     webToolsExtension,
     imageToolExtension,
     errorNoticeExtension,
+    createOutputLimitExtension(),
     toolGuardExtension,
     commandsExtension,
     headerExtension,
@@ -24289,7 +24426,7 @@ function buildRuntimeOptions(opts, sessionId) {
     resourceLoaderOptions: {
       extensionFactories,
       additionalSkillPaths: [SKILLS_DIR],
-      appendSystemPromptOverride: (base) => [...base, AGENT_RULES]
+      appendSystemPromptOverride: (base) => [...base, AGENT_RULES, ...shellPromptLine(shell) ? [shellPromptLine(shell)] : []]
     },
     extensionNames: extensionFactories.map((e) => e.name),
     tools: SDK_TOOLS
@@ -24433,6 +24570,140 @@ function createRealSpawn(io = { platform: process.platform, spawnSyncImpl: spawn
   };
 }
 
+// src/relaunch.ts
+import { existsSync as existsSync5, mkdtempSync as mkdtempSync2, realpathSync as realpathSync3, rmSync as rmSync2, statSync as statSync3 } from "node:fs";
+import { constants as osConstants, tmpdir as tmpdir2 } from "node:os";
+import { delimiter, dirname as dirname9, isAbsolute as isAbsolute2, join as join11, resolve as resolve4, sep as sep2, win32 } from "node:path";
+function applyRelaunchCwd(env, chdir = (d) => process.chdir(d), isDir = (p) => {
+  try {
+    return statSync3(p).isDirectory();
+  } catch {
+    return false;
+  }
+}) {
+  const dir = env.FREEPI_RELAUNCH_CWD;
+  delete env.FREEPI_RELAUNCH_CWD;
+  if (!dir)
+    return;
+  const fail2 = `free-pi: could not return to your project folder (${dir}) after updating. Run free-pi again from that folder.`;
+  if (!isDir(dir))
+    return fail2;
+  try {
+    chdir(dir);
+  } catch {
+    return fail2;
+  }
+  return;
+}
+var SEMVER = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;
+function canon(p, fold) {
+  let r;
+  try {
+    r = realpathSync3.native(p);
+  } catch {
+    r = resolve4(p);
+  }
+  return fold ? r.toLowerCase() : r;
+}
+function isInside2(e, d) {
+  return e === d || e.startsWith(d.endsWith(sep2) ? d : d + sep2);
+}
+function hasNodeModulesBin(entry) {
+  const parts = entry.split(/[\\/]+/).map((x) => x.toLowerCase());
+  return parts.some((x, i) => x === "node_modules" && parts[i + 1] === ".bin");
+}
+function sanitizedEnv(env, nodeDir, project, home, win) {
+  const proj = canon(project, win);
+  const broad = proj === canon(home, win) || dirname9(proj) === proj;
+  const out = {};
+  let pathKey = "PATH";
+  let oldPath = "";
+  for (const [k, v] of Object.entries(env)) {
+    const lk = k.toLowerCase();
+    if (lk.startsWith("npm_") || lk === "node_options" || lk === "node_path")
+      continue;
+    if (lk === "path") {
+      pathKey = k;
+      oldPath = v ?? "";
+      continue;
+    }
+    if (win && lk === "comspec")
+      continue;
+    out[k] = v;
+  }
+  if (win) {
+    const sysRoot = Object.entries(env).find(([k]) => k.toLowerCase() === "systemroot")?.[1];
+    const root = sysRoot && win32.isAbsolute(sysRoot) ? sysRoot : "C:\\Windows";
+    const comKey = Object.keys(env).find((k) => k.toLowerCase() === "comspec") ?? "ComSpec";
+    out[comKey] = win32.join(root, "System32", "cmd.exe");
+  }
+  const kept = oldPath.split(delimiter).filter((e) => e && isAbsolute2(e) && (broad || !isInside2(canon(e, win), proj)) && !hasNodeModulesBin(e));
+  out[pathKey] = [nodeDir, ...kept].join(delimiter);
+  return out;
+}
+async function relaunchViaNpx(latest, deps) {
+  const { env } = deps;
+  if ("FREEPI_NO_AUTO_UPDATE" in env || !deps.autoUpdateEnabled())
+    return;
+  if (env.FREEPI_AUTO_UPDATED)
+    return;
+  const win = deps.platform === "win32";
+  if (!latest || !SEMVER.test(latest))
+    return;
+  const target2 = latest;
+  const nodeDir = dirname9(deps.execPath);
+  const npxCli = win ? join11(nodeDir, "node_modules", "npm", "bin", "npx-cli.js") : join11(dirname9(nodeDir), "lib", "node_modules", "npm", "bin", "npx-cli.js");
+  const exists = deps.exists ?? existsSync5;
+  const distroNpxCli = "/usr/share/nodejs/npm/bin/npx-cli.js";
+  let npxCliPath = npxCli;
+  if (!exists(npxCli)) {
+    if (!win && deps.execPath === "/usr/bin/node" && exists(distroNpxCli))
+      npxCliPath = distroNpxCli;
+    else
+      return;
+  }
+  const childEnv = sanitizedEnv(env, nodeDir, deps.cwd, deps.homedir, win);
+  const readyDir = mkdtempSync2(join11(tmpdir2(), "free-pi-relaunch-"));
+  const readyFile = join11(readyDir, "started");
+  try {
+    deps.log(`Updating free-pi to ${target2}…`);
+    return await new Promise((resolve5) => {
+      let child;
+      try {
+        child = deps.spawn(deps.execPath, [npxCliPath, "--yes", `free-pi-cli@${target2}`, ...deps.argv], {
+          stdio: "inherit",
+          cwd: deps.homedir,
+          env: { ...childEnv, FREEPI_AUTO_UPDATED: target2, FREEPI_RELAUNCH_READY: readyFile, FREEPI_RELAUNCH_CWD: deps.cwd },
+          shell: false
+        });
+      } catch {
+        resolve5(undefined);
+        return;
+      }
+      const handlers = win ? [] : [
+        ["SIGINT", () => {}],
+        ["SIGTERM", () => void child.kill("SIGTERM")],
+        ["SIGHUP", () => void child.kill("SIGTERM")]
+      ];
+      for (const [sig, cb] of handlers)
+        deps.proc.on(sig, cb);
+      const done3 = (code) => {
+        for (const [sig, cb] of handlers)
+          deps.proc.off(sig, cb);
+        resolve5(code);
+      };
+      child.on("error", () => done3(undefined));
+      child.on("exit", (code, signal) => {
+        const exitCode = code ?? 128 + (signal ? osConstants.signals[signal] ?? 0 : 0);
+        const cancelled = signal === "SIGINT" || signal === "SIGTERM" || signal === "SIGHUP" || exitCode === 130 || exitCode === 143 || exitCode === 129;
+        done3(exitCode !== 0 && !cancelled && !existsSync5(readyFile) ? undefined : exitCode);
+      });
+    });
+  } finally {
+    rmSync2(readyDir, { recursive: true, force: true });
+  }
+}
+
 // src/run.ts
 import { SessionManager as SessionManager2 } from "@earendil-works/pi-coding-agent";
 
@@ -24563,13 +24834,13 @@ async function readOneKeypress(prompt, stdin = process.stdin, stdout = process.s
   if (typeof stdin.setRawMode === "function")
     stdin.setRawMode(true);
   stdin.resume();
-  return await new Promise((resolve4) => {
+  return await new Promise((resolve5) => {
     const onData = (chunk) => {
       stdin.off("data", onData);
       if (typeof stdin.setRawMode === "function")
         stdin.setRawMode(wasRaw ?? false);
       stdin.pause();
-      resolve4(typeof chunk === "string" ? chunk : chunk.toString("utf8"));
+      resolve5(typeof chunk === "string" ? chunk : chunk.toString("utf8"));
     };
     stdin.once("data", onData);
   });
@@ -24585,6 +24856,9 @@ async function promptResumeInteractive(session) {
 }
 
 // src/onboarding.ts
+import { existsSync as existsSync6, readdirSync as readdirSync3, realpathSync as realpathSync4 } from "node:fs";
+import { homedir as homedir6 } from "node:os";
+import { join as join12 } from "node:path";
 var INTRO_ENV_SKIP = "FREEPI_NO_INTRO";
 var INTRO_TEXT = `
 Welcome to free-pi — a free coding agent in your terminal.
@@ -24609,14 +24883,45 @@ function showIntro(log, env = process.env) {
 ${INTRO_TEXT}
 `);
 }
+var FIRST_TASK_EXPERIMENT = "retain.first_task";
+var PROJECT_MARKERS = [".git", "package.json", "pyproject.toml", "Cargo.toml", "go.mod", "pom.xml", "Gemfile", "composer.json"];
+function looksLikeProject(cwd, home = homedir6()) {
+  try {
+    if (realpathSync4(cwd) === realpathSync4(home))
+      return false;
+    if (PROJECT_MARKERS.some((m) => existsSync6(join12(cwd, m))))
+      return true;
+    return readdirSync3(cwd).some((f) => /\.(sln|csproj)$/.test(f));
+  } catch {
+    return false;
+  }
+}
+var FIRST_TASK_PROJECT_TEXT = `
+Try one of these on this project — just type it:
+  • Explain how this project is organized
+  • Find and fix one bug
+  • Add a test for the most important function
+`.trim();
+var FIRST_TASK_EMPTY_TEXT = `
+This folder doesn't look like a project. free-pi works best on code you
+already have: quit, "cd" into a project, and run "npx free-pi-cli" there.
+Or just type: Create a small runnable hello-world app here and run it
+`.trim();
+function showFirstTaskHint(log, cwd = process.cwd(), home = homedir6()) {
+  const text = looksLikeProject(cwd, home) ? FIRST_TASK_PROJECT_TEXT : FIRST_TASK_EMPTY_TEXT;
+  log(`
+${text}
+`);
+  return text;
+}
 
 // src/whats-new.ts
-import { existsSync as existsSync5, mkdirSync as mkdirSync2, readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "node:fs";
-import { dirname as dirname9 } from "node:path";
+import { existsSync as existsSync7, mkdirSync as mkdirSync2, readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "node:fs";
+import { dirname as dirname10 } from "node:path";
 function maybeWhatsNew(cliVersion, agentDir) {
   try {
     const path = getLastSeenVersionPath(agentDir);
-    const lastSeen = existsSync5(path) ? readFileSync4(path, "utf-8").trim() : undefined;
+    const lastSeen = existsSync7(path) ? readFileSync4(path, "utf-8").trim() : undefined;
     writeLastSeen(path, cliVersion);
     if (lastSeen === undefined)
       return;
@@ -24632,7 +24937,7 @@ function maybeWhatsNew(cliVersion, agentDir) {
   }
 }
 function writeLastSeen(path, version3) {
-  mkdirSync2(dirname9(path), { recursive: true });
+  mkdirSync2(dirname10(path), { recursive: true });
   writeFileSync2(path, version3, "utf-8");
 }
 
@@ -24678,18 +24983,22 @@ function validateSessionId(value) {
     return `Invalid --session value: ${err instanceof Error ? err.message : String(err)}`;
   }
 }
-function reportResumeExposure(deps, jwt2, event) {
-  if (deps.reportResumeExposure) {
+function reportResumeExposure(deps, jwt2, event, experiment = RESUME_ON_LAUNCH_EXPERIMENT) {
+  if (experiment === RESUME_ON_LAUNCH_EXPERIMENT && deps.reportResumeExposure) {
     deps.reportResumeExposure(event);
     return;
   }
+  if (experiment === FIRST_TASK_EXPERIMENT && deps.reportFirstTaskExposure) {
+    deps.reportFirstTaskExposure();
+    return;
+  }
   fetch(new URL("/telemetry/experiment", deps.baseUrl), {
     method: "POST",
     headers: {
       authorization: `Bearer ${jwt2}`,
       "content-type": "application/json"
     },
-    body: JSON.stringify({ experiment: RESUME_ON_LAUNCH_EXPERIMENT, event }),
+    body: JSON.stringify({ experiment, event }),
     signal: AbortSignal.timeout(3000)
   }).catch(() => {});
 }
@@ -24716,6 +25025,7 @@ ${FINISH_SIGNIN_LINE}
 `);
   let jwt2 = await loadJwt(deps.credentialsPath);
   let guestHandoffVariant;
+  let showFirstTask = false;
   let consentCurrent = false;
   if (jwt2) {
     try {
@@ -24764,6 +25074,7 @@ You're on a short guest trial — ads pay for it. ${LOGIN_VALUE_LINE}
 You're on a short guest trial — ads pay for it. Sign in with GitHub anytime (/login) to get 15,000 free credits a day and unlock a one-time comeback bonus.
 `);
       guestHandoffVariant = guest.guestHandoffVariant;
+      showFirstTask = guest.firstTaskVariant === "treatment" && !resumeFlags.hasPrompt;
     } catch (err) {
       if (!(err instanceof GuestUnavailableError))
         throw err;
@@ -24781,6 +25092,9 @@ Guest trial is not available right now.
     if (outcome === "updated-exit")
       return 0;
     if (outcome === "blocked") {
+      const relaunched = await deps.relaunchLatest?.(versionCheck.latest);
+      if (relaunched !== undefined)
+        return relaunched;
       deps.log("free-pi-cli needs an update. From a trusted folder (for example: cd ~), run: npx --yes free-pi-cli@latest   (or: npm i -g free-pi-cli@latest)");
       return 1;
     }
@@ -24803,6 +25117,10 @@ Guest trial is not available right now.
   if (me)
     updateAllowanceCache(me);
   guestHandoffVariant = me?.experiments?.guest_handoff ?? guestHandoffVariant;
+  if (showFirstTask) {
+    showFirstTaskHint(deps.log);
+    reportResumeExposure(deps, jwt2, "offer_shown", FIRST_TASK_EXPERIMENT);
+  }
   const startRefill = await fetchRefillStats(deps.baseUrl, jwt2).catch(() => {
     return;
   });
@@ -24945,12 +25263,17 @@ async function checkClientVersion(baseUrl, cliVersion, fetchImpl = fetch, jwt2)
 // src/main.ts
 function resolveCliRealpath() {
   try {
-    return realpathSync3(process.argv[1] ?? "");
+    return realpathSync5(process.argv[1] ?? "");
   } catch {
     return "";
   }
 }
 async function main() {
+  const cwdError = applyRelaunchCwd(process.env);
+  if (cwdError) {
+    console.error(cwdError);
+    process.exit(1);
+  }
   if (process.env.FREEPI_RELAUNCH_READY) {
     try {
       writeFileSync3(process.env.FREEPI_RELAUNCH_READY, "");
@@ -24996,11 +25319,23 @@ ${HELP_TEXT}`);
     credentialsPath: getCredentialsPath(agentDir),
     promptConsent: promptConsentInteractive,
     openBrowser,
-    sleep: (ms) => new Promise((resolve4) => setTimeout(resolve4, ms)),
+    sleep: (ms) => new Promise((resolve5) => setTimeout(resolve5, ms)),
     launchPi,
     log: (message) => console.log(message),
     checkClientVersion: (baseUrl, cliVersion, jwt2) => checkClientVersion(baseUrl, cliVersion, fetch, jwt2),
-    startGravityPixel: (jwt2) => startGravityPixel(jwt2, join11(dirname10(agentDir), "gravity")),
+    startGravityPixel: (jwt2) => startGravityPixel(jwt2, join13(dirname11(agentDir), "gravity")),
+    relaunchLatest: (latest) => relaunchViaNpx(latest, {
+      env: process.env,
+      argv: process.argv.slice(2),
+      platform: process.platform,
+      cwd: process.cwd(),
+      homedir: homedir7(),
+      execPath: process.execPath,
+      autoUpdateEnabled: () => readAutoUpdate(getConfigPath()),
+      spawn: (cmd, args, opts) => spawn3(cmd, args, opts),
+      proc: process,
+      log: (message) => console.log(message)
+    }),
     maybeSelfUpdate: (action2, latest) => maybeSelfUpdate(action2, latest, {
       env: process.env,
       autoUpdateEnabled: () => readAutoUpdate(getConfigPath()),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-pi-cli",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "description": "Free, ad-supported distribution of the pi coding agent. Inference paid for by ads.",
   "license": "MIT",
   "type": "module",