@happyvertical/smrt-core 0.30.0

package/dist/adapters/pubsub.d.ts

@@ -0,0 +1,124 @@
+import { Signal, SignalAdapter } from '@happyvertical/smrt-types';
+/**
+ * Signal filter function
+ *
+ * @param signal - Signal to evaluate
+ * @returns True if signal should be sent to subscriber
+ */
+export type SignalFilter = (signal: Signal) => boolean;
+/**
+ * Signal subscriber callback
+ */
+export type SignalSubscriber = (signal: Signal) => void | Promise<void>;
+/**
+ * Subscription configuration
+ */
+export interface Subscription {
+    /** Unique subscription ID */
+    id: string;
+    /** Callback to invoke with signals */
+    callback: SignalSubscriber;
+    /** Optional filter to apply before sending */
+    filter?: SignalFilter;
+}
+/**
+ * Pub/Sub Adapter - Broadcasts signals to subscribers
+ *
+ * Enables real-time updates for UI clients via WebSocket/SSE or
+ * internal event-driven architectures via callbacks.
+ *
+ * Features:
+ * - Multiple subscribers with independent filters
+ * - Fire-and-forget delivery (errors don't block other subscribers)
+ * - Flexible filtering (by class, method, type, etc.)
+ * - Subscription management (add, remove, list)
+ *
+ * @example
+ * ```typescript
+ * const pubsub = new PubSubAdapter();
+ * signalBus.register(pubsub);
+ *
+ * // Subscribe to all error signals
+ * const subId = pubsub.subscribe(
+ *   (signal) => console.error('Error:', signal),
+ *   (signal) => signal.type === 'error'
+ * );
+ *
+ * // Later, unsubscribe
+ * pubsub.unsubscribe(subId);
+ * ```
+ */
+export declare class PubSubAdapter implements SignalAdapter {
+    private subscriptions;
+    private nextSubscriptionId;
+    /**
+     * Handle a signal and broadcast to subscribers
+     *
+     * @param signal - Signal to broadcast
+     */
+    handle(signal: Signal): Promise<void>;
+    /**
+     * Subscribe to signals
+     *
+     * @param callback - Function to call with matching signals
+     * @param filter - Optional filter to apply before sending
+     * @returns Subscription ID for later unsubscribe
+     */
+    subscribe(callback: SignalSubscriber, filter?: SignalFilter): string;
+    /**
+     * Unsubscribe from signals
+     *
+     * @param subscriptionId - ID returned from subscribe()
+     * @returns True if subscription was found and removed
+     */
+    unsubscribe(subscriptionId: string): boolean;
+    /**
+     * Get count of active subscriptions
+     *
+     * @returns Number of active subscribers
+     */
+    get subscriberCount(): number;
+    /**
+     * Clear all subscriptions
+     *
+     * Removes all subscribers. Useful for cleanup or testing.
+     */
+    clearSubscriptions(): void;
+    /**
+     * Create filter for specific class
+     *
+     * @param className - Class name to match
+     * @returns Filter function
+     */
+    static filterByClass(className: string): SignalFilter;
+    /**
+     * Create filter for specific method
+     *
+     * @param methodName - Method name to match
+     * @returns Filter function
+     */
+    static filterByMethod(methodName: string): SignalFilter;
+    /**
+     * Create filter for specific signal type
+     *
+     * @param type - Signal type to match
+     * @returns Filter function
+     */
+    static filterByType(type: 'start' | 'step' | 'end' | 'error'): SignalFilter;
+    /**
+     * Create filter for specific class and method
+     *
+     * @param className - Class name to match
+     * @param methodName - Method name to match
+     * @returns Filter function
+     */
+    static filterByClassAndMethod(className: string, methodName: string): SignalFilter;
+    /**
+     * Combine multiple filters with AND logic
+     *
+     * @param filters - Filters to combine
+     * @returns Combined filter function
+     */
+    static combineFilters(...filters: SignalFilter[]): SignalFilter;
+}
+//# sourceMappingURL=pubsub.d.ts.map

