@evalops/maestro 0.10.18 → 0.10.21

package/dist/opentelemetry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"opentelemetry.d.ts","sourceRoot":"","sources":["../src/opentelemetry.ts"],"names":[],"mappings":"AA0CA,eAAO,MAAM,sBAAsB,QAAO,OAmBzC,CAAC;AAEF,eAAO,MAAM,kBAAkB,2CAAoC,CAAC;AAEpE,MAAM,WAAW,mBAAmB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,sBAAsB,IAAI,mBAAmB,CAsC5D;AAED,wBAAsB,iBAAiB,CACtC,WAAW,SAAa,GACtB,OAAO,CAAC,IAAI,CAAC,CAiEf"}
+{"version":3,"file":"opentelemetry.d.ts","sourceRoot":"","sources":["../src/opentelemetry.ts"],"names":[],"mappings":"AAmCA,eAAO,MAAM,sBAAsB,QAAO,OAuBzC,CAAC;AAEF,eAAO,MAAM,kBAAkB,2CAAoC,CAAC;AAEpE,MAAM,WAAW,mBAAmB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,sBAAsB,IAAI,mBAAmB,CAyC5D;AAED,wBAAsB,iBAAiB,CACtC,WAAW,SAAa,GACtB,OAAO,CAAC,IAAI,CAAC,CAiEf"}

package/dist/opentelemetry.js

@@ -1,9 +1,10 @@
-import { createRequire } from "node:module";
 import { DiagConsoleLogger, DiagLogLevel, diag, trace, } from "@opentelemetry/api";
 import { getNodeAutoInstrumentations } from "@opentelemetry/auto-instrumentations-node";
 import { resourceFromAttributes } from "@opentelemetry/resources";
 import { NodeSDK } from "@opentelemetry/sdk-node";
 import { SEMRESATTRS_DEPLOYMENT_ENVIRONMENT, SEMRESATTRS_SERVICE_NAME, SEMRESATTRS_SERVICE_VERSION, } from "@opentelemetry/semantic-conventions";
+import { readPackageVersion } from "./package-version.js";
+import { isInternalTelemetryDisabled } from "./telemetry/disablement.js";
 let sdkStartPromise = null;
 let sdkStarted = false;
 let handlersRegistered = false;
