@hue-run/sdk 0.16.0 → 0.18.0

package/dist/types.d.ts

@@ -1,5 +1,7 @@
 import type { Attributes, Context, Span, SpanKind, Tracer, TracerProvider } from "@opentelemetry/api";
+import type { AttributeValue } from "@opentelemetry/api";
 import type { LoggerProvider } from "@opentelemetry/api-logs";
+import type { Attachment } from "./attachment.js";
 /**
  * JSON-compatible data: the shape content has on the wire after the helpers encode it. Helpers
  * accept `unknown` and validate at runtime; values that are not plain JSON are omitted with an
@@ -8,6 +10,14 @@ import type { LoggerProvider } from "@opentelemetry/api-logs";
 export type JsonValue = null | boolean | number | string | JsonValue[] | {
     [key: string]: JsonValue;
 };
+/**
+ * JSON data that may hold an {@link Attachment} anywhere: what a span attribute passed to a helper
+ * may be besides an OpenTelemetry attribute value. Such a value is recorded as JSON text with each
+ * attachment as its digest part.
+ */
+export type AttachmentJson = Attachment | JsonValue | AttachmentJson[] | {
+    [key: string]: AttachmentJson;
+};
 /** Telemetry signal named by export reports, issues and processors. */
 export type Signal = "traces" | "logs";
 /** Options accepted by every Hue client and transport, whether enabled or disabled. */
@@ -124,11 +134,13 @@ export interface ExportReport {
     pendingBytes: number;
     /** Helper capture or instrumentation failures that omitted telemetry while preserving application results. */
     instrumentationFailures: number;
-    /** Span values over Hue's inline limit uploaded apart from their spans (or already stored by
-     * Hue), each listed under the span's `hue.blobs` with its first 16 KiB kept inline. */
+    /** Whole span attributes, inline media, attachments and opted-in file helper uploads stored
+     * apart from their records (or already held by Hue), each listed under the record's
+     * `hue.blobs`. */
     uploadedValues: number;
-    /** Span values over Hue's inline limit that could not be uploaded and were exported cut to the
-     * limit (an inline file as its digest), each reported in a warning issue. */
+    /** Whole-attribute, inline-media, attachment and opted-in file helper uploads that could not be
+     * attached. Content falls back to truncation, media digests, or file metadata, with a warning
+     * issue. */
     uploadFallbacks: number;
 }
 /** Caller budget for {@link HueClient.flushSafe} and {@link HueClient.shutdownSafe}. */
@@ -149,8 +161,15 @@ export interface SafeLifecycleResult {
 export interface SpanOptions {
     /** OpenTelemetry span kind; `INTERNAL` by default. */
     kind?: SpanKind;
-    /** Attributes set when the span starts. */
-    attributes?: Attributes;
+    /**
+     * Attributes set when the span starts. A value that is a JSON object, an array OpenTelemetry
+     * cannot hold (not of one primitive type) or an {@link Attachment} is recorded as JSON text, with
+     * each attachment as its digest part and its bytes uploaded; put files under `metadata` for Hue to
+     * list them as the span's metadata files.
+     */
+    attributes?: {
+        [key: string]: AttributeValue | AttachmentJson | undefined;
+    };
     /** Recorded as `gen_ai.conversation.id` on this span and inherited by nested helper spans. */
     sessionId?: string;
     /** Recorded as `user.id` on this span and inherited by nested helper spans. */
@@ -237,7 +256,9 @@ export interface FileRecord {
     mediaType: string;
     /** Hex SHA-256 of the file's bytes; computed from `data` when omitted. */
     sha256?: string;
-    /** The file's bytes, only hashed and measured, never exported; a string is hashed as UTF-8.
+    /** Upload supplied bytes on this span when content capture is enabled. Defaults to false. */
+    upload?: boolean;
+    /** The file's bytes, hashed and measured locally by default; a string is hashed as UTF-8.
      * Data larger than 25 MiB is omitted and counted as an instrumentation failure. */
     data?: Uint8Array | string;
     /** Size in bytes; computed from `data` when omitted. */

package/dist/version.d.ts

@@ -1,2 +1,2 @@
 /** Package version shared by the instrumentation scope and the export User-Agent. */
-export declare const sdkVersion = "0.16.0";
+export declare const sdkVersion = "0.18.0";

package/dist/version.js

@@ -1,3 +1,3 @@
 // Generated by scripts/write-version.mjs from package.json; do not edit by hand.
 /** Package version shared by the instrumentation scope and the export User-Agent. */
-export const sdkVersion = "0.16.0";
+export const sdkVersion = "0.18.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hue-run/sdk",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "private": false,
   "license": "MIT",
   "publishConfig": {
@@ -99,7 +99,7 @@
     "@opentelemetry/api": "1.9.1",
     "@opentelemetry/context-async-hooks": "2.11.0",
     "@types/bun": "1.4.2",
-    "@types/node": "26.5.1",
+    "@types/node": "26.6.4",
     "ai": "7.0.99",
     "ajv": "8.20.0",
     "protobufjs": "8.8.0",