@covia/covia-sdk 1.3.0 → 1.4.0

package/README.md

@@ -337,6 +337,10 @@ await venue.agents.message("my-agent", { event: "update" });
 await venue.agents.trigger("my-agent");
 const state = await venue.agents.query("my-agent");
 
+// Session-scoped chat — mints a session on the first call, continue by echoing sessionId
+const first = await venue.agents.chat("my-agent", "hi");
+const follow = await venue.agents.chat("my-agent", "and now?", first.sessionId);
+
 // Lifecycle
 const agents = await venue.agents.list();
 await venue.agents.suspend("my-agent");
@@ -351,6 +355,7 @@ await venue.agents.delete("my-agent");
 | `agents.create(input)` | `AgentCreateResult` | Create an agent |
 | `agents.request(id, input?, wait?)` | `AgentRequestResult` | Send request to agent |
 | `agents.message(id, message)` | `AgentMessageResult` | Send a message |
+| `agents.chat(id, message, sessionId?)` | `AgentChatResult` | Session-scoped chat — awaits next response on the session |
 | `agents.trigger(id)` | `AgentTriggerResult` | Trigger agent execution |
 | `agents.query(id)` | `AgentQueryResult` | Query agent state |
 | `agents.list(includeTerminated?)` | `AgentListResult` | List agents |

package/dist/index.d.mts

