@nimblebrain/mpak-sdk - npm Package Compare versions

Comparing version 0.4.1 to 0.5.0

dist/index.cjs

@@ -1090,4 +1090,5 @@ "use strict";
       } else {
+        const aliasesForField = envAliases.get(fieldName) ?? [];
         let envValue;
-        for (const envVar of envAliases.get(fieldName) ?? []) {
+        for (const envVar of aliasesForField) {
           const v = process.env[envVar];
@@ -1107,3 +1108,4 @@ if (typeof v === "string" && v.length > 0) {
             title: fieldData.title ?? fieldName,
-            sensitive: fieldData.sensitive ?? false
+            sensitive: fieldData.sensitive ?? false,
+            envAliases: aliasesForField
           };
@@ -1110,0 +1112,0 @@ if (fieldData.description !== void 0) {

dist/index.d.cts

@@ -648,2 +648,13 @@ import { BundleSearchParamsInput, BundleSearchResponse, BundleDetail, VersionsResponse, VersionDetail, PlatformInfo, DownloadInfo, SkillSearchParamsInput, SkillSearchResponse, SkillDetail, SkillDownloadInfo, CacheMetadata, McpbManifest, CachedBundleInfo } from '@nimblebrain/mpak-schemas';
     readonly packageName: string;
+    /**
+     * The fields that could not be satisfied by any of the SDK's resolution
+     * tiers (override, stored config, env alias, manifest default).
+     *
+     * `envAliases` lists the host env var names the bundle declared as
+     * satisfying this field in its `server.mcp_config.env`. Empty when the
+     * bundle has no `${user_config.<field>}` mapping. Always present —
+     * consumers never need to re-derive this from the manifest. A friendly
+     * error-translator can render a `export ANTHROPIC_API_KEY=...` hint
+     * directly from the error without reaching back into the manifest.
+     */
     readonly missingFields: Array<{
@@ -654,4 +665,17 @@ key: string;
         sensitive: boolean;
+        envAliases: string[];
     }>;
-    constructor(packageName: string, missingFields: Array<{
+    constructor(packageName: string, 
+    /**
+     * The fields that could not be satisfied by any of the SDK's resolution
+     * tiers (override, stored config, env alias, manifest default).
+     *
+     * `envAliases` lists the host env var names the bundle declared as
+     * satisfying this field in its `server.mcp_config.env`. Empty when the
+     * bundle has no `${user_config.<field>}` mapping. Always present —
+     * consumers never need to re-derive this from the manifest. A friendly
+     * error-translator can render a `export ANTHROPIC_API_KEY=...` hint
+     * directly from the error without reaching back into the manifest.
+     */
+    missingFields: Array<{
         key: string;
@@ -661,2 +685,3 @@ title: string;
         sensitive: boolean;
+        envAliases: string[];
     }>);
@@ -663,0 +688,0 @@ }

dist/index.d.ts

@@ -648,2 +648,13 @@ import { BundleSearchParamsInput, BundleSearchResponse, BundleDetail, VersionsResponse, VersionDetail, PlatformInfo, DownloadInfo, SkillSearchParamsInput, SkillSearchResponse, SkillDetail, SkillDownloadInfo, CacheMetadata, McpbManifest, CachedBundleInfo } from '@nimblebrain/mpak-schemas';
     readonly packageName: string;
+    /**
+     * The fields that could not be satisfied by any of the SDK's resolution
+     * tiers (override, stored config, env alias, manifest default).
+     *
+     * `envAliases` lists the host env var names the bundle declared as
+     * satisfying this field in its `server.mcp_config.env`. Empty when the
+     * bundle has no `${user_config.<field>}` mapping. Always present —
+     * consumers never need to re-derive this from the manifest. A friendly
+     * error-translator can render a `export ANTHROPIC_API_KEY=...` hint
+     * directly from the error without reaching back into the manifest.
+     */
     readonly missingFields: Array<{
@@ -654,4 +665,17 @@ key: string;
         sensitive: boolean;
+        envAliases: string[];
     }>;
-    constructor(packageName: string, missingFields: Array<{
+    constructor(packageName: string, 
+    /**
+     * The fields that could not be satisfied by any of the SDK's resolution
+     * tiers (override, stored config, env alias, manifest default).
+     *
+     * `envAliases` lists the host env var names the bundle declared as
+     * satisfying this field in its `server.mcp_config.env`. Empty when the
+     * bundle has no `${user_config.<field>}` mapping. Always present —
+     * consumers never need to re-derive this from the manifest. A friendly
+     * error-translator can render a `export ANTHROPIC_API_KEY=...` hint
+     * directly from the error without reaching back into the manifest.
+     */
+    missingFields: Array<{
         key: string;
@@ -661,2 +685,3 @@ title: string;
         sensitive: boolean;
+        envAliases: string[];
     }>);
@@ -663,0 +688,0 @@ }

dist/index.js

@@ -1052,4 +1052,5 @@ // src/mpakSDK.ts
       } else {
+        const aliasesForField = envAliases.get(fieldName) ?? [];
         let envValue;
-        for (const envVar of envAliases.get(fieldName) ?? []) {
+        for (const envVar of aliasesForField) {
           const v = process.env[envVar];
@@ -1069,3 +1070,4 @@ if (typeof v === "string" && v.length > 0) {
             title: fieldData.title ?? fieldName,
-            sensitive: fieldData.sensitive ?? false
+            sensitive: fieldData.sensitive ?? false,
+            envAliases: aliasesForField
           };
@@ -1072,0 +1074,0 @@ if (fieldData.description !== void 0) {

package.json

 {
   "name": "@nimblebrain/mpak-sdk",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "TypeScript SDK for mpak registry - MCPB bundles and Agent Skills",
@@ -5,0 +5,0 @@ "author": "NimbleBrain Inc <[e-mail]>",

No alert changes

Improved metrics

Total package byte prevSize

336072

1.45%

Lines of code

3165

0.92%

No dependency changes