@celigo/api-specs 0.2.164 → 0.2.165

package/dist/topic.yml

@@ -743,8 +743,10 @@ paths:
       summary: Get a listener's read position
       description: |-
         Reports how far a topic export (listener) has read on this topic — where its next run resumes.
-        Use it to check whether a listener is keeping up or has never run. The export must belong to the
-        account but need not subscribe to this topic; an export that does not simply has no cursor.
+        Use it to check whether a listener is keeping up, or whether it has a read position at all: it
+        has none while it has not subscribed, or while its topic has never received a message. The export
+        must belong to the account but need not subscribe to this topic; an export that does not simply
+        has no cursor.
       operationId: getTopicExportOffsets
       tags:
         - Topics
@@ -783,7 +785,7 @@ paths:
                     hasCursor: true
                     offset: 1287
                 never_consumed:
-                  summary: Listener that has not read this topic yet
+                  summary: Listener that has not subscribed, or whose topic has never received a message
                   value:
                     hasCursor: false
                     offset: -1
@@ -1657,15 +1659,18 @@ components:
         hasCursor:
           type: boolean
           description: |-
-            When true, the listener is subscribed to this topic and its next run resumes from `offset`.
-            The position appears when the listener's flow goes from disabled to enabled, before anything
-            is read: at the end of the stream under `topic.startPosition: latest`, at the first retained
-            message under `earliest`. False when the listener has never subscribed — it was saved
-            without `type: "stream"`, its flow has not gone from disabled to enabled since it was saved
-            (a flow created enabled never subscribes), or it does not listen to this topic. A listener
-            whose flow is disabled keeps its position. When the message at that position is no longer
-            retained — it expired past `retentionMs` or was purged — the listener still reports true
-            with the old `offset`, and its next run resumes from the earliest message still retained,
+            When true, the listener is subscribed to this topic and its next run resumes from
+            `offset`. The position appears when the listener's flow goes from disabled to enabled,
+            before anything is read: at the end of the stream under `topic.startPosition: latest`,
+            at the first retained message under `earliest`. On a topic nothing has ever been
+            published to, it appears only with the first publish, and the listener still receives
+            that first message. False in two cases: the listener has never subscribed — it was saved
+            without `type: "stream"`, its flow has not gone from disabled to enabled since it was
+            saved (a flow created enabled never subscribes), or it does not listen to this topic; or
+            its topic has never received a message, until the first publish. A listener whose flow
+            is disabled keeps its position. When the message at that position is no longer retained
+            — it expired past `retentionMs` or was purged — the listener still reports true with the
+            old `offset`, and its next run resumes from the earliest message still retained,
             whatever its `startPosition`.
           examples:
             - true

package/package.json

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

package/schemas.json

@@ -1,7 +1,7 @@
 {
 	"provenance": {
 		"repo": "celigo/integrator-api-specs",
-		"iasCommit": "30ef0495",
+		"iasCommit": "ab4f8f83",
 		"generatedAt": "2026-10-22"
 	},
 	"roots": {