@askdkc/dsh-cli 0.11.3

package/node_modules/@dsh-std/messages/schema/message-observer-envelope-0.15.schema.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:dsh-std:messages:message-observer-envelope:0.15",
+  "title": "MessageObserver envelope v0.15",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["eventType", "eventVersion", "eventId", "scope", "sequence", "privacyClass", "summary", "payload"],
+  "properties": {
+    "eventType": { "const": "messages.observe" },
+    "eventVersion": { "const": "0.15" },
+    "eventId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]+$" },
+    "scope": { "type": "string", "minLength": 1, "maxLength": 256 },
+    "sequence": { "type": "integer", "minimum": 0 },
+    "privacyClass": { "enum": ["public", "internal", "sensitive"] },
+    "summary": { "type": "string", "maxLength": 1024 },
+    "payload": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "content"],
+      "properties": {
+        "kind": { "enum": ["message.created", "message.received", "message.sent"] },
+        "messageId": { "type": "string", "maxLength": 256 },
+        "author": { "type": "string", "maxLength": 256 },
+        "content": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/contentBlock" } },
+        "truncated": { "type": "boolean" }
+      }
+    }
+  },
+  "$defs": {
+    "contentBlock": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "text"],
+          "properties": {
+            "type": { "const": "text" },
+            "text": { "type": "string", "maxLength": 262144 }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "data", "mimeType"],
+          "properties": {
+            "type": { "const": "image" },
+            "data": { "type": "string", "contentEncoding": "base64" },
+            "mimeType": { "type": "string", "pattern": "^[A-Za-z0-9.+-]+/[A-Za-z0-9.+-]+$" }
+          }
+        }
+      ]
+    }
+  }
+}

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

@@ -0,0 +1,9 @@
+# Changelog
+
+Changes to `@dsh-std/presentation` are recorded here.
+
+## 0.1.0 (draft)
+
+- Defined invocation-scoped `OpenExternal`, `CopyText`, `Notification`, `UserInteraction`, and `ExternalRedirect` capabilities.
+- Added typed question, approval, secret-input, and one-shot loopback redirect flows.
+- Added optional exact loopback callback URIs with explicit-port validation, no-substitution semantics, and address-in-use failure reporting.

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

@@ -0,0 +1,27 @@
+# @dsh-std/presentation
+
+English | [中文](README.zh.md)
+
+Small, invocation-scoped operations that a runtime facet may request from a connected presentation client.
+
+## Contracts
+
+`v1alpha1` defines five independent presentation protocols:
+
+- `OpenExternal` asks the client to open an HTTP or HTTPS URI.
+- `CopyText` asks the client to copy text to its clipboard.
+- `Notification` asks the client to display informational, warning, or error text.
+- `UserInteraction` carries structured questions, one-invocation approvals, and secret input.
+- `ExternalRedirect` receives a one-shot HTTP redirect on the user side and may reserve an exact loopback URI requested by the consumer.
+
+A facet declares each required operation in its manifest. A client advertises only the protocols it can perform for the current connection. The runtime admits the command only when all required presentation protocols are available, and it accepts only operations declared by that facet. Operations belong to the active invocation; they are not a global event bus or a persistent client capability.
+
+The package provides protocol definitions, invocation-scoped typed client and implementation binders, and request/result validation. The Host binds request identity and origin when it creates a client; consumers supply only operation-specific input. It does not perform UI work. Native applications, terminals, browsers, editors, and automation clients may implement different subsets.
+
+Simple operations are available from `@dsh-std/presentation/operations`, while interaction types are available from `@dsh-std/presentation/interaction`. A Host-provided `PresentationDescriptor` is only a projection of active agreements for the current invocation; it is not a separate Snapshot protocol.
+
+## Known Limitations and Deferred Work
+
+- `OpenExternal` intentionally rejects non-HTTP(S) URI schemes.
+- Clipboard reads, arbitrary UI trees, and file pickers are not defined.
+- Delivery acknowledgement and durable replay are outside `v1alpha1`.

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

@@ -0,0 +1,29 @@
+# @dsh-std/presentation
+
+[English](README.md) | 中文
+
+拟议设计见 [Presentation Operations](../../docs/proposals/presentation.zh.md)。
+
+运行时插件可以向已连接表现客户端请求的小型、调用作用域内操作。
+
+## 协议
+
+`v1alpha1` 定义五个彼此独立的表现协议：
+
+- `OpenExternal` 请求客户端打开 HTTP 或 HTTPS URI；
+- `CopyText` 请求客户端把文本复制到剪贴板；
+- `Notification` 请求客户端显示信息、警告或错误文本；
+- `UserInteraction` 承载结构化 question、单次 approval 和 secret input。
+- `ExternalRedirect` 在用户侧接收一次 HTTP redirect，并可按调用方要求独占精确的 loopback URI。
+
+Facet 在清单中声明每项所需操作。客户端只为当前连接声明自己能够执行的协议。仅当全部必需表现协议可用时，运行时才接纳命令；运行时也只接受该 facet 事先声明的操作。操作属于当前调用，不是全局事件总线或持久客户端能力。
+
+本包提供 protocol definitions、调用作用域内的类型化 client/implementation binder、请求与结果校验。Host 创建 client 时绑定 request identity 与 origin，Consumer 只提交 operation 自有输入。它不执行 UI 工作；原生应用、终端、浏览器、编辑器和自动化客户端可以实现不同子集。
+
+普通操作可以从 `@dsh-std/presentation/operations` 导入，交互协议可以从 `@dsh-std/presentation/interaction` 导入。Host 交给领域调用的 `PresentationDescriptor` 只是当前 invocation active agreements 的投影，不是额外的 Snapshot 协议。
+
+## 已知限制与暂缓事项
+
+- `OpenExternal` 有意拒绝非 HTTP(S) URI scheme。
+- 协议不定义剪贴板读取、任意 UI tree 或文件选择器。
+- `v1alpha1` 不包含投递确认与持久回放。

