@backendkit-labs/agent-core 0.14.0

package/dist/memory/SessionMemory.d.ts

@@ -0,0 +1,9 @@
+import type { SessionMemoryData } from '../types';
+export declare class SessionMemory implements SessionMemoryData {
+    private store;
+    get(key: string): string | undefined;
+    set(key: string, value: string): void;
+    getAll(): Record<string, string>;
+    clear(): void;
+}
+//# sourceMappingURL=SessionMemory.d.ts.map

package/dist/memory/SessionMemory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionMemory.d.ts","sourceRoot":"","sources":["../../src/memory/SessionMemory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD,qBAAa,aAAc,YAAW,iBAAiB;IACnD,OAAO,CAAC,KAAK,CAA6B;IAE1C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIpC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIrC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAIhC,KAAK,IAAI,IAAI;CAGhB"}

package/dist/memory/SessionMemory.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionMemory = void 0;
+class SessionMemory {
+    store = new Map();
+    get(key) {
+        return this.store.get(key);
+    }
+    set(key, value) {
+        this.store.set(key, value);
+    }
+    getAll() {
+        return Object.fromEntries(this.store.entries());
+    }
+    clear() {
+        this.store.clear();
+    }
+}
+exports.SessionMemory = SessionMemory;
+//# sourceMappingURL=SessionMemory.js.map

package/dist/memory/SessionMemory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionMemory.js","sourceRoot":"","sources":["../../src/memory/SessionMemory.ts"],"names":[],"mappings":";;;AAEA,MAAa,aAAa;IACd,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE1C,GAAG,CAAC,GAAW;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAa;QAC1B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM;QACF,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,KAAK;QACD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACJ;AAlBD,sCAkBC"}

package/dist/observability/CostTracker.d.ts

@@ -0,0 +1,19 @@
+import type { CostTrackerConfig } from './types';
+export declare class CostTracker {
+    private readonly config;
+    private runInput;
+    private runOutput;
+    private dayInput;
+    private dayOutput;
+    private dayStartMs;
+    private readonly timer;
+    constructor(config: CostTrackerConfig);
+    onRunStart(): void;
+    /** Called when the engine receives a metrics event. Returns estimated cost for this batch. */
+    onTokens(inputTokens: number, outputTokens: number, providedCostUsd?: number): number;
+    getRunCost(): number;
+    getDayCost(): number;
+    destroy(): void;
+    private compute;
+}
+//# sourceMappingURL=CostTracker.d.ts.map

package/dist/observability/CostTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CostTracker.d.ts","sourceRoot":"","sources":["../../src/observability/CostTracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE9D,qBAAa,WAAW;IAiBR,OAAO,CAAC,QAAQ,CAAC,MAAM;IAhBnC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAiB;IAGnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAOH;gBAEU,MAAM,EAAE,iBAAiB;IAEtD,UAAU,IAAI,IAAI;IAKlB,8FAA8F;IAC9F,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM;IA0BrF,UAAU,IAAI,MAAM;IACpB,UAAU,IAAI,MAAM;IAEpB,OAAO,IAAI,IAAI;IAEf,OAAO,CAAC,OAAO;CAIlB"}

