@superblocksteam/telemetry 2.0.83-next.1

package/dist-esm/testing/in-memory-exporter.js

@@ -0,0 +1,248 @@
+/**
+ * In-Memory Exporters for Testing
+ *
+ * These exporters capture telemetry data in memory for assertion in tests.
+ * No external connections are made.
+ */
+import { ExportResultCode } from '@opentelemetry/core';
+/**
+ * In-memory span exporter for testing.
+ * Captures all exported spans for assertion.
+ */
+export class InMemorySpanExporter {
+    spans = [];
+    stopped = false;
+    /**
+     * Export spans to in-memory storage.
+     */
+    export(spans, resultCallback) {
+        if (this.stopped) {
+            resultCallback({ code: ExportResultCode.FAILED });
+            return;
+        }
+        this.spans.push(...spans);
+        resultCallback({ code: ExportResultCode.SUCCESS });
+    }
+    /**
+     * Shutdown the exporter.
+     */
+    shutdown() {
+        this.stopped = true;
+        return Promise.resolve();
+    }
+    /**
+     * Force flush (no-op for in-memory).
+     */
+    forceFlush() {
+        return Promise.resolve();
+    }
+    /**
+     * Get all captured spans.
+     */
+    getSpans() {
+        return [...this.spans];
+    }
+    /**
+     * Get the number of captured spans.
+     */
+    getSpanCount() {
+        return this.spans.length;
+    }
+    /**
+     * Clear captured spans.
+     */
+    reset() {
+        this.spans = [];
+    }
+    /**
+     * Find spans by name.
+     *
+     * @param name - Span name to search for
+     * @returns Matching spans
+     */
+    findSpansByName(name) {
+        return this.spans.filter((s) => s.name === name);
+    }
+    /**
+     * Find spans by name pattern (regex).
+     *
+     * @param pattern - Regex pattern to match span names
+     * @returns Matching spans
+     */
+    findSpansByPattern(pattern) {
+        return this.spans.filter((s) => pattern.test(s.name));
+    }
+    /**
+     * Find spans with a specific attribute value.
+     *
+     * @param key - Attribute key
+     * @param value - Attribute value (or regex for pattern matching)
+     * @returns Matching spans
+     */
+    findSpansByAttribute(key, value) {
+        return this.spans.filter((s) => {
+            const attr = s.attributes[key];
+            if (attr === undefined)
+                return false;
+            if (value instanceof RegExp) {
+                return value.test(String(attr));
+            }
+            return attr === value;
+        });
+    }
+    /**
+     * Assert no spans have a specific attribute value.
+     * Useful for ensuring Tier 1 data doesn't leak.
+     *
+     * @param key - Attribute key
+     * @param value - Forbidden attribute value (or regex pattern)
+     * @throws Error if forbidden attribute is found
+     */
+    assertNoAttribute(key, value) {
+        for (const span of this.spans) {
+            const attr = span.attributes[key];
+            if (attr === undefined)
+                continue;
+            const matches = value instanceof RegExp ? value.test(String(attr)) : attr === value;
+            if (matches) {
+                throw new Error(`Found forbidden attribute ${key}=${String(attr)} on span "${span.name}"`);
+            }
+        }
+    }
+    /**
+     * Assert all spans have a required attribute.
+     *
+     * @param key - Attribute key
+     * @throws Error if any span is missing the attribute
+     */
+    assertAllHaveAttribute(key) {
+        for (const span of this.spans) {
+            if (span.attributes[key] === undefined) {
+                throw new Error(`Span "${span.name}" is missing required attribute "${key}"`);
+            }
+        }
+    }
+    /**
+     * Get span names for debugging.
+     */
+    getSpanNames() {
+        return this.spans.map((s) => s.name);
+    }
+}
+/**
+ * In-memory metric exporter for testing.
+ */
+export class InMemoryMetricExporter {
+    metrics = [];
+    /**
+     * Export metrics to in-memory storage.
+     */
+    export(metrics) {
+        this.metrics.push(...metrics);
+    }
+    /**
+     * Get all captured metrics.
+     */
+    getMetrics() {
+        return [...this.metrics];
+    }
+    /**
+     * Find metrics by name.
+     *
+     * @param name - Metric name
+     * @returns Matching metrics
+     */
+    findMetricsByName(name) {
+        return this.metrics.filter((m) => m.name === name);
+    }
+    /**
+     * Clear captured metrics.
+     */
+    reset() {
+        this.metrics = [];
+    }
+    /**
+     * Assert no metrics have a specific label value.
+     *
+     * @param labelKey - Label key
+     * @param value - Forbidden value
+     * @throws Error if forbidden label is found
+     */
+    assertNoLabel(labelKey, value) {
+        for (const metric of this.metrics) {
+            for (const dp of metric.dataPoints) {
+                const label = dp.attributes[labelKey];
+                if (label === undefined)
+                    continue;
+                const matches = value instanceof RegExp ? value.test(String(label)) : label === value;
+                if (matches) {
+                    throw new Error(`Found forbidden label ${labelKey}=${String(label)} on metric "${metric.name}"`);
+                }
+            }
+        }
+    }
+}
+/**
+ * In-memory log exporter for testing.
+ */
+export class InMemoryLogExporter {
+    logs = [];
+    /**
+     * Export logs to in-memory storage.
+     */
+    export(logs) {
+        this.logs.push(...logs);
+    }
+    /**
+     * Get all captured logs.
+     */
+    getLogs() {
+        return [...this.logs];
+    }
+    /**
+     * Find logs by severity.
+     *
+     * @param severityNumber - Severity level (e.g., 9 for INFO, 13 for WARN, 17 for ERROR)
+     * @returns Matching logs
+     */
+    findLogsBySeverity(severityNumber) {
+        return this.logs.filter((l) => l.severityNumber === severityNumber);
+    }
+    /**
+     * Find logs containing text.
+     *
+     * @param text - Text to search for in log body
+     * @returns Matching logs
+     */
+    findLogsContaining(text) {
+        return this.logs.filter((l) => {
+            if (l.body === undefined)
+                return false;
+            const bodyStr = String(l.body);
+            return text instanceof RegExp ? text.test(bodyStr) : bodyStr.includes(text);
+        });
+    }
+    /**
+     * Clear captured logs.
+     */
+    reset() {
+        this.logs = [];
+    }
+    /**
+     * Assert no logs contain sensitive data.
+     *
+     * @param pattern - Pattern to check for (forbidden content)
+     * @throws Error if forbidden content is found
+     */
+    assertNoLogContains(pattern) {
+        for (const log of this.logs) {
+            if (log.body === undefined)
+                continue;
+            const bodyStr = String(log.body);
+            if (pattern.test(bodyStr)) {
+                throw new Error(`Found forbidden content in log: ${bodyStr.slice(0, 100)}...`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=in-memory-exporter.js.map

package/dist-esm/testing/in-memory-exporter.js.map

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

package/dist-esm/testing/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Testing Utilities
+ *
+ * In-memory exporters and test helpers for telemetry assertions.
+ */
+export { InMemorySpanExporter, InMemoryMetricExporter, InMemoryLogExporter, type CapturedMetric, type CapturedLogRecord, } from './in-memory-exporter.js';
+export { initTestTelemetry, getTestTelemetryInstance, resetTestTelemetry, getTestTracer, withTestSpan, type TestTelemetryInstance, } from './test-init.js';
+//# sourceMappingURL=index.d.ts.map

package/dist-esm/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,iBAAiB,GACvB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,KAAK,qBAAqB,GAC3B,MAAM,gBAAgB,CAAC"}

package/dist-esm/testing/index.js

@@ -0,0 +1,8 @@
+/**
+ * Testing Utilities
+ *
+ * In-memory exporters and test helpers for telemetry assertions.
+ */
+export { InMemorySpanExporter, InMemoryMetricExporter, InMemoryLogExporter, } from './in-memory-exporter.js';
+export { initTestTelemetry, getTestTelemetryInstance, resetTestTelemetry, getTestTracer, withTestSpan, } from './test-init.js';
+//# sourceMappingURL=index.js.map

package/dist-esm/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,GAGpB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,aAAa,EACb,YAAY,GAEb,MAAM,gBAAgB,CAAC"}

package/dist-esm/testing/test-init.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Test Telemetry Initialization
+ *
+ * Initialize telemetry for testing with in-memory exporters.
+ * No external connections are made.
+ */
+import { trace } from "@opentelemetry/api";
+import { InMemorySpanExporter, InMemoryMetricExporter, InMemoryLogExporter } from "./in-memory-exporter.js";
+import { TelemetryPolicyEvaluator } from "../common/policy-evaluator.js";
+import type { BaseTelemetryConfig } from "../types/index.js";
+/**
+ * Test telemetry instance with in-memory exporters.
+ */
+export interface TestTelemetryInstance {
+    /** In-memory span exporter */
+    spanExporter: InMemorySpanExporter;
+    /** In-memory metric exporter */
+    metricExporter: InMemoryMetricExporter;
+    /** In-memory log exporter */
+    logExporter: InMemoryLogExporter;
+    /** Policy evaluator */
+    policyEvaluator: TelemetryPolicyEvaluator;
+    /** Reset all exporters (call in beforeEach) */
+    reset: () => void;
+    /** Shutdown (call in afterAll) */
+    shutdown: () => Promise<void>;
+}
+/**
+ * Initialize telemetry for testing.
+ *
+ * Uses in-memory exporters, no external connections.
+ * Call once per test file, use reset() in beforeEach.
+ *
+ * @param config - Optional test configuration
+ * @returns Test telemetry instance
+ *
+ * @example
+ * ```typescript
+ * import { initTestTelemetry } from '@superblocksteam/telemetry/testing';
+ *
+ * describe('MyService', () => {
+ *   const { spanExporter, reset } = initTestTelemetry();
+ *
+ *   beforeEach(() => reset());
+ *
+ *   it('creates expected spans', async () => {
+ *     // ... test code ...
+ *     expect(spanExporter.getSpans()).toHaveLength(1);
+ *   });
+ * });
+ * ```
+ */
+export declare function initTestTelemetry(config?: Partial<BaseTelemetryConfig>): TestTelemetryInstance;
+/**
+ * Get the test telemetry instance.
+ *
+ * @throws Error if not initialized
+ */
+export declare function getTestTelemetryInstance(): TestTelemetryInstance;
+/**
+ * Reset the test telemetry (for cleanup between test files).
+ */
+export declare function resetTestTelemetry(): Promise<void>;
+/**
+ * Get a tracer for tests.
+ *
+ * @param name - Tracer name
+ * @returns Tracer instance
+ */
+export declare function getTestTracer(name?: string): ReturnType<typeof trace.getTracer>;
+/**
+ * Run a function within a test span.
+ * Useful for testing span creation.
+ *
+ * @param name - Span name
+ * @param fn - Function to run
+ * @returns Function result
+ */
+export declare function withTestSpan<T>(name: string, fn: () => Promise<T> | T): Promise<T>;
+//# sourceMappingURL=test-init.d.ts.map

package/dist-esm/testing/test-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-init.d.ts","sourceRoot":"","sources":["../../src/testing/test-init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAM3C,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,8BAA8B;IAC9B,YAAY,EAAE,oBAAoB,CAAC;IACnC,gCAAgC;IAChC,cAAc,EAAE,sBAAsB,CAAC;IACvC,6BAA6B;IAC7B,WAAW,EAAE,mBAAmB,CAAC;IACjC,uBAAuB;IACvB,eAAe,EAAE,wBAAwB,CAAC;IAC1C,+CAA+C;IAC/C,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAeD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACpC,qBAAqB,CA2CvB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,qBAAqB,CAOhE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAIxD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,SAAS,GACZ,UAAU,CAAC,OAAO,KAAK,CAAC,SAAS,CAAC,CAEpC;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC,CASZ"}

package/dist-esm/testing/test-init.js

@@ -0,0 +1,137 @@
+/**
+ * Test Telemetry Initialization
+ *
+ * Initialize telemetry for testing with in-memory exporters.
+ * No external connections are made.
+ */
+import { trace } from "@opentelemetry/api";
+import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
+import { SimpleSpanProcessor } from "@opentelemetry/sdk-trace-base";
+import { AsyncLocalStorageContextManager } from "@opentelemetry/context-async-hooks";
+import { W3CTraceContextPropagator } from "@opentelemetry/core";
+import { InMemorySpanExporter, InMemoryMetricExporter, InMemoryLogExporter, } from "./in-memory-exporter.js";
+import { buildResource } from "../common/resource.js";
+import { TelemetryPolicyEvaluator } from "../common/policy-evaluator.js";
+import { CLOUD_DEFAULT_POLICY } from "../types/policy.js";
+// Singleton for tests
+let testInstance;
+let tracerProvider;
+/**
+ * Default test configuration.
+ */
+const DEFAULT_TEST_CONFIG = {
+    serviceName: "test-service",
+    serviceVersion: "0.0.0-test",
+    environment: "test",
+};
+/**
+ * Initialize telemetry for testing.
+ *
+ * Uses in-memory exporters, no external connections.
+ * Call once per test file, use reset() in beforeEach.
+ *
+ * @param config - Optional test configuration
+ * @returns Test telemetry instance
+ *
+ * @example
+ * ```typescript
+ * import { initTestTelemetry } from '@superblocksteam/telemetry/testing';
+ *
+ * describe('MyService', () => {
+ *   const { spanExporter, reset } = initTestTelemetry();
+ *
+ *   beforeEach(() => reset());
+ *
+ *   it('creates expected spans', async () => {
+ *     // ... test code ...
+ *     expect(spanExporter.getSpans()).toHaveLength(1);
+ *   });
+ * });
+ * ```
+ */
+export function initTestTelemetry(config) {
+    if (testInstance) {
+        return testInstance;
+    }
+    const mergedConfig = { ...DEFAULT_TEST_CONFIG, ...config };
+    const resource = buildResource(mergedConfig);
+    const spanExporter = new InMemorySpanExporter();
+    const metricExporter = new InMemoryMetricExporter();
+    const logExporter = new InMemoryLogExporter();
+    const policyEvaluator = new TelemetryPolicyEvaluator(CLOUD_DEFAULT_POLICY);
+    // Create provider with span processors in constructor (OTEL v2.x API)
+    tracerProvider = new NodeTracerProvider({
+        resource,
+        spanProcessors: [new SimpleSpanProcessor(spanExporter)],
+    });
+    // Register the provider
+    tracerProvider.register({
+        propagator: new W3CTraceContextPropagator(),
+        contextManager: new AsyncLocalStorageContextManager(),
+    });
+    testInstance = {
+        spanExporter,
+        metricExporter,
+        logExporter,
+        policyEvaluator,
+        reset: () => {
+            spanExporter.reset();
+            metricExporter.reset();
+            logExporter.reset();
+        },
+        shutdown: async () => {
+            await tracerProvider?.shutdown();
+            testInstance = undefined;
+            tracerProvider = undefined;
+        },
+    };
+    return testInstance;
+}
+/**
+ * Get the test telemetry instance.
+ *
+ * @throws Error if not initialized
+ */
+export function getTestTelemetryInstance() {
+    if (!testInstance) {
+        throw new Error("[TestTelemetry] Not initialized. Call initTestTelemetry() first.");
+    }
+    return testInstance;
+}
+/**
+ * Reset the test telemetry (for cleanup between test files).
+ */
+export async function resetTestTelemetry() {
+    if (testInstance) {
+        await testInstance.shutdown();
+    }
+}
+/**
+ * Get a tracer for tests.
+ *
+ * @param name - Tracer name
+ * @returns Tracer instance
+ */
+export function getTestTracer(name = "test") {
+    return trace.getTracer(name);
+}
+/**
+ * Run a function within a test span.
+ * Useful for testing span creation.
+ *
+ * @param name - Span name
+ * @param fn - Function to run
+ * @returns Function result
+ */
+export async function withTestSpan(name, fn) {
+    const tracer = getTestTracer();
+    return tracer.startActiveSpan(name, async (span) => {
+        try {
+            return await fn();
+        }
+        finally {
+            span.end();
+        }
+    });
+}
+//# sourceMappingURL=test-init.js.map

package/dist-esm/testing/test-init.js.map

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

package/dist-esm/types/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Telemetry Types
+ *
+ * Re-exports policy types and config interfaces.
+ */
+export * from './policy.js';
+/**
+ * Base configuration for telemetry initialization.
+ */
+export interface BaseTelemetryConfig {
+    /** Service name (e.g., 'superblocks-server') */
+    serviceName: string;
+    /** Service version (e.g., '1.0.0') */
+    serviceVersion: string;
+    /** Deployment environment (e.g., 'production', 'staging', 'development') */
+    environment: string;
+    /** Additional resource attributes */
+    resourceAttributes?: Record<string, string>;
+}
+/**
+ * Node.js specific telemetry configuration.
+ */
+export interface NodeTelemetryConfig extends BaseTelemetryConfig {
+    /** OTLP collector URL (e.g., http://localhost:4318) */
+    otlpUrl?: string;
+    /** OpenTelemetry instrumentations to enable */
+    instrumentations?: unknown[];
+    /** Whether to enable metrics collection */
+    metricsEnabled?: boolean;
+    /** Whether to enable log collection */
+    logsEnabled?: boolean;
+}
+/**
+ * Browser specific telemetry configuration.
+ */
+export interface BrowserTelemetryConfig extends BaseTelemetryConfig {
+    /** OTLP traces endpoint URL */
+    otlpUrl: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist-esm/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IAEpB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IAEvB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IAEpB,qCAAqC;IACrC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,OAAO,EAAE,CAAC;IAE7B,2CAA2C;IAC3C,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,uCAAuC;IACvC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist-esm/types/index.js

@@ -0,0 +1,7 @@
+/**
+ * Telemetry Types
+ *
+ * Re-exports policy types and config interfaces.
+ */
+export * from './policy.js';
+//# sourceMappingURL=index.js.map

package/dist-esm/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAC"}

package/dist-esm/types/policy.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Telemetry Policy Types
+ *
+ * NOTE: In the hybrid tier architecture, the OTEL Collector handles
+ * sanitization, hashing, and routing. The SDK just emits full-fidelity data.
+ * See obs/otel-collector/config-tiered.yaml for Collector configuration.
+ */
+import { DeploymentTypeEnum } from "@superblocksteam/shared";
+export { DeploymentTypeEnum as DeploymentType };
+/**
+ * Telemetry tier definitions.
+ *
+ * Tier 1 (Local): Full fidelity data for debugging. Stored in customer LGTM.
+ * Tier 2 (Operational): Sanitized metrics/traces for ops. Exported to Superblocks.
+ * Tier 3 (Analytics): AI experience telemetry. Exported with content controls.
+ *
+ * In the hybrid architecture:
+ * - SDK emits all data to the Collector
+ * - Collector transforms and routes to appropriate tier pipelines
+ * - Tier tagging, hashing, and filtering happen at Collector level
+ */
+export declare enum TelemetryTier {
+    /** Full fidelity debugging data - prompts, code, tool IO, stack traces */
+    TIER_1_LOCAL = "tier_1_local",
+    /** Sanitized operational metrics and traces for dashboards/billing */
+    TIER_2_OPERATIONAL = "tier_2_operational",
+    /** AI experience telemetry - prompts, responses, quality signals (no tool outputs) */
+    TIER_3_AI_EXPERIENCE = "tier_3_ai_experience"
+}
+export declare enum EnforcementMode {
+    /** Log violations but allow */
+    AUDIT = "audit",
+    /** Block violations */
+    ENFORCE = "enforce"
+}
+/**
+ * Tier 3 content export policy for runtime control during incidents.
+ */
+export interface Tier3ContentPolicy {
+    /** Export AI prompts/responses. Kill switch for incidents. */
+    contentExportEnabled: boolean;
+    /** Redact detected secrets (JWTs, API keys, PEM blocks) from content */
+    secretRedactionEnabled: boolean;
+    /** Block export if tool output patterns detected in response */
+    toolOutputFilteringEnabled: boolean;
+    /** Max prompt length in bytes */
+    maxPromptBytes: number;
+    /** Max response length in bytes */
+    maxResponseBytes: number;
+}
+export interface TierConfig {
+    /** Is this tier enabled for local retention? */
+    enabled: boolean;
+    /** Is this tier enabled for export? */
+    exportEnabled: boolean;
+    /** Sampling rate for this tier (0.0 - 1.0) */
+    sampleRate: number;
+}
+export interface TelemetryPolicy {
+    /** Deployment context */
+    deploymentType: DeploymentTypeEnum;
+    /** Per-tier configuration */
+    tiers: {
+        [TelemetryTier.TIER_1_LOCAL]: TierConfig;
+        [TelemetryTier.TIER_2_OPERATIONAL]: TierConfig;
+        [TelemetryTier.TIER_3_AI_EXPERIENCE]: TierConfig;
+    };
+    /** Tier 3 content export controls (prompts, responses). */
+    tier3Content: Tier3ContentPolicy;
+    /** Enforcement behavior */
+    enforcementMode: EnforcementMode;
+    /** Optional org-specific overrides */
+    orgOverrides?: Record<string, Partial<TelemetryPolicy>>;
+}
+/** Default Tier 3 content policy (enabled with all guardrails) */
+export declare const TIER3_CONTENT_POLICY_DEFAULT: Tier3ContentPolicy;
+/** Tier 3 content policy: disabled (kill switch) */
+export declare const TIER3_CONTENT_POLICY_DISABLED: Tier3ContentPolicy;
+/**
+ * Cloud deployment: all tiers enabled and exported.
+ */
+export declare const CLOUD_DEFAULT_POLICY: TelemetryPolicy;
+/**
+ * Cloud-Prem deployment: Tier 1 local only, Tier 2/3 exported.
+ * Hashing/sanitization handled by OTEL Collector.
+ */
+export declare const CLOUD_PREM_DEFAULT_POLICY: TelemetryPolicy;
+/**
+ * Get the default policy for a deployment type.
+ */
+export declare function getDefaultPolicy(deploymentType: DeploymentTypeEnum): TelemetryPolicy;
+//# sourceMappingURL=policy.d.ts.map

package/dist-esm/types/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/types/policy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,kBAAkB,IAAI,cAAc,EAAE,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,oBAAY,aAAa;IACvB,0EAA0E;IAC1E,YAAY,iBAAiB;IAE7B,sEAAsE;IACtE,kBAAkB,uBAAuB;IAEzC,sFAAsF;IACtF,oBAAoB,yBAAyB;CAC9C;AAED,oBAAY,eAAe;IACzB,+BAA+B;IAC/B,KAAK,UAAU;IACf,uBAAuB;IACvB,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,oBAAoB,EAAE,OAAO,CAAC;IAC9B,wEAAwE;IACxE,sBAAsB,EAAE,OAAO,CAAC;IAChC,gEAAgE;IAChE,0BAA0B,EAAE,OAAO,CAAC;IACpC,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,aAAa,EAAE,OAAO,CAAC;IACvB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,cAAc,EAAE,kBAAkB,CAAC;IAEnC,6BAA6B;IAC7B,KAAK,EAAE;QACL,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC;QACzC,CAAC,aAAa,CAAC,kBAAkB,CAAC,EAAE,UAAU,CAAC;QAC/C,CAAC,aAAa,CAAC,oBAAoB,CAAC,EAAE,UAAU,CAAC;KAClD,CAAC;IAEF,2DAA2D;IAC3D,YAAY,EAAE,kBAAkB,CAAC;IAEjC,2BAA2B;IAC3B,eAAe,EAAE,eAAe,CAAC;IAEjC,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC;CACzD;AAMD,kEAAkE;AAClE,eAAO,MAAM,4BAA4B,EAAE,kBAM1C,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,6BAA6B,EAAE,kBAM3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,eAqBlC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,eAqBvC,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,cAAc,EAAE,kBAAkB,GACjC,eAAe,CASjB"}