@dsh-workbench/core 0.3.2 → 0.3.4

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-browser-act.d.ts

@@ -1,47 +1,10 @@
 import type { DshShell } from '@dsh-workbench/shared';
 import { type BrowserStep } from './diy-browser';
 export declare const ACT_TIMEOUT_MS = 15000;
-export interface ActTarget {
-    readonly selector: string;
-    readonly role: string;
-    readonly name: string;
-    readonly testid: string;
-    readonly nth: number | null;
-    readonly page: boolean;
-}
-export declare function actTargetOf(raw: Record<string, unknown>): ActTarget;
-export declare function scopedSelectorOf(unit: string, target: ActTarget): string;
-export declare const SCOPE_ATTR = "data-diy-scope";
-export declare function semanticOptionsOf(target: ActTarget): readonly string[];
-export declare function targetOptionsOf(target: ActTarget): readonly string[];
-export declare function refsOf(payload: Record<string, unknown> | undefined): readonly number[];
-export declare function totalMatchesOf(payload: Record<string, unknown> | undefined): number;
-export declare function scopeMarkScriptOf(unit: string, refs: readonly number[], nth: number, token: string): string;
-export declare function scopeClearScriptOf(token: string): string;
-export declare function scopedMarkerSelectorOf(unit: string, token: string): string;
 export interface ActStep extends BrowserStep {
     readonly payload: Record<string, unknown> | undefined;
 }
 export declare function actBrowser(shell: DshShell, command: string, session: string, argv: readonly string[], timeoutMs?: number): Promise<ActStep>;
 export declare function actErrorOf(step: ActStep): string;
-export declare function matchesOf(step: ActStep): number;
-export declare function scrollIntoView(shell: DshShell, command: string, session: string, unit: string, selector: string): Promise<ActStep>;
-export declare function reloadPage(shell: DshShell, command: string, session: string): Promise<ActStep>;
-export interface WidthShot {
-    readonly ok: boolean;
-    readonly file: string;
-    readonly width: number;
-    readonly height: number;
-    readonly reason: string;
-}
-export declare function shootAtWidth(shell: DshShell, command: string, session: string, file: string, width?: number, height?: number): Promise<WidthShot>;
-export interface NetworkArm {
-    readonly ok: boolean;
-    readonly pid: string;
-    readonly reason: string;
-}
-export declare const NET_CAP_LINES = 2000;
-export declare const NET_CAP_SECONDS = 900;
-export declare function armNetwork(shell: DshShell, command: string, session: string, file: string): Promise<NetworkArm>;
-export declare function stopNetwork(shell: DshShell, session: string, file: string): Promise<boolean>;
-export declare function readNetwork(shell: DshShell, file: string, lines: number): Promise<readonly Record<string, unknown>[]>;
+export declare const SWEEP_TIMEOUT_MS = 4000;
+export declare function stopNetworkExact(shell: DshShell, file: string, timeoutMs?: number): Promise<boolean>;

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

