10xgraph-client 0.6.0 → 1.0.0-rc.2

package/dist/interrupt.d.ts

@@ -0,0 +1,46 @@
+import type { StreamChunk } from './endpoints/stream.js';
+/**
+ * A pause raised by `interrupt()` in a graph node or tool, waiting for a resume value.
+ * Mirrors the server payload at `chunk.data.interrupt` of an `updates` chunk whose
+ * `status` is `"interrupted"`.
+ */
+export interface Interrupt {
+    /** Unique id of this pause; echo it as `interrupt_id` when resuming. */
+    id: string;
+    /** Stable position of the call within its node or tool call. */
+    key: string;
+    /** Node that was running when the graph paused. */
+    node: string;
+    /** Payload passed to `interrupt()`: what to approve or choose from. */
+    value?: unknown;
+    /** Human-readable prompt. */
+    message?: string | null;
+    /** Machine-readable reason, for example `"tool_approval"`. */
+    reason: string;
+    /** JSON Schema the resume value must follow. */
+    response_schema?: Record<string, unknown> | null;
+    /** Tool call that paused, when `interrupt()` ran inside a tool. */
+    tool_call_id?: string | null;
+}
+/** Spread into the `options` of `invoke`, `stream` or `wsStream` to answer an interrupt. */
+export interface InterruptResume {
+    resume: unknown;
+    interrupt_id: string;
+}
+/** The pending interrupt carried by a stream chunk, or null when the chunk has none. */
+export declare function getInterrupt(chunk: Pick<StreamChunk, 'event' | 'data'>): Interrupt | null;
+/**
+ * Answer an interrupt with approval. `value` is what the interrupted code receives; it
+ * defaults to `true`. When the interrupt sets `response_schema`, pass a value that matches it.
+ *
+ * ```ts
+ * await client.invoke([], { config: { thread_id }, ...approveInterrupt(interrupt) });
+ * ```
+ */
+export declare function approveInterrupt(interrupt: Interrupt, value?: unknown): InterruptResume;
+/**
+ * Answer an interrupt with a cancel. The server resumes the interrupted code with `null`
+ * and does not check it against `response_schema`.
+ */
+export declare function rejectInterrupt(interrupt: Interrupt): InterruptResume;
+//# sourceMappingURL=interrupt.d.ts.map

package/dist/interrupt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interrupt.d.ts","sourceRoot":"","sources":["../src/interrupt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACjD,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,4FAA4F;AAC5F,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,CAAC,GAAG,SAAS,GAAG,IAAI,CAMzF;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,GAAE,OAAc,GAAG,eAAe,CAE7F;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,eAAe,CAErE"}

package/dist/request.d.ts

@@ -15,6 +15,16 @@ export interface TenxGraphHeaderAuth {
     prefix?: string | null;
 }
 export type TenxGraphAuth = TenxGraphBearerAuth | TenxGraphBasicAuth | TenxGraphHeaderAuth;
