free-pi-cli 0.6.0 → 0.6.2

package/dist/index.js

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

package/dist/{main-98djq99p.js → main-cwwgr8bh.js}

@@ -5,8 +5,8 @@ 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 { realpathSync as realpathSync4, writeFileSync as writeFileSync3 } from "node:fs";
+import { dirname as dirname10, join as join12 } from "node:path";
 
 // src/browser.ts
 import { spawn } from "node:child_process";
@@ -29,6 +29,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 +14412,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 +14435,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 +14629,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 +14725,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 +14763,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 +15057,7 @@ var HiveClassifyResponseSchema = exports_external.object({
 // package.json
 var package_default = {
   name: "free-pi-cli",
-  version: "0.6.0",
+  version: "0.6.2",
   description: "Free, ad-supported distribution of the pi coding agent. Inference paid for by ads.",
   license: "MIT",
   type: "module",
@@ -15768,6 +15796,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 +15854,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
     }))
   };
 }
@@ -20433,13 +20489,19 @@ at first run, before the GitHub sign-in.
 Each user gets a free allowance every day. The allowance can change with
 supply and demand. \`/usage\` shows how much of today's allowance is spent, as
 a percentage, with token counts.
-One session per account runs at a time. If a previous session is stuck,
+You can run free-pi in more than one terminal. If a previous session is stuck,
 \`/close-other-session\` frees it.
 
 ## Credits
 \`/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 +20833,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 +20894,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 +20904,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 +20916,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 +21039,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) {
@@ -21054,20 +21166,65 @@ function registerBugAutocomplete(pi) {
 }
 
 // src/footer-align.ts
-var ANSI = /\x1b\[[0-9;]*m/g;
-var SIMPLE = /^[\x20-\x7e\xa0-\xff]*$/;
+import { truncateToWidth as truncateToWidth4, visibleWidth as visibleWidth2 } from "@earendil-works/pi-tui";
+var MIN_GAP = 2;
+var MIN_CWD = 8;
+var LEADING_SGR = /^(?:\x1b\[[0-9;]*m)+/;
+function mergeStatusIntoCwdLine(lines, width) {
+  if (lines.length < 3)
+    return lines;
+  const [cwd, stats] = lines;
+  const status = lines[lines.length - 1];
+  const statusW = visibleWidth2(status);
+  let left = cwd;
+  if (visibleWidth2(left) + MIN_GAP + statusW > width) {
+    const room = width - MIN_GAP - statusW;
+    if (room < MIN_CWD)
+      return lines;
+    const style = LEADING_SGR.exec(cwd)?.[0] ?? "";
+    left = truncateToWidth4(cwd, room, style ? `${style}...\x1B[0m` : "...");
+  }
+  const gap = " ".repeat(Math.max(MIN_GAP, width - visibleWidth2(left) - statusW));
+  return [left + gap + status, stats, ...lines.slice(2, -1)];
+}
 function installFooterRightAlign(mode) {
   const footer = mode.footer;
   const render = footer.render.bind(footer);
-  footer.render = (w) => {
-    const lines = render(w);
-    if (lines.length <= 2)
-      return lines;
-    const last = lines[lines.length - 1];
-    const text = last.replace(ANSI, "");
-    if (!SIMPLE.test(text))
-      return lines;
-    return [...lines.slice(0, -1), " ".repeat(Math.max(0, w - text.length)) + last];
+  footer.render = (w) => mergeStatusIntoCwdLine(render(w), w);
+}
+
+// src/guest-handoff.ts
+var LOGIN_VALUE_LINE = "sign in free with GitHub: full daily allowance, FREE abliterated DeepSeek, history saved";
+var GUEST_NEAR_WALL_LINE = `A few guest requests left. ${LOGIN_VALUE_LINE}`;
+var SIGNED_IN_CONTINUE_LINE = "Signed in. Your conversation continues — full daily allowance is unlocked.";
+var HEADLESS_FALLBACK_LINE = "No browser or clipboard here — open the URL and enter the code above.";
+function isHandoffTreatment(variant) {
+  return variant === "treatment";
+}
+var GUEST_NOTES = [
+  "Signed-in users get the Defense models in /model, for security work on code and systems you own. Sign in free with /login.",
+  "With the Defense models you can audit your own repo for vulnerabilities and get fixes, without the usual refusals. /login to unlock.",
+  "Write detection rules and review your server configs with the Defense models. Sign in free with /login.",
+  "More on security work with free-pi: https://freepi.ai/cybersecurity. /login to unlock the Defense models."
+];
+var GUEST_NOTE_EVERY_TURNS = 3;
+function createGuestNotesExtension(opts) {
+  let turns = 0;
+  let shown = 0;
+  return {
+    name: "free-pi-guest-notes",
+    factory(pi) {
+      pi.on("agent_end", (event, ctx) => {
+        if (!opts.isGuest() || shown >= GUEST_NOTES.length)
+          return;
+        const last = [...event.messages].reverse().find((m) => m.role === "assistant");
+        if (last?.stopReason !== "stop")
+          return;
+        if (++turns % GUEST_NOTE_EVERY_TURNS !== 0)
+          return;
+        ctx.ui.notify(GUEST_NOTES[shown++], "info");
+      });
+    }
   };
 }
 
@@ -21113,6 +21270,27 @@ function mergeAttribution(a, b) {
 
 // src/changelog.ts
 var CHANGELOG_HIGHLIGHTS = [
+  {
+    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: [
+      "/model shows the Defense models by their real names.",
+      "Five more Defense models: Abliterated Large V2, Qwen 3.6 Plus Uncensored, Gemma 4 Uncensored, GLM 4.7 Flash Heretic and Uncensored 1.2.",
+      "The footer is two lines: credits left now sit next to the folder name.",
+      "The welcome text no longer says you can only run one session."
+    ]
+  },
   {
     version: "0.6.0",
     highlights: [
@@ -21414,7 +21592,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 = {}) {
@@ -21522,15 +21701,6 @@ async function submitUserConsent(baseUrl, jwt2, consentVersion) {
     throw new Error(`consent submission failed: HTTP ${res.status}`);
 }
 
-// src/guest-handoff.ts
-var LOGIN_VALUE_LINE = "sign in free with GitHub: full daily allowance, FREE abliterated DeepSeek, history saved";
-var GUEST_NEAR_WALL_LINE = `A few guest requests left. ${LOGIN_VALUE_LINE}`;
-var SIGNED_IN_CONTINUE_LINE = "Signed in. Your conversation continues — full daily allowance is unlocked.";
-var HEADLESS_FALLBACK_LINE = "No browser or clipboard here — open the URL and enter the code above.";
-function isHandoffTreatment(variant) {
-  return variant === "treatment";
-}
-
 // src/clipboard.ts
 import { spawn as spawn2 } from "node:child_process";
 import { existsSync as existsSync2 } from "node:fs";
@@ -21780,6 +21950,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 [
@@ -21821,8 +21992,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;
@@ -22005,7 +22176,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) {
@@ -24206,7 +24378,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() };
@@ -24226,6 +24399,7 @@ function buildRuntimeOptions(opts, sessionId) {
     webToolsExtension,
     imageToolExtension,
     errorNoticeExtension,
+    createOutputLimitExtension(),
     toolGuardExtension,
     commandsExtension,
     headerExtension,
@@ -24235,7 +24409,8 @@ function buildRuntimeOptions(opts, sessionId) {
     codemodeExtension,
     toolSearchExtension,
     hiveExtension,
-    ...guestLoginExtension ? [guestLoginExtension] : []
+    ...guestLoginExtension ? [guestLoginExtension] : [],
+    ...opts.guest ? [createGuestNotesExtension({ isGuest: () => auth.isGuest() })] : []
   ];
   const settingsManager = buildSettingsManager(opts, models, opts.projectTrusted === true);
   return {
@@ -24243,7 +24418,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
@@ -24539,6 +24714,9 @@ async function promptResumeInteractive(session) {
 }
 
 // src/onboarding.ts
+import { existsSync as existsSync5, readdirSync as readdirSync3, realpathSync as realpathSync3 } from "node:fs";
+import { homedir as homedir6 } from "node:os";
+import { join as join11 } from "node:path";
 var INTRO_ENV_SKIP = "FREEPI_NO_INTRO";
 var INTRO_TEXT = `
 Welcome to free-pi — a free coding agent in your terminal.
@@ -24546,8 +24724,8 @@ Welcome to free-pi — a free coding agent in your terminal.
   • It's the pi coding agent, free to use. Ads in the terminal pay for the
     inference — ad content never reaches the model.
   • Tell it what to build, fix, or explain, like any coding assistant.
-  • One session per account at a time. If you close the terminal, relaunch
-    with "npx free-pi-cli" — or resume where you left off with
+  • You can run free-pi in more than one terminal. If you close the terminal,
+    relaunch with "npx free-pi-cli" — or resume where you left off with
     "npx free-pi-cli --session <id>" (the id prints when you exit).
 
 Set ${INTRO_ENV_SKIP}=1 to skip this next time.
@@ -24563,14 +24741,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 (realpathSync3(cwd) === realpathSync3(home))
+      return false;
+    if (PROJECT_MARKERS.some((m) => existsSync5(join11(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 { existsSync as existsSync6, mkdirSync as mkdirSync2, readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "node:fs";
 import { dirname as dirname9 } from "node:path";
 function maybeWhatsNew(cliVersion, agentDir) {
   try {
     const path = getLastSeenVersionPath(agentDir);
-    const lastSeen = existsSync5(path) ? readFileSync4(path, "utf-8").trim() : undefined;
+    const lastSeen = existsSync6(path) ? readFileSync4(path, "utf-8").trim() : undefined;
     writeLastSeen(path, cliVersion);
     if (lastSeen === undefined)
       return;
@@ -24632,18 +24841,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(() => {});
 }
@@ -24670,6 +24883,7 @@ ${FINISH_SIGNIN_LINE}
 `);
   let jwt2 = await loadJwt(deps.credentialsPath);
   let guestHandoffVariant;
+  let showFirstTask = false;
   let consentCurrent = false;
   if (jwt2) {
     try {
@@ -24718,6 +24932,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;
@@ -24757,6 +24972,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;
   });
@@ -24899,7 +25118,7 @@ async function checkClientVersion(baseUrl, cliVersion, fetchImpl = fetch, jwt2)
 // src/main.ts
 function resolveCliRealpath() {
   try {
-    return realpathSync3(process.argv[1] ?? "");
+    return realpathSync4(process.argv[1] ?? "");
   } catch {
     return "";
   }
@@ -24954,7 +25173,7 @@ ${HELP_TEXT}`);
     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, join12(dirname10(agentDir), "gravity")),
     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.0",
+  "version": "0.6.2",
   "description": "Free, ad-supported distribution of the pi coding agent. Inference paid for by ads.",
   "license": "MIT",
   "type": "module",