@struct-ai/sdk 0.2.0 → 0.3.0

package/dist/node_modules/@struct-ai/sdk/dist/commonjs/integrations/langchain-callback.d.ts

@@ -1,134 +0,0 @@
-import { type Tracer } from "@opentelemetry/api";
-import type { Logger } from "@opentelemetry/api-logs";
-import { type StructSDK } from "../core.js";
-type Serialized = {
-    lc?: number;
-    type?: string;
-    id?: string[];
-    kwargs?: Record<string, unknown>;
-    name?: string;
-};
-type UnknownMessage = unknown;
-interface ChatGenerationLike {
-    text?: string;
-    message?: UnknownMessage;
-    generationInfo?: Record<string, unknown>;
-}
-interface LLMResultLike {
-    generations: ChatGenerationLike[][];
-    llmOutput?: Record<string, unknown>;
-}
-/**
- * LangChain CallbackHandler — creates OTel spans from LangChain callbacks.
- *
- * Parent-child linkage comes from `parentRunId` fields LangChain passes to us,
- * NOT from OTel's async context. This survives LangGraph's internal task
- * shuffling, which is why the callback API is the industry-standard integration
- * point (LangSmith, OpenInference, Traceloop, Langfuse all use it).
- *
- * thread_id vs gen_ai.conversation.id
- * -----------------------------------
- * These are distinct concepts and Struct keeps them separate:
- *
- * - `config.configurable.thread_id` is LangGraph's checkpoint identifier,
- *   keying a conversation's state in the checkpointer. Multiple turns of
- *   the same conversation reuse one thread_id so history accumulates.
- *
- * - `gen_ai.conversation.id` is the OTel GenAI-spec conversation identifier
- *   and Struct's UI grouping unit — one value = one entry in the sessions
- *   list. For the top-level agent we auto-derive it from thread_id, so a
- *   stable thread_id across multi-turn chats collapses into one session.
- *
- * For SUBAGENTS (an agent invoked from inside another's tool body) we
- * deliberately assign a DIFFERENT conversation.id — either from the subagent's
- * own thread_id if supplied, or a fresh UUID. The resulting session is
- * linked back to the outer agent's session via the
- * `struct.agent.parent_session_id` span attribute (what powers "Spawned
- * by" / subagent navigation in the UI). Without this split the subagent's
- * spans would collapse into the outer session, burying delegation.
- *
- * LangChain quirk (handled automatically): when `agent.invoke(...)` runs
- * nested inside a parent call, LangChain's config-merge inherits the
- * parent's `metadata.thread_id` onto the child even if its config provided
- * a different one. We detect that by comparing against the nearest agent
- * ancestor's session; if they match, treat it as "inherited, not
- * user-intended" and assign a fresh UUID to the subagent.
- *
- * End-user guidance:
- *   - Use thread_id per conversation; multi-turn chats reuse it.
- *   - For a subagent call, pass a DIFFERENT thread_id (or omit it and let
- *     LangGraph generate one). Each subagent then surfaces as its own
- *     session in the UI, linked back via parent_session_id.
- */
-export declare class StructCallbackHandler {
-    private readonly sdk;
-    private readonly tracer;
-    private readonly logger;
-    readonly name = "struct";
-    readonly lc_namespace: readonly string[];
-    readonly lc_serializable = false;
-    readonly awaitHandlers = false;
-    readonly ignoreLLM = false;
-    readonly ignoreChain = false;
-    readonly ignoreAgent = false;
-    readonly ignoreRetriever = false;
-    readonly ignoreCustomEvent = true;
-    /**
-     * LangChain reads `raiseError` to decide whether a callback throw should
-     * abort the user's run. We keep this `false` because every callback method
-     * is wrapped in `safe()` and never throws — but a `true` here would tell
-     * LangChain to surface our (impossible) throws into the user's call.
-     * Locked by `test_handler_raiseError_is_false`.
-     */
-    readonly raiseError = false;
-    private readonly runs;
-    private readonly internalLogger;
-    constructor(sdk: StructSDK, tracer: Tracer, logger: Logger | undefined);
-    handleChainStart: (chain: Serialized, inputs: unknown, runId: string, parentRunId?: string, _tags?: string[], metadata?: Record<string, unknown>, runType?: string, runName?: string) => void;
-    handleChainEnd: (_outputs: unknown, runId: string) => void;
-    handleChainError: (err: Error, runId: string) => void;
-    handleChatModelStart: (llm: Serialized, messages: UnknownMessage[][], runId: string, parentRunId?: string, extraParams?: Record<string, unknown>, _tags?: string[], metadata?: Record<string, unknown>, runName?: string) => void;
-    handleLLMStart: (llm: Serialized, prompts: string[], runId: string, parentRunId?: string, extraParams?: Record<string, unknown>, tags?: string[], metadata?: Record<string, unknown>, runName?: string) => void;
-    handleLLMEnd: (output: LLMResultLike, runId: string) => void;
-    handleLLMError: (err: Error, runId: string) => void;
-    handleToolStart: (tool: Serialized, input: string, runId: string, parentRunId?: string, _tags?: string[], metadata?: Record<string, unknown>, runName?: string) => void;
-    handleToolEnd: (output: unknown, runId: string) => void;
-    handleToolError: (err: Error, runId: string) => void;
-    handleRetrieverStart: (retriever: Serialized, query: string, runId: string, parentRunId?: string, _tags?: string[], metadata?: Record<string, unknown>, runName?: string) => void;
-    handleRetrieverEnd: (documents: unknown[], runId: string) => void;
-    handleRetrieverError: (err: Error, runId: string) => void;
-    private resolveParent;
-    /**
-     * Conversation-id resolution for chat/tool/retriever spans — INHERIT from
-     * the parent agent so everything rolls up under one gen_ai.conversation.id.
-     */
-    private resolveSessionId;
-    /**
-     * Walk the run tree to find the nearest ``invoke_agent`` ancestor's
-     * gen_ai.conversation.id.
-     *
-     * The immediate ``parentRunId`` might be a tool, LLM, retriever, or a
-     * filtered RunnableSequence — none of which are agents themselves. We
-     * populate ``nearestAgentSessionId`` at each run's creation so any
-     * descendant can read it in O(1).
-     *
-     * Used to set ``struct.agent.parent_session_id`` on nested ``invoke_agent``
-     * spans (our UI's "Spawned by" / "Subagents" linkage).
-     */
-    private inheritedAgentSessionId;
-    /**
-     * Conversation-id resolution for AGENT spans — each agent invocation gets
-     * its own gen_ai.conversation.id. We deliberately do NOT inherit from the
-     * parent run, so subagents surface as separate entries in the sessions
-     * list. Parent linkage is preserved via `struct.agent.parent_session_id`.
-     *
-     * LangChain inherits `metadata.thread_id` from the parent invoke's config
-     * when a nested invoke runs inside it (even if the child config supplied
-     * its own). We detect that inheritance by comparing against the parent's
-     * resolved session and ignore the inherited value.
-     */
-    private resolveAgentSessionId;
-    private propagateUserPrompt;
-}
-export {};
-//# sourceMappingURL=langchain-callback.d.ts.map