package/node_modules/@dsh-std/presentation/lib/callback.d.ts

@@ -0,0 +1,2 @@
+import { EXTERNAL_REDIRECT_KIND, ExternalRedirectCall, ExternalRedirectClient, ExternalRedirectHandler, ExternalRedirectInput, ExternalRedirectReady, ExternalRedirectRequest, ExternalRedirectValue, externalRedirectClient, externalRedirectImplementation, externalRedirectProtocol, externalRedirectSupport, validateExternalRedirectReady, validateExternalRedirectRequest, validateExternalRedirectResult } from "./index.js";
+export { EXTERNAL_REDIRECT_KIND, ExternalRedirectCall, ExternalRedirectClient, ExternalRedirectHandler, ExternalRedirectInput, ExternalRedirectReady, ExternalRedirectRequest, ExternalRedirectValue, externalRedirectClient, externalRedirectImplementation, externalRedirectProtocol, externalRedirectSupport, validateExternalRedirectReady, validateExternalRedirectRequest, validateExternalRedirectResult };

package/node_modules/@dsh-std/presentation/lib/callback.js

@@ -0,0 +1,179 @@
+import { defineCapabilityProtocol } from "@dsh-std/connection";
+//#region src/callback.ts
+const EXTERNAL_REDIRECT_KIND = "ExternalRedirect";
+const emptySpec = (value) => {
+	if (value !== void 0) throw new TypeError("ExternalRedirect does not accept spec in v1alpha1");
+};
+const externalRedirectProtocol = defineCapabilityProtocol({
+	apiVersion: "presentation.dsh/v1alpha1",
+	kind: EXTERNAL_REDIRECT_KIND,
+	validateRequirement: emptySpec,
+	validateSupport: emptySpec
+});
+const externalRedirectSupport = Object.freeze({
+	apiVersion: "presentation.dsh/v1alpha1",
+	kind: EXTERNAL_REDIRECT_KIND
+});
+function externalRedirectClient(client, scope) {
+	validateScope(scope);
+	return Object.freeze({ receive(input = {}, options) {
+		const request = Object.freeze({
+			...input,
+			mode: input.mode ?? "http-get",
+			requestId: nextRequestId(scope),
+			invocationId: scope.invocationId,
+			origin: scope.origin,
+			...scope.deadline === void 0 ? {} : { deadline: scope.deadline }
+		});
+		validateExternalRedirectRequest(request);
+		const call = client.invoke(externalRedirectSupport, "receive", request, options);
+		return Object.freeze({
+			invocationId: call.invocationId,
+			ready: firstReady(call.progress),
+			result: call.result.then(validateExternalRedirectResult),
+			cancel: (reason) => call.cancel(reason)
+		});
+	} });
+}
+function externalRedirectImplementation(participantId, handler) {
+	return Object.freeze({
+		participantId,
+		protocol: externalRedirectSupport,
+		async handle(operation, input, context) {
+			if (operation !== "receive") throw new TypeError(`unsupported ExternalRedirect operation ${JSON.stringify(operation)}`);
+			validateExternalRedirectRequest(input);
+			let announced = false;
+			const guardedContext = Object.freeze({
+				...context,
+				progress(value) {
+					if (announced) throw new TypeError("ExternalRedirect provider emitted more than one ready event");
+					validateExternalRedirectReady(value);
+					if (input.exactRedirectUri !== void 0 && value.redirectUri !== input.exactRedirectUri) throw new TypeError("ExternalRedirect provider did not announce the exact requested redirect URI");
+					announced = true;
+					context.progress(value);
+				}
+			});
+			const result = validateExternalRedirectResult(await handler.receive(input, guardedContext));
+			if (result.status === "submitted" && !announced) throw new TypeError("ExternalRedirect provider submitted a result before announcing redirectUri");
+			return result;
+		}
+	});
+}
+function validateExternalRedirectRequest(value) {
+	const request = exactRecord(value, [
+		"requestId",
+		"invocationId",
+		"origin",
+		"deadline",
+		"mode",
+		"exactRedirectUri"
+	], [
+		"requestId",
+		"invocationId",
+		"origin",
+		"mode"
+	], "ExternalRedirect request");
+	nonEmpty(request.requestId, "ExternalRedirect request.requestId");
+	nonEmpty(request.invocationId, "ExternalRedirect request.invocationId");
+	nonEmpty(request.origin, "ExternalRedirect request.origin");
+	if (request.mode !== "http-get") throw new TypeError("ExternalRedirect request.mode must be \"http-get\"");
+	if (request.exactRedirectUri !== void 0) validateLoopbackUri(request.exactRedirectUri, "ExternalRedirect request.exactRedirectUri", true);
+	dateTime(request.deadline, "ExternalRedirect request.deadline");
+}
+function validateExternalRedirectReady(value) {
+	const ready = exactRecord(value, [
+		"type",
+		"redirectUri",
+		"expiresAt"
+	], ["type", "redirectUri"], "ExternalRedirect ready");
+	if (ready.type !== "ready") throw new TypeError("ExternalRedirect ready.type must be \"ready\"");
+	validateLoopbackUri(ready.redirectUri, "ExternalRedirect ready.redirectUri", false);
+	dateTime(ready.expiresAt, "ExternalRedirect ready.expiresAt");
+}
+function validateExternalRedirectResult(value) {
+	if (!record(value)) throw new TypeError("ExternalRedirect result must be an object");
+	if (value.status === "submitted") {
+		const submitted = exactRecord(exactRecord(value, ["status", "value"], ["status", "value"], "ExternalRedirect result").value, ["query"], ["query"], "ExternalRedirect value");
+		if (!record(submitted.query)) throw new TypeError("ExternalRedirect value.query must be an object");
+		const query = {};
+		for (const [name, entries] of Object.entries(submitted.query)) {
+			if (name === "" || !Array.isArray(entries) || entries.some((entry) => typeof entry !== "string")) throw new TypeError("ExternalRedirect value.query must map non-empty names to string arrays");
+			query[name] = Object.freeze([...entries]);
+		}
+		return Object.freeze({
+			status: "submitted",
+			value: Object.freeze({ query: Object.freeze(query) })
+		});
+	}
+	if (value.status === "unavailable") {
+		const result = exactRecord(value, ["status", "reason"], ["status"], "ExternalRedirect result");
+		if (result.reason !== void 0) nonEmpty(result.reason, "ExternalRedirect result.reason");
+		return Object.freeze({
+			status: "unavailable",
+			...result.reason === void 0 ? {} : { reason: result.reason }
+		});
+	}
+	if (value.status === "cancelled" || value.status === "expired") {
+		exactRecord(value, ["status"], ["status"], "ExternalRedirect result");
+		return Object.freeze({ status: value.status });
+	}
+	throw new TypeError("ExternalRedirect result.status is invalid");
+}
+async function firstReady(progress) {
+	for await (const value of progress) {
+		validateExternalRedirectReady(value);
+		return Object.freeze({ ...value });
+	}
+	throw new TypeError("ExternalRedirect provider completed without announcing redirectUri");
+}
+function validateScope(scope) {
+	if (!record(scope)) throw new TypeError("Presentation invocation scope must be an object");
+	nonEmpty(scope.invocationId, "Presentation invocation scope.invocationId");
+	nonEmpty(scope.origin, "Presentation invocation scope.origin");
+	dateTime(scope.deadline, "Presentation invocation scope.deadline");
+	if (typeof scope.nextRequestId !== "function") throw new TypeError("Presentation invocation scope.nextRequestId must be a function");
+}
+function nextRequestId(scope) {
+	const value = scope.nextRequestId();
+	nonEmpty(value, "Presentation requestId");
+	return value;
+}
+function exactRecord(value, allowed, required, label) {
+	if (!record(value)) throw new TypeError(`${label} must be an object`);
+	const unknown = Object.keys(value).filter((key) => !allowed.includes(key));
+	if (unknown.length > 0) throw new TypeError(`${label} contains unknown field ${JSON.stringify(unknown[0])}`);
+	for (const key of required) if (!Object.hasOwn(value, key)) throw new TypeError(`${label}.${key} is required`);
+	return value;
+}
+function record(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function nonEmpty(value, label) {
+	if (typeof value !== "string" || value.trim() === "") throw new TypeError(`${label} must be a non-empty string`);
+}
+function dateTime(value, label) {
+	if (value !== void 0 && (typeof value !== "string" || Number.isNaN(Date.parse(value)))) throw new TypeError(`${label} must be an RFC 3339 date-time`);
+}
+function validateLoopbackUri(value, label, requireExplicitPort) {
+	nonEmpty(value, label);
+	let uri;
+	try {
+		uri = new URL(value);
+	} catch {
+		throw new TypeError(`${label} must be an absolute URI`);
+	}
+	if (uri.protocol !== "http:") throw new TypeError(`${label} must use HTTP`);
+	if (uri.hostname !== "127.0.0.1" && uri.hostname !== "[::1]" && uri.hostname !== "localhost") throw new TypeError(`${label} must target a loopback host`);
+	if (uri.username !== "" || uri.password !== "") throw new TypeError(`${label} must not contain user information`);
+	if (uri.hash !== "") throw new TypeError(`${label} must not contain a fragment`);
+	if (requireExplicitPort) {
+		const authority = value.slice(value.indexOf("//") + 2).split(/[/?#]/u, 1)[0];
+		const match = /^(?:127\.0\.0\.1|localhost):(\d+)$|^\[::1\]:(\d+)$/iu.exec(authority);
+		const port = Number(match?.[1] ?? match?.[2]);
+		if (!Number.isSafeInteger(port) || port < 1 || port > 65535) throw new TypeError(`${label} must include an explicit TCP port`);
+	}
+}
+//#endregion
+export { EXTERNAL_REDIRECT_KIND, externalRedirectClient, externalRedirectImplementation, externalRedirectProtocol, externalRedirectSupport, validateExternalRedirectReady, validateExternalRedirectRequest, validateExternalRedirectResult };
+
+//# sourceMappingURL=callback.js.map

package/node_modules/@dsh-std/presentation/lib/callback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback.js","names":[],"sources":["../src/callback.ts"],"sourcesContent":["import type {\n  CapabilityClient,\n  CapabilityHandlerContext,\n  CapabilityImplementation,\n} from '@dsh-std/connection'\nimport { defineCapabilityProtocol } from '@dsh-std/connection'\nimport type { ProtocolSupport } from '@dsh-std/core'\nimport type { PresentationInvocationScope, PresentationRequestContext, PresentationResult } from './index.js'\n\nexport const EXTERNAL_REDIRECT_KIND = 'ExternalRedirect'\n\nexport interface ExternalRedirectRequest extends PresentationRequestContext {\n  readonly mode: 'http-get'\n  /** Exact loopback URI required by the external provider, including an explicit port. */\n  readonly exactRedirectUri?: string\n}\nexport interface ExternalRedirectInput {\n  readonly mode?: 'http-get'\n  /** The provider must bind and announce this exact URI or report the request unavailable. */\n  readonly exactRedirectUri?: string\n}\n\nexport interface ExternalRedirectReady {\n  readonly type: 'ready'\n  readonly redirectUri: string\n  readonly expiresAt?: string\n}\n\nexport interface ExternalRedirectValue {\n  readonly query: Readonly<Record<string, readonly string[]>>\n}\n\nexport interface ExternalRedirectCall {\n  readonly invocationId: string\n  readonly ready: Promise<ExternalRedirectReady>\n  readonly result: Promise<PresentationResult<ExternalRedirectValue>>\n  cancel(reason?: string): void\n}\n\nexport interface ExternalRedirectClient {\n  receive(input?: ExternalRedirectInput, options?: { readonly signal?: AbortSignal }): ExternalRedirectCall\n}\n\nexport interface ExternalRedirectHandler {\n  receive(\n    request: ExternalRedirectRequest,\n    context: CapabilityHandlerContext<ExternalRedirectReady>,\n  ): PresentationResult<ExternalRedirectValue> | Promise<PresentationResult<ExternalRedirectValue>>\n}\n\nconst emptySpec = (value: unknown): undefined => {\n  if (value !== undefined) throw new TypeError('ExternalRedirect does not accept spec in v1alpha1')\n  return undefined\n}\n\nexport const externalRedirectProtocol = defineCapabilityProtocol({\n  apiVersion: 'presentation.dsh/v1alpha1', kind: EXTERNAL_REDIRECT_KIND,\n  validateRequirement: emptySpec, validateSupport: emptySpec,\n})\nexport const externalRedirectSupport: ProtocolSupport = Object.freeze({\n  apiVersion: 'presentation.dsh/v1alpha1', kind: EXTERNAL_REDIRECT_KIND,\n})\n\nexport function externalRedirectClient(client: CapabilityClient, scope: PresentationInvocationScope): ExternalRedirectClient {\n  validateScope(scope)\n  return Object.freeze({\n    receive(input: ExternalRedirectInput = {}, options?: { readonly signal?: AbortSignal }) {\n      const request = Object.freeze({\n        ...input,\n        mode: input.mode ?? 'http-get',\n        requestId: nextRequestId(scope), invocationId: scope.invocationId, origin: scope.origin,\n        ...(scope.deadline === undefined ? {} : { deadline: scope.deadline }),\n      })\n      validateExternalRedirectRequest(request)\n      const call = client.invoke<ExternalRedirectRequest, PresentationResult<ExternalRedirectValue>, ExternalRedirectReady>(\n        externalRedirectSupport, 'receive', request, options,\n      )\n      return Object.freeze({\n        invocationId: call.invocationId,\n        ready: firstReady(call.progress),\n        result: call.result.then(validateExternalRedirectResult),\n        cancel: (reason?: string) => call.cancel(reason),\n      })\n    },\n  })\n}\n\nexport function externalRedirectImplementation(\n  participantId: string,\n  handler: ExternalRedirectHandler,\n): CapabilityImplementation<ExternalRedirectRequest, PresentationResult<ExternalRedirectValue>, ExternalRedirectReady> {\n  return Object.freeze({\n    participantId, protocol: externalRedirectSupport,\n    async handle(operation: string, input: ExternalRedirectRequest, context: CapabilityHandlerContext<ExternalRedirectReady>) {\n      if (operation !== 'receive') throw new TypeError(`unsupported ExternalRedirect operation ${JSON.stringify(operation)}`)\n      validateExternalRedirectRequest(input)\n      let announced = false\n      const guardedContext: CapabilityHandlerContext<ExternalRedirectReady> = Object.freeze({\n        ...context,\n        progress(value: ExternalRedirectReady) {\n          if (announced) throw new TypeError('ExternalRedirect provider emitted more than one ready event')\n          validateExternalRedirectReady(value)\n          if (input.exactRedirectUri !== undefined && value.redirectUri !== input.exactRedirectUri) {\n            throw new TypeError('ExternalRedirect provider did not announce the exact requested redirect URI')\n          }\n          announced = true\n          context.progress(value)\n        },\n      })\n      const result = validateExternalRedirectResult(await handler.receive(input, guardedContext))\n      if (result.status === 'submitted' && !announced) {\n        throw new TypeError('ExternalRedirect provider submitted a result before announcing redirectUri')\n      }\n      return result\n    },\n  })\n}\n\nexport function validateExternalRedirectRequest(value: unknown): asserts value is ExternalRedirectRequest {\n  const request = exactRecord(value, ['requestId', 'invocationId', 'origin', 'deadline', 'mode', 'exactRedirectUri'], ['requestId', 'invocationId', 'origin', 'mode'], 'ExternalRedirect request')\n  nonEmpty(request.requestId, 'ExternalRedirect request.requestId')\n  nonEmpty(request.invocationId, 'ExternalRedirect request.invocationId')\n  nonEmpty(request.origin, 'ExternalRedirect request.origin')\n  if (request.mode !== 'http-get') throw new TypeError('ExternalRedirect request.mode must be \"http-get\"')\n  if (request.exactRedirectUri !== undefined) validateLoopbackUri(request.exactRedirectUri, 'ExternalRedirect request.exactRedirectUri', true)\n  dateTime(request.deadline, 'ExternalRedirect request.deadline')\n}\n\nexport function validateExternalRedirectReady(value: unknown): asserts value is ExternalRedirectReady {\n  const ready = exactRecord(value, ['type', 'redirectUri', 'expiresAt'], ['type', 'redirectUri'], 'ExternalRedirect ready')\n  if (ready.type !== 'ready') throw new TypeError('ExternalRedirect ready.type must be \"ready\"')\n  validateLoopbackUri(ready.redirectUri, 'ExternalRedirect ready.redirectUri', false)\n  dateTime(ready.expiresAt, 'ExternalRedirect ready.expiresAt')\n}\n\nexport function validateExternalRedirectResult(value: unknown): PresentationResult<ExternalRedirectValue> {\n  if (!record(value)) throw new TypeError('ExternalRedirect result must be an object')\n  if (value.status === 'submitted') {\n    const result = exactRecord(value, ['status', 'value'], ['status', 'value'], 'ExternalRedirect result')\n    const submitted = exactRecord(result.value, ['query'], ['query'], 'ExternalRedirect value')\n    if (!record(submitted.query)) throw new TypeError('ExternalRedirect value.query must be an object')\n    const query: Record<string, readonly string[]> = {}\n    for (const [name, entries] of Object.entries(submitted.query)) {\n      if (name === '' || !Array.isArray(entries) || entries.some(entry => typeof entry !== 'string')) {\n        throw new TypeError('ExternalRedirect value.query must map non-empty names to string arrays')\n      }\n      query[name] = Object.freeze([...entries])\n    }\n    return Object.freeze({ status: 'submitted', value: Object.freeze({ query: Object.freeze(query) }) })\n  }\n  if (value.status === 'unavailable') {\n    const result = exactRecord(value, ['status', 'reason'], ['status'], 'ExternalRedirect result')\n    if (result.reason !== undefined) nonEmpty(result.reason, 'ExternalRedirect result.reason')\n    return Object.freeze({ status: 'unavailable', ...(result.reason === undefined ? {} : { reason: result.reason as string }) })\n  }\n  if (value.status === 'cancelled' || value.status === 'expired') {\n    exactRecord(value, ['status'], ['status'], 'ExternalRedirect result')\n    return Object.freeze({ status: value.status })\n  }\n  throw new TypeError('ExternalRedirect result.status is invalid')\n}\n\nasync function firstReady(progress: AsyncIterable<ExternalRedirectReady>): Promise<ExternalRedirectReady> {\n  for await (const value of progress) {\n    validateExternalRedirectReady(value)\n    return Object.freeze({ ...value })\n  }\n  throw new TypeError('ExternalRedirect provider completed without announcing redirectUri')\n}\n\nfunction validateScope(scope: PresentationInvocationScope): void {\n  if (!record(scope)) throw new TypeError('Presentation invocation scope must be an object')\n  nonEmpty(scope.invocationId, 'Presentation invocation scope.invocationId')\n  nonEmpty(scope.origin, 'Presentation invocation scope.origin')\n  dateTime(scope.deadline, 'Presentation invocation scope.deadline')\n  if (typeof scope.nextRequestId !== 'function') throw new TypeError('Presentation invocation scope.nextRequestId must be a function')\n}\n\nfunction nextRequestId(scope: PresentationInvocationScope): string {\n  const value = scope.nextRequestId()\n  nonEmpty(value, 'Presentation requestId')\n  return value\n}\n\nfunction exactRecord(value: unknown, allowed: readonly string[], required: readonly string[], label: string): Record<string, unknown> {\n  if (!record(value)) throw new TypeError(`${label} must be an object`)\n  const unknown = Object.keys(value).filter(key => !allowed.includes(key))\n  if (unknown.length > 0) throw new TypeError(`${label} contains unknown field ${JSON.stringify(unknown[0])}`)\n  for (const key of required) if (!Object.hasOwn(value, key)) throw new TypeError(`${label}.${key} is required`)\n  return value\n}\nfunction record(value: unknown): value is Record<string, unknown> { return typeof value === 'object' && value !== null && !Array.isArray(value) }\nfunction nonEmpty(value: unknown, label: string): asserts value is string {\n  if (typeof value !== 'string' || value.trim() === '') throw new TypeError(`${label} must be a non-empty string`)\n}\nfunction dateTime(value: unknown, label: string): void {\n  if (value !== undefined && (typeof value !== 'string' || Number.isNaN(Date.parse(value)))) throw new TypeError(`${label} must be an RFC 3339 date-time`)\n}\n\nfunction validateLoopbackUri(value: unknown, label: string, requireExplicitPort: boolean): asserts value is string {\n  nonEmpty(value, label)\n  let uri: URL\n  try {\n    uri = new URL(value)\n  } catch {\n    throw new TypeError(`${label} must be an absolute URI`)\n  }\n  if (uri.protocol !== 'http:') throw new TypeError(`${label} must use HTTP`)\n  if (uri.hostname !== '127.0.0.1' && uri.hostname !== '[::1]' && uri.hostname !== 'localhost') {\n    throw new TypeError(`${label} must target a loopback host`)\n  }\n  if (uri.username !== '' || uri.password !== '') throw new TypeError(`${label} must not contain user information`)\n  if (uri.hash !== '') throw new TypeError(`${label} must not contain a fragment`)\n  if (requireExplicitPort) {\n    const authority = value.slice(value.indexOf('//') + 2).split(/[/?#]/u, 1)[0]!\n    const match = /^(?:127\\.0\\.0\\.1|localhost):(\\d+)$|^\\[::1\\]:(\\d+)$/iu.exec(authority)\n    const port = Number(match?.[1] ?? match?.[2])\n    if (!Number.isSafeInteger(port) || port < 1 || port > 65_535) {\n      throw new TypeError(`${label} must include an explicit TCP port`)\n    }\n  }\n}\n"],"mappings":"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"}

package/node_modules/@dsh-std/presentation/lib/index.d.ts

@@ -0,0 +1,262 @@
+import { CapabilityClient, CapabilityHandlerContext, CapabilityImplementation } from "@dsh-std/connection";
+import { ProtocolCatalog, ProtocolDefinition, ProtocolSupport } from "@dsh-std/core";
+//#region src/index.d.ts
+declare const API_VERSION = "presentation.dsh/v1alpha1";
+declare const OPEN_EXTERNAL_KIND = "OpenExternal";
+declare const COPY_TEXT_KIND = "CopyText";
+declare const NOTIFICATION_KIND = "Notification";
+declare const USER_INTERACTION_KIND = "UserInteraction";
+interface PresentationDescriptor {
+  /** Endpoint identity selected and authenticated by the Host for this invocation. */
+  readonly clientId: string;
+  /** Active Presentation agreements projected into this invocation. */
+  readonly contracts: readonly ProtocolSupport[];
+}
+interface PresentationRequestContext {
+  readonly requestId: string;
+  readonly invocationId: string;
+  readonly origin: string;
+  readonly deadline?: string;
+}
+/** Invocation authority supplied by the Host when it creates scoped clients. */
+interface PresentationInvocationScope {
+  readonly invocationId: string;
+  readonly origin: string;
+  readonly deadline?: string;
+  nextRequestId(): string;
+}
+type PresentationResult<T> = {
+  readonly status: 'submitted';
+  readonly value: T;
+} | {
+  readonly status: 'cancelled';
+} | {
+  readonly status: 'expired';
+} | {
+  readonly status: 'unavailable';
+  readonly reason?: string;
+};
+interface OpenExternalRequest extends PresentationRequestContext {
+  readonly uri: string;
+}
+type OpenExternalInput = Omit<OpenExternalRequest, keyof PresentationRequestContext>;
+interface OpenExternalReceipt {
+  readonly accepted: true;
+}
+interface CopyTextRequest extends PresentationRequestContext {
+  readonly text: string;
+  readonly sensitivity?: 'public' | 'private';
+}
+type CopyTextInput = Omit<CopyTextRequest, keyof PresentationRequestContext>;
+interface CopyTextReceipt {
+  readonly accepted: true;
+}
+interface NotificationRequest extends PresentationRequestContext {
+  readonly text: string;
+  readonly level?: 'info' | 'warning' | 'error';
+  readonly deduplicationKey?: string;
+}
+type NotificationInput = Omit<NotificationRequest, keyof PresentationRequestContext>;
+interface NotificationReceipt {
+  readonly accepted: true;
+}
+type UserInteractionOperation = 'question' | 'approval' | 'secret-input';
+interface UserInteractionRequirementSpec {
+  readonly operations: readonly UserInteractionOperation[];
+  readonly optionalOperations?: readonly UserInteractionOperation[];
+}
+interface UserInteractionLimits {
+  readonly maxConcurrentRequests?: number;
+  readonly maxFields?: number;
+  readonly maxOptionsPerField?: number;
+  readonly maxTextLength?: number;
+}
+interface UserInteractionSupportSpec {
+  readonly operations: readonly UserInteractionOperation[];
+  readonly limits?: UserInteractionLimits;
+}
+interface QuestionOption {
+  readonly id: string;
+  readonly label: string;
+  readonly description?: string;
+}
+interface QuestionFieldBase {
+  readonly id: string;
+  readonly label: string;
+  readonly description?: string;
+  readonly required?: boolean;
+}
+interface TextQuestionField extends QuestionFieldBase {
+  readonly kind: 'text';
+  readonly multiline?: boolean;
+  readonly minLength?: number;
+  readonly maxLength?: number;
+}
+interface SelectQuestionField extends QuestionFieldBase {
+  readonly kind: 'select';
+  readonly multiple?: boolean;
+  readonly options: readonly QuestionOption[];
+}
+interface ConfirmQuestionField extends QuestionFieldBase {
+  readonly kind: 'confirm';
+}
+type QuestionField = TextQuestionField | SelectQuestionField | ConfirmQuestionField;
+interface QuestionRequest extends PresentationRequestContext {
+  readonly kind: 'question';
+  readonly title?: string;
+  readonly description?: string;
+  readonly fields: readonly QuestionField[];
+}
+interface QuestionAnswers {
+  readonly answers: Readonly<Record<string, string | boolean | readonly string[]>>;
+}
+interface ApprovalDetail {
+  readonly label: string;
+  readonly value: string;
+  readonly sensitivity?: 'public' | 'private';
+}
+interface ApprovalRequest extends PresentationRequestContext {
+  readonly kind: 'approval';
+  readonly action: string;
+  readonly summary: string;
+  readonly details?: readonly ApprovalDetail[];
+  readonly risk?: 'low' | 'medium' | 'high';
+}
+interface ApprovalValue {
+  readonly decision: 'approved' | 'denied';
+}
+interface SecretInputRequest extends PresentationRequestContext {
+  readonly kind: 'secret-input';
+  readonly label: string;
+  readonly description?: string;
+  readonly minLength?: number;
+  readonly maxLength?: number;
+}
+interface SecretInputValue {
+  readonly secret: string;
+}
+type UserInteractionRequest = QuestionRequest | ApprovalRequest | SecretInputRequest;
+type UserInteractionValue = QuestionAnswers | ApprovalValue | SecretInputValue;
+type QuestionInput = Omit<QuestionRequest, keyof PresentationRequestContext>;
+type ApprovalInput = Omit<ApprovalRequest, keyof PresentationRequestContext>;
+type SecretInput = Omit<SecretInputRequest, keyof PresentationRequestContext>;
+interface OpenExternalClient {
+  openExternal(input: OpenExternalInput, options?: {
+    readonly signal?: AbortSignal;
+  }): Promise<PresentationResult<OpenExternalReceipt>>;
+}
+interface CopyTextClient {
+  copyText(input: CopyTextInput, options?: {
+    readonly signal?: AbortSignal;
+  }): Promise<PresentationResult<CopyTextReceipt>>;
+}
+interface NotificationClient {
+  notify(input: NotificationInput, options?: {
+    readonly signal?: AbortSignal;
+  }): Promise<PresentationResult<NotificationReceipt>>;
+}
+interface UserInteractionClient {
+  interact(input: QuestionInput, options?: {
+    readonly signal?: AbortSignal;
+  }): Promise<PresentationResult<QuestionAnswers>>;
+  interact(input: ApprovalInput, options?: {
+    readonly signal?: AbortSignal;
+  }): Promise<PresentationResult<ApprovalValue>>;
+  interact(input: SecretInput, options?: {
+    readonly signal?: AbortSignal;
+  }): Promise<PresentationResult<SecretInputValue>>;
+}
+/** Typed Presentation capabilities available to one domain invocation. */
+interface PresentationClients {
+  readonly descriptor: PresentationDescriptor;
+  readonly openExternal?: OpenExternalClient;
+  readonly copyText?: CopyTextClient;
+  readonly notification?: NotificationClient;
+  readonly interaction?: UserInteractionClient;
+  readonly externalRedirect?: ExternalRedirectClient;
+}
+interface OpenExternalHandler {
+  openExternal(request: OpenExternalRequest, context: CapabilityHandlerContext): PresentationResult<OpenExternalReceipt> | Promise<PresentationResult<OpenExternalReceipt>>;
+}
+interface CopyTextHandler {
+  copyText(request: CopyTextRequest, context: CapabilityHandlerContext): PresentationResult<CopyTextReceipt> | Promise<PresentationResult<CopyTextReceipt>>;
+}
+interface NotificationHandler {
+  notify(request: NotificationRequest, context: CapabilityHandlerContext): PresentationResult<NotificationReceipt> | Promise<PresentationResult<NotificationReceipt>>;
+}
+interface UserInteractionHandler {
+  interact(request: QuestionRequest, context: CapabilityHandlerContext): PresentationResult<QuestionAnswers> | Promise<PresentationResult<QuestionAnswers>>;
+  interact(request: ApprovalRequest, context: CapabilityHandlerContext): PresentationResult<ApprovalValue> | Promise<PresentationResult<ApprovalValue>>;
+  interact(request: SecretInputRequest, context: CapabilityHandlerContext): PresentationResult<SecretInputValue> | Promise<PresentationResult<SecretInputValue>>;
+}
+declare const openExternalProtocol: ProtocolDefinition<unknown, unknown, unknown, unknown>;
+declare const copyTextProtocol: ProtocolDefinition<unknown, unknown, unknown, unknown>;
+declare const notificationProtocol: ProtocolDefinition<unknown, unknown, unknown, unknown>;
+declare const openExternalSupport: ProtocolSupport;
+declare const copyTextSupport: ProtocolSupport;
+declare const notificationSupport: ProtocolSupport;
+declare const userInteractionSupport: (spec: UserInteractionSupportSpec) => ProtocolSupport<UserInteractionSupportSpec>;
+declare const userInteractionProtocol: ProtocolDefinition<UserInteractionRequirementSpec, UserInteractionSupportSpec>;
+declare const protocols: readonly ProtocolDefinition[];
+declare function register(catalog: ProtocolCatalog): () => void;
+declare function openExternalClient(client: CapabilityClient, scope: PresentationInvocationScope): OpenExternalClient;
+declare function copyTextClient(client: CapabilityClient, scope: PresentationInvocationScope): CopyTextClient;
+declare function notificationClient(client: CapabilityClient, scope: PresentationInvocationScope): NotificationClient;
+declare function userInteractionClient(client: CapabilityClient, scope: PresentationInvocationScope): UserInteractionClient;
+declare function presentationClients(descriptor: PresentationDescriptor, client: CapabilityClient, scope: PresentationInvocationScope): PresentationClients;
+declare function openExternalImplementation(participantId: string, handler: OpenExternalHandler): CapabilityImplementation;
+declare function copyTextImplementation(participantId: string, handler: CopyTextHandler): CapabilityImplementation;
+declare function notificationImplementation(participantId: string, handler: NotificationHandler): CapabilityImplementation;
+declare function userInteractionImplementation(participantId: string, spec: UserInteractionSupportSpec, handler: UserInteractionHandler): CapabilityImplementation;
+declare function validatePresentationDescriptor(value: unknown): asserts value is PresentationDescriptor;
+declare function validateOpenExternalRequest(value: unknown): asserts value is OpenExternalRequest;
+declare function validateCopyTextRequest(value: unknown): asserts value is CopyTextRequest;
+declare function validateNotificationRequest(value: unknown): asserts value is NotificationRequest;
+declare function validateUserInteractionRequest(value: unknown): asserts value is UserInteractionRequest;
+declare function validateUserInteractionRequirement(value: unknown): UserInteractionRequirementSpec;
+declare function validateUserInteractionSupport(value: unknown): UserInteractionSupportSpec;
+//#endregion
+//#region src/callback.d.ts
+declare const EXTERNAL_REDIRECT_KIND = "ExternalRedirect";
+interface ExternalRedirectRequest extends PresentationRequestContext {
+  readonly mode: 'http-get';
+  /** Exact loopback URI required by the external provider, including an explicit port. */
+  readonly exactRedirectUri?: string;
+}
+interface ExternalRedirectInput {
+  readonly mode?: 'http-get';
+  /** The provider must bind and announce this exact URI or report the request unavailable. */
+  readonly exactRedirectUri?: string;
+}
+interface ExternalRedirectReady {
+  readonly type: 'ready';
+  readonly redirectUri: string;
+  readonly expiresAt?: string;
+}
+interface ExternalRedirectValue {
+  readonly query: Readonly<Record<string, readonly string[]>>;
+}
+interface ExternalRedirectCall {
+  readonly invocationId: string;
+  readonly ready: Promise<ExternalRedirectReady>;
+  readonly result: Promise<PresentationResult<ExternalRedirectValue>>;
+  cancel(reason?: string): void;
+}
+interface ExternalRedirectClient {
+  receive(input?: ExternalRedirectInput, options?: {
+    readonly signal?: AbortSignal;
+  }): ExternalRedirectCall;
+}
+interface ExternalRedirectHandler {
+  receive(request: ExternalRedirectRequest, context: CapabilityHandlerContext<ExternalRedirectReady>): PresentationResult<ExternalRedirectValue> | Promise<PresentationResult<ExternalRedirectValue>>;
+}
+declare const externalRedirectProtocol: import("@dsh-std/core").ProtocolDefinition<unknown, unknown, unknown, unknown>;
+declare const externalRedirectSupport: ProtocolSupport;
+declare function externalRedirectClient(client: CapabilityClient, scope: PresentationInvocationScope): ExternalRedirectClient;
+declare function externalRedirectImplementation(participantId: string, handler: ExternalRedirectHandler): CapabilityImplementation<ExternalRedirectRequest, PresentationResult<ExternalRedirectValue>, ExternalRedirectReady>;
+declare function validateExternalRedirectRequest(value: unknown): asserts value is ExternalRedirectRequest;
+declare function validateExternalRedirectReady(value: unknown): asserts value is ExternalRedirectReady;
+declare function validateExternalRedirectResult(value: unknown): PresentationResult<ExternalRedirectValue>;
+//#endregion
+export { API_VERSION, ApprovalDetail, ApprovalInput, ApprovalRequest, ApprovalValue, COPY_TEXT_KIND, ConfirmQuestionField, CopyTextClient, CopyTextHandler, CopyTextInput, CopyTextReceipt, CopyTextRequest, EXTERNAL_REDIRECT_KIND, ExternalRedirectCall, ExternalRedirectClient, ExternalRedirectHandler, ExternalRedirectInput, ExternalRedirectReady, ExternalRedirectRequest, ExternalRedirectValue, NOTIFICATION_KIND, NotificationClient, NotificationHandler, NotificationInput, NotificationReceipt, NotificationRequest, OPEN_EXTERNAL_KIND, OpenExternalClient, OpenExternalHandler, OpenExternalInput, OpenExternalReceipt, OpenExternalRequest, PresentationClients, PresentationDescriptor, PresentationInvocationScope, PresentationRequestContext, PresentationResult, QuestionAnswers, QuestionField, QuestionInput, QuestionOption, QuestionRequest, SecretInput, SecretInputRequest, SecretInputValue, SelectQuestionField, TextQuestionField, USER_INTERACTION_KIND, UserInteractionClient, UserInteractionHandler, UserInteractionLimits, UserInteractionOperation, UserInteractionRequest, UserInteractionRequirementSpec, UserInteractionSupportSpec, UserInteractionValue, copyTextClient, copyTextImplementation, copyTextProtocol, copyTextSupport, externalRedirectClient, externalRedirectImplementation, externalRedirectProtocol, externalRedirectSupport, notificationClient, notificationImplementation, notificationProtocol, notificationSupport, openExternalClient, openExternalImplementation, openExternalProtocol, openExternalSupport, presentationClients, protocols, register, userInteractionClient, userInteractionImplementation, userInteractionProtocol, userInteractionSupport, validateCopyTextRequest, validateExternalRedirectReady, validateExternalRedirectRequest, validateExternalRedirectResult, validateNotificationRequest, validateOpenExternalRequest, validatePresentationDescriptor, validateUserInteractionRequest, validateUserInteractionRequirement, validateUserInteractionSupport };
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@dsh-std/presentation/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts","../src/callback.ts"],"mappings":"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"}