@agentuity/frontend 0.0.100

package/AGENTS.md

@@ -0,0 +1,80 @@
+# Agent Guidelines for @agentuity/web
+
+## Package Overview
+
+Generic web utilities for building Agentuity frontend applications. Provides framework-agnostic utilities that can be used across React, Svelte, Vue, and other frontend frameworks.
+
+## Commands
+
+- **Build**: `bun run build` (compiles for browser target)
+- **Typecheck**: `bun run typecheck` (runs TypeScript type checking)
+- **Clean**: `bun run clean` (removes dist/)
+
+## Architecture
+
+- **Runtime**: Browser only (uses browser APIs like fetch, WebSocket, EventSource)
+- **Build target**: Browser with ESNext
+- **Dependencies**: Requires `@agentuity/core` (workspace dependency)
+- **No framework dependencies**: Pure JavaScript/TypeScript with no React/Svelte/Vue dependencies
+
+## Structure
+
+```text
+src/
+├── index.ts           # Main entry point
+├── env.ts             # Environment variable helpers
+├── url.ts             # URL building utilities
+├── serialization.ts   # JSON serialization helpers
+├── reconnect.ts       # Exponential backoff reconnection logic
+├── types.ts           # Type definitions for route registries
+└── memo.ts            # JSON equality utilities
+```
+
+## Code Style
+
+- **Framework-agnostic** - No framework-specific dependencies (React, Svelte, etc.)
+- **TypeScript generics** - Heavy use of generics for type safety
+- **Pure functions** - All utilities are pure functions where possible
+- **Browser APIs** - Uses standard browser APIs (fetch, WebSocket, EventSource)
+
+## Important Conventions
+
+- **No framework dependencies** - This package must remain framework-agnostic
+- **Type inference** - Route types are inferred from generated types (RouteRegistry)
+- **Base URL** - Defaults to current origin if not provided
+- **WebSocket protocol** - Auto-converts http:// to ws:// and https:// to wss://
+- **Serialization** - Automatically handles JSON serialization/deserialization
+
+## Utilities
+
+### URL Building
+
+- `buildUrl()` - Construct URLs with paths, subpaths, and query parameters
+- `defaultBaseUrl` - Default base URL from environment or window.location.origin
+
+### Reconnection Manager
+
+- `createReconnectManager()` - Exponential backoff reconnection logic with jitter
+- Configurable threshold, delays, and retry strategies
+
+### Environment
+
+- `getProcessEnv()` - Cross-platform environment variable access (process.env, import.meta.env)
+
+### Serialization
+
+- `deserializeData()` - Safe JSON deserialization with fallback
+- `jsonEqual()` - JSON-based equality check for memoization
+
+## Testing
+
+- Test with Bun test runner
+- Mock browser APIs where needed (fetch, WebSocket, EventSource)
+- Ensure all utilities work without framework dependencies
+
+## Publishing Checklist
+
+1. Run `bun run build` to compile for browser
+2. Verify `dist/` contains browser-compatible code (no Node.js APIs)
+3. Ensure no framework-specific dependencies are added
+4. Must publish **after** @agentuity/core

package/README.md

@@ -0,0 +1,65 @@
+# @agentuity/web
+
+Generic web utilities for building Agentuity frontend applications. Provides framework-agnostic utilities for URL building, serialization, reconnection logic, and type definitions.
+
+This package contains reusable JavaScript logic that can be shared across different frontend frameworks (React, Svelte, Vue, etc.).
+
+## Installation
+
+```bash
+npm install @agentuity/web
+```
+
+## Features
+
+- **URL Building**: Utilities for constructing URLs with query parameters
+- **Environment Helpers**: Cross-platform environment variable access
+- **Serialization**: JSON serialization/deserialization utilities
+- **Reconnection Logic**: Exponential backoff reconnection manager for WebSockets and SSE
+- **Type Definitions**: Shared TypeScript types for route registries
+- **Memoization**: JSON-based equality checking
+
+## Usage
+
+### URL Building
+
+```typescript
+import { buildUrl, defaultBaseUrl } from '@agentuity/web';
+
+const url = buildUrl(
+	'https://api.example.com',
+	'/users',
+	undefined,
+	new URLSearchParams({ page: '1' })
+);
+// => 'https://api.example.com/users?page=1'
+```
+
+### Reconnection Manager
+
+```typescript
+import { createReconnectManager } from '@agentuity/web';
+
+const reconnect = createReconnectManager({
+	onReconnect: () => console.log('Reconnecting...'),
+	threshold: 3,
+	baseDelay: 500,
+	factor: 2,
+	maxDelay: 30000,
+});
+
+// Record failures to trigger exponential backoff
+reconnect.recordFailure();
+```
+
+### Serialization
+
+```typescript
+import { deserializeData } from '@agentuity/web';
+
+const data = deserializeData<MyType>('{"key":"value"}');
+```
+
+## License
+
+Apache-2.0

