@deepseek-harness-tui/dsh-tui 0.11.2 → 0.13.0

package/lib/types/adapter/ports/descriptor.d.ts

@@ -2,7 +2,7 @@
  * Internal read-only Host Descriptor access Port.
  *
  * This is a narrow host-internal diagnostic capability. It deliberately does
- * NOT expose the dsh-ecosystem-spec Host Descriptor protocol object, does NOT
+ * NOT expose the tui-profile Host Descriptor protocol object, does NOT
  * carry apiVersion/kind/negotiation/permission semantics, and does NOT accept
  * caller-supplied owner/principal/activation data. The protocol-shaped
  * descriptor is built and owned by the Standard/Spec plane + Kernel lifecycle

package/lib/types/adapter/ports/descriptor.js

@@ -2,7 +2,7 @@
  * Internal read-only Host Descriptor access Port.
  *
  * This is a narrow host-internal diagnostic capability. It deliberately does
- * NOT expose the dsh-ecosystem-spec Host Descriptor protocol object, does NOT
+ * NOT expose the tui-profile Host Descriptor protocol object, does NOT
  * carry apiVersion/kind/negotiation/permission semantics, and does NOT accept
  * caller-supplied owner/principal/activation data. The protocol-shaped
  * descriptor is built and owned by the Standard/Spec plane + Kernel lifecycle

package/lib/types/adapter/ports/index.d.ts

@@ -3,7 +3,7 @@
  *
  * Boundary rules for this directory:
  * - No imports from `@deepseek-ai/*`.
- * - No imports from `@dsh-std/*` or `dsh-ecosystem-spec` private protocol
+ * - No imports from `@dsh-std/*` or `tui-profile` private protocol
  *   definitions.
  * - No protocol version / negotiation / manifest / permission semantics.
  * - No caller-supplied OwnerRef / activationId / principal on capability

package/lib/types/adapter/ports/index.js

@@ -3,7 +3,7 @@
  *
  * Boundary rules for this directory:
  * - No imports from `@deepseek-ai/*`.
- * - No imports from `@dsh-std/*` or `dsh-ecosystem-spec` private protocol
+ * - No imports from `@dsh-std/*` or `tui-profile` private protocol
  *   definitions.
  * - No protocol version / negotiation / manifest / permission semantics.
  * - No caller-supplied OwnerRef / activationId / principal on capability

package/lib/types/adapter/ports/panels.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Internal Host Port for the TUI side-panel registry (ctx.tuiPanels).
+ *
+ * Panels are host-internal sidebar contributions. This port expresses only
+ * the host's call intent; it does not carry protocol coordinates,
+ * negotiation, manifests, permissions, or caller-supplied owner values.
+ */
+import type { HostDisposer } from './owner.js';
+export interface HostPanelSummary {
+    readonly id: string;
+    readonly title: string;
+    readonly source: 'plugin';
+}
+export interface HostPanelsPort {
+    register(descriptor: {
+        readonly id: string;
+        readonly title?: string;
+    }): HostDisposer;
+    list(): readonly HostPanelSummary[];
+    open(id: string): boolean;
+    close(id: string): boolean;
+    subscribe(listener: (event: {
+        readonly type: string;
+        readonly id: string;
+    }) => void): HostDisposer;
+}
+export type HostPanelsDisposer = HostDisposer;
+//# sourceMappingURL=panels.d.ts.map

package/lib/types/adapter/ports/panels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panels.d.ts","sourceRoot":"","sources":["../../../../src/adapter/ports/panels.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,YAAY,CAAA;IACpF,IAAI,IAAI,SAAS,gBAAgB,EAAE,CAAA;IACnC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAA;IACzB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAA;IAC1B,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,YAAY,CAAA;CACnG;AAED,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAA"}

package/lib/types/adapter/ports/panels.js

@@ -0,0 +1,8 @@
+/**
+ * Internal Host Port for the TUI side-panel registry (ctx.tuiPanels).
+ *
+ * Panels are host-internal sidebar contributions. This port expresses only
+ * the host's call intent; it does not carry protocol coordinates,
+ * negotiation, manifests, permissions, or caller-supplied owner values.
+ */
+export {};

package/lib/types/adapter/ports/workspace.d.ts

@@ -2,7 +2,7 @@
  * Internal Host Port for workspace enumeration/resolution.
  *
  * This port is a TUI-internal capability interface. It does not define
- * dsh-std/dsh-ecosystem-spec protocol types, negotiation, permissions, or
+ * dsh-std/tui-profile protocol types, negotiation, permissions, or
  * caller-supplied owner identities.
  */
 import type { HostDisposer } from './owner.js';

package/lib/types/adapter/ports/workspace.js

@@ -2,7 +2,7 @@
  * Internal Host Port for workspace enumeration/resolution.
  *
  * This port is a TUI-internal capability interface. It does not define