package/dist/observability/CostTracker.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CostTracker = void 0;
+class CostTracker {
+    config;
+    runInput = 0;
+    runOutput = 0;
+    dayInput = 0;
+    dayOutput = 0;
+    dayStartMs = utcDayStart();
+    // Lightweight midnight-reset: unref'd so it doesn't keep the process alive
+    timer = setInterval(() => {
+        const now = utcDayStart();
+        if (now !== this.dayStartMs) {
+            this.dayInput = 0;
+            this.dayOutput = 0;
+            this.dayStartMs = now;
+        }
+    }, 60_000).unref();
+    constructor(config) {
+        this.config = config;
+    }
+    onRunStart() {
+        this.runInput = 0;
+        this.runOutput = 0;
+    }
+    /** Called when the engine receives a metrics event. Returns estimated cost for this batch. */
+    onTokens(inputTokens, outputTokens, providedCostUsd) {
+        this.runInput += inputTokens;
+        this.runOutput += outputTokens;
+        this.dayInput += inputTokens;
+        this.dayOutput += outputTokens;
+        const runCost = providedCostUsd ?? this.compute(this.runInput, this.runOutput);
+        const dayCost = this.compute(this.dayInput, this.dayOutput);
+        if (this.config.budget?.perRun !== undefined && runCost >= this.config.budget.perRun) {
+            this.config.onBudgetExceeded?.({
+                runCostUsd: runCost, dayCostUsd: dayCost,
+                inputTokens: this.runInput, outputTokens: this.runOutput,
+                budgetExceeded: 'perRun',
+            });
+        }
+        else if (this.config.budget?.perDay !== undefined && dayCost >= this.config.budget.perDay) {
+            this.config.onBudgetExceeded?.({
+                runCostUsd: runCost, dayCostUsd: dayCost,
+                inputTokens: this.dayInput, outputTokens: this.dayOutput,
+                budgetExceeded: 'perDay',
+            });
+        }
+        return this.compute(inputTokens, outputTokens);
+    }
+    getRunCost() { return this.compute(this.runInput, this.runOutput); }
+    getDayCost() { return this.compute(this.dayInput, this.dayOutput); }
+    destroy() { clearInterval(this.timer); }
+    compute(input, output) {
+        return input * ((this.config.inputPricePerMToken ?? 0) / 1_000_000)
+            + output * ((this.config.outputPricePerMToken ?? 0) / 1_000_000);
+    }
+}
+exports.CostTracker = CostTracker;
+function utcDayStart() {
+    const d = new Date();
+    return Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate());
+}
+//# sourceMappingURL=CostTracker.js.map

package/dist/observability/CostTracker.js.map

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

package/dist/observability/MetricsCollector.d.ts

@@ -0,0 +1,17 @@
+import type { MetricsSnapshot } from './types';
+export declare class MetricsCollector {
+    private durations;
+    private errorRuns;
+    private totalInput;
+    private totalOutput;
+    private estimatedCostUsd;
+    private tools;
+    private agents;
+    recordRun(durationMs: number, error: boolean): void;
+    recordTokens(input: number, output: number, costUsd: number): void;
+    recordToolCall(name: string, success: boolean): void;
+    recordAgentBlock(agentId: string, durationMs: number): void;
+    getSnapshot(): MetricsSnapshot;
+    private percentile;
+}
+//# sourceMappingURL=MetricsCollector.d.ts.map

package/dist/observability/MetricsCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetricsCollector.d.ts","sourceRoot":"","sources":["../../src/observability/MetricsCollector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,qBAAa,gBAAgB;IACzB,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,KAAK,CAA6E;IAC1F,OAAO,CAAC,MAAM,CAAuE;IAErF,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAKnD,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAMlE,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAOpD,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAO3D,WAAW,IAAI,eAAe;IAqB9B,OAAO,CAAC,UAAU;CAIrB"}

package/dist/observability/MetricsCollector.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricsCollector = void 0;
+class MetricsCollector {
+    durations = [];
+    errorRuns = 0;
+    totalInput = 0;
+    totalOutput = 0;
+    estimatedCostUsd = 0;
+    tools = new Map();
+    agents = new Map();
+    recordRun(durationMs, error) {
+        this.durations.push(durationMs);
+        if (error)
+            this.errorRuns++;
+    }
+    recordTokens(input, output, costUsd) {
+        this.totalInput += input;
+        this.totalOutput += output;
+        this.estimatedCostUsd += costUsd;
+    }
+    recordToolCall(name, success) {
+        let t = this.tools.get(name);
+        if (!t) {
+            t = { calls: 0, successes: 0, failures: 0 };
+            this.tools.set(name, t);
+        }
+        t.calls++;
+        if (success)
+            t.successes++;
+        else
+            t.failures++;
+    }
+    recordAgentBlock(agentId, durationMs) {
+        let a = this.agents.get(agentId);
+        if (!a) {
+            a = { invocations: 0, totalDurationMs: 0 };
+            this.agents.set(agentId, a);
+        }
+        a.invocations++;
+        a.totalDurationMs += durationMs;
+    }
+    getSnapshot() {
+        const sorted = [...this.durations].sort((a, b) => a - b);
+        return {
+            runs: {
+                total: this.durations.length,
+                errors: this.errorRuns,
+                totalDurationMs: this.durations.reduce((s, d) => s + d, 0),
+                p50Ms: this.percentile(sorted, 50),
+                p95Ms: this.percentile(sorted, 95),
+                p99Ms: this.percentile(sorted, 99),
+            },
+            tokens: {
+                totalInput: this.totalInput,
+                totalOutput: this.totalOutput,
+                estimatedCostUsd: this.estimatedCostUsd,
+            },
+            tools: Object.fromEntries(this.tools),
+            agents: Object.fromEntries(this.agents),
+        };
+    }
+    percentile(sorted, p) {
+        if (sorted.length === 0)
+            return null;
+        return sorted[Math.max(0, Math.ceil(sorted.length * p / 100) - 1)];
+    }
+}
+exports.MetricsCollector = MetricsCollector;
+//# sourceMappingURL=MetricsCollector.js.map

