@askdkc/dsh-cli 0.11.3

package/vendor/dsh-std/packages/command/node_modules/@dsh-std/connection/lib/resolve-3X6ausgz.js

@@ -0,0 +1,226 @@
+import { defineProtocolDeclaration, validateProtocolDeclaration } from "@dsh-std/core";
+//#region src/model.ts
+const CONNECTION_API_VERSION = "connection.dsh/v1alpha1";
+function createEndpointOffer(endpoint, revision, declarations) {
+	validateEndpoint(endpoint);
+	validateOfferRevision(revision);
+	const seen = /* @__PURE__ */ new Set();
+	const normalized = declarations.map((declaration) => defineProtocolDeclaration(declaration));
+	for (const declaration of normalized) {
+		if (seen.has(declaration.participant.id)) throw new TypeError(`duplicate endpoint participant ${JSON.stringify(declaration.participant.id)}`);
+		seen.add(declaration.participant.id);
+	}
+	return Object.freeze({
+		apiVersion: CONNECTION_API_VERSION,
+		kind: "ConnectionOffer",
+		endpoint: freezeEndpoint(endpoint),
+		revision,
+		declarations: Object.freeze(normalized)
+	});
+}
+function validateEndpointOffer(offer) {
+	if (offer.apiVersion !== "connection.dsh/v1alpha1" || offer.kind !== "ConnectionOffer") throw new TypeError("endpoint offer version or kind is unsupported");
+	validateEndpoint(offer.endpoint);
+	validateOfferRevision(offer.revision);
+	if (!Array.isArray(offer.declarations)) throw new TypeError("endpoint offer declarations must be an array");
+	const seen = /* @__PURE__ */ new Set();
+	for (const declaration of offer.declarations) {
+		validateProtocolDeclaration(declaration);
+		if (seen.has(declaration.participant.id)) throw new TypeError(`duplicate endpoint participant ${JSON.stringify(declaration.participant.id)}`);
+		seen.add(declaration.participant.id);
+	}
+}
+function freezeEndpoint(endpoint) {
+	return Object.freeze({
+		id: endpoint.id,
+		instanceId: endpoint.instanceId
+	});
+}
+function validatePlanCoordinates(connectionId, revision) {
+	nonEmpty(connectionId, "connectionId");
+	if (!Number.isSafeInteger(revision) || revision < 1) throw new TypeError("connection revision must be a positive safe integer");
+}
+function validateEndpoint(endpoint) {
+	nonEmpty(endpoint.id, "endpoint.id");
+	nonEmpty(endpoint.instanceId, "endpoint.instanceId");
+}
+function validateOfferRevision(revision) {
+	if (!Number.isSafeInteger(revision) || revision < 0) throw new TypeError("offer revision must be a non-negative safe integer");
+}
+function nonEmpty(value, label) {
+	if (typeof value !== "string" || value.trim() === "") throw new TypeError(`${label} must be a non-empty string`);
+}
+//#endregion
+//#region src/connection.ts
+var ConnectionInvocationError = class extends Error {
+	code;
+	constructor(code, message, options) {
+		super(message, options);
+		this.code = code;
+		this.name = "ConnectionInvocationError";
+	}
+};
+//#endregion
+//#region src/rpc.ts
+/** Reusable RPC-shaped protocol definition. Domain packages opt into these semantics explicitly. */
+function defineCapabilityProtocol(options) {
+	const definition = {
+		apiVersion: options.apiVersion,
+		kind: options.kind,
+		...options.accepts === void 0 ? {} : { accepts: Object.freeze([...options.accepts]) },
+		validateRequirement: options.validateRequirement ?? ((value) => value),
+		validateSupport: options.validateSupport ?? ((value) => value),
+		negotiate(input) {
+			const issues = [];
+			const bindings = [];
+			const connectionPolicy = isConnectionPolicy(input.policy) ? input.policy : void 0;
+			for (const row of input.requirements) {
+				const consumerEndpoint = connectionPolicy?.endpointByParticipant[row.participant];
+				const providers = input.supports.filter((candidate) => candidate.participant !== row.participant && (consumerEndpoint === void 0 || connectionPolicy?.endpointByParticipant[candidate.participant] !== consumerEndpoint));
+				if (providers.length === 0) {
+					issues.push(Object.freeze({
+						code: row.requirement.optional === true ? "optional-support-missing" : "required-support-missing",
+						severity: row.requirement.optional === true ? "warning" : "error",
+						participant: row.participant,
+						message: `no participant supports ${row.requirement.apiVersion} ${row.requirement.kind}`
+					}));
+					continue;
+				}
+				if (providers.length > 1 && options.multipleProviders !== true) {
+					issues.push(Object.freeze({
+						code: "support-ambiguous",
+						severity: "error",
+						participant: row.participant,
+						message: `multiple participants support ${row.requirement.apiVersion} ${row.requirement.kind}`
+					}));
+					continue;
+				}
+				for (const provider of options.multipleProviders === true ? providers : providers.slice(0, 1)) bindings.push(Object.freeze({
+					consumer: row.participant,
+					provider: provider.participant,
+					requirement: row.requirement,
+					support: provider.support
+				}));
+			}
+			return {
+				agreement: Object.freeze({
+					kind: "CapabilityBindings",
+					bindings: Object.freeze(bindings)
+				}),
+				issues: Object.freeze(issues)
+			};
+		}
+	};
+	return Object.freeze(definition);
+}
+function isConnectionPolicy(value) {
+	return typeof value === "object" && value !== null && typeof value.endpointByParticipant === "object" && value.endpointByParticipant !== null;
+}
+function isCapabilityAgreement(value) {
+	return typeof value === "object" && value !== null && value.kind === "CapabilityBindings" && Array.isArray(value.bindings);
+}
+//#endregion
+//#region src/resolve.ts
+function resolveConnection(left, right, options) {
+	validateEndpointOffer(left);
+	validateEndpointOffer(right);
+	validatePlanCoordinates(options.connectionId, options.revision);
+	if (left.endpoint.instanceId === right.endpoint.instanceId) throw new TypeError("connection endpoints must have distinct instanceId values");
+	const owner = participantOwners(left, right);
+	const endpointByParticipant = Object.freeze(Object.fromEntries([...owner.entries()].map(([participant, row]) => [participant, row.endpoint.instanceId])));
+	const policy = Object.freeze({
+		endpointByParticipant,
+		...options.policy === void 0 ? {} : { protocol: options.policy }
+	});
+	const report = options.protocols.negotiate([...left.declarations, ...right.declarations], policy);
+	const bindings = [];
+	for (const protocol of report.protocols) {
+		if (!isCapabilityAgreement(protocol.agreement)) continue;
+		for (const draft of protocol.agreement.bindings) {
+			const consumer = owner.get(draft.consumer);
+			const provider = owner.get(draft.provider);
+			if (consumer === void 0 || provider === void 0) continue;
+			bindings.push(Object.freeze({
+				bindingId: "",
+				agreementId: `${protocol.apiVersion}:${protocol.kind}`,
+				planRevision: options.revision,
+				consumer,
+				provider,
+				requirement: Object.freeze({ ...draft.requirement }),
+				support: Object.freeze({ ...draft.support })
+			}));
+		}
+	}
+	bindings.sort((a, b) => a.consumer.participantId.localeCompare(b.consumer.participantId) || a.requirement.apiVersion.localeCompare(b.requirement.apiVersion) || a.requirement.kind.localeCompare(b.requirement.kind) || a.provider.participantId.localeCompare(b.provider.participantId));
+	const numbered = bindings.map((binding, index) => Object.freeze({
+		...binding,
+		bindingId: `binding-${String(index + 1)}`
+	}));
+	const issues = Object.freeze(report.issues.map((row) => connectionIssue(row, owner)));
+	const coordinates = Object.freeze([Object.freeze({
+		endpoint: freezeEndpoint(left.endpoint),
+		revision: left.revision
+	}), Object.freeze({
+		endpoint: freezeEndpoint(right.endpoint),
+		revision: right.revision
+	})]);
+	const digest = planDigest({
+		connectionId: options.connectionId,
+		revision: options.revision,
+		offers: coordinates,
+		protocols: report.protocols
+	});
+	return Object.freeze({
+		apiVersion: CONNECTION_API_VERSION,
+		kind: "ConnectionAgreement",
+		connectionId: options.connectionId,
+		revision: options.revision,
+		digest,
+		offers: coordinates,
+		compatible: report.compatible,
+		protocols: report.protocols,
+		bindings: Object.freeze(numbered),
+		issues
+	});
+}
+function planDigest(value) {
+	const input = canonical(value);
+	let hash = 2166136261;
+	for (let index = 0; index < input.length; index += 1) hash = Math.imul(hash ^ input.charCodeAt(index), 16777619);
+	return `fnv1a32:${(hash >>> 0).toString(16).padStart(8, "0")}`;
+}
+function canonical(value) {
+	if (Array.isArray(value)) return `[${value.map(canonical).join(",")}]`;
+	if (typeof value === "object" && value !== null) return `{${Object.entries(value).sort(([a], [b]) => a.localeCompare(b)).map(([key, item]) => `${JSON.stringify(key)}:${canonical(item)}`).join(",")}}`;
+	return JSON.stringify(value);
+}
+function participantOwners(left, right) {
+	const owners = /* @__PURE__ */ new Map();
+	for (const offer of [left, right]) for (const declaration of offer.declarations) {
+		if (owners.has(declaration.participant.id)) throw new TypeError(`participant ${JSON.stringify(declaration.participant.id)} appears in both endpoint offers`);
+		owners.set(declaration.participant.id, Object.freeze({
+			endpoint: freezeEndpoint(offer.endpoint),
+			participantId: declaration.participant.id
+		}));
+	}
+	return owners;
+}
+function connectionIssue(issue, owners) {
+	return Object.freeze({
+		severity: issue.severity,
+		code: issue.code,
+		...issue.participant === void 0 ? {} : { participant: owners.get(issue.participant) ?? Object.freeze({
+			endpoint: Object.freeze({
+				id: "unknown",
+				instanceId: "unknown"
+			}),
+			participantId: issue.participant
+		}) },
+		...issue.path === void 0 ? {} : { path: issue.path },
+		message: issue.message
+	});
+}
+//#endregion
+export { CONNECTION_API_VERSION as a, validateEndpointOffer as c, ConnectionInvocationError as i, validatePlanCoordinates as l, defineCapabilityProtocol as n, createEndpointOffer as o, isCapabilityAgreement as r, freezeEndpoint as s, resolveConnection as t };
+
+//# sourceMappingURL=resolve-3X6ausgz.js.map

