@covia/covia-sdk 1.7.0 → 1.7.2

package/dist/index.d.mts

@@ -431,6 +431,7 @@ declare class AssetManager {
      * @returns Returns either an Operation or DataAsset based on the asset's metadata
      */
     get(assetId: AssetID): Promise<Asset>;
+    private _wrap;
     /**
      * List assets with pagination support
      * @param options - Pagination options (offset, limit)
@@ -1006,6 +1007,14 @@ 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;
+    /** 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
+     *  on the venue. Each entry is a human-readable message. */
+    warnings?: string[];
 }
 interface AgentRequestInput {
     agentId: string;
@@ -1048,10 +1057,13 @@ interface AgentListInput {
     includeTerminated?: boolean;
 }
 interface AgentListResult {
+    /** Always objects. The invoke op returns enriched entries; the job-free GET
+     *  returns bare id strings, which the SDK normalises to `{agentId}` — so
+     *  `status`/`tasks` are present only when the venue supplied them. */
     agents: Array<{
         agentId: string;
-        status: string;
-        tasks: number;
+        status?: string;
+        tasks?: number;
     }>;
 }
 interface AgentDeleteInput {
@@ -1466,6 +1478,33 @@ declare function didUrl(did: string | null, namespace: string, ...segments: stri
  */
 declare function assetHash(ref: string): string | null;
 
+/**
+ * Pluggable persistent store for content-addressed asset metadata.
+ *
+ * An asset id is the Convex value hash of its metadata (`AMap.getHash()`
+ * venue-side), so hash → metadata is immutable: entries never go stale and are
+ * safe to cache indefinitely, across sessions and across venues. Keys are the
+ * normalised bare hash (lowercase, no `0x`), so `<hash>`, `0x<hash>` and
+ * `<DID>/a/<hash>` refs all share one entry.
+ *
+ * Trust model: entries are cached as returned by the venue that served them.
+ * Provable verification — recomputing the Convex value hash of the metadata
+ * and rejecting mismatches — requires a canonical CVM cell encoder in
+ * TypeScript, which does not exist yet; when it lands, verification will gate
+ * admission to this cache so entries are correct by construction rather than
+ * by trust. Until then this is a availability/performance cache with the same
+ * trust as an uncached fetch from the same venue.
+ */
+interface AssetMetadataStore {
+    get(hash: string): AssetMetadata | undefined;
+    put(hash: string, metadata: AssetMetadata): void;
+    clear(): void;
+}
+/** Replace the persistent metadata store (e.g. a file-backed store in Node),
+ *  or pass `null` to disable persistence. Browsers default to localStorage. */
+declare function setAssetMetadataStore(s: AssetMetadataStore | null): void;
+declare function getAssetMetadataStore(): AssetMetadataStore | null;
+
 /**
  * Simple logger for the Covia SDK.
  *
@@ -1599,4 +1638,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, AssetNotFoundError, type AssetPinResult, Auth, BasicAuth, BearerAuth, ChatSession, type ContentDetails, type ContentHashResult, CoviaConnectionError, 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, 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, getParsedAssetId, grant, hexToPrivateKey, identityToken, isDid, isJobComplete, isJobFinished, isJobPaused, logger, parseDidUrl, parseRetryAfterMs, parseSSEStream, privateKeyToHex, relayDelegation, retryDelayMs, 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 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 ContentDetails, type ContentHashResult, CoviaConnectionError, 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, 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

@@ -431,6 +431,7 @@ declare class AssetManager {
      * @returns Returns either an Operation or DataAsset based on the asset's metadata
      */
     get(assetId: AssetID): Promise<Asset>;
+    private _wrap;
     /**
      * List assets with pagination support
      * @param options - Pagination options (offset, limit)
@@ -1006,6 +1007,14 @@ 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;
+    /** 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
+     *  on the venue. Each entry is a human-readable message. */
+    warnings?: string[];
 }
 interface AgentRequestInput {
     agentId: string;
@@ -1048,10 +1057,13 @@ interface AgentListInput {
     includeTerminated?: boolean;
 }
 interface AgentListResult {
+    /** Always objects. The invoke op returns enriched entries; the job-free GET
+     *  returns bare id strings, which the SDK normalises to `{agentId}` — so
+     *  `status`/`tasks` are present only when the venue supplied them. */
     agents: Array<{
         agentId: string;
-        status: string;
-        tasks: number;
+        status?: string;
+        tasks?: number;
     }>;
 }
 interface AgentDeleteInput {
@@ -1466,6 +1478,33 @@ declare function didUrl(did: string | null, namespace: string, ...segments: stri
  */
 declare function assetHash(ref: string): string | null;
 
+/**
+ * Pluggable persistent store for content-addressed asset metadata.
+ *
+ * An asset id is the Convex value hash of its metadata (`AMap.getHash()`
+ * venue-side), so hash → metadata is immutable: entries never go stale and are
+ * safe to cache indefinitely, across sessions and across venues. Keys are the
+ * normalised bare hash (lowercase, no `0x`), so `<hash>`, `0x<hash>` and
+ * `<DID>/a/<hash>` refs all share one entry.
+ *
+ * Trust model: entries are cached as returned by the venue that served them.
+ * Provable verification — recomputing the Convex value hash of the metadata
+ * and rejecting mismatches — requires a canonical CVM cell encoder in
+ * TypeScript, which does not exist yet; when it lands, verification will gate
+ * admission to this cache so entries are correct by construction rather than
+ * by trust. Until then this is a availability/performance cache with the same
+ * trust as an uncached fetch from the same venue.
+ */
+interface AssetMetadataStore {
+    get(hash: string): AssetMetadata | undefined;
+    put(hash: string, metadata: AssetMetadata): void;
+    clear(): void;
+}
+/** Replace the persistent metadata store (e.g. a file-backed store in Node),
+ *  or pass `null` to disable persistence. Browsers default to localStorage. */
+declare function setAssetMetadataStore(s: AssetMetadataStore | null): void;
+declare function getAssetMetadataStore(): AssetMetadataStore | null;
+
 /**
  * Simple logger for the Covia SDK.
  *
@@ -1599,4 +1638,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, AssetNotFoundError, type AssetPinResult, Auth, BasicAuth, BearerAuth, ChatSession, type ContentDetails, type ContentHashResult, CoviaConnectionError, 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, 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, getParsedAssetId, grant, hexToPrivateKey, identityToken, isDid, isJobComplete, isJobFinished, isJobPaused, logger, parseDidUrl, parseRetryAfterMs, parseSSEStream, privateKeyToHex, relayDelegation, retryDelayMs, 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 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 ContentDetails, type ContentHashResult, CoviaConnectionError, 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, 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

@@ -1499,6 +1499,53 @@ async function* parseSSEStream(response) {
   }
 }
 
+// src/asset-cache.ts
+var PREFIX = "covia:asset-meta:";
+var LocalStorageMetadataStore = class {
+  get(hash) {
+    try {
+      const raw = localStorage.getItem(PREFIX + hash);
+      return raw ? JSON.parse(raw) : void 0;
+    } catch {
+      return void 0;
+    }
+  }
+  put(hash, metadata) {
+    try {
+      localStorage.setItem(PREFIX + hash, JSON.stringify(metadata));
+    } catch {
+    }
+  }
+  clear() {
+    try {
+      const doomed = [];
+      for (let i = 0; i < localStorage.length; i++) {
+        const key = localStorage.key(i);
+        if (key?.startsWith(PREFIX)) doomed.push(key);
+      }
+      doomed.forEach((k) => localStorage.removeItem(k));
+    } catch {
+    }
+  }
+};
+function detectDefaultStore() {
+  try {
+    return typeof localStorage !== "undefined" ? new LocalStorageMetadataStore() : null;
+  } catch {
+    return null;
+  }
+}
+var store = detectDefaultStore();
+function setAssetMetadataStore(s) {
+  store = s;
+}
+function getAssetMetadataStore() {
+  return store;
+}
+function normaliseHash(hash) {
+  return (hash.startsWith("0x") ? hash.slice(2) : hash).toLowerCase();
+}
+
 // src/AdapterManager.ts
 var ADAPTERS_PATH = "v/info/adapters";
 var LIST_LIMIT = 1e3;
@@ -1585,6 +1632,8 @@ var AgentManager = class {
         );
       } catch (e) {
         if (!(e instanceof NotFoundError)) throw e;
+        const routeMissing = path === "" || /\bEndpoint (GET|POST|PUT|DELETE|PATCH|HEAD) /.test(e.message);
+        if (!routeMissing) throw e;
         this.agentsGetSupported = false;
       }
     }
@@ -1627,7 +1676,10 @@ var AgentManager = class {
    * venues transparently fall back to the invoke path (one probe, remembered).
    */
   async list(includeTerminated) {
-    return this._agentsOr("", { includeTerminated }, () => this.venue.operations.run("v/ops/agent/list", { includeTerminated }));
+    const result = await this._agentsOr("", { includeTerminated }, () => this.venue.operations.run("v/ops/agent/list", { includeTerminated }));
+    const raw = result?.agents ?? [];
+    const agents = raw.map((a) => typeof a === "string" ? { agentId: a } : a);
+    return { agents };
   }
   async delete(agentId, remove) {
     return this.venue.operations.run("v/ops/agent/delete", { agentId, remove });
@@ -1814,9 +1866,12 @@ var JobManager = class {
     this.venue = venue;
   }
   async list() {
-    return fetchWithError(`${this.venue.baseUrl}/api/v1/jobs`, {
+    const body = await fetchWithError(`${this.venue.baseUrl}/api/v1/jobs`, {
       headers: this._buildHeaders()
     });
+    if (Array.isArray(body)) return body;
+    const items = body?.items;
+    return Array.isArray(items) ? items : [];
   }
   async get(jobId) {
     try {
@@ -2004,21 +2059,23 @@ var AssetManager = class {
    */
   async get(assetId) {
     if (cache.has(assetId)) {
-      const cachedData = cache.get(assetId);
-      if (cachedData.operation) {
-        return new Operation(assetId, this.venue, cachedData);
-      } else {
-        return new DataAsset(assetId, this.venue, cachedData);
+      return this._wrap(assetId, cache.get(assetId));
+    }
+    const hash = assetHash(assetId);
+    if (hash) {
+      const persisted = getAssetMetadataStore()?.get(normaliseHash(hash));
+      if (persisted) {
+        cache.set(assetId, persisted);
+        return this._wrap(assetId, persisted);
       }
     }
     try {
       const data = await fetchWithError(`${this.venue.baseUrl}/api/v1/assets/${assetId}`);
-      if (assetHash(assetId)) cache.set(assetId, data);
-      if (data.operation) {
-        return new Operation(assetId, this.venue, data);
-      } else {
-        return new DataAsset(assetId, this.venue, data);
+      if (hash) {
+        cache.set(assetId, data);
+        getAssetMetadataStore()?.put(normaliseHash(hash), data);
       }
+      return this._wrap(assetId, data);
     } catch (error) {
       if (error instanceof NotFoundError) {
         throw new AssetNotFoundError(assetId);
@@ -2026,6 +2083,12 @@ var AssetManager = class {
       throw error;
     }
   }
+  _wrap(assetId, data) {
+    if (data.operation) {
+      return new Operation(assetId, this.venue, data);
+    }
+    return new DataAsset(assetId, this.venue, data);
+  }
   /**
    * List assets with pagination support
    * @param options - Pagination options (offset, limit)
@@ -2111,6 +2174,7 @@ var AssetManager = class {
    */
   clearCache() {
     cache.clear();
+    getAssetMetadataStore()?.clear();
   }
   // `contentType` defaults to JSON for the metadata/register endpoints. Pass
   // `undefined` for binary content upload so fetch infers the type from the
@@ -2279,7 +2343,8 @@ var WorkspaceManager = class {
     return this._valuesOr("read", { path, maxSize }, () => this.venue.operations.run("v/ops/covia/read", { path, maxSize }));
   }
   async list(path, limit, offset, ucans) {
-    if (ucans?.length || !path) return this.venue.operations.run("v/ops/covia/list", { path, limit, offset }, { ucans });
+    path = path || "/";
+    if (ucans?.length) return this.venue.operations.run("v/ops/covia/list", { path, limit, offset }, { ucans });
     return this._valuesOr("list", { path, limit, offset }, () => this.venue.operations.run("v/ops/covia/list", { path, limit, offset }));
   }
   async slice(path, offset, limit, ucans) {
@@ -2854,6 +2919,7 @@ exports.fetchWithError = fetchWithError;
 exports.generateKeyPair = generateKeyPair;
 exports.getAssetIdFromPath = getAssetIdFromPath;
 exports.getAssetIdFromVenueId = getAssetIdFromVenueId;
+exports.getAssetMetadataStore = getAssetMetadataStore;
 exports.getParsedAssetId = getParsedAssetId;
 exports.grant = grant;
 exports.hexToPrivateKey = hexToPrivateKey;
@@ -2869,4 +2935,5 @@ exports.parseSSEStream = parseSSEStream;
 exports.privateKeyToHex = privateKeyToHex;
 exports.relayDelegation = relayDelegation;
 exports.retryDelayMs = retryDelayMs;
+exports.setAssetMetadataStore = setAssetMetadataStore;
 exports.venueBaseUrlCandidates = venueBaseUrlCandidates;

package/dist/index.mjs

@@ -1497,6 +1497,53 @@ async function* parseSSEStream(response) {
   }
 }
 
+// src/asset-cache.ts
+var PREFIX = "covia:asset-meta:";
+var LocalStorageMetadataStore = class {
+  get(hash) {
+    try {
+      const raw = localStorage.getItem(PREFIX + hash);
+      return raw ? JSON.parse(raw) : void 0;
+    } catch {
+      return void 0;
+    }
+  }
+  put(hash, metadata) {
+    try {
+      localStorage.setItem(PREFIX + hash, JSON.stringify(metadata));
+    } catch {
+    }
+  }
+  clear() {
+    try {
+      const doomed = [];
+      for (let i = 0; i < localStorage.length; i++) {
+        const key = localStorage.key(i);
+        if (key?.startsWith(PREFIX)) doomed.push(key);
+      }
+      doomed.forEach((k) => localStorage.removeItem(k));
+    } catch {
+    }
+  }
+};
+function detectDefaultStore() {
+  try {
+    return typeof localStorage !== "undefined" ? new LocalStorageMetadataStore() : null;
+  } catch {
+    return null;
+  }
+}
+var store = detectDefaultStore();
+function setAssetMetadataStore(s) {
+  store = s;
+}
+function getAssetMetadataStore() {
+  return store;
+}
+function normaliseHash(hash) {
+  return (hash.startsWith("0x") ? hash.slice(2) : hash).toLowerCase();
+}
+
 // src/AdapterManager.ts
 var ADAPTERS_PATH = "v/info/adapters";
 var LIST_LIMIT = 1e3;
@@ -1583,6 +1630,8 @@ var AgentManager = class {
         );
       } catch (e) {
         if (!(e instanceof NotFoundError)) throw e;
+        const routeMissing = path === "" || /\bEndpoint (GET|POST|PUT|DELETE|PATCH|HEAD) /.test(e.message);
+        if (!routeMissing) throw e;
         this.agentsGetSupported = false;
       }
     }
@@ -1625,7 +1674,10 @@ var AgentManager = class {
    * venues transparently fall back to the invoke path (one probe, remembered).
    */
   async list(includeTerminated) {
-    return this._agentsOr("", { includeTerminated }, () => this.venue.operations.run("v/ops/agent/list", { includeTerminated }));
+    const result = await this._agentsOr("", { includeTerminated }, () => this.venue.operations.run("v/ops/agent/list", { includeTerminated }));
+    const raw = result?.agents ?? [];
+    const agents = raw.map((a) => typeof a === "string" ? { agentId: a } : a);
+    return { agents };
   }
   async delete(agentId, remove) {
     return this.venue.operations.run("v/ops/agent/delete", { agentId, remove });
@@ -1812,9 +1864,12 @@ var JobManager = class {
     this.venue = venue;
   }
   async list() {
-    return fetchWithError(`${this.venue.baseUrl}/api/v1/jobs`, {
+    const body = await fetchWithError(`${this.venue.baseUrl}/api/v1/jobs`, {
       headers: this._buildHeaders()
     });
+    if (Array.isArray(body)) return body;
+    const items = body?.items;
+    return Array.isArray(items) ? items : [];
   }
   async get(jobId) {
     try {
@@ -2002,21 +2057,23 @@ var AssetManager = class {
    */
   async get(assetId) {
     if (cache.has(assetId)) {
-      const cachedData = cache.get(assetId);
-      if (cachedData.operation) {
-        return new Operation(assetId, this.venue, cachedData);
-      } else {
-        return new DataAsset(assetId, this.venue, cachedData);
+      return this._wrap(assetId, cache.get(assetId));
+    }
+    const hash = assetHash(assetId);
+    if (hash) {
+      const persisted = getAssetMetadataStore()?.get(normaliseHash(hash));
+      if (persisted) {
+        cache.set(assetId, persisted);
+        return this._wrap(assetId, persisted);
       }
     }
     try {
       const data = await fetchWithError(`${this.venue.baseUrl}/api/v1/assets/${assetId}`);
-      if (assetHash(assetId)) cache.set(assetId, data);
-      if (data.operation) {
-        return new Operation(assetId, this.venue, data);
-      } else {
-        return new DataAsset(assetId, this.venue, data);
+      if (hash) {
+        cache.set(assetId, data);
+        getAssetMetadataStore()?.put(normaliseHash(hash), data);
       }
+      return this._wrap(assetId, data);
     } catch (error) {
       if (error instanceof NotFoundError) {
         throw new AssetNotFoundError(assetId);
@@ -2024,6 +2081,12 @@ var AssetManager = class {
       throw error;
     }
   }
+  _wrap(assetId, data) {
+    if (data.operation) {
+      return new Operation(assetId, this.venue, data);
+    }
+    return new DataAsset(assetId, this.venue, data);
+  }
   /**
    * List assets with pagination support
    * @param options - Pagination options (offset, limit)
@@ -2109,6 +2172,7 @@ var AssetManager = class {
    */
   clearCache() {
     cache.clear();
+    getAssetMetadataStore()?.clear();
   }
   // `contentType` defaults to JSON for the metadata/register endpoints. Pass
   // `undefined` for binary content upload so fetch infers the type from the
@@ -2277,7 +2341,8 @@ var WorkspaceManager = class {
     return this._valuesOr("read", { path, maxSize }, () => this.venue.operations.run("v/ops/covia/read", { path, maxSize }));
   }
   async list(path, limit, offset, ucans) {
-    if (ucans?.length || !path) return this.venue.operations.run("v/ops/covia/list", { path, limit, offset }, { ucans });
+    path = path || "/";
+    if (ucans?.length) return this.venue.operations.run("v/ops/covia/list", { path, limit, offset }, { ucans });
     return this._valuesOr("list", { path, limit, offset }, () => this.venue.operations.run("v/ops/covia/list", { path, limit, offset }));
   }
   async slice(path, offset, limit, ucans) {
@@ -2801,4 +2866,4 @@ function relayDelegation(privateKey, venueDID, lifetimeSeconds, caps = []) {
   (*! noble-ed25519 - MIT License (c) 2019 Paul Miller (paulmillr.com) *)
 */
 
-export { AdapterManager, Agent, AgentManager, AgentStatus, Asset, AssetManager, AssetNotFoundError, Auth, BasicAuth, BearerAuth, ChatSession, CoviaConnectionError, CoviaError, CoviaTimeoutError, CredentialsHTTP, DataAsset, Ed25519Auth, Grid, GridError, Job, JobFailedError, JobManager, JobNotFoundError, JobStatus, KeyPairAuth, Namespace, NoAuth, NotFoundError, Operation, OperationManager, RateLimitError, RunStatus, SecretManager, UCANManager, VENUE_RELAY, Venue, WorkspaceManager, assetHash, createSSEEvent, createUCANJWT, decodePublicKey, didFor, didFromPublicKey, didMethod, didUrl, encodePublicKey, fetchStreamWithError, fetchWithError, generateKeyPair, getAssetIdFromPath, getAssetIdFromVenueId, getParsedAssetId, grant, hexToPrivateKey, identityToken, isDid, isJobComplete, isJobFinished, isJobPaused, logger, parseDidUrl, parseRetryAfterMs, parseSSEStream, privateKeyToHex, relayDelegation, retryDelayMs, venueBaseUrlCandidates };
+export { AdapterManager, Agent, AgentManager, AgentStatus, Asset, AssetManager, AssetNotFoundError, Auth, BasicAuth, BearerAuth, ChatSession, CoviaConnectionError, CoviaError, CoviaTimeoutError, CredentialsHTTP, DataAsset, Ed25519Auth, Grid, GridError, Job, JobFailedError, JobManager, JobNotFoundError, JobStatus, KeyPairAuth, Namespace, NoAuth, NotFoundError, Operation, OperationManager, RateLimitError, RunStatus, SecretManager, UCANManager, VENUE_RELAY, Venue, 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.7.0",
+  "version": "1.7.2",
   "description": "Typescript library for covia-ai",
   "packageManager": "pnpm@11.9.0",
   "main": "./dist/index.js",