notte-sdk 1.10.1 → 1.10.3

package/dist/index.mjs

@@ -1,5 +1,5 @@
 // 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
@@ -1148,6 +1148,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",
@@ -1162,6 +1171,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",
@@ -2222,6 +2264,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 });
@@ -2262,6 +2309,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 });
@@ -2272,6 +2324,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 });
@@ -2311,6 +2373,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: {
@@ -3131,7 +3198,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) {
@@ -3847,7 +3914,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.
@@ -4951,19 +5020,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 } : {} }
     });
   }
   /**
@@ -4996,12 +5068,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`.
@@ -5010,6 +5083,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 = {}) {
@@ -5018,8 +5094,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,
@@ -6367,6 +6446,7 @@ export {
   executeSessionFile,
   extractProductEndpoint,
   fetchSpecializedData,
+  functionConditionalRollback,
   functionCreate,
   functionDelete,
   functionDownloadUrl,
@@ -6380,6 +6460,11 @@ export {
   functionRuntimeHealth,
   functionScheduleDelete,
   functionScheduleSet,
+  functionSchedulesAdd,
+  functionSchedulesList,
+  functionSchedulesRemove,
+  functionSchedulesResume,
+  functionSchedulesUpdate,
   functionUpdate,
   getPayment,
   getPolicy,