package/vendor/dsh-std/packages/command/node_modules/@dsh-std/connection/lib/resolve-3X6ausgz.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-3X6ausgz.js","names":[],"sources":["../src/model.ts","../src/connection.ts","../src/rpc.ts","../src/resolve.ts"],"sourcesContent":["import type {\n  NegotiatedProtocol,\n  ProtocolDeclaration,\n  ProtocolRequirement,\n  ProtocolSupport,\n} from '@dsh-std/core'\nimport type { ProtocolCatalog } from '@dsh-std/core'\nimport { defineProtocolDeclaration, validateProtocolDeclaration } from '@dsh-std/core'\n\nexport const CONNECTION_API_VERSION = 'connection.dsh/v1alpha1'\n\nexport interface EndpointIdentity {\n  readonly id: string\n  readonly instanceId: string\n}\n\nexport interface EndpointOffer {\n  readonly apiVersion: typeof CONNECTION_API_VERSION\n  readonly kind: 'ConnectionOffer'\n  readonly endpoint: EndpointIdentity\n  readonly revision: number\n  readonly declarations: readonly ProtocolDeclaration[]\n}\n\nexport interface ConnectionEndpointReference extends EndpointIdentity {}\n\nexport interface CapabilityParticipant {\n  readonly endpoint: ConnectionEndpointReference\n  readonly participantId: string\n}\n\nexport interface CapabilityBinding {\n  readonly bindingId: string\n  readonly agreementId: string\n  readonly planRevision: number\n  readonly consumer: CapabilityParticipant\n  readonly provider: CapabilityParticipant\n  readonly requirement: ProtocolRequirement\n  readonly support: ProtocolSupport\n}\n\nexport interface ConnectionIssue {\n  readonly severity: 'error' | 'warning'\n  readonly code: string\n  readonly participant?: CapabilityParticipant\n  readonly path?: string\n  readonly message: string\n}\n\nexport interface ConnectionPlan {\n  readonly apiVersion: typeof CONNECTION_API_VERSION\n  readonly kind: 'ConnectionAgreement'\n  readonly connectionId: string\n  readonly revision: number\n  readonly digest: string\n  readonly offers: readonly {\n    readonly endpoint: ConnectionEndpointReference\n    readonly revision: number\n  }[]\n  readonly compatible: boolean\n  readonly protocols: readonly NegotiatedProtocol[]\n  readonly bindings: readonly CapabilityBinding[]\n  readonly issues: readonly ConnectionIssue[]\n}\n\nexport interface ResolveConnectionOptions {\n  readonly connectionId: string\n  readonly revision: number\n  readonly protocols: ProtocolCatalog\n  readonly policy?: unknown\n}\n\n/** Policy envelope supplied to definitions while evaluating a pair of endpoint offers. */\nexport interface ConnectionNegotiationPolicy {\n  readonly endpointByParticipant: Readonly<Record<string, string>>\n  readonly protocol?: unknown\n}\n\nexport function createEndpointOffer(\n  endpoint: EndpointIdentity,\n  revision: number,\n  declarations: readonly ProtocolDeclaration[],\n): EndpointOffer {\n  validateEndpoint(endpoint)\n  validateOfferRevision(revision)\n  const seen = new Set<string>()\n  const normalized = declarations.map(declaration => defineProtocolDeclaration(declaration))\n  for (const declaration of normalized) {\n    if (seen.has(declaration.participant.id)) throw new TypeError(`duplicate endpoint participant ${JSON.stringify(declaration.participant.id)}`)\n    seen.add(declaration.participant.id)\n  }\n  return Object.freeze({\n    apiVersion: CONNECTION_API_VERSION,\n    kind: 'ConnectionOffer',\n    endpoint: freezeEndpoint(endpoint),\n    revision,\n    declarations: Object.freeze(normalized),\n  })\n}\n\nexport function validateEndpointOffer(offer: EndpointOffer): void {\n  if (offer.apiVersion !== CONNECTION_API_VERSION || offer.kind !== 'ConnectionOffer') throw new TypeError('endpoint offer version or kind is unsupported')\n  validateEndpoint(offer.endpoint)\n  validateOfferRevision(offer.revision)\n  if (!Array.isArray(offer.declarations)) throw new TypeError('endpoint offer declarations must be an array')\n  const seen = new Set<string>()\n  for (const declaration of offer.declarations) {\n    validateProtocolDeclaration(declaration)\n    if (seen.has(declaration.participant.id)) throw new TypeError(`duplicate endpoint participant ${JSON.stringify(declaration.participant.id)}`)\n    seen.add(declaration.participant.id)\n  }\n}\n\nexport function freezeEndpoint(endpoint: EndpointIdentity): ConnectionEndpointReference {\n  return Object.freeze({ id: endpoint.id, instanceId: endpoint.instanceId })\n}\n\nexport function validatePlanCoordinates(connectionId: string, revision: number): void {\n  nonEmpty(connectionId, 'connectionId')\n  if (!Number.isSafeInteger(revision) || revision < 1) throw new TypeError('connection revision must be a positive safe integer')\n}\n\nfunction validateEndpoint(endpoint: EndpointIdentity): void {\n  nonEmpty(endpoint.id, 'endpoint.id')\n  nonEmpty(endpoint.instanceId, 'endpoint.instanceId')\n}\n\nfunction validateOfferRevision(revision: number): void {\n  if (!Number.isSafeInteger(revision) || revision < 0) throw new TypeError('offer revision must be a non-negative safe integer')\n}\n\nfunction nonEmpty(value: string, label: string): void {\n  if (typeof value !== 'string' || value.trim() === '') throw new TypeError(`${label} must be a non-empty string`)\n}\n","import type { ApiReference, ProtocolSupport } from '@dsh-std/core'\nimport type { CapabilityBinding, ConnectionEndpointReference, ConnectionPlan, EndpointOffer } from './model.js'\n\nexport interface CapabilityHandlerContext<TProgress = unknown> {\n  readonly connectionId: string\n  readonly planRevision: number\n  readonly invocationId: string\n  readonly binding: CapabilityBinding\n  readonly signal: AbortSignal\n  progress(value: TProgress): void\n}\n\nexport type CapabilityHandler<TInput = unknown, TOutput = unknown, TProgress = unknown> = (\n  operation: string, input: TInput, context: CapabilityHandlerContext<TProgress>,\n) => TOutput | Promise<TOutput>\n\nexport interface CapabilityImplementation<TInput = unknown, TOutput = unknown, TProgress = unknown> {\n  readonly participantId: string\n  readonly protocol: ProtocolSupport\n  readonly handle: CapabilityHandler<TInput, TOutput, TProgress>\n}\n\nexport interface CapabilityDispatch<TInput = unknown, TProgress = unknown> {\n  readonly connectionId: string\n  readonly planRevision: number\n  readonly invocationId: string\n  readonly binding: CapabilityBinding\n  readonly operation: string\n  readonly input: TInput\n  readonly signal: AbortSignal\n  progress(value: TProgress): void\n}\n\nexport interface ConnectionEndpoint {\n  readonly offer: EndpointOffer\n  dispatch<TInput = unknown, TOutput = unknown, TProgress = unknown>(invocation: CapabilityDispatch<TInput, TProgress>): Promise<TOutput>\n  onOfferChange(listener: (offer: EndpointOffer) => void): () => void\n}\n\nexport interface CapabilityCall<TOutput = unknown, TProgress = unknown> {\n  readonly invocationId: string\n  readonly result: Promise<TOutput>\n  readonly progress: AsyncIterable<TProgress>\n  cancel(reason?: string): void\n}\n\nexport interface CapabilityClient {\n  readonly participantId: string\n  binding(reference: ApiReference): CapabilityBinding | undefined\n  invoke<TInput = unknown, TOutput = unknown, TProgress = unknown>(\n    reference: ApiReference,\n    operation: string,\n    input: TInput,\n    options?: { readonly signal?: AbortSignal },\n  ): CapabilityCall<TOutput, TProgress>\n}\n\nexport interface StandardConnection {\n  readonly id: string\n  readonly local: ConnectionEndpointReference\n  readonly remote: ConnectionEndpointReference\n  readonly plan: ConnectionPlan\n  client(participantId: string): CapabilityClient\n  onPlanChange(listener: (plan: ConnectionPlan) => void): () => void\n  close(reason?: string): void | Promise<void>\n}\n\nexport class ConnectionInvocationError extends Error {\n  constructor(\n    readonly code: 'connection-closed' | 'capability-unbound' | 'handler-missing' | 'cancelled' | 'handler-failed',\n    message: string,\n    options?: ErrorOptions,\n  ) {\n    super(message, options)\n    this.name = 'ConnectionInvocationError'\n  }\n}\n","import type {\n  ProtocolDefinition,\n  ProtocolIssue,\n  ProtocolRequirement,\n  ProtocolSupport,\n} from '@dsh-std/core'\nimport type { ConnectionNegotiationPolicy } from './model.js'\n\nexport interface CapabilityBindingDraft {\n  readonly consumer: string\n  readonly provider: string\n  readonly requirement: ProtocolRequirement\n  readonly support: ProtocolSupport\n}\n\nexport interface CapabilityAgreement {\n  readonly kind: 'CapabilityBindings'\n  readonly bindings: readonly CapabilityBindingDraft[]\n}\n\nexport interface CapabilityProtocolOptions {\n  readonly apiVersion: string\n  readonly kind: string\n  readonly accepts?: readonly string[]\n  readonly multipleProviders?: boolean\n  validateRequirement?(spec: unknown): unknown\n  validateSupport?(spec: unknown): unknown\n}\n\n/** Reusable RPC-shaped protocol definition. Domain packages opt into these semantics explicitly. */\nexport function defineCapabilityProtocol(options: CapabilityProtocolOptions): ProtocolDefinition {\n  const definition: ProtocolDefinition = {\n    apiVersion: options.apiVersion,\n    kind: options.kind,\n    ...(options.accepts === undefined ? {} : { accepts: Object.freeze([...options.accepts]) }),\n    validateRequirement: options.validateRequirement ?? ((value: unknown) => value),\n    validateSupport: options.validateSupport ?? ((value: unknown) => value),\n    negotiate(input) {\n      const issues: ProtocolIssue[] = []\n      const bindings: CapabilityBindingDraft[] = []\n      const connectionPolicy = isConnectionPolicy(input.policy) ? input.policy : undefined\n      for (const row of input.requirements) {\n        const consumerEndpoint = connectionPolicy?.endpointByParticipant[row.participant]\n        const providers = input.supports.filter(candidate =>\n          candidate.participant !== row.participant\n          && (consumerEndpoint === undefined\n            || connectionPolicy?.endpointByParticipant[candidate.participant] !== consumerEndpoint),\n        )\n        if (providers.length === 0) {\n          issues.push(Object.freeze({\n            code: row.requirement.optional === true ? 'optional-support-missing' : 'required-support-missing',\n            severity: row.requirement.optional === true ? 'warning' : 'error',\n            participant: row.participant,\n            message: `no participant supports ${row.requirement.apiVersion} ${row.requirement.kind}`,\n          }))\n          continue\n        }\n        if (providers.length > 1 && options.multipleProviders !== true) {\n          issues.push(Object.freeze({\n            code: 'support-ambiguous', severity: 'error', participant: row.participant,\n            message: `multiple participants support ${row.requirement.apiVersion} ${row.requirement.kind}`,\n          }))\n          continue\n        }\n        for (const provider of options.multipleProviders === true ? providers : providers.slice(0, 1)) {\n          bindings.push(Object.freeze({\n            consumer: row.participant,\n            provider: provider.participant,\n            requirement: row.requirement,\n            support: provider.support,\n          }))\n        }\n      }\n      return {\n        agreement: Object.freeze({ kind: 'CapabilityBindings' as const, bindings: Object.freeze(bindings) }),\n        issues: Object.freeze(issues),\n      }\n    },\n  }\n  return Object.freeze(definition)\n}\n\nfunction isConnectionPolicy(value: unknown): value is ConnectionNegotiationPolicy {\n  return typeof value === 'object' && value !== null\n    && typeof (value as { endpointByParticipant?: unknown }).endpointByParticipant === 'object'\n    && (value as { endpointByParticipant?: unknown }).endpointByParticipant !== null\n}\n\nexport function isCapabilityAgreement(value: unknown): value is CapabilityAgreement {\n  return typeof value === 'object' && value !== null\n    && (value as { kind?: unknown }).kind === 'CapabilityBindings'\n    && Array.isArray((value as { bindings?: unknown }).bindings)\n}\n","import type { ProtocolIssue } from '@dsh-std/core'\nimport {\n  CONNECTION_API_VERSION,\n  freezeEndpoint,\n  validateEndpointOffer,\n  validatePlanCoordinates,\n  type CapabilityBinding,\n  type CapabilityParticipant,\n  type ConnectionIssue,\n  type ConnectionPlan,\n  type ConnectionNegotiationPolicy,\n  type EndpointOffer,\n  type ResolveConnectionOptions,\n} from './model.js'\nimport { isCapabilityAgreement } from './rpc.js'\n\nexport function resolveConnection(left: EndpointOffer, right: EndpointOffer, options: ResolveConnectionOptions): ConnectionPlan {\n  validateEndpointOffer(left)\n  validateEndpointOffer(right)\n  validatePlanCoordinates(options.connectionId, options.revision)\n  if (left.endpoint.instanceId === right.endpoint.instanceId) throw new TypeError('connection endpoints must have distinct instanceId values')\n\n  const owner = participantOwners(left, right)\n  const endpointByParticipant = Object.freeze(Object.fromEntries(\n    [...owner.entries()].map(([participant, row]) => [participant, row.endpoint.instanceId]),\n  ))\n  const policy: ConnectionNegotiationPolicy = Object.freeze({\n    endpointByParticipant,\n    ...(options.policy === undefined ? {} : { protocol: options.policy }),\n  })\n  const report = options.protocols.negotiate([...left.declarations, ...right.declarations], policy)\n  const bindings: CapabilityBinding[] = []\n  for (const protocol of report.protocols) {\n    if (!isCapabilityAgreement(protocol.agreement)) continue\n    for (const draft of protocol.agreement.bindings) {\n      const consumer = owner.get(draft.consumer)\n      const provider = owner.get(draft.provider)\n      if (consumer === undefined || provider === undefined) continue\n      bindings.push(Object.freeze({\n        bindingId: '', agreementId: `${protocol.apiVersion}:${protocol.kind}`,\n        planRevision: options.revision,\n        consumer, provider,\n        requirement: Object.freeze({ ...draft.requirement }),\n        support: Object.freeze({ ...draft.support }),\n      }))\n    }\n  }\n  bindings.sort((a, b) => a.consumer.participantId.localeCompare(b.consumer.participantId)\n    || a.requirement.apiVersion.localeCompare(b.requirement.apiVersion)\n    || a.requirement.kind.localeCompare(b.requirement.kind)\n    || a.provider.participantId.localeCompare(b.provider.participantId))\n  const numbered = bindings.map((binding, index) => Object.freeze({ ...binding, bindingId: `binding-${String(index + 1)}` }))\n  const issues = Object.freeze(report.issues.map(row => connectionIssue(row, owner)))\n  const coordinates = Object.freeze([\n    Object.freeze({ endpoint: freezeEndpoint(left.endpoint), revision: left.revision }),\n    Object.freeze({ endpoint: freezeEndpoint(right.endpoint), revision: right.revision }),\n  ])\n  const digest = planDigest({ connectionId: options.connectionId, revision: options.revision, offers: coordinates, protocols: report.protocols })\n  return Object.freeze({\n    apiVersion: CONNECTION_API_VERSION,\n    kind: 'ConnectionAgreement',\n    connectionId: options.connectionId,\n    revision: options.revision,\n    digest,\n    offers: coordinates,\n    compatible: report.compatible,\n    protocols: report.protocols,\n    bindings: Object.freeze(numbered),\n    issues,\n  })\n}\n\nfunction planDigest(value: unknown): string {\n  const input = canonical(value)\n  let hash = 2166136261\n  for (let index = 0; index < input.length; index += 1) hash = Math.imul(hash ^ input.charCodeAt(index), 16777619)\n  return `fnv1a32:${(hash >>> 0).toString(16).padStart(8, '0')}`\n}\n\nfunction canonical(value: unknown): string {\n  if (Array.isArray(value)) return `[${value.map(canonical).join(',')}]`\n  if (typeof value === 'object' && value !== null) {\n    return `{${Object.entries(value).sort(([a], [b]) => a.localeCompare(b)).map(([key, item]) => `${JSON.stringify(key)}:${canonical(item)}`).join(',')}}`\n  }\n  return JSON.stringify(value)\n}\n\nfunction participantOwners(left: EndpointOffer, right: EndpointOffer): Map<string, CapabilityParticipant> {\n  const owners = new Map<string, CapabilityParticipant>()\n  for (const offer of [left, right]) {\n    for (const declaration of offer.declarations) {\n      if (owners.has(declaration.participant.id)) throw new TypeError(`participant ${JSON.stringify(declaration.participant.id)} appears in both endpoint offers`)\n      owners.set(declaration.participant.id, Object.freeze({\n        endpoint: freezeEndpoint(offer.endpoint), participantId: declaration.participant.id,\n      }))\n    }\n  }\n  return owners\n}\n\nfunction connectionIssue(issue: ProtocolIssue, owners: ReadonlyMap<string, CapabilityParticipant>): ConnectionIssue {\n  return Object.freeze({\n    severity: issue.severity,\n    code: issue.code,\n    ...(issue.participant === undefined ? {} : {\n      participant: owners.get(issue.participant) ?? Object.freeze({\n        endpoint: Object.freeze({ id: 'unknown', instanceId: 'unknown' }), participantId: issue.participant,\n      }),\n    }),\n    ...(issue.path === undefined ? {} : { path: issue.path }),\n    message: issue.message,\n  })\n}\n"],"mappings":"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"}

