@askdkc/dsh-cli 0.11.3

package/node_modules/@dsh-std/command/lib/index.js

@@ -0,0 +1,252 @@
+import { defineCapabilityProtocol } from "@dsh-std/connection";
+import { validatePresentationDescriptor } from "@dsh-std/presentation";
+//#region src/index.ts
+const API_VERSION = "commands.dsh/v1alpha1";
+const KIND = "Command";
+const RUNTIME_KIND = "CommandRuntime";
+function assertCommandHandler(value) {
+	if (!record(value) || typeof value.execute !== "function") throw new TypeError("Command handler must provide execute(input, context)");
+}
+const extensionDefinition = Object.freeze({
+	apiVersion: API_VERSION,
+	kind: KIND,
+	validateMetadata(metadata) {
+		if (!/^[a-z][a-z0-9_-]*$/u.test(metadata.name)) throw new TypeError("Command metadata.name is invalid");
+	},
+	validateSpec(value) {
+		validateNodeSpec(value, "Command spec");
+	}
+});
+/** Host support for accepting and owning Command resource publications. */
+const resourceProtocol = Object.freeze({
+	apiVersion: API_VERSION,
+	kind: KIND,
+	validateRequirement: emptyProtocolSpec,
+	validateSupport: emptyProtocolSpec,
+	negotiate(input) {
+		const issues = [];
+		for (const row of input.requirements) {
+			if (input.supports.some((candidate) => candidate.participant !== row.participant)) continue;
+			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 accepts ${row.requirement.apiVersion} ${row.requirement.kind} resources`
+			}));
+		}
+		return {
+			agreement: Object.freeze({ kind: "ResourcePublication" }),
+			issues: Object.freeze(issues)
+		};
+	}
+});
+const resourceSupport = Object.freeze({
+	apiVersion: API_VERSION,
+	kind: KIND
+});
+/** Callable, resource-keyed command dispatcher implemented once by a Runtime adapter. */
+const runtimeProtocol = defineCapabilityProtocol({
+	apiVersion: API_VERSION,
+	kind: RUNTIME_KIND
+});
+const runtimeSupport = Object.freeze({
+	apiVersion: API_VERSION,
+	kind: RUNTIME_KIND
+});
+/** Bind the typed CommandRuntime operations to a consumer-scoped connection client. */
+function commandRuntime(client) {
+	return Object.freeze({
+		catalog(input, options) {
+			return client.invoke(runtimeSupport, "catalog", validateCatalogInput(input), options);
+		},
+		execute(input, options) {
+			return client.invoke(runtimeSupport, "execute", validateExecutionInput(input), options);
+		}
+	});
+}
+/** Create the sole Runtime-side dispatcher implementation for every Command resource. */
+function commandRuntimeImplementation(participantId, handler) {
+	return Object.freeze({
+		participantId,
+		protocol: runtimeSupport,
+		handle(operation, input, context) {
+			if (operation === "catalog") return handler.catalog(validateCatalogInput(input), context);
+			if (operation === "execute") return handler.execute(validateExecutionInput(input), context);
+			throw new TypeError(`unsupported CommandRuntime operation ${JSON.stringify(operation)}`);
+		}
+	});
+}
+function register(protocols, manifest) {
+	const disposeResource = manifest?.registerExtension(extensionDefinition) ?? (() => void 0);
+	const disposeResourceProtocol = protocols.register(resourceProtocol);
+	const disposeRuntime = protocols.register(runtimeProtocol);
+	return () => {
+		disposeRuntime();
+		disposeResourceProtocol();
+		disposeResource();
+	};
+}
+function emptyProtocolSpec(value) {
+	if (value !== void 0) throw new TypeError("Command resource protocol does not accept spec");
+}
+function record(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function validateCatalogInput(value) {
+	if (!record(value)) throw new TypeError("CommandRuntime.catalog input must be an object");
+	exact(value, ["contextId", "presentation"], "CommandRuntime.catalog input");
+	text(value.contextId, "CommandRuntime.catalog input.contextId");
+	if (value.presentation !== void 0) validatePresentationDescriptor(value.presentation);
+	return Object.freeze({
+		contextId: value.contextId,
+		...value.presentation === void 0 ? {} : { presentation: value.presentation }
+	});
+}
+function validateExecutionInput(value) {
+	if (!record(value)) throw new TypeError("CommandRuntime.execute input must be an object");
+	exact(value, [
+		"contextId",
+		"line",
+		"presentation"
+	], "CommandRuntime.execute input");
+	const catalog = validateCatalogInput({
+		contextId: value.contextId,
+		...value.presentation === void 0 ? {} : { presentation: value.presentation }
+	});
+	text(value.line, "CommandRuntime.execute input.line");
+	return Object.freeze({
+		...catalog,
+		line: value.line
+	});
+}
+function validateNodeSpec(value, label) {
+	if (!record(value)) throw new TypeError(`${label} must be an object`);
+	exact(value, [
+		"title",
+		"titles",
+		"description",
+		"aliases",
+		"arguments",
+		"options",
+		"children"
+	], label);
+	text(value.title, `${label}.title`);
+	if (value.description !== void 0) text(value.description, `${label}.description`);
+	if (value.titles !== void 0) localized(value.titles, `${label}.titles`);
+	if (value.aliases !== void 0) tokens(value.aliases, `${label}.aliases`);
+	if (value.arguments !== void 0) argumentsList(value.arguments, `${label}.arguments`);
+	if (value.options !== void 0) optionsList(value.options, `${label}.options`);
+	if (value.children !== void 0) children(value.children, `${label}.children`);
+}
+function argumentsList(value, label) {
+	if (!Array.isArray(value)) throw new TypeError(`${label} must be an array`);
+	const names = /* @__PURE__ */ new Set();
+	for (const [index, argument] of value.entries()) {
+		const item = `${label}[${index}]`;
+		if (!record(argument)) throw new TypeError(`${item} must be an object`);
+		exact(argument, [
+			"name",
+			"title",
+			"titles",
+			"required",
+			"variadic",
+			"values"
+		], item);
+		token(argument.name, `${item}.name`);
+		if (names.has(argument.name)) throw new TypeError(`${label} contains a duplicate argument`);
+		names.add(argument.name);
+		if (argument.title !== void 0) text(argument.title, `${item}.title`);
+		if (argument.titles !== void 0) localized(argument.titles, `${item}.titles`);
+		if (argument.required !== void 0 && typeof argument.required !== "boolean") throw new TypeError(`${item}.required must be boolean`);
+		if (argument.variadic !== void 0 && typeof argument.variadic !== "boolean") throw new TypeError(`${item}.variadic must be boolean`);
+		if (argument.variadic === true && index !== value.length - 1) throw new TypeError(`${item} must be the last argument when variadic`);
+		if (argument.values !== void 0) values(argument.values, `${item}.values`);
+	}
+}
+function optionsList(value, label) {
+	if (!Array.isArray(value)) throw new TypeError(`${label} must be an array`);
+	const names = /* @__PURE__ */ new Set();
+	for (const [index, option] of value.entries()) {
+		const item = `${label}[${index}]`;
+		if (!record(option)) throw new TypeError(`${item} must be an object`);
+		exact(option, [
+			"names",
+			"title",
+			"titles",
+			"value"
+		], item);
+		text(option.title, `${item}.title`);
+		if (option.titles !== void 0) localized(option.titles, `${item}.titles`);
+		if (!Array.isArray(option.names) || option.names.length === 0) throw new TypeError(`${item}.names must be a non-empty array`);
+		for (const name of option.names) {
+			if (typeof name !== "string" || !/^-{1,2}[^\s-][^\s]*$/u.test(name)) throw new TypeError(`${item}.names contains an invalid option`);
+			if (names.has(name)) throw new TypeError(`${label} contains a duplicate option name`);
+			names.add(name);
+		}
+		if (option.value !== void 0) argumentsList([option.value], `${item}.value`);
+	}
+}
+function children(value, label) {
+	if (!Array.isArray(value)) throw new TypeError(`${label} must be an array`);
+	const names = /* @__PURE__ */ new Set();
+	for (const [index, child] of value.entries()) {
+		const item = `${label}[${index}]`;
+		if (!record(child)) throw new TypeError(`${item} must be an object`);
+		exact(child, ["name", "spec"], item);
+		token(child.name, `${item}.name`);
+		for (const name of [child.name, ...Array.isArray(child.spec?.aliases) ? child.spec.aliases : []]) {
+			if (typeof name !== "string") continue;
+			if (names.has(name)) throw new TypeError(`${label} contains a duplicate name or alias`);
+			names.add(name);
+		}
+		validateNodeSpec(child.spec, `${item}.spec`);
+	}
+}
+function values(value, label) {
+	if (!Array.isArray(value)) throw new TypeError(`${label} must be an array`);
+	const seen = /* @__PURE__ */ new Set();
+	for (const [index, choice] of value.entries()) {
+		const item = `${label}[${index}]`;
+		if (!record(choice)) throw new TypeError(`${item} must be an object`);
+		exact(choice, [
+			"value",
+			"title",
+			"titles"
+		], item);
+		text(choice.value, `${item}.value`);
+		if (seen.has(choice.value)) throw new TypeError(`${label} contains a duplicate value`);
+		seen.add(choice.value);
+		if (choice.title !== void 0) text(choice.title, `${item}.title`);
+		if (choice.titles !== void 0) localized(choice.titles, `${item}.titles`);
+	}
+}
+function localized(value, label) {
+	if (!record(value)) throw new TypeError(`${label} must be an object`);
+	for (const [locale, translation] of Object.entries(value)) {
+		if (locale.trim() === "") throw new TypeError(`${label} contains an empty locale`);
+		text(translation, `${label}.${locale}`);
+	}
+}
+function tokens(value, label) {
+	if (!Array.isArray(value)) throw new TypeError(`${label} must be an array`);
+	const seen = /* @__PURE__ */ new Set();
+	for (const valueItem of value) {
+		token(valueItem, label);
+		if (seen.has(valueItem)) throw new TypeError(`${label} contains a duplicate token`);
+		seen.add(valueItem);
+	}
+}
+function token(value, label) {
+	if (typeof value !== "string" || !/^[^\s/]+$/u.test(value)) throw new TypeError(`${label} must be one token`);
+}
+function text(value, label) {
+	if (typeof value !== "string" || value.trim() === "") throw new TypeError(`${label} must be a non-empty string`);
+}
+function exact(value, allowed, label) {
+	const unknown = Object.keys(value).filter((key) => !allowed.includes(key) && !key.startsWith("x-"));
+	if (unknown.length > 0) throw new TypeError(`${label} contains unknown field ${JSON.stringify(unknown[0])}`);
+}
+//#endregion
+export { API_VERSION, KIND, RUNTIME_KIND, assertCommandHandler, commandRuntime, commandRuntimeImplementation, extensionDefinition, register, resourceProtocol, resourceSupport, runtimeProtocol, runtimeSupport };
+
+//# sourceMappingURL=index.js.map

package/node_modules/@dsh-std/command/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type {\n  ProtocolCatalog,\n  ProtocolDefinition,\n  ProtocolIssue,\n  ProtocolSupport,\n} from '@dsh-std/core'\nimport type { ManifestDefinitionCatalog, ManifestExtension } from '@dsh-std/manifest'\nimport type {\n  CapabilityCall,\n  CapabilityClient,\n  CapabilityHandlerContext,\n  CapabilityImplementation,\n} from '@dsh-std/connection'\nimport { defineCapabilityProtocol } from '@dsh-std/connection'\nimport {\n  validatePresentationDescriptor,\n  type PresentationClients,\n  type PresentationDescriptor,\n} from '@dsh-std/presentation'\n\nexport const API_VERSION = 'commands.dsh/v1alpha1'\nexport const KIND = 'Command'\nexport const RUNTIME_KIND = 'CommandRuntime'\n\n/** Stable reference to one declared command path. */\nexport interface CommandReference {\n  readonly name: string\n  readonly path?: readonly string[]\n}\n\nexport interface CommandValueSpec {\n  readonly value: string\n  readonly title?: string\n  readonly titles?: Readonly<Record<string, string>>\n}\n\nexport interface CommandArgumentSpec {\n  readonly name: string\n  readonly title?: string\n  readonly titles?: Readonly<Record<string, string>>\n  readonly required?: boolean\n  readonly variadic?: boolean\n  readonly values?: readonly CommandValueSpec[]\n}\n\nexport interface CommandOptionSpec {\n  /** Literal spellings such as `--verbose` and `-v`. */\n  readonly names: readonly string[]\n  readonly title: string\n  readonly titles?: Readonly<Record<string, string>>\n  readonly value?: CommandArgumentSpec\n}\n\nexport interface CommandNodeSpec {\n  readonly title: string\n  readonly titles?: Readonly<Record<string, string>>\n  readonly description?: string\n  readonly aliases?: readonly string[]\n  readonly arguments?: readonly CommandArgumentSpec[]\n  readonly options?: readonly CommandOptionSpec[]\n  readonly children?: readonly CommandNode[]\n}\n\nexport interface CommandNode {\n  readonly name: string\n  readonly spec: CommandNodeSpec\n}\n\nexport type CommandSpec = CommandNodeSpec\n\nexport type CommandResource = ManifestExtension<CommandSpec>\n\nexport interface CommandOwnerReference {\n  readonly component: string\n  readonly facet: string\n  readonly participantId?: string\n}\n\nexport interface CommandDescriptor {\n  readonly name: string\n  readonly description: string\n  readonly input?: { readonly hint: string }\n  readonly owner: CommandOwnerReference\n  readonly resource: CommandResource\n  readonly available: boolean\n  readonly missingPresentation: readonly ProtocolSupport[]\n  readonly issues: readonly { readonly code: string; readonly message: string }[]\n}\n\nexport interface CommandCatalog {\n  readonly apiVersion: typeof API_VERSION\n  readonly commands: readonly CommandDescriptor[]\n}\n\nexport interface CommandCatalogInput {\n  /** Opaque execution context selected by the consuming product. */\n  readonly contextId: string\n  readonly presentation?: PresentationDescriptor\n}\n\nexport interface CommandExecutionInput extends CommandCatalogInput {\n  readonly line: string\n}\n\nexport interface CommandExecution {\n  readonly apiVersion: typeof API_VERSION\n  readonly commandId: string\n  readonly result: {\n    readonly kind: 'success' | 'error'\n    readonly text?: string\n    readonly sourceEventSeq?: number\n  }\n}\n\nexport type CommandRuntimeCall =\n  | { readonly operation: 'catalog'; readonly input: CommandCatalogInput; readonly output: CommandCatalog }\n  | { readonly operation: 'execute'; readonly input: CommandExecutionInput; readonly output: CommandExecution | undefined }\n\nexport interface CommandRuntimeClient {\n  catalog(input: CommandCatalogInput, options?: { readonly signal?: AbortSignal }): CapabilityCall<CommandCatalog>\n  execute(input: CommandExecutionInput, options?: { readonly signal?: AbortSignal }): CapabilityCall<CommandExecution | undefined>\n}\n\nexport interface CommandRuntimeHandler {\n  catalog(input: CommandCatalogInput, context: CapabilityHandlerContext): CommandCatalog | Promise<CommandCatalog>\n  execute(\n    input: CommandExecutionInput,\n    context: CapabilityHandlerContext,\n  ): CommandExecution | undefined | Promise<CommandExecution | undefined>\n}\n\nexport interface CommandHandlerInput {\n  readonly rawInput: string\n}\n\nexport interface CommandHandlerContext {\n  readonly signal: AbortSignal\n  /** Host-bound clients for Presentation agreements active in this invocation. */\n  readonly presentation?: PresentationClients\n}\n\nexport interface CommandHandler {\n  execute(\n    input: CommandHandlerInput,\n    context: CommandHandlerContext,\n  ): CommandExecution['result'] | Promise<CommandExecution['result']>\n}\n\nexport function assertCommandHandler(value: unknown): asserts value is CommandHandler {\n  if (!record(value) || typeof value.execute !== 'function') {\n    throw new TypeError('Command handler must provide execute(input, context)')\n  }\n}\n\nexport const extensionDefinition = Object.freeze({\n  apiVersion: API_VERSION,\n  kind: KIND,\n  validateMetadata(metadata: { readonly name: string }): void {\n    if (!/^[a-z][a-z0-9_-]*$/u.test(metadata.name)) throw new TypeError('Command metadata.name is invalid')\n  },\n  validateSpec(value: unknown): void {\n    validateNodeSpec(value, 'Command spec')\n  },\n})\n\n/** Host support for accepting and owning Command resource publications. */\nexport const resourceProtocol: ProtocolDefinition = Object.freeze({\n  apiVersion: API_VERSION,\n  kind: KIND,\n  validateRequirement: emptyProtocolSpec,\n  validateSupport: emptyProtocolSpec,\n  negotiate(input) {\n    const issues: ProtocolIssue[] = []\n    for (const row of input.requirements) {\n      if (input.supports.some(candidate => candidate.participant !== row.participant)) continue\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 accepts ${row.requirement.apiVersion} ${row.requirement.kind} resources`,\n      }))\n    }\n    return {\n      agreement: Object.freeze({ kind: 'ResourcePublication' as const }),\n      issues: Object.freeze(issues),\n    }\n  },\n} satisfies ProtocolDefinition)\n\nexport const resourceSupport: ProtocolSupport = Object.freeze({\n  apiVersion: API_VERSION,\n  kind: KIND,\n})\n\n/** Callable, resource-keyed command dispatcher implemented once by a Runtime adapter. */\nexport const runtimeProtocol = defineCapabilityProtocol({\n  apiVersion: API_VERSION,\n  kind: RUNTIME_KIND,\n})\n\nexport const runtimeSupport: ProtocolSupport = Object.freeze({\n  apiVersion: API_VERSION,\n  kind: RUNTIME_KIND,\n})\n\n/** Bind the typed CommandRuntime operations to a consumer-scoped connection client. */\nexport function commandRuntime(client: CapabilityClient): CommandRuntimeClient {\n  return Object.freeze({\n    catalog(input: CommandCatalogInput, options?: { readonly signal?: AbortSignal }) {\n      return client.invoke<CommandCatalogInput, CommandCatalog>(runtimeSupport, 'catalog', validateCatalogInput(input), options)\n    },\n    execute(input: CommandExecutionInput, options?: { readonly signal?: AbortSignal }) {\n      return client.invoke<CommandExecutionInput, CommandExecution | undefined>(runtimeSupport, 'execute', validateExecutionInput(input), options)\n    },\n  })\n}\n\n/** Create the sole Runtime-side dispatcher implementation for every Command resource. */\nexport function commandRuntimeImplementation(\n  participantId: string,\n  handler: CommandRuntimeHandler,\n): CapabilityImplementation {\n  return Object.freeze({\n    participantId,\n    protocol: runtimeSupport,\n    handle(operation: string, input: unknown, context: CapabilityHandlerContext) {\n      if (operation === 'catalog') return handler.catalog(validateCatalogInput(input), context)\n      if (operation === 'execute') return handler.execute(validateExecutionInput(input), context)\n      throw new TypeError(`unsupported CommandRuntime operation ${JSON.stringify(operation)}`)\n    },\n  })\n}\n\nexport function register(protocols: ProtocolCatalog, manifest?: ManifestDefinitionCatalog): () => void {\n  const disposeResource = manifest?.registerExtension(extensionDefinition) ?? (() => undefined)\n  const disposeResourceProtocol = protocols.register(resourceProtocol)\n  const disposeRuntime = protocols.register(runtimeProtocol)\n  return () => {\n    disposeRuntime()\n    disposeResourceProtocol()\n    disposeResource()\n  }\n}\n\nfunction emptyProtocolSpec(value: unknown): undefined {\n  if (value !== undefined) throw new TypeError('Command resource protocol does not accept spec')\n  return undefined\n}\n\nfunction record(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nfunction validateCatalogInput(value: unknown): CommandCatalogInput {\n  if (!record(value)) throw new TypeError('CommandRuntime.catalog input must be an object')\n  exact(value, ['contextId', 'presentation'], 'CommandRuntime.catalog input')\n  text(value.contextId, 'CommandRuntime.catalog input.contextId')\n  if (value.presentation !== undefined) validatePresentationDescriptor(value.presentation)\n  return Object.freeze({\n    contextId: value.contextId as string,\n    ...(value.presentation === undefined ? {} : { presentation: value.presentation as PresentationDescriptor }),\n  })\n}\n\nfunction validateExecutionInput(value: unknown): CommandExecutionInput {\n  if (!record(value)) throw new TypeError('CommandRuntime.execute input must be an object')\n  exact(value, ['contextId', 'line', 'presentation'], 'CommandRuntime.execute input')\n  const catalog = validateCatalogInput({\n    contextId: value.contextId,\n    ...(value.presentation === undefined ? {} : { presentation: value.presentation }),\n  })\n  text(value.line, 'CommandRuntime.execute input.line')\n  return Object.freeze({ ...catalog, line: value.line as string })\n}\n\nfunction validateNodeSpec(value: unknown, label: string): void {\n  if (!record(value)) throw new TypeError(`${label} must be an object`)\n  exact(value, ['title', 'titles', 'description', 'aliases', 'arguments', 'options', 'children'], label)\n  text(value.title, `${label}.title`)\n  if (value.description !== undefined) text(value.description, `${label}.description`)\n  if (value.titles !== undefined) localized(value.titles, `${label}.titles`)\n  if (value.aliases !== undefined) tokens(value.aliases, `${label}.aliases`)\n  if (value.arguments !== undefined) argumentsList(value.arguments, `${label}.arguments`)\n  if (value.options !== undefined) optionsList(value.options, `${label}.options`)\n  if (value.children !== undefined) children(value.children, `${label}.children`)\n}\n\nfunction argumentsList(value: unknown, label: string): void {\n  if (!Array.isArray(value)) throw new TypeError(`${label} must be an array`)\n  const names = new Set<string>()\n  for (const [index, argument] of value.entries()) {\n    const item = `${label}[${index}]`\n    if (!record(argument)) throw new TypeError(`${item} must be an object`)\n    exact(argument, ['name', 'title', 'titles', 'required', 'variadic', 'values'], item)\n    token(argument.name, `${item}.name`)\n    if (names.has(argument.name as string)) throw new TypeError(`${label} contains a duplicate argument`)\n    names.add(argument.name as string)\n    if (argument.title !== undefined) text(argument.title, `${item}.title`)\n    if (argument.titles !== undefined) localized(argument.titles, `${item}.titles`)\n    if (argument.required !== undefined && typeof argument.required !== 'boolean') throw new TypeError(`${item}.required must be boolean`)\n    if (argument.variadic !== undefined && typeof argument.variadic !== 'boolean') throw new TypeError(`${item}.variadic must be boolean`)\n    if (argument.variadic === true && index !== value.length - 1) throw new TypeError(`${item} must be the last argument when variadic`)\n    if (argument.values !== undefined) values(argument.values, `${item}.values`)\n  }\n}\n\nfunction optionsList(value: unknown, label: string): void {\n  if (!Array.isArray(value)) throw new TypeError(`${label} must be an array`)\n  const names = new Set<string>()\n  for (const [index, option] of value.entries()) {\n    const item = `${label}[${index}]`\n    if (!record(option)) throw new TypeError(`${item} must be an object`)\n    exact(option, ['names', 'title', 'titles', 'value'], item)\n    text(option.title, `${item}.title`)\n    if (option.titles !== undefined) localized(option.titles, `${item}.titles`)\n    if (!Array.isArray(option.names) || option.names.length === 0) throw new TypeError(`${item}.names must be a non-empty array`)\n    for (const name of option.names) {\n      if (typeof name !== 'string' || !/^-{1,2}[^\\s-][^\\s]*$/u.test(name)) throw new TypeError(`${item}.names contains an invalid option`)\n      if (names.has(name)) throw new TypeError(`${label} contains a duplicate option name`)\n      names.add(name)\n    }\n    if (option.value !== undefined) argumentsList([option.value], `${item}.value`)\n  }\n}\n\nfunction children(value: unknown, label: string): void {\n  if (!Array.isArray(value)) throw new TypeError(`${label} must be an array`)\n  const names = new Set<string>()\n  for (const [index, child] of value.entries()) {\n    const item = `${label}[${index}]`\n    if (!record(child)) throw new TypeError(`${item} must be an object`)\n    exact(child, ['name', 'spec'], item)\n    token(child.name, `${item}.name`)\n    for (const name of [child.name, ...(Array.isArray((child.spec as Record<string, unknown> | undefined)?.aliases) ? (child.spec as { aliases: unknown[] }).aliases : [])]) {\n      if (typeof name !== 'string') continue\n      if (names.has(name)) throw new TypeError(`${label} contains a duplicate name or alias`)\n      names.add(name)\n    }\n    validateNodeSpec(child.spec, `${item}.spec`)\n  }\n}\n\nfunction values(value: unknown, label: string): void {\n  if (!Array.isArray(value)) throw new TypeError(`${label} must be an array`)\n  const seen = new Set<string>()\n  for (const [index, choice] of value.entries()) {\n    const item = `${label}[${index}]`\n    if (!record(choice)) throw new TypeError(`${item} must be an object`)\n    exact(choice, ['value', 'title', 'titles'], item)\n    text(choice.value, `${item}.value`)\n    if (seen.has(choice.value as string)) throw new TypeError(`${label} contains a duplicate value`)\n    seen.add(choice.value as string)\n    if (choice.title !== undefined) text(choice.title, `${item}.title`)\n    if (choice.titles !== undefined) localized(choice.titles, `${item}.titles`)\n  }\n}\n\nfunction localized(value: unknown, label: string): void {\n  if (!record(value)) throw new TypeError(`${label} must be an object`)\n  for (const [locale, translation] of Object.entries(value)) {\n    if (locale.trim() === '') throw new TypeError(`${label} contains an empty locale`)\n    text(translation, `${label}.${locale}`)\n  }\n}\n\nfunction tokens(value: unknown, label: string): void {\n  if (!Array.isArray(value)) throw new TypeError(`${label} must be an array`)\n  const seen = new Set<string>()\n  for (const valueItem of value) {\n    token(valueItem, label)\n    if (seen.has(valueItem as string)) throw new TypeError(`${label} contains a duplicate token`)\n    seen.add(valueItem as string)\n  }\n}\n\nfunction token(value: unknown, label: string): void {\n  if (typeof value !== 'string' || !/^[^\\s/]+$/u.test(value)) throw new TypeError(`${label} must be one token`)\n}\n\nfunction text(value: unknown, label: string): void {\n  if (typeof value !== 'string' || value.trim() === '') throw new TypeError(`${label} must be a non-empty string`)\n}\n\nfunction exact(value: Record<string, unknown>, allowed: readonly string[], label: string): void {\n  const unknown = Object.keys(value).filter(key => !allowed.includes(key) && !key.startsWith('x-'))\n  if (unknown.length > 0) throw new TypeError(`${label} contains unknown field ${JSON.stringify(unknown[0])}`)\n}\n"],"mappings":"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"}

package/node_modules/@dsh-std/command/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@dsh-std/command",
+  "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" } },
+  "files": ["lib", "CHANGELOG.md"],
+  "scripts": {
+    "build": "pnpm run typecheck && tsdown",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests"
+  },
+  "dependencies": {
+    "@dsh-std/core": "workspace:*",
+    "@dsh-std/manifest": "workspace:*",
+    "@dsh-std/connection": "workspace:*",
+    "@dsh-std/presentation": "workspace:*"
+  },
+  "engines": { "node": "^22.19 || >=24" }
+}

