@dsh-workbench/core 0.3.3 → 0.3.5

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

@@ -0,0 +1,13 @@
+import type { ApprovalInput, ReactNode, Translate } from '@dsh-workbench/shared';
+export interface ApprovalRow {
+    readonly label: string;
+    readonly value: string;
+}
+export declare function recordApprovalRows(args: Readonly<Record<string, unknown>>, t: Translate): readonly ApprovalRow[];
+export interface ApprovalPlanView {
+    readonly rows: readonly ApprovalRow[];
+    readonly warn?: string | undefined;
+}
+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;

package/dist/types/app/layouts/sidebar/RecordFooterAction.d.ts

@@ -0,0 +1,16 @@
+import type { RecordIntent, RecordState, Translate } from '@dsh-workbench/shared';
+export interface RecordFooterActionProps {
+    readonly wide?: boolean | undefined;
+    readonly t: Translate;
+}
+export interface RecordActView {
+    readonly intent: RecordIntent;
+    readonly label: string;
+}
+export interface RecordFooterView {
+    readonly label: string;
+    readonly note: string;
+    readonly acts: readonly RecordActView[];
+}
+export declare function recordFooterView(state: RecordState, t: Translate): RecordFooterView;
+export declare function RecordFooterAction({ wide, t }: RecordFooterActionProps): JSX.Element | null;

package/dist/types/app/layouts/sidebar/record-footer.d.ts

@@ -0,0 +1,4 @@
+import type { DshClientContext } from '@dsh-workbench/shared';
+export declare const RECORD_FOOTER_ID = "workbench-record";
+export declare const RECORD_FOOTER_ORDER = 11;
+export declare function registerRecordFooter(ctx: DshClientContext): void;

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

@@ -0,0 +1 @@
+export { ALL_TOOLS, DIY_RECORD_PREPARE_TOOL, DIY_RECORD_READ_TOOL } from './unit';

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

@@ -0,0 +1,3 @@
+import type { DshHostContext, DshToolDefinition, DshToolRegistry } from '@dsh-workbench/shared';
+export declare function componentsTool(ctx: DshHostContext): DshToolDefinition;
+export declare function registerComponentsTool(ctx: DshHostContext, tools: DshToolRegistry): readonly (() => void)[];

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

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

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

@@ -1,5 +1,4 @@
 import type { DshHostContext, DshToolRunContext } from '@dsh-workbench/shared';
