npm - pyyol - Versions diffs - 1.2.0 - Mend

pyyol 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (65) hide show

package/dist/login.js ADDED Viewed

@@ -0,0 +1,107 @@
+/**
+ * The `pyyol login` browser flow (mirrors the Python SDK). Opens the dashboard's
+ * `/cli-login` page and captures the issued token on a loopback callback — the
+ * GitHub-CLI model. The dashboard owns the actual auth (GitHub / Google / wallet /
+ * email); the CLI is provider-agnostic and just captures the returned token.
+ */
+import { spawn } from "node:child_process";
+import { randomBytes, timingSafeEqual } from "node:crypto";
+import { createServer } from "node:http";
+/** Constant-time string compare (length-guarded so timingSafeEqual never throws). */
+function safeEqual(a, b) {
+    const ab = Buffer.from(a);
+    const bb = Buffer.from(b);
+    return ab.length === bb.length && timingSafeEqual(ab, bb);
+}
+/** Derive the WSS connect URL from a platform API/base URL. */
+export function deriveConnectUrl(apiUrl) {
+    if (!apiUrl)
+        return "";
+    try {
+        const u = new URL(apiUrl);
+        const scheme = u.protocol === "https:" || u.protocol === "wss:" ? "wss:" : "ws:";
+        return `${scheme}//${u.host}/v1/agent/connect`;
+    }
+    catch {
+        return "";
+    }
+}
+function openBrowser(url) {
+    // NEVER use shell:true here — the auth URL contains `&` (…&state=…&provider=…),
+    // which cmd.exe would treat as a command separator (arg/command injection via a
+    // hostile --dashboard). Pass the URL as a discrete, non-shell argument.
+    let cmd;
+    let args;
+    if (process.platform === "win32") {
+        cmd = "cmd";
+        args = ["/c", "start", "", url]; // empty title arg so a quoted URL isn't taken as the title
+    }
+    else if (process.platform === "darwin") {
+        cmd = "open";
+        args = [url];
+    }
+    else {
+        cmd = "xdg-open";
+        args = [url];
+    }
+    try {
+        const child = spawn(cmd, args, { stdio: "ignore", detached: true, shell: false });
+        child.unref();
+    }
+    catch {
+        /* headless: the user can open the URL manually (printed by the caller) */
+    }
+}
+/** Run the loopback browser login and resolve with captured Credentials.
+ *  `open` overrides how the auth URL is opened (tests inject a fake). */
+export function runLoginFlow(opts) {
+    const state = randomBytes(16).toString("base64url");
+    const apiUrl = opts.apiUrl ?? "";
+    const opener = opts.open ?? openBrowser;
+    const timeoutMs = opts.timeoutMs ?? 180_000;
+    return new Promise((resolveP, reject) => {
+        const server = createServer((req, res) => {
+            const u = new URL(req.url ?? "/", "http://127.0.0.1");
+            if (u.pathname !== "/callback") {
+                res.writeHead(404).end();
+                return;
+            }
+            const token = u.searchParams.get("token") ?? "";
+            const ok = Boolean(token) && safeEqual(u.searchParams.get("state") ?? "", state);
+            res.writeHead(ok ? 200 : 400, { "Content-Type": "text/html; charset=utf-8" });
+            res.end(ok
+                ? "<!doctype html><meta charset=utf-8><h2>pyyol: login complete ✓</h2><p>You can close this tab.</p>"
+                : "<!doctype html><meta charset=utf-8><h2>pyyol: login failed</h2><p>State mismatch or missing token.</p>");
+            if (!ok)
+                return;
+            clearTimeout(timer);
+            server.close();
+            resolveP({
+                url: apiUrl,
+                connectUrl: u.searchParams.get("connect_url") || deriveConnectUrl(apiUrl),
+                agentId: u.searchParams.get("agent_id") ?? "",
+                accessToken: token,
+                refreshToken: u.searchParams.get("refresh_token") ?? "",
+                // Optional: the dashboard may hand back a long-lived agent key directly.
+                // If it doesn't, `pyyol login` mints one post-auth.
+                apiKey: u.searchParams.get("api_key") ?? "",
+                authUrl: "",
+            });
+        });
+        const timer = setTimeout(() => {
+            server.close();
+            reject(new Error("login timed out or was cancelled"));
+        }, timeoutMs);
+        server.listen(0, "127.0.0.1", () => {
+            const addr = server.address();
+            const port = typeof addr === "object" && addr ? addr.port : 0;
+            const callback = `http://127.0.0.1:${port}/callback`;
+            let authUrl = `${opts.dashboardUrl.replace(/\/$/, "")}/cli-login` +
+                `?callback=${encodeURIComponent(callback)}&state=${state}`;
+            if (opts.provider)
+                authUrl += `&provider=${encodeURIComponent(opts.provider)}`;
+            opener(authUrl);
+        });
+    });
+}
+//# sourceMappingURL=login.js.map