package/node_modules/@dsh-std/connection/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+Changes to `@dsh-std/connection` are recorded here.
+
+## 0.1.0 (draft)
+
+- Defined connection services, endpoint views, participant publication, capability bindings, and attachments.
+- Added an in-memory transport for protocol conformance and host integration tests.

package/node_modules/@dsh-std/connection/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/node_modules/@dsh-std/connection/README.md

@@ -0,0 +1,42 @@
+# @dsh-std/connection
+
+English | [中文](README.zh.md)
+
+The proposed design is documented in [Endpoint Connection](../../docs/proposals/endpoint-connection.zh.md). It separates the application-facing `ConnectionService` from the Connection Host provider SPI. The remainder of this page describes the current reference implementation, which does not yet complete that split.
+
+Host-provided communication service, two-endpoint capability negotiation, and implementation-neutral invocation for the DSH Standard.
+
+## Endpoint offers
+
+An endpoint offer contains an endpoint identity, a revision, and the live participant declarations admitted by endpoint policy. It carries no component manifests, installation inventory, or plugin registry.
+
+`resolveConnection()` passes both sets of declarations to a caller-owned `ProtocolCatalog`. Each protocol definition owns its negotiation and may place invocation bindings in its agreement; connection does not impose consumer/provider semantics on every protocol. `defineCapabilityProtocol()` is an explicit helper for domain protocols that do use RPC-shaped bindings.
+
+Each invocation binding is participant-scoped and plan-revision-scoped. A client for one participant cannot discover or invoke bindings granted to another participant.
+
+## Current reference API
+
+`StandardConnection` exposes endpoint identities, the active plan, consumer-scoped clients, plan-change observation, and close. `CapabilityClient.invoke()` returns an invocation id, a result promise, an asynchronous progress stream, and cancellation. Domain protocol packages own operation names and input, output, and progress values.
+
+`ConnectionBroker` selects one registered `ConnectionConnector` for an implementation-neutral target URI. Zero matches and multiple matches are both explicit errors. The broker does not expose the selected connector type through `StandardConnection`.
+
+These types are an early reference implementation. They do not require a TUI, Web UI, GUI, or business plugin to register and operate its own connector. The protocol direction places the broker, connector/provider registry, carrier, and wire behind a Connection Host's `ConnectionService`. A consumer submits a target and uses scoped typed clients for the negotiated protocols.
+
+A Connection Host may install or discover a remote service, own authentication, ports, forwarding and reconnection, and produce the `StandardConnection`. An SSH target facet contributes resolution and bootstrap integration while system OpenSSH or another provider may supply the physical SSH implementation. Applications do not observe the selected provider, ports, credentials, or wire.
+
+## Lifecycle
+
+Renegotiation creates a complete new plan revision and publishes it atomically. An invocation admitted under the old revision retains its binding until settlement; later invocations use the new revision. Closing a connection cancels active work and rejects new work with `connection-closed`.
+
+Transport implementations must preserve invocation isolation, progress order, cancellation, and the error classification exposed by `ConnectionInvocationError`. They are also responsible for authenticating the peer and preventing one connection from reusing another connection's grants.
+
+## Reference implementation
+
+The `@dsh-std/connection/memory` export provides a process-local implementation for tests, adapters, and conformance experiments. It demonstrates symmetric calls, progress, cancellation, isolation, and renegotiation. It is not a required carrier or a wire-format specification.
+
+## Known Limitations and Deferred Work
+
+- The consumer-facing `ConnectionService` and Host provider SPI are not implemented in the current code yet.
+- The package does not yet standardize discovery, authentication, encryption, reconnect policy, framing, or serialization.
+- A connection has exactly two endpoints in `v1alpha1`; multi-party routing is composed from separate connections.
+- The capability helper requires one peer provider by default. Protocols that allow multiple providers must opt into and define that behavior explicitly.

