@deepseek-harness-tui/dsh-tui 0.8.0 → 0.8.2

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

@@ -0,0 +1,143 @@
+/** dsh-TUI private, lifecycle-owned manifest contribution definitions. */
+
+export const API_VERSION = 'tui.dsh/v1alpha1'
+
+export const SETTINGS_SECTION = Object.freeze({
+  apiVersion: API_VERSION,
+  kind: 'SettingsSection',
+})
+
+export const SCENE = Object.freeze({
+  apiVersion: API_VERSION,
+  kind: 'Scene',
+})
+
+export const settingsSectionExtensionDefinition = Object.freeze({
+  ...SETTINGS_SECTION,
+  validateMetadata(metadata) {
+    contributionName(metadata?.name, 'SettingsSection metadata.name')
+  },
+  validateSpec: validateSettingsSectionSpec,
+})
+
+export function validateSettingsSectionSpec(value) {
+  const spec = exactRecord(value, ['namespace', 'title', 'titles', 'fields'], 'SettingsSection content')
+  contributionName(spec.namespace, 'SettingsSection content.namespace')
+  nonEmpty(spec.title, 'SettingsSection content.title')
+  localized(spec.titles, 'SettingsSection content.titles')
+  if (!Array.isArray(spec.fields)) throw new TypeError('SettingsSection content.fields must be an array')
+  return Object.freeze({
+    namespace: spec.namespace,
+    title: spec.title,
+    ...(spec.titles === undefined ? {} : { titles: freezeRecord(spec.titles) }),
+    fields: Object.freeze(spec.fields.map((field, index) => validateSettingsField(field, index))),
+  })
+}
+
+export const sceneExtensionDefinition = Object.freeze({
+  ...SCENE,
+  validateMetadata(metadata) {
+    contributionName(metadata?.name, 'Scene metadata.name')
+  },
+  validateSpec: validateSceneSpec,
+})
+
+export function validateSceneSpec(value) {
+  const spec = exactRecord(value, ['title', 'titles'], 'Scene content')
+  if (spec.title !== undefined) nonEmpty(spec.title, 'Scene content.title')
+  localized(spec.titles, 'Scene content.titles')
+  return Object.freeze({
+    ...(spec.title === undefined ? {} : { title: spec.title }),
+    ...(spec.titles === undefined ? {} : { titles: freezeRecord(spec.titles) }),
+  })
+}
+
+export const contributionExtensionDefinitions = Object.freeze([
+  settingsSectionExtensionDefinition,
+  sceneExtensionDefinition,
+])
+
+export function registerTuiContributionExtensions(catalog) {
+  const disposers = contributionExtensionDefinitions.map(definition => catalog.registerExtension(definition))
+  return () => { for (const dispose of disposers.reverse()) dispose() }
+}
+
+export function assertSettingsSectionHandler(value) {
+  runtimeObject(value, 'SettingsSection handler')
+}
+
+export function assertSceneHandler(value) {
+  const handler = runtimeObject(value, 'Scene handler')
+  if (typeof handler.component !== 'function') throw new TypeError('Scene handler.component must be a function')
+}
+
+function validateSettingsField(value, index) {
+  const label = `SettingsSection spec.fields[${index}]`
+  const field = exactRecord(value, [
+    'path', 'label', 'titles', 'hint', 'hintTitles', 'kind', 'options', 'placeholder', 'secretRef',
+  ], label)
+  if (!Array.isArray(field.path) || field.path.length === 0
+    || field.path.some(segment => typeof segment !== 'string' || segment.length === 0)) {
+    throw new TypeError(`${label}.path must be a non-empty string array`)
+  }
+  nonEmpty(field.label, `${label}.label`)
+  localized(field.titles, `${label}.titles`)
+  if (field.hint !== undefined) nonEmpty(field.hint, `${label}.hint`)
+  localized(field.hintTitles, `${label}.hintTitles`)
+  if (!['text', 'number', 'boolean', 'select'].includes(field.kind)) {
+    throw new TypeError(`${label}.kind is invalid`)
+  }
+  if (field.placeholder !== undefined && typeof field.placeholder !== 'string') {
+    throw new TypeError(`${label}.placeholder must be a string`)
+  }
+  if (field.secretRef !== undefined) nonEmpty(field.secretRef, `${label}.secretRef`)
+  if (field.options !== undefined) {
+    if (!Array.isArray(field.options)) throw new TypeError(`${label}.options must be an array`)
+    for (const [optionIndex, valueOption] of field.options.entries()) {
+      const option = exactRecord(valueOption, ['value', 'label', 'titles'], `${label}.options[${optionIndex}]`)
+      nonEmpty(option.value, `${label}.options[${optionIndex}].value`)
+      nonEmpty(option.label, `${label}.options[${optionIndex}].label`)
+      localized(option.titles, `${label}.options[${optionIndex}].titles`)
+    }
+  }
+  return Object.freeze(structuredClone(field))
+}
+
+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 runtimeObject(value, label) {
+  if ((typeof value !== 'object' && typeof value !== 'function') || value === null || Array.isArray(value)) {
+    throw new TypeError(`${label} must be an object`)
+  }
+  return value
+}
+
+function contributionName(value, label) {
+  if (typeof value !== 'string' || !/^[a-z][a-z0-9_-]*$/u.test(value)) {
+    throw new TypeError(`${label} is invalid`)
+  }
+}
+
+function nonEmpty(value, label) {
+  if (typeof value !== 'string' || value.trim() === '') throw new TypeError(`${label} must be a non-empty string`)
+}
+
+function localized(value, label) {
+  if (value === undefined) return
+  const record = exactRecord(value, Object.keys(value), label)
+  for (const [locale, text] of Object.entries(record)) {
+    if (locale.trim() === '') throw new TypeError(`${label} contains an empty locale`)
+    nonEmpty(text, `${label}.${locale}`)
+  }
+}
+
+function freezeRecord(value) {
+  return Object.freeze({ ...value })
+}

