@deepseek-harness-tui/dsh-tui 0.9.2 → 0.10.0-beta.1

package/dsh-ecosystem-spec/protocols/tui-channel-http.js

@@ -1,32 +1,32 @@
-export const TUI_CHANNEL_HTTP_API_VERSION = 'tui.dsh/v1alpha1'
-export const TUI_CHANNEL_HTTP_KIND = 'ChannelEndpoint'
-export const TUI_CHANNEL_HTTP_HEALTH_PATH = '/dsh-tui/v1/health'
-export const TUI_CHANNEL_HTTP_DESCRIPTOR_PATH = '/dsh-tui/v1/endpoint'
-export const TUI_CHANNEL_HTTP_WEBSOCKET_PATH = '/dsh-tui/v1/connection'
-
-export function createTuiChannelEndpointDescriptor(origin) {
-  const normalized = new URL(origin)
-  if (normalized.protocol !== 'http:' && normalized.protocol !== 'https:') {
-    throw new TypeError('TUI Channel endpoint origin must use http or https')
-  }
-  normalized.pathname = '/'
-  normalized.search = ''
-  normalized.hash = ''
-  return Object.freeze({
-    apiVersion: TUI_CHANNEL_HTTP_API_VERSION,
-    kind: TUI_CHANNEL_HTTP_KIND,
-    origin: normalized.toString().replace(/\/$/u, ''),
-    connection: TUI_CHANNEL_HTTP_WEBSOCKET_PATH,
-  })
-}
-
-export function validateTuiChannelEndpointDescriptor(value) {
-  if (typeof value !== 'object' || value === null || Array.isArray(value)) throw new TypeError('TUI Channel endpoint descriptor must be an object')
-  if (value.apiVersion !== TUI_CHANNEL_HTTP_API_VERSION || value.kind !== TUI_CHANNEL_HTTP_KIND) {
-    throw new TypeError('TUI Channel endpoint descriptor version or kind is unsupported')
-  }
-  if (typeof value.origin !== 'string') throw new TypeError('TUI Channel endpoint origin must be a string')
-  createTuiChannelEndpointDescriptor(value.origin)
-  if (value.connection !== TUI_CHANNEL_HTTP_WEBSOCKET_PATH) throw new TypeError('TUI Channel endpoint connection path is unsupported')
-  return value
-}
+export const TUI_CHANNEL_HTTP_API_VERSION = 'tui.dsh/v1alpha1'
+export const TUI_CHANNEL_HTTP_KIND = 'ChannelEndpoint'
+export const TUI_CHANNEL_HTTP_HEALTH_PATH = '/dsh-tui/v1/health'
+export const TUI_CHANNEL_HTTP_DESCRIPTOR_PATH = '/dsh-tui/v1/endpoint'
+export const TUI_CHANNEL_HTTP_WEBSOCKET_PATH = '/dsh-tui/v1/connection'
+
+export function createTuiChannelEndpointDescriptor(origin) {
+  const normalized = new URL(origin)
+  if (normalized.protocol !== 'http:' && normalized.protocol !== 'https:') {
+    throw new TypeError('TUI Channel endpoint origin must use http or https')
+  }
+  normalized.pathname = '/'
+  normalized.search = ''
+  normalized.hash = ''
+  return Object.freeze({
+    apiVersion: TUI_CHANNEL_HTTP_API_VERSION,
+    kind: TUI_CHANNEL_HTTP_KIND,
+    origin: normalized.toString().replace(/\/$/u, ''),
+    connection: TUI_CHANNEL_HTTP_WEBSOCKET_PATH,
+  })
+}
+
+export function validateTuiChannelEndpointDescriptor(value) {
+  if (typeof value !== 'object' || value === null || Array.isArray(value)) throw new TypeError('TUI Channel endpoint descriptor must be an object')
+  if (value.apiVersion !== TUI_CHANNEL_HTTP_API_VERSION || value.kind !== TUI_CHANNEL_HTTP_KIND) {
+    throw new TypeError('TUI Channel endpoint descriptor version or kind is unsupported')
+  }
+  if (typeof value.origin !== 'string') throw new TypeError('TUI Channel endpoint origin must be a string')
+  createTuiChannelEndpointDescriptor(value.origin)
+  if (value.connection !== TUI_CHANNEL_HTTP_WEBSOCKET_PATH) throw new TypeError('TUI Channel endpoint connection path is unsupported')
+  return value
+}

