@vantinelai/openclaw 0.1.0

package/dist/config.d.ts

@@ -0,0 +1,30 @@
+export interface OpenclawJsonConfig {
+    models?: {
+        providers?: Record<string, unknown>;
+    };
+    'diagnostics-otel'?: {
+        enabled: boolean;
+        endpoint: string;
+        protocol: string;
+        headers?: Record<string, string>;
+    };
+    [key: string]: unknown;
+}
+/**
+ * Returns the default path to ~/.openclaw/openclaw.json
+ */
+export declare function getOpenclawConfigPath(): string;
+/**
+ * Read existing openclaw.json if it exists, return empty object otherwise.
+ */
+export declare function readOpenclawConfig(configPath?: string): OpenclawJsonConfig;
+/**
+ * Deep-merge a patch into the existing openclaw.json and write it back.
+ * Returns the path written to.
+ */
+export declare function writeOpenclawConfig(patch: OpenclawJsonConfig, configPath?: string): string;
+/**
+ * Build the Vantinel config fragment for openclaw.json
+ */
+export declare function buildVantinelConfigFragment(apiKey: string, gatewayUrl: string): OpenclawJsonConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC;IACF,kBAAkB,CAAC,EAAE;QACnB,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAW1E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,kBAAkB,EACzB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAaR;AAqBD;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,kBAAkB,CAqBpB"}

package/dist/config.js