package/dist/observability/MetricsCollector.js.map

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

package/dist/observability/ObservabilityManager.d.ts

@@ -0,0 +1,33 @@
+import type { Transport } from '../transport/Transport';
+import type { MetricsSnapshot, ObservabilityConfig } from './types';
+/**
+ * Wraps a Transport to intercept AgentEvents and feed them into tracing,
+ * metrics collection, and cost tracking.
+ *
+ * Attach via createBaseEngine({ observability: config }) — the wrapped
+ * transport is passed to AgentEngine transparently.
+ */
+export declare class ObservabilityManager {
+    private readonly config;
+    private readonly tracer;
+    private readonly metrics;
+    private readonly cost;
+    private readonly metricsConfig;
+    private runSpan;
+    private runStart;
+    private runHadError;
+    private blockSpans;
+    constructor(config: ObservabilityConfig);
+    /** Returns a new Transport that proxies all events through this manager. */
+    wrapTransport(transport: Transport): Transport;
+    /** Returns the current cumulative metrics snapshot. */
+    getMetricsSnapshot(): MetricsSnapshot | null;
+    /** USD cost of the most recent run (0 if no pricing config). */
+    getRunCost(): number;
+    /** Cumulative USD cost since UTC midnight (0 if no pricing config). */
+    getDayCost(): number;
+    /** Clean up resources (interval timer in CostTracker). */
+    destroy(): void;
+    private handleEvent;
+}
+//# sourceMappingURL=ObservabilityManager.d.ts.map

package/dist/observability/ObservabilityManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObservabilityManager.d.ts","sourceRoot":"","sources":["../../src/observability/ObservabilityManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAKxD,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAQpE;;;;;;GAMG;AACH,qBAAa,oBAAoB;IAYjB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAXnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiC;IAG/D,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAA0D;gBAE/C,MAAM,EAAE,mBAAmB;IAOxD,4EAA4E;IAC5E,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS;IAW9C,uDAAuD;IACvD,kBAAkB,IAAI,eAAe,GAAG,IAAI;IAI5C,gEAAgE;IAChE,UAAU,IAAI,MAAM;IAEpB,uEAAuE;IACvE,UAAU,IAAI,MAAM;IAEpB,0DAA0D;IAC1D,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,WAAW;CA6DtB"}

