@agent-inspect/langchain 6.31.34 → 6.31.36

package/dist/index.d.cts

@@ -1,261 +0,0 @@
-import { AgentAction, AgentFinish } from '@langchain/core/agents';
-import { BaseCallbackHandler } from '@langchain/core/callbacks/base';
-import { Serialized } from '@langchain/core/load/serializable';
-import { LLMResult } from '@langchain/core/outputs';
-import { ChainValues } from '@langchain/core/utils/types';
-
-type AttributionConfidence = "explicit" | "correlated" | "heuristic" | "unknown";
-type InspectKind = "RUN" | "AGENT" | "LLM" | "TOOL" | "CHAIN" | "RETRIEVER" | "DECISION" | "RESULT" | "ERROR" | "LOGIC" | "LOG" | "OUTCOME";
-interface EventSource {
-    type: "manual" | "json-log" | "log4js" | "pino" | "winston" | "adapter";
-    file?: string;
-    line?: number;
-}
-interface InspectEvent {
-    eventId: string;
-    runId: string;
-    parentId?: string;
-    name: string;
-    kind: InspectKind;
-    timestamp: number;
-    status?: "running" | "ok" | "error";
-    durationMs?: number;
-    attributes?: Record<string, unknown>;
-    confidence: AttributionConfidence;
-    source: EventSource;
-}
-
-type RedactionStrategy = "full" | "prefix" | "hash";
-type RedactionRule = string | {
-    key: string;
-    strategy: RedactionStrategy;
-    keep?: number;
-};
-
-/** Named redaction presets for trace writing and share-safe exports (v1.3.0+). */
-type RedactionProfile = "local" | "share" | "strict";
-
-/**
- * Capture policy shared by the official adapters.
- *
- * `metadata-only` is the default everywhere and never persists framework
- * payload content. `preview` opts into bounded, redacted previews.
- */
-type AdapterCaptureMode = "metadata-only" | "preview";
-/** Stable diagnostic codes emitted by shared preview capture. */
-declare const ADAPTER_CAPTURE_DIAGNOSTIC_CODES: readonly ["AI_CAPTURE_FIELD_UNAVAILABLE", "AI_CAPTURE_PREVIEW_TRUNCATED", "AI_CAPTURE_PREVIEW_REDACTED"];
-type AdapterCaptureDiagnosticCode = (typeof ADAPTER_CAPTURE_DIAGNOSTIC_CODES)[number];
-/** One bounded diagnostic. Never contains preview content or filesystem paths. */
-interface AdapterCaptureDiagnostic {
-    readonly code: AdapterCaptureDiagnosticCode;
-    readonly message: string;
-    /** Persisted attribute name the diagnostic refers to (e.g. `inputPreview`). */
-    readonly field: string;
-    readonly capture: AdapterCaptureMode;
-}
-/** Optional consumer hook for adapter capture diagnostics. */
-type AdapterDiagnosticListener = (diagnostic: AdapterCaptureDiagnostic) => void;
-/** Bounded capture counters for adapter `getDiagnostics()` surfaces. */
-interface AdapterCaptureDiagnostics {
-    readonly capture: AdapterCaptureMode;
-    readonly redactionProfile: RedactionProfile;
-    readonly maxPreviewChars: number;
-    readonly previewFieldsCaptured: number;
-    readonly previewFieldsUnavailable: number;
-    readonly previewFieldsTruncated: number;
-    readonly previewFieldsRedacted: number;
-    readonly lastDiagnosticCode?: AdapterCaptureDiagnosticCode;
-    readonly lastDiagnosticMessage?: string;
-}
-
-type CaptureMode = "none" | "metadata-only" | "preview";
-interface LangChainStreamingOptions {
-    /**
-     * Capture streaming lifecycle metadata (chunk counts, duration).
-     * Does not capture full token text by default.
-     */
-    stream?: boolean;
-    /**
-     * Maximum streamed preview characters when `capture: "preview"`.
-     * Defaults to `maxPreviewChars` when omitted.
-     */
-    maxStreamPreviewChars?: number;
-}
-interface AgentInspectCallbackOptions extends LangChainStreamingOptions {
-    runName?: string;
-    /** Trace directory for JSONL. When set and `persist` is omitted, persistence is enabled. */
-    traceDir?: string;
-    silent?: boolean;
-    capture?: CaptureMode;
-    redact?: RedactionRule[];
-    maxPreviewChars?: number;
-    /**
-     * Redaction profile applied to preview attributes before persistence.
-     * `share` and `strict` also cap `maxPreviewChars`.
-     *
-     * @experimental Effective only when `capture: "preview"`.
-     */
-    redactionProfile?: RedactionProfile;
-    /**
-     * Receives bounded capture diagnostics such as
-     * `AI_CAPTURE_FIELD_UNAVAILABLE`. Listener failures are isolated.
-     *
-     * @experimental
-     */
-    onDiagnostic?: AdapterDiagnosticListener;
-    /**
-     * Persist callback lifecycle as schemaVersion "0.1" JSONL.
-     * When omitted: enabled if `traceDir` is set, otherwise in-memory only.
-     * Explicit `false` forces in-memory even when `traceDir` is set.
-     */
-    persist?: boolean;
-    /** Optional run id for standalone persisted runs (defaults to generated id). */
-    runId?: string;
-}
-interface LangChainRunMetadata {
-    runId: string;
-    parentRunId?: string;
-    runName?: string;
-    tags?: string[];
-    metadata?: Record<string, unknown>;
-}
-
-/** Subpaths like `@langchain/core/messages/base` are not package exports; derive from the handler contract. */
-type ChatModelMessages = Parameters<NonNullable<BaseCallbackHandler["handleChatModelStart"]>>[1];
-type RetrieverDocuments = Parameters<NonNullable<BaseCallbackHandler["handleRetrieverEnd"]>>[0];
-
-declare class AgentInspectCallback extends BaseCallbackHandler {
-    #private;
-    name: string;
-    /**
-     * Ensure LangGraph/LangChain awaits async handler work (persistence) before
-     * invoke/stream settles. Required for deterministic standalone envelopes.
-     */
-    awaitHandlers: boolean;
-    constructor(options?: AgentInspectCallbackOptions);
-    getEvents(): InspectEvent[];
-    clear(): void;
-    /**
-     * Bounded adapter diagnostics for the current invocation (counts only).
-     * Safe for CLI/MCP summaries — no absolute paths or payloads.
-     *
-     * @experimental
-     */
-    getDiagnostics(): {
-        lateEventCount: number;
-        activeRunCount: number;
-        endedRunCount: number;
-        pendingRelationshipCount: number;
-        knownRelationshipCount: number;
-        syntheticGroupCount: number;
-        selfParentRejectedCount: number;
-        ambiguousRelationshipCount: number;
-        envelopeStarted: boolean;
-        finalized: boolean;
-        completionGeneration: number;
-        hasTerminalError: boolean;
-        inMemoryEventCount: number;
-        deferredPersistStartCount: number;
-        capture: AdapterCaptureDiagnostics;
-    };
-    /**
-     * Drain deferred completion work (microtask finalization).
-     * Idempotent. Failures are isolated and never thrown to user code.
-     *
-     * @experimental Additive finalization API for serverless / unusual callback shapes.
-     */
-    flush(): Promise<void>;
-    /**
-     * Complete the standalone envelope when started. Fallback when automatic
-     * completion cannot run (e.g. process shutdown). Idempotent.
-     * Failures are isolated and never thrown to user code.
-     *
-     * @experimental Additive finalization API for serverless / unusual callback shapes.
-     */
-    finalize(options?: {
-        status?: "success" | "error";
-        errorMessage?: string;
-    }): Promise<void>;
-    /**
-     * `flush()` then `finalize()`. Idempotent. Failures are isolated.
-     *
-     * @experimental Additive finalization API for serverless / unusual callback shapes.
-     */
-    close(): Promise<void>;
-    /**
-     * Match CallbackManager's runtime call order (parentRunId 4th), same as
-     * handleLLMStart / handleToolStart — not the declared CallbackHandlerMethods
-     * TypeScript order that puts runType 4th and parentRunId 8th.
-     */
-    handleChainStart(chain: Serialized, inputs: ChainValues, runId: string, parentRunId?: string, tags?: string[], metadata?: Record<string, unknown>, runType?: string, runName?: string, _extra?: Record<string, unknown>): Promise<void>;
-    handleChainEnd(outputs: ChainValues, runId: string, parentRunId?: string, tags?: string[], _kwargs?: {
-        inputs?: Record<string, unknown>;
-    }): Promise<void>;
-    handleChainError(err: unknown, runId: string, parentRunId?: string, tags?: string[], _kwargs?: {
-        inputs?: Record<string, unknown>;
-    }): Promise<void>;
-    handleLLMStart(llm: Serialized, prompts: string[], runId: string, parentRunId?: string, _extraParams?: Record<string, unknown>, tags?: string[], metadata?: Record<string, unknown>, runName?: string): Promise<void>;
-    handleChatModelStart(llm: Serialized, messages: ChatModelMessages, runId: string, parentRunId?: string, _extraParams?: Record<string, unknown>, tags?: string[], metadata?: Record<string, unknown>, runName?: string): Promise<void>;
-    handleLLMNewToken(token: string, _idx: {
-        prompt: number;
-        completion: number;
-    }, runId: string, _parentRunId?: string, _tags?: string[], _fields?: {
-        chunk?: unknown;
-    }): void | Promise<void>;
-    handleLLMEnd(output: LLMResult, runId: string, parentRunId?: string, tags?: string[], _extraParams?: Record<string, unknown>): Promise<void>;
-    handleLLMError(err: unknown, runId: string, parentRunId?: string, tags?: string[], _extraParams?: Record<string, unknown>): Promise<void>;
-    handleToolStart(tool: Serialized, input: string, runId: string, parentRunId?: string, tags?: string[], metadata?: Record<string, unknown>, runName?: string, toolCallId?: string): Promise<void>;
-    handleToolEnd(output: unknown, runId: string, parentRunId?: string, tags?: string[]): Promise<void>;
-    handleToolError(err: unknown, runId: string, parentRunId?: string, tags?: string[]): Promise<void>;
-    handleRetrieverStart(retriever: Serialized, _query: string, runId: string, parentRunId?: string, tags?: string[], metadata?: Record<string, unknown>, name?: string): Promise<void>;
-    handleRetrieverEnd(documents: RetrieverDocuments, runId: string, parentRunId?: string, tags?: string[]): Promise<void>;
-    handleRetrieverError(err: unknown, runId: string, parentRunId?: string, tags?: string[]): Promise<void>;
-    handleAgentAction(action: AgentAction, runId: string, parentRunId?: string, tags?: string[]): Promise<void>;
-    handleAgentEnd(finish: AgentFinish, runId: string, parentRunId?: string, tags?: string[]): Promise<void>;
-}
-
-/** Options for explicit envelope finalization (serverless / unusual callback shapes). */
-interface FinalizeOptions {
-    status?: "success" | "error";
-    errorMessage?: string;
-    endTime?: number;
-}
-/** Bounded persistence diagnostics (no absolute paths / customer payloads). */
-interface AdapterPersistenceDiagnostics {
-    readonly lateEventCount: number;
-    readonly activeRunCount: number;
-    readonly endedRunCount: number;
-    readonly pendingRelationshipCount: number;
-    readonly knownRelationshipCount: number;
-    readonly syntheticGroupCount: number;
-    readonly selfParentRejectedCount: number;
-    readonly ambiguousRelationshipCount: number;
-    readonly envelopeStarted: boolean;
-    readonly finalized: boolean;
-    readonly completionGeneration: number;
-    readonly hasTerminalError: boolean;
-}
-
-interface TokenUsage {
-    input?: number;
-    output?: number;
-    total?: number;
-    cached?: number;
-    cacheWrite?: number;
-    reasoning?: number;
-}
-/** Extract token usage from LangChain / provider-shaped LLM outputs. Never throws. */
-declare function extractTokenUsage(output: unknown): TokenUsage | undefined;
-/** Best-effort model name from serialized LLM / chat model or provider metadata. */
-declare function extractModelName(serializedOrOutput: unknown): string | undefined;
-/**
- * Safe truncated string preview for logging-style fields.
- *
- * Delegates to the shared adapter preview serializer so every official adapter
- * bounds and escapes preview values identically.
- */
-declare function safePreview(value: unknown, maxChars: number): string | undefined;
-/** Shallow plain metadata: drops functions/symbols; avoids deep nesting. Never throws. */
-declare function toPlainMetadata(value: unknown): Record<string, unknown>;
-
-export { type AdapterPersistenceDiagnostics, AgentInspectCallback, type AgentInspectCallbackOptions, type CaptureMode, type FinalizeOptions, type LangChainRunMetadata, type LangChainStreamingOptions, type TokenUsage, extractModelName, extractTokenUsage, safePreview, toPlainMetadata };

