@dsh-workbench/core 0.3.3 → 0.3.4

package/dist/types/modules/panels/model/diy-record-text.d.ts

@@ -0,0 +1,89 @@
+import type { RecordExpect, RecordMove, RecordRefusal, RecordState } from '@dsh-workbench/shared';
+export interface RecordCall {
+    readonly key: string;
+    readonly method: string;
+    readonly url: string;
+    readonly body: string;
+    readonly status: number;
+    readonly ct: string;
+    readonly response: string;
+    readonly at: number;
+    readonly source: 'hook' | 'capture';
+}
+export interface RecordPageRead {
+    readonly ok: boolean;
+    readonly code: string;
+    readonly phase: string;
+    readonly t0: number | null;
+    readonly t1: number | null;
+    readonly href: string;
+    readonly here: string;
+    readonly dropped: number;
+    readonly unhooked: boolean;
+    readonly calls: readonly RecordCall[];
+}
+export declare function recordPageOf(payload: Record<string, unknown> | undefined): RecordPageRead;
+export declare function filterTextOf(expect: RecordExpect | null): string;
+export declare function probeCommandOf(calls: readonly RecordCall[]): string;
+export declare function bodyMissingOf(calls: readonly RecordCall[]): boolean;
+export declare function recordRefusalText(code: RecordRefusal, held?: RecordState): string;
+export declare function recordMissingText(): string;
+export declare function recordTalkOf(): string;
+export interface RecordListRow {
+    readonly index: number;
+    readonly key: string;
+    readonly at: number;
+    readonly method: string;
+    readonly url: string;
+    readonly status: number;
+    readonly ct: string;
+    readonly size: number;
+    readonly source: 'hook' | 'capture';
+    readonly hasRequest: boolean;
+    readonly hasResponse: boolean;
+    readonly likelyWrite: boolean;
+    readonly marked: boolean;
+}
+export declare function listRowsOf(calls: readonly RecordCall[], expect: RecordExpect | null): readonly RecordListRow[];
+export interface RecordReadFacts {
+    readonly phase: string;
+    readonly armed: boolean;
+    readonly hookCaught: number;
+    readonly rows: readonly RecordListRow[];
+    readonly merged: number;
+    readonly capturedLines: number;
+    readonly capturedInSegment: number;
+    readonly capturedOutside: number;
+    readonly capturedTotalLines: number;
+    readonly capturedTruncated: boolean;
+    readonly capturedTailLimit: number;
+    readonly dropped: number;
+    readonly nav: boolean;
+    readonly filter: string;
+    readonly captureRound: string;
+}
+export declare function renderRecordRead(input: RecordReadFacts): string;
+export interface RecordDetailFacts {
+    readonly found: boolean;
+    readonly where: string;
+    readonly method: string;
+    readonly url: string;
+    readonly status: number;
+    readonly ct: string;
+    readonly at: number;
+    readonly request: string;
+    readonly response: string;
+    readonly headers: string;
+    readonly requestFullSize: number;
+    readonly responseFullSize: number;
+    readonly requestSizeExact: boolean;
+    readonly responseSizeExact: boolean;
+    readonly ambiguous: number;
+    readonly source: string;
+    readonly maxBytes: number;
+    readonly note: string;
+}
+export declare function renderRecordDetail(input: RecordDetailFacts): string;
+export declare function moveOrThrow(move: RecordMove, held: RecordState | null): RecordState;
+export declare function domainOf(url: string): string;
+export declare function readDomainsOf(design: unknown): readonly string[];

package/dist/types/modules/panels/model/diy-record-text.test.d.ts

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

package/dist/types/modules/panels/model/diy-record-tools.d.ts

@@ -0,0 +1,2 @@
+import type { DshHostContext, RecordStore } from '@dsh-workbench/shared';
+export declare function registerRecordTools(ctx: DshHostContext, store: RecordStore): readonly (() => void)[];

package/dist/types/modules/panels/model/diy-record.d.ts