package/dsh-ecosystem-spec/registry/README.md

@@ -0,0 +1,14 @@
+# dsh-TUI Admission Protocol Profile
+
+[`registry-0.15.json`](registry-0.15.json) 不是全局协议注册表。它描述本 TUI admission profile 使用的 definition 集合：
+
+- `imports` 引用固定 dsh-std revision 已提供的 definitions；
+- `definitions` 只收录 dsh-TUI 私有 definitions。
+
+导入条目不复制 dsh-std 的 schema 或 contract 正文。Community v0.15 的 `Command`、`LocalStorage`、`MessageObserver`、Presentation 与 Workspace 定义分别由 `@dsh-std/command`、`@dsh-std/storage`、`@dsh-std/messages`、`@dsh-std/presentation` 与 `@dsh-std/workspace` 注册。
+
+本地 definition 的 contract profile 使用 SHA-256 固定。修改 profile 内容必须更新 digest，并按兼容性决定保留坐标或发布新 `apiVersion`。digest 只证明字节一致，不证明发布者身份。
+
+`tui.dsh/*` 是 dsh-TUI 私有 namespace。私有 definition 与公共 definition 一样注册到 dsh-std `ProtocolCatalog`；目录收录本身不产生 live support。
+
+权限目录仍是 TUI authorization policy 的输入。permission grant 与 protocol support 分开判断，安装 definition 不自动授权操作。

package/dsh-ecosystem-spec/registry/contracts/decision-events-v1alpha1.json

@@ -0,0 +1,13 @@
+{
+  "name":"tui.decision-events","version":"v1alpha1","kind":"capability",
+  "coordinates":{"apiVersion":"tui.dsh/v1alpha1","kind":"DecisionEvents"},
+  "caller":"authorized TUI decision-point dispatcher",
+  "permissions":["session.input.intercept","session.rewind.intercept","session.switch.intercept","session.compact.intercept"],
+  "operations":[{"name":"decide","input":{"event":"private decision envelope"},"output":{"decision":"event-point-defined decision or no-opinion"}}],
+  "errors":["INTERCEPT_PERMISSION_NOT_GRANTED","DECISION_STALE","DECISION_BUDGET_EXCEEDED","INVALID_DECISION"],
+  "concurrency":"one decision chain is serialized; independent decision points may run concurrently",
+  "timeout":"the dispatcher applies an explicit per-handler and total decision budget",
+  "cleanup":"subscriptions are owned by an activation scope and removed on deactivate or grant revocation",
+  "privacyClass":"sensitive",
+  "securityBoundary":false
+}

package/dsh-ecosystem-spec/registry/contracts/scene-v1alpha1.json

@@ -0,0 +1,13 @@
+{
+  "name":"tui.scene","version":"v1alpha1","kind":"extension",
+  "coordinates":{"apiVersion":"tui.dsh/v1alpha1","kind":"Scene"},
+  "caller":"trusted in-process dsh-TUI scene shell",
+  "permissions":[],
+  "operations":["open","close","render"],
+  "errors":["SCENE_INVALID","SCENE_CONFLICT","RENDERER_INCOMPATIBLE"],
+  "concurrency":"one scene may own the full-screen surface at a time",
+  "timeout":"scene operations are local; domain calls made by a scene retain their own deadlines",
+  "cleanup":"an open scene closes when its owning facet deactivates",
+  "privacyClass":"sensitive",
+  "securityBoundary":false
+}

