@askdkc/dsh-cli 0.11.3

package/lib/types/adapter/ports/channel-view.js

@@ -0,0 +1,2 @@
+/** Host-owned in-process Channel contract. No runtime or upstream imports. */
+export {};

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

@@ -0,0 +1,68 @@
+/** Host-owned in-process Channel contract. No runtime or upstream imports. */
+export interface TuiWorkspaceTarget {
+    /** Stable, user-pasteable target identifier. */
+    uri: string;
+    /** Host-side cwd recorded in the DSH session header. */
+    cwd: string;
+    /** Compact picker/status label. */
+    label: string;
+    /** Optional secondary picker copy. */
+    description?: string;
+    kind: TuiWorkspaceKind;
+    /** Provider-owned compact badge; the TUI does not interpret it. */
+    badge: string;
+}
+export type TuiWorkspaceKind = 'local' | 'provider';
+/**
+ * One durable workspace as the home screen's sidebar sees it.
+ *
+ * Distinct from {@link TuiWorkspaceTarget} on purpose: a target answers "where
+ * could a session run" (providers included, plus the live cwd), while an entry
+ * answers "what did the user register" — the ledger's own order, ids, titles,
+ * and how many sessions currently hang off it. A workspace with no sessions is
+ * a real row here (and invisible to every session-derived listing), and a
+ * registered directory that has since been deleted is still a row so the user
+ * can remove it.
+ */
+export interface TuiWorkspaceEntry {
+    /** Ledger record id (a uuid); stable across renames. */
+    id: string;
+    /** Canonical directory path recorded at create time. */
+    path: string;
+    /** Durable display title, already defaulted by the registry. */
+    title: string;
+    /** False when the recorded directory no longer exists on disk. */
+    present: boolean;
+    /** Sessions currently attached to this workspace. */
+    sessionCount: number;
+}
+export interface TuiWorkspaceCommand {
+    name: string;
+    aliases?: readonly string[];
+    description: string;
+    run(input: string, context: {
+        cwd: string;
+    }, signal?: AbortSignal): Promise<TuiWorkspaceCommandResult> | TuiWorkspaceCommandResult;
+}
+export type TuiWorkspaceCommandResult = {
+    kind: 'choices';
+    title: string;
+    choices: readonly TuiWorkspaceChoice[];
+} | {
+    kind: 'target';
+    target: TuiWorkspaceTarget;
+};
+export interface TuiWorkspaceChoice {
+    id: string;
+    label: string;
+    description?: string;
+    badge?: string;
+    choose(signal?: AbortSignal): Promise<TuiWorkspaceCommandResult> | TuiWorkspaceCommandResult;
+    /** Optional inline editor entered with Tab while this choice is focused. */
+    input?: {
+        initialValue?: string;
+        placeholder?: string;
+        submit(value: string, signal?: AbortSignal): Promise<TuiWorkspaceCommandResult> | TuiWorkspaceCommandResult;
+    };
+}
+//# sourceMappingURL=channel-workspace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel-workspace.d.ts","sourceRoot":"","sources":["../../../../src/adapter/ports/channel-workspace.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAG9E,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAA;IACX,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAA;IACX,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,gBAAgB,CAAA;IACtB,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,UAAU,CAAA;AAEnD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAA;IACV,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAA;IACb,kEAAkE;IAClE,OAAO,EAAE,OAAO,CAAA;IAChB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,yBAAyB,CAAC,GAAG,yBAAyB,CAAA;CACnI;AAED,MAAM,MAAM,yBAAyB,GACjC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,CAAA;AAElD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,yBAAyB,CAAC,GAAG,yBAAyB,CAAA;IAC5F,4EAA4E;IAC5E,KAAK,CAAC,EAAE;QACN,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,yBAAyB,CAAC,GAAG,yBAAyB,CAAA;KAC5G,CAAA;CACF"}

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

@@ -0,0 +1,2 @@
+/** Host-owned in-process Channel contract. No runtime or upstream imports. */
+export {};

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

