free-pi-cli 0.2.1 → 0.2.2

package/README.md

@@ -13,6 +13,25 @@ may be used to train models), then signs you in with GitHub. Config and the
 signed-in token live under `~/.free-pi/agent`, kept separate from any
 existing `~/.pi/agent` install.
 
+## Running it again
+
+Closed the terminal? Just run the same command again — you stay signed in:
+
+```
+npx free-pi-cli
+```
+
+Prefer a shorter command? Install it once, globally, then call it by name:
+
+```
+npm install -g free-pi-cli
+free-pi-cli
+```
+
+Note: `free-pi-cli` is the command — **not** `pi`. If you see the built-in
+agent suggest `pi --session …` on exit, use `npx free-pi-cli` instead (each
+run starts a fresh session).
+
 ## Development
 
 - `FREEPI_BASE_URL` overrides the backend base URL (default

package/dist/index.js

@@ -14467,6 +14467,8 @@ function assertExhaustiveErrorCode(code) {
 // ../shared/src/config.ts
 var ConfigSchema = exports_external.object({
   perUserDailyCapUsd: exports_external.number().default(5),
+  perUserRollingCapUsd: exports_external.number().default(0),
+  rollingCapWindowHours: exports_external.number().int().default(5),
   globalDailyCapUsd: exports_external.number().default(50),
   contextCharBudget: exports_external.number().int().default(800000),
   accountsPerDayCeiling: exports_external.number().int().default(500),
@@ -14477,12 +14479,13 @@ var ConfigSchema = exports_external.object({
   modelId: exports_external.string().default("deepseek/deepseek-v4-flash"),
   providerDataCollection: exports_external.enum(["allow", "deny"]).optional(),
   promptCacheEnabled: exports_external.boolean().default(false),
+  emailCaptureEnabled: exports_external.boolean().default(false),
   providerOrder: exports_external.array(exports_external.string()).optional(),
   tierNewMaxDays: exports_external.number().int().default(30),
   tierYoungMaxDays: exports_external.number().int().default(365),
   tierCapNewUsd: exports_external.number().default(0.5),
   tierCapYoungUsd: exports_external.number().default(2),
-  sessionLeaseTtlMinutes: exports_external.number().int().default(10),
+  sessionLeaseTtlMinutes: exports_external.number().int().default(30),
   minCliVersion: exports_external.string().default("0.0.0"),
   latestCliVersion: exports_external.string().default("0.2.0"),
   abuseWindowMinutes: exports_external.number().int().default(30),
@@ -14520,6 +14523,8 @@ function envList(value) {
 function loadConfig(env = process.env) {
   return ConfigSchema.parse({
     perUserDailyCapUsd: envNumber(env.PER_USER_DAILY_CAP_USD),
+    perUserRollingCapUsd: envNumber(env.PER_USER_ROLLING_CAP_USD),
+    rollingCapWindowHours: envNumber(env.ROLLING_CAP_WINDOW_HOURS),
     globalDailyCapUsd: envNumber(env.GLOBAL_DAILY_CAP_USD),
     contextCharBudget: envNumber(env.CONTEXT_CHAR_BUDGET),
     accountsPerDayCeiling: envNumber(env.ACCOUNTS_PER_DAY_CEILING),
@@ -14530,6 +14535,7 @@ function loadConfig(env = process.env) {
     modelId: env.MODEL_ID || undefined,
     providerDataCollection: env.PROVIDER_DATA_COLLECTION || undefined,
     promptCacheEnabled: envBoolean(env.PROMPT_CACHE_ENABLED),
+    emailCaptureEnabled: envBoolean(env.EMAIL_CAPTURE_ENABLED),
     providerOrder: envList(env.PROVIDER_ORDER),
     tierNewMaxDays: envNumber(env.TIER_NEW_MAX_DAYS),
     tierYoungMaxDays: envNumber(env.TIER_YOUNG_MAX_DAYS),
@@ -14582,7 +14588,8 @@ async function authedFetch(deps, path, init) {
     headers: {
       ...init?.headers ?? {},
       Authorization: `Bearer ${token}`,
-      "Content-Type": "application/json"
+      "Content-Type": "application/json",
+      ...deps.sessionId && (path.startsWith("/ads/next") || path === "/ads/impression") ? { "x-session-id": deps.sessionId } : {}
     }
   });
 }
@@ -14659,7 +14666,7 @@ function renderAdCard(creative, clickUrl, theme, columns) {
     theme.fg("borderAccent", top),
     row(headline, { bold: true }),
     row(body),
-    row(`▸ ${cta}  ${url2}`, { linkUrl: url2 }),
+    row(`▸ ${cta}`, { linkUrl: url2 }),
     theme.fg("borderAccent", bottom)
   ];
 }
@@ -14667,7 +14674,7 @@ function renderPlainAdLine(creative, clickUrl, theme, columns) {
   const headline = sanitizeText(creative.headline);
   const cta = sanitizeText(creative.cta);
   const url2 = sanitizeText(clickUrl);
-  const plain = truncate(`AD ▚ ${headline} — ${cta} ${url2}`, Math.max(10, columns - 2));
+  const plain = truncate(`AD ▚ ${headline} — ${cta}`, Math.max(10, columns - 2));
   return theme.fg("dim", osc8(plain, url2));
 }
 function renderErrorLine(message, theme) {
@@ -14739,6 +14746,8 @@ function mapErrorCode(code) {
   switch (code) {
     case "daily_cap":
       return "out of free tokens today, resets at 00:00 UTC";
+    case "rolling_cap":
+      return "over the rolling spend cap on the free tier — wait for the Retry-After window";
     case "concurrent":
       return "only one request at a time on the free tier — wait for the current one to finish";
     case "concurrent_session":
@@ -14785,7 +14794,12 @@ async function renderMeter(deps, ctx) {
 // ../pi-ads/src/index.ts
 var BANNER_REFRESH_MS = 10 * 60 * 1000;
 function createAdsExtension(opts) {
-  const deps = { baseUrl: opts.baseUrl, getToken: opts.getToken, fetchImpl: opts.fetchImpl };
+  const deps = {
+    baseUrl: opts.baseUrl,
+    getToken: opts.getToken,
+    sessionId: opts.sessionId,
+    fetchImpl: opts.fetchImpl
+  };
   const config3 = loadConfig();
   return {
     name: "free-pi-ads",
@@ -14815,15 +14829,18 @@ function createAdsExtension(opts) {
     }
   };
 }
+
+// src/pi-launch.ts
+import { join as join2, resolve } from "node:path";
 // package.json
 var package_default = {
   name: "free-pi-cli",
-  version: "0.2.1",
+  version: "0.2.2",
   description: "Free, ad-supported distribution of the pi coding agent. Inference paid for by ads.",
   license: "MIT",
   type: "module",
   bin: {
-    "free-pi-cli": "./dist/index.js"
+    "free-pi-cli": "dist/index.js"
   },
   files: [
     "dist",
@@ -19198,7 +19215,8 @@ function buildRuntimeOptions(opts, sessionId) {
   };
   const adsExtension = createAdsExtension({
     baseUrl: opts.baseUrl,
-    getToken: () => opts.jwt
+    getToken: () => opts.jwt,
+    sessionId
   });
   const usageToolExtension = createUsageToolExtension({
     baseUrl: opts.baseUrl,
@@ -19223,10 +19241,28 @@ function buildRuntimeOptions(opts, sessionId) {
     tools: ALLOWED_TOOL_NAMES
   };
 }
+function getSessionDir(cwd, agentDir) {
+  const resolvedCwd = resolve(cwd);
+  const safePath = `--${resolvedCwd.replace(/^[/\\]/, "").replace(/[/\\:]/g, "-")}--`;
+  return join2(resolve(agentDir), "sessions", safePath);
+}
+async function createSessionManager(cwd, sessionDir, sessionId, api3 = SessionManager) {
+  if (sessionId) {
+    const infos = await api3.list(cwd, sessionDir);
+    const info = infos.find((session) => session.id === sessionId);
+    if (!info) {
+      throw new Error(`No session found matching '${sessionId}' in this directory`);
+    }
+    return api3.open(info.path, sessionDir);
+  }
+  return api3.create(cwd, sessionDir);
+}
 async function launchPi(opts) {
-  const sessionId = crypto.randomUUID();
-  const { settingsManager, resourceLoaderOptions, tools } = buildRuntimeOptions(opts, sessionId);
   const cwd = process.cwd();
+  const sessionDir = getSessionDir(cwd, opts.agentDir);
+  const sm = await createSessionManager(cwd, sessionDir, opts.session);
+  const sessionId = sm.getSessionId();
+  const { settingsManager, resourceLoaderOptions, tools } = buildRuntimeOptions(opts, sessionId);
   const createRuntime = async ({
     cwd: rtCwd,
     sessionManager,
@@ -19252,13 +19288,14 @@ async function launchPi(opts) {
   const runtime = await createAgentSessionRuntime(createRuntime, {
     cwd,
     agentDir: opts.agentDir,
-    sessionManager: SessionManager.create(cwd)
+    sessionManager: sm
   });
   const mode = new InteractiveMode(runtime, {
     initialImages: [],
     initialMessages: []
   });
   await mode.run();
+  return sm.getSessionId();
 }
 
 // src/prompt.ts
@@ -19272,6 +19309,8 @@ free-pi — before you start
   * A persistent ad banner and occasional inline ad cards render in the
     terminal UI. Ad content never enters the model's context.
   * Your coding sessions may be used to train models.
+  * If GitHub email capture is enabled, we collect your GitHub email and may
+    use it to contact you about the service or product.
   * free-pi-cli auto-updates itself when a new version is available. Disable
     with FREEPI_NO_AUTO_UPDATE or {"autoUpdate":false} in ~/.free-pi/config.json.
 
@@ -19377,6 +19416,9 @@ async function checkToken(baseUrl, jwt2) {
     throw new UnauthorizedError;
 }
 
+// src/run.ts
+import { SessionManager as SessionManager2 } from "@earendil-works/pi-coding-agent";
+
 // src/credentials.ts
 import { mkdir, readFile, rm, writeFile, chmod } from "node:fs/promises";
 import { dirname } from "node:path";
@@ -19400,6 +19442,32 @@ async function clearJwt(credentialsPath) {
   await rm(credentialsPath, { force: true });
 }
 
+// src/onboarding.ts
+var INTRO_ENV_SKIP = "FREEPI_NO_INTRO";
+var INTRO_TEXT = `
+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
+    "npx free-pi-cli --session <id>" (the id prints when you exit).
+
+Set ${INTRO_ENV_SKIP}=1 to skip this next time.
+`.trim();
+function introSkipped(env = process.env) {
+  const v = env[INTRO_ENV_SKIP];
+  return v === "1" || v === "true";
+}
+function showIntro(log, env = process.env) {
+  if (introSkipped(env))
+    return;
+  log(`
+${INTRO_TEXT}
+`);
+}
+
 // src/run.ts
 async function loginFlow(deps) {
   const device = await startDeviceFlow(deps.baseUrl);
@@ -19412,7 +19480,27 @@ Open ${device.verification_uri} and enter code: ${device.user_code}
   await saveJwt(deps.credentialsPath, token);
   return token;
 }
-async function run(deps) {
+function parseSessionArg(argv) {
+  const flagIndex = argv.indexOf("--session");
+  if (flagIndex === -1)
+    return {};
+  const value = argv[flagIndex + 1];
+  if (!value || value.startsWith("--")) {
+    return { error: "Missing value for --session" };
+  }
+  try {
+    SessionManager2.inMemory(process.cwd(), { id: value });
+  } catch (err) {
+    return { error: `Invalid --session value: ${err instanceof Error ? err.message : String(err)}` };
+  }
+  return { session: value };
+}
+async function run(deps, argv = process.argv) {
+  const sessionArg = parseSessionArg(argv);
+  if (sessionArg.error) {
+    deps.log(sessionArg.error);
+    return 1;
+  }
   let jwt2 = await loadJwt(deps.credentialsPath);
   if (jwt2) {
     try {
@@ -19430,6 +19518,7 @@ async function run(deps) {
       deps.log("Declined. Exiting without contacting the free-pi server.");
       return 1;
     }
+    showIntro(deps.log);
     jwt2 = await loginFlow(deps);
   }
   const versionCheck = await deps.checkClientVersion(deps.baseUrl, CLI_VERSION);
@@ -19445,7 +19534,17 @@ async function run(deps) {
       deps.log(`update available: ${versionCheck.latest}, you have ${CLI_VERSION}; run \`npx free-pi-cli@latest\``);
     }
   }
-  await deps.launchPi({ baseUrl: deps.baseUrl, jwt: jwt2, agentDir: deps.agentDir });
+  const finalSessionId = await deps.launchPi({
+    baseUrl: deps.baseUrl,
+    jwt: jwt2,
+    agentDir: deps.agentDir,
+    session: sessionArg.session
+  });
+  deps.log(finalSessionId ? `
+free-pi session ended. Start it again anytime:  npx free-pi-cli --session ${finalSessionId}` : `
+free-pi session ended. Start it again anytime:  npx free-pi-cli`);
+  deps.log(`(or install once for a shorter command:  npm i -g free-pi-cli  →  free-pi-cli)
+`);
   return 0;
 }
 
@@ -19525,7 +19624,7 @@ async function main() {
     credentialsPath: getCredentialsPath(agentDir),
     promptConsent: promptConsentInteractive,
     openBrowser,
-    sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+    sleep: (ms) => new Promise((resolve2) => setTimeout(resolve2, ms)),
     launchPi,
     log: (message) => console.log(message),
     checkClientVersion,

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "free-pi-cli",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Free, ad-supported distribution of the pi coding agent. Inference paid for by ads.",
   "license": "MIT",
   "type": "module",
   "bin": {
-    "free-pi-cli": "./dist/index.js"
+    "free-pi-cli": "dist/index.js"
   },
   "files": [
     "dist",