@backbay/glia 0.2.0-alpha.7 → 0.2.0-alpha.8

package/dist/protocol/index.js

@@ -1,4 +1,362 @@
-export { AuthConfigSchema, AuthTypeSchema, BBManifestSchema, BBStateSchema, CapabilitySchema, CapabilityTypeSchema, ConfirmationTypeSchema, ConstraintConfigSchema, CostEstimateSchema, EntitySchemaSchema, InputFieldSchema, InputTypeSchema, LatencyEstimateSchema, OutputFieldSchema, RiskLevelSchema, assertValidId, extractAllEntities, extractEntity, extractFieldValue, fetchManifest, findAction, findAllActionElements, findAllActions, findAllEntities, findEntity, findField, findInput, findManifestUrl, findOutput, generateDocumentId, generateRunId, generateSessionId, generateWorkspaceId, getActionId, getAvailableActions, getCost, getDescription, getEntityId, getEntityType, getFieldName, getInputs, getState, isActionAvailable, isAuthenticated, isValidId, observeState, parseManifest, requiresConfirmation, setState, toAgentId, toCapabilityId, toComponentId, toDocumentId, toEntityTypeId, toRunId, toSessionId, toWorkspaceId, validateCapability, validateEntitySchema, validateManifest, waitForState } from '../chunk-5IZELOOU.js';
-import '../chunk-TM6AOUSD.js';
+import { z } from 'zod';
+
+// src/protocol/schema.ts
+var CapabilityTypeSchema = z.enum(["query", "mutation", "workflow"]);
+var RiskLevelSchema = z.enum(["low", "medium", "high"]);
+var InputTypeSchema = z.enum(["string", "number", "boolean", "date", "file", "select"]);
+var AuthTypeSchema = z.enum(["none", "session", "oauth", "api-key"]);
+var ConfirmationTypeSchema = z.enum(["none", "optional", "required"]);
+var BBStateSchema = z.enum([
+  "idle",
+  "loading",
+  "success",
+  "error",
+  "disabled",
+  "hidden",
+  "requires-auth"
+]);
+var InputFieldSchema = z.object({
+  name: z.string().min(1),
+  type: InputTypeSchema,
+  required: z.boolean().optional(),
+  default: z.unknown().optional(),
+  options: z.array(z.string()).optional(),
+  from: z.string().optional(),
+  selector: z.string().optional()
+});
+var OutputFieldSchema = z.object({
+  name: z.string().min(1),
+  type: z.string().min(1),
+  selector: z.string().optional()
+});
+var CostEstimateSchema = z.object({
+  usd: z.union([z.number(), z.literal("variable")]).optional(),
+  tokens: z.number().optional(),
+  risk: RiskLevelSchema
+});
+var LatencyEstimateSchema = z.object({
+  typical: z.number().positive(),
+  max: z.number().positive().optional()
+});
+var CapabilitySchema = z.object({
+  id: z.string().min(1).regex(/^[a-z][a-z0-9-]*$/, "ID must be kebab-case"),
+  type: CapabilityTypeSchema,
+  description: z.string().min(1),
+  entry: z.string().optional(),
+  selector: z.string().min(1),
+  inputs: z.array(InputFieldSchema).optional(),
+  outputs: z.array(OutputFieldSchema).optional(),
+  cost: CostEstimateSchema.optional(),
+  latency: LatencyEstimateSchema.optional(),
+  requires: z.array(z.string()).optional(),
+  confirmation: ConfirmationTypeSchema.optional(),
+  steps: z.array(z.string()).optional()
+}).refine(
+  (data) => {
+    if (data.type === "workflow" && (!data.steps || data.steps.length === 0)) {
+      return false;
+    }
+    return true;
+  },
+  { message: "Workflow capabilities must have steps defined" }
+);
+var EntitySchemaSchema = z.object({
+  selector: z.string().min(1),
+  fields: z.record(z.string(), z.string()),
+  actions: z.array(z.string()).optional()
+});
+var AuthConfigSchema = z.object({
+  type: AuthTypeSchema,
+  loginUrl: z.string().optional(),
+  logoutUrl: z.string().optional(),
+  indicator: z.string().optional(),
+  scopes: z.array(z.string()).optional(),
+  header: z.string().optional(),
+  documentationUrl: z.string().optional()
+});
+var RateLimitSchema = z.object({
+  requests: z.number().positive(),
+  window: z.string().regex(/^\d+[smhd]$/, 'Window must be like "60s", "5m", "1h", "1d"')
+});
+var ConstraintConfigSchema = z.object({
+  rateLimit: RateLimitSchema.optional(),
+  requiresHuman: z.array(z.string()).optional(),
+  blockedAgents: z.array(z.string()).optional(),
+  allowedAgents: z.array(z.string()).optional()
+});
+var BBManifestSchema = z.object({
+  version: z.literal("1.0"),
+  name: z.string().min(1),
+  description: z.string().min(1),
+  icon: z.string().url().optional(),
+  contact: z.string().optional(),
+  documentation: z.string().url().optional(),
+  capabilities: z.array(CapabilitySchema).min(1),
+  entities: z.record(z.string(), EntitySchemaSchema).optional(),
+  auth: AuthConfigSchema.optional(),
+  constraints: ConstraintConfigSchema.optional(),
+  extensions: z.record(z.string(), z.unknown()).optional()
+});
+function validateManifest(manifest) {
+  const result = BBManifestSchema.safeParse(manifest);
+  if (result.success) {
+    return { success: true, data: result.data };
+  }
+  return { success: false, errors: result.error };
+}
+function parseManifest(json) {
+  try {
+    const parsed = JSON.parse(json);
+    return validateManifest(parsed);
+  } catch (error) {
+    return {
+      success: false,
+      errors: new z.ZodError([
+        {
+          code: "custom",
+          path: [],
+          message: `Invalid JSON: ${error instanceof Error ? error.message : "Unknown error"}`
+        }
+      ])
+    };
+  }
+}
+function validateCapability(capability) {
+  return CapabilitySchema.safeParse(capability);
+}
+function validateEntitySchema(entity) {
+  return EntitySchemaSchema.safeParse(entity);
+}
+
+// src/protocol/branded.ts
+function toAgentId(id) {
+  return id;
+}
+function toRunId(id) {
+  return id;
+}
+function toWorkspaceId(id) {
+  return id;
+}
+function toSessionId(id) {
+  return id;
+}
+function toDocumentId(id) {
+  return id;
+}
+function toCapabilityId(id) {
+  return id;
+}
+function toEntityTypeId(id) {
+  return id;
+}
+function toComponentId(id) {
+  return id;
+}
+function generateRunId() {
+  const timestamp = Date.now();
+  const random = Math.random().toString(36).slice(2, 9);
+  return `run-${timestamp}-${random}`;
+}
+function generateSessionId(adapter) {
+  const timestamp = Date.now();
+  const random = Math.random().toString(36).slice(2, 9);
+  return `session-${adapter}-${timestamp}-${random}`;
+}
+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}`;
+}
+function generateWorkspaceId(name) {
+  const slug = name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+  return `workspace-${slug}`;
+}
+function isValidId(value) {
+  return typeof value === "string" && value.length > 0;
+}
+function assertValidId(value, name = "id") {
+  if (!isValidId(value)) {
+    throw new Error(`Invalid ${name}: expected non-empty string, got ${typeof value}`);
+  }
+}
+
+// src/protocol/dom.ts
+function findAction(actionId, root = document) {
+  return root.querySelector(`[data-bb-action="${actionId}"]`);
+}
+function findAllActions(actionId, root = document) {
+  return Array.from(root.querySelectorAll(`[data-bb-action="${actionId}"]`));
+}
+function findAllActionElements(root = document) {
+  return Array.from(root.querySelectorAll("[data-bb-action]"));
+}
+function findEntity(entityType, entityId, root = document) {
+  return root.querySelector(`[data-bb-entity="${entityType}"][data-bb-entity-id="${entityId}"]`);
+}
+function findAllEntities(entityType, root = document) {
+  return Array.from(root.querySelectorAll(`[data-bb-entity="${entityType}"]`));
+}
+function findField(fieldName, root = document) {
+  return root.querySelector(`[data-bb-field="${fieldName}"]`);
+}
+function findInput(inputName, root = document) {
+  return root.querySelector(`[data-bb-input="${inputName}"]`);
+}
+function findOutput(outputName, root = document) {
+  return root.querySelector(`[data-bb-output="${outputName}"]`);
+}
+function isAuthenticated(indicator, root = document) {
+  return root.querySelector(indicator) !== null;
+}
+function getActionId(element) {
+  return element.getAttribute("data-bb-action");
+}
+function getEntityType(element) {
+  return element.getAttribute("data-bb-entity");
+}
+function getEntityId(element) {
+  return element.getAttribute("data-bb-entity-id");
+}
+function getFieldName(element) {
+  return element.getAttribute("data-bb-field");
+}
+function getState(element) {
+  return element.getAttribute("data-bb-state");
+}
+function requiresConfirmation(element) {
+  return element.getAttribute("data-bb-confirm") === "true";
+}
+function getDescription(element) {
+  const desc = element.getAttribute("data-bb-description");
+  if (desc) return desc;
+  const descElement = element.querySelector("[data-bb-description]");
+  return descElement?.textContent?.trim() ?? null;
+}
+function getInputs(element) {
+  const inputs = element.getAttribute("data-bb-inputs");
+  if (!inputs) return null;
+  try {
+    return JSON.parse(inputs);
+  } catch {
+    return null;
+  }
+}
+function getCost(element) {
+  const cost = element.getAttribute("data-bb-cost");
+  if (!cost) return null;
+  try {
+    return JSON.parse(cost);
+  } catch {
+    return null;
+  }
+}
+function extractEntity(element, schema) {
+  const result = {};
+  for (const [fieldName, selectorOrAttr] of Object.entries(schema.fields)) {
+    result[fieldName] = extractFieldValue(element, selectorOrAttr);
+  }
+  return result;
+}
+function extractFieldValue(root, selectorOrAttr) {
+  if (selectorOrAttr.startsWith("data-")) {
+    return root.getAttribute(selectorOrAttr);
+  }
+  const attrMatch = selectorOrAttr.match(/^(.+?)\s+@(.+)$/);
+  if (attrMatch) {
+    const [, selector, attr] = attrMatch;
+    const child2 = root.querySelector(selector);
+    return child2?.getAttribute(attr) ?? null;
+  }
+  const child = root.querySelector(selectorOrAttr);
+  return child?.textContent?.trim() ?? null;
+}
+function extractAllEntities(entityType, schema, root = document) {
+  const elements = findAllEntities(entityType, root);
+  return elements.map((el) => extractEntity(el, schema));
+}
+function setState(element, state) {
+  element.setAttribute("data-bb-state", state);
+}
+function waitForState(element, targetState, options = {}) {
+  const { timeout = 3e4, 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();
+  });
+}
+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();
+}
+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)
+  }));
+}
+function isActionAvailable(element) {
+  const state = getState(element);
+  if (!state || state === "idle" || state === "success") return true;
+  return false;
+}
+function findManifestUrl(doc = document) {
+  const link = doc.querySelector('link[rel="bb-manifest"]');
+  if (link) {
+    return link.getAttribute("href");
+  }
+  return "/bb-manifest.json";
+}
+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"
+    };
+  }
+}
+
+export { AuthConfigSchema, AuthTypeSchema, BBManifestSchema, BBStateSchema, CapabilitySchema, CapabilityTypeSchema, ConfirmationTypeSchema, ConstraintConfigSchema, CostEstimateSchema, EntitySchemaSchema, InputFieldSchema, InputTypeSchema, LatencyEstimateSchema, OutputFieldSchema, RiskLevelSchema, assertValidId, extractAllEntities, extractEntity, extractFieldValue, fetchManifest, findAction, findAllActionElements, findAllActions, findAllEntities, findEntity, findField, findInput, findManifestUrl, findOutput, generateDocumentId, generateRunId, generateSessionId, generateWorkspaceId, getActionId, getAvailableActions, getCost, getDescription, getEntityId, getEntityType, getFieldName, getInputs, getState, isActionAvailable, isAuthenticated, isValidId, observeState, parseManifest, requiresConfirmation, setState, toAgentId, toCapabilityId, toComponentId, toDocumentId, toEntityTypeId, toRunId, toSessionId, toWorkspaceId, validateCapability, validateEntitySchema, validateManifest, waitForState };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/protocol/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}
+{"version":3,"sources":["../../src/protocol/schema.ts","../../src/protocol/branded.ts","../../src/protocol/dom.ts"],"names":["child"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Zod schemas for bb-protocol validation\n */\n\nimport { z } from 'zod';\n\n// =============================================================================\n// Enums\n// =============================================================================\n\nexport const CapabilityTypeSchema = z.enum(['query', 'mutation', 'workflow']);\nexport const RiskLevelSchema = z.enum(['low', 'medium', 'high']);\nexport const InputTypeSchema = z.enum(['string', 'number', 'boolean', 'date', 'file', 'select']);\nexport const AuthTypeSchema = z.enum(['none', 'session', 'oauth', 'api-key']);\nexport const ConfirmationTypeSchema = z.enum(['none', 'optional', 'required']);\nexport const BBStateSchema = z.enum([\n  'idle',\n  'loading',\n  'success',\n  'error',\n  'disabled',\n  'hidden',\n  'requires-auth',\n]);\n\n// =============================================================================\n// Nested Schemas\n// =============================================================================\n\nexport const InputFieldSchema = z.object({\n  name: z.string().min(1),\n  type: InputTypeSchema,\n  required: z.boolean().optional(),\n  default: z.unknown().optional(),\n  options: z.array(z.string()).optional(),\n  from: z.string().optional(),\n  selector: z.string().optional(),\n});\n\nexport const OutputFieldSchema = z.object({\n  name: z.string().min(1),\n  type: z.string().min(1),\n  selector: z.string().optional(),\n});\n\nexport const CostEstimateSchema = z.object({\n  usd: z.union([z.number(), z.literal('variable')]).optional(),\n  tokens: z.number().optional(),\n  risk: RiskLevelSchema,\n});\n\nexport const LatencyEstimateSchema = z.object({\n  typical: z.number().positive(),\n  max: z.number().positive().optional(),\n});\n\nexport const CapabilitySchema = z\n  .object({\n    id: z\n      .string()\n      .min(1)\n      .regex(/^[a-z][a-z0-9-]*$/, 'ID must be kebab-case'),\n    type: CapabilityTypeSchema,\n    description: z.string().min(1),\n    entry: z.string().optional(),\n    selector: z.string().min(1),\n    inputs: z.array(InputFieldSchema).optional(),\n    outputs: z.array(OutputFieldSchema).optional(),\n    cost: CostEstimateSchema.optional(),\n    latency: LatencyEstimateSchema.optional(),\n    requires: z.array(z.string()).optional(),\n    confirmation: ConfirmationTypeSchema.optional(),\n    steps: z.array(z.string()).optional(),\n  })\n  .refine(\n    (data) => {\n      // Workflows should have steps\n      if (data.type === 'workflow' && (!data.steps || data.steps.length === 0)) {\n        return false;\n      }\n      return true;\n    },\n    { message: 'Workflow capabilities must have steps defined' }\n  );\n\nexport const EntitySchemaSchema = z.object({\n  selector: z.string().min(1),\n  fields: z.record(z.string(), z.string()),\n  actions: z.array(z.string()).optional(),\n});\n\nexport const AuthConfigSchema = z.object({\n  type: AuthTypeSchema,\n  loginUrl: z.string().optional(),\n  logoutUrl: z.string().optional(),\n  indicator: z.string().optional(),\n  scopes: z.array(z.string()).optional(),\n  header: z.string().optional(),\n  documentationUrl: z.string().optional(),\n});\n\nexport const RateLimitSchema = z.object({\n  requests: z.number().positive(),\n  window: z.string().regex(/^\\d+[smhd]$/, 'Window must be like \"60s\", \"5m\", \"1h\", \"1d\"'),\n});\n\nexport const ConstraintConfigSchema = z.object({\n  rateLimit: RateLimitSchema.optional(),\n  requiresHuman: z.array(z.string()).optional(),\n  blockedAgents: z.array(z.string()).optional(),\n  allowedAgents: z.array(z.string()).optional(),\n});\n\n// =============================================================================\n// Main Manifest Schema\n// =============================================================================\n\nexport const BBManifestSchema = z.object({\n  version: z.literal('1.0'),\n  name: z.string().min(1),\n  description: z.string().min(1),\n  icon: z.string().url().optional(),\n  contact: z.string().optional(),\n  documentation: z.string().url().optional(),\n  capabilities: z.array(CapabilitySchema).min(1),\n  entities: z.record(z.string(), EntitySchemaSchema).optional(),\n  auth: AuthConfigSchema.optional(),\n  constraints: ConstraintConfigSchema.optional(),\n  extensions: z.record(z.string(), z.unknown()).optional(),\n});\n\n// =============================================================================\n// Validation Functions\n// =============================================================================\n\nexport type ManifestValidationResult =\n  | { success: true; data: z.infer<typeof BBManifestSchema> }\n  | { success: false; errors: z.ZodError };\n\n/**\n * Validate a manifest object against the schema\n */\nexport function validateManifest(manifest: unknown): ManifestValidationResult {\n  const result = BBManifestSchema.safeParse(manifest);\n  if (result.success) {\n    return { success: true, data: result.data };\n  }\n  return { success: false, errors: result.error };\n}\n\n/**\n * Parse and validate a manifest JSON string\n */\nexport function parseManifest(json: string): ManifestValidationResult {\n  try {\n    const parsed = JSON.parse(json);\n    return validateManifest(parsed);\n  } catch (error) {\n    return {\n      success: false,\n      errors: new z.ZodError([\n        {\n          code: 'custom',\n          path: [],\n          message: `Invalid JSON: ${error instanceof Error ? error.message : 'Unknown error'}`,\n        },\n      ]),\n    };\n  }\n}\n\n/**\n * Validate a single capability\n */\nexport function validateCapability(capability: unknown) {\n  return CapabilitySchema.safeParse(capability);\n}\n\n/**\n * Validate an entity schema\n */\nexport function validateEntitySchema(entity: unknown) {\n  return EntitySchemaSchema.safeParse(entity);\n}\n\n// =============================================================================\n// Type Exports\n// =============================================================================\n\nexport type BBManifestInput = z.input<typeof BBManifestSchema>;\nexport type BBManifestOutput = z.output<typeof BBManifestSchema>;\nexport type CapabilityInput = z.input<typeof CapabilitySchema>;\nexport type EntitySchemaInput = z.input<typeof EntitySchemaSchema>;\n","/**\n * Branded Types\n *\n * These types use TypeScript's structural typing escape hatch to create\n * nominally-typed IDs that prevent accidental mixing of different ID types.\n *\n * @example\n * ```ts\n * const agentId: AgentId = 'agent-123' as AgentId;\n * const runId: RunId = 'run-456' as RunId;\n *\n * function getAgent(id: AgentId) { ... }\n *\n * getAgent(agentId); // OK\n * getAgent(runId);   // Type error!\n * ```\n */\n\n// =============================================================================\n// Brand Symbol\n// =============================================================================\n\ndeclare const __brand: unique symbol;\n\n/**\n * Creates a branded type that is structurally incompatible with other branded types.\n * This prevents accidentally passing the wrong type of ID to a function.\n */\ntype Brand<T, B> = T & { readonly [__brand]: B };\n\n// =============================================================================\n// Branded ID Types\n// =============================================================================\n\n/**\n * Unique identifier for an AI agent.\n * @example 'claude-3-opus', 'gpt-4', 'agent-custom-1'\n */\nexport type AgentId = Brand<string, 'AgentId'>;\n\n/**\n * Unique identifier for an agent run/execution.\n * @example 'run-1705123456789-abc123'\n */\nexport type RunId = Brand<string, 'RunId'>;\n\n/**\n * Unique identifier for a workspace specification.\n * @example 'workspace-dashboard-v1'\n */\nexport type WorkspaceId = Brand<string, 'WorkspaceId'>;\n\n/**\n * Unique identifier for a play session.\n * @example 'session-openrct2-xyz789'\n */\nexport type SessionId = Brand<string, 'SessionId'>;\n\n/**\n * Unique identifier for a synced document.\n * @example 'doc-project-readme-md'\n */\nexport type DocumentId = Brand<string, 'DocumentId'>;\n\n/**\n * Unique identifier for a capability in a manifest.\n * @example 'search-products', 'create-order'\n */\nexport type CapabilityId = Brand<string, 'CapabilityId'>;\n\n/**\n * Unique identifier for an entity type.\n * @example 'product', 'user', 'order'\n */\nexport type EntityTypeId = Brand<string, 'EntityTypeId'>;\n\n/**\n * Unique identifier for a component in the registry.\n * @example 'glow-button', 'glass-panel', 'graph-3d'\n */\nexport type ComponentId = Brand<string, 'ComponentId'>;\n\n// =============================================================================\n// Type Guards and Utilities\n// =============================================================================\n\n/**\n * Create a branded AgentId from a string.\n * Use this when receiving agent IDs from external sources.\n */\nexport function toAgentId(id: string): AgentId {\n  return id as AgentId;\n}\n\n/**\n * Create a branded RunId from a string.\n * Use this when receiving run IDs from external sources.\n */\nexport function toRunId(id: string): RunId {\n  return id as RunId;\n}\n\n/**\n * Create a branded WorkspaceId from a string.\n * Use this when receiving workspace IDs from external sources.\n */\nexport function toWorkspaceId(id: string): WorkspaceId {\n  return id as WorkspaceId;\n}\n\n/**\n * Create a branded SessionId from a string.\n * Use this when receiving session IDs from external sources.\n */\nexport function toSessionId(id: string): SessionId {\n  return id as SessionId;\n}\n\n/**\n * Create a branded DocumentId from a string.\n * Use this when receiving document IDs from external sources.\n */\nexport function toDocumentId(id: string): DocumentId {\n  return id as DocumentId;\n}\n\n/**\n * Create a branded CapabilityId from a string.\n * Use this when receiving capability IDs from external sources.\n */\nexport function toCapabilityId(id: string): CapabilityId {\n  return id as CapabilityId;\n}\n\n/**\n * Create a branded EntityTypeId from a string.\n * Use this when receiving entity type IDs from external sources.\n */\nexport function toEntityTypeId(id: string): EntityTypeId {\n  return id as EntityTypeId;\n}\n\n/**\n * Create a branded ComponentId from a string.\n * Use this when receiving component IDs from external sources.\n */\nexport function toComponentId(id: string): ComponentId {\n  return id as ComponentId;\n}\n\n// =============================================================================\n// ID Generation Utilities\n// =============================================================================\n\n/**\n * Generate a unique run ID with timestamp and random suffix.\n */\nexport function generateRunId(): RunId {\n  const timestamp = Date.now();\n  const random = Math.random().toString(36).slice(2, 9);\n  return `run-${timestamp}-${random}` as RunId;\n}\n\n/**\n * Generate a unique session ID with adapter prefix and random suffix.\n */\nexport function generateSessionId(adapter: string): SessionId {\n  const timestamp = Date.now();\n  const random = Math.random().toString(36).slice(2, 9);\n  return `session-${adapter}-${timestamp}-${random}` as SessionId;\n}\n\n/**\n * Generate a unique document ID from a descriptive name.\n */\nexport function generateDocumentId(name: string): DocumentId {\n  const slug = name\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-|-$/g, '');\n  const random = Math.random().toString(36).slice(2, 6);\n  return `doc-${slug}-${random}` as DocumentId;\n}\n\n/**\n * Generate a unique workspace ID from a name.\n */\nexport function generateWorkspaceId(name: string): WorkspaceId {\n  const slug = name\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-|-$/g, '');\n  return `workspace-${slug}` as WorkspaceId;\n}\n\n// =============================================================================\n// Type Assertions\n// =============================================================================\n\n/**\n * Check if a value is a valid ID string (non-empty).\n */\nexport function isValidId(value: unknown): value is string {\n  return typeof value === 'string' && value.length > 0;\n}\n\n/**\n * Assert that a value is a valid ID, throwing if not.\n */\nexport function assertValidId(value: unknown, name = 'id'): asserts value is string {\n  if (!isValidId(value)) {\n    throw new Error(`Invalid ${name}: expected non-empty string, got ${typeof value}`);\n  }\n}\n","/**\n * DOM utilities for bb-protocol annotations\n *\n * Query and interact with elements annotated with data-bb-* attributes.\n */\n\nimport type { BBState, EntitySchema, BBAttributes } from './types.js';\n\n// =============================================================================\n// Element Queries\n// =============================================================================\n\n/**\n * Find an element by its bb-action attribute\n */\nexport function findAction(actionId: string, root: ParentNode = document): Element | null {\n  return root.querySelector(`[data-bb-action=\"${actionId}\"]`);\n}\n\n/**\n * Find all elements with a specific bb-action\n */\nexport function findAllActions(actionId: string, root: ParentNode = document): Element[] {\n  return Array.from(root.querySelectorAll(`[data-bb-action=\"${actionId}\"]`));\n}\n\n/**\n * Find all action elements on the page\n */\nexport function findAllActionElements(root: ParentNode = document): Element[] {\n  return Array.from(root.querySelectorAll('[data-bb-action]'));\n}\n\n/**\n * Find an entity by type and ID\n */\nexport function findEntity(\n  entityType: string,\n  entityId: string,\n  root: ParentNode = document\n): Element | null {\n  return root.querySelector(`[data-bb-entity=\"${entityType}\"][data-bb-entity-id=\"${entityId}\"]`);\n}\n\n/**\n * Find all entities of a specific type\n */\nexport function findAllEntities(entityType: string, root: ParentNode = document): Element[] {\n  return Array.from(root.querySelectorAll(`[data-bb-entity=\"${entityType}\"]`));\n}\n\n/**\n * Find a field within an entity or root\n */\nexport function findField(fieldName: string, root: ParentNode = document): Element | null {\n  return root.querySelector(`[data-bb-field=\"${fieldName}\"]`);\n}\n\n/**\n * Find an input by name\n */\nexport function findInput(inputName: string, root: ParentNode = document): Element | null {\n  return root.querySelector(`[data-bb-input=\"${inputName}\"]`);\n}\n\n/**\n * Find output area by name\n */\nexport function findOutput(outputName: string, root: ParentNode = document): Element | null {\n  return root.querySelector(`[data-bb-output=\"${outputName}\"]`);\n}\n\n/**\n * Check if user is authenticated based on auth indicator\n */\nexport function isAuthenticated(indicator: string, root: ParentNode = document): boolean {\n  return root.querySelector(indicator) !== null;\n}\n\n// =============================================================================\n// Attribute Reading\n// =============================================================================\n\n/**\n * Get the bb-action ID from an element\n */\nexport function getActionId(element: Element): string | null {\n  return element.getAttribute('data-bb-action');\n}\n\n/**\n * Get the entity type from an element\n */\nexport function getEntityType(element: Element): string | null {\n  return element.getAttribute('data-bb-entity');\n}\n\n/**\n * Get the entity ID from an element\n */\nexport function getEntityId(element: Element): string | null {\n  return element.getAttribute('data-bb-entity-id');\n}\n\n/**\n * Get the field name from an element\n */\nexport function getFieldName(element: Element): string | null {\n  return element.getAttribute('data-bb-field');\n}\n\n/**\n * Get the current state of an element\n */\nexport function getState(element: Element): BBState | null {\n  return element.getAttribute('data-bb-state') as BBState | null;\n}\n\n/**\n * Check if an element requires confirmation\n */\nexport function requiresConfirmation(element: Element): boolean {\n  return element.getAttribute('data-bb-confirm') === 'true';\n}\n\n/**\n * Get the hidden description for an element\n */\nexport function getDescription(element: Element): string | null {\n  // First check for data-bb-description attribute\n  const desc = element.getAttribute('data-bb-description');\n  if (desc) return desc;\n\n  // Then check for child with data-bb-description\n  const descElement = element.querySelector('[data-bb-description]');\n  return descElement?.textContent?.trim() ?? null;\n}\n\n/**\n * Get JSON-encoded inputs from an element\n */\nexport function getInputs(element: Element): Record<string, unknown> | null {\n  const inputs = element.getAttribute('data-bb-inputs');\n  if (!inputs) return null;\n  try {\n    return JSON.parse(inputs);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Get JSON-encoded cost from an element\n */\nexport function getCost(element: Element): { usd?: number; risk?: string } | null {\n  const cost = element.getAttribute('data-bb-cost');\n  if (!cost) return null;\n  try {\n    return JSON.parse(cost);\n  } catch {\n    return null;\n  }\n}\n\n// =============================================================================\n// Entity Extraction\n// =============================================================================\n\n/**\n * Extract entity data based on schema field mappings\n */\nexport function extractEntity(\n  element: Element,\n  schema: EntitySchema\n): Record<string, string | null> {\n  const result: Record<string, string | null> = {};\n\n  for (const [fieldName, selectorOrAttr] of Object.entries(schema.fields)) {\n    result[fieldName] = extractFieldValue(element, selectorOrAttr);\n  }\n\n  return result;\n}\n\n/**\n * Extract a single field value using selector syntax\n *\n * Supports:\n * - \"data-bb-entity-id\" - read data attribute from root\n * - \"[data-bb-field='name']\" - text content of child element\n * - \"[data-bb-field='image'] @src\" - attribute of child element\n * - \"[data-bb-field='status'] @data-bb-state\" - data attribute of child\n */\nexport function extractFieldValue(root: Element, selectorOrAttr: string): string | null {\n  // Check if it's a direct data attribute reference (no brackets)\n  if (selectorOrAttr.startsWith('data-')) {\n    return root.getAttribute(selectorOrAttr);\n  }\n\n  // Check for attribute extraction syntax: \"selector @attr\"\n  const attrMatch = selectorOrAttr.match(/^(.+?)\\s+@(.+)$/);\n  if (attrMatch) {\n    const [, selector, attr] = attrMatch;\n    const child = root.querySelector(selector);\n    return child?.getAttribute(attr) ?? null;\n  }\n\n  // Standard selector - get text content\n  const child = root.querySelector(selectorOrAttr);\n  return child?.textContent?.trim() ?? null;\n}\n\n/**\n * Extract all entities of a type from a page\n */\nexport function extractAllEntities(\n  entityType: string,\n  schema: EntitySchema,\n  root: ParentNode = document\n): Array<Record<string, string | null>> {\n  const elements = findAllEntities(entityType, root);\n  return elements.map((el) => extractEntity(el, schema));\n}\n\n// =============================================================================\n// State Management\n// =============================================================================\n\n/**\n * Set the state of an element\n */\nexport function setState(element: Element, state: BBState): void {\n  element.setAttribute('data-bb-state', state);\n}\n\n/**\n * Wait for an element to reach a specific state\n */\nexport function waitForState(\n  element: Element,\n  targetState: BBState,\n  options: { timeout?: number; pollInterval?: number } = {}\n): Promise<void> {\n  const { timeout = 30000, pollInterval = 100 } = options;\n\n  return new Promise((resolve, reject) => {\n    const startTime = Date.now();\n\n    const check = () => {\n      const currentState = getState(element);\n      if (currentState === targetState) {\n        resolve();\n        return;\n      }\n\n      if (Date.now() - startTime > timeout) {\n        reject(new Error(`Timeout waiting for state \"${targetState}\". Current: \"${currentState}\"`));\n        return;\n      }\n\n      setTimeout(check, pollInterval);\n    };\n\n    check();\n  });\n}\n\n/**\n * Observe state changes on an element\n */\nexport function observeState(\n  element: Element,\n  callback: (state: BBState | null, previousState: BBState | null) => void\n): () => void {\n  let previousState = getState(element);\n\n  const observer = new MutationObserver((mutations) => {\n    for (const mutation of mutations) {\n      if (mutation.type === 'attributes' && mutation.attributeName === 'data-bb-state') {\n        const newState = getState(element);\n        if (newState !== previousState) {\n          callback(newState, previousState);\n          previousState = newState;\n        }\n      }\n    }\n  });\n\n  observer.observe(element, { attributes: true, attributeFilter: ['data-bb-state'] });\n\n  return () => observer.disconnect();\n}\n\n// =============================================================================\n// Action Helpers\n// =============================================================================\n\n/**\n * Get all available actions with their metadata\n */\nexport function getAvailableActions(root: ParentNode = document): Array<{\n  id: string;\n  element: Element;\n  state: BBState | null;\n  requiresConfirmation: boolean;\n  description: string | null;\n  inputs: Record<string, unknown> | null;\n  cost: { usd?: number; risk?: string } | null;\n}> {\n  const elements = findAllActionElements(root);\n  return elements.map((element) => ({\n    id: getActionId(element)!,\n    element,\n    state: getState(element),\n    requiresConfirmation: requiresConfirmation(element),\n    description: getDescription(element),\n    inputs: getInputs(element),\n    cost: getCost(element),\n  }));\n}\n\n/**\n * Check if an action is currently available (not disabled/loading/hidden)\n */\nexport function isActionAvailable(element: Element): boolean {\n  const state = getState(element);\n  if (!state || state === 'idle' || state === 'success') return true;\n  return false;\n}\n\n// =============================================================================\n// Manifest Discovery\n// =============================================================================\n\n/**\n * Find the bb-manifest link in the document\n */\nexport function findManifestUrl(doc: Document = document): string | null {\n  const link = doc.querySelector('link[rel=\"bb-manifest\"]');\n  if (link) {\n    return link.getAttribute('href');\n  }\n  // Default location\n  return '/bb-manifest.json';\n}\n\n/**\n * Fetch and parse the bb-manifest for the current page\n */\nexport async function fetchManifest(\n  url?: string\n): Promise<{ success: true; data: unknown } | { success: false; error: string }> {\n  const manifestUrl = url ?? findManifestUrl();\n  if (!manifestUrl) {\n    return { success: false, error: 'No manifest URL found' };\n  }\n\n  try {\n    const response = await fetch(manifestUrl);\n    if (!response.ok) {\n      return { success: false, error: `HTTP ${response.status}: ${response.statusText}` };\n    }\n    const data = await response.json();\n    return { success: true, data };\n  } catch (error) {\n    return {\n      success: false,\n      error: error instanceof Error ? error.message : 'Unknown error',\n    };\n  }\n}\n"]}