@herbertgao/pi-extensions 2026.9.12 → 2026.9.13

package/node_modules/pi-typesafe/dist/login.d.ts

@@ -1,4 +1,5 @@
 import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import type { TypeSafeBackend } from "./backends.js";
 import type { KeySource } from "./credentials.js";
 export interface LoginResult {
     /** Where the verified key was saved. */
@@ -7,9 +8,10 @@ export interface LoginResult {
     models: number;
 }
 /**
- * Prompt for a key (hidden input), verify it with a model listing, and store it for every pi-typesafe consumer.
- * Resolves to undefined when the user cancels. Rejects with TypeSafeIntegrationError for an invalid or unverifiable key.
- * Refuses when TYPESAFE_API_KEY is set, because the environment would shadow the stored key.
+ * Prompt for a TypeSafe key (hidden input), verify it against api.typesafe.ai with a model listing, and store it for
+ * every pi-typesafe consumer. Resolves to undefined when the user cancels. Rejects with TypeSafeIntegrationError for an
+ * invalid or unverifiable key. Refuses when TYPESAFE_API_KEY is set, because the environment would shadow the stored
+ * key. Other backends have no login: their key is an environment variable only.
  */
 export declare function loginWithPrompt(ctx: ExtensionCommandContext): Promise<LoginResult | undefined>;
 export type EnsureApiKeyResult = {
@@ -20,8 +22,12 @@ export type EnsureApiKeyResult = {
     login: LoginResult;
 };
 /**
- * Use the configured key if there is one; otherwise run the login prompt. `undefined` means the user cancelled.
- * A store that must not be read throws `configuration` with the reason instead of prompting, so a permissions
- * problem stays visible; the result shape is frozen for existing callers.
+ * Use the configured key for the backend if there is one; otherwise run the login prompt. `undefined` means the user
+ * cancelled. A store that must not be read throws `configuration` with the reason instead of prompting, so a
+ * permissions problem stays visible; the result shape is frozen for existing callers. A backend without a login store
+ * (every backend except TypeSafe) throws `configuration` naming its environment variable instead of prompting, because
+ * the prompt would verify the key against the wrong service and store it where the TypeSafe key lives.
  */
-export declare function ensureApiKey(ctx: ExtensionCommandContext): Promise<EnsureApiKeyResult | undefined>;
+export declare function ensureApiKey(ctx: ExtensionCommandContext, options?: {
+    backend?: TypeSafeBackend;
+}): Promise<EnsureApiKeyResult | undefined>;

package/node_modules/pi-typesafe/dist/login.js

@@ -1,11 +1,13 @@
+import { DEFAULT_BACKEND, backendConfig, usesTypesafeKey } from "./backends.js";
 import { createTypeSafe } from "./client.js";
 import { keySituation, normalizeApiKey, storeApiKey } from "./credentials.js";
 import { TypeSafeIntegrationError } from "./errors.js";
 import { promptForApiKey } from "./key-prompt.js";
 /**
- * Prompt for a key (hidden input), verify it with a model listing, and store it for every pi-typesafe consumer.
- * Resolves to undefined when the user cancels. Rejects with TypeSafeIntegrationError for an invalid or unverifiable key.
- * Refuses when TYPESAFE_API_KEY is set, because the environment would shadow the stored key.
+ * Prompt for a TypeSafe key (hidden input), verify it against api.typesafe.ai with a model listing, and store it for
+ * every pi-typesafe consumer. Resolves to undefined when the user cancels. Rejects with TypeSafeIntegrationError for an
+ * invalid or unverifiable key. Refuses when TYPESAFE_API_KEY is set, because the environment would shadow the stored
+ * key. Other backends have no login: their key is an environment variable only.
  */
 export async function loginWithPrompt(ctx) {
     if (process.env.TYPESAFE_API_KEY?.trim()) {
@@ -23,16 +25,23 @@ export async function loginWithPrompt(ctx) {
     return { path: storeApiKey(key), models: models.length };
 }
 /**
- * Use the configured key if there is one; otherwise run the login prompt. `undefined` means the user cancelled.
- * A store that must not be read throws `configuration` with the reason instead of prompting, so a permissions
- * problem stays visible; the result shape is frozen for existing callers.
+ * Use the configured key for the backend if there is one; otherwise run the login prompt. `undefined` means the user
+ * cancelled. A store that must not be read throws `configuration` with the reason instead of prompting, so a
+ * permissions problem stays visible; the result shape is frozen for existing callers. A backend without a login store
+ * (every backend except TypeSafe) throws `configuration` naming its environment variable instead of prompting, because
+ * the prompt would verify the key against the wrong service and store it where the TypeSafe key lives.
  */
-export async function ensureApiKey(ctx) {
-    const situation = keySituation();
+export async function ensureApiKey(ctx, options = {}) {
+    const backend = options.backend ?? DEFAULT_BACKEND;
+    const situation = keySituation(backend);
     if (situation.kind === "environment" || situation.kind === "stored")
         return { source: situation.kind };
     if (situation.kind === "unusable")
         throw new TypeSafeIntegrationError("configuration", situation.reason);
+    const config = backendConfig(backend);
+    if (!usesTypesafeKey(config)) {
+        throw new TypeSafeIntegrationError("configuration", `No ${config.label} key. Set ${config.keyEnv} in the environment; /typesafe login stores a TypeSafe key only.`);
+    }
     const login = await loginWithPrompt(ctx);
     return login ? { source: "stored", login } : undefined;
 }

package/node_modules/pi-typesafe/dist/schema.js

@@ -5,42 +5,48 @@ import { TypeSafeIntegrationError } from "./errors.js";
 export const DEFAULT_MAX_INPUT_BYTES = 65_536;
 /** Questions one request may ask. More than this needs `chunkEvaluationRequest`, which splits and fans out. */
 export const DEFAULT_MAX_QUESTIONS = 32;
-// The API accepts structured descriptions, not only strings.
-const entry = Type.Union([
+// The API accepts structured descriptions, not only strings. The schema is the only shape guidance the model gets
+// before its first call, so every field the agent authors says what it means.
+const entry = (description) => Type.Union([
     Type.String(),
     Type.Null(),
     Type.Array(Type.Unknown()),
     Type.Record(Type.String(), Type.Unknown()),
-]);
-const instructions = Type.Optional(entry);
+], description === undefined ? {} : { description });
+const instructions = Type.Optional(entry("One judgment about the whole state, phrased as a question or a statement."));
 const question = Type.Union([
     Type.Object({
-        type: Type.Literal("noul"),
+        type: Type.Literal("noul", { description: "Yes or no: the probability the instructions hold." }),
         instructions,
         criteria: Type.Optional(Type.Union([
             Type.Null(),
-            Type.Object({ true: Type.Optional(entry), false: Type.Optional(entry) }, { additionalProperties: false }),
-        ])),
+            Type.Object({ true: Type.Optional(entry()), false: Type.Optional(entry()) }, { additionalProperties: false }),
+        ], { description: "Optional: what counts as yes and what counts as no, { true, false }." })),
     }, { additionalProperties: false }),
     Type.Object({
-        type: Type.Literal("choice"),
+        type: Type.Literal("choice", { description: "Pick one criteria label." }),
         instructions,
-        criteria: Type.Record(Type.String({ minLength: 1, maxLength: 200 }), entry, { minProperties: 1, maxProperties: 64 }),
+        criteria: Type.Record(Type.String({ minLength: 1, maxLength: 200 }), entry(), {
+            minProperties: 1,
+            maxProperties: 64,
+            description: "The options as a map from label to when it applies: { billing: \"Charges and payments\", other: null }. 1–64 entries.",
+        }),
     }, { additionalProperties: false }),
     Type.Object({
-        type: Type.Literal("score"),
+        type: Type.Literal("score", { description: "Rate against the ordered criteria levels." }),
         instructions,
-        criteria: Type.Array(entry, { minItems: 2, maxItems: 32 }),
+        criteria: Type.Array(entry(), { minItems: 2, maxItems: 32, description: "Ordered rubric levels, lowest first: [\"neutral\", \"angry\"]. 2–32 levels." }),
     }, { additionalProperties: false }),
 ]);
 /** The JSON schema used by both the Pi tool and the programmatic interface. */
 export const evaluationSchema = Type.Object({
-    state: entry,
+    state: entry("What to judge: text, or an object whose fields the questions name."),
     questions: Type.Record(Type.String({ minLength: 1, maxLength: 100 }), question, {
         minProperties: 1,
         maxProperties: DEFAULT_MAX_QUESTIONS,
+        description: "Questions keyed by a short id, as an object map, not an array: { \"urgent\": { type: \"noul\", instructions: ... } }.",
     }),
-    model: Type.Optional(Type.String({ minLength: 1, maxLength: 100 })),
+    model: Type.Optional(Type.String({ minLength: 1, maxLength: 100, description: "Jev model id, e.g. jev-latest. Omit for the default." })),
 }, { additionalProperties: false });
 const usage = `Expected { state, questions: { <id>: { type: "choice", instructions, criteria: { label: description|null } } | { type: "score", instructions, criteria: [level0, level1, ...] } | { type: "noul", instructions } } }; 1–${DEFAULT_MAX_QUESTIONS} questions, Choice 1–64 options, Score 2–32 levels.`;
 /** Paths and messages only; never the submitted values. */

package/node_modules/pi-typesafe/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-typesafe",
-  "version": "0.6.1",
+  "version": "0.7.1",
   "description": "TypeSafe AI (Jev) decisions for Pi: batched Choice/Score/Noul evaluation tool, terminal playground, and a typed API other extensions build on.",
   "type": "module",
   "license": "MIT",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herbertgao/pi-extensions",
-  "version": "2026.9.12",
+  "version": "2026.9.13",
   "description": "Aggregate installer for HerbertGao-maintained Pi extensions.",
   "keywords": [
     "extensions",
@@ -43,7 +43,7 @@
     "@earendil-works/pi-tui": "^0.85.1",
     "@herbertgao/pi-bark": "0.1.2",
     "@herbertgao/pi-cc-extensions": "0.9.4",
-    "@herbertgao/pi-subagents": "0.18.1",
+    "@herbertgao/pi-subagents": "0.18.2",
     "@herbertgao/resume-from": "0.2.2",
     "@herbertgao/sol-pi": "0.3.1",
     "@juicesharp/rpiv-ask-user-question": "2.11.0",
@@ -55,7 +55,7 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@mozilla/readability": "^0.6.0",
     "@napi-rs/keyring": "^1.3.0",
-    "@narumitw/pi-btw": "0.60.3",
+    "@narumitw/pi-btw": "0.61.0",
     "@narumitw/pi-caffeinate": "0.49.8",
     "@narumitw/pi-tui-kit": "^0.64.0",
     "@noble/ed25519": "^3.1.0",
@@ -91,8 +91,8 @@
     "pi-jev-auto-mode": "0.4.1",
     "pi-lens": "4.2.1",
     "pi-mcp-adapter": "2.36.0",
-    "pi-multi-account": "1.22.0",
-    "pi-typesafe": "0.6.1",
+    "pi-multi-account": "1.23.0",
+    "pi-typesafe": "0.7.1",
     "pi-web-access": "0.30.0",
     "pidusage": "^4.0.1",
     "promise.try": "^2.0.1",