@armoriq/sdk-dev 0.8.0 → 0.8.3

package/dist/observability/schema.js

@@ -1,291 +0,0 @@
-"use strict";
-/**
- * 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.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isValidSpanStatus = isValidSpanStatus;
-exports.isValidSpanKind = isValidSpanKind;
-exports.isValidPolicyDecision = isValidPolicyDecision;
-exports.isValidPolicySource = isValidPolicySource;
-exports.isValidPolicyEnforcementAction = isValidPolicyEnforcementAction;
-exports.isValidEventLevel = isValidEventLevel;
-exports.isValidGenericSpanAttributes = isValidGenericSpanAttributes;
-exports.isValidPolicyCallAttributes = isValidPolicyCallAttributes;
-exports.isValidGenerationAttributes = isValidGenerationAttributes;
-exports.isValidEventAttributes = isValidEventAttributes;
-exports.isValidSpanAttributes = isValidSpanAttributes;
-exports.isValidTraceRecord = isValidTraceRecord;
-exports.isValidSpanRecord = isValidSpanRecord;
-exports.isValidIngestBatch = isValidIngestBatch;
-exports.isValidIngestPayload = isValidIngestPayload;
-exports.mintId = mintId;
-exports.isValidUuid = isValidUuid;
-const crypto_1 = require("crypto");
-const SPAN_KINDS = new Set([
-    'span',
-    'policy_call',
-    'generation',
-    'event',
-]);
-const SPAN_STATUSES = new Set(['ok', 'error', 'denied']);
-const POLICY_DECISIONS = new Set([
-    'allow',
-    'deny',
-    'hold',
-    'ask',
-]);
-const POLICY_SOURCES = new Set([
-    'native',
-    'sdk-local',
-    'sdk',
-    'proxy',
-    'opa',
-    'opa_fallback',
-]);
-const POLICY_ENFORCEMENT_ACTIONS = new Set([
-    'allow',
-    'allow_log',
-    'hold',
-    'block',
-]);
-const EVENT_LEVELS = new Set(['info', 'warn', 'error']);
-function isPlainObject(x) {
-    return typeof x === 'object' && x !== null && !Array.isArray(x);
-}
-// ─── Validators (cheap, return boolean) ──────────────────────────────────
-function isValidSpanStatus(x) {
-    return typeof x === 'string' && SPAN_STATUSES.has(x);
-}
-function isValidSpanKind(x) {
-    return typeof x === 'string' && SPAN_KINDS.has(x);
-}
-function isValidPolicyDecision(x) {
-    return typeof x === 'string' && POLICY_DECISIONS.has(x);
-}
-function isValidPolicySource(x) {
-    return typeof x === 'string' && POLICY_SOURCES.has(x);
-}
-function isValidPolicyEnforcementAction(x) {
-    return (typeof x === 'string' && POLICY_ENFORCEMENT_ACTIONS.has(x));
-}
-function isValidEventLevel(x) {
-    return typeof x === 'string' && EVENT_LEVELS.has(x);
-}
-function isStringOrNull(x) {
-    return x === null || typeof x === 'string';
-}
-function isStringArrayOrEmpty(x) {
-    return Array.isArray(x) && x.every((v) => typeof v === 'string');
-}
-function isValidGenericSpanAttributes(x) {
-    if (!isPlainObject(x))
-        return false;
-    if (x.kind !== 'span')
-        return false;
-    if ('toolName' in x &&
-        x.toolName !== undefined &&
-        typeof x.toolName !== 'string')
-        return false;
-    if ('errorMessage' in x &&
-        x.errorMessage !== undefined &&
-        typeof x.errorMessage !== 'string')
-        return false;
-    return true;
-}
-function isValidPolicyCallAttributes(x) {
-    if (!isPlainObject(x))
-        return false;
-    if (x.kind !== 'policy_call')
-        return false;
-    if (!isValidPolicyDecision(x.decision))
-        return false;
-    if (!isValidPolicySource(x.source))
-        return false;
-    if (!isStringOrNull(x.policyId))
-        return false;
-    if (!isStringOrNull(x.policyName))
-        return false;
-    if (!isStringOrNull(x.policyHash))
-        return false;
-    if (!isStringOrNull(x.policyVersion))
-        return false;
-    if (!isStringOrNull(x.matchedRuleId))
-        return false;
-    if (!isStringOrNull(x.reason))
-        return false;
-    if (!isStringOrNull(x.delegationId))
-        return false;
-    if (!isStringArrayOrEmpty(x.dataClasses))
-        return false;
-    if ('enforcementAction' in x &&
-        x.enforcementAction !== null &&
-        !isValidPolicyEnforcementAction(x.enforcementAction))
-        return false;
-    return true;
-}
-function isValidGenerationAttributes(x) {
-    if (!isPlainObject(x))
-        return false;
-    if (x.kind !== 'generation')
-        return false;
-    if (typeof x.model !== 'string')
-        return false;
-    if (typeof x.inputTokens !== 'number' || !Number.isFinite(x.inputTokens))
-        return false;
-    if (typeof x.outputTokens !== 'number' || !Number.isFinite(x.outputTokens))
-        return false;
-    if (typeof x.costUsd !== 'number' || !Number.isFinite(x.costUsd))
-        return false;
-    if ('cacheReadTokens' in x &&
-        x.cacheReadTokens !== null &&
-        (typeof x.cacheReadTokens !== 'number' || !Number.isFinite(x.cacheReadTokens)))
-        return false;
-    if ('cacheWriteTokens' in x &&
-        x.cacheWriteTokens !== null &&
-        (typeof x.cacheWriteTokens !== 'number' || !Number.isFinite(x.cacheWriteTokens)))
-        return false;
-    if ('prompt' in x && x.prompt !== null && typeof x.prompt !== 'string')
-        return false;
-    if ('completion' in x &&
-        x.completion !== null &&
-        typeof x.completion !== 'string')
-        return false;
-    if ('finishReason' in x &&
-        x.finishReason !== null &&
-        typeof x.finishReason !== 'string')
-        return false;
-    return true;
-}
-function isValidEventAttributes(x) {
-    if (!isPlainObject(x))
-        return false;
-    if (x.kind !== 'event')
-        return false;
-    if (typeof x.message !== 'string')
-        return false;
-    return isValidEventLevel(x.level);
-}
-function isValidSpanAttributes(x) {
-    if (!isPlainObject(x))
-        return false;
-    const k = x.kind;
-    if (k === 'span')
-        return isValidGenericSpanAttributes(x);
-    if (k === 'policy_call')
-        return isValidPolicyCallAttributes(x);
-    if (k === 'generation')
-        return isValidGenerationAttributes(x);
-    if (k === 'event')
-        return isValidEventAttributes(x);
-    return false;
-}
-function isValidTraceRecord(x) {
-    if (!isPlainObject(x))
-        return false;
-    if (typeof x.id !== 'string' || x.id.length === 0)
-        return false;
-    if (typeof x.name !== 'string' || x.name.length === 0)
-        return false;
-    if (typeof x.startTime !== 'string')
-        return false;
-    if ('endTime' in x &&
-        x.endTime !== null &&
-        typeof x.endTime !== 'string')
-        return false;
-    if ('durationMs' in x &&
-        x.durationMs !== null &&
-        (typeof x.durationMs !== 'number' || !Number.isInteger(x.durationMs)))
-        return false;
-    if (!isValidSpanStatus(x.status))
-        return false;
-    if (!isStringOrNull(x.sessionId))
-        return false;
-    if (!isStringOrNull(x.userId))
-        return false;
-    if (!isStringOrNull(x.agentId))
-        return false;
-    if (!isPlainObject(x.attributes))
-        return false;
-    if (!isStringArrayOrEmpty(x.tags))
-        return false;
-    return true;
-}
-function isValidSpanRecord(x) {
-    if (!isPlainObject(x))
-        return false;
-    if (typeof x.id !== 'string' || x.id.length === 0)
-        return false;
-    if (typeof x.name !== 'string' || x.name.length === 0)
-        return false;
-    if (typeof x.startTime !== 'string')
-        return false;
-    if ('endTime' in x &&
-        x.endTime !== null &&
-        typeof x.endTime !== 'string')
-        return false;
-    if ('durationMs' in x &&
-        x.durationMs !== null &&
-        (typeof x.durationMs !== 'number' || !Number.isInteger(x.durationMs)))
-        return false;
-    if (!isValidSpanKind(x.kind))
-        return false;
-    if (!isValidSpanStatus(x.status))
-        return false;
-    if (!isStringOrNull(x.parentSpanId))
-        return false;
-    if (!isStringOrNull(x.sessionId))
-        return false;
-    return isValidSpanAttributes(x.attributes);
-}
-function isValidIngestBatch(x) {
-    if (!isPlainObject(x))
-        return false;
-    if (!isValidTraceRecord(x.trace))
-        return false;
-    if (!Array.isArray(x.spans))
-        return false;
-    for (const s of x.spans) {
-        if (!isValidSpanRecord(s))
-            return false;
-    }
-    return true;
-}
-function isValidIngestPayload(x) {
-    if (!isPlainObject(x))
-        return false;
-    if (typeof x.product !== 'string' || x.product.length === 0)
-        return false;
-    if (!isStringOrNull(x.sessionId))
-        return false;
-    if (!Array.isArray(x.batches) || x.batches.length === 0)
-        return false;
-    for (const b of x.batches) {
-        if (!isValidIngestBatch(b))
-            return false;
-    }
-    return true;
-}
-// ─── ID minting helper (used by recorder) ────────────────────────────────
-function mintId() {
-    return (0, crypto_1.randomUUID)();
-}
-// ─── UUID validation ──────────────────────────────────────────────────────
-// The backend's `obs_sessions.id` column is a UUID. A trace's `sessionId`
-// must therefore either be a valid UUID or `null` — never an arbitrary
-// string like the literal `'default'` — or the trace can never be grouped
-// into a session (see ArmorIQSession's sessionId resolution in session.ts).
-const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-function isValidUuid(x) {
-    return typeof x === 'string' && UUID_RE.test(x);
-}
-//# sourceMappingURL=schema.js.map

package/dist/observability/schema.js.map

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

package/dist/observability/shipper.d.ts

@@ -1,84 +0,0 @@
-/**
- * ObservabilityShipper — batches ended traces + their spans and POSTs them
- * to the backend ingest endpoint.
- *
- * Failure handling (the no-throw invariant):
- *   - 4xx: log warning, drop the batches. The backend has rejected the
- *     payload as malformed; retrying won't help.
- *   - 5xx and network errors: exponential backoff (500ms, 1s, 2s) up to
- *     3 retries; then log warning, drop.
- *   - Any throw from the httpClient is caught and treated as a network
- *     error (retried per the same schedule).
- *
- * The shipper is owned by `ObservabilityRecorder` — SDK consumers should
- * not construct it directly. It's exported so the recorder module can
- * import it without circular dep issues.
- */
-import { AxiosInstance } from 'axios';
-import { type IngestBatch } from './schema';
-export interface ShipperConfig {
-    /** Backend base URL (no trailing slash). Shipper appends `/observability/spans`. */
-    endpoint: string;
-    /** API key sent in the `X-API-Key` header. */
-    apiKey: string;
-    /** Product tag included in every payload. */
-    product: string;
-    /** Optional top-level session id (used as the fallback for batches without one). */
-    sessionId?: string | null;
-    /**
-     * Max batches per POST. Default 100. `flush()` chunks the queue into
-     * groups of at most this size and sends one POST per chunk — a burst of
-     * traces never sends a single unbounded giant POST.
-     */
-    batchSize?: number;
-    /** Auto-flush interval (ms). Default 5000. */
-    flushIntervalMs?: number;
-    /** Override the HTTP client (axios instance). Defaults to axios.create({ timeout: 10000 }). */
-    httpClient?: AxiosInstance;
-}
-export declare class ObservabilityShipper {
-    private readonly endpoint;
-    private readonly apiKey;
-    private readonly product;
-    private readonly sessionId;
-    private readonly batchSize;
-    private readonly flushIntervalMs;
-    private readonly httpClient;
-    private readonly queue;
-    private intervalHandle;
-    private stopPromise;
-    constructor(config: ShipperConfig);
-    /**
-     * Append a batch to the internal queue. The shipper does not validate
-     * the batch here (the recorder already validates on record); invalid
-     * batches are filtered at flush time.
-     */
-    enqueue(batch: IngestBatch): void;
-    /**
-     * Start the periodic auto-flush. Idempotent — calling start() while
-     * already running is a no-op.
-     */
-    start(): void;
-    /**
-     * Stop the periodic auto-flush and do a final flush of anything still
-     * in the queue. Safe to call multiple times.
-     */
-    stop(): Promise<void>;
-    /**
-     * POST all queued batches, chunked so each POST carries at most
-     * `this.batchSize` batches (default 100) — a burst of traces no longer
-     * sends one unbounded giant POST. Chunks are sent sequentially (simpler
-     * failure semantics than parallel: a failing chunk doesn't race with a
-     * later chunk's retry backoff). Returns the summed `{ accepted, rejected }`
-     * across all chunks. NEVER throws — observability failures must not break
-     * the consumer.
-     */
-    flush(): Promise<{
-        accepted: number;
-        rejected: number;
-    }>;
-    /** Test-only accessor: inspect the current queue size. */
-    get __queueSize(): number;
-    private postWithRetry;
-}
-//# sourceMappingURL=shipper.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"shipper.d.ts","sourceRoot":"","sources":["../../src/observability/shipper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAc,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,EAAsB,KAAK,WAAW,EAAsB,MAAM,UAAU,CAAC;AAEpF,MAAM,WAAW,aAAa;IAC5B,oFAAoF;IACpF,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+FAA+F;IAC/F,UAAU,CAAC,EAAE,aAAa,CAAC;CAC5B;AAwCD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,WAAW,CAA8B;gBAErC,MAAM,EAAE,aAAa;IAWjC;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAIjC;;;OAGG;IACH,KAAK,IAAI,IAAI;IAab;;;OAGG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAarB;;;;;;;;OAQG;IACG,KAAK,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAiC9D,0DAA0D;IAC1D,IAAI,WAAW,IAAI,MAAM,CAExB;YAIa,aAAa;CA+C5B"}

