@nklisch/pi-enhanced 0.1.0

package/node_modules/@nklisch/pi-plugins/dist/application/mcp-plugin-projection.js

@@ -0,0 +1,342 @@
+import { z } from "zod";
+import { canonicalJson, compareUtf8 } from "../domain/canonical-json.js";
+import { verifyComponentId } from "../domain/component-identity.js";
+import { ComponentIdSchema } from "../domain/components.js";
+import { CompatibilityReportSchema, RuntimeRequirementStatusRegistry, } from "../domain/compatibility.js";
+import { analyzeMcpCompatibility, compareMcpSourceLocations } from "../domain/mcp-compatibility-plan.js";
+import { createMcpLaunchTemplate } from "../domain/mcp-launch-template.js";
+import { RuntimeCapabilityRegistry } from "../domain/compatibility-policy.js";
+import { ContentDigestSchema, hashContent } from "../domain/content-manifest.js";
+import { DomainContractError, ErrorCodeRegistry } from "../domain/errors.js";
+import { SourceLocationSchema } from "../domain/provenance-location.js";
+import { McpConfigSourceSchemaV1, McpRuntimeCapabilitiesSchemaV1, McpRuntimeServerKeySchemaV1, deriveMcpRuntimeServerKey, McpSourceIdentitySchemaV1, McpSourceRegistrationSchemaV1, McpSourceProjectionBindingSchemaV1, McpToolAliasSegmentSchema, McpToolAliasTemplateSchemaV1, } from "./ports/mcp-runtime.js";
+import { createMcpSourceRegistration, verifyMcpSourceRegistration, } from "./mcp-source-registration.js";
+import { PluginRuntimeProjectionSchemaV1, createActiveProjectionExpectation, digestCompatibilityReport, } from "./ports/runtime-projection.js";
+export const PluginMcpLaunchTemplateSchemaV1 = McpSourceProjectionBindingSchemaV1;
+export const PluginMcpAliasOmissionCodeSchema = z.enum([
+    "RUNTIME_ALIAS_UNAVAILABLE",
+    "UNREPRESENTABLE_ALIAS_SEGMENT",
+]);
+export const PluginMcpAliasOmissionSchema = z.object({
+    componentId: ComponentIdSchema,
+    serverKey: McpRuntimeServerKeySchemaV1,
+    code: PluginMcpAliasOmissionCodeSchema,
+}).strict().readonly();
+const PluginMcpProjectionNoneSchemaV1 = z.object({
+    schemaVersion: z.literal(1),
+    kind: z.literal("none"),
+    identity: McpSourceIdentitySchemaV1,
+    aliasOmissions: z.tuple([]),
+    digest: ContentDigestSchema,
+}).strict().readonly();
+const PluginMcpProjectionSourceSchemaV1 = z.object({
+    schemaVersion: z.literal(1),
+    kind: z.literal("source"),
+    registration: McpSourceRegistrationSchemaV1,
+    aliasOmissions: z.array(PluginMcpAliasOmissionSchema).readonly(),
+    digest: ContentDigestSchema,
+}).strict().readonly();
+export const PluginMcpProjectionSchemaV1 = z.discriminatedUnion("kind", [
+    PluginMcpProjectionNoneSchemaV1,
+    PluginMcpProjectionSourceSchemaV1,
+]);
+const encoder = new TextEncoder();
+const OPERATION = "createPluginMcpProjection";
+function fail(reason, componentIds = []) {
+    throw new DomainContractError({
+        code: ErrorCodeRegistry.sourceInvalid,
+        operation: OPERATION,
+        message: "MCP projection evidence is inconsistent",
+        details: {
+            reason,
+            ...(componentIds.length === 0 ? {} : { componentIds: [...componentIds].sort(compareUtf8) }),
+        },
+    });
+}
+function digestProjection(value, sha256) {
+    return hashContent(encoder.encode(`plugin-mcp-projection-v1\0${canonicalJson(value)}`), sha256);
+}
+function sourceIdentity(projection) {
+    return McpSourceIdentitySchemaV1.parse({
+        schemaVersion: 1,
+        scope: projection.scope,
+        plugin: projection.plugin,
+        revision: projection.revision,
+        projectionDigest: projection.digest,
+    });
+}
+function exactSet(values) {
+    return [...new Set(values)].sort(compareUtf8);
+}
+function sameStrings(left, right) {
+    const a = exactSet(left);
+    const b = exactSet(right);
+    return a.length === b.length && a.every((value, index) => value === b[index]);
+}
+function runtimeSupports(capability, runtime) {
+    switch (capability) {
+        case RuntimeCapabilityRegistry.mcpRuntime.id:
+            return Object.values(runtime.sourceLifecycle).every(Boolean);
+        case RuntimeCapabilityRegistry.mcpTransportStdio.id:
+            return runtime.transports.stdio;
+        case RuntimeCapabilityRegistry.mcpTransportStreamableHttp.id:
+            return runtime.transports.streamableHttp;
+        case RuntimeCapabilityRegistry.mcpOAuthAuthorizationCode.id:
+            return runtime.oauth.authorizationCode;
+        case RuntimeCapabilityRegistry.mcpOAuthClientCredentials.id:
+            return runtime.oauth.clientCredentials;
+        case RuntimeCapabilityRegistry.mcpToolApproval.id:
+            return runtime.features.toolApproval;
+        case RuntimeCapabilityRegistry.mcpSampling.id:
+            return runtime.features.sampling;
+        case RuntimeCapabilityRegistry.mcpElicitationForm.id:
+            return runtime.features.elicitationForm;
+        case RuntimeCapabilityRegistry.mcpElicitationUrl.id:
+            return runtime.features.elicitationUrl;
+        case RuntimeCapabilityRegistry.mcpResources.id:
+            return runtime.features.resources;
+        default:
+            return false;
+    }
+}
+function requirementId(componentId, capability) {
+    return `requirement-v1:${capability}:${componentId}`;
+}
+function canonicalLocations(locations) {
+    const sorted = locations.map((location) => SourceLocationSchema.parse(location)).sort(compareMcpSourceLocations);
+    const unique = sorted.filter((location, index) => index === 0 || compareMcpSourceLocations(location, sorted[index - 1]) !== 0);
+    if (unique.length === 0)
+        fail("MISSING_MCP_PROVENANCE");
+    return unique;
+}
+function reportAssessment(report, componentId) {
+    return report.components.find((assessment) => assessment.componentId === componentId);
+}
+function verifyReportPlan(report, componentId, capabilities, runtime) {
+    const assessment = reportAssessment(report, componentId);
+    if (assessment === undefined || assessment.verdict.kind !== "supported") {
+        fail("MCP_COMPONENT_NOT_SUPPORTED", [componentId]);
+    }
+    const expectedIds = capabilities.map((capability) => requirementId(componentId, capability));
+    if (!sameStrings(assessment.requirementIds, expectedIds)) {
+        fail("MCP_REQUIREMENT_SET_MISMATCH", [componentId]);
+    }
+    const byId = new Map(report.requirements.map((entry) => [entry.requirement.id, entry]));
+    for (const [index, id] of expectedIds.entries()) {
+        const requirement = byId.get(id);
+        if (requirement === undefined || requirement.status !== RuntimeRequirementStatusRegistry.available.tag) {
+            fail("MCP_REQUIREMENT_UNAVAILABLE", [componentId]);
+        }
+        if (requirement.requirement.capability !== capabilities[index] ||
+            !runtimeSupports(capabilities[index], runtime)) {
+            fail("MCP_RUNTIME_CAPABILITY_MISMATCH", [componentId]);
+        }
+    }
+}
+function aliasFor(pluginIdentity, componentId, serverKey, nativeKey, provenance, runtime) {
+    if (!provenance.some((location) => location.host === "claude"))
+        return { aliases: [] };
+    if (!runtime.features.pluginToolAliases) {
+        return {
+            aliases: [],
+            omission: PluginMcpAliasOmissionSchema.parse({
+                componentId,
+                serverKey,
+                code: "RUNTIME_ALIAS_UNAVAILABLE",
+            }),
+        };
+    }
+    const pluginName = pluginIdentity.manifestName ?? pluginIdentity.marketplaceEntryName;
+    const validPlugin = McpToolAliasSegmentSchema.safeParse(pluginName);
+    const validNativeKey = McpToolAliasSegmentSchema.safeParse(nativeKey);
+    if (!validPlugin.success || !validNativeKey.success) {
+        return {
+            aliases: [],
+            omission: PluginMcpAliasOmissionSchema.parse({
+                componentId,
+                serverKey,
+                code: "UNREPRESENTABLE_ALIAS_SEGMENT",
+            }),
+        };
+    }
+    return {
+        aliases: [McpToolAliasTemplateSchemaV1.parse({
+                schemaVersion: 1,
+                kind: "claude-plugin",
+                pluginName: validPlugin.data,
+                nativeServerKey: validNativeKey.data,
+                collisionPolicy: "omit-all",
+                preserveNativeDiscovery: true,
+            })],
+    };
+}
+function canonicalWithoutDigest(value) {
+    const { digest: _digest, ...withoutDigest } = value;
+    return withoutDigest;
+}
+function derivePluginMcpProjection(projection, runtime, sha256, verifyPlan) {
+    const identity = sourceIdentity(projection);
+    if (projection.components.mcpServers.length === 0) {
+        const withoutDigest = {
+            schemaVersion: 1,
+            kind: "none",
+            identity,
+            aliasOmissions: [],
+        };
+        return PluginMcpProjectionSchemaV1.parse({
+            ...withoutDigest,
+            digest: digestProjection(withoutDigest, sha256),
+        });
+    }
+    const rows = projection.components.mcpServers.map((component) => {
+        try {
+            verifyComponentId(component.id, projection.plugin, {
+                kind: "mcp-server",
+                nativeKey: component.nativeKey.value,
+            }, sha256);
+        }
+        catch {
+            fail("MCP_COMPONENT_ID_MISMATCH", [component.id]);
+        }
+        const analysis = analyzeMcpCompatibility({ plugin: projection.plugin, component });
+        // Runtime projection only receives activatable components; a degraded or
+        // blocked analysis here means the activation evidence drifted.
+        if (analysis.kind !== "supported")
+            fail("MCP_DECLARATION_UNSUPPORTED", [component.id]);
+        for (const capability of analysis.plan.requirementCapabilityIds) {
+            if (!runtimeSupports(capability, runtime)) {
+                fail("MCP_RUNTIME_CAPABILITY_MISMATCH", [component.id]);
+            }
+        }
+        verifyPlan?.(component.id, analysis.plan.requirementCapabilityIds);
+        const serverKey = deriveMcpRuntimeServerKey(component.id);
+        const provenance = canonicalLocations(analysis.plan.provenance);
+        const alias = aliasFor(projection.pluginIdentity, component.id, serverKey, component.nativeKey.value, provenance, runtime);
+        const projectionBinding = PluginMcpLaunchTemplateSchemaV1.parse({
+            schemaVersion: 1,
+            componentId: component.id,
+            contentRef: projection.contentRef,
+            dataRef: projection.dataRef,
+            ...(projection.configurationRef === undefined ? {} : { configurationRef: projection.configurationRef }),
+        });
+        let launchTemplate;
+        try {
+            launchTemplate = createMcpLaunchTemplate(component, projection.plugin);
+        }
+        catch {
+            fail("MCP_LAUNCH_TEMPLATE_MISMATCH", [component.id]);
+        }
+        return {
+            serverKey,
+            server: {
+                componentId: component.id,
+                nativeKey: component.nativeKey.value,
+                transport: analysis.plan.transport,
+                options: analysis.plan.options,
+                projection: projectionBinding,
+                launchTemplate,
+                toolAliases: alias.aliases,
+                provenance,
+            },
+            ...(alias.omission === undefined ? {} : { omission: alias.omission }),
+        };
+    }).sort((left, right) => compareUtf8(left.serverKey, right.serverKey));
+    const source = McpConfigSourceSchemaV1.parse({
+        schemaVersion: 1,
+        identity,
+        servers: Object.fromEntries(rows.map((row) => [row.serverKey, row.server])),
+    });
+    const aliasOmissions = rows.flatMap((row) => row.omission === undefined ? [] : [row.omission])
+        .sort((left, right) => compareUtf8(left.serverKey, right.serverKey) || compareUtf8(left.code, right.code));
+    const registration = createMcpSourceRegistration({ source, sha256 });
+    const withoutDigest = {
+        schemaVersion: 1,
+        kind: "source",
+        registration,
+        aliasOmissions,
+    };
+    return PluginMcpProjectionSchemaV1.parse({
+        ...withoutDigest,
+        digest: digestProjection(withoutDigest, sha256),
+    });
+}
+/**
+ * Recompute MCP contribution bytes from the authoritative whole-plugin
+ * projection. Lifecycle callers use this rather than trusting a separately
+ * self-hashed MCP projection supplied beside the expectation.
+ */
+export function createPluginMcpProjectionFromExpectation(input) {
+    let projection;
+    let runtime;
+    try {
+        projection = createActiveProjectionExpectation(PluginRuntimeProjectionSchemaV1.parse(input.projection), input.sha256).projection;
+        runtime = McpRuntimeCapabilitiesSchemaV1.parse(input.runtimeCapabilities);
+    }
+    catch {
+        fail("INVALID_MCP_PROJECTION_INPUT");
+    }
+    return derivePluginMcpProjection(projection, runtime, input.sha256);
+}
+/** Verify a claimed source projection against independently derived authority. */
+export function verifyPluginMcpProjectionAgainstExpectation(input) {
+    const claimed = verifyPluginMcpProjection(input.claimed, input.sha256);
+    const authoritative = createPluginMcpProjectionFromExpectation(input);
+    if (canonicalJson(claimed) !== canonicalJson(authoritative)) {
+        fail("MCP_PROJECTION_AUTHORITY_MISMATCH");
+    }
+    return authoritative;
+}
+export function createPluginMcpProjection(input) {
+    let projection;
+    let compatibility;
+    let runtime;
+    try {
+        projection = createActiveProjectionExpectation(PluginRuntimeProjectionSchemaV1.parse(input.projection), input.sha256).projection;
+        compatibility = CompatibilityReportSchema.parse(input.compatibility);
+        runtime = McpRuntimeCapabilitiesSchemaV1.parse(input.runtimeCapabilities);
+    }
+    catch {
+        fail("INVALID_MCP_PROJECTION_INPUT");
+    }
+    if (projection.pluginIdentity.key !== projection.plugin ||
+        canonicalJson(compatibility.plugin) !== canonicalJson(projection.pluginIdentity)) {
+        fail("PLUGIN_IDENTITY_MISMATCH");
+    }
+    if (digestCompatibilityReport(compatibility, input.sha256) !== projection.compatibilityDigest) {
+        fail("COMPATIBILITY_EVIDENCE_MISMATCH");
+    }
+    if (!compatibility.activatable)
+        fail("REPORT_NOT_ACTIVATABLE");
+    const inventoryIds = projection.components.mcpServers.map((component) => component.id);
+    const reportMcpIds = compatibility.components
+        .filter((assessment) => assessment.componentId.startsWith("component-v1:mcp-server:"))
+        .filter((assessment) => assessment.verdict.kind === "supported")
+        .map((assessment) => assessment.componentId);
+    if (!sameStrings(inventoryIds, reportMcpIds)) {
+        fail("MCP_INVENTORY_MISMATCH", [...inventoryIds, ...reportMcpIds]);
+    }
+    const result = derivePluginMcpProjection(projection, runtime, input.sha256, (componentId, capabilityIds) => verifyReportPlan(compatibility, componentId, capabilityIds, runtime));
+    if (input.digest !== undefined && ContentDigestSchema.parse(input.digest) !== result.digest) {
+        fail("MCP_PROJECTION_DIGEST_MISMATCH");
+    }
+    return result;
+}
+export function verifyPluginMcpProjection(input, sha256) {
+    let value;
+    try {
+        value = PluginMcpProjectionSchemaV1.parse(input);
+    }
+    catch {
+        fail("INVALID_MCP_PROJECTION_SHAPE");
+    }
+    if (value.kind === "source") {
+        // The projection digest includes the claimed registration digest, so the
+        // registration must also be independently recomputed from its source.
+        verifyMcpSourceRegistration(value.registration, sha256);
+    }
+    const expected = digestProjection(canonicalWithoutDigest(value), sha256);
+    if (value.digest !== expected)
+        fail("MCP_PROJECTION_DIGEST_MISMATCH");
+    return value;
+}
+//# sourceMappingURL=mcp-plugin-projection.js.map