-import { type BrowserFindResult, type BrowserReadResult } from '@dsh-workbench/shared/host';
 import type { BundleChange } from '../../../shared/api/bundle-install';
 import type { PanelsService } from './service';
 export declare const OUTPUT_SCHEMA: {
@@ -85,18 +84,18 @@ export declare function asNumber(value: unknown): number | undefined;
 export declare function asText(value: unknown): string;
 export declare function plainJson<T>(value: T): T;
 export declare function verdictOf(change: BundleChange): string;
-export declare function renderProbe(out: BrowserReadResult): string;
-export declare function renderFind(out: BrowserFindResult): string;
 export declare function showOrReason(panels: PanelsService, unit: string, workspace: string | null): {
     readonly ok: boolean;
     readonly reason?: string;
 };
-export declare function workshopOf(ctx: DshHostContext, exec: DshToolRunContext): {
+export declare function workshopOf(ctx: DshHostContext, exec: DshToolRunContext): Promise<{
     readonly packagesDir: string;
     readonly workspace: string | null;
-};
+    readonly title: string;
+}>;
 export declare function modulesOf(ctx: DshHostContext, packagesDir: string): {
     installed: string[];
     modules: readonly import("@/shared/api/host/diy-workshop").WorkshopModule[];
 };
+export declare function moduleDirsOf(packagesDir: string): readonly string[];
 export declare function panelEntriesOf(panels: PanelsService, workspace: string | null): import("./config").PanelEntry[];

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

@@ -7,5 +7,5 @@ export interface ObserverCleanup {
 export interface CleanupLog {
     warn?(message: string): void;
 }
-export declare function stopObservers(ctx: DshHostContext, session?: string): Promise<ObserverCleanup>;
-export declare function withObserverCleanup(store: DebugStore, cleanup: () => Promise<ObserverCleanup>, logger?: CleanupLog | undefined): DebugStore;
+export declare function stopObservers(ctx: DshHostContext, workspace: string | null | undefined, session?: string): Promise<ObserverCleanup>;
+export declare function withObserverCleanup(store: DebugStore, cleanup: (workspace: string | null) => Promise<ObserverCleanup>, logger?: CleanupLog | undefined): DebugStore;

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

@@ -26,5 +26,5 @@ export declare function debugForeignPactText(held: DebugState): string;
 export declare function debugOffBoardText(held: DebugState, situation?: BoardSituation): string;
 export declare function boardProbeOf(page: WorkbenchPage): BoardProbe;
 export declare function boardStateOf(page: WorkbenchPage, workshop: string | null): BoardState;
-export declare function boardGateText(situation: BoardSituation, unit: string, page: WorkbenchPage): string;
+export declare function boardGateText(situation: BoardSituation, unit: string, page: WorkbenchPage, title?: string): string;
 export declare function pageAt(ctx: DshHostContext, exec: DshToolRunContext, raw: unknown, options?: PageOptions): Promise<PageHandle>;

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

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

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

@@ -0,0 +1,27 @@
+import type { RecordCall } from './diy-record-text';
+export declare const SEGMENT_SLACK_MS = 1500;
+export interface CaptureEntry {
+    readonly key: string;
+    readonly at: number;
+    readonly method: string;
+    readonly url: string;
+    readonly status: number;
+    readonly ct: string;
+    readonly size: number;
+    readonly request: string;
+    readonly response: string;
+    readonly requestFullSize: number;
+    readonly responseFullSize: number;
+    readonly requestSizeExact: boolean;
+    readonly responseSizeExact: boolean;
+    readonly headers: string;
+}
+export declare function captureEntriesOf(text: string): readonly CaptureEntry[];
+export declare function segmentOf(entries: readonly CaptureEntry[], t0: number | null, t1: number | null): {
+    readonly inside: readonly CaptureEntry[];
+    readonly outside: number;
+};
+export declare function captureCallsOf(entries: readonly CaptureEntry[]): readonly RecordCall[];
+export declare function mergeCalls(hook: readonly RecordCall[], captured: readonly RecordCall[]): readonly RecordCall[];
+export declare function pickAllOf(entries: readonly CaptureEntry[], key: string): readonly CaptureEntry[];
+export declare function pickOf(entries: readonly CaptureEntry[], key: string, at?: number | null): CaptureEntry | null;

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

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

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

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

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

@@ -0,0 +1,2 @@
+import type { RecordStore, RouteTable } from '@dsh-workbench/shared/host';
+export declare function diyRecordRoutes(store: RecordStore): RouteTable;

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

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

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

@@ -0,0 +1,6 @@
+export declare const RECORD_KEY = "__dshDiyRecord";
+export declare const RECORD_KEEP_KEY = "__dshDiyRecordKeep";
+export declare const RECORD_OFF_KEY = "__dshDiyRecordOff";
+export declare const RECORD_ARM_SCRIPT: string;
+export declare const RECORD_READ_SCRIPT: string;
+export declare const RECORD_STOP_SCRIPT: string;

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,9 +17,9 @@ 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";
 export declare const DIY_INSTALL_TOOL = "workbench_diy_install";
 export declare const DIY_SHOW_TOOL = "workbench_diy_show";
 export declare const DIY_STATE_TOOL = "workbench_diy_state";
@@ -39,14 +39,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_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_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_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/context-chips.d.ts

@@ -1,10 +1,30 @@
 import type { DshClientContext } from '@dsh-workbench/shared';
 import { type ContextRef } from '@dsh-workbench/shared';
+/**
+ * 对话 `@` 引用源报名用的名字：引用、lexicon 与编解码都挂在这个 source 名下。
+ */
 export declare const CONTEXT_SOURCE = "workbench";
+/**
+ * `addContextChip` 的结果：`inserted` 真插进输入框了、`unavailable` 这台 dsh 缺服务或当时插不进去。
+ */
 export type ChipResult = 'inserted' | 'unavailable';
+/**
+ * 装引用源要的外壳依赖：现在这个会话是哪一个 —— 拿不到 session id 就插不了。
+ */
 export interface ContextChipsDeps {
     currentSessionId(): string | undefined;
 }
+/**
+ * 外壳启动、拿到 dsh 的 client context 之后调一次：把 `@` 引用源注册进对话输入框；
+ * dsh 没给 `inputTriggers` 时不装、也不报错。
+ */
 export declare function installContextChips(ctx: DshClientContext, deps: ContextChipsDeps): void;
+/**
+ * 要往当前对话输入框插一条 `@` 引用时调用（卡片上“发到对话”那类动作）：同步返回，只反映当场这一拍 ——
+ * 没插进去会自己再试几拍，后面成功了也不会回头改这个返回值。没装过 / 没会话 / 拿不到输入框都回 `unavailable`。
+ */
 export declare function addContextChip(ref: ContextRef, label: string): ChipResult;
+/**
+ * 把编好的引用串码成带 `@` 的标记文本（输入框里显示与复制到剪贴板都是这一份）；认不出的串原样加个 `@`。
+ */
 export declare function serializeChipRef(encoded: string): string;

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,65 @@
+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 toolchainBinAmong(root: string, dirs: readonly 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, fallbackBin?: 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;
+/** 指引目录：从宿主产物往上找 `skills/workbench-module-diy`（找不到回 `null`）。 */
+export declare function skillDirOf(from: string): string | null;
+export declare function byLocationOf(payload: SurfacePayload): readonly {
+    readonly where: string;
+    readonly names: readonly string[];
+}[];
+export interface SurfaceBucket {
+    readonly label: string;
+    readonly key: string;
+    readonly names: readonly string[];
+}
+export declare function kitBucketsOf(payload: SurfacePayload): readonly SurfaceBucket[];
+export declare function matchesBucket(where: string, bucket: string): boolean;
+export declare function bucketNamesOf(query: SurfaceQuery): readonly {
+    readonly face: 'kit' | 'primitives';
+    readonly keys: readonly string[];
+}[];
+export declare const TWO_FACE_ALL = "\u26A0\uFE0F \u4E24\u4E2A\u9762\u4E00\u8D77\u4E0D\u7ED9\u5168\u8868 \u2014\u2014 \u8981\u5168\u8868\u5C31\u6307\u540D\u4E00\u9762\uFF1Ascope=kit \u6216 scope=primitives\u3002";
+export declare function refusesEvery(scope: SurfaceScope, all: boolean, focused: boolean): boolean;
+export declare function renderSurfaceText(query: SurfaceQuery, options: {
+    scope: SurfaceScope;
+    all: boolean;
+    bucket?: string;
+}): 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

@@ -1,4 +1,3 @@
-import type { DshHostContext } from '@dsh-workbench/shared';
 export interface WorkshopModule {
     readonly unit: string;
     readonly name: string;
@@ -6,10 +5,9 @@ export interface WorkshopModule {
     readonly dir: string;
     readonly installed: boolean;
 }
-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 inWorkshopSession(ctx: DshHostContext, workspace: string | null): boolean;
+export declare function readDesignOfModule(dir: string): unknown;
 export interface WorkshopSync {
     readonly state: 'ok' | 'syncing' | 'failed';
     readonly version: string;

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/api/host/preset-scope.d.ts

@@ -0,0 +1,16 @@
+import type { DshHostContext } from '@dsh-workbench/shared';
+import { type ToolScopeContext } from '@dsh-workbench/shared/host';
+import { type ToolScope } from './tool-scope';
+export interface SessionProjections {
+    stateOf(session: unknown, key: string): unknown;
+    onChanged(listener: (session: unknown, key: string, value: unknown, seq: unknown) => void): () => void;
+}
+export interface PresetScopeOptions {
+    readonly ctx: DshHostContext;
+    readonly deniedTools: (context: ToolScopeContext) => readonly string[];
+    readonly logger?: {
+        info?(message: string): void;
+        warn?(message: string): void;
+    } | undefined;
+}
+export declare function createPresetScope(options: PresetScopeOptions): ToolScope;