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

package/dist/types/shared/api/host/package-route.d.ts

@@ -1,23 +0,0 @@
-import type { DshShell } from '@dsh-workbench/shared';
-import { type ResolvedPluginSource } from '@dsh-workbench/shared/host';
-export type PackageRouteKind = 'opencli-plugin' | 'dsh-bundle' | 'neither';
-export interface PackageRoute {
-    readonly kind: PackageRouteKind;
-    readonly pkg?: string;
-    readonly pluginName?: string;
-}
-export declare const LOCAL_PLUGIN_ENV = "DSH_WB_OPENCLI_PLUGIN_PATH";
-export declare const PLUGIN_REGISTRY_ENV = "DSH_WB_OPENCLI_PLUGIN_REGISTRY";
-export declare function packageRouteOf(options: {
-    readonly spec: string;
-    readonly shell?: DshShell | undefined;
-    readonly registry?: string | undefined;
-    readonly force?: boolean;
-}): Promise<PackageRoute | undefined>;
-export declare function resetPackageRouteCache(): void;
-export declare function pluginInstallPlan(options: {
-    readonly spec: string;
-    readonly command: string;
-    readonly registry?: string | undefined;
-    readonly pluginName?: string | undefined;
-}): ResolvedPluginSource;

package/dist/types/shared/api/host/package-route.test.d.ts

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

package/dist/types/shared/api/host/plugin-catalog.d.ts

@@ -1,65 +0,0 @@
-import type { DshShell } from '@dsh-workbench/shared';
-export interface PluginCommandArg {
-    readonly name: string;
-    readonly type: string;
-    readonly required: boolean;
-    readonly positional: boolean;
-    readonly valueRequired: boolean;
-    readonly choices: readonly string[];
-    readonly defaultValue?: unknown;
-    readonly help: string;
-}
-export interface PluginCommand {
-    readonly plugin: string;
-    readonly name: string;
-    readonly description: string;
-    readonly access: string;
-    readonly browser: boolean;
-    readonly siteSession: string;
-    readonly domain?: string;
-    readonly args: readonly PluginCommandArg[];
-}
-export interface PluginCommandSet {
-    readonly plugin: string;
-    readonly version: string;
-    readonly commands: readonly PluginCommand[];
-}
-export interface PluginRow {
-    readonly name: string;
-    readonly version: string;
-    readonly commands: readonly string[];
-}
-export interface CommandRow {
-    readonly site: string;
-    readonly name: string;
-    readonly description: string;
-    readonly access: string;
-    readonly browser: boolean;
-    readonly siteSession: string;
-    readonly domain?: string;
-    readonly args: readonly PluginCommandArg[];
-}
-export interface PluginCatalogSnapshot {
-    readonly ok: boolean;
-    readonly at: number;
-    readonly sets: readonly PluginCommandSet[];
-    readonly problems: readonly string[];
-}
-export interface PluginCatalog {
-    refresh(options?: {
-        readonly force?: boolean;
-    }): Promise<PluginCatalogSnapshot>;
-    snapshot(): PluginCatalogSnapshot;
-}
-export interface PluginCatalogOptions {
-    readonly shell?: DshShell | undefined;
-    readonly command: string;
-    readonly timeoutMs?: number;
-}
-export declare function parsePluginRows(stdout: string): PluginRow[] | undefined;
-export declare function parseCommandRows(stdout: string): CommandRow[] | undefined;
-export declare function attributeCommands(plugins: readonly PluginRow[], rows: readonly CommandRow[]): {
-    readonly sets: PluginCommandSet[];
-    readonly problems: string[];
-};
-export declare function createPluginCatalog(options: PluginCatalogOptions): PluginCatalog;

package/dist/types/shared/api/host/plugin-login-hint.d.ts

@@ -1,2 +0,0 @@
-export declare function loginUrlOfDomain(domain: string | undefined): string | undefined;
-export declare function pluginLoginHint(error: unknown, domain: string | undefined): string;

package/dist/types/shared/api/host/plugin-tools.d.ts

@@ -1,14 +0,0 @@
-import type { ApprovalDetail, ApprovalPolicy, OpencliSession } from '@dsh-workbench/shared/host';
-import type { PluginCommand } from './plugin-catalog';
-export declare const RUN_CODE_TOOL = "run_code";
-export declare const PLUGIN_PROMPT_BUDGET = 4000;
-export declare function pluginToolName(plugin: string, command: string): string;
-export declare function pluginPromptChars(command: PluginCommand): number;
-export declare function pluginToolParameters(command: PluginCommand): Record<string, unknown>;
-export declare function pluginToolDescription(command: PluginCommand): string;
-export declare function pluginToolWrites(command: PluginCommand): boolean;
-export declare function pluginToolSession(command: PluginCommand): OpencliSession;
-export declare function pluginToolArgv(command: PluginCommand, raw: unknown): string[];
-export declare function pluginKeyArgs(command: PluginCommand, raw: unknown): string;
-export declare function pluginApprovalQuestion(command: PluginCommand, raw: unknown): ApprovalDetail;
-export declare function pluginApprovalFor(command: PluginCommand): ApprovalPolicy;