+/**
+ * Abort `controller` when the caller's `signal` aborts. Returns a cleanup function.
+ * A signal that is already aborted aborts the controller immediately.
+ */
+export declare function linkAbortSignal(controller: AbortController, signal?: AbortSignal | null): () => void;
+/** Per-call options accepted by every client method that makes a request. */
+export interface RequestOptions {
+    /** Abort to cancel the request. Rejects with the signal's AbortError, never as a timeout. */
+    signal?: AbortSignal;
+}
 export interface RequestContext {
     baseUrl: string;
     authToken?: string | null;
@@ -24,10 +34,28 @@ export interface RequestContext {
     timeout: number;
     debug: boolean;
     webSocketImpl?: WebSocketImpl;
+    /** Caller's cancellation signal for this call. Set per call by the client, not stored. */
+    signal?: AbortSignal;
 }
 export declare function buildHeaders(context: Pick<RequestContext, 'authToken' | 'auth' | 'headers'>, defaults?: HeadersInit): Record<string, string>;
 export declare function getRequestCredentials(context: Pick<RequestContext, 'credentials'>): Pick<RequestInit, 'credentials'> | Record<string, never>;
 export declare function bearerAuth(token: string): TenxGraphBearerAuth;
 export declare function basicAuth(username: string, password: string): TenxGraphBasicAuth;
 export declare function headerAuth(name: string, value: string, prefix?: string | null): TenxGraphHeaderAuth;
+/** Percent-encode one URL path segment (thread, message or memory id). */
+export declare function encodePathSegment(value: string | number): string;
+/** Strip trailing slashes so `${baseUrl}/path` never produces `//path`. */
+export declare function normalizeBaseUrl(baseUrl: string): string;
+/**
+ * fetch with the shared client policy:
+ * - the timeout timer is always cleared (also when fetch rejects) and does not keep a Node
+ *   process alive;
+ * - `context.signal` cancels the call (rejects with the AbortError, never as a timeout);
+ * - a timeout throws RequestTimeoutError, any other fetch rejection throws NetworkError
+ *   with the original error as `cause`;
+ * - with header-type credentials other than Authorization (e.g. X-API-Key, which fetch does not
+ *   strip on a redirect)
+ *   redirects are followed only within the same origin; a cross-origin redirect is refused.
+ */
+export declare function fetchWithTimeout(context: Pick<RequestContext, 'timeout' | 'signal' | 'auth'>, url: string, init?: RequestInit): Promise<Response>;
 //# sourceMappingURL=request.d.ts.map

package/dist/request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,MAAM,aAAa,GAAG,mBAAmB,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;AAE3F,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AA8FD,wBAAgB,YAAY,CAC1B,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC,EAC/D,QAAQ,CAAC,EAAE,WAAW,GACrB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAaxB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,aAAa,CAAC,GAC3C,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAM1D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAE7D;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAEhF;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GACrB,mBAAmB,CAErB"}
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG7C,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,MAAM,aAAa,GAAG,mBAAmB,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;AAE3F;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,eAAe,EAC3B,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,GAC1B,MAAM,IAAI,CASZ;AAED,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,6FAA6F;IAC7F,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,0FAA0F;IAC1F,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AA8FD,wBAAgB,YAAY,CAC1B,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC,EAC/D,QAAQ,CAAC,EAAE,WAAW,GACrB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAaxB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,aAAa,CAAC,GAC3C,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAM1D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAE7D;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAEhF;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GACrB,mBAAmB,CAErB;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEhE;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKxD;AAoBD;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC,EAC5D,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,QAAQ,CAAC,CA2DnB"}

package/dist/tools.d.ts

@@ -35,12 +35,26 @@ export interface ToolRegistration {
     description?: string;
     parameters?: ToolParameter;
     handler: ToolHandler;
+    /**
+     * Runs on the server-sent arguments before the handler (after the declared `parameters`
+     * check). Throw, or return `false`, to reject the call: the model receives a failed tool
+     * result and the handler is not run.
+     */
+    validate?: (args: any) => boolean | void | Promise<boolean | void>;
+    /** Reject calls whose JSON-serialised arguments exceed this many bytes. Default 1 MiB. */
+    maxArgsBytes?: number;
 }
+/** Default cap on serialised tool-call arguments. */
+export declare const DEFAULT_MAX_TOOL_ARGS_BYTES: number;
+/** Check `args` against the top level of a declared JSON Schema; returns an error message or null. */
+export declare function checkToolArguments(args: unknown, parameters?: ToolParameter): string | null;
 export interface ToolDefinition extends ToolHandler {
     name: string;
     description?: string;
     parameters?: ToolParameter;
     node?: string;
+    validate?: ToolRegistration['validate'];
+    maxArgsBytes?: number;
 }
 export declare class ToolExecutor {
     private tools;

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAwC,MAAM,cAAc,CAAC;AAG7E,MAAM,WAAW,WAAW;IAC1B,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,CAAC,EAAE,aAAa,GAAG,aAAa,CAUjF;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,aAAa,CAAC;KAC3B,CAAC;CACH;AAGD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,OAAO,EAAE,WAAW,CAAC;CACtB;AAGD,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,WAAW,CAA2C;gBAElD,KAAK,GAAE,cAAc,EAAO;IAiBxC;;OAEG;IACH,YAAY,CAAC,YAAY,EAAE,gBAAgB,GAAG,IAAI;IAuClD;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE;IAK/C;;OAEG;IACH,SAAS,IAAI,IAAI,EAAE;IAkBnB;;;OAGG;IACG,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAgEhE"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAwC,MAAM,cAAc,CAAC;AAG7E,MAAM,WAAW,WAAW;IAC1B,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,CAAC,EAAE,aAAa,GAAG,aAAa,CAUjF;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,aAAa,CAAC;KAC3B,CAAC;CACH;AAGD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,OAAO,EAAE,WAAW,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACnE,0FAA0F;IAC1F,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qDAAqD;AACrD,eAAO,MAAM,2BAA2B,QAAc,CAAC;AAEvD,sGAAsG;AACtG,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAoC3F;AAGD,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,WAAW,CAA2C;gBAElD,KAAK,GAAE,cAAc,EAAO;IAiBxC;;OAEG;IACH,YAAY,CAAC,YAAY,EAAE,gBAAgB,GAAG,IAAI;IAiDlD;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE;IAK/C;;OAEG;IACH,SAAS,IAAI,IAAI,EAAE;IAkBnB;;;OAGG;IACG,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAiGhE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "10xgraph-client",
-  "version": "0.6.0",
+  "version": "1.0.0-rc.2",
   "description": "TypeScript client for the 10xGraph API server: invoke and stream agent graphs, manage threads, memory and files, run client-side tools, and realtime audio. Formerly @10xscale/agentflow-client.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -8,9 +8,14 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
     },
     "./package.json": "./package.json"
   },
