@hachej/boring-workspace 0.1.0

package/dist/explorer-DtLUnuah.d.ts

@@ -0,0 +1,129 @@
+interface UiBridge {
+    getState(): Promise<UiState | null>;
+    setState(state: UiState): Promise<void>;
+    postCommand(cmd: UiCommand): Promise<CommandResult>;
+    subscribeCommands(handler: (cmd: UiCommand & {
+        seq: number;
+    }) => void): () => void;
+    drainCommands?(): Promise<Array<UiCommand & {
+        seq: number;
+    }>>;
+}
+type UiState = Record<string, unknown>;
+type UiCommand = {
+    kind: 'openFile';
+    params: {
+        path: string;
+        mode?: 'view' | 'edit' | 'diff';
+    };
+} | {
+    kind: 'openSurface';
+    params: {
+        kind: string;
+        target: string;
+        meta?: Record<string, unknown>;
+    };
+} | {
+    kind: 'openPanel';
+    params: {
+        id: string;
+        component: string;
+        params?: Record<string, unknown>;
+    };
+} | {
+    kind: 'closePanel';
+    params: {
+        id: string;
+    };
+} | {
+    kind: 'closeWorkbenchLeftPane';
+    params: Record<string, never>;
+} | {
+    kind: 'showNotification';
+    params: {
+        msg: string;
+        level?: 'info' | 'warn' | 'error';
+    };
+} | {
+    kind: 'navigateToLine';
+    params: {
+        file: string;
+        line: number;
+    };
+} | {
+    kind: 'expandToFile';
+    params: {
+        path: string;
+    };
+} | {
+    kind: string;
+    params: Record<string, unknown>;
+};
+interface CommandResult {
+    seq: number;
+    status: 'ok' | 'error';
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+
+/**
+ * DataExplorer shared types — no runtime deps.
+ *
+ * Importable from BOTH front and server bundles without dragging in
+ * platform-specific code.
+ */
+type Badge = {
+    /** 1–4 char mono code rendered as a chip. */
+    code: string;
+    tooltip?: string;
+};
+type ExplorerRow = {
+    id: string;
+    title: string;
+    /** Optional muted second line (truncates with title). */
+    subtitle?: string;
+    /** Group key — must match one of the facet values for `groupBy`. */
+    group?: string;
+    /** Leading mono chip (e.g. type code, frequency). */
+    leading?: Badge;
+    /** Trailing mono chips for status flags (e.g. [D] derived, [LIVE]). */
+    trailing?: Badge[];
+    /** Right-aligned plain text for numeric metadata (e.g. "1.2M", "2.4s"). */
+    meta?: string;
+};
+type FacetValue = {
+    value: string;
+    count: number;
+};
+type Facets = Record<string, FacetValue[]>;
+type SearchArgs = {
+    query: string;
+    filters: Record<string, string[]>;
+    /** Scope to a single group's value (only set when paginating inside a group). */
+    group?: {
+        key: string;
+        value: string;
+    };
+    limit: number;
+    offset: number;
+    signal?: AbortSignal;
+};
+type SearchResult = {
+    items: ExplorerRow[];
+    /** Total count for the current scope (query + filters + optional group). */
+    total: number;
+    hasMore: boolean;
+};
+type FacetsArgs = {
+    filters: Record<string, string[]>;
+    signal?: AbortSignal;
+};
+type ExplorerAdapter = {
+    search(args: SearchArgs): Promise<SearchResult>;
+    /** Optional. When omitted, the explorer renders flat (no facet popover). */
+    fetchFacets?(args: FacetsArgs): Promise<Facets>;
+};
+
+export type { CommandResult as C, ExplorerAdapter as E, SearchResult as S, UiBridge as U, UiCommand as a, UiState as b, ExplorerRow as c };

package/dist/panel-DnvDNQac.js

@@ -0,0 +1,6 @@
+function n(e) {
+  return e;
+}
+export {
+  n as d
+};

package/dist/server.d.ts

@@ -0,0 +1,84 @@
+import { U as UiBridge, E as ExplorerAdapter, S as SearchResult } from './explorer-DtLUnuah.js';
+export { C as CommandResult, a as UiCommand, b as UiState } from './explorer-DtLUnuah.js';
+import { FastifyRequest, FastifyInstance } from 'fastify';
+import { A as AgentTool } from './agent-tool-NvxKfist.js';
+import { b as WorkspaceServerPlugin } from './bootstrapServer-BRUqUpVW.js';
+export { C as ComposeServerPluginsOptions, S as ServerBootstrapOptions, e as ServerBootstrapResult, f as ServerPluginError, W as WorkspaceProvisioningContribution, a as WorkspaceRouteContribution, g as bootstrapServer, c as composeServerPlugins, d as defineServerPlugin, v as validateServerPlugin } from './bootstrapServer-BRUqUpVW.js';
+export { PiPackageSource as WorkspacePiPackageSource } from '@hachej/boring-agent/server';
+
+declare function createInMemoryBridge(): UiBridge;
+
+interface UiRoutesOptions {
+    bridge?: UiBridge;
+    getBridge?: (request: FastifyRequest) => UiBridge | Promise<UiBridge>;
+}
+declare function uiRoutes(app: FastifyInstance, opts: UiRoutesOptions, done: (err?: Error) => void): void;
+
+interface ExecUiToolOptions {
+    /**
+     * Workspace root used to validate paths in path-bearing commands
+     * (`openFile`, `expandToFile`, `navigateToLine`). When provided, the
+     * tool stat-checks the resolved path before queueing the UI command and
+     * returns an error to the agent if the file is missing or escapes the
+     * root — so the model gets immediate feedback instead of the frontend
+     * silently no-op'ing on a wrong path. When omitted, paths are passed
+     * through unvalidated (back-compat for callers without server-side
+     * filesystem access).
+     */
+    workspaceRoot?: string;
+    /**
+     * After dispatching a state-changing command (openFile, openPanel,
+     * openSurface, closePanel), wait this many ms before the first state
+     * read. Set to 0 to disable verification entirely. Defaults to 200ms.
+     */
+    verifyDelayMs?: number;
+    /**
+     * How many additional state reads to attempt after the first if the
+     * expected change hasn't appeared yet. Defaults to 2.
+     */
+    verifyRetries?: number;
+    /**
+     * Milliseconds between retry state reads. Defaults to 200ms.
+     */
+    verifyIntervalMs?: number;
+}
+declare function createGetUiStateTool(uiBridge: UiBridge): AgentTool;
+declare function createExecUiTool(uiBridge: UiBridge, opts?: ExecUiToolOptions): AgentTool;
+/**
+ * Convenience: returns both UI tools as an `AgentTool[]` ready to merge into
+ * `extraTools`. `createWorkspaceAgentServer` calls this internally; hosts that
+ * want manual control can use it directly:
+ *
+ *   const bridge = createInMemoryBridge()
+ *   const app = await createAgentApp({
+ *     extraTools: createWorkspaceUiTools(bridge),
+ *   })
+ *   await app.register(uiRoutes, { bridge })
+ */
+declare function createWorkspaceUiTools(uiBridge: UiBridge, opts?: ExecUiToolOptions): AgentTool[];
+
+interface DataCatalogAgentToolOptions {
+    name?: string;
+    label?: string;
+    adapter: ExplorerAdapter;
+    defaultLimit?: number;
+    maxLimit?: number;
+}
+interface DataCatalogSkillOptions {
+    label?: string;
+    toolName?: string;
+    surfaceKind?: string;
+    guidance?: string;
+}
+interface DataCatalogServerPluginOptions extends DataCatalogAgentToolOptions, DataCatalogSkillOptions {
+    id?: string;
+}
+declare function formatDataCatalogSearchResult(query: string, result: SearchResult): string;
+declare function createDataCatalogAgentTool(options: DataCatalogAgentToolOptions): AgentTool;
+declare function createDataCatalogSkillPrompt(options?: DataCatalogSkillOptions): string;
+declare function createDataCatalogServerPlugin(options: DataCatalogServerPluginOptions): WorkspaceServerPlugin & {
+    agentTools: AgentTool[];
+    systemPrompt: string;
+};
+
+export { type DataCatalogAgentToolOptions, type DataCatalogServerPluginOptions, type DataCatalogSkillOptions, UiBridge, type UiRoutesOptions, WorkspaceServerPlugin, createDataCatalogAgentTool, createDataCatalogServerPlugin, createDataCatalogSkillPrompt, createExecUiTool, createGetUiStateTool, createInMemoryBridge, createWorkspaceUiTools, formatDataCatalogSearchResult, uiRoutes };