@prefactor/core 0.2.0 → 0.2.1

package/dist/transport/http/http-client.js.map

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

package/dist/transport/http/retry-policy.d.ts

@@ -0,0 +1,4 @@
+import type { HttpTransportConfig } from '../../config.js';
+export declare function shouldRetryStatusCode(statusCode: number, retryOnStatusCodes: number[]): boolean;
+export declare function calculateRetryDelay(attempt: number, config: Pick<HttpTransportConfig, 'initialRetryDelay' | 'maxRetryDelay' | 'retryMultiplier'>, random?: () => number): number;
+//# sourceMappingURL=retry-policy.d.ts.map

package/dist/transport/http/retry-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-policy.d.ts","sourceRoot":"","sources":["../../../src/transport/http/retry-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAI3D,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,GAAG,OAAO,CAE/F;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,mBAAmB,GAAG,eAAe,GAAG,iBAAiB,CAAC,EAC5F,MAAM,GAAE,MAAM,MAAoB,GACjC,MAAM,CAOR"}

package/dist/transport/http/retry-policy.js

@@ -0,0 +1,10 @@
+const JITTER_MIN = 0.5;
+export function shouldRetryStatusCode(statusCode, retryOnStatusCodes) {
+    return retryOnStatusCodes.includes(statusCode);
+}
+export function calculateRetryDelay(attempt, config, random = Math.random) {
+    const baseDelay = Math.min(config.initialRetryDelay * config.retryMultiplier ** attempt, config.maxRetryDelay);
+    const jitterMultiplier = JITTER_MIN + random() * JITTER_MIN;
+    return Math.round(baseDelay * jitterMultiplier);
+}
+//# sourceMappingURL=retry-policy.js.map

package/dist/transport/http/retry-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-policy.js","sourceRoot":"","sources":["../../../src/transport/http/retry-policy.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB,MAAM,UAAU,qBAAqB,CAAC,UAAkB,EAAE,kBAA4B;IACpF,OAAO,kBAAkB,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,MAA4F,EAC5F,SAAuB,IAAI,CAAC,MAAM;IAElC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CACxB,MAAM,CAAC,iBAAiB,GAAG,MAAM,CAAC,eAAe,IAAI,OAAO,EAC5D,MAAM,CAAC,aAAa,CACrB,CAAC;IACF,MAAM,gBAAgB,GAAG,UAAU,GAAG,MAAM,EAAE,GAAG,UAAU,CAAC;IAC5D,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,gBAAgB,CAAC,CAAC;AAClD,CAAC"}

package/dist/transport/http.d.ts

@@ -1,67 +1,48 @@
 import type { HttpTransportConfig } from '../config.js';
-import type { QueueAction } from '../queue/actions.js';
-import type { Transport } from './base.js';
-/**
- * HTTP transport sends spans to a remote API endpoint.
- *
- * Features:
- * - Exponential backoff retry logic
- * - Span ID mapping (SDK ID → backend ID)
- * - Agent instance lifecycle management
- *
- * @example
- * ```typescript
- * const transport = new HttpTransport({
- *   apiUrl: 'https://api.prefactor.ai',
- *   apiToken: process.env.PREFACTOR_API_TOKEN!,
- * });
- * ```
- */
+import type { Span } from '../tracing/span.js';
+export type AgentInstanceOptions = {
+    agentId?: string;
+    agentIdentifier?: string;
+    agentName?: string;
+    agentDescription?: string;
+};
+export interface Transport {
+    emit(span: Span): void;
+    finishSpan(spanId: string, endTime: number): void;
+    startAgentInstance(options?: AgentInstanceOptions): void;
+    finishAgentInstance(): void;
+    registerSchema(schema: Record<string, unknown>): void;
+    close(): void | Promise<void>;
+}
 export declare class HttpTransport implements Transport {
     private config;
     private closed;
+    private readonly actionQueue;
+    private readonly taskExecutor;
+    private readonly agentInstanceClient;
+    private readonly agentSpanClient;
+    private previousAgentSchema;
+    private requiresNewAgentIdentifier;
+    private previousAgentIdentifier;
     private agentInstanceId;
     private spanIdMap;
     private pendingFinishes;
     constructor(config: HttpTransportConfig);
-    processBatch(items: QueueAction[]): Promise<void>;
-    /**
-     * Process any pending finishes for a span that was just registered.
-     */
+    registerSchema(schema: Record<string, unknown>): void;
+    startAgentInstance(options?: AgentInstanceOptions): void;
+    finishAgentInstance(): void;
+    emit(span: Span): void;
+    finishSpan(spanId: string, endTime: number): void;
+    close(): Promise<void>;
+    private enqueue;
+    private processAction;
     private processPendingFinishes;
-    /**
-     * Send a span to the API
-     */
     private sendSpan;
-    /**
-     * Transform span to backend API format with nested details/payload structure
-     */
     private transformSpanToApiFormat;
-    /**
-     * Get default schema (v1.0.0) with span schemas for all supported types
-     */
-    private getDefaultSchema;
-    /**
-     * Ensure an agent instance is registered
-     */
+    private mapStatusForApi;
     private ensureAgentRegistered;
-    /**
-     * Start agent instance execution
-     */
     private startAgentInstanceHttp;
-    /**
-     * Finish agent instance execution
-     */
     private finishAgentInstanceHttp;
-    /**
-     * Finish a span via HTTP
-     */
     private finishSpanHttp;
-    /**
-     * Close the transport and wait for queue to drain
-     *
-     * @returns Promise that resolves when transport is closed
-     */
-    close(): Promise<void>;
 }
 //# sourceMappingURL=http.d.ts.map

