@armoriq/sdk-dev 0.8.0 → 0.8.3

package/dist/observability/recorder.js

@@ -1,475 +0,0 @@
-"use strict";
-/**
- * ObservabilityRecorder — in-memory ring buffer for traces + spans.
- *
- * The recorder is the only place in the SDK that mints trace/span IDs. The
- * session chokepoints (peer subagent's wrap) call `startTrace` /
- * `recordPolicyCall` / `endTrace` and the recorder takes care of:
- *   1. Validating each emit (cheap shape checks; bad data is logged + dropped,
- *      never thrown into the SDK consumer).
- *   2. Minting IDs and computing endTime/durationMs.
- *   3. Holding the in-memory ring buffer (default 1000 traces). On overflow,
- *      the oldest trace AND all its spans are dropped (we never want a partial
- *      trace at the backend).
- *   4. Pushing ended traces onto the shipper's queue.
- *   5. Forwarding every emit to the test sink (if set) so tests can assert
- *      on the exact lifecycle.
- *
- * Per plan §9 Q3: in-memory only. `durable: true` is parsed and stored but
- * does nothing in v1 — a one-time warning is logged the first time a
- * consumer opts in.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ObservabilityRecorder = void 0;
-exports.__setObservabilitySinkForTests = __setObservabilitySinkForTests;
-const shipper_1 = require("./shipper");
-const schema_1 = require("./schema");
-const model_prices_1 = require("./model-prices");
-const trace_summary_1 = require("./trace-summary");
-const DEFAULT_MAX_BUFFER = 1000;
-const DEFAULT_FLUSH_INTERVAL_MS = 5000;
-const DEFAULT_BATCH_SIZE = 100;
-let currentSink = null;
-function __setObservabilitySinkForTests(sink) {
-    currentSink = sink;
-}
-function notifySink(event) {
-    if (currentSink) {
-        try {
-            currentSink(event);
-        }
-        catch (e) {
-            // A throwing sink is a test bug. Log and continue — never let test
-            // plumbing break the SDK consumer.
-            // eslint-disable-next-line no-console
-            console.warn(`[observability] test sink threw: ${e?.message ?? e}`);
-        }
-    }
-}
-let durableWarned = false;
-// ─── Recorder ─────────────────────────────────────────────────────────────
-class ObservabilityRecorder {
-    enabled;
-    product;
-    userId;
-    agentId;
-    defaultSessionId;
-    maxBufferSize;
-    onSpan;
-    buffer = [];
-    bufferIndex = new Map();
-    shipper;
-    warnedDurable = false;
-    constructor(config) {
-        this.enabled = config.enabled !== false;
-        this.product = config.product;
-        this.userId = config.userId ?? null;
-        this.agentId = config.agentId ?? null;
-        this.defaultSessionId = config.sessionId ?? null;
-        this.maxBufferSize = config.maxBufferSize ?? DEFAULT_MAX_BUFFER;
-        this.onSpan = config.onSpan;
-        if (config.durable && !durableWarned) {
-            durableWarned = true;
-            this.warnedDurable = true;
-            // eslint-disable-next-line no-console
-            console.warn('[observability] durable=true is parsed but not implemented in v1; ' +
-                'spans are held in memory only and lost on process exit');
-        }
-        this.shipper = new shipper_1.ObservabilityShipper({
-            endpoint: config.endpoint,
-            apiKey: config.apiKey,
-            product: this.product,
-            sessionId: this.defaultSessionId,
-            batchSize: config.batchSize ?? DEFAULT_BATCH_SIZE,
-            flushIntervalMs: config.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS,
-            httpClient: config.httpClient,
-        });
-        if (this.enabled) {
-            this.shipper.start();
-        }
-    }
-    /** Internal accessor for tests; not part of the public API. */
-    get __shipper() {
-        return this.shipper;
-    }
-    /** True when the consumer passed `enabled: true` (the default). */
-    get isEnabled() {
-        return this.enabled;
-    }
-    // ─── Trace lifecycle ──────────────────────────────────────────────────
-    /**
-     * Mint a new trace and return its context. The trace is added to the
-     * in-memory buffer (dropping the oldest if at capacity) and the context
-     * is passed to subsequent `recordSpan` / `endTrace` calls.
-     */
-    startTrace(name, attributes, sessionId) {
-        // Explicit `sessionId` (even explicit `null`) wins; otherwise fall back
-        // to the recorder's default (the owning ArmorIQSession's stable UUID
-        // session id). This is the single chokepoint that stamps sessionId onto
-        // every trace uniformly, including callers (e.g. summarizeTranscriptUsage)
-        // that don't pass one at all.
-        const resolvedSessionId = sessionId !== undefined ? sessionId : this.defaultSessionId;
-        if (!this.enabled) {
-            // Return a no-op context. recordSpan/endTrace will be no-ops.
-            return {
-                traceId: (0, schema_1.mintId)(),
-                sessionId: resolvedSessionId,
-                name,
-                startTimeMs: Date.now(),
-                attributes: attributes ?? {},
-            };
-        }
-        const traceId = (0, schema_1.mintId)();
-        const startTimeMs = Date.now();
-        const trace = {
-            id: traceId,
-            sessionId: resolvedSessionId,
-            name,
-            startTime: new Date(startTimeMs).toISOString(),
-            endTime: null,
-            durationMs: null,
-            status: 'ok',
-            userId: this.userId,
-            agentId: this.agentId,
-            attributes: attributes ?? {},
-            tags: [],
-        };
-        this.appendToBuffer({ trace, spans: [] });
-        notifySink({ kind: 'trace_started', trace, sessionId: trace.sessionId });
-        return {
-            traceId,
-            sessionId: trace.sessionId,
-            name,
-            startTimeMs,
-            attributes: trace.attributes,
-        };
-    }
-    /**
-     * Append a span to an existing trace. The span is validated against the
-     * wire schema; an invalid span is logged and dropped (never thrown).
-     */
-    recordSpan(ctx, span) {
-        if (!this.enabled)
-            return;
-        if (!(0, schema_1.isValidSpanRecord)(span)) {
-            const spanAny = span;
-            const kindLabel = spanAny?.kind ?? 'unknown';
-            // eslint-disable-next-line no-console
-            console.warn(`[observability] dropping invalid span (kind=${String(kindLabel)}, trace=${ctx.traceId})`);
-            return;
-        }
-        const entry = this.bufferIndex.get(ctx.traceId);
-        if (!entry) {
-            // eslint-disable-next-line no-console
-            console.warn(`[observability] recordSpan called for unknown traceId=${ctx.traceId}; dropping span`);
-            return;
-        }
-        entry.spans.push(span);
-        if (this.onSpan) {
-            try {
-                this.onSpan(span);
-            }
-            catch (e) {
-                // eslint-disable-next-line no-console
-                console.warn(`[observability] onSpan hook threw: ${e?.message ?? e}`);
-            }
-        }
-        notifySink({
-            kind: 'span_recorded',
-            traceId: ctx.traceId,
-            traceSessionId: entry.trace.sessionId,
-            span,
-        });
-    }
-    /**
-     * Construct a `kind: 'policy_call'` span from the supplied fields and
-     * record it under the given trace. Returns the constructed span (useful
-     * for tests); otherwise the return value can be ignored.
-     */
-    recordPolicyCall(ctx, attrs, parentSpanId) {
-        const span = {
-            id: (0, schema_1.mintId)(),
-            parentSpanId: parentSpanId ?? null,
-            sessionId: ctx.sessionId,
-            kind: 'policy_call',
-            name: `${attrs.policyName ?? attrs.policyId ?? 'policy'}.${attrs.decision}`,
-            startTime: new Date().toISOString(),
-            endTime: new Date().toISOString(),
-            durationMs: attrs.durationMs != null && Number.isFinite(attrs.durationMs)
-                ? Math.round(attrs.durationMs)
-                : 0,
-            status: attrs.decision === 'allow' ? 'ok' : 'denied',
-            attributes: {
-                kind: 'policy_call',
-                policyId: attrs.policyId,
-                policyName: attrs.policyName,
-                policyHash: attrs.policyHash ?? null,
-                policyVersion: attrs.policyVersion ?? null,
-                decision: attrs.decision,
-                matchedRuleId: attrs.matchedRuleId ?? null,
-                dataClasses: attrs.dataClasses ?? [],
-                reason: attrs.reason,
-                input: attrs.input,
-                output: attrs.output,
-                source: attrs.source,
-                enforcementAction: attrs.enforcementAction ?? null,
-                obligations: attrs.obligations ?? null,
-                delegationId: attrs.delegationId ?? null,
-            },
-        };
-        this.recordSpan(ctx, span);
-        return span;
-    }
-    /**
-     * Construct a `kind: 'generation'` span from the supplied fields,
-     * compute `costUsd` from the static price table, and record it.
-     * Unknown models yield costUsd=0 (the span is still recorded).
-     * Pass `costUsd` to override the computed value (e.g. when the caller
-     * already has a precomputed cost from a third-party billing system).
-     */
-    recordGeneration(ctx, attrs, parentSpanId) {
-        const cost = attrs.costUsd ??
-            (0, model_prices_1.computeCostUsd)(attrs.model, attrs.inputTokens, attrs.outputTokens, attrs.cacheReadTokens ?? 0, attrs.cacheWriteTokens ?? 0);
-        const span = {
-            id: (0, schema_1.mintId)(),
-            parentSpanId: parentSpanId ?? null,
-            sessionId: ctx.sessionId,
-            kind: 'generation',
-            name: `generation.${attrs.model}`,
-            startTime: new Date().toISOString(),
-            endTime: new Date().toISOString(),
-            durationMs: 0,
-            status: 'ok',
-            attributes: {
-                kind: 'generation',
-                model: attrs.model,
-                inputTokens: attrs.inputTokens,
-                outputTokens: attrs.outputTokens,
-                cacheReadTokens: attrs.cacheReadTokens ?? null,
-                cacheWriteTokens: attrs.cacheWriteTokens ?? null,
-                costUsd: cost,
-                prompt: attrs.prompt ?? null,
-                completion: attrs.completion ?? null,
-                finishReason: attrs.finishReason ?? null,
-            },
-        };
-        this.recordSpan(ctx, span);
-        return span;
-    }
-    /**
-     * Record a `kind: 'event'` span — a point-in-time annotation (e.g.
-     * "plan growth", "approval polled"). Use sparingly; events are cheap
-     * but they still count toward the ring buffer.
-     */
-    recordEvent(ctx, attrs, parentSpanId) {
-        const span = {
-            id: (0, schema_1.mintId)(),
-            parentSpanId: parentSpanId ?? null,
-            sessionId: ctx.sessionId,
-            kind: 'event',
-            name: attrs.message.slice(0, 120),
-            startTime: new Date().toISOString(),
-            endTime: new Date().toISOString(),
-            durationMs: 0,
-            status: 'ok',
-            attributes: {
-                kind: 'event',
-                message: attrs.message,
-                level: attrs.level ?? 'info',
-            },
-        };
-        this.recordSpan(ctx, span);
-        return span;
-    }
-    /**
-     * Mint + record a `kind: 'span'` CONTAINER span — a nesting point that
-     * groups the child spans emitted by one chokepoint (e.g. `iap.enforce.local`)
-     * under the session's single active plan trace (Model A: trace-per-plan).
-     *
-     * The container starts open (`status: 'ok'`, `endTime: null`,
-     * `durationMs: null`) and MUST be finalized with `closeSpan()` once the
-     * chokepoint's work completes (success or error). A container span with a
-     * null `endTime` is intentionally valid mid-flight — see
-     * `isValidGenericSpanAttributes`/`isValidSpanRecord`, which permit a
-     * null `endTime`/`durationMs` for exactly this reason (Task 1 risk #1).
-     *
-     * Returns the minted span id — even when the recorder is disabled, so
-     * call sites can pass it along unconditionally as a `parentSpanId` to
-     * `recordPolicyCall`/`recordGeneration`/`recordEvent` without special-casing
-     * the disabled path.
-     */
-    openSpan(ctx, opts) {
-        const id = (0, schema_1.mintId)();
-        if (!this.enabled)
-            return id;
-        const span = {
-            id,
-            parentSpanId: opts.parentSpanId ?? null,
-            sessionId: ctx.sessionId,
-            kind: 'span',
-            name: opts.name,
-            startTime: new Date().toISOString(),
-            endTime: null,
-            durationMs: null,
-            status: 'ok',
-            attributes: { kind: 'span', ...(opts.attributes ?? {}) },
-        };
-        this.recordSpan(ctx, span);
-        return id;
-    }
-    /**
-     * Finalize a container span previously opened with `openSpan()`: sets
-     * `endTime`, optionally `durationMs`/`status`/`attributes.errorMessage`.
-     * No-op (never throws) when the recorder is disabled, the trace is
-     * unknown, or the spanId doesn't match a buffered span (e.g. it already
-     * shipped) — mirrors `endTrace`'s defensive lookup.
-     */
-    closeSpan(ctx, spanId, opts) {
-        if (!this.enabled)
-            return;
-        const entry = this.bufferIndex.get(ctx.traceId);
-        if (!entry)
-            return;
-        const span = entry.spans.find((s) => s.id === spanId);
-        if (!span)
-            return;
-        span.endTime = new Date().toISOString();
-        if (opts?.durationMs != null && Number.isFinite(opts.durationMs)) {
-            span.durationMs = Math.round(opts.durationMs);
-        }
-        if (opts?.status)
-            span.status = opts.status;
-        if (opts?.errorMessage !== undefined) {
-            span.attributes = { ...span.attributes, errorMessage: opts.errorMessage };
-        }
-    }
-    /**
-     * Finalize a trace: set endTime, compute durationMs, apply optional
-     * status / errorMessage. Pushes the (trace, spans) batch to the
-     * shipper's queue, then REMOVES the entry from the in-memory ring buffer
-     * — once a trace has been handed to the shipper, the shipper's own queue
-     * is the durable record; keeping a second copy in the ring buffer would
-     * let ended/shipped traces occupy buffer slots until overflow/flush,
-     * needlessly evicting still-in-flight traces sooner. No-op when disabled
-     * or when the trace is unknown.
-     */
-    endTrace(ctx, opts) {
-        if (!this.enabled)
-            return;
-        const entry = this.bufferIndex.get(ctx.traceId);
-        if (!entry) {
-            // eslint-disable-next-line no-console
-            console.warn(`[observability] endTrace called for unknown traceId=${ctx.traceId}; dropping`);
-            return;
-        }
-        const endMs = Date.now();
-        const durationMs = endMs - ctx.startTimeMs;
-        const finalStatus = opts?.status ?? 'ok';
-        const attributesWithError = opts?.errorMessage !== undefined
-            ? { ...entry.trace.attributes, errorMessage: opts.errorMessage }
-            : entry.trace.attributes;
-        // Derive dashboard tags + an output summary from the trace's own spans
-        // (policy_call decisions, tool names) — this is the one place every
-        // trace passes through before shipping, so it's the natural chokepoint
-        // to fill in `tags`/`attributes.output` for callers that never set them
-        // explicitly. A caller-supplied non-empty `tags` array or an explicit
-        // `attributes.output` always wins; this only fills genuine gaps.
-        const summary = (0, trace_summary_1.deriveTraceSummary)(entry.spans, this.product);
-        const updated = {
-            ...entry.trace,
-            endTime: new Date(endMs).toISOString(),
-            durationMs,
-            status: finalStatus,
-            tags: entry.trace.tags.length > 0 ? entry.trace.tags : summary.tags,
-            attributes: attributesWithError.output !== undefined || summary.output === null
-                ? attributesWithError
-                : { ...attributesWithError, output: summary.output },
-        };
-        // Enqueue the ended batch on the shipper — this is now the durable
-        // record of the trace.
-        this.shipper.enqueue({
-            trace: updated,
-            spans: entry.spans.slice(),
-        });
-        // Remove the entry from the ring buffer; it no longer needs to occupy a
-        // buffer slot now that the shipper owns it.
-        const idx = this.buffer.indexOf(entry);
-        if (idx >= 0)
-            this.buffer.splice(idx, 1);
-        this.bufferIndex.delete(ctx.traceId);
-        notifySink({
-            kind: 'trace_ended',
-            trace: updated,
-            spans: entry.spans.slice(),
-        });
-    }
-    // ─── Buffer management ────────────────────────────────────────────────
-    /**
-     * Drain the in-memory buffer. Returns a readonly array of the current
-     * (trace, spans) pairs. The buffer is NOT cleared by this call — that
-     * is `flush()`'s job. `drain()` is for inspection (tests, debugging).
-     *
-     * Note: since `endTrace()` removes entries once they're handed to the
-     * shipper (see #8), `drain()` only ever reflects traces that are still
-     * in-flight (started but not yet ended).
-     */
-    drain() {
-        return this.buffer.map((e) => ({ trace: e.trace, spans: e.spans.slice() }));
-    }
-    /**
-     * POST any queued (ended) batches via the shipper. Returns the shipper's
-     * accepted/rejected counts. NEVER throws — observability failures must
-     * not break the SDK consumer.
-     *
-     * Only ended traces (`trace.endTime !== null`) are ever handed to the
-     * shipper (see `endTrace()`); in-flight (un-ended) traces stay in the
-     * in-memory ring buffer untouched — flushing must never drop a trace
-     * that's still being built. As an extra safety net (in case some future
-     * caller enqueues directly), any buffer entries whose trace happens to
-     * already carry an `endTime` are also handed to the shipper and removed
-     * here; anything without an `endTime` is left alone and a warning is
-     * logged with the retained count.
-     */
-    async flush() {
-        if (!this.enabled)
-            return { accepted: 0, rejected: 0 };
-        const ended = this.buffer.filter((e) => e.trace.endTime !== null);
-        if (ended.length > 0) {
-            for (const entry of ended) {
-                this.shipper.enqueue({ trace: entry.trace, spans: entry.spans.slice() });
-                const idx = this.buffer.indexOf(entry);
-                if (idx >= 0)
-                    this.buffer.splice(idx, 1);
-                this.bufferIndex.delete(entry.trace.id);
-            }
-        }
-        const inFlightCount = this.buffer.length;
-        if (inFlightCount > 0) {
-            // eslint-disable-next-line no-console
-            console.warn(`[observability] flush() retained ${inFlightCount} in-flight (un-ended) trace(s) in the buffer`);
-        }
-        return this.shipper.flush();
-    }
-    /**
-     * Stop the underlying shipper (clears the periodic interval + final
-     * flush). Call on session close. Safe to call multiple times.
-     */
-    async stop() {
-        await this.shipper.stop();
-    }
-    // ─── Internals ────────────────────────────────────────────────────────
-    appendToBuffer(entry) {
-        this.buffer.push(entry);
-        this.bufferIndex.set(entry.trace.id, entry);
-        if (this.buffer.length > this.maxBufferSize) {
-            const dropped = this.buffer.shift();
-            if (dropped) {
-                this.bufferIndex.delete(dropped.trace.id);
-                // eslint-disable-next-line no-console
-                console.warn(`[observability] ring buffer full (max=${this.maxBufferSize}); dropped trace=${dropped.trace.id}`);
-            }
-        }
-    }
-}
-exports.ObservabilityRecorder = ObservabilityRecorder;
-//# sourceMappingURL=recorder.js.map

