@thinkhive/sdk 2.0.1 → 3.1.0

package/dist/integrations/ticket-linking.js

@@ -0,0 +1,259 @@
+"use strict";
+/**
+ * ThinkHive SDK v3.0 - Ticket Linking
+ *
+ * Deterministic linking between runs and support tickets
+ * 7 link methods with explicit confidence scores
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.linking = exports.LINK_METHOD_CONFIDENCE = void 0;
+exports.generateZendeskMarker = generateZendeskMarker;
+exports.parseZendeskMarker = parseZendeskMarker;
+exports.hasZendeskMarker = hasZendeskMarker;
+exports.removeZendeskMarker = removeZendeskMarker;
+exports.linkRunToTicket = linkRunToTicket;
+exports.linkRunToZendeskTicket = linkRunToZendeskTicket;
+exports.getBestLinkMethod = getBestLinkMethod;
+exports.formatLinkConfidence = formatLinkConfidence;
+exports.getConfidenceLevel = getConfidenceLevel;
+const client_1 = require("../core/client");
+// ============================================================================
+// ZENDESK MARKER
+// ============================================================================
+/**
+ * Zendesk marker format: [THID:run_xxx]
+ * Embedded in agent responses for deterministic linking
+ */
+const MARKER_PREFIX = '[THID:';
+const MARKER_SUFFIX = ']';
+const MARKER_REGEX = /\[THID:([a-zA-Z0-9_-]+)\]/;
+/**
+ * Generate a Zendesk marker to embed in agent responses
+ *
+ * @example
+ * ```typescript
+ * const runId = 'run_abc123';
+ * const marker = generateZendeskMarker(runId);
+ * // Returns: '[THID:run_abc123]'
+ *
+ * // Append to your agent response:
+ * const response = `I've found your order. ${marker}`;
+ * ```
+ */
+function generateZendeskMarker(runId) {
+    if (!runId) {
+        throw new Error('Run ID is required to generate Zendesk marker');
+    }
+    return `${MARKER_PREFIX}${runId}${MARKER_SUFFIX}`;
+}
+/**
+ * Parse a Zendesk marker from text
+ *
+ * @example
+ * ```typescript
+ * const text = 'Thank you for contacting us. [THID:run_abc123]';
+ * const runId = parseZendeskMarker(text);
+ * // Returns: 'run_abc123'
+ * ```
+ */
+function parseZendeskMarker(text) {
+    const match = text.match(MARKER_REGEX);
+    return match ? match[1] : null;
+}
+/**
+ * Check if text contains a Zendesk marker
+ */
+function hasZendeskMarker(text) {
+    return MARKER_REGEX.test(text);
+}
+/**
+ * Remove Zendesk marker from text (for clean display)
+ *
+ * @example
+ * ```typescript
+ * const text = 'Thank you! [THID:run_abc123]';
+ * const clean = removeZendeskMarker(text);
+ * // Returns: 'Thank you!'
+ * ```
+ */
+function removeZendeskMarker(text) {
+    return text.replace(MARKER_REGEX, '').trim();
+}
+// ============================================================================
+// LINK METHODS & CONFIDENCE
+// ============================================================================
+/**
+ * Confidence scores for each link method
+ * Based on deterministic linking principles from v3 spec
+ */
+exports.LINK_METHOD_CONFIDENCE = {
+    sdk_explicit: 1.0, // Direct SDK call with ticket ID
+    zendesk_marker: 1.0, // Embedded THID marker in response
+    custom_field: 1.0, // Zendesk custom field
+    middleware_stamp: 0.98, // Middleware-injected trace ID
+    session_match: 0.95, // Session ID correlation
+    email_time_window: 0.6, // Email + 15min window (lowest confidence)
+    manual: 1.0, // Human-assigned
+};
+/**
+ * Linking API client
+ */
+exports.linking = {
+    /**
+     * Create a link between a run and a ticket
+     *
+     * @example
+     * ```typescript
+     * // SDK explicit linking (highest confidence)
+     * const link = await linking.create({
+     *   runId: 'run_abc123',
+     *   ticketId: 'ticket_xyz',
+     *   method: 'sdk_explicit',
+     * });
+     *
+     * // Zendesk marker linking
+     * const link = await linking.create({
+     *   runId: 'run_abc123',
+     *   externalTicketId: '12345',
+     *   platform: 'zendesk',
+     *   method: 'zendesk_marker',
+     * });
+     * ```
+     */
+    async create(input) {
+        return (0, client_1.apiRequestWithData)('/links', {
+            method: 'POST',
+            body: {
+                ...input,
+                confidence: exports.LINK_METHOD_CONFIDENCE[input.method],
+            },
+        });
+    },
+    /**
+     * Get links for a run
+     *
+     * @example
+     * ```typescript
+     * const links = await linking.getForRun('run_abc123');
+     * ```
+     */
+    async getForRun(runId) {
+        return (0, client_1.apiRequestWithData)(`/runs/${runId}/links`);
+    },
+    /**
+     * Get links for a ticket
+     *
+     * @example
+     * ```typescript
+     * const links = await linking.getForTicket('ticket_xyz');
+     * ```
+     */
+    async getForTicket(ticketId) {
+        return (0, client_1.apiRequestWithData)(`/tickets/${ticketId}/links`);
+    },
+    /**
+     * Verify a link (confirm or reject)
+     *
+     * @example
+     * ```typescript
+     * await linking.verify('link_abc123', {
+     *   verified: true,
+     *   notes: 'Confirmed by support agent',
+     * });
+     * ```
+     */
+    async verify(linkId, options) {
+        return (0, client_1.apiRequestWithData)(`/links/${linkId}/verify`, {
+            method: 'POST',
+            body: options,
+        });
+    },
+    /**
+     * Delete a link
+     *
+     * @example
+     * ```typescript
+     * await linking.delete('link_abc123');
+     * ```
+     */
+    async delete(linkId) {
+        await (0, client_1.apiRequest)(`/links/${linkId}`, { method: 'DELETE' });
+    },
+    /**
+     * Auto-link runs to tickets based on available evidence
+     *
+     * @example
+     * ```typescript
+     * const results = await linking.autoLink('run_abc123');
+     * for (const link of results.created) {
+     *   console.log(`Linked to ${link.ticketId} via ${link.method}`);
+     * }
+     * ```
+     */
+    async autoLink(runId) {
+        return (0, client_1.apiRequestWithData)(`/runs/${runId}/auto-link`, {
+            method: 'POST',
+        });
+    },
+};
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+/**
+ * Create SDK explicit link (convenience function)
+ */
+async function linkRunToTicket(runId, ticketId) {
+    return exports.linking.create({
+        runId,
+        ticketId,
+        method: 'sdk_explicit',
+    });
+}
+/**
+ * Create Zendesk link via marker
+ */
+async function linkRunToZendeskTicket(runId, zendeskTicketId) {
+    return exports.linking.create({
+        runId,
+        externalTicketId: zendeskTicketId,
+        platform: 'zendesk',
+        method: 'zendesk_marker',
+    });
+}
+/**
+ * Get the best link method for a given scenario
+ */
+function getBestLinkMethod(available) {
+    if (available.hasTicketId)
+        return 'sdk_explicit';
+    if (available.hasMarker)
+        return 'zendesk_marker';
+    if (available.hasCustomField)
+        return 'custom_field';
+    if (available.hasMiddlewareStamp)
+        return 'middleware_stamp';
+    if (available.hasSessionId)
+        return 'session_match';
+    if (available.hasEmail)
+        return 'email_time_window';
+    return null;
+}
+/**
+ * Format link confidence for display
+ */
+function formatLinkConfidence(confidence) {
+    return `${Math.round(confidence * 100)}%`;
+}
+/**
+ * Get confidence level label
+ */
+function getConfidenceLevel(confidence) {
+    if (confidence >= 1.0)
+        return 'definitive';
+    if (confidence >= 0.95)
+        return 'high';
+    if (confidence >= 0.8)
+        return 'medium';
+    return 'low';
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGlja2V0LWxpbmtpbmcuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW50ZWdyYXRpb25zL3RpY2tldC1saW5raW5nLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQTs7Ozs7R0FLRzs7O0FBOEJILHNEQUtDO0FBWUQsZ0RBR0M7QUFLRCw0Q0FFQztBQVlELGtEQUVDO0FBcU1ELDBDQVNDO0FBS0Qsd0RBVUM7QUFLRCw4Q0FpQkM7QUFLRCxvREFFQztBQUtELGdEQU9DO0FBM1VELDJDQUFnRTtBQUdoRSwrRUFBK0U7QUFDL0UsaUJBQWlCO0FBQ2pCLCtFQUErRTtBQUUvRTs7O0dBR0c7QUFDSCxNQUFNLGFBQWEsR0FBRyxRQUFRLENBQUM7QUFDL0IsTUFBTSxhQUFhLEdBQUcsR0FBRyxDQUFDO0FBQzFCLE1BQU0sWUFBWSxHQUFHLDJCQUEyQixDQUFDO0FBRWpEOzs7Ozs7Ozs7Ozs7R0FZRztBQUNILFNBQWdCLHFCQUFxQixDQUFDLEtBQWE7SUFDakQsSUFBSSxDQUFDLEtBQUssRUFBRSxDQUFDO1FBQ1gsTUFBTSxJQUFJLEtBQUssQ0FBQywrQ0FBK0MsQ0FBQyxDQUFDO0lBQ25FLENBQUM7SUFDRCxPQUFPLEdBQUcsYUFBYSxHQUFHLEtBQUssR0FBRyxhQUFhLEVBQUUsQ0FBQztBQUNwRCxDQUFDO0FBRUQ7Ozs7Ozs7OztHQVNHO0FBQ0gsU0FBZ0Isa0JBQWtCLENBQUMsSUFBWTtJQUM3QyxNQUFNLEtBQUssR0FBRyxJQUFJLENBQUMsS0FBSyxDQUFDLFlBQVksQ0FBQyxDQUFDO0lBQ3ZDLE9BQU8sS0FBSyxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQztBQUNqQyxDQUFDO0FBRUQ7O0dBRUc7QUFDSCxTQUFnQixnQkFBZ0IsQ0FBQyxJQUFZO0lBQzNDLE9BQU8sWUFBWSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQztBQUNqQyxDQUFDO0FBRUQ7Ozs7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Q0FDL0IsU0FPQztJQUVELElBQUksU0FBUyxDQUFDLFdBQVc7UUFBRSxPQUFPLGNBQWMsQ0FBQztJQUNqRCxJQUFJLFNBQVMsQ0FBQyxTQUFTO1FBQUUsT0FBTyxnQkFBZ0IsQ0FBQztJQUNqRCxJQUFJLFNBQVMsQ0FBQyxjQUFjO1FBQUUsT0FBTyxjQUFjLENBQUM7SUFDcEQsSUFBSSxTQUFTLENBQUMsa0JBQWtCO1FBQUUsT0FBTyxrQkFBa0IsQ0FBQztJQUM1RCxJQUFJLFNBQVMsQ0FBQyxZQUFZO1FBQUUsT0FBTyxlQUFlLENBQUM7SUFDbkQsSUFBSSxTQUFTLENBQUMsUUFBUTtRQUFFLE9BQU8sbUJBQW1CLENBQUM7SUFDbkQsT0FBTyxJQUFJLENBQUM7QUFDZCxDQUFDO0FBRUQ7O0dBRUc7QUFDSCxTQUFnQixvQkFBb0IsQ0FBQyxVQUFrQjtJQUNyRCxPQUFPLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxVQUFVLEdBQUcsR0FBRyxDQUFDLEdBQUcsQ0FBQztBQUM1QyxDQUFDO0FBRUQ7O0dBRUc7QUFDSCxTQUFnQixrQkFBa0IsQ0FDaEMsVUFBa0I7SUFFbEIsSUFBSSxVQUFVLElBQUksR0FBRztRQUFFLE9BQU8sWUFBWSxDQUFDO0lBQzNDLElBQUksVUFBVSxJQUFJLElBQUk7UUFBRSxPQUFPLE1BQU0sQ0FBQztJQUN0QyxJQUFJLFVBQVUsSUFBSSxHQUFHO1FBQUUsT0FBTyxRQUFRLENBQUM7SUFDdkMsT0FBTyxLQUFLLENBQUM7QUFDZixDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBUaGlua0hpdmUgU0RLIHYzLjAgLSBUaWNrZXQgTGlua2luZ1xuICpcbiAqIERldGVybWluaXN0aWMgbGlua2luZyBiZXR3ZWVuIHJ1bnMgYW5kIHN1cHBvcnQgdGlja2V0c1xuICogNyBsaW5rIG1ldGhvZHMgd2l0aCBleHBsaWNpdCBjb25maWRlbmNlIHNjb3Jlc1xuICovXG5cbmltcG9ydCB7IGFwaVJlcXVlc3QsIGFwaVJlcXVlc3RXaXRoRGF0YSB9IGZyb20gJy4uL2NvcmUvY2xpZW50JztcbmltcG9ydCB0eXBlIHsgTGlua01ldGhvZCB9IGZyb20gJy4uL2NvcmUvdHlwZXMnO1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBaRU5ERVNLIE1BUktFUlxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG4vKipcbiAqIFplbmRlc2sgbWFya2VyIGZvcm1hdDogW1RISUQ6cnVuX3h4eF1cbiAqIEVtYmVkZGVkIGluIGFnZW50IHJlc3BvbnNlcyBmb3IgZGV0ZXJtaW5pc3RpYyBsaW5raW5nXG4gKi9cbmNvbnN0IE1BUktFUl9QUkVGSVggPSAnW1RISUQ6JztcbmNvbnN0IE1BUktFUl9TVUZGSVggPSAnXSc7XG5jb25zdCBNQVJLRVJfUkVHRVggPSAvXFxbVEhJRDooW2EtekEtWjAtOV8tXSspXFxdLztcblxuLyoqXG4gKiBHZW5lcmF0ZSBhIFplbmRlc2sgbWFya2VyIHRvIGVtYmVkIGluIGFnZW50IHJlc3BvbnNlc1xuICpcbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBjb25zdCBydW5JZCA9ICdydW5fYWJjMTIzJztcbiAqIGNvbnN0IG1hcmtlciA9IGdlbmVyYXRlWmVuZGVza01hcmtlcihydW5JZCk7XG4gKiAvLyBSZXR1cm5zOiAnW1RISUQ6cnVuX2FiYzEyM10nXG4gKlxuICogLy8gQXBwZW5kIHRvIHlvdXIgYWdlbnQgcmVzcG9uc2U6XG4gKiBjb25zdCByZXNwb25zZSA9IGBJJ3ZlIGZvdW5kIHlvdXIgb3JkZXIuICR7bWFya2VyfWA7XG4gKiBgYGBcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdlbmVyYXRlWmVuZGVza01hcmtlcihydW5JZDogc3RyaW5nKTogc3RyaW5nIHtcbiAgaWYgKCFydW5JZCkge1xuICAgIHRocm93IG5ldyBFcnJvcignUnVuIElEIGlzIHJlcXVpcmVkIHRvIGdlbmVyYXRlIFplbmRlc2sgbWFya2VyJyk7XG4gIH1cbiAgcmV0dXJuIGAke01BUktFUl9QUkVGSVh9JHtydW5JZH0ke01BUktFUl9TVUZGSVh9YDtcbn1cblxuLyoqXG4gKiBQYXJzZSBhIFplbmRlc2sgbWFya2VyIGZyb20gdGV4dFxuICpcbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBjb25zdCB0ZXh0ID0gJ1RoYW5rIHlvdSBmb3IgY29udGFjdGluZyB1cy4gW1RISUQ6cnVuX2FiYzEyM10nO1xuICogY29uc3QgcnVuSWQgPSBwYXJzZVplbmRlc2tNYXJrZXIodGV4dCk7XG4gKiAvLyBSZXR1cm5zOiAncnVuX2FiYzEyMydcbiAqIGBgYFxuICovXG5leHBvcnQgZnVuY3Rpb24gcGFyc2VaZW5kZXNrTWFya2VyKHRleHQ6IHN0cmluZyk6IHN0cmluZyB8IG51bGwge1xuICBjb25zdCBtYXRjaCA9IHRleHQubWF0Y2goTUFSS0VSX1JFR0VYKTtcbiAgcmV0dXJuIG1hdGNoID8gbWF0Y2hbMV0gOiBudWxsO1xufVxuXG4vKipcbiAqIENoZWNrIGlmIHRleHQgY29udGFpbnMgYSBaZW5kZXNrIG1hcmtlclxuICovXG5leHBvcnQgZnVuY3Rpb24gaGFzWmVuZGVza01hcmtlcih0ZXh0OiBzdHJpbmcpOiBib29sZWFuIHtcbiAgcmV0dXJuIE1BUktFUl9SRUdFWC50ZXN0KHRleHQpO1xufVxuXG4vKipcbiAqIFJlbW92ZSBaZW5kZXNrIG1hcmtlciBmcm9tIHRleHQgKGZvciBjbGVhbiBkaXNwbGF5KVxuICpcbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBjb25zdCB0ZXh0ID0gJ1RoYW5rIHlvdSEgW1RISUQ6cnVuX2FiYzEyM10nO1xuICogY29uc3QgY2xlYW4gPSByZW1vdmVaZW5kZXNrTWFya2VyKHRleHQpO1xuICogLy8gUmV0dXJuczogJ1RoYW5rIHlvdSEnXG4gKiBgYGBcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHJlbW92ZVplbmRlc2tNYXJrZXIodGV4dDogc3RyaW5nKTogc3RyaW5nIHtcbiAgcmV0dXJuIHRleHQucmVwbGFjZShNQVJLRVJfUkVHRVgsICcnKS50cmltKCk7XG59XG5cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbi8vIExJTksgTUVUSE9EUyAmIENPTkZJREVOQ0Vcbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cblxuLyoqXG4gKiBDb25maWRlbmNlIHNjb3JlcyBmb3IgZWFjaCBsaW5rIG1ldGhvZFxuICogQmFzZWQgb24gZGV0ZXJtaW5pc3RpYyBsaW5raW5nIHByaW5jaXBsZXMgZnJvbSB2MyBzcGVjXG4gKi9cbmV4cG9ydCBjb25zdCBMSU5LX01FVEhPRF9DT05GSURFTkNFOiBSZWNvcmQ8TGlua01ldGhvZCwgbnVtYmVyPiA9IHtcbiAgc2RrX2V4cGxpY2l0OiAxLjAsICAgICAgLy8gRGlyZWN0IFNESyBjYWxsIHdpdGggdGlja2V0IElEXG4gIHplbmRlc2tfbWFya2VyOiAxLjAsICAgIC8vIEVtYmVkZGVkIFRISUQgbWFya2VyIGluIHJlc3BvbnNlXG4gIGN1c3RvbV9maWVsZDogMS4wLCAgICAgIC8vIFplbmRlc2sgY3VzdG9tIGZpZWxkXG4gIG1pZGRsZXdhcmVfc3RhbXA6IDAuOTgsIC8vIE1pZGRsZXdhcmUtaW5qZWN0ZWQgdHJhY2UgSURcbiAgc2Vzc2lvbl9tYXRjaDogMC45NSwgICAgLy8gU2Vzc2lvbiBJRCBjb3JyZWxhdGlvblxuICBlbWFpbF90aW1lX3dpbmRvdzogMC42LCAvLyBFbWFpbCArIDE1bWluIHdpbmRvdyAobG93ZXN0IGNvbmZpZGVuY2UpXG4gIG1hbnVhbDogMS4wLCAgICAgICAgICAgIC8vIEh1bWFuLWFzc2lnbmVkXG59O1xuXG4vKipcbiAqIExpbmsgZXZpZGVuY2Ugc3RydWN0dXJlXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgTGlua0V2aWRlbmNlIHtcbiAgbWV0aG9kOiBMaW5rTWV0aG9kO1xuICBjb25maWRlbmNlOiBudW1iZXI7XG4gIHRpbWVzdGFtcDogc3RyaW5nO1xuICBkZXRhaWxzOiB7XG4gICAgcnVuSWQ/OiBzdHJpbmc7XG4gICAgdGlja2V0SWQ/OiBzdHJpbmc7XG4gICAgZXh0ZXJuYWxUaWNrZXRJZD86IHN0cmluZztcbiAgICBwbGF0Zm9ybT86IHN0cmluZztcbiAgICBzZXNzaW9uSWQ/OiBzdHJpbmc7XG4gICAgZW1haWw/OiBzdHJpbmc7XG4gICAgdGltZVdpbmRvd01pbnV0ZXM/OiBudW1iZXI7XG4gICAgY3VzdG9tRmllbGROYW1lPzogc3RyaW5nO1xuICAgIGN1c3RvbUZpZWxkVmFsdWU/OiBzdHJpbmc7XG4gIH07XG59XG5cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbi8vIExJTktJTkcgQVBJXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbi8qKlxuICogQ3JlYXRlIGxpbmsgaW5wdXRcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBDcmVhdGVMaW5rSW5wdXQge1xuICBydW5JZDogc3RyaW5nO1xuICB0aWNrZXRJZD86IHN0cmluZztcbiAgZXh0ZXJuYWxUaWNrZXRJZD86IHN0cmluZztcbiAgcGxhdGZvcm0/OiAnemVuZGVzaycgfCAnaW50ZXJjb20nIHwgJ3NhbGVzZm9yY2UnIHwgJ2ZyZXNoZGVzayc7XG4gIG1ldGhvZDogTGlua01ldGhvZDtcbiAgZXZpZGVuY2U/OiBQYXJ0aWFsPExpbmtFdmlkZW5jZVsnZGV0YWlscyddPjtcbn1cblxuLyoqXG4gKiBMaW5rIHJlc3BvbnNlXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgTGlua1Jlc3BvbnNlIHtcbiAgaWQ6IHN0cmluZztcbiAgcnVuSWQ6IHN0cmluZztcbiAgdGlja2V0SWQ/OiBzdHJpbmc7XG4gIGV4dGVybmFsVGlja2V0SWQ/OiBzdHJpbmc7XG4gIHBsYXRmb3JtPzogc3RyaW5nO1xuICBtZXRob2Q6IExpbmtNZXRob2Q7XG4gIGNvbmZpZGVuY2U6IG51bWJlcjtcbiAgZXZpZGVuY2U6IExpbmtFdmlkZW5jZTtcbiAgY3JlYXRlZEF0OiBzdHJpbmc7XG59XG5cbi8qKlxuICogTGlua2luZyBBUEkgY2xpZW50XG4gKi9cbmV4cG9ydCBjb25zdCBsaW5raW5nID0ge1xuICAvKipcbiAgICogQ3JlYXRlIGEgbGluayBiZXR3ZWVuIGEgcnVuIGFuZCBhIHRpY2tldFxuICAgKlxuICAgKiBAZXhhbXBsZVxuICAgKiBgYGB0eXBlc2NyaXB0XG4gICAqIC8vIFNESyBleHBsaWNpdCBsaW5raW5nIChoaWdoZXN0IGNvbmZpZGVuY2UpXG4gICAqIGNvbnN0IGxpbmsgPSBhd2FpdCBsaW5raW5nLmNyZWF0ZSh7XG4gICAqICAgcnVuSWQ6ICdydW5fYWJjMTIzJyxcbiAgICogICB0aWNrZXRJZDogJ3RpY2tldF94eXonLFxuICAgKiAgIG1ldGhvZDogJ3Nka19leHBsaWNpdCcsXG4gICAqIH0pO1xuICAgKlxuICAgKiAvLyBaZW5kZXNrIG1hcmtlciBsaW5raW5nXG4gICAqIGNvbnN0IGxpbmsgPSBhd2FpdCBsaW5raW5nLmNyZWF0ZSh7XG4gICAqICAgcnVuSWQ6ICdydW5fYWJjMTIzJyxcbiAgICogICBleHRlcm5hbFRpY2tldElkOiAnMTIzNDUnLFxuICAgKiAgIHBsYXRmb3JtOiAnemVuZGVzaycsXG4gICAqICAgbWV0aG9kOiAnemVuZGVza19tYXJrZXInLFxuICAgKiB9KTtcbiAgICogYGBgXG4gICAqL1xuICBhc3luYyBjcmVhdGUoaW5wdXQ6IENyZWF0ZUxpbmtJbnB1dCk6IFByb21pc2U8TGlua1Jlc3BvbnNlPiB7XG4gICAgcmV0dXJuIGFwaVJlcXVlc3RXaXRoRGF0YTxMaW5rUmVzcG9uc2U+KCcvbGlua3MnLCB7XG4gICAgICBtZXRob2Q6ICdQT1NUJyxcbiAgICAgIGJvZHk6IHtcbiAgICAgICAgLi4uaW5wdXQsXG4gICAgICAgIGNvbmZpZGVuY2U6IExJTktfTUVUSE9EX0NPTkZJREVOQ0VbaW5wdXQubWV0aG9kXSxcbiAgICAgIH0sXG4gICAgfSk7XG4gIH0sXG5cbiAgLyoqXG4gICAqIEdldCBsaW5rcyBmb3IgYSBydW5cbiAgICpcbiAgICogQGV4YW1wbGVcbiAgICogYGBgdHlwZXNjcmlwdFxuICAgKiBjb25zdCBsaW5rcyA9IGF3YWl0IGxpbmtpbmcuZ2V0Rm9yUnVuKCdydW5fYWJjMTIzJyk7XG4gICAqIGBgYFxuICAgKi9cbiAgYXN5bmMgZ2V0Rm9yUnVuKHJ1bklkOiBzdHJpbmcpOiBQcm9taXNlPExpbmtSZXNwb25zZVtdPiB7XG4gICAgcmV0dXJuIGFwaVJlcXVlc3RXaXRoRGF0YTxMaW5rUmVzcG9uc2VbXT4oYC9ydW5zLyR7cnVuSWR9L2xpbmtzYCk7XG4gIH0sXG5cbiAgLyoqXG4gICAqIEdldCBsaW5rcyBmb3IgYSB0aWNrZXRcbiAgICpcbiAgICogQGV4YW1wbGVcbiAgICogYGBgdHlwZXNjcmlwdFxuICAgKiBjb25zdCBsaW5rcyA9IGF3YWl0IGxpbmtpbmcuZ2V0Rm9yVGlja2V0KCd0aWNrZXRfeHl6Jyk7XG4gICAqIGBgYFxuICAgKi9cbiAgYXN5bmMgZ2V0Rm9yVGlja2V0KHRpY2tldElkOiBzdHJpbmcpOiBQcm9taXNlPExpbmtSZXNwb25zZVtdPiB7XG4gICAgcmV0dXJuIGFwaVJlcXVlc3RXaXRoRGF0YTxMaW5rUmVzcG9uc2VbXT4oYC90aWNrZXRzLyR7dGlja2V0SWR9L2xpbmtzYCk7XG4gIH0sXG5cbiAgLyoqXG4gICAqIFZlcmlmeSBhIGxpbmsgKGNvbmZpcm0gb3IgcmVqZWN0KVxuICAgKlxuICAgKiBAZXhhbXBsZVxuICAgKiBgYGB0eXBlc2NyaXB0XG4gICAqIGF3YWl0IGxpbmtpbmcudmVyaWZ5KCdsaW5rX2FiYzEyMycsIHtcbiAgICogICB2ZXJpZmllZDogdHJ1ZSxcbiAgICogICBub3RlczogJ0NvbmZpcm1lZCBieSBzdXBwb3J0IGFnZW50JyxcbiAgICogfSk7XG4gICAqIGBgYFxuICAgKi9cbiAgYXN5bmMgdmVyaWZ5KFxuICAgIGxpbmtJZDogc3RyaW5nLFxuICAgIG9wdGlvbnM6IHsgdmVyaWZpZWQ6IGJvb2xlYW47IG5vdGVzPzogc3RyaW5nIH1cbiAgKTogUHJvbWlzZTx7IGxpbmtJZDogc3RyaW5nOyB2ZXJpZmllZDogYm9vbGVhbjsgbWVzc2FnZTogc3RyaW5nIH0+IHtcbiAgICByZXR1cm4gYXBpUmVxdWVzdFdpdGhEYXRhKGAvbGlua3MvJHtsaW5rSWR9L3ZlcmlmeWAsIHtcbiAgICAgIG1ldGhvZDogJ1BPU1QnLFxuICAgICAgYm9keTogb3B0aW9ucyxcbiAgICB9KTtcbiAgfSxcblxuICAvKipcbiAgICogRGVsZXRlIGEgbGlua1xuICAgKlxuICAgKiBAZXhhbXBsZVxuICAgKiBgYGB0eXBlc2NyaXB0XG4gICAqIGF3YWl0IGxpbmtpbmcuZGVsZXRlKCdsaW5rX2FiYzEyMycpO1xuICAgKiBgYGBcbiAgICovXG4gIGFzeW5jIGRlbGV0ZShsaW5rSWQ6IHN0cmluZyk6IFByb21pc2U8dm9pZD4ge1xuICAgIGF3YWl0IGFwaVJlcXVlc3QoYC9saW5rcy8ke2xpbmtJZH1gLCB7IG1ldGhvZDogJ0RFTEVURScgfSk7XG4gIH0sXG5cbiAgLyoqXG4gICAqIEF1dG8tbGluayBydW5zIHRvIHRpY2tldHMgYmFzZWQgb24gYXZhaWxhYmxlIGV2aWRlbmNlXG4gICAqXG4gICAqIEBleGFtcGxlXG4gICAqIGBgYHR5cGVzY3JpcHRcbiAgICogY29uc3QgcmVzdWx0cyA9IGF3YWl0IGxpbmtpbmcuYXV0b0xpbmsoJ3J1bl9hYmMxMjMnKTtcbiAgICogZm9yIChjb25zdCBsaW5rIG9mIHJlc3VsdHMuY3JlYXRlZCkge1xuICAgKiAgIGNvbnNvbGUubG9nKGBMaW5rZWQgdG8gJHtsaW5rLnRpY2tldElkfSB2aWEgJHtsaW5rLm1ldGhvZH1gKTtcbiAgICogfVxuICAgKiBgYGBcbiAgICovXG4gIGFzeW5jIGF1dG9MaW5rKHJ1bklkOiBzdHJpbmcpOiBQcm9taXNlPHtcbiAgICBydW5JZDogc3RyaW5nO1xuICAgIGNyZWF0ZWQ6IExpbmtSZXNwb25zZVtdO1xuICAgIGNhbmRpZGF0ZXM6IEFycmF5PHtcbiAgICAgIHRpY2tldElkOiBzdHJpbmc7XG4gICAgICBtZXRob2Q6IExpbmtNZXRob2Q7XG4gICAgICBjb25maWRlbmNlOiBudW1iZXI7XG4gICAgICByZWFzb246IHN0cmluZztcbiAgICB9PjtcbiAgfT4ge1xuICAgIHJldHVybiBhcGlSZXF1ZXN0V2l0aERhdGEoYC9ydW5zLyR7cnVuSWR9L2F1dG8tbGlua2AsIHtcbiAgICAgIG1ldGhvZDogJ1BPU1QnLFxuICAgIH0pO1xuICB9LFxufTtcblxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuLy8gSEVMUEVSIEZVTkNUSU9OU1xuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG4vKipcbiAqIENyZWF0ZSBTREsgZXhwbGljaXQgbGluayAoY29udmVuaWVuY2UgZnVuY3Rpb24pXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBsaW5rUnVuVG9UaWNrZXQoXG4gIHJ1bklkOiBzdHJpbmcsXG4gIHRpY2tldElkOiBzdHJpbmdcbik6IFByb21pc2U8TGlua1Jlc3BvbnNlPiB7XG4gIHJldHVybiBsaW5raW5nLmNyZWF0ZSh7XG4gICAgcnVuSWQsXG4gICAgdGlja2V0SWQsXG4gICAgbWV0aG9kOiAnc2RrX2V4cGxpY2l0JyxcbiAgfSk7XG59XG5cbi8qKlxuICogQ3JlYXRlIFplbmRlc2sgbGluayB2aWEgbWFya2VyXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBsaW5rUnVuVG9aZW5kZXNrVGlja2V0KFxuICBydW5JZDogc3RyaW5nLFxuICB6ZW5kZXNrVGlja2V0SWQ6IHN0cmluZ1xuKTogUHJvbWlzZTxMaW5rUmVzcG9uc2U+IHtcbiAgcmV0dXJuIGxpbmtpbmcuY3JlYXRlKHtcbiAgICBydW5JZCxcbiAgICBleHRlcm5hbFRpY2tldElkOiB6ZW5kZXNrVGlja2V0SWQsXG4gICAgcGxhdGZvcm06ICd6ZW5kZXNrJyxcbiAgICBtZXRob2Q6ICd6ZW5kZXNrX21hcmtlcicsXG4gIH0pO1xufVxuXG4vKipcbiAqIEdldCB0aGUgYmVzdCBsaW5rIG1ldGhvZCBmb3IgYSBnaXZlbiBzY2VuYXJpb1xuICovXG5leHBvcnQgZnVuY3Rpb24gZ2V0QmVzdExpbmtNZXRob2QoXG4gIGF2YWlsYWJsZToge1xuICAgIGhhc1RpY2tldElkOiBib29sZWFuO1xuICAgIGhhc01hcmtlcjogYm9vbGVhbjtcbiAgICBoYXNDdXN0b21GaWVsZDogYm9vbGVhbjtcbiAgICBoYXNNaWRkbGV3YXJlU3RhbXA6IGJvb2xlYW47XG4gICAgaGFzU2Vzc2lvbklkOiBib29sZWFuO1xuICAgIGhhc0VtYWlsOiBib29sZWFuO1xuICB9XG4pOiBMaW5rTWV0aG9kIHwgbnVsbCB7XG4gIGlmIChhdmFpbGFibGUuaGFzVGlja2V0SWQpIHJldHVybiAnc2RrX2V4cGxpY2l0JztcbiAgaWYgKGF2YWlsYWJsZS5oYXNNYXJrZXIpIHJldHVybiAnemVuZGVza19tYXJrZXInO1xuICBpZiAoYXZhaWxhYmxlLmhhc0N1c3RvbUZpZWxkKSByZXR1cm4gJ2N1c3RvbV9maWVsZCc7XG4gIGlmIChhdmFpbGFibGUuaGFzTWlkZGxld2FyZVN0YW1wKSByZXR1cm4gJ21pZGRsZXdhcmVfc3RhbXAnO1xuICBpZiAoYXZhaWxhYmxlLmhhc1Nlc3Npb25JZCkgcmV0dXJuICdzZXNzaW9uX21hdGNoJztcbiAgaWYgKGF2YWlsYWJsZS5oYXNFbWFpbCkgcmV0dXJuICdlbWFpbF90aW1lX3dpbmRvdyc7XG4gIHJldHVybiBudWxsO1xufVxuXG4vKipcbiAqIEZvcm1hdCBsaW5rIGNvbmZpZGVuY2UgZm9yIGRpc3BsYXlcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGZvcm1hdExpbmtDb25maWRlbmNlKGNvbmZpZGVuY2U6IG51bWJlcik6IHN0cmluZyB7XG4gIHJldHVybiBgJHtNYXRoLnJvdW5kKGNvbmZpZGVuY2UgKiAxMDApfSVgO1xufVxuXG4vKipcbiAqIEdldCBjb25maWRlbmNlIGxldmVsIGxhYmVsXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBnZXRDb25maWRlbmNlTGV2ZWwoXG4gIGNvbmZpZGVuY2U6IG51bWJlclxuKTogJ2RlZmluaXRpdmUnIHwgJ2hpZ2gnIHwgJ21lZGl1bScgfCAnbG93JyB7XG4gIGlmIChjb25maWRlbmNlID49IDEuMCkgcmV0dXJuICdkZWZpbml0aXZlJztcbiAgaWYgKGNvbmZpZGVuY2UgPj0gMC45NSkgcmV0dXJuICdoaWdoJztcbiAgaWYgKGNvbmZpZGVuY2UgPj0gMC44KSByZXR1cm4gJ21lZGl1bSc7XG4gIHJldHVybiAnbG93Jztcbn1cbiJdfQ==

package/package.json

@@ -1,19 +1,45 @@
 {
   "name": "@thinkhive/sdk",
-  "version": "2.0.1",
-  "publishConfig": {
-    "access": "public"
-  },
-  "description": "ThinkHive SDK - AI Agent Observability Platform with explainability, RAG evaluation, and business impact analysis",
+  "version": "3.1.0",
+  "description": "ThinkHive SDK v3.1 - AI agent observability supporting 25 trace formats including LangSmith, Langfuse, Opik, Braintrust, Datadog, MLflow, and more",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./instrumentation/openai": {
+      "require": "./dist/instrumentation/openai.js",
+      "types": "./dist/instrumentation/openai.d.ts"
+    },
+    "./instrumentation/langchain": {
+      "require": "./dist/instrumentation/langchain.js",
+      "types": "./dist/instrumentation/langchain.d.ts"
+    },
+    "./integrations/ticket-linking": {
+      "require": "./dist/integrations/ticket-linking.js",
+      "types": "./dist/integrations/ticket-linking.d.ts"
+    },
+    "./integrations/customer-context": {
+      "require": "./dist/integrations/customer-context.js",
+      "types": "./dist/integrations/customer-context.d.ts"
+    }
+  },
   "files": [
     "dist",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "MIGRATION.md"
   ],
   "scripts": {
-    "test": "echo \"No tests yet\" && exit 0"
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit"
   },
   "keywords": [
     "thinkhive",
@@ -27,9 +53,15 @@
     "hallucination-detection",
     "business-impact",
     "langchain",
+    "langgraph",
     "openai",
     "anthropic",
-    "agent"
+    "agent",
+    "facts-vs-inferences",
+    "calibration",
+    "zendesk",
+    "intercom",
+    "customer-support"
   ],
   "author": "ThinkHive <support@thinkhive.ai>",
   "license": "MIT",
@@ -42,7 +74,7 @@
     "url": "https://github.com/thinkhive/thinkhive-js/issues"
   },
   "engines": {
-    "node": ">=16.0.0"
+    "node": ">=18.0.0"
   },
   "dependencies": {
     "@opentelemetry/api": "^1.8.0",
@@ -50,5 +82,25 @@
     "@opentelemetry/resources": "^1.21.0",
     "@opentelemetry/sdk-trace-node": "^1.21.0",
     "@opentelemetry/sdk-trace-base": "^1.21.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0",
+    "eslint": "^8.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0"
+  },
+  "peerDependencies": {
+    "openai": ">=4.0.0",
+    "@langchain/core": ">=0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "openai": {
+      "optional": true
+    },
+    "@langchain/core": {
+      "optional": true
+    }
   }
 }