@raindrop-ai/ai-sdk 0.3.2 → 0.3.4

package/dist/{index-BqXHiknB.d.mts → index-DCYSGvxI.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 SubagentRun as $, type AISDKChatRequestLike as A, type BuildEventPatch as B, type CarrierHeaders as C, DEFAULT_MAX_TEXT_FIELD_CHARS as D, type EndSpanArgs as E, type FeatureFlagValue as F, type RaindropTelemetryOptions as G, HANDOFF_ATTRIBUTE_PREFIXES as H, type IdentifyInput as I, SUBAGENT_AGENT_ROLE as J, SUBAGENT_CANCELLED_OUTPUT as K, type SelfDiagnosticsOptions as L, type SelfDiagnosticsSignalDefinition as M, type SelfDiagnosticsSignalDefinitions as N, type OtlpAnyValue as O, type ParentToolContext as P, type SelfDiagnosticsTool as Q, REDACTED_PLACEHOLDER as R, SUBAGENT_ABORTED_OUTPUT as S, type SelfDiagnosticsToolInput as T, type SelfDiagnosticsToolOptions as U, type SelfDiagnosticsToolResult as V, type StartSpanArgs as W, SubagentApi as X, type SubagentDispatch as Y, type SubagentDispatchOptions as Z, type SubagentResumeOptions as _, type AISDKChatRequestMessageLike as a, type SubagentRunMetadata as a0, TOOL_EVENTS_ALLOW as a1, TRUNCATION_MARKER as a2, type TraceCarrier as a3, type TraceSpan as a4, type TransformSpanHook as a5, type WrapAISDKOptions as a6, type WrappedAI as a7, type WrappedAISDK as a8, _resetParentToolContextStorage as a9, _resetRaindropCallMetadataStorage as aa, _resetWarnedMissingUserId as ab, boundedStringify as ac, capText as ad, clearParentToolContext as ae, createRaindropAISDK as af, currentSpan as ag, defaultTransformSpan as ah, enterParentToolContext as ai, eventMetadata as aj, eventMetadataFromChatRequest as ak, fromHeaders as al, getContextManager as am, getCurrentParentToolContext as an, getCurrentRaindropCallMetadata as ao, normalizeFeatureFlags as ap, raindrop as aq, readRaindropCallMetadataFromArgs as ar, redactJsonAttributeValue as as, redactSecretsInObject as at, resetUnresolvedCarrierWarning as au, runWithParentToolContext as av, runWithRaindropCallMetadata as aw, toHeaders as ax, toLangSmithHeaders as ay, withCurrent as az, type AISDKMessage as b, type AgentCallMetadata as c, type AgentWithMetadata as d, type Attachment as e, ContextManager as f, type ContextSpan as g, type CreateSpanArgs as h, DEFAULT_REDACT_ATTRIBUTE_KEYS as i, DEFAULT_SECRET_KEY_NAMES as j, DETACHED_MODE as k, type DetachedChildLink as l, type DetachedDispatch as m, type EventBuilder as n, type EventMetadataOptions as o, type FeatureFlags as p, HANDOFF_ATTRIBUTE_SUFFIXES as q, HANDOFF_TERMINAL_CANCELLED as r, HANDOFF_TERMINAL_PROPERTY_KEY as s, type OtlpSpan as t, type RaindropAISDKClient as u, type RaindropAISDKContext as v, type RaindropAISDKOptions as w, type RaindropCallMetadata as x, RaindropTelemetryIntegration as y, type RaindropTelemetryIntegrationOptions as z };
+export { type SubagentDispatchOptions as $, type AISDKChatRequestLike as A, type BuildEventPatch as B, type CarrierHeaders as C, DEFAULT_MAX_TEXT_FIELD_CHARS as D, type EndSpanArgs as E, type FeatureFlagValue as F, RaindropTelemetryIntegration as G, HANDOFF_ATTRIBUTE_PREFIXES as H, type IdentifyInput as I, type RaindropTelemetryIntegrationOptions as J, type RaindropTelemetryOptions as K, SUBAGENT_AGENT_ROLE as L, SUBAGENT_CANCELLED_OUTPUT as M, type SelfDiagnosticsOptions as N, type OtlpAnyValue as O, PROMPT_TOOLS_ATTRIBUTE as P, type SelfDiagnosticsSignalDefinition as Q, REDACTED_PLACEHOLDER as R, SUBAGENT_ABORTED_OUTPUT as S, type SelfDiagnosticsSignalDefinitions as T, type SelfDiagnosticsTool as U, type SelfDiagnosticsToolInput as V, type SelfDiagnosticsToolOptions as W, type SelfDiagnosticsToolResult as X, type StartSpanArgs as Y, SubagentApi as Z, type SubagentDispatch as _, type AISDKChatRequestMessageLike as a, type SubagentResumeOptions as a0, type SubagentRun as a1, type SubagentRunMetadata as a2, TOOL_EVENTS_ALLOW as a3, TRUNCATION_MARKER as a4, type ToolDeclaration as a5, type TraceCarrier as a6, type TraceSpan as a7, type TransformSpanHook as a8, type WrapAISDKOptions as a9, toHeaders as aA, toLangSmithHeaders as aB, withCurrent as aC, type WrappedAI as aa, type WrappedAISDK as ab, _resetParentToolContextStorage as ac, _resetRaindropCallMetadataStorage as ad, _resetWarnedMissingUserId as ae, boundedStringify as af, capText as ag, clearParentToolContext as ah, createRaindropAISDK as ai, currentSpan as aj, defaultTransformSpan as ak, enterParentToolContext as al, eventMetadata as am, eventMetadataFromChatRequest as an, fromHeaders as ao, getContextManager as ap, getCurrentParentToolContext as aq, getCurrentRaindropCallMetadata as ar, normalizeFeatureFlags as as, raindrop as at, readRaindropCallMetadataFromArgs as au, redactJsonAttributeValue as av, redactSecretsInObject as aw, resetUnresolvedCarrierWarning as ax, runWithParentToolContext as ay, runWithRaindropCallMetadata as az, type AISDKMessage as b, type AgentCallMetadata as c, type AgentWithMetadata as d, type Attachment as e, ContextManager as f, type ContextSpan as g, type CreateSpanArgs as h, DEFAULT_REDACT_ATTRIBUTE_KEYS as i, DEFAULT_SECRET_KEY_NAMES as j, DETACHED_MODE as k, type DetachedChildLink as l, type DetachedDispatch as m, type EventBuilder as n, type EventMetadataOptions as o, type FeatureFlags as p, HANDOFF_ATTRIBUTE_SUFFIXES as q, HANDOFF_TERMINAL_CANCELLED as r, HANDOFF_TERMINAL_PROPERTY_KEY as s, type OtlpSpan as t, type ParentToolContext as u, type PromptToolsOverride as v, type RaindropAISDKClient as w, type RaindropAISDKContext as x, type RaindropAISDKOptions as y, type RaindropCallMetadata as z };

