@agentxm/registry-client 0.28.4 → 0.28.6

package/dist/src/client.d.ts

@@ -50,6 +50,11 @@ export interface GetExtensionsByOwnerArgs {
  * - `name`: extension name
  * - `version`: specific version to fetch, or `None` for latest
  */
+/** Bytes received so far and the declared total when the transport reports one. */
+export interface ArchiveDownloadProgress {
+    readonly done: number;
+    readonly total?: number | undefined;
+}
 export interface GetExtensionPackageArgs {
     readonly owner: Handle;
     readonly type: ExtensionType;
@@ -57,6 +62,11 @@ export interface GetExtensionPackageArgs {
     readonly version: Option.Option<Version | VersionRange>;
     /** Marks an archive read used only to verify compatibility before selection. */
     readonly usagePurpose?: "verification";
+    /**
+     * Observes archive bytes as they arrive. Called once per received chunk;
+     * callers throttle before publishing. Never called for a cache hit.
+     */
+    readonly onProgress?: (progress: ArchiveDownloadProgress) => Effect.Effect<void>;
 }
 /**
  * Options for fetching extension index metadata from a registry.

package/dist/src/index.d.ts

@@ -9,7 +9,7 @@
  * @experimental This API is unstable and may change without notice.
  * @packageDocumentation
  */
-export type { RegistryClient, RegistryExtensionManifest, DiscoverPackageInput, DiscoverPackagesArgs, GetExtensionsByOwnerArgs, GetExtensionsByOwnerResponse, GetExtensionIndexArgs, GetExactExtensionVersionArgs, ExactExtensionVersion, GetExtensionVisibilityArgs, GetExtensionPackageArgs, GetExtensionPackageResponse, PublishExtensionArgs, PublishExtensionResponse, RegistryPublishWarning, PreviewExtensionPublishesArgs, PublishPreviewResult, PublishPreviewTarget, OwnerExistsResponse, ExtensionExistsArgs, ExtensionExistsResponse, ExtensionVisibility, UpdateExtensionVisibilityArgs, } from "./client.js";
+export type { RegistryClient, RegistryExtensionManifest, DiscoverPackageInput, DiscoverPackagesArgs, GetExtensionsByOwnerArgs, GetExtensionsByOwnerResponse, GetExtensionIndexArgs, GetExactExtensionVersionArgs, ExactExtensionVersion, GetExtensionVisibilityArgs, ArchiveDownloadProgress, GetExtensionPackageArgs, GetExtensionPackageResponse, PublishExtensionArgs, PublishExtensionResponse, RegistryPublishWarning, PreviewExtensionPublishesArgs, PublishPreviewResult, PublishPreviewTarget, OwnerExistsResponse, ExtensionExistsArgs, ExtensionExistsResponse, ExtensionVisibility, UpdateExtensionVisibilityArgs, } from "./client.js";
 export { createRegistryClient } from "./client.js";
 export { createLocalRegistryClient } from "./local-client.js";
 export { createRemoteRegistryClient } from "./remote-client.js";

package/dist/src/remote-client.js

@@ -9,8 +9,11 @@
  * @experimental This API is unstable and may change without notice.
  * @packageDocumentation
  */
+import * as Headers from "effect/unstable/http/Headers";
 import * as HttpClient from "effect/unstable/http/HttpClient";
 import * as HttpClientRequest from "effect/unstable/http/HttpClientRequest";
+import * as MutableRef from "effect/MutableRef";
+import * as Stream from "effect/Stream";
 import * as Effect from "effect/Effect";
 import * as Option from "effect/Option";
 import * as Schema from "effect/Schema";
@@ -197,6 +200,35 @@ const extensionDeclarationToDiscoveryRef = (value) => {
             : { versionRange: value.versionRange }),
     };
 };
