beeai-framework 0.1.2

package/dist/instrumentation/helpers/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/instrumentation/helpers/utils.ts"],"names":["assertLLMWithMessagesToPromptFn","instance","Boolean","ChatModel"],"mappings":";;;;;;AAkBO,SAASA,gCAAgCC,QAAgB,EAAA;AAC9D,EAAOC,OAAAA,OAAAA,CAAQD,QAAYA,IAAAA,QAAAA,YAAoBE,kBAAAA,CAAAA;AACjD;AAFgBH,MAAAA,CAAAA,+BAAAA,EAAAA,iCAAAA,CAAAA","file":"utils.cjs","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { ChatModel } from \"@/backend/chat.js\";\n\nexport function assertLLMWithMessagesToPromptFn(instance: object): instance is ChatModel {\n  return Boolean(instance && instance instanceof ChatModel);\n}\n"]}

package/dist/instrumentation/helpers/utils.d.cts

@@ -0,0 +1,40 @@
+import { ChatModel } from '../../backend/chat.cjs';
+import '../../backend/message.cjs';
+import '../../internals/serializable.cjs';
+import '../../internals/types.cjs';
+import '../../internals/helpers/guards.cjs';
+import 'ai';
+import '../../context.cjs';
+import '../../emitter-BWtGHYn0.cjs';
+import '../../internals/helpers/promise.cjs';
+import '../../errors.cjs';
+import 'promise-based-task';
+import '../../cache/base.cjs';
+import '../../backend/utils.cjs';
+import '../../backend/constants.cjs';
+import '../../tools/base.cjs';
+import 'ajv';
+import '../../internals/helpers/schema.cjs';
+import 'zod';
+import 'zod-to-json-schema';
+import '@ai-sdk/provider';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare function assertLLMWithMessagesToPromptFn(instance: object): instance is ChatModel;
+
+export { assertLLMWithMessagesToPromptFn };

package/dist/instrumentation/helpers/utils.d.ts

@@ -0,0 +1,40 @@
+import { ChatModel } from '../../backend/chat.js';
+import '../../backend/message.js';
+import '../../internals/serializable.js';
+import '../../internals/types.js';
+import '../../internals/helpers/guards.js';
+import 'ai';
+import '../../context.js';
+import '../../emitter-l0W9gC1A.js';
+import '../../internals/helpers/promise.js';
+import '../../errors.js';
+import 'promise-based-task';
+import '../../cache/base.js';
+import '../../backend/utils.js';
+import '../../backend/constants.js';
+import '../../tools/base.js';
+import 'ajv';
+import '../../internals/helpers/schema.js';
+import 'zod';
+import 'zod-to-json-schema';
+import '@ai-sdk/provider';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare function assertLLMWithMessagesToPromptFn(instance: object): instance is ChatModel;
+
+export { assertLLMWithMessagesToPromptFn };

package/dist/instrumentation/helpers/utils.js

@@ -0,0 +1,12 @@
+import { ChatModel } from '../../backend/chat.js';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function assertLLMWithMessagesToPromptFn(instance) {
+  return Boolean(instance && instance instanceof ChatModel);
+}
+__name(assertLLMWithMessagesToPromptFn, "assertLLMWithMessagesToPromptFn");
+
+export { assertLLMWithMessagesToPromptFn };
+//# sourceMappingURL=utils.js.map
+//# sourceMappingURL=utils.js.map

package/dist/instrumentation/helpers/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/instrumentation/helpers/utils.ts"],"names":["assertLLMWithMessagesToPromptFn","instance","Boolean","ChatModel"],"mappings":";;;;AAkBO,SAASA,gCAAgCC,QAAgB,EAAA;AAC9D,EAAOC,OAAAA,OAAAA,CAAQD,QAAYA,IAAAA,QAAAA,YAAoBE,SAAAA,CAAAA;AACjD;AAFgBH,MAAAA,CAAAA,+BAAAA,EAAAA,iCAAAA,CAAAA","file":"utils.js","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { ChatModel } from \"@/backend/chat.js\";\n\nexport function assertLLMWithMessagesToPromptFn(instance: object): instance is ChatModel {\n  return Boolean(instance && instance instanceof ChatModel);\n}\n"]}

package/dist/instrumentation/logger.cjs