package/vendor/dsh-std/packages/command/node_modules/@dsh-std/connection/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@dsh-std/connection",
+  "version": "0.1.0",
+  "license": "MIT",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": { "types": "./lib/index.d.ts", "default": "./lib/index.js" },
+    "./memory": { "types": "./lib/memory.d.ts", "default": "./lib/memory.js" }
+  },
+  "files": ["lib", "CHANGELOG.md"],
+  "scripts": {
+    "build": "pnpm run typecheck && tsdown",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": { "@dsh-std/core": "workspace:*" },
+  "engines": { "node": "^22.19 || >=24" }
+}

package/vendor/dsh-std/packages/command/node_modules/@dsh-std/core/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+Changes to `@dsh-std/core` are recorded here.
+
+## 0.1.0 (draft)
+
+- Defined protocol coordinates, participant declarations, definition catalogs, and negotiation reports.
+- Separated evaluator knowledge, requirements, potential support, and live support.

package/vendor/dsh-std/packages/command/node_modules/@dsh-std/core/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DSH Standard contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/vendor/dsh-std/packages/command/node_modules/@dsh-std/core/README.md

@@ -0,0 +1,13 @@
+# @dsh-std/core
+
+English | [中文](README.zh.md)
+
+The minimal meta-protocol for protocol declarations, definition registration, and negotiation. See the [Core Meta-protocol proposal](../../docs/proposals/core.zh.md).
+
+Core understands only `apiVersion`, `kind`, participants, requirements, supports, protocol definitions, and their agreements. It does not prescribe resources, capabilities, providers, execution planes, locality, endpoints, or plugin lifecycle.
+
+A `ProtocolCatalog` belongs to an evaluator. Each protocol definition explicitly lists accepted API versions, validates requirement/support `spec` values, and owns its negotiation logic. Core neither infers compatibility from a shared major version nor treats an installed definition as a live implementation.
+
+`defineProtocolDeclaration()` validates and freezes the requirements and supports currently published by one participant. Static component bounds belong to `@dsh-std/manifest`, selection to `@dsh-std/composition`, activation and the publication barrier to `@dsh-std/lifecycle`, and cross-endpoint offers to `@dsh-std/connection`.
+
+Provider selection, multi-party merging, catalogs, invocation bindings, and UI semantics remain owned by their protocol definitions or domain packages.