package/dist/node_modules/@struct-ai/sdk/dist/commonjs/integrations/langchain-content.d.ts

@@ -1,35 +0,0 @@
-import type { Part } from "./anthropic-content.js";
-export declare const PROVIDER_MAP: Record<string, string>;
-export declare const MODULE_PROVIDER_MAP: Record<string, string>;
-/** Detect LLM provider from a LangChain model instance. */
-export declare function detectProvider(model: unknown): string;
-/** Probe `modelName`, `model`, `modelId` attrs in order. */
-export declare function detectModel(model: unknown): string;
-/**
- * Extract the messages list from LangChain invoke()'s input argument.
- * Handles: BaseMessage[], string, PromptValue (via toChatMessages/toMessages),
- * dict with .messages key.
- */
-export declare function extractInputMessages(input: unknown): unknown[];
-/**
- * Extract thread_id from LangChain/LangGraph RunnableConfig.
- * Signature: (input, config?, ...).  Config has shape { configurable: { thread_id: "..." } }.
- */
-export declare function extractThreadId(args: readonly unknown[], options?: unknown): string | undefined;
-/**
- * Extract tool_call_id from LangChain ToolCall input.
- * LangChain tool invocation input shape: { name, args, id, type: "tool_call" }.
- */
-export declare function extractToolCallId(args: readonly unknown[]): string | undefined;
-/** Convert a LangChain message to (role, parts). Uses ._getType() first, falls back to class name. */
-export declare function langchainMessageToRoleAndParts(msg: unknown): {
-    role: string;
-    parts: Part[];
-};
-export declare function langchainToInputMessages(messages: unknown[]): string;
-export declare function langchainToOutputMessages(result: unknown): string;
-/** Last user message parts for parent invoke_agent span propagation. */
-export declare function lastUserMessageParts(messages: unknown[]): Part[] | undefined;
-/** Merge a list of LangChain AIMessageChunks into one via .concat(). */
-export declare function mergeChunks(chunks: unknown[]): unknown;
-//# sourceMappingURL=langchain-content.d.ts.map

