@cleocode/cleo 2026.4.115 → 2026.4.117

package/dist/cli/index.js

@@ -16459,6 +16459,15 @@ var init_conduit2 = __esm({
               );
               return wrapResult(result, "query", "conduit", operation, startTime);
             }
+            case "listen": {
+              const result = await this.listenTopic(
+                params?.topicName,
+                params?.agentId,
+                params?.limit,
+                params?.since
+              );
+              return wrapResult(result, "query", "conduit", operation, startTime);
+            }
             default:
               return unsupportedOp("query", "conduit", operation, startTime);
           }
@@ -16498,6 +16507,24 @@ var init_conduit2 = __esm({
               );
               return wrapResult(result, "mutate", "conduit", operation, startTime);
             }
+            case "subscribe": {
+              const result = await this.subscribeTopic(
+                params?.topicName,
+                params?.agentId,
+                params?.filter
+              );
+              return wrapResult(result, "mutate", "conduit", operation, startTime);
+            }
+            case "publish": {
+              const result = await this.publishToTopic(
+                params?.topicName,
+                params?.content,
+                params?.kind,
+                params?.payload,
+                params?.agentId
+              );
+              return wrapResult(result, "mutate", "conduit", operation, startTime);
+            }
             default:
               return unsupportedOp("mutate", "conduit", operation, startTime);
           }
@@ -16514,8 +16541,8 @@ var init_conduit2 = __esm({
       }
       getSupportedOperations() {
         return {
-          query: ["status", "peek"],
-          mutate: ["start", "stop", "send"]
+          query: ["status", "peek", "listen"],
+          mutate: ["start", "stop", "send", "subscribe", "publish"]
         };
       }
       // ---------------------------------------------------------------------------
@@ -16722,6 +16749,165 @@ var init_conduit2 = __esm({
           }
         };
       }
+      // ── A2A Topic Operations (T1252) ────────────────────────────────────────
+      /**
+       * Subscribe agent to a named topic.
+       *
+       * Uses `LocalTransport` exclusively — topic operations require conduit.db.
+       *
+       * @param topicName - Topic name, e.g. `"epic-T1149.wave-2"`.
+       * @param agentId   - Agent id (defaults to active agent).
+       * @param _filter   - Reserved for future filter support.
+       * @task T1252
+       */
+      async subscribeTopic(topicName, agentId, _filter) {
+        if (!topicName) {
+          return {
+            success: false,
+            error: { code: "E_ARGS", message: 'Must specify "topicName"' }
+          };
+        }
+        const credential = await this.resolveCredential(agentId);
+        const { LocalTransport } = await import("@cleocode/core/conduit");
+        if (!LocalTransport.isAvailable(process.cwd())) {
+          return {
+            success: false,
+            error: { code: "E_CONDUIT", message: "conduit.db not found \u2014 run: cleo init" }
+          };
+        }
+        const transport = new LocalTransport();
+        await transport.connect({
+          agentId: credential.agentId,
+          apiKey: credential.apiKey,
+          apiBaseUrl: credential.apiBaseUrl
+        });
+        try {
+          await transport.subscribeTopic(topicName);
+          return {
+            success: true,
+            data: {
+              agentId: credential.agentId,
+              topicName,
+              message: `Subscribed to topic: ${topicName}`
+            }
+          };
+        } finally {
+          await transport.disconnect();
+        }
+      }
+      /**
+       * Publish a message to a named topic.
+       *
+       * Uses `LocalTransport` exclusively — topic operations require conduit.db.
+       *
+       * @param topicName - Target topic name.
+       * @param content   - Message content (required).
+       * @param kind      - Message kind (default `"message"`).
+       * @param payload   - Optional structured payload.
+       * @param agentId   - Publisher agent id (defaults to active agent).
+       * @task T1252
+       */
+      async publishToTopic(topicName, content, kind, payload, agentId) {
+        if (!topicName) {
+          return {
+            success: false,
+            error: { code: "E_ARGS", message: 'Must specify "topicName"' }
+          };
+        }
+        if (!content) {
+          return {
+            success: false,
+            error: { code: "E_ARGS", message: 'Must specify "content"' }
+          };
+        }
+        const credential = await this.resolveCredential(agentId);
+        const { LocalTransport } = await import("@cleocode/core/conduit");
+        if (!LocalTransport.isAvailable(process.cwd())) {
+          return {
+            success: false,
+            error: { code: "E_CONDUIT", message: "conduit.db not found \u2014 run: cleo init" }
+          };
+        }
+        const transport = new LocalTransport();
+        await transport.connect({
+          agentId: credential.agentId,
+          apiKey: credential.apiKey,
+          apiBaseUrl: credential.apiBaseUrl
+        });
+        try {
+          const result = await transport.publishToTopic(topicName, content, { kind, payload });
+          return {
+            success: true,
+            data: {
+              messageId: result.messageId,
+              from: credential.agentId,
+              topicName,
+              transport: "local",
+              publishedAt: (/* @__PURE__ */ new Date()).toISOString()
+            }
+          };
+        } finally {
+          await transport.disconnect();
+        }
+      }
+      /**
+       * One-shot poll for topic messages.
+       *
+       * Returns messages published to the topic (ordered oldest-first).
+       * Uses `LocalTransport` exclusively — topic operations require conduit.db.
+       *
+       * @param topicName - Topic name to poll.
+       * @param agentId   - Agent id (defaults to active agent).
+       * @param limit     - Maximum messages to return (default 50).
+       * @param since     - Return only messages after this ISO 8601 timestamp.
+       * @task T1252
+       */
+      async listenTopic(topicName, agentId, limit, since) {
+        if (!topicName) {
+          return {
+            success: false,
+            error: { code: "E_ARGS", message: 'Must specify "topicName"' }
+          };
+        }
+        const startMs = Date.now();
+        const credential = await this.resolveCredential(agentId);
+        const { LocalTransport } = await import("@cleocode/core/conduit");
+        if (!LocalTransport.isAvailable(process.cwd())) {
+          return {
+            success: false,
+            error: { code: "E_CONDUIT", message: "conduit.db not found \u2014 run: cleo init" }
+          };
+        }
+        const transport = new LocalTransport();
+        await transport.connect({
+          agentId: credential.agentId,
+          apiKey: credential.apiKey,
+          apiBaseUrl: credential.apiBaseUrl
+        });
+        try {
+          const sinceUnix = since ? Math.floor(new Date(since).getTime() / 1e3) : 0;
+          const messages = await transport.pollTopic(topicName, {
+            limit: limit ?? 50,
+            since: sinceUnix
+          });
+          return {
+            success: true,
+            data: {
+              topicName,
+              messages: messages.map((m) => ({
+                id: m.id,
+                from: m.from,
+                content: m.content,
+                conversationId: m.threadId,
+                timestamp: m.timestamp
+              })),
+              listenedForMs: Date.now() - startMs
+            }
+          };
+        } finally {
+          await transport.disconnect();
+        }
+      }
       /** Send a message to an agent or conversation. Uses LocalTransport when conduit.db is available. */
       async sendMessage(content, to, conversationId, agentId) {
         if (!to && !conversationId) {