package/dsh-ecosystem-spec/protocols/tui-channel.d.ts

@@ -1,59 +1,59 @@
-import type { ApiReference, ProtocolDefinition } from '@dsh-std/core'
-
-export type JsonValue = null | boolean | number | string | readonly JsonValue[] | { readonly [key: string]: JsonValue }
-
-export const TUI_CHANNEL: Readonly<ApiReference & {
-  apiVersion: 'tui.dsh/v1alpha1'
-  kind: 'Channel'
-}>
-export const TUI_CHANNEL_WIRE_REVISION: 6
-export const TUI_CHANNEL_FEATURES: readonly string[]
-
-export interface TuiChannelRequirementSpec {
-  readonly wireRevision: number
-  readonly features: readonly string[]
-}
-export interface TuiChannelSupportSpec extends TuiChannelRequirementSpec {}
-
-export interface TuiChannelSnapshot {
-  readonly wireRevision: number
-  readonly channelId: string
-  readonly version: number
-  readonly state: Readonly<Record<string, JsonValue>>
-}
-
-export interface TuiChannelWorkspaceFlowChoice {
-  readonly id: string
-  readonly label: string
-  readonly description?: string
-  readonly badge?: string
-  readonly action: string
-  readonly input?: {
-    readonly action: string
-    readonly initialValue?: string
-    readonly placeholder?: string
-  }
-}
-
-export type TuiChannelWorkspaceFlowResult =
-  | { readonly kind: 'target'; readonly target: import('./tui-contributions.js').WorkspaceTarget }
-  | { readonly kind: 'choices'; readonly title: string; readonly choices: readonly TuiChannelWorkspaceFlowChoice[] }
-
-export type TuiChannelInput =
-  | { readonly operation: 'open'; readonly value: { readonly workspace?: string; readonly sessionId?: string; readonly options?: JsonValue } }
-  | { readonly operation: 'subscribe'; readonly value: { readonly channelId: string; readonly afterVersion: number } }
-  | { readonly operation: 'invoke'; readonly value: { readonly channelId: string; readonly method: string; readonly arguments: readonly JsonValue[] } }
-  | { readonly operation: 'close'; readonly value: { readonly channelId: string } }
-
-export interface TuiChannelInvokeOutput {
-  readonly value: JsonValue
-  readonly valueDefined?: boolean
-  readonly snapshot?: TuiChannelSnapshot
-}
-
-export const tuiChannelDefinition: ProtocolDefinition
-export function validateTuiChannelRequirement(value: unknown): TuiChannelRequirementSpec
-export function validateTuiChannelSupport(value: unknown): TuiChannelSupportSpec
-export function validateTuiChannelInput(operation: string, value: unknown): object
-export function validateTuiChannelSnapshot(value: unknown): TuiChannelSnapshot
-export function validateTuiChannelOutput(operation: string, value: unknown): object
+import type { ApiReference, ProtocolDefinition } from '@dsh-std/core'
+
+export type JsonValue = null | boolean | number | string | readonly JsonValue[] | { readonly [key: string]: JsonValue }
+
+export const TUI_CHANNEL: Readonly<ApiReference & {
+  apiVersion: 'tui.dsh/v1alpha1'
+  kind: 'Channel'
+}>
+export const TUI_CHANNEL_WIRE_REVISION: 6
+export const TUI_CHANNEL_FEATURES: readonly string[]
+
+export interface TuiChannelRequirementSpec {
+  readonly wireRevision: number
+  readonly features: readonly string[]
+}
+export interface TuiChannelSupportSpec extends TuiChannelRequirementSpec {}
+
+export interface TuiChannelSnapshot {
+  readonly wireRevision: number
+  readonly channelId: string
+  readonly version: number
+  readonly state: Readonly<Record<string, JsonValue>>
+}
+
+export interface TuiChannelWorkspaceFlowChoice {
+  readonly id: string
+  readonly label: string
+  readonly description?: string
+  readonly badge?: string
+  readonly action: string
+  readonly input?: {
+    readonly action: string
+    readonly initialValue?: string
+    readonly placeholder?: string
+  }
+}
+
+export type TuiChannelWorkspaceFlowResult =
+  | { readonly kind: 'target'; readonly target: import('./tui-contributions.js').WorkspaceTarget }
+  | { readonly kind: 'choices'; readonly title: string; readonly choices: readonly TuiChannelWorkspaceFlowChoice[] }
+
+export type TuiChannelInput =
+  | { readonly operation: 'open'; readonly value: { readonly workspace?: string; readonly sessionId?: string; readonly options?: JsonValue } }
+  | { readonly operation: 'subscribe'; readonly value: { readonly channelId: string; readonly afterVersion: number } }
+  | { readonly operation: 'invoke'; readonly value: { readonly channelId: string; readonly method: string; readonly arguments: readonly JsonValue[] } }
+  | { readonly operation: 'close'; readonly value: { readonly channelId: string } }
+
+export interface TuiChannelInvokeOutput {
+  readonly value: JsonValue
+  readonly valueDefined?: boolean
+  readonly snapshot?: TuiChannelSnapshot
+}
+
+export const tuiChannelDefinition: ProtocolDefinition
+export function validateTuiChannelRequirement(value: unknown): TuiChannelRequirementSpec
+export function validateTuiChannelSupport(value: unknown): TuiChannelSupportSpec
+export function validateTuiChannelInput(operation: string, value: unknown): object
+export function validateTuiChannelSnapshot(value: unknown): TuiChannelSnapshot
+export function validateTuiChannelOutput(operation: string, value: unknown): object