@@ -16,18 +17,14 @@ const packageVersion = (() => {
         if (cached) {
             return cached;
         }
-        try {
-            const packageJson = createRequire(import.meta.url)("../package.json");
-            const version = packageJson.version;
-            cached = typeof version === "string" ? version : "unknown";
-        }
-        catch (error) {
-            cached = process.env.MAESTRO_VERSION ?? "unknown";
-        }
+        cached = readPackageVersion();
         return cached;
     };
 })();
 export const isOpenTelemetryEnabled = () => {
+    if (isInternalTelemetryDisabled()) {
+        return false;
+    }
     if (process.env.MAESTRO_OTEL === "0") {
         return false;
     }
@@ -45,6 +42,7 @@ export const isOpenTelemetryEnabled = () => {
 };
 export const getTelemetryTracer = () => trace.getTracer("composer");
 export function getOpenTelemetryStatus() {
+    const internalTelemetryDisabled = isInternalTelemetryDisabled();
     const enabled = isOpenTelemetryEnabled();
     const otlpEndpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
     const tracesExporter = process.env.OTEL_TRACES_EXPORTER || (otlpEndpoint ? "otlp" : "default");
@@ -58,9 +56,11 @@ export function getOpenTelemetryStatus() {
         ? process.env.MAESTRO_OTEL === "1"
             ? "MAESTRO_OTEL=1"
             : "OTEL exporter detected"
-        : process.env.MAESTRO_OTEL === "0"
-            ? "MAESTRO_OTEL=0"
-            : "no OTEL exporter configured";
+        : internalTelemetryDisabled
+            ? "internal telemetry disabled"
+            : process.env.MAESTRO_OTEL === "0"
+                ? "MAESTRO_OTEL=0"
+                : "no OTEL exporter configured";
     return {
         enabled,
         reason,

package/dist/opentelemetry.js.map

@@ -1 +1 @@
-{"version":3,"file":"opentelemetry.js","sourceRoot":"","sources":["../src/opentelemetry.ts"],"names":[],"mappings":"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","sourcesContent":["import { createRequire } from \"node:module\";\nimport {\n\tDiagConsoleLogger,\n\tDiagLogLevel,\n\tdiag,\n\ttrace,\n} from \"@opentelemetry/api\";\nimport { getNodeAutoInstrumentations } from \"@opentelemetry/auto-instrumentations-node\";\nimport { resourceFromAttributes } from \"@opentelemetry/resources\";\nimport { NodeSDK } from \"@opentelemetry/sdk-node\";\nimport {\n\tSEMRESATTRS_DEPLOYMENT_ENVIRONMENT,\n\tSEMRESATTRS_SERVICE_NAME,\n\tSEMRESATTRS_SERVICE_VERSION,\n} from \"@opentelemetry/semantic-conventions\";\n\nlet sdkStartPromise: Promise<void> | null = null;\nlet sdkStarted = false;\nlet handlersRegistered = false;\nlet configuredServiceName: string | null = null;\nlet configuredSampler: string | null = null;\nlet sdkInstance: NodeSDK | null = null;\n\nconst packageVersion = (() => {\n\tlet cached: string | null = null;\n\treturn (): string => {\n\t\tif (cached) {\n\t\t\treturn cached;\n\t\t}\n\t\ttry {\n\t\t\tconst packageJson = createRequire(import.meta.url)(\"../package.json\") as {\n\t\t\t\tversion?: string;\n\t\t\t};\n\t\t\tconst version = packageJson.version;\n\t\t\tcached = typeof version === \"string\" ? version : \"unknown\";\n\t\t} catch (error) {\n\t\t\tcached = process.env.MAESTRO_VERSION ?? \"unknown\";\n\t\t}\n\t\treturn cached;\n\t};\n})();\n\nexport const isOpenTelemetryEnabled = (): boolean => {\n\tif (process.env.MAESTRO_OTEL === \"0\") {\n\t\treturn false;\n\t}\n\n\tif (process.env.MAESTRO_OTEL === \"1\") {\n\t\treturn true;\n\t}\n\n\tconst hasOtlpEndpoint = Boolean(process.env.OTEL_EXPORTER_OTLP_ENDPOINT);\n\tconst traceExporter = process.env.OTEL_TRACES_EXPORTER;\n\tconst metricsExporter = process.env.OTEL_METRICS_EXPORTER;\n\tconst logsExporter = process.env.OTEL_LOGS_EXPORTER;\n\tconst hasExplicitExporter =\n\t\t(traceExporter && traceExporter !== \"none\") ||\n\t\t(metricsExporter && metricsExporter !== \"none\") ||\n\t\t(logsExporter && logsExporter !== \"none\");\n\n\treturn hasOtlpEndpoint || Boolean(hasExplicitExporter);\n};\n\nexport const getTelemetryTracer = () => trace.getTracer(\"composer\");\n\nexport interface OpenTelemetryStatus {\n\tenabled: boolean;\n\treason: string;\n\tserviceName: string;\n\tsdkStarted: boolean;\n\totlpEndpoint?: string;\n\ttracesExporter?: string;\n\tmetricsExporter?: string;\n\tlogsExporter?: string;\n\tautoInstrumentation: boolean;\n\tsampler?: string;\n}\n\nexport function getOpenTelemetryStatus(): OpenTelemetryStatus {\n\tconst enabled = isOpenTelemetryEnabled();\n\tconst otlpEndpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT;\n\tconst tracesExporter =\n\t\tprocess.env.OTEL_TRACES_EXPORTER || (otlpEndpoint ? \"otlp\" : \"default\");\n\tconst metricsExporter =\n\t\tprocess.env.OTEL_METRICS_EXPORTER || (otlpEndpoint ? \"otlp\" : \"default\");\n\tconst logsExporter =\n\t\tprocess.env.OTEL_LOGS_EXPORTER || (otlpEndpoint ? \"otlp\" : \"default\");\n\tconst sampler =\n\t\tconfiguredSampler ||\n\t\tprocess.env.OTEL_TRACES_SAMPLER ||\n\t\tprocess.env.MAESTRO_OTEL_SAMPLER ||\n\t\t\"parentbased_traceidratio\";\n\n\tconst reason = enabled\n\t\t? process.env.MAESTRO_OTEL === \"1\"\n\t\t\t? \"MAESTRO_OTEL=1\"\n\t\t\t: \"OTEL exporter detected\"\n\t\t: process.env.MAESTRO_OTEL === \"0\"\n\t\t\t? \"MAESTRO_OTEL=0\"\n\t\t\t: \"no OTEL exporter configured\";\n\n\treturn {\n\t\tenabled,\n\t\treason,\n\t\tserviceName:\n\t\t\tconfiguredServiceName ||\n\t\t\tprocess.env.MAESTRO_OTEL_SERVICE_NAME ||\n\t\t\t\"composer\",\n\t\tsdkStarted,\n\t\totlpEndpoint,\n\t\ttracesExporter,\n\t\tmetricsExporter,\n\t\tlogsExporter,\n\t\tautoInstrumentation: enabled,\n\t\tsampler,\n\t};\n}\n\nexport async function initOpenTelemetry(\n\tserviceName = \"composer\",\n): Promise<void> {\n\tif (sdkStartPromise) {\n\t\treturn sdkStartPromise;\n\t}\n\tif (!isOpenTelemetryEnabled()) {\n\t\tsdkStartPromise = Promise.resolve();\n\t\treturn sdkStartPromise;\n\t}\n\n\tdiag.setLogger(new DiagConsoleLogger(), DiagLogLevel.ERROR);\n\n\tconst resolvedServiceName =\n\t\tprocess.env.MAESTRO_OTEL_SERVICE_NAME || serviceName;\n\tconfiguredServiceName = resolvedServiceName;\n\n\tif (process.env.MAESTRO_OTEL_SAMPLER && !process.env.OTEL_TRACES_SAMPLER) {\n\t\tprocess.env.OTEL_TRACES_SAMPLER = process.env.MAESTRO_OTEL_SAMPLER;\n\t\tconfiguredSampler = process.env.MAESTRO_OTEL_SAMPLER;\n\t} else if (process.env.OTEL_TRACES_SAMPLER) {\n\t\tconfiguredSampler = process.env.OTEL_TRACES_SAMPLER;\n\t}\n\tconst resource = resourceFromAttributes({\n\t\t[SEMRESATTRS_SERVICE_NAME]: resolvedServiceName,\n\t\t[SEMRESATTRS_SERVICE_VERSION]: packageVersion(),\n\t\t[SEMRESATTRS_DEPLOYMENT_ENVIRONMENT]: process.env.NODE_ENV ?? \"development\",\n\t});\n\n\tconst sdk = new NodeSDK({\n\t\tresource,\n\t\tinstrumentations: [getNodeAutoInstrumentations()],\n\t});\n\tsdkInstance = sdk;\n\tsdkStartPromise = Promise.resolve().then(() => {\n\t\ttry {\n\t\t\tsdk.start();\n\t\t\tsdkStarted = true;\n\t\t} catch {\n\t\t\t// If OTEL boot fails, continue without blocking CLI/Web usage\n\t\t}\n\t});\n\n\tif (!handlersRegistered) {\n\t\thandlersRegistered = true;\n\t\tconst shutdown = async () => {\n\t\t\ttry {\n\t\t\t\tif (sdkInstance) {\n\t\t\t\t\tawait sdkInstance.shutdown();\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\t// Ignore shutdown failures\n\t\t\t}\n\t\t};\n\n\t\tprocess.once(\"beforeExit\", () => {\n\t\t\tvoid shutdown();\n\t\t});\n\t\tprocess.once(\"SIGINT\", () => {\n\t\t\tvoid shutdown();\n\t\t});\n\t\tprocess.once(\"SIGTERM\", () => {\n\t\t\tvoid shutdown();\n\t\t});\n\t}\n\n\treturn sdkStartPromise;\n}\n"]}
+{"version":3,"file":"opentelemetry.js","sourceRoot":"","sources":["../src/opentelemetry.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\tDiagConsoleLogger,\n\tDiagLogLevel,\n\tdiag,\n\ttrace,\n} from \"@opentelemetry/api\";\nimport { getNodeAutoInstrumentations } from \"@opentelemetry/auto-instrumentations-node\";\nimport { resourceFromAttributes } from \"@opentelemetry/resources\";\nimport { NodeSDK } from \"@opentelemetry/sdk-node\";\nimport {\n\tSEMRESATTRS_DEPLOYMENT_ENVIRONMENT,\n\tSEMRESATTRS_SERVICE_NAME,\n\tSEMRESATTRS_SERVICE_VERSION,\n} from \"@opentelemetry/semantic-conventions\";\nimport { readPackageVersion } from \"./package-version.js\";\nimport { isInternalTelemetryDisabled } from \"./telemetry/disablement.js\";\n\nlet sdkStartPromise: Promise<void> | null = null;\nlet sdkStarted = false;\nlet handlersRegistered = false;\nlet configuredServiceName: string | null = null;\nlet configuredSampler: string | null = null;\nlet sdkInstance: NodeSDK | null = null;\n\nconst packageVersion = (() => {\n\tlet cached: string | null = null;\n\treturn (): string => {\n\t\tif (cached) {\n\t\t\treturn cached;\n\t\t}\n\t\tcached = readPackageVersion();\n\t\treturn cached;\n\t};\n})();\n\nexport const isOpenTelemetryEnabled = (): boolean => {\n\tif (isInternalTelemetryDisabled()) {\n\t\treturn false;\n\t}\n\n\tif (process.env.MAESTRO_OTEL === \"0\") {\n\t\treturn false;\n\t}\n\n\tif (process.env.MAESTRO_OTEL === \"1\") {\n\t\treturn true;\n\t}\n\n\tconst hasOtlpEndpoint = Boolean(process.env.OTEL_EXPORTER_OTLP_ENDPOINT);\n\tconst traceExporter = process.env.OTEL_TRACES_EXPORTER;\n\tconst metricsExporter = process.env.OTEL_METRICS_EXPORTER;\n\tconst logsExporter = process.env.OTEL_LOGS_EXPORTER;\n\tconst hasExplicitExporter =\n\t\t(traceExporter && traceExporter !== \"none\") ||\n\t\t(metricsExporter && metricsExporter !== \"none\") ||\n\t\t(logsExporter && logsExporter !== \"none\");\n\n\treturn hasOtlpEndpoint || Boolean(hasExplicitExporter);\n};\n\nexport const getTelemetryTracer = () => trace.getTracer(\"composer\");\n\nexport interface OpenTelemetryStatus {\n\tenabled: boolean;\n\treason: string;\n\tserviceName: string;\n\tsdkStarted: boolean;\n\totlpEndpoint?: string;\n\ttracesExporter?: string;\n\tmetricsExporter?: string;\n\tlogsExporter?: string;\n\tautoInstrumentation: boolean;\n\tsampler?: string;\n}\n\nexport function getOpenTelemetryStatus(): OpenTelemetryStatus {\n\tconst internalTelemetryDisabled = isInternalTelemetryDisabled();\n\tconst enabled = isOpenTelemetryEnabled();\n\tconst otlpEndpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT;\n\tconst tracesExporter =\n\t\tprocess.env.OTEL_TRACES_EXPORTER || (otlpEndpoint ? \"otlp\" : \"default\");\n\tconst metricsExporter =\n\t\tprocess.env.OTEL_METRICS_EXPORTER || (otlpEndpoint ? \"otlp\" : \"default\");\n\tconst logsExporter =\n\t\tprocess.env.OTEL_LOGS_EXPORTER || (otlpEndpoint ? \"otlp\" : \"default\");\n\tconst sampler =\n\t\tconfiguredSampler ||\n\t\tprocess.env.OTEL_TRACES_SAMPLER ||\n\t\tprocess.env.MAESTRO_OTEL_SAMPLER ||\n\t\t\"parentbased_traceidratio\";\n\n\tconst reason = enabled\n\t\t? process.env.MAESTRO_OTEL === \"1\"\n\t\t\t? \"MAESTRO_OTEL=1\"\n\t\t\t: \"OTEL exporter detected\"\n\t\t: internalTelemetryDisabled\n\t\t\t? \"internal telemetry disabled\"\n\t\t\t: process.env.MAESTRO_OTEL === \"0\"\n\t\t\t\t? \"MAESTRO_OTEL=0\"\n\t\t\t\t: \"no OTEL exporter configured\";\n\n\treturn {\n\t\tenabled,\n\t\treason,\n\t\tserviceName:\n\t\t\tconfiguredServiceName ||\n\t\t\tprocess.env.MAESTRO_OTEL_SERVICE_NAME ||\n\t\t\t\"composer\",\n\t\tsdkStarted,\n\t\totlpEndpoint,\n\t\ttracesExporter,\n\t\tmetricsExporter,\n\t\tlogsExporter,\n\t\tautoInstrumentation: enabled,\n\t\tsampler,\n\t};\n}\n\nexport async function initOpenTelemetry(\n\tserviceName = \"composer\",\n): Promise<void> {\n\tif (sdkStartPromise) {\n\t\treturn sdkStartPromise;\n\t}\n\tif (!isOpenTelemetryEnabled()) {\n\t\tsdkStartPromise = Promise.resolve();\n\t\treturn sdkStartPromise;\n\t}\n\n\tdiag.setLogger(new DiagConsoleLogger(), DiagLogLevel.ERROR);\n\n\tconst resolvedServiceName =\n\t\tprocess.env.MAESTRO_OTEL_SERVICE_NAME || serviceName;\n\tconfiguredServiceName = resolvedServiceName;\n\n\tif (process.env.MAESTRO_OTEL_SAMPLER && !process.env.OTEL_TRACES_SAMPLER) {\n\t\tprocess.env.OTEL_TRACES_SAMPLER = process.env.MAESTRO_OTEL_SAMPLER;\n\t\tconfiguredSampler = process.env.MAESTRO_OTEL_SAMPLER;\n\t} else if (process.env.OTEL_TRACES_SAMPLER) {\n\t\tconfiguredSampler = process.env.OTEL_TRACES_SAMPLER;\n\t}\n\tconst resource = resourceFromAttributes({\n\t\t[SEMRESATTRS_SERVICE_NAME]: resolvedServiceName,\n\t\t[SEMRESATTRS_SERVICE_VERSION]: packageVersion(),\n\t\t[SEMRESATTRS_DEPLOYMENT_ENVIRONMENT]: process.env.NODE_ENV ?? \"development\",\n\t});\n\n\tconst sdk = new NodeSDK({\n\t\tresource,\n\t\tinstrumentations: [getNodeAutoInstrumentations()],\n\t});\n\tsdkInstance = sdk;\n\tsdkStartPromise = Promise.resolve().then(() => {\n\t\ttry {\n\t\t\tsdk.start();\n\t\t\tsdkStarted = true;\n\t\t} catch {\n\t\t\t// If OTEL boot fails, continue without blocking CLI/Web usage\n\t\t}\n\t});\n\n\tif (!handlersRegistered) {\n\t\thandlersRegistered = true;\n\t\tconst shutdown = async () => {\n\t\t\ttry {\n\t\t\t\tif (sdkInstance) {\n\t\t\t\t\tawait sdkInstance.shutdown();\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\t// Ignore shutdown failures\n\t\t\t}\n\t\t};\n\n\t\tprocess.once(\"beforeExit\", () => {\n\t\t\tvoid shutdown();\n\t\t});\n\t\tprocess.once(\"SIGINT\", () => {\n\t\t\tvoid shutdown();\n\t\t});\n\t\tprocess.once(\"SIGTERM\", () => {\n\t\t\tvoid shutdown();\n\t\t});\n\t}\n\n\treturn sdkStartPromise;\n}\n"]}

package/dist/package-version.d.ts

@@ -0,0 +1,2 @@
+export declare function readPackageVersion(): string;
+//# sourceMappingURL=package-version.d.ts.map

package/dist/package-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-version.d.ts","sourceRoot":"","sources":["../src/package-version.ts"],"names":[],"mappings":"AAEA,wBAAgB,kBAAkB,IAAI,MAAM,CAS3C"}

package/dist/package-version.js

@@ -0,0 +1,11 @@
+import { createRequire } from "node:module";
+export function readPackageVersion() {
+    try {
+        const packageJson = createRequire(import.meta.url)("../package.json");
+        return packageJson.version ?? "unknown";
+    }
+    catch {
+        return process.env.MAESTRO_VERSION ?? "unknown";
+    }
+}
+//# sourceMappingURL=package-version.js.map

package/dist/package-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-version.js","sourceRoot":"","sources":["../src/package-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,UAAU,kBAAkB;IACjC,IAAI,CAAC;QACJ,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAEnE,CAAC;QACF,OAAO,WAAW,CAAC,OAAO,IAAI,SAAS,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,SAAS,CAAC;IACjD,CAAC;AACF,CAAC","sourcesContent":["import { createRequire } from \"node:module\";\n\nexport function readPackageVersion(): string {\n\ttry {\n\t\tconst packageJson = createRequire(import.meta.url)(\"../package.json\") as {\n\t\t\tversion?: string;\n\t\t};\n\t\treturn packageJson.version ?? \"unknown\";\n\t} catch {\n\t\treturn process.env.MAESTRO_VERSION ?? \"unknown\";\n\t}\n}\n"]}

package/dist/packages/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const MAESTRO_PACKAGE_KEYWORD = "maestro-package";
+export declare const MISSING_MAESTRO_PACKAGE_KEYWORD_MESSAGE = "Missing \"maestro-package\" keyword.";
+//# sourceMappingURL=constants.d.ts.map

package/dist/packages/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/packages/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,oBAAoB,CAAC;AACzD,eAAO,MAAM,uCAAuC,yCAAkD,CAAC"}

package/dist/packages/constants.js

@@ -0,0 +1,3 @@
+export const MAESTRO_PACKAGE_KEYWORD = "maestro-package";
+export const MISSING_MAESTRO_PACKAGE_KEYWORD_MESSAGE = `Missing "${MAESTRO_PACKAGE_KEYWORD}" keyword.`;
+//# sourceMappingURL=constants.js.map

package/dist/packages/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/packages/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG,iBAAiB,CAAC;AACzD,MAAM,CAAC,MAAM,uCAAuC,GAAG,YAAY,uBAAuB,YAAY,CAAC","sourcesContent":["export const MAESTRO_PACKAGE_KEYWORD = \"maestro-package\";\nexport const MISSING_MAESTRO_PACKAGE_KEYWORD_MESSAGE = `Missing \"${MAESTRO_PACKAGE_KEYWORD}\" keyword.`;\n"]}

