@dsh-workbench/shared 0.3.11 → 1.0.0-beta.0

package/dist/contract/protocol/bundle-install.d.ts

@@ -0,0 +1,136 @@
+export declare const BUNDLE_REGISTRIES_ROUTE = "bundle-registries";
+export declare const BUNDLE_INSPECT_ROUTE = "bundle-inspect";
+export declare const BUNDLE_REGISTRY_DEFAULT = "default";
+export declare const MODULE_VERSIONS_ROUTE = "module-versions";
+export type BundleRegistry = string | null;
+export interface BundleRegistries {
+    readonly registry: BundleRegistry;
+    readonly fallbackRegistries: readonly BundleRegistry[];
+    readonly resolved: string | null;
+}
+export type BundleInspectProblem = 'invalid-spec' | 'already-installed' | 'not-found' | 'not-a-package' | 'not-a-bundle' | 'not-a-workbench-module' | 'not-a-module-or-plugin' | 'network' | 'unknown';
+export type BundleSpecKind = 'registry' | 'path' | 'git' | 'tarball';
+export interface BundleInspectionAccepted {
+    readonly status: 'accepted';
+    readonly kind: BundleSpecKind;
+    readonly name?: string;
+    readonly version?: string;
+    readonly description?: string;
+    readonly bundle: boolean | null;
+    readonly registry: BundleRegistry;
+    readonly host?: string;
+}
+export interface BundleInspectionRefused {
+    readonly status: 'refused';
+    readonly problem: BundleInspectProblem;
+    readonly reason: string;
+    readonly registries?: readonly BundleRegistry[];
+}
+export interface BundleInspectionPlugin {
+    readonly status: 'plugin';
+    readonly pkg: string;
+    readonly registry: BundleRegistry;
+    readonly pluginName?: string;
+    readonly version?: string;
+}
+export type BundleInspection = BundleInspectionAccepted | BundleInspectionRefused | BundleInspectionPlugin;
+export interface BundleRegistriesPayload {
+    readonly available: boolean;
+    readonly registries: BundleRegistries | null;
+}
+export interface BundleInspectionPayload {
+    readonly inspection: BundleInspection;
+}
+export type BundleApplication = 'applied' | 'restart-required' | 'overridden' | 'failed' | 'cancelled';
+export declare const SELF_UPDATE_STATES: readonly ["running", "ok", "rolled-back", "failed"];
+export type SelfUpdateState = (typeof SELF_UPDATE_STATES)[number];
+export interface WorkbenchSelfUpdate {
+    readonly state: SelfUpdateState;
+    readonly profile?: string;
+    readonly from?: string;
+    readonly to?: string;
+    readonly version?: string;
+    readonly at?: string;
+    readonly tail?: string;
+}
+export declare const RESTART_REASONS: readonly ["no-hmr", "package-moved", "host-module", "unmanaged-plugin", "module-comparison"];
+export type RestartReason = (typeof RESTART_REASONS)[number];
+export type BundleChangeStage = 'install' | 'enable' | 'remove';
+export type BundleFailureKind = 'pnpm-missing' | 'timeout' | 'not-found' | 'no-matching-version' | 'network' | 'disk-full' | 'permission' | 'build-blocked' | 'integrity' | 'unknown';
+export interface BundlePackageResult {
+    readonly exitCode: number;
+    readonly output: string;
+    readonly truncated: boolean;
+    readonly logPath: string;
+    readonly kind?: BundleFailureKind;
+}
+export interface BundleChange {
+    readonly application: BundleApplication;
+    readonly stage: BundleChangeStage;
+    readonly changed: boolean;
+    readonly target: string;
+    readonly bundle?: string;
+    readonly version?: string;
+    readonly errorCode?: string;
+    readonly errorDetail?: string;
+    readonly packageResult?: BundlePackageResult;
+    readonly pendingBuilds?: readonly string[];
+    readonly restartReason?: RestartReason;
+    readonly failedAt?: 'registry' | 'spec-host';
+}
+export interface BundleInstallRequest {
+    readonly spec: string;
+    readonly registry?: BundleRegistry;
+    readonly requestId?: string;
+    readonly approvedBuilds?: readonly string[];
+}
+export type BundleCancellation = 'cancelled' | 'too-late' | 'not-running';
+export type BundleSupplyState = 'not-a-module' | 'no-needs' | 'installed' | 'failed' | 'pending-restart';
+export interface BundleModulePayload {
+    readonly kind: 'module' | 'not-module' | 'unknown';
+    readonly pkg: string;
+    readonly unit?: string;
+    readonly version?: string;
+}
+export interface BundleSupplyPayload {
+    readonly state: BundleSupplyState;
+    readonly reason?: string;
+}
+export interface BundleInstalledPlugin {
+    readonly kind: 'opencli-plugin';
+    readonly pkg: string;
+    readonly name?: string;
+}
+export interface BundleInstallPayload {
+    readonly change: BundleChange;
+    readonly module: BundleModulePayload;
+    readonly supply: BundleSupplyPayload;
+    readonly plugin?: BundleInstalledPlugin;
+}
+export interface BundleRemovePayload {
+    readonly change: BundleChange;
+    readonly keptFor: readonly string[];
+}
+export interface BundleCancellationPayload {
+    readonly cancellation: BundleCancellation | null;
+}
+export interface ModuleVersion {
+    readonly unit: string;
+    readonly pkg: string;
+    readonly installed: string;
+    readonly latest?: string;
+    readonly local?: boolean;
+    readonly refused?: readonly string[];
+}
+export interface WorkbenchVersion {
+    readonly pkg: string;
+    readonly installed: string;
+    readonly latest?: string;
+    readonly running?: string;
+    readonly local?: boolean;
+}
+export interface ModuleVersionsPayload {
+    readonly modules: readonly ModuleVersion[];
+    readonly workbench?: WorkbenchVersion;
+    readonly selfUpdate?: WorkbenchSelfUpdate;
+}

