@askdkc/dsh-cli 0.11.3

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

@@ -0,0 +1,24 @@
+/**
+ * Internal Host Port for the TUI scene registry.
+ *
+ * Scenes are host-internal full-screen 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 HostSceneDescriptor {
+    readonly id: string;
+    readonly title?: string;
+    /** The component is host-owned and not a serializable protocol value. */
+    readonly component: unknown;
+}
+export interface HostScenesPort {
+    register(descriptor: HostSceneDescriptor): HostDisposer;
+    list(): readonly HostSceneDescriptor[];
+    open(id: string): boolean;
+    close(): void;
+    readonly active: HostSceneDescriptor | undefined;
+    subscribe(listener: () => void): HostDisposer;
+}
+export type HostScenesDisposer = HostDisposer;
+//# sourceMappingURL=scenes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scenes.d.ts","sourceRoot":"","sources":["../../../../src/adapter/ports/scenes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,mBAAmB,GAAG,YAAY,CAAA;IACvD,IAAI,IAAI,SAAS,mBAAmB,EAAE,CAAA;IACtC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAA;IACzB,KAAK,IAAI,IAAI,CAAA;IACb,QAAQ,CAAC,MAAM,EAAE,mBAAmB,GAAG,SAAS,CAAA;IAChD,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,YAAY,CAAA;CAC9C;AAED,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAA"}

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

@@ -0,0 +1,8 @@
+/**
+ * Internal Host Port for the TUI scene registry.
+ *
+ * Scenes are host-internal full-screen 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/settings.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Internal Host Port for settings-section contributions.
+ *
+ * This port models the TUI host's settings editor surface: declared
+ * sections, fields, groups, and the subscribe feed. It deliberately carries
+ * no dsh settings protocol / revision / permission semantics and no
+ * caller-supplied owner.
+ */
+import type { HostDisposer } from './owner.js';
+export type HostSettingsFieldKind = 'text' | 'number' | 'boolean' | 'select';
+export interface HostSettingsFieldOption {
+    readonly value: string;
+    readonly label: string;
+}
+export interface HostSettingsGroup {
+    readonly id: string;
+    readonly title: string;
+}
+export interface HostSettingsField {
+    readonly path: readonly string[];
+    readonly label: string;
+    readonly hint?: string;
+    readonly group?: string;
+    readonly kind: HostSettingsFieldKind;
+    readonly options?: readonly HostSettingsFieldOption[];
+    readonly placeholder?: string;
+    readonly secret?: {
+        readonly ref: string;
+    };
+}
+export interface HostSettingsSection {
+    readonly ns: string;
+    readonly title: string;
+    readonly groups?: readonly HostSettingsGroup[];
+    readonly fields: readonly HostSettingsField[];
+}
+export interface HostSettingsPort {
+    register(section: HostSettingsSection): HostDisposer;
+    list(): readonly HostSettingsSection[];
+    section(ns: string): HostSettingsSection | undefined;
+    subscribe(listener: () => void): HostDisposer;
+}
+export type HostSettingsDisposer = HostDisposer;
+//# sourceMappingURL=settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../../../src/adapter/ports/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAA;AAE5E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAA;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAA;IACrD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CAC3C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAA;IAC9C,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAC9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAAA;IACpD,IAAI,IAAI,SAAS,mBAAmB,EAAE,CAAA;IACtC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAA;IACpD,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,YAAY,CAAA;CAC9C;AAED,MAAM,MAAM,oBAAoB,GAAG,YAAY,CAAA"}

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

@@ -0,0 +1,9 @@
+/**
+ * Internal Host Port for settings-section contributions.
+ *
+ * This port models the TUI host's settings editor surface: declared
+ * sections, fields, groups, and the subscribe feed. It deliberately carries
+ * no dsh settings protocol / revision / permission semantics and no
+ * caller-supplied owner.
+ */
+export {};

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

