@ultrathink-solutions/openclaw-logfire 0.1.0

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;GAWG;AAWH;;;;GAIG;AACH,UAAU,SAAS;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,EAAE;QACN,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,CAAC;IACF,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;IACzD,eAAe,CAAC,OAAO,EAAE;QACvB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,IAAI,CAAC;QAClB,IAAI,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAClC,GAAG,IAAI,CAAC;CACV;AAID,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CA6ErD"}

package/dist/index.js

@@ -0,0 +1,94 @@
+// SPDX-License-Identifier: MIT
+/**
+ * @ultrathink-solutions/openclaw-logfire
+ *
+ * Pydantic Logfire observability plugin for OpenClaw.
+ * OTEL GenAI semantic convention compliant.
+ *
+ * Minimal setup:
+ *   1. Set LOGFIRE_TOKEN env var
+ *   2. Add to openclaw.json:
+ *      { "plugins": { "entries": { "logfire": { "enabled": true, "config": {} } } } }
+ *   3. Restart OpenClaw
+ */
+import { resolveConfig } from './config.js';
+import { initializeOtel } from './otel.js';
+import { handleBeforeAgentStart } from './hooks/before-agent-start.js';
+import { handleBeforeToolCall } from './hooks/before-tool-call.js';
+import { handleToolResultPersist } from './hooks/tool-result-persist.js';
+import { handleAgentEnd } from './hooks/agent-end.js';
+import { handleMessageReceived } from './hooks/message-received.js';
+let sdk = null;
+export default function register(api) {
+    const config = resolveConfig(api.config);
+    // Validate token
+    if (!config.token) {
+        api.logger.error('Logfire plugin disabled: LOGFIRE_TOKEN not set. ' +
+            'Export it as an env var or set plugins.entries.logfire.config.token');
+        return;
+    }
+    // Initialize OTEL SDK
+    try {
+        sdk = initializeOtel(config);
+    }
+    catch (err) {
+        api.logger.error(`Logfire plugin init failed: ${err}`);
+        return;
+    }
+    // Register lifecycle hooks
+    api.on('before_agent_start', ((event) => {
+        try {
+            handleBeforeAgentStart(event, config);
+        }
+        catch (err) {
+            api.logger.warn(`Logfire before_agent_start error: ${err}`);
+        }
+    }));
+    api.on('before_tool_call', ((event) => {
+        try {
+            handleBeforeToolCall(event, config);
+        }
+        catch (err) {
+            api.logger.warn(`Logfire before_tool_call error: ${err}`);
+        }
+    }));
+    api.on('tool_result_persist', ((event) => {
+        try {
+            handleToolResultPersist(event, config);
+        }
+        catch (err) {
+            api.logger.warn(`Logfire tool_result_persist error: ${err}`);
+        }
+    }));
+    api.on('agent_end', ((event) => {
+        try {
+            handleAgentEnd(event, config, api.logger);
+        }
+        catch (err) {
+            api.logger.warn(`Logfire agent_end error: ${err}`);
+        }
+    }));
+    api.on('message_received', ((event) => {
+        try {
+            handleMessageReceived(event, config);
+        }
+        catch (err) {
+            api.logger.warn(`Logfire message_received error: ${err}`);
+        }
+    }));
+    // Register service for clean shutdown
+    api.registerService({
+        id: 'logfire-otel',
+        start: () => {
+            const region = config.region === 'eu' ? 'EU' : 'US';
+            api.logger.info(`Logfire: exporting to ${region} (service: ${config.serviceName}, env: ${config.environment})`);
+        },
+        stop: async () => {
+            if (sdk) {
+                await sdk.shutdown();
+                api.logger.info('Logfire: OTEL SDK shut down');
+            }
+        },
+    });
+}
+//# 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/metrics/genai-metrics.d.ts

