@covia/covia-sdk 1.7.3 → 1.8.0

package/dist/index.d.mts

@@ -367,6 +367,13 @@ declare class AgentManager {
      * No polling required.
      */
     chat(agentId: string, message: unknown, sessionId?: string): Promise<AgentChatResult>;
+    /**
+     * Set (or clear, by omitting `title` / passing an empty string) a
+     * session's free-form human-facing title — persisted on the venue in
+     * the session's own metadata, visible to every client and party in the
+     * session (not a per-browser local override).
+     */
+    renameSession(agentId: string, sessionId: string, title?: string): Promise<AgentRenameSessionResult>;
     trigger(agentId: string): Promise<AgentTriggerResult>;
     /**
      * List the caller's agents. **Job-free** on covia ≥ 0.4: goes through
@@ -1083,6 +1090,12 @@ interface AgentSuspendResult {
     agentId: string;
     status: string;
 }
+interface AgentRenameSessionResult {
+    agentId: string;
+    sessionId: string;
+    /** Absent when the title was cleared (an omitted/blank title on the call). */
+    title?: string;
+}
 interface AgentResumeInput {
     agentId: string;
     autoWake?: boolean;
@@ -1645,16 +1658,20 @@ interface UCANCapability {
 /** The did:key DID for a private key. */
 declare function didFor(privateKey: Uint8Array): string;
 /**
- * Mint a UCAN as an EdDSA JWT: `{iss, aud, att, exp[, prf]}` signed by
- * `privateKey` (iss = its did:key).
+ * Mint a UCAN as an EdDSA JWT in the Convex UCAN JWT profile:
+ * `{iss, aud, ucv, att, prf, exp}` signed by `privateKey` (iss = its did:key).
+ * From Convex 0.8.11 venues parse only this profile: the `ucv` claim and the
+ * `att`/`prf` arrays are always present, and the `exp` key is always present —
+ * explicitly `null` for a non-expiring token (UCAN v0.10.0; an absent `exp`
+ * is malformed).
  *
  * @param privateKey 32-byte Ed25519 private key (the issuer)
  * @param audienceDID who receives the token (`aud`)
  * @param att capabilities delegated (empty array = pure identity token)
- * @param lifetimeSeconds validity window
+ * @param lifetimeSeconds validity window, or `null` for a non-expiring token
  * @param proofs parent UCAN JWT strings (`prf`) for delegation chains
  */
-declare function createUCANJWT(privateKey: Uint8Array, audienceDID: string, att: UCANCapability[], lifetimeSeconds: number, proofs?: string[]): string;
+declare function createUCANJWT(privateKey: Uint8Array, audienceDID: string, att: UCANCapability[], lifetimeSeconds: number | null, proofs?: string[]): string;
 /**
  * Mint an **identity token**: a UCAN with an EMPTY attenuation list, audienced
  * to `venueDID`. Pure proof of identity — it grants nothing, and being
@@ -1680,4 +1697,4 @@ declare function grant(ownerPrivateKey: Uint8Array, audienceDID: string, withRes
  */
 declare function relayDelegation(privateKey: Uint8Array, venueDID: string, lifetimeSeconds: number, caps?: UCANCapability[]): string;
 
-export { type AdapterInfo, AdapterManager, type AdaptersResult, Agent, type AgentCancelTaskInput, type AgentCard, type AgentChatInput, type AgentChatResult, type AgentCompleteTaskResult, type AgentContextInput, type AgentCreateInput, type AgentCreateResult, type AgentDeleteInput, type AgentDeleteResult, type AgentFailTaskResult, type AgentForkInput, type AgentForkResult, type AgentInfoResult, type AgentListInput, type AgentListResult, AgentManager, type AgentMessageInput, type AgentMessageResult, 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, type AssetMetadataStore, AssetNotFoundError, type AssetPinResult, Auth, BasicAuth, BearerAuth, ChatSession, type ConnectionAttempt, type ContentDetails, type ContentHashResult, CoviaConnectionError, type CoviaConnectionErrorOptions, CoviaError, CoviaTimeoutError, type Credentials, CredentialsHTTP, type DIDDocument, type DIDURL, DataAsset, Ed25519Auth, type FunctionInfo, type FunctionsResult, Grid, GridError, type GroupCount, type InvokeOptions, type InvokePayload, Job, JobFailedError, JobManager, type JobMetadata, JobNotFoundError, JobStatus, KeyPairAuth, type MCPDiscovery, Namespace, NoAuth, NotFoundError, Operation, type OperationDetails, type OperationInfo, OperationManager, type OperationPayload, type OperationRunner, RateLimitError, RunStatus, type SSEEvent, type SecretExtractInput, type SecretExtractResult, SecretManager, type SecretSetInput, type SecretSetResult, type StatsData, type StatusData, type UCANAttenuation, type UCANCapability, type UCANIssueInput, type UCANIssueResult, UCANManager, type UCANVerifyResult, 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 WorkspaceInspectInput, type WorkspaceInspectResult, type WorkspaceListInput, type WorkspaceListResult, WorkspaceManager, type WorkspaceReadInput, type WorkspaceReadResult, type WorkspaceSliceInput, type WorkspaceSliceResult, type WorkspaceWriteInput, type WorkspaceWriteResult, assetHash, createSSEEvent, createUCANJWT, decodePublicKey, didFor, didFromPublicKey, didMethod, didUrl, encodePublicKey, fetchStreamWithError, fetchWithError, generateKeyPair, getAssetIdFromPath, getAssetIdFromVenueId, getAssetMetadataStore, getParsedAssetId, grant, hexToPrivateKey, identityToken, isDid, isJobComplete, isJobFinished, isJobPaused, logger, parseDidUrl, parseRetryAfterMs, parseSSEStream, privateKeyToHex, relayDelegation, retryDelayMs, setAssetMetadataStore, venueBaseUrlCandidates };
+export { type AdapterInfo, AdapterManager, type AdaptersResult, Agent, type AgentCancelTaskInput, type AgentCard, type AgentChatInput, type AgentChatResult, type AgentCompleteTaskResult, type AgentContextInput, type AgentCreateInput, type AgentCreateResult, type AgentDeleteInput, type AgentDeleteResult, type AgentFailTaskResult, type AgentForkInput, type AgentForkResult, type AgentInfoResult, type AgentListInput, type AgentListResult, AgentManager, type AgentMessageInput, type AgentMessageResult, type AgentRenameSessionResult, 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, type AssetMetadataStore, AssetNotFoundError, type AssetPinResult, Auth, BasicAuth, BearerAuth, ChatSession, type ConnectionAttempt, type ContentDetails, type ContentHashResult, CoviaConnectionError, type CoviaConnectionErrorOptions, CoviaError, CoviaTimeoutError, type Credentials, CredentialsHTTP, type DIDDocument, type DIDURL, DataAsset, Ed25519Auth, type FunctionInfo, type FunctionsResult, Grid, GridError, type GroupCount, type InvokeOptions, type InvokePayload, Job, JobFailedError, JobManager, type JobMetadata, JobNotFoundError, JobStatus, KeyPairAuth, type MCPDiscovery, Namespace, NoAuth, NotFoundError, Operation, type OperationDetails, type OperationInfo, OperationManager, type OperationPayload, type OperationRunner, RateLimitError, RunStatus, type SSEEvent, type SecretExtractInput, type SecretExtractResult, SecretManager, type SecretSetInput, type SecretSetResult, type StatsData, type StatusData, type UCANAttenuation, type UCANCapability, type UCANIssueInput, type UCANIssueResult, UCANManager, type UCANVerifyResult, 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 WorkspaceInspectInput, type WorkspaceInspectResult, type WorkspaceListInput, type WorkspaceListResult, WorkspaceManager, type WorkspaceReadInput, type WorkspaceReadResult, type WorkspaceSliceInput, type WorkspaceSliceResult, type WorkspaceWriteInput, type WorkspaceWriteResult, assetHash, createSSEEvent, createUCANJWT, decodePublicKey, didFor, didFromPublicKey, didMethod, didUrl, encodePublicKey, fetchStreamWithError, fetchWithError, generateKeyPair, getAssetIdFromPath, getAssetIdFromVenueId, getAssetMetadataStore, getParsedAssetId, grant, hexToPrivateKey, identityToken, isDid, isJobComplete, isJobFinished, isJobPaused, logger, parseDidUrl, parseRetryAfterMs, parseSSEStream, privateKeyToHex, relayDelegation, retryDelayMs, setAssetMetadataStore, venueBaseUrlCandidates };

package/dist/index.d.ts

@@ -367,6 +367,13 @@ declare class AgentManager {
      * No polling required.
      */
     chat(agentId: string, message: unknown, sessionId?: string): Promise<AgentChatResult>;
+    /**
+     * Set (or clear, by omitting `title` / passing an empty string) a
+     * session's free-form human-facing title — persisted on the venue in
+     * the session's own metadata, visible to every client and party in the
+     * session (not a per-browser local override).
+     */
+    renameSession(agentId: string, sessionId: string, title?: string): Promise<AgentRenameSessionResult>;
     trigger(agentId: string): Promise<AgentTriggerResult>;
     /**
      * List the caller's agents. **Job-free** on covia ≥ 0.4: goes through
@@ -1083,6 +1090,12 @@ interface AgentSuspendResult {
     agentId: string;
     status: string;
 }
+interface AgentRenameSessionResult {
+    agentId: string;
+    sessionId: string;
+    /** Absent when the title was cleared (an omitted/blank title on the call). */
+    title?: string;
+}
 interface AgentResumeInput {
     agentId: string;
     autoWake?: boolean;
@@ -1645,16 +1658,20 @@ interface UCANCapability {
 /** The did:key DID for a private key. */
 declare function didFor(privateKey: Uint8Array): string;
 /**
- * Mint a UCAN as an EdDSA JWT: `{iss, aud, att, exp[, prf]}` signed by
- * `privateKey` (iss = its did:key).
+ * Mint a UCAN as an EdDSA JWT in the Convex UCAN JWT profile:
+ * `{iss, aud, ucv, att, prf, exp}` signed by `privateKey` (iss = its did:key).
+ * From Convex 0.8.11 venues parse only this profile: the `ucv` claim and the
+ * `att`/`prf` arrays are always present, and the `exp` key is always present —
+ * explicitly `null` for a non-expiring token (UCAN v0.10.0; an absent `exp`
+ * is malformed).
  *
  * @param privateKey 32-byte Ed25519 private key (the issuer)
  * @param audienceDID who receives the token (`aud`)
  * @param att capabilities delegated (empty array = pure identity token)
- * @param lifetimeSeconds validity window
+ * @param lifetimeSeconds validity window, or `null` for a non-expiring token
  * @param proofs parent UCAN JWT strings (`prf`) for delegation chains
  */
-declare function createUCANJWT(privateKey: Uint8Array, audienceDID: string, att: UCANCapability[], lifetimeSeconds: number, proofs?: string[]): string;
+declare function createUCANJWT(privateKey: Uint8Array, audienceDID: string, att: UCANCapability[], lifetimeSeconds: number | null, proofs?: string[]): string;
 /**
  * Mint an **identity token**: a UCAN with an EMPTY attenuation list, audienced
  * to `venueDID`. Pure proof of identity — it grants nothing, and being
@@ -1680,4 +1697,4 @@ declare function grant(ownerPrivateKey: Uint8Array, audienceDID: string, withRes
  */
 declare function relayDelegation(privateKey: Uint8Array, venueDID: string, lifetimeSeconds: number, caps?: UCANCapability[]): string;
 
-export { type AdapterInfo, AdapterManager, type AdaptersResult, Agent, type AgentCancelTaskInput, type AgentCard, type AgentChatInput, type AgentChatResult, type AgentCompleteTaskResult, type AgentContextInput, type AgentCreateInput, type AgentCreateResult, type AgentDeleteInput, type AgentDeleteResult, type AgentFailTaskResult, type AgentForkInput, type AgentForkResult, type AgentInfoResult, type AgentListInput, type AgentListResult, AgentManager, type AgentMessageInput, type AgentMessageResult, 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, type AssetMetadataStore, AssetNotFoundError, type AssetPinResult, Auth, BasicAuth, BearerAuth, ChatSession, type ConnectionAttempt, type ContentDetails, type ContentHashResult, CoviaConnectionError, type CoviaConnectionErrorOptions, CoviaError, CoviaTimeoutError, type Credentials, CredentialsHTTP, type DIDDocument, type DIDURL, DataAsset, Ed25519Auth, type FunctionInfo, type FunctionsResult, Grid, GridError, type GroupCount, type InvokeOptions, type InvokePayload, Job, JobFailedError, JobManager, type JobMetadata, JobNotFoundError, JobStatus, KeyPairAuth, type MCPDiscovery, Namespace, NoAuth, NotFoundError, Operation, type OperationDetails, type OperationInfo, OperationManager, type OperationPayload, type OperationRunner, RateLimitError, RunStatus, type SSEEvent, type SecretExtractInput, type SecretExtractResult, SecretManager, type SecretSetInput, type SecretSetResult, type StatsData, type StatusData, type UCANAttenuation, type UCANCapability, type UCANIssueInput, type UCANIssueResult, UCANManager, type UCANVerifyResult, 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 WorkspaceInspectInput, type WorkspaceInspectResult, type WorkspaceListInput, type WorkspaceListResult, WorkspaceManager, type WorkspaceReadInput, type WorkspaceReadResult, type WorkspaceSliceInput, type WorkspaceSliceResult, type WorkspaceWriteInput, type WorkspaceWriteResult, assetHash, createSSEEvent, createUCANJWT, decodePublicKey, didFor, didFromPublicKey, didMethod, didUrl, encodePublicKey, fetchStreamWithError, fetchWithError, generateKeyPair, getAssetIdFromPath, getAssetIdFromVenueId, getAssetMetadataStore, getParsedAssetId, grant, hexToPrivateKey, identityToken, isDid, isJobComplete, isJobFinished, isJobPaused, logger, parseDidUrl, parseRetryAfterMs, parseSSEStream, privateKeyToHex, relayDelegation, retryDelayMs, setAssetMetadataStore, venueBaseUrlCandidates };
+export { type AdapterInfo, AdapterManager, type AdaptersResult, Agent, type AgentCancelTaskInput, type AgentCard, type AgentChatInput, type AgentChatResult, type AgentCompleteTaskResult, type AgentContextInput, type AgentCreateInput, type AgentCreateResult, type AgentDeleteInput, type AgentDeleteResult, type AgentFailTaskResult, type AgentForkInput, type AgentForkResult, type AgentInfoResult, type AgentListInput, type AgentListResult, AgentManager, type AgentMessageInput, type AgentMessageResult, type AgentRenameSessionResult, 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, type AssetMetadataStore, AssetNotFoundError, type AssetPinResult, Auth, BasicAuth, BearerAuth, ChatSession, type ConnectionAttempt, type ContentDetails, type ContentHashResult, CoviaConnectionError, type CoviaConnectionErrorOptions, CoviaError, CoviaTimeoutError, type Credentials, CredentialsHTTP, type DIDDocument, type DIDURL, DataAsset, Ed25519Auth, type FunctionInfo, type FunctionsResult, Grid, GridError, type GroupCount, type InvokeOptions, type InvokePayload, Job, JobFailedError, JobManager, type JobMetadata, JobNotFoundError, JobStatus, KeyPairAuth, type MCPDiscovery, Namespace, NoAuth, NotFoundError, Operation, type OperationDetails, type OperationInfo, OperationManager, type OperationPayload, type OperationRunner, RateLimitError, RunStatus, type SSEEvent, type SecretExtractInput, type SecretExtractResult, SecretManager, type SecretSetInput, type SecretSetResult, type StatsData, type StatusData, type UCANAttenuation, type UCANCapability, type UCANIssueInput, type UCANIssueResult, UCANManager, type UCANVerifyResult, 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 WorkspaceInspectInput, type WorkspaceInspectResult, type WorkspaceListInput, type WorkspaceListResult, WorkspaceManager, type WorkspaceReadInput, type WorkspaceReadResult, type WorkspaceSliceInput, type WorkspaceSliceResult, type WorkspaceWriteInput, type WorkspaceWriteResult, assetHash, createSSEEvent, createUCANJWT, decodePublicKey, didFor, didFromPublicKey, didMethod, didUrl, encodePublicKey, fetchStreamWithError, fetchWithError, generateKeyPair, getAssetIdFromPath, getAssetIdFromVenueId, getAssetMetadataStore, getParsedAssetId, grant, hexToPrivateKey, identityToken, isDid, isJobComplete, isJobFinished, isJobPaused, logger, parseDidUrl, parseRetryAfterMs, parseSSEStream, privateKeyToHex, relayDelegation, retryDelayMs, setAssetMetadataStore, venueBaseUrlCandidates };

package/dist/index.js

@@ -77,7 +77,8 @@ var JobFailedError = class extends CoviaError {
     const status = jobData.status ?? "unknown";
     let msg = `Job ${id} ${status}`;
     const output = jobData.output;
-    const errText = output && typeof output === "object" && "error" in output ? output.error : void 0;
+    const outputErrText = output && typeof output === "object" && "error" in output ? output.error : void 0;
+    const errText = typeof jobData.error === "string" ? jobData.error : outputErrText;
     if (typeof errText === "string") {
       msg += `: ${errText}`;
     }
@@ -1682,6 +1683,15 @@ var AgentManager = class {
   async chat(agentId, message, sessionId) {
     return this.venue.operations.run("v/ops/agent/chat", { agentId, message, sessionId });
   }
+  /**
+   * Set (or clear, by omitting `title` / passing an empty string) a
+   * session's free-form human-facing title — persisted on the venue in
+   * the session's own metadata, visible to every client and party in the
+   * session (not a per-browser local override).
+   */
+  async renameSession(agentId, sessionId, title) {
+    return this.venue.operations.run("v/ops/agent/rename-session", { agentId, sessionId, title });
+  }
   async trigger(agentId) {
     return this.venue.operations.run("v/ops/agent/trigger", { agentId });
   }
@@ -2903,6 +2913,7 @@ var Grid = class {
 // src/crypto/ucan.ts
 var encoder2 = new TextEncoder();
 var VENUE_RELAY = "venue/relay";
+var UCV_VERSION = "0.10.0";
 function didFor(privateKey) {
   return `did:key:${encodePublicKey(getPublicKey2(privateKey))}`;
 }
@@ -2913,10 +2924,11 @@ function createUCANJWT(privateKey, audienceDID, att, lifetimeSeconds, proofs = [
   const claims = {
     iss: `did:key:${multikey}`,
     aud: audienceDID,
+    ucv: UCV_VERSION,
     att,
-    exp: nowSecs + lifetimeSeconds
+    prf: proofs,
+    exp: lifetimeSeconds === null ? null : nowSecs + lifetimeSeconds
   };
-  if (proofs.length) claims.prf = proofs;
   const signingInput = `${base64UrlEncode(encoder2.encode(header))}.${base64UrlEncode(encoder2.encode(JSON.stringify(claims)))}`;
   const signature = sign(encoder2.encode(signingInput), privateKey);
   return `${signingInput}.${base64UrlEncode(signature)}`;

package/dist/index.mjs

@@ -75,7 +75,8 @@ var JobFailedError = class extends CoviaError {
     const status = jobData.status ?? "unknown";
     let msg = `Job ${id} ${status}`;
     const output = jobData.output;
-    const errText = output && typeof output === "object" && "error" in output ? output.error : void 0;
+    const outputErrText = output && typeof output === "object" && "error" in output ? output.error : void 0;
+    const errText = typeof jobData.error === "string" ? jobData.error : outputErrText;
     if (typeof errText === "string") {
       msg += `: ${errText}`;
     }
@@ -1680,6 +1681,15 @@ var AgentManager = class {
   async chat(agentId, message, sessionId) {
     return this.venue.operations.run("v/ops/agent/chat", { agentId, message, sessionId });
   }
+  /**
+   * Set (or clear, by omitting `title` / passing an empty string) a
+   * session's free-form human-facing title — persisted on the venue in
+   * the session's own metadata, visible to every client and party in the
+   * session (not a per-browser local override).
+   */
+  async renameSession(agentId, sessionId, title) {
+    return this.venue.operations.run("v/ops/agent/rename-session", { agentId, sessionId, title });
+  }
   async trigger(agentId) {
     return this.venue.operations.run("v/ops/agent/trigger", { agentId });
   }
@@ -2901,6 +2911,7 @@ var Grid = class {
 // src/crypto/ucan.ts
 var encoder2 = new TextEncoder();
 var VENUE_RELAY = "venue/relay";
+var UCV_VERSION = "0.10.0";
 function didFor(privateKey) {
   return `did:key:${encodePublicKey(getPublicKey2(privateKey))}`;
 }
@@ -2911,10 +2922,11 @@ function createUCANJWT(privateKey, audienceDID, att, lifetimeSeconds, proofs = [
   const claims = {
     iss: `did:key:${multikey}`,
     aud: audienceDID,
+    ucv: UCV_VERSION,
     att,
-    exp: nowSecs + lifetimeSeconds
+    prf: proofs,
+    exp: lifetimeSeconds === null ? null : nowSecs + lifetimeSeconds
   };
-  if (proofs.length) claims.prf = proofs;
   const signingInput = `${base64UrlEncode(encoder2.encode(header))}.${base64UrlEncode(encoder2.encode(JSON.stringify(claims)))}`;
   const signature = sign(encoder2.encode(signingInput), privateKey);
   return `${signingInput}.${base64UrlEncode(signature)}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@covia/covia-sdk",
-  "version": "1.7.3",
+  "version": "1.8.0",
   "description": "Typescript library for covia-ai",
   "packageManager": "pnpm@11.9.0",
   "main": "./dist/index.js",