package/node_modules/@nklisch/pi-plugins/dist/application/mcp-plugin-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-plugin-projection.js","sourceRoot":"","sources":["../../src/application/mcp-plugin-projection.ts"],"names":[],"mappings":"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"}

package/node_modules/@nklisch/pi-plugins/dist/application/mcp-runtime-capability-probe.d.ts

@@ -0,0 +1,12 @@
+import type { McpRuntimePort } from "./ports/mcp-runtime.js";
+import type { RuntimeCapabilityProbe } from "./ports/runtime-capability-probe.js";
+/**
+ * Decorate the existing complete capability probe without moving any MCP
+ * policy into the adapter. Absence is a valid composition choice; malformed
+ * present runtime evidence is an adapter failure and must not be downgraded.
+ */
+export declare function createMcpRuntimeCapabilityProbe(input: Readonly<{
+    base: RuntimeCapabilityProbe;
+    runtime?: Pick<McpRuntimePort, "capabilities">;
+    capturedBy: string;
+}>): RuntimeCapabilityProbe;

package/node_modules/@nklisch/pi-plugins/dist/application/mcp-runtime-capability-probe.js

@@ -0,0 +1,121 @@
+import { McpRuntimeCapabilitiesSchemaV1, } from "./ports/mcp-runtime.js";
+import { RuntimeCapabilityRegistry, RuntimeCapabilitySnapshotSchema, } from "../domain/compatibility-policy.js";
+import { BoundaryError, ErrorCodeRegistry } from "../domain/errors.js";
+import { isAbortRejection } from "./abort-rejection.js";
+const OPERATION = "probeMcpRuntimeCapabilities";
+const mcpCapabilityIds = [
+    RuntimeCapabilityRegistry.mcpRuntime.id,
+    RuntimeCapabilityRegistry.mcpTransportStdio.id,
+    RuntimeCapabilityRegistry.mcpTransportStreamableHttp.id,
+    RuntimeCapabilityRegistry.mcpOAuthAuthorizationCode.id,
+    RuntimeCapabilityRegistry.mcpOAuthClientCredentials.id,
+    RuntimeCapabilityRegistry.mcpToolApproval.id,
+    RuntimeCapabilityRegistry.mcpSampling.id,
+    RuntimeCapabilityRegistry.mcpElicitationForm.id,
+    RuntimeCapabilityRegistry.mcpElicitationUrl.id,
+    RuntimeCapabilityRegistry.mcpResources.id,
+];
+function adapterFailure(cause) {
+    return new BoundaryError({
+        code: ErrorCodeRegistry.adapterFailed,
+        operation: OPERATION,
+        message: "MCP runtime capability probe failed",
+        cause,
+    });
+}
+function status(value, availableExplanation, unavailableExplanation) {
+    return {
+        status: value ? "available" : "unavailable",
+        explanation: value ? availableExplanation : unavailableExplanation,
+    };
+}
+function snapshotWithMcpFacts(base, values, capturedBy) {
+    return RuntimeCapabilitySnapshotSchema.parse({
+        capabilities: {
+            ...base.capabilities,
+            ...values,
+        },
+        capturedBy,
+    });
+}
+function unavailableSnapshot(base, capturedBy, explanation) {
+    const values = Object.fromEntries(mcpCapabilityIds.map((id) => [id, status(false, explanation, explanation)]));
+    return snapshotWithMcpFacts(base, values, capturedBy);
+}
+function sourceLifecycleComplete(capabilities) {
+    return Object.values(capabilities.sourceLifecycle).every((value) => value === true);
+}
+function mapRuntimeCapabilities(base, capabilities, capturedBy) {
+    const runtimeAvailable = sourceLifecycleComplete(capabilities);
+    const lifecycleExplanation = runtimeAvailable
+        ? "MCP plugin-scoped source lifecycle is available"
+        : "MCP runtime source lifecycle contract is incomplete";
+    const exactFactUnavailable = "MCP runtime did not report this exact capability";
+    const values = {
+        [RuntimeCapabilityRegistry.mcpRuntime.id]: status(runtimeAvailable, lifecycleExplanation, lifecycleExplanation),
+        [RuntimeCapabilityRegistry.mcpTransportStdio.id]: status(runtimeAvailable && capabilities.transports.stdio, "MCP standard-I/O transport is available", runtimeAvailable ? exactFactUnavailable : lifecycleExplanation),
+        [RuntimeCapabilityRegistry.mcpTransportStreamableHttp.id]: status(runtimeAvailable && capabilities.transports.streamableHttp, "MCP Streamable HTTP transport is available", runtimeAvailable ? exactFactUnavailable : lifecycleExplanation),
+        [RuntimeCapabilityRegistry.mcpOAuthAuthorizationCode.id]: status(runtimeAvailable && capabilities.oauth.authorizationCode, "MCP authorization-code OAuth is available", runtimeAvailable ? exactFactUnavailable : lifecycleExplanation),
+        [RuntimeCapabilityRegistry.mcpOAuthClientCredentials.id]: status(runtimeAvailable && capabilities.oauth.clientCredentials, "MCP client-credentials OAuth is available", runtimeAvailable ? exactFactUnavailable : lifecycleExplanation),
+        [RuntimeCapabilityRegistry.mcpToolApproval.id]: status(runtimeAvailable && capabilities.features.toolApproval, "MCP tool approval is available", runtimeAvailable ? exactFactUnavailable : lifecycleExplanation),
+        [RuntimeCapabilityRegistry.mcpSampling.id]: status(runtimeAvailable && capabilities.features.sampling, "MCP sampling is available", runtimeAvailable ? exactFactUnavailable : lifecycleExplanation),
+        [RuntimeCapabilityRegistry.mcpElicitationForm.id]: status(runtimeAvailable && capabilities.features.elicitationForm, "MCP form elicitation is available", runtimeAvailable ? exactFactUnavailable : lifecycleExplanation),
+        [RuntimeCapabilityRegistry.mcpElicitationUrl.id]: status(runtimeAvailable && capabilities.features.elicitationUrl, "MCP URL elicitation is available", runtimeAvailable ? exactFactUnavailable : lifecycleExplanation),
+        [RuntimeCapabilityRegistry.mcpResources.id]: status(runtimeAvailable && capabilities.features.resources, "MCP resources are available", runtimeAvailable ? exactFactUnavailable : lifecycleExplanation),
+    };
+    return snapshotWithMcpFacts(base, values, capturedBy);
+}
+/**
+ * Decorate the existing complete capability probe without moving any MCP
+ * policy into the adapter. Absence is a valid composition choice; malformed
+ * present runtime evidence is an adapter failure and must not be downgraded.
+ */
+export function createMcpRuntimeCapabilityProbe(input) {
+    if (input.base === null || typeof input.base !== "object" || typeof input.base.snapshot !== "function") {
+        throw new TypeError("MCP runtime capability probe requires a base probe");
+    }
+    if (typeof input.capturedBy !== "string" || input.capturedBy.length === 0) {
+        throw new TypeError("MCP runtime capability probe requires a non-empty capture identity");
+    }
+    return {
+        async snapshot(signal) {
+            signal.throwIfAborted();
+            let base;
+            try {
+                base = RuntimeCapabilitySnapshotSchema.parse(await input.base.snapshot(signal));
+            }
+            catch (cause) {
+                if (signal.aborted)
+                    throw signal.reason;
+                if (isAbortRejection(cause))
+                    throw cause;
+                throw adapterFailure(cause);
+            }
+            signal.throwIfAborted();
+            if (input.runtime === undefined) {
+                return unavailableSnapshot(base, input.capturedBy, "MCP runtime package is unavailable");
+            }
+            let rawCapabilities;
+            try {
+                rawCapabilities = await input.runtime.capabilities(signal);
+            }
+            catch (cause) {
+                if (signal.aborted)
+                    throw signal.reason;
+                if (isAbortRejection(cause))
+                    throw cause;
+                throw adapterFailure(cause);
+            }
+            signal.throwIfAborted();
+            let capabilities;
+            try {
+                capabilities = McpRuntimeCapabilitiesSchemaV1.parse(rawCapabilities);
+            }
+            catch (cause) {
+                throw adapterFailure(cause);
+            }
+            return mapRuntimeCapabilities(base, capabilities, input.capturedBy);
+        },
+    };
+}
+//# sourceMappingURL=mcp-runtime-capability-probe.js.map

