@dsh-workbench/core 1.1.3 → 1.1.5

package/dist/types/app/layouts/approval-detail.d.ts

@@ -1,4 +1,4 @@
-import type { ApprovalInput, ReactNode, Translate } from '@dsh-workbench/shared';
+import type { ApprovalInput, ReactNode, Translate, UnitManifest, UnitToolOpencli } from '@dsh-workbench/shared';
 import type { MarketSourcesPayload, PublishPreview } from '../../kernel/contract/market-index';
 export interface ApprovalRow {
     readonly label: string;
@@ -12,6 +12,9 @@ export interface ApprovalPlanView {
     readonly warn?: string | undefined;
 }
 export declare function marketSourceRows(tool: string, args: Readonly<Record<string, unknown>>, payload: MarketSourcesPayload | null | undefined, t: Translate): readonly ApprovalRow[];
+export declare function pluginToolIndexOf(manifests: readonly UnitManifest[]): ReadonlyMap<string, UnitToolOpencli>;
+export declare function pluginApprovalRows(origin: UnitToolOpencli, args: Readonly<Record<string, unknown>>, t: Translate): readonly ApprovalRow[];
+export declare function shellApprovalRenderer(manifests: () => readonly UnitManifest[]): (input: ApprovalInput, t: Translate) => ReactNode;
 export declare function shellClaimsApprovalDetail(tool: string): boolean;
-export declare function shellApprovalPlan(input: ApprovalInput, t: Translate): ApprovalPlanView | undefined;
-export declare function shellApprovalDetail(input: ApprovalInput, t: Translate): ReactNode;
+export declare function shellApprovalPlan(input: ApprovalInput, t: Translate, pluginTools?: ReadonlyMap<string, UnitToolOpencli> | undefined): ApprovalPlanView | undefined;
+export declare function shellApprovalDetail(input: ApprovalInput, t: Translate, pluginTools?: ReadonlyMap<string, UnitToolOpencli> | undefined): ReactNode;

package/dist/types/app/layouts/market/add-module-registry-prefs.d.ts

@@ -0,0 +1,11 @@
+import { type RegistryChoice, type RegistryOption } from './add-module-text';
+export interface RegistryPrefs {
+    readonly choice: RegistryChoice;
+    readonly custom: string;
+}
+export declare const DEFAULT_REGISTRY_CHOICE: RegistryChoice;
+export declare function parseRegistryChoice(raw: string | null): RegistryChoice;
+export declare function readRegistryPrefs(): RegistryPrefs;
+export declare function writeRegistryChoice(choice: RegistryChoice): void;
+export declare function writeRegistryCustom(value: string): void;
+export declare function reconcileRegistryChoice(choice: RegistryChoice, choices: readonly RegistryOption[]): RegistryChoice;

package/dist/types/app/layouts/market/discover-confirm.d.ts

@@ -1,5 +1,5 @@
 import type { Translate } from '@dsh-workbench/shared';
-import type { DiscoverEntry, DiscoverVersionRow } from '../../../kernel/contract/market-index';
+import type { DiscoverEntry, DiscoverVersionRow, GitTransportKind } from '../../../kernel/contract/market-index';
 export interface DiscoverChoice {
     readonly entry: DiscoverEntry;
     readonly version: DiscoverVersionRow;
@@ -8,7 +8,8 @@ export interface DiscoverConfirmProps {
     readonly t: Translate;
     readonly locale: string;
     readonly choice: DiscoverChoice | null;
+    readonly transports: Readonly<Record<string, GitTransportKind>>;
     readonly onCancel: () => void;
     readonly onConfirm: (url?: string) => void;
 }
-export declare function DiscoverConfirm({ t, locale, choice, onCancel, onConfirm }: DiscoverConfirmProps): JSX.Element | null;
+export declare function DiscoverConfirm({ t, locale, choice, transports, onCancel, onConfirm }: DiscoverConfirmProps): JSX.Element | null;

package/dist/types/app/layouts/market/market-check.d.ts

@@ -0,0 +1,12 @@
+import type { Translate } from '@dsh-workbench/shared';
+import type { LatestCheckSummary } from '../rightbar/market-rows';
+export interface MarketCheckProps {
+    readonly t: Translate;
+    readonly checkedAt: number | null;
+    readonly latestCheck?: LatestCheckSummary | undefined;
+    readonly checking: boolean;
+    readonly failed: boolean;
+    readonly disabled: boolean;
+    readonly onCheck: () => void;
+}
+export declare function MarketCheck({ t, checkedAt, latestCheck, checking, failed, disabled, onCheck, }: MarketCheckProps): JSX.Element;

package/dist/types/app/layouts/market/market-header.d.ts

@@ -5,9 +5,7 @@ export interface MarketHeaderProps {
     readonly idPrefix: string;
     readonly tab: MarketTab;
     readonly busy: boolean;
-    readonly checking: boolean;
     readonly onTab: (tab: MarketTab) => void;
-    readonly onReload: () => void;
     readonly onAdd: () => void;
 }
-export declare function MarketHeader({ t, idPrefix, tab, busy, checking, onTab, onReload, onAdd }: MarketHeaderProps): JSX.Element;
+export declare function MarketHeader({ t, idPrefix, tab, busy, onTab, onAdd }: MarketHeaderProps): JSX.Element;

package/dist/types/app/layouts/market/use-discover.d.ts

@@ -1,5 +1,5 @@
 import type { Translate } from '@dsh-workbench/shared';
-import type { DiscoverEntry, DiscoverPayload, DiscoverVersionRow, MarketSourceConfig } from '../../../kernel/contract/market-index';
+import type { DiscoverEntry, DiscoverPayload, DiscoverVersionRow, GitTransportKind, MarketSourceConfig } from '../../../kernel/contract/market-index';
 import { type DiscoverSort } from './discover-view';
 interface InstallTarget {
     readonly entry: DiscoverEntry;
@@ -25,6 +25,7 @@ export interface DiscoverController {
     readonly failure: string | null;
     readonly sources: DiscoverPayload['sources'];
     readonly selected: string | null;
+    readonly transports: Readonly<Record<string, GitTransportKind>>;
     readonly entries: readonly DiscoverEntry[];
     readonly shown: readonly DiscoverEntry[];
     readonly total: number;

package/dist/types/app/layouts/market/use-git-transport.d.ts

@@ -1,4 +1,4 @@
-import type { GitProbeStatus, MarketIndexGitSource } from '../../../kernel/contract/market-index';
+import type { GitProbeStatus, GitTransportKind, MarketIndexGitSource } from '../../../kernel/contract/market-index';
 export type TransportProbe = GitProbeStatus | 'checking' | 'unknown';
 export interface GitTransportRow {
     readonly kind: 'https' | 'ssh';
@@ -16,4 +16,4 @@ export interface GitTransportState {
     setCustom(value: string): void;
     checkCustom(): void;
 }
-export declare function useGitTransport(source: MarketIndexGitSource | null): GitTransportState;
+export declare function useGitTransport(source: MarketIndexGitSource | null, preferredKind?: GitTransportKind | undefined): GitTransportState;

package/dist/types/app/layouts/market/use-module-versions.d.ts

@@ -1,4 +1,5 @@
 import type { ModuleVersion, WorkbenchSelfUpdate, WorkbenchVersion } from '../../../kernel/contract/bundle-install';
+import type { MarketInstalledModule } from '../../../kernel/contract/market-index';
 import type { InstalledPlugin } from '../../../shared/api/installed-plugins';
 export interface ModuleVersionsState {
     readonly modules: readonly ModuleVersion[] | null;
@@ -7,6 +8,7 @@ export interface ModuleVersionsState {
     readonly selfUpdate: WorkbenchSelfUpdate | null;
     readonly read: boolean;
     readonly checking: boolean;
+    readonly failed: boolean;
     readonly checkedAt: number | null;
 }
 export interface ModuleVersionsView extends ModuleVersionsState {
@@ -19,5 +21,6 @@ export declare function bumpModuleVersionsEpoch(): void;
 export declare function moduleVersionsValue(): ModuleVersionsState;
 export declare function resetModuleVersions(): void;
 export declare function subscribeModuleVersions(listener: () => void): () => void;
+export declare function withMarketUpdates(modules: readonly ModuleVersion[], rows: readonly MarketInstalledModule[]): readonly ModuleVersion[];
 export declare function runModuleVersionsRead(force?: boolean, fresh?: boolean): Promise<void>;
 export declare function useModuleVersions(): ModuleVersionsView;

package/dist/types/app/layouts/market/use-settling-modules.d.ts

@@ -0,0 +1 @@
+export declare function useSettlingModules(installedKey: string, rosterKey: string, activeKey: string): ReadonlySet<string>;

package/dist/types/app/layouts/rightbar/AskAgentButton.d.ts

@@ -0,0 +1,6 @@
+import type { Translate } from '@dsh-workbench/shared';
+export declare function AskAgentButton({ t, text, label, }: {
+    readonly t: Translate;
+    readonly text: string;
+    readonly label: string;
+}): JSX.Element;

package/dist/types/app/layouts/rightbar/FailureCard.d.ts

@@ -0,0 +1,8 @@
+import type { Translate } from '@dsh-workbench/shared';
+import type { InstallFailure } from '@dsh-workbench/shared';
+export declare function FailureCard({ t, failure, onRecheck, rechecking, }: {
+    readonly t: Translate;
+    readonly failure: InstallFailure;
+    readonly onRecheck: () => void;
+    readonly rechecking: boolean;
+}): JSX.Element;

package/dist/types/app/layouts/rightbar/MarketView.d.ts

@@ -20,14 +20,17 @@ export interface MarketViewProps {
     }) => void;
     readonly onPending?: ((pending: boolean) => void) | undefined;
     readonly updates?: ModuleUpdateMap | undefined;
+    readonly updatesCheckedAt?: number | null | undefined;
+    readonly updatesFailed?: boolean | undefined;
     readonly installed?: readonly InstalledWorkbenchModule[] | undefined;
     readonly installedRead?: boolean | undefined;
     readonly workbench?: WorkbenchVersion | null | undefined;
     readonly selfUpdate?: WorkbenchSelfUpdate | null | undefined;
     readonly plugins?: readonly InstalledPlugin[] | null | undefined;
     readonly settling?: ReadonlySet<string> | undefined;
+    readonly installing?: boolean | undefined;
     readonly mock?: MarketMock | undefined;
     readonly defaults?: readonly string[] | undefined;
     readonly changed?: Readonly<Record<string, number>> | undefined;
 }
-export declare function MarketView({ t, titleOf, manifests, installable, capabilities, freshness, onChanged, onPending, updates, installed, installedRead, workbench, selfUpdate, plugins, settling, mock, defaults, changed, }: MarketViewProps): JSX.Element;
+export declare function MarketView({ t, titleOf, manifests, installable, capabilities, freshness, onChanged, onPending, updates, updatesCheckedAt, updatesFailed, installed, installedRead, workbench, selfUpdate, plugins, settling, installing, mock, defaults, changed, }: MarketViewProps): JSX.Element;

package/dist/types/app/layouts/rightbar/SharedSection.d.ts

@@ -1,11 +1,14 @@
 import type { Translate } from '@dsh-workbench/shared';
 import { type SharedRow } from './market-rows';
+import type { MarketFailure } from './market-row-types';
 import { type Pending } from './market-view-text';
 import type { MarketRowAction } from './market-rows';
-export declare function SharedSection({ t, rows, pending, failureOf, act, }: {
+export declare function SharedSection({ t, rows, pending, failureOf, act, onRecheck, rechecking, }: {
     readonly t: Translate;
     readonly rows: readonly SharedRow[];
     readonly pending: Pending | null;
-    readonly failureOf: (id: string) => string | null;
+    readonly failureOf: (id: string) => MarketFailure | null;
     readonly act: (id: string, action: MarketRowAction) => Promise<void>;
+    readonly onRecheck: () => void;
+    readonly rechecking: boolean;
 }): JSX.Element | null;

package/dist/types/app/layouts/rightbar/failure-card-text.d.ts

@@ -0,0 +1,14 @@
+import type { InstallFailure, Translate } from '@dsh-workbench/shared';
+export interface FailureCardModel {
+    readonly title: string;
+    readonly fact: string;
+    readonly fixLabel: string;
+    readonly fix: string;
+    readonly copiedHint: string;
+    readonly command: string;
+    readonly output: string;
+    readonly exitCode: number | null;
+}
+export declare function shellPath(path: string): string;
+export declare function ownerLabel(uid: number): string;
+export declare function failureCardOf(failure: InstallFailure, t: Translate): FailureCardModel;

package/dist/types/app/layouts/rightbar/market-act.d.ts

@@ -1,15 +1,12 @@
 import type { Translate, WriteOutcome } from '@dsh-workbench/shared';
-import type { MarketRow } from './market-row-types';
+import type { MarketFailure, MarketRow } from './market-row-types';
 import { type MarketRowAction } from './market-rows';
 import { type HeldRow, type Pending } from './market-view-text';
 export interface MarketActSeats {
     readonly setPending: (next: Pending | null) => void;
     readonly setHeld: (next: HeldRow | undefined) => void;
     readonly setConfirming: (next: string | null) => void;
-    readonly setFailed: (next: {
-        readonly id: string;
-        readonly message: string;
-    } | null) => void;
+    readonly setFailed: (next: MarketFailure | null) => void;
     readonly setNotice: (next: string | null) => void;
 }
 export interface MarketActOptions {

package/dist/types/app/layouts/rightbar/market-change.d.ts

@@ -2,3 +2,4 @@ import type { Translate } from '@dsh-workbench/shared';
 import type { BundleChange } from '../../../kernel/contract/bundle-install';
 export declare function changeOf(value: unknown): BundleChange | undefined;
 export declare function changeFailure(change: BundleChange | undefined, t: Translate): string | undefined;
+export declare function appliedUnitsOf(value: unknown): readonly string[];

package/dist/types/app/layouts/rightbar/market-freshness.d.ts

@@ -1,6 +1,7 @@
 import type { Translate } from '@dsh-workbench/shared';
 export declare const MARKET_STALE_MS = 600000;
 export declare function checkedAgoText(at: number, now: number, t: Translate): string;
+export declare function checkedAgo(at: number, t: Translate): string;
 export interface MarketFreshness {
     readonly loaded: boolean;
     readonly checking: boolean;

package/dist/types/app/layouts/rightbar/market-hint.d.ts

@@ -13,5 +13,7 @@ export interface MarketHintInput {
     readonly plugins?: readonly InstalledPlugin[] | null | undefined;
     readonly workbench?: WorkbenchVersion | null | undefined;
     readonly busy?: ReadonlySet<string> | undefined;
+    readonly installing?: boolean | undefined;
+    readonly applied?: ReadonlySet<string> | undefined;
 }
 export declare function marketHintOf(input: MarketHintInput): PanelHint | null;

package/dist/types/app/layouts/rightbar/market-install.d.ts

@@ -0,0 +1,11 @@
+export interface MarketInstallState {
+    readonly installing: boolean;
+    readonly applied: ReadonlySet<string>;
+}
+export declare function marketInstallState(): MarketInstallState;
+export declare function subscribeMarketInstall(listener: () => void): () => void;
+export declare function publishMarketInstalling(token: string, active: boolean): void;
+export declare function publishMarketApplied(units: readonly string[]): void;
+export declare function resetMarketInstall(): void;
+export declare function useMarketInstallState(): MarketInstallState;
+export declare function usePublishMarketInstalling(token: string, active: boolean): void;

package/dist/types/app/layouts/rightbar/market-row-types.d.ts

@@ -1,8 +1,15 @@
 import type { ModuleUpdateBlock } from '../../../kernel/contract/bundle-install';
-export type MarketRowAction = 'install' | 'update' | 'update-bundle' | 'remove-bundle' | 'uninstall' | 'update-dependency' | 'update-plugin' | 'uninstall-plugin' | 'update-workbench' | 'migrate-workbench' | 'dismiss-followup';
+import type { MarketInstalledModule } from '../../../kernel/contract/market-index';
+import type { InstallFailure } from '@dsh-workbench/shared';
+export interface MarketFailure {
+    readonly id: string;
+    readonly message: string;
+    readonly failure?: InstallFailure;
+}
+export type MarketRowAction = 'install' | 'update' | 'update-bundle' | 'install-version' | 'remove-bundle' | 'uninstall' | 'update-dependency' | 'update-plugin' | 'uninstall-plugin' | 'update-workbench' | 'migrate-workbench' | 'dismiss-followup';
 export type MarketState = 'checking' | 'installed' | 'inactive' | 'unusable' | 'broken' | 'outdated' | 'pending-restart' | 'pending-followup' | 'missing' | 'unchecked' | 'unknown';
 export interface MarketNote {
-    readonly key: 'panels.market.needEnv' | 'panels.market.noSource' | 'panels.market.badSource' | 'panels.market.needCommands' | 'panels.market.needBinary' | 'panels.market.needLib' | 'panels.market.moduleRefused' | 'panels.market.moduleRestartHint' | 'panels.market.pluginAlsoKnownAs' | 'panels.market.pluginBroken';
+    readonly key: 'panels.market.needEnv' | 'panels.market.noSource' | 'panels.market.badSource' | 'panels.market.needCommands' | 'panels.market.needBinary' | 'panels.market.needLib' | 'panels.market.moduleRefused' | 'panels.market.moduleRestartHint' | 'panels.market.pluginAlsoKnownAs' | 'panels.market.pluginBroken' | 'panels.market.latestNoRegistry' | 'panels.market.latestProbeFailed';
     readonly params: Readonly<Record<string, string>>;
     readonly tone?: 'plain' | 'alert';
 }
@@ -12,6 +19,7 @@ export interface ModuleUpdate {
     readonly latest?: string;
     readonly local?: boolean;
     readonly blocked?: ModuleUpdateBlock;
+    readonly market?: MarketInstalledModule;
 }
 export interface MarketFollowUp {
     readonly id: string;
@@ -35,6 +43,7 @@ export interface MarketRow {
         readonly latest?: string;
     };
     readonly moduleUpdate?: ModuleUpdate;
+    readonly market?: MarketInstalledModule;
     readonly pkg?: string;
     readonly local?: boolean;
     readonly versionLabel?: string;

package/dist/types/app/layouts/rightbar/market-rows.d.ts

@@ -1,4 +1,5 @@
-import type { ModuleUpdateBlock, ModuleVersion } from '../../../kernel/contract/bundle-install';
+import type { LatestUnavailable, ModuleUpdateBlock, ModuleVersion } from '../../../kernel/contract/bundle-install';
+import type { MarketInstalledModule } from '../../../kernel/contract/market-index';
 import type { Translate, UnitManifest, UnitTitle } from '@dsh-workbench/shared';
 import type { MarketNameMap } from './market-names';
 import type { MarketRow, MarketRowAction, MarketState, ModuleUpdate } from './market-row-types';
@@ -18,9 +19,11 @@ export interface InstalledWorkbenchModule {
     readonly title?: UnitTitle | undefined;
     readonly latest?: string | undefined;
     readonly latestBlocked?: ModuleUpdateBlock | undefined;
+    readonly latestUnavailable?: LatestUnavailable | undefined;
     readonly local?: boolean | undefined;
     readonly refused?: readonly string[] | undefined;
     readonly clientRefused?: readonly string[] | undefined;
+    readonly market?: MarketInstalledModule | undefined;
 }
 export declare function withClientRefusals(modules: readonly InstalledWorkbenchModule[], refusals: readonly {
     readonly unit: string;
@@ -29,8 +32,14 @@ export declare function withClientRefusals(modules: readonly InstalledWorkbenchM
 }[]): readonly InstalledWorkbenchModule[];
 export declare function refusalReasons(host: readonly string[] | undefined, client: readonly string[] | undefined): readonly string[];
 export declare function installedIdSet(installed: readonly InstalledWorkbenchModule[] | undefined): ReadonlySet<string> | null;
+export interface LatestCheckSummary {
+    readonly checked: number;
+    readonly unknown: number;
+}
+export declare function latestCheckSummary(modules: readonly InstalledWorkbenchModule[] | undefined): LatestCheckSummary;
 export declare function installedRows(modules: readonly InstalledWorkbenchModule[], manifests: readonly UnitManifest[], listed: ReadonlySet<string>, names?: MarketNameMap | undefined, defaults?: ReadonlySet<string>, changed?: Readonly<Record<string, number>>): MarketRow[];
 export declare function marketSwitchLocked(row: MarketRow): boolean;
+export declare function marketAsksAgent(row: MarketRow): boolean;
 export declare function marketActions(row: MarketRow): MarketRowAction[];
 export declare function capabilityOutdated(capabilities: CapabilityMap | null, unit: string): boolean;
 export declare function marketCatalog(manifests: readonly UnitManifest[], installable: ReadonlySet<string> | null | undefined): readonly UnitManifest[];
@@ -44,4 +53,8 @@ export interface MarketSection {
 }
 export declare function marketOrder(rows: readonly MarketRow[], titleOf: (row: MarketRow) => string): MarketRow[];
 export declare function marketSections(rows: readonly MarketRow[]): MarketSection[];
+export declare function checkingRows(rows: readonly MarketRow[], scope: {
+    readonly all: boolean;
+    readonly units: ReadonlySet<string>;
+}): MarketRow[];
 export declare function marketRows(manifests: readonly UnitManifest[], capabilities: CapabilityMap | null, updates?: ModuleUpdateMap, defaults?: ReadonlySet<string>, changed?: Readonly<Record<string, number>>): MarketRow[];

package/dist/types/app/layouts/rightbar/market-section.d.ts

@@ -1,18 +1,22 @@
-import type { Translate } from '@dsh-workbench/shared';
-import type { MarketRow } from './market-row-types';
+import type { ReactNode, Translate } from '@dsh-workbench/shared';
+import type { MarketFailure, MarketRow } from './market-row-types';
 import { type MarketRowAction } from './market-rows';
 import type { MarketSectionIcon } from './market-section-icon';
 import { type Pending } from './market-view-text';
-export declare function MarketSection({ t, titleKey, icon, rows, pending, failureOf, act, confirmActions, onConfirming, onDefault, boardBusy, }: {
+export declare function MarketSection({ t, titleKey, icon, rows, pending, failureOf, act, confirmActions, onConfirming, onDefault, boardBusy, headAction, keepHead, onRecheck, rechecking, }: {
     readonly t: Translate;
     readonly titleKey?: string;
     readonly icon?: MarketSectionIcon;
     readonly rows: readonly MarketRow[];
     readonly pending: Pending | null;
-    readonly failureOf: (id: string) => string | null;
+    readonly failureOf: (id: string) => MarketFailure | null;
     readonly act: (id: string, action: MarketRowAction) => Promise<void>;
     readonly onDefault?: ((id: string, next: boolean) => void) | undefined;
     readonly boardBusy?: boolean | undefined;
     readonly confirmActions: readonly MarketRowAction[];
     readonly onConfirming: (id: string | null) => void;
+    readonly headAction?: ReactNode;
+    readonly keepHead?: boolean;
+    readonly onRecheck: () => void;
+    readonly rechecking: boolean;
 }): JSX.Element | null;

package/dist/types/app/layouts/rightbar/market-transient-state.d.ts

@@ -1,18 +1,13 @@
 import type { MarketMock } from './market-mock';
 import type { Pending } from './market-view-text';
+import type { MarketFailure } from './market-row-types';
 export interface MarketTransient {
     readonly pending: Pending | null;
     readonly setPending: (next: Pending | null) => void;
     readonly confirming: string | null;
     readonly setConfirming: (next: string | null) => void;
-    readonly failed: {
-        readonly id: string;
-        readonly message: string;
-    } | null;
-    readonly setFailed: (next: {
-        readonly id: string;
-        readonly message: string;
-    } | null) => void;
+    readonly failed: MarketFailure | null;
+    readonly setFailed: (next: MarketFailure | null) => void;
     readonly notice: string | null;
     readonly setNotice: (next: string | null) => void;
 }

package/dist/types/app/layouts/rightbar/market-view-text.d.ts

@@ -48,3 +48,5 @@ export declare function pendingRowOf(input: {
     readonly rows: readonly MarketRow[];
     readonly names: MarketNameMap;
 }): MarketRow | undefined;
+export declare function askAgentReason(row: MarketRow, t: Translate): string;
+export declare function askAgentText(row: MarketRow, t: Translate): string;

package/dist/types/app/layouts/rightbar/use-market-default.d.ts

@@ -0,0 +1,12 @@
+import type { Translate } from '@dsh-workbench/shared';
+export interface MarketDefaultSeat {
+    readonly pending: boolean;
+    setDefault(id: string, next: boolean): Promise<void>;
+}
+export declare function useMarketDefault(input: {
+    readonly t: Translate;
+    readonly mocked: boolean;
+    readonly defaults: readonly string[];
+    readonly changed: Readonly<Record<string, number>>;
+    readonly setNotice: (next: string | null) => void;
+}): MarketDefaultSeat;

package/dist/types/kernel/client/registry.d.ts

@@ -11,6 +11,7 @@ export interface ClientUnitRegistry {
     register(face: UnitClientFace): () => void;
     all(): readonly UnitClientFace[];
     manifests(): readonly UnitManifest[];
+    declared(): readonly UnitManifest[];
     installable(): ReadonlySet<string> | null;
     refusals(): readonly ClientUnitRefusal[];
     setManifests(manifests: readonly UnitManifest[], installable?: readonly string[]): void;

package/dist/types/kernel/contract/bundle-install.d.ts

@@ -1,2 +1,2 @@
 export { BUNDLE_REGISTRIES_ROUTE, BUNDLE_INSPECT_ROUTE, BUNDLE_REGISTRY_DEFAULT, MODULE_VERSIONS_ROUTE, SELF_UPDATE_STATES, RESTART_REASONS } from '@dsh-workbench/shared/contract/protocol/bundle-install';
-export type { BundleRegistry, BundleRegistries, BundleInspectProblem, BundleSpecKind, BundleInspectionAccepted, BundleInspectionRefused, BundleInspectionPlugin, BundleInspection, BundleRegistriesPayload, BundleInspectionPayload, BundleApplication, SelfUpdateState, WorkbenchSelfUpdate, RestartReason, BundleChangeStage, BundleFailureKind, BundlePackageResult, BundleChange, BundleInstallRequest, BundleCancellation, BundleSupplyState, BundleModulePayload, BundleSupplyPayload, BundleInstalledPlugin, BundleInstallPayload, BundleRemovePayload, BundleCancellationPayload, ModuleVersion, ModuleUpdateBlock, WorkbenchVersion, ModuleVersionsPayload } from '@dsh-workbench/shared/contract/protocol/bundle-install';
+export type { BundleRegistry, BundleRegistries, BundleInspectProblem, BundleSpecKind, BundleInspectionAccepted, BundleInspectionRefused, BundleInspectionPlugin, BundleInspection, BundleRegistriesPayload, BundleInspectionPayload, BundleApplication, SelfUpdateState, WorkbenchSelfUpdate, RestartReason, BundleChangeStage, BundleFailureKind, BundlePackageResult, BundleChange, BundleInstallRequest, BundleCancellation, BundleSupplyState, BundleModulePayload, BundleSupplyPayload, BundleInstalledPlugin, BundleInstallPayload, BundleRemovePayload, BundleCancellationPayload, LatestUnavailable, ModuleVersion, ModuleUpdateBlock, WorkbenchVersion, ModuleVersionsPayload } from '@dsh-workbench/shared/contract/protocol/bundle-install';

package/dist/types/kernel/contract/market-index.d.ts

@@ -1,2 +1,2 @@
-export { MARKET_DISCOVER_ROUTE, MARKET_DOC_ROUTE, MARKET_GIT_PROBE_ROUTE, MARKET_INDEX_FORMAT, MARKET_INDEX_PATH, MARKET_PUBLISH_PREVIEW_ROUTE, MARKET_SOURCES_RESOURCE, MARKET_SOURCES_ROUTE, MARKET_WORKBENCH_LABEL, } from '@dsh-workbench/shared/contract/protocol/market-index';
-export type { DiscoverCompat, DiscoverDoc, DiscoverDocKind, DiscoverEntry, DiscoverFilter, DiscoverInstallState, DiscoverPayload, DiscoverProblem, DiscoverSourceRow, DiscoverState, DiscoverVersionRow, GitProbePayload, GitProbeStatus, IndexSourceSpec, MarketClaim, MarketIndex, MarketIndexCategory, MarketIndexEngines, MarketIndexEntry, MarketIndexEntryMetadata, MarketIndexGitSource, MarketIndexLabel, MarketIndexMetadata, MarketIndexNpmSource, MarketIndexParse, MarketIndexProblem, MarketIndexProblemKind, MarketIndexSortKey, MarketIndexSource, MarketIndexVersion, MarketLocalizedText, MarketPublishDestination, MarketSourceConfig, MarketSourceKind, MarketSourcePolicy, MarketSourcesAction, MarketSourcesPayload, PublishChangelog, PublishPreview, } from '@dsh-workbench/shared/contract/protocol/market-index';
+export { MARKET_DISCOVER_ROUTE, MARKET_DOC_ROUTE, MARKET_GIT_PROBE_ROUTE, MARKET_INSTALLED_ROUTE, MARKET_INDEX_FORMAT, MARKET_INDEX_PATH, MARKET_PUBLISH_PREVIEW_ROUTE, MARKET_SOURCES_RESOURCE, MARKET_SOURCES_ROUTE, MARKET_WORKBENCH_LABEL, } from '@dsh-workbench/shared/contract/protocol/market-index';
+export type { DiscoverCompat, DiscoverDoc, DiscoverDocKind, DiscoverEntry, DiscoverFilter, DiscoverInstallState, DiscoverPayload, DiscoverProblem, DiscoverSourceRow, DiscoverState, DiscoverVersionRow, GitProbePayload, GitProbeStatus, GitTransportKind, MarketInstalledModule, MarketInstalledPayload, IndexSourceSpec, MarketClaim, MarketIndex, MarketIndexCategory, MarketIndexEngines, MarketIndexEntry, MarketIndexEntryMetadata, MarketIndexGitSource, MarketIndexLabel, MarketIndexMetadata, MarketIndexNpmSource, MarketIndexParse, MarketIndexProblem, MarketIndexProblemKind, MarketIndexSortKey, MarketIndexSource, MarketIndexVersion, MarketLocalizedText, MarketPublishDestination, MarketSourceConfig, MarketSourceKind, MarketSourcePolicy, MarketSourcesAction, MarketSourcesPayload, PublishChangelog, PublishPreview, } from '@dsh-workbench/shared/contract/protocol/market-index';

package/dist/types/modules/panels/model/market-install-error.d.ts

@@ -0,0 +1,3 @@
+import type { InstallFailure } from '@dsh-workbench/shared';
+import { WorkbenchDataError } from '@dsh-workbench/shared/host';
+export declare function installError(failure: InstallFailure): WorkbenchDataError;

package/dist/types/modules/panels/model/market-install-error.test.d.ts

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

package/dist/types/modules/panels/model/market-installed.d.ts

@@ -0,0 +1,19 @@
+import type { GitTransportKind, MarketIndex, MarketInstalledModule, MarketInstalledPayload, MarketSourceConfig } from '@dsh-workbench/shared/contract/protocol/market-index';
+import type { RouteTable } from '@dsh-workbench/shared/host';
+import type { ProfileModule } from '@dsh-workbench/shared/host';
+import type { GitProbeStatus } from '@dsh-workbench/shared/contract/protocol/market-index';
+export interface InstalledIndexInput {
+    readonly sources: readonly MarketSourceConfig[];
+    readonly cached: (source: MarketSourceConfig) => MarketIndex | undefined;
+    readonly modules: readonly ProfileModule[];
+    readonly dependencyOf: (pkg: string) => string | undefined;
+    readonly isNewer: (latest: string, installed: string) => boolean;
+    readonly probe?: ((url: string) => Promise<GitProbeStatus>) | undefined;
+    readonly preferred?: ((host: string) => GitTransportKind | undefined) | undefined;
+}
+export declare function installedFromIndexes(input: InstalledIndexInput): Promise<readonly MarketInstalledModule[]>;
+export declare function marketInstalledRoutes(read: () => MarketInstalledPayload | Promise<MarketInstalledPayload>): RouteTable;
+export declare function transportOfSpec(spec: string): {
+    readonly host: string;
+    readonly kind: GitTransportKind;
+} | undefined;

package/dist/types/modules/panels/model/market-installed.test.d.ts

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

package/dist/types/modules/panels/model/market-registry.d.ts

@@ -3,10 +3,11 @@ import type { BundleManager } from '@dsh-workbench/shared/host';
 import type { RegistryNotebook } from '@dsh-workbench/shared/host';
 export interface RegistryFixDeps {
     readonly registries?: RegistryNotebook | undefined;
+    readonly profileDir?: string | null | undefined;
     readonly logger?: {
         info?(message: string): void;
         warn?(message: string): void;
     } | undefined;
 }
-export declare function rememberInstalledSource(deps: RegistryFixDeps, manager: BundleManager, pkg: string, registry: string | undefined): Promise<void>;
+export declare function rememberInstalledSource(deps: RegistryFixDeps, manager: BundleManager, pkg: string, registry: string | undefined, version?: string | undefined): Promise<void>;
 export declare function retryAfterRegistryFix(deps: RegistryFixDeps, manager: BundleManager, pkg: string, change: BundleChange): Promise<BundleChange>;

package/dist/types/modules/panels/model/market-remove.d.ts

@@ -0,0 +1,13 @@
+import type { BundleChange } from '../../../kernel/contract/bundle-install';
+import type { BundleManager } from '@dsh-workbench/shared/host';
+import { type RegistryFixDeps } from './market-registry';
+export interface RemoveBundleOptions {
+    readonly manager: BundleManager;
+    readonly pkg: string;
+    readonly profileDir?: string | null | undefined;
+    readonly registryFix: RegistryFixDeps;
+    readonly logger?: {
+        warn?(message: string): void;
+    } | undefined;
+}
+export declare function removeDshBundle(options: RemoveBundleOptions): Promise<BundleChange>;

package/dist/types/modules/panels/model/market-remove.test.d.ts

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

package/dist/types/modules/panels/model/market-route.d.ts

@@ -22,9 +22,10 @@ export interface BundleInstallDeps {
     readonly ledger?: PluginLedger | undefined;
     readonly runAll: (commands: readonly PluginSourceCommand[]) => Promise<void>;
     readonly supplyAfter: (module: InstalledModule, change: BundleChange) => Promise<BundleSupply>;
-    readonly rememberSource: (manager: BundleManager, pkg: string, registry: string | undefined) => Promise<void>;
+    readonly rememberSource: (manager: BundleManager, pkg: string, registry: string | undefined, version?: string | undefined) => Promise<void>;
     readonly remove?: ((pkg: string) => Promise<BundleChange>) | undefined;
 }
+export declare function bundleNameOf(change: BundleChange, spec: string): string;
 export declare function installDshBundle(deps: Omit<BundleInstallDeps, 'spec' | 'options'>, spec: string, options?: BundleInstallOptions): Promise<BundleInstallOutcome>;
 export type ReplaceBundleDeps = Omit<BundleInstallDeps, 'spec' | 'options' | 'remove'> & {
     readonly remove: (pkg: string) => Promise<BundleChange>;

package/dist/types/modules/panels/model/market.d.ts

@@ -25,6 +25,7 @@ export declare function createMarketService(options: {
     modules?: (() => readonly ProfileModule[]) | undefined;
     workbench?: ((pkg: string) => ProfilePackage | undefined) | undefined;
     registries?: RegistryNotebook | undefined;
+    profileDir?: string | null | undefined;
     ledger?: PluginLedger | undefined;
     references?: (() => PluginReferences) | undefined;
     dshHome?: (() => string) | undefined;

package/dist/types/shared/api/host/git-probe.d.ts

@@ -4,3 +4,6 @@ export declare function classifyGitProbe(stderr: string, timedOut: boolean): Git
 export declare function probeGitAddress(shell: DshShell, url: string, options?: {
     readonly timeoutMs?: number;
 }): Promise<GitProbePayload>;
+export declare function probeGitAddressCached(shell: DshShell, url: string, options?: {
+    readonly timeoutMs?: number;
+}): Promise<GitProbePayload>;

package/dist/types/shared/api/host/market-sources-store.d.ts

@@ -1,4 +1,4 @@
-import type { MarketSourcesAction, MarketSourcesPayload } from '@dsh-workbench/shared/contract/protocol/market-index';
+import type { GitTransportKind, MarketSourcesAction, MarketSourcesPayload } from '@dsh-workbench/shared/contract/protocol/market-index';
 export type MarketSourcesWrite = Exclude<MarketSourcesAction, {
     readonly action: 'init';
 } | {
@@ -7,6 +7,7 @@ export type MarketSourcesWrite = Exclude<MarketSourcesAction, {
 export interface MarketSourcesStore {
     read(): MarketSourcesPayload;
     apply(action: MarketSourcesWrite): Promise<MarketSourcesPayload>;
+    rememberTransport(host: string, kind: GitTransportKind): Promise<void>;
 }
 export interface MarketSourcesStoreOptions {
     readonly root: string;

package/dist/types/shared/api/host/profile-dependencies.d.ts

@@ -0,0 +1 @@
+export declare function dependencyReader(profileDir: string | null): (pkg: string) => string | undefined;

package/dist/types/shared/hooks/market-queries.d.ts

@@ -1,10 +1,11 @@
 import type { ApiResponse } from '@dsh-workbench/shared';
-import { type DiscoverDoc, type DiscoverDocKind, type DiscoverPayload, type GitProbePayload, type MarketSourcesPayload, type PublishPreview } from '../../kernel/contract/market-index';
+import { type DiscoverDoc, type DiscoverDocKind, type DiscoverPayload, type GitProbePayload, type MarketInstalledPayload, type MarketSourcesPayload, type PublishPreview } from '../../kernel/contract/market-index';
 export declare function readMarketDiscover(options?: {
     readonly force?: boolean;
 }): Promise<ApiResponse<DiscoverPayload>>;
 export declare function readMarketSources(): Promise<ApiResponse<MarketSourcesPayload>>;
 export declare function readGitProbe(url: string): Promise<ApiResponse<GitProbePayload>>;
+export declare function readMarketInstalled(): Promise<ApiResponse<MarketInstalledPayload>>;
 export declare function readMarketDoc(name: string, version: string, kind: DiscoverDocKind): Promise<ApiResponse<{
     readonly doc: DiscoverDoc;
 }>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/core",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "description": "个人工作台：Agent 工作台（左栏 + 常驻对话 + 自研右侧数据面板）。",
   "type": "module",
   "icon": "./icon.svg",
@@ -100,8 +100,8 @@
     "proper-lockfile": "^4.1.2",
     "which": "^7.0.0",
     "write-file-atomic": "^8.0.0",
-    "@dsh-workbench/shared": "1.1.3",
-    "@dsh-workbench/adapters-default": "1.1.3"
+    "@dsh-workbench/shared": "1.1.5",
+    "@dsh-workbench/adapters-default": "1.1.5"
   },
   "license": "MIT",
   "repository": {

package/skills/workbench-module-diy/TOOLS.md

@@ -108,18 +108,27 @@
     ]
   },
   { "kind": "lib", "name": "opencli-workflow", "purpose": "发布编排" },
-  { "kind": "bin", "name": "acme", "purpose": "平台命令" },
+  {
+    "kind": "bin",
+    "name": "acme",
+    "purpose": "平台命令",
+    "install": { "kind": "command", "line": "brew install acme/tap/cli", "platforms": ["darwin"] },
+    "docs": "https://internal/acme-cli"
+  },
   { "kind": "env", "name": "ACME_TOKEN", "purpose": "访问令牌", "secret": true }
 ]
 ```
 
 - `sources` 按顺序试（本地 → 私有 → 公共）。没写 `sources` 就是「我自己装，你只帮我判」——外壳只探不代装。
+- `bin` 想让人一键装，就写 `install.line`（一条能直接粘进终端的命令，`platforms` 可限定平台）；
+  不写就只显示「缺这条命令」，按钮都不会有。`docs` 是给人和 agent 看的补充链接。
 - `extension` 的 `sources[].kind` 只有 `npm` / `git` / `local`；`lib` 只认 `npm`。
   未知 `kind` 或 `source.kind` 判红；need 里未知字段只警告，`x-` 前缀忽略。
 - 未装好文案由模块写：`libInstallCommand({ need, source })`（`@dsh-workbench/shared/host`）拼好源与缓存目录，
   原样输出；放进失败态。
 - `contracts` 判据：`apiVersion` 必须是 3；`needs` 走同一份 `NEED_KINDS` 注册表校验（`purpose` 必填、
-  `bin`/`env` 不许带 `sources`、`lib` 只认 npm 源）；声明了 `lib` 必须用 `libInstallCommand`。
+  `bin`/`env` 不许带 `sources`（`bin` 要代装就写 `install`）、`lib` 只认 npm 源）；
+  声明了 `lib` 必须用 `libInstallCommand`。
   未知 `runtime` 不判红：探针会给「这个运行时工作台还不认识」的 `unchecked`，等运行时 provider 补上。
 
 ## 9 长任务