package/dist/transport/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/transport/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAI3C;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAc,YAAW,SAAS;IAOjC,OAAO,CAAC,MAAM;IAN1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,SAAS,CAA6B;IAE9C,OAAO,CAAC,eAAe,CAA6B;gBAEhC,MAAM,EAAE,mBAAmB;IAEzC,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA0DvD;;OAEG;YACW,sBAAsB;IAepC;;OAEG;YACW,QAAQ;IAqDtB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAmDhC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;YACW,qBAAqB;IA4DnC;;OAEG;YACW,sBAAsB;IA6BpC;;OAEG;YACW,uBAAuB;IA8BrC;;OAEG;YACW,cAAc;IA4B5B;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAW7B"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/transport/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAIxD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAU/C,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAEvB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAElD,kBAAkB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAEzD,mBAAmB,IAAI,IAAI,CAAC;IAE5B,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEtD,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAID,qBAAa,aAAc,YAAW,SAAS;IAajC,OAAO,CAAC,MAAM;IAZ1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwC;IACpE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgC;IAC7D,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,0BAA0B,CAAS;IAC3C,OAAO,CAAC,uBAAuB,CAAuB;IACtD,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,eAAe,CAA6B;gBAEhC,MAAM,EAAE,mBAAmB;IAa/C,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIrD,kBAAkB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,IAAI;IAIxD,mBAAmB,IAAI,IAAI;IAI3B,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAItB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,aAAa,CA6DnB;YAEY,sBAAsB;YAmBtB,QAAQ;IAiBtB,OAAO,CAAC,wBAAwB;IAgDhC,OAAO,CAAC,eAAe;YAaT,qBAAqB;YA8BrB,sBAAsB;YActB,uBAAuB;YAevB,cAAc;CAa7B"}

package/dist/transport/http.js

@@ -1,95 +1,132 @@
-import { DEFAULT_AGENT_SCHEMA } from '../tracing/span.js';
+import { InMemoryQueue } from '../queue/in-memory-queue.js';
+import { TaskExecutor } from '../queue/task-executor.js';
 import { getLogger } from '../utils/logging.js';
+import { AgentInstanceClient } from './http/agent-instance-client.js';
+import { AgentSpanClient, } from './http/agent-span-client.js';
+import { HttpClient } from './http/http-client.js';
 const logger = getLogger('http-transport');