package/dist/node_modules/@struct-ai/sdk/dist/commonjs/integrations/langchain.d.ts

@@ -1,11 +0,0 @@
-import type { StructSDK } from "../core.js";
-import { StructCallbackHandler } from "./langchain-callback.js";
-/**
- * Export the handler so callers can register it explicitly
- * (e.g. `runnable.invoke(x, { callbacks: [struct.langchainHandler] })`)
- * when the global monkey-patch isn't an option.
- */
-export declare function getLangchainHandler(): StructCallbackHandler | undefined;
-export declare function patch(sdk: StructSDK): Promise<void>;
-export declare function unpatch(): Promise<void>;
-//# sourceMappingURL=langchain.d.ts.map

package/dist/node_modules/@struct-ai/sdk/dist/commonjs/package.json

@@ -1,3 +0,0 @@
-{
-  "type": "commonjs"
-}

package/dist/node_modules/@struct-ai/sdk/dist/commonjs/semconv.d.ts

@@ -1,54 +0,0 @@
-export declare const GEN_AI: {
-    readonly OPERATION_NAME: "gen_ai.operation.name";
-    readonly PROVIDER_NAME: "gen_ai.provider.name";
-    readonly SYSTEM: "gen_ai.system";
-    readonly AGENT_NAME: "gen_ai.agent.name";
-    readonly AGENT_ID: "gen_ai.agent.id";
-    readonly AGENT_VERSION: "gen_ai.agent.version";
-    readonly CONVERSATION_ID: "gen_ai.conversation.id";
-    readonly REQUEST_MODEL: "gen_ai.request.model";
-    readonly REQUEST_MAX_TOKENS: "gen_ai.request.max_tokens";
-    readonly REQUEST_TEMPERATURE: "gen_ai.request.temperature";
-    readonly REQUEST_TOP_P: "gen_ai.request.top_p";
-    readonly REQUEST_TOP_K: "gen_ai.request.top_k";
-    readonly REQUEST_FREQUENCY_PENALTY: "gen_ai.request.frequency_penalty";
-    readonly REQUEST_PRESENCE_PENALTY: "gen_ai.request.presence_penalty";
-    readonly REQUEST_STOP_SEQUENCES: "gen_ai.request.stop_sequences";
-    readonly RESPONSE_MODEL: "gen_ai.response.model";
-    readonly RESPONSE_FINISH_REASONS: "gen_ai.response.finish_reasons";
-    readonly RESPONSE_ID: "gen_ai.response.id";
-    readonly USAGE_INPUT_TOKENS: "gen_ai.usage.input_tokens";
-    readonly USAGE_OUTPUT_TOKENS: "gen_ai.usage.output_tokens";
-    readonly USAGE_CACHE_READ_INPUT_TOKENS: "gen_ai.usage.cache_read.input_tokens";
-    readonly USAGE_CACHE_CREATION_INPUT_TOKENS: "gen_ai.usage.cache_creation.input_tokens";
-    readonly INPUT_MESSAGES: "gen_ai.input.messages";
-    readonly OUTPUT_MESSAGES: "gen_ai.output.messages";
-    readonly SYSTEM_INSTRUCTIONS: "gen_ai.system_instructions";
-    readonly TOOL_DEFINITIONS: "gen_ai.tool.definitions";
-    readonly TOOL_NAME: "gen_ai.tool.name";
-    readonly TOOL_CALL_ID: "gen_ai.tool.call.id";
-    readonly TOOL_CALL_ARGUMENTS: "gen_ai.tool.call.arguments";
-    readonly TOOL_CALL_RESULT: "gen_ai.tool.call.result";
-    readonly DATA_SOURCE_ID: "gen_ai.data_source.id";
-    readonly RETRIEVAL_QUERY_TEXT: "gen_ai.retrieval.query.text";
-    readonly RETRIEVAL_DOCUMENTS: "gen_ai.retrieval.documents";
-    readonly MESSAGE_INDEX: "gen_ai.message.index";
-};
-export declare const STRUCT: {
-    readonly METADATA_PREFIX: "struct.metadata.";
-    readonly AGENT_PARENT_SESSION_ID: "struct.agent.parent_session_id";
-    readonly INPUT_MESSAGE_COUNT: "struct.input.message_count";
-};
-export declare const EVENT_NAME = "event.name";
-export declare const ERROR_TYPE = "error.type";
-export declare const EVENT_NAMES: {
-    readonly USER_MESSAGE: "gen_ai.user.message";
-    readonly ASSISTANT_MESSAGE: "gen_ai.assistant.message";
-    readonly SYSTEM_MESSAGE: "gen_ai.system.message";
-    readonly TOOL_MESSAGE: "gen_ai.tool.message";
-    readonly CHOICE: "gen_ai.choice";
-};
-export declare const ROLE_TO_EVENT_NAME: Record<string, string>;
-export declare const ANTHROPIC_FINISH_REASON_MAP: Record<string, string>;
-export declare const LANGCHAIN_FINISH_REASON_MAP: Record<string, string>;
-//# sourceMappingURL=semconv.d.ts.map

