observability-toolkit 2.0.0 → 2.1.0

package/dist/tools/ingest-spans.d.ts

@@ -0,0 +1,45 @@
+/**
+ * obs_ingest_spans — Push synthesized OTel spans to the cloud backend.
+ *
+ * Accepts a batch of spans as JSON, constructs an OTLP protobuf payload,
+ * and POSTs to the ingest worker at OBTOOL_INGEST_URL.
+ */
+import { z } from 'zod';
+export declare const ingestSpansSchema: z.ZodObject<{
+    spans: z.ZodArray<z.ZodObject<{
+        traceId: z.ZodString;
+        spanId: z.ZodString;
+        parentSpanId: z.ZodOptional<z.ZodString>;
+        operationName: z.ZodString;
+        startTimeNs: z.ZodString;
+        endTimeNs: z.ZodString;
+        attributes: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+    }, z.core.$strip>>;
+    backend: z.ZodDefault<z.ZodEnum<{
+        cloud: "cloud";
+        local: "local";
+    }>>;
+}, z.core.$strip>;
+export type IngestSpansInput = z.infer<typeof ingestSpansSchema>;
+export declare function ingestSpans(input: IngestSpansInput): Promise<unknown>;
+export declare const ingestSpansTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        spans: z.ZodArray<z.ZodObject<{
+            traceId: z.ZodString;
+            spanId: z.ZodString;
+            parentSpanId: z.ZodOptional<z.ZodString>;
+            operationName: z.ZodString;
+            startTimeNs: z.ZodString;
+            endTimeNs: z.ZodString;
+            attributes: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        }, z.core.$strip>>;
+        backend: z.ZodDefault<z.ZodEnum<{
+            cloud: "cloud";
+            local: "local";
+        }>>;
+    }, z.core.$strip>;
+    handler: typeof ingestSpans;
+};
+//# sourceMappingURL=ingest-spans.d.ts.map

package/dist/tools/ingest-spans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest-spans.d.ts","sourceRoot":"","sources":["../../src/tools/ingest-spans.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA6BxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;iBAG5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAgFjE,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAiB3E;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;CAK3B,CAAC"}

package/dist/tools/ingest-spans.js

