@juspay/neurolink 12.52.1 → 12.54.0

package/dist/constants/enums.d.ts

@@ -60,6 +60,7 @@ export declare enum AIProviderName {
     LEMONFOX_AI = "lemonfox-ai",
     LILAC = "lilac",
     LLMTECH = "llmtech",
+    LONGCAT = "longcat",
     MANCER = "mancer",
     META_MODEL_API = "meta-model-api",
     MINIMAX = "minimax",
@@ -1346,6 +1347,9 @@ export declare enum LilacModels {
 export declare enum LlmtechModels {
     NVIDIA_QWEN3_8_27B_NVFP4 = "nvidia/Qwen3.8-27B-NVFP4"
 }
+export declare enum LongCatModels {
+    LONGCAT_2_5_PREVIEW = "LongCat-2.5-Preview"
+}
 export declare enum MancerModels {
     MYTHOMAX = "mythomax",
     DEEPSEEK_V4_FLASH = "deepseek-v4-flash",

package/dist/constants/enums.js

@@ -65,6 +65,7 @@ export var AIProviderName;
     AIProviderName["LEMONFOX_AI"] = "lemonfox-ai";
     AIProviderName["LILAC"] = "lilac";
     AIProviderName["LLMTECH"] = "llmtech";
+    AIProviderName["LONGCAT"] = "longcat";
     AIProviderName["MANCER"] = "mancer";
     AIProviderName["META_MODEL_API"] = "meta-model-api";
     AIProviderName["MINIMAX"] = "minimax";
@@ -1626,6 +1627,10 @@ export var LlmtechModels;
 (function (LlmtechModels) {
     LlmtechModels["NVIDIA_QWEN3_8_27B_NVFP4"] = "nvidia/Qwen3.8-27B-NVFP4";
 })(LlmtechModels || (LlmtechModels = {}));
+export var LongCatModels;
+(function (LongCatModels) {
+    LongCatModels["LONGCAT_2_5_PREVIEW"] = "LongCat-2.5-Preview";
+})(LongCatModels || (LongCatModels = {}));
 export var MancerModels;
 (function (MancerModels) {
     MancerModels["MYTHOMAX"] = "mythomax";

package/dist/core/toolExecutionGuards.js

@@ -33,7 +33,15 @@ export function guardToolExecutor(name, execute, guards) {
         // The span wraps the CALL, not the guard: a timeout or an abort is a fact
         // about this tool invocation and belongs inside its observation.
         const wrapInSpan = guards.withToolSpan;
-        const call = wrapInSpan ? () => wrapInSpan(name, invoke) : invoke;
+        const toolCallId = typeof opts === "object" &&
+            opts !== null &&
+            "toolCallId" in opts &&
+            typeof opts.toolCallId === "string"
+            ? opts.toolCallId
+            : undefined;
+        const call = wrapInSpan
+            ? () => wrapInSpan(name, invoke, { args, toolCallId })
+            : invoke;
         guards.onProgress?.();
         try {
             const raced = guards.abortSignal

package/dist/providers/catalog/index.generated.d.ts

@@ -1,5 +1,5 @@
 import type { DecideCatalogJson, ProviderCatalogJson } from "../../types/index.js";
 export declare const CATALOG_JSON_ENTRIES: ProviderCatalogJson[];
-export declare const CATALOG_PROVIDER_IDS: readonly ["a2agent", "abliteration", "above-dev", "ai21", "aiand", "aihubmix", "aionlabs", "ambient", "api-route", "arcee", "atlas-cloud", "avian-io", "baidu-qianfan", "baseten", "bee-heossi", "byteplus-modelark", "bytez", "cerebras", "charm-hyper", "chutes", "cloudflare", "crusoe", "dashscope", "deepinfra", "deepseek", "empiriolabs", "featherless-ai", "fireworks", "friendli", "gmicloud", "gradientai", "groq", "hetzner-inference", "huggingface", "inception-labs", "inceptron", "inco", "inference-net", "io-intelligence", "koscompute", "lemonfox-ai", "lilac", "llmtech", "mancer", "meta-model-api", "minimax", "mistral", "moark", "modelscope", "moonshot-ai", "morph", "naver-clova-studio", "nebius", "neuralwatt", "novita", "ovhcloud", "parasail", "pareto-inference", "perplexity", "poolside", "prime-intellect", "reka", "sakana-ai", "sambanova", "sarvam", "scaleway", "siliconflow", "stackit", "stepfun", "subconscious", "synthetic", "telnyx", "thinking-machines", "tinfoil", "together-ai", "umans-ai", "upstage", "venice-ai", "vispark", "vultr-inference", "wafer", "wandb-inference", "xai", "xiaomi-mimo", "z-ai"];
+export declare const CATALOG_PROVIDER_IDS: readonly ["a2agent", "abliteration", "above-dev", "ai21", "aiand", "aihubmix", "aionlabs", "ambient", "api-route", "arcee", "atlas-cloud", "avian-io", "baidu-qianfan", "baseten", "bee-heossi", "byteplus-modelark", "bytez", "cerebras", "charm-hyper", "chutes", "cloudflare", "crusoe", "dashscope", "deepinfra", "deepseek", "empiriolabs", "featherless-ai", "fireworks", "friendli", "gmicloud", "gradientai", "groq", "hetzner-inference", "huggingface", "inception-labs", "inceptron", "inco", "inference-net", "io-intelligence", "koscompute", "lemonfox-ai", "lilac", "llmtech", "longcat", "mancer", "meta-model-api", "minimax", "mistral", "moark", "modelscope", "moonshot-ai", "morph", "naver-clova-studio", "nebius", "neuralwatt", "novita", "ovhcloud", "parasail", "pareto-inference", "perplexity", "poolside", "prime-intellect", "reka", "sakana-ai", "sambanova", "sarvam", "scaleway", "siliconflow", "stackit", "stepfun", "subconscious", "synthetic", "telnyx", "thinking-machines", "tinfoil", "together-ai", "umans-ai", "upstage", "venice-ai", "vispark", "vultr-inference", "wafer", "wandb-inference", "xai", "xiaomi-mimo", "z-ai"];
 export declare const DECIDE_CATALOG_JSON_ENTRIES: DecideCatalogJson[];
 export declare const DECIDE_CATALOG_PROVIDER_IDS: readonly ["laya"];

package/dist/providers/catalog/index.generated.js

@@ -44,6 +44,7 @@ import layaJson from "./laya.json" with { type: "json" };
 import lemonfoxAiJson from "./lemonfox-ai.json" with { type: "json" };
 import lilacJson from "./lilac.json" with { type: "json" };
 import llmtechJson from "./llmtech.json" with { type: "json" };
+import longcatJson from "./longcat.json" with { type: "json" };
 import mancerJson from "./mancer.json" with { type: "json" };
 import metaModelApiJson from "./meta-model-api.json" with { type: "json" };
 import minimaxJson from "./minimax.json" with { type: "json" };
@@ -138,6 +139,7 @@ export const CATALOG_JSON_ENTRIES = [
     lemonfoxAiJson,
     lilacJson,
     llmtechJson,
+    longcatJson,
     mancerJson,
     metaModelApiJson,
     minimaxJson,
@@ -225,6 +227,7 @@ export const CATALOG_PROVIDER_IDS = [
     "lemonfox-ai",
     "lilac",
     "llmtech",
+    "longcat",
     "mancer",
     "meta-model-api",
     "minimax",

package/dist/providers/catalog/longcat.json

@@ -0,0 +1,64 @@
+{
+    "$schema": "./provider-catalog.schema.json",
+    "id": "longcat",
+    "displayName": "LongCat",
+    "enumTypeName": "LongCatModels",
+    "aliases": [],
+    "tier": 2,
+    "wire": {
+        "baseURL": "https://api.longcat.chat/openai/v1"
+    },
+    "models": {
+        "default": "LongCat-2.5-Preview",
+        "fallbacks": ["LongCat-2.5-Preview"],
+        "defaultContextWindow": 1048576,
+        "defaultMaxOutputTokens": 131072,
+        "catalog": {
+            "LongCat-2.5-Preview": {
+                "contextWindow": 1048576,
+                "maxOutputTokens": 131072,
+                "vision": false,
+                "status": "preview",
+                "description": "Meituan LongCat 2.5 Preview, the only model this pilot lists. The 1M-token context rests on the vendor's Retrieve Model sample for this model id, not on a normative sentence. This pilot declares text generate/stream only; tools, vision, structured output and thinking await separate evidence. Account access is unverified."
+            }
+        }
+    },
+    "capabilities": {
+        "text": true,
+        "streaming": true,
+        "tools": false,
+        "toolsWithStreaming": false,
+        "structuredOutput": false,
+        "structuredOutputWithTools": false,
+        "embeddings": false,
+        "thinking": false
+    },
+    "errorRules": [
+        {
+            "status": 401,
+            "class": "authentication",
+            "message": "Invalid or expired LongCat API key. Check {apiKeyEnvVar} and the key in the LongCat platform console at {setupUrl}."
+        }
+    ],
+    "setup": {
+        "url": "https://longcat.chat/platform",
+        "apiKeyFormat": null,
+        "billingPolicy": "no-free-tier",
+        "instructions": [
+            "1. Sign in to the LongCat API platform and create an API key.",
+            "2. LongCat-2.5-Preview is usage-priced pay-as-you-go. Promotional credits, if your account has any, are consumed first, but no free allowance is stated: do not assume free usage. The vendor's Pay-As-You-Go page says account verification is required before topping up, and its FAQ scopes that requirement to users in Mainland China (not tried on an account).",
+            "3. LongCat-2.0 is served on the same route but is outside this pilot's catalog scope, so it is not a default or a fallback here.",
+            "4. Set {apiKeyEnvVar} for this provider. The base URL is https://api.longcat.chat/openai/v1 and the chat route is POST /chat/completions with Authorization: Bearer authentication."
+        ],
+        "description": "LongCat (Meituan) text/stream pilot with a usage-priced LongCat-2.5-Preview default. No free allowance is stated; no account entitlement, roster, live inference or delivery is verified."
+    },
+    "evidence": {
+        "rosterVerified": {
+            "date": "2026-10-12",
+            "code": "VENDOR_DOCS_ONLY_NOT_ROSTER_VERIFIED",
+            "method": "Vendor API documentation facts supplied to this change: default model id, 1048576 context from the vendor's Retrieve Model sample plus the 1M prose, 131072 maximum output, base URL https://api.longcat.chat/openai/v1 and route POST /chat/completions with Bearer auth. No GET /models, credentials, account or inference ran; this legacy field does not assert roster verification."
+        },
+        "liveMatrix": null,
+        "addedInPR": "https://github.com/juspay/neurolink/pull/1980"
+    }
+}

package/dist/providers/googleVertex/client.js

@@ -43,7 +43,7 @@ import { createStreamChannel } from "../../core/streamChannel.js";
 import { toNativeToolDeclarations } from "../../core/nativeToolFormat.js";
 import { getAvailableInputTokens, getContextWindowSize, } from "../../constants/contextWindows.js";
 import { resolveLiveTool } from "../../tools/toolDiscovery.js";
-import { ATTR, LANGFUSE_ATTR, spanJsonAttribute, tracers, withClientSpan, withClientStreamSpan, withSpan, } from "../../telemetry/index.js";
+import { ATTR, LANGFUSE_ATTR, spanContentAttribute, spanJsonAttribute, spanModelRequestAttribute, tracers, withClientSpan, withClientStreamSpan, withSpan, } from "../../telemetry/index.js";
 import { SpanKind, SpanStatusCode, context as otelContext, trace as otelTrace, } from "@opentelemetry/api";
 import { calculateCost } from "../../utils/pricing.js";
 import { transformToolExecutions } from "../../utils/transformationUtils.js";
@@ -3459,7 +3459,7 @@ export class GoogleVertexProvider extends BaseProvider {
         // Usage lives ONLY on the generation spans (Langfuse sums usage across
         // observations for trace totals, so repeating it on the turn double-counts).
         const offeredToolNames = (tools ?? []).map((anthropicTool) => anthropicTool.name);
-        const turnInputAttribute = spanJsonAttribute({
+        const turnInputAttribute = spanModelRequestAttribute({
             system: systemPromptWithSchema,
             messages: sanitizeAnthropicMessagesForTrace(messages),
         });
@@ -3543,6 +3543,7 @@ export class GoogleVertexProvider extends BaseProvider {
         const loopPromise = (async () => {
             let step = 0;
             const currentMessages = [...messages];
+            let stepConversation = currentMessages;
             // Step-cap / abort bookkeeping (mirrors the generate twin): read by the
             // terminal recovery block after the loop and by the finishReason
             // mapping written into finishReasonRef.
@@ -3569,18 +3570,34 @@ export class GoogleVertexProvider extends BaseProvider {
                 // migration. Shared with resolveToolOnMiss below: the old dispatch
                 // opened the span before the executor lookup, so a tool hydrated
                 // mid-turn was observed exactly like one declared up front.
-                const withToolSpan = (toolCallName, run) => {
+                const withToolSpan = (toolCallName, run, call) => {
+                    // Arguments are inputs: honour the same opt-out the AI SDK path uses.
+                    const argsAttribute = call?.args !== undefined &&
+                        process.env.NEUROLINK_RECORD_INPUTS?.trim().toLowerCase() !==
+                            "false"
+                        ? spanContentAttribute(call.args)
+                        : undefined;
                     const toolSpan = tracers.mcp.startSpan("ai.toolCall", {
                         kind: SpanKind.INTERNAL,
                         attributes: {
                             [LANGFUSE_ATTR.OBSERVATION_TYPE]: "tool",
                             [ATTR.GEN_AI_TOOL_NAME]: toolCallName,
                             "ai.toolCall.name": toolCallName,
+                            ...(call?.toolCallId
+                                ? { "ai.toolCall.id": call.toolCallId }
+                                : {}),
+                            ...(argsAttribute !== undefined
+                                ? {
+                                    "ai.toolCall.args": argsAttribute,
+                                    [LANGFUSE_ATTR.OBSERVATION_INPUT]: argsAttribute,
+                                }
+                                : {}),
                         },
                     }, turnContext);
                     const finish = (output, errorMessage) => {
-                        toolSpan.setAttribute("ai.toolCall.result", spanJsonAttribute(output));
-                        toolSpan.setAttribute(LANGFUSE_ATTR.OBSERVATION_OUTPUT, spanJsonAttribute(output));
+                        const outputAttribute = spanContentAttribute(output);
+                        toolSpan.setAttribute("ai.toolCall.result", outputAttribute);
+                        toolSpan.setAttribute(LANGFUSE_ATTR.OBSERVATION_OUTPUT, outputAttribute);
                         if (errorMessage) {
                             toolSpan.setAttribute(LANGFUSE_ATTR.OBSERVATION_LEVEL, "ERROR");
                             toolSpan.setAttribute(LANGFUSE_ATTR.OBSERVATION_STATUS_MESSAGE, errorMessage);
@@ -3742,6 +3759,7 @@ export class GoogleVertexProvider extends BaseProvider {
                     ...baseAdapter,
                     buildStepRequest: (conversation, engineStep) => {
                         step = engineStep + 1;
+                        stepConversation = conversation;
                         turnClock.noteProgress();
                         return baseAdapter.buildStepRequest(conversation, engineStep);
                     },
@@ -3782,9 +3800,9 @@ export class GoogleVertexProvider extends BaseProvider {
                                     temperature: requestParams.temperature,
                                     top_p: requestParams.top_p,
                                 }),
-                                [LANGFUSE_ATTR.OBSERVATION_INPUT]: spanJsonAttribute({
+                                [LANGFUSE_ATTR.OBSERVATION_INPUT]: spanModelRequestAttribute({
                                     system: systemPromptWithSchema,
-                                    messages: sanitizeAnthropicMessagesForTrace(currentMessages),
+                                    messages: sanitizeAnthropicMessagesForTrace(stepConversation),
                                 }),
                                 [LANGFUSE_ATTR.OBSERVATION_METADATA]: spanJsonAttribute({
                                     step,
@@ -3812,7 +3830,13 @@ export class GoogleVertexProvider extends BaseProvider {
                             turnCacheUsage.creation += result.usage.cacheWriteTokens ?? 0;
                             turnCacheUsage.creation5m += result.usage.cacheWrite5mTokens ?? 0;
                             turnCacheUsage.creation1h += result.usage.cacheWrite1hTokens ?? 0;
-                            generationSpan.setAttribute(LANGFUSE_ATTR.OBSERVATION_OUTPUT, spanJsonAttribute({ text: result.text }));
+                            generationSpan.setAttribute(LANGFUSE_ATTR.OBSERVATION_OUTPUT, spanContentAttribute({
+                                text: result.text,
+                                ...(result.toolCalls.length > 0
+                                    ? { toolCalls: result.toolCalls }
+                                    : {}),
+                            }));
+                            generationSpan.setAttribute(`${LANGFUSE_ATTR.OBSERVATION_METADATA}.finishReason`, result.rawStopReason ?? "unknown");
                             return result;
                         }
                         catch (error) {
@@ -4339,7 +4363,7 @@ export class GoogleVertexProvider extends BaseProvider {
                 if (turnCacheUsage.creation > 0) {
                     usage.cacheCreationTokens = turnCacheUsage.creation;
                 }
-                const turnOutputAttribute = spanJsonAttribute({
+                const turnOutputAttribute = spanContentAttribute({
                     text: aggregatedTurnText,
                     ...(structuredOutputRef.value
                         ? { structuredOutput: structuredOutputRef.value }
@@ -4357,6 +4381,7 @@ export class GoogleVertexProvider extends BaseProvider {
                     toolCallCount: metadata.totalToolExecutions,
                     toolsCalled: toolsUsedRef.filter((name) => name !== "final_result"),
                     structuredOutput: useFinalResultTool,
+                    ...(stopReasonRef.value ? { stopReason: stopReasonRef.value } : {}),
                     usage: {
                         input: usage.input,
                         output: usage.output,
@@ -4366,10 +4391,25 @@ export class GoogleVertexProvider extends BaseProvider {
                         input_cache_creation_1h: turnCacheUsage.creation1h,
                     },
                 }));
+                // How the turn ended, on the trace itself, so an evaluator can select
+                // only turns that finished ("completed") and skip capped, timed-out,
+                // aborted and failed ones. A trace holding several turns keeps the last
+                // one's; each turn's own is in its observation metadata above.
+                if (stopReasonRef.value) {
+                    turnSpan.setAttribute(`${LANGFUSE_ATTR.TRACE_METADATA}.stopReason`, stopReasonRef.value);
+                }
                 turnSpan.setStatus({ code: SpanStatusCode.OK });
                 channel.close();
             }
             catch (err) {
+                turnSpan.setAttribute(LANGFUSE_ATTR.OBSERVATION_METADATA, spanJsonAttribute({
+                    toolsOffered: offeredToolNames,
+                    toolCount: offeredToolNames.length,
+                    maxSteps,
+                    structuredOutput: useFinalResultTool,
+                    stopReason: "provider-error",
+                }));
+                turnSpan.setAttribute(`${LANGFUSE_ATTR.TRACE_METADATA}.stopReason`, "provider-error");
                 turnSpan.setStatus({
                     code: SpanStatusCode.ERROR,
                     message: err instanceof Error ? err.message : String(err),
@@ -5635,7 +5675,7 @@ export class GoogleVertexProvider extends BaseProvider {
                 "";
             // Set generation input before the call so error paths still carry the
             // request; output is set after the native call resolves.
-            const generationInputAttribute = spanJsonAttribute({
+            const generationInputAttribute = spanModelRequestAttribute({
                 ...(mergedOptions.systemPrompt
                     ? { system: mergedOptions.systemPrompt }
                     : {}),
@@ -5676,7 +5716,7 @@ export class GoogleVertexProvider extends BaseProvider {
                         });
                         nativeResult = await this.runNativeGenerateWithMiddleware(mergedOptions, modelName, (effectiveOptions) => this.executeNativeGemini3GenerateWithSchemaFallback(effectiveOptions, modelName));
                     }
-                    executionSpan.setAttribute(LANGFUSE_ATTR.OBSERVATION_OUTPUT, spanJsonAttribute(nativeResult?.content ?? ""));
+                    executionSpan.setAttribute(LANGFUSE_ATTR.OBSERVATION_OUTPUT, spanContentAttribute(nativeResult?.content ?? ""));
                     return nativeResult;
                 });
                 this.attachUsageAndCostAttributes(generateSpan, modelName, result?.usage);
@@ -5685,7 +5725,7 @@ export class GoogleVertexProvider extends BaseProvider {
                 // enabled / useAiResponse is false, so the cost is zero on
                 // non-TTS paths.
                 result = await this.synthesizeAIResponseIfNeeded(result, options);
-                generateSpan.setAttribute(LANGFUSE_ATTR.OBSERVATION_OUTPUT, spanJsonAttribute(result?.content ?? ""));
+                generateSpan.setAttribute(LANGFUSE_ATTR.OBSERVATION_OUTPUT, spanContentAttribute(result?.content ?? ""));
                 // Fire onFinish lifecycle callback for the native generate path.
                 // Pipeline A providers get this for free via the AI SDK middleware
                 // wrapper (LifecycleMiddleware); native @google/genai bypasses

package/dist/services/server/ai/observability/instrumentation.d.ts

@@ -124,6 +124,8 @@ export declare function setLangfuseContext<T = void>(context: {
     requestId?: string | null;
     traceName?: string | null;
     metadata?: Record<string, unknown> | null;
+    /** Langfuse trace tags, set on the trace's root span */
+    tags?: string[] | null;
     /** Explicit operation name (overrides auto-detection) */
     operationName?: string | null;
     /** Override global autoDetectOperationName for this context */

package/dist/services/server/ai/observability/instrumentation.js

@@ -298,6 +298,9 @@ class ContextEnricher {
             span.setAttribute("langfuse.trace.name", traceName);
             span.setAttribute("trace.name", traceName);
         }
+        if (isRootSpan && context?.tags && context.tags.length > 0) {
+            span.setAttribute("langfuse.trace.tags", [...context.tags]);
+        }
         // Set operation name as separate attribute for filtering/analytics
         if (operationName) {
             span.setAttribute("gen_ai.operation.name", operationName);
@@ -1163,6 +1166,7 @@ export async function setLangfuseContext(context, callback) {
         metadata: context.metadata !== undefined
             ? context.metadata
             : currentContext.metadata,
+        tags: context.tags !== undefined ? context.tags : currentContext.tags,
         // Operation name support
         operationName: context.operationName !== undefined
             ? context.operationName

package/dist/telemetry/attributes.d.ts

@@ -1,3 +1,4 @@
+import type { SpanModelRequest } from "../types/index.js";
 export declare const ATTR: {
     readonly GEN_AI_SYSTEM: "gen_ai.system";
     readonly GEN_AI_MODEL: "gen_ai.request.model";
@@ -114,6 +115,8 @@ export declare const LANGFUSE_ATTR: {
     readonly TRACE_NAME: "langfuse.trace.name";
     readonly TRACE_INPUT: "langfuse.trace.input";
     readonly TRACE_OUTPUT: "langfuse.trace.output";
+    readonly TRACE_TAGS: "langfuse.trace.tags";
+    readonly TRACE_METADATA: "langfuse.trace.metadata";
     readonly OBSERVATION_TYPE: "langfuse.observation.type";
     readonly OBSERVATION_INPUT: "langfuse.observation.input";
     readonly OBSERVATION_OUTPUT: "langfuse.observation.output";
@@ -127,6 +130,24 @@ export declare const LANGFUSE_ATTR: {
 };
 /** Default ceiling for serialized span attribute values. */
 export declare const SPAN_ATTRIBUTE_MAX_CHARS = 40000;
+/**
+ * Returns a copy of `value` with credentials masked: values under keys such as
+ * `access_token`, `password`, `authorization` or `set-cookie`, bearer tokens
+ * and `name=value` credentials inside text. Content with nothing sensitive in
+ * it serializes exactly as it did before. Throws only if the value cannot be
+ * walked; callers on the tracing path use `spanContentAttribute`, which turns
+ * that into an omitted value instead of a leak or a failed turn.
+ */
+export declare function redactSpanContent(value: unknown): unknown;
+/**
+ * `spanJsonAttribute` for content a person or model wrote or a tool returned
+ * (arguments, results, answers), with credentials masked first. Use the plain
+ * form for metadata such as usage counts and server ids.
+ *
+ * A structured value over the cap is shortened by trimming its longest
+ * strings, so the attribute stays valid JSON instead of ending mid-token.
+ */
+export declare function spanContentAttribute(value: unknown, maxChars?: number): string;
 /**
  * Serialize an arbitrary value for a span attribute, hard-capped at
  * `maxChars` so a pathological prompt or tool result can't put megabytes
@@ -134,3 +155,14 @@ export declare const SPAN_ATTRIBUTE_MAX_CHARS = 40000;
  * JSON-stringified with a String() fallback for circular structures.
  */
 export declare function spanJsonAttribute(value: unknown, maxChars?: number): string;
+/**
+ * Serialize a model request for a span attribute without losing the
+ * conversation to the cap.
+ *
+ * A head cut keeps the system prompt and drops everything after it, so a long
+ * system prompt hides every message, the user's question included. Here the
+ * prompt and the newest messages are budgeted first, older messages are
+ * dropped whole and counted, and the system prompt gets whatever room is left.
+ * The result is always valid JSON.
+ */
+export declare function spanModelRequestAttribute(rawRequest: SpanModelRequest, maxChars?: number): string;