package/dist/packages/inspection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inspection.d.ts","sourceRoot":"","sources":["../../src/packages/inspection.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,KAAK,qBAAqB,EAE1B,MAAM,0BAA0B,CAAC;AAQlC,OAAO,KAAK,EACX,iBAAiB,EAEjB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACrC,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACvC,KAAK,EAAE,qBAAqB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,oBAAoB,CACzC,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,GACT,OAAO,CAAC,gBAAgB,CAAC,CAqB3B;AAED,wBAAgB,8BAA8B,CAC7C,SAAS,EAAE,gBAAgB,GACzB,MAAM,EAAE,CAsBV;AA4BD,wBAAsB,4BAA4B,CACjD,YAAY,EAAE,MAAM,GAClB,OAAO,CAAC,uBAAuB,EAAE,CAAC,CA0BpC"}
+{"version":3,"file":"inspection.d.ts","sourceRoot":"","sources":["../../src/packages/inspection.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,KAAK,qBAAqB,EAE1B,MAAM,0BAA0B,CAAC;AASlC,OAAO,KAAK,EACX,iBAAiB,EAEjB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACrC,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACvC,KAAK,EAAE,qBAAqB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,oBAAoB,CACzC,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,GACT,OAAO,CAAC,gBAAgB,CAAC,CAqB3B;AAED,wBAAgB,8BAA8B,CAC7C,SAAS,EAAE,gBAAgB,GACzB,MAAM,EAAE,CAsBV;AA4BD,wBAAsB,4BAA4B,CACjD,YAAY,EAAE,MAAM,GAClB,OAAO,CAAC,uBAAuB,EAAE,CAAC,CA0BpC"}

package/dist/packages/inspection.js

@@ -1,6 +1,7 @@
 import { existsSync, statSync } from "node:fs";
 import { join } from "node:path";
 import { loadConfiguredPackageSpecs, } from "../config/toml-config.js";
+import { MISSING_MAESTRO_PACKAGE_KEYWORD_MESSAGE } from "./constants.js";
 import { discoverPackage } from "./discovery.js";
 import { loadPackage, loadPackageResources, parsePackageSpec, } from "./loader.js";
 import { parsePackageSource, resolvePackageSource } from "./sources.js";
@@ -28,7 +29,7 @@ export function collectPackageValidationIssues(inspected) {
     }
     const issues = [];
     if (!inspected.discovered.isMaestroPackage) {
-        issues.push('Missing "maestro-package" keyword.');
+        issues.push(MISSING_MAESTRO_PACKAGE_KEYWORD_MESSAGE);
     }
     for (const error of inspected.discovered.errors ?? []) {
         issues.push(error);

package/dist/packages/inspection.js.map

@@ -1 +1 @@
-{"version":3,"file":"inspection.js","sourceRoot":"","sources":["../../src/packages/inspection.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, statSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport {\n\ttype ConfiguredPackageSpec,\n\tloadConfiguredPackageSpecs,\n} from \"../config/toml-config.js\";\nimport { discoverPackage } from \"./discovery.js\";\nimport {\n\tloadPackage,\n\tloadPackageResources,\n\tparsePackageSpec,\n} from \"./loader.js\";\nimport { parsePackageSource, resolvePackageSource } from \"./sources.js\";\nimport type {\n\tDiscoveredPackage,\n\tMaestroManifest,\n\tPackageResources,\n\tPackageSource,\n\tResourceFilters,\n} from \"./types.js\";\n\nexport interface InspectedPackage {\n\tsourceSpec: string;\n\tsource: PackageSource;\n\tresolvedPath: string;\n\tdiscovered: DiscoveredPackage | null;\n\tresources?: PackageResources;\n}\n\nexport interface ConfiguredPackageReport {\n\tentry: ConfiguredPackageSpec;\n\tsourceSpec: string;\n\tfilters?: ResourceFilters;\n\tinspected?: InspectedPackage;\n\terror?: string;\n}\n\nexport async function inspectPackageSource(\n\tsourceSpec: string,\n\tcwd: string,\n): Promise<InspectedPackage> {\n\tconst source = parsePackageSource(sourceSpec, cwd);\n\tconst resolvedPath = await resolvePackageSource(source);\n\tconst discovered = discoverPackage(resolvedPath);\n\tconst inspected: InspectedPackage = {\n\t\tsourceSpec,\n\t\tsource,\n\t\tresolvedPath,\n\t\tdiscovered,\n\t};\n\n\tif (\n\t\tdiscovered?.isMaestroPackage &&\n\t\t(discovered.errors?.length ?? 0) === 0 &&\n\t\tdiscovered.packageJson.maestro\n\t) {\n\t\tconst loadedPackage = await loadPackage(sourceSpec, { cwd });\n\t\tinspected.resources = loadPackageResources(loadedPackage);\n\t}\n\n\treturn inspected;\n}\n\nexport function collectPackageValidationIssues(\n\tinspected: InspectedPackage,\n): string[] {\n\tif (!inspected.discovered) {\n\t\treturn [`No valid package.json found at ${inspected.resolvedPath}.`];\n\t}\n\n\tconst issues: string[] = [];\n\tif (!inspected.discovered.isMaestroPackage) {\n\t\tissues.push('Missing \"maestro-package\" keyword.');\n\t}\n\n\tfor (const error of inspected.discovered.errors ?? []) {\n\t\tissues.push(error);\n\t}\n\n\tconst manifest = inspected.discovered.packageJson.maestro;\n\tif (!manifest) {\n\t\tissues.push('Missing \"maestro\" section in package.json.');\n\t\treturn issues;\n\t}\n\n\tissues.push(...collectManifestPathIssues(inspected.resolvedPath, manifest));\n\treturn issues;\n}\n\nfunction collectManifestPathIssues(\n\tpackagePath: string,\n\tmanifest: MaestroManifest,\n): string[] {\n\tconst issues: string[] = [];\n\tfor (const key of [\"extensions\", \"skills\", \"prompts\", \"themes\"] as const) {\n\t\tconst manifestPaths = manifest[key];\n\t\tif (!Array.isArray(manifestPaths)) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tfor (const manifestPath of manifestPaths) {\n\t\t\tconst absolutePath = join(packagePath, manifestPath);\n\t\t\tif (!existsSync(absolutePath)) {\n\t\t\t\tissues.push(`${key} path does not exist: ${manifestPath}`);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (!statSync(absolutePath).isDirectory()) {\n\t\t\t\tissues.push(`${key} path is not a directory: ${manifestPath}`);\n\t\t\t}\n\t\t}\n\t}\n\treturn issues;\n}\n\nexport async function listConfiguredPackageReports(\n\tworkspaceDir: string,\n): Promise<ConfiguredPackageReport[]> {\n\tconst configured = loadConfiguredPackageSpecs(workspaceDir);\n\tconst reports: ConfiguredPackageReport[] = [];\n\tfor (const entry of configured) {\n\t\tconst [sourceSpec, filters] = parsePackageSpec(entry.spec, entry.cwd);\n\t\ttry {\n\t\t\treports.push({\n\t\t\t\tentry,\n\t\t\t\tsourceSpec,\n\t\t\t\tfilters,\n\t\t\t\tinspected: await inspectPackageSource(sourceSpec, entry.cwd),\n\t\t\t});\n\t\t} catch (error) {\n\t\t\treports.push({\n\t\t\t\tentry,\n\t\t\t\tsourceSpec,\n\t\t\t\tfilters,\n\t\t\t\terror:\n\t\t\t\t\terror instanceof Error\n\t\t\t\t\t\t? error.message\n\t\t\t\t\t\t: \"Failed to inspect configured package.\",\n\t\t\t});\n\t\t}\n\t}\n\n\treturn reports;\n}\n"]}
+{"version":3,"file":"inspection.js","sourceRoot":"","sources":["../../src/packages/inspection.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, statSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport {\n\ttype ConfiguredPackageSpec,\n\tloadConfiguredPackageSpecs,\n} from \"../config/toml-config.js\";\nimport { MISSING_MAESTRO_PACKAGE_KEYWORD_MESSAGE } from \"./constants.js\";\nimport { discoverPackage } from \"./discovery.js\";\nimport {\n\tloadPackage,\n\tloadPackageResources,\n\tparsePackageSpec,\n} from \"./loader.js\";\nimport { parsePackageSource, resolvePackageSource } from \"./sources.js\";\nimport type {\n\tDiscoveredPackage,\n\tMaestroManifest,\n\tPackageResources,\n\tPackageSource,\n\tResourceFilters,\n} from \"./types.js\";\n\nexport interface InspectedPackage {\n\tsourceSpec: string;\n\tsource: PackageSource;\n\tresolvedPath: string;\n\tdiscovered: DiscoveredPackage | null;\n\tresources?: PackageResources;\n}\n\nexport interface ConfiguredPackageReport {\n\tentry: ConfiguredPackageSpec;\n\tsourceSpec: string;\n\tfilters?: ResourceFilters;\n\tinspected?: InspectedPackage;\n\terror?: string;\n}\n\nexport async function inspectPackageSource(\n\tsourceSpec: string,\n\tcwd: string,\n): Promise<InspectedPackage> {\n\tconst source = parsePackageSource(sourceSpec, cwd);\n\tconst resolvedPath = await resolvePackageSource(source);\n\tconst discovered = discoverPackage(resolvedPath);\n\tconst inspected: InspectedPackage = {\n\t\tsourceSpec,\n\t\tsource,\n\t\tresolvedPath,\n\t\tdiscovered,\n\t};\n\n\tif (\n\t\tdiscovered?.isMaestroPackage &&\n\t\t(discovered.errors?.length ?? 0) === 0 &&\n\t\tdiscovered.packageJson.maestro\n\t) {\n\t\tconst loadedPackage = await loadPackage(sourceSpec, { cwd });\n\t\tinspected.resources = loadPackageResources(loadedPackage);\n\t}\n\n\treturn inspected;\n}\n\nexport function collectPackageValidationIssues(\n\tinspected: InspectedPackage,\n): string[] {\n\tif (!inspected.discovered) {\n\t\treturn [`No valid package.json found at ${inspected.resolvedPath}.`];\n\t}\n\n\tconst issues: string[] = [];\n\tif (!inspected.discovered.isMaestroPackage) {\n\t\tissues.push(MISSING_MAESTRO_PACKAGE_KEYWORD_MESSAGE);\n\t}\n\n\tfor (const error of inspected.discovered.errors ?? []) {\n\t\tissues.push(error);\n\t}\n\n\tconst manifest = inspected.discovered.packageJson.maestro;\n\tif (!manifest) {\n\t\tissues.push('Missing \"maestro\" section in package.json.');\n\t\treturn issues;\n\t}\n\n\tissues.push(...collectManifestPathIssues(inspected.resolvedPath, manifest));\n\treturn issues;\n}\n\nfunction collectManifestPathIssues(\n\tpackagePath: string,\n\tmanifest: MaestroManifest,\n): string[] {\n\tconst issues: string[] = [];\n\tfor (const key of [\"extensions\", \"skills\", \"prompts\", \"themes\"] as const) {\n\t\tconst manifestPaths = manifest[key];\n\t\tif (!Array.isArray(manifestPaths)) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tfor (const manifestPath of manifestPaths) {\n\t\t\tconst absolutePath = join(packagePath, manifestPath);\n\t\t\tif (!existsSync(absolutePath)) {\n\t\t\t\tissues.push(`${key} path does not exist: ${manifestPath}`);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (!statSync(absolutePath).isDirectory()) {\n\t\t\t\tissues.push(`${key} path is not a directory: ${manifestPath}`);\n\t\t\t}\n\t\t}\n\t}\n\treturn issues;\n}\n\nexport async function listConfiguredPackageReports(\n\tworkspaceDir: string,\n): Promise<ConfiguredPackageReport[]> {\n\tconst configured = loadConfiguredPackageSpecs(workspaceDir);\n\tconst reports: ConfiguredPackageReport[] = [];\n\tfor (const entry of configured) {\n\t\tconst [sourceSpec, filters] = parsePackageSpec(entry.spec, entry.cwd);\n\t\ttry {\n\t\t\treports.push({\n\t\t\t\tentry,\n\t\t\t\tsourceSpec,\n\t\t\t\tfilters,\n\t\t\t\tinspected: await inspectPackageSource(sourceSpec, entry.cwd),\n\t\t\t});\n\t\t} catch (error) {\n\t\t\treports.push({\n\t\t\t\tentry,\n\t\t\t\tsourceSpec,\n\t\t\t\tfilters,\n\t\t\t\terror:\n\t\t\t\t\terror instanceof Error\n\t\t\t\t\t\t? error.message\n\t\t\t\t\t\t: \"Failed to inspect configured package.\",\n\t\t\t});\n\t\t}\n\t}\n\n\treturn reports;\n}\n"]}

package/dist/packages/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/packages/search.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE;QACN,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAqDD,wBAAsB,qBAAqB,CAC1C,KAAK,SAAK,GACR,OAAO,CAAC,qBAAqB,CAAC,CA6BhC"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/packages/search.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE;QACN,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAoDD,wBAAsB,qBAAqB,CAC1C,KAAK,SAAK,GACR,OAAO,CAAC,qBAAqB,CAAC,CA6BhC"}

package/dist/packages/search.js

@@ -1,5 +1,5 @@
+import { MAESTRO_PACKAGE_KEYWORD } from "./constants.js";
 const PACKAGE_DISCOVERY_LIMIT = 8;
-const MAESTRO_PACKAGE_KEYWORD = "maestro-package";
 function buildPackageSearchText(query) {
     const trimmed = query.trim();
     return trimmed.length > 0

package/dist/packages/search.js.map

@@ -1 +1 @@
-{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/packages/search.ts"],"names":[],"mappings":"AAoCA,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAClC,MAAM,uBAAuB,GAAG,iBAAiB,CAAC;AAElD,SAAS,sBAAsB,CAAC,KAAa;IAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC;QACxB,CAAC,CAAC,GAAG,uBAAuB,IAAI,OAAO,EAAE;QACzC,CAAC,CAAC,uBAAuB,CAAC;AAC5B,CAAC;AAED,SAAS,2BAA2B,CACnC,WAEC;IAED,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO;QACN,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,WAAW,EAAE,WAAW,CAAC,WAAW;QACpC,QAAQ,EAAE,WAAW,CAAC,QAAQ,IAAI,EAAE;QACpC,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,KAAK,EAAE;YACN,GAAG,EAAE,WAAW,CAAC,KAAK,EAAE,GAAG;YAC3B,UAAU,EAAE,WAAW,CAAC,KAAK,EAAE,UAAU;YACzC,QAAQ,EAAE,WAAW,CAAC,KAAK,EAAE,QAAQ;SACrC;QACD,aAAa,EAAE,OAAO,WAAW,CAAC,IAAI,EAAE;KACxC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAC1C,KAAK,GAAG,EAAE;IAEV,MAAM,IAAI,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,wCAAwC,CAAC,CAAC;IAC9D,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACnC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAE9D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QACjC,OAAO,EAAE;YACR,MAAM,EAAE,kBAAkB;SAC1B;KACD,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACd,0BAA0B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,CACzE,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA6B,CAAC;IACpE,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;SACrC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACd,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CACjE;SACA,MAAM,CAAC,CAAC,KAAK,EAA+B,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;IAEjE,OAAO;QACN,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;QACnB,OAAO;KACP,CAAC;AACH,CAAC","sourcesContent":["export interface PackageSearchEntry {\n\tname: string;\n\tversion?: string;\n\tdescription?: string;\n\tkeywords: string[];\n\tdate?: string;\n\tlinks: {\n\t\tnpm?: string;\n\t\trepository?: string;\n\t\thomepage?: string;\n\t};\n\tinstallSource: string;\n}\n\nexport interface PackageSearchResponse {\n\tquery: string;\n\tentries: PackageSearchEntry[];\n}\n\ninterface NpmRegistrySearchPayload {\n\tobjects?: Array<{\n\t\tpackage?: {\n\t\t\tname?: string;\n\t\t\tversion?: string;\n\t\t\tdescription?: string;\n\t\t\tkeywords?: string[];\n\t\t\tdate?: string;\n\t\t\tlinks?: {\n\t\t\t\tnpm?: string;\n\t\t\t\trepository?: string;\n\t\t\t\thomepage?: string;\n\t\t\t};\n\t\t};\n\t}>;\n}\n\nconst PACKAGE_DISCOVERY_LIMIT = 8;\nconst MAESTRO_PACKAGE_KEYWORD = \"maestro-package\";\n\nfunction buildPackageSearchText(query: string): string {\n\tconst trimmed = query.trim();\n\treturn trimmed.length > 0\n\t\t? `${MAESTRO_PACKAGE_KEYWORD} ${trimmed}`\n\t\t: MAESTRO_PACKAGE_KEYWORD;\n}\n\nfunction normalizePackageSearchEntry(\n\tpackageInfo: NonNullable<\n\t\tNonNullable<NpmRegistrySearchPayload[\"objects\"]>[number][\"package\"]\n\t>,\n): PackageSearchEntry | null {\n\tif (!packageInfo.name || packageInfo.name.trim().length === 0) {\n\t\treturn null;\n\t}\n\n\treturn {\n\t\tname: packageInfo.name,\n\t\tversion: packageInfo.version,\n\t\tdescription: packageInfo.description,\n\t\tkeywords: packageInfo.keywords ?? [],\n\t\tdate: packageInfo.date,\n\t\tlinks: {\n\t\t\tnpm: packageInfo.links?.npm,\n\t\t\trepository: packageInfo.links?.repository,\n\t\t\thomepage: packageInfo.links?.homepage,\n\t\t},\n\t\tinstallSource: `npm:${packageInfo.name}`,\n\t};\n}\n\nexport async function searchPackageRegistry(\n\tquery = \"\",\n): Promise<PackageSearchResponse> {\n\tconst text = buildPackageSearchText(query);\n\tconst url = new URL(\"https://registry.npmjs.org/-/v1/search\");\n\turl.searchParams.set(\"text\", text);\n\turl.searchParams.set(\"size\", String(PACKAGE_DISCOVERY_LIMIT));\n\n\tconst response = await fetch(url, {\n\t\theaders: {\n\t\t\taccept: \"application/json\",\n\t\t},\n\t});\n\n\tif (!response.ok) {\n\t\tthrow new Error(\n\t\t\t`Package search failed: ${response.status} ${response.statusText}`.trim(),\n\t\t);\n\t}\n\n\tconst payload = (await response.json()) as NpmRegistrySearchPayload;\n\tconst entries = (payload.objects ?? [])\n\t\t.map((entry) =>\n\t\t\tentry.package ? normalizePackageSearchEntry(entry.package) : null,\n\t\t)\n\t\t.filter((entry): entry is PackageSearchEntry => entry !== null);\n\n\treturn {\n\t\tquery: query.trim(),\n\t\tentries,\n\t};\n}\n"]}
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/packages/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAsCzD,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAElC,SAAS,sBAAsB,CAAC,KAAa;IAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC;QACxB,CAAC,CAAC,GAAG,uBAAuB,IAAI,OAAO,EAAE;QACzC,CAAC,CAAC,uBAAuB,CAAC;AAC5B,CAAC;AAED,SAAS,2BAA2B,CACnC,WAEC;IAED,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO;QACN,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,WAAW,EAAE,WAAW,CAAC,WAAW;QACpC,QAAQ,EAAE,WAAW,CAAC,QAAQ,IAAI,EAAE;QACpC,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,KAAK,EAAE;YACN,GAAG,EAAE,WAAW,CAAC,KAAK,EAAE,GAAG;YAC3B,UAAU,EAAE,WAAW,CAAC,KAAK,EAAE,UAAU;YACzC,QAAQ,EAAE,WAAW,CAAC,KAAK,EAAE,QAAQ;SACrC;QACD,aAAa,EAAE,OAAO,WAAW,CAAC,IAAI,EAAE;KACxC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAC1C,KAAK,GAAG,EAAE;IAEV,MAAM,IAAI,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,wCAAwC,CAAC,CAAC;IAC9D,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACnC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAE9D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QACjC,OAAO,EAAE;YACR,MAAM,EAAE,kBAAkB;SAC1B;KACD,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACd,0BAA0B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,CACzE,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA6B,CAAC;IACpE,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;SACrC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACd,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CACjE;SACA,MAAM,CAAC,CAAC,KAAK,EAA+B,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;IAEjE,OAAO;QACN,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;QACnB,OAAO;KACP,CAAC;AACH,CAAC","sourcesContent":["import { MAESTRO_PACKAGE_KEYWORD } from \"./constants.js\";\n\nexport interface PackageSearchEntry {\n\tname: string;\n\tversion?: string;\n\tdescription?: string;\n\tkeywords: string[];\n\tdate?: string;\n\tlinks: {\n\t\tnpm?: string;\n\t\trepository?: string;\n\t\thomepage?: string;\n\t};\n\tinstallSource: string;\n}\n\nexport interface PackageSearchResponse {\n\tquery: string;\n\tentries: PackageSearchEntry[];\n}\n\ninterface NpmRegistrySearchPayload {\n\tobjects?: Array<{\n\t\tpackage?: {\n\t\t\tname?: string;\n\t\t\tversion?: string;\n\t\t\tdescription?: string;\n\t\t\tkeywords?: string[];\n\t\t\tdate?: string;\n\t\t\tlinks?: {\n\t\t\t\tnpm?: string;\n\t\t\t\trepository?: string;\n\t\t\t\thomepage?: string;\n\t\t\t};\n\t\t};\n\t}>;\n}\n\nconst PACKAGE_DISCOVERY_LIMIT = 8;\n\nfunction buildPackageSearchText(query: string): string {\n\tconst trimmed = query.trim();\n\treturn trimmed.length > 0\n\t\t? `${MAESTRO_PACKAGE_KEYWORD} ${trimmed}`\n\t\t: MAESTRO_PACKAGE_KEYWORD;\n}\n\nfunction normalizePackageSearchEntry(\n\tpackageInfo: NonNullable<\n\t\tNonNullable<NpmRegistrySearchPayload[\"objects\"]>[number][\"package\"]\n\t>,\n): PackageSearchEntry | null {\n\tif (!packageInfo.name || packageInfo.name.trim().length === 0) {\n\t\treturn null;\n\t}\n\n\treturn {\n\t\tname: packageInfo.name,\n\t\tversion: packageInfo.version,\n\t\tdescription: packageInfo.description,\n\t\tkeywords: packageInfo.keywords ?? [],\n\t\tdate: packageInfo.date,\n\t\tlinks: {\n\t\t\tnpm: packageInfo.links?.npm,\n\t\t\trepository: packageInfo.links?.repository,\n\t\t\thomepage: packageInfo.links?.homepage,\n\t\t},\n\t\tinstallSource: `npm:${packageInfo.name}`,\n\t};\n}\n\nexport async function searchPackageRegistry(\n\tquery = \"\",\n): Promise<PackageSearchResponse> {\n\tconst text = buildPackageSearchText(query);\n\tconst url = new URL(\"https://registry.npmjs.org/-/v1/search\");\n\turl.searchParams.set(\"text\", text);\n\turl.searchParams.set(\"size\", String(PACKAGE_DISCOVERY_LIMIT));\n\n\tconst response = await fetch(url, {\n\t\theaders: {\n\t\t\taccept: \"application/json\",\n\t\t},\n\t});\n\n\tif (!response.ok) {\n\t\tthrow new Error(\n\t\t\t`Package search failed: ${response.status} ${response.statusText}`.trim(),\n\t\t);\n\t}\n\n\tconst payload = (await response.json()) as NpmRegistrySearchPayload;\n\tconst entries = (payload.objects ?? [])\n\t\t.map((entry) =>\n\t\t\tentry.package ? normalizePackageSearchEntry(entry.package) : null,\n\t\t)\n\t\t.filter((entry): entry is PackageSearchEntry => entry !== null);\n\n\treturn {\n\t\tquery: query.trim(),\n\t\tentries,\n\t};\n}\n"]}

