mirascope 2.2.0-alpha.2 → 2.2.2-alpha.4

package/README.md

@@ -338,6 +338,173 @@ try {
 }
 ```
 
+## Ops: Instrumentation, Tracing & Versioning
+
+The `ops` module provides observability and versioning for your LLM applications, with automatic integration to Mirascope Cloud or any OpenTelemetry-compatible backend.
+
+### Configuration
+
+```typescript
+import { ops } from "mirascope";
+
+// Uses MIRASCOPE_API_KEY environment variable
+ops.configure();
+
+// Or explicit API key
+ops.configure({ apiKey: "your-api-key" });
+
+// Or custom OpenTelemetry provider
+import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
+ops.configure({ tracerProvider: new NodeTracerProvider() });
+```
+
+### Tracing
+
+Wrap functions or calls with `trace()` to create spans:
+
+```typescript
+import { llm, ops } from "mirascope";
+
+const recommendBook = llm.defineCall<{ genre: string }>({
+  model: "anthropic/claude-haiku-4-5",
+  template: ({ genre }) => `Recommend a ${genre} book.`,
+});
+
+// Trace a call
+const tracedRecommendBook = ops.trace(recommendBook, {
+  name: "recommend-book",
+  tags: ["recommendation", "books"],
+  metadata: { source: "example" },
+});
+
+const response = await tracedRecommendBook({ genre: "fantasy" });
+
+// Access span metadata
+const result = await tracedRecommendBook.wrapped({ genre: "sci-fi" });
+console.log(result.traceId, result.spanId);
+```
+
+### Versioning
+
+Track function versions based on closure analysis. Changes to your function code or its dependencies automatically create new versions:
+
+```typescript
+import { ops } from "mirascope";
+
+const computeEmbedding = ops.version(
+  async (text: string) => {
+    // Your embedding logic
+    return [0.1, 0.2, 0.3];
+  },
+  {
+    name: "embedding-v1",
+    tags: ["embedding", "production"],
+  }
+);
+
+// Access version info (hash, signatureHash, name, version, tags, metadata)
+console.log(computeEmbedding.versionInfo);
+
+// Get wrapped result with span info and annotation support
+const result = await computeEmbedding.wrapped("hello");
+await result.annotate({ label: "pass" }); // or "fail"
+```
+
+> [!NOTE]
+> For accurate source-level versioning, use the [Transform Plugin](#transform-plugin). Without it, versioning uses compiled JavaScript via `fn.toString()`.
+
+### Sessions
+
+Group related traces under a session ID:
+
+```typescript
+import { ops } from "mirascope";
+
+await ops.session({ id: "user-123-conversation-1" }, async () => {
+  const response = await tracedChat({ message: "Hello!" });
+  console.log(ops.currentSession()?.id); // "user-123-conversation-1"
+});
+
+// With attributes
+await ops.session(
+  {
+    id: "session-2",
+    attributes: { userId: "user-456", channel: "web" },
+  },
+  async () => {
+    // Attributes are propagated to spans
+  }
+);
+```
+
+### Spans
+
+Create custom spans for non-LLM operations:
+
+```typescript
+import { ops } from "mirascope";
+
+await ops.span("data-processing", async (span) => {
+  span.info("Starting processing");
+  span.set({ "app.batch_size": 100 });
+
+  // Nested spans
+  await ops.span("validation", async (child) => {
+    child.debug("Validating input");
+  });
+
+  span.info("Complete", { records: 100 });
+});
+```
+
+### LLM Instrumentation
+
+Automatically instrument all LLM calls with OpenTelemetry GenAI semantic conventions:
+
+```typescript
+import { ops } from "mirascope";
+
+ops.instrumentLLM();
+
+// Now all Model calls automatically create spans with:
+// - gen_ai.system: "anthropic"
+// - gen_ai.request.model: "claude-haiku-4-5"
+// - gen_ai.usage.input_tokens / output_tokens
+const response = await recommendBook({ genre: "mystery" });
+
+// Check status
+console.log(ops.isLLMInstrumented()); // true
+ops.uninstrumentLLM();
+```
+
+### Context Propagation
+
+Propagate trace context across service boundaries:
+
+```typescript
+import { ops } from "mirascope";
+
+// Inject context into outgoing HTTP headers
+const headers: Record<string, string> = {};
+ops.injectContext(headers);
+await fetch(url, { headers });
+
+// Extract context on receiving side
+await ops.propagatedContext(incomingHeaders, async () => {
+  await ops.span("downstream-work", async (span) => {
+    // Linked to upstream trace
+  });
+});
+
+// Session propagation
+const sessionId = ops.extractSessionId(incomingHeaders);
+if (sessionId) {
+  await ops.session({ id: sessionId }, async () => {
+    // Continue session from upstream
+  });
+}
+```
+
 ## Supported Providers
 
 - **Anthropic**: `anthropic/claude-sonnet-4-5`, `anthropic/claude-haiku-4-5`, etc.
@@ -380,6 +547,7 @@ See the [`examples/`](./examples) directory for more examples:
 - `context/` - Sharing dependencies with context
 - `chaining/` - Chaining and parallel calls
 - `reliability/` - Retry and fallback patterns
+- `ops/` - Tracing, versioning, sessions, and instrumentation
 
 Run an example:
 ```bash

