@backbay/glia 0.2.0-alpha.1

package/dist/primitives/ui/tabs.js

@@ -0,0 +1,17 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import * as TabsPrimitive from "@radix-ui/react-tabs";
+import { cn } from "../../lib/utils";
+function Tabs({ className, ...props }) {
+    return (_jsx(TabsPrimitive.Root, { "data-slot": "tabs", className: cn("flex flex-col gap-2", className), ...props }));
+}
+function TabsList({ className, ...props }) {
+    return (_jsx(TabsPrimitive.List, { "data-slot": "tabs-list", className: cn("bg-muted text-muted-foreground inline-flex h-9 w-fit items-center justify-center rounded-lg p-[3px]", className), ...props }));
+}
+function TabsTrigger({ className, ...props }) {
+    return (_jsx(TabsPrimitive.Trigger, { "data-slot": "tabs-trigger", className: cn("data-[state=active]:bg-background dark:data-[state=active]:text-foreground focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:outline-ring dark:data-[state=active]:border-input dark:data-[state=active]:bg-input/30 text-foreground dark:text-muted-foreground inline-flex h-[calc(100%-1px)] flex-1 items-center justify-center gap-1.5 rounded-md border border-transparent px-2 py-1 text-sm font-medium whitespace-nowrap transition-[color,box-shadow] focus-visible:ring-[3px] focus-visible:outline-1 disabled:pointer-events-none disabled:opacity-50 data-[state=active]:shadow-sm [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4", className), ...props }));
+}
+function TabsContent({ className, ...props }) {
+    return (_jsx(TabsPrimitive.Content, { "data-slot": "tabs-content", className: cn("flex-1 outline-none", className), ...props }));
+}
+export { Tabs, TabsList, TabsTrigger, TabsContent };

package/dist/primitives/ui/textarea.d.ts

@@ -0,0 +1,4 @@
+import * as React from "react";
+declare function Textarea({ className, ...props }: React.ComponentProps<"textarea">): import("react/jsx-runtime").JSX.Element;
+export { Textarea };
+//# sourceMappingURL=textarea.d.ts.map

package/dist/primitives/ui/textarea.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textarea.d.ts","sourceRoot":"","sources":["../../../src/primitives/ui/textarea.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,iBAAS,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,UAAU,CAAC,2CAW1E;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/primitives/ui/textarea.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { cn } from "../../lib/utils";
+function Textarea({ className, ...props }) {
+    return (_jsx("textarea", { "data-slot": "textarea", className: cn("border-input placeholder:text-muted-foreground focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive dark:bg-input/30 flex field-sizing-content min-h-16 w-full rounded-md border bg-transparent px-3 py-2 text-base shadow-xs transition-[color,box-shadow] outline-none focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50 md:text-sm", className), ...props }));
+}
+export { Textarea };

package/dist/primitives/ui/toggle.d.ts