package/dist/observability/ObservabilityManager.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObservabilityManager = void 0;
+const Tracer_1 = require("./Tracer");
+const MetricsCollector_1 = require("./MetricsCollector");
+const CostTracker_1 = require("./CostTracker");
+/**
+ * Wraps a Transport to intercept AgentEvents and feed them into tracing,
+ * metrics collection, and cost tracking.
+ *
+ * Attach via createBaseEngine({ observability: config }) — the wrapped
+ * transport is passed to AgentEngine transparently.
+ */
+class ObservabilityManager {
+    config;
+    tracer;
+    metrics;
+    cost;
+    metricsConfig;
+    // Per-run state
+    runSpan = null;
+    runStart = 0;
+    runHadError = false;
+    blockSpans = new Map();
+    constructor(config) {
+        this.config = config;
+        this.tracer = config.tracing ? new Tracer_1.Tracer(config.tracing) : null;
+        this.metrics = config.metrics ? new MetricsCollector_1.MetricsCollector() : null;
+        this.cost = config.costTracker ? new CostTracker_1.CostTracker(config.costTracker) : null;
+        this.metricsConfig = config.metrics;
+    }
+    /** Returns a new Transport that proxies all events through this manager. */
+    wrapTransport(transport) {
+        return {
+            emit: (event) => {
+                this.handleEvent(event);
+                transport.emit(event);
+            },
+            onInput: (handler) => transport.onInput(handler),
+            close: () => transport.close(),
+        };
+    }
+    /** Returns the current cumulative metrics snapshot. */
+    getMetricsSnapshot() {
+        return this.metrics?.getSnapshot() ?? null;
+    }
+    /** USD cost of the most recent run (0 if no pricing config). */
+    getRunCost() { return this.cost?.getRunCost() ?? 0; }
+    /** Cumulative USD cost since UTC midnight (0 if no pricing config). */
+    getDayCost() { return this.cost?.getDayCost() ?? 0; }
+    /** Clean up resources (interval timer in CostTracker). */
+    destroy() { this.cost?.destroy(); }
+    // ── Private ────────────────────────────────────────────────────────────────
+    handleEvent(event) {
+        switch (event.type) {
+            case 'ready':
+                this.runStart = Date.now();
+                this.runHadError = false;
+                this.cost?.onRunStart();
+                this.runSpan = this.tracer?.startRootSpan('run') ?? null;
+                break;
+            case 'done': {
+                const durationMs = Date.now() - this.runStart;
+                this.metrics?.recordRun(durationMs, this.runHadError);
+                this.runSpan?.end(this.runHadError ? 'error' : 'ok');
+                this.runSpan = null;
+                if (this.metricsConfig?.onSnapshot && this.metrics) {
+                    this.metricsConfig.onSnapshot(this.metrics.getSnapshot());
+                }
+                break;
+            }
+            case 'block_start': {
+                const span = this.tracer?.startSpan('agent_block', this.runSpan?.spanId, {
+                    agent_id: event.agent_id,
+                    ...(event.agent_name ? { agent_name: event.agent_name } : {}),
+                }) ?? null;
+                if (span)
+                    this.blockSpans.set(event.agent_id, { span, start: Date.now() });
+                break;
+            }
+            case 'block_end': {
+                const agentId = event.agent_id ?? '';
+                const entry = this.blockSpans.get(agentId);
+                if (entry) {
+                    entry.span.end(event.status === 'ok' ? 'ok' : 'error');
+                    this.metrics?.recordAgentBlock(agentId, Date.now() - entry.start);
+                    this.blockSpans.delete(agentId);
+                }
+                break;
+            }
+            case 'tool_result':
+                this.metrics?.recordToolCall(event.name, event.success);
+                break;
+            case 'error':
+                this.runHadError = true;
+                this.runSpan?.setTag('error', event.message);
+                break;
+            case 'metrics': {
+                const costUsd = this.cost?.onTokens(event.input_tokens, event.output_tokens, event.cost_usd) ?? 0;
+                this.metrics?.recordTokens(event.input_tokens, event.output_tokens, costUsd);
+                break;
+            }
+        }
+    }
+}
+exports.ObservabilityManager = ObservabilityManager;
+//# sourceMappingURL=ObservabilityManager.js.map

package/dist/observability/ObservabilityManager.js.map

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

package/dist/observability/Tracer.d.ts

@@ -0,0 +1,23 @@
+import type { TracingConfig } from './types';
+interface ActiveSpan {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    startedAt: Date;
+    tags: Record<string, string | number | boolean>;
+    end(status: 'ok' | 'error'): void;
+    setTag(key: string, value: string | number | boolean): void;
+}
+export declare class Tracer {
+    private readonly exporter;
+    private currentTraceId;
+    constructor(config: TracingConfig);
+    /** Start a new root span (new traceId). */
+    startRootSpan(name: string, tags?: Record<string, string | number | boolean>): ActiveSpan;
+    /** Start a child span under the current trace. */
+    startSpan(name: string, parentSpanId?: string, tags?: Record<string, string | number | boolean>): ActiveSpan;
+    private createSpan;
+}
+export {};
+//# sourceMappingURL=Tracer.d.ts.map

