@askdkc/dsh-cli 0.11.3

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/activityPrefs.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Persisted working-activity indicator preference, mirroring the pi
+ * working-activity extension's `~/.pi/agent/working-activity.json`
+ * (`frames` key). dsh-tui keeps its own copy at
+ * `~/.dsh-tui/working-activity.json` so the `/activity` choice survives
+ * restarts. The file is best-effort: a missing or corrupt file (or an
+ * unknown preset left behind by an older version) just falls back to the
+ * default preset.
+ */
+import { type WorkingActivityConfig } from 'dsh-working-activity/config';
+import type { Config as MountedActivityConfig } from 'dsh-working-activity';
+/**
+ * Parse a persisted `{ frames }` value; anything else yields undefined.
+ * @param text - Raw file contents.
+ * @returns The preset name when valid, else undefined.
+ */
+export declare function parseActivityFrames(text: string): string | undefined;
+/**
+ * The persisted indicator preset name, or undefined when unset or invalid.
+ * @param dir - Prefs directory (injectable for tests).
+ * @returns The persisted preset name, if any.
+ */
+export declare function readActivityFrames(dir?: string): string | undefined;
+/**
+ * Read the full pi-style working-activity config (frames / mode / features /
+ * customPhrases / customActions / narrate / thresholds) from the same JSON
+ * file the `/activity` command writes, parsed by the wa package. Best-effort:
+ * a missing or corrupt file yields undefined (callers use their defaults).
+ * @param dir - Prefs directory (injectable for tests).
+ * @returns The parsed config, or undefined when unreadable.
+ */
+export declare function readActivityConfig(dir?: string): WorkingActivityConfig | undefined;
+/**
+ * Fold the parsed user file into the mounted working-activity plugin config.
+ *
+ * The line's semantics moved into the plugin, but the file this app's own UI
+ * writes (`/activity`, the settings panel) is still where a user's feature
+ * switches live — without this fold they were parsed and silently dropped.
+ * Precedence keeps the old contract: an explicit row value wins over the
+ * file, the file fills everything the row leaves at its schema default. The
+ * flags come through `featureOn`, so the file's `mode: minimal` turns them
+ * off exactly as it did when the deleted channel sidecar built its tracker.
+ * (The sidecar also hardcoded `detailLimit: 40`, which is the plugin's own
+ * schema default — nothing to fold.)
+ *
+ * The plugin schema materializes its defaults before `apply` sees the config,
+ * so "equal to the default" is the honest reading of "the row did not set
+ * this key"; a row value explicitly set to the default is indistinguishable
+ * from an unset one and the file wins there. None of these keys are set by
+ * the shipped rows.
+ * @param config - Schema-resolved row config for the mounted plugin.
+ * @param file - Parsed user preferences (undefined when unreadable/absent).
+ * @returns the config to mount the plugin with.
+ */
+export declare function mergeActivityPreferences(config: MountedActivityConfig, file: WorkingActivityConfig | undefined): MountedActivityConfig;
+/**
+ * Persist the chosen indicator preset (best effort).
+ * @param name - Preset name to persist.
+ * @param dir - Prefs directory (injectable for tests).
+ * @returns True when the file was written, false on failure.
+ */
+export declare function writeActivityFrames(name: string, dir?: string): boolean;
+//# sourceMappingURL=activityPrefs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activityPrefs.d.ts","sourceRoot":"","sources":["../../src/activityPrefs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAwD,KAAK,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AAC9H,OAAO,KAAK,EAAE,MAAM,IAAI,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAK3E;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASpE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAkB,GAAG,MAAM,GAAG,SAAS,CAM9E;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAkB,GAAG,qBAAqB,GAAG,SAAS,CAM7F;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,qBAAqB,EAC7B,IAAI,EAAE,qBAAqB,GAAG,SAAS,GACtC,qBAAqB,CA2BvB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAkB,GAAG,OAAO,CAQlF"}