package/dsh-ecosystem-spec/protocols/tui-channel.js

@@ -1,166 +1,166 @@
-import { defineCapabilityProtocol } from '@dsh-std/connection'
-
-export const TUI_CHANNEL = Object.freeze({
-  apiVersion: 'tui.dsh/v1alpha1',
-  kind: 'Channel',
-})
-
-export const TUI_CHANNEL_WIRE_REVISION = 6
-
-export const TUI_CHANNEL_FEATURES = Object.freeze([
-  'commands',
-  'credentials',
-  'diagnostics',
-  'files',
-  'models',
-  'modes',
-  'presets',
-  'presentation',
-  'provider-setup',
-  'scenes',
-  'session-history',
-  'session-input',
-  'session-lifecycle',
-  'session-state',
-  'settings',
-  'skills',
-  'subagents',
-  'trace',
-  'workspaces',
-])
-
-export const tuiChannelDefinition = defineCapabilityProtocol({
-  ...TUI_CHANNEL,
-  validateRequirement: validateTuiChannelRequirement,
-  validateSupport: validateTuiChannelSupport,
-})
-
-export function validateTuiChannelRequirement(value) {
-  const spec = exactRecord(value, ['wireRevision', 'features'], 'Channel requirement')
-  const wireRevision = positiveInteger(spec.wireRevision, 'Channel requirement.wireRevision')
-  const features = featureList(spec.features, 'Channel requirement.features')
-  return Object.freeze({ wireRevision, features })
-}
-
-export function validateTuiChannelSupport(value) {
-  const spec = exactRecord(value, ['wireRevision', 'features'], 'Channel support')
-  const wireRevision = positiveInteger(spec.wireRevision, 'Channel support.wireRevision')
-  const features = featureList(spec.features, 'Channel support.features')
-  return Object.freeze({ wireRevision, features })
-}
-
-export function validateTuiChannelInput(operation, value) {
-  switch (operation) {
-    case 'open': {
-      const input = exactRecord(value, ['workspace', 'sessionId', 'options'], 'Channel.open input')
-      optionalString(input.workspace, 'Channel.open input.workspace')
-      optionalString(input.sessionId, 'Channel.open input.sessionId')
-      if (input.options !== undefined) jsonValue(input.options, 'Channel.open input.options', new Set())
-      return input
-    }
-    case 'subscribe': {
-      const input = exactRecord(value, ['channelId', 'afterVersion'], 'Channel.subscribe input')
-      nonEmpty(input.channelId, 'Channel.subscribe input.channelId')
-      nonNegativeInteger(input.afterVersion, 'Channel.subscribe input.afterVersion')
-      return input
-    }
-    case 'invoke': {
-      const input = exactRecord(value, ['channelId', 'method', 'arguments'], 'Channel.invoke input')
-      nonEmpty(input.channelId, 'Channel.invoke input.channelId')
-      nonEmpty(input.method, 'Channel.invoke input.method')
-      if (!Array.isArray(input.arguments)) throw new TypeError('Channel.invoke input.arguments must be an array')
-      jsonValue(input.arguments, 'Channel.invoke input.arguments', new Set())
-      return input
-    }
-    case 'close': {
-      const input = exactRecord(value, ['channelId'], 'Channel.close input')
-      nonEmpty(input.channelId, 'Channel.close input.channelId')
-      return input
-    }
-    default:
-      throw new TypeError(`Channel operation ${JSON.stringify(operation)} is not defined`)
-  }
-}
-
-export function validateTuiChannelSnapshot(value) {
-  const snapshot = exactRecord(value, ['wireRevision', 'channelId', 'version', 'state'], 'Channel snapshot')
-  positiveInteger(snapshot.wireRevision, 'Channel snapshot.wireRevision')
-  nonEmpty(snapshot.channelId, 'Channel snapshot.channelId')
-  nonNegativeInteger(snapshot.version, 'Channel snapshot.version')
-  const state = exactRecord(snapshot.state, Object.keys(snapshot.state ?? {}), 'Channel snapshot.state')
-  jsonValue(state, 'Channel snapshot.state', new Set())
-  return snapshot
-}
-
-export function validateTuiChannelOutput(operation, value) {
-  if (operation === 'open' || operation === 'subscribe') return validateTuiChannelSnapshot(value)
-  if (operation === 'invoke') {
-    const output = exactRecord(value, ['value', 'valueDefined', 'snapshot'], 'Channel.invoke output')
-    jsonValue(output.value, 'Channel.invoke output.value', new Set())
-    if (output.valueDefined !== undefined && typeof output.valueDefined !== 'boolean') {
-      throw new TypeError('Channel.invoke output.valueDefined must be boolean')
-    }
-    if (output.snapshot !== undefined) validateTuiChannelSnapshot(output.snapshot)
-    return output
-  }
-  if (operation === 'close') {
-    const output = exactRecord(value, ['closed'], 'Channel.close output')
-    if (output.closed !== true) throw new TypeError('Channel.close output.closed must be true')
-    return output
-  }
-  throw new TypeError(`Channel operation ${JSON.stringify(operation)} is not defined`)
-}
-
-function exactRecord(value, allowed, label) {
-  if (typeof value !== 'object' || value === null || Array.isArray(value)) throw new TypeError(`${label} must be an object`)
-  const unknown = Object.keys(value).filter(key => !allowed.includes(key) && !key.startsWith('x-'))
-  if (unknown.length > 0) throw new TypeError(`${label} contains unknown field ${JSON.stringify(unknown[0])}`)
-  return value
-}
-
-function featureList(value, label) {
-  if (!Array.isArray(value) || value.length === 0) throw new TypeError(`${label} must be a non-empty array`)
-  const features = value.map((feature, index) => {
-    nonEmpty(feature, `${label}[${index}]`)
-    return feature
-  })
-  if (new Set(features).size !== features.length) throw new TypeError(`${label} contains duplicates`)
-  return Object.freeze([...features].sort())
-}
-
-function positiveInteger(value, label) {
-  if (!Number.isSafeInteger(value) || value < 1) throw new TypeError(`${label} must be a positive integer`)
-  return value
-}
-
-function nonNegativeInteger(value, label) {
-  if (!Number.isSafeInteger(value) || value < 0) throw new TypeError(`${label} must be a non-negative integer`)
-  return value
-}
-
-function nonEmpty(value, label) {
-  if (typeof value !== 'string' || value.trim() === '') throw new TypeError(`${label} must be a non-empty string`)
-}
-
-function optionalString(value, label) {
-  if (value !== undefined) nonEmpty(value, label)
-}
-
-function jsonValue(value, label, ancestors) {
-  if (value === null || typeof value === 'boolean' || typeof value === 'string') return
-  if (typeof value === 'number') {
-    if (!Number.isFinite(value)) throw new TypeError(`${label} must contain only finite numbers`)
-    return
-  }
-  if (typeof value !== 'object') throw new TypeError(`${label} must be a JSON value`)
-  if (ancestors.has(value)) throw new TypeError(`${label} must not contain cycles`)
-  ancestors.add(value)
-  if (Array.isArray(value)) {
-    for (const [index, item] of value.entries()) jsonValue(item, `${label}[${index}]`, ancestors)
-  } else {
-    const prototype = Object.getPrototypeOf(value)
-    if (prototype !== Object.prototype && prototype !== null) throw new TypeError(`${label} must contain only plain objects`)
-    for (const [key, item] of Object.entries(value)) jsonValue(item, `${label}.${key}`, ancestors)
-  }
-  ancestors.delete(value)
-}
+import { defineCapabilityProtocol } from '@dsh-std/connection'
+
+export const TUI_CHANNEL = Object.freeze({
+  apiVersion: 'tui.dsh/v1alpha1',
+  kind: 'Channel',
+})
+
+export const TUI_CHANNEL_WIRE_REVISION = 6
+
+export const TUI_CHANNEL_FEATURES = Object.freeze([
+  'commands',
+  'credentials',
+  'diagnostics',
+  'files',
+  'models',
+  'modes',
+  'presets',
+  'presentation',
+  'provider-setup',
+  'scenes',
+  'session-history',
+  'session-input',
+  'session-lifecycle',
+  'session-state',
+  'settings',
+  'skills',
+  'subagents',
+  'trace',
+  'workspaces',
+])
+
+export const tuiChannelDefinition = defineCapabilityProtocol({
+  ...TUI_CHANNEL,
+  validateRequirement: validateTuiChannelRequirement,
+  validateSupport: validateTuiChannelSupport,
+})
+
+export function validateTuiChannelRequirement(value) {
+  const spec = exactRecord(value, ['wireRevision', 'features'], 'Channel requirement')
+  const wireRevision = positiveInteger(spec.wireRevision, 'Channel requirement.wireRevision')
+  const features = featureList(spec.features, 'Channel requirement.features')
+  return Object.freeze({ wireRevision, features })
+}
+
+export function validateTuiChannelSupport(value) {
+  const spec = exactRecord(value, ['wireRevision', 'features'], 'Channel support')
+  const wireRevision = positiveInteger(spec.wireRevision, 'Channel support.wireRevision')
+  const features = featureList(spec.features, 'Channel support.features')
+  return Object.freeze({ wireRevision, features })
+}
+
+export function validateTuiChannelInput(operation, value) {
+  switch (operation) {
+    case 'open': {
+      const input = exactRecord(value, ['workspace', 'sessionId', 'options'], 'Channel.open input')
+      optionalString(input.workspace, 'Channel.open input.workspace')
+      optionalString(input.sessionId, 'Channel.open input.sessionId')
+      if (input.options !== undefined) jsonValue(input.options, 'Channel.open input.options', new Set())
+      return input
+    }
+    case 'subscribe': {
+      const input = exactRecord(value, ['channelId', 'afterVersion'], 'Channel.subscribe input')
+      nonEmpty(input.channelId, 'Channel.subscribe input.channelId')
+      nonNegativeInteger(input.afterVersion, 'Channel.subscribe input.afterVersion')
+      return input
+    }
+    case 'invoke': {
+      const input = exactRecord(value, ['channelId', 'method', 'arguments'], 'Channel.invoke input')
+      nonEmpty(input.channelId, 'Channel.invoke input.channelId')
+      nonEmpty(input.method, 'Channel.invoke input.method')
+      if (!Array.isArray(input.arguments)) throw new TypeError('Channel.invoke input.arguments must be an array')
+      jsonValue(input.arguments, 'Channel.invoke input.arguments', new Set())
+      return input
+    }
+    case 'close': {
+      const input = exactRecord(value, ['channelId'], 'Channel.close input')
+      nonEmpty(input.channelId, 'Channel.close input.channelId')
+      return input
+    }
+    default:
+      throw new TypeError(`Channel operation ${JSON.stringify(operation)} is not defined`)
+  }
+}
+
+export function validateTuiChannelSnapshot(value) {
+  const snapshot = exactRecord(value, ['wireRevision', 'channelId', 'version', 'state'], 'Channel snapshot')
+  positiveInteger(snapshot.wireRevision, 'Channel snapshot.wireRevision')
+  nonEmpty(snapshot.channelId, 'Channel snapshot.channelId')
+  nonNegativeInteger(snapshot.version, 'Channel snapshot.version')
+  const state = exactRecord(snapshot.state, Object.keys(snapshot.state ?? {}), 'Channel snapshot.state')
+  jsonValue(state, 'Channel snapshot.state', new Set())
+  return snapshot
+}
+
+export function validateTuiChannelOutput(operation, value) {
+  if (operation === 'open' || operation === 'subscribe') return validateTuiChannelSnapshot(value)
+  if (operation === 'invoke') {
+    const output = exactRecord(value, ['value', 'valueDefined', 'snapshot'], 'Channel.invoke output')
+    jsonValue(output.value, 'Channel.invoke output.value', new Set())
+    if (output.valueDefined !== undefined && typeof output.valueDefined !== 'boolean') {
+      throw new TypeError('Channel.invoke output.valueDefined must be boolean')
+    }
+    if (output.snapshot !== undefined) validateTuiChannelSnapshot(output.snapshot)
+    return output
+  }
+  if (operation === 'close') {
+    const output = exactRecord(value, ['closed'], 'Channel.close output')
+    if (output.closed !== true) throw new TypeError('Channel.close output.closed must be true')
+    return output
+  }
+  throw new TypeError(`Channel operation ${JSON.stringify(operation)} is not defined`)
+}
+
+function exactRecord(value, allowed, label) {
+  if (typeof value !== 'object' || value === null || Array.isArray(value)) throw new TypeError(`${label} must be an object`)
+  const unknown = Object.keys(value).filter(key => !allowed.includes(key) && !key.startsWith('x-'))
+  if (unknown.length > 0) throw new TypeError(`${label} contains unknown field ${JSON.stringify(unknown[0])}`)
+  return value
+}
+
+function featureList(value, label) {
+  if (!Array.isArray(value) || value.length === 0) throw new TypeError(`${label} must be a non-empty array`)
+  const features = value.map((feature, index) => {
+    nonEmpty(feature, `${label}[${index}]`)
+    return feature
+  })
+  if (new Set(features).size !== features.length) throw new TypeError(`${label} contains duplicates`)
+  return Object.freeze([...features].sort())
+}
+
+function positiveInteger(value, label) {
+  if (!Number.isSafeInteger(value) || value < 1) throw new TypeError(`${label} must be a positive integer`)
+  return value
+}
+
+function nonNegativeInteger(value, label) {
+  if (!Number.isSafeInteger(value) || value < 0) throw new TypeError(`${label} must be a non-negative integer`)
+  return value
+}
+
+function nonEmpty(value, label) {
+  if (typeof value !== 'string' || value.trim() === '') throw new TypeError(`${label} must be a non-empty string`)
+}
+
+function optionalString(value, label) {
+  if (value !== undefined) nonEmpty(value, label)
+}
+
+function jsonValue(value, label, ancestors) {
+  if (value === null || typeof value === 'boolean' || typeof value === 'string') return
+  if (typeof value === 'number') {
+    if (!Number.isFinite(value)) throw new TypeError(`${label} must contain only finite numbers`)
+    return
+  }
+  if (typeof value !== 'object') throw new TypeError(`${label} must be a JSON value`)
+  if (ancestors.has(value)) throw new TypeError(`${label} must not contain cycles`)
+  ancestors.add(value)
+  if (Array.isArray(value)) {
+    for (const [index, item] of value.entries()) jsonValue(item, `${label}[${index}]`, ancestors)
+  } else {
+    const prototype = Object.getPrototypeOf(value)
+    if (prototype !== Object.prototype && prototype !== null) throw new TypeError(`${label} must contain only plain objects`)
+    for (const [key, item] of Object.entries(value)) jsonValue(item, `${label}.${key}`, ancestors)
+  }
+  ancestors.delete(value)
+}