package/dist/login.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"login.js","sourceRoot":"","sources":["../src/login.ts"],"names":[],"mappings":"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"}

package/dist/mode.d.ts ADDED Viewed

@@ -0,0 +1,12 @@
+export declare const SANDBOX = "sandbox";
+export declare const RANKED = "ranked";
+export declare function resolveMode(opts: {
+    rankedFlag?: boolean;
+    cfgMode?: string;
+    devLocked?: boolean;
+}): string;
+export declare function banner(mode: string, color?: boolean): string;
+/** One-time confirmation before real-stakes play. In CI/non-TTY, only proceeds when
+ *  `assumeYes` is set — never silently enters ranked. */
+export declare function confirmRanked(assumeYes?: boolean): Promise<boolean>;
+//# sourceMappingURL=mode.d.ts.map

package/dist/mode.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"mode.d.ts","sourceRoot":"","sources":["../src/mode.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,OAAO,YAAY,CAAC;AACjC,eAAO,MAAM,MAAM,WAAW,CAAC;AAW/B,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG,MAAM,CAOT;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAQ5D;AAED;yDACyD;AACzD,wBAAsB,aAAa,CAAC,SAAS,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAYvE"}

package/dist/mode.js ADDED Viewed

@@ -0,0 +1,55 @@
+/**
+ * Money-safety mode model (mirrors the Python SDK): `sandbox` is the safe default;
+ * `ranked` (real stakes) needs an explicit opt-in. `pyyol dev` is hard-locked to
+ * sandbox; only `pyyol play <arena> --ranked` can reach ranked. Precedence for
+ * `play`: --ranked flag → PYYOL_MODE env → pyyol.toml → default sandbox.
+ */
+import { createInterface } from "node:readline";
+export const SANDBOX = "sandbox";
+export const RANKED = "ranked";
+const GREEN = "\x1b[32m";
+const RED = "\x1b[1;31m";
+const RESET = "\x1b[0m";
+function useColor() {
+    if (process.env.NO_COLOR)
+        return false;
+    return Boolean(process.stdout.isTTY);
+}
+export function resolveMode(opts) {
+    if (opts.devLocked)
+        return SANDBOX; // development never risks money
+    if (opts.rankedFlag)
+        return RANKED;
+    const env = (process.env.PYYOL_MODE ?? "").trim().toLowerCase();
+    if (env === SANDBOX || env === RANKED)
+        return env;
+    if (opts.cfgMode === SANDBOX || opts.cfgMode === RANKED)
+        return opts.cfgMode;
+    return SANDBOX;
+}
+export function banner(mode, color) {
+    const use = color === undefined ? useColor() : color;
+    if (mode === RANKED) {
+        const text = "⚠  RANKED — real stakes (escrow · Elo · P-Index)";
+        return use ? `${RED}${text}${RESET}` : text;
+    }
+    const text = "●  SANDBOX — practice, no stakes";
+    return use ? `${GREEN}${text}${RESET}` : text;
+}
+/** One-time confirmation before real-stakes play. In CI/non-TTY, only proceeds when
+ *  `assumeYes` is set — never silently enters ranked. */
+export async function confirmRanked(assumeYes = false) {
+    if (assumeYes)
+        return true;
+    if (!process.stdin.isTTY)
+        return false;
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const answer = await new Promise((res) => rl.question("This plays with REAL stakes. Continue? [y/N] ", res));
+        return ["y", "yes"].includes(answer.trim().toLowerCase());
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=mode.js.map

package/dist/mode.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"mode.js","sourceRoot":"","sources":["../src/mode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,CAAC,MAAM,OAAO,GAAG,SAAS,CAAC;AACjC,MAAM,CAAC,MAAM,MAAM,GAAG,QAAQ,CAAC;AAE/B,MAAM,KAAK,GAAG,UAAU,CAAC;AACzB,MAAM,GAAG,GAAG,YAAY,CAAC;AACzB,MAAM,KAAK,GAAG,SAAS,CAAC;AAExB,SAAS,QAAQ;IACf,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAI3B;IACC,IAAI,IAAI,CAAC,SAAS;QAAE,OAAO,OAAO,CAAC,CAAC,gCAAgC;IACpE,IAAI,IAAI,CAAC,UAAU;QAAE,OAAO,MAAM,CAAC;IACnC,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChE,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,GAAG,CAAC;IAClD,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC;IAC7E,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,KAAe;IAClD,MAAM,GAAG,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IACrD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,kDAAkD,CAAC;QAChE,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9C,CAAC;IACD,MAAM,IAAI,GAAG,kCAAkC,CAAC;IAChD,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC;AAED;yDACyD;AACzD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,SAAS,GAAG,KAAK;IACnD,IAAI,SAAS;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACvC,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7E,IAAI,CAAC;QACH,MAAM,MAAM,GAAW,MAAM,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAC/C,EAAE,CAAC,QAAQ,CAAC,+CAA+C,EAAE,GAAG,CAAC,CAClE,CAAC;QACF,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5D,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/models.d.ts ADDED Viewed

@@ -0,0 +1,105 @@
+/**
+ * Typed models for the Pyyol push protocol.
+ *
+ * Lifecycle envelopes are fully typed. Turn views are typed for their common
+ * fields; complex nested state (e.g. the Monopoly board) is left as an open
+ * object so the SDK stays thin and never drifts from the server's evolving state
+ * shape. Nothing here contains game strategy — these are pure data shapes.
+ */
+export declare const PROTOCOL_VERSION = "1.0";
+export declare const GOOFSPIEL = "goofspiel";
+export declare const MONOPOLY = "monopoly";
+export declare const MAFIA = "mafia";
+export declare const SUPPORTED_GAMES: readonly ["goofspiel", "monopoly", "mafia"];
+export interface InitializeRequest {
+    protocol: string;
+    match_id: string;
+    game: string;
+    seat: number;
+    players: number;
+    role?: string;
+    config?: unknown;
+    deadline_ms?: number;
+}
+export interface EventNotification {
+    protocol: string;
+    match_id: string;
+    game: string;
+    seq: number;
+    type: string;
+    payload?: unknown;
+}
+export interface GameEndNotification {
+    protocol: string;
+    match_id: string;
+    game: string;
+    result?: unknown;
+}
+/** One resolved round from this seat's perspective (both cards open post-resolution). */
+export interface GoofspielRound {
+    round: number;
+    prize: number;
+    prize_pool: number;
+    your_card: number;
+    opp_card: number;
+    winner: number;
+    scores: number[];
+}
+export interface GoofspielView {
+    game: "goofspiel";
+    match_id: string;
+    seat: number;
+    round: number;
+    current_prize: number;
+    prize_pool: number;
+    your_hand: number[];
+    scores: number[];
+    legal_actions: number[];
+    /** Every already-resolved round — the view is self-contained/replayable. */
+    history: GoofspielRound[];
+    raw: Record<string, unknown>;
+}
+export interface MonopolyView {
+    game: "monopoly";
+    match_id: string;
+    seat: number;
+    phase: string;
+    legal_actions: string[];
+    /** The raw board dict (players, holdings, phase, …) — inspect directly. */
+    state: Record<string, unknown>;
+    raw: Record<string, unknown>;
+}
+export interface MafiaView {
+    game: "mafia";
+    match_id: string;
+    your_seat: number;
+    your_role: string;
+    day: number;
+    phase: string;
+    alive: Record<number, boolean>;
+    allies: number[];
+    legal: string[];
+    public: Record<string, unknown>[];
+    private: Record<string, unknown>[];
+    raw: Record<string, unknown>;
+}
+export type TurnView = GoofspielView | MonopolyView | MafiaView | Record<string, unknown>;
+export interface GoofspielMove {
+    round?: number;
+    card: number;
+}
+export interface MonopolyMove {
+    action: string;
+    property?: number;
+    amount?: number;
+}
+export interface MafiaMove {
+    action: string;
+    target?: number;
+    tone?: string;
+    text?: string;
+}
+export type Move = GoofspielMove | MonopolyMove | MafiaMove | Record<string, unknown>;
+/** Parse a turn body into its typed view; unknown games return the raw object. */
+export declare function parseView(d: Record<string, any>): TurnView;
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"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"}

package/dist/models.js ADDED Viewed

@@ -0,0 +1,68 @@
+/**
+ * Typed models for the Pyyol push protocol.
+ *
+ * Lifecycle envelopes are fully typed. Turn views are typed for their common
+ * fields; complex nested state (e.g. the Monopoly board) is left as an open
+ * object so the SDK stays thin and never drifts from the server's evolving state
+ * shape. Nothing here contains game strategy — these are pure data shapes.
+ */
+export const PROTOCOL_VERSION = "1.0";
+export const GOOFSPIEL = "goofspiel";
+export const MONOPOLY = "monopoly";
+export const MAFIA = "mafia";
+export const SUPPORTED_GAMES = [GOOFSPIEL, MONOPOLY, MAFIA];
+const asNum = (v, d = 0) => (typeof v === "number" ? v : Number(v ?? d) || d);
+const asStr = (v, d = "") => (typeof v === "string" ? v : d);
+const asArr = (v) => (Array.isArray(v) ? v : []);
+/** Parse a turn body into its typed view; unknown games return the raw object. */
+export function parseView(d) {
+    switch (d.game) {
+        case GOOFSPIEL:
+            return {
+                game: GOOFSPIEL,
+                match_id: asStr(d.match_id),
+                seat: asNum(d.seat),
+                round: asNum(d.round),
+                current_prize: asNum(d.current_prize),
+                prize_pool: asNum(d.prize_pool),
+                your_hand: asArr(d.your_hand),
+                scores: asArr(d.scores),
+                legal_actions: asArr(d.legal_actions).length ? asArr(d.legal_actions) : asArr(d.your_hand),
+                history: asArr(d.history),
+                raw: d,
+            };
+        case MONOPOLY:
+            return {
+                game: MONOPOLY,
+                match_id: asStr(d.match_id),
+                seat: asNum(d.seat),
+                phase: asStr(d.phase),
+                legal_actions: asArr(d.legal_actions),
+                state: d.state ?? {},
+                raw: d,
+            };
+        case MAFIA: {
+            const aliveRaw = d.alive ?? {};
+            const alive = {};
+            for (const k of Object.keys(aliveRaw))
+                alive[Number(k)] = Boolean(aliveRaw[k]);
+            return {
+                game: MAFIA,
+                match_id: asStr(d.match_id),
+                your_seat: asNum(d.your_seat ?? d.seat),
+                your_role: asStr(d.your_role),
+                day: asNum(d.day),
+                phase: asStr(d.phase),
+                alive,
+                allies: asArr(d.allies),
+                legal: asArr(d.legal).length ? asArr(d.legal) : asArr(d.legal_actions),
+                public: asArr(d.public),
+                private: asArr(d.private),
+                raw: d,
+            };
+        }
+        default:
+            return d;
+    }
+}
+//# sourceMappingURL=models.js.map

package/dist/models.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"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"}