@@ -0,0 +1,62 @@
+/**
+ * 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
+ * caller-supplied owner identities.
+ */
+import type { HostDisposer } from './owner.js';
+export interface HostWorkspaceTarget {
+    readonly uri: string;
+    readonly cwd: string;
+    readonly label: string;
+    readonly description?: string;
+    readonly kind: 'local' | 'provider';
+    readonly badge: string;
+}
+export type HostWorkspaceCommandResult = {
+    readonly kind: 'choices';
+    readonly title: string;
+    readonly choices: readonly unknown[];
+} | {
+    readonly kind: 'target';
+    readonly target: HostWorkspaceTarget;
+};
+export interface HostWorkspaceCommand {
+    readonly name: string;
+    readonly aliases?: readonly string[];
+    readonly description: string;
+    run(input: string, context: {
+        readonly cwd: string;
+    }, signal?: AbortSignal): Promise<HostWorkspaceCommandResult> | HostWorkspaceCommandResult;
+}
+export interface HostCommandShell {
+    resolve(request: {
+        readonly command: string;
+        readonly workdir?: string;
+        readonly timeoutMs?: number;
+    }): unknown;
+    run(spec: unknown): Promise<{
+        readonly exitCode: number | null;
+        readonly stdout: {
+            readonly text: string;
+        };
+        readonly stderr: {
+            readonly text: string;
+        };
+        readonly timedOut: boolean;
+    }>;
+}
+export interface HostWorkspacePort {
+    list(currentCwd: string, signal?: AbortSignal): Promise<readonly HostWorkspaceTarget[]>;
+    resolve(reference: string, currentCwd?: string, signal?: AbortSignal): Promise<HostWorkspaceTarget | undefined>;
+    describe(cwd: string): HostWorkspaceTarget;
+    commandShell(cwd: string): Promise<HostCommandShell | undefined>;
+    rename(cwd: string, title: string): Promise<HostWorkspaceTarget>;
+    /** Drop a workspace registration; the directory and logs survive. */
+    remove(cwd: string): Promise<boolean>;
+    commands(): readonly Pick<HostWorkspaceCommand, 'name' | 'aliases' | 'description'>[];
+    runCommand(name: string, input: string, cwd: string, signal?: AbortSignal): Promise<HostWorkspaceCommandResult | undefined>;
+}
+export type HostWorkspaceDisposer = HostDisposer;
+//# sourceMappingURL=workspace.d.ts.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * 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
+ * caller-supplied owner identities.
+ */
+export {};

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

@@ -0,0 +1,11 @@
+/**
+ * dsh-ecosystem-spec / 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.
+ */
+export * from './profile.js';
+export * from './tui-contributions.js';
+export * from './protocol-constants.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapter/spec/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,cAAc,CAAA;AAC5B,cAAc,wBAAwB,CAAA;AACtC,cAAc,yBAAyB,CAAA"}

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

@@ -0,0 +1,10 @@
+/**
+ * dsh-ecosystem-spec / 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.
+ */
+export * from './profile.js';
+export * from './tui-contributions.js';
+export * from './protocol-constants.js';

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