package/dsh-ecosystem-spec/protocols/tui-contributions.d.ts

@@ -1,42 +1,42 @@
-import type { ApiReference } from '@dsh-std/core'
-import type { ManifestDefinitionCatalog, ManifestObjectDefinition } from '@dsh-std/manifest'
-
-export const API_VERSION: 'tui.dsh/v1alpha1'
-export const SETTINGS_SECTION: Readonly<ApiReference & { kind: 'SettingsSection' }>
-export const SCENE: Readonly<ApiReference & { kind: 'Scene' }>
-
-export type LocalizedText = Readonly<Record<string, string>>
-export type SettingsFieldKind = 'text' | 'number' | 'boolean' | 'select'
-export interface SettingsFieldOption { readonly value: string; readonly label: string; readonly titles?: LocalizedText }
-export interface SettingsFieldSpec {
-  readonly path: readonly string[]
-  readonly label: string
-  readonly titles?: LocalizedText
-  readonly hint?: string
-  readonly hintTitles?: LocalizedText
-  readonly kind: SettingsFieldKind
-  readonly options?: readonly SettingsFieldOption[]
-  readonly placeholder?: string
-  readonly secretRef?: string
-}
-export interface SettingsSectionSpec {
-  readonly namespace: string
-  readonly title: string
-  readonly titles?: LocalizedText
-  readonly fields: readonly SettingsFieldSpec[]
-}
-export interface SettingsSectionHandler {}
-
-export interface SceneSpec { readonly title?: string; readonly titles?: LocalizedText }
-export interface SceneHandler<Props = unknown, Result = unknown> {
-  readonly component: (props: Props) => Result
-}
-
-export const settingsSectionExtensionDefinition: ManifestObjectDefinition
-export const sceneExtensionDefinition: ManifestObjectDefinition
-export const contributionExtensionDefinitions: readonly ManifestObjectDefinition[]
-export function validateSettingsSectionSpec(value: unknown): Readonly<SettingsSectionSpec>
-export function validateSceneSpec(value: unknown): Readonly<SceneSpec>
-export function registerTuiContributionExtensions(catalog: ManifestDefinitionCatalog): () => void
-export function assertSettingsSectionHandler(value: unknown): asserts value is SettingsSectionHandler
-export function assertSceneHandler(value: unknown): asserts value is SceneHandler
+import type { ApiReference } from '@dsh-std/core'
+import type { ManifestDefinitionCatalog, ManifestObjectDefinition } from '@dsh-std/manifest'
+
+export const API_VERSION: 'tui.dsh/v1alpha1'
+export const SETTINGS_SECTION: Readonly<ApiReference & { kind: 'SettingsSection' }>
+export const SCENE: Readonly<ApiReference & { kind: 'Scene' }>
+
+export type LocalizedText = Readonly<Record<string, string>>
+export type SettingsFieldKind = 'text' | 'number' | 'boolean' | 'select'
+export interface SettingsFieldOption { readonly value: string; readonly label: string; readonly titles?: LocalizedText }
+export interface SettingsFieldSpec {
+  readonly path: readonly string[]
+  readonly label: string
+  readonly titles?: LocalizedText
+  readonly hint?: string
+  readonly hintTitles?: LocalizedText
+  readonly kind: SettingsFieldKind
+  readonly options?: readonly SettingsFieldOption[]
+  readonly placeholder?: string
+  readonly secretRef?: string
+}
+export interface SettingsSectionSpec {
+  readonly namespace: string
+  readonly title: string
+  readonly titles?: LocalizedText
+  readonly fields: readonly SettingsFieldSpec[]
+}
+export interface SettingsSectionHandler {}
+
+export interface SceneSpec { readonly title?: string; readonly titles?: LocalizedText }
+export interface SceneHandler<Props = unknown, Result = unknown> {
+  readonly component: (props: Props) => Result
+}
+
+export const settingsSectionExtensionDefinition: ManifestObjectDefinition
+export const sceneExtensionDefinition: ManifestObjectDefinition
+export const contributionExtensionDefinitions: readonly ManifestObjectDefinition[]
+export function validateSettingsSectionSpec(value: unknown): Readonly<SettingsSectionSpec>
+export function validateSceneSpec(value: unknown): Readonly<SceneSpec>
+export function registerTuiContributionExtensions(catalog: ManifestDefinitionCatalog): () => void
+export function assertSettingsSectionHandler(value: unknown): asserts value is SettingsSectionHandler
+export function assertSceneHandler(value: unknown): asserts value is SceneHandler