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

package/dist/lib/blocker-action.d.ts

@@ -18,18 +18,3 @@ export interface BlockerLabelState {
     readonly running: string | null;
     readonly copied: string | null;
 }
-/**
- * 这颗钮此刻该不该按成等待态：这一轮忙还没收，或有一支正在跑。
- * @param busy - 这一轮忙是不是还在。
- * @param running - 正在跑的那一支的 label；没有就给 `null`。
- * @returns 该等待给 `true`，否则 `false`。
- */
-export declare function blockerPending(busy: boolean, running: string | null): boolean;
-/**
- * 这颗钮此刻该显示什么字：正在重试说「重试中…」，正在跑的那一支说「修复中…」，刚复制过的说「已复制」，其余原样。
- * @param action - 这颗钮的形状（行为 + 平时文案）。
- * @param state - 此刻的运行态。
- * @param t - i18n 取词函数。
- * @returns 要显示的文案；三种临时态都不成立时就是 `action.label`。
- */
-export declare function blockerActionLabel(action: BlockerActionShape, state: BlockerLabelState, t: BlockerLabelTranslate): string;

package/dist/lib/blocker-action.js

@@ -1,25 +1 @@
-/**
- * 这颗钮此刻该不该按成等待态：这一轮忙还没收，或有一支正在跑。
- * @param busy - 这一轮忙是不是还在。
- * @param running - 正在跑的那一支的 label；没有就给 `null`。
- * @returns 该等待给 `true`，否则 `false`。
- */
-export function blockerPending(busy, running) {
-    return busy || running !== null;
-}
-/**
- * 这颗钮此刻该显示什么字：正在重试说「重试中…」，正在跑的那一支说「修复中…」，刚复制过的说「已复制」，其余原样。
- * @param action - 这颗钮的形状（行为 + 平时文案）。
- * @param state - 此刻的运行态。
- * @param t - i18n 取词函数。
- * @returns 要显示的文案；三种临时态都不成立时就是 `action.label`。
- */
-export function blockerActionLabel(action, state, t) {
-    if (action.kind === 'retry' && state.retrying)
-        return t('blocker.retry.running');
-    if (state.running === action.label)
-        return t('blocker.fix.running');
-    if (action.kind === 'copy' && state.copied === action.text)
-        return t('env.copied');
-    return action.label;
-}
+export {};

package/dist/{api → lib}/dsh-client.d.ts