+const contentLength = (response) => Option.match(Headers.get(response.headers, "content-length"), {
+    onNone: () => undefined,
+    onSome: (value) => {
+        const parsed = Number(value);
+        return Number.isFinite(parsed) && parsed >= 0 ? parsed : undefined;
+    },
+});
+/**
+ * Stream one archive body into memory, reporting received bytes per chunk.
+ * Non-2xx statuses fail as `HttpClientError` so the caller's mapping keeps
+ * the response evidence.
+ */
+const downloadArchive = (http, path, onProgress) => Effect.gen(function* () {
+    const response = yield* HttpClient.filterStatusOk(http).execute(HttpClientRequest.get(path));
+    const total = contentLength(response);
+    const received = MutableRef.make(0);
+    const report = onProgress ?? (() => Effect.void);
+    const chunks = yield* response.stream.pipe(Stream.tap((chunk) => report({
+        done: MutableRef.updateAndGet(received, (done) => done + chunk.byteLength),
+        ...(total === undefined ? {} : { total }),
+    })), Stream.runCollect);
+    const archive = new Uint8Array(MutableRef.get(received));
+    let offset = 0;
+    for (const chunk of chunks) {
+        archive.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return archive;
+});
 const registryRequestMetadata = (method, url) => ({
     service: "registry",
     method,
@@ -216,9 +248,7 @@ const registryRequestMetadata = (method, url) => ({
 export const createRemoteRegistryClient = (baseUrl, httpClient, archiveCache, requestPolicy) => {
     const remoteHttpClient = captureRegistryErrorResponseBodies(httpClient.pipe(HttpClient.mapRequest(HttpClientRequest.prependUrl(baseUrl))));
     const client = GeneratedRegistryClient.make(remoteHttpClient);
-    const verificationArchiveClient = GeneratedRegistryClient.make(remoteHttpClient, {
-        transformClient: (baseClient) => Effect.succeed(baseClient.pipe(HttpClient.mapRequest(HttpClientRequest.setHeader("x-agentxm-usage-purpose", "verification")))),
-    });
+    const verificationHttpClient = remoteHttpClient.pipe(HttpClient.mapRequest(HttpClientRequest.setHeader("x-agentxm-usage-purpose", "verification")));
     const executeRemoteRequest = (effect, args) => executeRegistryRequest(effect, {
         operation: args.operation,
         request: registryRequestMetadata(args.method, new URL(args.path, baseUrl).href),
@@ -457,12 +487,13 @@ export const createRemoteRegistryClient = (baseUrl, httpClient, archiveCache, re
                 };
             }
         }
-        // Step 3: Download archive
-        const archiveClient = args.usagePurpose === "verification" ? verificationArchiveClient : client;
-        const archive = yield* executeRemoteRequest(archiveClient.ExtensionsDownloadArchive(args.owner, pluralizeType(args.type), args.name, resolvedEntry.value.version, undefined), {
+        // Step 3: Download archive, streaming the body so the caller observes
+        // progress as bytes arrive; the transport never decides how often.
+        const archivePath = `/v1/extensions/${args.owner}/${pluralizeType(args.type)}/${args.name}/${resolvedEntry.value.version}/archive`;
+        const archive = yield* executeRemoteRequest(downloadArchive(args.usagePurpose === "verification" ? verificationHttpClient : remoteHttpClient, archivePath, args.onProgress), {
             operation: "download package archive",
             method: "GET",
-            path: `/v1/extensions/${args.owner}/${pluralizeType(args.type)}/${args.name}/${resolvedEntry.value.version}/archive`,
+            path: archivePath,
             replaySafety: safe,
             mapError: mapArchiveFetchError,
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentxm/registry-client",
-  "version": "0.28.4",
+  "version": "0.28.6",
   "description": "AXM registry integration: local and remote registry clients over the generated OpenAPI transport, request policy and retries, typed registry failures, archive cache, and lifecycle administration for the axm CLI. Unstable and unsupported — use the axm.sh CLI.",
   "type": "module",
   "license": "FSL-1.1-MIT",
@@ -18,6 +18,7 @@
   "exports": {
     ".": {
       "types": "./dist/src/index.d.ts",
+      "axm-source": "./src/index.ts",
       "default": "./dist/src/index.js"
     }
   },
@@ -38,8 +39,8 @@
     "effect": "4.0.0-rc.112",
     "fflate": "^0.8.3",
     "semver": "^7.8.5",
-    "@agentxm/extension-model": "^0.28.4",
-    "@agentxm/registry-protocol": "^0.28.4"
+    "@agentxm/extension-model": "^0.28.6",
+    "@agentxm/registry-protocol": "^0.28.6"
   },
   "devDependencies": {
     "@effect/openapi-generator": "4.0.0-rc.112",