@deepseek-harness-tui/dsh-tui 0.7.3 → 0.8.1

package/lib/types/utils/loaded-context.d.ts

@@ -1,10 +1,9 @@
 import type { LoadedContext } from '../dsh-adapter/channel.js';
-/** Per-entry display cap: the panel shows the beginning of long texts. */
+/** Per-entry display cap: `/context` shows the beginning of long texts. */
 export declare const CONTEXT_ENTRY_MAX_CHARS = 800;
 /**
  * Truncate one entry's text for the panel body. The model-visible text is
- * the source of truth and stays complete in the session log; the panel only
- * bounds its own rendering.
+ * the source of truth; the local report only bounds its own rendering.
  * @param text - the interpolated model-visible text.
  * @param max - character cap, defaults to {@link CONTEXT_ENTRY_MAX_CHARS}.
  * @returns the text, or its head plus a truncation marker.
@@ -17,4 +16,10 @@ export declare function truncateContextText(text: string, max?: number): string;
  * @returns the summary, or `''` when every group is empty.
  */
 export declare function summarizeLoadedContext(context: LoadedContext): string;
+/**
+ * Format the loaded-context snapshot for the local `/context` report.
+ * The report preserves the former startup panel's grouping and truncation
+ * without keeping a second expandable surface in the transcript header.
+ */
+export declare function formatLoadedContextReport(context: LoadedContext): string[];
 //# sourceMappingURL=loaded-context.d.ts.map