@@ -0,0 +1,20 @@
+/**
+ * OTEL GenAI semantic convention metrics.
+ *
+ * gen_ai.client.token.usage     — Histogram of token counts
+ * gen_ai.client.operation.duration — Histogram of operation latency
+ *
+ * Bucket boundaries follow the spec recommendations.
+ */
+export interface MetricAttributes {
+    agentName: string;
+    workspace: string;
+    providerName: string;
+    requestModel: string;
+    responseModel: string;
+    hasError: boolean;
+    errorType?: string;
+}
+export declare function recordTokenUsage(tokens: number, tokenType: 'input' | 'output', attrs: MetricAttributes): void;
+export declare function recordOperationDuration(durationSeconds: number, attrs: MetricAttributes): void;
+//# sourceMappingURL=genai-metrics.d.ts.map

package/dist/metrics/genai-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"genai-metrics.d.ts","sourceRoot":"","sources":["../../src/metrics/genai-metrics.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAiCH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,OAAO,GAAG,QAAQ,EAC7B,KAAK,EAAE,gBAAgB,GACtB,IAAI,CAUN;AAED,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,gBAAgB,GACtB,IAAI,CAYN"}

package/dist/metrics/genai-metrics.js

@@ -0,0 +1,56 @@
+// SPDX-License-Identifier: MIT
+/**
+ * OTEL GenAI semantic convention metrics.
+ *
+ * gen_ai.client.token.usage     — Histogram of token counts
+ * gen_ai.client.operation.duration — Histogram of operation latency
+ *
+ * Bucket boundaries follow the spec recommendations.
+ */
+import { metrics } from '@opentelemetry/api';
+const meter = metrics.getMeter('@ultrathink-solutions/openclaw-logfire', '0.1.0');
+/** Spec bucket boundaries for token usage. */
+const TOKEN_BUCKETS = [
+    1, 4, 16, 64, 256, 1024, 4096, 16384, 65536, 262144, 1048576, 4194304,
+    16777216, 67108864,
+];
+/** Spec bucket boundaries for operation duration (seconds). */
+const DURATION_BUCKETS = [
+    0.01, 0.02, 0.04, 0.08, 0.16, 0.32, 0.64, 1.28, 2.56, 5.12, 10.24, 20.48,
+    40.96, 81.92,
+];
+const tokenHistogram = meter.createHistogram('gen_ai.client.token.usage', {
+    description: 'Number of input and output tokens used',
+    unit: '{token}',
+    advice: { explicitBucketBoundaries: TOKEN_BUCKETS },
+});
+const durationHistogram = meter.createHistogram('gen_ai.client.operation.duration', {
+    description: 'GenAI operation duration',
+    unit: 's',
+    advice: { explicitBucketBoundaries: DURATION_BUCKETS },
+});
+export function recordTokenUsage(tokens, tokenType, attrs) {
+    tokenHistogram.record(tokens, {
+        'gen_ai.operation.name': 'invoke_agent',
+        'gen_ai.provider.name': attrs.providerName,
+        'gen_ai.token.type': tokenType,
+        'gen_ai.request.model': attrs.requestModel,
+        'gen_ai.response.model': attrs.responseModel,
+        'openclaw.agent_name': attrs.agentName,
+        'openclaw.workspace': attrs.workspace,
+    });
+}
+export function recordOperationDuration(durationSeconds, attrs) {
+    durationHistogram.record(durationSeconds, {
+        'gen_ai.operation.name': 'invoke_agent',
+        'gen_ai.provider.name': attrs.providerName,
+        'gen_ai.request.model': attrs.requestModel,
+        'gen_ai.response.model': attrs.responseModel,
+        'openclaw.agent_name': attrs.agentName,
+        'openclaw.workspace': attrs.workspace,
+        ...(attrs.hasError && attrs.errorType
+            ? { 'error.type': attrs.errorType }
+            : {}),
+    });
+}
+//# sourceMappingURL=genai-metrics.js.map