package/dist/types/shared/api/host/plugin-units.d.ts

@@ -1,48 +0,0 @@
-import type { Opencli } from '@dsh-workbench/shared/host';
-import type { PluginCatalog } from './plugin-catalog';
-import type { UnitRegistry } from './unit-registry';
-export interface PluginRowRef {
-    readonly id: string;
-    readonly pkg: string;
-    readonly name?: string | undefined;
-}
-export interface PluginRowsSource {
-    listPlugins(workspace: string | null): readonly PluginRowRef[];
-    subscribe?(listener: () => void): () => void;
-}
-export interface PluginUnitRow {
-    readonly plugin: string;
-    readonly pkg: string;
-    readonly version: string;
-    readonly commands: number;
-    readonly synthesized: number;
-    readonly chars: number;
-    readonly tools: readonly string[];
-}
-export interface PluginUnitReport {
-    readonly ok: boolean;
-    readonly at: number;
-    readonly plugins: readonly PluginUnitRow[];
-    readonly problems: readonly string[];
-}
-export interface PluginUnits {
-    refresh(options?: {
-        readonly force?: boolean;
-    }): Promise<PluginUnitReport>;
-    touch(): void;
-    report(): PluginUnitReport;
-    dispose(): void;
-}
-export interface PluginUnitsOptions {
-    readonly registry: UnitRegistry;
-    readonly catalog: PluginCatalog;
-    readonly rows: () => readonly PluginRowRef[];
-    readonly declared: (plugin: string) => ReadonlySet<string>;
-    readonly opencliFor: (plugin: string) => Opencli;
-    readonly toolNames?: () => ReadonlySet<string>;
-    readonly logger?: {
-        info?(message: string): void;
-        warn?(message: string): void;
-    } | undefined;
-}
-export declare function createPluginUnits(options: PluginUnitsOptions): PluginUnits;

package/dist/types/shared/api/host/preflight-route.d.ts

@@ -1,15 +0,0 @@
-import type { DshHostContext, DshShell } from '@dsh-workbench/shared';
-import type { RouteTable } from '@dsh-workbench/shared/host';
-/**
- * 把启动体检接上 `preflight` 那条路由。
- * @param input - 路由表、宿主上下文、执行缝，以及 opencli 命令 / 装它用的命令（可选）与各套件声明的预热读命令。
- * @returns 无（路由挂在 `input.routes.preflight` 上）。
- */
-export declare function registerPreflight(input: {
-    routes: RouteTable;
-    ctx: DshHostContext;
-    shell: DshShell;
-    opencliCommand: string;
-    installCommand?: string | undefined;
-    warmReads: () => readonly (readonly string[])[];
-}): void;

package/dist/types/shared/api/host/preflight.d.ts