package/dist/node_modules/@struct-ai/sdk/dist/commonjs/truncation.d.ts

@@ -1,10 +0,0 @@
-export declare const MAX_CONTENT_SIZE: number;
-export declare const MAX_FIELD_SIZE = 16384;
-export declare const TRUNCATION_MARKER = "\u2026 [truncated]";
-export declare function truncateField<T>(value: T, maxLen?: number): T | string;
-type Part = Record<string, unknown>;
-export declare function truncateParts(parts: Part[]): Part[];
-export declare function truncateAndSerialize(obj: unknown, maxSize?: number): string;
-export declare function safeJsonStringify(obj: unknown): string;
-export {};
-//# sourceMappingURL=truncation.d.ts.map

package/dist/node_modules/@struct-ai/sdk/dist/esm/content-capture.d.ts

@@ -1,10 +0,0 @@
-export declare enum ContentCaptureMode {
-    None = "none",
-    EventOnly = "event_only",
-    SpanOnly = "span_only",
-    SpanAndEvent = "span_and_event"
-}
-export declare function emitEventsFor(mode: ContentCaptureMode): boolean;
-export declare function emitSpanContentFor(mode: ContentCaptureMode): boolean;
-export declare function captureContentFor(mode: ContentCaptureMode): boolean;
-//# sourceMappingURL=content-capture.d.ts.map

package/dist/node_modules/@struct-ai/sdk/dist/esm/context.d.ts

@@ -1,30 +0,0 @@
-import type { Span } from "@opentelemetry/api";
-export interface StructContext {
-    sessionId?: string;
-    conversationId?: string;
-    agentSpan?: Span;
-    pendingToolCalls?: Record<string, string[]>;
-}
-export declare function getStore(): StructContext | undefined;
-export declare function getSessionId(): string | undefined;
-export declare function getConversationId(): string | undefined;
-export declare function getAgentSpan(): Span | undefined;
-export declare function getPendingToolCalls(): Record<string, string[]> | undefined;
-export declare function runWithContext<T>(patch: Partial<StructContext>, fn: () => T): T;
-export declare function ensurePendingToolCallsSlot(): Record<string, string[]>;
-/**
- * Pop the first pending tool_use id matching `name`, or undefined.
- * FIFO semantics match Python struct-sdk-python.
- */
-export declare function popPendingToolCallId(name: string): string | undefined;
-/**
- * Push (name, id) pairs into the active pending-tool-calls slot.
- * Initializes a transient dict if no active agent scope.
- */
-export declare function pushPendingToolCalls(pairs: readonly [string, string][]): void;
-/** Snapshot the store for wrapping async iterators. */
-export declare function snapshotStore(): StructContext | undefined;
-export declare function runWithStore<T>(store: StructContext | undefined, fn: () => T): T;
-/** Test-only: run `fn` inside a completely fresh context (no parent store). */
-export declare function runInFreshContext<T>(fn: () => T): T;
-//# sourceMappingURL=context.d.ts.map