package/vendor/dsh-std/packages/command/node_modules/@dsh-std/core/README.zh.md

@@ -0,0 +1,13 @@
+# @dsh-std/core
+
+[English](README.md) | 中文
+
+协议声明、definition 注册与协商的最小元协议。设计见 [Core Meta-protocol](../../docs/proposals/core.zh.md)。
+
+Core 只认识 `apiVersion`、`kind`、participant、requirement、support、协议 definition 及其 agreement。它不预设 resource、capability、provider、execution plane、locality、endpoint 或插件生命周期。
+
+`ProtocolCatalog` 由评估器持有。每个协议 definition 明确列出接受的 API 版本，分别校验 requirement/support 的 `spec`，并拥有自己的协商逻辑。Core 不会从相同主版本推断兼容性，也不会把安装了一份 definition 当作已有 live implementation。
+
+`defineProtocolDeclaration()` 校验并冻结一个 participant 当前实际发布的 requirements 与 supports。静态组件上限属于 `@dsh-std/manifest`，选择属于 `@dsh-std/composition`，激活与 publication barrier 属于 `@dsh-std/lifecycle`，跨端点 offer 属于 `@dsh-std/connection`。
+
+协议专属的 provider 选择、多项合并、目录、调用绑定和 UI 语义均由相应 definition 或独立协议包定义。

