@superblocksteam/vite-plugin-file-sync 2.0.82 → 2.0.83-next.1

package/dist/ai-service/llmobs/otel-exporter.d.ts

@@ -5,20 +5,43 @@
  * for export via OTEL collector. Used in CLOUD_PREM deployments where direct
  * Datadog API access is not available.
  *
- * This uses the SpanInterceptor pattern from test-utils/span-interceptor.ts:
- * - Patches LLMObsSpanWriter.prototype.flush to capture span events
- * - Converts span events to OTEL spans with llmobs.* attributes
- * - Drops original spans to prevent Datadog LLMObs API submission
+ * TIERED TELEMETRY ARCHITECTURE (v0.3.0):
+ *
+ * This exporter emits FULL-FIDELITY spans to the OTEL Collector with the
+ * `include_tier3` tier policy hint. The Collector is responsible for tier separation:
+ *
+ * - Tier 1: Full data (prompts, user-email, org-id) → Customer's local observability
+ * - Tier 2: Sanitized data (hashed IDs, no content) → Superblocks-managed observability
+ * - Tier 3: AI content with identity stripped → AI quality analysis
+ *
+ * The SDK's job is to:
+ * 1. Convert LLMObs spans to OTEL format
+ * 2. Emit ALL data (including content and identity)
+ * 3. Use gen_ai.* semantic conventions ONLY (no legacy llm.* prefixes)
+ * 4. Set `superblocks.tier_hint: "include_tier3"` for AI quality analysis
+ *
+ * The Collector's job is to:
+ * 1. Hash identity attributes (user-email → user.hash) for Tier 2
+ * 2. Strip forbidden attributes (llmobs.input, llmobs.output) for Tier 2
+ * 3. Strip identity (no hashing) for Tier 3, but preserve content
+ * 4. Route to appropriate tier pipelines based on tier_hint
+ *
+ * Contract: tier2-traces.v0.3.0.json
+ * See also: sdk-tier-policy-hints.md
  */
 /**
  * Converts LLMObs spans to OTEL spans for CLOUD_PREM deployments.
  *
+ * This exporter emits FULL-FIDELITY spans. The OTEL Collector handles
+ * tier separation (hashing, stripping, routing).
+ *
  * When initialized, patches LLMObsSpanWriter.flush to:
  * 1. Intercept all buffered span events
- * 2. Convert each to an OTEL span with llmobs.* attributes
- * 3. Drop original spans (prevent Datadog LLMObs API submission)
+ * 2. Convert each to a FULL OTEL span with gen_ai.* attributes
+ * 3. Include identity and content (Collector will sanitize for Tier 2)
+ * 4. Drop original spans (prevent Datadog LLMObs API submission)
  */