package/dist/env.d.ts

@@ -0,0 +1,2 @@
+export declare const getProcessEnv: (key: string) => string | undefined;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAQpD,CAAC"}

package/dist/env.js

@@ -0,0 +1,10 @@
+export const getProcessEnv = (key) => {
+    if (typeof process !== 'undefined' && process.env) {
+        return process.env[key];
+    }
+    if (typeof import.meta.env !== 'undefined') {
+        return import.meta.env[key];
+    }
+    return undefined;
+};
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAW,EAAsB,EAAE;IAChE,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACnD,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,WAAW,EAAE,CAAC;QAC5C,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC,CAAC"}

package/dist/eventstream-manager.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Message handler callback type
+ */
+export type MessageHandler<T = unknown> = (data: T) => void;
+/**
+ * EventStream state change callback types
+ */
+export interface EventStreamCallbacks<TOutput = unknown> {
+    /** Called when connection is established */
+    onConnect?: () => void;
+    /** Called when connection is closed */
+    onDisconnect?: () => void;
+    /** Called when an error occurs */
+    onError?: (error: Error) => void;
+    /** Called when a message is received */
+    onMessage?: MessageHandler<TOutput>;
+}
+/**
+ * Options for EventStreamManager
+ */
+export interface EventStreamManagerOptions<TOutput = unknown> {
+    /** EventStream URL */
+    url: string;
+    /** Callbacks for state changes */
+    callbacks?: EventStreamCallbacks<TOutput>;
+    /** Reconnection configuration */
+    reconnect?: {
+        threshold?: number;
+        baseDelay?: number;
+        factor?: number;
+        maxDelay?: number;
+        jitter?: number;
+    };
+}
+/**
+ * EventStream manager state
+ */
+export interface EventStreamManagerState {
+    /** Whether EventStream is currently connected */
+    isConnected: boolean;
+    /** Current error, if any */
+    error: Error | null;
+    /** EventStream ready state */
+    readyState: number;
+}
+/**
+ * Generic EventStream (SSE) connection manager with automatic reconnection
+ * and handler management.
+ *
+ * Framework-agnostic - can be used with React, Svelte, Vue, or vanilla JS.
+ */
+export declare class EventStreamManager<TOutput = unknown> {
+    private es;
+    private manualClose;
+    private pendingMessages;
+    private messageHandler;
+    private reconnectManager;
+    private callbacks;
+    private url;
+    private reconnectConfig;
+    private firstMessageReceived;
+    constructor(options: EventStreamManagerOptions<TOutput>);
+    /**
+     * Connect to the EventStream server
+     */
+    connect(): void;
+    /**
+     * Set the message handler.
+     * Any buffered messages will be delivered immediately.
+     */
+    setMessageHandler(handler: MessageHandler<TOutput>): void;
+    /**
+     * Get current state
+     */
+    getState(): EventStreamManagerState;
+    /**
+     * Close the EventStream connection and cleanup
+     */
+    close(): void;
+    /**
+     * Dispose of the manager (alias for close)
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=eventstream-manager.d.ts.map

package/dist/eventstream-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventstream-manager.d.ts","sourceRoot":"","sources":["../src/eventstream-manager.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,OAAO,GAAG,OAAO;IACtD,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,kCAAkC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,wCAAwC;IACxC,SAAS,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB,CAAC,OAAO,GAAG,OAAO;IAC3D,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,SAAS,CAAC,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC1C,iCAAiC;IACjC,SAAS,CAAC,EAAE;QACX,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,iDAAiD;IACjD,WAAW,EAAE,OAAO,CAAC;IACrB,4BAA4B;IAC5B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,qBAAa,kBAAkB,CAAC,OAAO,GAAG,OAAO;IAChD,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,eAAe,CAAyE;IAChG,OAAO,CAAC,oBAAoB,CAAS;gBAEzB,OAAO,EAAE,yBAAyB,CAAC,OAAO,CAAC;IAYvD;;OAEG;IACH,OAAO,IAAI,IAAI;IAoEf;;;OAGG;IACH,iBAAiB,CAAC,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,IAAI;IAOzD;;OAEG;IACH,QAAQ,IAAI,uBAAuB;IAQnC;;OAEG;IACH,KAAK,IAAI,IAAI;IAmBb;;OAEG;IACH,OAAO,IAAI,IAAI;CAGf"}

package/dist/eventstream-manager.js

@@ -0,0 +1,137 @@
+import { createReconnectManager } from './reconnect';
+import { deserializeData } from './serialization';
+/**
+ * Generic EventStream (SSE) connection manager with automatic reconnection
+ * and handler management.
+ *
+ * Framework-agnostic - can be used with React, Svelte, Vue, or vanilla JS.
+ */
+export class EventStreamManager {
+    es;
+    manualClose = false;
+    pendingMessages = [];
+    messageHandler;
+    reconnectManager;
+    callbacks;
+    url;
+    reconnectConfig;
+    firstMessageReceived = false;
+    constructor(options) {
+        this.url = options.url;
+        this.callbacks = options.callbacks || {};
+        this.reconnectConfig = {
+            threshold: options.reconnect?.threshold ?? 3,
+            baseDelay: options.reconnect?.baseDelay ?? 500,
+            factor: options.reconnect?.factor ?? 2,
+            maxDelay: options.reconnect?.maxDelay ?? 30000,
+            jitter: options.reconnect?.jitter ?? 250,
+        };
+    }
+    /**
+     * Connect to the EventStream server
+     */
+    connect() {
+        if (this.manualClose)
+            return;
+        this.es = new EventSource(this.url);
+        this.firstMessageReceived = false;
+        this.es.onopen = () => {
+            this.reconnectManager?.recordSuccess();
+            this.callbacks.onConnect?.();
+        };
+        this.es.onerror = () => {
+            const error = new Error('EventStream error');
+            this.callbacks.onError?.(error);
+            this.callbacks.onDisconnect?.();
+            if (this.manualClose) {
+                return;
+            }
+            const result = this.reconnectManager?.recordFailure();
+            if (result?.scheduled) {
+                // Close current connection before reconnecting
+                if (this.es) {
+                    this.es.onopen = null;
+                    this.es.onerror = null;
+                    this.es.onmessage = null;
+                    this.es.close();
+                }
+                this.es = undefined;
+            }
+        };
+        this.es.onmessage = (event) => {
+            // Record success on first message (not just on open)
+            if (!this.firstMessageReceived) {
+                this.reconnectManager?.recordSuccess();
+                this.firstMessageReceived = true;
+            }
+            const payload = deserializeData(event.data);
+            // Call the registered message handler
+            if (this.messageHandler) {
+                this.messageHandler(payload);
+            }
+            else {
+                // Buffer messages until a handler is set
+                this.pendingMessages.push(payload);
+            }
+            // Also call the callback if provided
+            this.callbacks.onMessage?.(payload);
+        };
+        // Setup reconnect manager
+        if (!this.reconnectManager) {
+            this.reconnectManager = createReconnectManager({
+                onReconnect: () => this.connect(),
+                threshold: this.reconnectConfig.threshold,
+                baseDelay: this.reconnectConfig.baseDelay,
+                factor: this.reconnectConfig.factor,
+                maxDelay: this.reconnectConfig.maxDelay,
+                jitter: this.reconnectConfig.jitter,
+                enabled: () => !this.manualClose,
+            });
+        }
+    }
+    /**
+     * Set the message handler.
+     * Any buffered messages will be delivered immediately.
+     */
+    setMessageHandler(handler) {
+        this.messageHandler = handler;
+        // Flush pending messages
+        this.pendingMessages.forEach(handler);
+        this.pendingMessages = [];
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        return {
+            isConnected: this.es?.readyState === EventSource.OPEN,
+            error: null, // Error state managed externally via callbacks
+            readyState: this.es?.readyState ?? EventSource.CLOSED,
+        };
+    }
+    /**
+     * Close the EventStream connection and cleanup
+     */
+    close() {
+        this.manualClose = true;
+        this.reconnectManager?.dispose();
+        if (this.es) {
+            this.es.onopen = null;
+            this.es.onerror = null;
+            this.es.onmessage = null;
+            this.es.close();
+        }
+        this.es = undefined;
+        this.messageHandler = undefined;
+        this.pendingMessages = [];
+        // Notify disconnect callback
+        this.callbacks.onDisconnect?.();
+    }
+    /**
+     * Dispose of the manager (alias for close)
+     */
+    dispose() {
+        this.close();
+    }
+}
+//# sourceMappingURL=eventstream-manager.js.map

package/dist/eventstream-manager.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { getProcessEnv } from './env';
+export { buildUrl, defaultBaseUrl } from './url';
+export { deserializeData } from './serialization';
+export { createReconnectManager, type ReconnectOptions, type ReconnectManager } from './reconnect';
+export { type RouteRegistry, type WebSocketRouteRegistry, type SSERouteRegistry } from './types';
+export { jsonEqual } from './memo';
+export { WebSocketManager, type MessageHandler as WebSocketMessageHandler, type WebSocketCallbacks, type WebSocketManagerOptions, type WebSocketManagerState, } from './websocket-manager';
+export { EventStreamManager, type MessageHandler as EventStreamMessageHandler, type EventStreamCallbacks, type EventStreamManagerOptions, type EventStreamManagerState, } from './eventstream-manager';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AACjG,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EACN,gBAAgB,EAChB,KAAK,cAAc,IAAI,uBAAuB,EAC9C,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,kBAAkB,EAClB,KAAK,cAAc,IAAI,yBAAyB,EAChD,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,GAC5B,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { getProcessEnv } from './env';
+export { buildUrl, defaultBaseUrl } from './url';
+export { deserializeData } from './serialization';
+export { createReconnectManager } from './reconnect';
+export { jsonEqual } from './memo';
+export { WebSocketManager, } from './websocket-manager';
+export { EventStreamManager, } from './eventstream-manager';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAgD,MAAM,aAAa,CAAC;AAEnG,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EACN,gBAAgB,GAKhB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,kBAAkB,GAKlB,MAAM,uBAAuB,CAAC"}

package/dist/memo.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Simple JSON-based equality check for memoization.
+ * Compares stringified JSON to avoid deep equality overhead.
+ */
+export declare function jsonEqual<T>(a: T, b: T): boolean;
+//# sourceMappingURL=memo.d.ts.map

package/dist/memo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memo.d.ts","sourceRoot":"","sources":["../src/memo.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,OAAO,CAWhD"}

package/dist/memo.js

@@ -0,0 +1,20 @@
+/**
+ * Simple JSON-based equality check for memoization.
+ * Compares stringified JSON to avoid deep equality overhead.
+ */
+export function jsonEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a === undefined || b === undefined)
+        return false;
+    if (a === null || b === null)
+        return a === b;
+    try {
+        return JSON.stringify(a) === JSON.stringify(b);
+    }
+    catch {
+        // Fallback for non-serializable values
+        return false;
+    }
+}
+//# sourceMappingURL=memo.js.map