package/vendor/dsh-std/packages/command/node_modules/@dsh-std/core/lib/index.d.ts

@@ -0,0 +1,112 @@
+//#region src/protocol.d.ts
+/** Domain-neutral protocol identities and live participant declarations. */
+interface ApiReference {
+  readonly apiVersion: string;
+  readonly kind: string;
+}
+interface ParticipantIdentity {
+  /** Unique within the negotiation scope that carries this declaration. */
+  readonly id: string;
+}
+interface ProtocolRequirement<Spec = unknown> extends ApiReference {
+  readonly optional?: boolean;
+  readonly spec?: Spec;
+}
+interface ProtocolSupport<Spec = unknown> extends ApiReference {
+  readonly spec?: Spec;
+}
+interface ProtocolDeclaration {
+  readonly participant: ParticipantIdentity;
+  readonly requires?: readonly ProtocolRequirement[];
+  readonly supports?: readonly ProtocolSupport[];
+}
+interface ParsedApiVersion {
+  readonly group: string;
+  readonly major: number;
+  readonly stability: 'alpha' | 'beta' | 'stable';
+  readonly revision: number;
+}
+declare function protocolKey(reference: ApiReference): string;
+/** A grouping key only. It does not claim that versions in the family interoperate. */
+declare function protocolFamilyKey(reference: ApiReference): string;
+declare function sameProtocol(left: ApiReference, right: ApiReference): boolean;
+declare function parseApiVersion(value: string): ParsedApiVersion;
+declare function validateApiReference(value: unknown, label?: string): asserts value is ApiReference;
+declare function validateProtocolDeclaration(value: unknown): asserts value is ProtocolDeclaration;
+declare function defineProtocolDeclaration<const T extends ProtocolDeclaration>(declaration: T): T;
+//#endregion
+//#region src/negotiation.d.ts
+interface EvaluatorIdentity {
+  readonly name: string;
+  readonly version: string;
+}
+interface ProtocolRequirementEntry<Spec = unknown> {
+  readonly participant: string;
+  readonly requirement: ProtocolRequirement<Spec>;
+}
+interface ProtocolSupportEntry<Spec = unknown> {
+  readonly participant: string;
+  readonly support: ProtocolSupport<Spec>;
+}
+interface ProtocolIssue {
+  readonly code: string;
+  readonly severity: 'error' | 'warning';
+  readonly participant?: string;
+  readonly path?: string;
+  readonly message: string;
+}
+interface ProtocolNegotiationInput<RequirementSpec = unknown, SupportSpec = unknown, Policy = unknown> {
+  readonly requirements: readonly ProtocolRequirementEntry<RequirementSpec>[];
+  readonly supports: readonly ProtocolSupportEntry<SupportSpec>[];
+  readonly policy?: Policy;
+}
+interface ProtocolNegotiationOutcome<Agreement = unknown> {
+  readonly agreement?: Agreement;
+  readonly issues?: readonly ProtocolIssue[];
+}
+interface ProtocolDefinition<RequirementSpec = unknown, SupportSpec = unknown, Agreement = unknown, Policy = unknown> extends ApiReference {
+  /** Every accepted wire/static API version. No compatibility is inferred by core. */
+  readonly accepts?: readonly string[];
+  validateRequirement(spec: unknown): RequirementSpec;
+  validateSupport(spec: unknown): SupportSpec;
+  negotiate(input: ProtocolNegotiationInput<RequirementSpec, SupportSpec, Policy>): ProtocolNegotiationOutcome<Agreement>;
+}
+interface NegotiatedProtocol<Agreement = unknown> extends ApiReference {
+  readonly participants: readonly string[];
+  readonly agreement?: Agreement;
+  readonly issues: readonly ProtocolIssue[];
+}
+interface NegotiationReport {
+  readonly apiVersion: 'core.dsh/report/v1alpha1';
+  readonly evaluator: EvaluatorIdentity;
+  readonly compatible: boolean;
+  readonly protocols: readonly NegotiatedProtocol[];
+  readonly issues: readonly ProtocolIssue[];
+}
+declare class ProtocolCatalog {
+  readonly evaluator: EvaluatorIdentity;
+  private readonly definitions;
+  constructor(evaluator: EvaluatorIdentity);
+  register(definition: ProtocolDefinition): () => void;
+  list(): readonly ProtocolDefinition[];
+  resolve(reference: ApiReference): ProtocolDefinition | undefined;
+  understands(reference: ApiReference): boolean;
+  negotiate(declarations: readonly ProtocolDeclaration[], policy?: unknown): NegotiationReport;
+}
+//#endregion
+//#region src/version.d.ts
+interface SemanticVersion {
+  readonly major: number;
+  readonly minor: number;
+  readonly patch: number;
+  readonly prerelease: readonly (string | number)[];
+  readonly build: readonly string[];
+}
+type VersionRange = string | readonly string[];
+declare function parseSemanticVersion(value: string): SemanticVersion;
+declare function compareSemanticVersions(leftValue: string | SemanticVersion, rightValue: string | SemanticVersion): number;
+declare function assertVersionRange(range: VersionRange): void;
+declare function satisfiesVersionRange(versionValue: string, range: VersionRange): boolean;
+//#endregion
+export { ApiReference, EvaluatorIdentity, NegotiatedProtocol, NegotiationReport, ParsedApiVersion, ParticipantIdentity, ProtocolCatalog, ProtocolDeclaration, ProtocolDefinition, ProtocolIssue, ProtocolNegotiationInput, ProtocolNegotiationOutcome, ProtocolRequirement, ProtocolRequirementEntry, ProtocolSupport, ProtocolSupportEntry, SemanticVersion, VersionRange, assertVersionRange, compareSemanticVersions, defineProtocolDeclaration, parseApiVersion, parseSemanticVersion, protocolFamilyKey, protocolKey, sameProtocol, satisfiesVersionRange, validateApiReference, validateProtocolDeclaration };
+//# sourceMappingURL=index.d.ts.map