package/dist/metrics/genai-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genai-metrics.js","sourceRoot":"","sources":["../../src/metrics/genai-metrics.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,wCAAwC,EAAE,OAAO,CAAC,CAAC;AAElF,8CAA8C;AAC9C,MAAM,aAAa,GAAG;IACpB,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IACrE,QAAQ,EAAE,QAAQ;CACnB,CAAC;AAEF,+DAA+D;AAC/D,MAAM,gBAAgB,GAAG;IACvB,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK;IACxE,KAAK,EAAE,KAAK;CACb,CAAC;AAEF,MAAM,cAAc,GAAG,KAAK,CAAC,eAAe,CAAC,2BAA2B,EAAE;IACxE,WAAW,EAAE,wCAAwC;IACrD,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,EAAE,wBAAwB,EAAE,aAAa,EAAE;CACpD,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,KAAK,CAAC,eAAe,CAC7C,kCAAkC,EAClC;IACE,WAAW,EAAE,0BAA0B;IACvC,IAAI,EAAE,GAAG;IACT,MAAM,EAAE,EAAE,wBAAwB,EAAE,gBAAgB,EAAE;CACvD,CACF,CAAC;AAYF,MAAM,UAAU,gBAAgB,CAC9B,MAAc,EACd,SAA6B,EAC7B,KAAuB;IAEvB,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE;QAC5B,uBAAuB,EAAE,cAAc;QACvC,sBAAsB,EAAE,KAAK,CAAC,YAAY;QAC1C,mBAAmB,EAAE,SAAS;QAC9B,sBAAsB,EAAE,KAAK,CAAC,YAAY;QAC1C,uBAAuB,EAAE,KAAK,CAAC,aAAa;QAC5C,qBAAqB,EAAE,KAAK,CAAC,SAAS;QACtC,oBAAoB,EAAE,KAAK,CAAC,SAAS;KACtC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,eAAuB,EACvB,KAAuB;IAEvB,iBAAiB,CAAC,MAAM,CAAC,eAAe,EAAE;QACxC,uBAAuB,EAAE,cAAc;QACvC,sBAAsB,EAAE,KAAK,CAAC,YAAY;QAC1C,sBAAsB,EAAE,KAAK,CAAC,YAAY;QAC1C,uBAAuB,EAAE,KAAK,CAAC,aAAa;QAC5C,qBAAqB,EAAE,KAAK,CAAC,SAAS;QACtC,oBAAoB,EAAE,KAAK,CAAC,SAAS;QACrC,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,SAAS;YACnC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,SAAS,EAAE;YACnC,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC;AACL,CAAC"}

package/dist/otel.d.ts

@@ -0,0 +1,10 @@
+/**
+ * OpenTelemetry SDK initialization targeting Logfire's OTLP endpoint.
+ *
+ * Logfire accepts traces and metrics over HTTP/protobuf (not gRPC).
+ * Authentication is a write token passed as the Authorization header.
+ */
+import { NodeSDK } from '@opentelemetry/sdk-node';
+import type { LogfirePluginConfig } from './config.js';
+export declare function initializeOtel(config: LogfirePluginConfig): NodeSDK;
+//# sourceMappingURL=otel.d.ts.map

package/dist/otel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../src/otel.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAalD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAOvD,wBAAgB,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CA6DnE"}

package/dist/otel.js