package/dist/memo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memo.js","sourceRoot":"","sources":["../src/memo.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAI,CAAI,EAAE,CAAI;IACtC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAE7C,IAAI,CAAC;QACJ,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACR,uCAAuC;QACvC,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC"}

package/dist/reconnect.d.ts

@@ -0,0 +1,22 @@
+export interface ReconnectOptions {
+    onReconnect: () => void;
+    threshold?: number;
+    baseDelay?: number;
+    factor?: number;
+    maxDelay?: number;
+    jitter?: number;
+    enabled?: () => boolean;
+}
+export interface ReconnectManager {
+    recordFailure: () => {
+        scheduled: boolean;
+        delay: number | null;
+    };
+    recordSuccess: () => void;
+    cancel: () => void;
+    reset: () => void;
+    dispose: () => void;
+    getAttempts: () => number;
+}
+export declare function createReconnectManager(opts: ReconnectOptions): ReconnectManager;
+//# sourceMappingURL=reconnect.d.ts.map

package/dist/reconnect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconnect.d.ts","sourceRoot":"","sources":["../src/reconnect.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAChC,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAChC,aAAa,EAAE,MAAM;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAClE,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,MAAM,CAAC;CAC1B;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAqD/E"}

package/dist/reconnect.js

@@ -0,0 +1,47 @@
+export function createReconnectManager(opts) {
+    let attempts = 0;
+    let timer = null;
+    const cancel = () => {
+        if (timer) {
+            clearTimeout(timer);
+            timer = null;
+        }
+    };
+    const reset = () => {
+        attempts = 0;
+        cancel();
+    };
+    const recordSuccess = () => reset();
+    const computeDelay = (attemptAfterThreshold) => {
+        const base = opts.baseDelay ?? 500;
+        const factor = opts.factor ?? 2;
+        const max = opts.maxDelay ?? 30000;
+        const jitterMax = opts.jitter ?? 250;
+        const backoff = Math.min(base * Math.pow(factor, attemptAfterThreshold), max);
+        const jitter = jitterMax > 0 ? Math.random() * jitterMax : 0;
+        return backoff + jitter;
+    };
+    const recordFailure = () => {
+        attempts += 1;
+        const threshold = opts.threshold ?? 0;
+        if (opts.enabled && !opts.enabled()) {
+            return { scheduled: false, delay: null };
+        }
+        if (attempts - threshold >= 0) {
+            const after = Math.max(0, attempts - threshold);
+            const delay = computeDelay(after);
+            cancel();
+            timer = setTimeout(() => {
+                if (opts.enabled && !opts.enabled())
+                    return;
+                opts.onReconnect();
+            }, delay);
+            return { scheduled: true, delay };
+        }
+        return { scheduled: false, delay: null };
+    };
+    const dispose = () => cancel();
+    const getAttempts = () => attempts;
+    return { recordFailure, recordSuccess, cancel, reset, dispose, getAttempts };
+}
+//# sourceMappingURL=reconnect.js.map

