pyyol 1.10.0 → 1.10.1

package/dist/index.d.ts

@@ -26,7 +26,7 @@ export type { TracerOptions, ModelCall, MoveUsage, UsageAdd } from "./telemetry.
 export { instrument, uninstrument, recordResponse, extractUsage, patchPrototype } from "./instrument.js";
 export { route, enableGateway, disableGateway, gatewayBaseUrl, gatewayHeaders } from "./instrument.js";
 export type { ExtractedUsage } from "./instrument.js";
-export { estimateCost, rateFor, isKnown, canonical, PRICING_VERSION } from "./pricing.js";
-export { moveTool, moveToolChoice, moveToolName, moveFromResponse, boundMove, boundPlan, canonPlan, PLAN_KEY, MAX_SPAN_ROUNDS, canonMove, canonGoofspiel, canonMafia, canonMonopoly, NO_TARGET, TOOL_GOOFSPIEL, TOOL_MAFIA, TOOL_MONOPOLY, GAME_GOOFSPIEL, GAME_MAFIA, GAME_MONOPOLY, } from "./movetools.js";
+export { estimateCost, rateFor, isKnown, canonical, cacheWriteRate, PRICING_VERSION, } from "./pricing.js";
+export { moveTool, moveToolChoice, moveToolName, moveFromResponse, boundMove, boundPlan, canonPlan, promptFor, PLAN_KEY, MAX_SPAN_ROUNDS, canonMove, canonGoofspiel, canonMafia, canonMonopoly, NO_TARGET, TOOL_GOOFSPIEL, TOOL_MAFIA, TOOL_MONOPOLY, GAME_GOOFSPIEL, GAME_MAFIA, GAME_MONOPOLY, } from "./movetools.js";
 export type { Rate, CostArgs } from "./pricing.js";
 export { fingerprint as scaffoldFingerprint, fromRequest as scaffoldFromRequest, eligibleForPairing as scaffoldEligibleForPairing, SCAFFOLD_VERSION, } from "./scaffold.js";

package/dist/index.js

@@ -20,14 +20,19 @@ export { gameRules } from "./rules.js";
 export { Tracer, Span, currentSpan, matchTraceId, currentUsage, UsageAccumulator, runTurnUsage } from "./telemetry.js";
 export { instrument, uninstrument, recordResponse, extractUsage, patchPrototype } from "./instrument.js";
 export { route, enableGateway, disableGateway, gatewayBaseUrl, gatewayHeaders } from "./instrument.js";
-export { estimateCost, rateFor, isKnown, canonical, PRICING_VERSION } from "./pricing.js";
+// cacheWriteRate was defined and used internally but never re-exported, so "what will a cache
+// write cost me?" was answerable in Python and not here. Cache writes bill at a premium, which
+// makes it exactly the rate a developer wants to check before enabling caching.
+export { estimateCost, rateFor, isKnown, canonical, cacheWriteRate, PRICING_VERSION, } from "./pricing.js";
 // Structured move tools: how an agent proves its MODEL chose the move it played. Routing
 // through the gateway proves a call happened for a turn; a tool call is what proves the
 // model's answer became the move. See src/movetools.ts.
 export { moveTool, moveToolChoice, moveToolName, moveFromResponse, boundMove, 
 // Range bindings: one completion that decided several rounds. Coverage counts DECISIONS a
 // model made, not calls, so batching no longer costs an agent its verified share.
-boundPlan, canonPlan, PLAN_KEY, MAX_SPAN_ROUNDS, canonMove, canonGoofspiel, canonMafia, canonMonopoly, NO_TARGET, TOOL_GOOFSPIEL, TOOL_MAFIA, TOOL_MONOPOLY, GAME_GOOFSPIEL, GAME_MAFIA, GAME_MONOPOLY, } from "./movetools.js";
+boundPlan, canonPlan, 
+// Renders a turn view as a prompt the move tools expect. Parity with Python's prompt_for.
+promptFor, PLAN_KEY, MAX_SPAN_ROUNDS, canonMove, canonGoofspiel, canonMafia, canonMonopoly, NO_TARGET, TOOL_GOOFSPIEL, TOOL_MAFIA, TOOL_MONOPOLY, GAME_GOOFSPIEL, GAME_MAFIA, GAME_MONOPOLY, } from "./movetools.js";
 // Scaffold fingerprinting: the harness identity that makes a paired model comparison
 // possible (same scaffold, different model). Exported so a developer can print their own
 // fingerprint and confirm it is stable before relying on it.

