lavs-client 0.1.0

package/README.md

@@ -0,0 +1,62 @@
+# lavs-client
+
+Client SDK for the **LAVS (Local Agent View Service)** protocol.
+
+Enables frontend applications to call LAVS endpoints via SSE (Server-Sent Events) streaming, with support for queries, mutations, and real-time subscriptions.
+
+## Install
+
+```bash
+npm install lavs-client
+```
+
+## Usage
+
+```typescript
+import { LAVSClient } from 'lavs-client';
+
+const client = new LAVSClient({
+  baseUrl: 'http://localhost:4936',
+  agentId: 'my-agent',
+});
+
+// Query endpoint
+const todos = await client.query('listTodos');
+
+// Mutation endpoint
+const newTodo = await client.mutate('addTodo', {
+  text: 'Buy groceries',
+  priority: 3,
+});
+
+// Subscription (real-time updates via SSE)
+const unsubscribe = client.subscribe('watchTodos', {}, (event) => {
+  console.log('Update:', event.data);
+});
+```
+
+## API
+
+### `new LAVSClient(options)`
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `baseUrl` | `string` | LAVS server base URL |
+| `agentId` | `string` | Agent identifier |
+
+### Methods
+
+| Method | Description |
+|--------|-------------|
+| `query(endpoint, input?)` | Call a query endpoint |
+| `mutate(endpoint, input?)` | Call a mutation endpoint |
+| `subscribe(endpoint, input?, callback)` | Subscribe to real-time updates |
+
+## Related Packages
+
+- [`lavs-types`](https://www.npmjs.com/package/lavs-types) — Protocol type definitions
+- [`lavs-runtime`](https://www.npmjs.com/package/lavs-runtime) — Server-side runtime
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,81 @@
+/**
+ * LAVS Client SDK
+ *
+ * Client library for calling LAVS endpoints from frontend applications.
+ */
+import { LAVSManifest } from './types';
+/**
+ * LAVS Client configuration
+ */
+export interface LAVSClientOptions {
+    agentId: string;
+    baseURL?: string;
+    projectPath?: string;
+}
+/**
+ * LAVS Client for calling agent endpoints
+ */
+export declare class LAVSClient {
+    private agentId;
+    private baseURL;
+    private projectPath?;
+    private manifest;
+    constructor(options: LAVSClientOptions);
+    /**
+     * Get auth token from localStorage
+     */
+    private getAuthToken;
+    /**
+     * Get LAVS manifest for the agent
+     */
+    getManifest(): Promise<LAVSManifest>;
+    /**
+     * Call a LAVS endpoint
+     *
+     * @param endpointId - Endpoint ID from manifest
+     * @param input - Input data for the endpoint
+     * @returns Endpoint result
+     */
+    call<TResult = any>(endpointId: string, input?: any): Promise<TResult>;
+    /**
+     * Subscribe to a LAVS subscription endpoint via SSE.
+     *
+     * Opens a Server-Sent Events connection to the endpoint's /subscribe URL.
+     * Returns an unsubscribe function to close the connection.
+     *
+     * @param endpointId - Subscription endpoint ID from manifest
+     * @param callback - Called with event data on each SSE message
+     * @param options - Optional: onError handler, onConnected handler
+     * @returns Unsubscribe function to close the SSE connection
+     */
+    subscribe(endpointId: string, callback: (data: any) => void, options?: {
+        onError?: (error: Event) => void;
+        onConnected?: (subscriptionInfo: any) => void;
+    }): () => void;
+    /**
+     * Clear manifest cache (force reload on next getManifest)
+     */
+    clearCache(): void;
+}
+/**
+ * Interface that view components should implement
+ */
+export interface LAVSViewComponent extends HTMLElement {
+    /**
+     * Called when component is mounted
+     */
+    connectedCallback?(): void;
+    /**
+     * Set the LAVS client (injected by container)
+     */
+    setLAVSClient(client: LAVSClient): void;
+    /**
+     * Optional: receive notifications when agent performs actions
+     */
+    onAgentAction?(action: any): void;
+    /**
+     * Called when component is unmounted
+     */
+    disconnectedCallback?(): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAa,MAAM,SAAS,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAA6B;gBAEjC,OAAO,EAAE,iBAAiB;IAatC;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC;IA8C1C;;;;;;OAMG;IACG,IAAI,CAAC,OAAO,GAAG,GAAG,EACtB,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,GAAG,GACV,OAAO,CAAC,OAAO,CAAC;IAkDnB;;;;;;;;;;OAUG;IACH,SAAS,CACP,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,EAC7B,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;QACjC,WAAW,CAAC,EAAE,CAAC,gBAAgB,EAAE,GAAG,KAAK,IAAI,CAAC;KAC/C,GACA,MAAM,IAAI;IAyDb;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD;;OAEG;IACH,iBAAiB,CAAC,IAAI,IAAI,CAAC;IAE3B;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAExC;;OAEG;IACH,aAAa,CAAC,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC;IAElC;;OAEG;IACH,oBAAoB,CAAC,IAAI,IAAI,CAAC;CAC/B"}

package/dist/client.js

@@ -0,0 +1,190 @@
+/**
+ * LAVS Client SDK
+ *
+ * Client library for calling LAVS endpoints from frontend applications.
+ */
+import { LAVSError } from './types';
+/**
+ * LAVS Client for calling agent endpoints
+ */
+export class LAVSClient {
+    agentId;
+    baseURL;
+    projectPath;
+    manifest = null;
+    constructor(options) {
+        this.agentId = options.agentId;
+        this.baseURL = options.baseURL || window.location.origin;
+        this.projectPath = options.projectPath;
+        // Debug logging
+        console.log('[LAVSClient] Initialized:', {
+            agentId: this.agentId,
+            projectPath: this.projectPath,
+            hasProjectPath: !!this.projectPath
+        });
+    }
+    /**
+     * Get auth token from localStorage
+     */
+    getAuthToken() {
+        // Try both possible token keys for compatibility
+        return localStorage.getItem('auth_token') || localStorage.getItem('authToken');
+    }
+    /**
+     * Get LAVS manifest for the agent
+     */
+    async getManifest() {
+        if (this.manifest) {
+            return this.manifest;
+        }
+        const url = `${this.baseURL}/api/agents/${this.agentId}/lavs/manifest`;
+        try {
+            const token = this.getAuthToken();
+            const headers = {
+                'Content-Type': 'application/json',
+            };
+            if (token) {
+                headers['Authorization'] = `Bearer ${token}`;
+            }
+            const response = await fetch(url, {
+                method: 'GET',
+                headers,
+                credentials: 'include', // Include cookies for auth
+            });
+            if (!response.ok) {
+                const body = await response.json();
+                // Handle JSON-RPC error format
+                const rpcError = body.error || body;
+                throw new LAVSError(rpcError.code || -1, rpcError.message || rpcError.error || `HTTP ${response.status}: ${response.statusText}`, rpcError.data);
+            }
+            const body = await response.json();
+            // Unwrap JSON-RPC 2.0 response: { jsonrpc: '2.0', result: manifest }
+            this.manifest = body.result ?? body;
+            return this.manifest;
+        }
+        catch (error) {
+            if (error instanceof LAVSError) {
+                throw error;
+            }
+            throw new LAVSError(-1, `Failed to fetch manifest: ${error.message}`);
+        }
+    }
+    /**
+     * Call a LAVS endpoint
+     *
+     * @param endpointId - Endpoint ID from manifest
+     * @param input - Input data for the endpoint
+     * @returns Endpoint result
+     */
+    async call(endpointId, input) {
+        const url = `${this.baseURL}/api/agents/${this.agentId}/lavs/${endpointId}`;
+        try {
+            const token = this.getAuthToken();
+            const headers = {
+                'Content-Type': 'application/json',
+            };
+            if (token) {
+                headers['Authorization'] = `Bearer ${token}`;
+            }
+            // Add projectPath to headers if available
+            if (this.projectPath) {
+                headers['X-Project-Path'] = this.projectPath;
+                console.log('[LAVSClient] Adding X-Project-Path header:', this.projectPath);
+            }
+            else {
+                console.log('[LAVSClient] No projectPath available');
+            }
+            const response = await fetch(url, {
+                method: 'POST',
+                headers,
+                credentials: 'include',
+                body: JSON.stringify(input || {}),
+            });
+            if (!response.ok) {
+                const body = await response.json();
+                // Handle JSON-RPC error format
+                const rpcError = body.error || body;
+                throw new LAVSError(rpcError.code || -1, rpcError.message || rpcError.error || `HTTP ${response.status}: ${response.statusText}`, rpcError.data);
+            }
+            const body = await response.json();
+            // Unwrap JSON-RPC 2.0 response: { jsonrpc: '2.0', result: data }
+            return (body.result ?? body);
+        }
+        catch (error) {
+            if (error instanceof LAVSError) {
+                throw error;
+            }
+            throw new LAVSError(-1, `Failed to call endpoint: ${error.message}`);
+        }
+    }
+    /**
+     * Subscribe to a LAVS subscription endpoint via SSE.
+     *
+     * Opens a Server-Sent Events connection to the endpoint's /subscribe URL.
+     * Returns an unsubscribe function to close the connection.
+     *
+     * @param endpointId - Subscription endpoint ID from manifest
+     * @param callback - Called with event data on each SSE message
+     * @param options - Optional: onError handler, onConnected handler
+     * @returns Unsubscribe function to close the SSE connection
+     */
+    subscribe(endpointId, callback, options) {
+        const url = `${this.baseURL}/api/agents/${this.agentId}/lavs/${endpointId}/subscribe`;
+        const eventSource = new EventSource(url, {
+            withCredentials: true,
+        });
+        // Handle connection established
+        eventSource.addEventListener('connected', (event) => {
+            try {
+                const info = JSON.parse(event.data);
+                console.log('[LAVSClient] SSE connected:', info);
+                options?.onConnected?.(info);
+            }
+            catch (e) {
+                console.warn('[LAVSClient] Failed to parse connected event:', e);
+            }
+        });
+        // Handle data events
+        eventSource.addEventListener('data', (event) => {
+            try {
+                const data = JSON.parse(event.data);
+                callback(data);
+            }
+            catch (e) {
+                console.warn('[LAVSClient] Failed to parse SSE data:', e);
+                callback(event.data); // Pass raw data if not JSON
+            }
+        });
+        // Handle heartbeat (keep-alive)
+        eventSource.addEventListener('heartbeat', () => {
+            // Heartbeat received, connection is alive
+        });
+        // Handle generic messages (no event type)
+        eventSource.onmessage = (event) => {
+            try {
+                const data = JSON.parse(event.data);
+                callback(data);
+            }
+            catch {
+                callback(event.data);
+            }
+        };
+        // Handle errors
+        eventSource.onerror = (event) => {
+            console.error('[LAVSClient] SSE error:', event);
+            options?.onError?.(event);
+        };
+        // Return unsubscribe function
+        return () => {
+            console.log('[LAVSClient] Closing SSE connection for:', endpointId);
+            eventSource.close();
+        };
+    }
+    /**
+     * Clear manifest cache (force reload on next getManifest)
+     */
+    clearCache() {
+        this.manifest = null;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * LAVS Client SDK
+ *
+ * Export all LAVS client functionality
+ */
+export * from './types';
+export * from './client';
+//# 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;;;;GAIG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * LAVS Client SDK
+ *
+ * Export all LAVS client functionality
+ */
+export * from './types';
+export * from './client';
+//# 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;;;;GAIG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,107 @@
+/**
+ * LAVS Client Types
+ *
+ * Frontend type definitions for LAVS (Local Agent View Service)
+ */
+/**
+ * LAVS Manifest - describes the agent's data interface
+ */
+export interface LAVSManifest {
+    lavs: string;
+    name: string;
+    version: string;
+    description?: string;
+    endpoints: Endpoint[];
+    view?: ViewConfig;
+    types?: Record<string, any>;
+    permissions?: Permissions;
+}
+/**
+ * Endpoint definition
+ */
+export interface Endpoint {
+    id: string;
+    method: 'query' | 'mutation' | 'subscription';
+    description?: string;
+    handler: Handler;
+    schema?: Schema;
+    permissions?: Permissions;
+}
+/**
+ * Handler types
+ */
+export type Handler = ScriptHandler | FunctionHandler | HTTPHandler | MCPHandler;
+export interface ScriptHandler {
+    type: 'script';
+    command: string;
+    args?: string[];
+    input?: 'args' | 'stdin' | 'env';
+    cwd?: string;
+    timeout?: number;
+    env?: Record<string, string>;
+}
+export interface FunctionHandler {
+    type: 'function';
+    module: string;
+    function: string;
+}
+export interface HTTPHandler {
+    type: 'http';
+    url: string;
+    method: string;
+    headers?: Record<string, string>;
+}
+export interface MCPHandler {
+    type: 'mcp';
+    server: string;
+    tool: string;
+}
+/**
+ * Schema definition (JSON Schema)
+ */
+export interface Schema {
+    input?: any;
+    output?: any;
+}
+/**
+ * View configuration
+ */
+export interface ViewConfig {
+    component: ComponentSource;
+    fallback?: 'list' | 'table' | 'json';
+    icon?: string;
+    theme?: Record<string, string>;
+}
+export type ComponentSource = {
+    type: 'cdn';
+    url: string;
+    exportName?: string;
+} | {
+    type: 'npm';
+    package: string;
+    version?: string;
+} | {
+    type: 'local';
+    path: string;
+} | {
+    type: 'inline';
+    code: string;
+};
+/**
+ * Permissions
+ */
+export interface Permissions {
+    fileAccess?: string[];
+    networkAccess?: boolean | string[];
+    maxExecutionTime?: number;
+    maxMemory?: number;
+}
+/**
+ * LAVS Error
+ */
+export declare class LAVSError extends Error {
+    code: number;
+    data?: any | undefined;
+    constructor(code: number, message: string, data?: any | undefined);
+}
+//# 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":"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"}

package/dist/types.js

@@ -0,0 +1,19 @@
+/**
+ * LAVS Client Types
+ *
+ * Frontend type definitions for LAVS (Local Agent View Service)
+ */
+/**
+ * LAVS Error
+ */
+export class LAVSError extends Error {
+    code;
+    data;
+    constructor(code, message, data) {
+        super(message);
+        this.code = code;
+        this.data = data;
+        this.name = 'LAVSError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgGH;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAEzB;IAEA;IAHT,YACS,IAAY,EACnB,OAAe,EACR,IAAU;QAEjB,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAJ,IAAI,CAAQ;QAEZ,SAAI,GAAJ,IAAI,CAAM;QAGjB,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "lavs-client",
+  "version": "0.1.0",
+  "description": "LAVS (Local Agent View Service) client SDK for frontend applications",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "lavs",
+    "agent",
+    "view",
+    "service",
+    "client",
+    "frontend",
+    "sse"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nicepkg/lavs.git",
+    "directory": "sdk/typescript/client"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5.1.6"
+  }
+}