- * dsh-std/dsh-ecosystem-spec protocol types, negotiation, permissions, or
+ * dsh-std/tui-profile protocol types, negotiation, permissions, or
  * caller-supplied owner identities.
  */
 export {};

package/lib/types/adapter/spec/index.d.ts

@@ -1,9 +1,9 @@
 /**
- * dsh-ecosystem-spec / conformance thin layer.
+ * tui-profile / conformance thin layer.
  *
  * This directory is the intended single loading boundary for the vendored TUI
  * private protocol definitions. It must remain thin: protocol definitions are
- * authored in dsh-ecosystem-spec, not redefined here.
+ * authored in tui-profile, not redefined here.
  */
 export * from './profile.js';
 export * from './tui-contributions.js';

package/lib/types/adapter/spec/index.js

@@ -1,9 +1,9 @@
 /**
- * dsh-ecosystem-spec / conformance thin layer.
+ * tui-profile / conformance thin layer.
  *
  * This directory is the intended single loading boundary for the vendored TUI
  * private protocol definitions. It must remain thin: protocol definitions are
- * authored in dsh-ecosystem-spec, not redefined here.
+ * authored in tui-profile, not redefined here.
  */
 export * from './profile.js';
 export * from './tui-contributions.js';

package/lib/types/adapter/spec/profile.d.ts

@@ -1,10 +1,10 @@
 /**
- * Thin spec-plane loader for the pinned dsh-ecosystem-spec profile.
+ * Thin spec-plane loader for the in-tree TUI Profile.
  *
- * This module owns the boundary to the vendored TUI admission profile. The
- * actual registry/profile sha pins live in the Standard plane for now; the
- * long-term direction is to keep only dsh-ecosystem-spec private definitions
- * and conformance here.
+ * This module owns the boundary to `tui-profile/`（本仓库自维护的准入与私有协议
+ * 定义，纯文件、随代码修订）. The actual registry/profile sha pins live in the
+ * Standard plane for now; the long-term direction is to keep only tui-profile
+ * private definitions and conformance here.
  */
-export { DSH_STD_REVISION, ECOSYSTEM_SPEC_REVISION, locateSpecDir, loadSpecData, verifyRegistry, verifyContractProfiles, registryEntries, digestFile, type SpecData, } from '../standard/registry.js';
+export { DSH_STD_REVISION, TUI_PROFILE_DIR, locateSpecDir, loadSpecData, verifyRegistry, verifyContractProfiles, registryEntries, digestFile, type SpecData, } from '../standard/registry.js';
 //# sourceMappingURL=profile.d.ts.map

package/lib/types/adapter/spec/profile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../../../src/adapter/spec/profile.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACb,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,UAAU,EACV,KAAK,QAAQ,GACd,MAAM,yBAAyB,CAAA"}
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../../../src/adapter/spec/profile.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,UAAU,EACV,KAAK,QAAQ,GACd,MAAM,yBAAyB,CAAA"}

package/lib/types/adapter/spec/profile.js

@@ -1,9 +1,9 @@
 /**
- * Thin spec-plane loader for the pinned dsh-ecosystem-spec profile.
+ * Thin spec-plane loader for the in-tree TUI Profile.
  *
- * This module owns the boundary to the vendored TUI admission profile. The
- * actual registry/profile sha pins live in the Standard plane for now; the
- * long-term direction is to keep only dsh-ecosystem-spec private definitions
- * and conformance here.
+ * This module owns the boundary to `tui-profile/`（本仓库自维护的准入与私有协议
+ * 定义，纯文件、随代码修订）. The actual registry/profile sha pins live in the
+ * Standard plane for now; the long-term direction is to keep only tui-profile
+ * private definitions and conformance here.
  */
-export { DSH_STD_REVISION, ECOSYSTEM_SPEC_REVISION, locateSpecDir, loadSpecData, verifyRegistry, verifyContractProfiles, registryEntries, digestFile, } from '../standard/registry.js';
+export { DSH_STD_REVISION, TUI_PROFILE_DIR, locateSpecDir, loadSpecData, verifyRegistry, verifyContractProfiles, registryEntries, digestFile, } from '../standard/registry.js';

package/lib/types/adapter/spec/protocol-constants.d.ts

@@ -1,9 +1,9 @@
 /**
- * dsh-ecosystem-spec derived protocol constants.
+ * tui-profile derived protocol constants.
  *
  * This is the explicit derivation layer required by the adapter boundary.
  *
- * Sources (all are committed dsh-ecosystem-spec assets, not local patches):
+ * Sources (all are committed tui-profile assets, not local patches):
  * - `registry/permissions-0.1.json` is the machine-readable permission policy
  *   table; `EXPECTED_PERMISSIONS` and the intercept permission names are
  *   derived directly from it.
@@ -37,7 +37,7 @@ export declare const TUI_DECISION_EVENT_NAMES: readonly string[];
  * registry rather than authored in product code.
  */
 export declare const TUI_EXTENSION_PERMISSION_NAMES: readonly string[];