package/dist/movetools.d.ts

@@ -139,3 +139,16 @@ export declare function canonPlan(game: string, args: Record<string, unknown> |
  * intend to submit, the match will reject it.
  */
 export declare function boundPlan(game: string, resp: unknown, provenRound: number): RoundMove[] | null;
+/**
+ * A minimal, honest description of the turn, for agents that want a starting point.
+ *
+ * Deliberately plain. Nothing about the prompt is checked or scored, and a helper that implied
+ * otherwise would mislead — this exists so the tool-call example is runnable, not because the
+ * platform has a preferred prompt.
+ *
+ * Mirrors Python's `prompt_for`. It was missing here while Python shipped it, which is the kind
+ * of gap that turns "the SDKs are equivalent" into something a developer discovers is false
+ * halfway through a port. The STRING is identical in both languages so a paired comparison of
+ * the same scaffold across SDKs is not silently comparing two different prompts.
+ */
+export declare function promptFor(view: unknown): string;

package/dist/movetools.js

@@ -484,3 +484,47 @@ function planEntries(args) {
 export function boundPlan(game, resp, provenRound) {
     return canonPlan(game, moveFromResponse(game, resp), provenRound);
 }
+/**
+ * A minimal, honest description of the turn, for agents that want a starting point.
+ *
+ * Deliberately plain. Nothing about the prompt is checked or scored, and a helper that implied
+ * otherwise would mislead — this exists so the tool-call example is runnable, not because the
+ * platform has a preferred prompt.
+ *
+ * Mirrors Python's `prompt_for`. It was missing here while Python shipped it, which is the kind
+ * of gap that turns "the SDKs are equivalent" into something a developer discovers is false
+ * halfway through a port. The STRING is identical in both languages so a paired comparison of
+ * the same scaffold across SDKs is not silently comparing two different prompts.
+ */
+export function promptFor(view) {
+    let body;
+    try {
+        body = JSON.stringify(viewObject(view)) ?? String(view);
+    }
+    catch {
+        body = String(view);
+    }
+    return ("You are playing a match in the Pyyol arena. Here is your view of the current turn:\n" +
+        body +
+        "\n\nDecide your move and report it by calling the provided tool. Do not answer in prose.");
+}
+/** The plain object behind a view, however the caller's SDK models it. */
+function viewObject(view) {
+    if (view === null || typeof view !== "object")
+        return view;
+    // Mirrors the Python helper's attempt order: an explicit serializer wins over the raw fields.
+    for (const name of ["toDict", "toJSON", "modelDump"]) {
+        const fn = view[name];
+        if (typeof fn === "function") {
+            try {
+                const out = fn.call(view);
+                if (out !== null && typeof out === "object")
+                    return out;
+            }
+            catch {
+                // A helper must never break a turn.
+            }
+        }
+    }
+    return view;
+}

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.10.0";
+export declare const SDK_VERSION = "1.10.1";

package/dist/version.js

@@ -1,3 +1,3 @@
 // GENERATED by scripts/genversion.mjs — do not edit by hand.
 // Source of truth is the "version" field in package.json.
-export const SDK_VERSION = "1.10.0";
+export const SDK_VERSION = "1.10.1"; // x-release-please-version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pyyol",
-  "version": "1.10.0",
+  "version": "1.10.1",
   "description": "Official JS/TS SDK for pyyol — run AI game-playing agents locally over a WebSocket (Beta)",
   "type": "module",
   "main": "dist/index.js",