@dsh-workbench/shared 0.1.0

package/dist/components/SaveBar.js

@@ -0,0 +1,6 @@
+import { h } from '../lib/react.js';
+export function SaveBar({ busy, disabled, labels, onCancel, onSave }) {
+    return (h("div", { className: "wb-formActions" },
+        h("button", { type: "button", className: "wb-linkButton", onClick: onCancel, disabled: busy }, labels.cancel),
+        h("button", { type: "button", className: "wb-primaryButton", onClick: onSave, disabled: busy || disabled === true }, busy ? labels.saving : labels.save)));
+}

package/dist/components/StateDot.d.ts

@@ -0,0 +1,5 @@
+export type DotState = 'ongoing' | 'warning' | 'done' | 'idle' | string;
+export declare function StateDot({ state, size }: {
+    state: DotState;
+    size: number;
+}): JSX.Element;

package/dist/components/StateDot.js

@@ -0,0 +1,10 @@
+import { h } from '../lib/react.js';
+export function StateDot({ state, size }) {
+    if (state === 'ongoing') {
+        return (h("svg", { className: "wb-loading", viewBox: "0 0 24 24", width: size, height: size, "aria-hidden": "true", style: { display: 'block' } },
+            h("g", { className: "wb-loadingMotion" },
+                h("circle", { className: "wb-loadingTrack", cx: 12, cy: 12, r: 9.5 }),
+                h("circle", { className: "wb-loadingArc", cx: 12, cy: 12, r: 9.5 }))));
+    }
+    return (h("span", { className: "wb-stateDot", "data-state": state, style: { width: size, height: size }, "aria-hidden": "true" }));
+}

package/dist/components/board-module.d.ts

@@ -0,0 +1,67 @@
+import type { ReactNode } from 'react';
+import type { SessionsSnapshot, Translate, WorkspaceSnapshot, WorkspaceView } from '../api/dsh-client.js';
+import type { UnitManifest } from '../api/unit.js';
+import type { CapabilityPayload } from '../api/workbench-contract.js';
+import type { Dictionaries } from '../i18n/index.js';
+export interface PanelStep {
+    readonly kind: string;
+}
+export interface SuiteWorld {
+    readonly workspaces: WorkspaceSnapshot;
+    readonly sessions: SessionsSnapshot;
+    readonly manifests: readonly UnitManifest[];
+    readonly panelConfig: {
+        readonly shown: Readonly<Record<string, boolean>>;
+    } | null;
+    readonly capabilities: Readonly<Record<string, CapabilityPayload>> | null;
+    readonly current: {
+        readonly sessionId: string | null;
+        readonly workspace: WorkspaceView | null;
+    };
+}
+export interface BoardModuleProps {
+    readonly world: SuiteWorld;
+    readonly refreshToken: number;
+    readonly onRefresh: () => void;
+    readonly onNavigate: (step: PanelStep) => void;
+    readonly onOpenMarket: () => void;
+    readonly onSummary: (summary: ModuleSummary) => void;
+    readonly t: Translate;
+}
+export interface ModuleSummary {
+    readonly refreshing: boolean;
+    readonly at: number | null;
+}
+export interface UnitStep {
+    readonly titleKey: string;
+    readonly View: (props: BoardModuleProps) => ReactNode;
+}
+export interface BoardModule {
+    readonly id: string;
+    readonly titleKey: string;
+    readonly order: number;
+    readonly enabledByDefault: boolean;
+    readonly View: (props: BoardModuleProps) => ReactNode;
+    readonly steps?: Readonly<Record<string, UnitStep>>;
+}
+export interface UnitClientFace {
+    readonly manifest: UnitManifest;
+    readonly card: (props: BoardModuleProps) => ReactNode;
+    readonly steps?: Readonly<Record<string, UnitStep>>;
+    readonly messages?: Dictionaries;
+    readonly approval?: {
+        readonly tools: readonly string[];
+        readonly render: (props: {
+            readonly input: ApprovalInput;
+            readonly t: Translate;
+        }) => ReactNode;
+    } | undefined;
+}
+export interface ApprovalInput {
+    readonly tool: string;
+    readonly args: Readonly<Record<string, unknown>>;
+}
+export interface UnitClientApi {
+    registerUnit(face: UnitClientFace): () => void;
+    manifests(): readonly UnitManifest[];
+}

package/dist/components/board-module.js

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

package/dist/components/icons.d.ts