package/dist/contract/protocol/bundle-install.js

@@ -0,0 +1,12 @@
+export const BUNDLE_REGISTRIES_ROUTE = 'bundle-registries';
+export const BUNDLE_INSPECT_ROUTE = 'bundle-inspect';
+export const BUNDLE_REGISTRY_DEFAULT = 'default';
+export const MODULE_VERSIONS_ROUTE = 'module-versions';
+export const SELF_UPDATE_STATES = ['running', 'ok', 'rolled-back', 'failed'];
+export const RESTART_REASONS = [
+    'no-hmr',
+    'package-moved',
+    'host-module',
+    'unmanaged-plugin',
+    'module-comparison',
+];

package/dist/contract/protocol/config-sync.d.ts

@@ -0,0 +1,55 @@
+export declare const CONFIG_SYNC_ROUTE = "config-sync";
+export declare const CONFIG_SYNC_RESOURCE = "configSync";
+export type ConfigSyncState = 'new' | 'differs' | 'same';
+export type ConfigSyncAssetState = 'missing' | 'differs' | 'same' | 'external';
+export interface ConfigSyncAssetFile {
+    readonly path: string;
+    readonly state: ConfigSyncAssetState;
+    readonly bytes: number | null;
+}
+export interface ConfigSyncAsset {
+    readonly key: string;
+    readonly path: string;
+    readonly kind: 'file' | 'dir';
+    readonly state: ConfigSyncAssetState;
+    readonly files: readonly ConfigSyncAssetFile[];
+    readonly bytes: number;
+    readonly reason?: string;
+}
+export interface ConfigSyncRow {
+    readonly key: string;
+    readonly id: string;
+    readonly insert: boolean;
+    readonly state: ConfigSyncState;
+    readonly body: string;
+    readonly ownBody: string | null;
+    readonly missing: readonly string[];
+    readonly assets: readonly ConfigSyncAsset[];
+}
+export interface ConfigSyncProfile {
+    readonly name: string;
+    readonly readable: boolean;
+    readonly candidates: number;
+}
+export interface ConfigSyncSnapshot {
+    readonly self: string;
+    readonly home: string;
+    readonly source: string;
+    readonly profiles: readonly ConfigSyncProfile[];
+    readonly rows: readonly ConfigSyncRow[];
+    readonly emptyProviders: boolean;
+    readonly reason?: string;
+}
+export interface ConfigSyncApplied {
+    readonly written: readonly string[];
+    readonly skipped: readonly string[];
+    readonly files: readonly string[];
+    readonly verified: boolean;
+}
+export interface ConfigSyncRequest {
+    readonly source: string;
+    readonly keys: readonly string[];
+    readonly overwrite: readonly string[];
+    readonly assets?: readonly string[];
+    readonly overwriteAssets?: readonly string[];
+}