package/node_modules/@nklisch/pi-plugins/dist/application/mcp-runtime-capability-probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-runtime-capability-probe.js","sourceRoot":"","sources":["../../src/application/mcp-runtime-capability-probe.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,GAE/B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,yBAAyB,EACzB,+BAA+B,GAGhC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,SAAS,GAAG,6BAA6B,CAAC;AAEhD,MAAM,gBAAgB,GAAG;IACvB,yBAAyB,CAAC,UAAU,CAAC,EAAE;IACvC,yBAAyB,CAAC,iBAAiB,CAAC,EAAE;IAC9C,yBAAyB,CAAC,0BAA0B,CAAC,EAAE;IACvD,yBAAyB,CAAC,yBAAyB,CAAC,EAAE;IACtD,yBAAyB,CAAC,yBAAyB,CAAC,EAAE;IACtD,yBAAyB,CAAC,eAAe,CAAC,EAAE;IAC5C,yBAAyB,CAAC,WAAW,CAAC,EAAE;IACxC,yBAAyB,CAAC,kBAAkB,CAAC,EAAE;IAC/C,yBAAyB,CAAC,iBAAiB,CAAC,EAAE;IAC9C,yBAAyB,CAAC,YAAY,CAAC,EAAE;CACjC,CAAC;AAIX,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,IAAI,aAAa,CAAC;QACvB,IAAI,EAAE,iBAAiB,CAAC,aAAa;QACrC,SAAS,EAAE,SAAS;QACpB,OAAO,EAAE,qCAAqC;QAC9C,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED,SAAS,MAAM,CACb,KAAc,EACd,oBAA4B,EAC5B,sBAA8B;IAE9B,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa;QAC3C,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,sBAAsB;KACnE,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAC3B,IAA+B,EAC/B,MAAwE,EACxE,UAAkB;IAElB,OAAO,+BAA+B,CAAC,KAAK,CAAC;QAC3C,YAAY,EAAE;YACZ,GAAG,IAAI,CAAC,YAAY;YACpB,GAAG,MAAM;SACV;QACD,UAAU;KACX,CAAC,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB,CAC1B,IAA+B,EAC/B,UAAkB,EAClB,WAAmB;IAEnB,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAC/B,gBAAgB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,CAClB,CAAC;IAC5D,OAAO,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,uBAAuB,CAAC,YAAoC;IACnE,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;AACtF,CAAC;AAED,SAAS,sBAAsB,CAC7B,IAA+B,EAC/B,YAAoC,EACpC,UAAkB;IAElB,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,YAAY,CAAC,CAAC;IAC/D,MAAM,oBAAoB,GAAG,gBAAgB;QAC3C,CAAC,CAAC,iDAAiD;QACnD,CAAC,CAAC,qDAAqD,CAAC;IAC1D,MAAM,oBAAoB,GAAG,kDAAkD,CAAC;IAChF,MAAM,MAAM,GAA2D;QACrE,CAAC,yBAAyB,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,MAAM,CAC/C,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,CACrB;QACD,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,EAAE,CAAC,EAAE,MAAM,CACtD,gBAAgB,IAAI,YAAY,CAAC,UAAU,CAAC,KAAK,EACjD,yCAAyC,EACzC,gBAAgB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,oBAAoB,CAC/D;QACD,CAAC,yBAAyB,CAAC,0BAA0B,CAAC,EAAE,CAAC,EAAE,MAAM,CAC/D,gBAAgB,IAAI,YAAY,CAAC,UAAU,CAAC,cAAc,EAC1D,4CAA4C,EAC5C,gBAAgB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,oBAAoB,CAC/D;QACD,CAAC,yBAAyB,CAAC,yBAAyB,CAAC,EAAE,CAAC,EAAE,MAAM,CAC9D,gBAAgB,IAAI,YAAY,CAAC,KAAK,CAAC,iBAAiB,EACxD,2CAA2C,EAC3C,gBAAgB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,oBAAoB,CAC/D;QACD,CAAC,yBAAyB,CAAC,yBAAyB,CAAC,EAAE,CAAC,EAAE,MAAM,CAC9D,gBAAgB,IAAI,YAAY,CAAC,KAAK,CAAC,iBAAiB,EACxD,2CAA2C,EAC3C,gBAAgB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,oBAAoB,CAC/D;QACD,CAAC,yBAAyB,CAAC,eAAe,CAAC,EAAE,CAAC,EAAE,MAAM,CACpD,gBAAgB,IAAI,YAAY,CAAC,QAAQ,CAAC,YAAY,EACtD,gCAAgC,EAChC,gBAAgB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,oBAAoB,CAC/D;QACD,CAAC,yBAAyB,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,MAAM,CAChD,gBAAgB,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,EAClD,2BAA2B,EAC3B,gBAAgB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,oBAAoB,CAC/D;QACD,CAAC,yBAAyB,CAAC,kBAAkB,CAAC,EAAE,CAAC,EAAE,MAAM,CACvD,gBAAgB,IAAI,YAAY,CAAC,QAAQ,CAAC,eAAe,EACzD,mCAAmC,EACnC,gBAAgB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,oBAAoB,CAC/D;QACD,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,EAAE,CAAC,EAAE,MAAM,CACtD,gBAAgB,IAAI,YAAY,CAAC,QAAQ,CAAC,cAAc,EACxD,kCAAkC,EAClC,gBAAgB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,oBAAoB,CAC/D;QACD,CAAC,yBAAyB,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,MAAM,CACjD,gBAAgB,IAAI,YAAY,CAAC,QAAQ,CAAC,SAAS,EACnD,6BAA6B,EAC7B,gBAAgB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,oBAAoB,CAC/D;KACF,CAAC;IACF,OAAO,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAAC,KAI9C;IACA,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;QACvG,MAAM,IAAI,SAAS,CAAC,oDAAoD,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1E,MAAM,IAAI,SAAS,CAAC,oEAAoE,CAAC,CAAC;IAC5F,CAAC;IAED,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,MAAmB;YAChC,MAAM,CAAC,cAAc,EAAE,CAAC;YAExB,IAAI,IAA+B,CAAC;YACpC,IAAI,CAAC;gBACH,IAAI,GAAG,+BAA+B,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;YAClF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,MAAM,CAAC,OAAO;oBAAE,MAAM,MAAM,CAAC,MAAM,CAAC;gBACxC,IAAI,gBAAgB,CAAC,KAAK,CAAC;oBAAE,MAAM,KAAK,CAAC;gBACzC,MAAM,cAAc,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;YACD,MAAM,CAAC,cAAc,EAAE,CAAC;YAExB,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBAChC,OAAO,mBAAmB,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,EAAE,oCAAoC,CAAC,CAAC;YAC3F,CAAC;YAED,IAAI,eAAwB,CAAC;YAC7B,IAAI,CAAC;gBACH,eAAe,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAC7D,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,MAAM,CAAC,OAAO;oBAAE,MAAM,MAAM,CAAC,MAAM,CAAC;gBACxC,IAAI,gBAAgB,CAAC,KAAK,CAAC;oBAAE,MAAM,KAAK,CAAC;gBACzC,MAAM,cAAc,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;YACD,MAAM,CAAC,cAAc,EAAE,CAAC;YAExB,IAAI,YAAoC,CAAC;YACzC,IAAI,CAAC;gBACH,YAAY,GAAG,8BAA8B,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YACvE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,cAAc,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;YACD,OAAO,sBAAsB,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QACtE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/node_modules/@nklisch/pi-plugins/dist/application/mcp-source-registration.d.ts

