@prefactor/core 0.3.1 → 0.3.3

package/dist/client.d.ts

@@ -22,7 +22,7 @@ export type MiddlewareLike = unknown;
 /**
  * Provider integration contract for Prefactor SDK clients.
  */
-export interface PrefactorProvider {
+export interface PrefactorProvider<TMiddleware = MiddlewareLike> {
     /**
      * Creates provider middleware bound to the core runtime services.
      *
@@ -31,11 +31,24 @@ export interface PrefactorProvider {
      * @param config - Resolved SDK configuration.
      * @returns Provider middleware consumed by upstream frameworks.
      */
-    createMiddleware(tracer: Tracer, agentManager: AgentInstanceManager, config: Config): MiddlewareLike;
+    createMiddleware(tracer: Tracer, agentManager: AgentInstanceManager, config: Config): TMiddleware;
     /**
      * Optional provider-level cleanup hook invoked during client shutdown.
      */
     shutdown?: () => void | Promise<void>;
+    /**
+     * Returns the SDK header entry to append to HTTP requests created by the core runtime.
+     *
+     * @returns Adapter-specific SDK identifier, or `undefined` to use the core header only.
+     */
+    getSdkHeaderEntry?: () => string | undefined;
+    /**
+     * Normalizes a user- or provider-authored agent schema before core registers it.
+     *
+     * @param agentSchema - Authored agent schema configuration.
+     * @returns Normalized schema, or `undefined` to leave the input unchanged.
+     */
+    normalizeAgentSchema?: (agentSchema: Record<string, unknown>) => Record<string, unknown> | undefined;
     /**
      * Provides a default agent schema when a user does not supply one.
      *
@@ -43,7 +56,7 @@ export interface PrefactorProvider {
      */
     getDefaultAgentSchema?: () => Record<string, unknown> | undefined;
 }
-export declare class PrefactorClient {
+export declare class PrefactorClient<TMiddleware = MiddlewareLike> {
     private readonly core;
     private readonly middleware;
     private readonly provider;
@@ -54,7 +67,7 @@ export declare class PrefactorClient {
      * @param middleware - Provider middleware returned by the integration.
      * @param provider - Provider used to construct the client.
      */
-    constructor(core: CoreRuntime, middleware: MiddlewareLike, provider: PrefactorProvider);
+    constructor(core: CoreRuntime, middleware: TMiddleware, provider: PrefactorProvider<TMiddleware>);
     /**
      * Returns the runtime tracer used by this client.
      *
@@ -66,7 +79,7 @@ export declare class PrefactorClient {
      *
      * @returns Provider middleware object.
      */
-    getMiddleware(): MiddlewareLike;
+    getMiddleware(): TMiddleware;
     /**
      * Runs a function within a manually-created span.
      *
@@ -87,9 +100,9 @@ export declare class PrefactorClient {
 /**
  * Options for initializing the global Prefactor client.
  */
-export interface PrefactorOptions {
+export interface PrefactorOptions<TMiddleware = MiddlewareLike> {
     /** Provider integration used to create middleware and defaults. */
-    provider: PrefactorProvider;
+    provider: PrefactorProvider<TMiddleware>;
     /** Optional HTTP configuration overrides for the runtime config. */
     httpConfig?: Config['httpConfig'];
 }
@@ -101,11 +114,11 @@ export interface PrefactorOptions {
  * @param options - Initialization options.
  * @returns Global Prefactor client instance.
  */
-export declare function init(options: PrefactorOptions): PrefactorClient;
+export declare function init<TMiddleware = MiddlewareLike>(options: PrefactorOptions<TMiddleware>): PrefactorClient<TMiddleware>;
 /**
  * Returns the currently initialized global Prefactor client, if any.
  *
  * @returns Active global client or `null`.
  */
-export declare function getClient(): PrefactorClient | null;
+export declare function getClient(): PrefactorClient<MiddlewareLike> | null;
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAIlD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;OAOG;IACH,gBAAgB,CACd,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,oBAAoB,EAClC,MAAM,EAAE,MAAM,GACb,cAAc,CAAC;IAClB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CACnE;AAKD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAE7C;;;;;;OAMG;gBACS,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,EAAE,iBAAiB;IAMtF;;;;OAIG;IACH,SAAS,IAAI,MAAM;IAInB;;;;OAIG;IACH,aAAa,IAAI,cAAc;IAI/B;;;;;;OAMG;IACH,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAa7E;;;;;;OAMG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAShC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CA2C/D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,eAAe,GAAG,IAAI,CAElD"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAIlD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,WAAW,GAAG,cAAc;IAC7D;;;;;;;OAOG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;IAClG;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC7C;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,CACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACjC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACzC;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CACnE;AAKD,qBAAa,eAAe,CAAC,WAAW,GAAG,cAAc;IACvD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAE1D;;;;;;OAMG;gBAED,IAAI,EAAE,WAAW,EACjB,UAAU,EAAE,WAAW,EACvB,QAAQ,EAAE,iBAAiB,CAAC,WAAW,CAAC;IAO1C;;;;OAIG;IACH,SAAS,IAAI,MAAM;IAInB;;;;OAIG;IACH,aAAa,IAAI,WAAW;IAI5B;;;;;;OAMG;IACH,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAa7E;;;;;;OAMG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAShC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,WAAW,GAAG,cAAc;IAC5D,mEAAmE;IACnE,QAAQ,EAAE,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACzC,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,WAAW,GAAG,cAAc,EAC/C,OAAO,EAAE,gBAAgB,CAAC,WAAW,CAAC,GACrC,eAAe,CAAC,WAAW,CAAC,CA6D9B;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,eAAe,CAAC,cAAc,CAAC,GAAG,IAAI,CAElE"}

package/dist/client.js

@@ -78,7 +78,8 @@ export class PrefactorClient {
  * @returns Global Prefactor client instance.
  */
 export function init(options) {
-    const nextInitKey = buildInitKey(options);
+    const sdkHeaderEntry = options.provider.getSdkHeaderEntry?.();
+    const nextInitKey = buildInitKey(options, sdkHeaderEntry);
     if (prefactorClient) {
         if (prefactorInitKey !== nextInitKey) {
             throw new Error('Prefactor is already initialized with a different provider or configuration. ' +
@@ -99,7 +100,21 @@ export function init(options) {
             },
         };
     }
-    const core = createCore(finalConfig);
+    if (finalConfig.httpConfig?.agentSchema) {
+        const normalizedSchema = options.provider.normalizeAgentSchema?.(finalConfig.httpConfig.agentSchema);
+        if (normalizedSchema) {
+            finalConfig = {
+                ...finalConfig,
+                httpConfig: {
+                    ...finalConfig.httpConfig,
+                    agentSchema: normalizedSchema,
+                },
+            };
+        }
+    }
+    const core = createCore(finalConfig, {
+        sdkHeaderEntry,
+    });
     const httpConfig = finalConfig.httpConfig;
     if (httpConfig?.agentSchema) {
         core.agentManager.registerSchema(httpConfig.agentSchema);
@@ -117,9 +132,13 @@ export function init(options) {
 export function getClient() {
     return prefactorClient;
 }
-function buildInitKey(options) {
+function buildInitKey(options, sdkHeaderEntry) {
     const providerType = options.provider.constructor?.name ?? 'anonymous-provider';
-    return `${providerType}:${stableStringify(options.httpConfig ?? null)}`;
+    return stableStringify({
+        providerType,
+        httpConfig: options.httpConfig ?? null,
+        sdkHeaderEntry: sdkHeaderEntry ?? null,
+    });
 }
 function stableStringify(value) {
     return JSON.stringify(normalizeValue(value));

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/create-core.d.ts

@@ -9,11 +9,16 @@ export type CoreRuntime = {
     /** Gracefully shuts down the runtime and flushes transport work. */
     shutdown: () => Promise<void>;
 };
+export type CreateCoreOptions = {
+    /** Optional adapter identifier appended ahead of the core SDK header. */
+    sdkHeaderEntry?: string;
+};
 /**
  * Creates a fully initialized core runtime from validated SDK configuration.
  *
  * @param config - Resolved SDK configuration.
+ * @param options - Optional runtime construction options.
  * @returns Runtime containing tracer, agent manager, and shutdown function.
  */
-export declare function createCore(config: Config): CoreRuntime;
+export declare function createCore(config: Config, options?: CreateCoreOptions): CoreRuntime;
 //# sourceMappingURL=create-core.d.ts.map

package/dist/create-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-core.d.ts","sourceRoot":"","sources":["../src/create-core.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAI1C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAG7C,MAAM,MAAM,WAAW,GAAG;IACxB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IAEf,0EAA0E;IAC1E,YAAY,EAAE,oBAAoB,CAAC;IAEnC,oEAAoE;IACpE,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAiCtD"}
+{"version":3,"file":"create-core.d.ts","sourceRoot":"","sources":["../src/create-core.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAI1C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAG7C,MAAM,MAAM,WAAW,GAAG;IACxB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IAEf,0EAA0E;IAC1E,YAAY,EAAE,oBAAoB,CAAC;IAEnC,oEAAoE;IACpE,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,WAAW,CAoCvF"}

package/dist/create-core.js

@@ -9,14 +9,17 @@ import { HttpTransport } from './transport/http.js';
  * Creates a fully initialized core runtime from validated SDK configuration.
  *
  * @param config - Resolved SDK configuration.
+ * @param options - Optional runtime construction options.
  * @returns Runtime containing tracer, agent manager, and shutdown function.
  */
-export function createCore(config) {
+export function createCore(config, options = {}) {
     if (!config.httpConfig) {
         throw new Error('HTTP transport requires httpConfig to be provided in configuration');
     }
     const httpConfig = HttpTransportConfigSchema.parse(config.httpConfig);
-    const transport = new HttpTransport(httpConfig);
+    const transport = options.sdkHeaderEntry === undefined
+        ? new HttpTransport(httpConfig)
+        : new HttpTransport(httpConfig, options.sdkHeaderEntry);
     let partition;
     if (config.httpConfig.agentId) {
         try {

package/dist/create-core.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-core.js","sourceRoot":"","sources":["../src/create-core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAkB,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAapD;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IAED,MAAM,UAAU,GAAG,yBAAyB,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC;IAEhD,IAAI,SAAgC,CAAC;IACrC,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,GAAG,SAAS,CAAC;QACxB,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAChD,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,MAAM,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IACvE,MAAM,YAAY,GAAG,IAAI,oBAAoB,CAAC,SAAS,EAAE;QACvD,uBAAuB;KACxB,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,KAAK,IAAmB,EAAE;QACzC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1B,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,CAAC;IACF,MAAM,OAAO,GAAgB,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC;IAChE,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"create-core.js","sourceRoot":"","sources":["../src/create-core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAkB,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAkBpD;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,UAA6B,EAAE;IACxE,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IAED,MAAM,UAAU,GAAG,yBAAyB,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACtE,MAAM,SAAS,GACb,OAAO,CAAC,cAAc,KAAK,SAAS;QAClC,CAAC,CAAC,IAAI,aAAa,CAAC,UAAU,CAAC;QAC/B,CAAC,CAAC,IAAI,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAE5D,IAAI,SAAgC,CAAC;IACrC,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,GAAG,SAAS,CAAC;QACxB,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAChD,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,MAAM,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IACvE,MAAM,YAAY,GAAG,IAAI,oBAAoB,CAAC,SAAS,EAAE;QACvD,uBAAuB;KACxB,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,KAAK,IAAmB,EAAE;QACzC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1B,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,CAAC;IACF,MAAM,OAAO,GAAgB,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC;IAChE,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.cjs

@@ -33,7 +33,9 @@ __export(exports_src, {
   truncateString: () => truncateString,
   shutdown: () => shutdown,
   serializeValue: () => serializeValue,
+  resolveMappedSpanType: () => resolveMappedSpanType,
   registerShutdownHandler: () => registerShutdownHandler,
+  normalizeAgentToolSchemas: () => normalizeAgentToolSchemas,
   init: () => init,
   getLogger: () => getLogger,
   getClient: () => getClient,
@@ -621,6 +623,32 @@ function calculateRetryDelay(attempt, config, random = Math.random) {
   return Math.round(baseDelay * jitterMultiplier);
 }
 
+// packages/core/src/version.ts
+var PACKAGE_NAME = "@prefactor/core";
+var PACKAGE_VERSION = "0.3.3";
+
+// packages/core/src/transport/http/sdk-request-header.ts
+var DEFAULT_SDK_REQUEST_HEADER = formatSdkHeaderEntry(PACKAGE_NAME, PACKAGE_VERSION);
+function buildSdkRequestHeader(...entries) {
+  const parts = [
+    ...entries.filter((entry) => Boolean(entry)).map((entry) => normalizeSdkHeaderEntry(entry)),
+    DEFAULT_SDK_REQUEST_HEADER
+  ];
+  return Array.from(new Set(parts)).join(" ");
+}
+function normalizeSdkHeaderEntry(entry) {
+  const atIndex = entry.lastIndexOf("@");
+  if (atIndex <= 0) {
+    return entry;
+  }
+  const packageName = entry.slice(0, atIndex);
+  const version = entry.slice(atIndex + 1);
+  return version ? `${packageName}@${version}` : packageName;
+}
+function formatSdkHeaderEntry(packageName, version) {
+  return `${packageName}@${version}`;
+}
+
 // packages/core/src/transport/http/http-client.ts
 class HttpClientError extends Error {
   url;
@@ -646,11 +674,13 @@ class HttpClient {
   fetchFn;
   sleep;
   random;
-  constructor(config, dependencies = {}) {
+  sdkHeader;
+  constructor(config, dependencies = {}, sdkHeaderEntry) {
     this.config = config;
     this.fetchFn = dependencies.fetchFn ?? fetch;
     this.sleep = dependencies.sleep ?? ((delayMs) => new Promise((resolve) => setTimeout(resolve, delayMs)));
     this.random = dependencies.random ?? Math.random;
+    this.sdkHeader = sdkHeaderEntry ? buildSdkRequestHeader(sdkHeaderEntry) : DEFAULT_SDK_REQUEST_HEADER;
   }
   async request(path, options = {}) {
     const url = new URL(path, this.config.apiUrl).toString();
@@ -659,6 +689,7 @@ class HttpClient {
     while (true) {
       const headers = new Headers(options.headers);
       headers.set("Authorization", `Bearer ${this.config.apiToken}`);
+      headers.set("X-Prefactor-SDK", this.sdkHeader);
       if (options.body !== undefined && !headers.has("Content-Type")) {
         headers.set("Content-Type", "application/json");
       }
@@ -798,9 +829,9 @@ class HttpTransport {
   spanIdMap = new Map;
   pendingFinishes = new Map;
   pendingChildren = new Map;
-  constructor(config) {
+  constructor(config, sdkHeaderEntry) {
     this.config = config;
-    const httpClient = new HttpClient(config);
+    const httpClient = sdkHeaderEntry === undefined ? new HttpClient(config) : new HttpClient(config, {}, sdkHeaderEntry);
     this.agentInstanceClient = new AgentInstanceClient(httpClient);
     this.agentSpanClient = new AgentSpanClient(httpClient);
     this.taskExecutor = new TaskExecutor(this.actionQueue, this.processAction, {
@@ -1086,12 +1117,12 @@ class HttpTransport {
 }
 
 // packages/core/src/create-core.ts
-function createCore(config) {
+function createCore(config, options = {}) {
   if (!config.httpConfig) {
     throw new Error("HTTP transport requires httpConfig to be provided in configuration");
   }
   const httpConfig = HttpTransportConfigSchema.parse(config.httpConfig);
-  const transport = new HttpTransport(httpConfig);
+  const transport = options.sdkHeaderEntry === undefined ? new HttpTransport(httpConfig) : new HttpTransport(httpConfig, options.sdkHeaderEntry);
   let partition;
   if (config.httpConfig.agentId) {
     try {
@@ -1203,7 +1234,8 @@ class PrefactorClient {
   }
 }
 function init(options) {
-  const nextInitKey = buildInitKey(options);
+  const sdkHeaderEntry = options.provider.getSdkHeaderEntry?.();
+  const nextInitKey = buildInitKey(options, sdkHeaderEntry);
   if (prefactorClient) {
     if (prefactorInitKey !== nextInitKey) {
       throw new Error("Prefactor is already initialized with a different provider or configuration. " + "Call shutdown() before re-initializing with different options.");
@@ -1223,7 +1255,21 @@ function init(options) {
       }
     };
   }
-  const core = createCore(finalConfig);
+  if (finalConfig.httpConfig?.agentSchema) {
+    const normalizedSchema = options.provider.normalizeAgentSchema?.(finalConfig.httpConfig.agentSchema);
+    if (normalizedSchema) {
+      finalConfig = {
+        ...finalConfig,
+        httpConfig: {
+          ...finalConfig.httpConfig,
+          agentSchema: normalizedSchema
+        }
+      };
+    }
+  }
+  const core = createCore(finalConfig, {
+    sdkHeaderEntry
+  });
   const httpConfig = finalConfig.httpConfig;
   if (httpConfig?.agentSchema) {
     core.agentManager.registerSchema(httpConfig.agentSchema);
@@ -1236,9 +1282,13 @@ function init(options) {
 function getClient() {
   return prefactorClient;
 }
-function buildInitKey(options) {
+function buildInitKey(options, sdkHeaderEntry) {
   const providerType = options.provider.constructor?.name ?? "anonymous-provider";
-  return `${providerType}:${stableStringify2(options.httpConfig ?? null)}`;
+  return stableStringify2({
+    providerType,
+    httpConfig: options.httpConfig ?? null,
+    sdkHeaderEntry: sdkHeaderEntry ?? null
+  });
 }
 function stableStringify2(value) {
   return JSON.stringify(normalizeValue2(value));
@@ -1258,6 +1308,160 @@ function normalizeValue2(value) {
   }
   return value;
 }
+// packages/core/src/tool-schema.ts
+var logger2 = getLogger("tool-schema");
+function normalizeAgentToolSchemas(agentSchema, {
+  defaultAgentSchema,
+  providerName
+}) {
+  const toolSchemas = extractToolSchemas(agentSchema, providerName);
+  return {
+    agentSchema: mergeWithDefaultAgentSchema(stripToolSchemas(agentSchema), defaultAgentSchema),
+    toolSchemas,
+    toolSpanTypes: buildToolSpanTypes(toolSchemas)
+  };
+}
+function resolveMappedSpanType(toolName, toolSpanTypes, defaultSpanType) {
+  return toolSpanTypes?.[toolName] ?? defaultSpanType;
+}
+function extractToolSchemas(agentSchema, providerName) {
+  const rawToolSchemas = getRawToolSchemas(agentSchema);
+  if (!rawToolSchemas) {
+    return;
+  }
+  const toolSchemas = {};
+  const toolBySpanType = new Map;
+  for (const [toolName, rawConfig] of Object.entries(rawToolSchemas)) {
+    const parsedToolSchema = parseToolSchemaConfig(toolName, rawConfig, providerName, toolBySpanType);
+    if (!parsedToolSchema) {
+      continue;
+    }
+    toolSchemas[toolName] = parsedToolSchema;
+  }
+  return Object.keys(toolSchemas).length > 0 ? toolSchemas : undefined;
+}
+function getRawToolSchemas(agentSchema) {
+  if (!agentSchema || typeof agentSchema !== "object" || Array.isArray(agentSchema)) {
+    return;
+  }
+  const rawToolSchemas = agentSchema.toolSchemas;
+  if (rawToolSchemas === undefined) {
+    return;
+  }
+  if (!rawToolSchemas || typeof rawToolSchemas !== "object" || Array.isArray(rawToolSchemas)) {
+    logger2.warn("Ignoring invalid agentSchema.toolSchemas: expected an object keyed by tool name.");
+    return;
+  }
+  return rawToolSchemas;
+}
+function parseToolSchemaConfig(toolName, rawConfig, providerName, toolBySpanType) {
+  if (!rawConfig || typeof rawConfig !== "object" || Array.isArray(rawConfig)) {
+    logger2.warn(`Invalid agentSchema.toolSchemas.${toolName}: expected an object with spanType and inputSchema.`);
+    return;
+  }
+  const config = rawConfig;
+  if (typeof config.spanType !== "string") {
+    logger2.warn(`Invalid agentSchema.toolSchemas.${toolName}.spanType: expected a non-empty string.`);
+    return;
+  }
+  const inputSchema = assertValidInputSchema(toolName, config.inputSchema);
+  if (!inputSchema) {
+    return;
+  }
+  const normalizedSpanType = normalizeUniqueToolSpanType(toolName, config.spanType, providerName, toolBySpanType);
+  if (!normalizedSpanType) {
+    return;
+  }
+  return {
+    spanType: normalizedSpanType,
+    inputSchema
+  };
+}
+function assertValidInputSchema(toolName, inputSchema) {
+  if (!inputSchema || typeof inputSchema !== "object" || Array.isArray(inputSchema)) {
+    logger2.warn(`Invalid agentSchema.toolSchemas.${toolName}.inputSchema: expected an object.`);
+    return;
+  }
+  return inputSchema;
+}
+function normalizeUniqueToolSpanType(toolName, spanType, providerName, toolBySpanType) {
+  const normalizedSpanType = normalizeToolSpanType(spanType, toolName, providerName);
+  if (!normalizedSpanType) {
+    return;
+  }
+  const conflictingTool = toolBySpanType.get(normalizedSpanType);
+  if (conflictingTool && conflictingTool !== toolName) {
+    logger2.warn(`Invalid agentSchema.toolSchemas.${toolName}.spanType: normalized span type "${normalizedSpanType}" conflicts with "${conflictingTool}".`);
+    return;
+  }
+  toolBySpanType.set(normalizedSpanType, toolName);
+  return normalizedSpanType;
+}
+function buildToolSpanTypes(toolSchemas) {
+  if (!toolSchemas) {
+    return;
+  }
+  return Object.fromEntries(Object.entries(toolSchemas).map(([toolName, config]) => [toolName, config.spanType]));
+}
+function cloneRecord(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return {};
+  }
+  return { ...value };
+}
+function stripToolSchemas(baseSchema) {
+  if (!baseSchema || typeof baseSchema !== "object" || Array.isArray(baseSchema)) {
+    return baseSchema;
+  }
+  const { toolSchemas: _, ...rest } = baseSchema;
+  return rest;
+}
+function mergeWithDefaultAgentSchema(baseSchema, defaultAgentSchema) {
+  if (!baseSchema) {
+    return defaultAgentSchema;
+  }
+  return {
+    ...defaultAgentSchema,
+    ...baseSchema,
+    span_schemas: {
+      ...cloneRecord(defaultAgentSchema.span_schemas),
+      ...cloneRecord(baseSchema.span_schemas)
+    },
+    span_result_schemas: {
+      ...cloneRecord(defaultAgentSchema.span_result_schemas),
+      ...cloneRecord(baseSchema.span_result_schemas)
+    }
+  };
+}
+function normalizeToolSpanType(spanType, toolName, providerName) {
+  const trimmedSpanType = spanType.trim();
+  if (trimmedSpanType.length === 0) {
+    logger2.warn(`Invalid agentSchema.toolSchemas.${toolName}.spanType: expected a non-empty string.`);
+    return;
+  }
+  const providerToolPrefix = `${providerName}:tool:`;
+  if (trimmedSpanType.startsWith(providerToolPrefix)) {
+    const suffix2 = trimmedSpanType.slice(providerToolPrefix.length).replace(/^:+/, "");
+    if (suffix2.length === 0) {
+      logger2.warn(`Invalid agentSchema.toolSchemas.${toolName}.spanType: expected a non-empty suffix after normalization.`);
+      return;
+    }
+    return `${providerName}:tool:${suffix2}`;
+  }
+  let suffix = trimmedSpanType;
+  if (suffix.startsWith(`${providerName}:`)) {
+    suffix = suffix.slice(`${providerName}:`.length);
+  }
+  if (suffix.startsWith("tool:")) {
+    suffix = suffix.slice("tool:".length);
+  }
+  suffix = suffix.replace(/^:+/, "");
+  if (suffix.length === 0) {
+    logger2.warn(`Invalid agentSchema.toolSchemas.${toolName}.spanType: expected a non-empty suffix after normalization.`);
+    return;
+  }
+  return `${providerName}:tool:${suffix}`;
+}
 // packages/core/src/utils/serialization.ts
 function truncateString(value, maxLength) {
   if (value.length <= maxLength) {
@@ -1292,4 +1496,4 @@ function serializeValue(value, maxLength = 1e4) {
   }
 }
 
-//# debugId=4C0DC6DB86519AD564756E2164756E21
+//# debugId=3EC702ECBCC3224764756E2164756E21