package/dist/contract/protocol/config-sync.js

@@ -0,0 +1,2 @@
+export const CONFIG_SYNC_ROUTE = 'config-sync';
+export const CONFIG_SYNC_RESOURCE = 'configSync';

package/dist/contract/protocol/diy.d.ts

@@ -0,0 +1,4 @@
+export declare const DIY_PRESET_ID = "workbench-diy";
+export declare const WORKSHOP_RELATIVE = "workbench/diy";
+export declare const WORKSHOP_TITLE = "\u5DE5\u4F5C\u53F0DIY";
+export declare const WORKSHOP_PAST_TITLES: readonly string[];

package/dist/contract/protocol/diy.js

@@ -0,0 +1,4 @@
+export const DIY_PRESET_ID = 'workbench-diy';
+export const WORKSHOP_RELATIVE = 'workbench/diy';
+export const WORKSHOP_TITLE = '工作台DIY';
+export const WORKSHOP_PAST_TITLES = ['DIY 工坊', '工作台自带 · DIY 模块住这儿'];

package/dist/contract/protocol/dsh-plugins.d.ts

@@ -0,0 +1,11 @@
+export declare const DSH_PLUGINS_ROUTE = "dsh-plugins";
+export interface DshPluginRow {
+    readonly name: string;
+    readonly version: string;
+    readonly enabled: boolean;
+}
+export interface DshPluginsSnapshot {
+    readonly available: boolean;
+    readonly bundles: readonly DshPluginRow[];
+    readonly plugins: readonly DshPluginRow[];
+}

package/dist/contract/protocol/dsh-plugins.js

@@ -0,0 +1 @@
+export const DSH_PLUGINS_ROUTE = 'dsh-plugins';

package/dist/contract/protocol/long-tasks.d.ts

@@ -0,0 +1,13 @@
+import type { LongTaskStatus } from '../long-task.js';
+export declare const LONG_TASKS_ROUTE = "long-tasks";
+export interface ShellLongTaskRow {
+    readonly unit: string;
+    readonly id: string;
+    readonly workspace: string;
+    readonly target: string;
+    readonly status: LongTaskStatus;
+    readonly session?: string | undefined;
+}
+export interface ShellLongTasksPayload {
+    readonly runs: readonly ShellLongTaskRow[];
+}

package/dist/contract/protocol/long-tasks.js

@@ -0,0 +1 @@
+export const LONG_TASKS_ROUTE = 'long-tasks';

package/dist/contract/protocol/market-index.d.ts