package/dist/node_modules/@struct-ai/sdk/dist/esm/core.d.ts

@@ -1,120 +0,0 @@
-import { type Tracer } from "@opentelemetry/api";
-import { type Logger } from "@opentelemetry/api-logs";
-import { type LogRecordProcessor } from "@opentelemetry/sdk-logs";
-import type { SpanProcessor } from "@opentelemetry/sdk-trace-base";
-import { ContentCaptureMode } from "./content-capture.js";
-export declare const DEFAULT_ENDPOINT = "https://ingest.struct.ai";
-export interface InitOptions {
-    ingestKey: string;
-    serviceName?: string;
-    serviceVersion?: string;
-    environment?: string;
-    endpoint?: string;
-    captureContent?: boolean;
-    contentCapture?: ContentCaptureMode;
-    /**
-     * Maximum time `shutdown()` is allowed to spend flushing telemetry providers
-     * before returning. If the ingest endpoint is dead or slow, shutdown returns
-     * within this budget rather than hanging the host process exit. Defaults to
-     * 5000ms. Can be overridden per call via `shutdown(timeoutMs)`.
-     */
-    shutdownTimeoutMs?: number;
-}
-export interface AgentScopeOptions {
-    name: string;
-    sessionId?: string;
-    /**
-     * Stable identifier for the agent DEFINITION — `gen_ai.agent.id` per the OTel
-     * GenAI spec. Not the same as sessionId (which identifies a single
-     * invocation / conversation). Omit if you don't have a stable ID.
-     */
-    agentId?: string;
-    version?: string;
-    metadata?: Record<string, string>;
-}
-export interface ToolScopeOptions {
-    name: string;
-    toolCallId?: string;
-}
-export interface InternalLogger {
-    info(msg: string, ...args: unknown[]): void;
-    warn(msg: string, ...args: unknown[]): void;
-    debug(msg: string, ...args: unknown[]): void;
-}
-/**
- * Sites that have already logged a first-failure WARN; subsequent failures at
- * the same site log at DEBUG. Mirrors `_first_failure_logged` in the Python
- * SDK.
- *
- * Exported for tests that need to clear the set between runs so log-level
- * assertions are deterministic. Internal — not re-exported from `index.ts`,
- * so consumers cannot reach it via the package's public API surface.
- */
-export declare const firstFailureLogged: Set<string>;
-/**
- * Run `fn`; swallow any exception. The first failure per `site` logs at WARN
- * (with the error attached); subsequent failures at the same site log at
- * DEBUG. The caller's logger is passed explicitly so this helper stays a free
- * module-level function — usable from instrumentation modules that don't
- * carry an SDK reference of their own.
- *
- * Mirrors `_safe(fn, *, site)` in the Python SDK.
- */
-export declare function safe(fn: () => void, site: string, logger: InternalLogger): void;
-export declare class StructSDK {
-    private _initialized;
-    private _tracerProvider;
-    private _loggerProvider;
-    private _ingestKey;
-    private _endpoint;
-    private _contentCapture;
-    private _shutdownHook;
-    private _shutdownTimeoutMs;
-    private _internalLogger;
-    private _readyPromise;
-    /** Resolves once auto-instrumentation has attempted to patch every detected library. */
-    get ready(): Promise<void>;
-    get initialized(): boolean;
-    get endpoint(): string;
-    get ingestKey(): string;
-    get contentCapture(): ContentCaptureMode;
-    get captureContent(): boolean;
-    get emitEvents(): boolean;
-    get emitSpanContent(): boolean;
-    init(options: InitOptions): void;
-    getTracer(name?: string): Tracer;
-    getLogger(name?: string): Logger;
-    getInternalLogger(): InternalLogger;
-    /** Test-only: attach a custom span processor to the internal provider. */
-    addSpanProcessor(processor: SpanProcessor): void;
-    /** Test-only: attach a custom log record processor. */
-    addLogRecordProcessor(processor: LogRecordProcessor): void;
-    /**
-     * Shut down the SDK and flush pending telemetry.
-     *
-     * Returns within `timeoutMs` (default: SDK init's `shutdownTimeoutMs`,
-     * fallback 5000ms). If the ingest endpoint is unreachable, in-flight
-     * telemetry may be dropped — the trade-off vs. blocking process exit.
-     *
-     * In serverless / edge runtimes (Lambda, Vercel, etc.), the runtime does
-     * NOT await our `beforeExit` hook. Call `await struct.shutdown()`
-     * explicitly before your function returns or before container freeze.
-     *
-     * Safe to call multiple times. Safe to call on an SDK that failed to init
-     * or was never initialized.
-     *
-     * @param timeoutMs - Override the configured shutdown timeout for this call.
-     */
-    shutdown(timeoutMs?: number): Promise<void>;
-    /**
-     * Run `fn` inside an `invoke_agent` span scope.
-     * Matches Python's _AgentContext behavior.
-     */
-    agent<T>(options: AgentScopeOptions, fn: () => Promise<T> | T): Promise<T>;
-    /**
-     * Run `fn` inside an `execute_tool` span scope.
-     * Matches Python's _ToolContext behavior.
-     */
-    tool<T>(options: ToolScopeOptions, fn: () => Promise<T> | T): Promise<T>;
-}
-//# sourceMappingURL=core.d.ts.map