@@ -0,0 +1,148 @@
+/**
+ * Internal Host Ports for the TUI live Channel.
+ *
+ * The Channel is the host-internal, stateful terminal projection of one DSH
+ * Agent/Session/Workspace. These ports intentionally split that projection
+ * into five small internal surfaces:
+ *   - projection: the serializable renderer projection (rows/status/tokens);
+ *   - actions:    user-driven Channel mutations (submit/cancel/rewind/…);
+ *   - state:      the live state snapshot;
+ *   - plugins:    plugin-facing seams (external commands, scenes, settings);
+ *   - transcript: durable transcript/event access.
+ *
+ * Boundary rules:
+ * - These are TUI host-internal interfaces, not dsh-std/dsh-ecosystem-spec
+ *   protocol definitions. No apiVersion/kind/negotiation/permission/manifest
+ *   semantics appear here.
+ * - No caller-supplied owner/principal/activation identity is accepted;
+ *   ownership is derived by the Kernel from the Cordis activation.
+ * - Secret values and live function handles are never part of a state or
+ *   projection snapshot.
+ */
+import type { ChannelUi } from './channel-ui.js';
+import type { ComposerSubmission } from './channel-view.js';
+import type { HostDisposer } from './owner.js';
+export interface HostChannelToolProjection {
+    readonly callId: string;
+    readonly name: string;
+    readonly status: 'running' | 'ok' | 'error';
+    readonly argsPreview: string;
+    readonly resultPreview?: string;
+    readonly errorText?: string;
+    readonly startedAt: number;
+    readonly durationMs?: number;
+}
+export interface HostChannelRowProjection {
+    readonly id: number;
+    readonly kind: string;
+    readonly text: string;
+    readonly label?: string;
+    readonly streaming?: boolean;
+    readonly time?: number;
+    readonly seq?: number;
+    readonly tool?: HostChannelToolProjection;
+}
+export interface HostChannelProjectionSnapshot {
+    readonly version: number;
+    readonly rows: readonly HostChannelRowProjection[];
+    readonly status: string;
+    readonly sessionTitle: string;
+    readonly agentId: string;
+    readonly model: string;
+    readonly provider: string;
+    readonly cwd: string;
+    readonly displayCwd: string;
+    readonly working: boolean;
+    readonly activeToolCount: number;
+    readonly lastUserText: string;
+    readonly commandList: readonly {
+        readonly name: string;
+        readonly description?: string;
+    }[];
+    readonly contextSegments: Readonly<Record<string, number>>;
+    readonly subagents: readonly unknown[];
+}
+export interface HostChannelProjectionPort {
+    /** In-process renderer view; never serialized or exposed as a wire snapshot. */
+    ui?(): ChannelUi;
+    snapshot(): HostChannelProjectionSnapshot;
+    subscribe(listener: () => void): HostDisposer;
+}
+export interface HostChannelActionsPort {
+    submit(text: string): void;
+    steer(text: string): void;
+    cancel(): void;
+    interruptAndDeliver(inputs: readonly (string | ComposerSubmission)[]): number;
+    clear(): void;
+    loadOlder(): number;
+    notify(text: string, options?: {
+        readonly color?: 'error' | 'warning' | 'success';
+        readonly timeoutMs?: number;
+    }): HostDisposer;
+}
+export interface HostChannelStateSnapshot {
+    readonly version: number;
+    readonly status: string;
+    readonly sessionTitle: string;
+    readonly sessionColor: string;
+    readonly agentId: string;
+    /** Session identity behind the bound agent, when the host knows one. Optional
+     *  so a minimal/embedded channel can omit it; the working line then simply has
+     *  no session to read a projection for. */
+    readonly sessionId?: string;
+    readonly agentBindingGeneration: number;
+    readonly model: string;
+    readonly provider: string;
+    readonly cwd: string;
+    readonly displayCwd: string;
+    readonly gitBranch?: string;
+    readonly working: boolean;
+    readonly cancelPending: boolean;
+    readonly spinnerMode: string;
+    readonly responseChars: number;
+    readonly activeToolCount: number;
+    readonly turnStart: number;
+    readonly lastUserText: string;
+    readonly tokens: Readonly<Record<string, number>>;
+    readonly lastUsage?: Readonly<Record<string, number>>;
+    readonly activityFrames?: string;
+    readonly goal?: Readonly<Record<string, unknown>>;
+    readonly todos: readonly Readonly<Record<string, unknown>>[];
+    readonly loadedContext?: Readonly<Record<string, unknown>>;
+    readonly pending: readonly Readonly<Record<string, unknown>>[];
+    readonly pluginScene?: Readonly<Record<string, unknown>>;
+    readonly mode: Readonly<Record<string, unknown>>;
+    readonly agentPreset?: string;
+}
+export interface HostChannelStatePort {
+    snapshot(): HostChannelStateSnapshot;
+}
+export interface HostChannelSettingsSectionProjection {
+    readonly ns: string;
+    readonly title: string;
+    readonly groups?: readonly {
+        readonly id: string;
+        readonly title: string;
+    }[];
+    readonly fields: readonly Readonly<Record<string, unknown>>[];
+}
+export interface HostChannelPluginsPort {
+    runExternalCommand(name: string, rawInput: string): Promise<string | undefined>;
+    openPluginScene(id: string): boolean;
+    closePluginScene(): void;
+    settingsSections(): readonly HostChannelSettingsSectionProjection[];
+    subscribeSettingsSections(listener: () => void): HostDisposer;
+}
+export interface HostChannelTranscriptPort {
+    rows(): readonly HostChannelRowProjection[];
+    traceEvents(): readonly unknown[];
+}
+export interface HostChannelPort {
+    readonly projection: HostChannelProjectionPort;
+    readonly actions: HostChannelActionsPort;
+    readonly state: HostChannelStatePort;
+    readonly plugins: HostChannelPluginsPort;
+    readonly transcript: HostChannelTranscriptPort;
+}
+export type HostChannelDisposer = HostDisposer;
+//# sourceMappingURL=channel.d.ts.map

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

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

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