package/dist/reconnect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconnect.js","sourceRoot":"","sources":["../src/reconnect.ts"],"names":[],"mappings":"AAmBA,MAAM,UAAU,sBAAsB,CAAC,IAAsB;IAC5D,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,KAAK,GAAyC,IAAI,CAAC;IAEvD,MAAM,MAAM,GAAG,GAAG,EAAE;QACnB,IAAI,KAAK,EAAE,CAAC;YACX,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,GAAG,IAAI,CAAC;QACd,CAAC;IACF,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,GAAG,EAAE;QAClB,QAAQ,GAAG,CAAC,CAAC;QACb,MAAM,EAAE,CAAC;IACV,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC;IAEpC,MAAM,YAAY,GAAG,CAAC,qBAA6B,EAAE,EAAE;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,EAAE,GAAG,CAAC,CAAC;QAC9E,MAAM,MAAM,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7D,OAAO,OAAO,GAAG,MAAM,CAAC;IACzB,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,GAAG,EAAE;QAC1B,QAAQ,IAAI,CAAC,CAAC;QACd,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;QACtC,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YACrC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC1C,CAAC;QAED,IAAI,QAAQ,GAAG,SAAS,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;YAChD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;YAClC,MAAM,EAAE,CAAC;YACT,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACvB,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;oBAAE,OAAO;gBAC5C,IAAI,CAAC,WAAW,EAAE,CAAC;YACpB,CAAC,EAAE,KAAK,CAAC,CAAC;YACV,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACnC,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC1C,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC;IAE/B,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC;IAEnC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAC9E,CAAC"}