package/dist/adapters/pubsub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pubsub.d.ts","sourceRoot":"","sources":["../../src/adapters/pubsub.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAIvE;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,aAAc,YAAW,aAAa;IACjD,OAAO,CAAC,aAAa,CAAwC;IAC7D,OAAO,CAAC,kBAAkB,CAAK;IAE/B;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B3C;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM;IAYpE;;;;;OAKG;IACH,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAI5C;;;;OAIG;IACH,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED;;;;OAIG;IACH,kBAAkB,IAAI,IAAI;IAI1B;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAIrD;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY;IAIvD;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,YAAY;IAI3E;;;;;;OAMG;IACH,MAAM,CAAC,sBAAsB,CAC3B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,YAAY;IAKf;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,GAAG,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY;CAGhE"}

package/dist/adapters/pubsub.js

@@ -0,0 +1,121 @@
+import { createLogger } from "@happyvertical/logger";
+const logger = createLogger({ level: "info" });
+class PubSubAdapter {
+  subscriptions = /* @__PURE__ */ new Map();
+  nextSubscriptionId = 1;
+  /**
+   * Handle a signal and broadcast to subscribers
+   *
+   * @param signal - Signal to broadcast
+   */
+  async handle(signal) {
+    const promises = [];
+    for (const subscription of this.subscriptions.values()) {
+      if (subscription.filter && !subscription.filter(signal)) {
+        continue;
+      }
+      const promise = (async () => {
+        try {
+          await subscription.callback(signal);
+        } catch (error) {
+          logger.error(`PubSubAdapter: Subscriber ${subscription.id} error`, {
+            error
+          });
+        }
+      })();
+      promises.push(promise);
+    }
+    await Promise.allSettled(promises);
+  }
+  /**
+   * Subscribe to signals
+   *
+   * @param callback - Function to call with matching signals
+   * @param filter - Optional filter to apply before sending
+   * @returns Subscription ID for later unsubscribe
+   */
+  subscribe(callback, filter) {
+    const id = `sub-${this.nextSubscriptionId++}`;
+    this.subscriptions.set(id, {
+      id,
+      callback,
+      filter
+    });
+    return id;
+  }
+  /**
+   * Unsubscribe from signals
+   *
+   * @param subscriptionId - ID returned from subscribe()
+   * @returns True if subscription was found and removed
+   */
+  unsubscribe(subscriptionId) {
+    return this.subscriptions.delete(subscriptionId);
+  }
+  /**
+   * Get count of active subscriptions
+   *
+   * @returns Number of active subscribers
+   */
+  get subscriberCount() {
+    return this.subscriptions.size;
+  }
+  /**
+   * Clear all subscriptions
+   *
+   * Removes all subscribers. Useful for cleanup or testing.
+   */
+  clearSubscriptions() {
+    this.subscriptions.clear();
+  }
+  /**
+   * Create filter for specific class
+   *
+   * @param className - Class name to match
+   * @returns Filter function
+   */
+  static filterByClass(className) {
+    return (signal) => signal.className === className;
+  }
+  /**
+   * Create filter for specific method
+   *
+   * @param methodName - Method name to match
+   * @returns Filter function
+   */
+  static filterByMethod(methodName) {
+    return (signal) => signal.method === methodName;
+  }
+  /**
+   * Create filter for specific signal type
+   *
+   * @param type - Signal type to match
+   * @returns Filter function
+   */
+  static filterByType(type) {
+    return (signal) => signal.type === type;
+  }
+  /**
+   * Create filter for specific class and method
+   *
+   * @param className - Class name to match
+   * @param methodName - Method name to match
+   * @returns Filter function
+   */
+  static filterByClassAndMethod(className, methodName) {
+    return (signal) => signal.className === className && signal.method === methodName;
+  }
+  /**
+   * Combine multiple filters with AND logic
+   *
+   * @param filters - Filters to combine
+   * @returns Combined filter function
+   */
+  static combineFilters(...filters) {
+    return (signal) => filters.every((filter) => filter(signal));
+  }
+}
+export {
+  PubSubAdapter
+};
+//# sourceMappingURL=pubsub.js.map