package/node_modules/@dsh-std/connection/README.zh.md

@@ -0,0 +1,42 @@
+# @dsh-std/connection
+
+[English](README.md) | 中文
+
+拟议设计见 [Endpoint Connection](../../docs/proposals/endpoint-connection.zh.md)。规范把普通应用使用的 `ConnectionService` 与 Connection Host 的 provider SPI 分开；本页其余内容描述尚未完成该分层的当前参考实现。
+
+DSH Standard 的宿主通信 service、双端点能力协商与实现无关调用。
+
+## 端点提议
+
+端点提议包含端点身份、修订号，以及经端点 policy 裁剪后的 live participant declarations。它不携带 component manifests、安装记录或插件注册表。
+
+`resolveConnection()` 把两端 declarations 交给调用方提供的 `ProtocolCatalog`。每份协议 definition 决定如何协商，并可在 agreement 中产生调用绑定；connection 不为所有协议预设 consumer/provider 语义。内置的 `defineCapabilityProtocol()` 是需要 RPC 绑定的领域协议可显式采用的辅助定义。
+
+每项调用绑定都限定于消费 participant 和方案修订版。一个 participant 的客户端不能发现或调用授予另一 participant 的绑定。
+
+## 当前参考 API
+
+`StandardConnection` 暴露端点身份、当前方案、按消费方隔离的客户端、方案变更观察与关闭操作。`CapabilityClient.invoke()` 返回调用 id、结果 Promise、异步进度流与取消操作。领域协议包拥有操作名称以及输入、输出和进度值的语义。
+
+`ConnectionBroker` 根据与实现无关的目标 URI，从已注册 `ConnectionConnector` 中选择唯一实现。零个匹配与多个匹配都是明确错误。broker 不会通过 `StandardConnection` 暴露选中的 connector 类型。
+
+这些类型是早期参考实现，不表示 TUI、Web、GUI 或业务插件应自行注册 connector。规范方向是由 Connection Host 把 broker、connector/provider、carrier 和 wire 封装为 `ConnectionService`；consumer 只提交 target，并通过 scoped typed client 使用已协商协议。
+
+Connection Host 负责安装或发现远端服务、认证、端口与转发、重连和 `StandardConnection`。SSH target facet 可以贡献解析与 bootstrap 集成，物理 SSH 则可由系统 OpenSSH 或独立 provider 完成。应用不会看到所选 provider、端口、凭据或 wire。
+
+## 生命周期
+
+重新协商会生成完整的新方案修订版，并原子发布。旧修订版已经接纳的调用保留其绑定直至结束；后续调用使用新修订版。关闭连接会取消活跃工作，并以 `connection-closed` 拒绝新工作。
+
+传输实现必须保持调用隔离、进度顺序、取消语义和 `ConnectionInvocationError` 暴露的错误分类。实现还负责认证对端，并阻止一条连接复用另一条连接的授权。
+
+## 参考实现
+
+`@dsh-std/connection/memory` 导出用于测试、适配器和一致性实验的进程内实现。它演示双向调用、进度、取消、隔离和重新协商，但不是强制承载方式或线协议规范。
+
+## 已知限制与暂缓事项
+
+- consumer-facing `ConnectionService` 与 Host provider SPI 尚未在当前代码中实现。
+- 本包尚未标准化发现、认证、加密、重连策略、封帧或序列化。
+- `v1alpha1` 的一条连接恰好包含两个端点；多方路由由多条独立连接组合。
+- Capability helper 默认要求唯一对端提供方；需要多提供方的协议必须明确选择其规则。