package/dsh-ecosystem-spec/registry/contracts/settings-section-v1alpha1.json

@@ -0,0 +1,13 @@
+{
+  "name":"tui.settings-section","version":"v1alpha1","kind":"extension",
+  "coordinates":{"apiVersion":"tui.dsh/v1alpha1","kind":"SettingsSection"},
+  "caller":"dsh-TUI settings contribution binder",
+  "permissions":[],
+  "operations":["render"],
+  "errors":["SECTION_INVALID","NAMESPACE_CONFLICT","NAMESPACE_UNAVAILABLE"],
+  "concurrency":"one active section owns each settings namespace",
+  "timeout":"not applicable to declarative rendering; writes use the settings protocol deadline",
+  "cleanup":"removing a section removes only UI metadata and preserves settings and credentials",
+  "privacyClass":"public",
+  "securityBoundary":false
+}

package/dsh-ecosystem-spec/registry/contracts/tui-channel-v1alpha1.json

@@ -0,0 +1,30 @@
+{
+  "name": "tui.channel",
+  "version": "v1alpha1",
+  "coordinates": {
+    "apiVersion": "tui.dsh/v1alpha1",
+    "kind": "Channel"
+  },
+  "kind": "capability",
+  "caller": "a negotiated TUI endpoint",
+  "permissions": [],
+  "operations": [
+    {"name": "open", "input": "workspace/session selector", "output": "complete channel snapshot"},
+    {"name": "subscribe", "input": "channel id and last observed version", "output": "snapshot progress stream"},
+    {"name": "invoke", "input": "channel method and JSON arguments", "output": "method progress, JSON result and optional snapshot"},
+    {"name": "close", "input": "channel id", "output": "closed acknowledgement"}
+  ],
+  "wireRevision": 6,
+  "features": [
+    "commands", "credentials", "diagnostics", "files", "models", "modes",
+    "presets", "presentation", "provider-setup", "scenes", "session-history", "session-input",
+    "session-lifecycle", "session-state", "settings", "skills", "subagents",
+    "trace", "workspaces"
+  ],
+  "errors": ["CHANNEL_NOT_FOUND", "FEATURE_UNAVAILABLE", "INVALID_ARGUMENT", "PERMISSION_DENIED", "REVISION_MISMATCH", "PROVIDER_FAILURE"],
+  "concurrency": "state mutations are serialized per channel; independent read operations may run concurrently",
+  "timeout": "the caller supplies connection invocation cancellation; subscriptions remain open until cancelled or closed",
+  "cleanup": "connection close or facet deactivate releases subscriptions, uploads and channel attachments",
+  "privacyClass": "sensitive",
+  "securityBoundary": false
+}

package/dsh-ecosystem-spec/registry/contracts/workspace-provider-v1alpha1.json

@@ -0,0 +1,6 @@
+{
+  "status": "superseded",
+  "coordinates": {"apiVersion": "workspace.dsh/v1alpha1", "kind": "WorkspaceProvider"},
+  "package": "@dsh-std/workspace",
+  "proposal": "vendor/dsh-std/docs/proposals/workspace.zh.md"
+}

package/dsh-ecosystem-spec/registry/host-descriptor.tui.example.json

@@ -0,0 +1,56 @@
+{
+  "$schema": "urn:dsh-tui:host-descriptor:0.15",
+  "hostId": "dsh-tui",
+  "hostVersion": "0.1.0-experimental",
+  "facetApiVersions": [
+    "v1alpha1"
+  ],
+  "contracts": [
+    {
+      "apiVersion": "storage.dsh/v1alpha1",
+      "kind": "LocalStorage",
+      "definition": {
+        "source": "dsh-std",
+        "package": "@dsh-std/storage"
+      },
+      "permissions": [
+        "storage.local.read",
+        "storage.local.write"
+      ]
+    },
+    {
+      "apiVersion": "commands.dsh/v1alpha1",
+      "kind": "Command",
+      "definition": {
+        "source": "dsh-std",
+        "package": "@dsh-std/command"
+      },
+      "permissions": [
+        "commands.invoke"
+      ]
+    },
+    {
+      "apiVersion": "messages.dsh/v1alpha1",
+      "kind": "MessageObserver",
+      "definition": {
+        "source": "dsh-std",
+        "package": "@dsh-std/messages"
+      },
+      "permissions": [
+        "messages.observe.read"
+      ]
+    }
+  ],
+  "runtime": {
+    "location": "remote",
+    "generationId": "example-generation-1",
+    "headless": true,
+    "remoteAttach": true
+  },
+  "trustLevel": "trusted-in-process",
+  "platform": {
+    "os": "linux",
+    "arch": "x64",
+    "node": ">=22.19"
+  }
+}

