@dbx-tools/appkit 0.9.129 → 0.9.131

package/lib/src/telemetry.js

@@ -0,0 +1,126 @@
+/** AppKit telemetry compatibility helpers. */
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { createRequire } from "node:module";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+/** Return the request pathname without its query string. */
+function requestPath(request) {
+    return request.url?.split("?", 1)[0] ?? "";
+}
+/** Whether one request matches the default or configured HTTP telemetry exclusions. */
+export function excludeHttpTelemetryRequest(request, options = {}) {
+    if (request.method === "HEAD")
+        return true;
+    const pathname = requestPath(request);
+    for (const pattern of options.exclude ?? []) {
+        if (pattern.endsWith("*")) {
+            if (pathname.startsWith(pattern.slice(0, -1)))
+                return true;
+        }
+        else if (pathname === pattern) {
+            return true;
+        }
+    }
+    return options.filter?.(request) ?? false;
+}
+function appKitInternalModuleUrl(relativePath) {
+    const require = createRequire(import.meta.url);
+    const packageRoot = path.dirname(require.resolve("@databricks/appkit/package.json"));
+    return pathToFileURL(path.join(packageRoot, "dist", ...relativePath.split("/"))).href;
+}
+function isNativeHttpInstrumentation(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const candidate = value;
+    return typeof candidate.getConfig === "function" && typeof candidate.setConfig === "function";
+}
+async function nativeInstrumentations() {
+    const loaded = (await import(__rewriteRelativeImportExtension(appKitInternalModuleUrl("telemetry/instrumentations.js"))));
+    if (!loaded.instrumentations) {
+        throw new Error("@databricks/appkit no longer exposes its native instrumentations");
+    }
+    return loaded.instrumentations;
+}
+async function nativeHttpInstrumentation() {
+    const instrumentation = (await nativeInstrumentations()).http;
+    if (!isNativeHttpInstrumentation(instrumentation)) {
+        throw new Error("@databricks/appkit no longer exposes the expected native HTTP telemetry instrumentation");
+    }
+    return instrumentation;
+}
+async function nativeTelemetryManagerClass() {
+    const loaded = (await import(__rewriteRelativeImportExtension(appKitInternalModuleUrl("telemetry/telemetry-manager.js"))));
+    if (!loaded.TelemetryManager) {
+        throw new Error("@databricks/appkit no longer exposes its native telemetry manager");
+    }
+    return loaded.TelemetryManager;
+}
+async function nativeTelemetryManager() {
+    return (await nativeTelemetryManagerClass()).getInstance();
+}
+function requireNativeTracerProvider(manager) {
+    if (!manager.tracerProvider) {
+        throw new Error("AppKit's native tracer provider has not started");
+    }
+    return manager.tracerProvider;
+}
+/**
+ * Extend AppKit's native HTTP request filter without registering a second HTTP
+ * instrumentation. AppKit 0.81 owns the instrumentation but does not expose a
+ * public filter option, so this compatibility hook mutates its existing
+ * singleton before `createApp()` registers it.
+ */
+export async function configureNativeHttpTelemetry(options = {}) {
+    const instrumentation = await nativeHttpInstrumentation();
+    const config = instrumentation.getConfig();
+    const appKitFilter = config.ignoreIncomingRequestHook;
+    instrumentation.setConfig({
+        ...config,
+        ignoreIncomingRequestHook: (request) => Boolean(appKitFilter?.(request)) || excludeHttpTelemetryRequest(request, options),
+    });
+}
+/**
+ * Bind AppKit's native instrumentations to the provider AppKit started. This is
+ * called after AppKit's deferred `TelemetryManager.start()` phase so a runtime
+ * that already occupied the global OTel slot cannot leave native spans no-op.
+ */
+export async function bindNativeTelemetryProvider() {
+    const manager = await nativeTelemetryManager();
+    if (!manager.tracerProvider)
+        return false;
+    for (const instrumentation of Object.values(await nativeInstrumentations())) {
+        instrumentation.setTracerProvider?.(manager.tracerProvider);
+    }
+    return true;
+}
+/** Contribute a processor before AppKit builds its native tracer provider. */
+export async function registerNativeSpanProcessor(processor) {
+    (await nativeTelemetryManagerClass()).registerSpanProcessor(processor);
+}
+/**
+ * Return a tracer provider that resolves AppKit's provider when a tracer method
+ * is invoked. AppKit starts its provider after plugin setup, while consumers
+ * such as Mastra construct their OTel bridge during setup.
+ */
+export async function deferredNativeTracerProvider() {
+    const manager = await nativeTelemetryManager();
+    return {
+        getTracer(name, version, options) {
+            return new Proxy({}, {
+                get(_target, property) {
+                    const tracer = requireNativeTracerProvider(manager).getTracer(name, version, options);
+                    const value = Reflect.get(tracer, property, tracer);
+                    return typeof value === "function" ? value.bind(tracer) : value;
+                },
+            });
+        },
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGVsZW1ldHJ5LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3RlbGVtZXRyeS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSw4Q0FBOEM7Ozs7Ozs7OztBQUc5QyxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sYUFBYSxDQUFDO0FBQzVDLE9BQU8sSUFBSSxNQUFNLFdBQVcsQ0FBQztBQUM3QixPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sVUFBVSxDQUFDO0FBMEN6Qyw0REFBNEQ7QUFDNUQsU0FBUyxXQUFXLENBQUMsT0FBd0I7SUFDM0MsT0FBTyxPQUFPLENBQUMsR0FBRyxFQUFFLEtBQUssQ0FBQyxHQUFHLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLElBQUksRUFBRSxDQUFDO0FBQzdDLENBQUM7QUFFRCx1RkFBdUY7QUFDdkYsTUFBTSxVQUFVLDJCQUEyQixDQUN6QyxPQUF3QixFQUN4QixVQUFzQyxFQUFFO0lBRXhDLElBQUksT0FBTyxDQUFDLE1BQU0sS0FBSyxNQUFNO1FBQUUsT0FBTyxJQUFJLENBQUM7SUFDM0MsTUFBTSxRQUFRLEdBQUcsV0FBVyxDQUFDLE9BQU8sQ0FBQyxDQUFDO0lBQ3RDLEtBQUssTUFBTSxPQUFPLElBQUksT0FBTyxDQUFDLE9BQU8sSUFBSSxFQUFFLEVBQUUsQ0FBQztRQUM1QyxJQUFJLE9BQU8sQ0FBQyxRQUFRLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQztZQUMxQixJQUFJLFFBQVEsQ0FBQyxVQUFVLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQztnQkFBRSxPQUFPLElBQUksQ0FBQztRQUM3RCxDQUFDO2FBQU0sSUFBSSxRQUFRLEtBQUssT0FBTyxFQUFFLENBQUM7WUFDaEMsT0FBTyxJQUFJLENBQUM7UUFDZCxDQUFDO0lBQ0gsQ0FBQztJQUNELE9BQU8sT0FBTyxDQUFDLE1BQU0sRUFBRSxDQUFDLE9BQU8sQ0FBQyxJ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LEVBQUUsTUFBTSxDQUFZLENBQUM7b0JBQy9ELE9BQU8sT0FBTyxLQUFLLEtBQUssVUFBVSxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUM7Z0JBQ2xFLENBQUM7YUFDRixDQUFDLENBQUM7UUFDTCxDQUFDO0tBQ0YsQ0FBQztBQUNKLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKiogQXBwS2l0IHRlbGVtZXRyeSBjb21wYXRpYmlsaXR5IGhlbHBlcnMuICovXG5cbmltcG9ydCB0eXBlIHsgSW5jb21pbmdNZXNzYWdlIH0gZnJvbSBcIm5vZGU6aHR0cFwiO1xuaW1wb3J0IHsgY3JlYXRlUmVxdWlyZSB9IGZyb20gXCJub2RlOm1vZHVsZVwiO1xuaW1wb3J0IHBhdGggZnJvbSBcIm5vZGU6cGF0aFwiO1xuaW1wb3J0IHsgcGF0aFRvRmlsZVVSTCB9IGZyb20gXCJub2RlOnVybFwiO1xuXG5pbXBvcnQgdHlwZSB7IFRyYWNlciwgVHJhY2VyT3B0aW9ucywgVHJhY2VyUHJvdmlkZXIgfSBmcm9tIFwiQG9wZW50ZWxlbWV0cnkvYXBpXCI7XG5pbXBvcnQgdHlwZSB7IFNwYW5Qcm9jZXNzb3IgfSBmcm9tIFwiQG9wZW50ZWxlbWV0cnkvc2RrLXRyYWNlLWJhc2VcIjtcblxudHlwZSBJbmNvbWluZ1JlcXVlc3RGaWx0ZXIgPSAocmVxdWVzdDogSW5jb21pbmdNZXNzYWdlKSA9PiBib29sZWFuO1xuXG5pbnRlcmZhY2UgTmF0aXZlSHR0cEluc3RydW1lbnRhdGlvbkNvbmZpZyB7XG4gIHJlYWRvbmx5IGVuYWJsZWQ/OiBib29sZWFuO1xuICByZWFkb25seSBpZ25vcmVJbmNvbWluZ1JlcXVlc3RIb29rPzogSW5jb21pbmdSZXF1ZXN0RmlsdGVyO1xuICByZWFkb25seSBba2V5OiBzdHJpbmddOiB1bmtub3duO1xufVxuXG5pbnRlcmZhY2UgTmF0aXZlSW5zdHJ1bWVudGF0aW9uIHtcbiAgc2V0VHJhY2VyUHJvdmlkZXI/KHByb3ZpZGVyOiBUcmFjZXJQcm92aWRlcik6IHZvaWQ7XG59XG5cbmludGVyZmFjZSBOYXRpdmVIdHRwSW5zdHJ1bWVudGF0aW9uIGV4dGVuZHMgTmF0aXZlSW5zdHJ1bWVudGF0aW9uIHtcbiAgZ2V0Q29uZmlnKCk6IE5hdGl2ZUh0dHBJbnN0cnVtZW50YXRpb25Db25maWc7XG4gIHNldENvbmZpZyhjb25maWc6IE5hdGl2ZUh0dHBJbnN0cnVtZW50YXRpb25Db25maWcpOiB2b2lkO1xufVxuXG5pbnRlcmZhY2UgTmF0aXZlVGVsZW1ldHJ5TWFuYWdlciB7XG4gIHRyYWNlclByb3ZpZGVyPzogVHJhY2VyUHJvdmlkZXI7XG59XG5cbmludGVyZmFjZSBOYXRpdmVUZWxlbWV0cnlNYW5hZ2VyQ2xhc3Mge1xuICBnZXRJbnN0YW5jZSgpOiBOYXRpdmVUZWxlbWV0cnlNYW5hZ2VyO1xuICByZWdpc3RlclNwYW5Qcm9jZXNzb3IocHJvY2Vzc29yOiBTcGFuUHJvY2Vzc29yKTogdm9pZDtcbn1cblxuLyoqIE9wdGlvbnMgZm9yIEFwcEtpdCdzIG5hdGl2ZSBIVFRQIHJlcXVlc3QgdHJhY2luZy4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgTmF0aXZlSHR0cFRlbGVtZXRyeU9wdGlvbnMge1xuICAvKipcbiAgICogUmVxdWVzdCBwYXRocyB0byBleGNsdWRlLiBBIHRyYWlsaW5nIGAqYCBtYXRjaGVzIGV2ZXJ5IHBhdGggd2l0aCB0aGF0XG4gICAqIHByZWZpeDsgb3RoZXIgdmFsdWVzIGFyZSBleGFjdCBwYXRoIG1hdGNoZXMuIFF1ZXJ5IHN0cmluZ3MgYXJlIGlnbm9yZWQuXG4gICAqL1xuICByZWFkb25seSBleGNsdWRlPzogcmVhZG9ubHkgc3RyaW5nW107XG4gIC8qKiBBZGRpdGlvbmFsIGNhbGxlci1vd25lZCByZXF1ZXN0IGZpbHRlci4gUmV0dXJuaW5nIGB0cnVlYCBleGNsdWRlcyB0aGUgcmVxdWVzdC4gKi9cbiAgcmVhZG9ubHkgZmlsdGVyPzogSW5jb21pbmdSZXF1ZXN0RmlsdGVyO1xufVxuXG4vKiogUmV0dXJuIHRoZSByZXF1ZXN0IHBhdGhuYW1lIHdpdGhvdXQgaXRzIHF1ZXJ5IHN0cmluZy4gKi9cbmZ1bmN0aW9uIHJlcXVlc3RQYXRoKHJlcXVlc3Q6IEluY29taW5nTWVzc2FnZSk6IHN0cmluZyB7XG4gIHJldHVybiByZXF1ZXN0LnVybD8uc3BsaXQoXCI/XCIsIDEpWzBdID8/IFwiXCI7XG59XG5cbi8qKiBXaGV0aGVyIG9uZSByZXF1ZXN0IG1hdGNoZXMgdGhlIGRlZmF1bHQgb3IgY29uZmlndXJlZCBIVFRQIHRlbGVtZXRyeSBleGNsdXNpb25zLiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGV4Y2x1ZGVIdHRwVGVsZW1ldHJ5UmVxdWVzdChcbiAgcmVxdWVzdDogSW5jb21pbmdNZXNzYWdlLFxuICBvcHRpb25zOiBOYXRpdmVIdHRwVGVsZW1ldHJ5T3B0aW9ucyA9IHt9LFxuKTogYm9vbGVhbiB7XG4gIGlmIChyZXF1ZXN0Lm1ldGhvZCA9PT0gXCJIRUFEXCIpIHJldHVybiB0cnVlO1xuICBjb25zdCBwYXRobmFtZSA9IHJlcXVlc3RQYXRoKHJlcXVlc3QpO1xuICBmb3IgKGNvbnN0IHBhdHRlcm4gb2Ygb3B0aW9ucy5leGNsdWRlID8/IFtdKSB7XG4gICAgaWYgKHBhdHRlcm4uZW5kc1dpdGgoXCIqXCIpKSB7XG4gICAgICBpZiAocGF0aG5hbWUuc3RhcnRzV2l0aChwYXR0ZXJuLnNsaWNlKDAsIC0xKSkpIHJldHVybiB0cnVlO1xuICAgIH0gZWxzZSBpZiAocGF0aG5hbWUgPT09IHBhdHRlcm4pIHtcbiAgICAgIHJldHVybiB0cnVlO1xuICAgIH1cbiAgfVxuICByZXR1cm4gb3B0aW9ucy5maWx0ZXI/LihyZXF1ZXN0KSA/PyBmYWxzZTtcbn1cblxuZnVuY3Rpb24gYXBwS2l0SW50ZXJuYWxNb2R1bGVVcmwocmVsYXRpdmVQYXRoOiBzdHJpbmcpOiBzdHJpbmcge1xuICBjb25zdCByZXF1aXJlID0gY3JlYXRlUmVxdWlyZShpbXBvcnQubWV0YS51cmwpO1xuICBjb25zdCBwYWNrYWdlUm9vdCA9IHBhdGguZGlybmFtZShyZXF1aXJlLnJlc29sdmUoXCJAZGF0YWJyaWNrcy9hcHBraXQvcGFja2FnZS5qc29uXCIpKTtcbiAgcmV0dXJuIHBhdGhUb0ZpbGVVUkwocGF0aC5qb2luKHBhY2thZ2VSb290LCBcImRpc3RcIiwgLi4ucmVsYXRpdmVQYXRoLnNwbGl0KFwiL1wiKSkpLmhyZWY7XG59XG5cbmZ1bmN0aW9uIGlzTmF0aXZlSHR0cEluc3RydW1lbnRhdGlvbih2YWx1ZTogdW5rbm93bik6IHZhbHVlIGlzIE5hdGl2ZUh0dHBJbnN0cnVtZW50YXRpb24ge1xuICBpZiAoIXZhbHVlIHx8IHR5cGVvZiB2YWx1ZSAhPT0gXCJvYmplY3RcIikgcmV0dXJuIGZhbHNlO1xuICBjb25zdCBjYW5kaWRhdGUgPSB2YWx1ZSBhcyBQYXJ0aWFsPE5hdGl2ZUh0dHBJbnN0cnVtZW50YXRpb24+O1xuICByZXR1cm4gdHlwZW9mIGNhbmRpZGF0ZS5nZXRDb25maWcgPT09IFwiZnVuY3Rpb25cIiAmJiB0eXBlb2YgY2FuZGlkYXRlLnNldENvbmZpZyA9PT0gXCJmdW5jdGlvblwiO1xufVxuXG5hc3luYyBmdW5jdGlvbiBuYXRpdmVJbnN0cnVtZW50YXRpb25zKCk6IFByb21pc2U8UmVjb3JkPHN0cmluZywgTmF0aXZlSW5zdHJ1bWVudGF0aW9uPj4ge1xuICBjb25zdCBsb2FkZWQgPSAoYXdhaXQgaW1wb3J0KGFwcEtpdEludGVybmFsTW9kdWxlVXJsKFwidGVsZW1ldHJ5L2luc3RydW1lbnRhdGlvbnMuanNcIikpKSBhcyB7XG4gICAgaW5zdHJ1bWVudGF0aW9ucz86IFJlY29yZDxzdHJpbmcsIE5hdGl2ZUluc3RydW1lbnRhdGlvbj47XG4gIH07XG4gIGlmICghbG9hZGVkLmluc3RydW1lbnRhdGlvbnMpIHtcbiAgICB0aHJvdyBuZXcgRXJyb3IoXCJAZGF0YWJyaWNrcy9hcHBraXQgbm8gbG9uZ2VyIGV4cG9zZXMgaXRzIG5hdGl2ZSBpbnN0cnVtZW50YXRpb25zXCIpO1xuICB9XG4gIHJldHVybiBsb2FkZWQuaW5zdHJ1bWVudGF0aW9ucztcbn1cblxuYXN5bmMgZnVuY3Rpb24gbmF0aXZlSHR0cEluc3RydW1lbnRhdGlvbigpOiBQcm9taXNlPE5hdGl2ZUh0dHBJbnN0cnVtZW50YXRpb24+IHtcbiAgY29uc3QgaW5zdHJ1bWVudGF0aW9uID0gKGF3YWl0IG5hdGl2ZUluc3RydW1lbnRhdGlvbnMoKSkuaHR0cDtcbiAgaWYgKCFpc05hdGl2ZUh0dHBJbnN0cnVtZW50YXRpb24oaW5zdHJ1bWVudGF0aW9uKSkge1xuICAgIHRocm93IG5ldyBFcnJvcihcbiAgICAgIFwiQGRhdGFicmlja3MvYXBwa2l0IG5vIGxvbmdlciBleHBvc2VzIHRoZSBleHBlY3RlZCBuYXRpdmUgSFRUUCB0ZWxlbWV0cnkgaW5zdHJ1bWVudGF0aW9uXCIsXG4gICAgKTtcbiAgfVxuICByZXR1cm4gaW5zdHJ1bWVudGF0aW9uO1xufVxuXG5hc3luYyBmdW5jdGlvbiBuYXRpdmVUZWxlbWV0cnlNYW5hZ2VyQ2xhc3MoKTogUHJvbWlzZTxOYXRpdmVUZWxlbWV0cnlNYW5hZ2VyQ2xhc3M+IHtcbiAgY29uc3QgbG9hZGVkID0gKGF3YWl0IGltcG9ydChhcHBLaXRJbnRlcm5hbE1vZHVsZVVybChcInRlbGVtZXRyeS90ZWxlbWV0cnktbWFuYWdlci5qc1wiKSkpIGFzIHtcbiAgICBUZWxlbWV0cnlNYW5hZ2VyPzogTmF0aXZlVGVsZW1ldHJ5TWFuYWdlckNsYXNzO1xuICB9O1xuICBpZiAoIWxvYWRlZC5UZWxlbWV0cnlNYW5hZ2VyKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKFwiQGRhdGFicmlja3MvYXBwa2l0IG5vIGxvbmdlciBleHBvc2VzIGl0cyBuYXRpdmUgdGVsZW1ldHJ5IG1hbmFnZXJcIik7XG4gIH1cbiAgcmV0dXJuIGxvYWRlZC5UZWxlbWV0cnlNYW5hZ2VyO1xufVxuXG5hc3luYyBmdW5jdGlvbiBuYXRpdmVUZWxlbWV0cnlNYW5hZ2VyKCk6IFByb21pc2U8TmF0aXZlVGVsZW1ldHJ5TWFuYWdlcj4ge1xuICByZXR1cm4gKGF3YWl0IG5hdGl2ZVRlbGVtZXRyeU1hbmFnZXJDbGFzcygpKS5nZXRJbnN0YW5jZSgpO1xufVxuXG5mdW5jdGlvbiByZXF1aXJlTmF0aXZlVHJhY2VyUHJvdmlkZXIobWFuYWdlcjogTmF0aXZlVGVsZW1ldHJ5TWFuYWdlcik6IFRyYWNlclByb3ZpZGVyIHtcbiAgaWYgKCFtYW5hZ2VyLnRyYWNlclByb3ZpZGVyKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKFwiQXBwS2l0J3MgbmF0aXZlIHRyYWNlciBwcm92aWRlciBoYXMgbm90IHN0YXJ0ZWRcIik7XG4gIH1cbiAgcmV0dXJuIG1hbmFnZXIudHJhY2VyUHJvdmlkZXI7XG59XG5cbi8qKlxuICogRXh0ZW5kIEFwcEtpdCdzIG5hdGl2ZSBIVFRQIHJlcXVlc3QgZmlsdGVyIHdpdGhvdXQgcmVnaXN0ZXJpbmcgYSBzZWNvbmQgSFRUUFxuICogaW5zdHJ1bWVudGF0aW9uLiBBcHBLaXQgMC44MSBvd25zIHRoZSBpbnN0cnVtZW50YXRpb24gYnV0IGRvZXMgbm90IGV4cG9zZSBhXG4gKiBwdWJsaWMgZmlsdGVyIG9wdGlvbiwgc28gdGhpcyBjb21wYXRpYmlsaXR5IGhvb2sgbXV0YXRlcyBpdHMgZXhpc3RpbmdcbiAqIHNpbmdsZXRvbiBiZWZvcmUgYGNyZWF0ZUFwcCgpYCByZWdpc3RlcnMgaXQuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBjb25maWd1cmVOYXRpdmVIdHRwVGVsZW1ldHJ5KFxuICBvcHRpb25zOiBOYXRpdmVIdHRwVGVsZW1ldHJ5T3B0aW9ucyA9IHt9LFxuKTogUHJvbWlzZTx2b2lkPiB7XG4gIGNvbnN0IGluc3RydW1lbnRhdGlvbiA9IGF3YWl0IG5hdGl2ZUh0dHBJbnN0cnVtZW50YXRpb24oKTtcbiAgY29uc3QgY29uZmlnID0gaW5zdHJ1bWVudGF0aW9uLmdldENvbmZpZygpO1xuICBjb25zdCBhcHBLaXRGaWx0ZXIgPSBjb25maWcuaWdub3JlSW5jb21pbmdSZXF1ZXN0SG9vaztcbiAgaW5zdHJ1bWVudGF0aW9uLnNldENvbmZpZyh7XG4gICAgLi4uY29uZmlnLFxuICAgIGlnbm9yZUluY29taW5nUmVxdWVzdEhvb2s6IChyZXF1ZXN0KSA9PlxuICAgICAgQm9vbGVhbihhcHBLaXRGaWx0ZXI/LihyZXF1ZXN0KSkgfHwgZXhjbHVkZUh0dHBUZWxlbWV0cnlSZXF1ZXN0KHJlcXVlc3QsIG9wdGlvbnMpLFxuICB9KTtcbn1cblxuLyoqXG4gKiBCaW5kIEFwcEtpdCdzIG5hdGl2ZSBpbnN0cnVtZW50YXRpb25zIHRvIHRoZSBwcm92aWRlciBBcHBLaXQgc3RhcnRlZC4gVGhpcyBpc1xuICogY2FsbGVkIGFmdGVyIEFwcEtpdCdzIGRlZmVycmVkIGBUZWxlbWV0cnlNYW5hZ2VyLnN0YXJ0KClgIHBoYXNlIHNvIGEgcnVudGltZVxuICogdGhhdCBhbHJlYWR5IG9jY3VwaWVkIHRoZSBnbG9iYWwgT1RlbCBzbG90IGNhbm5vdCBsZWF2ZSBuYXRpdmUgc3BhbnMgbm8tb3AuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBiaW5kTmF0aXZlVGVsZW1ldHJ5UHJvdmlkZXIoKTogUHJvbWlzZTxib29sZWFuPiB7XG4gIGNvbnN0IG1hbmFnZXIgPSBhd2FpdCBuYXRpdmVUZWxlbWV0cnlNYW5hZ2VyKCk7XG4gIGlmICghbWFuYWdlci50cmFjZXJQcm92aWRlcikgcmV0dXJuIGZhbHNlO1xuICBmb3IgKGNvbnN0IGluc3RydW1lbnRhdGlvbiBvZiBPYmplY3QudmFsdWVzKGF3YWl0IG5hdGl2ZUluc3RydW1lbnRhdGlvbnMoKSkpIHtcbiAgICBpbnN0cnVtZW50YXRpb24uc2V0VHJhY2VyUHJvdmlkZXI/LihtYW5hZ2VyLnRyYWNlclByb3ZpZGVyKTtcbiAgfVxuICByZXR1cm4gdHJ1ZTtcbn1cblxuLyoqIENvbnRyaWJ1dGUgYSBwcm9jZXNzb3IgYmVmb3JlIEFwcEtpdCBidWlsZHMgaXRzIG5hdGl2ZSB0cmFjZXIgcHJvdmlkZXIuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gcmVnaXN0ZXJOYXRpdmVTcGFuUHJvY2Vzc29yKHByb2Nlc3NvcjogU3BhblByb2Nlc3Nvcik6IFByb21pc2U8dm9pZD4ge1xuICAoYXdhaXQgbmF0aXZlVGVsZW1ldHJ5TWFuYWdlckNsYXNzKCkpLnJlZ2lzdGVyU3BhblByb2Nlc3Nvcihwcm9jZXNzb3IpO1xufVxuXG4vKipcbiAqIFJldHVybiBhIHRyYWNlciBwcm92aWRlciB0aGF0IHJlc29sdmVzIEFwcEtpdCdzIHByb3ZpZGVyIHdoZW4gYSB0cmFjZXIgbWV0aG9kXG4gKiBpcyBpbnZva2VkLiBBcHBLaXQgc3RhcnRzIGl0cyBwcm92aWRlciBhZnRlciBwbHVnaW4gc2V0dXAsIHdoaWxlIGNvbnN1bWVyc1xuICogc3VjaCBhcyBNYXN0cmEgY29uc3RydWN0IHRoZWlyIE9UZWwgYnJpZGdlIGR1cmluZyBzZXR1cC5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIGRlZmVycmVkTmF0aXZlVHJhY2VyUHJvdmlkZXIoKTogUHJvbWlzZTxUcmFjZXJQcm92aWRlcj4ge1xuICBjb25zdCBtYW5hZ2VyID0gYXdhaXQgbmF0aXZlVGVsZW1ldHJ5TWFuYWdlcigpO1xuICByZXR1cm4ge1xuICAgIGdldFRyYWNlcihuYW1lOiBzdHJpbmcsIHZlcnNpb24/OiBzdHJpbmcsIG9wdGlvbnM/OiBUcmFjZXJPcHRpb25zKTogVHJhY2VyIHtcbiAgICAgIHJldHVybiBuZXcgUHJveHkoe30gYXMgVHJhY2VyLCB7XG4gICAgICAgIGdldChfdGFyZ2V0LCBwcm9wZXJ0eSkge1xuICAgICAgICAgIGNvbnN0IHRyYWNlciA9IHJlcXVpcmVOYXRpdmVUcmFjZXJQcm92aWRlcihtYW5hZ2VyKS5nZXRUcmFjZXIobmFtZSwgdmVyc2lvbiwgb3B0aW9ucyk7XG4gICAgICAgICAgY29uc3QgdmFsdWUgPSBSZWZsZWN0LmdldCh0cmFjZXIsIHByb3BlcnR5LCB0cmFjZXIpIGFzIHVua25vd247XG4gICAgICAgICAgcmV0dXJuIHR5cGVvZiB2YWx1ZSA9PT0gXCJmdW5jdGlvblwiID8gdmFsdWUuYmluZCh0cmFjZXIpIDogdmFsdWU7XG4gICAgICAgIH0sXG4gICAgICB9KTtcbiAgICB9LFxuICB9O1xufVxuIl19

package/lib/src/tool-provider.d.ts

@@ -12,6 +12,8 @@ export interface AgentToolExecutionContext {
     readonly resourceId?: string;
     /** Model endpoint selected for the current agent turn. */
     readonly model?: string;
+    /** Browser application origin associated with the current agent turn. */
+    readonly origin?: string;
     /** Best-effort progress sink validated by the hosting integration. */
     readonly writeProgress?: (event: unknown, options?: AgentToolProgressOptions) => Promise<void>;
 }

package/lib/src/tool-provider.js

@@ -17,4 +17,4 @@ export class ToolRegistryPlugin extends Plugin {
         return executeFromRegistry(this.toolRegistry, name, args, signal);
     }
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidG9vbC1wcm92aWRlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90b29sLXByb3ZpZGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLDBFQUEwRTtBQUUxRSxPQUFPLEVBQUUsTUFBTSxFQUF5QixNQUFNLG9CQUFvQixDQUFDO0FBQ25FLE9BQU8sRUFDTCxtQkFBbUIsRUFDbkIsaUJBQWlCLEdBSWxCLE1BQU0seUJBQXlCLENBQUM7QUFrQmpDOzs7OztHQUtHO0FBQ0gsTUFBTSxPQUFnQixrQkFDcEIsU0FBUSxNQUFlO0lBTXZCLG1EQUFtRDtJQUNuRCxhQUFhO1FBQ1gsT0FBTyxpQkFBaUIsQ0FBQyxJQUFJLENBQUMsWUFBWSxDQUFDLENBQUM7SUFDOUMsQ0FBQztJQUVELHdEQUF3RDtJQUN4RCxnQkFBZ0IsQ0FDZCxJQUFZLEVBQ1osSUFBYSxFQUNiLE1BQW9CLEVBQ3BCLFFBQW9DO1FBRXBDLE9BQU8sbUJBQW1CLENBQUMsSUFBSSxDQUFDLFlBQVksRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLE1BQU0sQ0FBQyxDQUFDO0lBQ3BFLENBQUM7Q0FDRiIsInNvdXJjZXNDb250ZW50IjpbIi8qKiBBcHBLaXQgcGx1Z2luIGJhc2UgZm9yIHRvb2xzIGJhY2tlZCBieSB0aGUgbmF0aXZlIHJlZ2lzdHJ5IGhlbHBlcnMuICovXG5cbmltcG9ydCB7IFBsdWdpbiwgdHlwZSBCYXNlUGx1Z2luQ29uZmlnIH0gZnJvbSBcIkBkYXRhYnJpY2tzL2FwcGtpdFwiO1xuaW1wb3J0IHtcbiAgZXhlY3V0ZUZyb21SZWdpc3RyeSxcbiAgdG9vbHNGcm9tUmVnaXN0cnksXG4gIHR5cGUgQWdlbnRUb29sRGVmaW5pdGlvbixcbiAgdHlwZSBUb29sUHJvdmlkZXIsXG4gIHR5cGUgVG9vbFJlZ2lzdHJ5LFxufSBmcm9tIFwiQGRhdGFicmlja3MvYXBwa2l0L2JldGFcIjtcblxuLyoqIERlbGl2ZXJ5IG9wdGlvbnMgZm9yIG9uZSBhZ2VudC10b29sIHByb2dyZXNzIGV2ZW50LiAqL1xuZXhwb3J0IGludGVyZmFjZSBBZ2VudFRvb2xQcm9ncmVzc09wdGlvbnMge1xuICAvKiogU3RyZWFtIHRoZSBldmVudCB0byBhY3RpdmUgY2xpZW50cyB3aXRob3V0IHBlcnNpc3RpbmcgaXQgaW4gbWVzc2FnZSBoaXN0b3J5LiAqL1xuICByZWFkb25seSB0cmFuc2llbnQ/OiBib29sZWFuO1xufVxuXG4vKiogT3B0aW9uYWwgcmVxdWVzdCBzdGF0ZSBzdXBwbGllZCBieSBhbiBhZ2VudCBob3N0IHdoZW4gZGlzcGF0Y2hpbmcgYSBwbHVnaW4gdG9vbC4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQWdlbnRUb29sRXhlY3V0aW9uQ29udGV4dCB7XG4gIC8qKiBSZXNvdXJjZSBpZGVudGl0eSBhc3NvY2lhdGVkIHdpdGggdGhlIGN1cnJlbnQgYWdlbnQgdHVybi4gKi9cbiAgcmVhZG9ubHkgcmVzb3VyY2VJZD86IHN0cmluZztcbiAgLyoqIE1vZGVsIGVuZHBvaW50IHNlbGVjdGVkIGZvciB0aGUgY3VycmVudCBhZ2VudCB0dXJuLiAqL1xuICByZWFkb25seSBtb2RlbD86IHN0cmluZztcbiAgLyoqIEJlc3QtZWZmb3J0IHByb2dyZXNzIHNpbmsgdmFsaWRhdGVkIGJ5IHRoZSBob3N0aW5nIGludGVncmF0aW9uLiAqL1xuICByZWFkb25seSB3cml0ZVByb2dyZXNzPzogKGV2ZW50OiB1bmtub3duLCBvcHRpb25zPzogQWdlbnRUb29sUHJvZ3Jlc3NPcHRpb25zKSA9PiBQcm9taXNlPHZvaWQ+O1xufVxuXG4vKipcbiAqIEltcGxlbWVudHMgQXBwS2l0J3MgYFRvb2xQcm92aWRlcmAgY29udHJhY3QgZnJvbSBvbmUgbmF0aXZlIHRvb2wgcmVnaXN0cnkuXG4gKlxuICogU3ViY2xhc3NlcyBvd24gb25seSB0aGVpciByZWdpc3RyeSBlbnRyaWVzLiBWYWxpZGF0aW9uLCBMTE0tZnJpZW5kbHkgc2NoZW1hXG4gKiBlcnJvcnMsIHRvb2wgZGVzY3JpcHRpb25zLCBhbmQgZGlzcGF0Y2ggc3RheSBvbiBBcHBLaXQncyBuYXRpdmUgaGVscGVycy5cbiAqL1xuZXhwb3J0IGFic3RyYWN0IGNsYXNzIFRvb2xSZWdpc3RyeVBsdWdpbjxUQ29uZmlnIGV4dGVuZHMgQmFzZVBsdWdpbkNvbmZpZyA9IEJhc2VQbHVnaW5Db25maWc+XG4gIGV4dGVuZHMgUGx1Z2luPFRDb25maWc+XG4gIGltcGxlbWVudHMgVG9vbFByb3ZpZGVyXG57XG4gIC8qKiBOYXRpdmUgQXBwS2l0IHRvb2wgZW50cmllcyBleHBvc2VkIGJ5IHRoaXMgcGx1Z2luLiAqL1xuICBwcm90ZWN0ZWQgYWJzdHJhY3QgZ2V0IHRvb2xSZWdpc3RyeSgpOiBUb29sUmVnaXN0cnk7XG5cbiAgLyoqIFRvb2wgZGVmaW5pdGlvbnMgb2ZmZXJlZCB0byBhbiBBcHBLaXQgYWdlbnQuICovXG4gIGdldEFnZW50VG9vbHMoKTogQWdlbnRUb29sRGVmaW5pdGlvbltdIHtcbiAgICByZXR1cm4gdG9vbHNGcm9tUmVnaXN0cnkodGhpcy50b29sUmVnaXN0cnkpO1xuICB9XG5cbiAgLyoqIFZhbGlkYXRlIGFuZCBkaXNwYXRjaCBvbmUgQXBwS2l0IGFnZW50IHRvb2wgY2FsbC4gKi9cbiAgZXhlY3V0ZUFnZW50VG9vbChcbiAgICBuYW1lOiBzdHJpbmcsXG4gICAgYXJnczogdW5rbm93bixcbiAgICBzaWduYWw/OiBBYm9ydFNpZ25hbCxcbiAgICBfY29udGV4dD86IEFnZW50VG9vbEV4ZWN1dGlvbkNvbnRleHQsXG4gICk6IFByb21pc2U8dW5rbm93bj4ge1xuICAgIHJldHVybiBleGVjdXRlRnJvbVJlZ2lzdHJ5KHRoaXMudG9vbFJlZ2lzdHJ5LCBuYW1lLCBhcmdzLCBzaWduYWwpO1xuICB9XG59XG4iXX0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidG9vbC1wcm92aWRlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90b29sLXByb3ZpZGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLDBFQUEwRTtBQUUxRSxPQUFPLEVBQUUsTUFBTSxFQUF5QixNQUFNLG9CQUFvQixDQUFDO0FBQ25FLE9BQU8sRUFDTCxtQkFBbUIsRUFDbkIsaUJBQWlCLEdBSWxCLE1BQU0seUJBQXlCLENBQUM7QUFvQmpDOzs7OztHQUtHO0FBQ0gsTUFBTSxPQUFnQixrQkFDcEIsU0FBUSxNQUFlO0lBTXZCLG1EQUFtRDtJQUNuRCxhQUFhO1FBQ1gsT0FBTyxpQkFBaUIsQ0FBQyxJQUFJLENBQUMsWUFBWSxDQUFDLENBQUM7SUFDOUMsQ0FBQztJQUVELHdEQUF3RDtJQUN4RCxnQkFBZ0IsQ0FDZCxJQUFZLEVBQ1osSUFBYSxFQUNiLE1BQW9CLEVBQ3BCLFFBQW9DO1FBRXBDLE9BQU8sbUJBQW1CLENBQUMsSUFBSSxDQUFDLFlBQVksRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLE1BQU0sQ0FBQyxDQUFDO0lBQ3BFLENBQUM7Q0FDRiIsInNvdXJjZXNDb250ZW50IjpbIi8qKiBBcHBLaXQgcGx1Z2luIGJhc2UgZm9yIHRvb2xzIGJhY2tlZCBieSB0aGUgbmF0aXZlIHJlZ2lzdHJ5IGhlbHBlcnMuICovXG5cbmltcG9ydCB7IFBsdWdpbiwgdHlwZSBCYXNlUGx1Z2luQ29uZmlnIH0gZnJvbSBcIkBkYXRhYnJpY2tzL2FwcGtpdFwiO1xuaW1wb3J0IHtcbiAgZXhlY3V0ZUZyb21SZWdpc3RyeSxcbiAgdG9vbHNGcm9tUmVnaXN0cnksXG4gIHR5cGUgQWdlbnRUb29sRGVmaW5pdGlvbixcbiAgdHlwZSBUb29sUHJvdmlkZXIsXG4gIHR5cGUgVG9vbFJlZ2lzdHJ5LFxufSBmcm9tIFwiQGRhdGFicmlja3MvYXBwa2l0L2JldGFcIjtcblxuLyoqIERlbGl2ZXJ5IG9wdGlvbnMgZm9yIG9uZSBhZ2VudC10b29sIHByb2dyZXNzIGV2ZW50LiAqL1xuZXhwb3J0IGludGVyZmFjZSBBZ2VudFRvb2xQcm9ncmVzc09wdGlvbnMge1xuICAvKiogU3RyZWFtIHRoZSBldmVudCB0byBhY3RpdmUgY2xpZW50cyB3aXRob3V0IHBlcnNpc3RpbmcgaXQgaW4gbWVzc2FnZSBoaXN0b3J5LiAqL1xuICByZWFkb25seSB0cmFuc2llbnQ/OiBib29sZWFuO1xufVxuXG4vKiogT3B0aW9uYWwgcmVxdWVzdCBzdGF0ZSBzdXBwbGllZCBieSBhbiBhZ2VudCBob3N0IHdoZW4gZGlzcGF0Y2hpbmcgYSBwbHVnaW4gdG9vbC4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQWdlbnRUb29sRXhlY3V0aW9uQ29udGV4dCB7XG4gIC8qKiBSZXNvdXJjZSBpZGVudGl0eSBhc3NvY2lhdGVkIHdpdGggdGhlIGN1cnJlbnQgYWdlbnQgdHVybi4gKi9cbiAgcmVhZG9ubHkgcmVzb3VyY2VJZD86IHN0cmluZztcbiAgLyoqIE1vZGVsIGVuZHBvaW50IHNlbGVjdGVkIGZvciB0aGUgY3VycmVudCBhZ2VudCB0dXJuLiAqL1xuICByZWFkb25seSBtb2RlbD86IHN0cmluZztcbiAgLyoqIEJyb3dzZXIgYXBwbGljYXRpb24gb3JpZ2luIGFzc29jaWF0ZWQgd2l0aCB0aGUgY3VycmVudCBhZ2VudCB0dXJuLiAqL1xuICByZWFkb25seSBvcmlnaW4/OiBzdHJpbmc7XG4gIC8qKiBCZXN0LWVmZm9ydCBwcm9ncmVzcyBzaW5rIHZhbGlkYXRlZCBieSB0aGUgaG9zdGluZyBpbnRlZ3JhdGlvbi4gKi9cbiAgcmVhZG9ubHkgd3JpdGVQcm9ncmVzcz86IChldmVudDogdW5rbm93biwgb3B0aW9ucz86IEFnZW50VG9vbFByb2dyZXNzT3B0aW9ucykgPT4gUHJvbWlzZTx2b2lkPjtcbn1cblxuLyoqXG4gKiBJbXBsZW1lbnRzIEFwcEtpdCdzIGBUb29sUHJvdmlkZXJgIGNvbnRyYWN0IGZyb20gb25lIG5hdGl2ZSB0b29sIHJlZ2lzdHJ5LlxuICpcbiAqIFN1YmNsYXNzZXMgb3duIG9ubHkgdGhlaXIgcmVnaXN0cnkgZW50cmllcy4gVmFsaWRhdGlvbiwgTExNLWZyaWVuZGx5IHNjaGVtYVxuICogZXJyb3JzLCB0b29sIGRlc2NyaXB0aW9ucywgYW5kIGRpc3BhdGNoIHN0YXkgb24gQXBwS2l0J3MgbmF0aXZlIGhlbHBlcnMuXG4gKi9cbmV4cG9ydCBhYnN0cmFjdCBjbGFzcyBUb29sUmVnaXN0cnlQbHVnaW48VENvbmZpZyBleHRlbmRzIEJhc2VQbHVnaW5Db25maWcgPSBCYXNlUGx1Z2luQ29uZmlnPlxuICBleHRlbmRzIFBsdWdpbjxUQ29uZmlnPlxuICBpbXBsZW1lbnRzIFRvb2xQcm92aWRlclxue1xuICAvKiogTmF0aXZlIEFwcEtpdCB0b29sIGVudHJpZXMgZXhwb3NlZCBieSB0aGlzIHBsdWdpbi4gKi9cbiAgcHJvdGVjdGVkIGFic3RyYWN0IGdldCB0b29sUmVnaXN0cnkoKTogVG9vbFJlZ2lzdHJ5O1xuXG4gIC8qKiBUb29sIGRlZmluaXRpb25zIG9mZmVyZWQgdG8gYW4gQXBwS2l0IGFnZW50LiAqL1xuICBnZXRBZ2VudFRvb2xzKCk6IEFnZW50VG9vbERlZmluaXRpb25bXSB7XG4gICAgcmV0dXJuIHRvb2xzRnJvbVJlZ2lzdHJ5KHRoaXMudG9vbFJlZ2lzdHJ5KTtcbiAgfVxuXG4gIC8qKiBWYWxpZGF0ZSBhbmQgZGlzcGF0Y2ggb25lIEFwcEtpdCBhZ2VudCB0b29sIGNhbGwuICovXG4gIGV4ZWN1dGVBZ2VudFRvb2woXG4gICAgbmFtZTogc3RyaW5nLFxuICAgIGFyZ3M6IHVua25vd24sXG4gICAgc2lnbmFsPzogQWJvcnRTaWduYWwsXG4gICAgX2NvbnRleHQ/OiBBZ2VudFRvb2xFeGVjdXRpb25Db250ZXh0LFxuICApOiBQcm9taXNlPHVua25vd24+IHtcbiAgICByZXR1cm4gZXhlY3V0ZUZyb21SZWdpc3RyeSh0aGlzLnRvb2xSZWdpc3RyeSwgbmFtZSwgYXJncywgc2lnbmFsKTtcbiAgfVxufVxuIl19

package/lib/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/_auto-configure.ts","../src/appkit.ts","../src/brand-context.ts","../src/bundle.ts","../src/cache-storage.ts","../src/databricks.ts","../src/files-cache.ts","../src/identity.ts","../src/interceptor.ts","../src/lakebase-resolver.ts","../src/migration.ts","../src/pgaddress.ts","../src/plugin-execution.ts","../src/plugin-registry.ts","../src/provision.ts","../src/request-tags.ts","../src/tool-operations.ts","../src/tool-provider.ts","../src/toolkit-entries.ts","../index.ts"],"version":"5.9.3"}
+{"root":["../src/_auto-configure.ts","../src/appkit.ts","../src/brand-context.ts","../src/bundle.ts","../src/cache-storage.ts","../src/databricks.ts","../src/files-cache.ts","../src/identity.ts","../src/interceptor.ts","../src/lakebase-resolver.ts","../src/migration.ts","../src/openapi-tool.ts","../src/pgaddress.ts","../src/plugin-execution.ts","../src/plugin-registry.ts","../src/provision.ts","../src/request-tags.ts","../src/telemetry.ts","../src/tool-operations.ts","../src/tool-provider.ts","../src/toolkit-entries.ts","../index.ts"],"version":"5.9.3"}

package/package.json

@@ -20,7 +20,8 @@
   },
   "devDependencies": {
     "@databricks/appkit": "0.81.0",
-    "@dbx-tools/projen": "^0.9.129",
+    "@dbx-tools/projen": "^0.9.131",
+    "@types/json-schema": "^7",
     "@types/node": "^24.6.0",
     "typescript": "^5.9.3",
     "vitest": "3.2.4"
@@ -30,13 +31,15 @@
   },
   "dependencies": {
     "@databricks/sdk-experimental": "^0.17.0",
-    "@dbx-tools/auth": "^0.9.129",
-    "@dbx-tools/cache": "^0.9.129",
-    "@dbx-tools/core": "^0.9.129",
-    "@dbx-tools/lakebase": "^0.9.129",
-    "@dbx-tools/postgres": "^0.9.129",
-    "@dbx-tools/shared-core": "^0.9.129",
-    "@dbx-tools/shared-fs": "^0.9.129",
+    "@dbx-tools/auth": "^0.9.131",
+    "@dbx-tools/cache": "^0.9.131",
+    "@dbx-tools/core": "^0.9.131",
+    "@dbx-tools/lakebase": "^0.9.131",
+    "@dbx-tools/postgres": "^0.9.131",
+    "@dbx-tools/shared-core": "^0.9.131",
+    "@dbx-tools/shared-fs": "^0.9.131",
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/sdk-trace-base": "2.8.0",
     "zod": "4.3.6"
   },
   "main": "./lib/index.js",
@@ -90,6 +93,10 @@
         "types": "./lib/src/migration.d.ts",
         "default": "./lib/src/migration.js"
       },