package/dist/rules.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+/** Full Markdown rules for all three games, or just one game's section.
+ *  @param game optional "goofspiel" | "monopoly" | "mafia" to slice one section. */
+export declare function gameRules(game?: string): string;
+//# sourceMappingURL=rules.d.ts.map

package/dist/rules.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"AASA;oFACoF;AACpF,wBAAgB,SAAS,CAAC,IAAI,SAAK,GAAG,MAAM,CAY3C"}

package/dist/rules.js ADDED Viewed

@@ -0,0 +1,26 @@
+/**
+ * Programmatic access to the engine-generated game rules bundled with this package
+ * (rules/games.md — the same reference an LLM/agent author needs). Ships inside the
+ * npm tarball via the package.json `files` allowlist, so it is always available
+ * offline and can never drift from the deployed engine (CI drift-gates it).
+ */
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+/** Full Markdown rules for all three games, or just one game's section.
+ *  @param game optional "goofspiel" | "monopoly" | "mafia" to slice one section. */
+export function gameRules(game = "") {
+    // dist/rules.js → ../rules/games.md (package root). Resolved relative to this
+    // module so it works regardless of the consumer's CWD.
+    const path = fileURLToPath(new URL("../rules/games.md", import.meta.url));
+    const text = readFileSync(path, "utf8");
+    if (!game)
+        return text;
+    const cap = game.charAt(0).toUpperCase() + game.slice(1).toLowerCase();
+    const marker = `## ${cap}`;
+    const start = text.indexOf(marker);
+    if (start === -1)
+        return text;
+    const next = text.indexOf("\n## ", start + marker.length);
+    return next === -1 ? text.slice(start) : text.slice(start, next);
+}
+//# sourceMappingURL=rules.js.map