@@ -0,0 +1,12 @@
+'use strict';
+
+var logger_cjs = require('../logger/logger.cjs');
+
+const instrumentationLogger = logger_cjs.Logger.root.child({
+  name: "instrumentation",
+  level: logger_cjs.LoggerLevel.WARN
+});
+
+exports.instrumentationLogger = instrumentationLogger;
+//# sourceMappingURL=logger.cjs.map
+//# sourceMappingURL=logger.cjs.map

package/dist/instrumentation/logger.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/instrumentation/logger.ts"],"names":["instrumentationLogger","Logger","root","child","name","level","LoggerLevel","WARN"],"mappings":";;;;AAkBaA,MAAAA,qBAAAA,GAAwBC,iBAAOC,CAAAA,IAAAA,CAAKC,KAAM,CAAA;EACrDC,IAAM,EAAA,iBAAA;AACNC,EAAAA,KAAAA,EAAOC,sBAAYC,CAAAA;AACrB,CAAA","file":"logger.cjs","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Logger, LoggerLevel } from \"@/logger/logger.js\";\n\nexport const instrumentationLogger = Logger.root.child({\n  name: \"instrumentation\",\n  level: LoggerLevel.WARN,\n});\n"]}

package/dist/instrumentation/logger.d.cts

@@ -0,0 +1,26 @@
+import { Logger } from '../logger/logger.cjs';
+import 'pino';
+import '../errors.cjs';
+import '../internals/types.cjs';
+import '../internals/helpers/guards.cjs';
+import '../internals/serializable.cjs';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare const instrumentationLogger: Logger;
+
+export { instrumentationLogger };

package/dist/instrumentation/logger.d.ts

@@ -0,0 +1,26 @@
+import { Logger } from '../logger/logger.js';
+import 'pino';
+import '../errors.js';
+import '../internals/types.js';
+import '../internals/helpers/guards.js';
+import '../internals/serializable.js';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare const instrumentationLogger: Logger;
+
+export { instrumentationLogger };

package/dist/instrumentation/logger.js

@@ -0,0 +1,10 @@
+import { Logger, LoggerLevel } from '../logger/logger.js';
+
+const instrumentationLogger = Logger.root.child({
+  name: "instrumentation",
+  level: LoggerLevel.WARN
+});
+
+export { instrumentationLogger };
+//# sourceMappingURL=logger.js.map
+//# sourceMappingURL=logger.js.map

package/dist/instrumentation/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/instrumentation/logger.ts"],"names":["instrumentationLogger","Logger","root","child","name","level","LoggerLevel","WARN"],"mappings":";;AAkBaA,MAAAA,qBAAAA,GAAwBC,MAAOC,CAAAA,IAAAA,CAAKC,KAAM,CAAA;EACrDC,IAAM,EAAA,iBAAA;AACNC,EAAAA,KAAAA,EAAOC,WAAYC,CAAAA;AACrB,CAAA","file":"logger.js","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Logger, LoggerLevel } from \"@/logger/logger.js\";\n\nexport const instrumentationLogger = Logger.root.child({\n  name: \"instrumentation\",\n  level: LoggerLevel.WARN,\n});\n"]}

package/dist/instrumentation/tracer.cjs