@@ -0,0 +1,70 @@
+// SPDX-License-Identifier: MIT
+/**
+ * OpenTelemetry SDK initialization targeting Logfire's OTLP endpoint.
+ *
+ * Logfire accepts traces and metrics over HTTP/protobuf (not gRPC).
+ * Authentication is a write token passed as the Authorization header.
+ */
+import { NodeSDK } from '@opentelemetry/sdk-node';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-proto';
+import { OTLPMetricExporter } from '@opentelemetry/exporter-metrics-otlp-proto';
+import { PeriodicExportingMetricReader } from '@opentelemetry/sdk-metrics';
+import { BatchSpanProcessor, SimpleSpanProcessor, } from '@opentelemetry/sdk-trace-base';
+import { Resource } from '@opentelemetry/resources';
+import { ATTR_SERVICE_NAME, SEMRESATTRS_DEPLOYMENT_ENVIRONMENT, } from '@opentelemetry/semantic-conventions';
+const LOGFIRE_ENDPOINTS = {
+    us: 'https://logfire-us.pydantic.dev',
+    eu: 'https://logfire-eu.pydantic.dev',
+};
+export function initializeOtel(config) {
+    const token = config.token;
+    if (!token) {
+        throw new Error('@ultrathink-solutions/openclaw-logfire: LOGFIRE_TOKEN is required. ' +
+            'Set it as an environment variable or in plugins.entries.logfire.config.token');
+    }
+    const baseEndpoint = LOGFIRE_ENDPOINTS[config.region] ?? LOGFIRE_ENDPOINTS.us;
+    const authHeaders = { Authorization: `Bearer ${token}` };
+    // Trace exporter
+    const traceExporter = new OTLPTraceExporter({
+        url: `${baseEndpoint}/v1/traces`,
+        headers: authHeaders,
+    });
+    // Resource attributes
+    const resourceAttrs = {
+        [ATTR_SERVICE_NAME]: config.serviceName,
+        [SEMRESATTRS_DEPLOYMENT_ENVIRONMENT]: config.environment,
+        ...config.resourceAttributes,
+    };
+    if (config.projectUrl) {
+        resourceAttrs['logfire.project_url'] = config.projectUrl;
+    }
+    const resource = new Resource(resourceAttrs);
+    // Span processor
+    const spanProcessor = config.spanProcessorType === 'simple'
+        ? new SimpleSpanProcessor(traceExporter)
+        : new BatchSpanProcessor(traceExporter, {
+            maxQueueSize: config.batchConfig.maxQueueSize,
+            maxExportBatchSize: config.batchConfig.maxExportBatchSize,
+            scheduledDelayMillis: config.batchConfig.scheduledDelayMs,
+        });
+    // SDK config
+    const sdkConfig = {
+        resource,
+        spanProcessors: [spanProcessor],
+    };
+    // Metrics exporter (optional)
+    if (config.enableMetrics) {
+        const metricExporter = new OTLPMetricExporter({
+            url: `${baseEndpoint}/v1/metrics`,
+            headers: authHeaders,
+        });
+        sdkConfig.metricReader = new PeriodicExportingMetricReader({
+            exporter: metricExporter,
+            exportIntervalMillis: config.metricsIntervalMs,
+        });
+    }
+    const sdk = new NodeSDK(sdkConfig);
+    sdk.start();
+    return sdk;
+}
+//# sourceMappingURL=otel.js.map

package/dist/otel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.js","sourceRoot":"","sources":["../src/otel.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAChF,OAAO,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EACL,iBAAiB,EACjB,kCAAkC,GACnC,MAAM,qCAAqC,CAAC;AAG7C,MAAM,iBAAiB,GAA2B;IAChD,EAAE,EAAE,iCAAiC;IACrC,EAAE,EAAE,iCAAiC;CACtC,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,MAA2B;IACxD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,qEAAqE;YACnE,8EAA8E,CACjF,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,iBAAiB,CAAC,EAAE,CAAC;IAC9E,MAAM,WAAW,GAAG,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE,CAAC;IAEzD,iBAAiB;IACjB,MAAM,aAAa,GAAG,IAAI,iBAAiB,CAAC;QAC1C,GAAG,EAAE,GAAG,YAAY,YAAY;QAChC,OAAO,EAAE,WAAW;KACrB,CAAC,CAAC;IAEH,sBAAsB;IACtB,MAAM,aAAa,GAA2B;QAC5C,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC,WAAW;QACvC,CAAC,kCAAkC,CAAC,EAAE,MAAM,CAAC,WAAW;QACxD,GAAG,MAAM,CAAC,kBAAkB;KAC7B,CAAC;IACF,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,aAAa,CAAC,qBAAqB,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC;IAC3D,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,aAAa,CAAC,CAAC;IAE7C,iBAAiB;IACjB,MAAM,aAAa,GACjB,MAAM,CAAC,iBAAiB,KAAK,QAAQ;QACnC,CAAC,CAAC,IAAI,mBAAmB,CAAC,aAAa,CAAC;QACxC,CAAC,CAAC,IAAI,kBAAkB,CAAC,aAAa,EAAE;YACpC,YAAY,EAAE,MAAM,CAAC,WAAW,CAAC,YAAY;YAC7C,kBAAkB,EAAE,MAAM,CAAC,WAAW,CAAC,kBAAkB;YACzD,oBAAoB,EAAE,MAAM,CAAC,WAAW,CAAC,gBAAgB;SAC1D,CAAC,CAAC;IAET,aAAa;IACb,MAAM,SAAS,GAA6C;QAC1D,QAAQ;QACR,cAAc,EAAE,CAAC,aAAa,CAAC;KAChC,CAAC;IAEF,8BAA8B;IAC9B,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACzB,MAAM,cAAc,GAAG,IAAI,kBAAkB,CAAC;YAC5C,GAAG,EAAE,GAAG,YAAY,aAAa;YACjC,OAAO,EAAE,WAAW;SACrB,CAAC,CAAC;QACH,SAAS,CAAC,YAAY,GAAG,IAAI,6BAA6B,CAAC;YACzD,QAAQ,EAAE,cAAc;YACxB,oBAAoB,EAAE,MAAM,CAAC,iBAAiB;SAC/C,CAAC,CAAC;IACL,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IACnC,GAAG,CAAC,KAAK,EAAE,CAAC;IACZ,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/trace-link.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Build clickable Logfire trace URLs.
+ *
+ * Format: {projectUrl}/explore?traceId={traceId}
+ */
+export declare function buildLogfireTraceUrl(projectUrl: string, traceId: string, spanId?: string): string;
+//# sourceMappingURL=trace-link.d.ts.map