package/node_modules/@dsh-std/connection/lib/connection-CdGcSQnu.d.ts

@@ -0,0 +1,125 @@
+import { ApiReference, NegotiatedProtocol, ProtocolCatalog, ProtocolDeclaration, ProtocolRequirement, ProtocolSupport } from "@dsh-std/core";
+//#region src/model.d.ts
+declare const CONNECTION_API_VERSION = "connection.dsh/v1alpha1";
+interface EndpointIdentity {
+  readonly id: string;
+  readonly instanceId: string;
+}
+interface EndpointOffer {
+  readonly apiVersion: typeof CONNECTION_API_VERSION;
+  readonly kind: 'ConnectionOffer';
+  readonly endpoint: EndpointIdentity;
+  readonly revision: number;
+  readonly declarations: readonly ProtocolDeclaration[];
+}
+interface ConnectionEndpointReference extends EndpointIdentity {}
+interface CapabilityParticipant {
+  readonly endpoint: ConnectionEndpointReference;
+  readonly participantId: string;
+}
+interface CapabilityBinding {
+  readonly bindingId: string;
+  readonly agreementId: string;
+  readonly planRevision: number;
+  readonly consumer: CapabilityParticipant;
+  readonly provider: CapabilityParticipant;
+  readonly requirement: ProtocolRequirement;
+  readonly support: ProtocolSupport;
+}
+interface ConnectionIssue {
+  readonly severity: 'error' | 'warning';
+  readonly code: string;
+  readonly participant?: CapabilityParticipant;
+  readonly path?: string;
+  readonly message: string;
+}
+interface ConnectionPlan {
+  readonly apiVersion: typeof CONNECTION_API_VERSION;
+  readonly kind: 'ConnectionAgreement';
+  readonly connectionId: string;
+  readonly revision: number;
+  readonly digest: string;
+  readonly offers: readonly {
+    readonly endpoint: ConnectionEndpointReference;
+    readonly revision: number;
+  }[];
+  readonly compatible: boolean;
+  readonly protocols: readonly NegotiatedProtocol[];
+  readonly bindings: readonly CapabilityBinding[];
+  readonly issues: readonly ConnectionIssue[];
+}
+interface ResolveConnectionOptions {
+  readonly connectionId: string;
+  readonly revision: number;
+  readonly protocols: ProtocolCatalog;
+  readonly policy?: unknown;
+}
+/** Policy envelope supplied to definitions while evaluating a pair of endpoint offers. */
+interface ConnectionNegotiationPolicy {
+  readonly endpointByParticipant: Readonly<Record<string, string>>;
+  readonly protocol?: unknown;
+}
+declare function createEndpointOffer(endpoint: EndpointIdentity, revision: number, declarations: readonly ProtocolDeclaration[]): EndpointOffer;
+declare function validateEndpointOffer(offer: EndpointOffer): void;
+declare function freezeEndpoint(endpoint: EndpointIdentity): ConnectionEndpointReference;
+declare function validatePlanCoordinates(connectionId: string, revision: number): void;
+//#endregion
+//#region src/connection.d.ts
+interface CapabilityHandlerContext<TProgress = unknown> {
+  readonly connectionId: string;
+  readonly planRevision: number;
+  readonly invocationId: string;
+  readonly binding: CapabilityBinding;
+  readonly signal: AbortSignal;
+  progress(value: TProgress): void;
+}
+type CapabilityHandler<TInput = unknown, TOutput = unknown, TProgress = unknown> = (operation: string, input: TInput, context: CapabilityHandlerContext<TProgress>) => TOutput | Promise<TOutput>;
+interface CapabilityImplementation<TInput = unknown, TOutput = unknown, TProgress = unknown> {
+  readonly participantId: string;
+  readonly protocol: ProtocolSupport;
+  readonly handle: CapabilityHandler<TInput, TOutput, TProgress>;
+}
+interface CapabilityDispatch<TInput = unknown, TProgress = unknown> {
+  readonly connectionId: string;
+  readonly planRevision: number;
+  readonly invocationId: string;
+  readonly binding: CapabilityBinding;
+  readonly operation: string;
+  readonly input: TInput;
+  readonly signal: AbortSignal;
+  progress(value: TProgress): void;
+}
+interface ConnectionEndpoint {
+  readonly offer: EndpointOffer;
+  dispatch<TInput = unknown, TOutput = unknown, TProgress = unknown>(invocation: CapabilityDispatch<TInput, TProgress>): Promise<TOutput>;
+  onOfferChange(listener: (offer: EndpointOffer) => void): () => void;
+}
+interface CapabilityCall<TOutput = unknown, TProgress = unknown> {
+  readonly invocationId: string;
+  readonly result: Promise<TOutput>;
+  readonly progress: AsyncIterable<TProgress>;
+  cancel(reason?: string): void;
+}
+interface CapabilityClient {
+  readonly participantId: string;
+  binding(reference: ApiReference): CapabilityBinding | undefined;
+  invoke<TInput = unknown, TOutput = unknown, TProgress = unknown>(reference: ApiReference, operation: string, input: TInput, options?: {
+    readonly signal?: AbortSignal;
+  }): CapabilityCall<TOutput, TProgress>;
+}
+interface StandardConnection {
+  readonly id: string;
+  readonly local: ConnectionEndpointReference;
+  readonly remote: ConnectionEndpointReference;
+  readonly plan: ConnectionPlan;
+  client(participantId: string): CapabilityClient;
+  onPlanChange(listener: (plan: ConnectionPlan) => void): () => void;
+  close(reason?: string): void | Promise<void>;
+}
+declare class ConnectionInvocationError extends Error {
+  readonly code: 'connection-closed' | 'capability-unbound' | 'handler-missing' | 'cancelled' | 'handler-failed';
+  constructor(code: 'connection-closed' | 'capability-unbound' | 'handler-missing' | 'cancelled' | 'handler-failed', message: string, options?: ErrorOptions);
+}
+//#endregion
+export { validatePlanCoordinates as C, validateEndpointOffer as S, EndpointIdentity as _, CapabilityHandlerContext as a, createEndpointOffer as b, ConnectionInvocationError as c, CapabilityBinding as d, CapabilityParticipant as f, ConnectionPlan as g, ConnectionNegotiationPolicy as h, CapabilityHandler as i, StandardConnection as l, ConnectionIssue as m, CapabilityClient as n, CapabilityImplementation as o, ConnectionEndpointReference as p, CapabilityDispatch as r, ConnectionEndpoint as s, CapabilityCall as t, CONNECTION_API_VERSION as u, EndpointOffer as v, freezeEndpoint as x, ResolveConnectionOptions as y };
+//# sourceMappingURL=connection-CdGcSQnu.d.ts.map