package/dist/{index-BqXHiknB.d.ts → index-DCYSGvxI.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 SubagentRun as $, type AISDKChatRequestLike as A, type BuildEventPatch as B, type CarrierHeaders as C, DEFAULT_MAX_TEXT_FIELD_CHARS as D, type EndSpanArgs as E, type FeatureFlagValue as F, type RaindropTelemetryOptions as G, HANDOFF_ATTRIBUTE_PREFIXES as H, type IdentifyInput as I, SUBAGENT_AGENT_ROLE as J, SUBAGENT_CANCELLED_OUTPUT as K, type SelfDiagnosticsOptions as L, type SelfDiagnosticsSignalDefinition as M, type SelfDiagnosticsSignalDefinitions as N, type OtlpAnyValue as O, type ParentToolContext as P, type SelfDiagnosticsTool as Q, REDACTED_PLACEHOLDER as R, SUBAGENT_ABORTED_OUTPUT as S, type SelfDiagnosticsToolInput as T, type SelfDiagnosticsToolOptions as U, type SelfDiagnosticsToolResult as V, type StartSpanArgs as W, SubagentApi as X, type SubagentDispatch as Y, type SubagentDispatchOptions as Z, type SubagentResumeOptions as _, type AISDKChatRequestMessageLike as a, type SubagentRunMetadata as a0, TOOL_EVENTS_ALLOW as a1, TRUNCATION_MARKER as a2, type TraceCarrier as a3, type TraceSpan as a4, type TransformSpanHook as a5, type WrapAISDKOptions as a6, type WrappedAI as a7, type WrappedAISDK as a8, _resetParentToolContextStorage as a9, _resetRaindropCallMetadataStorage as aa, _resetWarnedMissingUserId as ab, boundedStringify as ac, capText as ad, clearParentToolContext as ae, createRaindropAISDK as af, currentSpan as ag, defaultTransformSpan as ah, enterParentToolContext as ai, eventMetadata as aj, eventMetadataFromChatRequest as ak, fromHeaders as al, getContextManager as am, getCurrentParentToolContext as an, getCurrentRaindropCallMetadata as ao, normalizeFeatureFlags as ap, raindrop as aq, readRaindropCallMetadataFromArgs as ar, redactJsonAttributeValue as as, redactSecretsInObject as at, resetUnresolvedCarrierWarning as au, runWithParentToolContext as av, runWithRaindropCallMetadata as aw, toHeaders as ax, toLangSmithHeaders as ay, withCurrent as az, type AISDKMessage as b, type AgentCallMetadata as c, type AgentWithMetadata as d, type Attachment as e, ContextManager as f, type ContextSpan as g, type CreateSpanArgs as h, DEFAULT_REDACT_ATTRIBUTE_KEYS as i, DEFAULT_SECRET_KEY_NAMES as j, DETACHED_MODE as k, type DetachedChildLink as l, type DetachedDispatch as m, type EventBuilder as n, type EventMetadataOptions as o, type FeatureFlags as p, HANDOFF_ATTRIBUTE_SUFFIXES as q, HANDOFF_TERMINAL_CANCELLED as r, HANDOFF_TERMINAL_PROPERTY_KEY as s, type OtlpSpan as t, type RaindropAISDKClient as u, type RaindropAISDKContext as v, type RaindropAISDKOptions as w, type RaindropCallMetadata as x, RaindropTelemetryIntegration as y, type RaindropTelemetryIntegrationOptions as z };
+export { type SubagentDispatchOptions as $, type AISDKChatRequestLike as A, type BuildEventPatch as B, type CarrierHeaders as C, DEFAULT_MAX_TEXT_FIELD_CHARS as D, type EndSpanArgs as E, type FeatureFlagValue as F, RaindropTelemetryIntegration as G, HANDOFF_ATTRIBUTE_PREFIXES as H, type IdentifyInput as I, type RaindropTelemetryIntegrationOptions as J, type RaindropTelemetryOptions as K, SUBAGENT_AGENT_ROLE as L, SUBAGENT_CANCELLED_OUTPUT as M, type SelfDiagnosticsOptions as N, type OtlpAnyValue as O, PROMPT_TOOLS_ATTRIBUTE as P, type SelfDiagnosticsSignalDefinition as Q, REDACTED_PLACEHOLDER as R, SUBAGENT_ABORTED_OUTPUT as S, type SelfDiagnosticsSignalDefinitions as T, type SelfDiagnosticsTool as U, type SelfDiagnosticsToolInput as V, type SelfDiagnosticsToolOptions as W, type SelfDiagnosticsToolResult as X, type StartSpanArgs as Y, SubagentApi as Z, type SubagentDispatch as _, type AISDKChatRequestMessageLike as a, type SubagentResumeOptions as a0, type SubagentRun as a1, type SubagentRunMetadata as a2, TOOL_EVENTS_ALLOW as a3, TRUNCATION_MARKER as a4, type ToolDeclaration as a5, type TraceCarrier as a6, type TraceSpan as a7, type TransformSpanHook as a8, type WrapAISDKOptions as a9, toHeaders as aA, toLangSmithHeaders as aB, withCurrent as aC, type WrappedAI as aa, type WrappedAISDK as ab, _resetParentToolContextStorage as ac, _resetRaindropCallMetadataStorage as ad, _resetWarnedMissingUserId as ae, boundedStringify as af, capText as ag, clearParentToolContext as ah, createRaindropAISDK as ai, currentSpan as aj, defaultTransformSpan as ak, enterParentToolContext as al, eventMetadata as am, eventMetadataFromChatRequest as an, fromHeaders as ao, getContextManager as ap, getCurrentParentToolContext as aq, getCurrentRaindropCallMetadata as ar, normalizeFeatureFlags as as, raindrop as at, readRaindropCallMetadataFromArgs as au, redactJsonAttributeValue as av, redactSecretsInObject as aw, resetUnresolvedCarrierWarning as ax, runWithParentToolContext as ay, runWithRaindropCallMetadata as az, type AISDKMessage as b, type AgentCallMetadata as c, type AgentWithMetadata as d, type Attachment as e, ContextManager as f, type ContextSpan as g, type CreateSpanArgs as h, DEFAULT_REDACT_ATTRIBUTE_KEYS as i, DEFAULT_SECRET_KEY_NAMES as j, DETACHED_MODE as k, type DetachedChildLink as l, type DetachedDispatch as m, type EventBuilder as n, type EventMetadataOptions as o, type FeatureFlags as p, HANDOFF_ATTRIBUTE_SUFFIXES as q, HANDOFF_TERMINAL_CANCELLED as r, HANDOFF_TERMINAL_PROPERTY_KEY as s, type OtlpSpan as t, type ParentToolContext as u, type PromptToolsOverride as v, type RaindropAISDKClient as w, type RaindropAISDKContext as x, type RaindropAISDKOptions as y, type RaindropCallMetadata as z };