@@ -0,0 +1,84 @@
+'use strict';
+
+var version_cjs = require('../version.cjs');
+var opentelemetry = require('@opentelemetry/api');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var opentelemetry__default = /*#__PURE__*/_interopDefault(opentelemetry);
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const tracer = opentelemetry__default.default.trace.getTracer("beeai-framework", version_cjs.Version);
+const activeTracesMap = /* @__PURE__ */ new Map();
+function buildSpansForParent({ spans, parentId, traceId }) {
+  spans.filter((fwSpan) => fwSpan.parent_id === parentId).forEach((fwSpan) => {
+    tracer.startActiveSpan(fwSpan.context.span_id, {
+      // custom start time
+      startTime: fwSpan.start_time,
+      // set span important attributes
+      attributes: {
+        target: fwSpan.attributes.target,
+        name: fwSpan.name,
+        traceId,
+        ...fwSpan.attributes.data && {
+          data: JSON.stringify(fwSpan.attributes.data)
+        },
+        ...fwSpan.attributes.ctx && {
+          ctx: JSON.stringify(fwSpan.attributes.ctx)
+        }
+      }
+    }, (activeSpan) => {
+      activeSpan.setStatus(fwSpan.status);
+      buildSpansForParent({
+        spans,
+        traceId,
+        parentId: fwSpan.context.span_id
+      });
+      activeSpan.end(fwSpan.end_time);
+    });
+  });
+}
+__name(buildSpansForParent, "buildSpansForParent");
+function buildTraceTree({ prompt, history, generatedMessage, spans, traceId, version, runErrorSpanKey, startTime, endTime, source }) {
+  tracer.startActiveSpan(`beeai-framework-${source}-${traceId}`, {
+    // custom start time
+    startTime,
+    // set main span important attributes
+    attributes: {
+      traceId,
+      version,
+      ...prompt && {
+        prompt
+      },
+      ...generatedMessage !== void 0 && {
+        response: JSON.stringify(generatedMessage)
+      },
+      ...history && {
+        history: JSON.stringify(history)
+      }
+    }
+  }, (activeSpan) => {
+    const runErrorSpan = spans.find((span) => span.attributes.target === runErrorSpanKey);
+    if (runErrorSpan) {
+      activeSpan.setStatus(runErrorSpan.status);
+    } else {
+      activeSpan.setStatus({
+        code: opentelemetry.SpanStatusCode.OK
+      });
+    }
+    buildSpansForParent({
+      spans,
+      traceId,
+      parentId: void 0
+    });
+    activeSpan.end(endTime);
+  });
+}
+__name(buildTraceTree, "buildTraceTree");
+
+exports.activeTracesMap = activeTracesMap;
+exports.buildTraceTree = buildTraceTree;
+exports.tracer = tracer;
+//# sourceMappingURL=tracer.cjs.map
+//# sourceMappingURL=tracer.cjs.map

package/dist/instrumentation/tracer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/instrumentation/tracer.ts"],"names":["tracer","opentelemetry","trace","getTracer","Version","activeTracesMap","Map","buildSpansForParent","spans","parentId","traceId","filter","fwSpan","parent_id","forEach","startActiveSpan","context","span_id","startTime","start_time","attributes","target","name","data","JSON","stringify","ctx","activeSpan","setStatus","status","end","end_time","buildTraceTree","prompt","history","generatedMessage","version","runErrorSpanKey","endTime","source","undefined","response","runErrorSpan","find","span","code","SpanStatusCode","OK"],"mappings":"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","file":"tracer.cjs","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Version } from \"@/version.js\";\nimport opentelemetry, { SpanStatusCode, TimeInput } from \"@opentelemetry/api\";\nimport { FrameworkSpan, GeneratedResponse } from \"./types.js\";\n\nexport const tracer = opentelemetry.trace.getTracer(\"beeai-framework\", Version);\n\nexport const activeTracesMap = new Map<string, string>();\n\ninterface ComputeTreeProps {\n  prompt?: string | null;\n  history: GeneratedResponse[] | undefined;\n  generatedMessage: GeneratedResponse | undefined;\n  spans: FrameworkSpan[];\n  traceId: string;\n  version: string;\n  runErrorSpanKey: string;\n  startTime: TimeInput;\n  endTime: TimeInput;\n  source: string;\n}\n\ninterface BuildSpansForParentProps {\n  spans: FrameworkSpan[];\n  traceId: string;\n  parentId: string | undefined;\n}\n\nfunction buildSpansForParent({ spans, parentId, traceId }: BuildSpansForParentProps) {\n  spans\n    .filter((fwSpan) => fwSpan.parent_id === parentId)\n    .forEach((fwSpan) => {\n      tracer.startActiveSpan(\n        fwSpan.context.span_id,\n        {\n          // custom start time\n          startTime: fwSpan.start_time,\n          // set span important attributes\n          attributes: {\n            target: fwSpan.attributes.target,\n            name: fwSpan.name,\n            traceId,\n            ...(fwSpan.attributes.data && { data: JSON.stringify(fwSpan.attributes.data) }),\n            ...(fwSpan.attributes.ctx && { ctx: JSON.stringify(fwSpan.attributes.ctx) }),\n          },\n        },\n        (activeSpan) => {\n          // set status\n          activeSpan.setStatus(fwSpan.status);\n\n          // set nested spans\n          buildSpansForParent({ spans, traceId, parentId: fwSpan.context.span_id });\n\n          // finish the span\n          activeSpan.end(fwSpan.end_time);\n        },\n      );\n    });\n}\n\nexport function buildTraceTree({\n  prompt,\n  history,\n  generatedMessage,\n  spans,\n  traceId,\n  version,\n  runErrorSpanKey,\n  startTime,\n  endTime,\n  source,\n}: ComputeTreeProps) {\n  tracer.startActiveSpan(\n    `beeai-framework-${source}-${traceId}`,\n    {\n      // custom start time\n      startTime,\n      // set main span important attributes\n      attributes: {\n        traceId,\n        version,\n        ...(prompt && { prompt }),\n        ...(generatedMessage !== undefined && { response: JSON.stringify(generatedMessage) }),\n        ...(history && { history: JSON.stringify(history) }),\n      },\n    },\n    (activeSpan) => {\n      // set status\n      const runErrorSpan = spans.find((span) => span.attributes.target === runErrorSpanKey);\n      if (runErrorSpan) {\n        activeSpan.setStatus(runErrorSpan.status);\n      } else {\n        activeSpan.setStatus({ code: SpanStatusCode.OK });\n      }\n\n      // set nested spans\n      buildSpansForParent({ spans, traceId, parentId: undefined });\n\n      // finish the main span with custom end time\n      activeSpan.end(endTime);\n    },\n  );\n}\n"]}