@@ -0,0 +1,10 @@
+/**
+ * Thin spec-plane loader for the pinned dsh-ecosystem-spec 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.
+ */
+export { DSH_STD_REVISION, ECOSYSTEM_SPEC_REVISION, 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

@@ -0,0 +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"}

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

@@ -0,0 +1,9 @@
+/**
+ * Thin spec-plane loader for the pinned dsh-ecosystem-spec 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.
+ */
+export { DSH_STD_REVISION, ECOSYSTEM_SPEC_REVISION, locateSpecDir, loadSpecData, verifyRegistry, verifyContractProfiles, registryEntries, digestFile, } from '../standard/registry.js';

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

@@ -0,0 +1,60 @@
+/**
+ * dsh-ecosystem-spec 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):
+ * - `registry/permissions-0.1.json` is the machine-readable permission policy
+ *   table; `EXPECTED_PERMISSIONS` and the intercept permission names are
+ *   derived directly from it.
+ * - `registry/registry-0.15.json` defines the host contract set used by the
+ *   descriptor driver.
+ * - The TUI decision event point names are not present as a standalone
+ *   machine-readable JSON array in the committed spec revision. They are
+ *   therefore authored ONCE here (the TUI spec-boundary derivation file) and
+ *   validated by `verify:protocol-single-source` against the committed
+ *   `adapters/dsh-tui-v0.15.md` + `rfc/0005-decision-events.md`/registry
+ *   vocabulary. Product/standard code must never declare a second copy.
+ */
+interface PermissionRow {
+    readonly name: string;
+    readonly default: 'allow' | 'deny';
+    readonly revocable: boolean;
+    readonly scope: string;
+}
+/** The permission registry is policy, pinned in the vendored spec. */
+export declare const EXPECTED_PERMISSIONS: readonly PermissionRow[];
+/**
+ * TUI decision event point names.
+ *
+ * These are the RFC 0005 decision points run through the D-7 gate. The
+ * committed spec revision does not yet export them as a machine-readable
+ * array, so this is the single TUI-side derivation/validation site.
+ */
+export declare const TUI_DECISION_EVENT_NAMES: readonly string[];
+/**
+ * TUI intercept permission names. Derived from the committed permission
+ * registry rather than authored in product code.
+ */
+export declare const TUI_EXTENSION_PERMISSION_NAMES: readonly string[];
+/** All intercept permissions exported by dsh-ecosystem-spec. */
+export declare const INTERCEPT_PERMISSIONS: ReadonlySet<string>;
+/** Decision event point names (subscribe/notification vocabulary). */
+export declare const TUI_EVENT_SCOPE_NAMES: ReadonlySet<string>;
+/**
+ * Single spec-layer derivation of the decision-point -> intercept permission
+ * map. Product code must import from here instead of declaring a second copy.
+ */
+export declare const DECISION_EVENT_PERMISSIONS: Readonly<Record<string, string>>;
+/** Inverse view, also spec-layer derived. */
+export declare const INTERCEPT_EVENT_SCOPE_BY_PERMISSION: Readonly<Record<string, string>>;
+/** Host-supported contract coordinates, derived from the vendored registry's
+ * machine-readable entries selected by the TUI driver set. This is the single
+ * source used by the upstream descriptor driver; product code must not keep a
+ * second handwritten list. */
+export declare const HOST_SUPPORTED_CONTRACTS: readonly {
+    apiVersion: string;
+    kind: string;
+}[];
+export {};
+//# sourceMappingURL=protocol-constants.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,129 @@
+/**
+ * dsh-ecosystem-spec 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):
+ * - `registry/permissions-0.1.json` is the machine-readable permission policy
+ *   table; `EXPECTED_PERMISSIONS` and the intercept permission names are
+ *   derived directly from it.
+ * - `registry/registry-0.15.json` defines the host contract set used by the
+ *   descriptor driver.
+ * - The TUI decision event point names are not present as a standalone
+ *   machine-readable JSON array in the committed spec revision. They are
+ *   therefore authored ONCE here (the TUI spec-boundary derivation file) and
+ *   validated by `verify:protocol-single-source` against the committed
+ *   `adapters/dsh-tui-v0.15.md` + `rfc/0005-decision-events.md`/registry
+ *   vocabulary. Product/standard code must never declare a second copy.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** The permission registry is policy, pinned in the vendored spec. */
+export const EXPECTED_PERMISSIONS = (() => {
+    const dir = locateSpecRoot();
+    if (dir === undefined) {
+        // The gate/loader fails closed earlier in production; this fallback keeps
+        // type/build safe for environments without the submodule.
+        return Object.freeze([]);
+    }
+    try {
+        const raw = JSON.parse(readFileSync(join(dir, 'registry', 'permissions-0.1.json'), 'utf8'));
+        const rows = Array.isArray(raw.permissions)
+            ? raw.permissions.filter((row) => row !== null
+                && typeof row === 'object'
+                && typeof row.name === 'string'
+                && (row.default === 'allow' || row.default === 'deny')
+                && typeof row.revocable === 'boolean'
+                && typeof row.scope === 'string')
+            : [];
+        return Object.freeze(rows.map(row => Object.freeze({
+            name: row.name,
+            default: row.default,
+            revocable: row.revocable,
+            scope: row.scope,
+        })));
+    }
+    catch {
+        return Object.freeze([]);
+    }
+})();
+/**
+ * TUI decision event point names.
+ *
+ * These are the RFC 0005 decision points run through the D-7 gate. The
+ * committed spec revision does not yet export them as a machine-readable
+ * array, so this is the single TUI-side derivation/validation site.
+ */
+export const TUI_DECISION_EVENT_NAMES = Object.freeze([
+    'tui/input',
+    'tui/rewind-prompt',
+    'tui/rewind-done',
+    'tui/session-switch',
+    'tui/session-switched',
+    'tui/compact',
+]);
+/**
+ * TUI intercept permission names. Derived from the committed permission
+ * registry rather than authored in product code.
+ */
+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. */
+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);
+/**
+ * Single spec-layer derivation of the decision-point -> intercept permission
+ * map. Product code must import from here instead of declaring a second copy.
+ */
+export const DECISION_EVENT_PERMISSIONS = Object.freeze({
+    'tui/input': 'session.input.intercept',
+    'tui/rewind-prompt': 'session.rewind.intercept',
+    'tui/session-switch': 'session.switch.intercept',
+    'tui/compact': 'session.compact.intercept',
+});
+/** Inverse view, also spec-layer derived. */
+export const INTERCEPT_EVENT_SCOPE_BY_PERMISSION = Object.freeze(Object.fromEntries(Object.entries(DECISION_EVENT_PERMISSIONS).map(([event, permission]) => [permission, event])));
+/** Host-supported contract coordinates, derived from the vendored registry's
+ * machine-readable entries selected by the TUI driver set. This is the single
+ * source used by the upstream descriptor driver; product code must not keep a
+ * second handwritten list. */
+export const HOST_SUPPORTED_CONTRACTS = (() => {
+    const dir = locateSpecRoot();
+    if (dir === undefined)
+        return Object.freeze([]);
+    try {
+        const raw = JSON.parse(readFileSync(join(dir, 'registry', 'registry-0.15.json'), 'utf8'));
+        const entries = [
+            ...(Array.isArray(raw.imports) ? raw.imports : []),
+            ...(Array.isArray(raw.definitions) ? raw.definitions : []),
+        ];
+        const supported = new Set(['commands', 'storage.local', 'messages.observe', 'tui.decision-events']);
+        const coords = entries
+            .filter(entry => typeof entry.name === 'string' && supported.has(entry.name))
+            .map(entry => ({
+            apiVersion: entry.coordinates?.apiVersion,
+            kind: entry.coordinates?.kind,
+        }))
+            .filter((coord) => typeof coord.apiVersion === 'string' && typeof coord.kind === 'string');
+        return Object.freeze(coords.map(coord => Object.freeze({ ...coord })));
+    }
+    catch {
+        return Object.freeze([]);
+    }
+})();
+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');
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+    return undefined;
+}

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