@@ -0,0 +1,76 @@
+import type { DshHostContext, DshShell, RecordState, RecordStore } from '@dsh-workbench/shared';
+import type { CaptureEntry } from './diy-record-capture';
+import type { RecordCall, RecordListRow, RecordPageRead } from './diy-record-text';
+export declare const OPEN_TIMEOUT_MS = 30000;
+export declare const SETTLE_MS = 2000;
+export declare const WAIT_CAP_MS: number;
+export declare const POLL_MS = 1000;
+export declare const DETAIL_MAX_BYTES = 60000;
+export declare const pauseFor: (ms: number) => Promise<void>;
+export declare function waitOf(value: unknown): number;
+export declare function foreignDomainText(design: unknown, url: string): string;
+export declare function captureFileOf(packagesDir: string, unit: string): string;
+export declare function lastCaptureFileOf(file: string): string;
+export declare function startRecordCapture(shell: DshShell, command: string, session: string, file: string): Promise<boolean>;
+export interface WatchFinishDeps {
+    readonly ctx: DshHostContext;
+    readonly shell: DshShell;
+    readonly command: string;
+    readonly sessionId: string;
+    readonly store: RecordStore;
+    readonly url: string;
+    readonly captureFile: string;
+}
+export declare function watchFinishStepOf(input: WatchFinishDeps): Promise<{
+    readonly stop: boolean;
+    readonly delivered: boolean;
+}>;
+export declare function watchRecordFinish(input: WatchFinishDeps): void;
+export interface CaptureRead {
+    readonly text: string;
+    readonly totalLines: number;
+    readonly tailLimit: number;
+    readonly truncated: boolean;
+    readonly round: string;
+}
+export declare function captureLinesOf(shell: DshShell, file: string, timeoutMs?: number): Promise<number>;
+export declare function captureRoundOf(shell: DshShell, file: string, timeoutMs?: number): Promise<string>;
+export declare function captureTextOf(shell: DshShell, file: string, timeoutMs?: number): Promise<{
+    readonly text: string;
+    readonly truncated: boolean;
+}>;
+export declare function captureReadOf(shell: DshShell, file: string, timeoutMs?: number): Promise<CaptureRead>;
+export declare function keepCaptureOf(shell: DshShell, file: string, timeoutMs?: number): Promise<boolean>;
+export declare function captureLinesWithKeyOf(shell: DshShell, file: string, key: string, timeoutMs?: number): Promise<string>;
+export interface SegmentBundle {
+    readonly capture: CaptureRead;
+    readonly entries: readonly CaptureEntry[];
+    readonly inside: readonly CaptureEntry[];
+    readonly outside: number;
+    readonly merged: readonly RecordCall[];
+    readonly rows: readonly RecordListRow[];
+}
+export declare function bundleOf(capture: CaptureRead, page: RecordPageRead, state: RecordState): SegmentBundle;
+export declare function hookCallOf(page: RecordPageRead, key: string): RecordCall | null;
+export declare function detailOfEntry(entry: CaptureEntry, maxBytes: number, ambiguous?: number): Record<string, unknown>;
+export declare function detailOfCall(call: RecordCall, maxBytes: number): Record<string, unknown>;
+export declare function releaseRecord(input: {
+    readonly shell: DshShell;
+    readonly command: string;
+    readonly session: string;
+    readonly url: string;
+    readonly captureFile: string;
+}): Promise<{
+    readonly tab: boolean;
+    readonly capture: boolean;
+}>;
+export declare function releaseQuietly(input: {
+    readonly shell: DshShell;
+    readonly command: string;
+    readonly session: string;
+    readonly url: string;
+    readonly captureFile: string;
+}): Promise<{
+    readonly tab: boolean;
+    readonly capture: boolean;
+}>;

package/dist/types/modules/panels/model/diy-record.test.d.ts

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

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

@@ -3,6 +3,7 @@ import type { HandoffEntry } from '@dsh-workbench/shared/host';
 import type { UnitManifest } from '@dsh-workbench/shared/host';
 export declare const PANELS_FACT = "panels";
 export declare const DIY_DEBUG_FACT = "diy-debug";
+export declare const DIY_RECORD_FACT = "diy-record";
 export declare function panelsHandoffEntry(target?: {
     readonly path?: string | undefined;
 }): HandoffEntry | undefined;

package/dist/types/modules/panels/unit.d.ts

@@ -17,6 +17,7 @@ export declare const MODULES_UPDATE_WORKBENCH_TOOL = "workbench_modules_update_w
 export declare const DIY_LIST_TOOL = "workbench_diy_list";
 export declare const DIY_STATUS_TOOL = "workbench_diy_status";
 export declare const DIY_PANEL_TOOL = "workbench_diy_panel";
+export declare const DIY_COMPONENTS_TOOL = "workbench_diy_components";
 export declare const DIY_RECON_TOOL = "workbench_diy_recon";
 export declare const DIY_SPEC_TOOL = "workbench_diy_spec";
 export declare const DIY_PROBE_TOOL = "workbench_diy_probe";
@@ -39,14 +40,19 @@ export declare const DIY_DIALOG_TOOL = "workbench_diy_dialog";
 export declare const DIY_LOGS_WATCH_TOOL = "workbench_diy_logs_watch";
 export declare const DIY_LOGS_READ_TOOL = "workbench_diy_logs_read";
 export declare const DIY_LOGS_STOP_TOOL = "workbench_diy_logs_stop";
+export declare const DIY_RECORD_PREPARE_TOOL = "workbench_diy_record_prepare";
+export declare const DIY_RECORD_READ_TOOL = "workbench_diy_record_read";
+export declare const DIY_RECORD_DETAIL_TOOL = "workbench_diy_record_detail";
+export declare const DIY_RECORD_STOP_TOOL = "workbench_diy_record_stop";
 export declare const DIY_DEBUG_START_TOOL = "workbench_diy_debug_start";
 export declare const DIY_DEBUG_PAUSE_TOOL = "workbench_diy_debug_pause";
 export declare const DIY_DEBUG_RESUME_TOOL = "workbench_diy_debug_resume";
 export declare const DIY_DEBUG_STOP_TOOL = "workbench_diy_debug_stop";