package/dist/instrumentation/tracer.d.cts

@@ -0,0 +1,36 @@
+import opentelemetry, { TimeInput } from '@opentelemetry/api';
+import { GeneratedResponse, FrameworkSpan } from './types.cjs';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare const tracer: opentelemetry.Tracer;
+declare const activeTracesMap: Map<string, string>;
+interface ComputeTreeProps {
+    prompt?: string | null;
+    history: GeneratedResponse[] | undefined;
+    generatedMessage: GeneratedResponse | undefined;
+    spans: FrameworkSpan[];
+    traceId: string;
+    version: string;
+    runErrorSpanKey: string;
+    startTime: TimeInput;
+    endTime: TimeInput;
+    source: string;
+}
+declare function buildTraceTree({ prompt, history, generatedMessage, spans, traceId, version, runErrorSpanKey, startTime, endTime, source, }: ComputeTreeProps): void;
+
+export { activeTracesMap, buildTraceTree, tracer };

package/dist/instrumentation/tracer.d.ts

@@ -0,0 +1,36 @@
+import opentelemetry, { TimeInput } from '@opentelemetry/api';
+import { GeneratedResponse, FrameworkSpan } from './types.js';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare const tracer: opentelemetry.Tracer;
+declare const activeTracesMap: Map<string, string>;
+interface ComputeTreeProps {
+    prompt?: string | null;
+    history: GeneratedResponse[] | undefined;
+    generatedMessage: GeneratedResponse | undefined;
+    spans: FrameworkSpan[];
+    traceId: string;
+    version: string;
+    runErrorSpanKey: string;
+    startTime: TimeInput;
+    endTime: TimeInput;
+    source: string;
+}
+declare function buildTraceTree({ prompt, history, generatedMessage, spans, traceId, version, runErrorSpanKey, startTime, endTime, source, }: ComputeTreeProps): void;
+
+export { activeTracesMap, buildTraceTree, tracer };

package/dist/instrumentation/tracer.js

@@ -0,0 +1,76 @@
+import { Version } from '../version.js';
+import opentelemetry, { SpanStatusCode } from '@opentelemetry/api';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const tracer = opentelemetry.trace.getTracer("beeai-framework", Version);
+const activeTracesMap = /* @__PURE__ */ new Map();
+function buildSpansForParent({ spans, parentId, traceId }) {
+  spans.filter((fwSpan) => fwSpan.parent_id === parentId).forEach((fwSpan) => {
+    tracer.startActiveSpan(fwSpan.context.span_id, {
+      // custom start time
+      startTime: fwSpan.start_time,
+      // set span important attributes
+      attributes: {
+        target: fwSpan.attributes.target,
+        name: fwSpan.name,
+        traceId,
+        ...fwSpan.attributes.data && {
+          data: JSON.stringify(fwSpan.attributes.data)
+        },
+        ...fwSpan.attributes.ctx && {
+          ctx: JSON.stringify(fwSpan.attributes.ctx)
+        }
+      }
+    }, (activeSpan) => {
+      activeSpan.setStatus(fwSpan.status);
+      buildSpansForParent({
+        spans,
+        traceId,
+        parentId: fwSpan.context.span_id
+      });
+      activeSpan.end(fwSpan.end_time);
+    });
+  });
+}
+__name(buildSpansForParent, "buildSpansForParent");
+function buildTraceTree({ prompt, history, generatedMessage, spans, traceId, version, runErrorSpanKey, startTime, endTime, source }) {
+  tracer.startActiveSpan(`beeai-framework-${source}-${traceId}`, {
+    // custom start time
+    startTime,
+    // set main span important attributes
+    attributes: {
+      traceId,
+      version,
+      ...prompt && {
+        prompt
+      },
+      ...generatedMessage !== void 0 && {
+        response: JSON.stringify(generatedMessage)
+      },
+      ...history && {
+        history: JSON.stringify(history)
+      }
+    }
+  }, (activeSpan) => {
+    const runErrorSpan = spans.find((span) => span.attributes.target === runErrorSpanKey);
+    if (runErrorSpan) {
+      activeSpan.setStatus(runErrorSpan.status);
+    } else {
+      activeSpan.setStatus({
+        code: SpanStatusCode.OK
+      });
+    }
+    buildSpansForParent({
+      spans,
+      traceId,
+      parentId: void 0
+    });
+    activeSpan.end(endTime);
+  });
+}
+__name(buildTraceTree, "buildTraceTree");
+
+export { activeTracesMap, buildTraceTree, tracer };
+//# sourceMappingURL=tracer.js.map
+//# sourceMappingURL=tracer.js.map