package/dist/observability/Tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tracer.d.ts","sourceRoot":"","sources":["../../src/observability/Tracer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAsB,aAAa,EAAE,MAAM,SAAS,CAAC;AAEjE,UAAU,UAAU;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,IAAI,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAChD,GAAG,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,IAAI,CAAC;IAClC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;CAC/D;AAED,qBAAa,MAAM;IACf,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,cAAc,CAAuB;gBAEjC,MAAM,EAAE,aAAa;IAIjC,2CAA2C;IAC3C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,UAAU;IAKzF,kDAAkD;IAClD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,UAAU;IAK5G,OAAO,CAAC,UAAU;CAoCrB"}

package/dist/observability/Tracer.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tracer = void 0;
+const crypto_1 = require("crypto");
+class Tracer {
+    exporter;
+    currentTraceId = null;
+    constructor(config) {
+        this.exporter = resolveExporter(config.exporter);
+    }
+    /** Start a new root span (new traceId). */
+    startRootSpan(name, tags) {
+        this.currentTraceId = (0, crypto_1.randomUUID)();
+        return this.createSpan(name, this.currentTraceId, undefined, tags);
+    }
+    /** Start a child span under the current trace. */
+    startSpan(name, parentSpanId, tags) {
+        const traceId = this.currentTraceId ?? (0, crypto_1.randomUUID)();
+        return this.createSpan(name, traceId, parentSpanId, tags);
+    }
+    createSpan(name, traceId, parentSpanId, tags = {}) {
+        const spanId = (0, crypto_1.randomUUID)();
+        const startedAt = new Date();
+        const mutableTags = { ...tags };
+        const exporter = this.exporter;
+        return {
+            traceId,
+            spanId,
+            parentSpanId,
+            name,
+            startedAt,
+            tags: mutableTags,
+            setTag(key, value) { mutableTags[key] = value; },
+            end(status) {
+                const endedAt = new Date();
+                const span = {
+                    traceId,
+                    spanId,
+                    parentSpanId,
+                    name,
+                    startedAt,
+                    endedAt,
+                    durationMs: endedAt.getTime() - startedAt.getTime(),
+                    status,
+                    tags: { ...mutableTags },
+                };
+                exporter(span);
+            },
+        };
+    }
+}
+exports.Tracer = Tracer;
+function resolveExporter(exporter) {
+    if (!exporter || exporter === 'noop')
+        return () => undefined;
+    if (exporter === 'console') {
+        return (span) => {
+            const ms = span.durationMs.toString().padStart(5);
+            const tags = Object.entries(span.tags).map(([k, v]) => `${k}=${v}`).join(' ');
+            console.log(`[TRACE] ${ms}ms ${span.status.toUpperCase().padEnd(5)} ${span.name}${tags ? ` | ${tags}` : ''}`);
+        };
+    }
+    return exporter;
+}
+//# sourceMappingURL=Tracer.js.map

package/dist/observability/Tracer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tracer.js","sourceRoot":"","sources":["../../src/observability/Tracer.ts"],"names":[],"mappings":";;;AAAA,mCAAoC;AAcpC,MAAa,MAAM;IACE,QAAQ,CAAe;IAChC,cAAc,GAAkB,IAAI,CAAC;IAE7C,YAAY,MAAqB;QAC7B,IAAI,CAAC,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED,2CAA2C;IAC3C,aAAa,CAAC,IAAY,EAAE,IAAgD;QACxE,IAAI,CAAC,cAAc,GAAG,IAAA,mBAAU,GAAE,CAAC;QACnC,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACvE,CAAC;IAED,kDAAkD;IAClD,SAAS,CAAC,IAAY,EAAE,YAAqB,EAAE,IAAgD;QAC3F,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,IAAI,IAAA,mBAAU,GAAE,CAAC;QACpD,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;IAC9D,CAAC;IAEO,UAAU,CACd,IAAY,EACZ,OAAe,EACf,YAAqB,EACrB,OAAkD,EAAE;QAEpD,MAAM,MAAM,GAAG,IAAA,mBAAU,GAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAE/B,OAAO;YACH,OAAO;YACP,MAAM;YACN,YAAY;YACZ,IAAI;YACJ,SAAS;YACT,IAAI,EAAE,WAAW;YACjB,MAAM,CAAC,GAAG,EAAE,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;YAChD,GAAG,CAAC,MAAM;gBACN,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;gBAC3B,MAAM,IAAI,GAAS;oBACf,OAAO;oBACP,MAAM;oBACN,YAAY;oBACZ,IAAI;oBACJ,SAAS;oBACT,OAAO;oBACP,UAAU,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE;oBACnD,MAAM;oBACN,IAAI,EAAE,EAAE,GAAG,WAAW,EAAE;iBAC3B,CAAC;gBACF,QAAQ,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;SACJ,CAAC;IACN,CAAC;CACJ;AAxDD,wBAwDC;AAED,SAAS,eAAe,CAAC,QAAmC;IACxD,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,MAAM;QAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC;IAC7D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,EAAE,EAAE;YACZ,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAClD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC9E,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAClH,CAAC,CAAC;IACN,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC"}