@@ -0,0 +1,84 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+/**
+ * Returns the default path to ~/.openclaw/openclaw.json
+ */
+export function getOpenclawConfigPath() {
+    return path.join(os.homedir(), '.openclaw', 'openclaw.json');
+}
+/**
+ * Read existing openclaw.json if it exists, return empty object otherwise.
+ */
+export function readOpenclawConfig(configPath) {
+    const filePath = configPath ?? getOpenclawConfigPath();
+    try {
+        if (fs.existsSync(filePath)) {
+            const raw = fs.readFileSync(filePath, 'utf-8');
+            return JSON.parse(raw);
+        }
+    }
+    catch {
+        // Ignore parse errors — start fresh
+    }
+    return {};
+}
+/**
+ * Deep-merge a patch into the existing openclaw.json and write it back.
+ * Returns the path written to.
+ */
+export function writeOpenclawConfig(patch, configPath) {
+    const filePath = configPath ?? getOpenclawConfigPath();
+    const dir = path.dirname(filePath);
+    // Ensure directory exists
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const existing = readOpenclawConfig(filePath);
+    const merged = deepMerge(existing, patch);
+    fs.writeFileSync(filePath, JSON.stringify(merged, null, 2), 'utf-8');
+    return filePath;
+}
+function deepMerge(base, patch) {
+    const result = { ...base };
+    for (const [key, value] of Object.entries(patch)) {
+        if (value !== null &&
+            typeof value === 'object' &&
+            !Array.isArray(value) &&
+            typeof result[key] === 'object' &&
+            result[key] !== null &&
+            !Array.isArray(result[key])) {
+            result[key] = deepMerge(result[key], value);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Build the Vantinel config fragment for openclaw.json
+ */
+export function buildVantinelConfigFragment(apiKey, gatewayUrl) {
+    const baseUrl = gatewayUrl.replace(/\/$/, '');
+    return {
+        models: {
+            providers: {
+                vantinel: {
+                    baseUrl: `${baseUrl}/v1`,
+                    apiKey,
+                    type: 'openai',
+                },
+            },
+        },
+        'diagnostics-otel': {
+            enabled: true,
+            endpoint: `${baseUrl}/v1/traces`,
+            protocol: 'http/json',
+            headers: {
+                'X-Vantinel-API-Key': apiKey,
+            },
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @vantinel/openclaw
+ *
+ * One-line setup for Vantinel observability with OpenClaw / NemoClaw agents.
+ *
+ * @example
+ * import { setup } from '@vantinelai/openclaw'
+ * await setup({ apiKey: 'vntl_...', gatewayUrl: 'http://localhost:8000' })
+ */
+export { getOpenclawConfigPath, readOpenclawConfig, writeOpenclawConfig, buildVantinelConfigFragment } from './config.js';
+export { startMcpProxy, stopMcpProxy, isMcpProxyRunning } from './proxy.js';
+export type { OpenclawSetupConfig, SetupResult, OpenclawClientWrapper } from './types.js';
+import type { OpenclawSetupConfig, SetupResult } from './types.js';
+/**
+ * One-call setup: writes openclaw.json fragment, verifies gateway connectivity,
+ * and optionally starts the MCP proxy.
+ */
+export declare function setup(config: OpenclawSetupConfig): Promise<SetupResult>;
+/**
+ * Programmatically wrap an OpenClaw JS client instance.
+ * Intercepts tool calls to add Vantinel observability.
+ *
+ * @param client - An OpenClaw client instance (duck-typed)
+ * @param config - Vantinel config
+ */
+export declare function wrapOpenClaw(client: Record<string, unknown>, config: Pick<OpenclawSetupConfig, 'apiKey' | 'gatewayUrl' | 'agentId'>): Record<string, unknown>;
+/**
+ * Returns the Vantinel dashboard deep-link URL for a given agent session.
+ */
+export declare function getSessionUrl(sessionId: string, options?: {
+    dashboardUrl?: string;
+}): string;
+//# 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;;;;;;;;GAQG;AAEH,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC1H,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC5E,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAG1F,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEnE;;;GAGG;AACH,wBAAsB,KAAK,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,CAsD7E;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC,GACrE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4BzB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAClC,MAAM,CAGR"}

package/dist/index.js

@@ -0,0 +1,123 @@
+/**
+ * @vantinel/openclaw
+ *
+ * One-line setup for Vantinel observability with OpenClaw / NemoClaw agents.
+ *
+ * @example
+ * import { setup } from '@vantinelai/openclaw'
+ * await setup({ apiKey: 'vntl_...', gatewayUrl: 'http://localhost:8000' })
+ */
+export { getOpenclawConfigPath, readOpenclawConfig, writeOpenclawConfig, buildVantinelConfigFragment } from './config.js';
+export { startMcpProxy, stopMcpProxy, isMcpProxyRunning } from './proxy.js';
+import { buildVantinelConfigFragment, writeOpenclawConfig } from './config.js';
+/**
+ * One-call setup: writes openclaw.json fragment, verifies gateway connectivity,
+ * and optionally starts the MCP proxy.
+ */
+export async function setup(config) {
+    const gatewayUrl = (config.gatewayUrl ?? 'http://localhost:8000').replace(/\/$/, '');
+    const errors = [];
+    let gatewayLatencyMs;
+    let configWritten = false;
+    let configPath = '';
+    let proxyStarted = false;
+    // 1. Write openclaw.json fragment
+    try {
+        const fragment = buildVantinelConfigFragment(config.apiKey, gatewayUrl);
+        configPath = writeOpenclawConfig(fragment);
+        configWritten = true;
+    }
+    catch (err) {
+        errors.push(`Failed to write openclaw.json: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // 2. Verify gateway connectivity
+    try {
+        const start = Date.now();
+        const res = await fetch(`${gatewayUrl}/health`, {
+            signal: AbortSignal.timeout(3000),
+        });
+        gatewayLatencyMs = Date.now() - start;
+        if (!res.ok) {
+            errors.push(`Gateway health check failed: HTTP ${res.status}`);
+        }
+    }
+    catch (err) {
+        errors.push(`Cannot reach gateway at ${gatewayUrl}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // 3. Optionally start MCP proxy
+    if (config.startMcpProxy) {
+        try {
+            const { startMcpProxy } = await import('./proxy.js');
+            proxyStarted = await startMcpProxy('openclaw-mcp-server', [], {
+                mode: config.proxyMode ?? 'openclaw',
+                collectorUrl: gatewayUrl,
+                apiKey: config.apiKey,
+            });
+        }
+        catch (err) {
+            errors.push(`Failed to start MCP proxy: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    return {
+        ok: errors.length === 0,
+        gatewayUrl,
+        gatewayLatencyMs,
+        configWritten,
+        configPath,
+        proxyStarted,
+        errors,
+    };
+}
+/**
+ * Programmatically wrap an OpenClaw JS client instance.
+ * Intercepts tool calls to add Vantinel observability.
+ *
+ * @param client - An OpenClaw client instance (duck-typed)
+ * @param config - Vantinel config
+ */
+export function wrapOpenClaw(client, config) {
+    const gatewayUrl = (config.gatewayUrl ?? 'http://localhost:8000').replace(/\/$/, '');
+    const apiKey = config.apiKey;
+    // Wrap the `run` method if it exists (OpenClaw's main execution method)
+    if (typeof client['run'] === 'function') {
+        const originalRun = client['run'];
+        const agentId = config.agentId ?? 'openclaw-agent';
+        const sessionId = `oc_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+        // Send session start
+        void sendSessionEvent(apiKey, gatewayUrl, 'start', sessionId, agentId).catch(() => { });
+        client['run'] = async function (...args) {
+            try {
+                const result = await originalRun.apply(client, args);
+                void sendSessionEvent(apiKey, gatewayUrl, 'end', sessionId, agentId).catch(() => { });
+                return result;
+            }
+            catch (err) {
+                void sendSessionEvent(apiKey, gatewayUrl, 'error', sessionId, agentId, {
+                    error: err instanceof Error ? err.message : String(err),
+                }).catch(() => { });
+                throw err;
+            }
+        };
+    }
+    return client;
+}
+/**
+ * Returns the Vantinel dashboard deep-link URL for a given agent session.
+ */
+export function getSessionUrl(sessionId, options) {
+    const base = (options?.dashboardUrl ?? 'https://app.vantinel.com').replace(/\/$/, '');
+    return `${base}/agents/${encodeURIComponent(sessionId)}`;
+}
+// ── Internal helpers ──────────────────────────────────────────────────────────
+async function sendSessionEvent(apiKey, gatewayUrl, event, sessionId, agentId, metadata) {
+    await fetch(`${gatewayUrl}/v1/agents/sessions`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'X-Vantinel-API-Key': apiKey,
+        },
+        body: JSON.stringify({ event, session_id: sessionId, agent_id: agentId, metadata }),
+        signal: AbortSignal.timeout(2000),
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/proxy.d.ts

@@ -0,0 +1,21 @@
+export interface ProxyOptions {
+    mode?: 'openclaw' | 'nemoclaw' | 'generic';
+    collectorUrl?: string;
+    apiKey?: string;
+    clientId?: string;
+}
+/**
+ * Start the Vantinel MCP proxy wrapper.
+ * Spawns `npx vantinel-mcp-proxy --mode <mode>` in the background.
+ * Returns true if started successfully, false if already running or failed.
+ */
+export declare function startMcpProxy(targetCommand: string, targetArgs: string[], options?: ProxyOptions): Promise<boolean>;
+/**
+ * Stop the running MCP proxy process.
+ */
+export declare function stopMcpProxy(): Promise<void>;
+/**
+ * Returns true if the MCP proxy is currently running.
+ */
+export declare function isMcpProxyRunning(): boolean;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,OAAO,CAAC,CAiClB;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAKlD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C"}

package/dist/proxy.js

@@ -0,0 +1,54 @@
+import { spawn } from 'child_process';
+let proxyProcess = null;
+/**
+ * Start the Vantinel MCP proxy wrapper.
+ * Spawns `npx vantinel-mcp-proxy --mode <mode>` in the background.
+ * Returns true if started successfully, false if already running or failed.
+ */
+export async function startMcpProxy(targetCommand, targetArgs, options = {}) {
+    if (proxyProcess && !proxyProcess.killed) {
+        return false; // Already running
+    }
+    const mode = options.mode ?? 'openclaw';
+    const env = {
+        ...process.env,
+    };
+    if (options.collectorUrl)
+        env['VANTINEL_COLLECTOR_URL'] = options.collectorUrl;
+    if (options.apiKey)
+        env['VANTINEL_API_KEY'] = options.apiKey;
+    if (options.clientId)
+        env['VANTINEL_CLIENT_ID'] = options.clientId;
+    if (options.mode)
+        env['VANTINEL_MODE'] = options.mode;
+    const args = ['--mode', mode, '--', targetCommand, ...targetArgs];
+    proxyProcess = spawn('npx', ['vantinel-mcp-proxy', ...args], {
+        env,
+        stdio: 'inherit',
+        detached: false,
+    });
+    proxyProcess.on('error', (err) => {
+        console.warn('[Vantinel] MCP proxy failed to start:', err.message);
+        proxyProcess = null;
+    });
+    proxyProcess.on('exit', () => {
+        proxyProcess = null;
+    });
+    return true;
+}
+/**
+ * Stop the running MCP proxy process.
+ */
+export async function stopMcpProxy() {
+    if (proxyProcess && !proxyProcess.killed) {
+        proxyProcess.kill('SIGTERM');
+        proxyProcess = null;
+    }
+}
+/**
+ * Returns true if the MCP proxy is currently running.
+ */
+export function isMcpProxyRunning() {
+    return proxyProcess !== null && !proxyProcess.killed;
+}
+//# sourceMappingURL=proxy.js.map

package/dist/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAgB,MAAM,eAAe,CAAC;AAEpD,IAAI,YAAY,GAAwB,IAAI,CAAC;AAS7C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,aAAqB,EACrB,UAAoB,EACpB,UAAwB,EAAE;IAE1B,IAAI,YAAY,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC,CAAC,kBAAkB;IAClC,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,UAAU,CAAC;IACxC,MAAM,GAAG,GAA2B;QAClC,GAAG,OAAO,CAAC,GAA6B;KACzC,CAAC;IAEF,IAAI,OAAO,CAAC,YAAY;QAAE,GAAG,CAAC,wBAAwB,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAC/E,IAAI,OAAO,CAAC,MAAM;QAAE,GAAG,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAC7D,IAAI,OAAO,CAAC,QAAQ;QAAE,GAAG,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;IACnE,IAAI,OAAO,CAAC,IAAI;QAAE,GAAG,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAEtD,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,UAAU,CAAC,CAAC;IAElE,YAAY,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,oBAAoB,EAAE,GAAG,IAAI,CAAC,EAAE;QAC3D,GAAG;QACH,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IAEH,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QAC/B,OAAO,CAAC,IAAI,CAAC,uCAAuC,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACnE,YAAY,GAAG,IAAI,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;QAC3B,YAAY,GAAG,IAAI,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,IAAI,YAAY,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;QACzC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7B,YAAY,GAAG,IAAI,CAAC;IACtB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,YAAY,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;AACvD,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,31 @@
+export interface OpenclawSetupConfig {
+    /** Vantinel API key (starts with vntl_) */
+    apiKey: string;
+    /** Gateway URL, defaults to http://localhost:8000 */
+    gatewayUrl?: string;
+    /** Agent ID for this OpenClaw instance */
+    agentId?: string;
+    /** Session budget in USD. 0 = unlimited */
+    sessionBudget?: number;
+    /** Whether to start MCP proxy wrapper automatically */
+    startMcpProxy?: boolean;
+    /** Mode for MCP proxy: openclaw, nemoclaw, generic */
+    proxyMode?: 'openclaw' | 'nemoclaw' | 'generic';
+    /** Dashboard URL for deep-links */
+    dashboardUrl?: string;
+}
+export interface SetupResult {
+    ok: boolean;
+    gatewayUrl: string;
+    gatewayLatencyMs?: number;
+    configWritten: boolean;
+    configPath: string;
+    proxyStarted: boolean;
+    errors: string[];
+}
+export interface OpenclawClientWrapper {
+    /** The underlying VantinelClient for direct use */
+    sendSessionEvent(event: 'start' | 'end' | 'step' | 'error', sessionId: string, metadata?: Record<string, unknown>): Promise<void>;
+    destroy(): Promise<void>;
+}
+//# 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,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,sDAAsD;IACtD,SAAS,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IAChD,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClI,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

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/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@vantinelai/openclaw",
+  "version": "0.1.0",
+  "description": "One-line Vantinel observability setup for OpenClaw and NemoClaw autonomous agents",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist"
+  },
+  "keywords": ["vantinel", "openclaw", "nemoclaw", "ai-agent", "observability"],
+  "author": "Vantinel AI <support@vantinel.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vantinel/vantinel-node.git",
+    "directory": "packages/openclaw"
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "@types/node": "^20.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}