package/lib/types/utils/loaded-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loaded-context.d.ts","sourceRoot":"","sources":["../../../src/utils/loaded-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAG9D,0EAA0E;AAC1E,eAAO,MAAM,uBAAuB,MAAM,CAAA;AAE1C;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAA0B,GAAG,MAAM,CAGvF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAQrE"}
+{"version":3,"file":"loaded-context.d.ts","sourceRoot":"","sources":["../../../src/utils/loaded-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAG9D,2EAA2E;AAC3E,eAAO,MAAM,uBAAuB,MAAM,CAAA;AAE1C;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAA0B,GAAG,MAAM,CAGvF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAQrE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,EAAE,CA6B1E"}

package/lib/types/utils/loaded-context.js

@@ -1,10 +1,9 @@
 import { t } from '../i18n.js';
-/** Per-entry display cap: the panel shows the beginning of long texts. */
+/** Per-entry display cap: `/context` shows the beginning of long texts. */
 export const CONTEXT_ENTRY_MAX_CHARS = 800;
 /**
  * Truncate one entry's text for the panel body. The model-visible text is
- * the source of truth and stays complete in the session log; the panel only
- * bounds its own rendering.
+ * the source of truth; the local report only bounds its own rendering.
  * @param text - the interpolated model-visible text.
  * @param max - character cap, defaults to {@link CONTEXT_ENTRY_MAX_CHARS}.
  * @returns the text, or its head plus a truncation marker.
@@ -34,3 +33,40 @@ export function summarizeLoadedContext(context) {
         parts.push(t('context-tools', { n: context.tools.length }));
     return parts.join(' · ');
 }
+/**
+ * Format the loaded-context snapshot for the local `/context` report.
+ * The report preserves the former startup panel's grouping and truncation
+ * without keeping a second expandable surface in the transcript header.
+ */
+export function formatLoadedContextReport(context) {
+    const lines = [];
+    const appendEntry = (name, text, max = CONTEXT_ENTRY_MAX_CHARS) => {
+        lines.push(`  ${name}`);
+        lines.push(...truncateContextText(text, max).split('\n').map(line => `    ${line}`));
+    };
+    if (context.sections.length > 0) {
+        lines.push(t('context-panel-sections', { n: context.sections.length }));
+        for (const section of context.sections)
+            appendEntry(section.name, section.text);
+    }
+    if (context.files.length > 0) {
+        lines.push(t('context-panel-files', { n: context.files.length }));
+        lines.push(...context.files.map(file => `  ${file.displayPath}`));
+    }
+    if (context.contexts.length > 0) {
+        lines.push(t('context-panel-runtime', { n: context.contexts.length }));
+        for (const entry of context.contexts)
+            appendEntry(entry.name, entry.text);
+    }
+    if (context.skills.length > 0) {
+        lines.push(t('context-panel-skills', { n: context.skills.length }));
+        for (const skill of context.skills)
+            appendEntry(skill.name, skill.description);
+    }
+    if (context.tools.length > 0) {
+        lines.push(t('context-panel-tools', { n: context.tools.length }));
+        for (const tool of context.tools)
+            appendEntry(tool.name, tool.description, 160);
+    }
+    return lines;
+}

package/lib/types/utils/modifiers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"modifiers.d.ts","sourceRoot":"","sources":["../../../src/utils/modifiers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,KAAK,SAAgC,CAAA;AAElD,yEAAyE;AACzE,wBAAgB,KAAK,CAAC,GAAG,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAEvE;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,QAAwB,CAAA;AAE7C;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE;IACjC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,GAAG,OAAO,CAEV;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAChE,OAAO,CAOT"}
+{"version":3,"file":"modifiers.d.ts","sourceRoot":"","sources":["../../../src/utils/modifiers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,KAAK,SAAgC,CAAA;AAElD,yEAAyE;AACzE,wBAAgB,KAAK,CAAC,GAAG,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAEvE;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,QAAwB,CAAA;AAE7C;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE;IACjC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,GAAG,OAAO,CAEV;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAChE,OAAO,CAQT"}

package/lib/types/utils/modifiers.js

@@ -33,12 +33,13 @@ export function isPlainReturn(key) {
  * pickers must do the same or their UI can render while Enter appears inert.
  */
 export function isPlainReturnInput(input, key) {
-    if (isPlainReturn(key))
-        return true;
     // Bracketed paste can deliver a chunk that is all line breaks — that is
     // pasted content, not an Enter press, and must never confirm a modal.
+    // Checked FIRST: a paste chunk may even carry the return flag.
     if (key.isPasted === true)
         return false;
+    if (isPlainReturn(key))
+        return true;
     return /^[\r\n]+$/u.test(input)
         && !key.ctrl && !key.meta && !key.shift && !key.super;
 }

package/lib/types/working-activity.d.ts

@@ -13,7 +13,19 @@
  * subpath keeps resolution anchored at @deepseek-harness-tui/dsh-tui itself — always a direct
  * profile dependency — and from its real location `dsh-working-activity`
  * resolves under every package-manager layout.
+ *
+ * `publish` is forced off at this mount point: the TUI derives its working
+ * line in-process (issue #143) and never wants activity/status snapshots in
+ * the session log — they make the shared JSONL unreadable for Web (issue
+ * #153). A stale global-launcher patch (≤0.6.x, resolved anchor-first by
+ * the dsh CLI) still carries `publish: true` on this row, which re-enabled
+ * the pollution even on an up-to-date profile install. A local `apply`
+ * shadows the star re-export, so the row config can never turn publishing
+ * back on; a log-replaying consumer mounts the bare package instead.
  * @module @deepseek-harness-tui/dsh-tui/working-activity
  */
+import { apply as mountedApply } from 'dsh-working-activity';
 export * from 'dsh-working-activity';
+type MountedContext = Parameters<typeof mountedApply>[0];
+export declare const apply: (ctx: MountedContext, config: Parameters<typeof mountedApply>[1]) => void;
 //# sourceMappingURL=working-activity.d.ts.map

package/lib/types/working-activity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"working-activity.d.ts","sourceRoot":"","sources":["../../src/working-activity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,cAAc,sBAAsB,CAAA"}
+{"version":3,"file":"working-activity.d.ts","sourceRoot":"","sources":["../../src/working-activity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,KAAK,IAAI,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAE5D,cAAc,sBAAsB,CAAA;AAIpC,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;AAExD,eAAO,MAAM,KAAK,GAAI,KAAK,cAAc,EAAE,QAAQ,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,KAAG,IAEvF,CAAA"}

package/lib/types/working-activity.js

@@ -13,6 +13,19 @@
  * subpath keeps resolution anchored at @deepseek-harness-tui/dsh-tui itself — always a direct
  * profile dependency — and from its real location `dsh-working-activity`
  * resolves under every package-manager layout.
+ *
+ * `publish` is forced off at this mount point: the TUI derives its working
+ * line in-process (issue #143) and never wants activity/status snapshots in
+ * the session log — they make the shared JSONL unreadable for Web (issue
+ * #153). A stale global-launcher patch (≤0.6.x, resolved anchor-first by
+ * the dsh CLI) still carries `publish: true` on this row, which re-enabled
+ * the pollution even on an up-to-date profile install. A local `apply`
+ * shadows the star re-export, so the row config can never turn publishing
+ * back on; a log-replaying consumer mounts the bare package instead.
  * @module @deepseek-harness-tui/dsh-tui/working-activity
  */
+import { apply as mountedApply } from 'dsh-working-activity';
 export * from 'dsh-working-activity';
+export const apply = (ctx, config) => {
+    mountedApply(ctx, { ...config, publish: false });
+};

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

@@ -0,0 +1,26 @@
+# @dsh-std/command
+
+English | [中文](README.zh.md)
+
+Named human-command resources and their shared callable Runtime dispatcher.
+
+## Contract
+
+A `Command` resource describes one root command and its nested subcommands. Nodes provide a title, localized titles, description, aliases, positional arguments, options, and child nodes. Arguments may be required, variadic, or restricted to documented values. Options declare every literal spelling and may accept one value.
+
+`CommandRuntime` defines the generic `catalog` and `execute` operations once for every command extension. A runtime adapter joins extensions published by active facets with its authoritative command registry and implements that capability. The execution context id remains opaque to the standard; a DSH adapter maps it to a session. Results contain only the command outcome. Invocation-scoped UI work uses typed clients from `@dsh-std/presentation`.
+
+`commandRuntime()` wraps a consumer-scoped `CapabilityClient` with typed methods, and `commandRuntimeImplementation()` builds the operation dispatcher for an adapter. Consumers and adapters do not repeat operation strings or payload validation.
+
+Presentation clients can build completion trees and forms without importing the owning component. A component such as dsh-codex declares `Command/codex`; its selected facet publishes the handler in its local runtime and never defines a connection-specific method.
+
+Names and aliases are single tokens. Sibling names and aliases, argument names, option spellings, and enumerated values must be unique. A variadic argument must be last.
+
+## Extension points
+
+Fields prefixed with `x-` may carry experimental metadata. Portable clients ignore extensions they do not understand. Incompatible command semantics require a new contract major version rather than redefining an existing field.
+
+## Known Limitations and Deferred Work
+
+- The contract does not define a command-line parser or quoting rules.
+- Dynamic completion is not part of `v1alpha1`; declared values are static.

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

@@ -0,0 +1,28 @@
+# @dsh-std/command
+
+[English](README.md) | 中文
+
+拟议设计见 [Command Resources and Runtime](../../docs/proposals/command.zh.md)。
+
+具名用户命令资源及其共享的可调用 Runtime 分派器。
+
+## 协议
+
+一项 `Command` 资源描述一个根命令及其嵌套子命令。节点可以提供标题、本地化标题、说明、别名、位置参数、选项和子节点。参数可以是必需、可变长或受已声明值限制；选项声明全部字面拼写，并可接收一个值。
+
+`CommandRuntime` 为全部命令 extension 统一定义 `catalog` 与 `execute` 操作。运行时适配器把 active facets 发布的 extension 与自身权威命令注册表关联，并实现该能力。执行上下文 id 对标准保持不透明；DSH 适配器将其映射为会话。结果只包含命令结果；调用作用域内的 UI 操作使用 `@dsh-std/presentation` 的类型化 client。
+
+`commandRuntime()` 用类型化方法包装按消费方隔离的 `CapabilityClient`，`commandRuntimeImplementation()` 为适配器创建操作分派器。消费方与适配器都无需重复操作字符串或载荷校验。
+
+表现客户端无需导入所属 component，即可构建补全树和表单。dsh-codex 之类的 component 声明 `Command/codex`，由选中的 facet 在本地运行时发布 handler；它不定义 connection 专用方法。
+
+名称与别名必须是单个 token。同级名称与别名、参数名、选项拼写和枚举值必须唯一。可变长参数必须位于末尾。
+
+## 扩展点
+
+以 `x-` 开头的字段可以承载实验性元数据。可移植客户端忽略无法理解的扩展。不兼容的命令语义需要新的协议主版本，不能重新定义现有字段。
+
+## 已知限制与暂缓事项
+
+- 协议不定义命令行解析器或引号规则。
+- `v1alpha1` 不包含动态补全；已声明值是静态的。

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

@@ -0,0 +1,144 @@
+import { CapabilityCall, CapabilityClient, CapabilityHandlerContext, CapabilityImplementation } from "@dsh-std/connection";
+import { PresentationClients, PresentationDescriptor } from "@dsh-std/presentation";
+import { ProtocolCatalog, ProtocolDefinition, ProtocolSupport } from "@dsh-std/core";
+import { ManifestDefinitionCatalog, ManifestExtension } from "@dsh-std/manifest";
+//#region src/index.d.ts
+declare const API_VERSION = "commands.dsh/v1alpha1";
+declare const KIND = "Command";
+declare const RUNTIME_KIND = "CommandRuntime";
+/** Stable reference to one declared command path. */
+interface CommandReference {
+  readonly name: string;
+  readonly path?: readonly string[];
+}
+interface CommandValueSpec {
+  readonly value: string;
+  readonly title?: string;
+  readonly titles?: Readonly<Record<string, string>>;
+}
+interface CommandArgumentSpec {
+  readonly name: string;
+  readonly title?: string;
+  readonly titles?: Readonly<Record<string, string>>;
+  readonly required?: boolean;
+  readonly variadic?: boolean;
+  readonly values?: readonly CommandValueSpec[];
+}
+interface CommandOptionSpec {
+  /** Literal spellings such as `--verbose` and `-v`. */
+  readonly names: readonly string[];
+  readonly title: string;
+  readonly titles?: Readonly<Record<string, string>>;
+  readonly value?: CommandArgumentSpec;
+}
+interface CommandNodeSpec {
+  readonly title: string;
+  readonly titles?: Readonly<Record<string, string>>;
+  readonly description?: string;
+  readonly aliases?: readonly string[];
+  readonly arguments?: readonly CommandArgumentSpec[];
+  readonly options?: readonly CommandOptionSpec[];
+  readonly children?: readonly CommandNode[];
+}
+interface CommandNode {
+  readonly name: string;
+  readonly spec: CommandNodeSpec;
+}
+type CommandSpec = CommandNodeSpec;
+type CommandResource = ManifestExtension<CommandSpec>;
+interface CommandOwnerReference {
+  readonly component: string;
+  readonly facet: string;
+  readonly participantId?: string;
+}
+interface CommandDescriptor {
+  readonly name: string;
+  readonly description: string;
+  readonly input?: {
+    readonly hint: string;
+  };
+  readonly owner: CommandOwnerReference;
+  readonly resource: CommandResource;
+  readonly available: boolean;
+  readonly missingPresentation: readonly ProtocolSupport[];
+  readonly issues: readonly {
+    readonly code: string;
+    readonly message: string;
+  }[];
+}
+interface CommandCatalog {
+  readonly apiVersion: typeof API_VERSION;
+  readonly commands: readonly CommandDescriptor[];
+}
+interface CommandCatalogInput {
+  /** Opaque execution context selected by the consuming product. */
+  readonly contextId: string;
+  readonly presentation?: PresentationDescriptor;
+}
+interface CommandExecutionInput extends CommandCatalogInput {
+  readonly line: string;
+}
+interface CommandExecution {
+  readonly apiVersion: typeof API_VERSION;
+  readonly commandId: string;
+  readonly result: {
+    readonly kind: 'success' | 'error';
+    readonly text?: string;
+    readonly sourceEventSeq?: number;
+  };
+}
+type CommandRuntimeCall = {
+  readonly operation: 'catalog';
+  readonly input: CommandCatalogInput;
+  readonly output: CommandCatalog;
+} | {
+  readonly operation: 'execute';
+  readonly input: CommandExecutionInput;
+  readonly output: CommandExecution | undefined;
+};
+interface CommandRuntimeClient {
+  catalog(input: CommandCatalogInput, options?: {
+    readonly signal?: AbortSignal;
+  }): CapabilityCall<CommandCatalog>;
+  execute(input: CommandExecutionInput, options?: {
+    readonly signal?: AbortSignal;
+  }): CapabilityCall<CommandExecution | undefined>;
+}
+interface CommandRuntimeHandler {
+  catalog(input: CommandCatalogInput, context: CapabilityHandlerContext): CommandCatalog | Promise<CommandCatalog>;
+  execute(input: CommandExecutionInput, context: CapabilityHandlerContext): CommandExecution | undefined | Promise<CommandExecution | undefined>;
+}
+interface CommandHandlerInput {
+  readonly rawInput: string;
+}
+interface CommandHandlerContext {
+  readonly signal: AbortSignal;
+  /** Host-bound clients for Presentation agreements active in this invocation. */
+  readonly presentation?: PresentationClients;
+}
+interface CommandHandler {
+  execute(input: CommandHandlerInput, context: CommandHandlerContext): CommandExecution['result'] | Promise<CommandExecution['result']>;
+}
+declare function assertCommandHandler(value: unknown): asserts value is CommandHandler;
+declare const extensionDefinition: Readonly<{
+  apiVersion: "commands.dsh/v1alpha1";
+  kind: "Command";
+  validateMetadata(metadata: {
+    readonly name: string;
+  }): void;
+  validateSpec(value: unknown): void;
+}>;
+/** Host support for accepting and owning Command resource publications. */
+declare const resourceProtocol: ProtocolDefinition;
+declare const resourceSupport: ProtocolSupport;
+/** Callable, resource-keyed command dispatcher implemented once by a Runtime adapter. */
+declare const runtimeProtocol: ProtocolDefinition<unknown, unknown, unknown, unknown>;
+declare const runtimeSupport: ProtocolSupport;
+/** Bind the typed CommandRuntime operations to a consumer-scoped connection client. */
+declare function commandRuntime(client: CapabilityClient): CommandRuntimeClient;
+/** Create the sole Runtime-side dispatcher implementation for every Command resource. */
+declare function commandRuntimeImplementation(participantId: string, handler: CommandRuntimeHandler): CapabilityImplementation;
+declare function register(protocols: ProtocolCatalog, manifest?: ManifestDefinitionCatalog): () => void;
+//#endregion
+export { API_VERSION, CommandArgumentSpec, CommandCatalog, CommandCatalogInput, CommandDescriptor, CommandExecution, CommandExecutionInput, CommandHandler, CommandHandlerContext, CommandHandlerInput, CommandNode, CommandNodeSpec, CommandOptionSpec, CommandOwnerReference, CommandReference, CommandResource, CommandRuntimeCall, CommandRuntimeClient, CommandRuntimeHandler, CommandSpec, CommandValueSpec, KIND, RUNTIME_KIND, assertCommandHandler, commandRuntime, commandRuntimeImplementation, extensionDefinition, register, resourceProtocol, resourceSupport, runtimeProtocol, runtimeSupport };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;cAoBa;cACA;cACA;;UAGI;WACN;WACA;;UAGM;WACN;WACA;WACA,SAAS,SAAS;;UAGZ;WACN;WACA;WACA,SAAS,SAAS;WAClB;WACA;WACA,kBAAkB;;UAGZ;;WAEN;WACA;WACA,SAAS,SAAS;WAClB,QAAQ;;UAGF;WACN;WACA,SAAS,SAAS;WAClB;WACA;WACA,qBAAqB;WACrB,mBAAmB;WACnB,oBAAoB;;UAGd;WACN;WACA,MAAM;;KAGL,cAAc;KAEd,kBAAkB,kBAAkB;UAE/B;WACN;WACA;WACA;;UAGM;WACN;WACA;WACA;aAAmB;;WACnB,OAAO;WACP,UAAU;WACV;WACA,8BAA8B;WAC9B;aAA4B;aAAuB;;;UAG7C;WACN,mBAAmB;WACnB,mBAAmB;;UAGb;;WAEN;WACA,eAAe;;UAGT,8BAA8B;WACpC;;UAGM;WACN,mBAAmB;WACnB;WACA;aACE;aACA;aACA;;;KAID;WACG;WAA+B,OAAO;WAA8B,QAAQ;;WAC5E;WAA+B,OAAO;WAAgC,QAAQ;;UAE5E;EACf,QAAQ,OAAO,qBAAqB;aAAqB,SAAS;MAAgB,eAAe;EACjG,QAAQ,OAAO,uBAAuB;aAAqB,SAAS;MAAgB,eAAe;;UAGpF;EACf,QAAQ,OAAO,qBAAqB,SAAS,2BAA2B,iBAAiB,QAAQ;EACjG,QACE,OAAO,uBACP,SAAS,2BACR,+BAA+B,QAAQ;;UAG3B;WACN;;UAGM;WACN,QAAQ;;WAER,eAAe;;UAGT;EACf,QACE,OAAO,qBACP,SAAS,wBACR,6BAA6B,QAAQ;;iBAG1B,qBAAqB,yBAAyB,SAAS;cAM1D,qBAAmB;;;EAGH,iBAAA;aAAW;;EAGlB,aAAA;;;cAMT,kBAAkB;cAuBlB,iBAAiB;;cAMjB,iBAAe;cAKf,gBAAgB;;iBAMb,eAAe,QAAQ,mBAAmB;;iBAY1C,6BACd,uBACA,SAAS,wBACR;iBAYa,SAAS,WAAW,iBAAiB,WAAW"}

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