package/dist/adapters/pubsub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pubsub.js","sources":["../../src/adapters/pubsub.ts"],"sourcesContent":["/**\n * Pub/Sub Adapter for Signal System\n *\n * Broadcasts signals to subscribers for real-time updates.\n * Supports multiple subscriber types (callbacks, WebSocket, SSE).\n */\n\nimport { createLogger } from '@happyvertical/logger';\nimport type { Signal, SignalAdapter } from '@happyvertical/smrt-types';\n\nconst logger = createLogger({ level: 'info' });\n\n/**\n * Signal filter function\n *\n * @param signal - Signal to evaluate\n * @returns True if signal should be sent to subscriber\n */\nexport type SignalFilter = (signal: Signal) => boolean;\n\n/**\n * Signal subscriber callback\n */\nexport type SignalSubscriber = (signal: Signal) => void | Promise<void>;\n\n/**\n * Subscription configuration\n */\nexport interface Subscription {\n  /** Unique subscription ID */\n  id: string;\n  /** Callback to invoke with signals */\n  callback: SignalSubscriber;\n  /** Optional filter to apply before sending */\n  filter?: SignalFilter;\n}\n\n/**\n * Pub/Sub Adapter - Broadcasts signals to subscribers\n *\n * Enables real-time updates for UI clients via WebSocket/SSE or\n * internal event-driven architectures via callbacks.\n *\n * Features:\n * - Multiple subscribers with independent filters\n * - Fire-and-forget delivery (errors don't block other subscribers)\n * - Flexible filtering (by class, method, type, etc.)\n * - Subscription management (add, remove, list)\n *\n * @example\n * ```typescript\n * const pubsub = new PubSubAdapter();\n * signalBus.register(pubsub);\n *\n * // Subscribe to all error signals\n * const subId = pubsub.subscribe(\n *   (signal) => console.error('Error:', signal),\n *   (signal) => signal.type === 'error'\n * );\n *\n * // Later, unsubscribe\n * pubsub.unsubscribe(subId);\n * ```\n */\nexport class PubSubAdapter implements SignalAdapter {\n  private subscriptions: Map<string, Subscription> = new Map();\n  private nextSubscriptionId = 1;\n\n  /**\n   * Handle a signal and broadcast to subscribers\n   *\n   * @param signal - Signal to broadcast\n   */\n  async handle(signal: Signal): Promise<void> {\n    // Broadcast to all matching subscribers\n    const promises: Promise<void>[] = [];\n\n    for (const subscription of this.subscriptions.values()) {\n      // Apply filter if present\n      if (subscription.filter && !subscription.filter(signal)) {\n        continue;\n      }\n\n      // Execute callback with error handling\n      const promise = (async () => {\n        try {\n          await subscription.callback(signal);\n        } catch (error) {\n          logger.error(`PubSubAdapter: Subscriber ${subscription.id} error`, {\n            error,\n          });\n        }\n      })();\n\n      promises.push(promise);\n    }\n\n    // Wait for all subscribers to process (fire-and-forget style)\n    await Promise.allSettled(promises);\n  }\n\n  /**\n   * Subscribe to signals\n   *\n   * @param callback - Function to call with matching signals\n   * @param filter - Optional filter to apply before sending\n   * @returns Subscription ID for later unsubscribe\n   */\n  subscribe(callback: SignalSubscriber, filter?: SignalFilter): string {\n    const id = `sub-${this.nextSubscriptionId++}`;\n\n    this.subscriptions.set(id, {\n      id,\n      callback,\n      filter,\n    });\n\n    return id;\n  }\n\n  /**\n   * Unsubscribe from signals\n   *\n   * @param subscriptionId - ID returned from subscribe()\n   * @returns True if subscription was found and removed\n   */\n  unsubscribe(subscriptionId: string): boolean {\n    return this.subscriptions.delete(subscriptionId);\n  }\n\n  /**\n   * Get count of active subscriptions\n   *\n   * @returns Number of active subscribers\n   */\n  get subscriberCount(): number {\n    return this.subscriptions.size;\n  }\n\n  /**\n   * Clear all subscriptions\n   *\n   * Removes all subscribers. Useful for cleanup or testing.\n   */\n  clearSubscriptions(): void {\n    this.subscriptions.clear();\n  }\n\n  /**\n   * Create filter for specific class\n   *\n   * @param className - Class name to match\n   * @returns Filter function\n   */\n  static filterByClass(className: string): SignalFilter {\n    return (signal: Signal) => signal.className === className;\n  }\n\n  /**\n   * Create filter for specific method\n   *\n   * @param methodName - Method name to match\n   * @returns Filter function\n   */\n  static filterByMethod(methodName: string): SignalFilter {\n    return (signal: Signal) => signal.method === methodName;\n  }\n\n  /**\n   * Create filter for specific signal type\n   *\n   * @param type - Signal type to match\n   * @returns Filter function\n   */\n  static filterByType(type: 'start' | 'step' | 'end' | 'error'): SignalFilter {\n    return (signal: Signal) => signal.type === type;\n  }\n\n  /**\n   * Create filter for specific class and method\n   *\n   * @param className - Class name to match\n   * @param methodName - Method name to match\n   * @returns Filter function\n   */\n  static filterByClassAndMethod(\n    className: string,\n    methodName: string,\n  ): SignalFilter {\n    return (signal: Signal) =>\n      signal.className === className && signal.method === methodName;\n  }\n\n  /**\n   * Combine multiple filters with AND logic\n   *\n   * @param filters - Filters to combine\n   * @returns Combined filter function\n   */\n  static combineFilters(...filters: SignalFilter[]): SignalFilter {\n    return (signal: Signal) => filters.every((filter) => filter(signal));\n  }\n}\n"],"names":[],"mappings":";AAUA,MAAM,SAAS,aAAa,EAAE,OAAO,QAAQ;AAsDtC,MAAM,cAAuC;AAAA,EAC1C,oCAA+C,IAAA;AAAA,EAC/C,qBAAqB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO7B,MAAM,OAAO,QAA+B;AAE1C,UAAM,WAA4B,CAAA;AAElC,eAAW,gBAAgB,KAAK,cAAc,OAAA,GAAU;AAEtD,UAAI,aAAa,UAAU,CAAC,aAAa,OAAO,MAAM,GAAG;AACvD;AAAA,MACF;AAGA,YAAM,WAAW,YAAY;AAC3B,YAAI;AACF,gBAAM,aAAa,SAAS,MAAM;AAAA,QACpC,SAAS,OAAO;AACd,iBAAO,MAAM,6BAA6B,aAAa,EAAE,UAAU;AAAA,YACjE;AAAA,UAAA,CACD;AAAA,QACH;AAAA,MACF,GAAA;AAEA,eAAS,KAAK,OAAO;AAAA,IACvB;AAGA,UAAM,QAAQ,WAAW,QAAQ;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,UAAU,UAA4B,QAA+B;AACnE,UAAM,KAAK,OAAO,KAAK,oBAAoB;AAE3C,SAAK,cAAc,IAAI,IAAI;AAAA,MACzB;AAAA,MACA;AAAA,MACA;AAAA,IAAA,CACD;AAED,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,YAAY,gBAAiC;AAC3C,WAAO,KAAK,cAAc,OAAO,cAAc;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,IAAI,kBAA0B;AAC5B,WAAO,KAAK,cAAc;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,qBAA2B;AACzB,SAAK,cAAc,MAAA;AAAA,EACrB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,cAAc,WAAiC;AACpD,WAAO,CAAC,WAAmB,OAAO,cAAc;AAAA,EAClD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,eAAe,YAAkC;AACtD,WAAO,CAAC,WAAmB,OAAO,WAAW;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,aAAa,MAAwD;AAC1E,WAAO,CAAC,WAAmB,OAAO,SAAS;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,OAAO,uBACL,WACA,YACc;AACd,WAAO,CAAC,WACN,OAAO,cAAc,aAAa,OAAO,WAAW;AAAA,EACxD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,kBAAkB,SAAuC;AAC9D,WAAO,CAAC,WAAmB,QAAQ,MAAM,CAAC,WAAW,OAAO,MAAM,CAAC;AAAA,EACrE;AACF;"}

package/dist/browser.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @smrt/core - Browser-safe entry point
+ *
+ * This entry point excludes Node.js-only code generators (CLI, REST, MCP)
+ * that contain shebangs and Node.js-specific APIs. Use this for browser
+ * builds, federation, and client-side applications.
+ *
+ * Excluded:
+ * - Code generators (CLIGenerator, APIGenerator, MCPGenerator)
+ * - Runtime manifest utilities (Node.js-only)
+ * - Prebuild utilities (Node.js-only)
+ *
+ * For Node.js applications, use the main entry point instead:
+ * import { ... } from '@happyvertical/smrt-core';
+ */
+export * from './adapters/index';
+export * from './class';
+export * from './collection';
+export type { AiUsageConfig, GlobalSignalConfig, MetricsConfig, PubSubConfig, } from './config';
+export { config } from './config';
+export * from './errors';
+export { type HierarchyView, SmrtHierarchical } from './hierarchical';
+export { type JunctionAttachOptions, type JunctionFilterOptions, SmrtJunction, } from './junction';
+export * from './object';
+export { SmrtPolymorphicAssociation, type SmrtPolymorphicAssociationOptions, } from './polymorphic-association';
+export * from './registry';
+export { smrt as smrtRegistry } from './registry';
+export * from './signals/index';
+export * from './system/index';
+export type { DiscoveryStrategy, ForgetOptions, ForgetScopeOptions, NoteMetadata, NoteOptions, RecallAllOptions, RecallOptions, SystemTableConfig, } from './system/types';
+export * from './tools/index';
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,cAAc,kBAAkB,CAAC;AAEjC,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,YAAY,GACb,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,KAAK,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,cAAc,UAAU,CAAC;AACzB,OAAO,EACL,0BAA0B,EAC1B,KAAK,iCAAiC,GACvC,MAAM,2BAA2B,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,YAAY,CAAC;AAElD,cAAc,iBAAiB,CAAC;AAEhC,cAAc,gBAAgB,CAAC;AAC/B,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAExB,cAAc,eAAe,CAAC"}

package/dist/browser.js

@@ -0,0 +1,68 @@
+import { AiUsageCollector, AiUsagePersistenceHandler } from "./adapters/ai-usage.js";
+import { DEFAULT_AI_COST_RATES, estimateAiUsageCost } from "./adapters/cost-rates.js";
+import { MetricsAdapter } from "./adapters/metrics.js";
+import { PubSubAdapter } from "./adapters/pubsub.js";
+import { SmrtClass } from "./class.js";
+import { SmrtCollection } from "./collection.js";
+import { config } from "./config.js";
+import { AIError, ConfigurationError, DatabaseError, ErrorUtils, FilesystemError, NetworkError, RuntimeError, SmrtError, TenantIsolationError, ValidationError, ValidationReport, ValidationUtils } from "./errors.js";
+import { SmrtHierarchical } from "./hierarchical.js";
+import { SmrtJunction } from "./junction.js";
+import { SmrtObject } from "./object.js";
+import { SmrtPolymorphicAssociation } from "./polymorphic-association.js";
+import { ObjectRegistry, smrt, smrt as smrt2 } from "./registry.js";
+import { SignalBus } from "./signals/bus.js";
+import { SignalSanitizer } from "./signals/sanitizer.js";
+import { ensureDispatchSubscriptionsSystemTableCompatibility, ensureDispatchSystemTableCompatibility, ensureJobEventsSystemTableCompatibility, ensureJobsSystemTableCompatibility, ensureLegacySystemTableCompatibility, tableExists } from "./system/compatibility.js";
+import { executeToolCall, executeToolCalls, formatToolResults, validateToolCall } from "./tools/tool-executor.js";
+import { convertTypeToJsonSchema, generateToolFromMethod, generateToolManifest, shouldIncludeMethod } from "./tools/tool-generator.js";
+import { SMRT_COLLECTION_BASE_NAMES, isSmrtCollectionExtendsName } from "./registry/collection-resolution.js";
+export {
+  AIError,
+  AiUsageCollector,
+  AiUsagePersistenceHandler,
+  ConfigurationError,
+  DEFAULT_AI_COST_RATES,
+  DatabaseError,
+  ErrorUtils,
+  FilesystemError,
+  MetricsAdapter,
+  NetworkError,
+  ObjectRegistry,
+  PubSubAdapter,
+  RuntimeError,
+  SMRT_COLLECTION_BASE_NAMES,
+  SignalBus,
+  SignalSanitizer,
+  SmrtClass,
+  SmrtCollection,
+  SmrtError,
+  SmrtHierarchical,
+  SmrtJunction,
+  SmrtObject,
+  SmrtPolymorphicAssociation,
+  TenantIsolationError,
+  ValidationError,
+  ValidationReport,
+  ValidationUtils,
+  config,
+  convertTypeToJsonSchema,
+  ensureDispatchSubscriptionsSystemTableCompatibility,
+  ensureDispatchSystemTableCompatibility,
+  ensureJobEventsSystemTableCompatibility,
+  ensureJobsSystemTableCompatibility,
+  ensureLegacySystemTableCompatibility,
+  estimateAiUsageCost,
+  executeToolCall,
+  executeToolCalls,
+  formatToolResults,
+  generateToolFromMethod,
+  generateToolManifest,
+  isSmrtCollectionExtendsName,
+  shouldIncludeMethod,
+  smrt,
+  smrt2 as smrtRegistry,
+  tableExists,
+  validateToolCall
+};
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;"}

package/dist/child-accessors.d.ts

@@ -0,0 +1,27 @@
+import { RelationshipMetadata } from './registry/types';
+/**
+ * Compute the canonical child-accessor method name for a `@oneToMany` field.
+ *
+ * `terms` → `getTerms`, `relationshipsFrom` → `getRelationshipsFrom`. Exported
+ * so tests and tooling can derive the name without re-implementing the rule.
+ *
+ * @param fieldName - The `@oneToMany` property name on the parent class
+ * @returns The generated accessor method name
+ */
+export declare function childAccessorName(fieldName: string): string;
+/**
+ * Install generated child accessors for a class's `@oneToMany` relationships.
+ *
+ * Called from the `@smrt()` decorator immediately after the class is
+ * registered, so `relationships` reflects the class's own (decorator- or
+ * manifest-derived) relationship metadata. Non-`oneToMany` entries are ignored,
+ * so callers may pass the unfiltered relationship list.
+ *
+ * @param ctor - The registered class constructor (its prototype is augmented)
+ * @param relationships - Relationship metadata for the class (from
+ *   `ObjectRegistry.getRelationships`)
+ */
+export declare function applyOneToManyChildAccessors(ctor: {
+    prototype?: any;
+} | undefined, relationships: RelationshipMetadata[] | undefined): void;
+//# sourceMappingURL=child-accessors.d.ts.map

package/dist/child-accessors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-accessors.d.ts","sourceRoot":"","sources":["../src/child-accessors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE;IAAE,SAAS,CAAC,EAAE,GAAG,CAAA;CAAE,GAAG,SAAS,EACrC,aAAa,EAAE,oBAAoB,EAAE,GAAG,SAAS,GAChD,IAAI,CAoCN"}

package/dist/child-accessors.js

@@ -0,0 +1,35 @@
+function childAccessorName(fieldName) {
+  return `get${fieldName.charAt(0).toUpperCase()}${fieldName.slice(1)}`;
+}
+function applyOneToManyChildAccessors(ctor, relationships) {
+  const prototype = ctor?.prototype;
+  if (!prototype || !relationships) {
+    return;
+  }
+  for (const relationship of relationships) {
+    if (relationship.type !== "oneToMany") {
+      continue;
+    }
+    const fieldName = relationship.fieldName;
+    if (!fieldName) {
+      continue;
+    }
+    const accessorName = childAccessorName(fieldName);
+    if (accessorName in prototype) {
+      continue;
+    }
+    Object.defineProperty(prototype, accessorName, {
+      value: function generatedChildAccessor() {
+        return this.loadRelatedMany(fieldName);
+      },
+      writable: true,
+      enumerable: false,
+      configurable: true
+    });
+  }
+}
+export {
+  applyOneToManyChildAccessors,
+  childAccessorName
+};
+//# sourceMappingURL=child-accessors.js.map

package/dist/child-accessors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-accessors.js","sources":["../src/child-accessors.ts"],"sourcesContent":["/**\n * R10 — consolidated child-accessor API for `@oneToMany` relationships.\n *\n * Before R10 every model hand-rolled its own child accessor (`getTerms`,\n * `getChildren`, `getForProfile`, …) with inconsistent names and shapes. This\n * module installs ONE canonical accessor per `@oneToMany` field at class\n * registration time: a `@oneToMany('Child') items` field gains a `getItems()`\n * instance method that delegates to the existing `loadRelatedMany('items')`\n * resolver — the same code path used for lazy loading and `include:` eager\n * loading, which itself queries through the child collection (the queryable\n * primitive).\n *\n * Two invariants make this safe to apply to every registered class:\n *\n * - **Additive.** If a method of the computed name already exists anywhere on\n *   the prototype chain — a hand-rolled accessor like\n *   `ProfileRelationship.getTerms()`, a differently-shaped `Profile.getMetadata()`,\n *   or a `SmrtObject` base method — it is left untouched. The generated\n *   accessor never renames or shadows an existing public signature.\n * - **Runtime-only.** Accessors are attached to the prototype at registration;\n *   they are invisible to the build-time manifest, so they never leak into the\n *   generated REST/CLI/MCP surface (those read `classInfo.tools`/scanned\n *   methods, not the runtime prototype). They are a developer-ergonomics\n *   convenience layered on top of `loadRelatedMany`.\n *\n * Multiplicity note: when the child class declares more than one foreign key\n * back to the parent (e.g. `ProfileRelationship.fromProfileId` /\n * `toProfileId`), annotate the `@oneToMany` with `{ foreignKey: 'fromProfileId' }`\n * so `loadRelatedMany` resolves the correct inverse side. Without it the\n * resolver falls back to the first matching foreign key (legacy behavior). An\n * explicit `foreignKey` that matches no inverse FK is treated as an error.\n *\n * STI note: a child class inherits the base's generated accessor through the\n * prototype chain. `loadRelatedMany` resolves the inverse FK against the\n * instance's class AND its registered ancestors (see\n * `ObjectRegistry.getInverseRelationshipsForSelf`), so calling the accessor on\n * an STI subclass instance resolves a `@oneToMany` declared on its base.\n */\n\nimport type { RelationshipMetadata } from './registry/types';\n\n/**\n * Compute the canonical child-accessor method name for a `@oneToMany` field.\n *\n * `terms` → `getTerms`, `relationshipsFrom` → `getRelationshipsFrom`. Exported\n * so tests and tooling can derive the name without re-implementing the rule.\n *\n * @param fieldName - The `@oneToMany` property name on the parent class\n * @returns The generated accessor method name\n */\nexport function childAccessorName(fieldName: string): string {\n  return `get${fieldName.charAt(0).toUpperCase()}${fieldName.slice(1)}`;\n}\n\n/**\n * Install generated child accessors for a class's `@oneToMany` relationships.\n *\n * Called from the `@smrt()` decorator immediately after the class is\n * registered, so `relationships` reflects the class's own (decorator- or\n * manifest-derived) relationship metadata. Non-`oneToMany` entries are ignored,\n * so callers may pass the unfiltered relationship list.\n *\n * @param ctor - The registered class constructor (its prototype is augmented)\n * @param relationships - Relationship metadata for the class (from\n *   `ObjectRegistry.getRelationships`)\n */\nexport function applyOneToManyChildAccessors(\n  ctor: { prototype?: any } | undefined,\n  relationships: RelationshipMetadata[] | undefined,\n): void {\n  const prototype = ctor?.prototype;\n  if (!prototype || !relationships) {\n    return;\n  }\n\n  for (const relationship of relationships) {\n    if (relationship.type !== 'oneToMany') {\n      continue;\n    }\n\n    const fieldName = relationship.fieldName;\n    if (!fieldName) {\n      continue;\n    }\n\n    const accessorName = childAccessorName(fieldName);\n\n    // Additive only: never shadow a hand-rolled accessor (or any inherited\n    // method, including SmrtObject base methods) of the same name. `in`\n    // walks the full prototype chain.\n    if (accessorName in prototype) {\n      continue;\n    }\n\n    Object.defineProperty(prototype, accessorName, {\n      value: function generatedChildAccessor(this: {\n        loadRelatedMany(field: string): Promise<any[]>;\n      }): Promise<any[]> {\n        return this.loadRelatedMany(fieldName);\n      },\n      writable: true,\n      enumerable: false,\n      configurable: true,\n    });\n  }\n}\n"],"names":[],"mappings":"AAkDO,SAAS,kBAAkB,WAA2B;AAC3D,SAAO,MAAM,UAAU,OAAO,CAAC,EAAE,YAAA,CAAa,GAAG,UAAU,MAAM,CAAC,CAAC;AACrE;AAcO,SAAS,6BACd,MACA,eACM;AACN,QAAM,YAAY,MAAM;AACxB,MAAI,CAAC,aAAa,CAAC,eAAe;AAChC;AAAA,EACF;AAEA,aAAW,gBAAgB,eAAe;AACxC,QAAI,aAAa,SAAS,aAAa;AACrC;AAAA,IACF;AAEA,UAAM,YAAY,aAAa;AAC/B,QAAI,CAAC,WAAW;AACd;AAAA,IACF;AAEA,UAAM,eAAe,kBAAkB,SAAS;AAKhD,QAAI,gBAAgB,WAAW;AAC7B;AAAA,IACF;AAEA,WAAO,eAAe,WAAW,cAAc;AAAA,MAC7C,OAAO,SAAS,yBAEG;AACjB,eAAO,KAAK,gBAAgB,SAAS;AAAA,MACvC;AAAA,MACA,UAAU;AAAA,MACV,YAAY;AAAA,MACZ,cAAc;AAAA,IAAA,CACf;AAAA,EACH;AACF;"}