package/dist/observability/recorder.js.map

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

package/dist/observability/schema.d.ts

@@ -1,163 +0,0 @@
-/**
- * Observability wire schema — hand-written types and runtime validators.
- *
- * The contract mirrors `conmap-auto/src/observability/schema.ts` (zod on the
- * backend). The SDK cannot use zod (per plan §9 Q1) — adding it would balloon
- * the bundle for a small, stable shape. The backend's zod parser is the
- * safety net at the ingest boundary; if the wire shape ever drifts, the
- * backend rejects the bad batch and the SDK's no-throw invariant swallows
- * the warning.
- *
- * The validators below are deliberately cheap (typeof, structural) — they
- * run on every emitted span and must not become a hot-path cost.
- */
-export type SpanStatus = 'ok' | 'error' | 'denied';
-export type SpanKind = 'span' | 'policy_call' | 'generation' | 'event';
-export type PolicyDecision = 'allow' | 'deny' | 'hold' | 'ask';
-export type PolicySource = 'native' | 'sdk-local' | 'sdk' | 'proxy' | 'opa' | 'opa_fallback';
-export type PolicyEnforcementAction = 'allow' | 'allow_log' | 'hold' | 'block';
-/** Short alias for consumers who don't need the Policy prefix. */
-export type EnforcementAction = PolicyEnforcementAction;
-export type EventLevel = 'info' | 'warn' | 'error';
-/**
- * Each attribute shape permits an open index signature so SDK callers can
- * attach side-channel metadata (e.g. trustId, delegationId) without
- * re-shaping the wire contract. The runtime validator only enforces the
- * documented fields; extras are passed through and the backend's strict
- * zod is the ultimate gatekeeper at the ingest boundary.
- */
-/** kind: 'span' — generic sub-operation (tool execution, delegation, etc.) */
-export interface GenericSpanAttributes {
-    kind: 'span';
-    toolName?: string;
-    toolInput?: unknown;
-    toolOutput?: unknown;
-    errorMessage?: string;
-    [key: string]: unknown;
-}
-/** kind: 'policy_call' — a policy evaluation result */
-export interface PolicyCallAttributes {
-    kind: 'policy_call';
-    policyId: string | null;
-    policyName: string | null;
-    policyHash: string | null;
-    policyVersion: string | null;
-    decision: PolicyDecision;
-    matchedRuleId: string | null;
-    dataClasses: string[];
-    reason: string | null;
-    input: unknown;
-    output: unknown;
-    source: PolicySource;
-    enforcementAction: PolicyEnforcementAction | null;
-    obligations: unknown;
-    delegationId: string | null;
-    [key: string]: unknown;
-}
-/** kind: 'generation' — an LLM call (records token usage + cost) */
-export interface GenerationAttributes {
-    kind: 'generation';
-    model: string;
-    inputTokens: number;
-    outputTokens: number;
-    cacheReadTokens: number | null;
-    cacheWriteTokens: number | null;
-    costUsd: number;
-    prompt: string | null;
-    completion: string | null;
-    finishReason: string | null;
-    [key: string]: unknown;
-}
-/** kind: 'event' — a point-in-time annotation */
-export interface EventAttributes {
-    kind: 'event';
-    message: string;
-    level: EventLevel;
-    [key: string]: unknown;
-}
-export type SpanAttributes = GenericSpanAttributes | PolicyCallAttributes | GenerationAttributes | EventAttributes;
-/** A Trace = the top-level observation of a logical unit of work. */
-export interface TraceRecord {
-    id: string;
-    sessionId: string | null;
-    name: string;
-    startTime: string;
-    endTime: string | null;
-    durationMs: number | null;
-    status: SpanStatus;
-    userId: string | null;
-    agentId: string | null;
-    attributes: Record<string, unknown>;
-    tags: string[];
-}
-/** A Span = a child of a trace, with a kind-discriminated attributes shape. */
-export interface SpanRecord {
-    id: string;
-    parentSpanId: string | null;
-    sessionId: string | null;
-    kind: SpanKind;
-    name: string;
-    startTime: string;
-    endTime: string | null;
-    durationMs: number | null;
-    status: SpanStatus;
-    attributes: SpanAttributes;
-}
-/**
- * A Session is the parent grouping (one IAP plan). Backend returns this
- * shape from its read API — FLAT token fields, not nested. Mirrors
- * `conmap-auto/src/observability/schema.ts` `SessionRecord`
- * (totalInputTokens/totalOutputTokens/totalCacheReadTokens/totalCacheWriteTokens).
- */
-export interface SessionRecord {
-    id: string;
-    orgId: string;
-    userId: string | null;
-    agentId: string | null;
-    product: string | null;
-    startedAt: string;
-    lastActivityAt: string;
-    traceCount: number;
-    totalInputTokens: number;
-    totalOutputTokens: number;
-    totalCacheReadTokens: number;
-    totalCacheWriteTokens: number;
-    totalCostUsd: number;
-    status: 'active' | 'completed' | 'expired' | 'error';
-}
-/** One trace + its child spans, packaged for ingest. */
-export interface IngestBatch {
-    trace: TraceRecord;
-    spans: SpanRecord[];
-}
-/** Top-level ingest body. orgId is resolved by the backend from the API key. */
-export interface IngestPayload {
-    product: string;
-    sessionId: string | null;
-    batches: IngestBatch[];
-}
-export interface TraceContext {
-    traceId: string;
-    sessionId: string | null;
-    name: string;
-    startTimeMs: number;
-    attributes: Record<string, unknown>;
-}
-export declare function isValidSpanStatus(x: unknown): x is SpanStatus;
-export declare function isValidSpanKind(x: unknown): x is SpanKind;
-export declare function isValidPolicyDecision(x: unknown): x is PolicyDecision;
-export declare function isValidPolicySource(x: unknown): x is PolicySource;
-export declare function isValidPolicyEnforcementAction(x: unknown): x is PolicyEnforcementAction;
-export declare function isValidEventLevel(x: unknown): x is EventLevel;
-export declare function isValidGenericSpanAttributes(x: unknown): x is GenericSpanAttributes;
-export declare function isValidPolicyCallAttributes(x: unknown): x is PolicyCallAttributes;
-export declare function isValidGenerationAttributes(x: unknown): x is GenerationAttributes;
-export declare function isValidEventAttributes(x: unknown): x is EventAttributes;
-export declare function isValidSpanAttributes(x: unknown): x is SpanAttributes;
-export declare function isValidTraceRecord(x: unknown): x is TraceRecord;
-export declare function isValidSpanRecord(x: unknown): x is SpanRecord;
-export declare function isValidIngestBatch(x: unknown): x is IngestBatch;
-export declare function isValidIngestPayload(x: unknown): x is IngestPayload;
-export declare function mintId(): string;
-export declare function isValidUuid(x: unknown): x is string;
-//# sourceMappingURL=schema.d.ts.map

package/dist/observability/schema.d.ts.map

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