@@ -1,75 +0,0 @@
-import type { DshShell } from '@dsh-workbench/shared';
-import type { DiyPresetVerdict } from './diy-preset-health';
-export type PreflightStepId = 'opencli' | 'bridge' | 'diy' | 'warm';
-export type PreflightStepStatus = 'pending' | 'running' | 'ok' | 'warn' | 'failed';
-export interface PreflightStep {
-    readonly id: PreflightStepId;
-    readonly status: PreflightStepStatus;
-    readonly detail?: string;
-    readonly action?: string;
-    readonly command?: string;
-}
-export type PreflightFailure = 'permission' | 'network' | 'missing' | 'unknown';
-export declare function classifyFailure(text: string): PreflightFailure;
-export type PreflightGuidance = 'install' | 'path' | 'shell';
-export type PreflightBridgeIssue = 'daemon' | 'extension' | 'profile' | 'stale' | 'unknown';
-export declare function readBridgeReport(stdout: string): {
-    readonly ok: boolean;
-    readonly issues: readonly PreflightBridgeIssue[];
-    readonly detail: string;
-};
-/**
- * DIY 模式挂不起来时随快照送出去的那三件：挂不起来的行、dsh 给的原文、修法（升级 dsh）。
- */
-export interface PreflightDiyGap {
-    readonly rows: readonly string[];
-    readonly detail: string;
-    readonly command: string;
-}
-export interface PreflightSnapshot {
-    readonly phase: 'idle' | 'checking' | 'installing' | 'ready' | 'failed';
-    readonly steps: readonly PreflightStep[];
-    readonly at: number;
-    readonly error?: string;
-    readonly failure?: PreflightFailure;
-    readonly guidance?: PreflightGuidance;
-    readonly bridgeIssues?: readonly PreflightBridgeIssue[];
-    readonly diyGap?: PreflightDiyGap;
-}
-/**
- * 环境体检：`run()` 跑一次并回快照，`snapshot()` 看眼下这一拍。`run` 的取舍是：
- * 已经有在跑的那一轮就跟它（不再排第二轮）；上一次跑出 `ready` 且不到 `PREFLIGHT_FRESH_MS`
- * 也直接回那一份 —— 于是两页同时打开只体检一轮、第二页还不用等。`hard` 不看新鲜度、一律重来，
- * 留给用户按的那颗「重试」；上一次是失败/没跑完的也一律重来。
- */
-export interface Preflight {
-    run(options?: {
-        hard?: boolean;
-    }): Promise<PreflightSnapshot>;
-    snapshot(): PreflightSnapshot;
-}
-export declare const OPENCLI_INSTALL_COMMAND: string;
-export interface BridgeVerdict {
-    readonly ok: boolean;
-    readonly detail: string;
-    readonly issues: readonly PreflightBridgeIssue[];
-    readonly command?: string | undefined;
-}
-export declare function canWarm(bridge: {
-    ok: boolean;
-    issues: readonly PreflightBridgeIssue[];
-}): boolean;
-export declare function createPreflight(options: {
-    shell: DshShell;
-    command?: string;
-    installCommand?: string;
-    logger?: {
-        warn?(message: string): void;
-    } | undefined;
-    install?: (() => Promise<{
-        ok: boolean;
-        detail: string;
-    }>) | undefined;
-    warmReads?: (() => readonly (readonly string[])[]) | undefined;
-    probeDiy?: (() => Promise<DiyPresetVerdict | undefined>) | undefined;
-}): Preflight;

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

@@ -1,6 +0,0 @@
-export interface TimedMemo<T> {
-    get(key: string, now?: number): T | undefined;
-    set(key: string, value: T, now?: number): void;
-    clear(): void;
-}
-export declare function createTimedMemo<T>(ttlMs: number): TimedMemo<T>;

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

@@ -1,11 +0,0 @@
-import type { DshShell } from '@dsh-workbench/shared';
-export type { UnitCapability, UnitCommands, UnitLibState, UnitPluginState } from '@dsh-workbench/shared/host';
-import type { UnitLibState } from '@dsh-workbench/shared/host';
-import type { UnitLibNeed } from '@dsh-workbench/shared/host';
-export declare function installedLibVersion(name: string): string | undefined;
-export declare function probeLibs(options: {
-    readonly needs: readonly UnitLibNeed[];
-    readonly shell: DshShell;
-    readonly force: boolean;
-}): Promise<ReadonlyMap<string, UnitLibState>>;
-export declare function resetLibCache(): void;

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

@@ -1,17 +0,0 @@
-import type { DshShell } from '@dsh-workbench/shared';
-import type { UnitCapability, UnitCommands } from "@dsh-workbench/shared/host";
-export type { UnitCapability, UnitCommands, UnitLibState, UnitPluginState } from "@dsh-workbench/shared/host";
-export declare function parsePluginList(stdout: string): unknown[] | undefined;
-export declare function probeUnitCommands(options: {
-    shell: DshShell;
-    command?: string;
-    unit: UnitCommands;
-    force?: boolean;
-}): Promise<UnitCapability>;
-export declare function probeUnits(options: {
-    shell: DshShell;
-    command?: string;
-    units: readonly UnitCommands[];
-    force?: boolean;
-}): Promise<UnitCapability[]>;
-export declare const resetProbeCache: () => void;

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

@@ -1,7 +0,0 @@
-import type { PluginRelease, UnitPluginNeed } from '@dsh-workbench/shared';
-import type { UnitCapability, UnitCommands, UnitLibState } from "./probe-libs";
-export declare function evaluateUnit(list: readonly unknown[] | undefined, unit: UnitCommands, failure: string | undefined, command?: string, releases?: ReadonlyMap<string, PluginRelease>, libs?: readonly UnitLibState[]): UnitCapability;
-export declare function gapsText(gaps: readonly string[]): string;
-export declare function pluginUpdateCommand(plugin: string | undefined): string | undefined;
-export declare function pluginInstallCommand(plugin: string | undefined): string;
-export declare function upgradeLine(need: UnitPluginNeed, command: string, latest: string): string | undefined;

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

