daishi-sdk 0.2.5 → 0.2.6

package/README.md

@@ -38,7 +38,7 @@ Seats play on the provider keys stored on your account. Every plan can read and
 
 - **One method per API operation**, named after its operation id: `getRun`, `listRuns`, `launch`, `cancel`, `getBatch`, `createScenario`, `createExperiment`, `getExperiment` and the rest. Request bodies and responses are typed from the API's OpenAPI document.
 - **Errors** throw `DaishiError` with the API's `code` (`unknown_run`, `plan_quota`, ...), `status`, `message`, `retryAfterSeconds`, and `docs`, a link to what the code means.
-- **Retries** are safe by construction. A 429 is retried after the seconds its `Retry-After` header names, and a cancel refused with `run_launching` after a pause, on any method, because the server refused before doing anything. A gateway error or a dropped connection is retried on GET only, so a write is never sent twice.
+- **Retries** are safe by construction. A 429 is retried after the seconds its `Retry-After` header names, and a cancel refused with `run_launching` after a pause, on any method, because the server refused before doing anything. So is a `503 handover`, the few seconds a deploy moves the world to a new release: the old release refuses every write before reading it. Any other gateway error or a dropped connection is retried on GET only, so a write is never sent twice.
 - **Waiting.** `waitForRun`, `waitForBatch` and `waitForExperiment` poll every 30 seconds until the run, batch or experiment ends. `waitForRun` also waits for a finished run's results, which arrive when the match archives. Pass `signal: AbortSignal.timeout(ms)` for a deadline. To be told instead of asking, set up [run-end notices](https://daishi.ai/docs/developer/runs#run-end-notices).
 
 ```ts

package/dist/generated.d.ts

@@ -5,7 +5,7 @@ export type JsonObject = {
 /** The API version these types describe. */
 export declare const API_VERSION = "1.0.0";
 /** Every error code the API documents. */
-export type ErrorCode = 'token_required' | 'scope_required' | 'plan_api' | 'rate_limited' | 'bad_request' | 'bad_scenario' | 'bad_replicates' | 'profile_required' | 'bad_season_ticks' | 'bad_frame' | 'bad_env' | 'too_many_scenarios' | 'unknown_scenario' | 'bad_skill' | 'too_many_skills' | 'unknown_skill' | 'bad_roster' | 'bad_model' | 'bad_name' | 'bad_provider' | 'provider_key_required' | 'openrouter_key_required' | 'openrouter_balance_low' | 'billing_frozen' | 'email_unverified' | 'bad_trials' | 'bad_spend_cap' | 'plan_seats' | 'plan_ticks' | 'plan_series' | 'plan_quota' | 'too_many_runs' | 'run_history_full' | 'seed_not_allowed' | 'unknown_run' | 'unknown_batch' | 'unknown_experiment' | 'experiment_trial' | 'experiment_not_running' | 'experiment_arms' | 'bad_experiment' | 'experiment_scenario' | 'experiment_world_only' | 'experiment_env_seed' | 'experiment_stopping' | 'bad_metric' | 'bad_design' | 'design_final' | 'design_late' | 'no_design' | 'experiment_effort_roster' | 'plan_experiment_arms' | 'plan_rerun' | 'unknown_log' | 'plan_invites' | 'invite_world' | 'invite_series' | 'too_many_open_worlds' | 'no_invite' | 'invite_fixed' | 'bad_invite' | 'never_played' | 'run_playing' | 'bad_note' | 'note_too_long' | 'run_launching' | 'internal_error';
+export type ErrorCode = 'token_required' | 'scope_required' | 'plan_api' | 'rate_limited' | 'handover' | 'bad_request' | 'bad_scenario' | 'bad_replicates' | 'profile_required' | 'bad_season_ticks' | 'bad_frame' | 'bad_env' | 'too_many_scenarios' | 'unknown_scenario' | 'bad_skill' | 'too_many_skills' | 'unknown_skill' | 'bad_roster' | 'bad_model' | 'bad_name' | 'bad_provider' | 'provider_key_required' | 'openrouter_key_required' | 'openrouter_balance_low' | 'billing_frozen' | 'email_unverified' | 'bad_trials' | 'bad_spend_cap' | 'plan_seats' | 'plan_ticks' | 'plan_series' | 'plan_quota' | 'too_many_runs' | 'run_history_full' | 'seed_not_allowed' | 'unknown_run' | 'unknown_batch' | 'unknown_experiment' | 'experiment_trial' | 'experiment_not_running' | 'experiment_arms' | 'bad_experiment' | 'experiment_scenario' | 'experiment_world_only' | 'experiment_env_seed' | 'experiment_stopping' | 'bad_metric' | 'bad_design' | 'design_final' | 'design_late' | 'no_design' | 'experiment_effort_roster' | 'plan_experiment_arms' | 'plan_rerun' | 'unknown_log' | 'plan_invites' | 'invite_world' | 'invite_series' | 'too_many_open_worlds' | 'no_invite' | 'invite_fixed' | 'bad_invite' | 'never_played' | 'run_playing' | 'bad_note' | 'note_too_long' | 'run_launching' | 'internal_error';
 export type Method = 'GET' | 'POST' | 'PUT' | 'DELETE';
 export interface RequestParts {
     query?: Record<string, string | number | boolean | undefined | null>;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Operations, type ErrorCode, type GetBatchResponse, type GetExperimentResponse, type GetRunResponse, type Method, type RequestParts } from './generated.js';
 export * from './generated.js';
-export declare const VERSION = "0.2.5";
+export declare const VERSION = "0.2.6";
 export declare const DEFAULT_BASE_URL = "https://daishi.ai/api/v1";
 export interface DaishiOptions {
     /** A Studio access token (`dsk_...`). Default: the `DAISHI_TOKEN` environment variable. */
@@ -52,9 +52,11 @@ export declare class DaishiError extends Error {
  *
  * Retries: a 429 is retried after the seconds its `Retry-After` names, and
  * a `run_launching` refusal after a short pause, on any method, because the
- * server refused before doing anything. A gateway error (502, 503, 504) or
- * a dropped connection is retried on GET only: a write that may have landed
- * is never sent twice.
+ * server refused before doing anything. So is a `503 handover`: for the few
+ * seconds a deploy moves the world to a new release, the old one refuses
+ * every write before reading it, and says so in that code. Any other gateway
+ * error (502, 503, 504) or a dropped connection is retried on GET only: a
+ * write that may have landed is never sent twice.
  */
 export declare class Daishi extends Operations {
     readonly baseUrl: string;

package/dist/index.js

@@ -1,6 +1,6 @@
 import { Operations } from './generated.js';
 export * from './generated.js';
-export const VERSION = '0.2.5';
+export const VERSION = '0.2.6';
 export const DEFAULT_BASE_URL = 'https://daishi.ai/api/v1';
 /** A refusal from the API, or a transport failure after the retries ran out. */
 export class DaishiError extends Error {
@@ -56,9 +56,11 @@ function envToken() {
  *
  * Retries: a 429 is retried after the seconds its `Retry-After` names, and
  * a `run_launching` refusal after a short pause, on any method, because the
- * server refused before doing anything. A gateway error (502, 503, 504) or
- * a dropped connection is retried on GET only: a write that may have landed
- * is never sent twice.
+ * server refused before doing anything. So is a `503 handover`: for the few
+ * seconds a deploy moves the world to a new release, the old one refuses
+ * every write before reading it, and says so in that code. Any other gateway
+ * error (502, 503, 504) or a dropped connection is retried on GET only: a
+ * write that may have landed is never sent twice.
  */
 export class Daishi extends Operations {
     baseUrl;
@@ -113,7 +115,7 @@ export class Daishi extends Operations {
             }
             const code = parsed?.error ?? `http_${res.status}`;
             const retryAfter = parseRetryAfter(res.headers.get('retry-after'));
-            const retryable = res.status === 429 || code === 'run_launching' || (method === 'GET' && GATEWAY.has(res.status));
+            const retryable = res.status === 429 || code === 'run_launching' || code === 'handover' || (method === 'GET' && GATEWAY.has(res.status));
             if (retryable && canRetry) {
                 await sleep(retryAfter !== null ? retryAfter * 1000 : backoffMs(attempt));
                 continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "daishi-sdk",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "Typed client for the Daishi Studio API: scenarios, runs, series batches and paired experiments, with retries and waiting helpers.",
   "keywords": [
     "daishi",