@@ -0,0 +1,22 @@
+/**
+ * Internal Host Ports for the TUI live Channel.
+ *
+ * The Channel is the host-internal, stateful terminal projection of one DSH
+ * Agent/Session/Workspace. These ports intentionally split that projection
+ * into five small internal surfaces:
+ *   - projection: the serializable renderer projection (rows/status/tokens);
+ *   - actions:    user-driven Channel mutations (submit/cancel/rewind/…);
+ *   - state:      the live state snapshot;
+ *   - plugins:    plugin-facing seams (external commands, scenes, settings);
+ *   - transcript: durable transcript/event access.
+ *
+ * Boundary rules:
+ * - These are TUI host-internal interfaces, not dsh-std/dsh-ecosystem-spec
+ *   protocol definitions. No apiVersion/kind/negotiation/permission/manifest
+ *   semantics appear here.
+ * - No caller-supplied owner/principal/activation identity is accepted;
+ *   ownership is derived by the Kernel from the Cordis activation.
+ * - Secret values and live function handles are never part of a state or
+ *   projection snapshot.
+ */
+export {};

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

@@ -0,0 +1,18 @@
+/**
+ * Internal Host Port for TUI DecisionEvents.
+ *
+ * DecisionEvents are the TUI-private interception/notification vocabulary.
+ * This Host Port intentionally exposes only the host-internal read-only
+ * topology probe and an optional host-owned subscription surface; it does
+ * not define the event protocol coordinates/permissions or accept an owner.
+ */
+import type { HostDisposer } from './owner.js';
+export interface HostDecisionsPort {
+    /** Read-only probe of the currently dispatchable decision event names. */
+    probe(): readonly string[];
+    /** Host-owned subscription; ownership is derived by the Kernel, not passed
+     * by the caller. */
+    subscribe(event: string, listener: (payload: Record<string, unknown>) => unknown): HostDisposer;
+}
+export type HostDecisionsDisposer = HostDisposer;
+//# sourceMappingURL=decisions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../../../../src/adapter/ports/decisions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,MAAM,WAAW,iBAAiB;IAChC,0EAA0E;IAC1E,KAAK,IAAI,SAAS,MAAM,EAAE,CAAA;IAC1B;wBACoB;IACpB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,GAAG,YAAY,CAAA;CAChG;AAED,MAAM,MAAM,qBAAqB,GAAG,YAAY,CAAA"}

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

@@ -0,0 +1,9 @@
+/**
+ * Internal Host Port for TUI DecisionEvents.
+ *
+ * DecisionEvents are the TUI-private interception/notification vocabulary.
+ * This Host Port intentionally exposes only the host-internal read-only
+ * topology probe and an optional host-owned subscription surface; it does
+ * not define the event protocol coordinates/permissions or accept an owner.
+ */
+export {};

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