package/dsh-ecosystem-spec/registry/permissions-0.1.json

@@ -0,0 +1,13 @@
+{
+  "registryVersion":"0.1",
+  "permissions":[
+    {"name":"storage.local.read","default":"deny","revocable":true,"scope":"plugin namespace"},
+    {"name":"storage.local.write","default":"deny","revocable":true,"scope":"plugin namespace"},
+    {"name":"commands.invoke","default":"allow","revocable":true,"scope":"declared command id","rationale":"调用由宿主或用户通过一次 invocation 主动发起，不同于数据访问类权限——插件无法仅凭此权限被动读取任何数据，故默认允许；撤销只关闭该 command ID 的调用入口"},
+    {"name":"messages.observe.read","default":"deny","revocable":true,"scope":"message observation scope"},
+    {"name":"session.input.intercept","default":"deny","revocable":true,"scope":"decision event subscription","rationale":"拦截类订阅（RFC 0005 D-7）：能否决/改写用户输入，严格强于观察，故默认拒绝；TUI 实验实现见 tui.dsh.decision-events"},
+    {"name":"session.rewind.intercept","default":"deny","revocable":true,"scope":"decision event subscription","rationale":"同 session.input.intercept——可否决会话回退或注入回退模式"},
+    {"name":"session.switch.intercept","default":"deny","revocable":true,"scope":"decision event subscription","rationale":"同 session.input.intercept——可否决会话切换"},
+    {"name":"session.compact.intercept","default":"deny","revocable":true,"scope":"decision event subscription","rationale":"同 session.input.intercept——可否决手动压缩"}
+  ]
+}

package/dsh-ecosystem-spec/registry/registry-0.15.json

@@ -0,0 +1,149 @@
+{
+  "profileVersion": "tui-admission/0.15",
+  "std": {
+    "repository": "https://github.com/Yan-Zero/dsh-std",
+    "submodule": "vendor/dsh-std",
+    "manifestVersion": "0.15"
+  },
+  "imports": [
+    {
+      "name": "commands",
+      "coordinates": {
+        "apiVersion": "commands.dsh/v1alpha1",
+        "kind": "Command"
+      },
+      "package": "@dsh-std/command",
+      "kind": "capability",
+      "permissions": [
+        "commands.invoke"
+      ]
+    },
+    {
+      "name": "storage.local",
+      "coordinates": {
+        "apiVersion": "storage.dsh/v1alpha1",
+        "kind": "LocalStorage"
+      },
+      "package": "@dsh-std/storage",
+      "kind": "capability",
+      "permissions": [
+        "storage.local.read",
+        "storage.local.write"
+      ]
+    },
+    {
+      "name": "messages.observe",
+      "coordinates": {
+        "apiVersion": "messages.dsh/v1alpha1",
+        "kind": "MessageObserver"
+      },
+      "package": "@dsh-std/messages",
+      "kind": "event",
+      "permissions": [
+        "messages.observe.read"
+      ],
+      "eventEnvelope": "@dsh-std/messages/schema/message-observer-envelope-0.15.json"
+    },
+    {
+      "name": "presentation.open-external",
+      "coordinates": {
+        "apiVersion": "presentation.dsh/v1alpha1",
+        "kind": "OpenExternal"
+      },
+      "package": "@dsh-std/presentation",
+      "kind": "capability",
+      "permissions": []
+    },
+    {
+      "name": "presentation.user-interaction",
+      "coordinates": {
+        "apiVersion": "presentation.dsh/v1alpha1",
+        "kind": "UserInteraction"
+      },
+      "package": "@dsh-std/presentation",
+      "kind": "capability",
+      "permissions": []
+    },
+    {
+      "name": "presentation.external-redirect",
+      "coordinates": {
+        "apiVersion": "presentation.dsh/v1alpha1",
+        "kind": "ExternalRedirect"
+      },
+      "package": "@dsh-std/presentation",
+      "kind": "capability",
+      "permissions": []
+    }
+  ],
+  "definitions": [
+    {
+      "name": "tui.decision-events",
+      "authority": "dsh-tui",
+      "coordinates": {
+        "apiVersion": "tui.dsh/v1alpha1",
+        "kind": "DecisionEvents"
+      },
+      "kind": "capability",
+      "profile": "registry/contracts/decision-events-v1alpha1.json",
+      "profileHash": "sha256:56440dde1b00c210b22761a0cba139ce0a20207330567777cebe1e48b494ceb0",
+      "permissions": [
+        "session.input.intercept",
+        "session.rewind.intercept",
+        "session.switch.intercept",
+        "session.compact.intercept"
+      ]
+    },
+    {
+      "name": "tui.channel",
+      "authority": "dsh-tui",
+      "coordinates": {
+        "apiVersion": "tui.dsh/v1alpha1",
+        "kind": "Channel"
+      },
+      "kind": "capability",
+      "profile": "registry/contracts/tui-channel-v1alpha1.json",
+      "profileHash": "sha256:2d0668656d999a8cacd363cd3c76207f9392118be8a83e6dd5f81b54ae063fe6",
+      "permissions": []
+    }
+  ],
+  "extensions": [
+    {
+      "name": "workspace.provider",
+      "authority": "dsh-std",
+      "coordinates": {
+        "apiVersion": "workspace.dsh/v1alpha1",
+        "kind": "WorkspaceProvider"
+      },
+      "kind": "extension",
+      "package": "@dsh-std/workspace",
+      "permissions": []
+    },
+    {
+      "name": "tui.settings-section",
+      "authority": "dsh-tui",
+      "coordinates": {
+        "apiVersion": "tui.dsh/v1alpha1",
+        "kind": "SettingsSection"
+      },
+      "kind": "extension",
+      "profile": "registry/contracts/settings-section-v1alpha1.json",
+      "profileHash": "sha256:685b0f17fe489f458e9b799811f61c42b858330584e95ecb97e7216b5be100ac",
+      "permissions": []
+    },
+    {
+      "name": "tui.scene",
+      "authority": "dsh-tui",
+      "coordinates": {
+        "apiVersion": "tui.dsh/v1alpha1",
+        "kind": "Scene"
+      },
+      "kind": "extension",
+      "profile": "registry/contracts/scene-v1alpha1.json",
+      "profileHash": "sha256:69ce3ae26d60dea2ed170376db8a1fb5860c94bd192c62681423c1d848ec2b26",
+      "permissions": []
+    }
+  ],
+  "facetApiVersions": [
+    "v1alpha1"
+  ]
+}