@@ -219,6 +219,23 @@ declare class AgentManager {
     create(input: AgentCreateInput): Promise<AgentCreateResult>;
     request(agentId: string, input?: any, wait?: boolean | number): Promise<AgentRequestResult>;
     message(agentId: string, message: any): Promise<AgentMessageResult>;
+    /**
+     * Send a message to an agent and synchronously await its next response on the session.
+     *
+     * Session lifecycle:
+     * - Omit `sessionId` on the first call — the server mints a new session and returns
+     *   its id in the result. Capture it.
+     * - Pass the returned `sessionId` on every subsequent call to continue the conversation.
+     * - An unknown `sessionId` is rejected (the server will not silently mint one); omit
+     *   the field entirely to start a new session.
+     *
+     * Concurrency: only one chat may be in flight per session. Concurrent calls on the
+     * same session are rejected by the venue.
+     *
+     * Blocking: always blocks until the agent produces its next response on the session.
+     * No polling required.
+     */
+    chat(agentId: string, message: any, sessionId?: string): Promise<AgentChatResult>;
     trigger(agentId: string): Promise<AgentTriggerResult>;
     query(agentId: string): Promise<AgentQueryResult>;
     list(includeTerminated?: boolean): Promise<AgentListResult>;
@@ -678,6 +695,16 @@ interface AgentMessageResult {
     agentId: string;
     delivered: boolean;
 }
+interface AgentChatInput {
+    agentId: string;
+    message: any;
+    sessionId?: string;
+}
+interface AgentChatResult {
+    agentId: string;
+    sessionId: string;
+    response: any;
+}
 interface AgentTriggerInput {
     agentId: string;
 }
@@ -1010,4 +1037,4 @@ declare function decodePublicKey(multikey: string): Uint8Array;
  */
 declare function didFromPublicKey(publicKey: Uint8Array): string;
 
-export { type AdapterInfo, type AdaptersResult, type AgentCancelTaskInput, type AgentCard, type AgentCreateInput, type AgentCreateResult, type AgentDeleteInput, type AgentDeleteResult, type AgentListInput, type AgentListResult, AgentManager, type AgentMessageInput, type AgentMessageResult, type AgentQueryInput, type AgentQueryResult, type AgentRequestInput, type AgentRequestResult, type AgentResumeInput, AgentStatus, type AgentSuspendResult, type AgentTriggerInput, type AgentTriggerResult, type AgentUpdateInput, Asset, type AssetID, type AssetList, type AssetListOptions, AssetManager, type AssetMetadata, AssetNotFoundError, Auth, BearerAuth, type ContentDetails, type ContentHashResult, CoviaConnectionError, CoviaError, CoviaTimeoutError, type Credentials, CredentialsHTTP, type DIDDocument, DataAsset, type FunctionInfo, type FunctionsResult, Grid, GridError, type InvokeOptions, type InvokePayload, Job, JobFailedError, JobManager, type JobMetadata, JobNotFoundError, JobStatus, KeyPairAuth, type MCPDiscovery, NoAuth, NotFoundError, Operation, type OperationDetails, type OperationInfo, OperationManager, type OperationPayload, RunStatus, type SSEEvent, type SecretExtractInput, type SecretExtractResult, SecretManager, type SecretSetInput, type SecretSetResult, type StatsData, type StatusData, type UCANAttenuation, type UCANIssueInput, type UCANIssueResult, UCANManager, Venue, type VenueConstructor, type VenueData, type VenueInterface, type VenueOptions, type WorkspaceAppendInput, type WorkspaceAppendResult, type WorkspaceDeleteInput, type WorkspaceDeleteResult, type WorkspaceListInput, type WorkspaceListResult, WorkspaceManager, type WorkspaceReadInput, type WorkspaceReadResult, type WorkspaceSliceInput, type WorkspaceSliceResult, type WorkspaceWriteInput, type WorkspaceWriteResult, createSSEEvent, decodePublicKey, didFromPublicKey, encodePublicKey, fetchStreamWithError, fetchWithError, generateKeyPair, getAssetIdFromPath, getAssetIdFromVenueId, getParsedAssetId, hexToPrivateKey, isJobComplete, isJobFinished, isJobPaused, logger, parseSSEStream, privateKeyToHex };
+export { type AdapterInfo, type AdaptersResult, type AgentCancelTaskInput, type AgentCard, type AgentChatInput, type AgentChatResult, type AgentCreateInput, type AgentCreateResult, type AgentDeleteInput, type AgentDeleteResult, type AgentListInput, type AgentListResult, AgentManager, type AgentMessageInput, type AgentMessageResult, type AgentQueryInput, type AgentQueryResult, type AgentRequestInput, type AgentRequestResult, type AgentResumeInput, AgentStatus, type AgentSuspendResult, type AgentTriggerInput, type AgentTriggerResult, type AgentUpdateInput, Asset, type AssetID, type AssetList, type AssetListOptions, AssetManager, type AssetMetadata, AssetNotFoundError, Auth, BearerAuth, type ContentDetails, type ContentHashResult, CoviaConnectionError, CoviaError, CoviaTimeoutError, type Credentials, CredentialsHTTP, type DIDDocument, DataAsset, type FunctionInfo, type FunctionsResult, Grid, GridError, type InvokeOptions, type InvokePayload, Job, JobFailedError, JobManager, type JobMetadata, JobNotFoundError, JobStatus, KeyPairAuth, type MCPDiscovery, NoAuth, NotFoundError, Operation, type OperationDetails, type OperationInfo, OperationManager, type OperationPayload, RunStatus, type SSEEvent, type SecretExtractInput, type SecretExtractResult, SecretManager, type SecretSetInput, type SecretSetResult, type StatsData, type StatusData, type UCANAttenuation, type UCANIssueInput, type UCANIssueResult, UCANManager, Venue, type VenueConstructor, type VenueData, type VenueInterface, type VenueOptions, type WorkspaceAppendInput, type WorkspaceAppendResult, type WorkspaceDeleteInput, type WorkspaceDeleteResult, type WorkspaceListInput, type WorkspaceListResult, WorkspaceManager, type WorkspaceReadInput, type WorkspaceReadResult, type WorkspaceSliceInput, type WorkspaceSliceResult, type WorkspaceWriteInput, type WorkspaceWriteResult, createSSEEvent, decodePublicKey, didFromPublicKey, encodePublicKey, fetchStreamWithError, fetchWithError, generateKeyPair, getAssetIdFromPath, getAssetIdFromVenueId, getParsedAssetId, hexToPrivateKey, isJobComplete, isJobFinished, isJobPaused, logger, parseSSEStream, privateKeyToHex };

package/dist/index.d.ts

@@ -219,6 +219,23 @@ declare class AgentManager {
     create(input: AgentCreateInput): Promise<AgentCreateResult>;
     request(agentId: string, input?: any, wait?: boolean | number): Promise<AgentRequestResult>;
     message(agentId: string, message: any): Promise<AgentMessageResult>;
+    /**
+     * Send a message to an agent and synchronously await its next response on the session.
+     *
+     * Session lifecycle:
+     * - Omit `sessionId` on the first call — the server mints a new session and returns
+     *   its id in the result. Capture it.
+     * - Pass the returned `sessionId` on every subsequent call to continue the conversation.
+     * - An unknown `sessionId` is rejected (the server will not silently mint one); omit
+     *   the field entirely to start a new session.
+     *
+     * Concurrency: only one chat may be in flight per session. Concurrent calls on the
+     * same session are rejected by the venue.
+     *
+     * Blocking: always blocks until the agent produces its next response on the session.
+     * No polling required.
+     */
+    chat(agentId: string, message: any, sessionId?: string): Promise<AgentChatResult>;
     trigger(agentId: string): Promise<AgentTriggerResult>;
     query(agentId: string): Promise<AgentQueryResult>;
     list(includeTerminated?: boolean): Promise<AgentListResult>;
@@ -678,6 +695,16 @@ interface AgentMessageResult {
     agentId: string;
     delivered: boolean;
 }
+interface AgentChatInput {
+    agentId: string;
+    message: any;
+    sessionId?: string;
+}
+interface AgentChatResult {
+    agentId: string;
+    sessionId: string;
+    response: any;
+}
 interface AgentTriggerInput {
     agentId: string;
 }
@@ -1010,4 +1037,4 @@ declare function decodePublicKey(multikey: string): Uint8Array;
  */
 declare function didFromPublicKey(publicKey: Uint8Array): string;
 
-export { type AdapterInfo, type AdaptersResult, type AgentCancelTaskInput, type AgentCard, type AgentCreateInput, type AgentCreateResult, type AgentDeleteInput, type AgentDeleteResult, type AgentListInput, type AgentListResult, AgentManager, type AgentMessageInput, type AgentMessageResult, type AgentQueryInput, type AgentQueryResult, type AgentRequestInput, type AgentRequestResult, type AgentResumeInput, AgentStatus, type AgentSuspendResult, type AgentTriggerInput, type AgentTriggerResult, type AgentUpdateInput, Asset, type AssetID, type AssetList, type AssetListOptions, AssetManager, type AssetMetadata, AssetNotFoundError, Auth, BearerAuth, type ContentDetails, type ContentHashResult, CoviaConnectionError, CoviaError, CoviaTimeoutError, type Credentials, CredentialsHTTP, type DIDDocument, DataAsset, type FunctionInfo, type FunctionsResult, Grid, GridError, type InvokeOptions, type InvokePayload, Job, JobFailedError, JobManager, type JobMetadata, JobNotFoundError, JobStatus, KeyPairAuth, type MCPDiscovery, NoAuth, NotFoundError, Operation, type OperationDetails, type OperationInfo, OperationManager, type OperationPayload, RunStatus, type SSEEvent, type SecretExtractInput, type SecretExtractResult, SecretManager, type SecretSetInput, type SecretSetResult, type StatsData, type StatusData, type UCANAttenuation, type UCANIssueInput, type UCANIssueResult, UCANManager, Venue, type VenueConstructor, type VenueData, type VenueInterface, type VenueOptions, type WorkspaceAppendInput, type WorkspaceAppendResult, type WorkspaceDeleteInput, type WorkspaceDeleteResult, type WorkspaceListInput, type WorkspaceListResult, WorkspaceManager, type WorkspaceReadInput, type WorkspaceReadResult, type WorkspaceSliceInput, type WorkspaceSliceResult, type WorkspaceWriteInput, type WorkspaceWriteResult, createSSEEvent, decodePublicKey, didFromPublicKey, encodePublicKey, fetchStreamWithError, fetchWithError, generateKeyPair, getAssetIdFromPath, getAssetIdFromVenueId, getParsedAssetId, hexToPrivateKey, isJobComplete, isJobFinished, isJobPaused, logger, parseSSEStream, privateKeyToHex };
+export { type AdapterInfo, type AdaptersResult, type AgentCancelTaskInput, type AgentCard, type AgentChatInput, type AgentChatResult, type AgentCreateInput, type AgentCreateResult, type AgentDeleteInput, type AgentDeleteResult, type AgentListInput, type AgentListResult, AgentManager, type AgentMessageInput, type AgentMessageResult, type AgentQueryInput, type AgentQueryResult, type AgentRequestInput, type AgentRequestResult, type AgentResumeInput, AgentStatus, type AgentSuspendResult, type AgentTriggerInput, type AgentTriggerResult, type AgentUpdateInput, Asset, type AssetID, type AssetList, type AssetListOptions, AssetManager, type AssetMetadata, AssetNotFoundError, Auth, BearerAuth, type ContentDetails, type ContentHashResult, CoviaConnectionError, CoviaError, CoviaTimeoutError, type Credentials, CredentialsHTTP, type DIDDocument, DataAsset, type FunctionInfo, type FunctionsResult, Grid, GridError, type InvokeOptions, type InvokePayload, Job, JobFailedError, JobManager, type JobMetadata, JobNotFoundError, JobStatus, KeyPairAuth, type MCPDiscovery, NoAuth, NotFoundError, Operation, type OperationDetails, type OperationInfo, OperationManager, type OperationPayload, RunStatus, type SSEEvent, type SecretExtractInput, type SecretExtractResult, SecretManager, type SecretSetInput, type SecretSetResult, type StatsData, type StatusData, type UCANAttenuation, type UCANIssueInput, type UCANIssueResult, UCANManager, Venue, type VenueConstructor, type VenueData, type VenueInterface, type VenueOptions, type WorkspaceAppendInput, type WorkspaceAppendResult, type WorkspaceDeleteInput, type WorkspaceDeleteResult, type WorkspaceListInput, type WorkspaceListResult, WorkspaceManager, type WorkspaceReadInput, type WorkspaceReadResult, type WorkspaceSliceInput, type WorkspaceSliceResult, type WorkspaceWriteInput, type WorkspaceWriteResult, createSSEEvent, decodePublicKey, didFromPublicKey, encodePublicKey, fetchStreamWithError, fetchWithError, generateKeyPair, getAssetIdFromPath, getAssetIdFromVenueId, getParsedAssetId, hexToPrivateKey, isJobComplete, isJobFinished, isJobPaused, logger, parseSSEStream, privateKeyToHex };

package/dist/index.js

@@ -1350,6 +1350,25 @@ var AgentManager = class {
   async message(agentId, message) {
     return this.venue.operations.run("v/ops/agent/message", { agentId, message });
   }
+  /**
+   * Send a message to an agent and synchronously await its next response on the session.
+   *
+   * Session lifecycle:
+   * - Omit `sessionId` on the first call — the server mints a new session and returns
+   *   its id in the result. Capture it.
+   * - Pass the returned `sessionId` on every subsequent call to continue the conversation.
+   * - An unknown `sessionId` is rejected (the server will not silently mint one); omit
+   *   the field entirely to start a new session.
+   *
+   * Concurrency: only one chat may be in flight per session. Concurrent calls on the
+   * same session are rejected by the venue.
+   *
+   * Blocking: always blocks until the agent produces its next response on the session.
+   * No polling required.
+   */
+  async chat(agentId, message, sessionId) {
+    return this.venue.operations.run("v/ops/agent/chat", { agentId, message, sessionId });
+  }
   async trigger(agentId) {
     return this.venue.operations.run("v/ops/agent/trigger", { agentId });
   }

package/dist/index.mjs

@@ -1348,6 +1348,25 @@ var AgentManager = class {
   async message(agentId, message) {
     return this.venue.operations.run("v/ops/agent/message", { agentId, message });
   }
+  /**
+   * Send a message to an agent and synchronously await its next response on the session.
+   *
+   * Session lifecycle:
+   * - Omit `sessionId` on the first call — the server mints a new session and returns
+   *   its id in the result. Capture it.
+   * - Pass the returned `sessionId` on every subsequent call to continue the conversation.
+   * - An unknown `sessionId` is rejected (the server will not silently mint one); omit
+   *   the field entirely to start a new session.
+   *
+   * Concurrency: only one chat may be in flight per session. Concurrent calls on the
+   * same session are rejected by the venue.
+   *
+   * Blocking: always blocks until the agent produces its next response on the session.
+   * No polling required.
+   */
+  async chat(agentId, message, sessionId) {
+    return this.venue.operations.run("v/ops/agent/chat", { agentId, message, sessionId });
+  }
   async trigger(agentId) {
     return this.venue.operations.run("v/ops/agent/trigger", { agentId });
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@covia/covia-sdk",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Typescript library for covia-ai",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -22,7 +22,7 @@
     "test": "jest",
     "test:unit": "jest src/__tests__/",
     "test:integration": "jest venue.test.ts",
-    "prepublishOnly": "npm run build && npm test",
+    "prepublishOnly": "npm run build && npm run test:unit",
     "prepare": "npm run build"
   },
   "keywords": [