-/**
- * HTTP transport sends spans to a remote API endpoint.
- *
- * Features:
- * - Exponential backoff retry logic
- * - Span ID mapping (SDK ID → backend ID)
- * - Agent instance lifecycle management
- *
- * @example
- * ```typescript
- * const transport = new HttpTransport({
- *   apiUrl: 'https://api.prefactor.ai',
- *   apiToken: process.env.PREFACTOR_API_TOKEN!,
- * });
- * ```
- */
 export class HttpTransport {
     config;
     closed = false;
+    actionQueue = new InMemoryQueue();
+    taskExecutor;
+    agentInstanceClient;
+    agentSpanClient;
+    previousAgentSchema = null;
+    requiresNewAgentIdentifier = false;
+    previousAgentIdentifier = null;
     agentInstanceId = null;
     spanIdMap = new Map();
-    // Pending finishes for spans that arrived before their span_end
     pendingFinishes = new Map();
     constructor(config) {
         this.config = config;
+        const httpClient = new HttpClient(config);
+        this.agentInstanceClient = new AgentInstanceClient(httpClient);
+        this.agentSpanClient = new AgentSpanClient(httpClient);
+        this.taskExecutor = new TaskExecutor(this.actionQueue, this.processAction, {
+            workerCount: 1,
+            onError: async (error) => {
+                logger.error('Error processing HTTP action:', error);
+            },
+        });
+        this.taskExecutor.start();
+    }
+    registerSchema(schema) {
+        this.enqueue({ type: 'schema_register', schema });
+    }
+    startAgentInstance(options) {
+        this.enqueue({ type: 'agent_start', options });
+    }
+    finishAgentInstance() {
+        this.enqueue({ type: 'agent_finish' });
+    }
+    emit(span) {
+        this.enqueue({ type: 'span_end', span });
+    }
+    finishSpan(spanId, endTime) {
+        this.enqueue({ type: 'span_finish', spanId, endTime });
+    }
+    async close() {
+        this.closed = true;
+        await this.taskExecutor.stop();
+        if (this.pendingFinishes.size > 0) {
+            logger.warn(`Transport closed with ${this.pendingFinishes.size} pending span finish(es) that could not be processed`);
+            this.pendingFinishes.clear();
+        }
     }
-    async processBatch(items) {
-        if (this.closed || items.length === 0) {
+    enqueue(action) {
+        if (this.closed) {
             return;
         }
-        // First pass: apply schema updates
-        for (const item of items) {
-            if (item.type === 'schema_register') {
-                this.config.agentSchema = item.data.schema;
-                this.config.agentSchemaIdentifier = item.data.schemaIdentifier;
-                this.config.schemaName = item.data.schemaName;
-                this.config.schemaIdentifier = item.data.schemaIdentifier;
+        this.actionQueue.put(action).catch((error) => {
+            logger.error('Failed to enqueue HTTP action:', error);
+        });
+    }
+    processAction = async (action) => {
+        switch (action.type) {
+            case 'schema_register': {
+                const incomingSchema = JSON.stringify(action.schema);
+                if (this.previousAgentSchema !== null && this.previousAgentSchema !== incomingSchema) {
+                    this.requiresNewAgentIdentifier = true;
+                    this.previousAgentIdentifier = this.config.agentIdentifier;
+                    this.agentInstanceId = null;
+                }
+                this.previousAgentSchema = incomingSchema;
+                this.config.agentSchema = action.schema;
+                return;
             }
-        }
-        // Second pass: process actions
-        for (const item of items) {
-            try {
-                switch (item.type) {
-                    case 'schema_register':
-                        break;
-                    case 'agent_start':
-                        this.config.agentId = item.data.agentId;
-                        if (item.data.agentIdentifier !== undefined)
-                            this.config.agentIdentifier = item.data.agentIdentifier;
-                        this.config.agentName = item.data.agentName;
-                        this.config.agentDescription = item.data.agentDescription;
-                        await this.startAgentInstanceHttp();
-                        break;
-                    case 'agent_finish':
-                        await this.finishAgentInstanceHttp();
-                        break;
-                    case 'span_end':
-                        if (!this.agentInstanceId) {
-                            await this.ensureAgentRegistered();
-                        }
-                        await this.sendSpan(item.data);
-                        break;
-                    case 'span_finish': {
-                        const spanId = item.data.spanId;
-                        const backendSpanId = this.spanIdMap.get(spanId);
-                        if (backendSpanId) {
-                            // Span mapping exists, finish immediately
-                            const timestamp = new Date(item.data.endTime).toISOString();
-                            await this.finishSpanHttp({ spanId, timestamp });
-                        }
-                        else {
-                            // Defer finish until span_end creates the mapping
-                            this.pendingFinishes.set(spanId, item.data.endTime);
-                        }
-                        break;
+            case 'agent_start': {
+                if (this.requiresNewAgentIdentifier) {
+                    const nextAgentIdentifier = action.options?.agentIdentifier;
+                    if (nextAgentIdentifier === undefined ||
+                        nextAgentIdentifier === this.previousAgentIdentifier) {
+                        logger.error('Schema changed; starting an agent requires a new agentIdentifier value.');
+                        return;
                     }
+                    this.requiresNewAgentIdentifier = false;
+                    this.previousAgentIdentifier = null;
+                }
+                if (action.options?.agentId !== undefined)
+                    this.config.agentId = action.options.agentId;
+                if (action.options?.agentIdentifier !== undefined) {
+                    this.config.agentIdentifier = action.options.agentIdentifier;
                 }
+                if (action.options?.agentName !== undefined)
+                    this.config.agentName = action.options.agentName;
+                if (action.options?.agentDescription !== undefined) {
+                    this.config.agentDescription = action.options.agentDescription;
+                }
+                await this.startAgentInstanceHttp();
+                return;
             }
-            catch (error) {
-                logger.error('Error processing batch item:', error);
+            case 'agent_finish':
+                await this.finishAgentInstanceHttp();
+                return;
+            case 'span_end':
+                if (!this.agentInstanceId) {
+                    await this.ensureAgentRegistered();
+                }
+                await this.sendSpan(action.span);
+                return;
+            case 'span_finish': {
+                const backendSpanId = this.spanIdMap.get(action.spanId);
+                if (backendSpanId) {
+                    const timestamp = new Date(action.endTime).toISOString();
+                    await this.finishSpanHttp({ spanId: action.spanId, timestamp });
+                }
+                else {
+                    this.pendingFinishes.set(action.spanId, action.endTime);
+                }
+                return;
             }
         }
-    }
-    /**
-     * Process any pending finishes for a span that was just registered.
-     */
+    };
     async processPendingFinishes(spanId) {
+        if (!this.pendingFinishes.has(spanId)) {
+            return;
+        }
         const pendingEndTime = this.pendingFinishes.get(spanId);
-        if (!pendingEndTime) {
+        if (pendingEndTime === undefined) {
             return;
         }
         try {
@@ -101,71 +138,36 @@ export class HttpTransport {
             logger.error('Error processing pending span finish:', error);
         }
     }
-    /**
-     * Send a span to the API
-     */
-    async sendSpan(span, retry = 0) {
-        const url = `${this.config.apiUrl}/api/v1/agent_spans`;
+    async sendSpan(span) {
         const payload = this.transformSpanToApiFormat(span);
         try {
-            const response = await fetch(url, {
-                method: 'POST',
-                headers: {
-                    Authorization: `Bearer ${this.config.apiToken}`,
-                    'Content-Type': 'application/json',
-                },
-                body: JSON.stringify(payload),
-                signal: AbortSignal.timeout(this.config.requestTimeout),
-            });
-            if (response.ok) {
-                const data = (await response.json());
-                const backendSpanId = data?.details?.id;
-                if (backendSpanId) {
-                    this.spanIdMap.set(span.spanId, backendSpanId);
-                    // Process any pending finishes that arrived before this span_end
-                    await this.processPendingFinishes(span.spanId);
-                }
+            const response = await this.agentSpanClient.create(payload);
+            const backendSpanId = response.details?.id;
+            if (!backendSpanId) {
                 return;
             }
-            // Retry on server errors or rate limiting
-            if ((response.status >= 500 || response.status === 429) && retry < this.config.maxRetries) {
-                const delay = Math.min(this.config.initialRetryDelay * this.config.retryMultiplier ** retry, this.config.maxRetryDelay);
-                logger.debug(`Retrying span send after ${delay}ms (attempt ${retry + 1})`);
-                await new Promise((resolve) => setTimeout(resolve, delay));
-                return this.sendSpan(span, retry + 1);
-            }
-            logger.error(`Failed to send span: ${response.status} ${response.statusText}`);
+            this.spanIdMap.set(span.spanId, backendSpanId);
+            await this.processPendingFinishes(span.spanId);
         }
         catch (error) {
             logger.error('Error sending span:', error);
-            // Retry on network errors
-            if (retry < this.config.maxRetries) {
-                const delay = Math.min(this.config.initialRetryDelay * this.config.retryMultiplier ** retry, this.config.maxRetryDelay);
-                await new Promise((resolve) => setTimeout(resolve, delay));
-                return this.sendSpan(span, retry + 1);
-            }
         }
     }
-    /**
-     * Transform span to backend API format with nested details/payload structure
-     */
     transformSpanToApiFormat(span) {
         const startedAt = new Date(span.startTime).toISOString();
         const finishedAt = span.endTime ? new Date(span.endTime).toISOString() : null;
-        // Build payload with span data
+        const apiStatus = this.mapStatusForApi(span.status);
         const payload = {
             span_id: span.spanId,
             trace_id: span.traceId,
             name: span.name,
-            status: span.status,
+            status: apiStatus,
             inputs: span.inputs,
             outputs: span.outputs,
             metadata: span.metadata,
-            tags: span.tags,
             token_usage: null,
             error: null,
         };
-        // Add optional token_usage
         if (span.tokenUsage) {
             payload.token_usage = {
                 prompt_tokens: span.tokenUsage.promptTokens,
@@ -173,7 +175,6 @@ export class HttpTransport {
                 total_tokens: span.tokenUsage.totalTokens,
             };
         }
-        // Add optional error
         if (span.error) {
             payload.error = {
                 error_type: span.error.errorType,
@@ -181,12 +182,12 @@ export class HttpTransport {
                 stacktrace: span.error.stacktrace,
             };
         }
-        // Resolve parent span ID to backend ID
         const parentSpanId = span.parentSpanId ? (this.spanIdMap.get(span.parentSpanId) ?? null) : null;
         return {
             details: {
                 agent_instance_id: this.agentInstanceId,
                 schema_name: span.spanType,
+                status: apiStatus,
                 payload,
                 parent_span_id: parentSpanId,
                 started_at: startedAt,
@@ -194,20 +195,22 @@ export class HttpTransport {
             },
         };
     }
-    /**
-     * Get default schema (v1.0.0) with span schemas for all supported types
-     */
-    getDefaultSchema() {
-        return DEFAULT_AGENT_SCHEMA;
+    mapStatusForApi(status) {
+        switch (status) {
+            case 'running':
+                return 'active';
+            case 'success':
+                return 'complete';
+            case 'error':
+                return 'failed';
+            default:
+                return 'active';
+        }
     }
-    /**
-     * Ensure an agent instance is registered
-     */
     async ensureAgentRegistered() {
         if (this.agentInstanceId) {
-            return;
+            return true;
         }
-        const url = `${this.config.apiUrl}/api/v1/agent_instance/register`;
         const payload = {};
         if (this.config.agentId)
             payload.agent_id = this.config.agentId;
@@ -218,148 +221,56 @@ export class HttpTransport {
                 description: this.config.agentDescription || '',
             };
         }
-        // Schema handling - four modes:
-        // 1. skipSchema=true: No schema in payload (pre-registered on backend)
-        // 2. agentSchema provided: Use full custom schema object
-        // 3. agentSchemaIdentifier provided: Use version identifier only
-        if (this.config.skipSchema) {
-            logger.debug('Skipping schema in registration (skipSchema=true)');
-            // Do not add agent_schema_version key
-        }
-        else if (this.config.agentSchema) {
-            logger.debug('Using custom agent schema');
+        if (this.config.agentSchema) {
             payload.agent_schema_version = this.config.agentSchema;
         }
-        else if (this.config.agentSchemaIdentifier) {
-            logger.debug(`Using schema version: ${this.config.agentSchemaIdentifier}`);
-            payload.agent_schema_version = {
-                external_identifier: this.config.agentSchemaIdentifier,
-            };
-        }
-        else {
-            logger.debug('Using default hardcoded schema (v1.0.0)');
-            payload.agent_schema_version = this.getDefaultSchema();
-        }
         try {
-            const response = await fetch(url, {
-                method: 'POST',
-                headers: {
-                    Authorization: `Bearer ${this.config.apiToken}`,
-                    'Content-Type': 'application/json',
-                },
-                body: JSON.stringify(payload),
-                signal: AbortSignal.timeout(this.config.requestTimeout),
-            });
-            if (response.ok) {
-                const data = (await response.json());
-                this.agentInstanceId = data?.details?.id ?? null;
-                logger.debug(`Registered agent instance: ${this.agentInstanceId}`);
-            }
-            else {
-                logger.error(`Failed to register agent: ${response.status} ${response.statusText}`);
-            }
+            const data = await this.agentInstanceClient.register(payload);
+            this.agentInstanceId = data.details?.id ?? null;
         }
         catch (error) {
             logger.error('Error registering agent:', error);
         }
+        return this.agentInstanceId !== null;
     }
-    /**
-     * Start agent instance execution
-     */
     async startAgentInstanceHttp() {
-        await this.ensureAgentRegistered();
-        if (!this.agentInstanceId) {
+        const isRegistered = await this.ensureAgentRegistered();
+        if (!isRegistered || !this.agentInstanceId) {
             logger.error('Cannot start agent instance: not registered');
             return;
         }
-        const url = `${this.config.apiUrl}/api/v1/agent_instance/${this.agentInstanceId}/start`;
         try {
-            const response = await fetch(url, {
-                method: 'POST',
-                headers: {
-                    Authorization: `Bearer ${this.config.apiToken}`,
-                    'Content-Type': 'application/json',
-                },
-                body: JSON.stringify({}),
-                signal: AbortSignal.timeout(this.config.requestTimeout),
-            });
-            if (!response.ok) {
-                logger.error(`Failed to start agent instance: ${response.status} ${response.statusText}`);
-            }
+            await this.agentInstanceClient.start(this.agentInstanceId);
         }
         catch (error) {
             logger.error('Error starting agent instance:', error);
         }
     }
-    /**
-     * Finish agent instance execution
-     */
     async finishAgentInstanceHttp() {
         if (!this.agentInstanceId) {
             logger.error('Cannot finish agent instance: not registered');
             return;
         }
-        const url = `${this.config.apiUrl}/api/v1/agent_instance/${this.agentInstanceId}/finish`;
         try {
-            const response = await fetch(url, {
-                method: 'POST',
-                headers: {
-                    Authorization: `Bearer ${this.config.apiToken}`,
-                    'Content-Type': 'application/json',
-                },
-                body: JSON.stringify({}),
-                signal: AbortSignal.timeout(this.config.requestTimeout),
-            });
-            if (!response.ok) {
-                logger.error(`Failed to finish agent instance: ${response.status} ${response.statusText}`);
-            }
+            await this.agentInstanceClient.finish(this.agentInstanceId);
         }
         catch (error) {
             logger.error('Error finishing agent instance:', error);
         }
-        // Reset so the next agent_start registers a fresh instance
         this.agentInstanceId = null;
     }
-    /**
-     * Finish a span via HTTP
-     */
     async finishSpanHttp(data) {
         const backendSpanId = this.spanIdMap.get(data.spanId);
         if (!backendSpanId) {
             logger.warn(`Cannot finish span ${data.spanId}: backend ID not found`);
             return;
         }
-        const url = `${this.config.apiUrl}/api/v1/agent_spans/${backendSpanId}/finish`;
         try {
-            const response = await fetch(url, {
-                method: 'POST',
-                headers: {
-                    Authorization: `Bearer ${this.config.apiToken}`,
-                    'Content-Type': 'application/json',
-                },
-                body: JSON.stringify({ timestamp: data.timestamp }),
-                signal: AbortSignal.timeout(this.config.requestTimeout),
-            });
-            if (!response.ok) {
-                logger.error(`Failed to finish span: ${response.status} ${response.statusText}`);
-            }
+            await this.agentSpanClient.finish(backendSpanId, data.timestamp);
         }
         catch (error) {
             logger.error('Error finishing span:', error);
         }
     }
-    /**
-     * Close the transport and wait for queue to drain
-     *
-     * @returns Promise that resolves when transport is closed
-     */
-    async close() {
-        this.closed = true;
-        // Log warning for any pending finishes that will never be processed
-        if (this.pendingFinishes.size > 0) {
-            logger.warn(`Transport closed with ${this.pendingFinishes.size} pending span finish(es) that could not be processed`);
-            this.pendingFinishes.clear();
-        }
-    }
 }
 //# sourceMappingURL=http.js.map