@dopamint-fun/open-sdk 0.2.0-dev.6 → 0.2.0-dev.8

package/dist/cli.js

@@ -24,7 +24,7 @@ import { acceptAndAwaitAdmission } from "./offer.js";
 import { playTour, queueUntilSeated } from "./tour.js";
 import { joinRoomWhenComposed, MIN_ROOM_SEATS, openRoom, roomInvitePrompt, } from "./room.js";
 import { disputeHolding, JoinRefused, joinTransaction, leaveTransaction, listTournaments, matchmakingOverLine, planJoin, presentToTournament, readAgentEntry, readAgentEntrySettled, playsHeldBy, giveBackTransaction, readTournament, sponsorAndExecute, tournamentIdArg, } from "./openTournament.js";
-import { authorityOriginFromSessionBase, buildConsentRequest, DEFAULT_OPEN_API_BASE_URL, digestForPrompt, settlementConsentPath, verifyConsentDisclosure, } from "./settlement.js";
+import { buildConsentRequest, DEFAULT_OPEN_API_BASE_URL, digestForPrompt, settlementConsentPath, verifyConsentDisclosure, } from "./settlement.js";
 import { actionSigningBytes, joinSigningBytes, requireSessionVersion, resumeSigningBytes, SESSION_VERSION, } from "./sessionWire.js";
 import { describeNext, refusalMessageFromText } from "./refusal.js";
 function fail(message) {
@@ -860,7 +860,12 @@ async function consentToTerminal(options) {
     const record = JSON.parse(offerBody);
     if (!record.admission)
         fail("offer is not admitted; there is no execution to settle");
-    const origin = authorityOriginFromSessionBase(record.admission.session_base_url);
+    /* The settlement verbs live on the product origin — `/v1/authority/…` is
+       the product's public route, which forwards to the shard that admitted
+       the execution. The session's own origin serves `/v1/exec/` only, so
+       deriving the consent root from `session_base_url` asks a listener that
+       does not serve this spelling. */
+    const origin = options.productUrl.replace(/\/$/, "");
     const path = settlementConsentPath(record.admission.execution_id);
     const promptResponse = await fetch(`${origin}${path}`);
     const promptText = await promptResponse.text();

package/dist/index.d.ts

@@ -3,9 +3,9 @@ export { deriveAgentId, registerCanonicalPayload, registerPayloadDigest, type Re
 export { canonicalIdentityPayload, nameAgent, parseIdentityFields, type AgentIdentityFields, type NameAgentArgs, } from "./identity.js";
 export { actionSigningBytes, encodeActionFrame, encodeJoinFrame, encodeResumeFrame, joinSigningBytes, resumeSigningBytes, SESSION_VERSION, UnsupportedSessionVersionError, type ActionProposal, type ArtifactReference, type JoinRequest, type ResumeRequest, type SessionContext, } from "./sessionWire.js";
 export { encodeAckFrame, SESSION_ERROR_NAMES, MAX_PREDICTION_PACING_MS, admitAuthorityEvent, applyPredictionGateStatus, decodeAuthorityMessage, freshSessionBoundary, predictionGateMessage, predictionGatePreparationOf, predictionGateTargetReceipt, sessionErrorHint, sessionErrorName, PredictionGateConflictError, SessionBoundaryError, type AcceptedSessionBoundary, type AuthorityMessage, type PredictionGateMessage, type PredictionGateOpening, type PredictionGatePreparation, type PredictionGateRelease, type PredictionGateStatus, type PredictionWindowRef, type ReceiptRef, type ResumeCursor, type StateRef, type ViewSnapshot, } from "./sessionCodec.js";
-export { type OpenTableView, type PlayReport, type SeatDecision, type SeatDecisionResult, type SeatPosition, SessionClient, SessionRefusal, chooseSeatAction, playSeat, } from "./session.js";
+export { type OpenTableView, type PlayReport, type SeatDecision, type SeatDecisionResult, type SeatPosition, SessionClient, SessionRefusal, chooseSeatAction, playSeat, waitForReadyOwner, } from "./session.js";
 export { cardFromByte, decodeLegalActions, decodeParticipantView, encodeAction, pickAction, type Card, type Rank, type Suit, type TexasAction, type TexasLegalActions, type TexasSeatView, } from "./texas.js";
-export { authorityOriginFromSessionBase, buildConsentRequest, DEFAULT_OPEN_API_BASE_URL, digestForPrompt, recomputeSettlementDigest, settlementConsentPath, verifyConsentDisclosure, } from "./settlement.js";
+export { buildConsentRequest, DEFAULT_OPEN_API_BASE_URL, digestForPrompt, recomputeSettlementDigest, settlementConsentPath, verifyConsentDisclosure, } from "./settlement.js";
 export { PACKAGE_NAME, RELEASE_CHANNELS, channelDistTag, installCommand, installSpec, resolveChannel, versionMatchesChannel, type ReleaseChannel, } from "./channel.js";
 export { fromHex, toHex } from "./bytes.js";
 export { AGENT_HTTP_CAPABILITY_HEADER, AGENT_HTTP_CAPABILITY_NONCE_BYTES, MAX_AGENT_HTTP_CAPABILITY_WINDOW_MS, agentHttpCanonicalPayload, agentHttpSigningBytes, decodeAgentHttpHeader, encodeAgentHttpHeader, mintAgentHttpCapability, type AgentHttpBinding, type AgentHttpCapability, } from "./agentHttp.js";
@@ -18,4 +18,4 @@ export { cardIndex, handCategory, scoreHand, HAND_CATEGORIES, RANK_ORDER, SUIT_O
 export { DEFAULT_SEAT_STATE_FILE, loadSeatState, saveSeatState, type SeatSessionState, } from "./seatState.js";
 export { newSeatState, openTurn, submitTurn, type SeatStateCheckpoint, type SeatTurnOutcome, type SeatTurnPosition, } from "./seatTurn.js";
 export { chipAddressOf, joinTransaction, leaveTransaction, listTournaments, planJoin, presentToTournament, readAgentEntry, readAgentEntrySettled, BOOK_CATCHES_UP_MS, readPass, readOwner, playsHeldBy, giveBackTransaction, readTournament, sponsorAndExecute, tournamentIdArg, tournamentPossessionSignature, JoinRefused, TournamentRefusal, TOURNAMENT_POSSESSION_SEAT, type JoinPlan, type SponsoredExecution, type TournamentAgentEntry, type TournamentPass, type TournamentPlay, type TournamentOwnerView, type TournamentOwnerAgent, type TournamentChainObjects, type TournamentClient, type TournamentOverview, type TournamentQueueEntry, } from "./openTournament.js";
-export { ClientRefusal, describeNext, refusalLines, refusalMessage, refusalMessageFromText, type RefusalBody, type RefusalNext, } from "./refusal.js";
+export { ClientRefusal, describeNext, ownershipFencePoll, ownershipFenced, refusalLines, refusalMessage, refusalMessageFromText, type RefusalBody, type RefusalNext, } from "./refusal.js";

package/dist/index.js

@@ -10,9 +10,9 @@ export { deriveAgentId, registerCanonicalPayload, registerPayloadDigest, } from
 export { canonicalIdentityPayload, nameAgent, parseIdentityFields, } from "./identity.js";
 export { actionSigningBytes, encodeActionFrame, encodeJoinFrame, encodeResumeFrame, joinSigningBytes, resumeSigningBytes, SESSION_VERSION, UnsupportedSessionVersionError, } from "./sessionWire.js";
 export { encodeAckFrame, SESSION_ERROR_NAMES, MAX_PREDICTION_PACING_MS, admitAuthorityEvent, applyPredictionGateStatus, decodeAuthorityMessage, freshSessionBoundary, predictionGateMessage, predictionGatePreparationOf, predictionGateTargetReceipt, sessionErrorHint, sessionErrorName, PredictionGateConflictError, SessionBoundaryError, } from "./sessionCodec.js";
-export { SessionClient, SessionRefusal, chooseSeatAction, playSeat, } from "./session.js";
+export { SessionClient, SessionRefusal, chooseSeatAction, playSeat, waitForReadyOwner, } from "./session.js";
 export { cardFromByte, decodeLegalActions, decodeParticipantView, encodeAction, pickAction, } from "./texas.js";
-export { authorityOriginFromSessionBase, buildConsentRequest, DEFAULT_OPEN_API_BASE_URL, digestForPrompt, recomputeSettlementDigest, settlementConsentPath, verifyConsentDisclosure, } from "./settlement.js";
+export { buildConsentRequest, DEFAULT_OPEN_API_BASE_URL, digestForPrompt, recomputeSettlementDigest, settlementConsentPath, verifyConsentDisclosure, } from "./settlement.js";
 export { PACKAGE_NAME, RELEASE_CHANNELS, channelDistTag, installCommand, installSpec, resolveChannel, versionMatchesChannel, } from "./channel.js";
 export { fromHex, toHex } from "./bytes.js";
 export { AGENT_HTTP_CAPABILITY_HEADER, AGENT_HTTP_CAPABILITY_NONCE_BYTES, MAX_AGENT_HTTP_CAPABILITY_WINDOW_MS, agentHttpCanonicalPayload, agentHttpSigningBytes, decodeAgentHttpHeader, encodeAgentHttpHeader, mintAgentHttpCapability, } from "./agentHttp.js";
@@ -30,4 +30,4 @@ export { cardIndex, handCategory, scoreHand, HAND_CATEGORIES, RANK_ORDER, SUIT_O
 export { DEFAULT_SEAT_STATE_FILE, loadSeatState, saveSeatState, } from "./seatState.js";
 export { newSeatState, openTurn, submitTurn, } from "./seatTurn.js";
 export { chipAddressOf, joinTransaction, leaveTransaction, listTournaments, planJoin, presentToTournament, readAgentEntry, readAgentEntrySettled, BOOK_CATCHES_UP_MS, readPass, readOwner, playsHeldBy, giveBackTransaction, readTournament, sponsorAndExecute, tournamentIdArg, tournamentPossessionSignature, JoinRefused, TournamentRefusal, TOURNAMENT_POSSESSION_SEAT, } from "./openTournament.js";
-export { ClientRefusal, describeNext, refusalLines, refusalMessage, refusalMessageFromText, } from "./refusal.js";
+export { ClientRefusal, describeNext, ownershipFencePoll, ownershipFenced, refusalLines, refusalMessage, refusalMessageFromText, } from "./refusal.js";

package/dist/refusal.d.ts

@@ -29,6 +29,11 @@ export interface RefusalBody {
     docs?: string;
 }
 /** `next …`, as one line an agent can act on. */
+/** True when a refusal body says the writer is fenced and the caller should
+ *  poll committed ownership rather than resend to the same origin. */
+export declare function ownershipFenced(body: unknown): boolean;
+/** The product route a fenced seat polls, when the refusal named one. */
+export declare function ownershipFencePoll(body: unknown): string | undefined;
 export declare function describeNext(next: RefusalNext): string;
 /** The lines a refusal prints: its code, what it said, the move, the entry. */
 export declare function refusalLines(body: unknown): string[];

package/dist/refusal.js

@@ -6,6 +6,27 @@
  * reading a refused command's output reads its move off the same lines rather
  * than off a table in a skill document. */
 /** `next …`, as one line an agent can act on. */
+/** True when a refusal body says the writer is fenced and the caller should
+ *  poll committed ownership rather than resend to the same origin. */
+export function ownershipFenced(body) {
+    if (typeof body !== "object" || body === null)
+        return false;
+    const refusal = body;
+    if (refusal.code !== "ownership_fenced")
+        return false;
+    return (isNext(refusal.next) &&
+        refusal.next.action === "wait" &&
+        typeof refusal.next.poll === "string");
+}
+/** The product route a fenced seat polls, when the refusal named one. */
+export function ownershipFencePoll(body) {
+    if (!ownershipFenced(body))
+        return undefined;
+    const next = body.next;
+    if (next && next.action === "wait")
+        return next.poll;
+    return undefined;
+}
 export function describeNext(next) {
     switch (next.action) {
         case "retry":

package/dist/session.d.ts

@@ -327,6 +327,18 @@ export interface RestartRetry {
  *  answer, 408, 429 or a 5xx -- until `bound` has passed. Any other answer is
  *  returned as it came, so a refusal stays the caller's to read. */
 export declare function fetchWhileRestarting(fetchImpl: typeof fetch, url: string, retry?: RestartRetry): Promise<Response>;
+/** Poll product until the committed owner is ready, then return its origin. */
+export declare function waitForReadyOwner(args: {
+    productUrl: string;
+    executionId: string;
+    fetchImpl?: typeof fetch;
+    timeoutMs?: number;
+    pauseMs?: number;
+    sleep?: (ms: number) => Promise<void>;
+}): Promise<{
+    sessionOrigin: string;
+    version: number;
+}>;
 export declare function openSeatSession(args: SeatSessionArgs): Promise<SeatSession>;
 export declare function playSeat(args: PlayArgs): Promise<PlayReport>;
 /** What the play loop does about a refusal, by the refusal's tag.

package/dist/session.js

@@ -7,6 +7,7 @@ import { MAX_TRANSPORT_FRAME_BYTES, PredictionGateConflictError, SessionBoundary
 import { actionSigningBytes, encodeActionFrame, encodeJoinFrame, encodeResumeFrame, joinSigningBytes, requireSessionVersion, resumeSigningBytes, SESSION_VERSION, UnsupportedSessionVersionError, } from "./sessionWire.js";
 import { decodeLegalActions, decodeParticipantView, encodeAction, pickAction, } from "./texas.js";
 import { authorizeSeatChallenge } from "./seatAuth.js";
+import { ownershipFenced } from "./refusal.js";
 const ACTION_IDENTITY_DOMAIN = textBytes("dopa_open::client::action_identity_v1");
 /** The lines a play door reports for one seat's sitting.
  *
@@ -528,6 +529,43 @@ export async function fetchWhileRestarting(fetchImpl, url, retry = {
         await sleep(retry.pauseMs);
     }
 }
+/** Poll product until the committed owner is ready, then return its origin. */
+export async function waitForReadyOwner(args) {
+    const fetchImpl = args.fetchImpl ?? fetch;
+    const sleep = args.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+    const product = args.productUrl.replace(/\/$/, "");
+    const until = Date.now() + (args.timeoutMs ?? 30_000);
+    const pause = args.pauseMs ?? 200;
+    const id = args.executionId.replace(/^0x/i, "");
+    for (;;) {
+        const response = await fetchImpl(`${product}/v1/authority/executions/${id}/route`);
+        if (response.ok) {
+            const body = (await response.json());
+            if (body.ready && body.sessionOrigin)
+                return { sessionOrigin: body.sessionOrigin, version: body.version ?? 0 };
+        }
+        else {
+            await response.body?.cancel();
+        }
+        if (Date.now() + pause > until)
+            throw new Error("committed owner did not become ready");
+        await sleep(pause);
+    }
+}
+function httpFailure(error) {
+    if (!(error instanceof Error))
+        return null;
+    const match = /^[a-z-]+ failed \((\d+)\): (.*)$/is.exec(error.message);
+    if (!match)
+        return null;
+    const status = Number(match[1]);
+    try {
+        return { status, body: JSON.parse(match[2] ?? "") };
+    }
+    catch {
+        return { status, body: match[2] ?? "" };
+    }
+}
 export async function openSeatSession(args) {
     const fetchImpl = args.fetchImpl ?? fetch;
     const product = args.productUrl.replace(/\/$/, "");
@@ -581,7 +619,7 @@ export async function openSeatSession(args) {
 }
 export async function playSeat(args) {
     const fetchImpl = args.fetchImpl ?? fetch;
-    const { client, product, executionHex, coordinatorKey, timeAuthorityKey, executionId, } = await openSeatSession(args);
+    let { client, product, executionHex, coordinatorKey, timeAuthorityKey, executionId, } = await openSeatSession(args);
     const record = {
         admission: {
             execution_id: executionId,
@@ -923,6 +961,21 @@ export async function playSeat(args) {
                client joined this seat with this key; fighting it back would evict
                a reconnect that may be the operator's own, so this one steps aside
                and says so. Everything else is transient, and resume is right. */
+            const failed = httpFailure(error);
+            if (failed?.status === 409 && ownershipFenced(failed.body)) {
+                const ready = await waitForReadyOwner({
+                    productUrl: product,
+                    executionId: executionHex,
+                    fetchImpl,
+                    timeoutMs: 30_000,
+                    pauseMs: 200,
+                });
+                client = new SessionClient(ready.sessionOrigin, args.agent, args.seat, args.agentId, client.executionId, client.executionManifestDigest, client.clientNonce, fetchImpl);
+                await client.resume(lastContext, lastCursor);
+                originToken = client.token ?? originToken;
+                reconnects += 1;
+                continue;
+            }
             const answer = afterRefusal(error);
             if (answer === "step-aside")
                 return {

package/dist/settlement.d.ts

@@ -57,5 +57,4 @@ export declare function buildConsentRequest(args: ConsentDisclosure & {
     signature: Uint8Array;
 }): ConsentRequest;
 export declare function settlementConsentPath(executionIdHex: string): string;
-export declare function authorityOriginFromSessionBase(sessionBaseUrl: string): string;
 export declare function digestForPrompt(prompt: ConsentPrompt): Uint8Array;

package/dist/settlement.js

@@ -110,12 +110,6 @@ export function settlementConsentPath(executionIdHex) {
     const hex = executionIdHex.replace(/^0x/, "");
     return `/v1/authority/executions/${hex}/settlements`;
 }
-export function authorityOriginFromSessionBase(sessionBaseUrl) {
-    const idx = sessionBaseUrl.indexOf("/v1/exec/");
-    if (idx <= 0)
-        throw new Error(`admission session_base_url is not an execution session URL: ${sessionBaseUrl}`);
-    return sessionBaseUrl.slice(0, idx);
-}
 export function digestForPrompt(prompt) {
     const terminal = decodeTerminalState(fromHex(prompt.encoded_terminal_state));
     return recomputeSettlementDigest(fromHex(prompt.anchor_context), terminal);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dopamint-fun/open-sdk",
-  "version": "0.2.0-dev.6",
+  "version": "0.2.0-dev.8",
   "description": "DOPA-OPEN client SDK: generate and hold your own agent key, sign registrations, and play a Participant Session",
   "license": "Apache-2.0",
   "repository": {