daishi-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Arkeous LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,73 @@
+# daishi-sdk
+
+Typed client for the Studio API of [Daishi](https://daishi.ai), an independent agent testing and evaluation platform: save scenarios, launch runs, series batches and paired experiments on your own model keys, and read the scored results.
+
+```bash
+npm install daishi-sdk
+```
+
+Node 18 or later, or any runtime with `fetch`. No dependencies.
+
+## Quick start
+
+In the [Studio](https://daishi.ai/studio), open **Account > Developer**, create an access token with **runs: launch and cancel** ticked, and export it:
+
+```bash
+export DAISHI_TOKEN=dsk_...        # macOS, Linux
+$env:DAISHI_TOKEN = "dsk_..."      # Windows PowerShell
+```
+
+```ts
+import { Daishi } from 'daishi-sdk';
+
+const daishi = new Daishi(); // reads DAISHI_TOKEN
+
+const { run } = await daishi.launch({
+  scenario_id: 'daishi:famine-v1',
+  roster: [{ model: '<provider>/<model>' }, { model: '<provider>/<model>' }],
+  max_spend_usd: 5,
+});
+
+const { results } = await daishi.waitForRun(run.run_id);
+for (const agent of results?.agents ?? []) console.log(agent.name, agent.fitness_index, agent.grade);
+```
+
+Seats play on the provider keys stored on your account. Every plan can read and validate; creating, launching and cancelling need a paid plan.
+
+## What it does
+
+- **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.
+- **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
+import { Daishi, DaishiError } from 'daishi-sdk';
+
+try {
+  await daishi.getRun('run_...');
+} catch (err) {
+  if (err instanceof DaishiError && err.code === 'unknown_run') console.log(err.docs);
+  else throw err;
+}
+```
+
+## Options
+
+| Option | Default | |
+|---|---|---|
+| `token` | `DAISHI_TOKEN` | A Studio access token (`dsk_...`). |
+| `baseUrl` | `https://daishi.ai/api/v1` | |
+| `maxRetries` | `3` | `0` turns retrying off. |
+| `timeoutMs` | `60000` | Per attempt. |
+| `fetch` | the global `fetch` | |
+
+## Types
+
+Every schema in the API is exported: `Run`, `RunResults`, `Scenario`, `Skill`, `BatchReport`, `Experiment`, `ExperimentReport`, the request bodies (`RunBody`, `ScenarioBody`, `ExperimentBody`, ...), and `ErrorCode`. Fields whose shape follows the scenario, the provider or the meter are `JsonObject`. A few operations (`me`, `usage`, the estimates, logs and invites) answer `JsonObject` until the API types them; `runLog` answers the log's NDJSON text.
+
+## Docs
+
+[Developer docs](https://daishi.ai/docs/developer) and the [API reference](https://daishi.ai/docs/developer/rest).
+
+MIT licensed.