@@ -0,0 +1,18 @@
+/**
+ * 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
+ * single loading boundary: TUI source must import private protocol definitions
+ * through this file, never directly through `#dsh-ecosystem-spec/*` from
+ * `adapter/standard` or UI code.
+ */
+export * from '#dsh-ecosystem-spec/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. */
+export declare const DECISION_EVENTS_COORDINATE: Readonly<import("@dsh-std/core").ApiReference & {
+    apiVersion: "tui.dsh/v1alpha1";
+    kind: "DecisionEvents";
+}>;
+//# sourceMappingURL=tui-contributions.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,19 @@
+/**
+ * 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
+ * single loading boundary: TUI source must import private protocol definitions
+ * through this file, never directly through `#dsh-ecosystem-spec/*` from
+ * `adapter/standard` or UI code.
+ */
+import { DECISION_EVENTS } from '#dsh-ecosystem-spec/profile-definitions';
+export * from '#dsh-ecosystem-spec/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. */
+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
+// here for the standard/product compatibility surface. No copies are authored
+// in `adapter/standard` or legacy code.

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

@@ -0,0 +1,11 @@
+/**
+ * Canonical admission entry.
+ *
+ * This is the unified Standard-plane admission surface for the first vertical
+ * slice: protocol catalog creation, manifest validation, Host Descriptor
+ * validation and negotiation. Plugin identity binding remains a Kernel/legacy
+ * Cordis concern because it requires activation ownership.
+ */
+export { createContractIndex, validatePlugin, validateHost, type ContractIndex, } from './validate.js';
+export { negotiate, type GrantedPermission } from './negotiate.js';
+//# sourceMappingURL=admission.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"admission.d.ts","sourceRoot":"","sources":["../../../../src/adapter/standard/admission.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,KAAK,aAAa,GACnB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAA"}

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

@@ -0,0 +1,10 @@
+/**
+ * Canonical admission entry.
+ *
+ * This is the unified Standard-plane admission surface for the first vertical
+ * slice: protocol catalog creation, manifest validation, Host Descriptor
+ * validation and negotiation. Plugin identity binding remains a Kernel/legacy
+ * Cordis concern because it requires activation ownership.
+ */
+export { createContractIndex, validatePlugin, validateHost, } from './validate.js';
+export { negotiate } from './negotiate.js';

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

