notte-sdk 1.10.1 → 1.10.3

package/dist/index.js

@@ -107,6 +107,7 @@ __export(index_exports, {
   executeSessionFile: () => executeSessionFile,
   extractProductEndpoint: () => extractProductEndpoint,
   fetchSpecializedData: () => fetchSpecializedData,
+  functionConditionalRollback: () => functionConditionalRollback,
   functionCreate: () => functionCreate,
   functionDelete: () => functionDelete,
   functionDownloadUrl: () => functionDownloadUrl,
@@ -120,6 +121,11 @@ __export(index_exports, {
   functionRuntimeHealth: () => functionRuntimeHealth,
   functionScheduleDelete: () => functionScheduleDelete,
   functionScheduleSet: () => functionScheduleSet,
+  functionSchedulesAdd: () => functionSchedulesAdd,
+  functionSchedulesList: () => functionSchedulesList,
+  functionSchedulesRemove: () => functionSchedulesRemove,
+  functionSchedulesResume: () => functionSchedulesResume,
+  functionSchedulesUpdate: () => functionSchedulesUpdate,
   functionUpdate: () => functionUpdate,
   getPayment: () => getPayment,
   getPolicy: () => getPolicy,
@@ -232,7 +238,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/version.ts
-var SDK_VERSION = true ? "1.10.1" : "dev";
+var SDK_VERSION = true ? "1.10.3" : "dev";
 var SDK_PACKAGE_NAME = true ? "notte-sdk" : "notte-sdk";
 
 // src/version-check.ts
@@ -1381,6 +1387,15 @@ var functionRollback = (options) => (options.client ?? client).post({
     ...options.headers
   }
 });
+var functionConditionalRollback = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/functions/{function_id}/rollback/conditional",
+  ...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",
@@ -1395,6 +1410,39 @@ var functionScheduleSet = (options) => (options.client ?? client).post({
     ...options.headers
   }
 });
+var functionSchedulesList = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/functions/{function_id}/schedules",
+  ...options
+});
+var functionSchedulesAdd = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/functions/{function_id}/schedules",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
+var functionSchedulesResume = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/functions/{function_id}/schedules/resume",
+  ...options
+});
+var functionSchedulesRemove = (options) => (options.client ?? client).delete({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/functions/{function_id}/schedules/{schedule_id}",
+  ...options
+});
+var functionSchedulesUpdate = (options) => (options.client ?? client).patch({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/functions/{function_id}/schedules/{schedule_id}",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
 var functionRunStart = (options) => (options.client ?? client).post({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/functions/{function_id}/runs/start",
@@ -2455,6 +2503,11 @@ function createResources(client2, getApiKey) {
       }
     },
     functions: {
+      /** functionSchedulesAdd: /functions/{function_id}/schedules. Returns the API response body. */
+      addSchedule: async (functionId, body, requestOptions = {}) => {
+        const response = await functionSchedulesAdd({ client: client2, throwOnError: true, signal: requestOptions.signal, headers: { ...requestOptions.headers }, path: { "function_id": functionId }, body });
+        return response.data;
+      },
       /** functionCreate: /functions. Returns the API response body. */
       create: async (body, query = void 0, requestOptions = {}) => {
         const response = await functionCreate({ client: client2, throwOnError: true, signal: requestOptions.signal, headers: { ...requestOptions.headers }, body, query });
@@ -2495,6 +2548,11 @@ function createResources(client2, getApiKey) {
         const response = await listFunctionRunsByFunctionId({ client: client2, throwOnError: true, signal: requestOptions.signal, headers: { ...requestOptions.headers }, path: { "function_id": functionId }, query });
         return response.data;
       },
+      /** functionSchedulesList: /functions/{function_id}/schedules. Returns the API response body. */
+      listSchedules: async (functionId, requestOptions = {}) => {
+        const response = await functionSchedulesList({ client: client2, throwOnError: true, signal: requestOptions.signal, headers: { ...requestOptions.headers }, path: { "function_id": functionId } });
+        return response.data;
+      },
       /** functionMetadataUpdate: /functions/{function_id}. Returns the API response body. */
       metadataUpdate: async (functionId, body, requestOptions = {}) => {
         const response = await functionMetadataUpdate({ client: client2, throwOnError: true, signal: requestOptions.signal, headers: { ...requestOptions.headers }, path: { "function_id": functionId }, body });
@@ -2505,6 +2563,16 @@ function createResources(client2, getApiKey) {
         const response = await prepareRunPayloadUpload({ client: client2, throwOnError: true, signal: requestOptions.signal, headers: { ...requestOptions.headers }, path: { "function_id": functionId, "run_id": runId, "field": field }, body });
         return response.data;
       },
+      /** functionSchedulesRemove: /functions/{function_id}/schedules/{schedule_id}. Returns the API response body. */
+      removeSchedule: async (functionId, scheduleId, requestOptions = {}) => {
+        const response = await functionSchedulesRemove({ client: client2, throwOnError: true, signal: requestOptions.signal, headers: { ...requestOptions.headers }, path: { "function_id": functionId, "schedule_id": scheduleId } });
+        return response.data;
+      },
+      /** functionSchedulesResume: /functions/{function_id}/schedules/resume. Returns the API response body. */
+      resumeSchedules: async (functionId, requestOptions = {}) => {
+        const response = await functionSchedulesResume({ client: client2, throwOnError: true, signal: requestOptions.signal, headers: { ...requestOptions.headers }, path: { "function_id": functionId } });
+        return response.data;
+      },
       /** functionRollback: /functions/{function_id}/rollback. Returns the API response body. */
       rollback: async (functionId, body, query = void 0, requestOptions = {}) => {
         const response = await functionRollback({ client: client2, throwOnError: true, signal: requestOptions.signal, headers: { ...requestOptions.headers }, path: { "function_id": functionId }, body, query });
@@ -2544,6 +2612,11 @@ function createResources(client2, getApiKey) {
       update: async (functionId, body, query = void 0, requestOptions = {}) => {
         const response = await functionUpdate({ client: client2, throwOnError: true, signal: requestOptions.signal, headers: { ...requestOptions.headers }, path: { "function_id": functionId }, body, query });
         return response.data;
+      },
+      /** functionSchedulesUpdate: /functions/{function_id}/schedules/{schedule_id}. Returns the API response body. */
+      updateSchedule: async (functionId, scheduleId, body, requestOptions = {}) => {
+        const response = await functionSchedulesUpdate({ client: client2, throwOnError: true, signal: requestOptions.signal, headers: { ...requestOptions.headers }, path: { "function_id": functionId, "schedule_id": scheduleId }, body });
+        return response.data;
       }
     },
     personas: {
@@ -3364,7 +3437,7 @@ var CLUSTER_OVERLOAD_RETRY_DELAY_MS = 3e4;
 var CAPTCHA_SOLVE_TIMEOUT_MS = 1e5;
 var OBSERVE_MIGRATION_URL = "https://docs.notte.cc/features/sessions/observe-migration";
 var OBSERVE_DEPRECATIONS = {
-  instructions: `\`observe({ instructions })\` is deprecated and will be removed on December 1, 2026; <<ALTERNATIVE FOR instructions: session.act() \u2014 pending>>. See ${OBSERVE_MIGRATION_URL}`,
+  instructions: `\`observe({ instructions })\` is deprecated and will be removed on December 1, 2026; the Python SDK's local sessions replace it with session.act(); here, call observe() without it and pick from the returned actions. See ${OBSERVE_MIGRATION_URL}`,
   deep: `\`perception_type: 'deep'\` is deprecated and will be removed on December 1, 2026; use \`perception_type: 'fast'\` (the default). See ${OBSERVE_MIGRATION_URL}`
 };
 function observeServerOwnedDialog(_dialog) {
@@ -4080,7 +4153,9 @@ var Session = class {
    * Deprecated: `perception_type: 'deep'` and `instructions` are removed on
    * December 1, 2026, and each warns once per session. Use `perception_type:
    * 'fast'` (the default) instead of `'deep'`. For `instructions`:
-   * `<<ALTERNATIVE FOR instructions: session.act() — pending>>`. See https://docs.notte.cc/features/sessions/observe-migration
+   * the Python SDK's local sessions replace it with `session.act()`; here, call
+   * `observe()` without it and pick from the returned actions. See
+   * https://docs.notte.cc/features/sessions/observe-migration
    *
    * @param options - Observation settings, including an optional URL, or a perception-mode string.
    * @returns Structured page analysis, available actions, and page metadata.
@@ -5184,19 +5259,22 @@ var NotteFunction = class {
    * before execution, then pass it to `run(variables, { functionRunId })`.
    * `run()` otherwise creates a new run on its own.
    *
-   * @param options - Run-record settings; `local` defaults to false. Node execution remains cloud-only.
+   * @param options - Run-record settings; `local` defaults to false. Node execution remains cloud-only. `version` pins a saved version; omitted means the latest.
    * @returns A created run record and its ID. No function code has executed yet.
    * @throws NotteAPIError if run creation is rejected.
    * @example
    * const created = await fn.createRun();
    * const result = await fn.run({ url: 'https://example.com' }, { functionRunId: created.function_run_id });
+   *
+   * const { versions } = await fn.get();
+   * const pinned = await fn.createRun({ version: versions[0] });
    */
   async createRun(options = {}) {
     const functionId = await this.ensureInitialized();
     return this.postRunEndpoint({
       url: FUNCTION_RUN_ENDPOINTS.create,
       path: { function_id: functionId },
-      body: { local: options.local ?? false }
+      body: { local: options.local ?? false, ...options.version !== void 0 ? { version: options.version } : {} }
     });
   }
   /**
@@ -5229,12 +5307,13 @@ var NotteFunction = class {
    * Pass `{ stream: false }` to receive the backend's JSON response without
    * live logs; execution still blocks until completion. Pass `functionRunId`
    * to execute a record returned by `createRun()`; otherwise a new run record
-   * is created first, exactly like Python. A failed execution throws
+   * is created first, exactly like Python. Pass `version` to run a saved
+   * version instead of the latest one. A failed execution throws
    * `FailedToRunCloudFunctionError` unless `raiseOnFailure` is false, and the
    * wait is aborted with `NotteTimeoutError` after `timeoutMs`.
    *
    * @param variables - JSON-serializable keyword arguments passed to the Python function's `run` entry point.
-   * @param options - Log streaming, failure handling, runtime, run ID, and timeout settings.
+   * @param options - Log streaming, failure handling, runtime, run ID, version, and timeout settings.
    * @returns The completed execution response. The function's return value is in `result`. Disabling streaming still waits for completion.
    * @throws FailedToRunCloudFunctionError if execution fails and `raiseOnFailure` is true.
    * @throws NotteTimeoutError if the execution request exceeds `timeoutMs`.
@@ -5243,6 +5322,9 @@ var NotteFunction = class {
    * const result = await fn.run({ url: 'https://example.com' });
    * console.log(result.result);
    *
+   * const { versions } = await fn.get();
+   * await fn.run({ url: 'https://example.com' }, { version: versions[0] });
+   *
    * await fn.run({ url: 'https://example.com' }, { runtime: 'extended', onLog: line => logger.info(line) });
    */
   async run(variables = {}, options = {}) {
@@ -5251,8 +5333,11 @@ var NotteFunction = class {
     if (!(timeoutMs > 0)) {
       throw new InvalidRequestError("timeoutMs must be a positive number");
     }
+    if (options.version !== void 0 && options.functionRunId !== void 0) {
+      throw new InvalidRequestError("Pass version to createRun({ version }) instead; a run's version is set when it is created");
+    }
     const functionId = await this.ensureInitialized();
-    const functionRunId = options.functionRunId ?? (await this.createRun()).function_run_id;
+    const functionRunId = options.functionRunId ?? (await this.createRun({ version: options.version })).function_run_id;
     const body = {
       workflow_id: functionId,
       variables,
@@ -6600,6 +6685,7 @@ var createClient2 = (config) => {
   executeSessionFile,
   extractProductEndpoint,
   fetchSpecializedData,
+  functionConditionalRollback,
   functionCreate,
   functionDelete,
   functionDownloadUrl,
@@ -6613,6 +6699,11 @@ var createClient2 = (config) => {
   functionRuntimeHealth,
   functionScheduleDelete,
   functionScheduleSet,
+  functionSchedulesAdd,
+  functionSchedulesList,
+  functionSchedulesRemove,
+  functionSchedulesResume,
+  functionSchedulesUpdate,
   functionUpdate,
   getPayment,
   getPolicy,