@axlsdk/axl 0.25.2 → 0.26.0

package/dist/{span-manager-L4H6ZCRQ.js → span-manager-I4JFIB5F.js}

@@ -3,8 +3,8 @@ const require = __axlCreateRequire(import.meta.url);
 const __AXL_BUILD_PATH__ = import.meta.url;
 import {
   OTelSpanManager
-} from "./chunk-PJROX3XU.js";
+} from "./chunk-SBQL47BB.js";
 export {
   OTelSpanManager
 };
-//# sourceMappingURL=span-manager-L4H6ZCRQ.js.map
+//# sourceMappingURL=span-manager-I4JFIB5F.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axlsdk/axl",
-  "version": "0.25.2",
+  "version": "0.26.0",
   "description": "TypeScript SDK for orchestrating Agentic Systems",
   "type": "module",
   "sideEffects": false,
@@ -50,7 +50,7 @@
     "tsup": "^8.3.0",
     "typescript": "^5.7.0",
     "vitest": "^3.0.0",
-    "@axlsdk/eval": "0.25.2"
+    "@axlsdk/eval": "0.26.0"
   },
   "keywords": [
     "ai",

package/dist/chunk-PJROX3XU.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/telemetry/span-manager.ts"],"sourcesContent":["import type { SpanHandle, SpanManager, TelemetryConfig } from './types.js';\n\n/** Minimal interface for an OTel span. */\ninterface OTelSpan {\n  setAttribute(key: string, value: string | number | boolean): void;\n  addEvent(name: string, attributes?: Record<string, string | number | boolean>): void;\n  setStatus(status: { code: unknown; message?: string }): void;\n  end(): void;\n}\n\n/** Minimal interface for an OTel tracer. */\ninterface OTelTracer {\n  startActiveSpan<T>(\n    name: string,\n    options: { attributes: Record<string, string | number | boolean> },\n    fn: (span: OTelSpan) => Promise<T>,\n  ): Promise<T>;\n}\n\n/** Minimal interface for an OTel tracer provider. */\ninterface OTelTracerProvider {\n  getTracer(name: string): OTelTracer;\n  shutdown?(): Promise<void>;\n}\n\n/** Minimal interface for the @opentelemetry/api module. */\ninterface OTelApi {\n  SpanStatusCode: { UNSET: unknown; OK: unknown; ERROR: unknown };\n  trace: {\n    getTracerProvider(): OTelTracerProvider;\n    getActiveSpan?(): OTelSpan | undefined;\n  };\n}\n\n/**\n * OpenTelemetry-backed SpanManager.\n * Dynamically imports @opentelemetry/api to avoid hard dependency.\n */\nexport class OTelSpanManager implements SpanManager {\n  private tracer: OTelTracer;\n  private otelApi: OTelApi;\n  private tracerProvider: OTelTracerProvider;\n\n  private constructor(otelApi: OTelApi, tracer: OTelTracer, tracerProvider: OTelTracerProvider) {\n    this.otelApi = otelApi;\n    this.tracer = tracer;\n    this.tracerProvider = tracerProvider;\n  }\n\n  static async create(config: TelemetryConfig): Promise<OTelSpanManager> {\n    let otelApi: OTelApi;\n    try {\n      otelApi = (await import('@opentelemetry/api')) as unknown as OTelApi;\n    } catch {\n      throw new Error(\n        '@opentelemetry/api is required for telemetry. Install it with: npm install @opentelemetry/api',\n      );\n    }\n\n    const tracerProvider =\n      (config.tracerProvider as OTelTracerProvider | undefined) ??\n      otelApi.trace.getTracerProvider();\n    const serviceName = config.serviceName ?? 'axl';\n    const tracer = tracerProvider.getTracer(serviceName);\n\n    return new OTelSpanManager(otelApi, tracer, tracerProvider);\n  }\n\n  async withSpanAsync<T>(\n    name: string,\n    attributes: Record<string, string | number | boolean>,\n    fn: (span: SpanHandle) => Promise<T>,\n  ): Promise<T> {\n    const otelApi = this.otelApi;\n\n    return this.tracer.startActiveSpan(name, { attributes }, async (otelSpan: OTelSpan) => {\n      let statusWasSet = false;\n      const handle: SpanHandle = {\n        setAttribute(key: string, value: string | number | boolean) {\n          otelSpan.setAttribute(key, value);\n        },\n        addEvent(eventName: string, attrs?: Record<string, string | number | boolean>) {\n          otelSpan.addEvent(eventName, attrs);\n        },\n        setStatus(code: 'unset' | 'ok' | 'error', message?: string) {\n          statusWasSet = true;\n          const statusCode =\n            code === 'ok'\n              ? otelApi.SpanStatusCode.OK\n              : code === 'error'\n                ? otelApi.SpanStatusCode.ERROR\n                : otelApi.SpanStatusCode.UNSET;\n          otelSpan.setStatus({ code: statusCode, message });\n        },\n        end() {\n          otelSpan.end();\n        },\n      };\n\n      try {\n        const result = await fn(handle);\n        if (!statusWasSet) handle.setStatus('ok');\n        return result;\n      } catch (err) {\n        // Error text can contain provider, prompt, or sensitive tool data.\n        // Keep exported status structural; host diagnostics remain in Axl's\n        // own error and redacted event channels.\n        handle.setStatus('error');\n        throw err;\n      } finally {\n        handle.end();\n      }\n    });\n  }\n\n  addEventToActiveSpan(name: string, attributes?: Record<string, string | number | boolean>): void {\n    const activeSpan = this.otelApi.trace.getActiveSpan?.();\n    if (activeSpan) {\n      activeSpan.addEvent(name, attributes);\n    }\n  }\n\n  async shutdown(): Promise<void> {\n    if (this.tracerProvider && typeof this.tracerProvider.shutdown === 'function') {\n      await this.tracerProvider.shutdown();\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;AAsCO,IAAM,kBAAN,MAAM,iBAAuC;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,SAAkB,QAAoB,gBAAoC;AAC5F,SAAK,UAAU;AACf,SAAK,SAAS;AACd,SAAK,iBAAiB;AAAA,EACxB;AAAA,EAEA,aAAa,OAAO,QAAmD;AACrE,QAAI;AACJ,QAAI;AACF,gBAAW,MAAM,OAAO,oBAAoB;AAAA,IAC9C,QAAQ;AACN,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAEA,UAAM,iBACH,OAAO,kBACR,QAAQ,MAAM,kBAAkB;AAClC,UAAM,cAAc,OAAO,eAAe;AAC1C,UAAM,SAAS,eAAe,UAAU,WAAW;AAEnD,WAAO,IAAI,iBAAgB,SAAS,QAAQ,cAAc;AAAA,EAC5D;AAAA,EAEA,MAAM,cACJ,MACA,YACA,IACY;AACZ,UAAM,UAAU,KAAK;AAErB,WAAO,KAAK,OAAO,gBAAgB,MAAM,EAAE,WAAW,GAAG,OAAO,aAAuB;AACrF,UAAI,eAAe;AACnB,YAAM,SAAqB;AAAA,QACzB,aAAa,KAAa,OAAkC;AAC1D,mBAAS,aAAa,KAAK,KAAK;AAAA,QAClC;AAAA,QACA,SAAS,WAAmB,OAAmD;AAC7E,mBAAS,SAAS,WAAW,KAAK;AAAA,QACpC;AAAA,QACA,UAAU,MAAgC,SAAkB;AAC1D,yBAAe;AACf,gBAAM,aACJ,SAAS,OACL,QAAQ,eAAe,KACvB,SAAS,UACP,QAAQ,eAAe,QACvB,QAAQ,eAAe;AAC/B,mBAAS,UAAU,EAAE,MAAM,YAAY,QAAQ,CAAC;AAAA,QAClD;AAAA,QACA,MAAM;AACJ,mBAAS,IAAI;AAAA,QACf;AAAA,MACF;AAEA,UAAI;AACF,cAAM,SAAS,MAAM,GAAG,MAAM;AAC9B,YAAI,CAAC,aAAc,QAAO,UAAU,IAAI;AACxC,eAAO;AAAA,MACT,SAAS,KAAK;AAIZ,eAAO,UAAU,OAAO;AACxB,cAAM;AAAA,MACR,UAAE;AACA,eAAO,IAAI;AAAA,MACb;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,qBAAqB,MAAc,YAA8D;AAC/F,UAAM,aAAa,KAAK,QAAQ,MAAM,gBAAgB;AACtD,QAAI,YAAY;AACd,iBAAW,SAAS,MAAM,UAAU;AAAA,IACtC;AAAA,EACF;AAAA,EAEA,MAAM,WAA0B;AAC9B,QAAI,KAAK,kBAAkB,OAAO,KAAK,eAAe,aAAa,YAAY;AAC7E,YAAM,KAAK,eAAe,SAAS;AAAA,IACrC;AAAA,EACF;AACF;","names":[]}