@@ -0,0 +1,195 @@
+export declare const MARKET_INDEX_FORMAT = 1;
+export declare const MARKET_INDEX_PATH = "market.json";
+export declare const MARKET_DISCOVER_ROUTE = "panels/market-discover";
+export declare const MARKET_DOC_ROUTE = "panels/market-doc";
+export declare const MARKET_PUBLISH_PREVIEW_ROUTE = "panels/market-publish-preview";
+export declare const MARKET_SOURCES_RESOURCE = "market-sources";
+export declare const MARKET_WORKBENCH_LABEL = "workbench";
+export type MarketSourceKind = 'http' | 'git';
+export type MarketSourcePolicy = 'artifacts-in-repo' | 'catalog-only';
+export interface IndexSourceSpec {
+    readonly kind: MarketSourceKind;
+    readonly url: string;
+    readonly ref?: string;
+    readonly path?: string;
+    readonly localPath?: string;
+}
+export interface MarketSourceConfig extends IndexSourceSpec {
+    readonly id: string;
+    readonly label: string;
+    readonly policy?: MarketSourcePolicy;
+}
+export interface MarketLocalizedText {
+    readonly zh?: string;
+    readonly en?: string;
+}
+export interface MarketIndexNpmSource {
+    readonly type: 'npm';
+    readonly registry?: string;
+}
+export interface MarketIndexGitSource {
+    readonly type: 'git';
+    readonly url: string;
+    readonly commit: string;
+    readonly path?: string;
+}
+export type MarketIndexSource = MarketIndexNpmSource | MarketIndexGitSource;
+export interface MarketIndexEngines {
+    readonly dsh?: string;
+}
+export interface MarketIndexVersion {
+    readonly version: string;
+    readonly publishTimestamp?: number;
+    readonly source: MarketIndexSource;
+    readonly engines?: MarketIndexEngines;
+}
+export interface MarketIndexEntryMetadata {
+    readonly category?: string;
+    readonly labels?: readonly string[];
+    readonly keywords?: readonly string[];
+    readonly sortKeys?: Readonly<Record<string, string | number>>;
+}
+export interface MarketIndexEntry {
+    readonly name: string;
+    readonly title?: MarketLocalizedText;
+    readonly description?: MarketLocalizedText;
+    readonly author?: string;
+    readonly homepage?: string;
+    readonly icon?: string;
+    readonly metadata?: MarketIndexEntryMetadata;
+    readonly versions: readonly MarketIndexVersion[];
+}
+export interface MarketIndexCategory {
+    readonly title?: MarketLocalizedText;
+}
+export interface MarketIndexLabel {
+    readonly title?: MarketLocalizedText;
+}
+export interface MarketIndexSortKey {
+    readonly title?: MarketLocalizedText;
+    readonly order?: 'asc' | 'desc';
+}
+export interface MarketIndexMetadata {
+    readonly categories?: Readonly<Record<string, MarketIndexCategory>>;
+    readonly labels?: Readonly<Record<string, MarketIndexLabel>>;
+    readonly sortKeys?: Readonly<Record<string, MarketIndexSortKey>>;
+}
+export interface MarketIndex {
+    readonly format: 1;
+    readonly title?: MarketLocalizedText;
+    readonly description?: MarketLocalizedText;
+    readonly metadata?: MarketIndexMetadata;
+    readonly plugins: readonly MarketIndexEntry[];
+}
+export type MarketIndexProblemKind = 'not-json' | 'not-object' | 'format' | 'plugins' | 'plugin' | 'name' | 'duplicate-name' | 'versions' | 'version' | 'version-order' | 'source' | 'git-commit' | 'timestamp' | 'icon';
+export interface MarketIndexProblem {
+    readonly kind: MarketIndexProblemKind;
+    readonly detail: string;
+    readonly at?: string;
+}
+export type MarketIndexParse = {
+    readonly ok: true;
+    readonly index: MarketIndex;
+} | {
+    readonly ok: false;
+    readonly problems: readonly MarketIndexProblem[];
+};
+export type DiscoverCompat = 'ok' | 'incompatible' | 'unknown';
+export type DiscoverInstallState = 'not-installed' | 'installed' | 'update-available' | 'different-version';
+export interface DiscoverVersionRow {
+    readonly version: string;
+    readonly publishTimestamp?: number;
+    readonly source: MarketIndexSource;
+    readonly engines?: MarketIndexEngines;
+    readonly compat: DiscoverCompat;
+    readonly peer?: string;
+    readonly install: DiscoverInstallState;
+}
+export interface DiscoverEntry {
+    readonly name: string;
+    readonly title?: MarketLocalizedText;
+    readonly description?: MarketLocalizedText;
+    readonly author?: string;
+    readonly homepage?: string;
+    readonly icon?: string;
+    readonly category?: string;
+    readonly labels: readonly string[];
+    readonly installedVersion?: string;
+    readonly versions: readonly DiscoverVersionRow[];
+}
+export interface DiscoverSourceRow extends MarketSourceConfig {
+    readonly writable: boolean | null;
+}
+export type DiscoverState = 'no-source' | 'ready' | 'unreadable' | 'invalid';
+export interface DiscoverProblem {
+    readonly kind: 'no-source' | 'http-status' | 'http-network' | 'http-url' | 'git-missing' | 'git-network' | 'git-auth' | 'git-file' | 'git-empty' | 'git-missing-index' | 'format' | 'timeout' | 'unknown';
+    readonly detail?: string;
+    readonly branch?: string;
+}
+export interface DiscoverPayload {
+    readonly state: DiscoverState;
+    readonly sources: readonly DiscoverSourceRow[];
+    readonly selected: string | null;
+    readonly entries: readonly DiscoverEntry[];
+    readonly fetchedAt?: number;
+    readonly commit?: string;
+    readonly stale?: boolean;
+    readonly problem?: DiscoverProblem;
+}
+export interface DiscoverFilter {
+    readonly query?: string;
+    readonly category?: string;
+    readonly label?: string;
+}
+export interface MarketSourcesPayload {
+    readonly sources: readonly MarketSourceConfig[];
+    readonly selected: string | null;
+}
+export interface MarketPublishDestination {
+    readonly url: string;
+    readonly ref?: string;
+    readonly indexPath: string;
+    readonly artifactPath: string;
+    readonly files: readonly string[];
+    readonly nextVersion?: string;
+}
+export interface PublishChangelog {
+    readonly version: string;
+    readonly text?: string;
+    readonly missing?: boolean;
+}
+export interface PublishPreview {
+    readonly name: string;
+    readonly version: string;
+    readonly registry?: string;
+    readonly market?: MarketPublishDestination;
+    readonly changelog?: PublishChangelog;
+}
+export type DiscoverDocKind = 'readme' | 'changelog';
+export type DiscoverDoc = {
+    readonly ok: true;
+    readonly kind: DiscoverDocKind;
+    readonly version: string;
+    readonly text: string;
+} | {
+    readonly ok: false;
+    readonly kind: DiscoverDocKind;
+    readonly version: string;
+    readonly reason: 'missing' | 'unavailable';
+    readonly detail?: string;
+};
+export type MarketSourcesAction = {
+    readonly action: 'save';
+    readonly source: MarketSourceConfig;
+    readonly select?: boolean;
+} | {
+    readonly action: 'remove';
+    readonly id: string;
+} | {
+    readonly action: 'select';
+    readonly id: string | null;
+} | {
+    readonly action: 'init';
+    readonly id: string;
+    readonly ref?: string;
+};