-export declare const ALL_TOOLS: readonly ["workbench_panels_list", "workbench_panels_show", "workbench_panels_hide", "workbench_panels_move", "workbench_panels_reset", "workbench_panels_follow", "workbench_modules_list", "workbench_modules_install", "workbench_modules_update", "workbench_modules_uninstall", "workbench_modules_install_bundle", "workbench_modules_update_dependency", "workbench_modules_update_plugin", "workbench_modules_uninstall_plugin", "workbench_modules_update_workbench", "workbench_diy_list", "workbench_diy_status", "workbench_diy_panel", "workbench_diy_recon", "workbench_diy_spec", "workbench_diy_probe", "workbench_diy_install", "workbench_diy_show", "workbench_diy_state", "workbench_diy_html", "workbench_diy_find", "workbench_diy_click", "workbench_diy_hover", "workbench_diy_type", "workbench_diy_fill", "workbench_diy_keys", "workbench_diy_scroll", "workbench_diy_wait", "workbench_diy_eval", "workbench_diy_screenshot", "workbench_diy_network", "workbench_diy_dialog", "workbench_diy_logs_watch", "workbench_diy_logs_read", "workbench_diy_logs_stop", "workbench_diy_debug_start", "workbench_diy_debug_pause", "workbench_diy_debug_resume", "workbench_diy_debug_stop"];
+export declare const ALL_TOOLS: readonly ["workbench_panels_list", "workbench_panels_show", "workbench_panels_hide", "workbench_panels_move", "workbench_panels_reset", "workbench_panels_follow", "workbench_modules_list", "workbench_modules_install", "workbench_modules_update", "workbench_modules_uninstall", "workbench_modules_install_bundle", "workbench_modules_update_dependency", "workbench_modules_update_plugin", "workbench_modules_uninstall_plugin", "workbench_modules_update_workbench", "workbench_diy_list", "workbench_diy_status", "workbench_diy_panel", "workbench_diy_components", "workbench_diy_recon", "workbench_diy_spec", "workbench_diy_probe", "workbench_diy_install", "workbench_diy_show", "workbench_diy_state", "workbench_diy_html", "workbench_diy_find", "workbench_diy_click", "workbench_diy_hover", "workbench_diy_type", "workbench_diy_fill", "workbench_diy_keys", "workbench_diy_scroll", "workbench_diy_wait", "workbench_diy_eval", "workbench_diy_screenshot", "workbench_diy_network", "workbench_diy_dialog", "workbench_diy_logs_watch", "workbench_diy_logs_read", "workbench_diy_logs_stop", "workbench_diy_record_prepare", "workbench_diy_record_read", "workbench_diy_record_detail", "workbench_diy_record_stop", "workbench_diy_debug_start", "workbench_diy_debug_pause", "workbench_diy_debug_resume", "workbench_diy_debug_stop"];
 export type PanelsToolName = (typeof ALL_TOOLS)[number];
