@hachej/boring-workspace 0.1.13 → 0.1.14

package/dist/app-front.d.ts

@@ -28,37 +28,76 @@ declare interface AgentToolOutput {
     tool: AgentTool;
 }
 
-/**
- * DataExplorer shared types — no runtime deps.
- *
- * Importable from BOTH front and server bundles without dragging in
- * platform-specific code.
- */
-declare type Badge = {
-    /** 1–4 char mono code rendered as a chip. */
-    code: string;
-    tooltip?: string;
-};
-
 declare interface BindingOutput {
     type: "binding";
     id: string;
     component: PluginBinding;
 }
 
+declare type CatalogAdapter = {
+    search(args: CatalogSearchArgs): Promise<CatalogSearchResult>;
+    fetchFacets?(args: CatalogFacetsArgs): Promise<CatalogFacets>;
+};
+
+declare type CatalogBadge = {
+    /** 1–4 char mono code rendered as a chip. */
+    code: string;
+    tooltip?: string;
+};
+
 declare interface CatalogConfig {
     id: string;
     label: string;
-    adapter: ExplorerAdapter;
-    onSelect: (row: ExplorerRow) => void;
+    adapter: CatalogAdapter;
+    onSelect: (row: CatalogRow) => void;
     pluginId?: string;
 }
 
+declare type CatalogFacets = Record<string, CatalogFacetValue[]>;
+
+declare type CatalogFacetsArgs = {
+    filters: Record<string, string[]>;
+    signal?: AbortSignal;
+};
+
+declare type CatalogFacetValue = {
+    value: string;
+    count: number;
+};
+
 declare interface CatalogOutput {
     type: "catalog";
     catalog: CatalogConfig;
 }
 
+declare type CatalogRow = {
+    id: string;
+    title: string;
+    subtitle?: string;
+    group?: string;
+    leading?: CatalogBadge;
+    trailing?: CatalogBadge[];
+    meta?: string;
+};
+
+declare type CatalogSearchArgs = {
+    query: string;
+    filters: Record<string, string[]>;
+    group?: {
+        key: string;
+        value: string;
+    };
+    limit: number;
+    offset: number;
+    signal?: AbortSignal;
+};
+
+declare type CatalogSearchResult = {
+    items: CatalogRow[];
+    total: number;
+    hasMore: boolean;
+};
+
 declare interface ChatLayoutProps {
     nav?: string | null;
     navParams?: Record<string, unknown>;
@@ -71,6 +110,7 @@ declare interface ChatLayoutProps {
     storageKey?: string;
     onOpenNav?: () => void;
     onOpenSurface?: () => void;
+    onOpenSidebar?: () => void;
     className?: string;
 }
 
@@ -96,39 +136,6 @@ export declare interface CreateLocalStorageSessionsOptions {
     initial?: () => WorkspaceLocalSessionsState;
 }
 
-declare type ExplorerAdapter = {
-    search(args: SearchArgs): Promise<SearchResult>;
-    /** Optional. When omitted, the explorer renders flat (no facet popover). */
-    fetchFacets?(args: FacetsArgs): Promise<Facets>;
-};
-
-declare 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;
-};
-
-declare type Facets = Record<string, FacetValue[]>;
-
-declare type FacetsArgs = {
-    filters: Record<string, string[]>;
-    signal?: AbortSignal;
-};
-
-declare type FacetValue = {
-    value: string;
-    count: number;
-};
-
 declare type JSONSchema = Record<string, unknown>;
 
 declare interface LeftTabOutput<T = LeftTabParams> {
@@ -242,26 +249,6 @@ declare interface ProviderOutput {
     component: PluginProvider;
 }
 
-declare 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;
-};
-
-declare type SearchResult = {
-    items: ExplorerRow[];
-    /** Total count for the current scope (query + filters + optional group). */
-    total: number;
-    hasMore: boolean;
-};
-
 declare interface SessionItem {
     id: string;
     title: string;
@@ -327,6 +314,8 @@ declare interface ToolExecContext {
     abortSignal: AbortSignal;
     toolCallId: string;
     onUpdate?: (partial: string) => void;
+    /** Agent chat/session id executing this tool, when known. */
+    sessionId?: string;
 }
 
 declare interface ToolResult {
@@ -394,6 +383,21 @@ export declare interface WorkspaceAgentSessionsApi<TSession extends WorkspaceAge
     delete: (id: string) => void | Promise<unknown>;
 }
 
+declare type WorkspaceAttentionBlocker = {
+    id: string;
+    reason: string;
+    surfaceKind?: string;
+    target?: string;
+    label?: string;
+    sessionId?: string;
+    actions?: WorkspaceAttentionBlockerAction[];
+};
+
+declare type WorkspaceAttentionBlockerAction = {
+    id: string;
+    label: string;
+};
+
 export declare function WorkspaceBootGate({ workspaceId, requestHeaders, apiBaseUrl, preloadPaths, loadingFallback, errorFallback, children, }: WorkspaceBootGateProps): JSX.Element;
 
 export declare interface WorkspaceBootGateProps {
@@ -422,6 +426,14 @@ declare interface WorkspaceChatPanelProps {
     isWorkbenchOpen?: () => boolean;
     /** Opens the visible workbench surface before dispatching a command. */
     openWorkbench?: () => void;
+    /** Closes the visible workbench surface after an ephemeral command finishes. */
+    closeWorkbench?: () => void;
+    /** Generic workspace blockers that should prevent submitting new chat turns. */
+    composerBlockers?: WorkspaceAttentionBlocker[];
+    /** Called when the user presses Stop in the composer. */
+    onComposerStop?: () => void;
+    /** Called when the chat implementation wants to run an action exposed by a blocker. */
+    onComposerBlockerAction?: (blocker: WorkspaceAttentionBlocker, action: string) => void;
     [key: string]: unknown;
 }