@@ -0,0 +1,11 @@
+import { type ContentDigest } from "../domain/content-manifest.js";
+import type { Sha256 } from "../domain/source.js";
+import { type McpConfigSource, type McpSourceRegistration } from "./ports/mcp-runtime.js";
+/** Bind the exact canonical, secret-free source bytes to one digest. */
+export declare function createMcpSourceRegistration(input: Readonly<{
+    source: McpConfigSource;
+    sha256: Sha256;
+    digest?: ContentDigest;
+}>): McpSourceRegistration;
+/** Parse untrusted registration evidence and recompute its canonical digest. */
+export declare function verifyMcpSourceRegistration(input: unknown, sha256: Sha256): McpSourceRegistration;

package/node_modules/@nklisch/pi-plugins/dist/application/mcp-source-registration.js

@@ -0,0 +1,54 @@
+import { canonicalJson } from "../domain/canonical-json.js";
+import { hashContent } from "../domain/content-manifest.js";
+import { DomainContractError, ErrorCodeRegistry } from "../domain/errors.js";
+import { McpConfigSourceSchemaV1, McpSourceRegistrationSchemaV1, } from "./ports/mcp-runtime.js";
+const encoder = new TextEncoder();
+const OPERATION = "createMcpSourceRegistration";
+function registrationDigest(source, sha256) {
+    return hashContent(encoder.encode(`mcp-source-registration-v1\0${canonicalJson(source)}`), sha256);
+}
+function invalidRegistration(reason) {
+    throw new DomainContractError({
+        code: ErrorCodeRegistry.sourceInvalid,
+        operation: OPERATION,
+        message: "MCP source registration evidence is inconsistent",
+        details: { reason },
+    });
+}
+/** Bind the exact canonical, secret-free source bytes to one digest. */
+export function createMcpSourceRegistration(input) {
+    let source;
+    try {
+        if (typeof input.sha256 !== "function")
+            throw new Error("missing digest function");
+        source = McpConfigSourceSchemaV1.parse(input.source);
+    }
+    catch {
+        invalidRegistration("INVALID_SOURCE");
+    }
+    const digest = registrationDigest(source, input.sha256);
+    if (input.digest !== undefined && input.digest !== digest) {
+        invalidRegistration("DIGEST_MISMATCH");
+    }
+    return McpSourceRegistrationSchemaV1.parse({
+        schemaVersion: 1,
+        source,
+        digest,
+    });
+}
+/** Parse untrusted registration evidence and recompute its canonical digest. */
+export function verifyMcpSourceRegistration(input, sha256) {
+    let registration;
+    try {
+        registration = McpSourceRegistrationSchemaV1.parse(input);
+    }
+    catch {
+        invalidRegistration("INVALID_REGISTRATION");
+    }
+    return createMcpSourceRegistration({
+        source: registration.source,
+        digest: registration.digest,
+        sha256,
+    });
+}
+//# sourceMappingURL=mcp-source-registration.js.map