package/dist/index.cjs

@@ -13184,11 +13184,216 @@ var TokenCostCalculateResponse = schemas_exports.object({
   totalCostDollars: schemas_exports.number()
 });
 
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemResourceAttributesItemValueArrayValue.ts
+var TracesCreateOtelRequestResourceSpansItemResourceAttributesItemValueArrayValue = schemas_exports.object({
+  values: schemas_exports.list(schemas_exports.unknown())
+});
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemResourceAttributesItemValueIntValue.ts
+var TracesCreateOtelRequestResourceSpansItemResourceAttributesItemValueIntValue = schemas_exports.undiscriminatedUnion([
+  schemas_exports.string(),
+  schemas_exports.number()
+]);
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemResourceAttributesItemValueKvlistValueValuesItem.ts
+var TracesCreateOtelRequestResourceSpansItemResourceAttributesItemValueKvlistValueValuesItem = schemas_exports.object({
+  key: schemas_exports.string(),
+  value: schemas_exports.unknown()
+});
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemResourceAttributesItemValueKvlistValue.ts
+var TracesCreateOtelRequestResourceSpansItemResourceAttributesItemValueKvlistValue = schemas_exports.object({
+  values: schemas_exports.list(
+    TracesCreateOtelRequestResourceSpansItemResourceAttributesItemValueKvlistValueValuesItem
+  )
+});
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemResourceAttributesItemValue.ts
+var TracesCreateOtelRequestResourceSpansItemResourceAttributesItemValue = schemas_exports.object({
+  stringValue: schemas_exports.string().optional(),
+  intValue: TracesCreateOtelRequestResourceSpansItemResourceAttributesItemValueIntValue.optional(),
+  doubleValue: schemas_exports.number().optional(),
+  boolValue: schemas_exports.boolean().optional(),
+  arrayValue: TracesCreateOtelRequestResourceSpansItemResourceAttributesItemValueArrayValue.optional(),
+  kvlistValue: TracesCreateOtelRequestResourceSpansItemResourceAttributesItemValueKvlistValue.optional()
+});
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemResourceAttributesItem.ts
+var TracesCreateOtelRequestResourceSpansItemResourceAttributesItem = schemas_exports.object({
+  key: schemas_exports.string(),
+  value: TracesCreateOtelRequestResourceSpansItemResourceAttributesItemValue
+});
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemResource.ts
+var TracesCreateOtelRequestResourceSpansItemResource = schemas_exports.object({
+  attributes: schemas_exports.list(TracesCreateOtelRequestResourceSpansItemResourceAttributesItem).optional(),
+  droppedAttributesCount: schemas_exports.number().optional()
+});
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemScopeSpansItemScopeAttributesItemValueArrayValue.ts
+var TracesCreateOtelRequestResourceSpansItemScopeSpansItemScopeAttributesItemValueArrayValue = schemas_exports.object({
+  values: schemas_exports.list(schemas_exports.unknown())
+});
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemScopeSpansItemScopeAttributesItemValueIntValue.ts
+var TracesCreateOtelRequestResourceSpansItemScopeSpansItemScopeAttributesItemValueIntValue = schemas_exports.undiscriminatedUnion([
+  schemas_exports.string(),
+  schemas_exports.number()
+]);
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemScopeSpansItemScopeAttributesItemValueKvlistValueValuesItem.ts
+var TracesCreateOtelRequestResourceSpansItemScopeSpansItemScopeAttributesItemValueKvlistValueValuesItem = schemas_exports.object({
+  key: schemas_exports.string(),
+  value: schemas_exports.unknown()
+});
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemScopeSpansItemScopeAttributesItemValueKvlistValue.ts
+var TracesCreateOtelRequestResourceSpansItemScopeSpansItemScopeAttributesItemValueKvlistValue = schemas_exports.object({
+  values: schemas_exports.list(
+    TracesCreateOtelRequestResourceSpansItemScopeSpansItemScopeAttributesItemValueKvlistValueValuesItem
+  )
+});
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemScopeSpansItemScopeAttributesItemValue.ts
+var TracesCreateOtelRequestResourceSpansItemScopeSpansItemScopeAttributesItemValue = schemas_exports.object({
+  stringValue: schemas_exports.string().optional(),
+  intValue: TracesCreateOtelRequestResourceSpansItemScopeSpansItemScopeAttributesItemValueIntValue.optional(),
+  doubleValue: schemas_exports.number().optional(),
+  boolValue: schemas_exports.boolean().optional(),
+  arrayValue: TracesCreateOtelRequestResourceSpansItemScopeSpansItemScopeAttributesItemValueArrayValue.optional(),
+  kvlistValue: TracesCreateOtelRequestResourceSpansItemScopeSpansItemScopeAttributesItemValueKvlistValue.optional()
+});
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemScopeSpansItemScopeAttributesItem.ts
+var TracesCreateOtelRequestResourceSpansItemScopeSpansItemScopeAttributesItem = schemas_exports.object({
+  key: schemas_exports.string(),
+  value: TracesCreateOtelRequestResourceSpansItemScopeSpansItemScopeAttributesItemValue
+});
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemScopeSpansItemScope.ts
+var TracesCreateOtelRequestResourceSpansItemScopeSpansItemScope = schemas_exports.object({
+  name: schemas_exports.string(),
+  version: schemas_exports.string().optional(),
+  attributes: schemas_exports.list(
+    TracesCreateOtelRequestResourceSpansItemScopeSpansItemScopeAttributesItem
+  ).optional(),
+  droppedAttributesCount: schemas_exports.number().optional()
+});
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemValueArrayValue.ts
+var TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemValueArrayValue = schemas_exports.object({
+  values: schemas_exports.list(schemas_exports.unknown())
+});
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemValueIntValue.ts
+var TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemValueIntValue = schemas_exports.undiscriminatedUnion([
+  schemas_exports.string(),
+  schemas_exports.number()
+]);
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemValueKvlistValueValuesItem.ts
+var TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemValueKvlistValueValuesItem = schemas_exports.object({
+  key: schemas_exports.string(),
+  value: schemas_exports.unknown()
+});
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemValueKvlistValue.ts
+var TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemValueKvlistValue = schemas_exports.object({
+  values: schemas_exports.list(
+    TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemValueKvlistValueValuesItem
+  )
+});
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemValue.ts
+var TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemValue = schemas_exports.object({
+  stringValue: schemas_exports.string().optional(),
+  intValue: TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemValueIntValue.optional(),
+  doubleValue: schemas_exports.number().optional(),
+  boolValue: schemas_exports.boolean().optional(),
+  arrayValue: TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemValueArrayValue.optional(),
+  kvlistValue: TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemValueKvlistValue.optional()
+});
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemAttributesItem.ts
+var TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemAttributesItem = schemas_exports.object({
+  key: schemas_exports.string(),
+  value: TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemValue
+});
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemEndTimeUnixNano.ts
+var TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemEndTimeUnixNano = schemas_exports.undiscriminatedUnion([
+  schemas_exports.string(),
+  schemas_exports.number()
+]);
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemStartTimeUnixNano.ts
+var TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemStartTimeUnixNano = schemas_exports.undiscriminatedUnion([
+  schemas_exports.string(),
+  schemas_exports.number()
+]);
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemStatus.ts
+var TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemStatus = schemas_exports.object({
+  code: schemas_exports.number().optional(),
+  message: schemas_exports.string().optional()
+});
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItem.ts
+var TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItem = schemas_exports.object({
+  traceId: schemas_exports.string(),
+  spanId: schemas_exports.string(),
+  parentSpanId: schemas_exports.string().optionalNullable(),
+  name: schemas_exports.string(),
+  kind: schemas_exports.number().optional(),
+  startTimeUnixNano: TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemStartTimeUnixNano,
+  endTimeUnixNano: TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemEndTimeUnixNano,
+  attributes: schemas_exports.list(
+    TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemAttributesItem
+  ).optional(),
+  droppedAttributesCount: schemas_exports.number().optional(),
+  events: schemas_exports.list(schemas_exports.unknown()).optional(),
+  droppedEventsCount: schemas_exports.number().optional(),
+  status: TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItemStatus.optional(),
+  links: schemas_exports.list(schemas_exports.unknown()).optional(),
+  droppedLinksCount: schemas_exports.number().optional()
+});
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItemScopeSpansItem.ts
+var TracesCreateOtelRequestResourceSpansItemScopeSpansItem = schemas_exports.object({
+  scope: TracesCreateOtelRequestResourceSpansItemScopeSpansItemScope.optional(),
+  spans: schemas_exports.list(
+    TracesCreateOtelRequestResourceSpansItemScopeSpansItemSpansItem
+  ),
+  schemaUrl: schemas_exports.string().optional()
+});
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelRequestResourceSpansItem.ts
+var TracesCreateOtelRequestResourceSpansItem = schemas_exports.object({
+  resource: TracesCreateOtelRequestResourceSpansItemResource.optional(),
+  scopeSpans: schemas_exports.list(
+    TracesCreateOtelRequestResourceSpansItemScopeSpansItem
+  ),
+  schemaUrl: schemas_exports.string().optional()
+});
+
+// src/api/_generated/serialization/resources/traces/client/requests/TracesCreateOtelRequest.ts
+var TracesCreateOtelRequest = schemas_exports.object({
+  resourceSpans: schemas_exports.list(
+    TracesCreateOtelRequestResourceSpansItem
+  )
+});
+
 // src/api/_generated/serialization/resources/traces/types/TracesCreateRequestResourceSpansItemResourceAttributesItemValueArrayValue.ts
 var TracesCreateRequestResourceSpansItemResourceAttributesItemValueArrayValue = schemas_exports.object({
   values: schemas_exports.list(schemas_exports.unknown())
 });
 