package/dist/observability/index.d.ts

@@ -0,0 +1,7 @@
+export { ObservabilityManager } from './ObservabilityManager';
+export { CostTracker } from './CostTracker';
+export { MetricsCollector } from './MetricsCollector';
+export { Tracer } from './Tracer';
+export type { ObservabilityConfig, TracingConfig, MetricsConfig, CostTrackerConfig, Span, SpanExporter, MetricsSnapshot, BudgetUsage, } from './types';
+export { MODEL_PRICING } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/observability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EACR,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,IAAI,EACJ,YAAY,EACZ,eAAe,EACf,WAAW,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

package/dist/observability/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MODEL_PRICING = exports.Tracer = exports.MetricsCollector = exports.CostTracker = exports.ObservabilityManager = void 0;
+var ObservabilityManager_1 = require("./ObservabilityManager");
+Object.defineProperty(exports, "ObservabilityManager", { enumerable: true, get: function () { return ObservabilityManager_1.ObservabilityManager; } });
+var CostTracker_1 = require("./CostTracker");
+Object.defineProperty(exports, "CostTracker", { enumerable: true, get: function () { return CostTracker_1.CostTracker; } });
+var MetricsCollector_1 = require("./MetricsCollector");
+Object.defineProperty(exports, "MetricsCollector", { enumerable: true, get: function () { return MetricsCollector_1.MetricsCollector; } });
+var Tracer_1 = require("./Tracer");
+Object.defineProperty(exports, "Tracer", { enumerable: true, get: function () { return Tracer_1.Tracer; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "MODEL_PRICING", { enumerable: true, get: function () { return types_1.MODEL_PRICING; } });
+//# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":";;;AAAA,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAC7B,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AAWf,iCAAwC;AAA/B,sGAAA,aAAa,OAAA"}

package/dist/observability/types.d.ts

@@ -0,0 +1,77 @@
+export interface Span {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    startedAt: Date;
+    endedAt: Date;
+    durationMs: number;
+    status: 'ok' | 'error';
+    tags: Record<string, string | number | boolean>;
+}
+export type SpanExporter = (span: Span) => void;
+export interface MetricsSnapshot {
+    runs: {
+        total: number;
+        errors: number;
+        totalDurationMs: number;
+        p50Ms: number | null;
+        p95Ms: number | null;
+        p99Ms: number | null;
+    };
+    tokens: {
+        totalInput: number;
+        totalOutput: number;
+        estimatedCostUsd: number;
+    };
+    tools: Record<string, {
+        calls: number;
+        successes: number;
+        failures: number;
+    }>;
+    agents: Record<string, {
+        invocations: number;
+        totalDurationMs: number;
+    }>;
+}
+export interface BudgetUsage {
+    runCostUsd: number;
+    dayCostUsd: number;
+    inputTokens: number;
+    outputTokens: number;
+    budgetExceeded: 'perRun' | 'perDay';
+}
+export interface TracingConfig {
+    /**
+     * 'console' prints each finished span to stdout.
+     * 'noop' disables tracing.
+     * A function receives every finished span — use to export to Jaeger, Zipkin, etc.
+     */
+    exporter?: SpanExporter | 'console' | 'noop';
+}
+export interface MetricsConfig {
+    /** Called after each run() completes with the cumulative snapshot. */
+    onSnapshot?: (snapshot: MetricsSnapshot) => void;
+}
+export interface CostTrackerConfig {
+    /** USD per million input tokens. */
+    inputPricePerMToken?: number;
+    /** USD per million output tokens. */
+    outputPricePerMToken?: number;
+    budget?: {
+        /** Call onBudgetExceeded when a single run exceeds this cost (USD). */
+        perRun?: number;
+        /** Call onBudgetExceeded when cumulative daily cost exceeds this (USD). Resets at UTC midnight. */
+        perDay?: number;
+    };
+    currency?: string;
+    onBudgetExceeded?: (usage: BudgetUsage) => void;
+}
+export interface ObservabilityConfig {
+    tracing?: TracingConfig;
+    metrics?: MetricsConfig;
+    costTracker?: CostTrackerConfig;
+}
+/** Per-model pricing (USD / million tokens, mid-2025). Spread into CostTrackerConfig. */
+export declare const MODEL_PRICING: Record<string, Pick<CostTrackerConfig, 'inputPricePerMToken' | 'outputPricePerMToken'>>;
+//# sourceMappingURL=types.d.ts.map

package/dist/observability/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/observability/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,IAAI;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACnD;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;AAIhD,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE;QACF,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,EAAE,MAAM,CAAC;QACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,CAAC;IACF,MAAM,EAAE;QACJ,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5E;AAID,MAAM,WAAW,WAAW;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,QAAQ,GAAG,QAAQ,CAAC;CACvC;AAID,MAAM,WAAW,aAAa;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC;CAChD;AAED,MAAM,WAAW,aAAa;IAC1B,sEAAsE;IACtE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,iBAAiB;IAC9B,oCAAoC;IACpC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qCAAqC;IACrC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,MAAM,CAAC,EAAE;QACL,uEAAuE;QACvE,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,mGAAmG;QACnG,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,mBAAmB;IAChC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACnC;AAID,yFAAyF;AACzF,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,qBAAqB,GAAG,sBAAsB,CAAC,CAOjH,CAAC"}

package/dist/observability/types.js

@@ -0,0 +1,15 @@
+"use strict";
+// ── Spans ─────────────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MODEL_PRICING = void 0;
+// ── Pricing presets ───────────────────────────────────────────────────────────
+/** Per-model pricing (USD / million tokens, mid-2025). Spread into CostTrackerConfig. */
+exports.MODEL_PRICING = {
+    'claude-opus-4-8': { inputPricePerMToken: 15, outputPricePerMToken: 75 },
+    'claude-sonnet-4-6': { inputPricePerMToken: 3, outputPricePerMToken: 15 },
+    'claude-haiku-4-5': { inputPricePerMToken: 0.80, outputPricePerMToken: 4 },
+    'gpt-4o': { inputPricePerMToken: 5, outputPricePerMToken: 15 },
+    'gpt-4o-mini': { inputPricePerMToken: 0.15, outputPricePerMToken: 0.60 },
+    'deepseek-chat': { inputPricePerMToken: 0.27, outputPricePerMToken: 1.10 },
+};
+//# sourceMappingURL=types.js.map

package/dist/observability/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/observability/types.ts"],"names":[],"mappings":";AAAA,iFAAiF;;;AAmFjF,iFAAiF;AAEjF,yFAAyF;AAC5E,QAAA,aAAa,GAA4F;IAClH,iBAAiB,EAAI,EAAE,mBAAmB,EAAE,EAAE,EAAI,oBAAoB,EAAE,EAAE,EAAI;IAC9E,mBAAmB,EAAE,EAAE,mBAAmB,EAAE,CAAC,EAAK,oBAAoB,EAAE,EAAE,EAAI;IAC9E,kBAAkB,EAAG,EAAE,mBAAmB,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,EAAK;IAC9E,QAAQ,EAAa,EAAE,mBAAmB,EAAE,CAAC,EAAK,oBAAoB,EAAE,EAAE,EAAI;IAC9E,aAAa,EAAQ,EAAE,mBAAmB,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE;IAC9E,eAAe,EAAM,EAAE,mBAAmB,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE;CACjF,CAAC"}