package/dist/trace-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-link.d.ts","sourceRoot":"","sources":["../src/trace-link.ts"],"names":[],"mappings":"AACA;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAKR"}

package/dist/trace-link.js

@@ -0,0 +1,14 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Build clickable Logfire trace URLs.
+ *
+ * Format: {projectUrl}/explore?traceId={traceId}
+ */
+export function buildLogfireTraceUrl(projectUrl, traceId, spanId) {
+    const base = projectUrl.replace(/\/$/, '');
+    const params = new URLSearchParams({ traceId });
+    if (spanId)
+        params.set('spanId', spanId);
+    return `${base}/explore?${params.toString()}`;
+}
+//# sourceMappingURL=trace-link.js.map

package/dist/trace-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-link.js","sourceRoot":"","sources":["../src/trace-link.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAkB,EAClB,OAAe,EACf,MAAe;IAEf,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAChD,IAAI,MAAM;QAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzC,OAAO,GAAG,IAAI,YAAY,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;AAChD,CAAC"}

package/dist/util.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Shared utilities: safe JSON serialization, truncation, secret redaction.
+ */
+/**
+ * Serialize a value to JSON, handling circular refs and BigInts.
+ * Returns an empty string on failure rather than throwing.
+ */
+export declare function safeJsonStringify(value: unknown): string;
+/** Truncate a string to maxLength, appending "...[truncated]" if needed. */
+export declare function truncate(value: string, maxLength: number): string;
+/** Redact likely secrets from a string. */
+export declare function redactSecrets(value: string): string;
+/**
+ * Prepare a tool input/output value for recording as a span attribute.
+ * Serializes to JSON, optionally redacts secrets, and truncates.
+ */
+export declare function prepareForCapture(value: unknown, maxLength: number, redact: boolean): string;
+/**
+ * Extract workspace name from a workspace directory path.
+ * e.g., "/path/to/workspaces/chief-of-staff" -> "chief-of-staff"
+ */
+export declare function extractWorkspaceName(workspaceDir: string | undefined): string;
+/**
+ * Generate a short unique ID for tool call correlation.
+ * Uses timestamp + random suffix to avoid collisions without
+ * pulling in a uuid dependency.
+ */
+export declare function generateCallId(): string;
+/**
+ * Extract error details in a structured format suitable for OTEL
+ * exception semantic conventions.
+ */
+export declare function extractErrorDetails(error: unknown): {
+    type: string;
+    message: string;
+    stacktrace: string;
+};
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AACA;;GAEG;AASH;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAcxD;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGjE;AAED,2CAA2C;AAC3C,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAenD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,GACd,MAAM,CAMR;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI7E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAIvC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAgBA"}

package/dist/util.js

