daishi-sdk 0.2.13 → 0.2.15

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' | 'bad_game' | 'bad_arena' | 'experiment_world_only' | 'experiment_same_arms' | 'experiment_env_seed' | 'experiment_stopping' | 'bad_metric' | 'bad_design' | 'design_final' | 'design_late' | 'no_design' | 'experiment_effort_roster' | 'experiment_no_probe' | 'experiment_too_few_seats' | '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 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' | 'bad_game' | 'bad_arena' | 'experiment_world_only' | 'experiment_same_arms' | 'experiment_env_seed' | 'experiment_stopping' | 'bad_metric' | 'bad_design' | 'design_final' | 'design_late' | 'no_design' | 'experiment_effort_roster' | 'experiment_no_probe' | 'experiment_too_few_seats' | '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' | 'unknown_set' | 'unknown_setup' | 'bad_set' | 'set_full' | 'series_trial' | 'in_another_set' | 'guest_seats' | 'set_empty' | 'run_launching' | 'internal_error';
 export type Method = 'GET' | 'POST' | 'PUT' | 'DELETE';
 export interface RequestParts {
     query?: Record<string, string | number | boolean | undefined | null>;
@@ -172,6 +172,22 @@ export interface ExperimentReport {
     /** The design document as the server received it: the SHA-256 of its UTF-8 bytes, its size, when it arrived, and its standing read from those times: `declared` (it arrived with the creation or before the first trial started, after which it cannot be replaced), `named` (it arrived later, and the experiment’s name, fixed at creation, carries `name_prefix`, the first 12 or more hex digits of its digest), or `after` (neither). The text is its own read. */
     design: ExperimentDesign | null;
 }
+/** A run set: several of the account’s finished runs, standalone runs and whole series batches, published on its profile as one card, each filed under a setup the owner named. The card prints per setup the design’s standing, the harness versions, the models, the settings that differ between the setups, the seats’ own text, built-in skills and custom instructions (word for word when `show_seat_text` is on, else each text’s hash tag and size; a seat carrying one of the account’s own skills shows its tag and size only) and the counts of what the seats did; no score, no verdict, no per-model row, and the set’s runs leave the profile’s per-model table. `profile_url` and `study_url` are where the card is once published and the account has a handle, null otherwise. */
+export interface RunSet {
+    set_id: string;
+    name: string;
+    note: string | null;
+    note_at_ms: number | null;
+    show_seat_text: boolean;
+    published: boolean;
+    published_at_ms: number | null;
+    created_at_ms: number;
+    updated_at_ms: number;
+    setups: RunSetSetup[];
+    members: RunSetMember[];
+    profile_url: string | null;
+    study_url: string | null;
+}
 export interface ScenarioBody {
     /** Display name, shown in the run builder under "Your scenarios". */
     name: string;
@@ -453,6 +469,97 @@ export interface ExtendInvitesBody {
     /** The new deadline, minutes from now, for every open seat. */
     minutes: number;
 }
+export interface ListSetsResponse {
+    sets: RunSet[];
+}
+export interface CreateSetBody {
+    /** The card’s title, kept on one line. Fixed once created. */
+    name: string;
+    /** The setups runs are filed under, in the order the card lists them. */
+    setups: CreateSetBodySetup[];
+    /** Your note on the set, shown on the card as your words, marked as yours. */
+    note?: string;
+    /** Print every seat’s custom instructions on the card. Default false. */
+    show_seat_text?: boolean;
+}
+export interface CreateSetResponse {
+    ok: boolean;
+    set: RunSet;
+}
+export interface GetSetResponse {
+    set: RunSet;
+}
+export interface UpdateSetBody {
+    /** The note, counted after trimming. "" or null: no note. */
+    note?: string | null;
+    /** Print every seat’s custom instructions on the card, or show only each text’s hash tag and size. */
+    show_seat_text?: boolean;
+    /** New labels by setup key, { "<key>": "<label>" }, for the setups named. */
+    labels?: JsonObject;
+}
+export interface UpdateSetResponse {
+    ok: boolean;
+    set: RunSet;
+}
+export interface DeleteSetResponse {
+    ok: boolean;
+    deleted: string;
+    unpublished: number;
+}
+export interface AddSetMembersBody {
+    /** The setup key to file them under. */
+    setup: string;
+    /** Run ids (run_...). */
+    runs?: string[];
+    /** Series batch ids (bat_...), each joining whole. */
+    batches?: string[];
+}
+export interface AddSetMembersResponse {
+    ok: boolean;
+    set: RunSet;
+}
+export interface RemoveSetMembersBody {
+    /** Run ids (run_...). */
+    runs?: string[];
+    /** Series batch ids (bat_...). */
+    batches?: string[];
+}
+export interface RemoveSetMembersResponse {
+    ok: boolean;
+    set: RunSet;
+}
+export interface AttachSetDesignBody {
+    /** The design document, as text (markdown or plain). */
+    design: string;
+}
+export interface AttachSetDesignResponse {
+    ok: boolean;
+    set: RunSet;
+}
+export interface GetSetDesignResponse {
+    set_id: string;
+    setup: string;
+    sha256: string;
+    bytes: number;
+    at_ms: number;
+    standing: 'declared' | 'named' | 'after';
+    name_prefix: string | null;
+    text: string;
+}
+export interface PublishSetResponse {
+    ok: boolean;
+    set: RunSet;
+    runs: Runs;
+    profile_url: string | null;
+    study_url: string | null;
+}
+export interface UnpublishSetResponse {
+    ok: boolean;
+    set: RunSet;
+    runs: Runs;
+    profile_url: string | null;
+    study_url: string | null;
+}
 export interface RunScenario {
     id: string;
     hash: string;
@@ -537,6 +644,7 @@ export interface SeatInteractions {
     betrayals: number;
     in_ring: boolean;
     rounds_with_seats: number | null;
+    rounds_ended_with_seats: number | null;
 }
 export interface RunResultsTopModel {
     name: string;
@@ -675,6 +783,12 @@ export interface ExperimentReportArmContact {
     seats: number;
     seats_never: number;
     share_of_rounds: number | null;
+    at_round_end: ExperimentReportArmContactAtRoundEnd | null;
+}
+export interface ExperimentReportArmContactAtRoundEnd {
+    seats: number;
+    seats_never: number;
+    share_of_rounds: number | null;
 }
 export interface ExperimentReportPair {
     trial: number;
@@ -761,6 +875,52 @@ export interface ExperimentReportWhatDiffered {
     label: string;
     changes: string[];
 }
+/** One setup of a run set: how many runs are filed under it and the series batches among them, the harness versions their seats registered under (a set may span versions; nothing is pooled across them), when the earliest run ever filed under it started its match (a run moved out does not raise it), its design, and its counts summed over its runs (null while none carries one; `uncounted` runs whose match could not be read add nothing). */
+export interface RunSetSetup {
+    key: string;
+    label: string;
+    runs: number;
+    batches: string[];
+    harness_versions: string[];
+    first_match_ms: number | null;
+    /** A setup’s design document as the server received it: the SHA-256 of its UTF-8 bytes, its size, when it arrived, and its standing read against the setup’s first match: `declared` (it arrived before the first run ever filed under the setup started its match; a run moved out later does not change that), `named` (it arrived later, and the set’s name, fixed at a creation that came before that first match, carries `name_prefix`, the first 12 or more hex digits of its digest; a set created after its matches can name nothing in advance, so its design reads `after`), or `after` (neither). The text is its own read. */
+    design: RunSetDesign | null;
+    /** Counts off the match’s event log, stamped when the run joined the set (`v` is the version of the reading): the roster seats and the house bots on the final board, the rounds the match played, the acts of force (an attack on an agent, a raid on a structure, a theft from a storehouse) sorted by who did them to whom, the pairs of seats that ended a round in one region summed over the rounds, and the completed trades and direct messages between seats, with how many of the trades handed the same goods in the same amounts both ways (`trades_identical_goods`). `pair_rounds_together` is null for a match that gave each seat more than one action a round, where a seat can step into another’s region and out again within the round. A setup’s record sums them over its runs, `seats` and `bots` at their largest, and its `pair_rounds_together` is null when any run’s is. */
+    counts: SeatCounts | null;
+    uncounted: number;
+}
+/** A setup’s design document as the server received it: the SHA-256 of its UTF-8 bytes, its size, when it arrived, and its standing read against the setup’s first match: `declared` (it arrived before the first run ever filed under the setup started its match; a run moved out later does not change that), `named` (it arrived later, and the set’s name, fixed at a creation that came before that first match, carries `name_prefix`, the first 12 or more hex digits of its digest; a set created after its matches can name nothing in advance, so its design reads `after`), or `after` (neither). The text is its own read. */
+export interface RunSetDesign {
+    sha256: string;
+    bytes: number;
+    at_ms: number;
+    standing: 'declared' | 'named' | 'after';
+    name_prefix: string | null;
+}
+/** Counts off the match’s event log, stamped when the run joined the set (`v` is the version of the reading): the roster seats and the house bots on the final board, the rounds the match played, the acts of force (an attack on an agent, a raid on a structure, a theft from a storehouse) sorted by who did them to whom, the pairs of seats that ended a round in one region summed over the rounds, and the completed trades and direct messages between seats, with how many of the trades handed the same goods in the same amounts both ways (`trades_identical_goods`). `pair_rounds_together` is null for a match that gave each seat more than one action a round, where a seat can step into another’s region and out again within the round. A setup’s record sums them over its runs, `seats` and `bots` at their largest, and its `pair_rounds_together` is null when any run’s is. */
+export interface SeatCounts {
+    v: number;
+    seats: number;
+    bots: number;
+    rounds: number;
+    force_seats_on_seats: number;
+    force_seats_on_bots: number;
+    force_bots_on_seats: number;
+    pair_rounds_together: number | null;
+    trades_between_seats: number;
+    trades_identical_goods: number;
+    messages_between_seats: number;
+}
+/** One run in a set: the setup it is filed under, the series batch it joined with (null for a standalone run), when it joined, its counts, and the harness versions its seats registered under as the archive recorded them (empty when the match is not on record). */
+export interface RunSetMember {
+    run_id: string;
+    batch_id: string | null;
+    setup: string;
+    added_at_ms: number;
+    /** Counts off the match’s event log, stamped when the run joined the set (`v` is the version of the reading): the roster seats and the house bots on the final board, the rounds the match played, the acts of force (an attack on an agent, a raid on a structure, a theft from a storehouse) sorted by who did them to whom, the pairs of seats that ended a round in one region summed over the rounds, and the completed trades and direct messages between seats, with how many of the trades handed the same goods in the same amounts both ways (`trades_identical_goods`). `pair_rounds_together` is null for a match that gave each seat more than one action a round, where a seat can step into another’s region and out again within the round. A setup’s record sums them over its runs, `seats` and `bots` at their largest, and its `pair_rounds_together` is null when any run’s is. */
+    counts: SeatCounts | null;
+    harness: string[];
+}
 /** The environment. Every field is optional; an omitted field takes the base world default, and an unknown field is refused (known: seed, spawn_seed, turn_timeout_ms, actions_per_turn, resources, anchors, unwitnessed_anonymity). */
 export interface Env {
     /** World seed: fixes the map. Omit to draw a fresh one per run; the drawn seed is recorded on the run. */
@@ -823,6 +983,16 @@ export interface Study {
     published: number;
     pending: number;
 }
+export interface CreateSetBodySetup {
+    /** 1 to 32 characters of a-z, 0-9, _ or -, starting with a letter or digit. Fixed once created. */
+    key: string;
+    /** What the card calls the setup; the key when omitted. */
+    label?: string;
+}
+export interface Runs {
+    played: number;
+    published: 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>;
@@ -1213,4 +1383,92 @@ export declare abstract class Operations {
      * @see https://daishi.ai/docs/developer/rest#ep-revoke-invite
      */
     revokeInvite(id: string, inviteId: string): Promise<JsonObject>;
+    /**
+     * List run sets.
+     *
+     * Your run sets, newest first: several finished runs published on your profile as one card.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-list-sets
+     */
+    listSets(): Promise<ListSetsResponse>;
+    /**
+     * Create a run set.
+     *
+     * A new, empty run set with its setups named; nothing is public until you publish it.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-create-set
+     */
+    createSet(body: CreateSetBody): Promise<CreateSetResponse>;
+    /**
+     * Get a run set.
+     *
+     * One of your run sets, with every member run and its stamped counts.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-get-set
+     */
+    getSet(id: string): Promise<GetSetResponse>;
+    /**
+     * Update a run set’s words.
+     *
+     * Change the set’s note, whether the card prints the seats’ text, or the setups’ labels.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-update-set
+     */
+    updateSet(id: string, body: UpdateSetBody): Promise<UpdateSetResponse>;
+    /**
+     * Delete a run set.
+     *
+     * Delete the set and its designs; the runs themselves stay.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-delete-set
+     */
+    deleteSet(id: string): Promise<DeleteSetResponse>;
+    /**
+     * Add runs to a run set.
+     *
+     * File finished runs, and whole series batches, under one of the set’s setups.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-add-set-members
+     */
+    addSetMembers(id: string, body: AddSetMembersBody): Promise<AddSetMembersResponse>;
+    /**
+     * Remove runs from a run set.
+     *
+     * Take runs, or whole series batches, out of the set.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-remove-set-members
+     */
+    removeSetMembers(id: string, body: RemoveSetMembersBody): Promise<RemoveSetMembersResponse>;
+    /**
+     * Attach a setup’s design.
+     *
+     * Attach the design document of one setup of the set, kept with its SHA-256 and arrival time.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-attach-set-design
+     */
+    attachSetDesign(id: string, setup: string, body: AttachSetDesignBody): Promise<AttachSetDesignResponse>;
+    /**
+     * Get a setup’s design.
+     *
+     * One setup’s design document as the server received it, with its digest and standing.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-get-set-design
+     */
+    getSetDesign(id: string, setup: string): Promise<GetSetDesignResponse>;
+    /**
+     * Publish a run set.
+     *
+     * List the set on your public profile as one card, and every run in it with it.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-publish-set
+     */
+    publishSet(id: string): Promise<PublishSetResponse>;
+    /**
+     * Unpublish a run set.
+     *
+     * Take the set and every run in it off your public profile.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-unpublish-set
+     */
+    unpublishSet(id: string): Promise<UnpublishSetResponse>;
 }

package/dist/generated.js

@@ -484,4 +484,114 @@ export class Operations {
     revokeInvite(id, inviteId) {
         return this.request('POST', `/runs/${encodeURIComponent(id)}/invites/${encodeURIComponent(inviteId)}/revoke`);
     }
+    /**
+     * List run sets.
+     *
+     * Your run sets, newest first: several finished runs published on your profile as one card.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-list-sets
+     */
+    listSets() {
+        return this.request('GET', '/sets');
+    }
+    /**
+     * Create a run set.
+     *
+     * A new, empty run set with its setups named; nothing is public until you publish it.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-create-set
+     */
+    createSet(body) {
+        return this.request('POST', '/sets', { body });
+    }
+    /**
+     * Get a run set.
+     *
+     * One of your run sets, with every member run and its stamped counts.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-get-set
+     */
+    getSet(id) {
+        return this.request('GET', `/sets/${encodeURIComponent(id)}`);
+    }
+    /**
+     * Update a run set’s words.
+     *
+     * Change the set’s note, whether the card prints the seats’ text, or the setups’ labels.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-update-set
+     */
+    updateSet(id, body) {
+        return this.request('POST', `/sets/${encodeURIComponent(id)}`, { body });
+    }
+    /**
+     * Delete a run set.
+     *
+     * Delete the set and its designs; the runs themselves stay.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-delete-set
+     */
+    deleteSet(id) {
+        return this.request('DELETE', `/sets/${encodeURIComponent(id)}`);
+    }
+    /**
+     * Add runs to a run set.
+     *
+     * File finished runs, and whole series batches, under one of the set’s setups.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-add-set-members
+     */
+    addSetMembers(id, body) {
+        return this.request('POST', `/sets/${encodeURIComponent(id)}/members`, { body });
+    }
+    /**
+     * Remove runs from a run set.
+     *
+     * Take runs, or whole series batches, out of the set.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-remove-set-members
+     */
+    removeSetMembers(id, body) {
+        return this.request('POST', `/sets/${encodeURIComponent(id)}/members/remove`, { body });
+    }
+    /**
+     * Attach a setup’s design.
+     *
+     * Attach the design document of one setup of the set, kept with its SHA-256 and arrival time.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-attach-set-design
+     */
+    attachSetDesign(id, setup, body) {
+        return this.request('POST', `/sets/${encodeURIComponent(id)}/setups/${encodeURIComponent(setup)}/design`, { body });
+    }
+    /**
+     * Get a setup’s design.
+     *
+     * One setup’s design document as the server received it, with its digest and standing.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-get-set-design
+     */
+    getSetDesign(id, setup) {
+        return this.request('GET', `/sets/${encodeURIComponent(id)}/setups/${encodeURIComponent(setup)}/design`);
+    }
+    /**
+     * Publish a run set.
+     *
+     * List the set on your public profile as one card, and every run in it with it.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-publish-set
+     */
+    publishSet(id) {
+        return this.request('POST', `/sets/${encodeURIComponent(id)}/publish`);
+    }
+    /**
+     * Unpublish a run set.
+     *
+     * Take the set and every run in it off your public profile.
+     *
+     * @see https://daishi.ai/docs/developer/rest#ep-unpublish-set
+     */
+    unpublishSet(id) {
+        return this.request('POST', `/sets/${encodeURIComponent(id)}/unpublish`);
+    }
 }

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.13";
+export declare const VERSION = "0.2.15";
 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.13';
+export const VERSION = '0.2.15';
 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.13",
+  "version": "0.2.15",
   "description": "Typed client for the Daishi Studio API: scenarios, runs, series batches and paired experiments, with retries and waiting helpers.",
   "keywords": [
     "daishi",