@@ -0,0 +1,18 @@
+export interface IconProps {
+    size?: number;
+}
+export declare function IconPanelLeft({ size }: IconProps): JSX.Element;
+export declare function IconFolder({ size }: IconProps): JSX.Element;
+export declare function IconFolderOpen({ size }: IconProps): JSX.Element;
+export declare function IconChevronDown({ size }: IconProps): JSX.Element;
+export declare function IconPlus({ size }: IconProps): JSX.Element;
+export declare function IconEllipsis({ size }: IconProps): JSX.Element;
+export declare function IconSettings({ size }: IconProps): JSX.Element;
+export declare function IconPin({ size }: IconProps): JSX.Element;
+export declare function IconCheck({ size }: IconProps): JSX.Element;
+export declare function IconNewChat({ size }: IconProps): JSX.Element;
+export declare function IconRefresh({ size }: IconProps): JSX.Element;
+export declare function IconRightUp({ size }: IconProps): JSX.Element;
+export declare function IconConversation({ size }: IconProps): JSX.Element;
+export declare function IconBrandMark({ size }: IconProps): JSX.Element;
+export declare function IconModules({ size }: IconProps): JSX.Element;

package/dist/components/icons.js

@@ -0,0 +1,81 @@
+import { h } from '../lib/react.js';
+function Shell({ size, strokeWidth = 1, viewBox = '0 0 16 16', children, }) {
+    return (h("svg", { width: size, height: size, viewBox: viewBox, fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: strokeWidth, style: { display: 'block' } }, children));
+}
+export function IconPanelLeft({ size = 16 }) {
+    return (h(Shell, { size: size },
+        h("path", { d: "M13.5 1.5H2.5C1.94772 1.5 1.5 1.94772 1.5 2.5V13.5C1.5 14.0523 1.94772 14.5 2.5 14.5H13.5C14.0523 14.5 14.5 14.0523 14.5 13.5V2.5C14.5 1.94772 14.0523 1.5 13.5 1.5Z", stroke: "currentColor" }),
+        h("path", { d: "M5.5 1.5V14.5", stroke: "currentColor" })));
+}
+export function IconFolder({ size = 16 }) {
+    return (h(Shell, { size: size },
+        h("path", { d: "M1.50439 3.11059C1.50439 2.55831 1.95211 2.1106 2.50439 2.1106H5.43389C5.67773 2.1106 5.91318 2.19969 6.09593 2.36113L7.71649 3.79265C7.89924 3.95409 8.1347 4.04319 8.3785 4.04319H13.4958C14.0481 4.04319 14.4958 4.4909 14.4958 5.04319V12.8894C14.4958 13.4417 14.0481 13.8894 13.4958 13.8894H2.50439C1.95211 13.8894 1.50439 13.4417 1.50439 12.8894V4.04319V3.11059Z", stroke: "currentColor" }),
+        h("path", { d: "M3.63501 7.66614H12.3647", stroke: "currentColor" })));
+}
+export function IconFolderOpen({ size = 16 }) {
+    return (h(Shell, { size: size },
+        h("path", { d: "M2.55912 7.93683C2.67584 7.49906 3.0723 7.19446 3.52536 7.19446H13.6491C14.3061 7.19446 14.7846 7.81725 14.6153 8.45209L13.4411 12.856C13.3244 13.2938 12.9279 13.5984 12.4748 13.5984H2.35113C1.69411 13.5984 1.21562 12.9756 1.38489 12.3407L2.55912 7.93683Z", fill: "currentColor", opacity: 0.16 }),
+        h("path", { d: "M13.6491 6.69446C14.6346 6.69453 15.3522 7.62895 15.0983 8.58118L13.9245 12.9845C13.7494 13.6412 13.1539 14.0988 12.4743 14.0988H2.35126C1.36574 14.0988 0.648153 13.1643 0.902044 12.212L2.07587 7.80774C2.25102 7.15128 2.84567 6.69455 3.52509 6.69446H13.6491ZM3.52509 7.69446C3.29865 7.69455 3.10004 7.84674 3.04169 8.06555L1.86786 12.4698C1.78345 12.7872 2.02285 13.0988 2.35126 13.0988H12.4743C12.7007 13.0988 12.8992 12.9463 12.9577 12.7277L14.1325 8.32336C14.2171 8.00598 13.9776 7.69453 13.6491 7.69446H3.52509Z", fill: "currentColor" }),
+        h("path", { d: "M4.7666 1.90137C5.13227 1.90144 5.48571 2.03525 5.75977 2.27734L7.27246 3.61328C7.36379 3.69382 7.48174 3.73828 7.60352 3.73828H12.3994C13.2276 3.73841 13.8993 4.41005 13.8994 5.23828V6.7168C13.8183 6.70327 13.735 6.69436 13.6494 6.69434H12.8994V5.23828C12.8993 4.96233 12.6754 4.73841 12.3994 4.73828H7.60352C7.23781 4.73828 6.88446 4.60438 6.61035 4.3623L5.09766 3.02637C5.00636 2.94576 4.88838 2.90144 4.7666 2.90137H2.0498C1.77366 2.90137 1.5498 3.12523 1.5498 3.40137V9.78223L0.902344 12.2119C0.648452 13.1642 1.36604 14.0986 2.35156 14.0986H2.0498C1.2214 14.0986 0.549838 13.427 0.549805 12.5986V3.40137C0.549805 2.57294 1.22138 1.90137 2.0498 1.90137H4.7666Z", fill: "currentColor" })));
+}
+export function IconChevronDown({ size = 14 }) {
+    return (h(Shell, { size: size },
+        h("path", { d: "M4 6L7.29289 9.29289C7.68342 9.68342 8.31658 9.68342 8.70711 9.29289L12 6", stroke: "currentColor" })));
+}
+export function IconPlus({ size = 16 }) {
+    return (h(Shell, { size: size },
+        h("path", { d: "M8 2V14", stroke: "currentColor" }),
+        h("path", { d: "M2 8H14", stroke: "currentColor" })));
+}
+export function IconEllipsis({ size = 16 }) {
+    return (h(Shell, { size: size },
+        h("path", { d: "M3 9C3.55228 9 4 8.55228 4 8C4 7.44772 3.55228 7 3 7C2.44772 7 2 7.44772 2 8C2 8.55228 2.44772 9 3 9Z", fill: "currentColor" }),
+        h("path", { d: "M8 9C8.55228 9 9 8.55228 9 8C9 7.44772 8.55228 7 8 7C7.44772 7 7 7.44772 7 8C7 8.55228 7.44772 9 8 9Z", fill: "currentColor" }),
+        h("path", { d: "M13 9C13.5523 9 14 8.55228 14 8C14 7.44772 13.5523 7 13 7C12.4477 7 12 7.44772 12 8C12 8.55228 12.4477 9 13 9Z", fill: "currentColor" })));
+}
+export function IconSettings({ size = 16 }) {
+    return (h(Shell, { size: size },
+        h("path", { d: "M8 9.75012C8.9665 9.75012 9.75 8.96662 9.75 8.00012C9.75 7.03362 8.9665 6.25012 8 6.25012C7.0335 6.25012 6.25 7.03362 6.25 8.00012C6.25 8.96662 7.0335 9.75012 8 9.75012Z", stroke: "currentColor" }),
+        h("path", { d: "M13.0107 7.79377C12.9505 7.89401 12.9205 7.94413 12.9205 7.99951C12.9205 8.0549 12.9505 8.10502 13.0106 8.20528L13.9849 9.83006C14.045 9.93029 14.0751 9.9804 14.0751 10.0358C14.0751 10.0911 14.045 10.1413 13.9849 10.2415L13.0037 11.8777C12.9468 11.9726 12.9184 12.0201 12.8725 12.0461C12.8267 12.072 12.7713 12.072 12.6607 12.072H10.6704C10.5598 12.072 10.5045 12.072 10.4586 12.098C10.4128 12.1239 10.3843 12.1714 10.3274 12.2662L9.33825 13.9142C9.28133 14.009 9.25287 14.0564 9.20703 14.0823C9.16118 14.1083 9.10588 14.1083 8.99529 14.1083H7.00486C6.89426 14.1083 6.83896 14.1083 6.79312 14.0823C6.74727 14.0564 6.71881 14.009 6.6619 13.9142L5.67273 12.2662C5.61581 12.1714 5.58735 12.1239 5.54151 12.098C5.49566 12.072 5.44036 12.072 5.32977 12.072H3.33945C3.2288 12.072 3.17347 12.072 3.12761 12.0461C3.08176 12.0201 3.0533 11.9726 2.9964 11.8777L2.0152 10.2415C1.9551 10.1413 1.92505 10.0911 1.92505 10.0358C1.92505 9.9804 1.9551 9.93029 2.0152 9.83006L2.98951 8.20528C3.04963 8.10502 3.07969 8.0549 3.07969 7.99951C3.07968 7.94413 3.04961 7.89401 2.98946 7.79377L2.01529 6.17011C1.95514 6.06987 1.92507 6.01975 1.92507 5.96437C1.92506 5.90899 1.95512 5.85886 2.01524 5.7586L2.9964 4.1224C3.0533 4.0275 3.08176 3.98005 3.12761 3.95408C3.17347 3.92811 3.2288 3.92811 3.33945 3.92811H5.32977C5.44036 3.92811 5.49566 3.92811 5.54151 3.90216C5.58735 3.87621 5.61581 3.82879 5.67273 3.73397L6.6619 2.08599C6.71881 1.99116 6.74727 1.94375 6.79312 1.9178C6.83896 1.89185 6.89426 1.89185 7.00486 1.89185H8.99529C9.10588 1.89185 9.16118 1.89185 9.20703 1.9178C9.25287 1.94375 9.28133 1.99116 9.33825 2.08599L10.3274 3.73397C10.3843 3.82879 10.4128 3.87621 10.4586 3.90216C10.5045 3.92811 10.5598 3.92811 10.6704 3.92811H12.6607C12.7713 3.92811 12.8267 3.92811 12.8725 3.95408C12.9184 3.98005 12.9468 4.0275 13.0037 4.1224L13.9849 5.7586C14.045 5.85886 14.0751 5.90899 14.0751 5.96437C14.0751 6.01975 14.045 6.06987 13.9849 6.17011L13.0107 7.79377Z", stroke: "currentColor", strokeMiterlimit: 10 })));
+}
+export function IconPin({ size = 16 }) {
+    return (h(Shell, { size: size },
+        h("path", { d: "M9.96976 1.70572L13.1554 3.93629L10.9019 8.12317L11.5158 11.605L10.7192 12.7427L2.52767 7.00693L3.3243 5.86922L6.80612 5.25528L9.96976 1.70572Z", fill: "currentColor", stroke: "currentColor", strokeLinejoin: "round" }),
+        h("path", { d: "M6.05285 9.47511C6.27284 9.16094 6.70586 9.08458 7.02003 9.30457C7.3342 9.52455 7.41055 9.95757 7.19057 10.2717L3.98587 14.4708L3.21223 13.9291L6.05285 9.47511Z", fill: "currentColor" })));
+}
+export function IconCheck({ size = 16 }) {
+    return (h(Shell, { size: size },
+        h("path", { d: "M2.25 8.5L5.49732 11.7473C5.90519 12.1552 6.57263 12.1344 6.95426 11.7018L13.75 4", stroke: "currentColor" })));
+}
+export function IconNewChat({ size = 14 }) {
+    return (h(Shell, { size: size, strokeWidth: 1.3 },
+        h("path", { d: "M2.37091 11.2501C1.58745 9.89288 1.32067 8.29835 1.61969 6.76006C1.91872 5.22177 2.76342 3.8433 3.99826 2.87846C5.2331 1.91362 6.77494 1.42737 8.33988 1.50925C9.90482 1.59113 11.3875 2.23562 12.5149 3.32406C13.6425 4.41269 14.3387 5.87206 14.4754 7.4334C14.612 8.99474 14.18 10.5529 13.2587 11.8209C12.3375 13.0888 10.9891 13.9813 9.46194 14.3337C8.18691 14.628 6.85895 14.5294 5.64989 14.0605C5.1712 13.8748 4.76962 13.4932 4.26534 13.3967C3.67413 13.2835 2.95257 13.5598 2.03794 14.3337", stroke: "currentColor" }),
+        h("path", { d: "M8 5V11", stroke: "currentColor" }),
+        h("path", { d: "M5 8H11", stroke: "currentColor" })));
+}
+export function IconRefresh({ size = 16 }) {
+    return (h(Shell, { size: size },
+        h("path", { d: "M14.5001 8C14.5 9.28552 14.1188 10.5422 13.4045 11.611C12.6903 12.6799 11.6752 13.5129 10.4875 14.0049C9.29982 14.4968 7.99295 14.6255 6.73212 14.3747C5.4713 14.124 4.31314 13.505 3.4041 12.596C2.49514 11.687 1.87614 10.5288 1.62537 9.26798C1.37459 8.00716 1.50331 6.70028 1.99525 5.51261C2.48719 4.32494 3.32025 3.30981 4.3891 2.59557C5.45795 1.88134 6.71458 1.50008 8.0001 1.5C9.9001 1.5 11.7001 2.3 13.0001 3.6L14.5001 5.1", stroke: "currentColor" }),
+        h("path", { d: "M14.4999 1.5V5.1H10.8999", stroke: "currentColor" })));
+}
+export function IconRightUp({ size = 14 }) {
+    return (h(Shell, { size: size },
+        h("path", { d: "M11.7256 2.77441C12.5538 2.77469 13.2256 3.44616 13.2256 4.27441V10.1416H12.2256V4.27441C12.2256 3.99844 12.0015 3.77469 11.7256 3.77441H5.7207V2.77441H11.7256Z", fill: "currentColor" }),
+        h("path", { d: "M2.77441 13.2255L12.3756 3.62427", stroke: "currentColor" })));
+}
+export function IconConversation({ size = 16 }) {
+    return (h(Shell, { size: size, strokeWidth: 1.3 },
+        h("path", { d: "M2.5 7.2c0-2.3 2.1-4.2 4.8-4.2h1.4c2.7 0 4.8 1.9 4.8 4.2s-2.1 4.2-4.8 4.2H7.5l-3.2 2v-2.3c-1.1-.8-1.8-2-1.8-3.9Z", stroke: "currentColor", strokeLinejoin: "round" })));
+}
+export function IconBrandMark({ size = 24 }) {
+    return (h(Shell, { size: size, strokeWidth: 1.6, viewBox: "0 0 24 24" },
+        h("rect", { x: 3, y: 3, width: 18, height: 18, rx: 5, stroke: "currentColor" }),
+        h("path", { d: "M8 9.5h8M8 12.5h8M8 15.5h5", stroke: "currentColor", strokeLinecap: "round" })));
+}
+export function IconModules({ size = 16 }) {
+    return (h("svg", { width: size, height: size, viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true" },
+        h("rect", { x: "2.5", y: "2.5", width: "4.6", height: "4.6", rx: "1.2", stroke: "currentColor", strokeWidth: "1.2" }),
+        h("rect", { x: "8.9", y: "2.5", width: "4.6", height: "4.6", rx: "1.2", stroke: "currentColor", strokeWidth: "1.2" }),
+        h("rect", { x: "2.5", y: "8.9", width: "4.6", height: "4.6", rx: "1.2", stroke: "currentColor", strokeWidth: "1.2" }),
+        h("rect", { x: "8.9", y: "8.9", width: "4.6", height: "4.6", rx: "1.2", stroke: "currentColor", strokeWidth: "1.2" })));
+}

package/dist/config/constants.d.ts

@@ -0,0 +1,27 @@
+export declare const PLUGIN_ID = "@dsh-workbench/core";
+export declare const API_PREFIX = "/workbench/api";
+export declare const PREFS_PREFIX = "/workbench/api/prefs";
+export declare const EVENTS_PATH = "/workbench/events";
+export declare const ACTIONS_PREFIX = "/workbench/api/actions";
+export declare const PROVISION_PREFIX = "/workbench/api/provision";
+export declare const OPENCLI_PIN = "1.8.8";
+export declare const CODING_ISSUES_SERVICE = "workbenchCodingIssues";
+export declare const PANELS_SERVICE = "workbenchPanels";
+export declare const UNITS_SERVICE = "workbenchUnits";
+export declare const PANEL_LIST_LIMIT = 50;
+export declare const OPENCLI_TIMEOUT_MS = 120000;
+export declare const OPENCLI_MAX_CONCURRENT = 4;
+export declare const WARM_TIMEOUT_MS = 20000;
+export declare const INSTALL_TIMEOUT_MS = 300000;
+export declare const VERSION_CHECK_TIMEOUT_MS = 10000;
+export declare const VERSION_CHECK_TTL_MS = 600000;
+export declare const PROBE_TTL_MS = 30000;
+export declare const MIN_BUSY_MS = 500;
+export declare const HANDOFF_TTL_MS = 15000;
+export declare const GIT_TIMEOUT_MS = 10000;
+export declare const PANEL_POLL_MS = 2000;
+export declare const DEFAULT_WORKSPACE_TITLE = "default-workspace";
+export declare const STORAGE_KEY_PROJECT = "dsh-workbench.project";
+export declare const STORAGE_KEY_RIGHTBAR = "dsh-workbench.rightbar.expanded";
+export declare const LOCALE_NS = "workbench";
+export declare const LOCALES: readonly ["zh", "en"];

package/dist/config/constants.js

@@ -0,0 +1,27 @@
+export const PLUGIN_ID = "@dsh-workbench/core";
+export const API_PREFIX = "/workbench/api";
+export const PREFS_PREFIX = `${API_PREFIX}/prefs`;
+export const EVENTS_PATH = "/workbench/events";
+export const ACTIONS_PREFIX = `${API_PREFIX}/actions`;
+export const PROVISION_PREFIX = `${API_PREFIX}/provision`;
+export const OPENCLI_PIN = "1.8.8";
+export const CODING_ISSUES_SERVICE = "workbenchCodingIssues";
+export const PANELS_SERVICE = "workbenchPanels";
+export const UNITS_SERVICE = "workbenchUnits";
+export const PANEL_LIST_LIMIT = 50;
+export const OPENCLI_TIMEOUT_MS = 120_000;
+export const OPENCLI_MAX_CONCURRENT = 4;
+export const WARM_TIMEOUT_MS = 20_000;
+export const INSTALL_TIMEOUT_MS = 300_000;
+export const VERSION_CHECK_TIMEOUT_MS = 10_000;
+export const VERSION_CHECK_TTL_MS = 600_000;
+export const PROBE_TTL_MS = 30_000;
+export const MIN_BUSY_MS = 500;
+export const HANDOFF_TTL_MS = 15_000;
+export const GIT_TIMEOUT_MS = 10_000;
+export const PANEL_POLL_MS = 2000;
+export const DEFAULT_WORKSPACE_TITLE = "default-workspace";
+export const STORAGE_KEY_PROJECT = "dsh-workbench.project";
+export const STORAGE_KEY_RIGHTBAR = "dsh-workbench.rightbar.expanded";
+export const LOCALE_NS = "workbench";
+export const LOCALES = ["zh", "en"];

package/dist/config/storage.d.ts

@@ -0,0 +1,4 @@
+export declare function readText(key: string): string | null;
+export declare function writeText(key: string, value: string | null): void;
+export declare function readFlag(key: string, fallback: boolean): boolean;
+export declare function writeFlag(key: string, value: boolean): void;

package/dist/config/storage.js

@@ -0,0 +1,27 @@
+export function readText(key) {
+    try {
+        return window.localStorage.getItem(key);
+    }
+    catch {
+        return null;
+    }
+}
+export function writeText(key, value) {
+    try {
+        if (value === null)
+            window.localStorage.removeItem(key);
+        else
+            window.localStorage.setItem(key, value);
+    }
+    catch {
+    }
+}
+export function readFlag(key, fallback) {
+    const raw = readText(key);
+    if (raw === null)
+        return fallback;
+    return raw === 'true';
+}
+export function writeFlag(key, value) {
+    writeText(key, value ? 'true' : 'false');
+}

package/dist/host/__tests__/fakes.d.ts

@@ -0,0 +1,41 @@
+import type { DshShell } from '../../api/dsh.js';
+import type { Opencli } from '../../host/opencli.js';
+export interface ShellCall {
+    command: string;
+    workdir?: string;
+    timeoutMs?: number;
+    onExpiry?: string;
+    stdoutMaxBytes?: number;
+}
+export interface ShellReply {
+    stdout?: string;
+    stderr?: string;
+    exitCode?: number | null;
+    timedOut?: boolean;
+    aborted?: boolean;
+    failWith?: Error;
+}
+export declare function createFakeShell(replies?: ShellReply[] | ((call: ShellCall, index: number) => ShellReply)): {
+    shell: DshShell;
+    calls: ShellCall[];
+    peak: () => number;
+    commands: () => string[];
+};
+export interface OpencliCall {
+    args: readonly string[];
+    key?: string;
+    workdir?: string;
+    refresh?: boolean;
+}
+export declare function createFakeOpencli(replies?: Array<unknown | Error> | ((call: OpencliCall, index: number) => unknown | Error)): {
+    opencli: Opencli;
+    calls: OpencliCall[];
+    keys: () => (string | undefined)[];
+};
+export declare function createFakeLogger(): {
+    logger: {
+        info: () => void;
+        warn: (message: string) => void;
+    };
+    warnings: string[];
+};

package/dist/host/__tests__/fakes.js

@@ -0,0 +1,76 @@
+import { setTimeout as delay } from 'node:timers/promises';
+const tick = () => delay(0);
+export function createFakeShell(replies = []) {
+    const calls = [];
+    let running = 0;
+    let peak = 0;
+    const replyAt = (index) => typeof replies === 'function' ? replies(calls[index], index) : (replies[index] ?? {});
+    const shell = {
+        resolve(request) {
+            calls.push(request);
+            return request;
+        },
+        async execute() {
+            const index = calls.length - 1;
+            const reply = replyAt(index);
+            if (reply.failWith !== undefined)
+                throw reply.failWith;
+            running += 1;
+            peak = Math.max(peak, running);
+            return {
+                async result() {
+                    await tick();
+                    running -= 1;
+                    return {
+                        exitCode: reply.exitCode ?? 0,
+                        timedOut: reply.timedOut ?? false,
+                        aborted: reply.aborted ?? false,
+                        stdout: { text: reply.stdout ?? '', truncated: false },
+                        stderr: { text: reply.stderr ?? '', truncated: false },
+                    };
+                },
+            };
+        },
+    };
+    return {
+        shell,
+        calls,
+        peak: () => peak,
+        commands: () => calls.map((call) => call.command),
+    };
+}
+export function createFakeOpencli(replies = []) {
+    const calls = [];
+    const opencli = {
+        async json(args, options = {}) {
+            const call = {
+                args,
+                ...(options.key === undefined ? {} : { key: options.key }),
+                ...(options.workdir === undefined ? {} : { workdir: options.workdir }),
+            };
+            calls.push(call);
+            const index = calls.length - 1;
+            const reply = typeof replies === 'function' ? replies(call, index) : (replies[index] ?? []);
+            if (reply instanceof Error)
+                throw reply;
+            return { value: reply, at: Date.now() };
+        },
+    };
+    return {
+        opencli,
+        calls,
+        keys: () => calls.map((call) => call.key),
+    };
+}
+export function createFakeLogger() {
+    const warnings = [];
+    return {
+        logger: {
+            info: () => { },
+            warn: (message) => {
+                warnings.push(message);
+            },
+        },
+        warnings,
+    };
+}

package/dist/host/__tests__/preflight-fixtures.d.ts

@@ -0,0 +1,19 @@
+import { createFakeShell } from './fakes';
+export declare const GOOD_BRIDGE_REPORT: string;
+export declare const ALL_OK: {
+    stdout: string;
+}[];
+export declare const STALE_DAEMON_BRIDGE: string;
+export declare const BROKEN_BRIDGE: string;
+export declare function build(replies: Parameters<typeof createFakeShell>[0], install?: () => Promise<{
+    ok: boolean;
+    detail: string;
+}>, warmReads?: () => readonly (readonly string[])[]): {
+    fake: {
+        shell: import("../..").DshShell;
+        calls: import("./fakes").ShellCall[];
+        peak: () => number;
+        commands: () => string[];
+    };
+    preflight: import("../preflight").Preflight;
+};

package/dist/host/__tests__/preflight-fixtures.js

@@ -0,0 +1,47 @@
+import { createPreflight } from '../preflight';
+import { createFakeShell } from './fakes';
+export const GOOD_BRIDGE_REPORT = [
+    'opencli v1.8.7 doctor (node v24.15.0)',
+    '',
+    '[OK] Daemon: running on port 19825 (v1.8.7)',
+    '[OK] Extension: connected (v1.0.24)',
+    '[OK] Connectivity: connected in 0.0s',
+    '',
+    'Everything looks good!',
+].join('\n');
+export const ALL_OK = [{ stdout: '1.8.8\n' }, { stdout: GOOD_BRIDGE_REPORT }];
+export const STALE_DAEMON_BRIDGE = [
+    'opencli v1.8.7 doctor (node v24.15.0)',
+    '',
+    '[STALE] Daemon: running on port 19825 (v1.8.8 != CLI v1.8.7)',
+    '[OK] Extension: connected (v1.0.24)',
+    '[OK] Connectivity: connected in 0.0s',
+    '',
+    'Issues:',
+    '  • Stale daemon detected: daemon v1.8.8 != CLI v1.8.7.',
+    '  Run: opencli daemon restart',
+].join('\n');
+export const BROKEN_BRIDGE = [
+    'opencli v1.8.7 doctor (node v24.15.0)',
+    '',
+    '[MISSING] Daemon: not running',
+    '[MISSING] Extension: not connected',
+    '[FAIL] Connectivity: failed (daemon not reachable)',
+    '',
+    'Issues:',
+    "  • Daemon is not running. It should start automatically when you run an opencli browser command.",
+    '  • Daemon is running but the Chrome/Chromium extension is not connected.',
+    'If the extension is not installed:',
+    '  1. Download from https://github.com/jackwener/opencli/releases',
+    '  2. Open chrome://extensions/ → Enable Developer Mode',
+    '  3. Click "Load unpacked" → select the extension folder',
+].join('\n');
+export function build(replies, install, warmReads) {
+    const fake = createFakeShell(replies);
+    const preflight = createPreflight({
+        shell: fake.shell,
+        ...(install === undefined ? {} : { install }),
+        ...(warmReads === undefined ? {} : { warmReads }),
+    });
+    return { fake, preflight };
+}

package/dist/host/cli-error.d.ts

@@ -0,0 +1,8 @@
+export interface CliErrorEnvelope {
+    readonly code: string;
+    readonly message: string;
+    readonly help?: string;
+    readonly exitCode?: number;
+}
+export declare function parseCliErrorEnvelope(text: string | undefined): CliErrorEnvelope | undefined;
+export declare function helpUrlOf(envelope: CliErrorEnvelope): string | undefined;

package/dist/host/cli-error.js

@@ -0,0 +1,70 @@
+function unquote(raw) {
+    const value = raw.trim();
+    if (value.length >= 2 && ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'")))) {
+        return value.slice(1, -1);
+    }
+    return value;
+}
+function joinBlock(previous, line, fold) {
+    if (previous === '')
+        return line;
+    return fold ? `${previous} ${line}` : `${previous}\n${line}`;
+}
+export function parseCliErrorEnvelope(text) {
+    if (text === undefined || text.trim() === '')
+        return undefined;
+    const lines = text.split('\n');
+    const start = lines.findIndex((line) => /^error:\s*$/.test(line.trim()) || /^error:\s*\S/.test(line.trim()));
+    if (start === -1)
+        return undefined;
+    const scalars = {};
+    let current;
+    let block;
+    const errorIndent = lines[start]?.search(/\S/) ?? 0;
+    for (const line of lines.slice(start + 1)) {
+        if (line.trim() === '')
+            continue;
+        const indent = line.search(/\S/);
+        if (block !== undefined && indent > block.indent) {
+            scalars[block.key] = joinBlock(scalars[block.key] ?? '', line.trim(), block.fold);
+            continue;
+        }
+        block = undefined;
+        if (indent <= errorIndent)
+            break;
+        const match = /^\s*(code|message|help|exitCode):\s*(.*)$/.exec(line);
+        if (match === null) {
+            if (current !== undefined)
+                scalars[current] = `${scalars[current] ?? ''} ${line.trim()}`.trim();
+            continue;
+        }
+        const [, key, value] = match;
+        if (key === undefined)
+            continue;
+        const raw = (value ?? '').trim();
+        const marker = /^([|>])[0-9]*([+-]?)$/.exec(raw);
+        if (marker !== null) {
+            scalars[key] = '';
+            block = { key, fold: marker[1] === '>', indent };
+            current = key;
+            continue;
+        }
+        scalars[key] = unquote(raw);
+        current = key;
+    }
+    const code = scalars['code'];
+    const message = scalars['message'];
+    if (code === undefined || code === '')
+        return undefined;
+    const exitCode = scalars['exitCode'];
+    return {
+        code,
+        message: message ?? code,
+        ...(scalars['help'] === undefined || scalars['help'] === '' ? {} : { help: scalars['help'] }),
+        ...(exitCode === undefined || Number.isNaN(Number(exitCode)) ? {} : { exitCode: Number(exitCode) }),
+    };
+}
+export function helpUrlOf(envelope) {
+    const match = /https?:\/\/[^\s"'`]+/.exec(envelope.help ?? '');
+    return match?.[0];
+}

package/dist/host/context-inject.d.ts

@@ -0,0 +1,24 @@
+import { type ContextRef } from '@dsh-workbench/shared';
+import type { ContextRenderer } from './unit-face';
+export declare const CONTEXT_SOURCE_KIND = "workbench";
+export interface ScannableMessage {
+    readonly source?: {
+        readonly kind?: string;
+    };
+    readonly content?: readonly {
+        readonly type?: string;
+        readonly text?: string;
+    }[];
+}
+export type { ContextRenderer };
+export declare function collectContextRefs(messages: readonly ScannableMessage[]): ContextRef[];
+export declare function buildContextMessage(text: string, summary: string): unknown;
+export interface ContextInjector {
+    inject(messages: readonly ScannableMessage[], agent: unknown): Promise<unknown | undefined>;
+}
+export declare function createContextInjector(options: {
+    renderers: ReadonlyMap<string, ContextRenderer>;
+    logger?: {
+        warn?(message: string): void;
+    } | undefined;
+}): ContextInjector;