@@ -0,0 +1,25 @@
+/**
+ * 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
+ * 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
+ * and is never a Host Port surface.
+ */
+export interface HostDescriptorSnapshot {
+    readonly hostId: string;
+    readonly hostVersion: string;
+    readonly generationId: string;
+    /** Human/machine-readable diagnostic labels (`apiVersion#kind`). */
+    readonly contracts: readonly string[];
+    readonly dropped: readonly string[];
+    readonly warnings: readonly string[];
+}
+export interface HostDescriptorPort {
+    readonly generationId: string;
+    /** Current read-only diagnostic snapshot for internal TUI/kernel use. */
+    snapshot(): HostDescriptorSnapshot;
+}
+//# sourceMappingURL=descriptor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../../../src/adapter/ports/descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CACrC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,yEAAyE;IACzE,QAAQ,IAAI,sBAAsB,CAAA;CACnC"}

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

@@ -0,0 +1,11 @@
+/**
+ * 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
+ * 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
+ * and is never a Host Port surface.
+ */
+export {};

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

@@ -0,0 +1,86 @@
+/**
+ * Internal Host Ports for TUI extension seams.
+ *
+ * These are host-internal, non-protocol interfaces: status lines, keyboard
+ * shortcuts, session-entry renderers, runtime themes, toasts, and command
+ * completion trees. None of them carry apiVersion/kind, negotiation,
+ * manifest, permission, or caller-supplied owner semantics.
+ */
+import type { HostDisposer } from './owner.js';
+export interface HostStatusEntry {
+    readonly key: string;
+    readonly text: string;
+}
+export interface HostStatusPort {
+    set(key: string, text: string | number | boolean | undefined): HostDisposer;
+    snapshot(): readonly HostStatusEntry[];
+    subscribe(listener: () => void): HostDisposer;
+}
+export type HostShortcutKey = {
+    readonly ctrl?: boolean;
+    readonly alt?: boolean;
+    readonly shift?: boolean;
+    readonly meta?: boolean;
+    readonly name?: string;
+    readonly raw?: string;
+};
+export interface HostShortcutOptions {
+    readonly description: string;
+    readonly handler: () => void | Promise<void>;
+}
+export interface HostShortcutEntry {
+    readonly combo: string;
+    readonly description: string;
+}
+export interface HostShortcutsPort {
+    register(combo: string, options: HostShortcutOptions): HostDisposer;
+    list(): readonly HostShortcutEntry[];
+    dispatch(input: string, key: HostShortcutKey): boolean;
+}
+export interface HostRenderResult {
+    readonly title?: string;
+    readonly lines: readonly string[];
+}
+export type HostEntryRenderer = (payload: unknown) => HostRenderResult | undefined;
+export interface HostRenderersPort {
+    register(type: string, renderer: HostEntryRenderer): HostDisposer;
+    render(type: string, payload: unknown): HostRenderResult | undefined;
+}
+export interface HostThemeDescriptor {
+    readonly name: string;
+    readonly displayName?: string;
+    readonly base: 'light' | 'dark' | 'dark-ansi';
+    readonly colors?: Readonly<Record<string, unknown>>;
+}
+export interface HostThemeRegistration {
+    readonly name: string;
+    readonly displayName: string;
+    readonly base: 'light' | 'dark' | 'dark-ansi';
+    readonly colors: Readonly<Record<string, unknown>>;
+}
+export interface HostThemesPort {
+    register(descriptor: HostThemeDescriptor): HostDisposer;
+    snapshot(): readonly HostThemeRegistration[];
+    resolve(name: string): unknown;
+    subscribe(listener: () => void): HostDisposer;
+}
+export interface HostToastDelivery {
+    readonly text: string;
+    readonly color?: 'success' | 'warning' | 'error';
+    readonly timeoutMs: number;
+}
+export interface HostToastPort {
+    show(delivery: HostToastDelivery): boolean;
+}
+export interface HostCommandTreeProvider {
+    readonly root: string;
+    children(canonicalPath: readonly string[]): readonly unknown[];
+    readonly descriptions?: Readonly<Record<string, unknown>>;
+}
+export interface HostCommandTreesPort {
+    register(provider: HostCommandTreeProvider): HostDisposer;
+    children(canonicalPath: readonly string[]): readonly unknown[];
+    descriptions(root: string): Readonly<Record<string, unknown>> | undefined;
+}
+export type HostExtensionsDisposer = HostDisposer;
+//# sourceMappingURL=extensions.d.ts.map

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * Internal Host Ports for TUI extension seams.
+ *
+ * These are host-internal, non-protocol interfaces: status lines, keyboard
+ * shortcuts, session-entry renderers, runtime themes, toasts, and command
+ * completion trees. None of them carry apiVersion/kind, negotiation,
+ * manifest, permission, or caller-supplied owner semantics.
+ */
+export {};

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

