free-pi-cli 0.2.15 → 0.2.18

package/README.md

@@ -5,7 +5,7 @@ for the user because ads pay for inference. All model calls route through the
 free-pi proxy — you never handle a model API key.
 
 ```
-npx free-pi-cli
+npx --no-audit free-pi-cli
 ```
 
 First run shows a consent screen (free inference, ads pay for it, sessions
@@ -18,7 +18,7 @@ existing `~/.pi/agent` install.
 Closed the terminal? Just run the same command again — you stay signed in:
 
 ```
-npx free-pi-cli
+npx --no-audit free-pi-cli
 ```
 
 Prefer a shorter command? Install it once, globally, then call it by name:

package/dist/index.js

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

package/dist/{main-d6chy61g.js → main-9w6ygmca.js}

@@ -48,7 +48,7 @@ function openBrowser(url, platform = process.platform, spawnImpl = spawn) {
 // package.json
 var package_default = {
   name: "free-pi-cli",
-  version: "0.2.15",
+  version: "0.2.18",
   description: "Free, ad-supported distribution of the pi coding agent. Inference paid for by ads.",
   license: "MIT",
   type: "module",
@@ -14774,6 +14774,7 @@ async function fetchMe(deps) {
 }
 
 // ../pi-ads/src/style.ts
+import { createHash } from "node:crypto";
 var OSC_RE = /\x1b\][\s\S]*?(?:\x07|\x1b\\)/g;
 var CSI_RE = /\x1b\[[0-9;?]*[ -/]*[@-~]/g;
 var C1_RE = /[\x80-\x9f]/g;
@@ -14793,8 +14794,9 @@ function truncate(text, maxWidth) {
 function pad(text, width) {
   return text.length >= width ? text.slice(0, width) : text + " ".repeat(width - text.length);
 }
-function osc8(text, url2) {
-  return `\x1B]8;;${url2}\x07${text}\x1B]8;;\x07`;
+function osc8(text, url2, id) {
+  const params = id ? `id=${id}` : "";
+  return `\x1B]8;${params};${url2}\x07${text}\x1B]8;;\x07`;
 }
 function renderAdCard(creative, clickUrl, theme, columns) {
   const headline = sanitizeText(creative.headline);
@@ -14805,20 +14807,20 @@ function renderAdCard(creative, clickUrl, theme, columns) {
   const label = " AD ░▒▓ ";
   const top = `┌${label}${"─".repeat(Math.max(0, innerWidth + 2 - label.length))}┐`;
   const bottom = `└${"─".repeat(innerWidth + 2)}┘`;
+  const linkId = createHash("sha256").update(url2).digest("hex").slice(0, 12);
   const row = (text, opts) => {
     const plain = pad(truncate(text, innerWidth), innerWidth);
     let styled = theme.fg("accent", plain);
     if (opts?.bold)
       styled = theme.bold(styled);
-    const content = opts?.linkUrl ? osc8(styled, opts.linkUrl) : styled;
-    return `│ ${content} │`;
+    return `│ ${styled} │`;
   };
   return [
-    theme.fg("borderAccent", top),
-    row(headline, { bold: true }),
-    row(body),
-    row(`▸ ${cta}`, { linkUrl: url2 }),
-    theme.fg("borderAccent", bottom)
+    theme.fg("borderAccent", osc8(top, url2, linkId)),
+    osc8(row(headline, { bold: true }), url2, linkId),
+    osc8(row(body), url2, linkId),
+    osc8(row(`▸ ${cta}`), url2, linkId),
+    theme.fg("borderAccent", osc8(bottom, url2, linkId))
   ];
 }
 function renderPlainAdLine(creative, clickUrl, theme, columns) {
@@ -19409,6 +19411,73 @@ function createBuyToolExtension(opts) {
   };
 }
 
+// src/docs.ts
+var FREE_PI_DOCS = `# free-pi
+
+## What free-pi is
+free-pi is a free, ad-supported distribution of the pi coding agent.
+You run \`npx free-pi-cli\`, sign in with GitHub, and get free inference with
+exciting models. Ads shown in the terminal pay for it. You never handle a
+model API key. Config and the sign-in token live under \`~/.free-pi/agent\`,
+separate from any \`~/.pi/agent\` install.
+
+## The promise
+Ad text never enters the model's context. Ads render only in the terminal,
+in a framed card, and the model never sees them.
+Coding sessions may be used to train models. This is on the consent screen
+at first run, before the GitHub sign-in.
+
+## The free allowance
+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,
+\`/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.
+
+## Commands
+- \`/usage\` — spend and remaining budget today
+- \`/support\` — visit today's advertiser
+- \`/tos\` — open the Terms of Service
+- \`/privacy-policy\` — open the Privacy Policy
+- \`/buy-credits\` — get more usage
+- \`/close-other-session\` — free a stuck session on another machine
+- \`/update\` — get the latest free-pi
+- \`/whats-new\` — what changed in recent releases
+
+## Support
+Today's sponsor keeps free-pi free. When the user asks how to help the
+project, or seems to like free-pi, suggest \`/support\` to visit the sponsor.
+More at https://freepi.ai
+`;
+
+// src/docs-tool.ts
+var DOCS_TOOL_NAME = "free_pi_docs";
+var PARAMS3 = exports_typebox.Object({});
+function createDocsToolExtension() {
+  return {
+    name: "free-pi-docs-tool",
+    factory(pi) {
+      pi.registerTool({
+        name: DOCS_TOOL_NAME,
+        label: "About free-pi",
+        description: "Returns the built-in free-pi guide. Read-only, takes no arguments, makes no network calls.",
+        promptSnippet: "Explain free-pi itself: what it is, how the free allowance and ads work, credits, and the free-pi slash commands",
+        parameters: PARAMS3,
+        async execute() {
+          return {
+            content: [{ type: "text", text: FREE_PI_DOCS }],
+            details: { ok: true }
+          };
+        }
+      });
+    }
+  };
+}
+
 // src/error-notice.ts
 var NOTICE_DEDUPE_MS = 15000;
 function parseErrorEnvelope(errorMessage) {
@@ -19480,6 +19549,26 @@ function createToolGuardExtension(opts) {
 
 // src/changelog.ts
 var CHANGELOG_HIGHLIGHTS = [
+  {
+    version: "0.2.18",
+    highlights: [
+      "Clearer wording in the startup consent line."
+    ]
+  },
+  {
+    version: "0.2.17",
+    highlights: [
+      "/tos and /privacy-policy open the Terms and Privacy Policy in your browser.",
+      "The consent screen and startup header now state that usage is funded by ads and training."
+    ]
+  },
+  {
+    version: "0.2.16",
+    highlights: [
+      "The whole ad card is now one clickable link.",
+      "Ask the agent about free-pi: it can explain the allowance, credits, and commands."
+    ]
+  },
   {
     version: "0.2.15",
     highlights: [
@@ -19644,6 +19733,16 @@ async function openAdvertiser(opts, ctx) {
   (opts.openBrowserImpl ?? openBrowser)(url2);
   ctx.ui.notify("Opening today's advertiser in your browser. Thank you for supporting free-pi.", "info");
 }
+var TERMS_URL = "https://freepi.ai/terms";
+var PRIVACY_URL = "https://freepi.ai/privacy";
+async function openTos(opts, ctx) {
+  (opts.openBrowserImpl ?? openBrowser)(TERMS_URL);
+  ctx.ui.notify(`Opening the Terms of Service in your browser: ${TERMS_URL}`, "info");
+}
+async function openPrivacyPolicy(opts, ctx) {
+  (opts.openBrowserImpl ?? openBrowser)(PRIVACY_URL);
+  ctx.ui.notify(`Opening the Privacy Policy in your browser: ${PRIVACY_URL}`, "info");
+}
 async function showUsage(opts, ctx) {
   const r = await fetchUsageText(opts);
   ctx.ui.notify(r.text, r.ok ? "info" : "error");
@@ -19676,6 +19775,14 @@ function createFreePiCommandsExtension(opts) {
         description: "Open today's advertiser in your browser to support free-pi.",
         handler: (_args, ctx) => openAdvertiser(opts, ctx)
       });
+      pi.registerCommand("tos", {
+        description: "Open the free-pi Terms of Service in your browser.",
+        handler: (_args, ctx) => openTos(opts, ctx)
+      });
+      pi.registerCommand("privacy-policy", {
+        description: "Open the free-pi Privacy Policy in your browser.",
+        handler: (_args, ctx) => openPrivacyPolicy(opts, ctx)
+      });
     }
   };
 }
@@ -19684,12 +19791,16 @@ function createFreePiCommandsExtension(opts) {
 var COMMANDS = [
   { name: "/usage", description: "spend and remaining budget today" },
   { name: "/support", description: "visit today's advertiser" },
+  { name: "/tos", description: "terms of service" },
+  { name: "/privacy-policy", description: "privacy policy" },
   { name: "/buy-credits", description: "get more usage" },
   { name: "/close-other-session", description: "free a stuck session on another machine" },
   { name: "/update", description: "get the latest free-pi" }
 ];
 var NAME_COLUMN = 24;
 var WELCOME_LINE = "Welcome to Free Pi, ad-supported inference. Please visit our advertisers to support us.";
+var CONSENT_LINE_1 = "Usage is funded by ads and training. By using free-pi you consent.";
+var CONSENT_LINE_2 = "See /tos and /privacy-policy.";
 var EXPANDED_HINT_LINE = "esc interrupt · ctrl+c clear / exit · / commands · ! bash";
 function truncate2(text, maxWidth) {
   if (maxWidth <= 0)
@@ -19710,7 +19821,18 @@ function headerLines(theme, modelName, expanded, width = Number.POSITIVE_INFINIT
     return fit(`${padded}${description}`, () => `${padded}${theme.fg("dim", description)}`);
   });
   const dim = (plain) => fit(plain, () => theme.fg("dim", plain));
-  const lines = ["", title, "", dim(WELCOME_LINE), "", ...commandLines, ""];
+  const lines = [
+    "",
+    title,
+    "",
+    dim(WELCOME_LINE),
+    "",
+    dim(CONSENT_LINE_1),
+    dim(CONSENT_LINE_2),
+    "",
+    ...commandLines,
+    ""
+  ];
   if (expanded)
     lines.push(dim(EXPANDED_HINT_LINE));
   return lines.map((line) => line === "" ? line : ` ${line}`);
@@ -19758,7 +19880,7 @@ function catalogModelsFor(opts) {
   const id = opts.model || MODEL_ID;
   return [{ id, name: id }];
 }
-var ALLOWED_TOOL_NAMES = [...SAFE_TOOLS, USAGE_TOOL_NAME, BUY_TOOL_NAME];
+var ALLOWED_TOOL_NAMES = [...SAFE_TOOLS, USAGE_TOOL_NAME, BUY_TOOL_NAME, DOCS_TOOL_NAME];
 function resolveModelName(opts) {
   return opts.models?.[0]?.name || opts.model || MODEL_ID;
 }
@@ -19787,6 +19909,7 @@ function buildRuntimeOptions(opts, sessionId) {
     baseUrl: opts.baseUrl,
     getToken: () => opts.jwt
   });
+  const docsToolExtension = createDocsToolExtension();
   const errorNoticeExtension = createErrorNoticeExtension();
   const toolGuardExtension = createToolGuardExtension({
     baseUrl: opts.baseUrl,
@@ -19806,6 +19929,7 @@ function buildRuntimeOptions(opts, sessionId) {
     adsExtension,
     usageToolExtension,
     buyToolExtension,
+    docsToolExtension,
     errorNoticeExtension,
     toolGuardExtension,
     commandsExtension,
@@ -19892,18 +20016,28 @@ import { createInterface } from "node:readline/promises";
 var CONSENT_TEXT = `
 free-pi — before you start
 
-  * Inference is free. Ads pay for it.
-  * 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.
+  * Inference is free. Ads pay for it, and so does training.
+  * Ad cards render in the terminal UI. Ad content never enters the model's
+    context.
+  * Your coding sessions (prompts, code, files, and model responses) are saved
+    as traces and used to train models. We may share or sell that data to
+    third parties. Once you accept, there is no opt-out, except where the law
+    gives you one.
+  * We do our best to remove personal information from traces before we store
+    them. We cannot promise it is perfectly clean.
+  * free-pi is in alpha and testing. There are no warranties or guarantees,
+    expressed or implied, and no guarantee of uptime.
   * 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.
 
+By accepting you agree to the Terms of Service (https://freepi.ai/terms)
+and the Privacy Policy (https://freepi.ai/privacy).
+
 Decline and nothing is sent to the free-pi server.
 `.trim();
-var CONSENT_VERSION = "1";
+var CONSENT_VERSION = "2";
 var NON_INTERACTIVE_CONSENT_TEXT = "free-pi first-run consent needs an interactive terminal (stdin is not a TTY). " + "Run `npx free-pi-cli` in a terminal once to review and accept; " + "after that, non-interactive runs work.";
 var CONSENT_PROMPT = "Accept? [y/N] ";
 function parseConsentAnswer(answer) {

package/package.json

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