@covia/covia-sdk 1.10.1 → 1.11.0

package/dist/index.d.mts

@@ -463,8 +463,13 @@ declare class AssetManager {
     private _wrap;
     /**
      * List assets with pagination support
-     * @param options - Pagination options (offset, limit)
+     * @param options - Pagination options (offset, limit). Pass
+     * `{ expand: 'metadata' }` to get each item's metadata inlined as
+     * `{id, metadata}` instead of a bare id string, sparing a per-id fetch.
      */
+    list(options: AssetListOptions & {
+        expand: 'metadata';
+    }): Promise<ExpandedAssetList>;
     list(options?: AssetListOptions): Promise<AssetList>;
     /**
      * List the authenticated caller's own assets — the per-user a/ namespace
@@ -827,9 +832,14 @@ declare class Venue implements VenueInterface {
     getAsset(assetId: AssetID): Promise<Asset>;
     /**
      * List assets with pagination support (convenience delegate to venue.assets.list)
-     * @param options - Pagination options (offset, limit)
-     * @returns {Promise<AssetList>} Paginated list of asset IDs with metadata
-     */
+     * @param options - Pagination options (offset, limit). Pass
+     * `{ expand: 'metadata' }` to get each item's metadata inlined.
+     * @returns {Promise<AssetList>} Paginated list of asset ids, or of
+     * `{id, metadata}` items when `expand: 'metadata'` is requested
+     */
+    listAssets(options: AssetListOptions & {
+        expand: 'metadata';
+    }): Promise<ExpandedAssetList>;
     listAssets(options?: AssetListOptions): Promise<AssetList>;
     /**
      * List all jobs
@@ -944,6 +954,9 @@ interface VenueInterface {
     getJob(jobId: string): Promise<Job>;
     listJobs(): Promise<string[]>;
     getAsset(assetId: AssetID): Promise<Asset>;
+    listAssets(options: AssetListOptions & {
+        expand: 'metadata';
+    }): Promise<ExpandedAssetList>;
     listAssets(options?: AssetListOptions): Promise<AssetList>;
     didDocument(): Promise<DIDDocument>;
     mcpDiscovery(): Promise<MCPDiscovery>;
@@ -1040,6 +1053,7 @@ interface StatsData {
 interface AssetListOptions {
     offset?: number;
     limit?: number;
+    expand?: 'metadata';
 }
 interface AssetList {
     items: string[];
@@ -1047,6 +1061,16 @@ interface AssetList {
     offset: number;
     limit: number;
 }
+interface AssetListItem {
+    id: string;
+    metadata: AssetMetadata;
+}
+interface ExpandedAssetList {
+    items: AssetListItem[];
+    total: number;
+    offset: number;
+    limit: number;
+}
 interface AssetSummary {
     id: string;
     name?: string;
@@ -1866,4 +1890,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 AgentRenameSessionResult, type AgentRequestInput, type AgentRequestResult, type AgentResumeInput, type AgentSession, type AgentSessionListOptions, type AgentSessionMetadata, AgentSessionNotFoundError, type AgentSessionPage, AgentStatus, type AgentSuspendResult, type AgentTriggerInput, type AgentTriggerResult, type AgentUpdateInput, Asset, type AssetID, type AssetList, type AssetListOptions, AssetManager, type AssetMetadata, type AssetMetadataStore, AssetNotFoundError, type AssetPinResult, type AssetSummary, 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, type MemoryChange, type MemoryEntry, MemoryManager, type MyAssetList, 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 Skill, type SkillFacet, SkillManager, type SkillMetadata, type StatsData, type StatusData, type UCANAttenuation, type UCANCapability, type UCANIssueInput, type UCANIssueResult, UCANManager, type UCANVerifyResult, UnsupportedVenueFeatureError, 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, type AgentSession, type AgentSessionListOptions, type AgentSessionMetadata, AgentSessionNotFoundError, type AgentSessionPage, AgentStatus, type AgentSuspendResult, 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, BasicAuth, BearerAuth, ChatSession, type ConnectionAttempt, type ContentDetails, type ContentHashResult, CoviaConnectionError, type CoviaConnectionErrorOptions, CoviaError, CoviaTimeoutError, type Credentials, CredentialsHTTP, type DIDDocument, type DIDURL, DataAsset, Ed25519Auth, type ExpandedAssetList, type FunctionInfo, type FunctionsResult, Grid, GridError, type GroupCount, type InvokeOptions, type InvokePayload, Job, JobFailedError, JobManager, type JobMetadata, JobNotFoundError, JobStatus, KeyPairAuth, type MCPDiscovery, type MemoryChange, type MemoryEntry, MemoryManager, type MyAssetList, 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 Skill, type SkillFacet, SkillManager, type SkillMetadata, type StatsData, type StatusData, type UCANAttenuation, type UCANCapability, type UCANIssueInput, type UCANIssueResult, UCANManager, type UCANVerifyResult, UnsupportedVenueFeatureError, 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

@@ -463,8 +463,13 @@ declare class AssetManager {
     private _wrap;
     /**
      * List assets with pagination support
-     * @param options - Pagination options (offset, limit)
+     * @param options - Pagination options (offset, limit). Pass
+     * `{ expand: 'metadata' }` to get each item's metadata inlined as
+     * `{id, metadata}` instead of a bare id string, sparing a per-id fetch.
      */
+    list(options: AssetListOptions & {
+        expand: 'metadata';
+    }): Promise<ExpandedAssetList>;
     list(options?: AssetListOptions): Promise<AssetList>;
     /**
      * List the authenticated caller's own assets — the per-user a/ namespace
@@ -827,9 +832,14 @@ declare class Venue implements VenueInterface {
     getAsset(assetId: AssetID): Promise<Asset>;
     /**
      * List assets with pagination support (convenience delegate to venue.assets.list)
-     * @param options - Pagination options (offset, limit)
-     * @returns {Promise<AssetList>} Paginated list of asset IDs with metadata
-     */
+     * @param options - Pagination options (offset, limit). Pass
+     * `{ expand: 'metadata' }` to get each item's metadata inlined.
+     * @returns {Promise<AssetList>} Paginated list of asset ids, or of
+     * `{id, metadata}` items when `expand: 'metadata'` is requested
+     */
+    listAssets(options: AssetListOptions & {
+        expand: 'metadata';
+    }): Promise<ExpandedAssetList>;
     listAssets(options?: AssetListOptions): Promise<AssetList>;
     /**
      * List all jobs
@@ -944,6 +954,9 @@ interface VenueInterface {
     getJob(jobId: string): Promise<Job>;
     listJobs(): Promise<string[]>;
     getAsset(assetId: AssetID): Promise<Asset>;
+    listAssets(options: AssetListOptions & {
+        expand: 'metadata';
+    }): Promise<ExpandedAssetList>;
     listAssets(options?: AssetListOptions): Promise<AssetList>;
     didDocument(): Promise<DIDDocument>;
     mcpDiscovery(): Promise<MCPDiscovery>;
@@ -1040,6 +1053,7 @@ interface StatsData {
 interface AssetListOptions {
     offset?: number;
     limit?: number;
+    expand?: 'metadata';
 }
 interface AssetList {
     items: string[];
@@ -1047,6 +1061,16 @@ interface AssetList {
     offset: number;
     limit: number;
 }
+interface AssetListItem {
+    id: string;
+    metadata: AssetMetadata;
+}
+interface ExpandedAssetList {
+    items: AssetListItem[];
+    total: number;
+    offset: number;
+    limit: number;
+}
 interface AssetSummary {
     id: string;
     name?: string;
@@ -1866,4 +1890,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 AgentRenameSessionResult, type AgentRequestInput, type AgentRequestResult, type AgentResumeInput, type AgentSession, type AgentSessionListOptions, type AgentSessionMetadata, AgentSessionNotFoundError, type AgentSessionPage, AgentStatus, type AgentSuspendResult, type AgentTriggerInput, type AgentTriggerResult, type AgentUpdateInput, Asset, type AssetID, type AssetList, type AssetListOptions, AssetManager, type AssetMetadata, type AssetMetadataStore, AssetNotFoundError, type AssetPinResult, type AssetSummary, 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, type MemoryChange, type MemoryEntry, MemoryManager, type MyAssetList, 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 Skill, type SkillFacet, SkillManager, type SkillMetadata, type StatsData, type StatusData, type UCANAttenuation, type UCANCapability, type UCANIssueInput, type UCANIssueResult, UCANManager, type UCANVerifyResult, UnsupportedVenueFeatureError, 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, type AgentSession, type AgentSessionListOptions, type AgentSessionMetadata, AgentSessionNotFoundError, type AgentSessionPage, AgentStatus, type AgentSuspendResult, 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, BasicAuth, BearerAuth, ChatSession, type ConnectionAttempt, type ContentDetails, type ContentHashResult, CoviaConnectionError, type CoviaConnectionErrorOptions, CoviaError, CoviaTimeoutError, type Credentials, CredentialsHTTP, type DIDDocument, type DIDURL, DataAsset, Ed25519Auth, type ExpandedAssetList, type FunctionInfo, type FunctionsResult, Grid, GridError, type GroupCount, type InvokeOptions, type InvokePayload, Job, JobFailedError, JobManager, type JobMetadata, JobNotFoundError, JobStatus, KeyPairAuth, type MCPDiscovery, type MemoryChange, type MemoryEntry, MemoryManager, type MyAssetList, 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 Skill, type SkillFacet, SkillManager, type SkillMetadata, type StatsData, type StatusData, type UCANAttenuation, type UCANCapability, type UCANIssueInput, type UCANIssueResult, UCANManager, type UCANVerifyResult, UnsupportedVenueFeatureError, 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

@@ -2311,16 +2311,15 @@ var AssetManager = class {
     }
     return new DataAsset(assetId, this.venue, data);
   }
-  /**
-   * List assets with pagination support
-   * @param options - Pagination options (offset, limit)
-   */
   async list(options = {}) {
     const params = new URLSearchParams();
     params.set("offset", String(options.offset ?? 0));
     if (options.limit !== void 0) {
       params.set("limit", String(options.limit));
     }
+    if (options.expand !== void 0) {
+      params.set("expand", options.expand);
+    }
     return venueJson(
       this.venue,
       `/api/v1/assets?${params.toString()}`,
@@ -3105,11 +3104,6 @@ var Venue = class _Venue {
   async getAsset(assetId) {
     return this.assets.get(assetId);
   }
-  /**
-   * List assets with pagination support (convenience delegate to venue.assets.list)
-   * @param options - Pagination options (offset, limit)
-   * @returns {Promise<AssetList>} Paginated list of asset IDs with metadata
-   */
   async listAssets(options = {}) {
     return this.assets.list(options);
   }

package/dist/index.mjs

@@ -2309,16 +2309,15 @@ var AssetManager = class {
     }
     return new DataAsset(assetId, this.venue, data);
   }
-  /**
-   * List assets with pagination support
-   * @param options - Pagination options (offset, limit)
-   */
   async list(options = {}) {
     const params = new URLSearchParams();
     params.set("offset", String(options.offset ?? 0));
     if (options.limit !== void 0) {
       params.set("limit", String(options.limit));
     }
+    if (options.expand !== void 0) {
+      params.set("expand", options.expand);
+    }
     return venueJson(
       this.venue,
       `/api/v1/assets?${params.toString()}`,
@@ -3103,11 +3102,6 @@ var Venue = class _Venue {
   async getAsset(assetId) {
     return this.assets.get(assetId);
   }
-  /**
-   * List assets with pagination support (convenience delegate to venue.assets.list)
-   * @param options - Pagination options (offset, limit)
-   * @returns {Promise<AssetList>} Paginated list of asset IDs with metadata
-   */
   async listAssets(options = {}) {
     return this.assets.list(options);
   }

package/package.json

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