@covia/covia-sdk 1.24.1 → 1.25.0

package/README.md

@@ -408,6 +408,10 @@ await mina.delete();
 const clone = await mina.fork("Mina-v2", { includeTimeline: true });
 ```
 
+Create and fork require unused names. Use update to preserve an existing agent
+and its history. Deletion normally returns `status: "TERMINATED"`; physical
+removal (`remove: true`) returns `removed: true` without a status.
+
 #### Agent Instance
 
 | Method | Returns | Description |

package/dist/index.d.mts

@@ -46,7 +46,6 @@ declare class Agent {
     fork(agentId: string, options?: {
         config?: Record<string, unknown>;
         includeTimeline?: boolean;
-        overwrite?: boolean;
     }): Promise<Agent>;
     context(task?: unknown): Promise<string>;
     delete(remove?: boolean): Promise<AgentDeleteResult>;
@@ -1088,12 +1087,16 @@ declare class A2AManager {
      *
      * @param agent Imported agent reference — `w/a2a/agents/<name>` or its
      *   immutable `did:.../a/<hash>` id.
-     * @param message An A2A Message: `{ role, parts, messageId? }`.
+     * @param message An A2A Message: `{ role, parts, messageId?, contextId? }`.
      * @param options.taskId Continue an existing remote Task instead of
-     *   starting a new one.
+     *   starting a new one. Only a non-terminal Task can be continued — a
+     *   finished Task is immutable and the remote agent rejects the message.
+     * @param options.contextId Start a new Task in an existing conversation,
+     *   e.g. to follow up once a Task has finished. Sets `message.contextId`.
      */
     send(agent: string, message: A2AMessage, options?: {
         taskId?: string;
+        contextId?: string;
     }): Promise<Job>;
 }
 
@@ -1722,19 +1725,16 @@ declare enum AgentStatus {
     SUSPENDED = "SUSPENDED",
     TERMINATED = "TERMINATED"
 }
+/** Creates a new name only. Use update to preserve an existing agent and its history. */
 interface AgentCreateInput {
     agentId: string;
     config?: Record<string, any>;
     state?: Record<string, any>;
-    overwrite?: boolean;
 }
 interface AgentCreateResult {
     agentId: string;
     status: string;
-    created: boolean;
-    /** True when an existing SLEEPING/SUSPENDED record was updated in place
-     *  (mutually exclusive with created). Absent on venues before 0.4. */
-    updated?: boolean;
+    address?: string;
     /** Non-fatal advisories (venue 0.5+): present only when the config looks
      *  misconfigured but create still succeeded — e.g. an Ollama model whose
      *  tool-calling can't be confirmed, or declared tools that don't resolve
@@ -1807,7 +1807,9 @@ interface AgentDeleteInput {
 }
 interface AgentDeleteResult {
     agentId: string;
-    status: string;
+    address?: string;
+    /** Present on logical termination; absent on physical removal. */
+    status?: string;
     removed?: boolean;
 }
 interface AgentSuspendResult {
@@ -1936,17 +1938,17 @@ interface AgentSessionPage {
     offset: number;
     limit: number;
 }
+/** Forks into an unused name; replacement requires explicit deletion first. */
 interface AgentForkInput {
     sourceId: string;
     agentId: string;
     config?: Record<string, any>;
     includeTimeline?: boolean;
-    overwrite?: boolean;
 }
 interface AgentForkResult {
     agentId: string;
+    address?: string;
     status: string;
-    created: boolean;
     forkedFrom: string;
 }
 interface AgentContextInput {
@@ -2507,6 +2509,8 @@ interface A2AMessage {
     role: string;
     parts: A2APart[];
     messageId?: string;
+    /** The conversation this message belongs to — a remote Task's `contextId`. */
+    contextId?: string;
 }
 /** The remote A2A Task snapshot a send mirrors onto the local Job's output —
  *  final when the Job reaches a terminal state, a live snapshot while paused. */
@@ -2839,4 +2843,5 @@ declare function relayDelegation(privateKey: Uint8Array, venueDID: string, lifet
 /** {@link relayDelegation} through an {@link Ed25519Signer}. */
 declare function relayDelegationWith(signer: Ed25519Signer, venueDID: string, lifetimeSeconds: number, caps?: UCANCapability[]): Promise<string>;
 
-export { type A2AAuthRef, type A2AImportAgentInput, type A2AImportAgentResult, A2AManager, type A2AMessage, type A2APart, type A2ATask, type AdapterInfo, AdapterManager, type AdaptersResult, Agent, type AgentAwaiting, type AgentCancelTaskInput, type AgentCard, type AgentChatInput, type AgentChatResult, type AgentCompactedSegment, type AgentCompleteTaskResult, type AgentContextInput, type AgentCreateInput, type AgentCreateResult, type AgentCycleEndEvent, type AgentCycleStartEvent, type AgentDeleteInput, type AgentDeleteResult, type AgentEvent, type AgentEventEnvelope, type AgentFailTaskResult, type AgentForkInput, type AgentForkResult, type AgentInferenceEndEvent, type AgentInferenceStartEvent, type AgentInfoResult, type AgentListInput, type AgentListResult, AgentManager, type AgentMessageInput, type AgentMessageResult, type AgentRenameSessionResult, type AgentRequestInput, type AgentRequestResult, type AgentResumeInput, type AgentRunEndEvent, type AgentRunStartEvent, type AgentSession, type AgentSessionListOptions, type AgentSessionMessage, type AgentSessionMetadata, AgentSessionNotFoundError, type AgentSessionPage, type AgentSessionRole, AgentStatus, type AgentStatusEvent, type AgentSuspendResult, type AgentToolResultEvent, type AgentToolStartEvent, type AgentTriggerInput, type AgentTriggerResult, type AgentUpdateInput, Asset, type AssetID, type AssetList, type AssetListItem, type AssetListOptions, AssetManager, type AssetMetadata, type AssetMetadataStore, AssetNotFoundError, type AssetPinResult, type AssetSummary, Auth, type AuthenticationKeyEntry, type AuthenticationKeysMap, type AuthenticationKeysResult, type AuthenticatorRevokeResult, BasicAuth, BearerAuth, type CatalogListOptions, ChatSession, type ConnectionAttempt, type ContentDetails, type ContentHashResult, CoviaConnectionError, type CoviaConnectionErrorOptions, CoviaError, CoviaTimeoutError, type Credentials, CredentialsHTTP, type DIDDocument, type DIDURL, type DLFSDrivesResult, type DLFSEntry, type DLFSListResult, DLFSManager, DataAsset, Ed25519Auth, type Ed25519Signer, type ExecutionScope, type ExpandedAssetList, type FunctionInfo, type FunctionsResult, Grid, GridError, type GroupCount, type InvokeOptions, type InvokePayload, Job, JobFailedError, type JobHistoryOptions, type JobHistoryPage, JobManager, type JobMetadata, JobNotFoundError, JobStatus, KeyPairAuth, type MCPContent, type MCPDiscovery, MCPError, MCPManager, type MCPTool, type MCPToolPage, type MCPToolResult, type MemoryChange, type MemoryEntry, MemoryManager, type MyAssetList, Namespace, NoAuth, NotFoundError, Operation, type OperationDetails, type OperationInfo, OperationManager, type OperationPayload, type OperationRunner, type PublicCaps, RateLimitError, RunStatus, type SSEEvent, ScopedWorkspace, type SecretExtractInput, type SecretExtractResult, SecretManager, type SecretSetInput, type SecretSetResult, type Skill, type SkillFacet, SkillManager, type SkillMetadata, type StatsData, type StatusAccess, type StatusData, type UCANAttenuation, type UCANCapability, type UCANIssueInput, type UCANIssueResult, UCANManager, type UCANVerifyResult, UnsupportedVenueFeatureError, type UserInfo, type UserListResult, UserManager, type UserSummary, VENUE_RELAY, Venue, type VenueConstructor, type VenueData, VenueIdentityChangedError, type VenueInterface, type VenueOptions, type WorkspaceAggregateResult, type WorkspaceAppendInput, type WorkspaceAppendResult, type WorkspaceCopyResult, type WorkspaceCountResult, type WorkspaceDeleteInput, type WorkspaceDeleteResult, type WorkspaceFieldValue, type WorkspaceInspectInput, type WorkspaceInspectResult, type WorkspaceListInput, type WorkspaceListResult, WorkspaceManager, type WorkspaceProjectedList, type WorkspaceReadInput, type WorkspaceReadResult, type WorkspaceSliceInput, type WorkspaceSliceResult, type WorkspaceWriteInput, type WorkspaceWriteResult, assetHash, createSSEEvent, createUCANJWT, createUCANJWTWith, decodePublicKey, didFor, didFromPublicKey, didMethod, didUrl, encodePublicKey, fetchStreamWithError, fetchWithError, generateKeyPair, generateNonExtractableKeyPair, getAssetIdFromPath, getAssetIdFromVenueId, getAssetMetadataStore, getParsedAssetId, grant, grantWith, hexToPrivateKey, identityToken, importNonExtractableKey, isDid, isJobComplete, isJobFinished, isJobPaused, isWebCryptoEd25519Supported, logger, parseDidUrl, parseRetryAfterMs, parseSSEStream, privateKeyToHex, rawKeySigner, relayDelegation, relayDelegationWith, retryDelayMs, setAssetMetadataStore, venueBaseUrlCandidates, webCryptoSigner };
+export { A2AManager, AdapterManager, Agent, AgentManager, AgentSessionNotFoundError, AgentStatus, Asset, AssetManager, AssetNotFoundError, Auth, BasicAuth, BearerAuth, ChatSession, CoviaConnectionError, CoviaError, CoviaTimeoutError, CredentialsHTTP, DLFSManager, DataAsset, Ed25519Auth, Grid, GridError, Job, JobFailedError, JobManager, JobNotFoundError, JobStatus, KeyPairAuth, MCPError, MCPManager, MemoryManager, Namespace, NoAuth, NotFoundError, Operation, OperationManager, RateLimitError, RunStatus, ScopedWorkspace, SecretManager, SkillManager, UCANManager, UnsupportedVenueFeatureError, UserManager, VENUE_RELAY, Venue, VenueIdentityChangedError, WorkspaceManager, assetHash, createSSEEvent, createUCANJWT, createUCANJWTWith, decodePublicKey, didFor, didFromPublicKey, didMethod, didUrl, encodePublicKey, fetchStreamWithError, fetchWithError, generateKeyPair, generateNonExtractableKeyPair, getAssetIdFromPath, getAssetIdFromVenueId, getAssetMetadataStore, getParsedAssetId, grant, grantWith, hexToPrivateKey, identityToken, importNonExtractableKey, isDid, isJobComplete, isJobFinished, isJobPaused, isWebCryptoEd25519Supported, logger, parseDidUrl, parseRetryAfterMs, parseSSEStream, privateKeyToHex, rawKeySigner, relayDelegation, relayDelegationWith, retryDelayMs, setAssetMetadataStore, venueBaseUrlCandidates, webCryptoSigner };
+export type { A2AAuthRef, A2AImportAgentInput, A2AImportAgentResult, A2AMessage, A2APart, A2ATask, AdapterInfo, AdaptersResult, AgentAwaiting, AgentCancelTaskInput, AgentCard, AgentChatInput, AgentChatResult, AgentCompactedSegment, AgentCompleteTaskResult, AgentContextInput, AgentCreateInput, AgentCreateResult, AgentCycleEndEvent, AgentCycleStartEvent, AgentDeleteInput, AgentDeleteResult, AgentEvent, AgentEventEnvelope, AgentFailTaskResult, AgentForkInput, AgentForkResult, AgentInferenceEndEvent, AgentInferenceStartEvent, AgentInfoResult, AgentListInput, AgentListResult, AgentMessageInput, AgentMessageResult, AgentRenameSessionResult, AgentRequestInput, AgentRequestResult, AgentResumeInput, AgentRunEndEvent, AgentRunStartEvent, AgentSession, AgentSessionListOptions, AgentSessionMessage, AgentSessionMetadata, AgentSessionPage, AgentSessionRole, AgentStatusEvent, AgentSuspendResult, AgentToolResultEvent, AgentToolStartEvent, AgentTriggerInput, AgentTriggerResult, AgentUpdateInput, AssetID, AssetList, AssetListItem, AssetListOptions, AssetMetadata, AssetMetadataStore, AssetPinResult, AssetSummary, AuthenticationKeyEntry, AuthenticationKeysMap, AuthenticationKeysResult, AuthenticatorRevokeResult, CatalogListOptions, ConnectionAttempt, ContentDetails, ContentHashResult, CoviaConnectionErrorOptions, Credentials, DIDDocument, DIDURL, DLFSDrivesResult, DLFSEntry, DLFSListResult, Ed25519Signer, ExecutionScope, ExpandedAssetList, FunctionInfo, FunctionsResult, GroupCount, InvokeOptions, InvokePayload, JobHistoryOptions, JobHistoryPage, JobMetadata, MCPContent, MCPDiscovery, MCPTool, MCPToolPage, MCPToolResult, MemoryChange, MemoryEntry, MyAssetList, OperationDetails, OperationInfo, OperationPayload, OperationRunner, PublicCaps, SSEEvent, SecretExtractInput, SecretExtractResult, SecretSetInput, SecretSetResult, Skill, SkillFacet, SkillMetadata, StatsData, StatusAccess, StatusData, UCANAttenuation, UCANCapability, UCANIssueInput, UCANIssueResult, UCANVerifyResult, UserInfo, UserListResult, UserSummary, VenueConstructor, VenueData, VenueInterface, VenueOptions, WorkspaceAggregateResult, WorkspaceAppendInput, WorkspaceAppendResult, WorkspaceCopyResult, WorkspaceCountResult, WorkspaceDeleteInput, WorkspaceDeleteResult, WorkspaceFieldValue, WorkspaceInspectInput, WorkspaceInspectResult, WorkspaceListInput, WorkspaceListResult, WorkspaceProjectedList, WorkspaceReadInput, WorkspaceReadResult, WorkspaceSliceInput, WorkspaceSliceResult, WorkspaceWriteInput, WorkspaceWriteResult };

package/dist/index.d.ts

@@ -46,7 +46,6 @@ declare class Agent {
     fork(agentId: string, options?: {
         config?: Record<string, unknown>;
         includeTimeline?: boolean;
-        overwrite?: boolean;
     }): Promise<Agent>;
     context(task?: unknown): Promise<string>;
     delete(remove?: boolean): Promise<AgentDeleteResult>;
@@ -1088,12 +1087,16 @@ declare class A2AManager {
      *
      * @param agent Imported agent reference — `w/a2a/agents/<name>` or its
      *   immutable `did:.../a/<hash>` id.
-     * @param message An A2A Message: `{ role, parts, messageId? }`.
+     * @param message An A2A Message: `{ role, parts, messageId?, contextId? }`.
      * @param options.taskId Continue an existing remote Task instead of
-     *   starting a new one.
+     *   starting a new one. Only a non-terminal Task can be continued — a
+     *   finished Task is immutable and the remote agent rejects the message.
+     * @param options.contextId Start a new Task in an existing conversation,
+     *   e.g. to follow up once a Task has finished. Sets `message.contextId`.
      */
     send(agent: string, message: A2AMessage, options?: {
         taskId?: string;
+        contextId?: string;
     }): Promise<Job>;
 }
 
@@ -1722,19 +1725,16 @@ declare enum AgentStatus {
     SUSPENDED = "SUSPENDED",
     TERMINATED = "TERMINATED"
 }
+/** Creates a new name only. Use update to preserve an existing agent and its history. */
 interface AgentCreateInput {
     agentId: string;
     config?: Record<string, any>;
     state?: Record<string, any>;
-    overwrite?: boolean;
 }
 interface AgentCreateResult {
     agentId: string;
     status: string;
-    created: boolean;
-    /** True when an existing SLEEPING/SUSPENDED record was updated in place
-     *  (mutually exclusive with created). Absent on venues before 0.4. */
-    updated?: boolean;
+    address?: string;
     /** Non-fatal advisories (venue 0.5+): present only when the config looks
      *  misconfigured but create still succeeded — e.g. an Ollama model whose
      *  tool-calling can't be confirmed, or declared tools that don't resolve
@@ -1807,7 +1807,9 @@ interface AgentDeleteInput {
 }
 interface AgentDeleteResult {
     agentId: string;
-    status: string;
+    address?: string;
+    /** Present on logical termination; absent on physical removal. */
+    status?: string;
     removed?: boolean;
 }
 interface AgentSuspendResult {
@@ -1936,17 +1938,17 @@ interface AgentSessionPage {
     offset: number;
     limit: number;
 }
+/** Forks into an unused name; replacement requires explicit deletion first. */
 interface AgentForkInput {
     sourceId: string;
     agentId: string;
     config?: Record<string, any>;
     includeTimeline?: boolean;
-    overwrite?: boolean;
 }
 interface AgentForkResult {
     agentId: string;
+    address?: string;
     status: string;
-    created: boolean;
     forkedFrom: string;
 }
 interface AgentContextInput {
@@ -2507,6 +2509,8 @@ interface A2AMessage {
     role: string;
     parts: A2APart[];
     messageId?: string;
+    /** The conversation this message belongs to — a remote Task's `contextId`. */
+    contextId?: string;
 }
 /** The remote A2A Task snapshot a send mirrors onto the local Job's output —
  *  final when the Job reaches a terminal state, a live snapshot while paused. */
@@ -2839,4 +2843,5 @@ declare function relayDelegation(privateKey: Uint8Array, venueDID: string, lifet
 /** {@link relayDelegation} through an {@link Ed25519Signer}. */
 declare function relayDelegationWith(signer: Ed25519Signer, venueDID: string, lifetimeSeconds: number, caps?: UCANCapability[]): Promise<string>;
 
-export { type A2AAuthRef, type A2AImportAgentInput, type A2AImportAgentResult, A2AManager, type A2AMessage, type A2APart, type A2ATask, type AdapterInfo, AdapterManager, type AdaptersResult, Agent, type AgentAwaiting, type AgentCancelTaskInput, type AgentCard, type AgentChatInput, type AgentChatResult, type AgentCompactedSegment, type AgentCompleteTaskResult, type AgentContextInput, type AgentCreateInput, type AgentCreateResult, type AgentCycleEndEvent, type AgentCycleStartEvent, type AgentDeleteInput, type AgentDeleteResult, type AgentEvent, type AgentEventEnvelope, type AgentFailTaskResult, type AgentForkInput, type AgentForkResult, type AgentInferenceEndEvent, type AgentInferenceStartEvent, type AgentInfoResult, type AgentListInput, type AgentListResult, AgentManager, type AgentMessageInput, type AgentMessageResult, type AgentRenameSessionResult, type AgentRequestInput, type AgentRequestResult, type AgentResumeInput, type AgentRunEndEvent, type AgentRunStartEvent, type AgentSession, type AgentSessionListOptions, type AgentSessionMessage, type AgentSessionMetadata, AgentSessionNotFoundError, type AgentSessionPage, type AgentSessionRole, AgentStatus, type AgentStatusEvent, type AgentSuspendResult, type AgentToolResultEvent, type AgentToolStartEvent, type AgentTriggerInput, type AgentTriggerResult, type AgentUpdateInput, Asset, type AssetID, type AssetList, type AssetListItem, type AssetListOptions, AssetManager, type AssetMetadata, type AssetMetadataStore, AssetNotFoundError, type AssetPinResult, type AssetSummary, Auth, type AuthenticationKeyEntry, type AuthenticationKeysMap, type AuthenticationKeysResult, type AuthenticatorRevokeResult, BasicAuth, BearerAuth, type CatalogListOptions, ChatSession, type ConnectionAttempt, type ContentDetails, type ContentHashResult, CoviaConnectionError, type CoviaConnectionErrorOptions, CoviaError, CoviaTimeoutError, type Credentials, CredentialsHTTP, type DIDDocument, type DIDURL, type DLFSDrivesResult, type DLFSEntry, type DLFSListResult, DLFSManager, DataAsset, Ed25519Auth, type Ed25519Signer, type ExecutionScope, type ExpandedAssetList, type FunctionInfo, type FunctionsResult, Grid, GridError, type GroupCount, type InvokeOptions, type InvokePayload, Job, JobFailedError, type JobHistoryOptions, type JobHistoryPage, JobManager, type JobMetadata, JobNotFoundError, JobStatus, KeyPairAuth, type MCPContent, type MCPDiscovery, MCPError, MCPManager, type MCPTool, type MCPToolPage, type MCPToolResult, type MemoryChange, type MemoryEntry, MemoryManager, type MyAssetList, Namespace, NoAuth, NotFoundError, Operation, type OperationDetails, type OperationInfo, OperationManager, type OperationPayload, type OperationRunner, type PublicCaps, RateLimitError, RunStatus, type SSEEvent, ScopedWorkspace, type SecretExtractInput, type SecretExtractResult, SecretManager, type SecretSetInput, type SecretSetResult, type Skill, type SkillFacet, SkillManager, type SkillMetadata, type StatsData, type StatusAccess, type StatusData, type UCANAttenuation, type UCANCapability, type UCANIssueInput, type UCANIssueResult, UCANManager, type UCANVerifyResult, UnsupportedVenueFeatureError, type UserInfo, type UserListResult, UserManager, type UserSummary, VENUE_RELAY, Venue, type VenueConstructor, type VenueData, VenueIdentityChangedError, type VenueInterface, type VenueOptions, type WorkspaceAggregateResult, type WorkspaceAppendInput, type WorkspaceAppendResult, type WorkspaceCopyResult, type WorkspaceCountResult, type WorkspaceDeleteInput, type WorkspaceDeleteResult, type WorkspaceFieldValue, type WorkspaceInspectInput, type WorkspaceInspectResult, type WorkspaceListInput, type WorkspaceListResult, WorkspaceManager, type WorkspaceProjectedList, type WorkspaceReadInput, type WorkspaceReadResult, type WorkspaceSliceInput, type WorkspaceSliceResult, type WorkspaceWriteInput, type WorkspaceWriteResult, assetHash, createSSEEvent, createUCANJWT, createUCANJWTWith, decodePublicKey, didFor, didFromPublicKey, didMethod, didUrl, encodePublicKey, fetchStreamWithError, fetchWithError, generateKeyPair, generateNonExtractableKeyPair, getAssetIdFromPath, getAssetIdFromVenueId, getAssetMetadataStore, getParsedAssetId, grant, grantWith, hexToPrivateKey, identityToken, importNonExtractableKey, isDid, isJobComplete, isJobFinished, isJobPaused, isWebCryptoEd25519Supported, logger, parseDidUrl, parseRetryAfterMs, parseSSEStream, privateKeyToHex, rawKeySigner, relayDelegation, relayDelegationWith, retryDelayMs, setAssetMetadataStore, venueBaseUrlCandidates, webCryptoSigner };
+export { A2AManager, AdapterManager, Agent, AgentManager, AgentSessionNotFoundError, AgentStatus, Asset, AssetManager, AssetNotFoundError, Auth, BasicAuth, BearerAuth, ChatSession, CoviaConnectionError, CoviaError, CoviaTimeoutError, CredentialsHTTP, DLFSManager, DataAsset, Ed25519Auth, Grid, GridError, Job, JobFailedError, JobManager, JobNotFoundError, JobStatus, KeyPairAuth, MCPError, MCPManager, MemoryManager, Namespace, NoAuth, NotFoundError, Operation, OperationManager, RateLimitError, RunStatus, ScopedWorkspace, SecretManager, SkillManager, UCANManager, UnsupportedVenueFeatureError, UserManager, VENUE_RELAY, Venue, VenueIdentityChangedError, WorkspaceManager, assetHash, createSSEEvent, createUCANJWT, createUCANJWTWith, decodePublicKey, didFor, didFromPublicKey, didMethod, didUrl, encodePublicKey, fetchStreamWithError, fetchWithError, generateKeyPair, generateNonExtractableKeyPair, getAssetIdFromPath, getAssetIdFromVenueId, getAssetMetadataStore, getParsedAssetId, grant, grantWith, hexToPrivateKey, identityToken, importNonExtractableKey, isDid, isJobComplete, isJobFinished, isJobPaused, isWebCryptoEd25519Supported, logger, parseDidUrl, parseRetryAfterMs, parseSSEStream, privateKeyToHex, rawKeySigner, relayDelegation, relayDelegationWith, retryDelayMs, setAssetMetadataStore, venueBaseUrlCandidates, webCryptoSigner };
+export type { A2AAuthRef, A2AImportAgentInput, A2AImportAgentResult, A2AMessage, A2APart, A2ATask, AdapterInfo, AdaptersResult, AgentAwaiting, AgentCancelTaskInput, AgentCard, AgentChatInput, AgentChatResult, AgentCompactedSegment, AgentCompleteTaskResult, AgentContextInput, AgentCreateInput, AgentCreateResult, AgentCycleEndEvent, AgentCycleStartEvent, AgentDeleteInput, AgentDeleteResult, AgentEvent, AgentEventEnvelope, AgentFailTaskResult, AgentForkInput, AgentForkResult, AgentInferenceEndEvent, AgentInferenceStartEvent, AgentInfoResult, AgentListInput, AgentListResult, AgentMessageInput, AgentMessageResult, AgentRenameSessionResult, AgentRequestInput, AgentRequestResult, AgentResumeInput, AgentRunEndEvent, AgentRunStartEvent, AgentSession, AgentSessionListOptions, AgentSessionMessage, AgentSessionMetadata, AgentSessionPage, AgentSessionRole, AgentStatusEvent, AgentSuspendResult, AgentToolResultEvent, AgentToolStartEvent, AgentTriggerInput, AgentTriggerResult, AgentUpdateInput, AssetID, AssetList, AssetListItem, AssetListOptions, AssetMetadata, AssetMetadataStore, AssetPinResult, AssetSummary, AuthenticationKeyEntry, AuthenticationKeysMap, AuthenticationKeysResult, AuthenticatorRevokeResult, CatalogListOptions, ConnectionAttempt, ContentDetails, ContentHashResult, CoviaConnectionErrorOptions, Credentials, DIDDocument, DIDURL, DLFSDrivesResult, DLFSEntry, DLFSListResult, Ed25519Signer, ExecutionScope, ExpandedAssetList, FunctionInfo, FunctionsResult, GroupCount, InvokeOptions, InvokePayload, JobHistoryOptions, JobHistoryPage, JobMetadata, MCPContent, MCPDiscovery, MCPTool, MCPToolPage, MCPToolResult, MemoryChange, MemoryEntry, MyAssetList, OperationDetails, OperationInfo, OperationPayload, OperationRunner, PublicCaps, SSEEvent, SecretExtractInput, SecretExtractResult, SecretSetInput, SecretSetResult, Skill, SkillFacet, SkillMetadata, StatsData, StatusAccess, StatusData, UCANAttenuation, UCANCapability, UCANIssueInput, UCANIssueResult, UCANVerifyResult, UserInfo, UserListResult, UserSummary, VenueConstructor, VenueData, VenueInterface, VenueOptions, WorkspaceAggregateResult, WorkspaceAppendInput, WorkspaceAppendResult, WorkspaceCopyResult, WorkspaceCountResult, WorkspaceDeleteInput, WorkspaceDeleteResult, WorkspaceFieldValue, WorkspaceInspectInput, WorkspaceInspectResult, WorkspaceListInput, WorkspaceListResult, WorkspaceProjectedList, WorkspaceReadInput, WorkspaceReadResult, WorkspaceSliceInput, WorkspaceSliceResult, WorkspaceWriteInput, WorkspaceWriteResult };

package/dist/index.js

@@ -3518,14 +3518,17 @@ var A2AManager = class {
    *
    * @param agent Imported agent reference — `w/a2a/agents/<name>` or its
    *   immutable `did:.../a/<hash>` id.
-   * @param message An A2A Message: `{ role, parts, messageId? }`.
+   * @param message An A2A Message: `{ role, parts, messageId?, contextId? }`.
    * @param options.taskId Continue an existing remote Task instead of
-   *   starting a new one.
+   *   starting a new one. Only a non-terminal Task can be continued — a
+   *   finished Task is immutable and the remote agent rejects the message.
+   * @param options.contextId Start a new Task in an existing conversation,
+   *   e.g. to follow up once a Task has finished. Sets `message.contextId`.
    */
   async send(agent, message, options) {
     return this.venue.operations.invoke(SEND_OP, {
       agent,
-      message,
+      message: options?.contextId !== void 0 ? { ...message, contextId: options.contextId } : message,
       ...options?.taskId !== void 0 && { taskId: options.taskId }
     });
   }

package/dist/index.mjs

@@ -3516,14 +3516,17 @@ var A2AManager = class {
    *
    * @param agent Imported agent reference — `w/a2a/agents/<name>` or its
    *   immutable `did:.../a/<hash>` id.
-   * @param message An A2A Message: `{ role, parts, messageId? }`.
+   * @param message An A2A Message: `{ role, parts, messageId?, contextId? }`.
    * @param options.taskId Continue an existing remote Task instead of
-   *   starting a new one.
+   *   starting a new one. Only a non-terminal Task can be continued — a
+   *   finished Task is immutable and the remote agent rejects the message.
+   * @param options.contextId Start a new Task in an existing conversation,
+   *   e.g. to follow up once a Task has finished. Sets `message.contextId`.
    */
   async send(agent, message, options) {
     return this.venue.operations.invoke(SEND_OP, {
       agent,
-      message,
+      message: options?.contextId !== void 0 ? { ...message, contextId: options.contextId } : message,
       ...options?.taskId !== void 0 && { taskId: options.taskId }
     });
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@covia/covia-sdk",
-  "version": "1.24.1",
+  "version": "1.25.0",
   "description": "Typescript library for covia-ai",
   "packageManager": "pnpm@11.9.0",
   "main": "./dist/index.js",
@@ -61,7 +61,7 @@
     "eslint": "^10.6.0",
     "jest": "^30.4.2",
     "ts-jest": "^29.4.11",
-    "tsup": "^8.0.0",
+    "tsup": "^9.0.0",
     "typescript": "^6.0.0",
     "typescript-eslint": "^8.62.1"
   },