@@ -20,6 +20,7 @@ export interface WorkspaceSnapshot {
 }
 /**
  * 会话一行的来源（标题、空会话、在跑与否、被谁留住）；retainedBy 按视图名记留住它的份数，mainView 大于 0 即正被主视图占着。
+ * projectionValues 是 dsh 的会话投影，外壳只读 `agentPreset` 一位（没选过模式时没有这一位）。
  */
 export interface SessionSummary {
     readonly id: string;
@@ -29,6 +30,7 @@ export interface SessionSummary {
     readonly updatedAt: number;
     readonly origin?: string;
     readonly retainedBy: Readonly<Partial<Record<string, number>>>;
+    readonly projectionValues?: Readonly<Record<string, unknown>>;
 }
 /**
  * 会话投影里的一条子代理目录项；外壳只认 id，其余字段随 dsh 变。
@@ -245,6 +247,7 @@ export interface DshConversationService {
 export interface DshSessionsService {
     readonly list: {
         getSnapshot(): SessionsSnapshot;
+        subscribe?(listener: () => void): () => void;
     };
     scope(sessionId: string): unknown | undefined;
     create?(request: {
@@ -284,10 +287,18 @@ export interface DshSessionsRemote {
     }>;
 }
 /**
- * dsh 客户端的远端写口集合；目前只有会话一家。
+ * remote.agentPresets 写口：给还没开跑的会话挑模式（同一件事就是模式选择器点一下）；
+ * 会话发出第一条消息后 dsh 会拒（模式已锁）。
+ */
+export interface DshAgentPresetsRemote {
+    select(sessionId: string, presetId: string): Promise<unknown>;
+}
+/**
+ * dsh 客户端的远端写口集合；会话与模式两家。
  */
 export interface DshClientRemote {
     readonly sessions: DshSessionsRemote;
+    readonly agentPresets?: DshAgentPresetsRemote;
 }
 /**
  * 客户端插件拿到的上下文：所有服务从它取，effect 注册的清理随插件卸载跑。

package/dist/lib/dsh-client.js

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

package/dist/lib/market-index.d.ts

@@ -0,0 +1,7 @@
+import type { MarketIndexSource, MarketLocalizedText } from '../contract/protocol/market-index.js';
+export declare function marketBranchOk(value: string): boolean;
+export declare function marketText(value: MarketLocalizedText | undefined, locale: string): string;
+export declare function marketInstallTarget(name: string, version: string, source: MarketIndexSource): {
+    readonly spec: string;
+    readonly registry?: string;
+};

package/dist/lib/market-index.js

@@ -0,0 +1,25 @@
+const BRANCH = /^[A-Za-z0-9][A-Za-z0-9._/-]*$/;
+export function marketBranchOk(value) {
+    const branch = value.trim();
+    return (BRANCH.test(branch) &&
+        !branch.includes('..') &&
+        !branch.endsWith('/') &&
+        !branch.endsWith('.') &&
+        !branch.includes('@{'));
+}
+export function marketText(value, locale) {
+    if (value === undefined)
+        return '';
+    const zh = value.zh ?? '';
+    const en = value.en ?? '';
+    return locale.toLowerCase().startsWith('zh') ? zh || en : en || zh;
+}
+export function marketInstallTarget(name, version, source) {
+    if (source.type === 'npm') {
+        const registry = (source.registry ?? '').trim();
+        return { spec: `${name}@${version}`, ...(registry === '' ? {} : { registry }) };
+    }
+    const base = `git+${source.url.trim().replace(/^git\+/, '')}#${source.commit}`;
+    const path = (source.path ?? '').trim().replace(/^\/+/, '');
+    return { spec: path === '' ? base : `${base}&path:/${path}` };
+}

package/dist/lib/react-types.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 从 react 借来的三个类型（`ReactNode` / `CSSProperties` / `ChangeEvent`）—— 模块从这里拿，
+ * 就不必自己直接依赖 react。只取类型：编译期擦除，不进任何产物。
+ */
+export type { ReactNode, CSSProperties, ChangeEvent } from 'react';

package/dist/lib/react-types.js

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

package/dist/lib/react.d.ts

@@ -1,53 +1,14 @@
 import type * as ReactTypes from 'react';
-/**
- * React 的 `createElement` 换个短名字再导出 —— 这套代码用 `h(...)` 写元素。
- */
 export declare const h: typeof ReactTypes.createElement;
-/**
- * React 的 `Fragment` 原样再导出 —— 模块从这里拿，就不必自己直接依赖 react。
- */
 export declare const Fragment: ReactTypes.ExoticComponent<ReactTypes.FragmentProps>;
-/**
- * React 的 `Component` 原样再导出 —— 模块从这里拿，就不必自己直接依赖 react。
- */
 export declare const Component: typeof ReactTypes.Component;
-/**
- * React 的 `createContext` 原样再导出 —— 模块从这里拿，就不必自己直接依赖 react。
- */
 export declare const createContext: typeof ReactTypes.createContext;
-/**
- * React 的 `useContext` 原样再导出 —— 模块从这里拿，就不必自己直接依赖 react。
- */
 export declare const useContext: typeof ReactTypes.useContext;
-/**
- * React 的 `useState` 原样再导出 —— 模块从这里拿，就不必自己直接依赖 react。
- */
 export declare const useState: typeof ReactTypes.useState;
-/**
- * React 的 `useEffect` 原样再导出 —— 模块从这里拿，就不必自己直接依赖 react。
- */
 export declare const useEffect: typeof ReactTypes.useEffect;
-/**
- * React 的 `useLayoutEffect` 原样再导出 —— 模块从这里拿，就不必自己直接依赖 react。
- */
 export declare const useLayoutEffect: typeof ReactTypes.useLayoutEffect;
-/**
- * React 的 `useMemo` 原样再导出 —— 模块从这里拿，就不必自己直接依赖 react。
- */
 export declare const useMemo: typeof ReactTypes.useMemo;
-/**
- * React 的 `useCallback` 原样再导出 —— 模块从这里拿，就不必自己直接依赖 react。
- */
 export declare const useCallback: typeof ReactTypes.useCallback;
-/**
- * React 的 `useRef` 原样再导出 —— 模块从这里拿，就不必自己直接依赖 react。
- */
 export declare const useRef: typeof ReactTypes.useRef;
-/**
- * React 的 `useSyncExternalStore` 原样再导出 —— 模块从这里拿，就不必自己直接依赖 react。
- */
 export declare const useSyncExternalStore: typeof ReactTypes.useSyncExternalStore;
-/**
- * 从 react 借来的三个类型（`ReactNode` / `CSSProperties` / `ChangeEvent`）—— 模块从这里拿，就不必自己直接依赖 react。
- */
-export type { ReactNode, CSSProperties, ChangeEvent } from 'react';
+export type { ReactNode, CSSProperties, ChangeEvent } from './react-types.js';

package/dist/lib/react.js

@@ -1,49 +1,13 @@
 const react = require('react');
-/**
- * React 的 `createElement` 换个短名字再导出 —— 这套代码用 `h(...)` 写元素。
- */
 export const h = react.createElement;
-/**
- * React 的 `Fragment` 原样再导出 —— 模块从这里拿，就不必自己直接依赖 react。
- */
 export const Fragment = react.Fragment;
-/**
- * React 的 `Component` 原样再导出 —— 模块从这里拿，就不必自己直接依赖 react。
- */
 export const Component = react.Component;
-/**
- * React 的 `createContext` 原样再导出 —— 模块从这里拿，就不必自己直接依赖 react。
- */
 export const createContext = react.createContext;
-/**
- * React 的 `useContext` 原样再导出 —— 模块从这里拿，就不必自己直接依赖 react。
- */
 export const useContext = react.useContext;
-/**
- * React 的 `useState` 原样再导出 —— 模块从这里拿，就不必自己直接依赖 react。
- */
 export const useState = react.useState;
-/**
- * React 的 `useEffect` 原样再导出 —— 模块从这里拿，就不必自己直接依赖 react。
- */
 export const useEffect = react.useEffect;
-/**
- * React 的 `useLayoutEffect` 原样再导出 —— 模块从这里拿，就不必自己直接依赖 react。
- */
 export const useLayoutEffect = react.useLayoutEffect;
-/**
- * React 的 `useMemo` 原样再导出 —— 模块从这里拿，就不必自己直接依赖 react。
- */
 export const useMemo = react.useMemo;
-/**
- * React 的 `useCallback` 原样再导出 —— 模块从这里拿，就不必自己直接依赖 react。
- */
 export const useCallback = react.useCallback;
-/**
- * React 的 `useRef` 原样再导出 —— 模块从这里拿，就不必自己直接依赖 react。
- */
 export const useRef = react.useRef;
-/**
- * React 的 `useSyncExternalStore` 原样再导出 —— 模块从这里拿，就不必自己直接依赖 react。
- */
 export const useSyncExternalStore = react.useSyncExternalStore;

package/dist/lib/ui.js

@@ -1,3 +1,4 @@
+import dayjs from 'dayjs';
 /**
  * 拼类名：只留真值、用空格连接（`false` / `null` / `undefined` / 空串都丢掉）。
  * @param parts - 若干类名或条件值。
@@ -79,14 +80,7 @@ export function relativeTime(epochMs, t) {
         return t('time.hours', { n: Math.floor(diff / (60 * MINUTE)) });
     if (diff < 7 * 24 * 60 * MINUTE)
         return t('time.days', { n: Math.floor(diff / (24 * 60 * MINUTE)) });
-    return new Date(epochMs).toLocaleString(undefined, {
-        year: 'numeric',
-        month: 'numeric',
-        day: 'numeric',
-        hour: '2-digit',
-        minute: '2-digit',
-        second: '2-digit',
-    });
+    return dayjs(epochMs).format('YYYY/M/D HH:mm:ss');
 }
 /**
  * 把 `/Users/<用户名>/…` 缩成 `~/…`，免得会话行里全是一样的长前缀。
@@ -109,5 +103,5 @@ export function parseLocalTimestamp(text) {
     const raw = String(text ?? '').trim();
     if (!LOCAL_TIMESTAMP.test(raw))
         return Number.NaN;
-    return new Date(raw.replace(' ', 'T')).getTime();
+    return dayjs(raw.replace(' ', 'T')).valueOf();
 }

package/dist/testing/data.d.ts

@@ -0,0 +1,13 @@
+import type { CallOverrides, DataReader, DataRequest, RecipeCalls, RequestRecipe } from '../contract/data.js';
+export interface RecipeCall {
+    readonly kind: 'request' | 'submit' | 'many';
+    readonly recipe: RequestRecipe;
+    readonly overrides?: CallOverrides | undefined;
+    readonly calls?: RecipeCalls | undefined;
+}
+export declare function createNoopDataReader(): DataReader;
+export declare function createFakeDataReader(reply?: unknown | ((request: DataRequest, index: number) => unknown), recipeReply?: unknown | ((call: RecipeCall, index: number) => unknown)): DataReader & {
+    readonly requests: readonly DataRequest[];
+    readonly calls: readonly RecipeCall[];
+};
+export declare const fakeDataReader: typeof createFakeDataReader;

package/dist/testing/data.js

@@ -0,0 +1,46 @@
+const NO_DATA = {
+    ok: false,
+    error: { code: 'invalid-request', message: '测试没有注入 DataReader' },
+};
+function filled(names, value) {
+    const out = {};
+    for (const name of names)
+        out[name] = value;
+    return out;
+}
+export function createNoopDataReader() {
+    return {
+        read: async () => NO_DATA,
+        request: async () => NO_DATA,
+        requestMany: async (_recipe, calls) => filled(Object.keys(calls), NO_DATA),
+        submit: async () => NO_DATA,
+    };
+}
+export function createFakeDataReader(reply = { ok: true, data: null }, recipeReply = { ok: true, data: null }) {
+    const requests = [];
+    const calls = [];
+    const answer = (call) => typeof recipeReply === 'function' ? recipeReply(call, calls.length - 1) : recipeReply;
+    const reader = {
+        async read(request) {
+            requests.push(request);
+            return typeof reply === 'function' ? reply(request, requests.length - 1) : reply;
+        },
+        async request(recipe, overrides) {
+            calls.push({ kind: 'request', recipe, overrides });
+            return answer(calls[calls.length - 1]);
+        },
+        async requestMany(recipe, plan) {
+            calls.push({ kind: 'many', recipe, calls: plan });
+            const answered = answer(calls[calls.length - 1]);
+            return typeof answered === 'object' && answered !== null && !('ok' in answered)
+                ? answered
+                : filled(Object.keys(plan), answered);
+        },
+        async submit(recipe, overrides) {
+            calls.push({ kind: 'submit', recipe, overrides });
+            return answer(calls[calls.length - 1]);
+        },
+    };
+    return Object.assign(reader, { requests, calls });
+}
+export const fakeDataReader = createFakeDataReader;

package/dist/testing/declaration.d.ts

@@ -1,2 +1,2 @@
-import type { UnitManifest } from '../api/unit.js';
+import type { UnitManifest } from '../contract/unit.js';
 export declare function declarationOfPackage(pkg: string, packageJson: URL | string): UnitManifest;

package/dist/testing/declaration.js

@@ -1,6 +1,6 @@
 import fs from 'node:fs';
 import { fileURLToPath } from 'node:url';
-import { readDeclaration } from '../host/unit-declaration.js';
+import { readDeclaration } from '../contract/unit-declaration.js';
 export function declarationOfPackage(pkg, packageJson) {
     const at = typeof packageJson === 'string' ? packageJson : fileURLToPath(packageJson);
     let parsed;

package/dist/testing/host-fakes.d.ts

@@ -1,5 +1,4 @@
 import type { DshShell } from '../api/dsh.js';
-import type { Opencli } from '../host/opencli.js';
 export interface ShellCall {
     command: string;
     workdir?: string;
@@ -21,18 +20,6 @@ export declare function createFakeShell(replies?: ShellReply[] | ((call: ShellCa
     peak: () => number;
     commands: () => string[];
 };
-export interface OpencliCall {
-    args: readonly string[];
-    key?: string;
-    workdir?: string;
-    session?: string;
-    refresh?: boolean;
-}
-export declare function createFakeOpencli(replies?: Array<unknown | Error> | ((call: OpencliCall, index: number) => unknown | Error)): {
-    opencli: Opencli;
-    calls: OpencliCall[];
-    keys: () => (string | undefined)[];
-};
 export declare function createFakeLogger(): {
     logger: {
         info: () => void;

package/dist/testing/host-fakes.js

@@ -39,30 +39,6 @@ export function createFakeShell(replies = []) {
         commands: () => calls.map((call) => call.command),
     };
 }
-export function createFakeOpencli(replies = []) {
-    const calls = [];
-    const opencli = {
-        async json(args, options = {}) {
-            const call = {
-                args,
-                ...(options.key === undefined ? {} : { key: options.key }),
-                ...(options.workdir === undefined ? {} : { workdir: options.workdir }),
-                ...(options.session === undefined ? {} : { session: options.session }),
-            };
-            calls.push(call);
-            const index = calls.length - 1;
-            const reply = typeof replies === 'function' ? replies(call, index) : (replies[index] ?? []);
-            if (reply instanceof Error)
-                throw reply;
-            return { value: reply, at: Date.now() };
-        },
-    };
-    return {
-        opencli,
-        calls,
-        keys: () => calls.map((call) => call.key),
-    };
-}
 export function createFakeLogger() {
     const warnings = [];
     return {

package/dist/testing/needs.d.ts

@@ -0,0 +1,16 @@
+import type { BinNeed, EnvNeed, ExtensionNeed, LibNeed, Need, SupplySource } from '../contract/needs.js';
+import type { NeedState } from '../contract/unit-capability.js';
+import type { UnitCapability } from '../contract/unit-capability.js';
+import type { UnitManifest } from '../contract/unit.js';
+export declare const fakeNpmSource: SupplySource;
+export declare function extensionNeedOf(name: string, extra?: Partial<ExtensionNeed>): ExtensionNeed;
+export declare function libNeedOf(name: string, extra?: Partial<LibNeed>): LibNeed;
+export declare function binNeedOf(name: string, extra?: Partial<BinNeed>): BinNeed;
+export declare function envNeedOf(name: string, extra?: Partial<EnvNeed>): EnvNeed;
+export declare function manifestOf(options?: {
+    readonly id?: string | undefined;
+    readonly needs?: readonly Need[] | undefined;
+    readonly card?: UnitManifest['card'];
+}): UnitManifest;
+export declare function needStateOf(need: Need, status?: NeedState['status'], extra?: Partial<NeedState>): NeedState;
+export declare function capabilityOf(unit: string, needs?: readonly NeedState[], extra?: Partial<UnitCapability>): UnitCapability;

package/dist/testing/needs.js

@@ -0,0 +1,46 @@
+export const fakeNpmSource = {
+    kind: 'npm',
+    registryEnv: 'WB_TEST_REGISTRY',
+    registryDefault: 'https://registry.invalid/',
+};
+export function extensionNeedOf(name, extra = {}) {
+    return {
+        kind: 'extension',
+        runtime: 'opencli',
+        name,
+        commands: [`${name}-read`],
+        purpose: '测试',
+        ...extra,
+    };
+}
+export function libNeedOf(name, extra = {}) {
+    return { kind: 'lib', name, purpose: '测试', ...extra };
+}
+export function binNeedOf(name, extra = {}) {
+    return { kind: 'bin', name, purpose: '测试', ...extra };
+}
+export function envNeedOf(name, extra = {}) {
+    return { kind: 'env', name, purpose: '测试', ...extra };
+}
+export function manifestOf(options = {}) {
+    return {
+        id: options.id ?? 'fixture',
+        card: options.card === undefined ? { titleKey: `${options.id ?? 'fixture'}.mine`, order: 10 } : options.card,
+        tools: [],
+        host: { inject: [] },
+        ...(options.needs === undefined ? {} : { needs: options.needs }),
+    };
+}
+export function needStateOf(need, status = 'ok', extra = {}) {
+    return {
+        id: need.id ?? `${need.kind}:${need.name}`,
+        kind: need.kind,
+        name: need.name,
+        status,
+        detail: `测试：${need.name}`,
+        ...extra,
+    };
+}
+export function capabilityOf(unit, needs = [], extra = {}) {
+    return { unit, status: needs.some((need) => need.status !== 'ok') ? 'missing' : 'ok', needs, ...extra };
+}

package/dist/testing.d.ts

@@ -1,2 +1,4 @@
 export * from './testing/host-fakes.js';
 export * from './testing/declaration.js';
+export * from './testing/needs.js';
+export * from './testing/data.js';

package/dist/testing.js

@@ -1,2 +1,4 @@
 export * from './testing/host-fakes.js';
 export * from './testing/declaration.js';
+export * from './testing/needs.js';
+export * from './testing/data.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/shared",
-  "version": "0.3.10",
+  "version": "1.0.0-beta.0",
   "description": "工作台与模块共享的纯代码与契约类型：类型、纯逻辑、哑组件、平台解析。宿主侧的东西从 /host 进（不影响浏览器产物）。",
   "license": "MIT",
   "type": "module",
@@ -16,6 +16,10 @@
     "./testing": {
       "types": "./dist/testing.d.ts",
       "default": "./dist/testing.js"
+    },
+    "./contract/*": {
+      "types": "./dist/contract/*.d.ts",
+      "default": "./dist/contract/*.js"
     }
   },
   "files": [
@@ -29,7 +33,7 @@
     "react": "*"
   },
   "devDependencies": {
-    "@arch-guard/core": "^0.11.0",
+    "@arch-guard/core": "^0.11.1",
     "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-rc.2",
     "@types/node": "^24.19.0",
     "@types/react": "^19.0.0",
@@ -38,6 +42,18 @@
     "typescript": "5.9",
     "vitest": "^5.0.2"
   },
+  "dependencies": {
+    "dayjs": "^1.11.23"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/novaeth/dsh-workbench.git",
+    "directory": "packages/shared"
+  },
+  "homepage": "https://github.com/novaeth/dsh-workbench#readme",
+  "bugs": {
+    "url": "https://github.com/novaeth/dsh-workbench/issues"
+  },
   "scripts": {
     "build": "tsc -p tsconfig.build.json && node scripts/copy-css.mjs",
     "typecheck": "tsc --noEmit --incremental --tsBuildInfoFile node_modules/.cache/tsconfig.tsbuildinfo",