package/dist/observability/shipper.js

@@ -1,206 +0,0 @@
-"use strict";
-/**
- * ObservabilityShipper — batches ended traces + their spans and POSTs them
- * to the backend ingest endpoint.
- *
- * Failure handling (the no-throw invariant):
- *   - 4xx: log warning, drop the batches. The backend has rejected the
- *     payload as malformed; retrying won't help.
- *   - 5xx and network errors: exponential backoff (500ms, 1s, 2s) up to
- *     3 retries; then log warning, drop.
- *   - Any throw from the httpClient is caught and treated as a network
- *     error (retried per the same schedule).
- *
- * The shipper is owned by `ObservabilityRecorder` — SDK consumers should
- * not construct it directly. It's exported so the recorder module can
- * import it without circular dep issues.
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ObservabilityShipper = void 0;
-const axios_1 = __importDefault(require("axios"));
-const crypto_1 = require("crypto");
-const schema_1 = require("./schema");
-const DEFAULT_BATCH_SIZE = 100;
-const DEFAULT_FLUSH_INTERVAL_MS = 5000;
-const MAX_RETRIES = 3;
-const BACKOFF_BASE_MS = 500;
-const HTTP_TIMEOUT_MS = 10000;
-function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-/** Split `batches` into chunks of at most `size` batches each (size >= 1). */
-function chunkBatches(batches, size) {
-    const effectiveSize = size > 0 ? size : DEFAULT_BATCH_SIZE;
-    const chunks = [];
-    for (let i = 0; i < batches.length; i += effectiveSize) {
-        chunks.push(batches.slice(i, i + effectiveSize));
-    }
-    return chunks;
-}
-// ─── beforeExit singleton ──────────────────────────────────────────────────
-// Each shipper registers itself here on start(). A single beforeExit listener
-// drains all active shippers so we never leak listeners (Node warns at 11).
-const activeShippers = new Set();
-let beforeExitRegistered = false;
-function registerBeforeExitHandler() {
-    if (beforeExitRegistered)
-        return;
-    if (typeof process === 'undefined' || typeof process.on !== 'function')
-        return;
-    beforeExitRegistered = true;
-    process.on('beforeExit', () => {
-        for (const s of activeShippers) {
-            void s.stop();
-        }
-    });
-}
-class ObservabilityShipper {
-    endpoint;
-    apiKey;
-    product;
-    sessionId;
-    batchSize;
-    flushIntervalMs;
-    httpClient;
-    queue = [];
-    intervalHandle = null;
-    stopPromise = null;
-    constructor(config) {
-        this.endpoint = config.endpoint.replace(/\/+$/, '');
-        this.apiKey = config.apiKey;
-        this.product = config.product;
-        this.sessionId = config.sessionId ?? null;
-        this.batchSize = config.batchSize ?? DEFAULT_BATCH_SIZE;
-        this.flushIntervalMs = config.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS;
-        this.httpClient =
-            config.httpClient ?? axios_1.default.create({ timeout: HTTP_TIMEOUT_MS });
-    }
-    /**
-     * Append a batch to the internal queue. The shipper does not validate
-     * the batch here (the recorder already validates on record); invalid
-     * batches are filtered at flush time.
-     */
-    enqueue(batch) {
-        this.queue.push(batch);
-    }
-    /**
-     * Start the periodic auto-flush. Idempotent — calling start() while
-     * already running is a no-op.
-     */
-    start() {
-        if (this.intervalHandle)
-            return;
-        this.intervalHandle = setInterval(() => {
-            void this.flush();
-        }, this.flushIntervalMs);
-        if (typeof this.intervalHandle === 'object' && this.intervalHandle !== null) {
-            // Don't keep the event loop alive solely for the flush interval.
-            this.intervalHandle.unref?.();
-        }
-        activeShippers.add(this);
-        registerBeforeExitHandler();
-    }
-    /**
-     * Stop the periodic auto-flush and do a final flush of anything still
-     * in the queue. Safe to call multiple times.
-     */
-    stop() {
-        if (this.stopPromise)
-            return this.stopPromise;
-        activeShippers.delete(this);
-        this.stopPromise = (async () => {
-            if (this.intervalHandle) {
-                clearInterval(this.intervalHandle);
-                this.intervalHandle = null;
-            }
-            await this.flush();
-        })();
-        return this.stopPromise;
-    }
-    /**
-     * POST all queued batches, chunked so each POST carries at most
-     * `this.batchSize` batches (default 100) — a burst of traces no longer
-     * sends one unbounded giant POST. Chunks are sent sequentially (simpler
-     * failure semantics than parallel: a failing chunk doesn't race with a
-     * later chunk's retry backoff). Returns the summed `{ accepted, rejected }`
-     * across all chunks. NEVER throws — observability failures must not break
-     * the consumer.
-     */
-    async flush() {
-        if (this.queue.length === 0) {
-            return { accepted: 0, rejected: 0 };
-        }
-        // Snapshot the queue and clear it before the network call so a
-        // concurrent enqueue lands in the next flush.
-        const batches = this.queue.splice(0, this.queue.length);
-        const valid = batches.filter((b) => (0, schema_1.isValidIngestBatch)(b));
-        const invalid = batches.length - valid.length;
-        if (invalid > 0) {
-            // eslint-disable-next-line no-console
-            console.warn(`[observability] shipper dropped ${invalid} invalid batch(es) at flush`);
-        }
-        if (valid.length === 0) {
-            return { accepted: 0, rejected: invalid };
-        }
-        let accepted = 0;
-        let rejected = invalid;
-        for (const chunk of chunkBatches(valid, this.batchSize)) {
-            const payload = {
-                product: this.product,
-                sessionId: this.sessionId,
-                batches: chunk,
-            };
-            const result = await this.postWithRetry(payload);
-            accepted += result.accepted;
-            rejected += result.rejected;
-        }
-        return { accepted, rejected };
-    }
-    /** Test-only accessor: inspect the current queue size. */
-    get __queueSize() {
-        return this.queue.length;
-    }
-    // ─── Internals ────────────────────────────────────────────────────────
-    async postWithRetry(payload) {
-        const url = `${this.endpoint}/observability/spans`;
-        const headers = {
-            'X-API-Key': this.apiKey,
-            'Content-Type': 'application/json',
-            'X-Request-Id': (0, crypto_1.randomUUID)(),
-        };
-        let lastError = null;
-        for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
-            try {
-                const response = await this.httpClient.post(url, payload, { headers });
-                const status = response.status;
-                if (status >= 200 && status < 300) {
-                    const data = (response.data ?? {});
-                    return {
-                        accepted: typeof data.accepted === 'number' ? data.accepted : 0,
-                        rejected: typeof data.rejected === 'number' ? data.rejected : 0,
-                    };
-                }
-                if (status >= 400 && status < 500) {
-                    // eslint-disable-next-line no-console
-                    console.warn(`[observability] shipper got ${status} from ${url}; dropping ${payload.batches.length} batch(es)`);
-                    return { accepted: 0, rejected: payload.batches.length };
-                }
-                lastError = new Error(`HTTP ${status}`);
-            }
-            catch (e) {
-                lastError = e;
-            }
-            if (attempt < MAX_RETRIES) {
-                await sleep(BACKOFF_BASE_MS * 2 ** attempt);
-            }
-        }
-        // eslint-disable-next-line no-console
-        console.warn(`[observability] shipper failed after ${MAX_RETRIES} retries; dropping ${payload.batches.length} batch(es): ${lastError?.message ?? 'unknown error'}`);
-        return { accepted: 0, rejected: payload.batches.length };
-    }
-}
-exports.ObservabilityShipper = ObservabilityShipper;
-//# sourceMappingURL=shipper.js.map