@@ -0,0 +1,74 @@
+/** Build the current dsh-TUI Host Descriptor from live Kernel lifecycle evidence. */
+import type { ContractCoordinate, HostDescriptor } from './types.js';
+import type { CapabilityLifecycle } from '../kernel/lifecycle.js';
+import { HOST_SUPPORTED_CONTRACTS } from '../spec/protocol-constants.js';
+export { HOST_SUPPORTED_CONTRACTS };
+/** The facet version is part of the host identity, not a protocol definition.
+ * Keep a conservative fallback so a descriptor remains schema-valid when the
+ * optional vendored registry is unavailable; the contract list is still
+ * empty in that degraded state. */
+export declare const HOST_FACET_API_VERSIONS: readonly string[];
+export interface HostDescriptorOptions {
+    hostId?: string;
+    hostVersion?: string;
+    generationId: string;
+    headless?: boolean;
+    /**
+     * Canonical live publication source. Only `lifecycles` with state `live`
+     * (or explicitly split feature-level live evidence) are published. A
+     * `degraded` lifecycle is never published as a whole capability; it must
+     * first be split into feature-level live evidence.
+     */
+    lifecycles?: readonly CapabilityLifecycle[];
+    /**
+     * Explicit legacy-compatibility topology. This is NOT live probe evidence:
+     * it represents the old mounted-service declaration path that remains the
+     * default in `legacy` adapter mode. It is intentionally kept separate from
+     * the live-only publication path and is used only by the dedicated legacy
+     * host descriptor builder / legacy production branch.
+     */
+    legacySupported?: readonly ContractCoordinate[];
+    /** Feature-level legacy DecisionEvents declaration, when the read-only
+     * topology probe has verified them. Empty/undefined means no features. */
+    legacyDecisionFeatures?: readonly string[];
+    /** Marks a build as a legacy compatibility declaration (adds warnings). */
+    legacy?: boolean;
+    specDir?: string;
+}
+export interface HostDescriptorBuild {
+    descriptor: HostDescriptor;
+    readonly dropped: readonly string[];
+    readonly warnings: readonly string[];
+}
+export declare function readOwnPackageVersion(): string;
+/**
+ * Build Host Descriptor only from live lifecycle evidence. This is the
+ * canonical production entry point; it never accepts a bare supported array as
+ * final fact.
+ */
+export declare function buildHostDescriptorFromLifecycles(lifecycles: readonly CapabilityLifecycle[], options?: Omit<HostDescriptorOptions, 'lifecycles'>): HostDescriptorBuild;
+export interface LegacyHostDescriptorOptions {
+    hostId?: string;
+    hostVersion?: string;
+    generationId: string;
+    headless?: boolean;
+    specDir?: string;
+    /** Coordinates declared by the legacy mounted-service topology. */
+    supported: readonly ContractCoordinate[];
+    /** Feature-level DecisionEvents declaration from the read-only legacy probe. */
+    decisionFeatures?: readonly string[];
+}
+/**
+ * Build the explicit legacy-mode Host Descriptor.
+ *
+ * P6 keeps this as a first-class mode, not a compatibility shim: it preserves
+ * the old default (`legacy` adapter mode) publication semantics. Command /
+ * LocalStorage / MessageObserver are declared when their legacy service rows
+ * are mounted, without running the new Kernel or any reversible live probe.
+ * It is deliberately distinct from the live-only
+ * `buildHostDescriptorFromLifecycles` path and returns warnings identifying it
+ * as a legacy declaration.
+ */
+export declare function buildLegacyHostDescriptor(options: LegacyHostDescriptorOptions): HostDescriptorBuild;
+export declare function buildHostDescriptor(options: HostDescriptorOptions): HostDescriptorBuild;
+//# sourceMappingURL=descriptor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../../../src/adapter/standard/descriptor.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAKrF,OAAO,KAAK,EAAE,kBAAkB,EAAgB,cAAc,EAAE,MAAM,YAAY,CAAA;AAClF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAIjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AAIxE,OAAO,EAAE,wBAAwB,EAAE,CAAA;AAEnC;;;mCAGmC;AACnC,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAAgC,CAAA;AAErF,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAA;IAC3C;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAC/C;8EAC0E;IAC1E,sBAAsB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1C,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,cAAc,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CACrC;AASD,wBAAgB,qBAAqB,IAAI,MAAM,CAyB9C;AAqJD;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,UAAU,EAAE,SAAS,mBAAmB,EAAE,EAC1C,OAAO,GAAE,IAAI,CAAC,qBAAqB,EAAE,YAAY,CAA+B,GAC/E,mBAAmB,CAErB;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mEAAmE;IACnE,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAA;IACxC,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACrC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,2BAA2B,GAAG,mBAAmB,CAWnG;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,GAAG,mBAAmB,CAuIvF"}