@respan/respan-sdk 1.1.2 → 1.1.3

package/README.md

@@ -1,5 +1,30 @@
-# Respan SDK
+# @respan/respan-sdk
 
 **[respan.ai](https://respan.ai)** | **[Documentation](https://docs.respan.ai)**
 
-Respan SDK allows you to interact with the Respan API smoothly.
+Core types, constants, and utilities for the Respan SDK ecosystem.
+
+## Installation
+
+```bash
+npm install @respan/respan-sdk
+```
+
+## What's included
+
+- **Types** — TypeScript definitions for spans, traces, logs, datasets, evaluators, experiments, and prompts
+- **Constants** — Span attribute keys, log type enums, and OTLP wire format constants
+- **Utilities** — Retry helpers and shared tooling used across Respan packages
+
+## Usage
+
+This package is a dependency of `@respan/tracing` and `@respan/respan`. You typically don't need to install it directly unless you're building a custom exporter or instrumentation plugin.
+
+```typescript
+import { RespanSpanAttributes, RespanLogType } from "@respan/respan-sdk";
+import type { RespanParams } from "@respan/respan-sdk";
+```
+
+## License
+
+Apache-2.0

package/dist/constants/logConstants.d.ts

@@ -1,4 +1,5 @@
 export declare enum RespanLogType {
+    CHAT = "chat",
     TEXT = "text",
     RESPONSE = "response",
     EMBEDDING = "embedding",

package/dist/constants/logConstants.js

@@ -2,6 +2,7 @@
 // Define Respan log type enum
 export var RespanLogType;
 (function (RespanLogType) {
+    RespanLogType["CHAT"] = "chat";
     RespanLogType["TEXT"] = "text";
     RespanLogType["RESPONSE"] = "response";
     RespanLogType["EMBEDDING"] = "embedding";

package/dist/constants/logConstants.js.map

@@ -1 +1 @@
-{"version":3,"file":"logConstants.js","sourceRoot":"","sources":["../../src/constants/logConstants.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,8BAA8B;AAC9B,MAAM,CAAN,IAAY,aAgBX;AAhBD,WAAY,aAAa;IACvB,8BAAa,CAAA;IACb,sCAAqB,CAAA;IACrB,wCAAuB,CAAA;IACvB,gDAA+B,CAAA;IAC/B,kCAAiB,CAAA;IACjB,sCAAqB,CAAA;IACrB,8BAAa,CAAA;IACb,8BAAa,CAAA;IACb,gCAAe,CAAA;IACf,oCAAmB,CAAA;IACnB,wCAAuB,CAAA;IACvB,sCAAqB,CAAA;IACrB,kCAAiB,CAAA;IACjB,0CAAyB,CAAA;IACzB,oCAAmB,CAAA;AACrB,CAAC,EAhBW,aAAa,KAAb,aAAa,QAgBxB"}
+{"version":3,"file":"logConstants.js","sourceRoot":"","sources":["../../src/constants/logConstants.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,8BAA8B;AAC9B,MAAM,CAAN,IAAY,aAiBX;AAjBD,WAAY,aAAa;IACvB,8BAAa,CAAA;IACb,8BAAa,CAAA;IACb,sCAAqB,CAAA;IACrB,wCAAuB,CAAA;IACvB,gDAA+B,CAAA;IAC/B,kCAAiB,CAAA;IACjB,sCAAqB,CAAA;IACrB,8BAAa,CAAA;IACb,8BAAa,CAAA;IACb,gCAAe,CAAA;IACf,oCAAmB,CAAA;IACnB,wCAAuB,CAAA;IACvB,sCAAqB,CAAA;IACrB,kCAAiB,CAAA;IACjB,0CAAyB,CAAA;IACzB,oCAAmB,CAAA;AACrB,CAAC,EAjBW,aAAa,KAAb,aAAa,QAiBxB"}

package/dist/types/baseTypes.d.ts

@@ -6,5 +6,8 @@ export type RespanParams = {
     evaluation_identifier?: string | number;
     thread_identifier?: string | number;
     trace_group_identifier?: string | number;
+    group_identifier?: string | number;
     metadata?: Record<string, any>;
+    prompt?: Record<string, any> | string;
+    environment?: string;
 };

package/dist/types/spanTypes.d.ts

@@ -6,7 +6,23 @@ export declare enum RespanSpanAttributes {
     RESPAN_EVALUATION_PARAMS_ID = "respan.evaluation_params.evaluation_identifier",
     RESPAN_THREADS_ID = "respan.threads.thread_identifier",
     RESPAN_TRACE_GROUP_ID = "respan.trace.trace_group_identifier",
-    RESPAN_METADATA = "respan.metadata"
+    RESPAN_METADATA = "respan.metadata",
+    RESPAN_PROMPT = "respan.prompt",
+    RESPAN_ENVIRONMENT = "respan.environment",
+    RESPAN_LINK_TIMESTAMP = "respan.link.timestamp",
+    RESPAN_LOG_METHOD = "respan.entity.log_method",
+    RESPAN_LOG_TYPE = "respan.entity.log_type",
+    RESPAN_LOG_ID = "respan.entity.log_id",
+    RESPAN_LOG_PARENT_ID = "respan.entity.log_parent_id",
+    RESPAN_LOG_ROOT_ID = "respan.entity.log_root_id",
+    RESPAN_LOG_SOURCE = "respan.entity.log_source",
+    OPENINFERENCE_SPAN_KIND = "openinference.span.kind",
+    GEN_AI_SYSTEM = "gen_ai.system",
+    GEN_AI_REQUEST_MODEL = "gen_ai.request.model",
+    GEN_AI_USAGE_PROMPT_TOKENS = "gen_ai.usage.prompt_tokens",
+    GEN_AI_USAGE_COMPLETION_TOKENS = "gen_ai.usage.completion_tokens",
+    LLM_REQUEST_TYPE = "llm.request.type",
+    LLM_SYSTEM = "llm.system"
 }
 export declare const RESPAN_SPAN_ATTRIBUTES_MAP: {
     [key: string]: string;

package/dist/types/spanTypes.js

@@ -14,6 +14,27 @@ export var RespanSpanAttributes;
     RespanSpanAttributes["RESPAN_TRACE_GROUP_ID"] = "respan.trace.trace_group_identifier";
     // Metadata
     RespanSpanAttributes["RESPAN_METADATA"] = "respan.metadata";
+    // Prompt & environment
+    RespanSpanAttributes["RESPAN_PROMPT"] = "respan.prompt";
+    RespanSpanAttributes["RESPAN_ENVIRONMENT"] = "respan.environment";
+    // Span links
+    RespanSpanAttributes["RESPAN_LINK_TIMESTAMP"] = "respan.link.timestamp";
+    // Logging
+    RespanSpanAttributes["RESPAN_LOG_METHOD"] = "respan.entity.log_method";
+    RespanSpanAttributes["RESPAN_LOG_TYPE"] = "respan.entity.log_type";
+    RespanSpanAttributes["RESPAN_LOG_ID"] = "respan.entity.log_id";
+    RespanSpanAttributes["RESPAN_LOG_PARENT_ID"] = "respan.entity.log_parent_id";
+    RespanSpanAttributes["RESPAN_LOG_ROOT_ID"] = "respan.entity.log_root_id";
+    RespanSpanAttributes["RESPAN_LOG_SOURCE"] = "respan.entity.log_source";
+    // OpenInference
+    RespanSpanAttributes["OPENINFERENCE_SPAN_KIND"] = "openinference.span.kind";
+    // GenAI / LLM semantic conventions (for packages that don't depend on @traceloop/ai-semantic-conventions)
+    RespanSpanAttributes["GEN_AI_SYSTEM"] = "gen_ai.system";
+    RespanSpanAttributes["GEN_AI_REQUEST_MODEL"] = "gen_ai.request.model";
+    RespanSpanAttributes["GEN_AI_USAGE_PROMPT_TOKENS"] = "gen_ai.usage.prompt_tokens";
+    RespanSpanAttributes["GEN_AI_USAGE_COMPLETION_TOKENS"] = "gen_ai.usage.completion_tokens";
+    RespanSpanAttributes["LLM_REQUEST_TYPE"] = "llm.request.type";
+    RespanSpanAttributes["LLM_SYSTEM"] = "llm.system";
 })(RespanSpanAttributes || (RespanSpanAttributes = {}));
 export const RESPAN_SPAN_ATTRIBUTES_MAP = {
     customer_identifier: RespanSpanAttributes.RESPAN_CUSTOMER_PARAMS_ID,
@@ -23,6 +44,9 @@ export const RESPAN_SPAN_ATTRIBUTES_MAP = {
     thread_identifier: RespanSpanAttributes.RESPAN_THREADS_ID,
     custom_identifier: RespanSpanAttributes.RESPAN_SPAN_CUSTOM_ID,
     trace_group_identifier: RespanSpanAttributes.RESPAN_TRACE_GROUP_ID,
-    metadata: RespanSpanAttributes.RESPAN_METADATA
+    group_identifier: RespanSpanAttributes.RESPAN_TRACE_GROUP_ID,
+    metadata: RespanSpanAttributes.RESPAN_METADATA,
+    prompt: RespanSpanAttributes.RESPAN_PROMPT,
+    environment: RespanSpanAttributes.RESPAN_ENVIRONMENT,
 };
 //# sourceMappingURL=spanTypes.js.map

package/dist/types/spanTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"spanTypes.js","sourceRoot":"","sources":["../../src/types/spanTypes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,oBAoBX;AApBD,WAAY,oBAAoB;IAC5B,kBAAkB;IAClB,sFAA8D,CAAA;IAE9D,kBAAkB;IAClB,gGAAwE,CAAA;IACxE,qFAA6D,CAAA;IAC7D,mFAA2D,CAAA;IAE3D,oBAAoB;IACpB,sGAA8E,CAAA;IAE9E,UAAU;IACV,8EAAsD,CAAA;IAEtD,QAAQ;IACR,qFAA6D,CAAA;IAE7D,WAAW;IACX,2DAAmC,CAAA;AACvC,CAAC,EApBW,oBAAoB,KAApB,oBAAoB,QAoB/B;AAED,MAAM,CAAC,MAAM,0BAA0B,GAA8B;IACjE,mBAAmB,EAAE,oBAAoB,CAAC,yBAAyB;IACnE,cAAc,EAAE,oBAAoB,CAAC,4BAA4B;IACjE,aAAa,EAAE,oBAAoB,CAAC,2BAA2B;IAC/D,qBAAqB,EAAE,oBAAoB,CAAC,2BAA2B;IACvE,iBAAiB,EAAE,oBAAoB,CAAC,iBAAiB;IACzD,iBAAiB,EAAE,oBAAoB,CAAC,qBAAqB;IAC7D,sBAAsB,EAAE,oBAAoB,CAAC,qBAAqB;IAClE,QAAQ,EAAE,oBAAoB,CAAC,eAAe;CACjD,CAAC"}
+{"version":3,"file":"spanTypes.js","sourceRoot":"","sources":["../../src/types/spanTypes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,oBA8CX;AA9CD,WAAY,oBAAoB;IAC5B,kBAAkB;IAClB,sFAA8D,CAAA;IAE9D,kBAAkB;IAClB,gGAAwE,CAAA;IACxE,qFAA6D,CAAA;IAC7D,mFAA2D,CAAA;IAE3D,oBAAoB;IACpB,sGAA8E,CAAA;IAE9E,UAAU;IACV,8EAAsD,CAAA;IAEtD,QAAQ;IACR,qFAA6D,CAAA;IAE7D,WAAW;IACX,2DAAmC,CAAA;IAEnC,uBAAuB;IACvB,uDAA+B,CAAA;IAC/B,iEAAyC,CAAA;IAEzC,aAAa;IACb,uEAA+C,CAAA;IAE/C,UAAU;IACV,sEAA8C,CAAA;IAC9C,kEAA0C,CAAA;IAC1C,8DAAsC,CAAA;IACtC,4EAAoD,CAAA;IACpD,wEAAgD,CAAA;IAChD,sEAA8C,CAAA;IAE9C,gBAAgB;IAChB,2EAAmD,CAAA;IAEnD,0GAA0G;IAC1G,uDAA+B,CAAA;IAC/B,qEAA6C,CAAA;IAC7C,iFAAyD,CAAA;IACzD,yFAAiE,CAAA;IACjE,6DAAqC,CAAA;IACrC,iDAAyB,CAAA;AAC7B,CAAC,EA9CW,oBAAoB,KAApB,oBAAoB,QA8C/B;AAED,MAAM,CAAC,MAAM,0BAA0B,GAA8B;IACjE,mBAAmB,EAAE,oBAAoB,CAAC,yBAAyB;IACnE,cAAc,EAAE,oBAAoB,CAAC,4BAA4B;IACjE,aAAa,EAAE,oBAAoB,CAAC,2BAA2B;IAC/D,qBAAqB,EAAE,oBAAoB,CAAC,2BAA2B;IACvE,iBAAiB,EAAE,oBAAoB,CAAC,iBAAiB;IACzD,iBAAiB,EAAE,oBAAoB,CAAC,qBAAqB;IAC7D,sBAAsB,EAAE,oBAAoB,CAAC,qBAAqB;IAClE,gBAAgB,EAAE,oBAAoB,CAAC,qBAAqB;IAC5D,QAAQ,EAAE,oBAAoB,CAAC,eAAe;IAC9C,MAAM,EAAE,oBAAoB,CAAC,aAAa;IAC1C,WAAW,EAAE,oBAAoB,CAAC,kBAAkB;CACvD,CAAC"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@respan/respan-sdk",
   "type": "module",
-  "version": "1.1.2",
-  "description": "Respan typing SDK",
+  "version": "1.1.3",
+  "description": "Core types, constants, and utilities for the Respan SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "author": "Respan <team@respan.ai>",