@@ -23,7 +28,7 @@
     "CHANGELOG.md"
   ],
   "scripts": {
-    "build": "npm run clean && tsc -p tsconfig.build.json && vite build",
+    "build": "npm run clean && tsc -p tsconfig.build.json && tsc -p tsconfig.build.cjs.json && node -e \"require('fs').writeFileSync('dist/cjs/package.json', '{\\\"type\\\": \\\"commonjs\\\"}\\n')\" && vite build",
     "clean": "rimraf dist",
     "dev": "vite build --watch",
     "typecheck": "tsc --noEmit",
@@ -93,7 +98,7 @@
   ],
   "license": "MIT",
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "publishConfig": {
     "access": "public"

package/src/agent.ts

@@ -1,18 +1,31 @@
 import { Message } from './message.js';
 
 // Define ExecutionMeta interface
-interface ExecutionMeta {
+export interface ExecutionMeta {
   current_node: string;
   step: number;
+  /** Server execution status, e.g. 'running', 'interrupted_before', 'completed'. */
+  status?: string;
+  interrupted_node?: string | null;
+  interrupt_reason?: string | null;
+  interrupt_data?: Record<string, any> | null;
+  thread_id?: string | null;
+  run_id?: string | null;
+  stop_current_execution?: string;
+  internal_data?: Record<string, any>;
+  /** @deprecated The server never sends this field. Read `status` / `interrupted_node`. */
   interrupt?: {
     node: string;
     reason: string;
     status: string;
     data?: Record<string, any>;
   };
-  is_running: boolean;
-  is_interrupted: boolean;
-  is_stopped_requested: boolean;
+  /** @deprecated The server never sends this field. Read `status`. */
+  is_running?: boolean;
+  /** @deprecated The server never sends this field. Read `status`. */
+  is_interrupted?: boolean;
+  /** @deprecated The server never sends this field. Read `stop_current_execution`. */
+  is_stopped_requested?: boolean;
 }
 
 // Define default ExecutionMeta implementation