package/dsh-ecosystem-spec/schemas/conformance-claim.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema":"https://json-schema.org/draft/2020-12/schema",
+  "$id":"https://dsh.community/schemas/conformance-claim-0.15.json",
+  "title":"DSH Conformance Claim v0.15",
+  "type":"object","additionalProperties":false,
+  "required":["claimVersion","subject","specVersion","hostDescriptorDigest","artifactDigest","suiteVersion","evidenceLevel","result","testedAt"],
+  "properties":{
+    "claimVersion":{"const":"0.15"},"subject":{"type":"string"},"specVersion":{"const":"community-v0.15"},
+    "hostDescriptorDigest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},"artifactDigest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},
+    "suiteVersion":{"type":"string"},"evidenceLevel":{"enum":["Declared","Parsed","Negotiated","Tested","Observed","Attested"]},
+    "result":{"enum":["pass","fail"]},"testedAt":{"type":"string","format":"date-time"},"runtime":{"type":"string"},
+    "signer":{"type":"string"},"expiresAt":{"type":"string","format":"date-time"},"revoked":{"type":"boolean"},
+    "failedRequirements":{"type":"array","items":{"type":"string"}}
+  }
+}

package/dsh-ecosystem-spec/schemas/effect-ledger-record.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema":"https://json-schema.org/draft/2020-12/schema",
+  "$id":"https://dsh.community/schemas/effect-ledger-record-0.15.json",
+  "title":"DSH Effect Ledger Record v0.15",
+  "type":"object","additionalProperties":false,
+  "required":["ledgerVersion","sequence","timestamp","pluginId","activationInstance","runtimeGenerationId","operation","resource","result"],
+  "properties":{
+    "ledgerVersion":{"const":"0.15"},"sequence":{"type":"integer","minimum":0},"timestamp":{"type":"string","format":"date-time"},
+    "pluginId":{"type":"string","minLength":1,"maxLength":128},"activationInstance":{"type":"string","minLength":1,"maxLength":128},"runtimeGenerationId":{"type":"string","pattern":"^[A-Za-z0-9._:-]+$","maxLength":128},
+    "operation":{"enum":["create","bind","replace","release","cleanup-failed"]},
+    "resource":{"type":"object","additionalProperties":false,"required":["kind","id"],"properties":{"kind":{"type":"string","minLength":1,"maxLength":64},"id":{"type":"string","minLength":1,"maxLength":128}}},
+    "replaces":{"type":"object","additionalProperties":false,"properties":{"resourceId":{"type":"string","minLength":1,"maxLength":128},"activationInstance":{"type":"string","minLength":1,"maxLength":128}}},
+    "result":{"enum":["applied","pending","failed"]},"errorCode":{"type":"string","minLength":1,"maxLength":64},
+    "valueDigest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"}
+  }
+}