package/node_modules/@dsh-std/connection/lib/connection-CdGcSQnu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-CdGcSQnu.d.ts","names":[],"sources":["../src/model.ts","../src/connection.ts"],"mappings":";;cASa;UAEI;WACN;WACA;;UAGM;WACN,mBAAmB;WACnB;WACA,UAAU;WACV;WACA,uBAAuB;;UAGjB,oCAAoC;UAEpC;WACN,UAAU;WACV;;UAGM;WACN;WACA;WACA;WACA,UAAU;WACV,UAAU;WACV,aAAa;WACb,SAAS;;UAGH;WACN;WACA;WACA,cAAc;WACd;WACA;;UAGM;WACN,mBAAmB;WACnB;WACA;WACA;WACA;WACA;aACE,UAAU;aACV;;WAEF;WACA,oBAAoB;WACpB,mBAAmB;WACnB,iBAAiB;;UAGX;WACN;WACA;WACA,WAAW;WACX;;;UAIM;WACN,uBAAuB,SAAS;WAChC;;iBAGK,oBACd,UAAU,kBACV,kBACA,uBAAuB,wBACtB;iBAkBa,sBAAsB,OAAO;iBAa7B,eAAe,UAAU,mBAAmB;iBAI5C,wBAAwB,sBAAsB;;;UClH7C,yBAAyB;WAC/B;WACA;WACA;WACA,SAAS;WACT,QAAQ;EACjB,SAAS,OAAO;;KAGN,kBAAkB,kBAAkB,mBAAmB,wBACjE,mBAAmB,OAAO,QAAQ,SAAS,yBAAyB,eACjE,UAAU,QAAQ;UAEN,yBAAyB,kBAAkB,mBAAmB;WACpE;WACA,UAAU;WACV,QAAQ,kBAAkB,QAAQ,SAAS;;UAGrC,mBAAmB,kBAAkB;WAC3C;WACA;WACA;WACA,SAAS;WACT;WACA,OAAO;WACP,QAAQ;EACjB,SAAS,OAAO;;UAGD;WACN,OAAO;EAChB,SAAS,kBAAkB,mBAAmB,qBAAqB,YAAY,mBAAmB,QAAQ,aAAa,QAAQ;EAC/H,cAAc,WAAW,OAAO;;UAGjB,eAAe,mBAAmB;WACxC;WACA,QAAQ,QAAQ;WAChB,UAAU,cAAc;EACjC,OAAO;;UAGQ;WACN;EACT,QAAQ,WAAW,eAAe;EAClC,OAAO,kBAAkB,mBAAmB,qBAC1C,WAAW,cACX,mBACA,OAAO,QACP;aAAqB,SAAS;MAC7B,eAAe,SAAS;;UAGZ;WACN;WACA,OAAO;WACP,QAAQ;WACR,MAAM;EACf,OAAO,wBAAwB;EAC/B,aAAa,WAAW,MAAM;EAC9B,MAAM,yBAAyB;;cAGpB,kCAAkC;WAElC;EAAA,YAAA,uGACT,iBACA,UAAU"}