package/dist/contract/protocol/market-index.js

@@ -0,0 +1,7 @@
+export const MARKET_INDEX_FORMAT = 1;
+export const MARKET_INDEX_PATH = 'market.json';
+export const MARKET_DISCOVER_ROUTE = 'panels/market-discover';
+export const MARKET_DOC_ROUTE = 'panels/market-doc';
+export const MARKET_PUBLISH_PREVIEW_ROUTE = 'panels/market-publish-preview';
+export const MARKET_SOURCES_RESOURCE = 'market-sources';
+export const MARKET_WORKBENCH_LABEL = 'workbench';

package/dist/contract/protocol/platform.d.ts

@@ -0,0 +1,44 @@
+export type Deployment = 'web' | 'desktop';
+export type HostOs = 'darwin' | 'win32' | 'linux' | 'other';
+export type HostRuntime = 'electron' | 'node';
+export type ClientShell = 'electron' | 'browser';
+export type ProfileName = 'desktop' | 'web' | 'workbench' | 'headless' | 'other';
+export type SelfUpdateCli = 'path-dsh' | 'desktop-cli';
+export interface HostCapabilities {
+    readonly pageDebug: boolean;
+    readonly siteExplore: boolean;
+    readonly recording: boolean;
+    readonly browserWake: boolean;
+    readonly selfUpdateCli: SelfUpdateCli;
+    readonly safeMode: boolean;
+}
+export interface ToolchainPlan {
+    readonly node: {
+        readonly source: 'desktop-shim' | 'path';
+    };
+    readonly npm: {
+        readonly neededFor: 'opencli-install';
+    };
+    readonly pnpm: {
+        readonly neededFor: 'workshop';
+        readonly expectedMajor: 10;
+    };
+}
+export interface HostSurface {
+    readonly deployment: Deployment;
+    readonly hostOs: HostOs;
+    readonly runtime: HostRuntime;
+    readonly profile: ProfileName;
+    readonly capabilities: HostCapabilities;
+    readonly restartHint: string;
+    readonly toolchain: ToolchainPlan;
+}
+export interface ClientCapabilities {
+    readonly debugFooter: boolean;
+}
+export interface ClientSurface {
+    readonly deployment: Deployment;
+    readonly shell: ClientShell;
+    readonly hostOs: HostOs;
+    readonly capabilities: ClientCapabilities;
+}