package/dsh-ecosystem-spec/schemas/host-descriptor.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema":"https://json-schema.org/draft/2020-12/schema",
+  "$id":"urn:dsh-tui:host-descriptor:0.15",
+  "title":"dsh-TUI Admission Host Descriptor v0.15",
+  "type":"object","additionalProperties":false,
+  "required":["$schema","hostId","hostVersion","facetApiVersions","contracts","runtime","trustLevel","platform"],
+  "properties":{
+    "$schema":{"type":"string","const":"urn:dsh-tui:host-descriptor:0.15"},
+    "hostId":{"type":"string","pattern":"^[a-z0-9]+([.-][a-z0-9]+)*$"},
+    "hostVersion":{"type":"string","minLength":1},
+    "facetApiVersions":{"type":"array","items":{"type":"string","pattern":"^v[0-9]+(?:alpha[0-9]+|beta[0-9]+)?$"},"minItems":1,"uniqueItems":true},
+    "contracts":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["apiVersion","kind","definition","permissions"],"properties":{
+      "apiVersion":{"type":"string","pattern":"^[a-z][a-z0-9.-]*/v[0-9]+(?:alpha[0-9]+|beta[0-9]+)?$"},
+      "kind":{"type":"string","pattern":"^[A-Z][A-Za-z0-9]*$"},
+      "spec":{},
+      "definition":{"oneOf":[
+        {"type":"object","additionalProperties":false,"required":["source","package"],"properties":{"source":{"const":"dsh-std"},"package":{"type":"string","pattern":"^@dsh-std/"}}},
+        {"type":"object","additionalProperties":false,"required":["source","profileHash"],"properties":{"source":{"const":"tui-profile"},"profileHash":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"}}}
+      ]},
+      "permissions":{"type":"array","items":{"type":"string"},"uniqueItems":true}
+    }},"uniqueItems":true},
+    "runtime":{"type":"object","additionalProperties":false,"required":["location","generationId","headless"],"properties":{"location":{"enum":["local","remote","container"]},"generationId":{"type":"string","pattern":"^[A-Za-z0-9._:-]+$"},"headless":{"type":"boolean"},"remoteAttach":{"type":"boolean"}}},
+    "trustLevel":{"enum":["trusted-in-process"]},
+    "platform":{"type":"object","additionalProperties":false,"required":["os","arch"],"properties":{"os":{"type":"string"},"arch":{"type":"string"},"node":{"type":"string"}}}
+  }
+}

package/lib/types/cc/figures.d.ts

@@ -17,6 +17,10 @@ export declare const POINTER = "\u276F";
 export declare const TICK = "\u2713";
 /** Small dot for separating operators (`∙`). */
 export declare const BULLET_OPERATOR = "\u2219";
+/** Settled tool-status dot, smaller than the running pulse (`•`). */
+export declare const BULLET = "\u2022";
+/** Failed tool status (`✗`). */
+export declare const MULTIPLICATION_X = "\u2717";
 /** Teardrop asterisk, decorative list marker (`✻`). */
 export declare const TEARDROP_ASTERISK = "\u273B";
 /** Lightning bolt, "fast / hot" marker (`↯`). */