+// src/api/_generated/serialization/resources/traces/types/TracesCreateRequestResourceSpansItemResourceAttributesItemValueIntValue.ts
+var TracesCreateRequestResourceSpansItemResourceAttributesItemValueIntValue = schemas_exports.undiscriminatedUnion([
+  schemas_exports.string(),
+  schemas_exports.number()
+]);
+
 // src/api/_generated/serialization/resources/traces/types/TracesCreateRequestResourceSpansItemResourceAttributesItemValueKvlistValueValuesItem.ts
 var TracesCreateRequestResourceSpansItemResourceAttributesItemValueKvlistValueValuesItem = schemas_exports.object({
   key: schemas_exports.string(),
@@ -13205,7 +13410,7 @@ var TracesCreateRequestResourceSpansItemResourceAttributesItemValueKvlistValue =
 // src/api/_generated/serialization/resources/traces/types/TracesCreateRequestResourceSpansItemResourceAttributesItemValue.ts
 var TracesCreateRequestResourceSpansItemResourceAttributesItemValue = schemas_exports.object({
   stringValue: schemas_exports.string().optional(),
-  intValue: schemas_exports.string().optional(),
+  intValue: TracesCreateRequestResourceSpansItemResourceAttributesItemValueIntValue.optional(),
   doubleValue: schemas_exports.number().optional(),
   boolValue: schemas_exports.boolean().optional(),
   arrayValue: TracesCreateRequestResourceSpansItemResourceAttributesItemValueArrayValue.optional(),
@@ -13229,6 +13434,12 @@ var TracesCreateRequestResourceSpansItemScopeSpansItemScopeAttributesItemValueAr
   values: schemas_exports.list(schemas_exports.unknown())
 });
 
+// src/api/_generated/serialization/resources/traces/types/TracesCreateRequestResourceSpansItemScopeSpansItemScopeAttributesItemValueIntValue.ts
+var TracesCreateRequestResourceSpansItemScopeSpansItemScopeAttributesItemValueIntValue = schemas_exports.undiscriminatedUnion([
+  schemas_exports.string(),
+  schemas_exports.number()
+]);
+
 // src/api/_generated/serialization/resources/traces/types/TracesCreateRequestResourceSpansItemScopeSpansItemScopeAttributesItemValueKvlistValueValuesItem.ts
 var TracesCreateRequestResourceSpansItemScopeSpansItemScopeAttributesItemValueKvlistValueValuesItem = schemas_exports.object({
   key: schemas_exports.string(),
@@ -13245,7 +13456,7 @@ var TracesCreateRequestResourceSpansItemScopeSpansItemScopeAttributesItemValueKv
 // src/api/_generated/serialization/resources/traces/types/TracesCreateRequestResourceSpansItemScopeSpansItemScopeAttributesItemValue.ts
 var TracesCreateRequestResourceSpansItemScopeSpansItemScopeAttributesItemValue = schemas_exports.object({
   stringValue: schemas_exports.string().optional(),
-  intValue: schemas_exports.string().optional(),
+  intValue: TracesCreateRequestResourceSpansItemScopeSpansItemScopeAttributesItemValueIntValue.optional(),
   doubleValue: schemas_exports.number().optional(),
   boolValue: schemas_exports.boolean().optional(),
   arrayValue: TracesCreateRequestResourceSpansItemScopeSpansItemScopeAttributesItemValueArrayValue.optional(),
@@ -13271,6 +13482,12 @@ var TracesCreateRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemVal
   values: schemas_exports.list(schemas_exports.unknown())
 });
 
+// src/api/_generated/serialization/resources/traces/types/TracesCreateRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemValueIntValue.ts
+var TracesCreateRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemValueIntValue = schemas_exports.undiscriminatedUnion([
+  schemas_exports.string(),
+  schemas_exports.number()
+]);
+
 // src/api/_generated/serialization/resources/traces/types/TracesCreateRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemValueKvlistValueValuesItem.ts
 var TracesCreateRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemValueKvlistValueValuesItem = schemas_exports.object({
   key: schemas_exports.string(),
@@ -13287,7 +13504,7 @@ var TracesCreateRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemVal
 // src/api/_generated/serialization/resources/traces/types/TracesCreateRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemValue.ts
 var TracesCreateRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemValue = schemas_exports.object({
   stringValue: schemas_exports.string().optional(),
-  intValue: schemas_exports.string().optional(),
+  intValue: TracesCreateRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemValueIntValue.optional(),
   doubleValue: schemas_exports.number().optional(),
   boolValue: schemas_exports.boolean().optional(),
   arrayValue: TracesCreateRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemValueArrayValue.optional(),
@@ -13300,6 +13517,18 @@ var TracesCreateRequestResourceSpansItemScopeSpansItemSpansItemAttributesItem =
   value: TracesCreateRequestResourceSpansItemScopeSpansItemSpansItemAttributesItemValue
 });
 
+// src/api/_generated/serialization/resources/traces/types/TracesCreateRequestResourceSpansItemScopeSpansItemSpansItemEndTimeUnixNano.ts
+var TracesCreateRequestResourceSpansItemScopeSpansItemSpansItemEndTimeUnixNano = schemas_exports.undiscriminatedUnion([
+  schemas_exports.string(),
+  schemas_exports.number()
+]);
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateRequestResourceSpansItemScopeSpansItemSpansItemStartTimeUnixNano.ts
+var TracesCreateRequestResourceSpansItemScopeSpansItemSpansItemStartTimeUnixNano = schemas_exports.undiscriminatedUnion([
+  schemas_exports.string(),
+  schemas_exports.number()
+]);
+
 // src/api/_generated/serialization/resources/traces/types/TracesCreateRequestResourceSpansItemScopeSpansItemSpansItemStatus.ts
 var TracesCreateRequestResourceSpansItemScopeSpansItemSpansItemStatus = schemas_exports.object({
   code: schemas_exports.number().optional(),
@@ -13313,8 +13542,8 @@ var TracesCreateRequestResourceSpansItemScopeSpansItemSpansItem = schemas_export
   parentSpanId: schemas_exports.string().optionalNullable(),
   name: schemas_exports.string(),
   kind: schemas_exports.number().optional(),
-  startTimeUnixNano: schemas_exports.string(),
-  endTimeUnixNano: schemas_exports.string(),
+  startTimeUnixNano: TracesCreateRequestResourceSpansItemScopeSpansItemSpansItemStartTimeUnixNano,
+  endTimeUnixNano: TracesCreateRequestResourceSpansItemScopeSpansItemSpansItemEndTimeUnixNano,
   attributes: schemas_exports.list(
     TracesCreateRequestResourceSpansItemScopeSpansItemSpansItemAttributesItem
   ).optional(),
@@ -13437,6 +13666,17 @@ var TracesSearchRequest = schemas_exports.object({
   rootSpansOnly: schemas_exports.boolean().optional()
 });
 
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelResponsePartialSuccess.ts
+var TracesCreateOtelResponsePartialSuccess = schemas_exports.object({
+  rejectedSpans: schemas_exports.number().optional(),
+  errorMessage: schemas_exports.string().optional()
+});
+
+// src/api/_generated/serialization/resources/traces/types/TracesCreateOtelResponse.ts
+var TracesCreateOtelResponse = schemas_exports.object({
+  partialSuccess: TracesCreateOtelResponsePartialSuccess.optional()
+});
+
 // src/api/_generated/serialization/resources/traces/types/TracesCreateResponsePartialSuccess.ts
 var TracesCreateResponsePartialSuccess = schemas_exports.object({
   rejectedSpans: schemas_exports.number().optional(),
@@ -21869,6 +22109,181 @@ var TracesClient = class {
       "/traces"
     );
   }
+  /**
+   * @param {Mirascope.TracesCreateOtelRequest} request
+   * @param {TracesClient.RequestOptions} requestOptions - Request-specific configuration.
+   *
+   * @throws {@link Mirascope.BadRequestError}
+   * @throws {@link Mirascope.UnauthorizedError}
+   * @throws {@link Mirascope.PaymentRequiredError}
+   * @throws {@link Mirascope.ForbiddenError}
+   * @throws {@link Mirascope.NotFoundError}
+   * @throws {@link Mirascope.ConflictError}
+   * @throws {@link Mirascope.TooManyRequestsError}
+   * @throws {@link Mirascope.InternalServerError}
+   * @throws {@link Mirascope.ServiceUnavailableError}
+   *
+   * @example
+   *     await client.traces.createotel({
+   *         resourceSpans: [{
+   *                 scopeSpans: [{
+   *                         spans: [{
+   *                                 traceId: "traceId",
+   *                                 spanId: "spanId",
+   *                                 name: "name",
+   *                                 startTimeUnixNano: "startTimeUnixNano",
+   *                                 endTimeUnixNano: "endTimeUnixNano"
+   *                             }]
+   *                     }]
+   *             }]
+   *     })
+   */
+  createotel(request, requestOptions) {
+    return HttpResponsePromise.fromPromise(
+      this.__createotel(request, requestOptions)
+    );
+  }
+  async __createotel(request, requestOptions) {
+    const _headers = mergeHeaders(
+      this._options?.headers,
+      requestOptions?.headers
+    );
+    const _response = await fetcher({
+      url: url_exports.join(
+        await Supplier.get(this._options.baseUrl) ?? await Supplier.get(this._options.environment) ?? MirascopeEnvironment.Production,
+        "v1/traces"
+      ),
+      method: "POST",
+      headers: _headers,
+      contentType: "application/json",
+      queryParameters: requestOptions?.queryParams,
+      requestType: "json",
+      body: TracesCreateOtelRequest.jsonOrThrow(request, {
+        unrecognizedObjectKeys: "strip",
+        omitUndefined: true
+      }),
+      timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 180) * 1e3,
+      maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+      abortSignal: requestOptions?.abortSignal,
+      fetchFn: this._options?.fetch,
+      logging: this._options.logging
+    });
+    if (_response.ok) {
+      return {
+        data: TracesCreateOtelResponse.parseOrThrow(
+          _response.body,
+          {
+            unrecognizedObjectKeys: "passthrough",
+            allowUnrecognizedUnionMembers: true,
+            allowUnrecognizedEnumValues: true,
+            skipValidation: true,
+            breadcrumbsPrefix: ["response"]
+          }
+        ),
+        rawResponse: _response.rawResponse
+      };
+    }
+    if (_response.error.reason === "status-code") {
+      switch (_response.error.statusCode) {
+        case 400:
+          throw new BadRequestError2(
+            _response.error.body,
+            _response.rawResponse
+          );
+        case 401:
+          throw new UnauthorizedError(
+            UnauthorizedErrorBody.parseOrThrow(
+              _response.error.body,
+              {
+                unrecognizedObjectKeys: "passthrough",
+                allowUnrecognizedUnionMembers: true,
+                allowUnrecognizedEnumValues: true,
+                skipValidation: true,
+                breadcrumbsPrefix: ["response"]
+              }
+            ),
+            _response.rawResponse
+          );
+        case 402:
+          throw new PaymentRequiredError(
+            PlanLimitExceededError.parseOrThrow(
+              _response.error.body,
+              {
+                unrecognizedObjectKeys: "passthrough",
+                allowUnrecognizedUnionMembers: true,
+                allowUnrecognizedEnumValues: true,
+                skipValidation: true,
+                breadcrumbsPrefix: ["response"]
+              }
+            ),
+            _response.rawResponse
+          );
+        case 403:
+          throw new ForbiddenError(
+            PermissionDeniedError.parseOrThrow(
+              _response.error.body,
+              {
+                unrecognizedObjectKeys: "passthrough",
+                allowUnrecognizedUnionMembers: true,
+                allowUnrecognizedEnumValues: true,
+                skipValidation: true,
+                breadcrumbsPrefix: ["response"]
+              }
+            ),
+            _response.rawResponse
+          );
+        case 404:
+          throw new NotFoundError2(
+            NotFoundErrorBody.parseOrThrow(_response.error.body, {
+              unrecognizedObjectKeys: "passthrough",
+              allowUnrecognizedUnionMembers: true,
+              allowUnrecognizedEnumValues: true,
+              skipValidation: true,
+              breadcrumbsPrefix: ["response"]
+            }),
+            _response.rawResponse
+          );
+        case 409:
+          throw new ConflictError(
+            _response.error.body,
+            _response.rawResponse
+          );
+        case 429:
+          throw new TooManyRequestsError(
+            RateLimitError2.parseOrThrow(_response.error.body, {
+              unrecognizedObjectKeys: "passthrough",
+              allowUnrecognizedUnionMembers: true,
+              allowUnrecognizedEnumValues: true,
+              skipValidation: true,
+              breadcrumbsPrefix: ["response"]
+            }),
+            _response.rawResponse
+          );
+        case 500:
+          throw new InternalServerError(
+            _response.error.body,
+            _response.rawResponse
+          );
+        case 503:
+          throw new ServiceUnavailableError(
+            _response.error.body,
+            _response.rawResponse
+          );
+        default:
+          throw new MirascopeError2({
+            statusCode: _response.error.statusCode,
+            body: _response.error.body,
+            rawResponse: _response.rawResponse
+          });
+      }
+    }
+    return handleNonStatusCodeError(
+      _response.error,
+      _response.rawResponse,
+      "POST",
+      "/v1/traces"
+    );
+  }
   /**
    * @param {Mirascope.TracesSearchRequest} request
    * @param {TracesClient.RequestOptions} requestOptions - Request-specific configuration.