feat: align async STAC resolver with Python client

AGENTS.md

@@ -0,0 +1,11 @@
+# AGENTS.md
+
+## Cross-client parity
+
+This JavaScript client and [dClimate/dclimate-client-py](https://github.com/dClimate/dclimate-client-py) are sibling libraries. Keep their user-visible capabilities and behavior aligned unless a language or runtime difference makes a change inapplicable.
+
+- For every public API or behavior change—especially STAC/IPFS resolution, dataset loading and selection, metadata, errors, and catalog listing—inspect the corresponding implementation, tests, documentation, and relevant open work in the Python client before finishing.
+- Unless the user explicitly limits the task to one repository, treat an applicable sibling-library update as part of the same task. Add equivalent tests and documentation in both projects, using idiomatic APIs for each language rather than mechanically copying implementation details.
+- If a change is not applicable to the sibling, or the sibling cannot be updated in the current task, state the reason and leave a concrete follow-up in the handoff or pull-request description. Do not silently allow accidental divergence.
+- When reviewing either client, treat undocumented behavioral differences as possible defects and verify whether parity should be restored.
+

README.md

@@ -296,6 +296,22 @@ catalog.forEach(({ collection, datasets }) => {
 });
 ```
 
+### Resolving a CID directly
+
+Use the public STAC resolver when you need the selected CID and variant without loading the dataset. The API is natively asynchronous and uses the platform's pooled `fetch` implementation.
+
+```typescript
+import { resolveCidFromStacServer } from "@dclimate/dclimate-client-js";
+
+const resolved = await resolveCidFromStacServer(
+  "ecmwf_aifs",
+  "temperature_forecast",
+  "single"
+);
+
+console.log(resolved.cid, resolved.variant);
+```
+
 ## Configuration
 
 ### Client options
@@ -357,6 +373,12 @@ Metric attributes include the gateway URL, store type, and status. The dataset C
 - `listAvailableDatasets()` - Get the full dataset catalog
 - `siren` - Namespaced Siren REST API client (getter; throws `SirenNotConfiguredError` unless `siren` is configured)
 
+### STAC utilities
+
+- `resolveCidFromStacServer(collection, dataset, variant?, serverUrl?)` - Resolve a CID and selected variant without loading the dataset
+- `resolveDatasetCidFromStacServer(collection, dataset, variant?, serverUrl?)` - Resolve only the CID string
+- `listAvailableDatasetsFromStacServer(serverUrl?)` - List collections, datasets, and variants directly from the paginated STAC API
+
 ### SirenClient (via `client.siren` or standalone)
 
 - `getMetricData(query)` - Fetch metric data for a region over a date range

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dclimate/dclimate-client-js",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "JavaScript client for dClimate datasets using jaxray and IPFS stores",
   "type": "module",
   "main": "./dist/node/index.js",

src/index.ts

@@ -14,6 +14,9 @@ export {
   getConcatenableItemsFromStac,
   listAvailableDatasetsFromStac,
   listAvailableDatasetsFromStacServer,
+  resolveCidFromStacServer,
+  resolveDatasetCidFromStacServer,
+  DEFAULT_STAC_SERVER_URL,
   getRootCatalogCid,
   resolveIpfsUri,
   type StacCatalog,
@@ -25,6 +28,9 @@ export {
   type StacOrganization,
   type SpatialExtent,
   type TemporalExtent,
+  type StacServerSearchResponse,
+  type StacServerItem,
+  type ResolvedCidFromServer,
   StacCatalogError,
   StacLoadError,
   StacResolutionError,