package/dist/instrumentation/tracer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/instrumentation/tracer.ts"],"names":["tracer","opentelemetry","trace","getTracer","Version","activeTracesMap","Map","buildSpansForParent","spans","parentId","traceId","filter","fwSpan","parent_id","forEach","startActiveSpan","context","span_id","startTime","start_time","attributes","target","name","data","JSON","stringify","ctx","activeSpan","setStatus","status","end","end_time","buildTraceTree","prompt","history","generatedMessage","version","runErrorSpanKey","endTime","source","undefined","response","runErrorSpan","find","span","code","SpanStatusCode","OK"],"mappings":"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","file":"tracer.js","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Version } from \"@/version.js\";\nimport opentelemetry, { SpanStatusCode, TimeInput } from \"@opentelemetry/api\";\nimport { FrameworkSpan, GeneratedResponse } from \"./types.js\";\n\nexport const tracer = opentelemetry.trace.getTracer(\"beeai-framework\", Version);\n\nexport const activeTracesMap = new Map<string, string>();\n\ninterface ComputeTreeProps {\n  prompt?: string | null;\n  history: GeneratedResponse[] | undefined;\n  generatedMessage: GeneratedResponse | undefined;\n  spans: FrameworkSpan[];\n  traceId: string;\n  version: string;\n  runErrorSpanKey: string;\n  startTime: TimeInput;\n  endTime: TimeInput;\n  source: string;\n}\n\ninterface BuildSpansForParentProps {\n  spans: FrameworkSpan[];\n  traceId: string;\n  parentId: string | undefined;\n}\n\nfunction buildSpansForParent({ spans, parentId, traceId }: BuildSpansForParentProps) {\n  spans\n    .filter((fwSpan) => fwSpan.parent_id === parentId)\n    .forEach((fwSpan) => {\n      tracer.startActiveSpan(\n        fwSpan.context.span_id,\n        {\n          // custom start time\n          startTime: fwSpan.start_time,\n          // set span important attributes\n          attributes: {\n            target: fwSpan.attributes.target,\n            name: fwSpan.name,\n            traceId,\n            ...(fwSpan.attributes.data && { data: JSON.stringify(fwSpan.attributes.data) }),\n            ...(fwSpan.attributes.ctx && { ctx: JSON.stringify(fwSpan.attributes.ctx) }),\n          },\n        },\n        (activeSpan) => {\n          // set status\n          activeSpan.setStatus(fwSpan.status);\n\n          // set nested spans\n          buildSpansForParent({ spans, traceId, parentId: fwSpan.context.span_id });\n\n          // finish the span\n          activeSpan.end(fwSpan.end_time);\n        },\n      );\n    });\n}\n\nexport function buildTraceTree({\n  prompt,\n  history,\n  generatedMessage,\n  spans,\n  traceId,\n  version,\n  runErrorSpanKey,\n  startTime,\n  endTime,\n  source,\n}: ComputeTreeProps) {\n  tracer.startActiveSpan(\n    `beeai-framework-${source}-${traceId}`,\n    {\n      // custom start time\n      startTime,\n      // set main span important attributes\n      attributes: {\n        traceId,\n        version,\n        ...(prompt && { prompt }),\n        ...(generatedMessage !== undefined && { response: JSON.stringify(generatedMessage) }),\n        ...(history && { history: JSON.stringify(history) }),\n      },\n    },\n    (activeSpan) => {\n      // set status\n      const runErrorSpan = spans.find((span) => span.attributes.target === runErrorSpanKey);\n      if (runErrorSpan) {\n        activeSpan.setStatus(runErrorSpan.status);\n      } else {\n        activeSpan.setStatus({ code: SpanStatusCode.OK });\n      }\n\n      // set nested spans\n      buildSpansForParent({ spans, traceId, parentId: undefined });\n\n      // finish the main span with custom end time\n      activeSpan.end(endTime);\n    },\n  );\n}\n"]}

