notte-sdk 0.0.20 → 0.0.22

package/dist/index.mjs

@@ -6,7 +6,7 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 });
 
 // src/version.ts
-var SDK_VERSION = true ? "0.0.20" : "dev";
+var SDK_VERSION = true ? "0.0.22" : "dev";
 var SDK_PACKAGE_NAME = true ? "notte-sdk" : "notte-sdk";
 
 // src/version-check.ts
@@ -1014,6 +1014,31 @@ var sessionReplay = (options) => (options.client ?? client).get({
   url: "/sessions/{session_id}/replay",
   ...options
 });
+var listSessionFiles = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/sessions/{session_id}/files",
+  ...options
+});
+var uploadSessionFile = (options) => (options.client ?? client).post({
+  ...formDataBodySerializer,
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/sessions/{session_id}/files",
+  ...options,
+  headers: {
+    "Content-Type": null,
+    ...options.headers
+  }
+});
+var deleteSessionFile = (options) => (options.client ?? client).delete({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/sessions/{session_id}/files/{file_id}",
+  ...options
+});
+var downloadSessionFile = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/sessions/{session_id}/files/{file_id}",
+  ...options
+});
 var agentStart = (options) => (options.client ?? client).post({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/agents/start",
@@ -1043,6 +1068,11 @@ var listAgents = (options) => (options?.client ?? client).get({
   url: "/agents",
   ...options
 });
+var functionRuntimeHealth = (options) => (options?.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/functions/health",
+  ...options
+});
 var listFunctions = (options) => (options?.client ?? client).get({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/functions",
@@ -1092,6 +1122,15 @@ var functionFork = (options) => (options.client ?? client).post({
   url: "/functions/{function_id}/fork",
   ...options
 });
+var functionRollback = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/functions/{function_id}/rollback",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
 var functionScheduleDelete = (options) => (options.client ?? client).delete({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/functions/{function_id}/schedule",
@@ -1342,70 +1381,66 @@ var mailboxUpdate = (options) => (options.client ?? client).patch({
     ...options.headers
   }
 });
-var improvePrompt = (options) => (options.client ?? client).post({
-  url: "/prompts/improve",
+var managedAuthConnectLinkCreate = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/managed-auth/connect-links",
   ...options,
   headers: {
     "Content-Type": "application/json",
     ...options.headers
   }
 });
-var nudgePrompt = (options) => (options.client ?? client).post({
-  url: "/prompts/nudge",
+var connectLinkContext = (options) => (options.client ?? client).post({ url: "/managed-auth/connect-links/context", ...options });
+var connectLinkMailboxes = (options) => (options.client ?? client).post({ url: "/managed-auth/connect-links/mailboxes", ...options });
+var connectLinkMailboxConnect = (options) => (options.client ?? client).post({
+  url: "/managed-auth/connect-links/mailboxes/connect",
   ...options,
   headers: {
     "Content-Type": "application/json",
     ...options.headers
   }
 });
-var getUsage = (options) => (options?.client ?? client).get({
-  security: [{ scheme: "bearer", type: "http" }],
-  url: "/usage",
-  ...options
-});
-var getUsageLogs = (options) => (options?.client ?? client).get({
-  security: [{ scheme: "bearer", type: "http" }],
-  url: "/usage/logs",
-  ...options
-});
-var fileDownload = (options) => (options.client ?? client).get({
-  security: [{ scheme: "bearer", type: "http" }],
-  url: "/storage/{session_id}/downloads/{filename}",
-  ...options
-});
-var fileUploadDownloadedFile = (options) => (options.client ?? client).post({
-  ...formDataBodySerializer,
-  security: [{ scheme: "bearer", type: "http" }],
-  url: "/storage/{session_id}/downloads/{filename}",
+var connectLinkMailboxSync = (options) => (options.client ?? client).post({
+  url: "/managed-auth/connect-links/mailboxes/sync",
   ...options,
   headers: {
-    "Content-Type": null,
+    "Content-Type": "application/json",
     ...options.headers
   }
 });
-var fileListDownloads = (options) => (options.client ?? client).get({
-  security: [{ scheme: "bearer", type: "http" }],
-  url: "/storage/{session_id}/downloads",
-  ...options
+var connectLinkSubmit = (options) => (options.client ?? client).post({
+  url: "/managed-auth/connect-links/submit",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
 });
-var fileDownloadUploadedFile = (options) => (options.client ?? client).get({
-  security: [{ scheme: "bearer", type: "http" }],
-  url: "/storage/uploads/{filename}",
-  ...options
+var connectLinkStatus = (options) => (options.client ?? client).get({ url: "/managed-auth/connect-links/status", ...options });
+var improvePrompt = (options) => (options.client ?? client).post({
+  url: "/prompts/improve",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
 });
-var fileUpload = (options) => (options.client ?? client).post({
-  ...formDataBodySerializer,
-  security: [{ scheme: "bearer", type: "http" }],
-  url: "/storage/uploads/{filename}",
+var nudgePrompt = (options) => (options.client ?? client).post({
+  url: "/prompts/nudge",
   ...options,
   headers: {
-    "Content-Type": null,
+    "Content-Type": "application/json",
     ...options.headers
   }
 });
-var fileListUploads = (options) => (options?.client ?? client).get({
+var getUsage = (options) => (options?.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/usage",
+  ...options
+});
+var getUsageLogs = (options) => (options?.client ?? client).get({
   security: [{ scheme: "bearer", type: "http" }],
-  url: "/storage/uploads",
+  url: "/usage/logs",
   ...options
 });
 var anythingStart = (options) => (options.client ?? client).post({
@@ -1441,6 +1476,15 @@ var deleteSecret = (options) => (options.client ?? client).delete({
   url: "/secrets/{secret_id}",
   ...options
 });
+var mintProxyCredentials = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/proxies/gateway/credentials",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
 var healthCheck = (options) => (options?.client ?? client).get({ url: "/health", ...options });
 var readyCheck = (options) => (options?.client ?? client).get({ url: "/ready", ...options });
 var scrapeWebpage = (options) => (options.client ?? client).post({
@@ -2642,6 +2686,18 @@ var NottePersona = class {
     }
     return this.response.persona_id;
   }
+  /**
+   * Public, human-readable email address of the persona
+   */
+  get email() {
+    return this.info.email;
+  }
+  /**
+   * Internal UUID-backed mailbox address of the persona
+   */
+  get internalEmail() {
+    return this.info.internal_email;
+  }
   /**
    * Start the persona - ensures initialization
    */
@@ -2857,10 +2913,52 @@ var NotteFunction = class {
       throw new Error(`Failed to get function run metadata: ${error instanceof Error ? error.message : String(error)}`);
     }
   }
+  /**
+   * List the runs of this function.
+   *
+   * `only_active` is sent as `false` unless the caller says otherwise, and that
+   * is deliberate rather than redundant. `GET /functions/{function_id}/runs`
+   * now defaults it to `false` server-side as well, but it used to default to
+   * `true`: the request model was a bare subclass of the session one, where
+   * "only active" reads sensibly as "list my running sessions" and, for "list
+   * this function's runs", was a trap. Hitting the endpoint with no query
+   * parameters returned only the runs executing right now - an empty list for
+   * any function that had finished. That cost us a bug in the anything-api
+   * console, where a function with 15 recorded runs displayed "Nothing has run
+   * this endpoint yet".
+   *
+   * Sending it explicitly pins this method to the documented behaviour against
+   * whichever API version it is talking to, including deployments that predate
+   * the server-side change. Callers who want only in-flight runs pass
+   * `only_active: true`.
+   */
+  async runs(options = {}) {
+    try {
+      const response = await listFunctionRunsByFunctionId({
+        client: this.client.getClient(),
+        path: {
+          function_id: this.functionId
+        },
+        query: {
+          ...options,
+          only_active: options.only_active ?? false
+        }
+      });
+      if (response?.error) {
+        throw new Error(`Failed to list function runs: ${formatError(response.error)}`);
+      }
+      return response.data;
+    } catch (error) {
+      if (error instanceof Error && error.message.startsWith("Failed to list function runs:")) {
+        throw error;
+      }
+      throw new Error(`Failed to list function runs: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
   /**
    * Start a function run
    */
-  async run(variables = {}) {
+  async run(variables = {}, options = {}) {
     const apiKey = this.client.getConfig().apiKey || "";
     if (!apiKey) {
       throw new Error("API key is required. Provide it via config.apiKey or set the NOTTE_API_KEY environment variable.");
@@ -2879,7 +2977,8 @@ var NotteFunction = class {
         body: {
           workflow_id: this.functionId,
           variables,
-          stream: false
+          stream: false,
+          ...options.runtime ? { runtime: options.runtime } : {}
         }
       });
       if (response?.error) {
@@ -2972,6 +3071,53 @@ function isHttpUrl(value) {
 
 // src/client.ts
 import { z as z3 } from "zod";
+
+// src/files.ts
+var SessionFiles = class {
+  constructor(client2, sessionId) {
+    this.client = client2;
+    this.sessionId = sessionId;
+  }
+  path(fileId) {
+    const root = `/sessions/${encodeURIComponent(this.sessionId)}/files`;
+    return fileId ? `${root}/${encodeURIComponent(fileId)}` : root;
+  }
+  async upload(file, filename = "file") {
+    const body = new FormData();
+    body.append("file", file, filename);
+    const result = await this.client.request({
+      method: "POST",
+      url: this.path(),
+      body
+    });
+    if (result.error || !result.data) throw new Error("Failed to upload session file");
+    return result.data;
+  }
+  async list(options = {}) {
+    const result = await this.client.request({
+      method: "GET",
+      url: this.path(),
+      query: { limit: options.limit ?? 100, offset: options.offset ?? 0, source: options.source }
+    });
+    if (result.error || !result.data) throw new Error("Failed to list session files");
+    return result.data;
+  }
+  async download(fileId) {
+    const result = await this.client.request({
+      method: "GET",
+      url: this.path(fileId),
+      parseAs: "blob"
+    });
+    if (result.error || !result.data) throw new Error(`Failed to download session file ${fileId}`);
+    return result.data;
+  }
+  async delete(fileId) {
+    const result = await this.client.request({ method: "DELETE", url: this.path(fileId) });
+    if (result.error) throw new Error(`Failed to delete session file ${fileId}`);
+  }
+};
+
+// src/client.ts
 var NotteClient = class {
   constructor(config = {}) {
     const apiKey = config.apiKey || process.env.NOTTE_API_KEY;
@@ -3028,6 +3174,10 @@ var NotteClient = class {
   Session(options = {}) {
     return new Session(this, options);
   }
+  /** Access files owned by a specific session, including closed sessions. */
+  Files(sessionId) {
+    return new SessionFiles(this.getClient(), sessionId);
+  }
   /**
    * Create a new agent
    */
@@ -3148,29 +3298,34 @@ export {
   NotteProxyAuthError,
   NotteVault,
   Session,
+  SessionFiles,
   agentStart,
   agentStatus,
   agentStop,
   anythingStart,
   client,
+  connectLinkContext,
+  connectLinkMailboxConnect,
+  connectLinkMailboxSync,
+  connectLinkMailboxes,
+  connectLinkStatus,
+  connectLinkSubmit,
   createClient2 as createClient,
   NotteClient as default,
   deleteSecret,
-  fileDownload,
-  fileDownloadUploadedFile,
-  fileListDownloads,
-  fileListUploads,
-  fileUpload,
-  fileUploadDownloadedFile,
+  deleteSessionFile,
+  downloadSessionFile,
   functionCreate,
   functionDelete,
   functionDownloadUrl,
   functionFork,
   functionMetadataUpdate,
+  functionRollback,
   functionRunGetMetadata,
   functionRunStart,
   functionRunStop,
   functionRunUpdateMetadata,
+  functionRuntimeHealth,
   functionScheduleDelete,
   functionScheduleSet,
   functionUpdate,
@@ -3186,6 +3341,7 @@ export {
   listFunctions,
   listPersonas,
   listSecrets,
+  listSessionFiles,
   listSessions,
   listVaults,
   mailboxConnectToken,
@@ -3194,6 +3350,8 @@ export {
   mailboxList,
   mailboxSync,
   mailboxUpdate,
+  managedAuthConnectLinkCreate,
+  mintProxyCredentials,
   nudgePrompt,
   pageExecute,
   pageObserve,
@@ -3226,6 +3384,7 @@ export {
   sessionStatus,
   sessionStop,
   storeSecret,
+  uploadSessionFile,
   vaultCreate,
   vaultCredentialsAdd,
   vaultCredentialsDelete,