@meistrari/tela-sdk-js 2.12.0 → 2.13.1

package/dist/index.cjs

@@ -4,6 +4,7 @@ const changeCase = require('change-case');
 const minimatch = require('minimatch');
 const z = require('zod');
 const Emittery = require('emittery');
+const agentSdk = require('@meistrari/agent-sdk');
 
 function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
 
@@ -23,12 +24,12 @@ const changeCase__namespace = /*#__PURE__*/_interopNamespaceCompat(changeCase);
 const z__default = /*#__PURE__*/_interopDefaultCompat(z);
 const Emittery__default = /*#__PURE__*/_interopDefaultCompat(Emittery);
 
-const version = "2.12.0";
+const version = "2.13.1";
 
-var __defProp$a = Object.defineProperty;
-var __defNormalProp$a = (obj, key, value) => key in obj ? __defProp$a(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$a = (obj, key, value) => {
-  __defNormalProp$a(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$b = Object.defineProperty;
+var __defNormalProp$b = (obj, key, value) => key in obj ? __defProp$b(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$b = (obj, key, value) => {
+  __defNormalProp$b(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 class TelaError extends Error {
@@ -58,7 +59,7 @@ class InvalidFileURL extends TelaError {
 class FileUploadError extends TelaError {
   constructor(message, statusCode) {
     super(`Failed to upload file: ${message} (Status code: ${statusCode})`);
-    __publicField$a(this, "statusCode");
+    __publicField$b(this, "statusCode");
     this.statusCode = statusCode;
   }
 }
@@ -75,30 +76,44 @@ class InvalidExecutionModeError extends TelaError {
 class ExecutionFailedError extends TelaError {
   constructor(rawOutput) {
     super(`Execution failed: ${JSON.stringify(rawOutput)}`);
-    __publicField$a(this, "rawOutput");
+    __publicField$b(this, "rawOutput");
     this.rawOutput = rawOutput;
   }
 }
 class TaskFailedError extends TelaError {
   constructor(rawTask, message, cause) {
     super(`Task failed: ${JSON.stringify(rawTask)}`, { cause });
-    __publicField$a(this, "rawTask");
+    __publicField$b(this, "rawTask");
     this.rawTask = rawTask;
   }
 }
 class BatchExecutionFailedError extends TelaError {
   constructor(rawResponse) {
     super(`Batch execution failed: ${JSON.stringify(rawResponse)}`);
-    __publicField$a(this, "rawResponse");
+    __publicField$b(this, "rawResponse");
     this.rawResponse = rawResponse;
   }
 }
+class AgentExecutionFailedError extends TelaError {
+  constructor(payload) {
+    super(`Agent execution failed${payload.sessionId ? ` (session ${payload.sessionId})` : ""}: ${payload.error ?? "unknown error"}`);
+    /** The session id, when known. */
+    __publicField$b(this, "sessionId");
+    /** The server-provided error message, when available. */
+    __publicField$b(this, "error");
+    /** The full raw payload that triggered the failure. */
+    __publicField$b(this, "raw");
+    this.sessionId = payload.sessionId;
+    this.error = payload.error;
+    this.raw = payload;
+  }
+}
 class APIError extends TelaError {
   constructor(statusCode, error, _message) {
     const message = error?.message ? typeof error.message === "string" ? error.message : JSON.stringify(error.message) : error ? JSON.stringify(error) : _message;
     super(message);
-    __publicField$a(this, "statusCode");
-    __publicField$a(this, "error");
+    __publicField$b(this, "statusCode");
+    __publicField$b(this, "error");
     this.statusCode = statusCode;
     this.error = error;
   }
@@ -140,7 +155,7 @@ class APIError extends TelaError {
 class UserAbortError extends APIError {
   constructor({ message } = {}) {
     super(void 0, void 0, message || "User aborted.");
-    __publicField$a(this, "statusCode");
+    __publicField$b(this, "statusCode");
   }
 }
 class ConnectionError extends APIError {
@@ -149,7 +164,7 @@ class ConnectionError extends APIError {
     cause
   }) {
     super(void 0, void 0, message || "Connection error.");
-    __publicField$a(this, "statusCode");
+    __publicField$b(this, "statusCode");
     if (cause)
       this.cause = cause;
   }
@@ -159,57 +174,57 @@ class ConnectionTimeout extends APIError {
     message
   } = {}) {
     super(void 0, void 0, message || "Request timed out.");
-    __publicField$a(this, "statusCode");
+    __publicField$b(this, "statusCode");
   }
 }
 class BadRequestError extends APIError {
   constructor() {
     super(...arguments);
-    __publicField$a(this, "statusCode", 400);
+    __publicField$b(this, "statusCode", 400);
   }
   // todo: handle validation errors from zod/typebox
 }
 class AuthenticationError extends APIError {
   constructor() {
     super(...arguments);
-    __publicField$a(this, "statusCode", 401);
+    __publicField$b(this, "statusCode", 401);
   }
 }
 class AuthorizationError extends APIError {
   constructor() {
     super(...arguments);
-    __publicField$a(this, "statusCode", 403);
+    __publicField$b(this, "statusCode", 403);
   }
 }
 class NotFoundError extends APIError {
   constructor() {
     super(...arguments);
-    __publicField$a(this, "statusCode", 404);
+    __publicField$b(this, "statusCode", 404);
   }
 }
 class ConflictError extends APIError {
   constructor() {
     super(...arguments);
-    __publicField$a(this, "statusCode", 409);
+    __publicField$b(this, "statusCode", 409);
   }
 }
 class UnprocessableEntityError extends APIError {
   constructor() {
     super(...arguments);
     // todo: check if tela returns 400 or 422 for zod errors
-    __publicField$a(this, "statusCode", 422);
+    __publicField$b(this, "statusCode", 422);
   }
 }
 class RateLimitError extends APIError {
   constructor() {
     super(...arguments);
-    __publicField$a(this, "statusCode", 429);
+    __publicField$b(this, "statusCode", 429);
   }
 }
 class InternalServerError extends APIError {
   constructor() {
     super(...arguments);
-    __publicField$a(this, "statusCode", 500);
+    __publicField$b(this, "statusCode", 500);
   }
 }
 function toError(err) {
@@ -495,10 +510,10 @@ function transformDurationToMs(durationStr) {
   return Number.parseInt(amount) * multiplier;
 }
 
-var __defProp$9 = Object.defineProperty;
-var __defNormalProp$9 = (obj, key, value) => key in obj ? __defProp$9(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$9 = (obj, key, value) => {
-  __defNormalProp$9(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$a = Object.defineProperty;
+var __defNormalProp$a = (obj, key, value) => key in obj ? __defProp$a(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$a = (obj, key, value) => {
+  __defNormalProp$a(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 class Stream {
@@ -762,9 +777,9 @@ function findDoubleNewlineIndex(buffer) {
 }
 class SSEDecoder {
   constructor() {
-    __publicField$9(this, "data");
-    __publicField$9(this, "event");
-    __publicField$9(this, "chunks");
+    __publicField$a(this, "data");
+    __publicField$a(this, "event");
+    __publicField$a(this, "chunks");
     this.event = null;
     this.data = [];
     this.chunks = [];
@@ -805,9 +820,9 @@ class SSEDecoder {
 const _LineDecoder = class _LineDecoder {
   // TextDecoder found in browsers; not typed to avoid pulling in either "dom" or "node" types.
   constructor() {
-    __publicField$9(this, "buffer");
-    __publicField$9(this, "trailingCR");
-    __publicField$9(this, "textDecoder");
+    __publicField$a(this, "buffer");
+    __publicField$a(this, "trailingCR");
+    __publicField$a(this, "textDecoder");
     this.buffer = [];
     this.trailingCR = false;
   }
@@ -882,8 +897,8 @@ const _LineDecoder = class _LineDecoder {
   }
 };
 // prettier-ignore
-__publicField$9(_LineDecoder, "NEWLINE_CHARS", /* @__PURE__ */ new Set(["\n", "\r"]));
-__publicField$9(_LineDecoder, "NEWLINE_REGEXP", /\r\n|[\n\r]/g);
+__publicField$a(_LineDecoder, "NEWLINE_CHARS", /* @__PURE__ */ new Set(["\n", "\r"]));
+__publicField$a(_LineDecoder, "NEWLINE_REGEXP", /\r\n|[\n\r]/g);
 let LineDecoder = _LineDecoder;
 function partition(str, delimiter) {
   const index = str.indexOf(delimiter);
@@ -920,10 +935,10 @@ function readableStreamAsyncIterable(stream) {
   };
 }
 
-var __defProp$8 = Object.defineProperty;
-var __defNormalProp$8 = (obj, key, value) => key in obj ? __defProp$8(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$8 = (obj, key, value) => {
-  __defNormalProp$8(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$9 = Object.defineProperty;
+var __defNormalProp$9 = (obj, key, value) => key in obj ? __defProp$9(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$9 = (obj, key, value) => {
+  __defNormalProp$9(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 function getRequestIdFromResponse(response) {
@@ -999,10 +1014,10 @@ function transformObjectCase(obj, transformCase) {
 }
 class BaseClient {
   constructor({ baseURL, maxRetries = 5, timeout = 0 }) {
-    __publicField$8(this, "baseURL");
-    __publicField$8(this, "maxRetries");
-    __publicField$8(this, "timeout");
-    __publicField$8(this, "fetch");
+    __publicField$9(this, "baseURL");
+    __publicField$9(this, "maxRetries");
+    __publicField$9(this, "timeout");
+    __publicField$9(this, "fetch");
     this.baseURL = baseURL;
     this.maxRetries = validateMaxRetries(maxRetries);
     this.timeout = validateTimeout(timeout);
@@ -1040,6 +1055,36 @@ class BaseClient {
   delete(path, opts) {
     return this.methodRequest("DELETE", path, opts);
   }
+  /**
+   * Performs a request and returns the raw {@link Response} together with its
+   * {@link AbortController}, bypassing JSON parsing and case transformation.
+   *
+   * Intended for consumers that parse the response body themselves — e.g.
+   * custom Server-Sent Events streams whose framing differs from the chat
+   * completion stream handled by {@link Stream.fromSSEResponse}. Reuses the
+   * client's retry, auth, timeout, and `baseURL` handling.
+   *
+   * @param method - The HTTP method to use.
+   * @param path - Request path (relative to `baseURL`/`opts.baseURL`, or absolute).
+   * @param opts - Request options (notably `baseURL`, `query`, and `signal`).
+   * @returns The live `Response` and the `AbortController` controlling it.
+   */
+  async requestRaw(method, path, opts) {
+    const { headers: customHeaders, ...restOpts } = opts ?? {};
+    const headers = this.createHeaders();
+    if (customHeaders) {
+      for (const [key, value] of customHeaders.entries()) {
+        headers.set(key, value);
+      }
+    }
+    const { response, controller } = await this.request({
+      method,
+      path,
+      headers,
+      ...restOpts
+    });
+    return { response, controller };
+  }
   async methodRequest(method, path, opts) {
     const { transformCase = true, headers: customHeaders, ...restOpts } = opts ?? {};
     const headers = this.createHeaders();
@@ -1287,10 +1332,10 @@ async function getStreamSize(stream) {
   return size;
 }
 
-var __defProp$7 = Object.defineProperty;
-var __defNormalProp$7 = (obj, key, value) => key in obj ? __defProp$7(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$7 = (obj, key, value) => {
-  __defNormalProp$7(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$8 = Object.defineProperty;
+var __defNormalProp$8 = (obj, key, value) => key in obj ? __defProp$8(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$8 = (obj, key, value) => {
+  __defNormalProp$8(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 function TelaFileSchema() {
@@ -1298,11 +1343,11 @@ function TelaFileSchema() {
 }
 class TelaFile {
   constructor(file, options = {}) {
-    __publicField$7(this, "_file");
-    __publicField$7(this, "_options");
-    __publicField$7(this, "_size", null);
-    __publicField$7(this, "_mimeType");
-    __publicField$7(this, "_name");
+    __publicField$8(this, "_file");
+    __publicField$8(this, "_options");
+    __publicField$8(this, "_size", null);
+    __publicField$8(this, "_mimeType");
+    __publicField$8(this, "_name");
     this._file = file;
     if (file instanceof File || file instanceof Blob) {
       this._size = file.size;
@@ -1781,10 +1826,10 @@ async function streamFile(vaultReference, client) {
   });
 }
 
-var __defProp$6 = Object.defineProperty;
-var __defNormalProp$6 = (obj, key, value) => key in obj ? __defProp$6(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$6 = (obj, key, value) => {
-  __defNormalProp$6(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$7 = Object.defineProperty;
+var __defNormalProp$7 = (obj, key, value) => key in obj ? __defProp$7(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$7 = (obj, key, value) => {
+  __defNormalProp$7(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 function timeout(ms, signal) {
@@ -1800,10 +1845,10 @@ function timeout(ms, signal) {
 }
 class Poller {
   constructor({ interval, timeout: timeout2, abortSignal }) {
-    __publicField$6(this, "_interval");
-    __publicField$6(this, "_timeout");
-    __publicField$6(this, "_abortSignal");
-    __publicField$6(this, "_internalAbortController");
+    __publicField$7(this, "_interval");
+    __publicField$7(this, "_timeout");
+    __publicField$7(this, "_abortSignal");
+    __publicField$7(this, "_internalAbortController");
     if (interval <= 0) {
       throw new TelaError("Interval must be greater than 0");
     }
@@ -1864,10 +1909,10 @@ class Poller {
   }
 }
 
-var __defProp$5 = Object.defineProperty;
-var __defNormalProp$5 = (obj, key, value) => key in obj ? __defProp$5(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$5 = (obj, key, value) => {
-  __defNormalProp$5(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$6 = Object.defineProperty;
+var __defNormalProp$6 = (obj, key, value) => key in obj ? __defProp$6(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$6 = (obj, key, value) => {
+  __defNormalProp$6(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 function isUUID(str) {
@@ -1923,21 +1968,21 @@ class CanvasExecution extends Emittery__default {
    */
   constructor(variables, params = { async: false }, outputSchema, client, isTask = false) {
     super();
-    __publicField$5(this, "_id");
-    __publicField$5(this, "_status");
-    __publicField$5(this, "_variables");
-    __publicField$5(this, "_params");
-    __publicField$5(this, "_client");
-    __publicField$5(this, "_outputSchema");
-    __publicField$5(this, "_skipResultValidation");
-    __publicField$5(this, "_abortController");
-    __publicField$5(this, "_isTask");
-    __publicField$5(this, "_headers");
-    __publicField$5(this, "_resultPromise");
-    __publicField$5(this, "_stream");
-    __publicField$5(this, "_rawResultValue");
-    __publicField$5(this, "_requestId");
-    __publicField$5(this, "_task");
+    __publicField$6(this, "_id");
+    __publicField$6(this, "_status");
+    __publicField$6(this, "_variables");
+    __publicField$6(this, "_params");
+    __publicField$6(this, "_client");
+    __publicField$6(this, "_outputSchema");
+    __publicField$6(this, "_skipResultValidation");
+    __publicField$6(this, "_abortController");
+    __publicField$6(this, "_isTask");
+    __publicField$6(this, "_headers");
+    __publicField$6(this, "_resultPromise");
+    __publicField$6(this, "_stream");
+    __publicField$6(this, "_rawResultValue");
+    __publicField$6(this, "_requestId");
+    __publicField$6(this, "_task");
     this._variables = variables;
     this._params = params;
     this._outputSchema = outputSchema;
@@ -2568,10 +2613,10 @@ class CanvasExecution extends Emittery__default {
   }
 }
 
-var __defProp$4 = Object.defineProperty;
-var __defNormalProp$4 = (obj, key, value) => key in obj ? __defProp$4(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$4 = (obj, key, value) => {
-  __defNormalProp$4(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$5 = Object.defineProperty;
+var __defNormalProp$5 = (obj, key, value) => key in obj ? __defProp$5(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$5 = (obj, key, value) => {
+  __defNormalProp$5(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 function resolveBatchQueue(queue) {
@@ -2723,8 +2768,8 @@ class BatchExecutionResult {
    * @internal
    */
   constructor(client, response) {
-    __publicField$4(this, "_client");
-    __publicField$4(this, "_response");
+    __publicField$5(this, "_client");
+    __publicField$5(this, "_response");
     this._client = client;
     this._response = response;
   }
@@ -3000,13 +3045,13 @@ class BatchExecution extends Emittery__default {
    */
   constructor(id, client, params = {}, creationResponse) {
     super();
-    __publicField$4(this, "_client");
-    __publicField$4(this, "_id");
-    __publicField$4(this, "_params");
-    __publicField$4(this, "_abortController");
-    __publicField$4(this, "_creationResponse");
-    __publicField$4(this, "_status", "created");
-    __publicField$4(this, "_resultPromise");
+    __publicField$5(this, "_client");
+    __publicField$5(this, "_id");
+    __publicField$5(this, "_params");
+    __publicField$5(this, "_abortController");
+    __publicField$5(this, "_creationResponse");
+    __publicField$5(this, "_status", "created");
+    __publicField$5(this, "_resultPromise");
     this._id = id;
     this._client = client;
     this._params = params;
@@ -3219,10 +3264,10 @@ class Batch {
    * @internal
    */
   constructor(client, canvasIdentifier, params = {}) {
-    __publicField$4(this, "_client");
-    __publicField$4(this, "_canvasIdentifier");
-    __publicField$4(this, "_items", []);
-    __publicField$4(this, "_params");
+    __publicField$5(this, "_client");
+    __publicField$5(this, "_canvasIdentifier");
+    __publicField$5(this, "_items", []);
+    __publicField$5(this, "_params");
     this._client = client;
     this._canvasIdentifier = canvasIdentifier;
     this._params = params;
@@ -3367,10 +3412,10 @@ class Batch {
   }
 }
 
-var __defProp$3 = Object.defineProperty;
-var __defNormalProp$3 = (obj, key, value) => key in obj ? __defProp$3(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$3 = (obj, key, value) => {
-  __defNormalProp$3(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$4 = Object.defineProperty;
+var __defNormalProp$4 = (obj, key, value) => key in obj ? __defProp$4(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$4 = (obj, key, value) => {
+  __defNormalProp$4(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 function fetchById(id, client) {
@@ -3402,15 +3447,15 @@ class Canvas {
    * @private
    */
   constructor({ id, applicationId, name, versionId, input, output, client, variables, isWorkflow }) {
-    __publicField$3(this, "_id");
-    __publicField$3(this, "_versionId");
-    __publicField$3(this, "_applicationId");
-    __publicField$3(this, "_name");
-    __publicField$3(this, "_input");
-    __publicField$3(this, "_output");
-    __publicField$3(this, "_client");
-    __publicField$3(this, "_variables");
-    __publicField$3(this, "_isWorkflow");
+    __publicField$4(this, "_id");
+    __publicField$4(this, "_versionId");
+    __publicField$4(this, "_applicationId");
+    __publicField$4(this, "_name");
+    __publicField$4(this, "_input");
+    __publicField$4(this, "_output");
+    __publicField$4(this, "_client");
+    __publicField$4(this, "_variables");
+    __publicField$4(this, "_isWorkflow");
     this._id = id;
     this._applicationId = applicationId;
     this._name = name;
@@ -3667,24 +3712,24 @@ z.z.object({
   requestId: z.z.string()
 });
 
-var __defProp$2 = Object.defineProperty;
-var __defNormalProp$2 = (obj, key, value) => key in obj ? __defProp$2(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$2 = (obj, key, value) => {
-  __defNormalProp$2(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$3 = Object.defineProperty;
+var __defNormalProp$3 = (obj, key, value) => key in obj ? __defProp$3(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$3 = (obj, key, value) => {
+  __defNormalProp$3(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 class Task extends Emittery__default {
   constructor(client, variables, task, requestId, outputSchema, skipResultValidation = false) {
     super();
-    __publicField$2(this, "_variables");
-    __publicField$2(this, "_task");
-    __publicField$2(this, "_abortController", new AbortController());
-    __publicField$2(this, "_client");
-    __publicField$2(this, "_outputSchema");
-    __publicField$2(this, "_skipResultValidation");
-    __publicField$2(this, "_resultPromise");
-    __publicField$2(this, "_status");
-    __publicField$2(this, "_requestId");
+    __publicField$3(this, "_variables");
+    __publicField$3(this, "_task");
+    __publicField$3(this, "_abortController", new AbortController());
+    __publicField$3(this, "_client");
+    __publicField$3(this, "_outputSchema");
+    __publicField$3(this, "_skipResultValidation");
+    __publicField$3(this, "_resultPromise");
+    __publicField$3(this, "_status");
+    __publicField$3(this, "_requestId");
     this._variables = variables;
     this._task = task;
     this._client = client;
@@ -3932,10 +3977,10 @@ class Task extends Emittery__default {
   }
 }
 
-var __defProp$1 = Object.defineProperty;
-var __defNormalProp$1 = (obj, key, value) => key in obj ? __defProp$1(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$1 = (obj, key, value) => {
-  __defNormalProp$1(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$2 = Object.defineProperty;
+var __defNormalProp$2 = (obj, key, value) => key in obj ? __defProp$2(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$2 = (obj, key, value) => {
+  __defNormalProp$2(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 const DateRange = z__default.object({
@@ -3981,11 +4026,11 @@ class Workstation {
    * @internal
    */
   constructor({ client, applicationId, promptVersion, input, output }) {
-    __publicField$1(this, "_id");
-    __publicField$1(this, "_promptVersion");
-    __publicField$1(this, "_client");
-    __publicField$1(this, "_input");
-    __publicField$1(this, "_output");
+    __publicField$2(this, "_id");
+    __publicField$2(this, "_promptVersion");
+    __publicField$2(this, "_client");
+    __publicField$2(this, "_input");
+    __publicField$2(this, "_output");
     this._id = applicationId;
     this._promptVersion = promptVersion;
     this._client = client;
@@ -4676,6 +4721,154 @@ class Vault {
   }
 }
 
+var __defProp$1 = Object.defineProperty;
+var __defNormalProp$1 = (obj, key, value) => key in obj ? __defProp$1(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$1 = (obj, key, value) => {
+  __defNormalProp$1(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+const AGENT_NO_TRANSFORM = { transformCase: false };
+class Agents {
+  constructor(gateway, config) {
+    /** The delegated agent-sdk client (the `/v4/*` execution backend). */
+    __publicField$1(this, "client");
+    /** The Tela gateway client (`/agent` discovery + vault upload). */
+    __publicField$1(this, "gateway");
+    /** Memoized `agentId` → `{ organizationName, repository }` resolutions. */
+    __publicField$1(this, "resolved", /* @__PURE__ */ new Map());
+    /**
+     * Streams a session's events. Pass-through to the agent-sdk client
+     * (`GET /v4/sessions/:id`).
+     */
+    __publicField$1(this, "streamSession");
+    /**
+     * Fetches the session timeline summary. Pass-through to the agent-sdk client
+     * (`GET /v4/sessions/:id/timeline`).
+     */
+    __publicField$1(this, "fetchTimeline");
+    /**
+     * Cancels a running session. Pass-through to the agent-sdk client
+     * (`POST /v4/sessions/:id/cancel`).
+     */
+    __publicField$1(this, "cancelSession");
+    /**
+     * Resolves a `vault://` reference to bytes/stream/json. Pass-through to the
+     * agent-sdk client.
+     */
+    __publicField$1(this, "resolveReference");
+    this.gateway = gateway;
+    this.client = "client" in config ? config.client : agentSdk.agentClient({
+      baseUrl: config.agentBaseURL,
+      authStrategy: config.authStrategy,
+      vaultUrl: config.vaultURL
+    });
+    this.streamSession = this.client.streamSession;
+    this.fetchTimeline = this.client.fetchTimeline;
+    this.cancelSession = this.client.cancelSession;
+    this.resolveReference = this.client.resolveReference;
+  }
+  /**
+   * Lists the agents available in the workspace (optionally filtered by
+   * project) via the Tela gateway (`GET /agent`).
+   */
+  async list(query = {}) {
+    const response = await this.gateway.get("/agent", {
+      ...AGENT_NO_TRANSFORM,
+      query
+    });
+    return response.data;
+  }
+  /**
+   * Fetches an agent record by id via the Tela gateway (`GET /agent/:id`).
+   */
+  async get(agentId) {
+    const response = await this.gateway.get(`/agent/${agentId}`, {
+      ...AGENT_NO_TRANSFORM
+    });
+    return response.data;
+  }
+  /**
+   * Starts (or continues/recovers) an agent session, delegating to the
+   * agent-sdk client (`POST /v4/agents/execute`).
+   *
+   * - **New session**: pass `agentId` (+ `message`). It is resolved to the
+   *   underlying `organizationName`/`repository`.
+   * - **Continue / recover**: pass `sessionId` (omit `agentId`); `recover: true`
+   *   resumes without a new message.
+   *
+   * After the request shape is validated, `TelaFile` inputs are uploaded to
+   * the vault; `webhooks` pass through to register lifecycle callbacks.
+   *
+   * @throws {Error} If neither `agentId` nor `sessionId` is provided, or if
+   * both are provided.
+   */
+  async executeAgent(params) {
+    const { agentId, inputs, ...rest } = params;
+    const hasSessionId = rest.sessionId !== void 0;
+    if (hasSessionId) {
+      if (agentId)
+        throw new Error("agents.executeAgent: pass either `agentId` to start a new session or `sessionId` to continue/recover an existing session, not both.");
+      const resolvedInputs2 = inputs ? await this.uploadInputs(inputs) : void 0;
+      return this.client.executeAgent({ ...rest, inputs: resolvedInputs2 });
+    }
+    if (!agentId)
+      throw new Error("agents.executeAgent: `agentId` is required to start a new session (omit it only when continuing an existing `sessionId`).");
+    const resolvedInputs = inputs ? await this.uploadInputs(inputs) : void 0;
+    const { organizationName, repository } = await this.resolveAgent(agentId);
+    return this.client.executeAgent({ ...rest, inputs: resolvedInputs, organizationName, repository });
+  }
+  /**
+   * Updates an agent's model, delegating to the agent-sdk client
+   * (`PUT /v4/agents/:repository/model`). The `agentId` is resolved to the
+   * underlying repository first.
+   */
+  async updateAgentModel(params) {
+    const { repository } = await this.resolveAgent(params.agentId);
+    return this.client.updateAgentModel({
+      repository,
+      model: params.model,
+      commitMessage: params.commitMessage
+    });
+  }
+  /**
+   * Resolves an `agentId` to its `organizationName`/`repository`, memoizing the
+   * lookup. Backed by the Tela gateway `GET /agent/:id`.
+   */
+  async resolveAgent(agentId) {
+    const cached = this.resolved.get(agentId);
+    if (cached)
+      return cached;
+    const { organizationName, repository } = await this.get(agentId);
+    const resolution = { organizationName, repository };
+    this.resolved.set(agentId, resolution);
+    return resolution;
+  }
+  /**
+   * Uploads any {@link TelaFile} inputs to the vault, turning the input list
+   * into agent-sdk {@link AgentInput}s (`vault://` references pass through).
+   */
+  async uploadInputs(inputs) {
+    return Promise.all(
+      inputs.map(async (input) => {
+        if (isTelaFile(input)) {
+          const { fileUrl } = await uploadFile(input, this.gateway);
+          return { vaultRef: fileUrl, filename: input.name ?? "file" };
+        }
+        return input;
+      })
+    );
+  }
+}
+
+function createAuthStrategy(credentials) {
+  if (credentials.dataToken)
+    return new agentSdk.DataTokenAuthStrategy(credentials.dataToken);
+  const bearer = credentials.apiKey ?? credentials.jwt;
+  if (!bearer)
+    throw new MissingAuthError();
+  return new agentSdk.APIKeyAuthStrategy(bearer);
+}
+
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => {
@@ -4687,7 +4880,7 @@ const _TelaSDK = class _TelaSDK extends BaseClient {
   /**
    * Creates a new instance of the TelaSDK.
    */
-  constructor({ baseURL = baseUrl, apiKey, jwt, dataToken, ...rest }) {
+  constructor({ baseURL = baseUrl, apiKey, jwt, dataToken, agentBaseURL, vaultURL, ...rest }) {
     super({ baseURL, ...rest });
     __publicField(this, "opts");
     __publicField(this, "apiKey");
@@ -4762,6 +4955,22 @@ const _TelaSDK = class _TelaSDK extends BaseClient {
      * ```
      */
     __publicField(this, "vault", new Vault(this));
+    /**
+     * Agents API resource — a thin pass-through wrapper around
+     * `@meistrari/agent-sdk`. Execute by `agentId`, then stream events, fetch the
+     * timeline, or cancel by `sessionId`.
+     *
+     * @example
+     * ```typescript
+     * const { sessionId } = await tela.agents.executeAgent({
+     *   agentId: 'agent-id',
+     *   message: 'Hello',
+     * })
+     * for await (const event of await tela.agents.streamSession(sessionId))
+     *   console.log(event.kind)
+     * ```
+     */
+    __publicField(this, "agents");
     __publicField(this, "workstation", {
       get: async (options) => {
         return Workstation.get({
@@ -4778,6 +4987,11 @@ const _TelaSDK = class _TelaSDK extends BaseClient {
     this.jwt = jwt;
     this.dataToken = dataToken;
     this.validateAuth();
+    this.agents = new Agents(this, {
+      agentBaseURL: agentBaseURL ?? baseURL,
+      vaultURL: vaultURL ?? `${baseURL}/_services/vault`,
+      authStrategy: createAuthStrategy({ apiKey, jwt, dataToken })
+    });
   }
   get authToken() {
     return this.apiKey || this.jwt || this.dataToken;
@@ -4853,12 +5067,18 @@ __publicField(_TelaSDK, "ConflictApiKeyAndJWTError", ConflictApiKeyAndJWTError);
 __publicField(_TelaSDK, "ExecutionFailedError", ExecutionFailedError);
 /** Thrown when a workstation task fails on the server. */
 __publicField(_TelaSDK, "TaskFailedError", TaskFailedError);
+/** Thrown when an agent session fails on the server. */
+__publicField(_TelaSDK, "AgentExecutionFailedError", AgentExecutionFailedError);
 let TelaSDK = _TelaSDK;
 function createTelaClient(opts) {
   return new TelaSDK(opts);
 }
 
+exports.parseSessionStream = agentSdk.parseSessionStream;
+exports.verifyWebhookSignature = agentSdk.verifyWebhookSignature;
 exports.APIError = APIError;
+exports.AgentExecutionFailedError = AgentExecutionFailedError;
+exports.Agents = Agents;
 exports.AuthenticationError = AuthenticationError;
 exports.AuthorizationError = AuthorizationError;
 exports.BadRequestError = BadRequestError;