notte-sdk 0.0.20 → 0.0.22

package/dist/index.js

@@ -38,29 +38,34 @@ __export(index_exports, {
   NotteProxyAuthError: () => NotteProxyAuthError,
   NotteVault: () => NotteVault,
   Session: () => Session,
+  SessionFiles: () => SessionFiles,
   agentStart: () => agentStart,
   agentStatus: () => agentStatus,
   agentStop: () => agentStop,
   anythingStart: () => anythingStart,
   client: () => client,
+  connectLinkContext: () => connectLinkContext,
+  connectLinkMailboxConnect: () => connectLinkMailboxConnect,
+  connectLinkMailboxSync: () => connectLinkMailboxSync,
+  connectLinkMailboxes: () => connectLinkMailboxes,
+  connectLinkStatus: () => connectLinkStatus,
+  connectLinkSubmit: () => connectLinkSubmit,
   createClient: () => createClient2,
   default: () => NotteClient,
   deleteSecret: () => deleteSecret,
-  fileDownload: () => fileDownload,
-  fileDownloadUploadedFile: () => fileDownloadUploadedFile,
-  fileListDownloads: () => fileListDownloads,
-  fileListUploads: () => fileListUploads,
-  fileUpload: () => fileUpload,
-  fileUploadDownloadedFile: () => fileUploadDownloadedFile,
+  deleteSessionFile: () => deleteSessionFile,
+  downloadSessionFile: () => downloadSessionFile,
   functionCreate: () => functionCreate,
   functionDelete: () => functionDelete,
   functionDownloadUrl: () => functionDownloadUrl,
   functionFork: () => functionFork,
   functionMetadataUpdate: () => functionMetadataUpdate,
+  functionRollback: () => functionRollback,
   functionRunGetMetadata: () => functionRunGetMetadata,
   functionRunStart: () => functionRunStart,
   functionRunStop: () => functionRunStop,
   functionRunUpdateMetadata: () => functionRunUpdateMetadata,
+  functionRuntimeHealth: () => functionRuntimeHealth,
   functionScheduleDelete: () => functionScheduleDelete,
   functionScheduleSet: () => functionScheduleSet,
   functionUpdate: () => functionUpdate,
@@ -76,6 +81,7 @@ __export(index_exports, {
   listFunctions: () => listFunctions,
   listPersonas: () => listPersonas,
   listSecrets: () => listSecrets,
+  listSessionFiles: () => listSessionFiles,
   listSessions: () => listSessions,
   listVaults: () => listVaults,
   mailboxConnectToken: () => mailboxConnectToken,
@@ -84,6 +90,8 @@ __export(index_exports, {
   mailboxList: () => mailboxList,
   mailboxSync: () => mailboxSync,
   mailboxUpdate: () => mailboxUpdate,
+  managedAuthConnectLinkCreate: () => managedAuthConnectLinkCreate,
+  mintProxyCredentials: () => mintProxyCredentials,
   nudgePrompt: () => nudgePrompt,
   pageExecute: () => pageExecute,
   pageObserve: () => pageObserve,
@@ -116,6 +124,7 @@ __export(index_exports, {
   sessionStatus: () => sessionStatus,
   sessionStop: () => sessionStop,
   storeSecret: () => storeSecret,
+  uploadSessionFile: () => uploadSessionFile,
   vaultCreate: () => vaultCreate,
   vaultCredentialsAdd: () => vaultCredentialsAdd,
   vaultCredentialsDelete: () => vaultCredentialsDelete,
@@ -130,7 +139,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // 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
@@ -1138,6 +1147,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",
@@ -1167,6 +1201,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",
@@ -1216,6 +1255,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",
@@ -1466,70 +1514,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({
@@ -1565,6 +1609,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({
@@ -2766,6 +2819,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
    */
@@ -2981,10 +3046,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.");
@@ -3003,7 +3110,8 @@ var NotteFunction = class {
         body: {
           workflow_id: this.functionId,
           variables,
-          stream: false
+          stream: false,
+          ...options.runtime ? { runtime: options.runtime } : {}
         }
       });
       if (response?.error) {
@@ -3096,6 +3204,53 @@ function isHttpUrl(value) {
 
 // src/client.ts
 var import_zod3 = require("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;
@@ -3152,6 +3307,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
    */
@@ -3273,28 +3432,33 @@ var createClient2 = (config) => {
   NotteProxyAuthError,
   NotteVault,
   Session,
+  SessionFiles,
   agentStart,
   agentStatus,
   agentStop,
   anythingStart,
   client,
+  connectLinkContext,
+  connectLinkMailboxConnect,
+  connectLinkMailboxSync,
+  connectLinkMailboxes,
+  connectLinkStatus,
+  connectLinkSubmit,
   createClient,
   deleteSecret,
-  fileDownload,
-  fileDownloadUploadedFile,
-  fileListDownloads,
-  fileListUploads,
-  fileUpload,
-  fileUploadDownloadedFile,
+  deleteSessionFile,
+  downloadSessionFile,
   functionCreate,
   functionDelete,
   functionDownloadUrl,
   functionFork,
   functionMetadataUpdate,
+  functionRollback,
   functionRunGetMetadata,
   functionRunStart,
   functionRunStop,
   functionRunUpdateMetadata,
+  functionRuntimeHealth,
   functionScheduleDelete,
   functionScheduleSet,
   functionUpdate,
@@ -3310,6 +3474,7 @@ var createClient2 = (config) => {
   listFunctions,
   listPersonas,
   listSecrets,
+  listSessionFiles,
   listSessions,
   listVaults,
   mailboxConnectToken,
@@ -3318,6 +3483,8 @@ var createClient2 = (config) => {
   mailboxList,
   mailboxSync,
   mailboxUpdate,
+  managedAuthConnectLinkCreate,
+  mintProxyCredentials,
   nudgePrompt,
   pageExecute,
   pageObserve,
@@ -3350,6 +3517,7 @@ var createClient2 = (config) => {
   sessionStatus,
   sessionStop,
   storeSecret,
+  uploadSessionFile,
   vaultCreate,
   vaultCredentialsAdd,
   vaultCredentialsDelete,