-export declare const READ_TOOLS: readonly ["workbench_panels_list", "workbench_modules_list", "workbench_diy_list", "workbench_diy_status", "workbench_diy_panel", "workbench_diy_recon", "workbench_diy_spec", "workbench_diy_probe", "workbench_diy_state", "workbench_diy_html", "workbench_diy_find", "workbench_diy_click", "workbench_diy_hover", "workbench_diy_type", "workbench_diy_fill", "workbench_diy_keys", "workbench_diy_scroll", "workbench_diy_wait", "workbench_diy_eval", "workbench_diy_screenshot", "workbench_diy_network", "workbench_diy_dialog", "workbench_diy_logs_watch", "workbench_diy_logs_read", "workbench_diy_logs_stop"];
-export declare const WRITE_TOOLS: readonly ["workbench_panels_show", "workbench_panels_hide", "workbench_panels_move", "workbench_panels_reset", "workbench_panels_follow", "workbench_modules_install", "workbench_modules_update", "workbench_modules_uninstall", "workbench_modules_install_bundle", "workbench_modules_update_dependency", "workbench_modules_update_plugin", "workbench_modules_uninstall_plugin", "workbench_modules_update_workbench", "workbench_diy_install", "workbench_diy_show", "workbench_diy_debug_start", "workbench_diy_debug_pause", "workbench_diy_debug_resume", "workbench_diy_debug_stop"];
-export declare const DIY_TOOLS: readonly ["workbench_diy_list", "workbench_diy_status", "workbench_diy_panel", "workbench_diy_recon", "workbench_diy_spec", "workbench_diy_probe", "workbench_diy_install", "workbench_diy_show", "workbench_diy_state", "workbench_diy_html", "workbench_diy_find", "workbench_diy_click", "workbench_diy_hover", "workbench_diy_type", "workbench_diy_fill", "workbench_diy_keys", "workbench_diy_scroll", "workbench_diy_wait", "workbench_diy_eval", "workbench_diy_screenshot", "workbench_diy_network", "workbench_diy_dialog", "workbench_diy_logs_watch", "workbench_diy_logs_read", "workbench_diy_logs_stop"];
+export declare const READ_TOOLS: readonly ["workbench_panels_list", "workbench_modules_list", "workbench_diy_list", "workbench_diy_status", "workbench_diy_panel", "workbench_diy_components", "workbench_diy_recon", "workbench_diy_spec", "workbench_diy_probe", "workbench_diy_state", "workbench_diy_html", "workbench_diy_find", "workbench_diy_click", "workbench_diy_hover", "workbench_diy_type", "workbench_diy_fill", "workbench_diy_keys", "workbench_diy_scroll", "workbench_diy_wait", "workbench_diy_eval", "workbench_diy_screenshot", "workbench_diy_network", "workbench_diy_dialog", "workbench_diy_logs_watch", "workbench_diy_logs_read", "workbench_diy_logs_stop", "workbench_diy_record_read", "workbench_diy_record_detail", "workbench_diy_record_stop"];
+export declare const WRITE_TOOLS: readonly ["workbench_panels_show", "workbench_panels_hide", "workbench_panels_move", "workbench_panels_reset", "workbench_panels_follow", "workbench_modules_install", "workbench_modules_update", "workbench_modules_uninstall", "workbench_modules_install_bundle", "workbench_modules_update_dependency", "workbench_modules_update_plugin", "workbench_modules_uninstall_plugin", "workbench_modules_update_workbench", "workbench_diy_install", "workbench_diy_show", "workbench_diy_record_prepare", "workbench_diy_debug_start", "workbench_diy_debug_pause", "workbench_diy_debug_resume", "workbench_diy_debug_stop"];
+export declare const DIY_TOOLS: readonly ["workbench_diy_list", "workbench_diy_status", "workbench_diy_panel", "workbench_diy_components", "workbench_diy_recon", "workbench_diy_spec", "workbench_diy_probe", "workbench_diy_install", "workbench_diy_show", "workbench_diy_state", "workbench_diy_html", "workbench_diy_find", "workbench_diy_click", "workbench_diy_hover", "workbench_diy_type", "workbench_diy_fill", "workbench_diy_keys", "workbench_diy_scroll", "workbench_diy_wait", "workbench_diy_eval", "workbench_diy_screenshot", "workbench_diy_network", "workbench_diy_dialog", "workbench_diy_logs_watch", "workbench_diy_logs_read", "workbench_diy_logs_stop"];
+export declare const DIY_RECORD_TOOLS: readonly ["workbench_diy_record_prepare", "workbench_diy_record_read", "workbench_diy_record_detail", "workbench_diy_record_stop"];
 export declare const DIY_DEBUG_TOOLS: readonly ["workbench_diy_debug_start", "workbench_diy_debug_pause", "workbench_diy_debug_resume", "workbench_diy_debug_stop"];
 export declare const panelsUnit: UnitManifest;

package/dist/types/shared/api/host/diy-acts.d.ts

@@ -0,0 +1,4 @@
+import type { DshHostContext } from '@dsh-workbench/shared';
+export declare function registerDiyActs(ctx: DshHostContext, facts: {
+    bump(names: readonly string[]): unknown;
+}): () => void;

package/dist/types/shared/api/host/diy-components.d.ts

@@ -0,0 +1,54 @@
+import type { DshShell } from '@dsh-workbench/shared';
+export declare const SURFACE_TIMEOUT_MS = 30000;
+export declare const EXCERPT_LINES = 60;
+export declare const SUMMARY_PER_BUCKET = 12;
+export declare const NEAR_LIMIT = 8;
+export declare const PRUNE_CHARS = 8192;
+export declare const PRIMITIVES_PKG = "@deepseek-ai/dsh-client-ui-primitives";
+export declare const MANIFEST_TAIL = "//# sourceMappingURL=";
+export type SurfaceScope = 'all' | 'primitives' | 'kit';
+export interface SurfacePayload {
+    readonly [key: string]: unknown;
+}
+export interface SurfaceQuery {
+    readonly primitives?: SurfacePayload;
+    readonly kit?: SurfacePayload;
+}
+export declare function scopeOf(raw: string): SurfaceScope;
+export declare function wantsPrimitives(scope: SurfaceScope): boolean;
+export declare function wantsKit(scope: SurfaceScope): boolean;
+export declare function toolchainBinOf(root: string): string | null;
+export declare function queryCommandOf(bin: string, only: 'kit' | 'primitives'): string;
+export declare function runSurfaceQuery(shell: DshShell, bin: string, only: 'kit' | 'primitives', root: string): Promise<SurfacePayload>;
+export declare function filesOf(payload: SurfacePayload | undefined): Record<string, string>;
+export declare function rootsOf(payload: SurfacePayload | undefined): Record<string, string>;
+export declare function countsOf(payload: SurfacePayload | undefined): Record<string, number>;
+export declare function installedVersionOf(payload: SurfacePayload | undefined): string | null;
+export declare function nearNamesOf(name: string, names: readonly string[], limit?: number): readonly string[];
+export declare function findFileOf(name: string, query: SurfaceQuery): {
+    readonly file: string;
+    readonly from: 'kit' | 'primitives';
+} | null;
+export declare function excerptOf(text: string, maxLines?: number): string;
+export declare function excerptAt(file: string, maxLines?: number): string;
+export declare function skillDirOf(from: string): string | null;
+export declare function symbolsIn(heading: string): readonly string[];
+export declare function docSectionOf(name: string, dir: string | null): {
+    readonly file: string;
+    readonly lines: string;
+} | null;
+export declare function byLocationOf(payload: SurfacePayload): readonly {
+    readonly where: string;
+    readonly names: readonly string[];
+}[];
+export declare function renderSurfaceText(query: SurfaceQuery, options: {
+    scope: SurfaceScope;
+    all: boolean;
+}): string;
+export declare function listedNamesOf(query: SurfaceQuery): readonly string[];
+export type FaceState = 'not-queried' | 'ok' | 'unreadable';
+export declare function faceStateOf(query: SurfaceQuery, face: 'kit' | 'primitives'): FaceState;
+export declare function renderNameText(name: string, found: {
+    readonly file: string;
+    readonly from: 'kit' | 'primitives';
+} | null, query: SurfaceQuery): string;