-declare class LLMObsOtelExporter {
+export declare class LLMObsOtelExporter {
     private originalFlush;
     /**
      * Get the OTEL tracer lazily to ensure it's fetched after NodeSDK is started.
@@ -31,14 +54,86 @@ declare class LLMObsOtelExporter {
      */
     init(): Promise<void>;
     /**
-     * Convert an LLMObs span event to an OTEL span.
+     * Emit a FULL-FIDELITY OTEL span from an LLMObs event.
+     *
+     * This method includes ALL data - the Collector is responsible for
+     * sanitizing and routing to the appropriate tier.
+     *
+     * Attributes emitted (gen_ai.* only, per v0.3.0 contract):
+     * - gen_ai.system (provider)
+     * - gen_ai.request.model
+     * - gen_ai.operation.name
+     * - gen_ai.usage.* (token counts)
+     * - gen_ai.request.status
+     * - gen_ai.client.duration_ms
+     * - gen_ai.error.category
+     * - gen_ai.response.finish_reasons
+     * - gen_ai.client.time_to_first_token
+     *
+     * Identity attributes (Collector will hash for Tier 2):
+     * - user-email
+     * - organization-id
+     * - application-id
+     * - session.id
      *
-     * The span is created with:
-     * - Correct timing (start time and duration from original span)
-     * - All LLMObs data as llmobs.* attributes
-     * - Model info, input/output, metadata, and metrics preserved
+     * Content attributes (Collector will strip for Tier 2):
+     * - llmobs.input
+     * - llmobs.output
+     */
+    private emitFullFidelitySpan;
+    /**
+     * Map LLMObs span name to contract-defined span pattern.
+     * Uses gen_ai.* naming per v0.3.0 contract.
+     */
+    private mapToSpanName;
+    /**
+     * Extract token metrics with gen_ai.usage.* naming.
+     */
+    private extractTokenMetrics;
+    /**
+     * Extract identity attributes from tags.
+     * These will be hashed by the Collector for Tier 2.
+     */
+    private extractIdentityFromTags;
+    /**
+     * Normalize provider to OTEL gen_ai.system canonical names.
      */
-    private convertToOtelSpan;
+    private normalizeSystem;
+    /**
+     * Extract operation name from event.
+     * Maps span kind to OTEL gen_ai.operation.name values.
+     */
+    private extractOperationName;
+    /**
+     * Extract error category from event metadata.
+     */
+    private extractErrorCategory;
+    /**
+     * Extract finish reason from event.
+     */
+    private extractFinishReason;
+    /**
+     * Extract time to first token from event metadata.
+     * Returns value in seconds (OTEL convention).
+     */
+    private extractTimeToFirstToken;
+    /**
+     * Safely stringify a value for span attributes.
+     */
+    private safeStringify;
+    /**
+     * Truncate an attribute value to MAX_ATTRIBUTE_LENGTH.
+     * Prevents OTEL Collector rejection and memory pressure from very large values.
+     */
+    private truncateAttribute;
+    /**
+     * Validate error category is in the allowed enum.
+     */
+    private isValidErrorCategory;
+    /**
+     * Validate finish reason is in the allowed enum.
+     */
+    private isValidFinishReason;
     /**
      * Filter out undefined values from attributes object.
      */
@@ -52,7 +147,9 @@ declare class LLMObsOtelExporter {
 /**
  * Singleton instance of the LLMObs-to-OTEL exporter.
  * Call llmobsOtelExporter.init() in CLOUD_PREM mode to enable.
+ *
+ * NOTE: This exporter emits FULL-FIDELITY spans.
+ * The OTEL Collector handles tier separation (hashing, stripping, routing).
  */
 export declare const llmobsOtelExporter: LLMObsOtelExporter;
-export {};
 //# sourceMappingURL=otel-exporter.d.ts.map

package/dist/ai-service/llmobs/otel-exporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"otel-exporter.d.ts","sourceRoot":"","sources":["../../../src/ai-service/llmobs/otel-exporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAuDH;;;;;;;GAOG;AACH,cAAM,kBAAkB;IACtB,OAAO,CAAC,aAAa,CAA+C;IAEpE;;;OAGG;IACH,OAAO,KAAK,UAAU,GAErB;IAED;;;OAGG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsClC;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IAgFzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;;OAGG;IACI,OAAO,IAAI,IAAI;CAOvB;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}
+{"version":3,"file":"otel-exporter.d.ts","sourceRoot":"","sources":["../../../src/ai-service/llmobs/otel-exporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AA2JH;;;;;;;;;;;GAWG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,aAAa,CAA+C;IAEpE;;;OAGG;IACH,OAAO,KAAK,UAAU,GAErB;IAED;;;OAGG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAyClC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,OAAO,CAAC,oBAAoB;IAmF5B;;;OAGG;IACH,OAAO,CAAC,aAAa;IAgCrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyD3B;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IA8C/B;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAoB5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA0B5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAwB3B;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IA2B/B;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;;OAGG;IACI,OAAO,IAAI,IAAI;CAOvB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}