@@ -1,21 +0,0 @@
-import type { BundleChange } from '../bundle-install.js';
-export interface RegistryEntry {
-    readonly scope: string;
-    readonly registry: string;
-}
-export interface RegistryNotebook {
-    sources(): readonly RegistryEntry[];
-    remember(entries: readonly RegistryEntry[]): readonly string[];
-}
-export declare const REGISTRY_MARKER = "# dsh-workbench \u5199\u7684\uFF1A\u8FD9\u4E00\u884C\u7684\u5305\u53EA\u5728\u8FD9\u4E2A\u6E90\u4E0A\uFF08dsh \u5378\u8F7D\u6CA1\u6709\u6E90\u53C2\u6570\uFF0Cpnpm \u5F97\u95EE\u5F97\u5230\uFF09";
-export declare function scopeOf(pkg: string): string | null;
-export declare function normalizeRegistry(url: string): string;
-export declare function sameRegistry(a: string | null | undefined, b: string | null | undefined): boolean;
-export declare function sourcesFromLockfile(text: string): readonly RegistryEntry[];
-export interface RegistryConfigMerge {
-    readonly text: string;
-    readonly added: readonly string[];
-}
-export declare function mergeRegistryConfig(text: string, entries: readonly RegistryEntry[]): RegistryConfigMerge;
-export declare function registryFailure(change: BundleChange): boolean;
-export declare function createRegistryNotebook(dir: string | null): RegistryNotebook;

package/dist/types/shared/api/host/registry-declaration.d.ts

@@ -1,23 +0,0 @@
-import type { DshShell } from '@dsh-workbench/shared';
-export declare function localDirOf(spec: string): string | undefined;
-export declare function packageManifestOf(dir: string): Readonly<Record<string, unknown>> | undefined;
-export declare function dshRecordOf(dir: string): unknown | undefined;
-export declare function packageNameOf(dir: string): string | undefined;
-export declare function pathDeclarationOf(spec: string): unknown | undefined;
-export interface RegistryDshLookup {
-    readonly readable: boolean;
-    readonly raw: unknown;
-}
-export declare function registryDshOf(options: {
-    shell: DshShell;
-    name: string;
-    registry?: string | undefined;
-    force?: boolean;
-}): Promise<RegistryDshLookup>;
-export declare function registryDeclarationOf(options: {
-    shell: DshShell;
-    name: string;
-    registry: string;
-    force?: boolean;
-}): Promise<unknown | undefined>;
-export declare function declarationRefusalOf(name: string, raw: unknown): readonly string[];

package/dist/types/shared/api/host/release.d.ts

@@ -1,24 +0,0 @@
-import type { DshShell } from '@dsh-workbench/shared';
-import type { PluginRelease } from '@dsh-workbench/shared';
-export declare function parseLedgerVersion(stdout: string, name: string): string | undefined;
-export declare function compareVersions(a: string, b: string): number | undefined;
-export declare function isNewerVersion(latest: string, installed: string): boolean;
-export declare function latestVersion(options: {
-    shell: DshShell;
-    name: string;
-    registry: string;
-    force?: boolean;
-}): Promise<string | undefined>;
-export declare function missingReleaseParts(options: {
-    shell: DshShell;
-    registry: string;
-    version: string;
-    force?: boolean;
-}): Promise<readonly string[]>;
-export declare function probeRelease(options: {
-    shell: DshShell;
-    package: string;
-    registry?: string | undefined;
-    force?: boolean;
-}): Promise<PluginRelease | undefined>;
-export declare function resetReleaseCache(): void;

package/dist/types/shared/api/host/runtime-seed.d.ts