-/** All intercept permissions exported by dsh-ecosystem-spec. */
+/** All intercept permissions exported by tui-profile. */
 export declare const INTERCEPT_PERMISSIONS: ReadonlySet<string>;
 /** Decision event point names (subscribe/notification vocabulary). */
 export declare const TUI_EVENT_SCOPE_NAMES: ReadonlySet<string>;

package/lib/types/adapter/spec/protocol-constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol-constants.d.ts","sourceRoot":"","sources":["../../../../src/adapter/spec/protocol-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,UAAU,aAAa;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAA;IAClC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,sEAAsE;AACtE,eAAO,MAAM,oBAAoB,EAAE,SAAS,aAAa,EA6BrD,CAAA;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAOpD,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,8BAA8B,EAAE,SAAS,MAAM,EAI3D,CAAA;AAED,gEAAgE;AAChE,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAA2C,CAAA;AAEjG,sEAAsE;AACtE,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAAqC,CAAA;AAE3F;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKtE,CAAA;AAEF,6CAA6C;AAC7C,eAAO,MAAM,mCAAmC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIhF,CAAA;AAED;;;8BAG8B;AAC9B,eAAO,MAAM,wBAAwB,EAAE,SAAS;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EA4BhF,CAAA"}
+{"version":3,"file":"protocol-constants.d.ts","sourceRoot":"","sources":["../../../../src/adapter/spec/protocol-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,UAAU,aAAa;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAA;IAClC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,sEAAsE;AACtE,eAAO,MAAM,oBAAoB,EAAE,SAAS,aAAa,EA6BrD,CAAA;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAOpD,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,8BAA8B,EAAE,SAAS,MAAM,EAI3D,CAAA;AAED,yDAAyD;AACzD,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAA2C,CAAA;AAEjG,sEAAsE;AACtE,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAAqC,CAAA;AAE3F;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKtE,CAAA;AAEF,6CAA6C;AAC7C,eAAO,MAAM,mCAAmC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIhF,CAAA;AAED;;;8BAG8B;AAC9B,eAAO,MAAM,wBAAwB,EAAE,SAAS;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EA4BhF,CAAA"}

package/lib/types/adapter/spec/protocol-constants.js

@@ -1,9 +1,9 @@
 /**
- * dsh-ecosystem-spec derived protocol constants.
+ * tui-profile derived protocol constants.
  *
  * This is the explicit derivation layer required by the adapter boundary.
  *
- * Sources (all are committed dsh-ecosystem-spec assets, not local patches):
+ * Sources (all are committed tui-profile assets, not local patches):
  * - `registry/permissions-0.1.json` is the machine-readable permission policy
  *   table; `EXPECTED_PERMISSIONS` and the intercept permission names are
  *   derived directly from it.
@@ -70,7 +70,7 @@ export const TUI_DECISION_EVENT_NAMES = Object.freeze([
 export const TUI_EXTENSION_PERMISSION_NAMES = Object.freeze(EXPECTED_PERMISSIONS
     .filter(permission => /^session\..+\.intercept$/u.test(permission.name))
     .map(permission => permission.name));
-/** All intercept permissions exported by dsh-ecosystem-spec. */
+/** All intercept permissions exported by tui-profile. */
 export const INTERCEPT_PERMISSIONS = new Set(TUI_EXTENSION_PERMISSION_NAMES);
 /** Decision event point names (subscribe/notification vocabulary). */
 export const TUI_EVENT_SCOPE_NAMES = new Set(TUI_DECISION_EVENT_NAMES);
@@ -117,8 +117,8 @@ export const HOST_SUPPORTED_CONTRACTS = (() => {
 function locateSpecRoot(start = dirname(fileURLToPath(import.meta.url))) {
     let dir = start;
     for (let index = 0; index < 8; index++) {
-        if (existsSync(join(dir, 'dsh-ecosystem-spec', 'registry', 'permissions-0.1.json'))) {
-            return join(dir, 'dsh-ecosystem-spec');
+        if (existsSync(join(dir, 'tui-profile', 'registry', 'permissions-0.1.json'))) {
+            return join(dir, 'tui-profile');
         }
         const parent = dirname(dir);
         if (parent === dir)

package/lib/types/adapter/spec/tui-contributions.d.ts

@@ -2,15 +2,15 @@
  * Thin spec-plane surface for TUI-private protocol contributions.
  *
  * The private protocol definitions themselves are authored and owned by
- * dsh-ecosystem-spec (`protocols/profile-definitions.js`). This module is the
+ * tui-profile (`protocols/profile-definitions.js`). This module is the
  * single loading boundary: TUI source must import private protocol definitions
- * through this file, never directly through `#dsh-ecosystem-spec/*` from
+ * through this file, never directly through `#tui-profile/*` from
  * `adapter/standard` or UI code.
  */
-export * from '#dsh-ecosystem-spec/profile-definitions';
+export * from '#tui-profile/profile-definitions';
 export { TUI_DECISION_EVENT_NAMES, TUI_EXTENSION_PERMISSION_NAMES, } from './protocol-constants.js';
 export declare const TUI_EXTENSION_API_VERSION = "tui.dsh/v1alpha1";
-/** Re-exported from dsh-ecosystem-spec; kept as a named friendly alias. */
+/** Re-exported from tui-profile; kept as a named friendly alias. */
 export declare const DECISION_EVENTS_COORDINATE: Readonly<import("@dsh-std/core").ApiReference & {
     apiVersion: "tui.dsh/v1alpha1";
     kind: "DecisionEvents";

package/lib/types/adapter/spec/tui-contributions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tui-contributions.d.ts","sourceRoot":"","sources":["../../../../src/adapter/spec/tui-contributions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,yCAAyC,CAAA;AACvD,OAAO,EACL,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,yBAAyB,CAAA;AAEhC,eAAO,MAAM,yBAAyB,qBAAqB,CAAA;AAE3D,2EAA2E;AAC3E,eAAO,MAAM,0BAA0B;;;EAAkB,CAAA"}
+{"version":3,"file":"tui-contributions.d.ts","sourceRoot":"","sources":["../../../../src/adapter/spec/tui-contributions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,kCAAkC,CAAA;AAChD,OAAO,EACL,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,yBAAyB,CAAA;AAEhC,eAAO,MAAM,yBAAyB,qBAAqB,CAAA;AAE3D,oEAAoE;AACpE,eAAO,MAAM,0BAA0B;;;EAAkB,CAAA"}

package/lib/types/adapter/spec/tui-contributions.js

@@ -2,16 +2,16 @@
  * Thin spec-plane surface for TUI-private protocol contributions.
  *
  * The private protocol definitions themselves are authored and owned by
- * dsh-ecosystem-spec (`protocols/profile-definitions.js`). This module is the
+ * tui-profile (`protocols/profile-definitions.js`). This module is the
  * single loading boundary: TUI source must import private protocol definitions
- * through this file, never directly through `#dsh-ecosystem-spec/*` from
+ * through this file, never directly through `#tui-profile/*` from
  * `adapter/standard` or UI code.
  */
-import { DECISION_EVENTS } from '#dsh-ecosystem-spec/profile-definitions';
-export * from '#dsh-ecosystem-spec/profile-definitions';
+import { DECISION_EVENTS } from '#tui-profile/profile-definitions';
+export * from '#tui-profile/profile-definitions';
 export { TUI_DECISION_EVENT_NAMES, TUI_EXTENSION_PERMISSION_NAMES, } from './protocol-constants.js';
 export const TUI_EXTENSION_API_VERSION = 'tui.dsh/v1alpha1';
-/** Re-exported from dsh-ecosystem-spec; kept as a named friendly alias. */
+/** Re-exported from tui-profile; kept as a named friendly alias. */
 export const DECISION_EVENTS_COORDINATE = DECISION_EVENTS;
 // TUI_DECISION_EVENT_NAMES and TUI_EXTENSION_PERMISSION_NAMES are derived in
 // `./protocol-constants.ts` (the only TUI-side authoring point) and re-exported

package/lib/types/adapter/standard/descriptor.js

@@ -255,7 +255,7 @@ export function buildHostDescriptor(options) {
             ? []
             : publishableLifecycles(options.lifecycles, warnings, dropped);
     if (data === undefined) {
-        warnings.push('admission profile unavailable (dsh-ecosystem-spec/); advertising an empty protocol surface');
+        warnings.push('admission profile unavailable (tui-profile/); advertising an empty protocol surface');
     }
     else {
         const index = createContractIndex(data.registry, data.permissions);

package/lib/types/adapter/standard/index.d.ts

@@ -1,13 +1,13 @@
 /**
- * Canonical dsh-std / dsh-ecosystem-spec plane for the TUI adapter.
+ * Canonical dsh-std / tui-profile plane for the TUI adapter.
  *
  * This is the single import point for protocol catalogs, Host Descriptor
  * construction, admission/negotiation, permission scopes, grant evaluation
- * and the pinned dsh-ecosystem-spec profile loader.
+ * and the pinned tui-profile profile loader.
  *
  * Invariants:
  * - No `@deepseek-ai/*` imports are allowed in this directory.
- * - Protocol semantics stay owned by dsh-std / dsh-ecosystem-spec; Host Ports
+ * - Protocol semantics stay owned by dsh-std / tui-profile; Host Ports
  *   must not invent a second protocol language.
  * - P6 removed the legacy `src/plugin-spec/*` and
  *   `src/dsh-adapter/{grants,host-descriptor}.ts` shims; production code

package/lib/types/adapter/standard/index.js

@@ -1,13 +1,13 @@
 /**
- * Canonical dsh-std / dsh-ecosystem-spec plane for the TUI adapter.
+ * Canonical dsh-std / tui-profile plane for the TUI adapter.
  *
  * This is the single import point for protocol catalogs, Host Descriptor
  * construction, admission/negotiation, permission scopes, grant evaluation
- * and the pinned dsh-ecosystem-spec profile loader.
+ * and the pinned tui-profile profile loader.
  *
  * Invariants:
  * - No `@deepseek-ai/*` imports are allowed in this directory.
- * - Protocol semantics stay owned by dsh-std / dsh-ecosystem-spec; Host Ports
+ * - Protocol semantics stay owned by dsh-std / tui-profile; Host Ports
  *   must not invent a second protocol language.
  * - P6 removed the legacy `src/plugin-spec/*` and
  *   `src/dsh-adapter/{grants,host-descriptor}.ts` shims; production code

package/lib/types/adapter/standard/registry.d.ts

@@ -1,7 +1,8 @@
-/** Load and verify the pinned dsh-TUI admission profile. */
+/** Load and verify the in-tree TUI Profile (dsh-TUI 自维护的准入与私有协议定义). */
 import type { ContractRegistry, PermissionRegistry, RegistryEntry } from './types.js';
 export declare const DSH_STD_REVISION = "614dfa1ac168db79fcf4577cf0ebb34e2e3b944b";
-export declare const ECOSYSTEM_SPEC_REVISION = "d28c267fe7fd775428ec2dccd65b0b7efd4dacee";
+/** 仓内 TUI Profile 目录（纯文件，无 submodule 挂载，随本仓库代码一起修订）。 */
+export declare const TUI_PROFILE_DIR = "tui-profile";
 export interface SpecData {
     dir: string;
     registry: ContractRegistry;

package/lib/types/adapter/standard/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/adapter/standard/registry.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAQ5D,OAAO,KAAK,EAAE,gBAAgB,EAAmB,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAEtG,eAAO,MAAM,gBAAgB,6CAA6C,CAAA;AAC1E,eAAO,MAAM,uBAAuB,6CAA6C,CAAA;AAEjF,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,WAAW,EAAE,kBAAkB,CAAA;IAC/B,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAC/B,CAAA;CACF;AASD,wBAAgB,aAAa,CAAC,KAAK,GAAE,MAAgD,GAAG,MAAM,GAAG,SAAS,CASzG;AAiFD,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAM,GAAG,SAA2B,GAAG,QAAQ,GAAG,SAAS,CAiB5F;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,gBAAgB,GAAG,aAAa,EAAE,CAI3E;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,MAAM,EAAE,CAE5E;AAED,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CAuCvD;AAED,4EAA4E;AAC5E,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CA2C/D"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/adapter/standard/registry.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAQvE,OAAO,KAAK,EAAE,gBAAgB,EAAmB,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAEtG,eAAO,MAAM,gBAAgB,6CAA6C,CAAA;AAC1E,wDAAwD;AACxD,eAAO,MAAM,eAAe,gBAAgB,CAAA;AAE5C,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,WAAW,EAAE,kBAAkB,CAAA;IAC/B,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAC/B,CAAA;CACF;AASD,wBAAgB,aAAa,CAAC,KAAK,GAAE,MAAgD,GAAG,MAAM,GAAG,SAAS,CASzG;AAiFD,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAM,GAAG,SAA2B,GAAG,QAAQ,GAAG,SAAS,CAiB5F;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,gBAAgB,GAAG,aAAa,EAAE,CAI3E;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,MAAM,EAAE,CAE5E;AAED,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CAuCvD;AAED,4EAA4E;AAC5E,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CA2C/D"}

package/lib/types/adapter/standard/registry.js

@@ -1,4 +1,4 @@
-/** Load and verify the pinned dsh-TUI admission profile. */
+/** Load and verify the in-tree TUI Profile (dsh-TUI 自维护的准入与私有协议定义). */
 import { createHash } from 'node:crypto';
 import { existsSync, readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
@@ -6,18 +6,19 @@ import { fileURLToPath } from 'node:url';
 import { getAdmissionCatalog } from './tui-extension.js';
 import { EXPECTED_PERMISSIONS } from '../spec/protocol-constants.js';
 export const DSH_STD_REVISION = '614dfa1ac168db79fcf4577cf0ebb34e2e3b944b';
-export const ECOSYSTEM_SPEC_REVISION = 'd28c267fe7fd775428ec2dccd65b0b7efd4dacee';
+/** 仓内 TUI Profile 目录（纯文件，无 submodule 挂载，随本仓库代码一起修订）。 */
+export const TUI_PROFILE_DIR = 'tui-profile';
 const REGISTRY_FILE = join('registry', 'registry-0.15.json');
 const EXPECTED_PROFILE_VERSION = 'tui-admission/0.15';
-const EXPECTED_STD_REPOSITORY = 'https://github.com/Yan-Zero/dsh-std';
+const EXPECTED_STD_REPOSITORY = 'https://github.com/T-Auto/dsh-std';
 const EXPECTED_STD_SUBMODULE = 'vendor/dsh-std';
 const EXPECTED_STD_MANIFEST_VERSION = '0.15';
 const EXPECTED_PERMISSION_REGISTRY_VERSION = '0.1';
 export function locateSpecDir(start = dirname(fileURLToPath(import.meta.url))) {
     let dir = start;
     for (let index = 0; index < 8; index++) {
-        if (existsSync(join(dir, 'dsh-ecosystem-spec', REGISTRY_FILE)))
-            return join(dir, 'dsh-ecosystem-spec');
+        if (existsSync(join(dir, TUI_PROFILE_DIR, REGISTRY_FILE)))
+            return join(dir, TUI_PROFILE_DIR);
         const parent = dirname(dir);
         if (parent === dir)
             return undefined;

package/lib/types/adapter/standard/tui-extension.d.ts

@@ -2,7 +2,7 @@
  * dsh-TUI private protocol registration on the shared dsh-std catalog.
  *
  * Private protocol definitions are NOT authored here. The canonical
- * dsh-ecosystem-spec definitions are loaded through `src/adapter/spec/`; this
+ * tui-profile definitions are loaded through `src/adapter/spec/`; this
  * module only registers public dsh-std protocols and delegates the private
  * TUI profile definitions to the spec boundary.
  */

package/lib/types/adapter/standard/tui-extension.js

@@ -2,7 +2,7 @@
  * dsh-TUI private protocol registration on the shared dsh-std catalog.
  *
  * Private protocol definitions are NOT authored here. The canonical
- * dsh-ecosystem-spec definitions are loaded through `src/adapter/spec/`; this
+ * tui-profile definitions are loaded through `src/adapter/spec/`; this
  * module only registers public dsh-std protocols and delegates the private
  * TUI profile definitions to the spec boundary.
  */

package/lib/types/adapter/upstream/index.d.ts

@@ -10,6 +10,7 @@ export type { UpstreamDriver, UpstreamDriverMount } from './driver.js';
 export { buildHostCapabilityLifecycles, refreshHostCapabilityLifecycles, detectHostDescriptorCapability, hostDescriptorDriver, } from './host-descriptor-driver.js';
 export { detectWorkspaceCapability, workspaceDriver, } from './workspace-driver.js';
 export { detectScenesCapability, scenesDriver, } from './scenes-driver.js';
+export { detectPanelsCapability, panelsDriver, } from './panels-driver.js';
 export { detectSettingsCapability, settingsDriver, } from './settings-driver.js';
 export { detectPresentationCapability, presentationDriver, } from './presentation-driver.js';
 export { detectDecisionsCapability, decisionsDriver, } from './decisions-driver.js';

package/lib/types/adapter/upstream/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapter/upstream/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClF,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtE,OAAO,EACL,6BAA6B,EAC7B,+BAA+B,EAC/B,8BAA8B,EAC9B,oBAAoB,GACrB,MAAM,6BAA6B,CAAA;AACpC,OAAO,EACL,yBAAyB,EACzB,eAAe,GAChB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,sBAAsB,EACtB,YAAY,GACb,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,wBAAwB,EACxB,cAAc,GACf,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,yBAAyB,EACzB,eAAe,GAChB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,EAC5B,YAAY,EACZ,eAAe,EACf,eAAe,EACf,YAAY,EACZ,WAAW,EACX,kBAAkB,GACnB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,GACd,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapter/upstream/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClF,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtE,OAAO,EACL,6BAA6B,EAC7B,+BAA+B,EAC/B,8BAA8B,EAC9B,oBAAoB,GACrB,MAAM,6BAA6B,CAAA;AACpC,OAAO,EACL,yBAAyB,EACzB,eAAe,GAChB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,sBAAsB,EACtB,YAAY,GACb,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,sBAAsB,EACtB,YAAY,GACb,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,wBAAwB,EACxB,cAAc,GACf,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,yBAAyB,EACzB,eAAe,GAChB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,EAC5B,YAAY,EACZ,eAAe,EACf,eAAe,EACf,YAAY,EACZ,WAAW,EACX,kBAAkB,GACnB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,GACd,MAAM,qBAAqB,CAAA"}

package/lib/types/adapter/upstream/index.js

@@ -8,6 +8,7 @@
 export { buildHostCapabilityLifecycles, refreshHostCapabilityLifecycles, detectHostDescriptorCapability, hostDescriptorDriver, } from './host-descriptor-driver.js';
 export { detectWorkspaceCapability, workspaceDriver, } from './workspace-driver.js';
 export { detectScenesCapability, scenesDriver, } from './scenes-driver.js';
+export { detectPanelsCapability, panelsDriver, } from './panels-driver.js';
 export { detectSettingsCapability, settingsDriver, } from './settings-driver.js';
 export { detectPresentationCapability, presentationDriver, } from './presentation-driver.js';
 export { detectDecisionsCapability, decisionsDriver, } from './decisions-driver.js';

package/lib/types/adapter/upstream/panels-driver.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Upstream driver for the TUI side-panel capability (ctx.tuiPanels).
+ *
+ * Panels are a register-class capability. The driver performs a real
+ * reversible probe through the host-only panels facade: register a uniquely
+ * named temporary panel, list it, dispose it, then prove the same id can be
+ * registered again (no residue). It never opens the panel during the probe,
+ * so no visible UI mutation is caused.
+ *
+ * Publication is feature-level: register/list are live only after the
+ * reversible no-residue probe; open/close/badge/subscribe are not safely
+ * auto-verifiable and stay degraded.
+ */
+import type { Detection } from './detection.js';
+import type { UpstreamDriver } from './driver.js';
+export declare function detectPanelsCapability(ctx: unknown): Detection;
+export declare const panelsDriver: UpstreamDriver;
+//# sourceMappingURL=panels-driver.d.ts.map

package/lib/types/adapter/upstream/panels-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panels-driver.d.ts","sourceRoot":"","sources":["../../../../src/adapter/upstream/panels-driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAqB,MAAM,gBAAgB,CAAA;AAClE,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,aAAa,CAAA;AAwDtE,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,CAmB9D;AAiED,eAAO,MAAM,YAAY,EAAE,cAY1B,CAAA"}

package/lib/types/adapter/upstream/panels-driver.js

@@ -0,0 +1,159 @@
+/**
+ * Upstream driver for the TUI side-panel capability (ctx.tuiPanels).
+ *
+ * Panels are a register-class capability. The driver performs a real
+ * reversible probe through the host-only panels facade: register a uniquely
+ * named temporary panel, list it, dispose it, then prove the same id can be
+ * registered again (no residue). It never opens the panel during the probe,
+ * so no visible UI mutation is caused.
+ *
+ * Publication is feature-level: register/list are live only after the
+ * reversible no-residue probe; open/close/badge/subscribe are not safely
+ * auto-verifiable and stay degraded.
+ */
+import { randomUUID } from 'node:crypto';
+import { lifecycleFromDetection } from '../kernel/lifecycle.js';
+import { getHostPanelRuntime } from '../../dsh-adapter/panels.js';
+const CAPABILITY = 'host.panels';
+const PANEL_FEATURES = Object.freeze([
+    'host.panels.register',
+    'host.panels.list',
+    'host.panels.open',
+    'host.panels.close',
+    'host.panels.badge',
+    'host.panels.subscribe',
+]);
+function serviceEvidence(id) {
+    return { kind: 'service', id };
+}
+function methodEvidence(service, method) {
+    return { kind: 'method', id: service + ':' + method };
+}
+function probeEvidence(id, detail) {
+    return { kind: 'probe', id, detail };
+}
+function errorText(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function panelHost(ctx) {
+    const service = ctx?.get?.('tuiPanels');
+    if (service === undefined)
+        return undefined;
+    try {
+        return getHostPanelRuntime(service);
+    }
+    catch {
+        return undefined;
+    }
+}
+function degradedFeature(capability, evidence, missing) {
+    return lifecycleFromDetection(capability, {
+        state: 'degraded',
+        missing: [missing],
+        evidence,
+    });
+}
+function liveFeature(capability, evidence) {
+    return lifecycleFromDetection(capability, {
+        state: 'supported',
+        evidence,
+    });
+}
+export function detectPanelsCapability(ctx) {
+    const service = ctx?.get?.('tuiPanels');
+    if (service === undefined) {
+        return { state: 'unsupported', reason: 'tuiPanels service is not mounted' };
+    }
+    const evidence = [serviceEvidence('tuiPanels')];
+    const host = panelHost(ctx);
+    if (host === undefined) {
+        return { state: 'degraded', missing: ['tuiPanels host facade'], evidence };
+    }
+    const methods = ['register', 'list', 'open', 'close', 'subscribe'];
+    for (const method of methods) {
+        if (typeof host[method] === 'function') {
+            evidence.push(methodEvidence('tuiPanels', method));
+        }
+        else {
+            return { state: 'degraded', missing: ['tuiPanels.' + method + '()'], evidence };
+        }
+    }
+    return { state: 'supported', evidence };
+}
+async function verifyPanelsLive(ctx) {
+    const host = panelHost(ctx);
+    const baseEvidence = [serviceEvidence('tuiPanels')];
+    if (host === undefined) {
+        return PANEL_FEATURES.map(feature => degradedFeature(feature, baseEvidence, feature + '.live-probe'));
+    }
+    const evidence = [serviceEvidence('tuiPanels')];
+    const id = 'dsh_tui_probe:' + randomUUID().replace(/-/g, '').slice(0, 12);
+    let dispose;
+    let registerLive = false;
+    try {
+        dispose = host.register({ id, title: 'dsh-tui reversible panel probe' });
+        const listed = host.list();
+        if (!Array.isArray(listed) || !listed.some(panel => panel.id === id)) {
+            throw new Error('temporary panel was not visible through list()');
+        }
+        evidence.push(probeEvidence('tuiPanels.register+dispose(' + id + ')', 'temporary panel registered and listed'));
+        dispose();
+        dispose = undefined;
+        // No-residue proof: the same id must be registrable again.
+        const second = host.register({ id, title: 'dsh-tui reversible panel probe' });
+        second();
+        evidence.push(probeEvidence('tuiPanels.dispose(' + id + ')', 'temporary panel removed; same id re-register succeeded'));
+        registerLive = true;
+    }
+    catch (error) {
+        evidence.push(probeEvidence('tuiPanels.reversible-live-probe', errorText(error)));
+    }
+    finally {
+        try {
+            dispose?.();
+        }
+        catch {
+            // Best-effort cleanup.
+        }
+    }
+    const out = [];
+    out.push(registerLive
+        ? liveFeature('host.panels.register', evidence)
+        : degradedFeature('host.panels.register', evidence, 'tuiPanels.reversible-live-probe'));
+    if (registerLive) {
+        out.push(liveFeature('host.panels.list', [
+            serviceEvidence('tuiPanels'),
+            methodEvidence('tuiPanels', 'list'),
+            probeEvidence('tuiPanels.list()', 'temporary panel visible through list()'),
+        ]));
+    }
+    else {
+        out.push(degradedFeature('host.panels.list', [serviceEvidence('tuiPanels'), methodEvidence('tuiPanels', 'list')], 'tuiPanels.list() live-probe'));
+    }
+    for (const feature of ['host.panels.open', 'host.panels.close', 'host.panels.badge', 'host.panels.subscribe']) {
+        out.push(degradedFeature(feature, [serviceEvidence('tuiPanels')], feature + '.live-probe'));
+    }
+    return out;
+}
+function createPanelsPort(host) {
+    return Object.freeze({
+        register: descriptor => host.register(descriptor),
+        list: () => host.list(),
+        open: id => host.open(id),
+        close: id => host.close(id),
+        subscribe: listener => host.subscribe(listener),
+    });
+}
+export const panelsDriver = {
+    id: 'dsh-tui-panels',
+    upstreamFamily: 'dsh-tui',
+    capability: 'host.panels',
+    mountEffectClass: 'register',
+    detect: detectPanelsCapability,
+    verifyLive: verifyPanelsLive,
+    async mount(context) {
+        const host = panelHost(context);
+        const ports = host === undefined ? undefined : { panels: createPanelsPort(host) };
+        return { disposer: () => undefined, ...(ports === undefined ? {} : { ports }) };
+    },
+};

package/lib/types/api.d.ts

@@ -1,6 +1,8 @@
 export type { TuiDecisionContext, TuiInputEvent, TuiInputDecision, TuiRewindPromptEvent, TuiRewindMode, TuiRewindPromptDecision, TuiRewindDoneEvent, TuiSessionSwitchEvent, TuiSessionSwitchDecision, TuiSessionSwitchedEvent, TuiCompactEvent, TuiCompactDecision, TuiDialogAnswer, TuiDialogBase, TuiDialogConfirmRequest, TuiDialogInputRequest, TuiDialogSelectOption, TuiDialogSelectRequest, TuiDialogSnapshot, TuiStatusEntry, TuiShortcutKey, TuiShortcutOptions, TuiEntryRenderer, TuiEntryRenderResult, TuiToastDelivery, TuiToastOptions, TuiToastSink, } from './extensions.js';
 export type { HostContract, HostDescriptor, ContractCoordinate, ContractRef, NegotiationDecision, PermissionEntry, PermissionRegistry, TuiPluginStorage, PluginStorageErrorCode, TuiPluginStorageRuntime, MessagesObserveContentBlock, MessagesObserveEnvelope, MessagesObserveListener, MessagesObservePayload, TuiMessageObserverRuntime, LedgerEntry, LedgerOperation, LedgerResult, TuiEffectLedgerRuntime, CommandErrorCode, CodedCommandError, } from './plugin-host.js';
 export type { TuiSceneProps, TuiSceneDescriptor } from './scenes.js';
+export type { TuiPanelDescriptor, TuiPanelProps, TuiPanelCompactProps, TuiPanelHostApi, TuiPanelSnapshot, TuiPanelKeyEvent, } from './panels.js';
+export { TUI_PANEL_API_VERSION } from './panels.js';
 export type { TuiSettingsFieldKind, TuiSettingsFieldOption, TuiSettingsGroup, TuiSettingsFieldWrite, TuiSettingsField, TuiSettingsSection, } from './settings-sections.js';
 export type { TuiCommandTreeProvider } from './command-trees.js';
 export type { TuiWorkspaceKind, TuiWorkspaceTarget, TuiWorkspaceChoice, TuiWorkspaceCommandResult, TuiWorkspaceCommand, TuiCommandShell, TuiWorkspaceProvider, } from './workspaces.js';