package/dist/node_modules/@struct-ai/sdk/dist/esm/events.d.ts

@@ -1,12 +0,0 @@
-import { type Logger } from "@opentelemetry/api-logs";
-/**
- * Emit per-message log events for an Anthropic messages.create() call.
- * Port of _emit_message_events from anthropic.py.
- */
-export declare function emitAnthropicMessageEvents(logger: Logger, messages: unknown, system: unknown): void;
-/**
- * Emit a gen_ai.choice LogRecord for an Anthropic response.
- * Port of _emit_choice_event from anthropic.py.
- */
-export declare function emitAnthropicChoiceEvent(logger: Logger, contentBlocks: unknown, stopReason: string | null | undefined): void;
-//# sourceMappingURL=events.d.ts.map

package/dist/node_modules/@struct-ai/sdk/dist/esm/index.d.ts

@@ -1,6 +0,0 @@
-import { StructSDK } from "./core.js";
-export { ContentCaptureMode } from "./content-capture.js";
-export type { AgentScopeOptions, InitOptions, InternalLogger, ToolScopeOptions, } from "./core.js";
-export { StructSDK } from "./core.js";
-export declare const struct: StructSDK;
-//# sourceMappingURL=index.d.ts.map

package/dist/node_modules/@struct-ai/sdk/dist/esm/integrations/anthropic-content.d.ts

@@ -1,24 +0,0 @@
-import { truncateField } from "../truncation.js";
-/** Part in the GenAI spec format. */
-export type Part = Record<string, unknown>;
-/**
- * Walk Anthropic response content blocks, return (name, id) pairs for tool_use blocks.
- * Port of _iter_tool_uses from anthropic.py.
- */
-export declare function iterToolUses(blocks: unknown): Array<[string, string]>;
-/**
- * Convert arbitrary content (string | block[] | unknown) → GenAI parts.
- * Port of _content_to_parts from anthropic.py.
- */
-export declare function contentToParts(content: unknown): Part[];
-/** Convert Anthropic message list → GenAI input-messages JSON string. */
-export declare function toInputMessages(messages: unknown): string;
-/** Convert response content blocks → GenAI output-messages JSON string. */
-export declare function toOutputMessages(contentBlocks: unknown, stopReason: string | null | undefined): string;
-/** Convert system prompt (string | block[]) → GenAI system_instructions JSON string. */
-export declare function toSystemInstructions(system: unknown): string;
-export declare function safeJsonForTool(obj: unknown): string;
-/** Extract the last user message's parts for parent-span propagation. */
-export declare function lastUserMessageParts(messages: unknown): Part[] | undefined;
-export { truncateField };
-//# sourceMappingURL=anthropic-content.d.ts.map

package/dist/node_modules/@struct-ai/sdk/dist/esm/integrations/anthropic.d.ts