@@ -0,0 +1,39 @@
+import type { DshHostContext, DshToolRegistry } from '@dsh-workbench/shared';
+import { type PngRect } from '../../../shared/api/host/png-crop';
+import { type PanelsToolName } from '../unit';
+export declare const CARD_TOKEN = "$card";
+export interface PngClip {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+export type CssTarget = {
+    readonly kind: 'positional';
+    readonly at: number;
+    readonly onlyWhenFirst?: string | undefined;
+} | {
+    readonly kind: 'flag';
+    readonly flag: string;
+};
+export interface BrowserToolRow {
+    readonly tool: PanelsToolName;
+    readonly verb: readonly string[];
+    readonly description: string;
+    readonly argsHelp: string;
+    readonly css?: CssTarget | undefined;
+    readonly evalInCard?: boolean | undefined;
+    readonly clip?: boolean | undefined;
+}
+export declare function cardSelectorIn(unit: string): string;
+export declare function evalWrapped(script: string, card: string): string;
+export declare function argvOf(row: BrowserToolRow, raw: Record<string, unknown>, unit: string): string[];
+export declare function clipOf(value: unknown): PngClip | undefined;
+export declare function deviceClipRect(clip: PngClip, dpr: number): PngRect;
+export declare function clipNote(clip: PngClip, viewport: {
+    readonly width: number;
+    readonly height: number;
+}): string;
+export declare function defaultShotPath(packagesDir: string, unit: string, stamp: number): string;
+export declare const BROWSER_TOOLS: readonly BrowserToolRow[];
+export declare function registerBrowserTools(ctx: DshHostContext, tools: DshToolRegistry): readonly (() => void)[];

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

@@ -1,6 +1,4 @@
 import type { DshShell } from '@dsh-workbench/shared';
-import { type PngRect } from '../../../shared/api/host/png-crop';
-import { type CardView, type PickRequest } from './diy-scripts';
 export declare const LOOK_TIMEOUT_MS = 30000;
 export interface BrowserStep {
     readonly ok: boolean;
@@ -8,6 +6,7 @@ export interface BrowserStep {
     readonly stderr: string;
     readonly exitCode: number | null;
     readonly timedOut: boolean;
+    readonly truncated: boolean;
 }
 export declare function runBrowserStep(shell: DshShell, command: string, argv: readonly string[], timeoutMs?: number): Promise<BrowserStep>;
 export declare function jsonOf(raw: string): Record<string, unknown> | undefined;
@@ -37,15 +36,3 @@ export interface PageHandshake {
     readonly reason: string;
 }
 export declare function readyPageOf(shell: DshShell, command: string, session: string): Promise<PageHandshake>;
-export declare function measureCard(shell: DshShell, command: string, session: string, unit: string, pick: PickRequest): Promise<CardView>;
-export interface Shot {
-    readonly ok: boolean;
-    readonly file: string;
-    readonly width: number;
-    readonly height: number;
-    readonly cropped: boolean;
-    readonly reason: string;
-}
-export declare function insideViewportOf(view: CardView): boolean;
-export declare function deviceRectOf(view: CardView): PngRect;
-export declare function shootCard(shell: DshShell, command: string, session: string, unit: string, file: string, view: CardView): Promise<Shot>;

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-observers.d.ts

@@ -0,0 +1,11 @@
+import type { DshHostContext } from '@dsh-workbench/shared';
+import type { DebugStore } from '@dsh-workbench/shared/host';
+export interface ObserverCleanup {
+    readonly net: boolean;
+    readonly logs: boolean;
+}
+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;

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

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

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

@@ -21,6 +21,7 @@ export interface PageOptions {
     readonly requirePact?: boolean | undefined;
 }
 export declare function debugPausedText(held: DebugState): string;
+export declare function debugMissingPactText(): string;
 export declare function debugForeignPactText(held: DebugState): string;
 export declare function debugOffBoardText(held: DebugState, situation?: BoardSituation): string;
 export declare function boardProbeOf(page: WorkbenchPage): BoardProbe;

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/diy-scripts.d.ts

@@ -1,65 +1,2 @@
 export declare const PAGE_PROBE = "(async () => {\n  const answer = await fetch('/workbench/api/health').then((one) => one.json()).catch(() => null);\n  const root = document.querySelector('.wb-root');\n  const where = root === null ? '' : (root.getAttribute('data-wb-where') ?? '');\n  const bar = document.querySelector('.wb-rightbar');\n  const board = bar === null ? '' : (bar.getAttribute('data-wb-board') ?? '');\n  const open = bar === null ? null : bar.hasAttribute('data-wb-open');\n  const style = bar === null ? null : getComputedStyle(bar);\n  const box = bar === null ? null : bar.getBoundingClientRect();\n  const drawn =\n    bar !== null &&\n    style.visibility !== 'hidden' &&\n    style.display !== 'none' &&\n    box.width > 0 &&\n    box.height > 0;\n  return JSON.stringify({\n    plugin: answer === null ? null : answer.plugin,\n    pid: answer === null ? null : answer.pid,\n    url: location.href,\n    title: document.title,\n    where,\n    board,\n    open,\n    shown: drawn,\n  });\n})()";
 export declare function cardSelectorOf(unit: string): string;
-export type DomMode = 'none' | 'outline' | 'html';
-export interface PickRequest {
-    readonly props: readonly string[];
-    readonly parts: readonly string[];
-    readonly dom: DomMode;
-}
-export declare const DOM_MODES: readonly DomMode[];
-export interface PickFacts {
-    readonly card: Readonly<Record<string, string>>;
-    readonly parts: Readonly<Record<string, Readonly<Record<string, string>>>>;
-}
-export declare const DEFAULT_PROPS: readonly ["display", "flexDirection", "gap", "padding", "width", "height", "overflow", "backgroundColor", "color", "borderRadius", "fontSize", "lineHeight", "fontFamily", "boxSizing", "--dsw-radius-xl", "--dsw-alias-bg-layer-1", "--dsw-alias-label-primary"];
-export declare const DEFAULT_PARTS: readonly [".wb-cardHead", ".wb-cardBody"];
-export declare function cleanNames(value: unknown, cap: number): readonly string[];
-export declare function pickOf(raw: Record<string, unknown>): PickRequest;
-export interface CardView {
-    readonly ok: boolean;
-    readonly anchored: boolean;
-    readonly visible: boolean;
-    readonly width: number;
-    readonly height: number;
-    readonly head: string;
-    readonly text: string;
-    readonly clipped: boolean;
-    readonly cards: number;
-    readonly rect: {
-        readonly x: number;
-        readonly y: number;
-        readonly width: number;
-        readonly height: number;
-    };
-    readonly dpr: number;
-    readonly viewport: {
-        readonly width: number;
-        readonly height: number;
-    };
-    readonly pick: PickFacts;
-    readonly slot: SlotFacts;
-    readonly outline: readonly CardNode[];
-    readonly html: string;
-}
-export interface SlotFacts {
-    readonly parentWidth: number;
-    readonly parentDisplay: string;
-    readonly columns: string;
-    readonly index: number;
-    readonly cards: number;
-    readonly viewportHeight: number;
-    readonly scrollHeight: number;
-}
-export interface CardNode {
-    readonly depth: number;
-    readonly tag: string;
-    readonly cls: string;
-    readonly role: string;
-    readonly name: string;
-    readonly text: string;
-}
-export declare const EMPTY_CARD: CardView;
-export declare function measureScriptOf(unit: string, pick: PickRequest): string;
-export declare function nodesOf(value: unknown): readonly CardNode[];
-export declare function slotOf(value: unknown): SlotFacts;
-export declare function pickFactsOf(value: unknown): PickFacts;

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

@@ -0,0 +1,5 @@
+import type { DshHostContext, DshToolDefinition, DshToolRegistry } from '@dsh-workbench/shared';
+export declare const SPEC_TIMEOUT_MS = 20000;
+export declare function specArgvOf(command: string): readonly string[];
+export declare function specTool(ctx: DshHostContext): DshToolDefinition;
+export declare function registerSpecTool(ctx: DshHostContext, tools: DshToolRegistry): readonly (() => void)[];

package/dist/types/modules/panels/model/diy-spec.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,34 +17,42 @@ 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_LOOK_TOOL = "workbench_diy_look";
 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";
+export declare const DIY_HTML_TOOL = "workbench_diy_html";
+export declare const DIY_FIND_TOOL = "workbench_diy_find";
 export declare const DIY_CLICK_TOOL = "workbench_diy_click";
+export declare const DIY_HOVER_TOOL = "workbench_diy_hover";
 export declare const DIY_TYPE_TOOL = "workbench_diy_type";
 export declare const DIY_FILL_TOOL = "workbench_diy_fill";
 export declare const DIY_KEYS_TOOL = "workbench_diy_keys";
-export declare const DIY_HOVER_TOOL = "workbench_diy_hover";
-export declare const DIY_SELECT_TOOL = "workbench_diy_select";
 export declare const DIY_SCROLL_TOOL = "workbench_diy_scroll";
-export declare const DIY_RELOAD_TOOL = "workbench_diy_reload";
-export declare const DIY_VIEWPORT_TOOL = "workbench_diy_viewport";
-export declare const DIY_NET_WATCH_TOOL = "workbench_diy_net_watch";
-export declare const DIY_NET_READ_TOOL = "workbench_diy_net_read";
-export declare const DIY_NET_STOP_TOOL = "workbench_diy_net_stop";
+export declare const DIY_WAIT_TOOL = "workbench_diy_wait";
+export declare const DIY_EVAL_TOOL = "workbench_diy_eval";
+export declare const DIY_SCREENSHOT_TOOL = "workbench_diy_screenshot";
+export declare const DIY_NETWORK_TOOL = "workbench_diy_network";
+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_probe", "workbench_diy_look", "workbench_diy_install", "workbench_diy_show", "workbench_diy_click", "workbench_diy_type", "workbench_diy_fill", "workbench_diy_keys", "workbench_diy_hover", "workbench_diy_select", "workbench_diy_scroll", "workbench_diy_reload", "workbench_diy_viewport", "workbench_diy_net_watch", "workbench_diy_net_read", "workbench_diy_net_stop", "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_probe", "workbench_diy_look", "workbench_diy_click", "workbench_diy_type", "workbench_diy_fill", "workbench_diy_keys", "workbench_diy_hover", "workbench_diy_select", "workbench_diy_scroll", "workbench_diy_reload", "workbench_diy_viewport", "workbench_diy_net_watch", "workbench_diy_net_read", "workbench_diy_net_stop", "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_probe", "workbench_diy_look", "workbench_diy_install", "workbench_diy_show", "workbench_diy_click", "workbench_diy_type", "workbench_diy_fill", "workbench_diy_keys", "workbench_diy_hover", "workbench_diy_select", "workbench_diy_scroll", "workbench_diy_reload", "workbench_diy_viewport", "workbench_diy_net_watch", "workbench_diy_net_read", "workbench_diy_net_stop", "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;