package/dist/types/shared/api/host/diy-debug-act.d.ts

@@ -1,9 +1,26 @@
 import type { DebugIntent, DebugState, DebugStore, PostResource } from '@dsh-workbench/shared/host';
 export declare const DEBUG_NOTICE_KIND = "workbench-diy";
+export interface NoticeTextBlock {
+    readonly type: 'text';
+    readonly text: string;
+}
+export interface NoticeSource {
+    readonly kind: string;
+    readonly form: 'notice';
+    readonly summary: string;
+}
+export interface NoticeMessage {
+    readonly role: 'user';
+    readonly id: string;
+    readonly content: readonly NoticeTextBlock[];
+    readonly source: NoticeSource;
+}
+export declare function noticeMessage(text: string, summary: string, kind?: string): NoticeMessage;
+export declare function isNoticeMessage(value: unknown): value is NoticeMessage;
 export interface NoticeAgent {
     readonly status: string;
-    inject(message: unknown): void;
-    followup(message: unknown): void;
+    inject(message: NoticeMessage): void;
+    followup(message: NoticeMessage): void;
 }
 export interface AgentsLookup {
     get(id: string): NoticeAgent | undefined;
@@ -11,20 +28,20 @@ export interface AgentsLookup {
 export declare function debugNoticeText(intent: DebugIntent, state: DebugState): string;
 export declare function debugNoticeSummary(intent: DebugIntent, state: DebugState): string;
 export declare function debugNotice(intent: DebugIntent, state: DebugState): {
-    message: unknown;
+    message: NoticeMessage;
     summary: string;
 };
 export type NoticeMode = 'wake' | 'hold' | 'drop';
 export type NoticeDelivery = 'followup' | 'inject' | 'held' | 'none' | 'skipped-idle';
-export declare function holdNotice(sessionId: string, message: unknown): void;
-export declare function takeHeldNotices(sessionId: string): unknown[];
-export declare function deliverDebugNotice(agents: AgentsLookup | undefined, sessionId: string, message: unknown, mode?: NoticeMode): NoticeDelivery;
+export declare function holdNotice(sessionId: string, message: NoticeMessage): void;
+export declare function takeHeldNotices(sessionId: string): NoticeMessage[];
+export declare function deliverDebugNotice(agents: AgentsLookup | undefined, sessionId: string, message: NoticeMessage, mode?: NoticeMode): NoticeDelivery;
 export interface DebugActDeps {
     readonly store: () => DebugStore | undefined;
     readonly agents: () => AgentsLookup | undefined;
     readonly now?: (() => number) | undefined;
     readonly notice?: ((intent: DebugIntent, state: DebugState) => {
-        message: unknown;
+        message: NoticeMessage;
         summary: string;
     }) | undefined;
 }

package/dist/types/shared/api/host/diy-record-act.d.ts

@@ -0,0 +1,19 @@
+import type { PostResource, RecordIntent, RecordState, RecordStore } from '@dsh-workbench/shared/host';
+import { type AgentsLookup, type NoticeMessage } from './diy-debug-act';
+export declare const RECORD_NOTICE_KIND = "workbench-diy-record";
+export declare function recordNoticeText(intent: RecordIntent, state: RecordState): string;
+export declare function recordNoticeSummary(intent: RecordIntent, state: RecordState): string;
+export declare function recordNotice(intent: RecordIntent, state: RecordState): {
+    message: NoticeMessage;
+    summary: string;
+};
+export interface RecordActDeps {
+    readonly store: () => RecordStore | undefined;
+    readonly agents: () => AgentsLookup | undefined;
+    readonly now?: (() => number) | undefined;
+    readonly notice?: ((intent: RecordIntent, state: RecordState) => {
+        message: NoticeMessage;
+        summary: string;
+    }) | undefined;
+}
+export declare function recordActResource(deps: RecordActDeps): PostResource;

package/dist/types/shared/api/host/diy-workshop.d.ts

@@ -9,6 +9,7 @@ export interface WorkshopModule {
 export declare function workshopPackagesDir(ctx: DshHostContext): string | null;
 export declare function insideWorkshop(root: string, target: string): boolean;
 export declare function workshopModules(packagesDir: string, installed?: readonly string[]): readonly WorkshopModule[];
+export declare function readDesignOfModule(dir: string): unknown;
 export declare function inWorkshopSession(ctx: DshHostContext, workspace: string | null): boolean;
 export interface WorkshopSync {
     readonly state: 'ok' | 'syncing' | 'failed';

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

@@ -4,6 +4,9 @@ import { type RouteTable } from '@dsh-workbench/shared/host';
 import type { ContextRenderer, UnitMountDeps, UnitMountResult, UnitCall } from '@dsh-workbench/shared/host';
 import type { HostUnit } from './unit-registry';
 import { type UnitReadiness } from './unit-readiness';
+export declare function declaredNotesOf(plans: Iterable<{
+    readonly declaredNotes: ReadonlySet<string>;
+}>): ReadonlySet<string>;
 export interface UnitFailure {
     readonly id: string;
     readonly reason: string;
@@ -35,6 +38,7 @@ export interface UnitsPlan {
     }>;
     readonly failed: readonly UnitFailure[];
     readonly warmReads: () => readonly (readonly string[])[];
+    readonly declaredNotes: ReadonlySet<string>;
     readonly disposeLongTasks: () => void;
 }
 interface NamedEntry {

package/dist/types/shared/hooks/use-diy-record.d.ts

@@ -0,0 +1,8 @@
+import type { RecordState } from '@dsh-workbench/shared';
+import type { HostWrite } from './use-host-write';
+export declare const DIY_RECORD_ROUTE = "panels/diy-record";
+export declare const DIY_RECORD_FACT = "diy-record";
+export declare function useDiyRecordState(): RecordState | null;
+export declare function useDiyRecordAct(): HostWrite<{
+    text?: string;
+}>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/core",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "个人工作台：Agent 工作台外壳（左栏 + 常驻对话 + 自研右侧数据面板）。",
   "type": "module",
   "icon": "./icon.svg",
@@ -87,7 +87,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@dsh-workbench/shared": "0.3.3"
+    "@dsh-workbench/shared": "0.3.4"
   },
   "scripts": {
     "build": "node scripts/build.mjs && node scripts/build-types.mjs",

package/scripts/seed-workshop.sh

@@ -102,6 +102,24 @@ target_version() {
   printf '%s\n' "$version"
 }
 
+# 外壳 manifest 里钉的那份 dsh UI 版本（模块模板默认带的那个 devDependency，见
+# `.scratch/dsh-primitives-face/spec.md` §3.1）。源优先**基准**（正在跑的那份外壳），
+# 没有才退回跑脚本这份副本 —— 与 link_workshop_skills 同一条口径。
+# 读不到就留空：调用方按"不写这一项"处理（模块 `init` 那边有自己的兜底常量与一句人话）。
+shell_primitives_version() {
+  local root="$SHELL_ROOT"
+  [ -n "$root" ] && [ -f "$root/package.json" ] || root="$REPO_DIR"
+  [ -f "$root/package.json" ] || return 0
+  node -e '
+const fs = require("node:fs");
+try {
+  const pinned = JSON.parse(fs.readFileSync(process.argv[1], "utf8"))
+    .devDependencies?.["@deepseek-ai/dsh-client-ui-primitives"];
+  process.stdout.write(typeof pinned === "string" ? pinned : "");
+} catch {}
+' "$root/package.json" 2>/dev/null || true
+}
+
 # 三个包的装法**只有一处真相**：仓库副本 link 进本仓，安装副本按目标版本装。
 # skeleton 与 sync 都调它 —— 两份规则漂开的症状是"根清单是 link、overrides 是 ^"，
 # 于是同一个工坊里两代并存（正是要防的那件事），而且不报错。
@@ -124,6 +142,15 @@ compute_specs() {
     TOOLS_SPEC="^$version"
     SHARED_SPEC="^$version"
   fi
+  # dsh 原语（模块模板默认带的那个）：**精确版**，与模块自己那份 devDependency 对齐 ——
+  # 类型面要对齐对账过的那一版（`.scratch/dsh-primitives-face/spec.md` §3.1）。
+  # 空 = 读不到外壳 manifest，就**不写这一项**（模块 `init` 有自己的兜底常量）。
+  local primitives_version
+  primitives_version="$(shell_primitives_version)"
+  PRIMITIVES_SPEC=""
+  if [ -n "$primitives_version" ]; then
+    PRIMITIVES_SPEC="$primitives_version"
+  fi
 }
 
 # 日志**只有一处**去处：$DSH_HOME/workbench/seed.log（冻结接口）。
@@ -395,8 +422,8 @@ run_sync() {
     log_line "→ ⚠️ 自愈失败：${reason}"
     return 1
   fi
-  node - "$DIY_DIR/package.json" "$CORE_SPEC" "$TOOLS_SPEC" "$SHARED_SPEC" <<'NODE'
-const [file, core, tools, shared] = process.argv.slice(2);
+  node - "$DIY_DIR/package.json" "$CORE_SPEC" "$TOOLS_SPEC" "$SHARED_SPEC" "$PRIMITIVES_SPEC" <<'NODE'
+const [file, core, tools, shared, primitives] = process.argv.slice(2);
 const fs = require('node:fs');
 const manifest = JSON.parse(fs.readFileSync(file, 'utf8'));
 const want = {
@@ -405,6 +432,11 @@ const want = {
   '@dsh-workbench/shared': shared,
 };
 manifest.devDependencies = { ...(manifest.devDependencies ?? {}), ...want };
+// dsh 原语（模块模板默认带的那个）：只进 devDependencies，**不进 overrides** ——
+// 它不是 @dsh-workbench 的包，覆盖它没有意义（那是"多个模块各装一份"的另一种病）。
+if (primitives !== undefined && primitives !== '') {
+  manifest.devDependencies['@deepseek-ai/dsh-client-ui-primitives'] = primitives;
+}
 manifest.pnpm = {
   ...(manifest.pnpm ?? {}),
   overrides: { ...(manifest.pnpm?.overrides ?? {}), ...want },
@@ -556,6 +588,13 @@ if [ -f "$DIY_DIR/package.json" ]; then
   echo "→ DIY 工坊已存在，跳过建骨架（要重来就先删掉 ${DIY_DIR}）"
 else
   echo "→ 建 DIY 工坊 $DIY_DIR"
+  # 原语那一行可能没有（读不到外壳 manifest 时不写）：空行在 JSON 里无害。
+  # ⚠️ 这里是 `if` 不是 `[ … ] && …`：后者在 `set -e` 下，测试为假时整条语句返回 1，
+  # 脚本会**当场退出**（骨架只建到一半、自愈也不起了）—— 实测被 ④ 那一格抓到。
+  PRIMITIVES_LINE=""
+  if [ -n "$PRIMITIVES_SPEC" ]; then
+    PRIMITIVES_LINE="    \"@deepseek-ai/dsh-client-ui-primitives\": \"$PRIMITIVES_SPEC\","
+  fi
   cat >"$DIY_DIR/package.json" <<EOF
 {
   "name": "dsh-workbench-diy",
@@ -567,6 +606,7 @@ else
     "@dsh-workbench/core": "$CORE_SPEC",
     "@dsh-workbench/module-tools": "$TOOLS_SPEC",
     "@dsh-workbench/shared": "$SHARED_SPEC",
+${PRIMITIVES_LINE}
     "@types/node": "^24.19.0",
     "@types/react": "^19.3.0",
     "esbuild": "^0.28.2",

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

@@ -68,7 +68,7 @@ pnpm exec dsh-wb-module init <unit> --dir <工坊>/packages/module-<unit> --temp
 
 | 文件 | 职责 |
 |---|---|
-| `package.json` | 自述清单：包名、`dsh.bundle.patch`、`dsh.client`、`dsh.workbench.unit`、`dsh.workbenchFaces{host,client}`（工具链字段，门禁必填）、六个脚本、peer 依赖 |
+| `package.json` | 自述清单：包名、`dsh.bundle.patch`、`dsh.client`（`external` 默认带 `@dsh-workbench/core/client` 与 dsh 原语那行）、`dsh.workbench.unit`、`dsh.workbenchFaces{host,client}`（工具链字段，门禁必填）、六个脚本、peer 依赖；原语那行由 `init` 盖精确版（[KIT.md](KIT.md) §8） |
 | `arch.config.mjs` | 模块自己的**架构方言**：**只有一行**工厂调用 `moduleArch()`（从 `@dsh-workbench/module-tools/arch` 来）。层序表 / 两个运行时 / 阈值只有那一份，随工具链同代 |
 | `eslint.config.mjs` | 模块自己的**语法卫生方言**：**只有两行** —— `moduleLint({ rootDir: import.meta.dirname })`（从 `@dsh-workbench/module-tools/lint` 来；`rootDir` 把 tsconfig 根钉在这个模块上，多份配置并存时 typescript-eslint 才猜得出）。规则 / ignores 只有那一份，随工具链同代；要放行某条就从 `moduleLint({ rules, ignores })` 开口子，别改方言那些块（判据比整份 8 块，逐块点名），也别手写一份自己的（自己 import 方言再照抄整份则分不出来） |
 | `cordis.patch.yml` | 把自己插进 profile 的那一行 |
@@ -104,6 +104,7 @@ dsh-wb-module build                 # 出 client.js 与 dist/host.js
 dsh-wb-module check                 # 十三条判据，全跑
 dsh-wb-module check --only cards    # 单跑一条（contracts / protocol / bundles / source / arch / lint /
                                     #   primitives / kit / cards / standalone / markers / style / alias）
+dsh-wb-module check --only primitives [--all|--json]   # 查询口：dsh 原语里有什么
 dsh-wb-module lint [--fix]          # 跑模块自己那份 eslint 配置；--fix 写回
 ```
 
@@ -116,7 +117,7 @@ dsh-wb-module lint [--fix]          # 跑模块自己那份 eslint 配置；--fi
 
 ```bash
 pnpm build       # 构建
-pnpm typecheck   # tsc --noEmit
+pnpm typecheck   # tsc --noEmit（init 后先 pnpm install）
 pnpm test        # vitest
 pnpm selfcheck   # 构建 + 把 client.js 当加载器跑一遍（`diy` 骨架里还多一条 `design check`）
 pnpm check       # dsh-wb-module check：十三条判据
@@ -134,7 +135,7 @@ pnpm lint        # dsh-wb-module lint：语法卫生（`pnpm lint -- --fix` 写
 `workbench_diy_status`（`unit=<单元 id>`）看它现在走到哪一步、`workbench_diy_install` 装上并上板、
 `workbench_diy_show` 只上板 —— 见 §7。**上完板自己逐条走一遍（这就是验收那一拍）**：浏览器那 14 把
 （`state` / `get html` / `find` / `click` / `hover` / `type` / `fill` / `keys` / `scroll` / `wait` / `eval` /
-`screenshot` / `network` / `dialog`，argv 与结果原样转发，全表见 [TOOLS.md](TOOLS.md) §13）打的是
+`screenshot` / `network` / `dialog`，argv 与结果原样转发，全表见 [FAMILY.md](FAMILY.md)）打的是
 **用户当前那一页**上工坊那块板里的那张卡 —— 用户那一页不会被换掉，但他得把工作台切到前台。
 **看屏 / 动屏那一族（浏览器那 14 把 / `logs_*`）要先 `workbench_diy_debug_start`**（`unit=…`；
 会请他点头一次）—— 没有这场约定它们一律当场拒；不看屏了先 `_pause`、收工 `_stop`。

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

@@ -75,13 +75,38 @@
 画不成的只有这几类，写词（并说清意思）：纯动作（"点一下去平台"）、agent 的下一步、
 时间性的词（"不变 / 自己变 / 立刻"）、纯映射表（能力名 ↔ 用户会怎么说）。
 
+### 审批屏：写工具族必答，而且那两格是固定的
+
+有"要用户点头"的写工具，就把**审批屏**也画进图里。它的形状不是自由的（仓内 ADR-0065，这份指引不链仓内路径）：
+
+```
+┌─ card（dsh 的壳）─────────────────────────────────────────┐
+│ ● 等待审批                                                 │ ← dsh 画的
+├───────────────────────────────────────────────────────────┤
+│ <标题：一句，≤40 字，…，允许吗？>                            │ ← 你写的 question / fallback
+│ <详情：ApprovalPlan 的两列表 + warn>                        │ ← 你写的 approval.render
+├───────────────────────────────────────────────────────────┤
+│                                  [ 拒绝 ]  [ 允许一次 ]    │
+└───────────────────────────────────────────────────────────┘
+```
+
+四条口径（同一份：[KIT.md](KIT.md) §3）：
+
+1. **标题只有一句**：`…，允许吗？` 收尾并点名"工作台"（工作台自己的动作可用 `申请…` 陈述句式）；
+   装配后 ≤108 字（含数据）。
+2. **事实放详情**，用外壳的 `ApprovalPlan`（`approval: { tools, render }`）：等宽、能换行、能滚，
+   长 URL / diff / 多字段都住这儿。
+3. **别把事实塞进标题**：宿主那句 `approvalDetail`（明细）只留给**没有详情表**的族，≤20 字一行 ——
+   你既然画了详情表，它就是空的。
+4. **附注（`approval_note`）不是你的**：只有 opencli 插件命令那族才必填；模块定义的工具默认没有那一格。
+
 ## 4 做完的判据
 
 - 全程**用户只说过需求相关的话**：没有一次被问"用什么、放在哪、叫什么、怎么测"。
 - 三张表没有空格（`dsh-wb-module design check` 绿）；表里每一格，都在真卡片上见过或点过，
   验收清单逐条打上了勾（`design accept`）。
 - **验收归谁按域分**：**DIY 域（工坊会话）的验收是 agent 自己走的** —— 调试族
-  （`workbench_diy_debug_start` + 浏览器那 14 把枚举工具 + `logs_*`，全表见 [TOOLS.md](TOOLS.md) §13）
+  （`workbench_diy_debug_start` + 浏览器那 14 把枚举工具 + `logs_*`，全表见 [FAMILY.md](FAMILY.md)）
   就是取证面；用户不必在场、也不必逐条点头，走完把"装好了、面板上哪一格"告诉他即可。
   **工程域没有那一族**，仍按「打开 :3081 → 右栏第 N 张卡 → 点 X → 应该看到 Y」请他看一次。
 - 要用户点头的**写能力（审批）那一拍仍是他的**：他真用一次时点，agent 代不了 ——