@@ -1,34 +0,0 @@
-import { type Tracer } from "@opentelemetry/api";
-import type { Logger } from "@opentelemetry/api-logs";
-import { type StructSDK } from "../core.js";
-interface PatchContext {
-    tracer: Tracer;
-    sdk: StructSDK;
-    logger: Logger | undefined;
-}
-interface CreateParams {
-    model?: string;
-    max_tokens?: number;
-    temperature?: number;
-    top_p?: number;
-    top_k?: number;
-    stop_sequences?: string[];
-    messages?: unknown[];
-    system?: unknown;
-    tools?: unknown[];
-    stream?: boolean;
-}
-export declare function patch(sdk: StructSDK): Promise<void>;
-export declare function unpatch(): Promise<void>;
-type CreateMethod = (this: unknown, params: CreateParams, opts?: unknown) => unknown;
-type StreamMethod = (this: unknown, params: CreateParams, opts?: unknown) => unknown;
-/** @internal */
-export type _PatchContextForTest = PatchContext;
-/** @internal */
-export declare function _wrapCreateForTest(original: CreateMethod): CreateMethod;
-/** @internal */
-export declare function _wrapStreamForTest(original: StreamMethod): StreamMethod;
-/** @internal */
-export declare function _setActivePatchCtxForTest(ctx: PatchContext | undefined): void;
-export {};
-//# sourceMappingURL=anthropic.d.ts.map

package/dist/node_modules/@struct-ai/sdk/dist/esm/integrations/index.d.ts

@@ -1,5 +0,0 @@
-import type { StructSDK } from "../core.js";
-export declare const patchedIntegrations: Set<string>;
-export declare function resetPatchedIntegrations(): void;
-export declare function autoInstrument(sdk: StructSDK): Promise<void>;
-//# sourceMappingURL=index.d.ts.map

package/dist/node_modules/@struct-ai/sdk/dist/esm/integrations/langchain-callback.d.ts