package/dist/instrumentation/types.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=types.cjs.map
+//# sourceMappingURL=types.cjs.map

package/dist/instrumentation/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.cjs"}

package/dist/instrumentation/types.d.cts

@@ -0,0 +1,39 @@
+import { Attributes, TimeInput, SpanStatus } from '@opentelemetry/api';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+interface FrameworkSpan {
+    attributes: {
+        ctx?: Attributes | null;
+        data?: Attributes | null;
+        target: string;
+    };
+    context: {
+        span_id: string;
+    };
+    end_time: TimeInput;
+    name: string;
+    parent_id?: string;
+    start_time: TimeInput;
+    status: SpanStatus;
+}
+interface GeneratedResponse {
+    text: string;
+    role: string;
+}
+
+export type { FrameworkSpan, GeneratedResponse };

package/dist/instrumentation/types.d.ts

@@ -0,0 +1,39 @@
+import { Attributes, TimeInput, SpanStatus } from '@opentelemetry/api';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+interface FrameworkSpan {
+    attributes: {
+        ctx?: Attributes | null;
+        data?: Attributes | null;
+        target: string;
+    };
+    context: {
+        span_id: string;
+    };
+    end_time: TimeInput;
+    name: string;
+    parent_id?: string;
+    start_time: TimeInput;
+    status: SpanStatus;
+}
+interface GeneratedResponse {
+    text: string;
+    role: string;
+}
+
+export type { FrameworkSpan, GeneratedResponse };

package/dist/instrumentation/types.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=types.js.map
+//# sourceMappingURL=types.js.map

package/dist/instrumentation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.js"}

package/dist/internals/env.cjs

@@ -0,0 +1,43 @@
+'use strict';
+
+var zod = require('zod');
+var errors_cjs = require('../errors.cjs');
+var object_cjs = require('./helpers/object.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function getEnv(key, fallback) {
+  return object_cjs.getProp(process.env, [
+    key
+  ], fallback);
+}
+__name(getEnv, "getEnv");
+function parseEnv(key, schema, defaultValue) {
+  const value = getEnv(key) ?? defaultValue;
+  const result = schema.safeParse(value);
+  if (!result.success) {
+    if (value === void 0) {
+      throw new errors_cjs.FrameworkError(`Required variable '${key}' is not set!`);
+    }
+    throw new errors_cjs.FrameworkError(`Failed to parse ENV variable (${key})!`, [
+      result.error
+    ]);
+  }
+  return result.data;
+}
+__name(parseEnv, "parseEnv");
+parseEnv.asBoolean = (key, fallback = false) => {
+  return parseEnv(key, zod.z.string(), String(fallback)).trim().toLowerCase() === "true";
+};
+function hasEnv(key) {
+  return object_cjs.getProp(process.env, [
+    key
+  ]) !== void 0;
+}
+__name(hasEnv, "hasEnv");
+
+exports.getEnv = getEnv;
+exports.hasEnv = hasEnv;
+exports.parseEnv = parseEnv;
+//# sourceMappingURL=env.cjs.map
+//# sourceMappingURL=env.cjs.map