package/dist/platform/a2a-capability-market.d.ts

@@ -0,0 +1,21 @@
+import type { PlatformAgentA2ASkill, PlatformAgentRegistryA2APeerCandidate } from "./agent-registry-client.js";
+export declare const A2A_CAPABILITY_MARKET_VERSION = "evalops.maestro.a2a-capability-market.v1";
+export interface A2ACapabilityMarketRequest {
+    skillId?: string;
+    taskClass?: string;
+    requiredContextGrants?: string[];
+    requiredArtifactKinds?: string[];
+    preferInternalEndpoint?: boolean;
+    now?: Date;
+}
+export interface A2ACapabilityMarketRank {
+    version: typeof A2A_CAPABILITY_MARKET_VERSION;
+    candidate: PlatformAgentRegistryA2APeerCandidate;
+    selectedSkill?: PlatformAgentA2ASkill;
+    score: number;
+    reasons: string[];
+    blockers: string[];
+}
+export declare function rankA2ACapabilityPeers(candidates: PlatformAgentRegistryA2APeerCandidate[], request?: A2ACapabilityMarketRequest): A2ACapabilityMarketRank[];
+export declare function selectA2ACapabilityPeer(candidates: PlatformAgentRegistryA2APeerCandidate[], request?: A2ACapabilityMarketRequest): A2ACapabilityMarketRank | undefined;
+//# sourceMappingURL=a2a-capability-market.d.ts.map

