daishi-sdk 0.2.6 → 0.2.8

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' | '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 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' | 'study_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>;
@@ -162,6 +162,8 @@ export interface ExperimentReport {
     detectable_gap: ExperimentReportDetectableGap;
     decision: ExperimentReportDecision;
     verdict: string;
+    plain: string;
+    what_differed: ExperimentReportWhatDiffered[];
     cost: Cost;
     note: string | null;
     note_at_ms: number | null;
@@ -334,6 +336,8 @@ export interface LaunchResponse {
 }
 export interface ListRunsResponse {
     runs: Run[];
+    next_cursor: string | null;
+    total: number;
 }
 export interface GetRunResponse {
     run: Run;
@@ -403,6 +407,38 @@ export interface UnpublishRunResponse {
     run: Run;
     profile_url: string | null;
 }
+export interface PublishExperimentBody {
+    /** The study’s note, your declared result. Omitted: the experiment keeps the note it has. "" or null: no note. */
+    note?: string | null;
+}
+export interface PublishExperimentResponse {
+    ok: boolean;
+    study: Study;
+    experiment: Experiment | null;
+    profile_url: string | null;
+    study_url: string | null;
+}
+export interface UnpublishExperimentResponse {
+    ok: boolean;
+    study: Study;
+    experiment: Experiment | null;
+    profile_url: string | null;
+    study_url: string | null;
+}
+export interface PublishBatchResponse {
+    ok: boolean;
+    study: Study;
+    experiment: Experiment | null;
+    profile_url: string | null;
+    study_url: string | null;
+}
+export interface UnpublishBatchResponse {
+    ok: boolean;
+    study: Study;
+    experiment: Experiment | null;
+    profile_url: string | null;
+    study_url: string | null;
+}
 export interface ExtendInvitesBody {
     /** The new deadline, minutes from now, for every open seat. */
     minutes: number;
@@ -616,6 +652,19 @@ export interface ExperimentReportComparison {
     verdict: 'arm_better' | 'control_better' | 'arm_higher' | 'control_higher' | 'undecided' | null;
     interval: Interval | null;
     detail: string;
+    exact: ExactCheck | null;
+    by_world: WorldReading | null;
+}
+export interface ExactCheck {
+    unit: 'pair' | 'world';
+    units: number;
+    p: number;
+    min_p: number;
+}
+export interface WorldReading {
+    worlds: number;
+    repeated: number;
+    interval: Interval | null;
 }
 export interface ExperimentReportSecondary {
     metric: 'fitness_index' | 'rank' | 'survived' | 'output_tokens_per_turn' | 'said_evaluated';
@@ -636,18 +685,30 @@ export interface ExperimentReportSecondaryComparison {
     interval: Interval | null;
     reading: 'arm_better' | 'control_better' | 'arm_higher' | 'control_higher' | 'undecided' | null;
     detail: string;
+    exact: ExactCheck | null;
+    by_world: WorldReading | null;
 }
 export interface ExperimentReportDetectableGap {
     sd_diff: number | null;
     source: 'observed' | 'prior';
     gap: number | null;
     power: number;
+    by_world: ExperimentReportDetectableGapByWorld | null;
+}
+export interface ExperimentReportDetectableGapByWorld {
+    worlds: number;
+    gap: number | null;
 }
 export interface ExperimentReportDecision {
     stop: boolean;
     reason: string;
     summary: string;
 }
+export interface ExperimentReportWhatDiffered {
+    arm: number;
+    label: string;
+    changes: string[];
+}
 /** The environment. Every field is optional; an omitted field takes the base world default. */
 export interface Env {
     /** World seed: fixes the map. Omit to draw a fresh one per run; the drawn seed is recorded on the run. */
@@ -690,6 +751,13 @@ export interface LaunchResponseBatch {
     trials: number;
     seed_mode: 'vary' | 'pinned';
 }
+export interface Study {
+    kind: 'experiment' | 'series';
+    id: string;
+    played: number;
+    published: number;
+    pending: number;
+}
 /** One method per API operation. The transport is the subclass's. */
 export declare abstract class Operations {
     protected abstract request<T>(method: Method, path: string, parts?: RequestParts): Promise<T>;
@@ -741,6 +809,14 @@ export declare abstract class Operations {
      * @see https://daishi.ai/docs/developer/rest#ep-library-anchors
      */
     libraryAnchors(): Promise<JsonObject>;
+    /**
+     * Studio templates.
+     *
+     * The ready-made studies the Studio’s New run page offers, word for word.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-templates
+     */
+    templates(): Promise<JsonObject>;
     /**
      * Validate a scenario.
      *
@@ -848,12 +924,13 @@ export declare abstract class Operations {
     /**
      * List your runs.
      *
-     * Your runs, newest first.
+     * Your runs, newest first, a page at a time.
      *
      * @see https://daishi.ai/docs/developer/rest#ep-list-runs
      */
     listRuns(query?: {
         limit?: number;
+        cursor?: string;
     }): Promise<ListRunsResponse>;
     /**
      * Get a run.
@@ -871,6 +948,14 @@ export declare abstract class Operations {
      * @see https://daishi.ai/docs/developer/rest#ep-usage
      */
     usage(): Promise<JsonObject>;
+    /**
+     * Your models.
+     *
+     * Every finished run rolled up by model: the figures the Studio’s Models page draws.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-models
+     */
+    models(): Promise<JsonObject>;
     /**
      * Live worlds.
      *
@@ -975,6 +1060,38 @@ export declare abstract class Operations {
      * @see https://daishi.ai/docs/developer/rest#ep-unpublish-run
      */
     unpublishRun(id: string): Promise<UnpublishRunResponse>;
+    /**
+     * Publish an experiment.
+     *
+     * List a whole paired experiment on your public profile in one call: every trial that played, in every arm.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-publish-experiment
+     */
+    publishExperiment(id: string, body: PublishExperimentBody): Promise<PublishExperimentResponse>;
+    /**
+     * Unpublish an experiment.
+     *
+     * Take every trial of a paired experiment off your public profile.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-unpublish-experiment
+     */
+    unpublishExperiment(id: string): Promise<UnpublishExperimentResponse>;
+    /**
+     * Publish a series.
+     *
+     * List a whole series batch on your public profile in one call: every trial that played.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-publish-batch
+     */
+    publishBatch(id: string): Promise<PublishBatchResponse>;
+    /**
+     * Unpublish a series.
+     *
+     * Take every trial of a series batch off your public profile.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-unpublish-batch
+     */
+    unpublishBatch(id: string): Promise<UnpublishBatchResponse>;
     /**
      * List a run’s logs.
      *
@@ -991,6 +1108,14 @@ export declare abstract class Operations {
      * @see https://daishi.ai/docs/developer/rest#ep-run-log
      */
     runLog(id: string, file: string): Promise<string>;
+    /**
+     * Read a run’s seats.
+     *
+     * Per seat: the debrief answer, voiced awareness, forfeited rounds with their causes, the harness that played it, and its trajectory file.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-run-seats
+     */
+    runSeats(id: string): Promise<JsonObject>;
     /**
      * List a run’s guest seats.
      *

package/dist/generated.js

@@ -64,6 +64,16 @@ export class Operations {
     libraryAnchors() {
         return this.request('GET', '/library/anchors');
     }
+    /**
+     * Studio templates.
+     *
+     * The ready-made studies the Studio’s New run page offers, word for word.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-templates
+     */
+    templates() {
+        return this.request('GET', '/templates');
+    }
     /**
      * Validate a scenario.
      *
@@ -197,7 +207,7 @@ export class Operations {
     /**
      * List your runs.
      *
-     * Your runs, newest first.
+     * Your runs, newest first, a page at a time.
      *
      * @see https://daishi.ai/docs/developer/rest#ep-list-runs
      */
@@ -224,6 +234,16 @@ export class Operations {
     usage() {
         return this.request('GET', '/usage');
     }
+    /**
+     * Your models.
+     *
+     * Every finished run rolled up by model: the figures the Studio’s Models page draws.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-models
+     */
+    models() {
+        return this.request('GET', '/models');
+    }
     /**
      * Live worlds.
      *
@@ -354,6 +374,46 @@ export class Operations {
     unpublishRun(id) {
         return this.request('POST', `/runs/${encodeURIComponent(id)}/unpublish`);
     }
+    /**
+     * Publish an experiment.
+     *
+     * List a whole paired experiment on your public profile in one call: every trial that played, in every arm.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-publish-experiment
+     */
+    publishExperiment(id, body) {
+        return this.request('POST', `/experiments/${encodeURIComponent(id)}/publish`, { body });
+    }
+    /**
+     * Unpublish an experiment.
+     *
+     * Take every trial of a paired experiment off your public profile.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-unpublish-experiment
+     */
+    unpublishExperiment(id) {
+        return this.request('POST', `/experiments/${encodeURIComponent(id)}/unpublish`);
+    }
+    /**
+     * Publish a series.
+     *
+     * List a whole series batch on your public profile in one call: every trial that played.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-publish-batch
+     */
+    publishBatch(id) {
+        return this.request('POST', `/batches/${encodeURIComponent(id)}/publish`);
+    }
+    /**
+     * Unpublish a series.
+     *
+     * Take every trial of a series batch off your public profile.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-unpublish-batch
+     */
+    unpublishBatch(id) {
+        return this.request('POST', `/batches/${encodeURIComponent(id)}/unpublish`);
+    }
     /**
      * List a run’s logs.
      *
@@ -374,6 +434,16 @@ export class Operations {
     runLog(id, file) {
         return this.request('GET', `/runs/${encodeURIComponent(id)}/logs/${encodeURIComponent(file)}`, { text: true });
     }
+    /**
+     * Read a run’s seats.
+     *
+     * Per seat: the debrief answer, voiced awareness, forfeited rounds with their causes, the harness that played it, and its trajectory file.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-run-seats
+     */
+    runSeats(id) {
+        return this.request('GET', `/runs/${encodeURIComponent(id)}/seats`);
+    }
     /**
      * List a run’s guest seats.
      *

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.6";
+export declare const VERSION = "0.2.8";
 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. */

package/dist/index.js

@@ -1,6 +1,6 @@
 import { Operations } from './generated.js';
 export * from './generated.js';
-export const VERSION = '0.2.6';
+export const VERSION = '0.2.8';
 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 {

package/package.json

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