@raindrop-ai/ai-sdk 0.3.2 → 0.3.4

package/dist/index.browser.d.mts

@@ -1,3 +1,99 @@
+type OtlpAnyValue = {
+    stringValue?: string;
+    intValue?: string;
+    doubleValue?: number;
+    boolValue?: boolean;
+    arrayValue?: {
+        values: OtlpAnyValue[];
+    };
+};
+type OtlpKeyValue = {
+    key: string;
+    value: OtlpAnyValue;
+};
+declare const SpanStatusCode: {
+    readonly UNSET: 0;
+    readonly OK: 1;
+    readonly ERROR: 2;
+};
+type OtlpSpanStatus = {
+    code: (typeof SpanStatusCode)[keyof typeof SpanStatusCode] | number;
+    message?: string;
+};
+type OtlpSpan = {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    startTimeUnixNano: string;
+    endTimeUnixNano: string;
+    attributes?: OtlpKeyValue[];
+    status?: OtlpSpanStatus;
+};
+type SpanIds = {
+    traceIdB64: string;
+    spanIdB64: string;
+    parentSpanIdB64?: string;
+};
+/** Kept structural so public integration declarations do not depend on private schemas. */
+type AppGitOptions = {
+    commitSha?: string | null;
+    commitDirty?: boolean | null;
+    branch?: string | null;
+    detectBranch?: boolean;
+    sourceDirectory?: string;
+    autoDetect?: boolean;
+};
+type AppGitSnapshot = Readonly<Record<string, unknown>>;
+type AppGitEnvironment = Readonly<Record<string, string | undefined>>;
+type AppGitLocalResult = {
+    commitSha?: string;
+    commitDirty?: boolean;
+    branch?: string;
+};
+type AppGitOperationOwner = string;
+type AppGitLocalResolver = (sourceDirectory: string | undefined, detectBranch: boolean, completed: (result: AppGitLocalResult) => void) => () => void;
+/** One client owns its defaults; operation snapshots never wait for discovery. */
+declare class AppGitContextImpl {
+    private defaults;
+    private explicit;
+    private explicitKeys;
+    private cancel;
+    private disposed;
+    private operations;
+    private operationOverflow;
+    private detectBranch;
+    private replayBranch;
+    private disabled;
+    constructor(options: AppGitOptions | false | undefined, runtime?: {
+        allowLocalGit?: boolean;
+        resolveLocal?: AppGitLocalResolver;
+        env?: AppGitEnvironment;
+        captureLegacyReplayBranch?: boolean;
+        allowDiscovery?: boolean;
+    });
+    private accept;
+    snapshot(properties?: Readonly<Record<string, unknown>>): AppGitSnapshot;
+    /** Safe defaults when no operation/span start was observed; never infer identity. */
+    snapshotExplicit(properties?: Readonly<Record<string, unknown>>, eventId?: string): AppGitSnapshot;
+    /** Existing replay branch reporting stays separate from opt-in event properties. */
+    snapshotForReplay(): AppGitSnapshot;
+    /** Merge a frozen span snapshot without losing client-authored provenance. */
+    mergeSnapshot(base: AppGitSnapshot, properties?: Readonly<Record<string, unknown>>, explicitKeys?: ReadonlySet<string>): AppGitSnapshot;
+    /** Shippers belonging to one client share this bounded operation registry. */
+    forOperation(eventId: string | undefined, properties?: Readonly<Record<string, unknown>>, owner?: AppGitOperationOwner): AppGitSnapshot;
+    releaseOperation(eventId: string, owner: AppGitOperationOwner): void;
+    finishOperation(eventId: string): void;
+    dispose(): void;
+}
+/** Structural at package boundaries: public SDK bundles contain independent copies of core. */
+type AppGitContext = Pick<AppGitContextImpl, "snapshot" | "snapshotForReplay" | "forOperation" | "finishOperation" | "dispose"> & {
+    snapshotExplicit?: AppGitContextImpl["snapshotExplicit"];
+    mergeSnapshot?: AppGitContextImpl["mergeSnapshot"];
+    releaseOperation?: (eventId: string, owner: AppGitOperationOwner) => void;
+};
+declare const AppGitContext: typeof AppGitContextImpl;
+
 type FeatureFlagValue = string | number | boolean;
 type FeatureFlags = string[] | Record<string, FeatureFlagValue>;
 /**
@@ -198,44 +294,6 @@ declare function fromHeaders(headers: CarrierHeaders): TraceCarrier | null;
  * pass purely because an earlier case consumed the one warning.
  */
 declare function resetUnresolvedCarrierWarning(): void;