@@ -0,0 +1,108 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Shared utilities: safe JSON serialization, truncation, secret redaction.
+ */
+/** Patterns that likely indicate secret values. */
+const SECRET_PATTERNS = [
+    /(?:api[_-]?key|token|secret|password|auth|credential|bearer)\s*[:=]\s*["']?[^\s"',}{]{8,}/gi,
+    /(?:sk|pk|rk|pat|ghp|gho|glpat|xox[bpras])[_-][A-Za-z0-9_-]{10,}/g,
+    /eyJ[A-Za-z0-9_-]{20,}\.[A-Za-z0-9_-]{20,}/g, // JWT
+];
+/**
+ * Serialize a value to JSON, handling circular refs and BigInts.
+ * Returns an empty string on failure rather than throwing.
+ */
+export function safeJsonStringify(value) {
+    const seen = new WeakSet();
+    try {
+        return JSON.stringify(value, (_key, val) => {
+            if (typeof val === 'bigint')
+                return val.toString();
+            if (typeof val === 'object' && val !== null) {
+                if (seen.has(val))
+                    return '[Circular]';
+                seen.add(val);
+            }
+            return val;
+        });
+    }
+    catch {
+        return String(value);
+    }
+}
+/** Truncate a string to maxLength, appending "...[truncated]" if needed. */
+export function truncate(value, maxLength) {
+    if (value.length <= maxLength)
+        return value;
+    return value.slice(0, maxLength) + '...[truncated]';
+}
+/** Redact likely secrets from a string. */
+export function redactSecrets(value) {
+    let result = value;
+    for (const pattern of SECRET_PATTERNS) {
+        // Reset lastIndex for global regexes
+        pattern.lastIndex = 0;
+        result = result.replace(pattern, (match) => {
+            // Keep the key name, redact the value portion
+            const eqIdx = match.search(/[:=]/);
+            if (eqIdx !== -1) {
+                return match.slice(0, eqIdx + 1) + ' [REDACTED]';
+            }
+            return '[REDACTED]';
+        });
+    }
+    return result;
+}
+/**
+ * Prepare a tool input/output value for recording as a span attribute.
+ * Serializes to JSON, optionally redacts secrets, and truncates.
+ */
+export function prepareForCapture(value, maxLength, redact) {
+    let str = typeof value === 'string' ? value : safeJsonStringify(value);
+    if (redact) {
+        str = redactSecrets(str);
+    }
+    return truncate(str, maxLength);
+}
+/**
+ * Extract workspace name from a workspace directory path.
+ * e.g., "/path/to/workspaces/chief-of-staff" -> "chief-of-staff"
+ */
+export function extractWorkspaceName(workspaceDir) {
+    if (!workspaceDir)
+        return 'unknown';
+    const parts = workspaceDir.replace(/\/$/, '').split('/');
+    return parts[parts.length - 1] || 'unknown';
+}
+/**
+ * Generate a short unique ID for tool call correlation.
+ * Uses timestamp + random suffix to avoid collisions without
+ * pulling in a uuid dependency.
+ */
+export function generateCallId() {
+    const ts = Date.now().toString(36);
+    const rand = Math.random().toString(36).slice(2, 8);
+    return `${ts}-${rand}`;
+}
+/**
+ * Extract error details in a structured format suitable for OTEL
+ * exception semantic conventions.
+ */
+export function extractErrorDetails(error) {
+    if (error instanceof Error) {
+        return {
+            type: error.constructor.name || 'Error',
+            message: error.message,
+            stacktrace: error.stack ?? '',
+        };
+    }
+    if (typeof error === 'string') {
+        return { type: 'Error', message: error, stacktrace: '' };
+    }
+    return {
+        type: 'Error',
+        message: safeJsonStringify(error),
+        stacktrace: '',
+    };
+}
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

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

package/openclaw.plugin.json

@@ -0,0 +1,174 @@
+{
+  "id": "logfire",
+  "kind": "observability",
+  "configSchema": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "token": {
+        "type": "string",
+        "description": "Logfire write token. Falls back to LOGFIRE_TOKEN env var."
+      },
+      "projectUrl": {
+        "type": "string",
+        "description": "Logfire project URL for clickable trace links."
+      },
+      "region": {
+        "type": "string",
+        "enum": ["us", "eu"],
+        "default": "us",
+        "description": "Logfire region (US or EU endpoint)."
+      },
+      "environment": {
+        "type": "string",
+        "default": "development",
+        "description": "Deployment environment label."
+      },
+      "serviceName": {
+        "type": "string",
+        "default": "openclaw-agent",
+        "description": "OTEL service name for resource identification."
+      },
+      "providerName": {
+        "type": "string",
+        "description": "GenAI provider name (e.g. 'anthropic', 'openai')."
+      },
+      "captureToolInput": {
+        "type": "boolean",
+        "default": true,
+        "description": "Record tool call arguments as span attributes."
+      },
+      "captureToolOutput": {
+        "type": "boolean",
+        "default": false,
+        "description": "Record tool results as span attributes (verbose)."
+      },
+      "toolInputMaxLength": {
+        "type": "integer",
+        "default": 2048,
+        "description": "Max character length for captured tool input."
+      },
+      "toolOutputMaxLength": {
+        "type": "integer",
+        "default": 512,
+        "description": "Max character length for captured tool output."
+      },
+      "captureStackTraces": {
+        "type": "boolean",
+        "default": true,
+        "description": "Include stack traces in error spans."
+      },
+      "captureMessageContent": {
+        "type": "boolean",
+        "default": false,
+        "description": "Record message text (privacy-sensitive)."
+      },
+      "captureToolDefinitions": {
+        "type": "boolean",
+        "default": false,
+        "description": "Record tool schemas in inference events."
+      },
+      "captureInferenceEvents": {
+        "type": "boolean",
+        "default": false,
+        "description": "Emit gen_ai.client.inference.operation.details events."
+      },
+      "redactSecrets": {
+        "type": "boolean",
+        "default": true,
+        "description": "Strip API keys, tokens, and JWTs from recorded data."
+      },
+      "distributedTracing": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "default": false,
+            "description": "Enable W3C traceparent injection/extraction."
+          },
+          "injectIntoCommands": {
+            "type": "boolean",
+            "default": true,
+            "description": "Inject traceparent into curl/wget/httpie commands."
+          },
+          "extractFromWebhooks": {
+            "type": "boolean",
+            "default": true,
+            "description": "Extract traceparent from inbound webhook headers."
+          },
+          "urlPatterns": {
+            "type": "array",
+            "items": { "type": "string" },
+            "default": ["*"],
+            "description": "Glob patterns for URLs to inject traceparent into."
+          }
+        }
+      },
+      "enableMetrics": {
+        "type": "boolean",
+        "default": true,
+        "description": "Emit token usage and operation duration histograms."
+      },
+      "metricsIntervalMs": {
+        "type": "integer",
+        "default": 60000,
+        "description": "Metrics export interval in milliseconds."
+      },
+      "enableTraceLinks": {
+        "type": "boolean",
+        "default": true,
+        "description": "Log clickable Logfire trace URLs."
+      },
+      "logLevel": {
+        "type": "string",
+        "enum": ["debug", "info", "warn", "error"],
+        "default": "info",
+        "description": "Plugin log verbosity."
+      },
+      "resourceAttributes": {
+        "type": "object",
+        "additionalProperties": { "type": "string" },
+        "description": "Additional OTEL resource attributes."
+      },
+      "spanProcessorType": {
+        "type": "string",
+        "enum": ["batch", "simple"],
+        "default": "batch",
+        "description": "Span processor type. Use 'simple' for debugging."
+      },
+      "batchConfig": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "maxQueueSize": { "type": "integer", "default": 2048 },
+          "maxExportBatchSize": { "type": "integer", "default": 512 },
+          "scheduledDelayMs": { "type": "integer", "default": 5000 }
+        }
+      }
+    }
+  },
+  "uiHints": {
+    "token": {
+      "label": "Write Token",
+      "placeholder": "Set via LOGFIRE_TOKEN env var",
+      "sensitive": true
+    },
+    "projectUrl": {
+      "label": "Project URL",
+      "placeholder": "https://logfire.pydantic.dev/org/project"
+    },
+    "region": {
+      "label": "Region"
+    },
+    "environment": {
+      "label": "Environment",
+      "placeholder": "production"
+    },
+    "serviceName": {
+      "label": "Service Name",
+      "placeholder": "openclaw-agent"
+    }
+  }
+}