package/dist/rules.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"rules.js","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;oFACoF;AACpF,MAAM,UAAU,SAAS,CAAC,IAAI,GAAG,EAAE;IACjC,8EAA8E;IAC9E,uDAAuD;IACvD,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,mBAAmB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1E,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACvE,MAAM,MAAM,GAAG,MAAM,GAAG,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1D,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACnE,CAAC"}

package/dist/runtime.d.ts ADDED Viewed

@@ -0,0 +1,97 @@
+/**
+ * The Pyyol Runtime Connector — the local-runtime transport for JS/TS.
+ *
+ * Your agent runs on your own machine and dials OUT over a single persistent
+ * WebSocket to the platform. The platform pushes match lifecycle down that socket
+ * and reads decisions back over it, so a laptop behind NAT works with zero
+ * networking config — you never host an inbound endpoint. This is the Beta model.
+ *
+ * The connector owns registration, heartbeats, automatic reconnection with
+ * exponential backoff, and request/response correlation; it dispatches frames to
+ * the handlers you registered on your `Agent`. No game logic lives here.
+ *
+ *     const agent = new Agent({ supportedGames: ["goofspiel"], name: "OlympAI" });
+ *     agent.onTurn("goofspiel", (v) => ({ round: v.round, card: Math.max(...v.legal_actions) }));
+ *     await agent.run({ url: "wss://pyyol.example/v1/agent/connect", agentId: "ag_…", token: "…" });
+ */
+import type { Agent } from "./server.js";
+export declare const PROTOCOL_VERSION = "1.0";
+/** A minimal structural type for a WHATWG WebSocket (Node 22+ global, or `ws`). */
+export interface WebSocketLike {
+    send(data: string): void;
+    close(code?: number, reason?: string): void;
+    addEventListener(type: string, listener: (ev: any) => void): void;
+    readyState: number;
+}
+export type WebSocketCtor = new (url: string) => WebSocketLike;
+export interface RuntimeOptions {
+    url: string;
+    agentId?: string;
+    token?: string;
+    name?: string;
+    games?: string[];
+    version?: string;
+    heartbeatMs?: number;
+    reconnect?: boolean;
+    maxBackoffMs?: number;
+    /** Bound the opening WS handshake (ms); dead-air links hang without it. Default 10s. */
+    connectTimeoutMs?: number;
+    /** Liveness watchdog: if NO frame (of any type) arrives within this window (ms),
+     *  treat the link as dead and close it. Catches a half-open (silently dropped) TCP
+     *  link that app-level PINGs alone can miss — the platform sets protocol-level
+     *  ping_timeout for the same reason. Closing makes session() reject → run()
+     *  reconnects. Defaults to max(30s, 3× heartbeat). */
+    livenessTimeoutMs?: number;
+    /** Inject a WebSocket implementation (defaults to globalThis.WebSocket). */
+    WebSocketImpl?: WebSocketCtor;
+    /** Called (once per process) with a one-line notice when the gateway reports a
+     *  newer SDK is available. Defaults to console.warn. */
+    onNotice?: (message: string) => void;
+    /** Optional live feed of match lifecycle for a CLI/console. kind is one of
+     *  "connected" | "turn" | "event" | "game_end" | "reauth". No-op if unset. */
+    onFeed?: (kind: string, detail: string) => void;
+    /** Rotating refresh token. When set (with apiUrl), a rejected register spends it
+     *  for a fresh access token and reconnects — so long-running agents stay authed
+     *  past the short access-token TTL. */
+    refreshToken?: string;
+    /** API base URL for POST /v1/auth/refresh (e.g. https://api.pyyol.com). */
+    apiUrl?: string;
+    /** Persist a rotated (access, refresh) pair, e.g. back to the credentials file. */
+    onTokens?: (access: string, refresh: string) => void | Promise<void>;
+    /** Inject the refresh HTTP call (tests). Defaults to a fetch of /v1/auth/refresh. */
+    refreshHttp?: (apiUrl: string, refreshToken: string) => Promise<{
+        access: string;
+        refresh: string;
+    } | null>;
+}
+/** Terminal connector failure (e.g. auth rejected) — not retried. */
+export declare class ConnectorError extends Error {
+}
+export declare class RuntimeConnector {
+    private agent;
+    private opts;
+    private stopped;
+    private nudged;
+    private registered;
+    private refreshAttempts;
+    private readonly tracer;
+    constructor(agent: Agent, opts: RuntimeOptions);
+    /** The gateway echoes the newest published version on the registered frame.
+     *  Print a one-line upgrade hint at most once (not on every reconnect). */
+    private maybeNudge;
+    /** Connect and serve until stopped, reconnecting with exponential backoff. */
+    run(): Promise<void>;
+    stop(): void;
+    /** Emit a live-feed line to the CLI/console, if a sink was provided. */
+    private feed;
+    /** Warn (once) when connecting over cleartext ws:// to a non-local host — the
+     *  register token is sent in the clear (mirrors the Python connector). */
+    private securityCheck;
+    /** One connection lifetime: resolves on a clean stop, rejects on transport loss. */
+    /** Spend the refresh token for a fresh access token; returns true on success
+     *  (opts.token rotated + persisted). Bounded per connection to avoid a loop. */
+    private tryRefresh;
+    private session;
+    private dispatch;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AASzC,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AAEtC,mFAAmF;AACnF,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;IAClE,UAAU,EAAE,MAAM,CAAC;CACpB;AACD,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,EAAE,MAAM,KAAK,aAAa,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wFAAwF;IACxF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;0DAIsD;IACtD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4EAA4E;IAC5E,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;4DACwD;IACxD,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC;kFAC8E;IAC9E,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD;;2CAEuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,qFAAqF;IACrF,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;CAC7G;AAkDD,qEAAqE;AACrE,qBAAa,cAAe,SAAQ,KAAK;CAAG;AA6B5C,qBAAa,gBAAgB;IASf,OAAO,CAAC,KAAK;IAAS,OAAO,CAAC,IAAI;IAR9C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,eAAe,CAAK;IAI5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBACZ,KAAK,EAAE,KAAK,EAAU,IAAI,EAAE,cAAc;IAI9D;+EAC2E;IAC3E,OAAO,CAAC,UAAU;IAWlB,8EAA8E;IACxE,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B1B,IAAI,IAAI,IAAI;IAKZ,wEAAwE;IACxE,OAAO,CAAC,IAAI;IAIZ;8EAC0E;IAC1E,OAAO,CAAC,aAAa;IAkBrB,oFAAoF;IACpF;oFACgF;YAClE,UAAU;IAwBxB,OAAO,CAAC,OAAO;YA+ED,QAAQ;CA0EvB"}