@flowcore/sdk 1.24.3 → 1.25.0

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [1.25.0](https://github.com/flowcore-io/flowcore-sdk/compare/v1.24.4...v1.25.0) (2025-04-10)
+
+
+### Features
+
+* **ai-agent-coordinator:** :sparkles: add AI Agent Coordinator operations and conversation management commands ([fea2033](https://github.com/flowcore-io/flowcore-sdk/commit/fea203321efcd1a99191f93c987087484afae535))
+* **ai-agent-coordinator:** :sparkles: add commands for managing conversation context and metadata ([68b003c](https://github.com/flowcore-io/flowcore-sdk/commit/68b003c651467b742e81a3106a3206bfd9b45e8e))
+* **ai-agent-coordinator:** :sparkles: implement WebSocket client and conversation stream command ([63d9595](https://github.com/flowcore-io/flowcore-sdk/commit/63d95956622f30f36f731418c71384f9b2e00c9d))
+
+
+### Bug Fixes
+
+* **ai-agent-coordinator:** :art: clean up command class implementations and formatting ([875106a](https://github.com/flowcore-io/flowcore-sdk/commit/875106a38543dedc7ed6bd2c3dedc3a9b09dbe3a))
+* **ai-agent-coordinator:** :art: enhance WebSocket command structure and improve error handling ([b7f9bff](https://github.com/flowcore-io/flowcore-sdk/commit/b7f9bffba95dc28f077d2565940b3f21b0ea4e55))
+* **websocket-client:** :bug: simplify WebSocket open state handling ([6fe00ae](https://github.com/flowcore-io/flowcore-sdk/commit/6fe00ae5d07becc7d4d96cbc1fa5c02a0e76f06a))
+
+## [1.24.4](https://github.com/flowcore-io/flowcore-sdk/compare/v1.24.3...v1.24.4) (2025-04-02)
+
+
+### Bug Fixes
+
+* **command:** :bug: remove debug logs for dedicated base URL retrieval ([bd81ec2](https://github.com/flowcore-io/flowcore-sdk/commit/bd81ec21528b22c33fb5b5ee996ec661eefec2db))
+
 ## [1.24.3](https://github.com/flowcore-io/flowcore-sdk/compare/v1.24.2...v1.24.3) (2025-04-02)
 
 

package/README.md

@@ -613,6 +613,214 @@ const result = await client.execute(command)
 > **Note**: If `waitForDelete` or `waitForTruncate` is set to `true`, the command will wait up to 25 seconds for the operation to complete.
 > **Important**: Event Type deletion and truncation operations require bearer token authentication.
 
+### AI Agent Coordinator Operations
+
+These commands allow interaction with the AI Agent Coordinator service for managing conversational AI agents.
+
+> **Important**: AI Agent Coordinator operations require bearer token authentication (OAuth2) and cannot be performed using API key authentication.
+
+#### List Conversations
+
+Retrieves metadata for all conversations accessible by the user.
+
+```typescript
+import { ConversationListCommand, FlowcoreClient } from "@flowcore/sdk"
+
+const command = new ConversationListCommand()
+
+const conversations = await client.execute(command)
+// Returns an array of conversation metadata:
+// {
+//   id: string;
+//   title: string;
+//   lastUpdated: string; // ISO Date string
+// }[]
+```
+
+#### Get a Specific Conversation
+
+Retrieves the full details, including messages and context, for a specific conversation.
+
+```typescript
+import { ConversationGetCommand, FlowcoreClient } from "@flowcore/sdk"
+
+const command = new ConversationGetCommand({ conversationId: "your-conversation-id" })
+
+try {
+  const conversation = await client.execute(command)
+  // Returns the full Conversation object:
+  // {
+  //   id: string;
+  //   title: string;
+  //   lastUpdated: string;
+  //   context: ContextItem[]; // Array of items in the conversation's context
+  //   messages: Message[];   // Array of messages in the conversation
+  // }
+} catch (error) {
+  if (error instanceof NotFoundException) {
+    console.error("Conversation not found:", error.details);
+  } else {
+    console.error("Failed to get conversation:", error);
+  }
+}
+```
+
+#### Delete a Conversation
+
+Permanently deletes a specific conversation and its associated data.
+
+```typescript
+import { ConversationDeleteCommand, FlowcoreClient } from "@flowcore/sdk"
+
+const command = new ConversationDeleteCommand({ conversationId: "conversation-id-to-delete" })
+
+try {
+  const result = await client.execute(command)
+  // Returns: { message: "Conversation deleted successfully." }
+  console.log(result.message);
+} catch (error) {
+  console.error("Failed to delete conversation:", error);
+}
+```
+
+#### Add Items to Conversation Context
+
+Adds one or more resources (like tenants, data cores) to the context of a specific conversation.
+
+```typescript
+import { ContextAddItemCommand, FlowcoreClient } from "@flowcore/sdk"
+
+const command = new ContextAddItemCommand({
+  conversationId: "your-conversation-id",
+  items: [
+    { type: "tenant", id: "tenant-id-to-add" },
+    { type: "dataCore", id: "data-core-id-to-add" }
+  ]
+})
+
+try {
+  const result = await client.execute(command)
+  // Returns the updated context array for the conversation:
+  // { context: ContextItem[] }
+  console.log("Updated context:", result.context);
+} catch (error) {
+  console.error("Failed to add context items:", error);
+}
+```
+
+#### Remove Item from Conversation Context
+
+Removes a specific item instance from the context of a conversation.
+
+```typescript
+import { ContextRemoveItemCommand, FlowcoreClient } from "@flowcore/sdk"
+
+const command = new ContextRemoveItemCommand({
+  conversationId: "your-conversation-id",
+  itemId: "context-item-id-to-remove" // The ID of the item in the context array
+})
+
+try {
+  const result = await client.execute(command)
+  // Returns the updated context array for the conversation:
+  // { context: ContextItem[] }
+  console.log("Updated context after removal:", result.context);
+} catch (error) {
+  console.error("Failed to remove context item:", error);
+}
+```
+
+#### Stream Conversation Events
+
+The `WebSocketClient` is used to establish a persistent connection for streaming conversation events (like AI responses, tool usage, etc.) for a specific conversation.
+
+```typescript
+import {
+  WebSocketClient,
+  ConversationStreamCommand,
+  type ConversationStreamConfig,
+  type ConversationStreamSendPayload,
+  type StreamChunk
+} from "@flowcore/sdk";
+import { Subject } from "rxjs";
+
+// 1. Authentication (using bearer token provider)
+const authOptions = {
+  getBearerToken: async (): Promise<string | null> => {
+    // Replace with your actual token retrieval logic
+    return "your-bearer-token";
+  }
+};
+
+// 2. Create the WebSocket Client
+const wsClient = new WebSocketClient(authOptions, {
+  // Optional configuration
+  reconnectInterval: 2000, // milliseconds
+  maxReconnects: 5
+});
+
+// 3. Define the command for the specific conversation stream
+const conversationConfig: ConversationStreamConfig = {
+  conversationId: "your-conversation-id"
+};
+const streamCommand = new ConversationStreamCommand(conversationConfig);
+
+// 4. Connect and handle the stream
+async function startStreaming() {
+  try {
+    console.log(`Connecting to conversation stream: ${conversationConfig.conversationId}...`);
+    const activeStream = await wsClient.connect(streamCommand);
+    console.log("Stream connected!");
+
+    // Subscribe to incoming chunks
+    const subscription = activeStream.output$.subscribe({
+      next: (chunk: StreamChunk) => {
+        console.log("Received chunk:", chunk.type, chunk);
+        // Process different chunk types (markdown_delta, tool_start, etc.)
+      },
+      error: (error) => {
+        console.error("Stream error:", error);
+        // Handle stream errors (e.g., attempt reconnect or notify user)
+      },
+      complete: () => {
+        console.log("Stream completed.");
+        // Handle stream completion (e.g., connection closed by server or maxReconnects reached)
+      }
+    });
+
+    // Example: Sending a message to the conversation
+    const messageToSend: ConversationStreamSendPayload = { content: "Hello Agent!" };
+    const sent = activeStream.send(messageToSend);
+    if (sent) {
+      console.log("Sent message to agent.");
+    } else {
+      console.warn("Failed to send message (socket likely not open).");
+    }
+
+    // Keep the connection open until explicitly disconnected or an error occurs
+    // In a real application, you might have UI events trigger disconnect
+    // Example: Disconnect after 60 seconds
+    setTimeout(() => {
+      console.log("Disconnecting stream...");
+      activeStream.disconnect();
+      subscription.unsubscribe();
+    }, 60000);
+
+  } catch (error) {
+    console.error("Failed to connect to WebSocket stream:", error);
+  }
+}
+
+startStreaming();
+
+// Remember to handle graceful shutdown by calling disconnect
+// e.g., wsClient.disconnect() or activeStream.disconnect()
+```
+
+**Stream Chunks (`StreamChunk`)**
+
+The `output$` observable emits objects conforming to the `StreamChunk` type (or subtypes). Refer to the API specification or SDK types for details on the different chunk types like `markdown_delta`, `tool_start`, `context_add_item`, etc., and their specific properties.
+
 ### Notifications
 
 The NotificationClient allows you to receive real-time notifications when events are ingested into an event type. The notifications follow the hierarchical structure: Data Core → Flow Type → Event Type.

package/esm/commands/ai-agent-coordinator/context-add-item.command.d.ts

@@ -0,0 +1,28 @@
+import type { Command } from "../../common/command.js";
+import { Command as BaseCommandClass } from "../../common/command.js";
+import type { AddContextItem, ContextUpdateResponse } from "../../contracts/ai-agent-coordinator.js";
+/**
+ * Input for adding items to a conversation's context.
+ */
+export type ContextAddItemCommandInput = {
+    /** The ID of the conversation to modify. */
+    conversationId: string;
+    /** An array of context items (type and ID) to add. */
+    items: AddContextItem[];
+};
+/**
+ * Output containing the updated context array after adding items.
+ */
+export type ContextAddItemCommandOutput = ContextUpdateResponse;
+/**
+ * Command to add one or more items to the context of a specific conversation.
+ */
+export declare class ContextAddItemCommand extends BaseCommandClass<ContextAddItemCommandInput, ContextAddItemCommandOutput> implements Command<ContextAddItemCommandInput, ContextAddItemCommandOutput> {
+    constructor(input: ContextAddItemCommandInput);
+    protected getBaseUrl(): string;
+    protected getMethod(): string;
+    protected getPath(): string;
+    protected getBody(): Record<string, unknown>;
+    protected parseResponse(response: unknown): ContextAddItemCommandOutput;
+}
+//# sourceMappingURL=context-add-item.command.d.ts.map

package/esm/commands/ai-agent-coordinator/context-add-item.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-add-item.command.d.ts","sourceRoot":"","sources":["../../../src/commands/ai-agent-coordinator/context-add-item.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAA;AAKpG;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAA;IACtB,sDAAsD;IACtD,KAAK,EAAE,cAAc,EAAE,CAAA;CACxB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,qBAAqB,CAAA;AAE/D;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,gBAAgB,CAAC,0BAA0B,EAAE,2BAA2B,CACjH,YAAW,OAAO,CAAC,0BAA0B,EAAE,2BAA2B,CAAC;gBAC/D,KAAK,EAAE,0BAA0B;cAI1B,UAAU,IAAI,MAAM;cAIpB,SAAS,IAAI,MAAM;cAInB,OAAO,IAAI,MAAM;cAIjB,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;cAMlC,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,2BAA2B;CASjF"}

package/esm/commands/ai-agent-coordinator/context-add-item.command.js

@@ -0,0 +1,34 @@
+import { Command as BaseCommandClass } from "../../common/command.js";
+const service = "ai-coordinator";
+const baseUrl = `https://${service}.api.flowcore.io`;
+/**
+ * Command to add one or more items to the context of a specific conversation.
+ */
+export class ContextAddItemCommand extends BaseCommandClass {
+    constructor(input) {
+        super(input);
+    }
+    getBaseUrl() {
+        return baseUrl;
+    }
+    getMethod() {
+        return "POST";
+    }
+    getPath() {
+        return `/api/v1/conversations/${this.input.conversationId}/context/add`;
+    }
+    getBody() {
+        return { items: this.input.items };
+    }
+    // Headers will be handled by base class based on getBody()
+    parseResponse(response) {
+        const data = response;
+        // Add more robust checking if necessary
+        if (data && Array.isArray(data.context)) {
+            return data;
+        }
+        else {
+            throw new Error("Invalid response format for ContextAddItemCommand");
+        }
+    }
+}

package/esm/commands/ai-agent-coordinator/context-remove-item.command.d.ts

@@ -0,0 +1,28 @@
+import type { Command } from "../../common/command.js";
+import { Command as BaseCommandClass } from "../../common/command.js";
+import type { ContextUpdateResponse } from "../../contracts/ai-agent-coordinator.js";
+/**
+ * Input for removing an item from a conversation's context.
+ */
+export type ContextRemoveItemCommandInput = {
+    /** The ID of the conversation to modify. */
+    conversationId: string;
+    /** The unique ID of the context item instance to remove. */
+    itemId: string;
+};
+/**
+ * Output containing the updated context array after removing the item.
+ */
+export type ContextRemoveItemCommandOutput = ContextUpdateResponse;
+/**
+ * Command to remove a specific item from the context of a conversation.
+ */
+export declare class ContextRemoveItemCommand extends BaseCommandClass<ContextRemoveItemCommandInput, ContextRemoveItemCommandOutput> implements Command<ContextRemoveItemCommandInput, ContextRemoveItemCommandOutput> {
+    constructor(input: ContextRemoveItemCommandInput);
+    protected getBaseUrl(): string;
+    protected getMethod(): string;
+    protected getPath(): string;
+    protected getBody(): Record<string, unknown>;
+    protected parseResponse(response: unknown): ContextRemoveItemCommandOutput;
+}
+//# sourceMappingURL=context-remove-item.command.d.ts.map

package/esm/commands/ai-agent-coordinator/context-remove-item.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-remove-item.command.d.ts","sourceRoot":"","sources":["../../../src/commands/ai-agent-coordinator/context-remove-item.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AACrE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAA;AAKpF;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG;IAC1C,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAA;IACtB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,qBAAqB,CAAA;AAElE;;GAEG;AACH,qBAAa,wBACX,SAAQ,gBAAgB,CAAC,6BAA6B,EAAE,8BAA8B,CACtF,YAAW,OAAO,CAAC,6BAA6B,EAAE,8BAA8B,CAAC;gBACrE,KAAK,EAAE,6BAA6B;cAI7B,UAAU,IAAI,MAAM;cAIpB,SAAS,IAAI,MAAM;cAInB,OAAO,IAAI,MAAM;cAIjB,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;cAIlC,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,8BAA8B;CAQpF"}

package/esm/commands/ai-agent-coordinator/context-remove-item.command.js

@@ -0,0 +1,32 @@
+import { Command as BaseCommandClass } from "../../common/command.js";
+const service = "ai-coordinator";
+const baseUrl = `https://${service}.api.flowcore.io`;
+/**
+ * Command to remove a specific item from the context of a conversation.
+ */
+export class ContextRemoveItemCommand extends BaseCommandClass {
+    constructor(input) {
+        super(input);
+    }
+    getBaseUrl() {
+        return baseUrl;
+    }
+    getMethod() {
+        return "POST";
+    }
+    getPath() {
+        return `/api/v1/conversations/${this.input.conversationId}/context/remove`;
+    }
+    getBody() {
+        return { itemId: this.input.itemId };
+    }
+    parseResponse(response) {
+        const data = response;
+        if (data && Array.isArray(data.context)) {
+            return data;
+        }
+        else {
+            throw new Error("Invalid response format for ContextRemoveItemCommand");
+        }
+    }
+}

package/esm/commands/ai-agent-coordinator/conversation-delete.command.d.ts

@@ -0,0 +1,25 @@
+import type { Command } from "../../common/command.js";
+import { Command as BaseCommandClass } from "../../common/command.js";
+import type { ConversationDeleteResponse } from "../../contracts/ai-agent-coordinator.js";
+/**
+ * Input for deleting a specific conversation.
+ */
+export type ConversationDeleteCommandInput = {
+    /** The unique ID of the conversation to delete. */
+    conversationId: string;
+};
+/**
+ * Output confirming the deletion of the conversation.
+ */
+export type ConversationDeleteCommandOutput = ConversationDeleteResponse;
+/**
+ * Command to delete a specific conversation by its ID.
+ */
+export declare class ConversationDeleteCommand extends BaseCommandClass<ConversationDeleteCommandInput, ConversationDeleteCommandOutput> implements Command<ConversationDeleteCommandInput, ConversationDeleteCommandOutput> {
+    constructor(input: ConversationDeleteCommandInput);
+    protected getBaseUrl(): string;
+    protected getMethod(): string;
+    protected getPath(): string;
+    protected parseResponse(response: unknown): ConversationDeleteCommandOutput;
+}
+//# sourceMappingURL=conversation-delete.command.d.ts.map

package/esm/commands/ai-agent-coordinator/conversation-delete.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-delete.command.d.ts","sourceRoot":"","sources":["../../../src/commands/ai-agent-coordinator/conversation-delete.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AACrE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAA;AAKzF;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAA;CACvB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,+BAA+B,GAAG,0BAA0B,CAAA;AAExE;;GAEG;AACH,qBAAa,yBACX,SAAQ,gBAAgB,CAAC,8BAA8B,EAAE,+BAA+B,CACxF,YAAW,OAAO,CAAC,8BAA8B,EAAE,+BAA+B,CAAC;gBACvE,KAAK,EAAE,8BAA8B;cAI9B,UAAU,IAAI,MAAM;cAIpB,SAAS,IAAI,MAAM;cAInB,OAAO,IAAI,MAAM;cAMjB,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,+BAA+B;CAUrF"}

package/esm/commands/ai-agent-coordinator/conversation-delete.command.js

@@ -0,0 +1,30 @@
+import { Command as BaseCommandClass } from "../../common/command.js";
+const service = "ai-coordinator";
+const baseUrl = `https://${service}.api.flowcore.io`;
+/**
+ * Command to delete a specific conversation by its ID.
+ */
+export class ConversationDeleteCommand extends BaseCommandClass {
+    constructor(input) {
+        super(input);
+    }
+    getBaseUrl() {
+        return baseUrl;
+    }
+    getMethod() {
+        return "DELETE";
+    }
+    getPath() {
+        return `/api/v1/conversations/${this.input.conversationId}`;
+    }
+    // No need to override getBody or getHeaders for DELETE with no body
+    parseResponse(response) {
+        const data = response;
+        if (data && data.message) {
+            return data;
+        }
+        else {
+            throw new Error("Invalid response format for ConversationDeleteCommand");
+        }
+    }
+}

package/esm/commands/ai-agent-coordinator/conversation-get.command.d.ts

@@ -0,0 +1,27 @@
+import type { Command } from "../../common/command.js";
+import { Command as BaseCommandClass } from "../../common/command.js";
+import type { Conversation } from "../../contracts/ai-agent-coordinator.js";
+import type { ClientError } from "../../exceptions/client-error.js";
+/**
+ * Input for fetching a specific conversation.
+ */
+export type ConversationGetCommandInput = {
+    /** The unique ID of the conversation to fetch. */
+    conversationId: string;
+};
+/**
+ * Output containing the full details of the fetched conversation.
+ */
+export type ConversationGetCommandOutput = Conversation;
+/**
+ * Command to fetch the details of a specific conversation by its ID.
+ */
+export declare class ConversationGetCommand extends BaseCommandClass<ConversationGetCommandInput, ConversationGetCommandOutput> implements Command<ConversationGetCommandInput, ConversationGetCommandOutput> {
+    constructor(input: ConversationGetCommandInput);
+    protected getBaseUrl(): string;
+    protected getMethod(): string;
+    protected getPath(): string;
+    protected parseResponse(response: unknown): ConversationGetCommandOutput;
+    protected handleClientError(error: ClientError): void;
+}
+//# sourceMappingURL=conversation-get.command.d.ts.map

package/esm/commands/ai-agent-coordinator/conversation-get.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-get.command.d.ts","sourceRoot":"","sources":["../../../src/commands/ai-agent-coordinator/conversation-get.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAA;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAMnE;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,kDAAkD;IAClD,cAAc,EAAE,MAAM,CAAA;CACvB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,YAAY,CAAA;AAEvD;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,gBAAgB,CAAC,2BAA2B,EAAE,4BAA4B,CACpH,YAAW,OAAO,CAAC,2BAA2B,EAAE,4BAA4B,CAAC;gBACjE,KAAK,EAAE,2BAA2B;cAI3B,UAAU,IAAI,MAAM;cAIpB,SAAS,IAAI,MAAM;cAInB,OAAO,IAAI,MAAM;cAIjB,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,4BAA4B;cAS9D,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;CAS/D"}

package/esm/commands/ai-agent-coordinator/conversation-get.command.js

@@ -0,0 +1,36 @@
+import { Command as BaseCommandClass } from "../../common/command.js";
+import { NotFoundException } from "../../exceptions/index.js";
+const service = "ai-coordinator";
+const baseUrl = `https://${service}.api.flowcore.io`;
+/**
+ * Command to fetch the details of a specific conversation by its ID.
+ */
+export class ConversationGetCommand extends BaseCommandClass {
+    constructor(input) {
+        super(input);
+    }
+    getBaseUrl() {
+        return baseUrl;
+    }
+    getMethod() {
+        return "GET";
+    }
+    getPath() {
+        return `/api/v1/conversations/${this.input.conversationId}`;
+    }
+    parseResponse(response) {
+        const data = response;
+        if (data && data.id) {
+            return data;
+        }
+        else {
+            throw new Error("Invalid response format for ConversationGetCommand");
+        }
+    }
+    handleClientError(error) {
+        if (error.status === 404) {
+            throw new NotFoundException("Conversation", { conversationId: this.input.conversationId });
+        }
+        throw error;
+    }
+}

package/esm/commands/ai-agent-coordinator/conversation-list.command.d.ts

@@ -0,0 +1,23 @@
+import type { Command } from "../../common/command.js";
+import { Command as BaseCommandClass } from "../../common/command.js";
+import type { ConversationMetadata } from "../../contracts/ai-agent-coordinator.js";
+/**
+ * Input for listing conversations.
+ * Currently empty as no filters are supported.
+ */
+export type ConversationListCommandInput = Record<string, never>;
+/**
+ * Output containing a list of conversation metadata.
+ */
+export type ConversationListCommandOutput = ConversationMetadata[];
+/**
+ * Command to list all conversations accessible by the user.
+ */
+export declare class ConversationListCommand extends BaseCommandClass<ConversationListCommandInput, ConversationListCommandOutput> implements Command<ConversationListCommandInput, ConversationListCommandOutput> {
+    constructor();
+    protected getBaseUrl(): string;
+    protected getMethod(): string;
+    protected getPath(): string;
+    protected parseResponse(response: unknown): ConversationListCommandOutput;
+}
+//# sourceMappingURL=conversation-list.command.d.ts.map

package/esm/commands/ai-agent-coordinator/conversation-list.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-list.command.d.ts","sourceRoot":"","sources":["../../../src/commands/ai-agent-coordinator/conversation-list.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AACrE,OAAO,KAAK,EAA4B,oBAAoB,EAAE,MAAM,yCAAyC,CAAA;AAK7G;;;GAGG;AACH,MAAM,MAAM,4BAA4B,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;AAEhE;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,oBAAoB,EAAE,CAAA;AAElE;;GAEG;AACH,qBAAa,uBACX,SAAQ,gBAAgB,CAAC,4BAA4B,EAAE,6BAA6B,CACpF,YAAW,OAAO,CAAC,4BAA4B,EAAE,6BAA6B,CAAC;;cAK5D,UAAU,IAAI,MAAM;cAIpB,SAAS,IAAI,MAAM;cAInB,OAAO,IAAI,MAAM;cAIjB,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,6BAA6B;CAQnF"}

package/esm/commands/ai-agent-coordinator/conversation-list.command.js

@@ -0,0 +1,29 @@
+import { Command as BaseCommandClass } from "../../common/command.js";
+const service = "ai-coordinator";
+const baseUrl = `https://${service}.api.flowcore.io`;
+/**
+ * Command to list all conversations accessible by the user.
+ */
+export class ConversationListCommand extends BaseCommandClass {
+    constructor() {
+        super({});
+    }
+    getBaseUrl() {
+        return baseUrl;
+    }
+    getMethod() {
+        return "GET";
+    }
+    getPath() {
+        return `/api/v1/conversations`;
+    }
+    parseResponse(response) {
+        const data = response;
+        if (data && Array.isArray(data.conversations)) {
+            return data.conversations;
+        }
+        else {
+            throw new Error("Invalid response format for ConversationListCommand");
+        }
+    }
+}

package/esm/commands/ai-agent-coordinator/conversation-stream.command.d.ts

@@ -0,0 +1,30 @@
+import type { WebSocketCommand } from "../../common/websocket-command.js";
+/**
+ * Configuration for the Conversation Stream.
+ * Only requires the conversationId.
+ */
+export interface ConversationStreamConfig {
+    conversationId: string;
+}
+/**
+ * Payload type for messages sent *to* the Conversation Stream.
+ */
+export interface ConversationStreamSendPayload {
+    content: string;
+}
+/**
+ * Command to stream conversation events for a specific agent.
+ */
+export declare class ConversationStreamCommand implements WebSocketCommand<ConversationStreamConfig, ConversationStreamSendPayload> {
+    private config;
+    constructor(config: ConversationStreamConfig);
+    /** Get the configuration object for the command. */
+    getConfig(): ConversationStreamConfig;
+    /** Get the base WebSocket URL. */
+    getWebSocketBaseUrl(): string;
+    /** Get the WebSocket path segment. */
+    getWebSocketPathSegment(config: ConversationStreamConfig): string;
+    /** Serializer function for outgoing payloads. */
+    serializeSendPayload(payload: ConversationStreamSendPayload): string;
+}
+//# sourceMappingURL=conversation-stream.command.d.ts.map

package/esm/commands/ai-agent-coordinator/conversation-stream.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-stream.command.d.ts","sourceRoot":"","sources":["../../../src/commands/ai-agent-coordinator/conversation-stream.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AAEzE;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,cAAc,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,qBAAa,yBACX,YAAW,gBAAgB,CAAC,wBAAwB,EAAE,6BAA6B,CAAC;IACpF,OAAO,CAAC,MAAM,CAA0B;gBAE5B,MAAM,EAAE,wBAAwB;IAO5C,oDAAoD;IACpD,SAAS,IAAI,wBAAwB;IAIrC,kCAAkC;IAClC,mBAAmB,IAAI,MAAM;IAK7B,sCAAsC;IACtC,uBAAuB,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM;IAKjE,iDAAiD;IACjD,oBAAoB,CAAC,OAAO,EAAE,6BAA6B,GAAG,MAAM;CAIrE"}

package/esm/commands/ai-agent-coordinator/conversation-stream.command.js

@@ -0,0 +1,36 @@
+/**
+ * Command to stream conversation events for a specific agent.
+ */
+export class ConversationStreamCommand {
+    constructor(config) {
+        Object.defineProperty(this, "config", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        if (!config.conversationId) {
+            throw new Error("conversationId is required in the config for ConversationStreamCommand");
+        }
+        this.config = config;
+    }
+    /** Get the configuration object for the command. */
+    getConfig() {
+        return this.config;
+    }
+    /** Get the base WebSocket URL. */
+    getWebSocketBaseUrl() {
+        // Specific base URL for AI Coordinator streams
+        return "wss://ai-coordinator.api.flowcore.io";
+    }
+    /** Get the WebSocket path segment. */
+    getWebSocketPathSegment(config) {
+        // Updated path segment based on likely API structure
+        return `/api/v1/stream/conversations/${config.conversationId}`;
+    }
+    /** Serializer function for outgoing payloads. */
+    serializeSendPayload(payload) {
+        // Default JSON serialization
+        return JSON.stringify(payload);
+    }
+}

package/esm/commands/ai-agent-coordinator/mod.d.ts

@@ -0,0 +1,7 @@
+export * from "./context-add-item.command.js";
+export * from "./context-remove-item.command.js";
+export * from "./conversation-delete.command.js";
+export * from "./conversation-get.command.js";
+export * from "./conversation-list.command.js";
+export * from "./conversation-stream.command.js";
+//# sourceMappingURL=mod.d.ts.map

package/esm/commands/ai-agent-coordinator/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/commands/ai-agent-coordinator/mod.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAA;AAC7C,cAAc,kCAAkC,CAAA;AAChD,cAAc,kCAAkC,CAAA;AAChD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,kCAAkC,CAAA"}

package/esm/commands/ai-agent-coordinator/mod.js

@@ -0,0 +1,6 @@
+export * from "./context-add-item.command.js";
+export * from "./context-remove-item.command.js";
+export * from "./conversation-delete.command.js";
+export * from "./conversation-get.command.js";
+export * from "./conversation-list.command.js";
+export * from "./conversation-stream.command.js";