package/dist/platform/a2a-capability-market.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-capability-market.d.ts","sourceRoot":"","sources":["../../src/platform/a2a-capability-market.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,qBAAqB,EACrB,qCAAqC,EACrC,MAAM,4BAA4B,CAAC;AAEpC,eAAO,MAAM,6BAA6B,6CACC,CAAC;AAE5C,MAAM,WAAW,0BAA0B;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,GAAG,CAAC,EAAE,IAAI,CAAC;CACX;AAED,MAAM,WAAW,uBAAuB;IACvC,OAAO,EAAE,OAAO,6BAA6B,CAAC;IAC9C,SAAS,EAAE,qCAAqC,CAAC;IACjD,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB;AAwND,wBAAgB,sBAAsB,CACrC,UAAU,EAAE,qCAAqC,EAAE,EACnD,OAAO,GAAE,0BAA+B,GACtC,uBAAuB,EAAE,CAY3B;AAED,wBAAgB,uBAAuB,CACtC,UAAU,EAAE,qCAAqC,EAAE,EACnD,OAAO,GAAE,0BAA+B,GACtC,uBAAuB,GAAG,SAAS,CAErC"}

package/dist/platform/a2a-capability-market.js

@@ -0,0 +1,176 @@
+export const A2A_CAPABILITY_MARKET_VERSION = "evalops.maestro.a2a-capability-market.v1";
+function normalizedSet(values) {
+    return new Set((values ?? []).map((value) => value.trim()).filter(Boolean));
+}
+function hasRequestedValues(values) {
+    return (values ?? []).some((value) => value.trim().length > 0);
+}
+function hasAll(required, available) {
+    const availableSet = normalizedSet(available);
+    return [...normalizedSet(required)].every((value) => availableSet.has(value));
+}
+function statusScore(status) {
+    const normalized = status?.toUpperCase();
+    if (normalized?.includes("IDLE")) {
+        return { score: 30, reason: "status_idle" };
+    }
+    if (normalized === "ACTIVE" ||
+        normalized === "AGENT_STATUS_ACTIVE" ||
+        normalized?.includes("ONLINE") ||
+        normalized?.includes("READY")) {
+        return { score: 20, reason: "status_online" };
+    }
+    if (normalized?.includes("BUSY")) {
+        return { score: 5, reason: "status_busy" };
+    }
+    return { score: 0, reason: "status_unknown" };
+}
+function heartbeatScore(lastHeartbeatAt, now) {
+    if (!lastHeartbeatAt) {
+        return { score: 0 };
+    }
+    const ageMs = now.getTime() - Date.parse(lastHeartbeatAt);
+    if (!Number.isFinite(ageMs) || ageMs < 0) {
+        return { score: 0 };
+    }
+    if (ageMs <= 60_000) {
+        return { score: 15, reason: "heartbeat_fresh" };
+    }
+    if (ageMs <= 5 * 60_000) {
+        return { score: 8, reason: "heartbeat_recent" };
+    }
+    return { score: -10, reason: "heartbeat_stale" };
+}
+function rankSkill(skill, request, taskClass) {
+    const reasons = [`skill:${skill.id}`];
+    const blockers = [];
+    let score = request.skillId ? 35 : 15;
+    if (taskClass && normalizedSet(skill.deniedTaskClasses).has(taskClass)) {
+        blockers.push(`task_class_denied:${taskClass}`);
+    }
+    if (taskClass) {
+        const allowedTaskClasses = normalizedSet(skill.allowedTaskClasses);
+        if (allowedTaskClasses.size > 0 && !allowedTaskClasses.has(taskClass)) {
+            blockers.push(`task_class_not_allowed:${taskClass}`);
+        }
+        else if (allowedTaskClasses.has(taskClass)) {
+            score += 10;
+            reasons.push(`task_class:${taskClass}`);
+        }
+    }
+    if (!hasAll(request.requiredContextGrants, skill.requiredContextGrants)) {
+        blockers.push("missing_context_grants");
+    }
+    if (!hasAll(request.requiredArtifactKinds, skill.requiredArtifactKinds)) {
+        blockers.push("missing_required_artifacts");
+    }
+    if (skill.approvalPolicyRef) {
+        score += 4;
+        reasons.push("approval_policy");
+    }
+    if (skill.requiredArtifactKinds?.length) {
+        score += 3;
+        reasons.push("artifact_contract");
+    }
+    return {
+        selectedSkill: skill,
+        score: blockers.length > 0 ? Number.NEGATIVE_INFINITY : score,
+        reasons,
+        blockers,
+    };
+}
+function noSkillRank(request, taskClass) {
+    const blockers = [];
+    if (request.skillId) {
+        blockers.push(`missing_skill:${request.skillId}`);
+    }
+    if (taskClass) {
+        blockers.push(`missing_task_class:${taskClass}`);
+    }
+    if (hasRequestedValues(request.requiredContextGrants)) {
+        blockers.push("missing_context_grants");
+    }
+    if (hasRequestedValues(request.requiredArtifactKinds)) {
+        blockers.push("missing_required_artifacts");
+    }
+    return { score: 0, reasons: [], blockers };
+}
+function unique(values) {
+    return [...new Set(values)];
+}
+function selectSkillRank(candidate, request, taskClass) {
+    if (request.skillId) {
+        const selectedSkill = candidate.skills.find((skill) => skill.id === request.skillId);
+        return selectedSkill
+            ? rankSkill(selectedSkill, request, taskClass)
+            : noSkillRank(request, taskClass);
+    }
+    if (candidate.skills.length === 0) {
+        return noSkillRank(request, taskClass);
+    }
+    const skillRanks = candidate.skills.map((skill) => rankSkill(skill, request, taskClass));
+    const bestSkillRank = skillRanks
+        .filter((rank) => rank.blockers.length === 0)
+        .reduce((best, rank) => {
+        if (!best || rank.score > best.score) {
+            return rank;
+        }
+        return best;
+    }, undefined);
+    if (bestSkillRank) {
+        return bestSkillRank;
+    }
+    return {
+        score: Number.NEGATIVE_INFINITY,
+        reasons: [],
+        blockers: unique(skillRanks.flatMap((rank) => rank.blockers)),
+    };
+}
+function rankCandidate(candidate, request) {
+    const now = request.now ?? new Date();
+    const taskClass = request.taskClass?.trim();
+    const skillRank = selectSkillRank(candidate, request, taskClass);
+    const selectedSkill = skillRank.selectedSkill;
+    const reasons = [...skillRank.reasons];
+    const blockers = [...skillRank.blockers];
+    let score = skillRank.score;
+    const status = statusScore(candidate.agent.status);
+    score += status.score;
+    reasons.push(status.reason);
+    const heartbeat = heartbeatScore(candidate.agent.lastHeartbeatAt, now);
+    score += heartbeat.score;
+    if (heartbeat.reason) {
+        reasons.push(heartbeat.reason);
+    }
+    if (candidate.endpointKind === "internal" && request.preferInternalEndpoint) {
+        score += 8;
+        reasons.push("internal_endpoint");
+    }
+    if (candidate.pushNotifications) {
+        score += 5;
+        reasons.push("push_notifications");
+    }
+    return {
+        version: A2A_CAPABILITY_MARKET_VERSION,
+        candidate,
+        ...(selectedSkill ? { selectedSkill } : {}),
+        score: blockers.length > 0 ? Number.NEGATIVE_INFINITY : score,
+        reasons,
+        blockers,
+    };
+}
+export function rankA2ACapabilityPeers(candidates, request = {}) {
+    return candidates
+        .map((candidate) => rankCandidate(candidate, request))
+        .filter((rank) => rank.blockers.length === 0)
+        .sort((left, right) => {
+        if (right.score !== left.score) {
+            return right.score - left.score;
+        }
+        return (left.candidate.agent.id ?? left.candidate.endpointUrl).localeCompare(right.candidate.agent.id ?? right.candidate.endpointUrl);
+    });
+}
+export function selectA2ACapabilityPeer(candidates, request = {}) {
+    return rankA2ACapabilityPeers(candidates, request)[0];
+}
+//# sourceMappingURL=a2a-capability-market.js.map