package/node_modules/@nklisch/pi-plugins/dist/application/mcp-source-registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-source-registration.js","sourceRoot":"","sources":["../../src/application/mcp-source-registration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAsB,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7E,OAAO,EACL,uBAAuB,EACvB,6BAA6B,GAG9B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;AAClC,MAAM,SAAS,GAAG,6BAA6B,CAAC;AAEhD,SAAS,kBAAkB,CACzB,MAAuB,EACvB,MAAc;IAEd,OAAO,WAAW,CAChB,OAAO,CAAC,MAAM,CAAC,+BAA+B,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,EACtE,MAAM,CACP,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAc;IACzC,MAAM,IAAI,mBAAmB,CAAC;QAC5B,IAAI,EAAE,iBAAiB,CAAC,aAAa;QACrC,SAAS,EAAE,SAAS;QACpB,OAAO,EAAE,kDAAkD;QAC3D,OAAO,EAAE,EAAE,MAAM,EAAE;KACpB,CAAC,CAAC;AACL,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,2BAA2B,CAAC,KAI1C;IACA,IAAI,MAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACnF,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IACxC,CAAC;IACD,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC1D,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,6BAA6B,CAAC,KAAK,CAAC;QACzC,aAAa,EAAE,CAAC;QAChB,MAAM;QACN,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,2BAA2B,CACzC,KAAc,EACd,MAAc;IAEd,IAAI,YAAmC,CAAC;IACxC,IAAI,CAAC;QACH,YAAY,GAAG,6BAA6B,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,mBAAmB,CAAC,sBAAsB,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,2BAA2B,CAAC;QACjC,MAAM,EAAE,YAAY,CAAC,MAAM;QAC3B,MAAM,EAAE,YAAY,CAAC,MAAM;QAC3B,MAAM;KACP,CAAC,CAAC;AACL,CAAC"}