-
-type OtlpAnyValue = {
-    stringValue?: string;
-    intValue?: string;
-    doubleValue?: number;
-    boolValue?: boolean;
-    arrayValue?: {
-        values: OtlpAnyValue[];
-    };
-};
-type OtlpKeyValue = {
-    key: string;
-    value: OtlpAnyValue;
-};
-declare const SpanStatusCode: {
-    readonly UNSET: 0;
-    readonly OK: 1;
-    readonly ERROR: 2;
-};
-type OtlpSpanStatus = {
-    code: (typeof SpanStatusCode)[keyof typeof SpanStatusCode] | number;
-    message?: string;
-};
-type OtlpSpan = {
-    traceId: string;
-    spanId: string;
-    parentSpanId?: string;
-    name: string;
-    startTimeUnixNano: string;
-    endTimeUnixNano: string;
-    attributes?: OtlpKeyValue[];
-    status?: OtlpSpanStatus;
-};
-type SpanIds = {
-    traceIdB64: string;
-    spanIdB64: string;
-    parentSpanIdB64?: string;
-};
 type Attachment$1 = {
     type: string;
     role: string;
@@ -277,6 +335,9 @@ type SignalInput = {
     after?: string;
 };
 type EventShipperOptions = {
+    appGit?: AppGitOptions | false;
+    /** Share with the trace shipper so one operation uses one source snapshot. */
+    appGitContext?: AppGitContext;
     writeKey?: string;
     endpoint?: string;
     enabled?: boolean;
@@ -308,6 +369,9 @@ type EventShipperOptions = {
     maxTextFieldChars?: number;
 };
 declare class EventShipper$1 {
+    private appGitContext;
+    private ownsAppGitContext;
+    private readonly appGitOwner;
     private baseUrl;
     private writeKey?;
     private enabled;
@@ -338,6 +402,7 @@ declare class EventShipper$1 {
     /** URL of the local debugger / Workshop daemon, when one is reachable. */
     private localDebuggerUrl;
     constructor(opts: EventShipperOptions);
+    protected ownAppGitContextForShutdown(): void;
     isDebugEnabled(): boolean;
     private authHeaders;
     private requestHeaders;
@@ -450,6 +515,8 @@ type InternalSpan = {
     attributes: Array<OtlpKeyValue | undefined>;
 };
 type TraceShipperOptions = {
+    appGit?: AppGitOptions | false;
+    appGitContext?: AppGitContext;
     writeKey?: string;
     endpoint?: string;
     enabled?: boolean;
@@ -518,6 +585,13 @@ type TraceShipperOptions = {
     maxTextFieldChars?: number;
 };
 declare class TraceShipper$1 {
+    private appGitContext;
+    protected ownsAppGitContext: boolean;
+    private readonly appGitOwner;
+    private appGitEventIds;
+    private appGitActiveSpans;
+    private appGitCaptured;
+    private appGitAdded;
     private baseUrl;
     private writeKey?;
     private enabled;
@@ -691,6 +765,46 @@ declare function getContextManager(): ContextManager;
 declare function currentSpan(): ContextSpan;
 declare function withCurrent<R>(span: ContextSpan, callback: () => R): R;
 
+/**
+ * `ai.prompt.tools`: the tool catalog a model call was given, one JSON
+ * document per tool, in the shape the Vercel AI SDK records on its
+ * `doGenerate` / `doStream` spans. Every integration emits this attribute on
+ * its model-call spans so downstream consumers (agent replay, world builder)
+ * can read what the model could call instead of guessing from the calls it
+ * happened to make.
+ *
+ * An absent attribute means the integration could not observe the tool list;
+ * an empty array means the model had no tools. Callers who know better than
+ * the integration pass a `tools` override, which replaces the inferred list.
+ */
+declare const PROMPT_TOOLS_ATTRIBUTE = "ai.prompt.tools";
+type JsonSchema = Record<string, unknown>;
+type FunctionToolDeclaration = {
+    type: "function";
+    name: string;
+    description?: string;
+    inputSchema?: JsonSchema;
+};
+type ProviderDefinedToolDeclaration = {
+    type: "provider-defined";
+    id?: string;
+    name: string;
+    args?: Record<string, unknown>;
+};
+type ToolDeclaration = FunctionToolDeclaration | ProviderDefinedToolDeclaration;
+/**
+ * What callers hand to a `tools` override. The canonical `ToolDeclaration`
+ * shape is accepted as-is; so is any framework shape `normalizeToolDeclarations`
+ * recognizes (OpenAI, Anthropic, Bedrock, LangChain, Pi, Mastra, AI SDK).
+ */
+type ToolDeclarationInput = ToolDeclaration | {
+    name: string;
+    description?: string;
+    inputSchema?: JsonSchema;
+    parameters?: JsonSchema;
+};
+type PromptToolsOverride = ReadonlyArray<ToolDeclarationInput | unknown>;
+
 declare class EventShipper extends EventShipper$1 {
     constructor(opts: ConstructorParameters<typeof EventShipper$1>[0]);
 }
@@ -1044,6 +1158,11 @@ type RaindropTelemetryIntegrationOptions = {
     debug?: boolean;
     /** See {@link SubagentApiOptions.settledEventIds}. */
     settledEventIds?: Set<string>;
+    /**
+     * Overrides the tool catalog recorded as `ai.prompt.tools` on every model
+     * span (replaces the step's tools; `[]` records an empty catalog).
+     */
+    tools?: PromptToolsOverride;
     context?: {
         userId?: string;
         eventId?: string;
@@ -1061,6 +1180,7 @@ declare class RaindropTelemetryIntegration implements TelemetryIntegration {
     private readonly subagentWrapping;
     private readonly debug;
     private readonly defaultContext;
+    private readonly promptTools;
     private readonly callStates;
     /**
      * Per-tool-call snapshot of the parent-tool ALS context taken right
@@ -1523,6 +1643,17 @@ type RaindropAISDKOptions = {
      * resolves to `default` server-side; byte-identical to prior behavior).
      */
     projectId?: string;
+    /** Application Git identity. Auto-detects commit SHA by default; pass `false` to disable. */
+    appGit?: AppGitOptions | false;
+    /**
+     * Share an application Git context with another telemetry feed owned by the
+     * same logical client. When provided, it takes precedence over `appGit`.
+     *
+     * Integration coordinators must stop every feed using the context before
+     * calling this client's `shutdown()`, which disposes the context. Disposal
+     * is idempotent.
+     */
+    appGitContext?: AppGitContext;
     /**
      * Force-enable (or opt out of) Workshop / local-debugger mirroring.
      *
@@ -1719,6 +1850,12 @@ type WrapAISDKOptions = {
      * Default: false (uses Proxy wrapping for backward compatibility).
      */
     nativeTelemetry?: boolean;
+    /**
+     * Overrides the tool catalog recorded as `ai.prompt.tools` on every model
+     * span, replacing the tools the AI SDK hands the model. `[]` records an
+     * explicitly empty catalog.
+     */
+    tools?: PromptToolsOverride;
 };
 /**
  * Opaque handle for a trace span. Pass as `parent` when creating child spans.
@@ -1815,6 +1952,7 @@ type RaindropAISDKClient = {
     createTelemetryIntegration(contextOrOptions?: RaindropTelemetryIntegrationOptions["context"] | {
         context?: RaindropTelemetryIntegrationOptions["context"];
         subagentWrapping?: boolean;
+        tools?: PromptToolsOverride;
     }): RaindropTelemetryIntegration;
     /**
      * Detached sub-agent hand-offs: record a sub-agent that runs in another
@@ -1928,6 +2066,11 @@ type RaindropTelemetryOptions = RaindropAISDKOptions & {
      * spans nest correctly. Enabled by default.
      */
     subagentWrapping?: boolean;
+    /**
+     * Overrides the tool catalog recorded as `ai.prompt.tools` on every model
+     * span. Use when the integration cannot see the tools the model was given.
+     */
+    tools?: PromptToolsOverride;
 };
 /**
  * One-line factory for the AI SDK v7 `registerTelemetry` DX.
@@ -1962,4 +2105,4 @@ type RaindropTelemetryOptions = RaindropAISDKOptions & {
  */
 declare function raindrop(options?: RaindropTelemetryOptions): RaindropTelemetryIntegration;
 
-export { type AISDKChatRequestLike, type AISDKChatRequestMessageLike, type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, type CarrierHeaders, ContextManager, type ContextSpan, type CreateSpanArgs, DEFAULT_MAX_TEXT_FIELD_CHARS, DEFAULT_REDACT_ATTRIBUTE_KEYS, DEFAULT_SECRET_KEY_NAMES, DETACHED_MODE, type DetachedChildLink, type DetachedDispatch, type EndSpanArgs, type EventBuilder, type EventMetadataOptions, type FeatureFlagValue, type FeatureFlags, HANDOFF_ATTRIBUTE_PREFIXES, HANDOFF_ATTRIBUTE_SUFFIXES, HANDOFF_TERMINAL_CANCELLED, HANDOFF_TERMINAL_PROPERTY_KEY, type IdentifyInput, type OtlpAnyValue, type OtlpSpan, type ParentToolContext, REDACTED_PLACEHOLDER, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type RaindropCallMetadata, RaindropTelemetryIntegration, type RaindropTelemetryIntegrationOptions, type RaindropTelemetryOptions, SUBAGENT_ABORTED_OUTPUT, SUBAGENT_AGENT_ROLE, SUBAGENT_CANCELLED_OUTPUT, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type SelfDiagnosticsTool, type SelfDiagnosticsToolInput, type SelfDiagnosticsToolOptions, type SelfDiagnosticsToolResult, type StartSpanArgs, SubagentApi, type SubagentDispatch, type SubagentDispatchOptions, type SubagentResumeOptions, type SubagentRun, type SubagentRunMetadata, TOOL_EVENTS_ALLOW, TRUNCATION_MARKER, type TraceCarrier, type TraceSpan, type TransformSpanHook, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetParentToolContextStorage, _resetRaindropCallMetadataStorage, _resetWarnedMissingUserId, boundedStringify, capText, clearParentToolContext, createRaindropAISDK, currentSpan, defaultTransformSpan, enterParentToolContext, eventMetadata, eventMetadataFromChatRequest, fromHeaders, getContextManager, getCurrentParentToolContext, getCurrentRaindropCallMetadata, normalizeFeatureFlags, raindrop, readRaindropCallMetadataFromArgs, redactJsonAttributeValue, redactSecretsInObject, resetUnresolvedCarrierWarning, runWithParentToolContext, runWithRaindropCallMetadata, toHeaders, toLangSmithHeaders, withCurrent };
+export { type AISDKChatRequestLike, type AISDKChatRequestMessageLike, type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, type CarrierHeaders, ContextManager, type ContextSpan, type CreateSpanArgs, DEFAULT_MAX_TEXT_FIELD_CHARS, DEFAULT_REDACT_ATTRIBUTE_KEYS, DEFAULT_SECRET_KEY_NAMES, DETACHED_MODE, type DetachedChildLink, type DetachedDispatch, type EndSpanArgs, type EventBuilder, type EventMetadataOptions, type FeatureFlagValue, type FeatureFlags, HANDOFF_ATTRIBUTE_PREFIXES, HANDOFF_ATTRIBUTE_SUFFIXES, HANDOFF_TERMINAL_CANCELLED, HANDOFF_TERMINAL_PROPERTY_KEY, type IdentifyInput, type OtlpAnyValue, type OtlpSpan, PROMPT_TOOLS_ATTRIBUTE, type ParentToolContext, type PromptToolsOverride, REDACTED_PLACEHOLDER, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type RaindropCallMetadata, RaindropTelemetryIntegration, type RaindropTelemetryIntegrationOptions, type RaindropTelemetryOptions, SUBAGENT_ABORTED_OUTPUT, SUBAGENT_AGENT_ROLE, SUBAGENT_CANCELLED_OUTPUT, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type SelfDiagnosticsTool, type SelfDiagnosticsToolInput, type SelfDiagnosticsToolOptions, type SelfDiagnosticsToolResult, type StartSpanArgs, SubagentApi, type SubagentDispatch, type SubagentDispatchOptions, type SubagentResumeOptions, type SubagentRun, type SubagentRunMetadata, TOOL_EVENTS_ALLOW, TRUNCATION_MARKER, type ToolDeclaration, type TraceCarrier, type TraceSpan, type TransformSpanHook, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetParentToolContextStorage, _resetRaindropCallMetadataStorage, _resetWarnedMissingUserId, boundedStringify, capText, clearParentToolContext, createRaindropAISDK, currentSpan, defaultTransformSpan, enterParentToolContext, eventMetadata, eventMetadataFromChatRequest, fromHeaders, getContextManager, getCurrentParentToolContext, getCurrentRaindropCallMetadata, normalizeFeatureFlags, raindrop, readRaindropCallMetadataFromArgs, redactJsonAttributeValue, redactSecretsInObject, resetUnresolvedCarrierWarning, runWithParentToolContext, runWithRaindropCallMetadata, toHeaders, toLangSmithHeaders, withCurrent };

package/dist/index.browser.d.ts

@@ -1,3 +1,99 @@
+type OtlpAnyValue = {
+    stringValue?: string;
+    intValue?: string;
+    doubleValue?: number;
+    boolValue?: boolean;
+    arrayValue?: {
+        values: OtlpAnyValue[];
+    };
+};
+type OtlpKeyValue = {
+    key: string;
+    value: OtlpAnyValue;
+};
+declare const SpanStatusCode: {
+    readonly UNSET: 0;
+    readonly OK: 1;
+    readonly ERROR: 2;
+};
+type OtlpSpanStatus = {
+    code: (typeof SpanStatusCode)[keyof typeof SpanStatusCode] | number;
+    message?: string;
+};
+type OtlpSpan = {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    startTimeUnixNano: string;
+    endTimeUnixNano: string;
+    attributes?: OtlpKeyValue[];
+    status?: OtlpSpanStatus;
+};
+type SpanIds = {
+    traceIdB64: string;
+    spanIdB64: string;
+    parentSpanIdB64?: string;
+};
+/** Kept structural so public integration declarations do not depend on private schemas. */
+type AppGitOptions = {
+    commitSha?: string | null;
+    commitDirty?: boolean | null;
+    branch?: string | null;
+    detectBranch?: boolean;
+    sourceDirectory?: string;
+    autoDetect?: boolean;
+};
+type AppGitSnapshot = Readonly<Record<string, unknown>>;
+type AppGitEnvironment = Readonly<Record<string, string | undefined>>;
+type AppGitLocalResult = {
+    commitSha?: string;
+    commitDirty?: boolean;
+    branch?: string;
+};
+type AppGitOperationOwner = string;
+type AppGitLocalResolver = (sourceDirectory: string | undefined, detectBranch: boolean, completed: (result: AppGitLocalResult) => void) => () => void;
+/** One client owns its defaults; operation snapshots never wait for discovery. */
+declare class AppGitContextImpl {
+    private defaults;
+    private explicit;
+    private explicitKeys;
+    private cancel;
+    private disposed;
+    private operations;
+    private operationOverflow;
+    private detectBranch;
+    private replayBranch;
+    private disabled;
+    constructor(options: AppGitOptions | false | undefined, runtime?: {
+        allowLocalGit?: boolean;
+        resolveLocal?: AppGitLocalResolver;
+        env?: AppGitEnvironment;
+        captureLegacyReplayBranch?: boolean;
+        allowDiscovery?: boolean;
+    });
+    private accept;
+    snapshot(properties?: Readonly<Record<string, unknown>>): AppGitSnapshot;
+    /** Safe defaults when no operation/span start was observed; never infer identity. */
+    snapshotExplicit(properties?: Readonly<Record<string, unknown>>, eventId?: string): AppGitSnapshot;
+    /** Existing replay branch reporting stays separate from opt-in event properties. */
+    snapshotForReplay(): AppGitSnapshot;
+    /** Merge a frozen span snapshot without losing client-authored provenance. */
+    mergeSnapshot(base: AppGitSnapshot, properties?: Readonly<Record<string, unknown>>, explicitKeys?: ReadonlySet<string>): AppGitSnapshot;
+    /** Shippers belonging to one client share this bounded operation registry. */
+    forOperation(eventId: string | undefined, properties?: Readonly<Record<string, unknown>>, owner?: AppGitOperationOwner): AppGitSnapshot;
+    releaseOperation(eventId: string, owner: AppGitOperationOwner): void;
+    finishOperation(eventId: string): void;
+    dispose(): void;
+}
+/** Structural at package boundaries: public SDK bundles contain independent copies of core. */
+type AppGitContext = Pick<AppGitContextImpl, "snapshot" | "snapshotForReplay" | "forOperation" | "finishOperation" | "dispose"> & {
+    snapshotExplicit?: AppGitContextImpl["snapshotExplicit"];
+    mergeSnapshot?: AppGitContextImpl["mergeSnapshot"];
+    releaseOperation?: (eventId: string, owner: AppGitOperationOwner) => void;
+};
+declare const AppGitContext: typeof AppGitContextImpl;
+
 type FeatureFlagValue = string | number | boolean;
 type FeatureFlags = string[] | Record<string, FeatureFlagValue>;
 /**
@@ -198,44 +294,6 @@ declare function fromHeaders(headers: CarrierHeaders): TraceCarrier | null;
  * pass purely because an earlier case consumed the one warning.
  */
 declare function resetUnresolvedCarrierWarning(): void;
-
-type OtlpAnyValue = {
-    stringValue?: string;
-    intValue?: string;
-    doubleValue?: number;
-    boolValue?: boolean;
-    arrayValue?: {
-        values: OtlpAnyValue[];
-    };
-};
-type OtlpKeyValue = {
-    key: string;
-    value: OtlpAnyValue;
-};
-declare const SpanStatusCode: {
-    readonly UNSET: 0;
-    readonly OK: 1;
-    readonly ERROR: 2;
-};
-type OtlpSpanStatus = {
-    code: (typeof SpanStatusCode)[keyof typeof SpanStatusCode] | number;
-    message?: string;
-};
-type OtlpSpan = {
-    traceId: string;
-    spanId: string;
-    parentSpanId?: string;
-    name: string;
-    startTimeUnixNano: string;
-    endTimeUnixNano: string;
-    attributes?: OtlpKeyValue[];
-    status?: OtlpSpanStatus;
-};
-type SpanIds = {
-    traceIdB64: string;
-    spanIdB64: string;
-    parentSpanIdB64?: string;
-};
 type Attachment$1 = {
     type: string;
     role: string;
@@ -277,6 +335,9 @@ type SignalInput = {
     after?: string;
 };
 type EventShipperOptions = {
+    appGit?: AppGitOptions | false;
+    /** Share with the trace shipper so one operation uses one source snapshot. */
+    appGitContext?: AppGitContext;
     writeKey?: string;
     endpoint?: string;
     enabled?: boolean;
@@ -308,6 +369,9 @@ type EventShipperOptions = {
     maxTextFieldChars?: number;
 };
 declare class EventShipper$1 {
+    private appGitContext;
+    private ownsAppGitContext;
+    private readonly appGitOwner;
     private baseUrl;
     private writeKey?;
     private enabled;
@@ -338,6 +402,7 @@ declare class EventShipper$1 {
     /** URL of the local debugger / Workshop daemon, when one is reachable. */
     private localDebuggerUrl;
     constructor(opts: EventShipperOptions);
+    protected ownAppGitContextForShutdown(): void;
     isDebugEnabled(): boolean;
     private authHeaders;
     private requestHeaders;
@@ -450,6 +515,8 @@ type InternalSpan = {
     attributes: Array<OtlpKeyValue | undefined>;
 };
 type TraceShipperOptions = {
+    appGit?: AppGitOptions | false;
+    appGitContext?: AppGitContext;
     writeKey?: string;
     endpoint?: string;
     enabled?: boolean;
@@ -518,6 +585,13 @@ type TraceShipperOptions = {
     maxTextFieldChars?: number;
 };
 declare class TraceShipper$1 {
+    private appGitContext;
+    protected ownsAppGitContext: boolean;
+    private readonly appGitOwner;
+    private appGitEventIds;
+    private appGitActiveSpans;
+    private appGitCaptured;
+    private appGitAdded;
     private baseUrl;
     private writeKey?;
     private enabled;
@@ -691,6 +765,46 @@ declare function getContextManager(): ContextManager;
 declare function currentSpan(): ContextSpan;
 declare function withCurrent<R>(span: ContextSpan, callback: () => R): R;
 
+/**
+ * `ai.prompt.tools`: the tool catalog a model call was given, one JSON
+ * document per tool, in the shape the Vercel AI SDK records on its
+ * `doGenerate` / `doStream` spans. Every integration emits this attribute on
+ * its model-call spans so downstream consumers (agent replay, world builder)
+ * can read what the model could call instead of guessing from the calls it
+ * happened to make.
+ *
+ * An absent attribute means the integration could not observe the tool list;
+ * an empty array means the model had no tools. Callers who know better than
+ * the integration pass a `tools` override, which replaces the inferred list.
+ */
+declare const PROMPT_TOOLS_ATTRIBUTE = "ai.prompt.tools";
+type JsonSchema = Record<string, unknown>;
+type FunctionToolDeclaration = {
+    type: "function";
+    name: string;
+    description?: string;
+    inputSchema?: JsonSchema;
+};
+type ProviderDefinedToolDeclaration = {
+    type: "provider-defined";
+    id?: string;
+    name: string;
+    args?: Record<string, unknown>;
+};
+type ToolDeclaration = FunctionToolDeclaration | ProviderDefinedToolDeclaration;
+/**
+ * What callers hand to a `tools` override. The canonical `ToolDeclaration`
+ * shape is accepted as-is; so is any framework shape `normalizeToolDeclarations`
+ * recognizes (OpenAI, Anthropic, Bedrock, LangChain, Pi, Mastra, AI SDK).
+ */
+type ToolDeclarationInput = ToolDeclaration | {
+    name: string;
+    description?: string;
+    inputSchema?: JsonSchema;
+    parameters?: JsonSchema;
+};
+type PromptToolsOverride = ReadonlyArray<ToolDeclarationInput | unknown>;
+
 declare class EventShipper extends EventShipper$1 {
     constructor(opts: ConstructorParameters<typeof EventShipper$1>[0]);
 }
@@ -1044,6 +1158,11 @@ type RaindropTelemetryIntegrationOptions = {
     debug?: boolean;
     /** See {@link SubagentApiOptions.settledEventIds}. */
     settledEventIds?: Set<string>;
+    /**
+     * Overrides the tool catalog recorded as `ai.prompt.tools` on every model
+     * span (replaces the step's tools; `[]` records an empty catalog).
+     */
+    tools?: PromptToolsOverride;
     context?: {
         userId?: string;
         eventId?: string;
@@ -1061,6 +1180,7 @@ declare class RaindropTelemetryIntegration implements TelemetryIntegration {
     private readonly subagentWrapping;
     private readonly debug;
     private readonly defaultContext;
+    private readonly promptTools;
     private readonly callStates;
     /**
      * Per-tool-call snapshot of the parent-tool ALS context taken right
@@ -1523,6 +1643,17 @@ type RaindropAISDKOptions = {
      * resolves to `default` server-side; byte-identical to prior behavior).
      */
     projectId?: string;
+    /** Application Git identity. Auto-detects commit SHA by default; pass `false` to disable. */
+    appGit?: AppGitOptions | false;
+    /**
+     * Share an application Git context with another telemetry feed owned by the
+     * same logical client. When provided, it takes precedence over `appGit`.
+     *
+     * Integration coordinators must stop every feed using the context before
+     * calling this client's `shutdown()`, which disposes the context. Disposal
+     * is idempotent.
+     */
+    appGitContext?: AppGitContext;
     /**
      * Force-enable (or opt out of) Workshop / local-debugger mirroring.
      *
@@ -1719,6 +1850,12 @@ type WrapAISDKOptions = {
      * Default: false (uses Proxy wrapping for backward compatibility).
      */
     nativeTelemetry?: boolean;
+    /**
+     * Overrides the tool catalog recorded as `ai.prompt.tools` on every model
+     * span, replacing the tools the AI SDK hands the model. `[]` records an
+     * explicitly empty catalog.
+     */
+    tools?: PromptToolsOverride;
 };
 /**
  * Opaque handle for a trace span. Pass as `parent` when creating child spans.
@@ -1815,6 +1952,7 @@ type RaindropAISDKClient = {
     createTelemetryIntegration(contextOrOptions?: RaindropTelemetryIntegrationOptions["context"] | {
         context?: RaindropTelemetryIntegrationOptions["context"];
         subagentWrapping?: boolean;
+        tools?: PromptToolsOverride;
     }): RaindropTelemetryIntegration;
     /**
      * Detached sub-agent hand-offs: record a sub-agent that runs in another
@@ -1928,6 +2066,11 @@ type RaindropTelemetryOptions = RaindropAISDKOptions & {
      * spans nest correctly. Enabled by default.
      */
     subagentWrapping?: boolean;
+    /**
+     * Overrides the tool catalog recorded as `ai.prompt.tools` on every model
+     * span. Use when the integration cannot see the tools the model was given.
+     */
+    tools?: PromptToolsOverride;
 };
 /**
  * One-line factory for the AI SDK v7 `registerTelemetry` DX.
@@ -1962,4 +2105,4 @@ type RaindropTelemetryOptions = RaindropAISDKOptions & {
  */
 declare function raindrop(options?: RaindropTelemetryOptions): RaindropTelemetryIntegration;
 
-export { type AISDKChatRequestLike, type AISDKChatRequestMessageLike, type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, type CarrierHeaders, ContextManager, type ContextSpan, type CreateSpanArgs, DEFAULT_MAX_TEXT_FIELD_CHARS, DEFAULT_REDACT_ATTRIBUTE_KEYS, DEFAULT_SECRET_KEY_NAMES, DETACHED_MODE, type DetachedChildLink, type DetachedDispatch, type EndSpanArgs, type EventBuilder, type EventMetadataOptions, type FeatureFlagValue, type FeatureFlags, HANDOFF_ATTRIBUTE_PREFIXES, HANDOFF_ATTRIBUTE_SUFFIXES, HANDOFF_TERMINAL_CANCELLED, HANDOFF_TERMINAL_PROPERTY_KEY, type IdentifyInput, type OtlpAnyValue, type OtlpSpan, type ParentToolContext, REDACTED_PLACEHOLDER, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type RaindropCallMetadata, RaindropTelemetryIntegration, type RaindropTelemetryIntegrationOptions, type RaindropTelemetryOptions, SUBAGENT_ABORTED_OUTPUT, SUBAGENT_AGENT_ROLE, SUBAGENT_CANCELLED_OUTPUT, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type SelfDiagnosticsTool, type SelfDiagnosticsToolInput, type SelfDiagnosticsToolOptions, type SelfDiagnosticsToolResult, type StartSpanArgs, SubagentApi, type SubagentDispatch, type SubagentDispatchOptions, type SubagentResumeOptions, type SubagentRun, type SubagentRunMetadata, TOOL_EVENTS_ALLOW, TRUNCATION_MARKER, type TraceCarrier, type TraceSpan, type TransformSpanHook, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetParentToolContextStorage, _resetRaindropCallMetadataStorage, _resetWarnedMissingUserId, boundedStringify, capText, clearParentToolContext, createRaindropAISDK, currentSpan, defaultTransformSpan, enterParentToolContext, eventMetadata, eventMetadataFromChatRequest, fromHeaders, getContextManager, getCurrentParentToolContext, getCurrentRaindropCallMetadata, normalizeFeatureFlags, raindrop, readRaindropCallMetadataFromArgs, redactJsonAttributeValue, redactSecretsInObject, resetUnresolvedCarrierWarning, runWithParentToolContext, runWithRaindropCallMetadata, toHeaders, toLangSmithHeaders, withCurrent };
+export { type AISDKChatRequestLike, type AISDKChatRequestMessageLike, type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, type CarrierHeaders, ContextManager, type ContextSpan, type CreateSpanArgs, DEFAULT_MAX_TEXT_FIELD_CHARS, DEFAULT_REDACT_ATTRIBUTE_KEYS, DEFAULT_SECRET_KEY_NAMES, DETACHED_MODE, type DetachedChildLink, type DetachedDispatch, type EndSpanArgs, type EventBuilder, type EventMetadataOptions, type FeatureFlagValue, type FeatureFlags, HANDOFF_ATTRIBUTE_PREFIXES, HANDOFF_ATTRIBUTE_SUFFIXES, HANDOFF_TERMINAL_CANCELLED, HANDOFF_TERMINAL_PROPERTY_KEY, type IdentifyInput, type OtlpAnyValue, type OtlpSpan, PROMPT_TOOLS_ATTRIBUTE, type ParentToolContext, type PromptToolsOverride, REDACTED_PLACEHOLDER, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type RaindropCallMetadata, RaindropTelemetryIntegration, type RaindropTelemetryIntegrationOptions, type RaindropTelemetryOptions, SUBAGENT_ABORTED_OUTPUT, SUBAGENT_AGENT_ROLE, SUBAGENT_CANCELLED_OUTPUT, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type SelfDiagnosticsTool, type SelfDiagnosticsToolInput, type SelfDiagnosticsToolOptions, type SelfDiagnosticsToolResult, type StartSpanArgs, SubagentApi, type SubagentDispatch, type SubagentDispatchOptions, type SubagentResumeOptions, type SubagentRun, type SubagentRunMetadata, TOOL_EVENTS_ALLOW, TRUNCATION_MARKER, type ToolDeclaration, type TraceCarrier, type TraceSpan, type TransformSpanHook, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetParentToolContextStorage, _resetRaindropCallMetadataStorage, _resetWarnedMissingUserId, boundedStringify, capText, clearParentToolContext, createRaindropAISDK, currentSpan, defaultTransformSpan, enterParentToolContext, eventMetadata, eventMetadataFromChatRequest, fromHeaders, getContextManager, getCurrentParentToolContext, getCurrentRaindropCallMetadata, normalizeFeatureFlags, raindrop, readRaindropCallMetadataFromArgs, redactJsonAttributeValue, redactSecretsInObject, resetUnresolvedCarrierWarning, runWithParentToolContext, runWithRaindropCallMetadata, toHeaders, toLangSmithHeaders, withCurrent };