package/lib/types/cc/figures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"figures.d.ts","sourceRoot":"","sources":["../../../src/cc/figures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,uEAAuE;AACvE,eAAO,MAAM,YAAY,QAA4C,CAAA;AAGrE,kDAAkD;AAClD,eAAO,MAAM,OAAO,WAAW,CAAA;AAC/B,+BAA+B;AAC/B,eAAO,MAAM,IAAI,WAAW,CAAA;AAC5B,gDAAgD;AAChD,eAAO,MAAM,eAAe,WAAW,CAAA;AACvC,uDAAuD;AACvD,eAAO,MAAM,iBAAiB,WAAW,CAAA;AACzC,iDAAiD;AACjD,eAAO,MAAM,cAAc,WAAW,CAAA;AAGtC,sBAAsB;AACtB,eAAO,MAAM,QAAQ,WAAW,CAAA;AAChC,wBAAwB;AACxB,eAAO,MAAM,UAAU,WAAW,CAAA;AAClC,2CAA2C;AAC3C,eAAO,MAAM,aAAa,WAAW,CAAA;AACrC,qDAAqD;AACrD,eAAO,MAAM,cAAc,WAAW,CAAA;AAGtC,qCAAqC;AACrC,eAAO,MAAM,UAAU,WAAW,CAAA;AAClC,+CAA+C;AAC/C,eAAO,MAAM,aAAa,WAAW,CAAA;AACrC,wCAAwC;AACxC,eAAO,MAAM,WAAW,WAAW,CAAA;AACnC,sCAAsC;AACtC,eAAO,MAAM,UAAU,WAAW,CAAA;AAGlC,0BAA0B;AAC1B,eAAO,MAAM,SAAS,WAAW,CAAA;AACjC,2BAA2B;AAC3B,eAAO,MAAM,UAAU,WAAW,CAAA;AAGlC,uDAAuD;AACvD,eAAO,MAAM,aAAa,WAAW,CAAA;AACrC,wCAAwC;AACxC,eAAO,MAAM,UAAU,WAAW,CAAA;AAGlC,mDAAmD;AACnD,eAAO,MAAM,YAAY,WAAW,CAAA;AACpC,qDAAqD;AACrD,eAAO,MAAM,cAAc,WAAW,CAAA;AACtC,iDAAiD;AACjD,eAAO,MAAM,cAAc,WAAW,CAAA;AAGtC,wCAAwC;AACxC,eAAO,MAAM,SAAS,WAAW,CAAA;AACjC,oDAAoD;AACpD,eAAO,MAAM,cAAc,WAAW,CAAA;AACtC,mCAAmC;AACnC,eAAO,MAAM,gBAAgB,WAAW,CAAA;AAGxC,4DAA4D;AAC5D,eAAO,MAAM,qBAAqB,UAKjC,CAAA;AACD,uCAAuC;AACvC,eAAO,MAAM,sBAAsB,6BAA6B,CAAA;AAChE,qCAAqC;AACrC,eAAO,MAAM,uBAAuB,WAAW,CAAA"}
+{"version":3,"file":"figures.d.ts","sourceRoot":"","sources":["../../../src/cc/figures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,uEAAuE;AACvE,eAAO,MAAM,YAAY,QAA4C,CAAA;AAGrE,kDAAkD;AAClD,eAAO,MAAM,OAAO,WAAW,CAAA;AAC/B,+BAA+B;AAC/B,eAAO,MAAM,IAAI,WAAW,CAAA;AAC5B,gDAAgD;AAChD,eAAO,MAAM,eAAe,WAAW,CAAA;AACvC,qEAAqE;AACrE,eAAO,MAAM,MAAM,WAAW,CAAA;AAC9B,gCAAgC;AAChC,eAAO,MAAM,gBAAgB,WAAW,CAAA;AACxC,uDAAuD;AACvD,eAAO,MAAM,iBAAiB,WAAW,CAAA;AACzC,iDAAiD;AACjD,eAAO,MAAM,cAAc,WAAW,CAAA;AAGtC,sBAAsB;AACtB,eAAO,MAAM,QAAQ,WAAW,CAAA;AAChC,wBAAwB;AACxB,eAAO,MAAM,UAAU,WAAW,CAAA;AAClC,2CAA2C;AAC3C,eAAO,MAAM,aAAa,WAAW,CAAA;AACrC,qDAAqD;AACrD,eAAO,MAAM,cAAc,WAAW,CAAA;AAGtC,qCAAqC;AACrC,eAAO,MAAM,UAAU,WAAW,CAAA;AAClC,+CAA+C;AAC/C,eAAO,MAAM,aAAa,WAAW,CAAA;AACrC,wCAAwC;AACxC,eAAO,MAAM,WAAW,WAAW,CAAA;AACnC,sCAAsC;AACtC,eAAO,MAAM,UAAU,WAAW,CAAA;AAGlC,0BAA0B;AAC1B,eAAO,MAAM,SAAS,WAAW,CAAA;AACjC,2BAA2B;AAC3B,eAAO,MAAM,UAAU,WAAW,CAAA;AAGlC,uDAAuD;AACvD,eAAO,MAAM,aAAa,WAAW,CAAA;AACrC,wCAAwC;AACxC,eAAO,MAAM,UAAU,WAAW,CAAA;AAGlC,mDAAmD;AACnD,eAAO,MAAM,YAAY,WAAW,CAAA;AACpC,qDAAqD;AACrD,eAAO,MAAM,cAAc,WAAW,CAAA;AACtC,iDAAiD;AACjD,eAAO,MAAM,cAAc,WAAW,CAAA;AAGtC,wCAAwC;AACxC,eAAO,MAAM,SAAS,WAAW,CAAA;AACjC,oDAAoD;AACpD,eAAO,MAAM,cAAc,WAAW,CAAA;AACtC,mCAAmC;AACnC,eAAO,MAAM,gBAAgB,WAAW,CAAA;AAGxC,4DAA4D;AAC5D,eAAO,MAAM,qBAAqB,UAKjC,CAAA;AACD,uCAAuC;AACvC,eAAO,MAAM,sBAAsB,6BAA6B,CAAA;AAChE,qCAAqC;AACrC,eAAO,MAAM,uBAAuB,WAAW,CAAA"}

package/lib/types/cc/figures.js

@@ -18,6 +18,10 @@ export const POINTER = '\u276f'; // ❯
 export const TICK = '\u2713'; // ✓
 /** Small dot for separating operators (`∙`). */
 export const BULLET_OPERATOR = '\u2219'; // ∙
+/** Settled tool-status dot, smaller than the running pulse (`•`). */
+export const BULLET = '\u2022'; // •
+/** Failed tool status (`✗`). */
+export const MULTIPLICATION_X = '\u2717'; // ✗
 /** Teardrop asterisk, decorative list marker (`✻`). */
 export const TEARDROP_ASTERISK = '\u273b'; // ✻
 /** Lightning bolt, "fast / hot" marker (`↯`). */

package/lib/types/command-trees.d.ts

@@ -1,3 +1,4 @@
-export * from './dsh-adapter/command-trees.js';
+export { name, TuiCommandTreeRuntime } from './dsh-adapter/command-trees.js';
+export type { TuiCommandTreeProvider } from './dsh-adapter/command-trees.js';
 export { default } from './dsh-adapter/command-trees.js';
 //# sourceMappingURL=command-trees.d.ts.map

package/lib/types/command-trees.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-trees.d.ts","sourceRoot":"","sources":["../../src/command-trees.ts"],"names":[],"mappings":"AAEA,cAAc,gCAAgC,CAAA;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAA"}
+{"version":3,"file":"command-trees.d.ts","sourceRoot":"","sources":["../../src/command-trees.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AAC5E,YAAY,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAA"}

package/lib/types/command-trees.js

@@ -1,4 +1,4 @@
 // Re-export shim: the Cordis-backed implementation lives behind the adapter
 // boundary so UI consumers never import official @deepseek-ai/* packages.
-export * from './dsh-adapter/command-trees.js';
+export { name, TuiCommandTreeRuntime } from './dsh-adapter/command-trees.js';
 export { default } from './dsh-adapter/command-trees.js';

package/lib/types/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/commands.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;AAElF,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB,yEAAyE;IACzE,YAAY,CAAC,EAAE,qBAAqB,CAAA;IACpC,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,+EAA+E;AAC/E,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,qBAAqB,CAAA;IACpC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,2EAA2E;AAC3E,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,KAAK,SAAS,qBAAqB,EAAE,CAAA;AAEpG;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,YAAY,EAwDxC,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAIhG;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAIhD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,SAAS,YAAY,EAAmB,GAC7C,OAAO,CAKT;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,SAAS,YAAY,EAAmB,GAC7C,YAAY,EAAE,CAKhB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,SAAS,YAAY,EAAmB,EAC/C,QAAQ,GAAE,eAA0B,GACnC,iBAAiB,EAAE,CAoCrB"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/commands.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;AAElF,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB,yEAAyE;IACzE,YAAY,CAAC,EAAE,qBAAqB,CAAA;IACpC,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,+EAA+E;AAC/E,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,qBAAqB,CAAA;IACpC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,2EAA2E;AAC3E,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,KAAK,SAAS,qBAAqB,EAAE,CAAA;AAEpG;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,YAAY,EA0DxC,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAIhG;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAIhD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,SAAS,YAAY,EAAmB,GAC7C,OAAO,CAKT;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,SAAS,YAAY,EAAmB,GAC7C,YAAY,EAAE,CAKhB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,SAAS,YAAY,EAAmB,EAC/C,QAAQ,GAAE,eAA0B,GACnC,iBAAiB,EAAE,CAoCrB"}

package/lib/types/commands.js

@@ -23,6 +23,7 @@ export const LOCAL_COMMANDS = [
     { name: 'btw', description: 'Ask a quick side question without interrupting the conversation' },
     { name: 'trace', description: 'Show the session event trace timeline' },
     // Session / environment
+    { name: 'context', description: 'Show loaded context details' },
     { name: 'status', description: 'Show session status' },
     { name: 'cost', description: 'Show session token usage' },
     { name: 'config', description: 'Show the dsh-tui configuration source' },
@@ -48,6 +49,7 @@ export const LOCAL_COMMANDS = [
     { name: 'hooks', description: 'Show hooks status' },
     { name: 'mcp', description: 'Show MCP status' },
     { name: 'skills', description: 'List available skills' },
+    { name: 'plugins', description: 'Show plugin contract, grant, and ledger diagnostics' },
     { name: 'update', description: 'Update dsh-tui and restart' },
     // Built-in skills (CC's skill commands, driven through DSH skills)
     { name: 'audit', description: 'Run a comprehensive code audit on this project' },