package/node_modules/@nklisch/pi-plugins/dist/application/mcp-tool-aliases.d.ts

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import { type McpToolAliasTemplate } from "./ports/mcp-runtime.js";
+export declare const McpToolAliasClaimSchemaV1: z.ZodReadonly<z.ZodObject<{
+    source: z.ZodReadonly<z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        scope: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+            kind: z.ZodLiteral<"user">;
+        }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+            kind: z.ZodLiteral<"project">;
+            projectKey: z.core.$ZodBranded<z.ZodString, "ProjectKey", "out">;
+        }, z.core.$strict>>], "kind">;
+        plugin: z.core.$ZodBranded<z.ZodString, "PluginKey", "out">;
+        revision: z.core.$ZodBranded<z.ZodString, "ContentDigest", "out">;
+        projectionDigest: z.core.$ZodBranded<z.ZodString, "ContentDigest", "out">;
+    }, z.core.$strict>>;
+    serverKey: z.core.$ZodBranded<z.ZodString, "McpRuntimeServerKey", "out">;
+    componentId: z.core.$ZodBranded<z.ZodString, "ComponentId", "out">;
+    nativeToolName: z.ZodString;
+    alias: z.ZodString;
+}, z.core.$strict>>;
+export type McpToolAliasClaim = z.infer<typeof McpToolAliasClaimSchemaV1>;
+export type McpToolAliasResolution = Readonly<{
+    exposed: readonly McpToolAliasClaim[];
+    omitted: readonly Readonly<{
+        claim: McpToolAliasClaim;
+        code: "NATIVE_NAME_COLLISION" | "ALIAS_CLAIM_COLLISION" | "UNREPRESENTABLE_ALIAS";
+    }>[];
+}>;
+/** Exact Claude plugin alias spelling; no segment is rewritten. */
+export declare function formatMcpToolAlias(template: McpToolAliasTemplate, nativeToolName: string): string;
+/**
+ * Resolve one complete post-discovery snapshot. Native names reserve their
+ * exact spelling and every claimant loses a contested alias.
+ */
+export declare function resolveMcpToolAliases(input: Readonly<{
+    nativeToolNames: readonly string[];
+    claims: readonly McpToolAliasClaim[];
+    isRepresentable(name: string): boolean;
+}>): McpToolAliasResolution;