@@ -1,40 +0,0 @@
-import { spawn } from 'node:child_process';
-import type { DshHostContext } from '@dsh-workbench/shared';
-export type SeedLog = (message: string) => void;
-export interface RuntimeSeedPaths {
-    readonly root: string;
-    readonly entryDir: string;
-    readonly opencliRoot: string;
-    readonly opencliBinDir: string;
-    readonly opencliBin: string;
-    readonly opencliHome: string;
-    readonly workshop: string;
-    readonly workshopPackages: string;
-    readonly workshopManifest: string;
-}
-export interface RuntimeSeedOptions {
-    readonly root: string;
-    readonly home: string;
-    readonly packageRoot: string;
-    readonly log?: SeedLog;
-}
-export declare function runtimeSeedPaths(root: string): RuntimeSeedPaths;
-export declare function runtimeSeedRootOf(ctx: DshHostContext): string | null;
-export declare function coversWritableRoot(workspaceRoot: string, root: string): boolean;
-export declare function warnUnwritableRoot(ctx: DshHostContext): void;
-export declare function packageRootOf(moduleUrl: string): string;
-export declare function isInstalledCopy(packageRoot: string): boolean;
-export declare function opencliWrapperScript(packageRoot: string, home: string): string;
-export interface SeedCommand {
-    readonly file: string;
-    readonly args: readonly string[];
-    readonly env: Readonly<Record<string, string>>;
-    readonly log: string;
-}
-export declare function workshopSeedPlan(packageRoot: string, home: string, root: string): {
-    readonly entry: SeedCommand;
-    readonly full: SeedCommand;
-};
-export declare function runDetached(command: SeedCommand, onError: SeedLog, spawnImpl?: typeof spawn): void;
-export declare function prependPath(entryDir: string, env?: NodeJS.ProcessEnv): boolean;
-export declare function seedRuntimeFiles(options: RuntimeSeedOptions): readonly string[];

package/dist/types/shared/api/host/self-update.d.ts

@@ -1,52 +0,0 @@
-import { spawn } from 'node:child_process';
-import { type SeedCommand } from './runtime-seed';
-import { SELF_UPDATE_STATES, type SelfUpdateState, type WorkbenchSelfUpdate } from '../bundle-install.js';
-export { SELF_UPDATE_STATES, type SelfUpdateState };
-export interface SelfUpdatePaths {
-    readonly dir: string;
-    readonly script: string;
-    readonly marker: string;
-    readonly log: string;
-}
-export interface SelfUpdateRequest {
-    readonly dshHome: string;
-    readonly profile: string;
-    readonly pkg: string;
-    readonly from: string;
-    readonly to: string;
-    readonly pinned: boolean;
-}
-export interface SelfUpdateMarker extends SelfUpdateRequest {
-    readonly state: SelfUpdateState;
-    readonly version: string;
-    readonly at: string;
-}
-export interface SelfUpdatePlan {
-    readonly paths: SelfUpdatePaths;
-    readonly script: string;
-    readonly marker: SelfUpdateMarker;
-    readonly command: SeedCommand;
-}
-export interface SelfUpdateStart {
-    readonly started: boolean;
-    readonly paths: SelfUpdatePaths;
-    readonly forward: string;
-}
-export declare function runningVersionOf(moduleUrl: string): string | undefined;
-export declare function selfUpdatePaths(dshHome: string): SelfUpdatePaths;
-export declare function recoveryCommand(input: {
-    readonly profile: string;
-    readonly pkg: string;
-    readonly version: string;
-}): string;
-export declare function selfUpdateMarker(request: SelfUpdateRequest, state: SelfUpdateState, version: string, at: string): SelfUpdateMarker;
-export declare function selfUpdateScript(request: SelfUpdateRequest, paths: SelfUpdatePaths): string;
-export declare function planSelfUpdate(request: SelfUpdateRequest, now?: Date): SelfUpdatePlan;
-export declare function startSelfUpdate(request: SelfUpdateRequest, onError: (message: string) => void, spawnImpl?: typeof spawn): SelfUpdateStart;
-/**
- * 读外面那个自更新进程留下的现场（marker + 日志尾）：状态是 `running` / `ok` / `rolled-back` / `failed`，
- * `tail` 是日志最后几行（最多 800 字）；没跑过、marker 坏了或状态不认识都给 `undefined`。
- * @param home DSH_HOME（自更新的现场在 `<home>/workbench` 下）。
- * @param profile 只认这个 profile 的现场（同一份 home 下几个 profile 共用一个目录）；不传就不过滤。
- */
-export declare function readSelfUpdateView(home: string, profile?: string): WorkbenchSelfUpdate | undefined;

package/dist/types/shared/api/host/version-range.d.ts

@@ -1,2 +0,0 @@
-export type VersionVerdict = 'satisfied' | 'unsatisfied' | 'malformed';
-export declare function checkVersionRange(contract: string | undefined, version: string): VersionVerdict;

package/dist/types/shared/api/long-tasks.d.ts

@@ -1,19 +0,0 @@
-import type { LongTaskStatus } from '@dsh-workbench/shared';
-/**
- * 外壳自己的长任务读口：一次把**全进程还在跑的**长任务交出来（不分单元、不分工作区）——
- * 左栏拿它点会话行与项目下拉里那颗 loading 点。
- */
-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/types/shared/api/sidebar-edition.d.ts

@@ -1,14 +0,0 @@
-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/types/shared/api/unit-manifests.d.ts

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