package/dist/internals/env.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internals/env.ts"],"names":["getEnv","key","fallback","getProp","process","env","parseEnv","schema","defaultValue","value","result","safeParse","success","undefined","FrameworkError","error","data","asBoolean","z","string","String","trim","toLowerCase","hasEnv"],"mappings":";;;;;;;;AAsBO,SAASA,MAAAA,CAAOC,KAAaC,QAAiB,EAAA;AACnD,EAAOC,OAAAA,kBAAAA,CAAQC,QAAQC,GAAK,EAAA;AAACJ,IAAAA;KAAMC,QAAAA,CAAAA;AACrC;AAFgBF,MAAAA,CAAAA,MAAAA,EAAAA,QAAAA,CAAAA;AAIT,SAASM,QAAAA,CACdL,GACAM,EAAAA,MAAAA,EACAC,YAAqB,EAAA;AAErB,EAAMC,MAAAA,KAAAA,GAAQT,MAAOC,CAAAA,GAAAA,CAAQO,IAAAA,YAAAA;AAC7B,EAAME,MAAAA,MAAAA,GAASH,MAAOI,CAAAA,SAAAA,CAAUF,KAAAA,CAAAA;AAChC,EAAI,IAAA,CAACC,OAAOE,OAAS,EAAA;AACnB,IAAA,IAAIH,UAAUI,KAAW,CAAA,EAAA;AACvB,MAAA,MAAM,IAAIC,yBAAAA,CAAe,CAAsBb,mBAAAA,EAAAA,GAAAA,CAAkB,aAAA,CAAA,CAAA;AACnE;AAEA,IAAA,MAAM,IAAIa,yBAAAA,CAAe,CAAiCb,8BAAAA,EAAAA,GAAAA,CAAS,EAAA,CAAA,EAAA;MAACS,MAAOK,CAAAA;AAAM,KAAA,CAAA;AACnF;AACA,EAAA,OAAOL,MAAOM,CAAAA,IAAAA;AAChB;AAfgBV,MAAAA,CAAAA,QAAAA,EAAAA,UAAAA,CAAAA;AAgBhBA,QAAAA,CAASW,SAAY,GAAA,CAAChB,GAAaC,EAAAA,QAAAA,GAAW,KAAK,KAAA;AACjD,EAAA,OAAOI,QAASL,CAAAA,GAAAA,EAAKiB,KAAEC,CAAAA,MAAAA,EAAUC,EAAAA,MAAAA,CAAOlB,QAAAA,CAAAA,CAAWmB,CAAAA,IAAAA,EAAOC,CAAAA,WAAAA,EAAkB,KAAA,MAAA;AAC9E,CAAA;AAEO,SAASC,OAAOtB,GAAW,EAAA;AAChC,EAAOE,OAAAA,kBAAAA,CAAQC,QAAQC,GAAK,EAAA;AAACJ,IAAAA;GAAI,CAAMY,KAAAA,KAAAA,CAAAA;AACzC;AAFgBU,MAAAA,CAAAA,MAAAA,EAAAA,QAAAA,CAAAA","file":"env.cjs","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { z, ZodSchema } from \"zod\";\nimport { FrameworkError } from \"@/errors.js\";\nimport { getProp } from \"@/internals/helpers/object.js\";\n\nexport function getEnv(key: string, fallback?: never): string | undefined;\nexport function getEnv(key: string, fallback: string): string;\nexport function getEnv(key: string, fallback?: string) {\n  return getProp(process.env, [key], fallback);\n}\n\nexport function parseEnv<T extends ZodSchema>(\n  key: string,\n  schema: T,\n  defaultValue?: string,\n): z.output<T> {\n  const value = getEnv(key) ?? defaultValue;\n  const result = schema.safeParse(value);\n  if (!result.success) {\n    if (value === undefined) {\n      throw new FrameworkError(`Required variable '${key}' is not set!`);\n    }\n\n    throw new FrameworkError(`Failed to parse ENV variable (${key})!`, [result.error]);\n  }\n  return result.data;\n}\nparseEnv.asBoolean = (key: string, fallback = false) => {\n  return parseEnv(key, z.string(), String(fallback)).trim().toLowerCase() === \"true\";\n};\n\nexport function hasEnv(key: string) {\n  return getProp(process.env, [key]) !== undefined;\n}\n"]}

package/dist/internals/env.d.cts

@@ -0,0 +1,27 @@
+import { ZodSchema, z } from 'zod';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare function getEnv(key: string, fallback?: never): string | undefined;
+declare function getEnv(key: string, fallback: string): string;
+declare function parseEnv<T extends ZodSchema>(key: string, schema: T, defaultValue?: string): z.output<T>;
+declare namespace parseEnv {
+    var asBoolean: (key: string, fallback?: boolean) => boolean;
+}
+declare function hasEnv(key: string): boolean;
+
+export { getEnv, hasEnv, parseEnv };