@alisio/sdk 0.1.0-alpha.18 → 0.1.0-alpha.19

package/dist/index.d.ts

@@ -524,6 +524,28 @@ export interface RunEvent {
     /** Embedder-supplied correlation id (for example an HTTP `X-Request-Id`), when given. */
     correlationId?: string;
 }
+/** What a `run_failed` event with `code: "timeout"` says about the limit that stopped the run. */
+export interface RunTimeoutInfo {
+    /** `run`: the whole-run limit (`limits.timeoutMs`); `first_token`: a silent request (`limits.firstTokenTimeoutMs`). */
+    kind: "run" | "first_token";
+    /** The limit that was reached, in milliseconds. */
+    ms: number;
+    /** Model the run was using, when known. */
+    model?: string;
+    /** Short provider label (the host of an OpenAI-compatible endpoint), when known. */
+    provider?: string;
+    /** What the run was doing: waiting for the first token of a request, streaming, or running a tool. */
+    stage: "waiting_model" | "streaming" | "tool" | "other";
+    /** The tool that was running when `stage` is `tool`. */
+    tool?: string;
+    /** Nothing had been produced yet: the very first model request of the run got no answer. */
+    firstRequest?: boolean;
+    /**
+     * `first_token` only: how many times the same request was sent (the first try plus the silent
+     * retries of `limits.firstTokenRetries`); `1` when retrying is disabled.
+     */
+    attempts?: number;
+}
 /**
  * Payload of each event type the core emits today, keyed by `RunEvent.type`. Additive: new
  * types and new optional fields may appear; existing fields keep their meaning.
@@ -609,12 +631,31 @@ export interface RunEventDataMap {
         turn: number;
         maxOutputTokens: number;
     };
+    /**
+     * A model request stayed completely silent for `limits.firstTokenTimeoutMs` and the same
+     * request is sent again (no new turn, nothing appended to the session). `attempt` is the
+     * retry about to start (1-based), `of` the retries allowed (`limits.firstTokenRetries`) and
+     * `afterMs` how long the aborted request had been silent.
+     */
+    request_retry: {
+        attempt: number;
+        of: number;
+        reason: "first_token_timeout";
+        afterMs: number;
+    };
     run_turns_exceeded: {
         turns: number;
         maxTurns: number;
     };
+    /**
+     * The run failed. `error` is always a human-readable message. `code: "timeout"` (with `timeout`)
+     * marks a run stopped by a time limit instead of a provider or tool error; both fields are
+     * additive and absent for every other failure.
+     */
     run_failed: {
         error: string;
+        code?: "timeout";
+        timeout?: RunTimeoutInfo;
     };
     run_cancelled: {
         error: string;
@@ -1192,6 +1233,8 @@ export interface SessionDetailWire {
 export interface InflightState {
     runId: string;
     status: "queued" | "running";
+    /** Epoch milliseconds when the run started executing; lets a reloaded client show elapsed time. */
+    startedAt?: number;
     /** Assistant text streamed since the last `turn_completed`. */
     text: string;
     /** Reasoning streamed since the last `turn_completed` (never persisted). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alisio/sdk",
-  "version": "0.1.0-alpha.18",
+  "version": "0.1.0-alpha.19",
   "description": "Typed plugin SDK for Alisio: the stable contract for tools, commands, context, compaction and session hooks, model completions and storage. Types only plus tiny helpers; zero runtime dependencies.",
   "author": "Gustavo Gutiérrez",
   "license": "MIT",