@backbay/glia 0.2.0-alpha.1

package/dist/protocol/dom.js

@@ -0,0 +1,300 @@
+/**
+ * DOM utilities for bb-protocol annotations
+ *
+ * Query and interact with elements annotated with data-bb-* attributes.
+ */
+// =============================================================================
+// Element Queries
+// =============================================================================
+/**
+ * Find an element by its bb-action attribute
+ */
+export function findAction(actionId, root = document) {
+    return root.querySelector(`[data-bb-action="${actionId}"]`);
+}
+/**
+ * Find all elements with a specific bb-action
+ */
+export function findAllActions(actionId, root = document) {
+    return Array.from(root.querySelectorAll(`[data-bb-action="${actionId}"]`));
+}
+/**
+ * Find all action elements on the page
+ */
+export function findAllActionElements(root = document) {
+    return Array.from(root.querySelectorAll('[data-bb-action]'));
+}
+/**
+ * Find an entity by type and ID
+ */
+export function findEntity(entityType, entityId, root = document) {
+    return root.querySelector(`[data-bb-entity="${entityType}"][data-bb-entity-id="${entityId}"]`);
+}
+/**
+ * Find all entities of a specific type
+ */
+export function findAllEntities(entityType, root = document) {
+    return Array.from(root.querySelectorAll(`[data-bb-entity="${entityType}"]`));
+}
+/**
+ * Find a field within an entity or root
+ */
+export function findField(fieldName, root = document) {
+    return root.querySelector(`[data-bb-field="${fieldName}"]`);
+}
+/**
+ * Find an input by name
+ */
+export function findInput(inputName, root = document) {
+    return root.querySelector(`[data-bb-input="${inputName}"]`);
+}
+/**
+ * Find output area by name
+ */
+export function findOutput(outputName, root = document) {
+    return root.querySelector(`[data-bb-output="${outputName}"]`);
+}
+/**
+ * Check if user is authenticated based on auth indicator
+ */
+export function isAuthenticated(indicator, root = document) {
+    return root.querySelector(indicator) !== null;
+}
+// =============================================================================
+// Attribute Reading
+// =============================================================================
+/**
+ * Get the bb-action ID from an element
+ */
+export function getActionId(element) {
+    return element.getAttribute('data-bb-action');
+}
+/**
+ * Get the entity type from an element
+ */
+export function getEntityType(element) {
+    return element.getAttribute('data-bb-entity');
+}
+/**
+ * Get the entity ID from an element
+ */
+export function getEntityId(element) {
+    return element.getAttribute('data-bb-entity-id');
+}
+/**
+ * Get the field name from an element
+ */
+export function getFieldName(element) {
+    return element.getAttribute('data-bb-field');
+}
+/**
+ * Get the current state of an element
+ */
+export function getState(element) {
+    return element.getAttribute('data-bb-state');
+}
+/**
+ * Check if an element requires confirmation
+ */
+export function requiresConfirmation(element) {
+    return element.getAttribute('data-bb-confirm') === 'true';
+}
+/**
+ * Get the hidden description for an element
+ */
+export function getDescription(element) {
+    // First check for data-bb-description attribute
+    const desc = element.getAttribute('data-bb-description');
+    if (desc)
+        return desc;
+    // Then check for child with data-bb-description
+    const descElement = element.querySelector('[data-bb-description]');
+    return descElement?.textContent?.trim() ?? null;
+}
+/**
+ * Get JSON-encoded inputs from an element
+ */
+export function getInputs(element) {
+    const inputs = element.getAttribute('data-bb-inputs');
+    if (!inputs)
+        return null;
+    try {
+        return JSON.parse(inputs);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get JSON-encoded cost from an element
+ */
+export function getCost(element) {
+    const cost = element.getAttribute('data-bb-cost');
+    if (!cost)
+        return null;
+    try {
+        return JSON.parse(cost);
+    }
+    catch {
+        return null;
+    }
+}
+// =============================================================================
+// Entity Extraction
+// =============================================================================
+/**
+ * Extract entity data based on schema field mappings
+ */
+export function extractEntity(element, schema) {
+    const result = {};
+    for (const [fieldName, selectorOrAttr] of Object.entries(schema.fields)) {
+        result[fieldName] = extractFieldValue(element, selectorOrAttr);
+    }
+    return result;
+}
+/**
+ * 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 function extractFieldValue(root, selectorOrAttr) {
+    // Check if it's a direct data attribute reference (no brackets)
+    if (selectorOrAttr.startsWith('data-')) {
+        return root.getAttribute(selectorOrAttr);
+    }
+    // Check for attribute extraction syntax: "selector @attr"
+    const attrMatch = selectorOrAttr.match(/^(.+?)\s+@(.+)$/);
+    if (attrMatch) {
+        const [, selector, attr] = attrMatch;
+        const child = root.querySelector(selector);
+        return child?.getAttribute(attr) ?? null;
+    }
+    // Standard selector - get text content
+    const child = root.querySelector(selectorOrAttr);
+    return child?.textContent?.trim() ?? null;
+}
+/**
+ * Extract all entities of a type from a page
+ */
+export function extractAllEntities(entityType, schema, root = document) {
+    const elements = findAllEntities(entityType, root);
+    return elements.map((el) => extractEntity(el, schema));
+}
+// =============================================================================
+// State Management
+// =============================================================================
+/**
+ * Set the state of an element
+ */
+export function setState(element, state) {
+    element.setAttribute('data-bb-state', state);
+}
+/**
+ * Wait for an element to reach a specific state
+ */
+export function waitForState(element, targetState, options = {}) {
+    const { timeout = 30000, pollInterval = 100 } = options;
+    return new Promise((resolve, reject) => {
+        const startTime = Date.now();
+        const check = () => {
+            const currentState = getState(element);
+            if (currentState === targetState) {
+                resolve();
+                return;
+            }
+            if (Date.now() - startTime > timeout) {
+                reject(new Error(`Timeout waiting for state "${targetState}". Current: "${currentState}"`));
+                return;
+            }
+            setTimeout(check, pollInterval);
+        };
+        check();
+    });
+}
+/**
+ * Observe state changes on an element
+ */
+export function observeState(element, callback) {
+    let previousState = getState(element);
+    const observer = new MutationObserver((mutations) => {
+        for (const mutation of mutations) {
+            if (mutation.type === 'attributes' && mutation.attributeName === 'data-bb-state') {
+                const newState = getState(element);
+                if (newState !== previousState) {
+                    callback(newState, previousState);
+                    previousState = newState;
+                }
+            }
+        }
+    });
+    observer.observe(element, { attributes: true, attributeFilter: ['data-bb-state'] });
+    return () => observer.disconnect();
+}
+// =============================================================================
+// Action Helpers
+// =============================================================================
+/**
+ * Get all available actions with their metadata
+ */
+export function getAvailableActions(root = document) {
+    const elements = findAllActionElements(root);
+    return elements.map((element) => ({
+        id: getActionId(element),
+        element,
+        state: getState(element),
+        requiresConfirmation: requiresConfirmation(element),
+        description: getDescription(element),
+        inputs: getInputs(element),
+        cost: getCost(element),
+    }));
+}
+/**
+ * Check if an action is currently available (not disabled/loading/hidden)
+ */
+export function isActionAvailable(element) {
+    const state = getState(element);
+    if (!state || state === 'idle' || state === 'success')
+        return true;
+    return false;
+}
+// =============================================================================
+// Manifest Discovery
+// =============================================================================
+/**
+ * Find the bb-manifest link in the document
+ */
+export function findManifestUrl(doc = document) {
+    const link = doc.querySelector('link[rel="bb-manifest"]');
+    if (link) {
+        return link.getAttribute('href');
+    }
+    // Default location
+    return '/bb-manifest.json';
+}
+/**
+ * Fetch and parse the bb-manifest for the current page
+ */
+export async function fetchManifest(url) {
+    const manifestUrl = url ?? findManifestUrl();
+    if (!manifestUrl) {
+        return { success: false, error: 'No manifest URL found' };
+    }
+    try {
+        const response = await fetch(manifestUrl);
+        if (!response.ok) {
+            return { success: false, error: `HTTP ${response.status}: ${response.statusText}` };
+        }
+        const data = await response.json();
+        return { success: true, data };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}

package/dist/protocol/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * bb-protocol - Discovery and execution layer for agent-native websites
+ */
+export type { CapabilityType, RiskLevel, InputType, AuthType, ConfirmationType, BBState, BBManifest, Capability, InputField, OutputField, CostEstimate, LatencyEstimate, EntitySchema, AuthConfig, ConstraintConfig, BBAttributes, SyncStatus, ConflictResolution, RunStatus, PlaySessionStatus, SyncConflict, Agent, AgentRun, PlaySessionData, JsonRpcResponse, IntensityValues, RunEventType, RunEvent, BBConfig, } from './types.js';
+export { BBManifestSchema, CapabilitySchema, EntitySchemaSchema, AuthConfigSchema, ConstraintConfigSchema, InputFieldSchema, OutputFieldSchema, CostEstimateSchema, LatencyEstimateSchema, CapabilityTypeSchema, RiskLevelSchema, InputTypeSchema, AuthTypeSchema, ConfirmationTypeSchema, BBStateSchema, validateManifest, parseManifest, validateCapability, validateEntitySchema, type ManifestValidationResult, type BBManifestInput, type BBManifestOutput, type CapabilityInput, type EntitySchemaInput, } from './schema.js';
+export type { AgentId, RunId, WorkspaceId, SessionId, DocumentId, CapabilityId, EntityTypeId, ComponentId, } from './branded.js';
+export { toAgentId, toRunId, toWorkspaceId, toSessionId, toDocumentId, toCapabilityId, toEntityTypeId, toComponentId, generateRunId, generateSessionId, generateDocumentId, generateWorkspaceId, isValidId, assertValidId, } from './branded.js';
+export { findAction, findAllActions, findAllActionElements, findEntity, findAllEntities, findField, findInput, findOutput, isAuthenticated, getActionId, getEntityType, getEntityId, getFieldName, getState, requiresConfirmation, getDescription, getInputs, getCost, extractEntity, extractFieldValue, extractAllEntities, setState, waitForState, observeState, getAvailableActions, isActionAvailable, findManifestUrl, fetchManifest, } from './dom.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EAEV,cAAc,EACd,SAAS,EACT,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,OAAO,EAGP,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,YAAY,EAGZ,UAAU,EACV,kBAAkB,EAClB,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,KAAK,EACL,QAAQ,EACR,eAAe,EACf,eAAe,EACf,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,QAAQ,GACT,MAAM,YAAY,CAAC;AAGpB,OAAO,EAEL,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,aAAa,EAGb,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EAGpB,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,OAAO,EACP,KAAK,EACL,WAAW,EACX,SAAS,EACT,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,cAAc,CAAC;AAEtB,OAAO,EAEL,SAAS,EACT,OAAO,EACP,aAAa,EACb,WAAW,EACX,YAAY,EACZ,cAAc,EACd,cAAc,EACd,aAAa,EAGb,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EAGnB,SAAS,EACT,aAAa,GACd,MAAM,cAAc,CAAC;AAGtB,OAAO,EAEL,UAAU,EACV,cAAc,EACd,qBAAqB,EACrB,UAAU,EACV,eAAe,EACf,SAAS,EACT,SAAS,EACT,UAAU,EACV,eAAe,EAGf,WAAW,EACX,aAAa,EACb,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,oBAAoB,EACpB,cAAc,EACd,SAAS,EACT,OAAO,EAGP,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAGlB,QAAQ,EACR,YAAY,EACZ,YAAY,EAGZ,mBAAmB,EACnB,iBAAiB,EAGjB,eAAe,EACf,aAAa,GACd,MAAM,UAAU,CAAC"}

package/dist/protocol/index.js

@@ -0,0 +1,30 @@
+/**
+ * bb-protocol - Discovery and execution layer for agent-native websites
+ */
+// Schema validation
+export { 
+// Schemas
+BBManifestSchema, CapabilitySchema, EntitySchemaSchema, AuthConfigSchema, ConstraintConfigSchema, InputFieldSchema, OutputFieldSchema, CostEstimateSchema, LatencyEstimateSchema, CapabilityTypeSchema, RiskLevelSchema, InputTypeSchema, AuthTypeSchema, ConfirmationTypeSchema, BBStateSchema, 
+// Validation functions
+validateManifest, parseManifest, validateCapability, validateEntitySchema, } from './schema.js';
+export { 
+// Type constructors
+toAgentId, toRunId, toWorkspaceId, toSessionId, toDocumentId, toCapabilityId, toEntityTypeId, toComponentId, 
+// ID generators
+generateRunId, generateSessionId, generateDocumentId, generateWorkspaceId, 
+// Validation
+isValidId, assertValidId, } from './branded.js';
+// DOM utilities
+export { 
+// Element queries
+findAction, findAllActions, findAllActionElements, findEntity, findAllEntities, findField, findInput, findOutput, isAuthenticated, 
+// Attribute reading
+getActionId, getEntityType, getEntityId, getFieldName, getState, requiresConfirmation, getDescription, getInputs, getCost, 
+// Entity extraction
+extractEntity, extractFieldValue, extractAllEntities, 
+// State management
+setState, waitForState, observeState, 
+// Action helpers
+getAvailableActions, isActionAvailable, 
+// Manifest discovery
+findManifestUrl, fetchManifest, } from './dom.js';