package/dist/platform/a2a-capability-market.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-capability-market.js","sourceRoot":"","sources":["../../src/platform/a2a-capability-market.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,6BAA6B,GACzC,0CAA0C,CAAC;AA2B5C,SAAS,aAAa,CAAC,MAA4B;IAClD,OAAO,IAAI,GAAG,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,kBAAkB,CAAC,MAA4B;IACvD,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,MAAM,CACd,QAA8B,EAC9B,SAA+B;IAE/B,MAAM,YAAY,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,WAAW,CAAC,MAA0B;IAI9C,MAAM,UAAU,GAAG,MAAM,EAAE,WAAW,EAAE,CAAC;IACzC,IAAI,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IAC7C,CAAC;IACD,IACC,UAAU,KAAK,QAAQ;QACvB,UAAU,KAAK,qBAAqB;QACpC,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC;QAC9B,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC5B,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IAC/C,CAAC;IACD,IAAI,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IAC5C,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;AAC/C,CAAC;AAED,SAAS,cAAc,CACtB,eAAmC,EACnC,GAAS;IAET,IAAI,CAAC,eAAe,EAAE,CAAC;QACtB,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACrB,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC1C,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACrB,CAAC;IACD,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;QACrB,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IACjD,CAAC;IACD,IAAI,KAAK,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC;QACzB,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IACjD,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;AAClD,CAAC;AAED,SAAS,SAAS,CACjB,KAA4B,EAC5B,OAAmC,EACnC,SAA6B;IAE7B,MAAM,OAAO,GAAG,CAAC,SAAS,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAEtC,IAAI,SAAS,IAAI,aAAa,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACxE,QAAQ,CAAC,IAAI,CAAC,qBAAqB,SAAS,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,SAAS,EAAE,CAAC;QACf,MAAM,kBAAkB,GAAG,aAAa,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACnE,IAAI,kBAAkB,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACvE,QAAQ,CAAC,IAAI,CAAC,0BAA0B,SAAS,EAAE,CAAC,CAAC;QACtD,CAAC;aAAM,IAAI,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9C,KAAK,IAAI,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,cAAc,SAAS,EAAE,CAAC,CAAC;QACzC,CAAC;IACF,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,KAAK,CAAC,qBAAqB,CAAC,EAAE,CAAC;QACzE,QAAQ,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,KAAK,CAAC,qBAAqB,CAAC,EAAE,CAAC;QACzE,QAAQ,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC7B,KAAK,IAAI,CAAC,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,KAAK,CAAC,qBAAqB,EAAE,MAAM,EAAE,CAAC;QACzC,KAAK,IAAI,CAAC,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACnC,CAAC;IAED,OAAO;QACN,aAAa,EAAE,KAAK;QACpB,KAAK,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK;QAC7D,OAAO;QACP,QAAQ;KACR,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CACnB,OAAmC,EACnC,SAA6B;IAE7B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,iBAAiB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,SAAS,EAAE,CAAC;QACf,QAAQ,CAAC,IAAI,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,kBAAkB,CAAC,OAAO,CAAC,qBAAqB,CAAC,EAAE,CAAC;QACvD,QAAQ,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,kBAAkB,CAAC,OAAO,CAAC,qBAAqB,CAAC,EAAE,CAAC;QACvD,QAAQ,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;AAC5C,CAAC;AAED,SAAS,MAAM,CAAC,MAAgB;IAC/B,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,eAAe,CACvB,SAAgD,EAChD,OAAmC,EACnC,SAA6B;IAE7B,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAC1C,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,OAAO,CAAC,OAAO,CACvC,CAAC;QACF,OAAO,aAAa;YACnB,CAAC,CAAC,SAAS,CAAC,aAAa,EAAE,OAAO,EAAE,SAAS,CAAC;YAC9C,CAAC,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACjD,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,CACpC,CAAC;IACF,MAAM,aAAa,GAAG,UAAU;SAC9B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC;SAC5C,MAAM,CAAqC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;QAC1D,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC;QACb,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC,EAAE,SAAS,CAAC,CAAC;IAEf,IAAI,aAAa,EAAE,CAAC;QACnB,OAAO,aAAa,CAAC;IACtB,CAAC;IAED,OAAO;QACN,KAAK,EAAE,MAAM,CAAC,iBAAiB;QAC/B,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;KAC7D,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CACrB,SAAgD,EAChD,OAAmC;IAEnC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IACtC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC;IAC5C,MAAM,SAAS,GAAG,eAAe,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACjE,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC;IAC9C,MAAM,OAAO,GAAG,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;IAE5B,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACnD,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC;IACtB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAE5B,MAAM,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;IACvE,KAAK,IAAI,SAAS,CAAC,KAAK,CAAC;IACzB,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,SAAS,CAAC,YAAY,KAAK,UAAU,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC;QAC7E,KAAK,IAAI,CAAC,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,SAAS,CAAC,iBAAiB,EAAE,CAAC;QACjC,KAAK,IAAI,CAAC,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACpC,CAAC;IAED,OAAO;QACN,OAAO,EAAE,6BAA6B;QACtC,SAAS;QACT,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,KAAK,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK;QAC7D,OAAO;QACP,QAAQ;KACR,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CACrC,UAAmD,EACnD,UAAsC,EAAE;IAExC,OAAO,UAAU;SACf,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;SACrD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC;SAC5C,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACrB,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACjC,CAAC;QACD,OAAO,CACN,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,WAAW,CACrD,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CACtC,UAAmD,EACnD,UAAsC,EAAE;IAExC,OAAO,sBAAsB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC","sourcesContent":["import type {\n\tPlatformAgentA2ASkill,\n\tPlatformAgentRegistryA2APeerCandidate,\n} from \"./agent-registry-client.js\";\n\nexport const A2A_CAPABILITY_MARKET_VERSION =\n\t\"evalops.maestro.a2a-capability-market.v1\";\n\nexport interface A2ACapabilityMarketRequest {\n\tskillId?: string;\n\ttaskClass?: string;\n\trequiredContextGrants?: string[];\n\trequiredArtifactKinds?: string[];\n\tpreferInternalEndpoint?: boolean;\n\tnow?: Date;\n}\n\nexport interface A2ACapabilityMarketRank {\n\tversion: typeof A2A_CAPABILITY_MARKET_VERSION;\n\tcandidate: PlatformAgentRegistryA2APeerCandidate;\n\tselectedSkill?: PlatformAgentA2ASkill;\n\tscore: number;\n\treasons: string[];\n\tblockers: string[];\n}\n\ninterface A2ACapabilitySkillRank {\n\tselectedSkill?: PlatformAgentA2ASkill;\n\tscore: number;\n\treasons: string[];\n\tblockers: string[];\n}\n\nfunction normalizedSet(values: string[] | undefined): Set<string> {\n\treturn new Set((values ?? []).map((value) => value.trim()).filter(Boolean));\n}\n\nfunction hasRequestedValues(values: string[] | undefined): boolean {\n\treturn (values ?? []).some((value) => value.trim().length > 0);\n}\n\nfunction hasAll(\n\trequired: string[] | undefined,\n\tavailable: string[] | undefined,\n) {\n\tconst availableSet = normalizedSet(available);\n\treturn [...normalizedSet(required)].every((value) => availableSet.has(value));\n}\n\nfunction statusScore(status: string | undefined): {\n\tscore: number;\n\treason: string;\n} {\n\tconst normalized = status?.toUpperCase();\n\tif (normalized?.includes(\"IDLE\")) {\n\t\treturn { score: 30, reason: \"status_idle\" };\n\t}\n\tif (\n\t\tnormalized === \"ACTIVE\" ||\n\t\tnormalized === \"AGENT_STATUS_ACTIVE\" ||\n\t\tnormalized?.includes(\"ONLINE\") ||\n\t\tnormalized?.includes(\"READY\")\n\t) {\n\t\treturn { score: 20, reason: \"status_online\" };\n\t}\n\tif (normalized?.includes(\"BUSY\")) {\n\t\treturn { score: 5, reason: \"status_busy\" };\n\t}\n\treturn { score: 0, reason: \"status_unknown\" };\n}\n\nfunction heartbeatScore(\n\tlastHeartbeatAt: string | undefined,\n\tnow: Date,\n): { score: number; reason?: string } {\n\tif (!lastHeartbeatAt) {\n\t\treturn { score: 0 };\n\t}\n\tconst ageMs = now.getTime() - Date.parse(lastHeartbeatAt);\n\tif (!Number.isFinite(ageMs) || ageMs < 0) {\n\t\treturn { score: 0 };\n\t}\n\tif (ageMs <= 60_000) {\n\t\treturn { score: 15, reason: \"heartbeat_fresh\" };\n\t}\n\tif (ageMs <= 5 * 60_000) {\n\t\treturn { score: 8, reason: \"heartbeat_recent\" };\n\t}\n\treturn { score: -10, reason: \"heartbeat_stale\" };\n}\n\nfunction rankSkill(\n\tskill: PlatformAgentA2ASkill,\n\trequest: A2ACapabilityMarketRequest,\n\ttaskClass: string | undefined,\n): A2ACapabilitySkillRank {\n\tconst reasons = [`skill:${skill.id}`];\n\tconst blockers: string[] = [];\n\tlet score = request.skillId ? 35 : 15;\n\n\tif (taskClass && normalizedSet(skill.deniedTaskClasses).has(taskClass)) {\n\t\tblockers.push(`task_class_denied:${taskClass}`);\n\t}\n\tif (taskClass) {\n\t\tconst allowedTaskClasses = normalizedSet(skill.allowedTaskClasses);\n\t\tif (allowedTaskClasses.size > 0 && !allowedTaskClasses.has(taskClass)) {\n\t\t\tblockers.push(`task_class_not_allowed:${taskClass}`);\n\t\t} else if (allowedTaskClasses.has(taskClass)) {\n\t\t\tscore += 10;\n\t\t\treasons.push(`task_class:${taskClass}`);\n\t\t}\n\t}\n\tif (!hasAll(request.requiredContextGrants, skill.requiredContextGrants)) {\n\t\tblockers.push(\"missing_context_grants\");\n\t}\n\tif (!hasAll(request.requiredArtifactKinds, skill.requiredArtifactKinds)) {\n\t\tblockers.push(\"missing_required_artifacts\");\n\t}\n\tif (skill.approvalPolicyRef) {\n\t\tscore += 4;\n\t\treasons.push(\"approval_policy\");\n\t}\n\tif (skill.requiredArtifactKinds?.length) {\n\t\tscore += 3;\n\t\treasons.push(\"artifact_contract\");\n\t}\n\n\treturn {\n\t\tselectedSkill: skill,\n\t\tscore: blockers.length > 0 ? Number.NEGATIVE_INFINITY : score,\n\t\treasons,\n\t\tblockers,\n\t};\n}\n\nfunction noSkillRank(\n\trequest: A2ACapabilityMarketRequest,\n\ttaskClass: string | undefined,\n): A2ACapabilitySkillRank {\n\tconst blockers: string[] = [];\n\tif (request.skillId) {\n\t\tblockers.push(`missing_skill:${request.skillId}`);\n\t}\n\tif (taskClass) {\n\t\tblockers.push(`missing_task_class:${taskClass}`);\n\t}\n\tif (hasRequestedValues(request.requiredContextGrants)) {\n\t\tblockers.push(\"missing_context_grants\");\n\t}\n\tif (hasRequestedValues(request.requiredArtifactKinds)) {\n\t\tblockers.push(\"missing_required_artifacts\");\n\t}\n\treturn { score: 0, reasons: [], blockers };\n}\n\nfunction unique(values: string[]): string[] {\n\treturn [...new Set(values)];\n}\n\nfunction selectSkillRank(\n\tcandidate: PlatformAgentRegistryA2APeerCandidate,\n\trequest: A2ACapabilityMarketRequest,\n\ttaskClass: string | undefined,\n): A2ACapabilitySkillRank {\n\tif (request.skillId) {\n\t\tconst selectedSkill = candidate.skills.find(\n\t\t\t(skill) => skill.id === request.skillId,\n\t\t);\n\t\treturn selectedSkill\n\t\t\t? rankSkill(selectedSkill, request, taskClass)\n\t\t\t: noSkillRank(request, taskClass);\n\t}\n\n\tif (candidate.skills.length === 0) {\n\t\treturn noSkillRank(request, taskClass);\n\t}\n\n\tconst skillRanks = candidate.skills.map((skill) =>\n\t\trankSkill(skill, request, taskClass),\n\t);\n\tconst bestSkillRank = skillRanks\n\t\t.filter((rank) => rank.blockers.length === 0)\n\t\t.reduce<A2ACapabilitySkillRank | undefined>((best, rank) => {\n\t\t\tif (!best || rank.score > best.score) {\n\t\t\t\treturn rank;\n\t\t\t}\n\t\t\treturn best;\n\t\t}, undefined);\n\n\tif (bestSkillRank) {\n\t\treturn bestSkillRank;\n\t}\n\n\treturn {\n\t\tscore: Number.NEGATIVE_INFINITY,\n\t\treasons: [],\n\t\tblockers: unique(skillRanks.flatMap((rank) => rank.blockers)),\n\t};\n}\n\nfunction rankCandidate(\n\tcandidate: PlatformAgentRegistryA2APeerCandidate,\n\trequest: A2ACapabilityMarketRequest,\n): A2ACapabilityMarketRank {\n\tconst now = request.now ?? new Date();\n\tconst taskClass = request.taskClass?.trim();\n\tconst skillRank = selectSkillRank(candidate, request, taskClass);\n\tconst selectedSkill = skillRank.selectedSkill;\n\tconst reasons = [...skillRank.reasons];\n\tconst blockers = [...skillRank.blockers];\n\tlet score = skillRank.score;\n\n\tconst status = statusScore(candidate.agent.status);\n\tscore += status.score;\n\treasons.push(status.reason);\n\n\tconst heartbeat = heartbeatScore(candidate.agent.lastHeartbeatAt, now);\n\tscore += heartbeat.score;\n\tif (heartbeat.reason) {\n\t\treasons.push(heartbeat.reason);\n\t}\n\tif (candidate.endpointKind === \"internal\" && request.preferInternalEndpoint) {\n\t\tscore += 8;\n\t\treasons.push(\"internal_endpoint\");\n\t}\n\tif (candidate.pushNotifications) {\n\t\tscore += 5;\n\t\treasons.push(\"push_notifications\");\n\t}\n\n\treturn {\n\t\tversion: A2A_CAPABILITY_MARKET_VERSION,\n\t\tcandidate,\n\t\t...(selectedSkill ? { selectedSkill } : {}),\n\t\tscore: blockers.length > 0 ? Number.NEGATIVE_INFINITY : score,\n\t\treasons,\n\t\tblockers,\n\t};\n}\n\nexport function rankA2ACapabilityPeers(\n\tcandidates: PlatformAgentRegistryA2APeerCandidate[],\n\trequest: A2ACapabilityMarketRequest = {},\n): A2ACapabilityMarketRank[] {\n\treturn candidates\n\t\t.map((candidate) => rankCandidate(candidate, request))\n\t\t.filter((rank) => rank.blockers.length === 0)\n\t\t.sort((left, right) => {\n\t\t\tif (right.score !== left.score) {\n\t\t\t\treturn right.score - left.score;\n\t\t\t}\n\t\t\treturn (\n\t\t\t\tleft.candidate.agent.id ?? left.candidate.endpointUrl\n\t\t\t).localeCompare(right.candidate.agent.id ?? right.candidate.endpointUrl);\n\t\t});\n}\n\nexport function selectA2ACapabilityPeer(\n\tcandidates: PlatformAgentRegistryA2APeerCandidate[],\n\trequest: A2ACapabilityMarketRequest = {},\n): A2ACapabilityMarketRank | undefined {\n\treturn rankA2ACapabilityPeers(candidates, request)[0];\n}\n"]}