@covia/covia-sdk 1.10.1 → 1.12.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
@@ -730,6 +735,35 @@ declare class MemoryManager {
     forget(number: number, path?: string): Promise<MemoryChange>;
 }
 
+interface DLFSManagerVenue extends VenueRequestContext {
+    lastKnownStatus?: StatusData;
+}
+declare class DLFSManager {
+    private venue;
+    private dlfsSupported;
+    constructor(venue: DLFSManagerVenue);
+    /** A job-free DLFS metadata GET that rejects when the endpoint is unavailable. */
+    private dlfsGet;
+    /**
+     * List the caller's DLFS drives, vault included. **Job-free** on covia
+     * venues serving `GET /api/v1/dlfs/drives` (covia#253).
+     */
+    listDrives(): Promise<DLFSDrivesResult>;
+    /**
+     * List one directory of a drive. **Job-free** on covia venues serving
+     * `GET /api/v1/dlfs/list` (covia#253). Own drives by bare name only —
+     * cross-user DID-URL drive addressing isn't supported by this manager.
+     */
+    list(drive: string, path?: string): Promise<DLFSListResult>;
+    /**
+     * Job-free file content — `GET /api/v1/content/dlfs/<drive>/<path>`, the
+     * same route the venue's generic asset-content resolver already serves
+     * (DLFSAdapter implements ContentProvider). Real streamed bytes with a
+     * correct Content-Type, not the JSON/base64 shape `dlfs:read` returns.
+     */
+    getContent(drive: string, path: string): Promise<ReadableStream<Uint8Array>>;
+}
+
 /**
  * Resolve a non-DID venue id into the ordered list of base URLs that
  * {@link Venue.connect} will try in turn. Explicit `http(s)://` inputs are
@@ -784,6 +818,7 @@ declare class Venue implements VenueInterface {
     private _secrets?;
     private _skills?;
     private _memory?;
+    private _dlfs?;
     get adapters(): AdapterManager;
     get agents(): AgentManager;
     get jobs(): JobManager;
@@ -794,6 +829,7 @@ declare class Venue implements VenueInterface {
     get secrets(): SecretManager;
     get skills(): SkillManager;
     get memory(): MemoryManager;
+    get dlfs(): DLFSManager;
     constructor(options?: VenueOptions);
     /**
      * Connect to a venue, validating it with `GET {base}/api/v1/status`. If the
@@ -827,9 +863,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 +985,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 +1084,7 @@ interface StatsData {
 interface AssetListOptions {
     offset?: number;
     limit?: number;
+    expand?: 'metadata';
 }
 interface AssetList {
     items: string[];
@@ -1047,6 +1092,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;
@@ -1459,6 +1514,19 @@ interface SecretExtractResult {
     name: string;
     value: string;
 }
+interface DLFSEntry {
+    name: string;
+    type: "file" | "directory";
+    size?: number;
+    modified?: string;
+}
+interface DLFSDrivesResult {
+    drives: string[];
+}
+interface DLFSListResult {
+    entries: DLFSEntry[];
+    warnings?: string[];
+}
 interface FunctionInfo {
     name: string;
     id: string;
@@ -1866,4 +1934,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, type DLFSDrivesResult, type DLFSEntry, type DLFSListResult, DLFSManager, 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
@@ -730,6 +735,35 @@ declare class MemoryManager {
     forget(number: number, path?: string): Promise<MemoryChange>;
 }
 
+interface DLFSManagerVenue extends VenueRequestContext {
+    lastKnownStatus?: StatusData;
+}
+declare class DLFSManager {
+    private venue;
+    private dlfsSupported;
+    constructor(venue: DLFSManagerVenue);
+    /** A job-free DLFS metadata GET that rejects when the endpoint is unavailable. */
+    private dlfsGet;
+    /**
+     * List the caller's DLFS drives, vault included. **Job-free** on covia
+     * venues serving `GET /api/v1/dlfs/drives` (covia#253).
+     */
+    listDrives(): Promise<DLFSDrivesResult>;
+    /**
+     * List one directory of a drive. **Job-free** on covia venues serving
+     * `GET /api/v1/dlfs/list` (covia#253). Own drives by bare name only —
+     * cross-user DID-URL drive addressing isn't supported by this manager.
+     */
+    list(drive: string, path?: string): Promise<DLFSListResult>;
+    /**
+     * Job-free file content — `GET /api/v1/content/dlfs/<drive>/<path>`, the
+     * same route the venue's generic asset-content resolver already serves
+     * (DLFSAdapter implements ContentProvider). Real streamed bytes with a
+     * correct Content-Type, not the JSON/base64 shape `dlfs:read` returns.
+     */
+    getContent(drive: string, path: string): Promise<ReadableStream<Uint8Array>>;
+}
+
 /**
  * Resolve a non-DID venue id into the ordered list of base URLs that
  * {@link Venue.connect} will try in turn. Explicit `http(s)://` inputs are
@@ -784,6 +818,7 @@ declare class Venue implements VenueInterface {
     private _secrets?;
     private _skills?;
     private _memory?;
+    private _dlfs?;
     get adapters(): AdapterManager;
     get agents(): AgentManager;
     get jobs(): JobManager;
@@ -794,6 +829,7 @@ declare class Venue implements VenueInterface {
     get secrets(): SecretManager;
     get skills(): SkillManager;
     get memory(): MemoryManager;
+    get dlfs(): DLFSManager;
     constructor(options?: VenueOptions);
     /**
      * Connect to a venue, validating it with `GET {base}/api/v1/status`. If the
@@ -827,9 +863,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 +985,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 +1084,7 @@ interface StatsData {
 interface AssetListOptions {
     offset?: number;
     limit?: number;
+    expand?: 'metadata';
 }
 interface AssetList {
     items: string[];
@@ -1047,6 +1092,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;
@@ -1459,6 +1514,19 @@ interface SecretExtractResult {
     name: string;
     value: string;
 }
+interface DLFSEntry {
+    name: string;
+    type: "file" | "directory";
+    size?: number;
+    modified?: string;
+}
+interface DLFSDrivesResult {
+    drives: string[];
+}
+interface DLFSListResult {
+    entries: DLFSEntry[];
+    warnings?: string[];
+}
 interface FunctionInfo {
     name: string;
     id: string;
@@ -1866,4 +1934,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, type DLFSDrivesResult, type DLFSEntry, type DLFSListResult, DLFSManager, 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()}`,
@@ -2799,6 +2798,59 @@ var MemoryManager = class {
   }
 };
 
+// src/DLFSManager.ts
+var DLFSManager = class {
+  constructor(venue) {
+    this.venue = venue;
+    // Whether this venue serves GET /api/v1/dlfs/* — flipped on a route-missing
+    // 404 so a pre-#253 venue pays the probe once, not one failed GET per read.
+    this.dlfsSupported = true;
+  }
+  /** A job-free DLFS metadata GET that rejects when the endpoint is unavailable. */
+  async dlfsGet(path) {
+    if (!this.dlfsSupported) throw new UnsupportedVenueFeatureError("venue DLFS browsing");
+    try {
+      return await venueJson(this.venue, `/api/v1/dlfs${path}`);
+    } catch (e) {
+      if (!(e instanceof NotFoundError)) throw e;
+      if (!ROUTE_MISSING_404.test(e.message)) throw e;
+      this.dlfsSupported = false;
+      throw new UnsupportedVenueFeatureError("venue DLFS browsing");
+    }
+  }
+  /**
+   * List the caller's DLFS drives, vault included. **Job-free** on covia
+   * venues serving `GET /api/v1/dlfs/drives` (covia#253).
+   */
+  async listDrives() {
+    return this.dlfsGet("/drives");
+  }
+  /**
+   * List one directory of a drive. **Job-free** on covia venues serving
+   * `GET /api/v1/dlfs/list` (covia#253). Own drives by bare name only —
+   * cross-user DID-URL drive addressing isn't supported by this manager.
+   */
+  async list(drive, path) {
+    const qs = new URLSearchParams({ drive, ...path ? { path } : {} });
+    return this.dlfsGet(`/list?${qs}`);
+  }
+  /**
+   * Job-free file content — `GET /api/v1/content/dlfs/<drive>/<path>`, the
+   * same route the venue's generic asset-content resolver already serves
+   * (DLFSAdapter implements ContentProvider). Real streamed bytes with a
+   * correct Content-Type, not the JSON/base64 shape `dlfs:read` returns.
+   */
+  async getContent(drive, path) {
+    const segments = path.split("/").filter(Boolean).map(encodeURIComponent).join("/");
+    const response = await venueStream(
+      this.venue,
+      `/api/v1/content/dlfs/${encodeURIComponent(drive)}/${segments}`
+    );
+    if (!response.body) throw new Error("Empty response body for DLFS content read");
+    return response.body;
+  }
+};
+
 // src/Agent.ts
 var Agent = class _Agent {
   constructor(id, venue) {
@@ -2997,6 +3049,9 @@ var Venue = class _Venue {
   get memory() {
     return this._memory ?? (this._memory = new MemoryManager(this));
   }
+  get dlfs() {
+    return this._dlfs ?? (this._dlfs = new DLFSManager(this));
+  }
   /**
    * Connect to a venue, validating it with `GET {base}/api/v1/status`. If the
    * venue is auth-gated (status answers 401/403 — public access disabled), the
@@ -3105,11 +3160,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);
   }
@@ -3349,6 +3399,7 @@ exports.CoviaConnectionError = CoviaConnectionError;
 exports.CoviaError = CoviaError;
 exports.CoviaTimeoutError = CoviaTimeoutError;
 exports.CredentialsHTTP = CredentialsHTTP;
+exports.DLFSManager = DLFSManager;
 exports.DataAsset = DataAsset;
 exports.Ed25519Auth = Ed25519Auth;
 exports.Grid = Grid;

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()}`,
@@ -2797,6 +2796,59 @@ var MemoryManager = class {
   }
 };
 
+// src/DLFSManager.ts
+var DLFSManager = class {
+  constructor(venue) {
+    this.venue = venue;
+    // Whether this venue serves GET /api/v1/dlfs/* — flipped on a route-missing
+    // 404 so a pre-#253 venue pays the probe once, not one failed GET per read.
+    this.dlfsSupported = true;
+  }
+  /** A job-free DLFS metadata GET that rejects when the endpoint is unavailable. */
+  async dlfsGet(path) {
+    if (!this.dlfsSupported) throw new UnsupportedVenueFeatureError("venue DLFS browsing");
+    try {
+      return await venueJson(this.venue, `/api/v1/dlfs${path}`);
+    } catch (e) {
+      if (!(e instanceof NotFoundError)) throw e;
+      if (!ROUTE_MISSING_404.test(e.message)) throw e;
+      this.dlfsSupported = false;
+      throw new UnsupportedVenueFeatureError("venue DLFS browsing");
+    }
+  }
+  /**
+   * List the caller's DLFS drives, vault included. **Job-free** on covia
+   * venues serving `GET /api/v1/dlfs/drives` (covia#253).
+   */
+  async listDrives() {
+    return this.dlfsGet("/drives");
+  }
+  /**
+   * List one directory of a drive. **Job-free** on covia venues serving
+   * `GET /api/v1/dlfs/list` (covia#253). Own drives by bare name only —
+   * cross-user DID-URL drive addressing isn't supported by this manager.
+   */
+  async list(drive, path) {
+    const qs = new URLSearchParams({ drive, ...path ? { path } : {} });
+    return this.dlfsGet(`/list?${qs}`);
+  }
+  /**
+   * Job-free file content — `GET /api/v1/content/dlfs/<drive>/<path>`, the
+   * same route the venue's generic asset-content resolver already serves
+   * (DLFSAdapter implements ContentProvider). Real streamed bytes with a
+   * correct Content-Type, not the JSON/base64 shape `dlfs:read` returns.
+   */
+  async getContent(drive, path) {
+    const segments = path.split("/").filter(Boolean).map(encodeURIComponent).join("/");
+    const response = await venueStream(
+      this.venue,
+      `/api/v1/content/dlfs/${encodeURIComponent(drive)}/${segments}`
+    );
+    if (!response.body) throw new Error("Empty response body for DLFS content read");
+    return response.body;
+  }
+};
+
 // src/Agent.ts
 var Agent = class _Agent {
   constructor(id, venue) {
@@ -2995,6 +3047,9 @@ var Venue = class _Venue {
   get memory() {
     return this._memory ?? (this._memory = new MemoryManager(this));
   }
+  get dlfs() {
+    return this._dlfs ?? (this._dlfs = new DLFSManager(this));
+  }
   /**
    * Connect to a venue, validating it with `GET {base}/api/v1/status`. If the
    * venue is auth-gated (status answers 401/403 — public access disabled), the
@@ -3103,11 +3158,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);
   }
@@ -3331,4 +3381,4 @@ function relayDelegation(privateKey, venueDID, lifetimeSeconds, caps = []) {
   (*! noble-ed25519 - MIT License (c) 2019 Paul Miller (paulmillr.com) *)
 */
 
-export { AdapterManager, Agent, AgentManager, AgentSessionNotFoundError, AgentStatus, Asset, AssetManager, AssetNotFoundError, Auth, BasicAuth, BearerAuth, ChatSession, CoviaConnectionError, CoviaError, CoviaTimeoutError, CredentialsHTTP, DataAsset, Ed25519Auth, Grid, GridError, Job, JobFailedError, JobManager, JobNotFoundError, JobStatus, KeyPairAuth, MemoryManager, Namespace, NoAuth, NotFoundError, Operation, OperationManager, RateLimitError, RunStatus, SecretManager, SkillManager, UCANManager, UnsupportedVenueFeatureError, VENUE_RELAY, Venue, VenueIdentityChangedError, WorkspaceManager, 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 { 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, MemoryManager, Namespace, NoAuth, NotFoundError, Operation, OperationManager, RateLimitError, RunStatus, SecretManager, SkillManager, UCANManager, UnsupportedVenueFeatureError, VENUE_RELAY, Venue, VenueIdentityChangedError, WorkspaceManager, 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/package.json

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