@@ -1,134 +0,0 @@
-import { type Tracer } from "@opentelemetry/api";
-import type { Logger } from "@opentelemetry/api-logs";
-import { type StructSDK } from "../core.js";
-type Serialized = {
-    lc?: number;
-    type?: string;
-    id?: string[];
-    kwargs?: Record<string, unknown>;
-    name?: string;
-};
-type UnknownMessage = unknown;
-interface ChatGenerationLike {
-    text?: string;
-    message?: UnknownMessage;
-    generationInfo?: Record<string, unknown>;
-}
-interface LLMResultLike {
-    generations: ChatGenerationLike[][];
-    llmOutput?: Record<string, unknown>;
-}
-/**
- * LangChain CallbackHandler — creates OTel spans from LangChain callbacks.
- *
- * Parent-child linkage comes from `parentRunId` fields LangChain passes to us,
- * NOT from OTel's async context. This survives LangGraph's internal task
- * shuffling, which is why the callback API is the industry-standard integration
- * point (LangSmith, OpenInference, Traceloop, Langfuse all use it).
- *
- * thread_id vs gen_ai.conversation.id
- * -----------------------------------
- * These are distinct concepts and Struct keeps them separate:
- *
- * - `config.configurable.thread_id` is LangGraph's checkpoint identifier,
- *   keying a conversation's state in the checkpointer. Multiple turns of
- *   the same conversation reuse one thread_id so history accumulates.
- *
- * - `gen_ai.conversation.id` is the OTel GenAI-spec conversation identifier
- *   and Struct's UI grouping unit — one value = one entry in the sessions
- *   list. For the top-level agent we auto-derive it from thread_id, so a
- *   stable thread_id across multi-turn chats collapses into one session.
- *
- * For SUBAGENTS (an agent invoked from inside another's tool body) we
- * deliberately assign a DIFFERENT conversation.id — either from the subagent's
- * own thread_id if supplied, or a fresh UUID. The resulting session is
- * linked back to the outer agent's session via the
- * `struct.agent.parent_session_id` span attribute (what powers "Spawned
- * by" / subagent navigation in the UI). Without this split the subagent's
- * spans would collapse into the outer session, burying delegation.
- *
- * LangChain quirk (handled automatically): when `agent.invoke(...)` runs
- * nested inside a parent call, LangChain's config-merge inherits the
- * parent's `metadata.thread_id` onto the child even if its config provided
- * a different one. We detect that by comparing against the nearest agent
- * ancestor's session; if they match, treat it as "inherited, not
- * user-intended" and assign a fresh UUID to the subagent.
- *
- * End-user guidance:
- *   - Use thread_id per conversation; multi-turn chats reuse it.
- *   - For a subagent call, pass a DIFFERENT thread_id (or omit it and let
- *     LangGraph generate one). Each subagent then surfaces as its own
- *     session in the UI, linked back via parent_session_id.
- */
-export declare class StructCallbackHandler {
-    private readonly sdk;
-    private readonly tracer;
-    private readonly logger;
-    readonly name = "struct";
-    readonly lc_namespace: readonly string[];
-    readonly lc_serializable = false;
-    readonly awaitHandlers = false;
-    readonly ignoreLLM = false;
-    readonly ignoreChain = false;
-    readonly ignoreAgent = false;
-    readonly ignoreRetriever = false;
-    readonly ignoreCustomEvent = true;
-    /**
-     * LangChain reads `raiseError` to decide whether a callback throw should
-     * abort the user's run. We keep this `false` because every callback method
-     * is wrapped in `safe()` and never throws — but a `true` here would tell
-     * LangChain to surface our (impossible) throws into the user's call.
-     * Locked by `test_handler_raiseError_is_false`.
-     */
-    readonly raiseError = false;
-    private readonly runs;
-    private readonly internalLogger;
-    constructor(sdk: StructSDK, tracer: Tracer, logger: Logger | undefined);
-    handleChainStart: (chain: Serialized, inputs: unknown, runId: string, parentRunId?: string, _tags?: string[], metadata?: Record<string, unknown>, runType?: string, runName?: string) => void;
-    handleChainEnd: (_outputs: unknown, runId: string) => void;
-    handleChainError: (err: Error, runId: string) => void;
-    handleChatModelStart: (llm: Serialized, messages: UnknownMessage[][], runId: string, parentRunId?: string, extraParams?: Record<string, unknown>, _tags?: string[], metadata?: Record<string, unknown>, runName?: string) => void;
-    handleLLMStart: (llm: Serialized, prompts: string[], runId: string, parentRunId?: string, extraParams?: Record<string, unknown>, tags?: string[], metadata?: Record<string, unknown>, runName?: string) => void;
-    handleLLMEnd: (output: LLMResultLike, runId: string) => void;
-    handleLLMError: (err: Error, runId: string) => void;
-    handleToolStart: (tool: Serialized, input: string, runId: string, parentRunId?: string, _tags?: string[], metadata?: Record<string, unknown>, runName?: string) => void;
-    handleToolEnd: (output: unknown, runId: string) => void;
-    handleToolError: (err: Error, runId: string) => void;
-    handleRetrieverStart: (retriever: Serialized, query: string, runId: string, parentRunId?: string, _tags?: string[], metadata?: Record<string, unknown>, runName?: string) => void;
-    handleRetrieverEnd: (documents: unknown[], runId: string) => void;
-    handleRetrieverError: (err: Error, runId: string) => void;
-    private resolveParent;
-    /**
-     * Conversation-id resolution for chat/tool/retriever spans — INHERIT from
-     * the parent agent so everything rolls up under one gen_ai.conversation.id.
-     */
-    private resolveSessionId;
-    /**
-     * Walk the run tree to find the nearest ``invoke_agent`` ancestor's
-     * gen_ai.conversation.id.
-     *
-     * The immediate ``parentRunId`` might be a tool, LLM, retriever, or a
-     * filtered RunnableSequence — none of which are agents themselves. We
-     * populate ``nearestAgentSessionId`` at each run's creation so any
-     * descendant can read it in O(1).
-     *
-     * Used to set ``struct.agent.parent_session_id`` on nested ``invoke_agent``
-     * spans (our UI's "Spawned by" / "Subagents" linkage).
-     */
-    private inheritedAgentSessionId;
-    /**
-     * Conversation-id resolution for AGENT spans — each agent invocation gets
-     * its own gen_ai.conversation.id. We deliberately do NOT inherit from the
-     * parent run, so subagents surface as separate entries in the sessions
-     * list. Parent linkage is preserved via `struct.agent.parent_session_id`.
-     *
-     * LangChain inherits `metadata.thread_id` from the parent invoke's config
-     * when a nested invoke runs inside it (even if the child config supplied
-     * its own). We detect that inheritance by comparing against the parent's
-     * resolved session and ignore the inherited value.
-     */
-    private resolveAgentSessionId;
-    private propagateUserPrompt;
-}
-export {};
-//# sourceMappingURL=langchain-callback.d.ts.map