@celigo/api-specs 0.2.71 → 0.2.72

package/dist/script.yml

@@ -361,10 +361,22 @@ paths:
   /v1/scripts/{_id}/logs:
     get:
       x-internal: false
-      summary: Get debug logs for a script
+      summary: Get execution logs for a script
       description: |-
-        Returns console output captured while debug is enabled on the script
-        (`debugUntil` set to a future timestamp).
+        Returns the script's execution log — the entries its `console.*` calls wrote during
+        real runs of the flows, APIs and Tools whose steps use the script. `console.log`,
+        `console.info`, `console.warn` and `console.error` output is recorded on every real
+        run regardless of the parent's logging mode (a flow's log level, an API's request
+        logging, a Tool invoke without `x-log-mode`); `console.debug` output is recorded only
+        while the script's `debugUntil` is in the future. Entries stay readable after a debug window closes. Test runs
+        execute the script but write no entries.
+
+        The window is read from `time_lte` downward, one time slice at a time, and each
+        call returns one slice. A response with an empty `logs` array **and** a
+        `nextPageURL` means that slice held nothing while the rest of the window is still
+        unread — follow the cursor until a response arrives without one. Only an empty
+        `logs` array with no `nextPageURL` means the window holds no entries. To read a
+        known run in one call, set `time_lte` a few seconds after the run ended.
       tags:
         - Scripts
       operationId: getScriptLogs
@@ -377,9 +389,47 @@ paths:
             type: string
             format: objectId
             x-celigo-refModel: scripts
+        - name: time_lte
+          in: query
+          required: false
+          description: |-
+            Upper bound of the time window (inclusive), as epoch milliseconds. Defaults to now if
+            omitted. Reading starts here and proceeds backward.
+          schema:
+            type: integer
+            format: int64
+        - name: time_gt
+          in: query
+          required: false
+          description: Lower bound of the time window (exclusive), as epoch milliseconds.
+          schema:
+            type: integer
+            format: int64
+        - name: _flowId
+          in: query
+          required: false
+          description: |-
+            Restricts entries to hooks that ran inside this parent. Despite the name it matches
+            the containing flow, API, or Tool alike — pass whichever the hook step lives in.
+          schema:
+            type: string
+            format: objectId
+        - name: _resourceId
+          in: query
+          required: false
+          description: Restricts entries to hooks that ran on this export or import step.
+          schema:
+            type: string
+            format: objectId
+        - name: functionType
+          in: query
+          required: false
+          description: Restricts entries to one hook type (for example `preMap` or `postResponseMap`).
+          schema:
+            type: string
       responses:
         '200':
-          description: Log entries for the script.
+          description: One slice of the script's execution log.
           content:
             application/json:
               schema:
@@ -387,18 +437,20 @@ paths:
                 properties:
                   logs:
                     type: array
-                    description: Debug log entries. Empty array when no logs exist or debug is not enabled.
+                    description: |-
+                      Entries from the slice that was read, newest first. Empty when the slice held
+                      nothing — check `nextPageURL` before treating that as an empty window.
                     items:
                       type: object
                       properties:
                         time:
                           type: string
-                          description: Timestamp when the log was captured.
+                          description: UTC timestamp when the entry was written.
                           examples:
                             - '2026-05-22 01:24:38.697'
                         functionType:
                           type: string
-                          description: Hook type that produced the log.
+                          description: Hook type that produced the entry.
                           examples:
                             - preSavePage
                         _resourceId:
@@ -409,23 +461,33 @@ paths:
                             - 6843b67b35b64c0bcba2fd69
                         logLevel:
                           type: string
-                          description: Severity level of the log entry.
+                          description: Severity of the entry, derived from the `console` method that wrote it.
                           enum:
                             - INFO
                             - WARN
                             - ERROR
+                            - DEBUG
                           x-enumDescriptions:
-                            INFO: Output from `console.log()`.
-                            WARN: Output from `console.warn()`.
-                            ERROR: Output from `console.error()`.
+                            INFO: Output from `console.log()` or `console.info()`
+                            WARN: Output from `console.warn()`
+                            ERROR: Output from `console.error()`
+                            DEBUG: Output from `console.debug()`, recorded only while `debugUntil` is in the future
                         message:
                           type: string
                           description: Log message content.
                           examples:
                             - test log message from preSavePage
+                  nextPageURL:
+                    type: string
+                    description: |-
+                      Path of the next slice to read, carrying the same filters with `time_lte` moved
+                      back to the slice boundary. Present whenever unread window remains — including
+                      when `logs` is empty. Absent once the window is exhausted.
+                    examples:
+                      - /v1/scripts/6843b67b35b64c0bcba2fd69/logs?time_gt=1790869357487&time_lte=1790955400000
               examples:
                 withLogs:
-                  summary: Script with debug logs
+                  summary: Slice with entries
                   value:
                     logs:
                       - time: '2026-05-22 01:24:38.697'
@@ -438,8 +500,13 @@ paths:
                         _resourceId: 6843b67b35b64c0bcba2fd69
                         logLevel: INFO
                         message: test log message from preSavePage
+                emptySliceMoreToRead:
+                  summary: Empty slice, window not exhausted — follow the cursor
+                  value:
+                    logs: []
+                    nextPageURL: /v1/scripts/6843b67b35b64c0bcba2fd69/logs?time_gt=1790869357487&time_lte=1790955400000
                 empty:
-                  summary: No logs
+                  summary: Window exhausted, no entries
                   value:
                     logs: []
         '401':
@@ -451,10 +518,11 @@ paths:
       operationId: deleteScriptLogs
       tags:
         - Scripts
-      summary: Delete debug logs for a script
+      summary: Delete execution logs for a script
       description: |-
-        Deletes all debug logs for the specified script. Synchronous and
-        idempotent — works even if the script has no logs.
+        Deletes every entry in the script's execution log — the same action as the script
+        page's Clear logs. Synchronous and idempotent; succeeds when the script has no
+        entries. The only way, apart from account retention, that entries leave the log.
       parameters:
         - name: _id
           in: path

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celigo/api-specs",
-  "version": "0.2.71",
+  "version": "0.2.72",
   "private": false,
   "description": "Public OpenAPI bundles (dist/) and the celigo-cli lint schema pack (schemas.json).",
   "keywords": [

package/schemas.json

@@ -1,8 +1,8 @@
 {
 	"provenance": {
 		"repo": "celigo/integrator-api-specs",
-		"iasCommit": "de043a7",
-		"generatedAt": "2026-10-02"
+		"iasCommit": "77f1be1",
+		"generatedAt": "2026-10-03"
 	},
 	"roots": {
 		"aiagent": 133,