@@ -0,0 +1,23 @@
+/**
+ * TUI Host Ports: pure internal capability interfaces.
+ *
+ * Boundary rules for this directory:
+ * - No imports from `@deepseek-ai/*`.
+ * - No imports from `@dsh-std/*` or `dsh-ecosystem-spec` private protocol
+ *   definitions.
+ * - No protocol version / negotiation / manifest / permission semantics.
+ * - No caller-supplied OwnerRef / activationId / principal on capability
+ *   methods; ownership is derived by the Kernel from Cordis activation.
+ * - Sensitive operations (admission, permission evaluation, ledger writes)
+ *   live in Kernel/Standard internal services, not in Host Ports.
+ */
+export type { HostOwnerRef, HostDisposer, HostEffectClass } from './owner.js';
+export type { HostDescriptorSnapshot, HostDescriptorPort } from './descriptor.js';
+export type { HostPresentationPort, HostPresentationDisposer, HostQuestionRequest, HostQuestionAnswer, HostApprovalRequest, HostApprovalOutcome, HostDialogRequest, HostDialogAnswer, } from './presentation.js';
+export type { HostWorkspacePort, HostWorkspaceDisposer, HostWorkspaceTarget, HostWorkspaceCommandResult, HostWorkspaceCommand, HostCommandShell, } from './workspace.js';
+export type { HostScenesPort, HostScenesDisposer, HostSceneDescriptor, } from './scenes.js';
+export type { HostSettingsPort, HostSettingsDisposer, HostSettingsSection, HostSettingsField, HostSettingsFieldKind, HostSettingsFieldOption, HostSettingsGroup, } from './settings.js';
+export type { HostStatusPort, HostShortcutsPort, HostRenderersPort, HostThemesPort, HostToastPort, HostCommandTreesPort, HostStatusEntry, HostShortcutKey, HostShortcutOptions, HostShortcutEntry, HostRenderResult, HostEntryRenderer, HostThemeDescriptor, HostThemeRegistration, HostToastDelivery, HostCommandTreeProvider, HostExtensionsDisposer, } from './extensions.js';
+export type { HostDecisionsPort, HostDecisionsDisposer, } from './decisions.js';
+export type { HostChannelPort, HostChannelProjectionPort, HostChannelActionsPort, HostChannelStatePort, HostChannelPluginsPort, HostChannelTranscriptPort, HostChannelProjectionSnapshot, HostChannelStateSnapshot, HostChannelRowProjection, HostChannelToolProjection, HostChannelSettingsSectionProjection, HostChannelDisposer, } from './channel.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapter/ports/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC7E,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACjF,YAAY,EACV,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EACV,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,0BAA0B,EAC1B,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,eAAe,CAAA;AACtB,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,iBAAiB,CAAA;AACxB,YAAY,EACV,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EACV,eAAe,EACf,yBAAyB,EACzB,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,6BAA6B,EAC7B,wBAAwB,EACxB,wBAAwB,EACxB,yBAAyB,EACzB,oCAAoC,EACpC,mBAAmB,GACpB,MAAM,cAAc,CAAA"}

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

@@ -0,0 +1,14 @@
+/**
+ * TUI Host Ports: pure internal capability interfaces.
+ *
+ * Boundary rules for this directory:
+ * - No imports from `@deepseek-ai/*`.
+ * - No imports from `@dsh-std/*` or `dsh-ecosystem-spec` private protocol
+ *   definitions.
+ * - No protocol version / negotiation / manifest / permission semantics.
+ * - No caller-supplied OwnerRef / activationId / principal on capability
+ *   methods; ownership is derived by the Kernel from Cordis activation.
+ * - Sensitive operations (admission, permission evaluation, ledger writes)
+ *   live in Kernel/Standard internal services, not in Host Ports.
+ */
+export {};

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