package/vendor/dsh-std/packages/command/node_modules/@dsh-std/core/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/protocol.ts","../src/negotiation.ts","../src/version.ts"],"mappings":";;UAEiB;WACN;WACA;;UAGM;;WAEN;;UAGM,oBAAoB,wBAAwB;WAClD;WACA,OAAO;;UAGD,gBAAgB,wBAAwB;WAC9C,OAAO;;UAGD;WACN,aAAa;WACb,oBAAoB;WACpB,oBAAoB;;UAGd;WACN;WACA;WACA;WACA;;iBAGK,YAAY,WAAW;;iBAKvB,kBAAkB,WAAW;iBAK7B,aAAa,MAAM,cAAc,OAAO;iBAIxC,gBAAgB,gBAAgB;iBAWhC,qBAAqB,gBAAgB,yBAAuC,SAAS;iBASrF,4BAA4B,yBAAyB,SAAS;iBAU9D,gCAAgC,UAAU,qBAAqB,aAAa,IAAI;;;UCpE/E;WACN;WACA;;UAGM,yBAAyB;WAC/B;WACA,aAAa,oBAAoB;;UAG3B,qBAAqB;WAC3B;WACA,SAAS,gBAAgB;;UAGnB;WACN;WACA;WACA;WACA;WACA;;UAGM,yBAAyB,2BAA2B,uBAAuB;WACjF,uBAAuB,yBAAyB;WAChD,mBAAmB,qBAAqB;WACxC,SAAS;;UAGH,2BAA2B;WACjC,YAAY;WACZ,kBAAkB;;UAGZ,mBAAmB,2BAA2B,uBAAuB,qBAAqB,0BACjG;;WAEC;EACT,oBAAoB,gBAAgB;EACpC,gBAAgB,gBAAgB;EAChC,UACE,OAAO,yBAAyB,iBAAiB,aAAa,UAC7D,2BAA2B;;UAGf,mBAAmB,6BAA6B;WACtD;WACA,YAAY;WACZ,iBAAiB;;UAGX;WACN;WACA,WAAW;WACX;WACA,oBAAoB;WACpB,iBAAiB;;cAQf;WAGU,WAAW;mBAFf;EAEI,YAAA,WAAW;EAKhC,SAAS,YAAY;EAmBrB,iBAAiB;EAIjB,QAAQ,WAAW,eAAe;EAKlC,YAAY,WAAW;EAIvB,UAAU,uBAAuB,uBAAuB,mBAAmB;;;;UClH5D;WACN;WACA;WACA;WACA;WACA;;KAGC;iBAEI,qBAAqB,gBAAgB;iBAerC,wBAAwB,oBAAoB,iBAAiB,qBAAqB;iBASlF,mBAAmB,OAAO;iBAI1B,sBAAsB,sBAAsB,OAAO"}