package/dist/contract/protocol/platform.js

@@ -0,0 +1 @@
+export {};

package/dist/contract/protocol/preflight-wake.d.ts

@@ -0,0 +1,7 @@
+export declare const WAKE_BROWSER_ROUTE = "wake-browser";
+export type DesktopBrowserId = 'chrome' | 'edge' | 'brave' | 'chromium' | 'vivaldi';
+export type BrowserWakeStatus = 'connected' | 'browser-open' | 'no-browser' | 'launch-failed' | 'not-connected' | 'unsupported' | 'unknown';
+export interface WakeBrowserReply {
+    readonly status: BrowserWakeStatus;
+    readonly browser?: DesktopBrowserId;
+}

package/dist/contract/protocol/preflight-wake.js

@@ -0,0 +1 @@
+export const WAKE_BROWSER_ROUTE = 'wake-browser';

package/dist/contract/protocol/profile-create.d.ts

@@ -0,0 +1,30 @@
+export declare const PROFILE_CREATE_ROUTE = "profile-create";
+export declare const PROFILE_CREATE_RESOURCE = "profileCreate";
+export interface ProfileCreateProfile {
+    readonly name: string;
+    readonly current: boolean;
+    readonly readable: boolean;
+}
+export interface ProfileCreateSnapshot {
+    readonly current: string;
+    readonly profiles: readonly ProfileCreateProfile[];
+}
+export interface ProfileCreateCopy {
+    readonly settings: boolean;
+    readonly plugins: boolean;
+    readonly projects: boolean;
+    readonly sessions: boolean;
+}
+export interface ProfileCreateRequest {
+    readonly profile: string;
+    readonly source: string;
+    readonly copy: ProfileCreateCopy;
+}
+export interface ProfileCreateApplied {
+    readonly ok: true;
+    readonly profile: string;
+    readonly source: string;
+    readonly home: string;
+    readonly command: string;
+    readonly copied: readonly string[];
+}

package/dist/contract/protocol/profile-create.js

@@ -0,0 +1,2 @@
+export const PROFILE_CREATE_ROUTE = 'profile-create';
+export const PROFILE_CREATE_RESOURCE = 'profileCreate';

package/dist/contract/protocol/sidebar-edition.d.ts

@@ -0,0 +1,14 @@
+export declare const SIDEBAR_EDITION_ROUTE = "sidebar-edition";
+export declare const SIDEBAR_EDITION_RESOURCE = "sidebarEdition";
+export type SidebarEdition = 'official' | 'custom';
+export interface SidebarEditionSnapshot {
+    readonly edition: SidebarEdition;
+}
+export interface SidebarEditionApplied {
+    readonly ok: true;
+    readonly edition: SidebarEdition;
+    readonly reloadRequired: boolean;
+}
+export interface SidebarEditionRequest {
+    readonly edition: SidebarEdition;
+}

package/dist/contract/protocol/sidebar-edition.js

@@ -0,0 +1,2 @@
+export const SIDEBAR_EDITION_ROUTE = 'sidebar-edition';
+export const SIDEBAR_EDITION_RESOURCE = 'sidebarEdition';

