@raindrop-ai/deep-agents 0.1.2 → 0.1.3

package/README.md

@@ -139,7 +139,7 @@ The `createRaindropDeepAgents()` factory returns:
 - **Streaming**: Token-by-token streaming events are not captured individually; only the final aggregated response is tracked.
 - **Subagent isolation**: When using the `task` tool for subagent delegation, each subagent's callbacks fire independently.
 - **Concurrent invocations on a shared handler**: A single handler instance keeps one in-flight span map at a time. Running multiple `agent.invoke(...)` calls **concurrently with the same handler** (e.g. `Promise.all([agent.invoke(...), agent.invoke(...)])` with the same `raindrop.handler`) can scramble the linkage between events and traces. Instantiate one `createRaindropDeepAgents()` per concurrent request; sequential invocations on a shared handler are fully supported.
-- **Long chain inputs/outputs are truncated**: Chain-level `input` and `output` captured on the root event are truncated to ~8 KB to stay within the SDK's payload-size limit. Per-LLM child events still carry full prompts. Tool payloads are pruned to their cap _before_ JSON serialization, so a multi-MB tool output costs the cap — not the payload — on your event loop (truncated values carry a `...[truncated by raindrop]` marker).
+- **Long inputs/outputs are truncated at `maxTextFieldChars`**: The root event's `input` is the latest user message and its `output` the final response, each capped at the configured `maxTextFieldChars` (default 1,000,000 chars), the same cap the other JavaScript integrations use; the full conversation history lives on the LLM span (`ai.prompt.messages`). Tool payloads are pruned to the cap _before_ JSON serialization, so a multi-MB tool output costs the cap — not the payload — on your event loop (truncated values carry a `...[truncated by raindrop]` marker).
 
 ## Testing
 

package/dist/index.d.mts

@@ -517,6 +517,15 @@ interface RaindropDeepAgentsHandlerOptions {
     eventName?: string;
     eventId?: () => string;
     traceChains?: boolean;
+    /**
+     * Per-field caps this handler captures against, fixed for its lifetime:
+     * `maxTextFieldChars` for span attributes (further reduced by
+     * `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` as each span is captured, the
+     * way the trace shipper applies it), `eventMaxTextFieldChars` for event
+     * `input`/`output`. Default to the module-wide cap at construction.
+     */
+    maxTextFieldChars?: number;
+    eventMaxTextFieldChars?: number;
 }
 declare class RaindropDeepAgentsHandler extends BaseCallbackHandler {
     name: string;
@@ -527,6 +536,8 @@ declare class RaindropDeepAgentsHandler extends BaseCallbackHandler {
     private eventName?;
     private eventIdSource?;
     private traceChains;
+    private readonly configuredSpanMaxChars;
+    private readonly eventMaxChars;
     private spans;
     private rootRunIds;
     private eventIds;
@@ -539,6 +550,7 @@ declare class RaindropDeepAgentsHandler extends BaseCallbackHandler {
      */
     _lastRootEventId: string | undefined;
     constructor(opts: RaindropDeepAgentsHandlerOptions);
+    private get spanMaxChars();
     private getEventId;
     private getParent;
     private cleanup;
@@ -587,6 +599,15 @@ interface DeepAgentsOptions {
      */
     projectId?: string;
     traceChains?: boolean;
+    /**
+     * Per-field character cap for captured text and JSON (`ai.prompt.messages`,
+     * `ai.toolCall.args` / `ai.toolCall.result`, event `input` / `output`).
+     * A history that does not fit is cut at message boundaries, stays valid
+     * JSON and is flagged with `ai.prompt.messages.truncated`. Module-wide,
+     * shared with the underlying shippers; omitting it leaves the current cap
+     * unchanged. Defaults to 1,000,000.
+     */
+    maxTextFieldChars?: number;
     /** Application Git identity. Auto-detects commit SHA by default; pass `false` to disable. */
     appGit?: AppGitOptions | false;
 }

package/dist/index.d.ts

@@ -517,6 +517,15 @@ interface RaindropDeepAgentsHandlerOptions {
     eventName?: string;
     eventId?: () => string;
     traceChains?: boolean;
+    /**
+     * Per-field caps this handler captures against, fixed for its lifetime:
+     * `maxTextFieldChars` for span attributes (further reduced by
+     * `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` as each span is captured, the
+     * way the trace shipper applies it), `eventMaxTextFieldChars` for event
+     * `input`/`output`. Default to the module-wide cap at construction.
+     */
+    maxTextFieldChars?: number;
+    eventMaxTextFieldChars?: number;
 }
 declare class RaindropDeepAgentsHandler extends BaseCallbackHandler {
     name: string;
@@ -527,6 +536,8 @@ declare class RaindropDeepAgentsHandler extends BaseCallbackHandler {
     private eventName?;
     private eventIdSource?;
     private traceChains;
+    private readonly configuredSpanMaxChars;
+    private readonly eventMaxChars;
     private spans;
     private rootRunIds;
     private eventIds;
@@ -539,6 +550,7 @@ declare class RaindropDeepAgentsHandler extends BaseCallbackHandler {
      */
     _lastRootEventId: string | undefined;
     constructor(opts: RaindropDeepAgentsHandlerOptions);
+    private get spanMaxChars();
     private getEventId;
     private getParent;
     private cleanup;
@@ -587,6 +599,15 @@ interface DeepAgentsOptions {
      */
     projectId?: string;
     traceChains?: boolean;
+    /**
+     * Per-field character cap for captured text and JSON (`ai.prompt.messages`,
+     * `ai.toolCall.args` / `ai.toolCall.result`, event `input` / `output`).
+     * A history that does not fit is cut at message boundaries, stays valid
+     * JSON and is flagged with `ai.prompt.messages.truncated`. Module-wide,
+     * shared with the underlying shippers; omitting it leaves the current cap
+     * unchanged. Defaults to 1,000,000.
+     */
+    maxTextFieldChars?: number;
     /** Application Git identity. Auto-detects commit SHA by default; pass `false` to disable. */
     appGit?: AppGitOptions | false;
 }