+      "./openapi-tool": {
+        "types": "./lib/src/openapi-tool.d.ts",
+        "default": "./lib/src/openapi-tool.js"
+      },
       "./pgaddress": {
         "types": "./lib/src/pgaddress.d.ts",
         "default": "./lib/src/pgaddress.js"
@@ -110,6 +117,10 @@
         "types": "./lib/src/request-tags.d.ts",
         "default": "./lib/src/request-tags.js"
       },
+      "./telemetry": {
+        "types": "./lib/src/telemetry.d.ts",
+        "default": "./lib/src/telemetry.js"
+      },
       "./tool-operations": {
         "types": "./lib/src/tool-operations.d.ts",
         "default": "./lib/src/tool-operations.js"
@@ -129,7 +140,7 @@
       "./package.json": "./package.json"
     }
   },
-  "version": "0.9.129",
+  "version": "0.9.131",
   "types": "./lib/index.d.ts",
   "dbxToolsConfig": {
     "tags": [
@@ -182,6 +193,10 @@
       "types": "./lib/src/migration.d.ts",
       "default": "./lib/src/migration.js"
     },
+    "./openapi-tool": {
+      "types": "./lib/src/openapi-tool.d.ts",
+      "default": "./lib/src/openapi-tool.js"
+    },
     "./pgaddress": {
       "types": "./lib/src/pgaddress.d.ts",
       "default": "./lib/src/pgaddress.js"
@@ -202,6 +217,10 @@
       "types": "./lib/src/request-tags.d.ts",
       "default": "./lib/src/request-tags.js"
     },
+    "./telemetry": {
+      "types": "./lib/src/telemetry.d.ts",
+      "default": "./lib/src/telemetry.js"
+    },
     "./tool-operations": {
       "types": "./lib/src/tool-operations.d.ts",
       "default": "./lib/src/tool-operations.js"

package/src/appkit.ts

@@ -51,6 +51,7 @@ import {
 } from "./interceptor.ts";
 import { applyLakebaseEnv, type LakebaseConnection } from "./lakebase-resolver.ts";
 import { provisionCacheSchema } from "./provision.ts";
+import { bindNativeTelemetryProvider } from "./telemetry.ts";
 
 const logger = log.logger("appkit");
 
@@ -309,6 +310,12 @@ export async function createApp<T extends AppKitPlugins>(
   const appConfig = { ...config };
   delete appConfig.autoConfigure;
   delete appConfig.interceptor;
+  const onPluginsReady = appConfig.onPluginsReady;
+  appConfig.onPluginsReady = async (app) => {
+    const bound = await bindNativeTelemetryProvider();
+    logger.debug("createApp: native telemetry provider binding", { bound });
+    await onPluginsReady?.(app);
+  };
 
   if (shouldInjectCacheStorage(config)) {
     logger.debug("createApp: inject memory-first cache storage");

package/src/openapi-tool.ts

@@ -0,0 +1,246 @@
+/**
+ * OpenAPI operation loading and JSON Schema extraction.
+ *
+ * @module
+ */
+
+import { readFile } from "node:fs/promises";
+import { object } from "@dbx-tools/shared-core";
+import { urlBuilder, type UrlBuilder } from "@dbx-tools/shared-core/net";
+import type { JSONSchema7 } from "json-schema";
+import { z } from "zod";
+
+const HTTP_METHODS = ["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS", "HEAD", "TRACE"] as const;
+
+const JsonObjectSchema = z
+  .record(z.string(), z.unknown())
+  .describe("A JSON object embedded in an OpenAPI document.");
+
+const OpenApiMediaTypeSchema = z
+  .object({
+    schema: JsonObjectSchema.describe("The JSON Schema for this media type."),
+  })
+  .describe("One OpenAPI media type.");
+
+const OpenApiRequestBodySchema = z
+  .object({
+    content: z
+      .record(z.string(), OpenApiMediaTypeSchema)
+      .describe("Request media types keyed by content type."),
+  })
+  .describe("An OpenAPI request body.");
+
+const OpenApiResponseSchema = z
+  .object({
+    content: z
+      .record(z.string(), OpenApiMediaTypeSchema)
+      .optional()
+      .describe("Response media types keyed by content type."),
+  })
+  .describe("One OpenAPI response.");
+
+const OpenApiOperationSchema = z
+  .object({
+    operationId: z.string().describe("The stable operation identifier."),
+    summary: z.string().optional().describe("The short operation summary."),
+    description: z.string().optional().describe("The full operation description."),
+    requestBody: OpenApiRequestBodySchema.optional().describe(
+      "The optional operation request body.",
+    ),
+    responses: z
+      .record(z.string(), OpenApiResponseSchema)
+      .describe("Operation responses keyed by HTTP status."),
+  })
+  .describe("The OpenAPI fields required to define a tool.");
+
+const OpenApiPathSchema = z
+  .object({
+    get: OpenApiOperationSchema.optional(),
+    post: OpenApiOperationSchema.optional(),
+    put: OpenApiOperationSchema.optional(),
+    patch: OpenApiOperationSchema.optional(),
+    delete: OpenApiOperationSchema.optional(),
+    options: OpenApiOperationSchema.optional(),
+    head: OpenApiOperationSchema.optional(),
+    trace: OpenApiOperationSchema.optional(),
+  })
+  .describe("Operations available at one OpenAPI path.");
+
+const OpenApiDocumentSchema = z
+  .object({
+    paths: z
+      .record(z.string(), OpenApiPathSchema)
+      .refine((paths) => Object.keys(paths).length > 0, "OpenAPI paths must not be empty")
+      .describe("OpenAPI path items keyed by URL path."),
+    components: JsonObjectSchema.optional().describe("Reusable OpenAPI components."),
+    servers: z
+      .array(
+        z.object({
+          url: z.string().describe("Server base URL."),
+        }),
+      )
+      .optional()
+      .describe("OpenAPI server definitions."),
+  })
+  .describe("An OpenAPI document used to define HTTP tools.");
+
+type OpenApiDocument = z.infer<typeof OpenApiDocumentSchema>;
+type OpenApiOperation = z.infer<typeof OpenApiOperationSchema>;
+
+/** HTTP method supported by an {@link OpenApiTool}. */
+export type OpenApiHttpMethod = (typeof HTTP_METHODS)[number];
+
+/** One executable HTTP operation derived from an OpenAPI document. */
+export interface OpenApiTool {
+  /** Stable operation identifier. */
+  id: string;
+  /** Model-facing operation description. */
+  description: string;
+  /** Resolved operation URL, or the OpenAPI path for a local document without a server URL. */
+  url: string;
+  /** HTTP method used by the operation. */
+  method: OpenApiHttpMethod;
+  /** JSON Schema describing operation input. */
+  inputSchema: JSONSchema7;
+  /** JSON Schema describing a successful operation result. */
+  outputSchema: JSONSchema7;
+}
+
+/** Request options used while loading an OpenAPI document. */
+export interface OpenApiToolsOptions {
+  /** Cancels an HTTP request or file read. */
+  signal?: AbortSignal;
+  /** Headers sent when `source` is an HTTP(S) URL. */
+  headers?: RequestInit["headers"];
+}
+
+/** Load an HTTP(S) URL or local file and return its OpenAPI operations as tool schemas. */
+export async function openApiTools(
+  source: string,
+  options: OpenApiToolsOptions = {},
+): Promise<OpenApiTool[]> {
+  const sourceUrl = httpUrl(source);
+  const document = OpenApiDocumentSchema.parse(
+    sourceUrl
+      ? await fetchDocument(sourceUrl, options)
+      : await readDocument(source, options.signal),
+  );
+  return Object.entries(document.paths).flatMap(([path, item]) =>
+    HTTP_METHODS.flatMap((method) => {
+      const operation = item[method.toLowerCase() as Lowercase<OpenApiHttpMethod>];
+      return operation ? [operationTool(document, sourceUrl, path, method, operation)] : [];
+    }),
+  );
+}
+
+function httpUrl(source: string): UrlBuilder | undefined {
+  const value = source.trim();
+  if (!value.startsWith("http://") && !value.startsWith("https://")) return undefined;
+  const url = urlBuilder(value);
+  return url?.scheme === "http" || url?.scheme === "https" ? url : undefined;
+}
+
+async function fetchDocument(url: URL, options: OpenApiToolsOptions): Promise<unknown> {
+  const response = await fetch(url, {
+    signal: options.signal,
+    headers: options.headers,
+  });
+  if (!response.ok) {
+    throw new Error(`OpenAPI request failed with HTTP ${response.status}: ${url}`);
+  }
+  return response.json();
+}
+
+async function readDocument(path: string, signal?: AbortSignal): Promise<unknown> {
+  return JSON.parse(await readFile(path, { encoding: "utf8", signal }));
+}
+
+function operationTool(
+  document: OpenApiDocument,
+  sourceUrl: URL | undefined,
+  path: string,
+  method: OpenApiHttpMethod,
+  operation: OpenApiOperation,
+): OpenApiTool {
+  const requestSchema = jsonSchema(operation.requestBody?.content) ?? { type: "object" };
+  const responseSchema = successfulResponseSchema(operation);
+  return {
+    id: operation.operationId,
+    description:
+      operation.description?.trim() || operation.summary?.trim() || operation.operationId,
+    url: operationUrl(document, sourceUrl, path),
+    method,
+    inputSchema: resolveReferences(document, requestSchema) as JSONSchema7,
+    outputSchema: resolveReferences(document, responseSchema) as JSONSchema7,
+  };
+}
+
+function successfulResponseSchema(operation: OpenApiOperation): Record<string, unknown> {
+  for (const [status, response] of Object.entries(operation.responses)) {
+    const schema = jsonSchema(response.content);
+    if (/^2(?:\d{2}|XX)$/i.test(status) && schema) return schema;
+  }
+  return {};
+}
+
+function jsonSchema(
+  content: Record<string, z.infer<typeof OpenApiMediaTypeSchema>> | undefined,
+): Record<string, unknown> | undefined {
+  const mediaType = Object.entries(content ?? {}).find(([type]) =>
+    /^application\/(?:[^+;]+\+)?json(?:;|$)/i.test(type),
+  );
+  return mediaType?.[1].schema;
+}
+
+function operationUrl(document: OpenApiDocument, sourceUrl: URL | undefined, path: string): string {
+  const server = document.servers?.[0]?.url;
+  if (server) {
+    const base = sourceUrl ? urlBuilder(new URL(server, sourceUrl)) : httpUrl(server);
+    return base
+      ? base.withPathAppend(path).toString()
+      : `${server.replace(/\/$/, "")}/${path.replace(/^\//, "")}`;
+  }
+  return sourceUrl ? (urlBuilder(sourceUrl)?.withPathReplace(path).toString() ?? path) : path;
+}
+
+function resolveReferences(
+  document: OpenApiDocument,
+  value: unknown,
+  active: ReadonlySet<string> = new Set(),
+): unknown {
+  if (Array.isArray(value)) return value.map((item) => resolveReferences(document, item, active));
+  if (!object.isRecord(value)) return value;
+  const reference = typeof value.$ref === "string" ? value.$ref : undefined;
+  if (reference) {
+    if (active.has(reference)) throw new Error(`Cyclic OpenAPI reference: ${reference}`);
+    const target = referenceTarget(document, reference);
+    const next = new Set(active).add(reference);
+    const { $ref: _ignored, ...siblings } = value;
+    return {
+      ...(resolveReferences(document, target, next) as Record<string, unknown>),
+      ...(resolveReferences(document, siblings, next) as Record<string, unknown>),
+    };
+  }
+  return Object.fromEntries(
+    Object.entries(value).map(([key, child]) => [key, resolveReferences(document, child, active)]),
+  );
+}
+
+function referenceTarget(document: OpenApiDocument, reference: string): unknown {
+  if (!reference.startsWith("#/")) throw new Error(`Unsupported OpenAPI reference: ${reference}`);
+  let current: unknown = document;
+  for (const rawSegment of reference.slice(2).split("/")) {
+    const segment = rawSegment.replaceAll("~1", "/").replaceAll("~0", "~");
+    if (!object.isRecord(current) || !(segment in current)) {
+      throw new Error(`Unresolved OpenAPI reference: ${reference}`);
+    }
+    current = current[segment];
+  }
+  return current;
+}
+
+if (import.meta.main) {
+  const source = process.argv[2];
+  if (!source) throw new Error("Usage: bun openapi-tool.ts <openapi-url-or-file>");
+  console.log(JSON.stringify(await openApiTools(source), null, 2));
+}