@lokeraar/pi-enclave-bridge 0.1.0 → 0.1.1

package/README.md

@@ -1,10 +1,47 @@
 # @lokeraar/pi-enclave-bridge
 
+[![Version: 0.1.1](https://img.shields.io/badge/version-0.1.1-blue.svg)](https://www.npmjs.com/package/@lokeraar/pi-enclave-bridge)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 EnClave provider for [Pi](https://pi.dev). The live router catalog shows up in
 `/model` with **real context windows, real per-token prices, live membership and
 the router's task aliases** — resolved from the model catalog Pi already ships,
 with no extra account required.
 
+<a href="https://github.com/Gentleman-Programming/gentle-ai">
+  <img width="220" src="https://raw.githubusercontent.com/Gentleman-Programming/gentle-ai/main/docs/assets/brand/built-with-gentle-ai.png" alt="Built with Gentle-AI" />
+</a>
+
+## 📋 Releases
+
+### 0.1.1 — a clamp that left room for an actual prompt
+
+The ceiling clamp kept back 2,048 tokens for the prompt. That router counts
+`messages + tools + max_tokens` against the window, not the output alone, and a
+real Pi call carries the system prompt plus every tool schema — order 20k
+tokens. The reserve only covered a toy request.
+
+`gpt-oss-120b` exposed it: a 131,072 window with a 117,964 ceiling left 13,108
+tokens for input, below what Pi sends, so **every** call failed with `400` as
+soon as the conversation carried anything. Measured with the same prompt:
+
+```
+input ~16k   ceiling 117964   HTTP 400   "needs about 133,972 tokens"
+input ~16k   ceiling  98304   HTTP 200
+input ~28k   ceiling  98304   HTTP 200
+```
+
+The published value is a ceiling, not a fixed request: Pi reduces it per turn to
+`min(published, contextWindow − prompt − reserve)`. The reserve just had to be
+realistic.
+
+### 0.1.0 — first release
+
+Values resolved from the model catalog Pi ships, with the vendor's model card
+outranking every catalog. `/login` once and the live router catalog appears in
+`/model` with real context windows, real per-token prices, live membership and
+the router's task aliases.
+
 ## ⚡ Quick Start
 
 ```bash

package/enclave-live.ts

@@ -181,8 +181,14 @@ const num = (v: unknown, fallback: number) => (typeof v === "number" && v > 0 ?
 /**
  * Tokens held back from an output ceiling so the prompt has room. See the clamp
  * in buildBlock.
+ *
+ * This must cover a real Pi request, not a toy one. The router counts
+ * `messages + tools + max_tokens` against the window, so a reserve smaller than
+ * the system prompt plus every tool schema makes the model unusable in practice:
+ * gpt-oss-120b (131,072 window) shipped a 117,964 ceiling that left ~13k for
+ * input, below what Pi sends, and every call 400'd once the conversation grew.
  */
-const PROMPT_RESERVE_TOKENS = 2_048;
+export const PROMPT_RESERVE_TOKENS = 32_768;
 
 /** Aliases the router exposes: never resolved from a donor. See donors.ts. */
 function isAliasId(id: string, aliases: readonly CatalogAlias[]): boolean {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lokeraar/pi-enclave-bridge",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "EnClave provider bridge for Pi: /login once and the live router catalog appears in /model with real context windows, real per-token prices, live membership and the router's task aliases \u2014 resolved from the model catalog Pi already ships.",
   "type": "module",
   "main": "./index.ts",

package/scripts/test-sync.mjs

@@ -20,7 +20,7 @@ import { join } from "node:path";
 const ROOT = join(new URL(".", import.meta.url).pathname, "..");
 const { bareName, resolveModel, readBundledCatalog, readPiCatalogs, findBundledCatalogDir, findBundledCatalogs, ROUNDING_TOLERANCE } =
   await import(join(ROOT, "donors.ts"));
-const { buildBlock } = await import(join(ROOT, "enclave-live.ts"));
+const { buildBlock, PROMPT_RESERVE_TOKENS } = await import(join(ROOT, "enclave-live.ts"));
 
 let passed = 0;
 const failed = [];
@@ -214,7 +214,8 @@ console.log("\nthe block: matching, near misses, endpoint-owned fields");
   check("alias price is the catalog ceiling", by["cyberouter/auto"].cost.input === 1.4, String(by["cyberouter/auto"].cost.input));
   check("aliases carry no donor record", by["cyberouter/auto"].donor === undefined);
 
-  check("an impossible ceiling is clamped below the window", by["cyberouter/inkling"].maxTokens === 262144 - 2048, String(by["cyberouter/inkling"].maxTokens));
+  check("an impossible ceiling is clamped below the window", by["cyberouter/inkling"].maxTokens === 262144 - PROMPT_RESERVE_TOKENS, String(by["cyberouter/inkling"].maxTokens));
+  check("the clamp leaves room for a real prompt", PROMPT_RESERVE_TOKENS >= 32_768, String(PROMPT_RESERVE_TOKENS));
   check("maxTokens is never null (Pi crashes formatting it)", out.models.every((m) => typeof m.maxTokens === "number"), "hay un null");
 }