package/dist/contract/protocol/unit-manifests.d.ts

@@ -0,0 +1,6 @@
+import type { UnitManifest } from '../unit.js';
+export declare const UNIT_MANIFESTS_ROUTE = "unit-manifests";
+export interface UnitManifestsPayload {
+    readonly manifests: readonly UnitManifest[];
+    readonly installable: readonly string[];
+}

package/dist/contract/protocol/unit-manifests.js

@@ -0,0 +1 @@
+export const UNIT_MANIFESTS_ROUTE = 'unit-manifests';

package/dist/contract/unit-board.js

@@ -0,0 +1 @@
+export {};

package/dist/contract/unit-capability.d.ts

@@ -0,0 +1,34 @@
+import type { Need, NeedKind } from './needs.js';
+import type { ProvisionProblem } from './plugin-source.js';
+/**
+ * 一条 need 探出来的样子：状态、给人看的一句、以及能照做的修法。
+ */
+export interface NeedState {
+    readonly id: string;
+    readonly kind: NeedKind;
+    readonly name: string;
+    readonly status: 'ok' | 'missing' | 'outdated' | 'unsatisfied' | 'unchecked';
+    readonly detail: string;
+    readonly command?: string;
+    readonly missing?: readonly string[];
+    readonly installed?: string;
+    readonly latest?: string;
+    readonly provision?: 'ready' | ProvisionProblem;
+}
+/**
+ * 一个单元的能力结论：unit 一级只做汇总，缺什么逐条看 needs。
+ */
+export interface UnitCapability {
+    readonly unit: string;
+    readonly status: 'ok' | 'degraded' | 'missing' | 'outdated' | 'unchecked' | 'unsupported' | 'failed';
+    readonly needs: readonly NeedState[];
+    readonly detail?: string;
+    readonly released?: boolean;
+}
+/**
+ * 探一个单元的输入：单元 id 加它声明的 need 列表。
+ */
+export interface NeedProbeInput {
+    readonly unit: string;
+    readonly needs: readonly Need[];
+}

package/dist/contract/unit-capability.js

@@ -0,0 +1 @@
+export {};

package/dist/{host → contract}/unit-declaration.d.ts

@@ -1,8 +1,9 @@
-import type { UnitEnvNeeds, UnitHostNeeds, UnitManifest } from '../api/unit.js';
+import type { UnitHostNeeds, UnitManifest } from '../contract/unit.js';
+import { type Need } from './needs.js';
 /**
  * 声明协议当前版本；模块清单的 dsh.workbench.apiVersion 要写这个整数。
  */
-export declare const WORKBENCH_API_VERSION = 1;
+export declare const WORKBENCH_API_VERSION = 2;
 /**
  * 外壳愿意认的协议版本；不在表里的模块当场被拒，不猜语义。
  */
@@ -31,14 +32,14 @@ export interface UnitDeclaration {
     readonly card: UnitCardDeclaration | null;
     readonly tools: readonly UnitToolDeclaration[];
     readonly host: UnitHostNeeds;
-    readonly env?: UnitEnvNeeds;
+    readonly needs?: readonly Need[];
 }
 /**
- * 协议认得的全部键；写了别的键不会被采纳（外壳静默忽略），所以字段名拼错不会有提示。
+ * 协议认得的全部键；写了别的键这份清单会被拒（`protocol` 判据与运行时同一套），拼错当场报出来。
  */
 export declare const DECLARATION_KEYS: readonly string[];
 /**
- * 协议要求必写的键；env 不在其中（没有环境需要就不写）。
+ * 协议要求必写的键；needs 不在其中（没有环境需要就不写）。
  */
 export declare const DECLARATION_REQUIRED_KEYS: readonly string[];
 /**
@@ -55,6 +56,7 @@ export interface DeclarationRead {
     readonly declaration?: UnitDeclaration;
     readonly manifest?: UnitManifest;
     readonly problems: readonly string[];
+    readonly warnings: readonly string[];
 }
 /**
  * 读一份清单：先查形状，过了再把声明规整成 manifest。