package/dist/serialization.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Deserialize data received from WebSocket or EventStream.
+ * Attempts to parse as JSON if the data looks like JSON, otherwise returns as-is.
+ */
+export declare const deserializeData: <T>(data: string) => T;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../src/serialization.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,MAAM,MAAM,KAAG,CASjD,CAAC"}

package/dist/serialization.js

@@ -0,0 +1,16 @@
+/**
+ * Deserialize data received from WebSocket or EventStream.
+ * Attempts to parse as JSON if the data looks like JSON, otherwise returns as-is.
+ */
+export const deserializeData = (data) => {
+    if (data) {
+        try {
+            return JSON.parse(data);
+        }
+        catch {
+            /* */
+        }
+    }
+    return data;
+};
+//# sourceMappingURL=serialization.js.map

package/dist/serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../src/serialization.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAI,IAAY,EAAK,EAAE;IACrD,IAAI,IAAI,EAAE,CAAC;QACV,IAAI,CAAC;YACJ,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACR,KAAK;QACN,CAAC;IACF,CAAC;IACD,OAAO,IAAS,CAAC;AAClB,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Route registry containing all typed API routes in the application.
+ * Auto-generated by the build tool from routes that use validator() middleware.
+ */
+export interface RouteRegistry {
+}
+/**
+ * WebSocket route registry containing all typed WebSocket routes in the application.
+ * Auto-generated by the build tool from routes that use validator() middleware.
+ */
+export interface WebSocketRouteRegistry {
+}
+/**
+ * SSE route registry containing all typed SSE routes in the application.
+ * Auto-generated by the build tool from routes that use validator() middleware.
+ */
+export interface SSERouteRegistry {
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;CAG7B;AAED;;;GAGG;AAEH,MAAM,WAAW,sBAAsB;CAGtC;AAED;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;CAGhC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/url.d.ts

@@ -0,0 +1,3 @@
+export declare const buildUrl: (base: string, path: string, subpath?: string, query?: URLSearchParams) => string;
+export declare const defaultBaseUrl: string;
+//# sourceMappingURL=url.d.ts.map

package/dist/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../src/url.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ,GACpB,MAAM,MAAM,EACZ,MAAM,MAAM,EACZ,UAAU,MAAM,EAChB,QAAQ,eAAe,KACrB,MAWF,CAAC;AAQF,eAAO,MAAM,cAAc,EAAE,MAKL,CAAC"}

package/dist/url.js

@@ -0,0 +1,24 @@
+import { getProcessEnv } from './env';
+export const buildUrl = (base, path, subpath, query) => {
+    path = path.startsWith('/') ? path : `/${path}`;
+    let url = base.replace(/\/$/, '') + path;
+    if (subpath) {
+        subpath = subpath.startsWith('/') ? subpath : `/${subpath}`;
+        url += `/${subpath}`;
+    }
+    if (query) {
+        url += `?${query.toString()}`;
+    }
+    return url;
+};
+const tryOrigin = () => {
+    if (typeof window !== 'undefined') {
+        return window.location.origin;
+    }
+};
+export const defaultBaseUrl = getProcessEnv('NEXT_PUBLIC_AGENTUITY_URL') ||
+    getProcessEnv('VITE_AGENTUITY_URL') ||
+    getProcessEnv('AGENTUITY_URL') ||
+    tryOrigin() ||
+    'http://localhost:3500';
+//# sourceMappingURL=url.js.map

package/dist/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../src/url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtC,MAAM,CAAC,MAAM,QAAQ,GAAG,CACvB,IAAY,EACZ,IAAY,EACZ,OAAgB,EAChB,KAAuB,EACd,EAAE;IACX,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IAChD,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC;IACzC,IAAI,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;QAC5D,GAAG,IAAI,IAAI,OAAO,EAAE,CAAC;IACtB,CAAC;IACD,IAAI,KAAK,EAAE,CAAC;QACX,GAAG,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC/B,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,GAAG,EAAE;IACtB,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QACnC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC/B,CAAC;AACF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAC1B,aAAa,CAAC,2BAA2B,CAAC;IAC1C,aAAa,CAAC,oBAAoB,CAAC;IACnC,aAAa,CAAC,eAAe,CAAC;IAC9B,SAAS,EAAE;IACX,uBAAuB,CAAC"}