package/dist/observability/shipper.js.map

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

package/dist/observability/trace-summary.d.ts

@@ -1,34 +0,0 @@
-/**
- * Trace-level tag/output-summary derivation.
- *
- * A trace's own `tags`/`attributes.output` are never populated by callers
- * today (every chokepoint only passes freeform `attributes` at
- * `startTrace()` time, before any child span exists) — so without this
- * module every trace ships with `tags: []` and no output summary, even
- * though the information needed to compute both already lives on the
- * trace's own spans by the time `endTrace()` runs.
- *
- * This is intentionally derived, not caller-supplied: it's computed once,
- * in one place (`ObservabilityRecorder.endTrace`), from the same in-memory
- * `spans` array the recorder already holds — no new public API surface,
- * no risk of callers drifting from each other's tagging conventions.
- *
- * Kept deliberately conservative and low-cardinality (per the dashboard's
- * TAGS column contract): product + distinct tool names + one decision
- * verdict, nothing free-text or unbounded.
- */
-import type { SpanRecord } from './schema';
-export interface TraceSummary {
-    /** Low-cardinality tags: product + distinct tool names + decision verdict. */
-    tags: string[];
-    /** Concise outcome summary derived from policy_call spans, or null if none. */
-    output: string | null;
-}
-/**
- * Derive `{ tags, output }` for a trace from its accumulated spans. Pure
- * and read-only — never mutates `spans`. Callers merge the result onto the
- * trace record themselves (see `ObservabilityRecorder.endTrace`), preserving
- * any tags/output the caller already set explicitly.
- */
-export declare function deriveTraceSummary(spans: readonly SpanRecord[], product: string | null | undefined): TraceSummary;
-//# sourceMappingURL=trace-summary.d.ts.map

package/dist/observability/trace-summary.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"trace-summary.d.ts","sourceRoot":"","sources":["../../src/observability/trace-summary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAwB,UAAU,EAAE,MAAM,UAAU,CAAC;AAqEjE,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,+EAA+E;IAC/E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACjC,YAAY,CAad"}