@@ -0,0 +1,10 @@
+import * as React from "react";
+import * as TogglePrimitive from "@radix-ui/react-toggle";
+import { type VariantProps } from "class-variance-authority";
+declare const toggleVariants: (props?: ({
+    variant?: "default" | "outline" | null | undefined;
+    size?: "default" | "sm" | "lg" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+declare function Toggle({ className, variant, size, ...props }: React.ComponentProps<typeof TogglePrimitive.Root> & VariantProps<typeof toggleVariants>): import("react/jsx-runtime").JSX.Element;
+export { Toggle, toggleVariants };
+//# sourceMappingURL=toggle.d.ts.map

package/dist/primitives/ui/toggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle.d.ts","sourceRoot":"","sources":["../../../src/primitives/ui/toggle.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,eAAe,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIlE,QAAA,MAAM,cAAc;;;8EAoBnB,CAAC;AAEF,iBAAS,MAAM,CAAC,EACd,SAAS,EACT,OAAO,EACP,IAAI,EACJ,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,eAAe,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,OAAO,cAAc,CAAC,2CAQzF;AAED,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC"}

package/dist/primitives/ui/toggle.js

@@ -0,0 +1,26 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import * as TogglePrimitive from "@radix-ui/react-toggle";
+import { cva } from "class-variance-authority";
+import { cn } from "../../lib/utils";
+const toggleVariants = cva("inline-flex items-center justify-center gap-2 rounded-md text-sm font-medium hover:bg-muted hover:text-muted-foreground disabled:pointer-events-none disabled:opacity-50 data-[state=on]:bg-accent data-[state=on]:text-accent-foreground [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 [&_svg]:shrink-0 focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] outline-none transition-[color,box-shadow] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive whitespace-nowrap", {
+    variants: {
+        variant: {
+            default: "bg-transparent",
+            outline: "border border-input bg-transparent shadow-xs hover:bg-accent hover:text-accent-foreground",
+        },
+        size: {
+            default: "h-9 px-2 min-w-9",
+            sm: "h-8 px-1.5 min-w-8",
+            lg: "h-10 px-2.5 min-w-10",
+        },
+    },
+    defaultVariants: {
+        variant: "default",
+        size: "default",
+    },
+});
+function Toggle({ className, variant, size, ...props }) {
+    return (_jsx(TogglePrimitive.Root, { "data-slot": "toggle", className: cn(toggleVariants({ variant, size, className })), ...props }));
+}
+export { Toggle, toggleVariants };

package/dist/primitives/ui/tooltip.d.ts

@@ -0,0 +1,8 @@
+import * as React from "react";
+import * as TooltipPrimitive from "@radix-ui/react-tooltip";
+declare function TooltipProvider({ delayDuration, ...props }: React.ComponentProps<typeof TooltipPrimitive.Provider>): import("react/jsx-runtime").JSX.Element;
+declare function Tooltip({ ...props }: React.ComponentProps<typeof TooltipPrimitive.Root>): import("react/jsx-runtime").JSX.Element;
+declare function TooltipTrigger({ ...props }: React.ComponentProps<typeof TooltipPrimitive.Trigger>): import("react/jsx-runtime").JSX.Element;
+declare function TooltipContent({ className, sideOffset, children, ...props }: React.ComponentProps<typeof TooltipPrimitive.Content>): import("react/jsx-runtime").JSX.Element;
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };
+//# sourceMappingURL=tooltip.d.ts.map

package/dist/primitives/ui/tooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooltip.d.ts","sourceRoot":"","sources":["../../../src/primitives/ui/tooltip.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,gBAAgB,MAAM,yBAAyB,CAAC;AAI5D,iBAAS,eAAe,CAAC,EACvB,aAAiB,EACjB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,QAAQ,CAAC,2CAQxD;AAED,iBAAS,OAAO,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,IAAI,CAAC,2CAMhF;AAED,iBAAS,cAAc,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,OAAO,CAAC,2CAE1F;AAED,iBAAS,cAAc,CAAC,EACtB,SAAS,EACT,UAAc,EACd,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,OAAO,CAAC,2CAiBvD;AAED,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,CAAC"}

package/dist/primitives/ui/tooltip.js

@@ -0,0 +1,17 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as TooltipPrimitive from "@radix-ui/react-tooltip";
+import { cn } from "../../lib/utils";
+function TooltipProvider({ delayDuration = 0, ...props }) {
+    return (_jsx(TooltipPrimitive.Provider, { "data-slot": "tooltip-provider", delayDuration: delayDuration, ...props }));
+}
+function Tooltip({ ...props }) {
+    return (_jsx(TooltipProvider, { children: _jsx(TooltipPrimitive.Root, { "data-slot": "tooltip", ...props }) }));
+}
+function TooltipTrigger({ ...props }) {
+    return _jsx(TooltipPrimitive.Trigger, { "data-slot": "tooltip-trigger", ...props });
+}
+function TooltipContent({ className, sideOffset = 0, children, ...props }) {
+    return (_jsx(TooltipPrimitive.Portal, { children: _jsxs(TooltipPrimitive.Content, { "data-slot": "tooltip-content", sideOffset: sideOffset, className: cn("bg-foreground text-background animate-in fade-in-0 zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 w-fit origin-(--radix-tooltip-content-transform-origin) rounded-md px-3 py-1.5 text-xs text-balance", className), ...props, children: [children, _jsx(TooltipPrimitive.Arrow, { className: "bg-foreground fill-foreground z-50 size-2.5 translate-y-[calc(-50%_-_2px)] rotate-45 rounded-[2px]" })] }) }));
+}
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };

package/dist/protocol/branded.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Branded Types
+ *
+ * These types use TypeScript's structural typing escape hatch to create
+ * nominally-typed IDs that prevent accidental mixing of different ID types.
+ *
+ * @example
+ * ```ts
+ * const agentId: AgentId = 'agent-123' as AgentId;
+ * const runId: RunId = 'run-456' as RunId;
+ *
+ * function getAgent(id: AgentId) { ... }
+ *
+ * getAgent(agentId); // OK
+ * getAgent(runId);   // Type error!
+ * ```
+ */
+declare const __brand: unique symbol;
+/**
+ * Creates a branded type that is structurally incompatible with other branded types.
+ * This prevents accidentally passing the wrong type of ID to a function.
+ */
+type Brand<T, B> = T & {
+    readonly [__brand]: B;
+};
+/**
+ * Unique identifier for an AI agent.
+ * @example 'claude-3-opus', 'gpt-4', 'agent-custom-1'
+ */
+export type AgentId = Brand<string, 'AgentId'>;
+/**
+ * Unique identifier for an agent run/execution.
+ * @example 'run-1705123456789-abc123'
+ */
+export type RunId = Brand<string, 'RunId'>;
+/**
+ * Unique identifier for a workspace specification.
+ * @example 'workspace-dashboard-v1'
+ */
+export type WorkspaceId = Brand<string, 'WorkspaceId'>;
+/**
+ * Unique identifier for a play session.
+ * @example 'session-openrct2-xyz789'
+ */
+export type SessionId = Brand<string, 'SessionId'>;
+/**
+ * Unique identifier for a synced document.
+ * @example 'doc-project-readme-md'
+ */
+export type DocumentId = Brand<string, 'DocumentId'>;
+/**
+ * Unique identifier for a capability in a manifest.
+ * @example 'search-products', 'create-order'
+ */
+export type CapabilityId = Brand<string, 'CapabilityId'>;
+/**
+ * Unique identifier for an entity type.
+ * @example 'product', 'user', 'order'
+ */
+export type EntityTypeId = Brand<string, 'EntityTypeId'>;
+/**
+ * Unique identifier for a component in the registry.
+ * @example 'glow-button', 'glass-panel', 'graph-3d'
+ */
+export type ComponentId = Brand<string, 'ComponentId'>;
+/**
+ * Create a branded AgentId from a string.
+ * Use this when receiving agent IDs from external sources.
+ */
+export declare function toAgentId(id: string): AgentId;
+/**
+ * Create a branded RunId from a string.
+ * Use this when receiving run IDs from external sources.
+ */
+export declare function toRunId(id: string): RunId;
+/**
+ * Create a branded WorkspaceId from a string.
+ * Use this when receiving workspace IDs from external sources.
+ */
+export declare function toWorkspaceId(id: string): WorkspaceId;
+/**
+ * Create a branded SessionId from a string.
+ * Use this when receiving session IDs from external sources.
+ */
+export declare function toSessionId(id: string): SessionId;
+/**
+ * Create a branded DocumentId from a string.
+ * Use this when receiving document IDs from external sources.
+ */
+export declare function toDocumentId(id: string): DocumentId;
+/**
+ * Create a branded CapabilityId from a string.
+ * Use this when receiving capability IDs from external sources.
+ */
+export declare function toCapabilityId(id: string): CapabilityId;
+/**
+ * Create a branded EntityTypeId from a string.
+ * Use this when receiving entity type IDs from external sources.
+ */
+export declare function toEntityTypeId(id: string): EntityTypeId;
+/**
+ * Create a branded ComponentId from a string.
+ * Use this when receiving component IDs from external sources.
+ */
+export declare function toComponentId(id: string): ComponentId;
+/**
+ * Generate a unique run ID with timestamp and random suffix.
+ */
+export declare function generateRunId(): RunId;
+/**
+ * Generate a unique session ID with adapter prefix and random suffix.
+ */
+export declare function generateSessionId(adapter: string): SessionId;
+/**
+ * Generate a unique document ID from a descriptive name.
+ */
+export declare function generateDocumentId(name: string): DocumentId;
+/**
+ * Generate a unique workspace ID from a name.
+ */
+export declare function generateWorkspaceId(name: string): WorkspaceId;
+/**
+ * Check if a value is a valid ID string (non-empty).
+ */
+export declare function isValidId(value: unknown): value is string;
+/**
+ * Assert that a value is a valid ID, throwing if not.
+ */
+export declare function assertValidId(value: unknown, name?: string): asserts value is string;
+export {};
+//# sourceMappingURL=branded.d.ts.map

package/dist/protocol/branded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branded.d.ts","sourceRoot":"","sources":["../../src/protocol/branded.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,CAAC,MAAM,OAAO,EAAE,OAAO,MAAM,CAAC;AAErC;;;GAGG;AACH,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC;AAMjD;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAE/C;;;GAGG;AACH,MAAM,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3C;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAEvD;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAErD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAMvD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE7C;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,CAEzC;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,CAErD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAEjD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAEnD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAEvD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAEvD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,CAErD;AAMD;;GAEG;AACH,wBAAgB,aAAa,IAAI,KAAK,CAIrC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAI5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAO3D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAM7D;AAMD;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,SAAO,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAIlF"}

package/dist/protocol/branded.js

@@ -0,0 +1,133 @@
+/**
+ * Branded Types
+ *
+ * These types use TypeScript's structural typing escape hatch to create
+ * nominally-typed IDs that prevent accidental mixing of different ID types.
+ *
+ * @example
+ * ```ts
+ * const agentId: AgentId = 'agent-123' as AgentId;
+ * const runId: RunId = 'run-456' as RunId;
+ *
+ * function getAgent(id: AgentId) { ... }
+ *
+ * getAgent(agentId); // OK
+ * getAgent(runId);   // Type error!
+ * ```
+ */
+// =============================================================================
+// Type Guards and Utilities
+// =============================================================================
+/**
+ * Create a branded AgentId from a string.
+ * Use this when receiving agent IDs from external sources.
+ */
+export function toAgentId(id) {
+    return id;
+}
+/**
+ * Create a branded RunId from a string.
+ * Use this when receiving run IDs from external sources.
+ */
+export function toRunId(id) {
+    return id;
+}
+/**
+ * Create a branded WorkspaceId from a string.
+ * Use this when receiving workspace IDs from external sources.
+ */
+export function toWorkspaceId(id) {
+    return id;
+}
+/**
+ * Create a branded SessionId from a string.
+ * Use this when receiving session IDs from external sources.
+ */
+export function toSessionId(id) {
+    return id;
+}
+/**
+ * Create a branded DocumentId from a string.
+ * Use this when receiving document IDs from external sources.
+ */
+export function toDocumentId(id) {
+    return id;
+}
+/**
+ * Create a branded CapabilityId from a string.
+ * Use this when receiving capability IDs from external sources.
+ */
+export function toCapabilityId(id) {
+    return id;
+}
+/**
+ * Create a branded EntityTypeId from a string.
+ * Use this when receiving entity type IDs from external sources.
+ */
+export function toEntityTypeId(id) {
+    return id;
+}
+/**
+ * Create a branded ComponentId from a string.
+ * Use this when receiving component IDs from external sources.
+ */
+export function toComponentId(id) {
+    return id;
+}
+// =============================================================================
+// ID Generation Utilities
+// =============================================================================
+/**
+ * Generate a unique run ID with timestamp and random suffix.
+ */
+export function generateRunId() {
+    const timestamp = Date.now();
+    const random = Math.random().toString(36).slice(2, 9);
+    return `run-${timestamp}-${random}`;
+}
+/**
+ * Generate a unique session ID with adapter prefix and random suffix.
+ */
+export function generateSessionId(adapter) {
+    const timestamp = Date.now();
+    const random = Math.random().toString(36).slice(2, 9);
+    return `session-${adapter}-${timestamp}-${random}`;
+}
+/**
+ * Generate a unique document ID from a descriptive name.
+ */
+export function generateDocumentId(name) {
+    const slug = name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+    const random = Math.random().toString(36).slice(2, 6);
+    return `doc-${slug}-${random}`;
+}
+/**
+ * Generate a unique workspace ID from a name.
+ */
+export function generateWorkspaceId(name) {
+    const slug = name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+    return `workspace-${slug}`;
+}
+// =============================================================================
+// Type Assertions
+// =============================================================================
+/**
+ * Check if a value is a valid ID string (non-empty).
+ */
+export function isValidId(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+/**
+ * Assert that a value is a valid ID, throwing if not.
+ */
+export function assertValidId(value, name = 'id') {
+    if (!isValidId(value)) {
+        throw new Error(`Invalid ${name}: expected non-empty string, got ${typeof value}`);
+    }
+}

package/dist/protocol/dom.d.ts

@@ -0,0 +1,148 @@
+/**
+ * DOM utilities for bb-protocol annotations
+ *
+ * Query and interact with elements annotated with data-bb-* attributes.
+ */
+import type { BBState, EntitySchema } from './types.js';
+/**
+ * Find an element by its bb-action attribute
+ */
+export declare function findAction(actionId: string, root?: ParentNode): Element | null;
+/**
+ * Find all elements with a specific bb-action
+ */
+export declare function findAllActions(actionId: string, root?: ParentNode): Element[];
+/**
+ * Find all action elements on the page
+ */
+export declare function findAllActionElements(root?: ParentNode): Element[];
+/**
+ * Find an entity by type and ID
+ */
+export declare function findEntity(entityType: string, entityId: string, root?: ParentNode): Element | null;
+/**
+ * Find all entities of a specific type
+ */
+export declare function findAllEntities(entityType: string, root?: ParentNode): Element[];
+/**
+ * Find a field within an entity or root
+ */
+export declare function findField(fieldName: string, root?: ParentNode): Element | null;
+/**
+ * Find an input by name
+ */
+export declare function findInput(inputName: string, root?: ParentNode): Element | null;
+/**
+ * Find output area by name
+ */
+export declare function findOutput(outputName: string, root?: ParentNode): Element | null;
+/**
+ * Check if user is authenticated based on auth indicator
+ */
+export declare function isAuthenticated(indicator: string, root?: ParentNode): boolean;
+/**
+ * Get the bb-action ID from an element
+ */
+export declare function getActionId(element: Element): string | null;
+/**
+ * Get the entity type from an element
+ */
+export declare function getEntityType(element: Element): string | null;
+/**
+ * Get the entity ID from an element
+ */
+export declare function getEntityId(element: Element): string | null;
+/**
+ * Get the field name from an element
+ */
+export declare function getFieldName(element: Element): string | null;
+/**
+ * Get the current state of an element
+ */
+export declare function getState(element: Element): BBState | null;
+/**
+ * Check if an element requires confirmation
+ */
+export declare function requiresConfirmation(element: Element): boolean;
+/**
+ * Get the hidden description for an element
+ */
+export declare function getDescription(element: Element): string | null;
+/**
+ * Get JSON-encoded inputs from an element
+ */
+export declare function getInputs(element: Element): Record<string, unknown> | null;
+/**
+ * Get JSON-encoded cost from an element
+ */
+export declare function getCost(element: Element): {
+    usd?: number;
+    risk?: string;
+} | null;
+/**
+ * Extract entity data based on schema field mappings
+ */
+export declare function extractEntity(element: Element, schema: EntitySchema): Record<string, string | null>;
+/**
+ * Extract a single field value using selector syntax
+ *
+ * Supports:
+ * - "data-bb-entity-id" - read data attribute from root
+ * - "[data-bb-field='name']" - text content of child element
+ * - "[data-bb-field='image'] @src" - attribute of child element
+ * - "[data-bb-field='status'] @data-bb-state" - data attribute of child
+ */
+export declare function extractFieldValue(root: Element, selectorOrAttr: string): string | null;
+/**
+ * Extract all entities of a type from a page
+ */
+export declare function extractAllEntities(entityType: string, schema: EntitySchema, root?: ParentNode): Array<Record<string, string | null>>;
+/**
+ * Set the state of an element
+ */
+export declare function setState(element: Element, state: BBState): void;
+/**
+ * Wait for an element to reach a specific state
+ */
+export declare function waitForState(element: Element, targetState: BBState, options?: {
+    timeout?: number;
+    pollInterval?: number;
+}): Promise<void>;
+/**
+ * Observe state changes on an element
+ */
+export declare function observeState(element: Element, callback: (state: BBState | null, previousState: BBState | null) => void): () => void;
+/**
+ * Get all available actions with their metadata
+ */
+export declare function getAvailableActions(root?: ParentNode): Array<{
+    id: string;
+    element: Element;
+    state: BBState | null;
+    requiresConfirmation: boolean;
+    description: string | null;
+    inputs: Record<string, unknown> | null;
+    cost: {
+        usd?: number;
+        risk?: string;
+    } | null;
+}>;
+/**
+ * Check if an action is currently available (not disabled/loading/hidden)
+ */
+export declare function isActionAvailable(element: Element): boolean;
+/**
+ * Find the bb-manifest link in the document
+ */
+export declare function findManifestUrl(doc?: Document): string | null;
+/**
+ * Fetch and parse the bb-manifest for the current page
+ */
+export declare function fetchManifest(url?: string): Promise<{
+    success: true;
+    data: unknown;
+} | {
+    success: false;
+    error: string;
+}>;
+//# sourceMappingURL=dom.d.ts.map

package/dist/protocol/dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/protocol/dom.ts"],"names":[],"mappings":"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"}