@uipath/common 1.199.0-preview.106 → 1.199.0-preview.108

package/dist/index.browser.d.ts

@@ -26,7 +26,7 @@ export * from "./telemetry/command-attribution.js";
 export * from "./telemetry/command-terminal.js";
 export { ConsoleTelemetryProvider } from "./telemetry/console-telemetry-provider.js";
 export type { IContextStorage } from "./telemetry/context-storage.js";
-export { getConfiguredTelemetrySessionId, getTelemetrySessionId, resolveTelemetrySessionId, TELEMETRY_SESSION_ID_ENV, TELEMETRY_SESSION_ID_PROPERTY, } from "./telemetry/session-id.js";
+export { getConfiguredTelemetrySessionId, getTelemetrySessionId, getTelemetrySessionSource, TELEMETRY_SESSION_ID_ENV, TELEMETRY_SESSION_SOURCE_PROPERTY, } from "./telemetry/session-id.js";
 export * from "./telemetry/telemetry-events.js";
 export type { ITelemetryProvider } from "./telemetry/telemetry-provider.js";
 export type { ITelemetryService, TelemetryContext, TelemetryProperties, } from "./telemetry/telemetry-service.js";

package/dist/index.browser.js

@@ -22842,8 +22842,18 @@ function getInboundTraceContext() {
 
 // src/telemetry/session-id.ts
 var TELEMETRY_SESSION_ID_ENV = "UIPATH_SESSION_ID";
-var TELEMETRY_SESSION_ID_PROPERTY = "session_id";
-var telemetrySessionIdSlot = singleton("TelemetrySessionId");
+var SESSION_ID_MAX_LENGTH = 64;
+var RANDOM_SESSION_ID_LENGTH = 32;
+var TELEMETRY_SESSION_SOURCE_PROPERTY = "session_id_source";
+var CONTROL_CHARACTERS = /\p{Cc}/gu;
+var INHERITED_SESSION_SOURCES = [
+  { envVar: "CLAUDE_CODE_SESSION_ID", source: "claude-code" },
+  { envVar: "CODEX_THREAD_ID", source: "codex" },
+  { envVar: "ANTIGRAVITY_TRAJECTORY_ID", source: "antigravity" },
+  { envVar: "TERM_SESSION_ID", source: "terminal" },
+  { envVar: "WT_SESSION", source: "terminal" }
+];
+var telemetrySessionSlot = singleton("TelemetrySession");
 var telemetryOperationIdSlot = singleton("TelemetryOperationId");
 function getProcessEnv2() {
   return globalThis.process?.env;
@@ -22852,27 +22862,45 @@ function normalizeSessionId(value) {
   if (typeof value !== "string" && typeof value !== "number" && typeof value !== "boolean") {
     return;
   }
-  const trimmed = String(value).trim();
-  return trimmed || undefined;
+  const cleaned = String(value).replace(CONTROL_CHARACTERS, "").trim().slice(0, SESSION_ID_MAX_LENGTH);
+  return cleaned || undefined;
 }
 function getConfiguredTelemetrySessionId() {
   return normalizeSessionId(getProcessEnv2()?.[TELEMETRY_SESSION_ID_ENV]);
 }
-function getTelemetrySessionId() {
-  const envSessionId = getConfiguredTelemetrySessionId();
-  if (envSessionId) {
-    return envSessionId;
+function getInheritedSession(env2) {
+  for (const candidate of INHERITED_SESSION_SOURCES) {
+    const handle = normalizeSessionId(env2[candidate.envVar]);
+    if (handle) {
+      return { id: handle, source: candidate.source };
+    }
+  }
+  return;
+}
+function generateRandomSession() {
+  const bytes = new Uint8Array(RANDOM_SESSION_ID_LENGTH / 2);
+  crypto.getRandomValues(bytes);
+  let hex = "";
+  for (const byte of bytes) {
+    hex += byte.toString(16).padStart(2, "0");
   }
-  const existing = telemetrySessionIdSlot.get();
+  return { id: hex, source: "random" };
+}
+function resolveTelemetrySession() {
+  const existing = telemetrySessionSlot.get();
   if (existing) {
     return existing;
   }
-  const generated = crypto.randomUUID();
-  telemetrySessionIdSlot.set(generated);
-  return generated;
+  const declaredHandle = getConfiguredTelemetrySessionId();
+  const resolved = declaredHandle ? { id: declaredHandle, source: "declared" } : getInheritedSession(getProcessEnv2() ?? {}) ?? generateRandomSession();
+  telemetrySessionSlot.set(resolved);
+  return resolved;
+}
+function getTelemetrySessionId() {
+  return resolveTelemetrySession().id;
 }
-function resolveTelemetrySessionId(existingSessionId) {
-  return getConfiguredTelemetrySessionId() ?? normalizeSessionId(existingSessionId);
+function getTelemetrySessionSource() {
+  return resolveTelemetrySession().source;
 }
 function getTelemetryOperationId() {
   const existing = telemetryOperationIdSlot.get();
@@ -23278,24 +23306,18 @@ class TelemetryService {
   }
   enrichPropertiesWithContext(properties, context) {
     const globalProperties = getGlobalTelemetryProperties();
-    const existingSessionId = properties?.[TELEMETRY_SESSION_ID_PROPERTY] ?? this.defaultProperties?.[TELEMETRY_SESSION_ID_PROPERTY] ?? globalProperties?.[TELEMETRY_SESSION_ID_PROPERTY];
-    const sessionId = resolveTelemetrySessionId(existingSessionId);
     const enriched = {
       ...getExecutionContextTelemetryProperties(),
       ...globalProperties,
       ...this.defaultProperties,
       ...redactProperties(properties ?? {}),
+      [TELEMETRY_SESSION_SOURCE_PROPERTY]: getTelemetrySessionSource(),
       ...context ? {
         [TELEMETRY_OPERATION_ID_PROPERTY]: context.operationId,
         ...context.parentId !== undefined ? { [TELEMETRY_PARENT_ID_PROPERTY]: context.parentId } : {},
         [TELEMETRY_SPAN_ID_PROPERTY]: context.id
       } : {}
     };
-    if (sessionId === undefined) {
-      delete enriched[TELEMETRY_SESSION_ID_PROPERTY];
-    } else {
-      enriched[TELEMETRY_SESSION_ID_PROPERTY] = sessionId;
-    }
     return enriched;
   }
   generateId() {
@@ -23337,7 +23359,6 @@ export {
   setGlobalLogFilePath,
   runWithSink,
   restoreConsole,
-  resolveTelemetrySessionId,
   resolveEnvReference,
   resetLoggerInstance,
   registerPackageMetadataOptions,
@@ -23363,6 +23384,7 @@ export {
   installSdkCodingAgentHeader,
   installConsoleGuard,
   hashContent,
+  getTelemetrySessionSource,
   getTelemetrySessionId,
   getSdkUserAgentToken,
   getRecordedCommandFailureTelemetry,
@@ -23399,7 +23421,7 @@ export {
   addSdkCodingAgentHeader,
   UIPATH_HOME_DIR,
   TelemetryService,
-  TELEMETRY_SESSION_ID_PROPERTY,
+  TELEMETRY_SESSION_SOURCE_PROPERTY,
   TELEMETRY_SESSION_ID_ENV,
   ScreenLogger,
   PollOutcome,
@@ -23421,4 +23443,4 @@ export {
   AUTH_FILENAME
 };
 
-//# debugId=5714488353CEE82464756E2164756E21
+//# debugId=04886234C3E93F8264756E2164756E21

package/dist/index.js

@@ -9476,8 +9476,18 @@ function getInboundTraceContext() {
 
 // src/telemetry/session-id.ts
 var TELEMETRY_SESSION_ID_ENV = "UIPATH_SESSION_ID";
-var TELEMETRY_SESSION_ID_PROPERTY = "session_id";
-var telemetrySessionIdSlot = singleton("TelemetrySessionId");
+var SESSION_ID_MAX_LENGTH = 64;
+var RANDOM_SESSION_ID_LENGTH = 32;
+var TELEMETRY_SESSION_SOURCE_PROPERTY = "session_id_source";
+var CONTROL_CHARACTERS = /\p{Cc}/gu;
+var INHERITED_SESSION_SOURCES = [
+  { envVar: "CLAUDE_CODE_SESSION_ID", source: "claude-code" },
+  { envVar: "CODEX_THREAD_ID", source: "codex" },
+  { envVar: "ANTIGRAVITY_TRAJECTORY_ID", source: "antigravity" },
+  { envVar: "TERM_SESSION_ID", source: "terminal" },
+  { envVar: "WT_SESSION", source: "terminal" }
+];
+var telemetrySessionSlot = singleton("TelemetrySession");
 var telemetryOperationIdSlot = singleton("TelemetryOperationId");
 function getProcessEnv2() {
   return globalThis.process?.env;
@@ -9486,27 +9496,45 @@ function normalizeSessionId(value) {
   if (typeof value !== "string" && typeof value !== "number" && typeof value !== "boolean") {
     return;
   }
-  const trimmed = String(value).trim();
-  return trimmed || undefined;
+  const cleaned = String(value).replace(CONTROL_CHARACTERS, "").trim().slice(0, SESSION_ID_MAX_LENGTH);
+  return cleaned || undefined;
 }
 function getConfiguredTelemetrySessionId() {
   return normalizeSessionId(getProcessEnv2()?.[TELEMETRY_SESSION_ID_ENV]);
 }
-function getTelemetrySessionId() {
-  const envSessionId = getConfiguredTelemetrySessionId();
-  if (envSessionId) {
-    return envSessionId;
+function getInheritedSession(env) {
+  for (const candidate of INHERITED_SESSION_SOURCES) {
+    const handle = normalizeSessionId(env[candidate.envVar]);
+    if (handle) {
+      return { id: handle, source: candidate.source };
+    }
+  }
+  return;
+}
+function generateRandomSession() {
+  const bytes = new Uint8Array(RANDOM_SESSION_ID_LENGTH / 2);
+  crypto.getRandomValues(bytes);
+  let hex = "";
+  for (const byte of bytes) {
+    hex += byte.toString(16).padStart(2, "0");
   }
-  const existing = telemetrySessionIdSlot.get();
+  return { id: hex, source: "random" };
+}
+function resolveTelemetrySession() {
+  const existing = telemetrySessionSlot.get();
   if (existing) {
     return existing;
   }
-  const generated = crypto.randomUUID();
-  telemetrySessionIdSlot.set(generated);
-  return generated;
+  const declaredHandle = getConfiguredTelemetrySessionId();
+  const resolved = declaredHandle ? { id: declaredHandle, source: "declared" } : getInheritedSession(getProcessEnv2() ?? {}) ?? generateRandomSession();
+  telemetrySessionSlot.set(resolved);
+  return resolved;
 }
-function resolveTelemetrySessionId(existingSessionId) {
-  return getConfiguredTelemetrySessionId() ?? normalizeSessionId(existingSessionId);
+function getTelemetrySessionId() {
+  return resolveTelemetrySession().id;
+}
+function getTelemetrySessionSource() {
+  return resolveTelemetrySession().source;
 }
 function getTelemetryOperationId() {
   const existing = telemetryOperationIdSlot.get();
@@ -9787,24 +9815,18 @@ class TelemetryService {
   }
   enrichPropertiesWithContext(properties, context) {
     const globalProperties = getGlobalTelemetryProperties();
-    const existingSessionId = properties?.[TELEMETRY_SESSION_ID_PROPERTY] ?? this.defaultProperties?.[TELEMETRY_SESSION_ID_PROPERTY] ?? globalProperties?.[TELEMETRY_SESSION_ID_PROPERTY];
-    const sessionId = resolveTelemetrySessionId(existingSessionId);
     const enriched = {
       ...getExecutionContextTelemetryProperties(),
       ...globalProperties,
       ...this.defaultProperties,
       ...redactProperties(properties ?? {}),
+      [TELEMETRY_SESSION_SOURCE_PROPERTY]: getTelemetrySessionSource(),
       ...context ? {
         [TELEMETRY_OPERATION_ID_PROPERTY]: context.operationId,
         ...context.parentId !== undefined ? { [TELEMETRY_PARENT_ID_PROPERTY]: context.parentId } : {},
         [TELEMETRY_SPAN_ID_PROPERTY]: context.id
       } : {}
     };
-    if (sessionId === undefined) {
-      delete enriched[TELEMETRY_SESSION_ID_PROPERTY];
-    } else {
-      enriched[TELEMETRY_SESSION_ID_PROPERTY] = sessionId;
-    }
     return enriched;
   }
   generateId() {
@@ -10042,16 +10064,6 @@ class NodeAppInsightsTelemetryProvider {
     }
     return { operationId, parentId, spanId };
   }
-  promoteSessionTag(merged, tags) {
-    const client = this.client;
-    if (!client || !merged)
-      return;
-    const sessionId = merged[TELEMETRY_SESSION_ID_PROPERTY];
-    delete merged[TELEMETRY_SESSION_ID_PROPERTY];
-    if (sessionId) {
-      tags[client.context.keys.sessionId] = sessionId;
-    }
-  }
   leafTagOverrides(properties) {
     const client = this.client;
     if (!client)
@@ -10064,7 +10076,6 @@ class NodeAppInsightsTelemetryProvider {
     if (spanId) {
       tags[keys.operationParentId] = spanId;
     }
-    this.promoteSessionTag(properties, tags);
     return tags;
   }
   operationCorrelation(properties) {
@@ -10079,7 +10090,6 @@ class NodeAppInsightsTelemetryProvider {
     if (parentId) {
       tagOverrides[keys.operationParentId] = parentId;
     }
-    this.promoteSessionTag(properties, tagOverrides);
     return { tagOverrides, id: spanId };
   }
   async trackEvent(eventName, properties) {
@@ -12346,7 +12356,6 @@ export {
   runValidators,
   runChecks,
   restoreConsole,
-  resolveTelemetrySessionId,
   resolveEnvReference,
   resolveDeprecatedOptionAlias,
   resolveAttachmentInputs,
@@ -12391,6 +12400,7 @@ export {
   installSdkCodingAgentHeader,
   installConsoleGuard,
   hashContent,
+  getTelemetrySessionSource,
   getTelemetrySessionId,
   getSdkUserAgentToken,
   getRecordedCommandFailureTelemetry,
@@ -12444,7 +12454,7 @@ export {
   TelemetryService,
   TELEMETRY_TRACEPARENT_ENV,
   TELEMETRY_SPAN_ID_PROPERTY,
-  TELEMETRY_SESSION_ID_PROPERTY,
+  TELEMETRY_SESSION_SOURCE_PROPERTY,
   TELEMETRY_SESSION_ID_ENV,
   TELEMETRY_PARENT_ID_PROPERTY,
   TELEMETRY_OPERATION_ID_PROPERTY,
@@ -12483,4 +12493,4 @@ export {
   ATTACHMENT_INSTRUCTIONS
 };
 
-//# debugId=0104AD30EA6F6A7264756E2164756E21
+//# debugId=6E7A3372F0CCF5B264756E2164756E21

package/dist/telemetry/index.d.ts

@@ -5,7 +5,7 @@ export type { IContextStorage } from "./context-storage.js";
 export { buildEnvironmentProperties, type NormalizedEnvironment, normalizeBaseUrl, normalizeEnvironment, } from "./environment-info.js";
 export { type CiProvider, detectExecutionContext, EXECUTION_CONTEXT_VALUES, type ExecutionContext, type ExecutionContextDetection, type ExecutionContextDetectionOptions, getExecutionContextTelemetryProperties, setExecutionContextAuthSignal, } from "./execution-context.js";
 export { redactError, redactProperties, redactProperty, redactValue, } from "./pii-redactor.js";
-export { getConfiguredTelemetrySessionId, getTelemetrySessionId, resolveTelemetrySessionId, TELEMETRY_SESSION_ID_ENV, TELEMETRY_SESSION_ID_PROPERTY, } from "./session-id.js";
+export { getConfiguredTelemetrySessionId, getTelemetrySessionId, getTelemetrySessionSource, TELEMETRY_SESSION_ID_ENV, TELEMETRY_SESSION_SOURCE_PROPERTY, } from "./session-id.js";
 export type { ITelemetryProvider } from "./telemetry-provider.js";
 export type { ITelemetryService, TelemetryContext, TelemetryProperties, } from "./telemetry-service.js";
 export { TELEMETRY_OPERATION_ID_PROPERTY, TELEMETRY_PARENT_ID_PROPERTY, TELEMETRY_SPAN_ID_PROPERTY, TelemetryService, } from "./telemetry-service.js";

package/dist/telemetry/index.js

@@ -588,8 +588,18 @@ function getInboundTraceContext() {
 
 // src/telemetry/session-id.ts
 var TELEMETRY_SESSION_ID_ENV = "UIPATH_SESSION_ID";
-var TELEMETRY_SESSION_ID_PROPERTY = "session_id";
-var telemetrySessionIdSlot = singleton("TelemetrySessionId");
+var SESSION_ID_MAX_LENGTH = 64;
+var RANDOM_SESSION_ID_LENGTH = 32;
+var TELEMETRY_SESSION_SOURCE_PROPERTY = "session_id_source";
+var CONTROL_CHARACTERS = /\p{Cc}/gu;
+var INHERITED_SESSION_SOURCES = [
+  { envVar: "CLAUDE_CODE_SESSION_ID", source: "claude-code" },
+  { envVar: "CODEX_THREAD_ID", source: "codex" },
+  { envVar: "ANTIGRAVITY_TRAJECTORY_ID", source: "antigravity" },
+  { envVar: "TERM_SESSION_ID", source: "terminal" },
+  { envVar: "WT_SESSION", source: "terminal" }
+];
+var telemetrySessionSlot = singleton("TelemetrySession");
 var telemetryOperationIdSlot = singleton("TelemetryOperationId");
 function getProcessEnv2() {
   return globalThis.process?.env;
@@ -598,27 +608,45 @@ function normalizeSessionId(value) {
   if (typeof value !== "string" && typeof value !== "number" && typeof value !== "boolean") {
     return;
   }
-  const trimmed = String(value).trim();
-  return trimmed || undefined;
+  const cleaned = String(value).replace(CONTROL_CHARACTERS, "").trim().slice(0, SESSION_ID_MAX_LENGTH);
+  return cleaned || undefined;
 }
 function getConfiguredTelemetrySessionId() {
   return normalizeSessionId(getProcessEnv2()?.[TELEMETRY_SESSION_ID_ENV]);
 }
-function getTelemetrySessionId() {
-  const envSessionId = getConfiguredTelemetrySessionId();
-  if (envSessionId) {
-    return envSessionId;
+function getInheritedSession(env) {
+  for (const candidate of INHERITED_SESSION_SOURCES) {
+    const handle = normalizeSessionId(env[candidate.envVar]);
+    if (handle) {
+      return { id: handle, source: candidate.source };
+    }
+  }
+  return;
+}
+function generateRandomSession() {
+  const bytes = new Uint8Array(RANDOM_SESSION_ID_LENGTH / 2);
+  crypto.getRandomValues(bytes);
+  let hex = "";
+  for (const byte of bytes) {
+    hex += byte.toString(16).padStart(2, "0");
   }
-  const existing = telemetrySessionIdSlot.get();
+  return { id: hex, source: "random" };
+}
+function resolveTelemetrySession() {
+  const existing = telemetrySessionSlot.get();
   if (existing) {
     return existing;
   }
-  const generated = crypto.randomUUID();
-  telemetrySessionIdSlot.set(generated);
-  return generated;
+  const declaredHandle = getConfiguredTelemetrySessionId();
+  const resolved = declaredHandle ? { id: declaredHandle, source: "declared" } : getInheritedSession(getProcessEnv2() ?? {}) ?? generateRandomSession();
+  telemetrySessionSlot.set(resolved);
+  return resolved;
+}
+function getTelemetrySessionId() {
+  return resolveTelemetrySession().id;
 }
-function resolveTelemetrySessionId(existingSessionId) {
-  return getConfiguredTelemetrySessionId() ?? normalizeSessionId(existingSessionId);
+function getTelemetrySessionSource() {
+  return resolveTelemetrySession().source;
 }
 function getTelemetryOperationId() {
   const existing = telemetryOperationIdSlot.get();
@@ -762,24 +790,18 @@ class TelemetryService {
   }
   enrichPropertiesWithContext(properties, context) {
     const globalProperties = getGlobalTelemetryProperties();
-    const existingSessionId = properties?.[TELEMETRY_SESSION_ID_PROPERTY] ?? this.defaultProperties?.[TELEMETRY_SESSION_ID_PROPERTY] ?? globalProperties?.[TELEMETRY_SESSION_ID_PROPERTY];
-    const sessionId = resolveTelemetrySessionId(existingSessionId);
     const enriched = {
       ...getExecutionContextTelemetryProperties(),
       ...globalProperties,
       ...this.defaultProperties,
       ...redactProperties(properties ?? {}),
+      [TELEMETRY_SESSION_SOURCE_PROPERTY]: getTelemetrySessionSource(),
       ...context ? {
         [TELEMETRY_OPERATION_ID_PROPERTY]: context.operationId,
         ...context.parentId !== undefined ? { [TELEMETRY_PARENT_ID_PROPERTY]: context.parentId } : {},
         [TELEMETRY_SPAN_ID_PROPERTY]: context.id
       } : {}
     };
-    if (sessionId === undefined) {
-      delete enriched[TELEMETRY_SESSION_ID_PROPERTY];
-    } else {
-      enriched[TELEMETRY_SESSION_ID_PROPERTY] = sessionId;
-    }
     return enriched;
   }
   generateId() {
@@ -797,7 +819,6 @@ class TelemetryService {
 }
 export {
   setExecutionContextAuthSignal,
-  resolveTelemetrySessionId,
   redactValue,
   redactProperty,
   redactProperties,
@@ -805,6 +826,7 @@ export {
   normalizeSkillName,
   normalizeEnvironment,
   normalizeBaseUrl,
+  getTelemetrySessionSource,
   getTelemetrySessionId,
   getExecutionContextTelemetryProperties,
   getConfiguredTelemetrySessionId,
@@ -814,7 +836,7 @@ export {
   buildCommandTelemetryAttribution,
   TelemetryService,
   TELEMETRY_SPAN_ID_PROPERTY,
-  TELEMETRY_SESSION_ID_PROPERTY,
+  TELEMETRY_SESSION_SOURCE_PROPERTY,
   TELEMETRY_SESSION_ID_ENV,
   TELEMETRY_PARENT_ID_PROPERTY,
   TELEMETRY_OPERATION_ID_PROPERTY,
@@ -823,4 +845,4 @@ export {
   BrowserContextStorage
 };
 
-//# debugId=0CFD50D10461DCC664756E2164756E21
+//# debugId=F57500BAC82BA8E664756E2164756E21

package/dist/telemetry/node-appinsights-telemetry-provider.d.ts

@@ -43,18 +43,6 @@ export declare class NodeAppInsightsTelemetryProvider implements ITelemetryProvi
      * inside a scope.
      */
     private consumeCorrelation;
-    /**
-     * Promote a `session_id` custom dimension onto the native `ai.session.id`
-     * context tag and strip it from the dimension bag. Session belongs in the
-     * native session tag — the App Insights Sessions blade reads it there — so
-     * shipping it as a custom dimension too is redundant and drifts (the raw
-     * tag vs. a redactor-hashed dimension). Only the AppInsights provider does
-     * this; fallback providers (logger/console) keep `session_id` as a
-     * dimension, since they have no native session field.
-     *
-     * `merged` is a fresh per-call object, so deleting in place is safe.
-     */
-    private promoteSessionTag;
     /**
      * Native correlation tags for a LEAF item (event/exception). It has no item
      * id of its own, so it nests under the current operation: `operation_Id` is

package/dist/telemetry/node.d.ts

@@ -4,7 +4,7 @@ export { detectAgent, detectAgentVersion } from "./detect-agent.js";
 export { buildEnvironmentProperties, type NormalizedEnvironment, normalizeBaseUrl, normalizeEnvironment, } from "./environment-info.js";
 export { type CiProvider, detectExecutionContext, EXECUTION_CONTEXT_VALUES, type ExecutionContext, type ExecutionContextDetection, type ExecutionContextDetectionOptions, getExecutionContextTelemetryProperties, setExecutionContextAuthSignal, } from "./execution-context.js";
 export { NodeContextStorage } from "./node-context-storage.js";
-export { getConfiguredTelemetrySessionId, getTelemetrySessionId, resolveTelemetrySessionId, TELEMETRY_SESSION_ID_ENV, TELEMETRY_SESSION_ID_PROPERTY, } from "./session-id.js";
+export { getConfiguredTelemetrySessionId, getTelemetrySessionId, getTelemetrySessionSource, TELEMETRY_SESSION_ID_ENV, TELEMETRY_SESSION_SOURCE_PROPERTY, } from "./session-id.js";
 export type { ITelemetryProvider } from "./telemetry-provider.js";
 export type { ITelemetryService, TelemetryContext, TelemetryProperties, } from "./telemetry-service.js";
 export { TELEMETRY_OPERATION_ID_PROPERTY, TELEMETRY_PARENT_ID_PROPERTY, TELEMETRY_SPAN_ID_PROPERTY, TelemetryService, } from "./telemetry-service.js";

package/dist/telemetry/session-id.d.ts

@@ -1,15 +1,61 @@
 export declare const TELEMETRY_SESSION_ID_ENV = "UIPATH_SESSION_ID";
-export declare const TELEMETRY_SESSION_ID_PROPERTY = "session_id";
+/**
+ * Hard ceiling on the emitted session id. App Insights caps `ai.session.id` at
+ * 64 characters and truncates past it silently, so the CLI cuts to the same
+ * limit itself rather than shipping a value the backend will quietly reshape.
+ *
+ * Two handles that share their first 64 characters therefore collapse into one
+ * session. Accepted: no observed host exports a handle anywhere near this long
+ * (every one of them is a UUID or shorter), and hashing to dodge it would make
+ * every id opaque — a host could no longer find its own `UIPATH_SESSION_ID` in
+ * the data.
+ */
+export declare const SESSION_ID_MAX_LENGTH = 64;
+/** Width of the minted fallback id when no host handle exists. */
+export declare const RANDOM_SESSION_ID_LENGTH = 32;
+/**
+ * Custom dimension naming which handle the session id came from. A `terminal`
+ * session is not comparable to a `claude-code` one (see the Session Id section
+ * of TELEMETRY_GUIDE.md), and the id alone does not say which it is — the
+ * handles pass through as the host exported them, with no source marker. Low
+ * cardinality by construction: one of {@link TelemetrySessionSource}.
+ */
+export declare const TELEMETRY_SESSION_SOURCE_PROPERTY = "session_id_source";
+/**
+ * Where a session id came from — the value of the
+ * {@link TELEMETRY_SESSION_SOURCE_PROPERTY} dimension.
+ *
+ * - `declared`: the host set `UIPATH_SESSION_ID` on purpose. The only boundary
+ *   someone chose; everything else is inferred.
+ * - `claude-code` / `codex` / `antigravity`: one agent conversation.
+ * - `terminal`: a terminal tab or pane, which can stay open for weeks and
+ *   splits when the user splits a pane.
+ * - `random`: no host handle at all, so one CLI process.
+ */
+export type TelemetrySessionSource = "declared" | "claude-code" | "codex" | "antigravity" | "terminal" | "random";
+/**
+ * The `UIPATH_SESSION_ID` handle as the host exported it (trimmed, control
+ * characters stripped, cut to {@link SESSION_ID_MAX_LENGTH}), or undefined when
+ * unset. Same value {@link getTelemetrySessionId} emits when it is set.
+ */
 export declare function getConfiguredTelemetrySessionId(): string | undefined;
 /**
- * Resolve the telemetry session id used by App Insights session tags.
+ * Resolve the session id for App Insights' native `ai.session.id` tag. Session
+ * lives on that tag and nowhere else — no custom dimension mirrors it.
  *
- * Coding-agent hosts can set UIPATH_SESSION_ID to correlate separate CLI
- * invocations. When unset, use one process-local fallback shared across
- * bundled copies of @uipath/common.
+ * The id is the host's handle verbatim, so a host that exports
+ * `UIPATH_SESSION_ID` can find its own sessions by that literal value. Which
+ * handle produced it rides the {@link TELEMETRY_SESSION_SOURCE_PROPERTY}
+ * dimension, since the id itself carries no source marker — the same string
+ * exported as `TERM_SESSION_ID` and as `UIPATH_SESSION_ID` is one id on two
+ * sources.
  */
 export declare function getTelemetrySessionId(): string;
-export declare function resolveTelemetrySessionId(existingSessionId: unknown): string | undefined;
+/**
+ * Which handle this process's session id came from — emitted on every telemetry
+ * item as {@link TELEMETRY_SESSION_SOURCE_PROPERTY}.
+ */
+export declare function getTelemetrySessionSource(): TelemetrySessionSource;
 /**
  * Resolve the per-invocation operation id used for App Insights' native
  * `operation_Id` tag.
@@ -24,8 +70,7 @@ export declare function resolveTelemetrySessionId(existingSessionId: unknown): s
  * transaction and with the API telemetry it triggers.
  *
  * The value is a 32-hex string (a UUID with dashes stripped). That is the shape
- * App Insights expects for `operation_Id`, and — unlike the UUID-shaped session
- * id — it is left untouched by the PII redactor, so the emitted value matches
- * raw on every path.
+ * App Insights expects for `operation_Id`, and it is left untouched by the PII
+ * redactor, so the emitted value matches raw on every path.
  */
 export declare function getTelemetryOperationId(): string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@uipath/common",
   "license": "MIT",
-  "version": "1.199.0-preview.106",
+  "version": "1.199.0-preview.108",
   "description": "Common infrastructure needed by uip tools.",
   "repository": {
     "type": "git",
@@ -67,5 +67,5 @@
     "mihaigirleanu",
     "vlad-uipath"
   ],
-  "gitHead": "cb01f256c2c4f1a1a5d014ffb97e506bac709e45"
+  "gitHead": "171f68daab68809916e8df10ea198c259f688ede"
 }