package/dist/index.d.ts

@@ -1,261 +0,0 @@
-import { AgentAction, AgentFinish } from '@langchain/core/agents';
-import { BaseCallbackHandler } from '@langchain/core/callbacks/base';
-import { Serialized } from '@langchain/core/load/serializable';
-import { LLMResult } from '@langchain/core/outputs';
-import { ChainValues } from '@langchain/core/utils/types';
-
-type AttributionConfidence = "explicit" | "correlated" | "heuristic" | "unknown";
-type InspectKind = "RUN" | "AGENT" | "LLM" | "TOOL" | "CHAIN" | "RETRIEVER" | "DECISION" | "RESULT" | "ERROR" | "LOGIC" | "LOG" | "OUTCOME";
-interface EventSource {
-    type: "manual" | "json-log" | "log4js" | "pino" | "winston" | "adapter";
-    file?: string;
-    line?: number;
-}
-interface InspectEvent {
-    eventId: string;
-    runId: string;
-    parentId?: string;
-    name: string;
-    kind: InspectKind;
-    timestamp: number;
-    status?: "running" | "ok" | "error";
-    durationMs?: number;
-    attributes?: Record<string, unknown>;
-    confidence: AttributionConfidence;
-    source: EventSource;
-}
-
-type RedactionStrategy = "full" | "prefix" | "hash";
-type RedactionRule = string | {
-    key: string;
-    strategy: RedactionStrategy;
-    keep?: number;
-};
-
-/** Named redaction presets for trace writing and share-safe exports (v1.3.0+). */
-type RedactionProfile = "local" | "share" | "strict";
-
-/**
- * Capture policy shared by the official adapters.
- *
- * `metadata-only` is the default everywhere and never persists framework
- * payload content. `preview` opts into bounded, redacted previews.
- */
-type AdapterCaptureMode = "metadata-only" | "preview";
-/** Stable diagnostic codes emitted by shared preview capture. */
-declare const ADAPTER_CAPTURE_DIAGNOSTIC_CODES: readonly ["AI_CAPTURE_FIELD_UNAVAILABLE", "AI_CAPTURE_PREVIEW_TRUNCATED", "AI_CAPTURE_PREVIEW_REDACTED"];
-type AdapterCaptureDiagnosticCode = (typeof ADAPTER_CAPTURE_DIAGNOSTIC_CODES)[number];
-/** One bounded diagnostic. Never contains preview content or filesystem paths. */
-interface AdapterCaptureDiagnostic {
-    readonly code: AdapterCaptureDiagnosticCode;
-    readonly message: string;
-    /** Persisted attribute name the diagnostic refers to (e.g. `inputPreview`). */
-    readonly field: string;
-    readonly capture: AdapterCaptureMode;
-}
-/** Optional consumer hook for adapter capture diagnostics. */
-type AdapterDiagnosticListener = (diagnostic: AdapterCaptureDiagnostic) => void;
-/** Bounded capture counters for adapter `getDiagnostics()` surfaces. */
-interface AdapterCaptureDiagnostics {
-    readonly capture: AdapterCaptureMode;
-    readonly redactionProfile: RedactionProfile;
-    readonly maxPreviewChars: number;
-    readonly previewFieldsCaptured: number;
-    readonly previewFieldsUnavailable: number;
-    readonly previewFieldsTruncated: number;
-    readonly previewFieldsRedacted: number;
-    readonly lastDiagnosticCode?: AdapterCaptureDiagnosticCode;
-    readonly lastDiagnosticMessage?: string;
-}
-
-type CaptureMode = "none" | "metadata-only" | "preview";
-interface LangChainStreamingOptions {
-    /**
-     * Capture streaming lifecycle metadata (chunk counts, duration).
-     * Does not capture full token text by default.
-     */
-    stream?: boolean;
-    /**
-     * Maximum streamed preview characters when `capture: "preview"`.
-     * Defaults to `maxPreviewChars` when omitted.
-     */
-    maxStreamPreviewChars?: number;
-}
-interface AgentInspectCallbackOptions extends LangChainStreamingOptions {
-    runName?: string;
-    /** Trace directory for JSONL. When set and `persist` is omitted, persistence is enabled. */
-    traceDir?: string;
-    silent?: boolean;
-    capture?: CaptureMode;
-    redact?: RedactionRule[];
-    maxPreviewChars?: number;
-    /**
-     * Redaction profile applied to preview attributes before persistence.
-     * `share` and `strict` also cap `maxPreviewChars`.
-     *
-     * @experimental Effective only when `capture: "preview"`.
-     */
-    redactionProfile?: RedactionProfile;
-    /**
-     * Receives bounded capture diagnostics such as
-     * `AI_CAPTURE_FIELD_UNAVAILABLE`. Listener failures are isolated.
-     *
-     * @experimental
-     */
-    onDiagnostic?: AdapterDiagnosticListener;
-    /**
-     * Persist callback lifecycle as schemaVersion "0.1" JSONL.
-     * When omitted: enabled if `traceDir` is set, otherwise in-memory only.
-     * Explicit `false` forces in-memory even when `traceDir` is set.
-     */
-    persist?: boolean;
-    /** Optional run id for standalone persisted runs (defaults to generated id). */
-    runId?: string;
-}
-interface LangChainRunMetadata {
-    runId: string;
-    parentRunId?: string;
-    runName?: string;
-    tags?: string[];
-    metadata?: Record<string, unknown>;
-}
-
-/** Subpaths like `@langchain/core/messages/base` are not package exports; derive from the handler contract. */
-type ChatModelMessages = Parameters<NonNullable<BaseCallbackHandler["handleChatModelStart"]>>[1];
-type RetrieverDocuments = Parameters<NonNullable<BaseCallbackHandler["handleRetrieverEnd"]>>[0];
-
-declare class AgentInspectCallback extends BaseCallbackHandler {
-    #private;
-    name: string;
-    /**
-     * Ensure LangGraph/LangChain awaits async handler work (persistence) before
-     * invoke/stream settles. Required for deterministic standalone envelopes.
-     */
-    awaitHandlers: boolean;
-    constructor(options?: AgentInspectCallbackOptions);
-    getEvents(): InspectEvent[];
-    clear(): void;
-    /**
-     * Bounded adapter diagnostics for the current invocation (counts only).
-     * Safe for CLI/MCP summaries — no absolute paths or payloads.
-     *
-     * @experimental
-     */
-    getDiagnostics(): {
-        lateEventCount: number;
-        activeRunCount: number;
-        endedRunCount: number;
-        pendingRelationshipCount: number;
-        knownRelationshipCount: number;
-        syntheticGroupCount: number;
-        selfParentRejectedCount: number;
-        ambiguousRelationshipCount: number;
-        envelopeStarted: boolean;
-        finalized: boolean;
-        completionGeneration: number;
-        hasTerminalError: boolean;
-        inMemoryEventCount: number;
-        deferredPersistStartCount: number;
-        capture: AdapterCaptureDiagnostics;
-    };
-    /**
-     * Drain deferred completion work (microtask finalization).
-     * Idempotent. Failures are isolated and never thrown to user code.
-     *
-     * @experimental Additive finalization API for serverless / unusual callback shapes.
-     */
-    flush(): Promise<void>;
-    /**
-     * Complete the standalone envelope when started. Fallback when automatic
-     * completion cannot run (e.g. process shutdown). Idempotent.
-     * Failures are isolated and never thrown to user code.
-     *
-     * @experimental Additive finalization API for serverless / unusual callback shapes.
-     */
-    finalize(options?: {
-        status?: "success" | "error";
-        errorMessage?: string;
-    }): Promise<void>;
-    /**
-     * `flush()` then `finalize()`. Idempotent. Failures are isolated.
-     *
-     * @experimental Additive finalization API for serverless / unusual callback shapes.
-     */
-    close(): Promise<void>;
-    /**
-     * Match CallbackManager's runtime call order (parentRunId 4th), same as
-     * handleLLMStart / handleToolStart — not the declared CallbackHandlerMethods
-     * TypeScript order that puts runType 4th and parentRunId 8th.
-     */
-    handleChainStart(chain: Serialized, inputs: ChainValues, runId: string, parentRunId?: string, tags?: string[], metadata?: Record<string, unknown>, runType?: string, runName?: string, _extra?: Record<string, unknown>): Promise<void>;
-    handleChainEnd(outputs: ChainValues, runId: string, parentRunId?: string, tags?: string[], _kwargs?: {
-        inputs?: Record<string, unknown>;
-    }): Promise<void>;
-    handleChainError(err: unknown, runId: string, parentRunId?: string, tags?: string[], _kwargs?: {
-        inputs?: Record<string, unknown>;
-    }): Promise<void>;
-    handleLLMStart(llm: Serialized, prompts: string[], runId: string, parentRunId?: string, _extraParams?: Record<string, unknown>, tags?: string[], metadata?: Record<string, unknown>, runName?: string): Promise<void>;
-    handleChatModelStart(llm: Serialized, messages: ChatModelMessages, runId: string, parentRunId?: string, _extraParams?: Record<string, unknown>, tags?: string[], metadata?: Record<string, unknown>, runName?: string): Promise<void>;
-    handleLLMNewToken(token: string, _idx: {
-        prompt: number;
-        completion: number;
-    }, runId: string, _parentRunId?: string, _tags?: string[], _fields?: {
-        chunk?: unknown;
-    }): void | Promise<void>;
-    handleLLMEnd(output: LLMResult, runId: string, parentRunId?: string, tags?: string[], _extraParams?: Record<string, unknown>): Promise<void>;
-    handleLLMError(err: unknown, runId: string, parentRunId?: string, tags?: string[], _extraParams?: Record<string, unknown>): Promise<void>;
-    handleToolStart(tool: Serialized, input: string, runId: string, parentRunId?: string, tags?: string[], metadata?: Record<string, unknown>, runName?: string, toolCallId?: string): Promise<void>;
-    handleToolEnd(output: unknown, runId: string, parentRunId?: string, tags?: string[]): Promise<void>;
-    handleToolError(err: unknown, runId: string, parentRunId?: string, tags?: string[]): Promise<void>;
-    handleRetrieverStart(retriever: Serialized, _query: string, runId: string, parentRunId?: string, tags?: string[], metadata?: Record<string, unknown>, name?: string): Promise<void>;
-    handleRetrieverEnd(documents: RetrieverDocuments, runId: string, parentRunId?: string, tags?: string[]): Promise<void>;
-    handleRetrieverError(err: unknown, runId: string, parentRunId?: string, tags?: string[]): Promise<void>;
-    handleAgentAction(action: AgentAction, runId: string, parentRunId?: string, tags?: string[]): Promise<void>;
-    handleAgentEnd(finish: AgentFinish, runId: string, parentRunId?: string, tags?: string[]): Promise<void>;
-}
-
-/** Options for explicit envelope finalization (serverless / unusual callback shapes). */
-interface FinalizeOptions {
-    status?: "success" | "error";
-    errorMessage?: string;
-    endTime?: number;
-}
-/** Bounded persistence diagnostics (no absolute paths / customer payloads). */
-interface AdapterPersistenceDiagnostics {
-    readonly lateEventCount: number;
-    readonly activeRunCount: number;
-    readonly endedRunCount: number;
-    readonly pendingRelationshipCount: number;
-    readonly knownRelationshipCount: number;
-    readonly syntheticGroupCount: number;
-    readonly selfParentRejectedCount: number;
-    readonly ambiguousRelationshipCount: number;
-    readonly envelopeStarted: boolean;
-    readonly finalized: boolean;
-    readonly completionGeneration: number;
-    readonly hasTerminalError: boolean;
-}
-
-interface TokenUsage {
-    input?: number;
-    output?: number;
-    total?: number;
-    cached?: number;
-    cacheWrite?: number;
-    reasoning?: number;
-}
-/** Extract token usage from LangChain / provider-shaped LLM outputs. Never throws. */
-declare function extractTokenUsage(output: unknown): TokenUsage | undefined;
-/** Best-effort model name from serialized LLM / chat model or provider metadata. */
-declare function extractModelName(serializedOrOutput: unknown): string | undefined;
-/**
- * Safe truncated string preview for logging-style fields.
- *
- * Delegates to the shared adapter preview serializer so every official adapter
- * bounds and escapes preview values identically.
- */
-declare function safePreview(value: unknown, maxChars: number): string | undefined;
-/** Shallow plain metadata: drops functions/symbols; avoids deep nesting. Never throws. */
-declare function toPlainMetadata(value: unknown): Record<string, unknown>;
-
-export { type AdapterPersistenceDiagnostics, AgentInspectCallback, type AgentInspectCallbackOptions, type CaptureMode, type FinalizeOptions, type LangChainRunMetadata, type LangChainStreamingOptions, type TokenUsage, extractModelName, extractTokenUsage, safePreview, toPlainMetadata };