bitfab 0.38.1 → 0.38.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/autoTrace.cjs +187 -0
- package/dist/autoTrace.cjs.map +1 -0
- package/dist/autoTrace.d.cts +39 -0
- package/dist/autoTrace.d.ts +39 -0
- package/dist/autoTrace.js +20 -0
- package/dist/chunk-GFBQ2AMO.js +129 -0
- package/dist/chunk-GFBQ2AMO.js.map +1 -0
- package/dist/chunk-H6LZRFMN.js +59 -0
- package/dist/chunk-H6LZRFMN.js.map +1 -0
- package/dist/{chunk-APYOBPGZ.js → chunk-JSU2Z2Z7.js} +236 -23
- package/dist/{chunk-APYOBPGZ.js.map → chunk-JSU2Z2Z7.js.map} +1 -1
- package/dist/{chunk-DUEN22MC.js → chunk-QWV7JDLQ.js} +13 -58
- package/dist/chunk-QWV7JDLQ.js.map +1 -0
- package/dist/index.cjs +301 -16
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +55 -1
- package/dist/index.d.ts +55 -1
- package/dist/index.js +4 -2
- package/dist/node.cjs +301 -16
- package/dist/node.cjs.map +1 -1
- package/dist/node.js +7 -4
- package/dist/node.js.map +1 -1
- package/dist/{replay-VMHBVAKA.js → replay-DDAYVRET.js} +3 -2
- package/dist/replay-DDAYVRET.js.map +1 -0
- package/package.json +11 -1
- package/dist/chunk-DUEN22MC.js.map +0 -1
- /package/dist/{replay-VMHBVAKA.js.map → autoTrace.js.map} +0 -0
package/dist/index.d.cts
CHANGED
|
@@ -523,6 +523,7 @@ declare class HttpClient {
|
|
|
523
523
|
* Blocks until complete - needed for function execution.
|
|
524
524
|
*/
|
|
525
525
|
lookupFunction<T>(name: string): Promise<T>;
|
|
526
|
+
getAutoTracePolicy<T>(traceFunctionKey: string, protocol: string): Promise<T>;
|
|
526
527
|
getTraceSpan(traceId: string, lookup: SpanLookup): Promise<CapturedSpan | null>;
|
|
527
528
|
private get;
|
|
528
529
|
/**
|
|
@@ -2098,6 +2099,27 @@ interface SpanMethodDecoratorContext<TThis, TValue> {
|
|
|
2098
2099
|
}
|
|
2099
2100
|
/** A standard ECMAScript method decorator produced by {@link Bitfab.span}. */
|
|
2100
2101
|
type SpanMethodDecorator = <TThis, TArgs extends unknown[], TReturn>(originalMethod: (this: TThis, ...args: TArgs) => TReturn, context: SpanMethodDecoratorContext<TThis, (this: TThis, ...args: TArgs) => TReturn>) => (this: TThis, ...args: TArgs) => TReturn;
|
|
2102
|
+
/** Options for experimental automatic subtree tracing. */
|
|
2103
|
+
interface TraceOptions {
|
|
2104
|
+
/** Root span name. Defaults to the decorated or wrapped function name. */
|
|
2105
|
+
name?: string;
|
|
2106
|
+
/** Root span type. Descendants are always `function` spans. */
|
|
2107
|
+
type?: SpanType;
|
|
2108
|
+
/** Maximum number of recorded descendant levels. Defaults to 30. */
|
|
2109
|
+
maxDepth?: number;
|
|
2110
|
+
/** Maximum descendant spans recorded per root invocation. Defaults to 500. */
|
|
2111
|
+
maxSpans?: number;
|
|
2112
|
+
/** Qualified or simple function names to leave out of the subtree. */
|
|
2113
|
+
exclude?: readonly string[] | ReadonlySet<string>;
|
|
2114
|
+
/** Record rest-argument wrapper functions. Defaults to false. */
|
|
2115
|
+
includeWrappers?: boolean;
|
|
2116
|
+
}
|
|
2117
|
+
type StandardTraceMethodDecorator = <This, TArgs extends unknown[], TReturn>(method: (this: This, ...args: TArgs) => TReturn, context: {
|
|
2118
|
+
kind: "method";
|
|
2119
|
+
name: string | symbol;
|
|
2120
|
+
}) => (this: This, ...args: TArgs) => TReturn;
|
|
2121
|
+
type LegacyTraceMethodDecorator = <This, TArgs extends unknown[], TReturn>(target: object, propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<(this: This, ...args: TArgs) => TReturn>) => void;
|
|
2122
|
+
type TraceMethodDecorator = StandardTraceMethodDecorator & LegacyTraceMethodDecorator;
|
|
2101
2123
|
|
|
2102
2124
|
/**
|
|
2103
2125
|
* Client for making provider-based API calls via BAML.
|
|
@@ -2117,6 +2139,7 @@ declare class Bitfab {
|
|
|
2117
2139
|
private readonly httpClient;
|
|
2118
2140
|
private readonly bamlClient;
|
|
2119
2141
|
private readonly dbSnapshot;
|
|
2142
|
+
private readonly autoTracePolicyRefreshes;
|
|
2120
2143
|
/**
|
|
2121
2144
|
* Mock overrides registered via {@link Bitfab.registerMockOverride}, applied
|
|
2122
2145
|
* to every `replay` on this client (after any per-call `mockOverride`). In
|
|
@@ -2129,6 +2152,37 @@ declare class Bitfab {
|
|
|
2129
2152
|
* @param config - Configuration options for the client
|
|
2130
2153
|
*/
|
|
2131
2154
|
constructor(config: BitfabConfig);
|
|
2155
|
+
/**
|
|
2156
|
+
* Decorate a class method as an automatically expanded trace root.
|
|
2157
|
+
*
|
|
2158
|
+
* Build instrumentation turns repository functions called beneath this
|
|
2159
|
+
* method into nested spans. Every generated span preserves structure; only
|
|
2160
|
+
* function IDs selected by the capture policy include inputs and output.
|
|
2161
|
+
* Without a compatible build transform, this still records the decorated
|
|
2162
|
+
* method as a normal rich root span but cannot discover child calls.
|
|
2163
|
+
*
|
|
2164
|
+
* @param traceFunctionKey - Groups traces and their capture policy.
|
|
2165
|
+
* @param options - Root presentation, subtree bounds, and exclusions.
|
|
2166
|
+
* @experimental Automatic child-call instrumentation is experimental.
|
|
2167
|
+
*/
|
|
2168
|
+
trace(traceFunctionKey: string, options?: TraceOptions): TraceMethodDecorator;
|
|
2169
|
+
/**
|
|
2170
|
+
* Wrap a function as an automatically expanded trace root.
|
|
2171
|
+
*
|
|
2172
|
+
* This is the function-oriented equivalent of {@link Bitfab.trace}. Build
|
|
2173
|
+
* instrumentation turns repository functions called beneath the wrapped
|
|
2174
|
+
* function into nested spans. Without a compatible transform, this still
|
|
2175
|
+
* records one normal rich root span and runs the function unchanged.
|
|
2176
|
+
*
|
|
2177
|
+
* @param traceFunctionKey - Groups traces and their capture policy.
|
|
2178
|
+
* @param optionsOrFn - Options or the workflow entrypoint to wrap.
|
|
2179
|
+
* @param maybeFn - Workflow entrypoint when options are provided.
|
|
2180
|
+
* @experimental Automatic child-call instrumentation is experimental.
|
|
2181
|
+
*/
|
|
2182
|
+
withTrace<This, TArgs extends unknown[], TReturn>(traceFunctionKey: string, fn: (this: This, ...args: TArgs) => TReturn): (this: This, ...args: TArgs) => TReturn;
|
|
2183
|
+
withTrace<This, TArgs extends unknown[], TReturn>(traceFunctionKey: string, options: TraceOptions, fn: (this: This, ...args: TArgs) => TReturn): (this: This, ...args: TArgs) => TReturn;
|
|
2184
|
+
private createAutoTraceRoot;
|
|
2185
|
+
private refreshAutoTraceCapturePolicy;
|
|
2132
2186
|
/**
|
|
2133
2187
|
* Flush and permanently close this client's tracing resources: its pending
|
|
2134
2188
|
* requests and the single span-transport worker shared by its decorators and
|
|
@@ -2663,7 +2717,7 @@ declare class BitfabFunction {
|
|
|
2663
2717
|
/**
|
|
2664
2718
|
* SDK version from package.json (injected at build time)
|
|
2665
2719
|
*/
|
|
2666
|
-
declare const __version__ = "0.38.
|
|
2720
|
+
declare const __version__ = "0.38.2";
|
|
2667
2721
|
|
|
2668
2722
|
/**
|
|
2669
2723
|
* Constants for the Bitfab SDK.
|
package/dist/index.d.ts
CHANGED
|
@@ -523,6 +523,7 @@ declare class HttpClient {
|
|
|
523
523
|
* Blocks until complete - needed for function execution.
|
|
524
524
|
*/
|
|
525
525
|
lookupFunction<T>(name: string): Promise<T>;
|
|
526
|
+
getAutoTracePolicy<T>(traceFunctionKey: string, protocol: string): Promise<T>;
|
|
526
527
|
getTraceSpan(traceId: string, lookup: SpanLookup): Promise<CapturedSpan | null>;
|
|
527
528
|
private get;
|
|
528
529
|
/**
|
|
@@ -2098,6 +2099,27 @@ interface SpanMethodDecoratorContext<TThis, TValue> {
|
|
|
2098
2099
|
}
|
|
2099
2100
|
/** A standard ECMAScript method decorator produced by {@link Bitfab.span}. */
|
|
2100
2101
|
type SpanMethodDecorator = <TThis, TArgs extends unknown[], TReturn>(originalMethod: (this: TThis, ...args: TArgs) => TReturn, context: SpanMethodDecoratorContext<TThis, (this: TThis, ...args: TArgs) => TReturn>) => (this: TThis, ...args: TArgs) => TReturn;
|
|
2102
|
+
/** Options for experimental automatic subtree tracing. */
|
|
2103
|
+
interface TraceOptions {
|
|
2104
|
+
/** Root span name. Defaults to the decorated or wrapped function name. */
|
|
2105
|
+
name?: string;
|
|
2106
|
+
/** Root span type. Descendants are always `function` spans. */
|
|
2107
|
+
type?: SpanType;
|
|
2108
|
+
/** Maximum number of recorded descendant levels. Defaults to 30. */
|
|
2109
|
+
maxDepth?: number;
|
|
2110
|
+
/** Maximum descendant spans recorded per root invocation. Defaults to 500. */
|
|
2111
|
+
maxSpans?: number;
|
|
2112
|
+
/** Qualified or simple function names to leave out of the subtree. */
|
|
2113
|
+
exclude?: readonly string[] | ReadonlySet<string>;
|
|
2114
|
+
/** Record rest-argument wrapper functions. Defaults to false. */
|
|
2115
|
+
includeWrappers?: boolean;
|
|
2116
|
+
}
|
|
2117
|
+
type StandardTraceMethodDecorator = <This, TArgs extends unknown[], TReturn>(method: (this: This, ...args: TArgs) => TReturn, context: {
|
|
2118
|
+
kind: "method";
|
|
2119
|
+
name: string | symbol;
|
|
2120
|
+
}) => (this: This, ...args: TArgs) => TReturn;
|
|
2121
|
+
type LegacyTraceMethodDecorator = <This, TArgs extends unknown[], TReturn>(target: object, propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<(this: This, ...args: TArgs) => TReturn>) => void;
|
|
2122
|
+
type TraceMethodDecorator = StandardTraceMethodDecorator & LegacyTraceMethodDecorator;
|
|
2101
2123
|
|
|
2102
2124
|
/**
|
|
2103
2125
|
* Client for making provider-based API calls via BAML.
|
|
@@ -2117,6 +2139,7 @@ declare class Bitfab {
|
|
|
2117
2139
|
private readonly httpClient;
|
|
2118
2140
|
private readonly bamlClient;
|
|
2119
2141
|
private readonly dbSnapshot;
|
|
2142
|
+
private readonly autoTracePolicyRefreshes;
|
|
2120
2143
|
/**
|
|
2121
2144
|
* Mock overrides registered via {@link Bitfab.registerMockOverride}, applied
|
|
2122
2145
|
* to every `replay` on this client (after any per-call `mockOverride`). In
|
|
@@ -2129,6 +2152,37 @@ declare class Bitfab {
|
|
|
2129
2152
|
* @param config - Configuration options for the client
|
|
2130
2153
|
*/
|
|
2131
2154
|
constructor(config: BitfabConfig);
|
|
2155
|
+
/**
|
|
2156
|
+
* Decorate a class method as an automatically expanded trace root.
|
|
2157
|
+
*
|
|
2158
|
+
* Build instrumentation turns repository functions called beneath this
|
|
2159
|
+
* method into nested spans. Every generated span preserves structure; only
|
|
2160
|
+
* function IDs selected by the capture policy include inputs and output.
|
|
2161
|
+
* Without a compatible build transform, this still records the decorated
|
|
2162
|
+
* method as a normal rich root span but cannot discover child calls.
|
|
2163
|
+
*
|
|
2164
|
+
* @param traceFunctionKey - Groups traces and their capture policy.
|
|
2165
|
+
* @param options - Root presentation, subtree bounds, and exclusions.
|
|
2166
|
+
* @experimental Automatic child-call instrumentation is experimental.
|
|
2167
|
+
*/
|
|
2168
|
+
trace(traceFunctionKey: string, options?: TraceOptions): TraceMethodDecorator;
|
|
2169
|
+
/**
|
|
2170
|
+
* Wrap a function as an automatically expanded trace root.
|
|
2171
|
+
*
|
|
2172
|
+
* This is the function-oriented equivalent of {@link Bitfab.trace}. Build
|
|
2173
|
+
* instrumentation turns repository functions called beneath the wrapped
|
|
2174
|
+
* function into nested spans. Without a compatible transform, this still
|
|
2175
|
+
* records one normal rich root span and runs the function unchanged.
|
|
2176
|
+
*
|
|
2177
|
+
* @param traceFunctionKey - Groups traces and their capture policy.
|
|
2178
|
+
* @param optionsOrFn - Options or the workflow entrypoint to wrap.
|
|
2179
|
+
* @param maybeFn - Workflow entrypoint when options are provided.
|
|
2180
|
+
* @experimental Automatic child-call instrumentation is experimental.
|
|
2181
|
+
*/
|
|
2182
|
+
withTrace<This, TArgs extends unknown[], TReturn>(traceFunctionKey: string, fn: (this: This, ...args: TArgs) => TReturn): (this: This, ...args: TArgs) => TReturn;
|
|
2183
|
+
withTrace<This, TArgs extends unknown[], TReturn>(traceFunctionKey: string, options: TraceOptions, fn: (this: This, ...args: TArgs) => TReturn): (this: This, ...args: TArgs) => TReturn;
|
|
2184
|
+
private createAutoTraceRoot;
|
|
2185
|
+
private refreshAutoTraceCapturePolicy;
|
|
2132
2186
|
/**
|
|
2133
2187
|
* Flush and permanently close this client's tracing resources: its pending
|
|
2134
2188
|
* requests and the single span-transport worker shared by its decorators and
|
|
@@ -2663,7 +2717,7 @@ declare class BitfabFunction {
|
|
|
2663
2717
|
/**
|
|
2664
2718
|
* SDK version from package.json (injected at build time)
|
|
2665
2719
|
*/
|
|
2666
|
-
declare const __version__ = "0.38.
|
|
2720
|
+
declare const __version__ = "0.38.2";
|
|
2667
2721
|
|
|
2668
2722
|
/**
|
|
2669
2723
|
* Constants for the Bitfab SDK.
|
package/dist/index.js
CHANGED
|
@@ -20,7 +20,8 @@ import {
|
|
|
20
20
|
getCurrentReplayBranch,
|
|
21
21
|
getCurrentSpan,
|
|
22
22
|
getCurrentTrace
|
|
23
|
-
} from "./chunk-
|
|
23
|
+
} from "./chunk-JSU2Z2Z7.js";
|
|
24
|
+
import "./chunk-GFBQ2AMO.js";
|
|
24
25
|
import {
|
|
25
26
|
BITFAB_PROGRESS_PREFIX,
|
|
26
27
|
BitfabError,
|
|
@@ -32,7 +33,8 @@ import {
|
|
|
32
33
|
flushTraces,
|
|
33
34
|
reportReplayProgress,
|
|
34
35
|
serializeReplayResult
|
|
35
|
-
} from "./chunk-
|
|
36
|
+
} from "./chunk-QWV7JDLQ.js";
|
|
37
|
+
import "./chunk-H6LZRFMN.js";
|
|
36
38
|
export {
|
|
37
39
|
BITFAB_PROGRESS_PREFIX,
|
|
38
40
|
Bitfab,
|
package/dist/node.cjs
CHANGED
|
@@ -97,7 +97,7 @@ var __version__, __packageName__;
|
|
|
97
97
|
var init_version_generated = __esm({
|
|
98
98
|
"src/version.generated.ts"() {
|
|
99
99
|
"use strict";
|
|
100
|
-
__version__ = "0.38.
|
|
100
|
+
__version__ = "0.38.2";
|
|
101
101
|
__packageName__ = "bitfab";
|
|
102
102
|
}
|
|
103
103
|
});
|
|
@@ -828,7 +828,7 @@ var init_otel = __esm({
|
|
|
828
828
|
EXPORT_CONCURRENCY_ENV = "BITFAB_OTEL_EXPORT_CONCURRENCY";
|
|
829
829
|
MAX_QUEUE_SIZE = 8192;
|
|
830
830
|
DIRECT_MAX_EXPORT_BATCH_SIZE = 512;
|
|
831
|
-
DIRECT_MAX_REQUEST_BATCH_SIZE =
|
|
831
|
+
DIRECT_MAX_REQUEST_BATCH_SIZE = 128;
|
|
832
832
|
DEFAULT_EXPORT_CONCURRENCY = 32;
|
|
833
833
|
MAX_EXPORT_CONCURRENCY = 64;
|
|
834
834
|
SCHEDULE_DELAY_MILLIS = 5e3;
|
|
@@ -1720,6 +1720,12 @@ var init_http = __esm({
|
|
|
1720
1720
|
async lookupFunction(name) {
|
|
1721
1721
|
return this.request("/api/sdk/functions/lookup", { name });
|
|
1722
1722
|
}
|
|
1723
|
+
async getAutoTracePolicy(traceFunctionKey, protocol) {
|
|
1724
|
+
return this.request("/api/sdk/auto-trace/policy", {
|
|
1725
|
+
traceFunctionKey,
|
|
1726
|
+
protocol
|
|
1727
|
+
});
|
|
1728
|
+
}
|
|
1723
1729
|
async getTraceSpan(traceId, lookup) {
|
|
1724
1730
|
const searchParams = new URLSearchParams();
|
|
1725
1731
|
if (lookup.id !== void 0) {
|
|
@@ -3772,6 +3778,80 @@ var BitfabClaudeAgentHandler = class {
|
|
|
3772
3778
|
// src/client.ts
|
|
3773
3779
|
init_asyncStorage();
|
|
3774
3780
|
|
|
3781
|
+
// src/autoTrace.ts
|
|
3782
|
+
init_asyncStorage();
|
|
3783
|
+
var autoTraceGlobal = globalThis;
|
|
3784
|
+
var autoTraceState = autoTraceGlobal.__bitfabAutoTraceStateV3 ?? {
|
|
3785
|
+
storage: null,
|
|
3786
|
+
browserScope: void 0,
|
|
3787
|
+
capturePolicies: /* @__PURE__ */ new WeakMap(),
|
|
3788
|
+
activeRoots: 0
|
|
3789
|
+
};
|
|
3790
|
+
autoTraceGlobal.__bitfabAutoTraceStateV3 = autoTraceState;
|
|
3791
|
+
function initializeAutoTraceStorage() {
|
|
3792
|
+
autoTraceState.storage ?? (autoTraceState.storage = createAsyncLocalStorage());
|
|
3793
|
+
}
|
|
3794
|
+
function runWithAutoTraceContext(context, fn, depth = 0) {
|
|
3795
|
+
initializeAutoTraceStorage();
|
|
3796
|
+
const scope = { context, depth };
|
|
3797
|
+
if (autoTraceState.storage) {
|
|
3798
|
+
return autoTraceState.storage.run(scope, fn);
|
|
3799
|
+
}
|
|
3800
|
+
const previous = autoTraceState.browserScope;
|
|
3801
|
+
autoTraceState.browserScope = scope;
|
|
3802
|
+
try {
|
|
3803
|
+
return fn();
|
|
3804
|
+
} finally {
|
|
3805
|
+
autoTraceState.browserScope = previous;
|
|
3806
|
+
}
|
|
3807
|
+
}
|
|
3808
|
+
function runWithAutoTraceRootContext(context, fn) {
|
|
3809
|
+
autoTraceState.activeRoots += 1;
|
|
3810
|
+
let result;
|
|
3811
|
+
try {
|
|
3812
|
+
result = runWithAutoTraceContext(context, fn);
|
|
3813
|
+
} catch (error) {
|
|
3814
|
+
autoTraceState.activeRoots -= 1;
|
|
3815
|
+
throw error;
|
|
3816
|
+
}
|
|
3817
|
+
if (isAutoTraceAsyncGenerator(result)) {
|
|
3818
|
+
autoTraceState.activeRoots -= 1;
|
|
3819
|
+
return wrapAutoTraceAsyncGenerator(context, result);
|
|
3820
|
+
}
|
|
3821
|
+
if (result instanceof Promise) {
|
|
3822
|
+
return result.finally(() => {
|
|
3823
|
+
autoTraceState.activeRoots -= 1;
|
|
3824
|
+
});
|
|
3825
|
+
}
|
|
3826
|
+
autoTraceState.activeRoots -= 1;
|
|
3827
|
+
return result;
|
|
3828
|
+
}
|
|
3829
|
+
function isAutoTraceAsyncGenerator(value) {
|
|
3830
|
+
if (value === null || typeof value !== "object") {
|
|
3831
|
+
return false;
|
|
3832
|
+
}
|
|
3833
|
+
const candidate = value;
|
|
3834
|
+
return typeof candidate.next === "function" && typeof candidate.return === "function" && typeof candidate.throw === "function" && typeof candidate[Symbol.asyncIterator] === "function";
|
|
3835
|
+
}
|
|
3836
|
+
function wrapAutoTraceAsyncGenerator(context, source) {
|
|
3837
|
+
const step = (method, value) => runWithAutoTraceRootContext(context, () => source[method](value));
|
|
3838
|
+
const wrapped = {
|
|
3839
|
+
next: (value) => step("next", value),
|
|
3840
|
+
return: (value) => step("return", value),
|
|
3841
|
+
throw: (error) => step("throw", error),
|
|
3842
|
+
[Symbol.asyncIterator]: () => wrapped
|
|
3843
|
+
};
|
|
3844
|
+
return wrapped;
|
|
3845
|
+
}
|
|
3846
|
+
function __setBitfabAutoTraceCapturePolicy(client, traceFunctionKey, functionIds) {
|
|
3847
|
+
const policies = autoTraceState.capturePolicies.get(client) ?? /* @__PURE__ */ new Map();
|
|
3848
|
+
policies.set(traceFunctionKey, new Set(functionIds));
|
|
3849
|
+
autoTraceState.capturePolicies.set(client, policies);
|
|
3850
|
+
}
|
|
3851
|
+
function getAutoTraceCapturePolicy(client, traceFunctionKey) {
|
|
3852
|
+
return autoTraceState.capturePolicies.get(client)?.get(traceFunctionKey) ?? /* @__PURE__ */ new Set();
|
|
3853
|
+
}
|
|
3854
|
+
|
|
3775
3855
|
// src/optionalPeer.ts
|
|
3776
3856
|
function importOptionalPeer(specifierParts) {
|
|
3777
3857
|
const specifier = specifierParts.join("/");
|
|
@@ -5513,6 +5593,14 @@ function readEnv2(name) {
|
|
|
5513
5593
|
}
|
|
5514
5594
|
return void 0;
|
|
5515
5595
|
}
|
|
5596
|
+
var DEFAULT_AUTO_TRACE_MAX_DEPTH = 30;
|
|
5597
|
+
var DEFAULT_AUTO_TRACE_MAX_SPANS = 500;
|
|
5598
|
+
var AUTO_TRACE_PROTOCOL = "ts-auto-v1";
|
|
5599
|
+
var AUTO_TRACE_POLICY_REFRESH_MS = 6e4;
|
|
5600
|
+
var AUTO_TRACE_POLICY_RETRY_MS = 1e4;
|
|
5601
|
+
function autoTraceLimit(value, fallback) {
|
|
5602
|
+
return value !== void 0 && Number.isFinite(value) && value >= 0 ? Math.floor(value) : fallback;
|
|
5603
|
+
}
|
|
5516
5604
|
var Bitfab = class {
|
|
5517
5605
|
/**
|
|
5518
5606
|
* Initialize the Bitfab client.
|
|
@@ -5522,6 +5610,7 @@ var Bitfab = class {
|
|
|
5522
5610
|
constructor(config) {
|
|
5523
5611
|
/** Gate the empty-key warning to fire at most once. */
|
|
5524
5612
|
this.apiKeyWarned = false;
|
|
5613
|
+
this.autoTracePolicyRefreshes = /* @__PURE__ */ new Map();
|
|
5525
5614
|
/**
|
|
5526
5615
|
* Mock overrides registered via {@link Bitfab.registerMockOverride}, applied
|
|
5527
5616
|
* to every `replay` on this client (after any per-call `mockOverride`). In
|
|
@@ -5545,6 +5634,178 @@ var Bitfab = class {
|
|
|
5545
5634
|
timeout: this.timeout
|
|
5546
5635
|
});
|
|
5547
5636
|
}
|
|
5637
|
+
/**
|
|
5638
|
+
* Decorate a class method as an automatically expanded trace root.
|
|
5639
|
+
*
|
|
5640
|
+
* Build instrumentation turns repository functions called beneath this
|
|
5641
|
+
* method into nested spans. Every generated span preserves structure; only
|
|
5642
|
+
* function IDs selected by the capture policy include inputs and output.
|
|
5643
|
+
* Without a compatible build transform, this still records the decorated
|
|
5644
|
+
* method as a normal rich root span but cannot discover child calls.
|
|
5645
|
+
*
|
|
5646
|
+
* @param traceFunctionKey - Groups traces and their capture policy.
|
|
5647
|
+
* @param options - Root presentation, subtree bounds, and exclusions.
|
|
5648
|
+
* @experimental Automatic child-call instrumentation is experimental.
|
|
5649
|
+
*/
|
|
5650
|
+
trace(traceFunctionKey, options = {}) {
|
|
5651
|
+
const decorator = (...args) => {
|
|
5652
|
+
if (args.length === 3) {
|
|
5653
|
+
const propertyKey = args[1];
|
|
5654
|
+
const descriptor = args[2];
|
|
5655
|
+
if (!descriptor || typeof descriptor.value !== "function") {
|
|
5656
|
+
throw new BitfabError("@bitfab.trace can only decorate methods");
|
|
5657
|
+
}
|
|
5658
|
+
if (!this.explicitlyEnabled) {
|
|
5659
|
+
return;
|
|
5660
|
+
}
|
|
5661
|
+
descriptor.value = this.createAutoTraceRoot(
|
|
5662
|
+
traceFunctionKey,
|
|
5663
|
+
String(propertyKey),
|
|
5664
|
+
options,
|
|
5665
|
+
descriptor.value
|
|
5666
|
+
);
|
|
5667
|
+
return;
|
|
5668
|
+
}
|
|
5669
|
+
const method = args[0];
|
|
5670
|
+
const context = args[1];
|
|
5671
|
+
if (typeof method !== "function" || context?.kind !== "method" || context.name === void 0) {
|
|
5672
|
+
throw new BitfabError("@bitfab.trace can only decorate methods");
|
|
5673
|
+
}
|
|
5674
|
+
if (!this.explicitlyEnabled) {
|
|
5675
|
+
return method;
|
|
5676
|
+
}
|
|
5677
|
+
return this.createAutoTraceRoot(
|
|
5678
|
+
traceFunctionKey,
|
|
5679
|
+
String(context.name),
|
|
5680
|
+
options,
|
|
5681
|
+
method
|
|
5682
|
+
);
|
|
5683
|
+
};
|
|
5684
|
+
return decorator;
|
|
5685
|
+
}
|
|
5686
|
+
withTrace(traceFunctionKey, optionsOrFn, maybeFn) {
|
|
5687
|
+
const options = typeof optionsOrFn === "function" ? {} : optionsOrFn;
|
|
5688
|
+
const fn = typeof optionsOrFn === "function" ? optionsOrFn : maybeFn;
|
|
5689
|
+
if (!fn) {
|
|
5690
|
+
throw new BitfabError("bitfab.withTrace requires a function");
|
|
5691
|
+
}
|
|
5692
|
+
if (!this.explicitlyEnabled) {
|
|
5693
|
+
return fn;
|
|
5694
|
+
}
|
|
5695
|
+
const name = fn.name !== "" ? fn.name : traceFunctionKey;
|
|
5696
|
+
return this.createAutoTraceRoot(traceFunctionKey, name, options, fn);
|
|
5697
|
+
}
|
|
5698
|
+
createAutoTraceRoot(traceFunctionKey, name, options, fn) {
|
|
5699
|
+
const self = this;
|
|
5700
|
+
const maxDepth = autoTraceLimit(
|
|
5701
|
+
options.maxDepth,
|
|
5702
|
+
DEFAULT_AUTO_TRACE_MAX_DEPTH
|
|
5703
|
+
);
|
|
5704
|
+
const maxSpans = autoTraceLimit(
|
|
5705
|
+
options.maxSpans,
|
|
5706
|
+
DEFAULT_AUTO_TRACE_MAX_SPANS
|
|
5707
|
+
);
|
|
5708
|
+
const excluded = new Set(options.exclude ?? []);
|
|
5709
|
+
const includeWrappers = options.includeWrappers ?? false;
|
|
5710
|
+
const tracedRoot = this.withSpan(
|
|
5711
|
+
traceFunctionKey,
|
|
5712
|
+
{ name: options.name ?? name, type: options.type ?? "custom" },
|
|
5713
|
+
function(...args) {
|
|
5714
|
+
const capturePolicy = getAutoTraceCapturePolicy(self, traceFunctionKey);
|
|
5715
|
+
self.refreshAutoTraceCapturePolicy(traceFunctionKey);
|
|
5716
|
+
let spansUsed = 0;
|
|
5717
|
+
let truncated = false;
|
|
5718
|
+
const warnTruncated = () => {
|
|
5719
|
+
if (!truncated) {
|
|
5720
|
+
truncated = true;
|
|
5721
|
+
getCurrentTrace().setMetadata({
|
|
5722
|
+
bitfabAutoTrace: {
|
|
5723
|
+
protocol: AUTO_TRACE_PROTOCOL,
|
|
5724
|
+
truncated: true,
|
|
5725
|
+
maxDepth,
|
|
5726
|
+
maxSpans
|
|
5727
|
+
}
|
|
5728
|
+
});
|
|
5729
|
+
}
|
|
5730
|
+
warnOnce(
|
|
5731
|
+
`auto-trace-truncated:${traceFunctionKey}`,
|
|
5732
|
+
`"${traceFunctionKey}" hit an automatic subtree capture limit (maxDepth=${maxDepth}, maxSpans=${maxSpans}); its trace is incomplete. Raise the limits or narrow the subtree with exclude.`
|
|
5733
|
+
);
|
|
5734
|
+
};
|
|
5735
|
+
const autoTraceContext = {
|
|
5736
|
+
invoke(definition, inputs, invokeFn, depth) {
|
|
5737
|
+
const nameParts = definition.name.split(".");
|
|
5738
|
+
const simpleName = nameParts[nameParts.length - 1];
|
|
5739
|
+
if (excluded.has(definition.name) || simpleName !== void 0 && excluded.has(simpleName) || definition.wrapper === true && !includeWrappers) {
|
|
5740
|
+
return invokeFn();
|
|
5741
|
+
}
|
|
5742
|
+
if (depth >= maxDepth || spansUsed >= maxSpans) {
|
|
5743
|
+
warnTruncated();
|
|
5744
|
+
return invokeFn();
|
|
5745
|
+
}
|
|
5746
|
+
spansUsed += 1;
|
|
5747
|
+
const childOptions = {
|
|
5748
|
+
name: definition.name,
|
|
5749
|
+
type: "function",
|
|
5750
|
+
captureWhen: "nested",
|
|
5751
|
+
functionId: definition.id,
|
|
5752
|
+
captureContent: capturePolicy.has(definition.id),
|
|
5753
|
+
autoTraceDefinition: definition
|
|
5754
|
+
};
|
|
5755
|
+
const tracedChild = self.withSpan(
|
|
5756
|
+
traceFunctionKey,
|
|
5757
|
+
childOptions,
|
|
5758
|
+
(..._inputs) => runWithAutoTraceContext(autoTraceContext, invokeFn, depth + 1)
|
|
5759
|
+
);
|
|
5760
|
+
return tracedChild(...inputs);
|
|
5761
|
+
}
|
|
5762
|
+
};
|
|
5763
|
+
return runWithAutoTraceRootContext(
|
|
5764
|
+
autoTraceContext,
|
|
5765
|
+
() => fn.apply(this, args)
|
|
5766
|
+
);
|
|
5767
|
+
}
|
|
5768
|
+
);
|
|
5769
|
+
const autoTraceRoot = function(...args) {
|
|
5770
|
+
if (!self.isTracingEnabled()) {
|
|
5771
|
+
return fn.apply(this, args);
|
|
5772
|
+
}
|
|
5773
|
+
return tracedRoot.apply(this, args);
|
|
5774
|
+
};
|
|
5775
|
+
Object.defineProperty(autoTraceRoot, "_bitfabTraceFunctionKey", {
|
|
5776
|
+
value: traceFunctionKey
|
|
5777
|
+
});
|
|
5778
|
+
return autoTraceRoot;
|
|
5779
|
+
}
|
|
5780
|
+
refreshAutoTraceCapturePolicy(traceFunctionKey) {
|
|
5781
|
+
const now = Date.now();
|
|
5782
|
+
const state = this.autoTracePolicyRefreshes.get(traceFunctionKey) ?? {
|
|
5783
|
+
refreshAfter: 0
|
|
5784
|
+
};
|
|
5785
|
+
if (state.inFlight || now < state.refreshAfter) {
|
|
5786
|
+
return;
|
|
5787
|
+
}
|
|
5788
|
+
const request = this.httpClient.getAutoTracePolicy(
|
|
5789
|
+
traceFunctionKey,
|
|
5790
|
+
AUTO_TRACE_PROTOCOL
|
|
5791
|
+
).then((policy) => {
|
|
5792
|
+
if (policy.protocol !== AUTO_TRACE_PROTOCOL) {
|
|
5793
|
+
state.refreshAfter = Date.now() + AUTO_TRACE_POLICY_RETRY_MS;
|
|
5794
|
+
return;
|
|
5795
|
+
}
|
|
5796
|
+
const functionIds = Array.isArray(policy.functionIds) ? policy.functionIds.filter(
|
|
5797
|
+
(id) => typeof id === "string" && id.startsWith(`${AUTO_TRACE_PROTOCOL}:`)
|
|
5798
|
+
).slice(0, DEFAULT_AUTO_TRACE_MAX_SPANS) : [];
|
|
5799
|
+
__setBitfabAutoTraceCapturePolicy(this, traceFunctionKey, functionIds);
|
|
5800
|
+
state.refreshAfter = Date.now() + AUTO_TRACE_POLICY_REFRESH_MS;
|
|
5801
|
+
}).catch(() => {
|
|
5802
|
+
state.refreshAfter = Date.now() + AUTO_TRACE_POLICY_RETRY_MS;
|
|
5803
|
+
}).finally(() => {
|
|
5804
|
+
state.inFlight = void 0;
|
|
5805
|
+
});
|
|
5806
|
+
state.inFlight = request;
|
|
5807
|
+
this.autoTracePolicyRefreshes.set(traceFunctionKey, state);
|
|
5808
|
+
}
|
|
5548
5809
|
/**
|
|
5549
5810
|
* Flush and permanently close this client's tracing resources: its pending
|
|
5550
5811
|
* requests and the single span-transport worker shared by its decorators and
|
|
@@ -6091,7 +6352,10 @@ var Bitfab = class {
|
|
|
6091
6352
|
parentSpanId,
|
|
6092
6353
|
inputs,
|
|
6093
6354
|
startedAt,
|
|
6094
|
-
spanType: options.type ?? "custom"
|
|
6355
|
+
spanType: options.type ?? "custom",
|
|
6356
|
+
functionId: options.functionId,
|
|
6357
|
+
captureContent: options.captureContent ?? true,
|
|
6358
|
+
autoTraceDefinition: options.autoTraceDefinition
|
|
6095
6359
|
};
|
|
6096
6360
|
const sendSpan = async (params) => {
|
|
6097
6361
|
const replayCtx = getReplayContext();
|
|
@@ -6256,7 +6520,16 @@ var Bitfab = class {
|
|
|
6256
6520
|
}
|
|
6257
6521
|
};
|
|
6258
6522
|
executeWithContext = () => {
|
|
6259
|
-
|
|
6523
|
+
let result;
|
|
6524
|
+
try {
|
|
6525
|
+
result = fn.apply(this, args);
|
|
6526
|
+
} catch (error) {
|
|
6527
|
+
void sendSpan({
|
|
6528
|
+
result: void 0,
|
|
6529
|
+
error: error instanceof Error ? error.message : String(error)
|
|
6530
|
+
});
|
|
6531
|
+
throw error;
|
|
6532
|
+
}
|
|
6260
6533
|
if (result instanceof Promise) {
|
|
6261
6534
|
return result.then((resolvedResult) => {
|
|
6262
6535
|
recordSpan(resolvedResult);
|
|
@@ -6497,8 +6770,8 @@ var Bitfab = class {
|
|
|
6497
6770
|
* Queued on the client's span transport; delivery is the transport's job.
|
|
6498
6771
|
*/
|
|
6499
6772
|
sendWrapperSpan(params) {
|
|
6500
|
-
const serializedInputs = serializeValue(params.inputs);
|
|
6501
|
-
const serializedResult = serializeValue(params.result);
|
|
6773
|
+
const serializedInputs = params.captureContent ? serializeValue(params.inputs) : void 0;
|
|
6774
|
+
const serializedResult = params.captureContent ? serializeValue(params.result) : void 0;
|
|
6502
6775
|
const externalSpan = {
|
|
6503
6776
|
id: params.spanId,
|
|
6504
6777
|
trace_id: params.traceId,
|
|
@@ -6507,26 +6780,38 @@ var Bitfab = class {
|
|
|
6507
6780
|
span_data: {
|
|
6508
6781
|
name: params.spanName,
|
|
6509
6782
|
type: params.spanType,
|
|
6510
|
-
|
|
6511
|
-
|
|
6512
|
-
|
|
6513
|
-
|
|
6514
|
-
|
|
6783
|
+
...params.functionId !== void 0 && {
|
|
6784
|
+
function_id: params.functionId,
|
|
6785
|
+
content_captured: params.captureContent
|
|
6786
|
+
},
|
|
6787
|
+
...params.autoTraceDefinition !== void 0 && {
|
|
6788
|
+
function_file: params.autoTraceDefinition.file,
|
|
6789
|
+
function_line: params.autoTraceDefinition.line,
|
|
6790
|
+
function_column: params.autoTraceDefinition.column
|
|
6515
6791
|
},
|
|
6516
|
-
...
|
|
6517
|
-
|
|
6792
|
+
...serializedInputs !== void 0 && {
|
|
6793
|
+
input: serializedInputs.json,
|
|
6794
|
+
...serializedInputs.meta !== void 0 && {
|
|
6795
|
+
input_meta: serializedInputs.meta
|
|
6796
|
+
}
|
|
6797
|
+
},
|
|
6798
|
+
...serializedResult !== void 0 && {
|
|
6799
|
+
output: serializedResult.json,
|
|
6800
|
+
...serializedResult.meta !== void 0 && {
|
|
6801
|
+
output_meta: serializedResult.meta
|
|
6802
|
+
}
|
|
6518
6803
|
},
|
|
6519
6804
|
...params.functionName !== void 0 && {
|
|
6520
6805
|
function_name: params.functionName
|
|
6521
6806
|
},
|
|
6522
|
-
...params.error !== void 0 && {
|
|
6807
|
+
...params.captureContent && params.error !== void 0 && {
|
|
6523
6808
|
error: params.error,
|
|
6524
6809
|
error_source: "code"
|
|
6525
6810
|
},
|
|
6526
|
-
...params.contexts && params.contexts.length > 0 && {
|
|
6811
|
+
...params.captureContent && params.contexts && params.contexts.length > 0 && {
|
|
6527
6812
|
contexts: params.contexts
|
|
6528
6813
|
},
|
|
6529
|
-
...params.prompt !== void 0 && { prompt: params.prompt }
|
|
6814
|
+
...params.captureContent && params.prompt !== void 0 && { prompt: params.prompt }
|
|
6530
6815
|
}
|
|
6531
6816
|
};
|
|
6532
6817
|
if (params.parentSpanId) {
|