@@ -0,0 +1,19 @@
+/**
+ * Internal host ownership primitives.
+ *
+ * These are TUI-host implementation details, not protocol semantics. They
+ * describe who owns an activation and how host-owned resources are released;
+ * they deliberately say nothing about plugin manifests, permission policy or
+ * negotiation.
+ */
+export interface HostOwnerRef {
+    /** Verified plugin/component identity, assigned by the Kernel. */
+    readonly componentId: string;
+    /** Opaque activation instance id, also assigned by the Kernel. */
+    readonly activationId?: string;
+}
+/** Idempotent release handle for host-owned resources. */
+export type HostDisposer = () => void;
+/** Marker used by kernel/slices to declare an effect class for shadow policy. */
+export type HostEffectClass = 'read-only' | 'subscribe' | 'register' | 'mutate';
+//# sourceMappingURL=owner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"owner.d.ts","sourceRoot":"","sources":["../../../../src/adapter/ports/owner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,0DAA0D;AAC1D,MAAM,MAAM,YAAY,GAAG,MAAM,IAAI,CAAA;AAErC,iFAAiF;AACjF,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAA"}

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

@@ -0,0 +1,9 @@
+/**
+ * Internal host ownership primitives.
+ *
+ * These are TUI-host implementation details, not protocol semantics. They
+ * describe who owns an activation and how host-owned resources are released;
+ * they deliberately say nothing about plugin manifests, permission policy or
+ * negotiation.
+ */
+export {};

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

@@ -0,0 +1,81 @@
+/**
+ * Internal Host Port for host presentation interactions.
+ *
+ * This is a TUI-internal narrow interface for asking/approving/showing
+ * dialogs. It is intentionally not a protocol definition: no apiVersion,
+ * no negotiation, no permission or manifest semantics, and no caller-
+ * supplied owner identity. The runtime derives ownership from the active
+ * Cordis activation before any such interaction is mediated.
+ */
+import type { HostDisposer } from './owner.js';
+export interface HostQuestionItem {
+    readonly id: string;
+    readonly question: string;
+    readonly options?: readonly string[];
+    readonly multiple?: boolean;
+}
+export interface HostQuestionRequest {
+    readonly title: string;
+    readonly questions: readonly HostQuestionItem[];
+}
+export interface HostQuestionAnswerItem {
+    readonly selected: readonly string[];
+    readonly custom?: string;
+}
+export interface HostQuestionAnswer {
+    readonly answers: readonly HostQuestionAnswerItem[];
+}
+export type HostApprovalOutcome = 'allowed-once' | 'rejected' | 'cancelled';
+export interface HostApprovalRequest {
+    readonly toolName: string;
+    readonly reason?: string;
+    readonly command?: string;
+    readonly external?: boolean;
+}
+export interface HostDialogSelectOption {
+    readonly id: string;
+    readonly label: string;
+    readonly description?: string;
+}
+export interface HostDialogSelectRequest {
+    readonly title: string;
+    readonly options: readonly HostDialogSelectOption[];
+    readonly signal?: AbortSignal;
+    readonly timeoutMs?: number;
+}
+export interface HostDialogConfirmRequest {
+    readonly title: string;
+    readonly message?: string;
+    readonly confirmLabel?: string;
+    readonly cancelLabel?: string;
+    readonly signal?: AbortSignal;
+    readonly timeoutMs?: number;
+}
+export interface HostDialogInputRequest {
+    readonly title: string;
+    readonly placeholder?: string;
+    readonly initial?: string;
+    readonly signal?: AbortSignal;
+    readonly timeoutMs?: number;
+}
+export type HostDialogRequest = {
+    readonly kind: 'select';
+} & HostDialogSelectRequest | {
+    readonly kind: 'confirm';
+} & HostDialogConfirmRequest | {
+    readonly kind: 'input';
+} & HostDialogInputRequest;
+export type HostDialogAnswer = string | boolean | undefined;
+/**
+ * Presentation Port. The methods are intentionally async settle points for
+ * host-internal UI; they do not expose the underlying DSH user-interaction
+ * service or the plugin caller.
+ */
+export interface HostPresentationPort {
+    ask(request: HostQuestionRequest): Promise<HostQuestionAnswer>;
+    approve(request: HostApprovalRequest): Promise<HostApprovalOutcome>;
+    dialog(request: HostDialogRequest): Promise<HostDialogAnswer>;
+}
+/** Convenience alias for host-owned caller cleanup. */
+export type HostPresentationDisposer = HostDisposer;
+//# sourceMappingURL=presentation.d.ts.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * Internal Host Port for host presentation interactions.
+ *
+ * This is a TUI-internal narrow interface for asking/approving/showing
+ * dialogs. It is intentionally not a protocol definition: no apiVersion,
+ * no negotiation, no permission or manifest semantics, and no caller-
+ * supplied owner identity. The runtime derives ownership from the active
+ * Cordis activation before any such interaction is mediated.
+ */
+export {};