@@ -0,0 +1,129 @@
+/**
+ * obs_ingest_spans — Push synthesized OTel spans to the cloud backend.
+ *
+ * Accepts a batch of spans as JSON, constructs an OTLP protobuf payload,
+ * and POSTs to the ingest worker at OBTOOL_INGEST_URL.
+ */
+import { z } from 'zod';
+import { encodeTracesProtobuf } from '../lib/exports/otlp-proto-encode.js';
+import { OBTOOL_INGEST_URL, getApiKey, HOOKS_TELEMETRY_DIR, ISO_DATE_LENGTH } from '../lib/core/constants.js';
+import { BYTES } from '../lib/core/units.js';
+import { mkdir, appendFile } from 'fs/promises';
+import { join } from 'path';
+import { INGEST_TIMEOUT_MS } from './ingest-constants.js';
+import { TraceIdSchema, SpanIdSchema } from '../lib/core/shared-schemas.js';
+const MAX_SPANS = 100;
+const MAX_OPERATION_NAME_LENGTH = 200;
+const MAX_ATTRIBUTE_STRING_LENGTH = BYTES.KB;
+/** OTLP span kind and status code constants */
+const SPAN_KIND_INTERNAL = 1;
+const STATUS_CODE_OK = 1;
+const spanSchema = z.object({
+    traceId: TraceIdSchema,
+    spanId: SpanIdSchema,
+    parentSpanId: SpanIdSchema.optional(),
+    operationName: z.string().min(1).max(MAX_OPERATION_NAME_LENGTH),
+    startTimeNs: z.string().regex(/^\d+$/, 'Must be numeric nanosecond timestamp'),
+    endTimeNs: z.string().regex(/^\d+$/, 'Must be numeric nanosecond timestamp'),
+    attributes: z.record(z.string(), z.union([z.string().max(MAX_ATTRIBUTE_STRING_LENGTH), z.number(), z.boolean()])),
+});
+export const ingestSpansSchema = z.object({
+    spans: z.array(spanSchema).min(1).max(MAX_SPANS),
+    backend: z.enum(['cloud', 'local']).default('cloud'),
+});
+function toOTLPKeyValues(attrs) {
+    return Object.entries(attrs).map(([key, val]) => ({
+        key,
+        value: typeof val === 'string' ? { stringValue: val }
+            : typeof val === 'number' ? (Number.isInteger(val) ? { intValue: String(val) } : { doubleValue: val })
+                : { boolValue: val },
+    }));
+}
+function buildOTLPExport(input) {
+    return {
+        resourceSpans: [{
+                resource: {
+                    attributes: [
+                        { key: 'service.name', value: { stringValue: 'claude-hooks' } },
+                        { key: 'service.version', value: { stringValue: '1.0.0' } },
+                    ],
+                },
+                scopeSpans: [{
+                        scope: { name: 'obs_ingest_spans', version: '1.0.0' },
+                        spans: input.spans.map(s => ({
+                            traceId: s.traceId,
+                            spanId: s.spanId,
+                            ...(s.parentSpanId ? { parentSpanId: s.parentSpanId } : {}),
+                            name: s.operationName,
+                            kind: SPAN_KIND_INTERNAL,
+                            startTimeUnixNano: s.startTimeNs,
+                            endTimeUnixNano: s.endTimeNs,
+                            status: { code: STATUS_CODE_OK },
+                            attributes: toOTLPKeyValues(s.attributes),
+                        })),
+                    }],
+            }],
+    };
+}
+async function postToIngest(binary) {
+    if (!OBTOOL_INGEST_URL) {
+        return { ok: false, status: 0, message: 'OBTOOL_INGEST_URL not configured' };
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), INGEST_TIMEOUT_MS);
+    try {
+        const res = await fetch(`${OBTOOL_INGEST_URL}/v1/traces`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/x-protobuf',
+                ...(getApiKey() ? { Authorization: `Bearer ${getApiKey()}` } : {}),
+            },
+            body: binary,
+            signal: controller.signal,
+        });
+        return { ok: res.ok, status: res.status, message: res.ok ? 'accepted' : await res.text() };
+    }
+    catch (err) {
+        return { ok: false, status: 0, message: err instanceof Error ? err.message : 'unknown error' };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function writeToLocal(input) {
+    try {
+        const dir = HOOKS_TELEMETRY_DIR;
+        await mkdir(dir, { recursive: true });
+        const date = new Date().toISOString().slice(0, ISO_DATE_LENGTH);
+        const filePath = join(dir, `synth-spans-${date}.jsonl`);
+        const lines = input.spans.map(s => JSON.stringify(s)).join('\n') + '\n';
+        await appendFile(filePath, lines);
+        return { ok: true, path: filePath };
+    }
+    catch (err) {
+        return { ok: false, path: '', error: err instanceof Error ? err.message : String(err) };
+    }
+}
+export async function ingestSpans(input) {
+    const otlpExport = buildOTLPExport(input);
+    const binary = encodeTracesProtobuf(otlpExport);
+    if (input.backend === 'cloud') {
+        const result = await postToIngest(binary);
+        if (result.ok) {
+            return { backend: 'cloud', spans: input.spans.length, status: result.status };
+        }
+        return { backend: 'cloud', error: result.message, status: result.status };
+    }
+    const local = await writeToLocal(input);
+    if (!local.ok) {
+        return { backend: 'local', error: local.error };
+    }
+    return { backend: 'local', spans: input.spans.length, path: local.path };
+}
+export const ingestSpansTool = {
+    name: 'obs_ingest_spans',
+    description: 'Push synthesized OTel spans to the cloud backend (OTLP protobuf) or local JSONL. Use for injecting agent lifecycle spans (create_agent, invoke_agent, execute_tool) or custom instrumentation.',
+    inputSchema: ingestSpansSchema,
+    handler: ingestSpans,
+};
+//# sourceMappingURL=ingest-spans.js.map

package/dist/tools/ingest-spans.js.map

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

package/dist/tools/ingest-spans.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for ingest-spans tool
+ */
+export {};
+//# sourceMappingURL=ingest-spans.test.d.ts.map

package/dist/tools/ingest-spans.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest-spans.test.d.ts","sourceRoot":"","sources":["../../src/tools/ingest-spans.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/tools/ingest-spans.test.js

@@ -0,0 +1,250 @@
+/**
+ * Unit tests for ingest-spans tool
+ */
+import { describe, it, beforeEach, afterEach, vi } from 'vitest';
+import assert from 'node:assert';
+import { ingestSpans, ingestSpansSchema } from './ingest-spans.js';
+import { generateHexId } from '../lib/exports/export-utils.js';
+import { OTLP_SPAN_ID_LENGTH, OTLP_TRACE_ID_LENGTH } from '../lib/core/constants.js';
+import { NANOSECONDS_PER_MILLISECOND_BIGINT } from '../lib/core/units.js';
+const VALID_TRACE_ID = generateHexId(OTLP_TRACE_ID_LENGTH);
+const VALID_SPAN_ID = generateHexId(OTLP_SPAN_ID_LENGTH);
+const NOW_NS = String(BigInt(Date.now()) * NANOSECONDS_PER_MILLISECOND_BIGINT);
+const END_NS = String(BigInt(NOW_NS) + NANOSECONDS_PER_MILLISECOND_BIGINT);
+describe('ingestSpans', () => {
+    let prevIngestUrl;
+    let prevApiKey;
+    beforeEach(() => {
+        prevIngestUrl = process.env.OBTOOL_INGEST_URL;
+        prevApiKey = process.env.OBTOOL_API_KEY;
+        delete process.env.OBTOOL_INGEST_URL;
+        delete process.env.OBTOOL_API_KEY;
+    });
+    afterEach(() => {
+        if (prevIngestUrl === undefined)
+            delete process.env.OBTOOL_INGEST_URL;
+        else
+            process.env.OBTOOL_INGEST_URL = prevIngestUrl;
+        if (prevApiKey === undefined)
+            delete process.env.OBTOOL_API_KEY;
+        else
+            process.env.OBTOOL_API_KEY = prevApiKey;
+        vi.restoreAllMocks();
+    });
+    describe('schema validation', () => {
+        it('accepts valid span with required fields', () => {
+            const result = ingestSpansSchema.safeParse({
+                spans: [{
+                        traceId: VALID_TRACE_ID,
+                        spanId: VALID_SPAN_ID,
+                        operationName: 'test.operation',
+                        startTimeNs: NOW_NS,
+                        endTimeNs: END_NS,
+                        attributes: { 'test.key': 'value' },
+                    }],
+            });
+            assert.ok(result.success);
+        });
+        it('accepts span with optional parentSpanId', () => {
+            const parentId = generateHexId(OTLP_SPAN_ID_LENGTH);
+            const result = ingestSpansSchema.safeParse({
+                spans: [{
+                        traceId: VALID_TRACE_ID,
+                        spanId: VALID_SPAN_ID,
+                        parentSpanId: parentId,
+                        operationName: 'test.operation',
+                        startTimeNs: NOW_NS,
+                        endTimeNs: END_NS,
+                        attributes: {},
+                    }],
+            });
+            assert.ok(result.success);
+        });
+        it('rejects invalid traceId (not 32-char hex)', () => {
+            const result = ingestSpansSchema.safeParse({
+                spans: [{
+                        traceId: 'invalid-trace-id',
+                        spanId: VALID_SPAN_ID,
+                        operationName: 'test.operation',
+                        startTimeNs: NOW_NS,
+                        endTimeNs: END_NS,
+                        attributes: {},
+                    }],
+            });
+            assert.ok(!result.success);
+        });
+        it('rejects invalid spanId (not 16-char hex)', () => {
+            const result = ingestSpansSchema.safeParse({
+                spans: [{
+                        traceId: VALID_TRACE_ID,
+                        spanId: 'invalid-span-id',
+                        operationName: 'test.operation',
+                        startTimeNs: NOW_NS,
+                        endTimeNs: END_NS,
+                        attributes: {},
+                    }],
+            });
+            assert.ok(!result.success);
+        });
+        it('rejects empty operationName', () => {
+            const result = ingestSpansSchema.safeParse({
+                spans: [{
+                        traceId: VALID_TRACE_ID,
+                        spanId: VALID_SPAN_ID,
+                        operationName: '',
+                        startTimeNs: NOW_NS,
+                        endTimeNs: END_NS,
+                        attributes: {},
+                    }],
+            });
+            assert.ok(!result.success);
+        });
+        it('rejects non-numeric timestamps', () => {
+            const result = ingestSpansSchema.safeParse({
+                spans: [{
+                        traceId: VALID_TRACE_ID,
+                        spanId: VALID_SPAN_ID,
+                        operationName: 'test.operation',
+                        startTimeNs: 'not-a-number',
+                        endTimeNs: END_NS,
+                        attributes: {},
+                    }],
+            });
+            assert.ok(!result.success);
+        });
+        it('rejects empty spans array', () => {
+            const result = ingestSpansSchema.safeParse({ spans: [] });
+            assert.ok(!result.success);
+        });
+        it('rejects more than 100 spans', () => {
+            const spans = Array(101).fill({
+                traceId: VALID_TRACE_ID,
+                spanId: VALID_SPAN_ID,
+                operationName: 'test.operation',
+                startTimeNs: NOW_NS,
+                endTimeNs: END_NS,
+                attributes: {},
+            });
+            const result = ingestSpansSchema.safeParse({ spans });
+            assert.ok(!result.success);
+        });
+        it('defaults backend to cloud', () => {
+            const result = ingestSpansSchema.safeParse({
+                spans: [{
+                        traceId: VALID_TRACE_ID,
+                        spanId: VALID_SPAN_ID,
+                        operationName: 'test.operation',
+                        startTimeNs: NOW_NS,
+                        endTimeNs: END_NS,
+                        attributes: {},
+                    }],
+            });
+            assert.ok(result.success);
+            assert.strictEqual(result.data.backend, 'cloud');
+        });
+        it('accepts numeric and boolean attributes', () => {
+            const result = ingestSpansSchema.safeParse({
+                spans: [{
+                        traceId: VALID_TRACE_ID,
+                        spanId: VALID_SPAN_ID,
+                        operationName: 'test.operation',
+                        startTimeNs: NOW_NS,
+                        endTimeNs: END_NS,
+                        attributes: {
+                            'string.attr': 'value',
+                            'number.attr': 42,
+                            'float.attr': 3.14,
+                            'bool.attr': true,
+                        },
+                    }],
+            });
+            assert.ok(result.success);
+        });
+    });
+    describe('backend selection', () => {
+        it('uses local backend when backend=local', async () => {
+            const result = await ingestSpans({
+                backend: 'local',
+                spans: [{
+                        traceId: VALID_TRACE_ID,
+                        spanId: VALID_SPAN_ID,
+                        operationName: 'test.operation',
+                        startTimeNs: NOW_NS,
+                        endTimeNs: END_NS,
+                        attributes: {},
+                    }],
+            });
+            assert.ok(result && typeof result === 'object');
+            assert.strictEqual(result.backend, 'local');
+            assert.ok(result.spans);
+        });
+        it('cloud backend returns error message on failure', async () => {
+            const result = await ingestSpans({
+                backend: 'cloud',
+                spans: [{
+                        traceId: VALID_TRACE_ID,
+                        spanId: VALID_SPAN_ID,
+                        operationName: 'test.operation',
+                        startTimeNs: NOW_NS,
+                        endTimeNs: END_NS,
+                        attributes: {},
+                    }],
+            });
+            assert.ok(result && typeof result === 'object');
+            assert.strictEqual(result.backend, 'cloud');
+            assert.ok(result.error || result.status);
+        });
+    });
+    describe('attribute handling', () => {
+        it('handles multiple span attributes', async () => {
+            const result = await ingestSpans({
+                backend: 'local',
+                spans: [{
+                        traceId: VALID_TRACE_ID,
+                        spanId: VALID_SPAN_ID,
+                        operationName: 'test.operation',
+                        startTimeNs: NOW_NS,
+                        endTimeNs: END_NS,
+                        attributes: {
+                            'service.name': 'test-service',
+                            'span.kind': 'internal',
+                            'request.id': '12345',
+                            'duration.ms': 100,
+                            'success': true,
+                        },
+                    }],
+            });
+            assert.ok(result && typeof result === 'object');
+            assert.strictEqual(result.spans, 1);
+        });
+        it('handles empty attributes object', async () => {
+            const result = await ingestSpans({
+                backend: 'local',
+                spans: [{
+                        traceId: VALID_TRACE_ID,
+                        spanId: VALID_SPAN_ID,
+                        operationName: 'test.operation',
+                        startTimeNs: NOW_NS,
+                        endTimeNs: END_NS,
+                        attributes: {},
+                    }],
+            });
+            assert.ok(result && typeof result === 'object');
+            assert.strictEqual(result.spans, 1);
+        });
+    });
+    describe('import regression checks', () => {
+        it('has correct exports', () => {
+            assert.ok(typeof ingestSpans === 'function');
+            assert.ok(ingestSpansSchema);
+        });
+        it('can import from correct modules', async () => {
+            // Verify that we can import the utilities needed by ingest-spans
+            const { OTLP_SPAN_ID_LENGTH: spanIdLen } = await import('../lib/core/constants.js');
+            const { NANOSECONDS_PER_MILLISECOND_BIGINT: nsPerMs } = await import('../lib/core/units.js');
+            assert.ok(typeof spanIdLen === 'number');
+            assert.ok(typeof nsPerMs === 'bigint');
+        });
+    });
+});
+//# sourceMappingURL=ingest-spans.test.js.map

package/dist/tools/ingest-spans.test.js.map

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

package/dist/tools/ingest-traces.d.ts

@@ -0,0 +1,76 @@
+/**
+ * obs_ingest_traces — Push complete OTel traces to the cloud backend.
+ *
+ * Accepts resourceSpans with service metadata and grouped spans,
+ * encodes as OTLP protobuf, and POSTs to the ingest worker.
+ * Mirrors obs_ingest_spans but operates at the trace (resourceSpans) level.
+ */
+import { z } from 'zod';
+export declare const ingestTracesSchema: z.ZodObject<{
+    resourceSpans: z.ZodArray<z.ZodObject<{
+        resource: z.ZodDefault<z.ZodObject<{
+            attributes: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        }, z.core.$strip>>;
+        serviceName: z.ZodDefault<z.ZodString>;
+        scopeSpans: z.ZodArray<z.ZodObject<{
+            scope: z.ZodOptional<z.ZodObject<{
+                name: z.ZodString;
+                version: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            spans: z.ZodArray<z.ZodObject<{
+                traceId: z.ZodString;
+                spanId: z.ZodString;
+                parentSpanId: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
+                kind: z.ZodDefault<z.ZodInt>;
+                startTimeNs: z.ZodString;
+                endTimeNs: z.ZodString;
+                statusCode: z.ZodDefault<z.ZodInt>;
+                statusMessage: z.ZodOptional<z.ZodString>;
+                attributes: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    backend: z.ZodDefault<z.ZodEnum<{
+        cloud: "cloud";
+        local: "local";
+    }>>;
+}, z.core.$strip>;
+export type IngestTracesInput = z.infer<typeof ingestTracesSchema>;
+export declare function ingestTraces(input: IngestTracesInput): Promise<unknown>;
+export declare const ingestTracesTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        resourceSpans: z.ZodArray<z.ZodObject<{
+            resource: z.ZodDefault<z.ZodObject<{
+                attributes: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            }, z.core.$strip>>;
+            serviceName: z.ZodDefault<z.ZodString>;
+            scopeSpans: z.ZodArray<z.ZodObject<{
+                scope: z.ZodOptional<z.ZodObject<{
+                    name: z.ZodString;
+                    version: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                spans: z.ZodArray<z.ZodObject<{
+                    traceId: z.ZodString;
+                    spanId: z.ZodString;
+                    parentSpanId: z.ZodOptional<z.ZodString>;
+                    name: z.ZodString;
+                    kind: z.ZodDefault<z.ZodInt>;
+                    startTimeNs: z.ZodString;
+                    endTimeNs: z.ZodString;
+                    statusCode: z.ZodDefault<z.ZodInt>;
+                    statusMessage: z.ZodOptional<z.ZodString>;
+                    attributes: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        backend: z.ZodDefault<z.ZodEnum<{
+            cloud: "cloud";
+            local: "local";
+        }>>;
+    }, z.core.$strip>;
+    handler: typeof ingestTraces;
+};
+//# sourceMappingURL=ingest-traces.d.ts.map

package/dist/tools/ingest-traces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest-traces.d.ts","sourceRoot":"","sources":["../../src/tools/ingest-traces.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuDxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG7B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAgGnE,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAkB7E;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAK5B,CAAC"}