@llm4ts/core 0.1.0

package/dist/observability/Metrics.js

@@ -0,0 +1,147 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Ref from "effect/Ref";
+import * as Schema from "effect/Schema";
+import { TokenUsage } from "../Models.js";
+export class RequestLabels extends Schema.Class("RequestLabels")({
+    provider: Schema.String,
+    model: Schema.String,
+    agent: Schema.optionalKey(Schema.String),
+    runId: Schema.optionalKey(Schema.String),
+    workflowStep: Schema.optionalKey(Schema.String)
+}) {
+}
+export class RequestMetrics extends Schema.Class("RequestMetrics")({
+    labels: RequestLabels,
+    tokenUsage: Schema.optionalKey(TokenUsage),
+    latencyMs: Schema.Number,
+    success: Schema.Boolean,
+    errorType: Schema.optionalKey(Schema.String),
+    estimatedCostUsd: Schema.optionalKey(Schema.Number)
+}) {
+}
+export class ProviderHealth extends Schema.Class("ProviderHealth")({
+    provider: Schema.String,
+    requestCount: Schema.Int,
+    successRate: Schema.Number,
+    avgLatencyMs: Schema.Number,
+    p95LatencyMs: Schema.Number,
+    estimatedCostUsd: Schema.Number
+}) {
+}
+export class ObservabilitySnapshot extends Schema.Class("ObservabilitySnapshot")({
+    totalRequests: Schema.Int,
+    totalErrors: Schema.Int,
+    activeRequests: Schema.Int,
+    promptTokens: Schema.Int,
+    completionTokens: Schema.Int,
+    totalTokens: Schema.Int,
+    estimatedCostUsd: Schema.Number,
+    p50LatencyMs: Schema.Number,
+    p95LatencyMs: Schema.Number,
+    byProvider: Schema.Array(ProviderHealth),
+    byAgentRequests: Schema.Record(Schema.String, Schema.Int)
+}) {
+}
+export class DashboardMetricsSnapshot extends Schema.Class("DashboardMetricsSnapshot")({
+    providerHealth: Schema.Array(ProviderHealth),
+    totalTokens: Schema.Int,
+    totalCostUsd: Schema.Number,
+    totalRequests: Schema.Int,
+    errorRate: Schema.Number
+}) {
+}
+export class MetricsCollector extends Context.Service()("@llm4ts/core/observability/MetricsCollector") {
+}
+const percentile = (values, quantile) => {
+    if (values.length === 0) {
+        return 0;
+    }
+    const sorted = [...values].sort((left, right) => left - right);
+    const index = Math.max(0, Math.ceil(quantile * sorted.length) - 1);
+    return sorted[index] ?? 0;
+};
+const providerHealth = (completed) => {
+    const providers = new Map();
+    for (const metric of completed) {
+        const current = providers.get(metric.labels.provider) ?? [];
+        current.push(metric);
+        providers.set(metric.labels.provider, current);
+    }
+    return [...providers.entries()]
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([provider, metrics]) => {
+        const latencies = metrics.map((metric) => metric.latencyMs);
+        const successes = metrics.filter((metric) => metric.success).length;
+        return ProviderHealth.make({
+            provider,
+            requestCount: metrics.length,
+            successRate: metrics.length === 0 ? 1 : successes / metrics.length,
+            avgLatencyMs: metrics.length === 0
+                ? 0
+                : latencies.reduce((sum, latency) => sum + latency, 0) / metrics.length,
+            p95LatencyMs: percentile(latencies, 0.95),
+            estimatedCostUsd: metrics.reduce((sum, metric) => sum + (metric.estimatedCostUsd ?? 0), 0)
+        });
+    });
+};
+const toSnapshot = (state) => {
+    const completed = state.completed;
+    const promptTokens = completed.reduce((sum, metric) => sum + (metric.tokenUsage?.prompt ?? 0), 0);
+    const completionTokens = completed.reduce((sum, metric) => sum + (metric.tokenUsage?.completion ?? 0), 0);
+    return ObservabilitySnapshot.make({
+        totalRequests: state.totalRequests,
+        totalErrors: completed.filter((metric) => !metric.success).length,
+        activeRequests: state.activeRequests,
+        promptTokens,
+        completionTokens,
+        totalTokens: promptTokens + completionTokens,
+        estimatedCostUsd: completed.reduce((sum, metric) => sum + (metric.estimatedCostUsd ?? 0), 0),
+        p50LatencyMs: percentile(completed.map((metric) => metric.latencyMs), 0.5),
+        p95LatencyMs: percentile(completed.map((metric) => metric.latencyMs), 0.95),
+        byProvider: providerHealth(completed),
+        byAgentRequests: Object.fromEntries(state.byAgentRequests)
+    });
+};
+export const makeMetricsCollector = Effect.fn("@llm4ts/core/observability/MetricsCollector.make")(function* () {
+    const state = yield* Ref.make({
+        totalRequests: 0,
+        activeRequests: 0,
+        completed: [],
+        byAgentRequests: new Map()
+    });
+    const markRequestStarted = (labels) => Ref.update(state, (current) => {
+        const agents = new Map(current.byAgentRequests);
+        if (labels.agent !== undefined) {
+            agents.set(labels.agent, (agents.get(labels.agent) ?? 0) + 1);
+        }
+        return {
+            totalRequests: current.totalRequests + 1,
+            activeRequests: current.activeRequests + 1,
+            completed: current.completed,
+            byAgentRequests: agents
+        };
+    });
+    const recordCompleted = (metrics) => Ref.update(state, (current) => ({
+        ...current,
+        activeRequests: Math.max(0, current.activeRequests - 1),
+        completed: [...current.completed, metrics]
+    }));
+    const snapshot = Ref.get(state).pipe(Effect.map(toSnapshot));
+    const dashboardSnapshot = snapshot.pipe(Effect.map((current) => DashboardMetricsSnapshot.make({
+        providerHealth: current.byProvider,
+        totalTokens: current.totalTokens,
+        totalCostUsd: current.estimatedCostUsd,
+        totalRequests: current.totalRequests,
+        errorRate: current.totalRequests === 0 ? 0 : current.totalErrors / current.totalRequests
+    })));
+    return {
+        markRequestStarted,
+        recordCompleted,
+        snapshot,
+        dashboardSnapshot
+    };
+});
+export const MetricsCollectorLive = Layer.effect(MetricsCollector, makeMetricsCollector());
+//# sourceMappingURL=Metrics.js.map

package/dist/observability/Metrics.js.map

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

package/dist/observability/Redaction.d.ts

@@ -0,0 +1,8 @@
+import type { JsonValue } from "../providers/CliSupport.ts";
+export interface RedactionOptions {
+    readonly secrets?: ReadonlyArray<string>;
+    readonly maxLength?: number;
+}
+export declare const redactText: (text: string, options?: RedactionOptions) => string;
+export declare const sanitizeFields: (fields: Readonly<Record<string, JsonValue>>, options?: RedactionOptions) => Readonly<Record<string, JsonValue>>;
+//# sourceMappingURL=Redaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Redaction.d.ts","sourceRoot":"","sources":["../../src/observability/Redaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAQD,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,EAAE,UAAS,gBAAqB,KAAG,MAYzE,CAAA;AAoBD,eAAO,MAAM,cAAc,GACzB,QAAQ,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,EAC3C,UAAS,gBAAqB,KAC7B,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAMlC,CAAA"}

package/dist/observability/Redaction.js

@@ -0,0 +1,38 @@
+const sensitiveKey = /(?:api[-_]?key|authorization|cookie|password|secret|token)/i;
+const credentialPatterns = [
+    /\bBearer\s+[A-Za-z0-9._~+/=-]+\b/gi,
+    /\b(?:sk|xox[baprs]|gh[opusr])[-_][A-Za-z0-9_-]{8,}\b/g
+];
+export const redactText = (text, options = {}) => {
+    let redacted = text;
+    for (const secret of options.secrets ?? []) {
+        if (secret.length > 0) {
+            redacted = redacted.split(secret).join("[REDACTED]");
+        }
+    }
+    for (const pattern of credentialPatterns) {
+        redacted = redacted.replace(pattern, "[REDACTED]");
+    }
+    const maxLength = Math.max(0, options.maxLength ?? 2_048);
+    return redacted.length <= maxLength ? redacted : `${redacted.slice(0, maxLength)}…[TRUNCATED]`;
+};
+const sanitizeValue = (value, options) => {
+    if (typeof value === "string") {
+        return redactText(value, options);
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => sanitizeValue(item, options));
+    }
+    if (value !== null && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([key, child]) => [
+            key,
+            sensitiveKey.test(key) ? "[REDACTED]" : sanitizeValue(child, options)
+        ]));
+    }
+    return value;
+};
+export const sanitizeFields = (fields, options = {}) => Object.fromEntries(Object.entries(fields).map(([key, value]) => [
+    key,
+    sensitiveKey.test(key) ? "[REDACTED]" : sanitizeValue(value, options)
+]));
+//# sourceMappingURL=Redaction.js.map

package/dist/observability/Redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Redaction.js","sourceRoot":"","sources":["../../src/observability/Redaction.ts"],"names":[],"mappings":"AAOA,MAAM,YAAY,GAAG,6DAA6D,CAAA;AAClF,MAAM,kBAAkB,GAA0B;IAChD,oCAAoC;IACpC,uDAAuD;CACxD,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,UAA4B,EAAE,EAAU,EAAE;IACjF,IAAI,QAAQ,GAAG,IAAI,CAAA;IACnB,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QAC3C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QACtD,CAAC;IACH,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,kBAAkB,EAAE,CAAC;QACzC,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;IACpD,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC,CAAA;IACzD,OAAO,QAAQ,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,cAAc,CAAA;AAChG,CAAC,CAAA;AAED,MAAM,aAAa,GAAG,CAAC,KAAgB,EAAE,OAAyB,EAAa,EAAE;IAC/E,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IACnC,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;IAC1D,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;YAC1C,GAAG;YACH,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC;SACtE,CAAC,CACH,CAAA;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,MAA2C,EAC3C,UAA4B,EAAE,EACO,EAAE,CACvC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;IAC3C,GAAG;IACH,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC;CACtE,CAAC,CACH,CAAA"}

package/dist/observability/StreamRecorder.d.ts

@@ -0,0 +1,9 @@
+import * as Effect from "effect/Effect";
+export interface StreamRecorder {
+    readonly rawLine: (provider: string, model: string | undefined, line: string) => Effect.Effect<void>;
+    readonly streamError: (provider: string, model: string | undefined, message: string) => Effect.Effect<void>;
+}
+export declare const noopStreamRecorder: StreamRecorder;
+export declare const currentStreamRecorder: Effect.Effect<StreamRecorder>;
+export declare const withStreamRecorder: (recorder: StreamRecorder) => <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+//# sourceMappingURL=StreamRecorder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StreamRecorder.d.ts","sourceRoot":"","sources":["../../src/observability/StreamRecorder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,CAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,EAAE,MAAM,KACT,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACxB,QAAQ,CAAC,WAAW,EAAE,CACpB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,EAAE,MAAM,KACZ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CACzB;AAED,eAAO,MAAM,kBAAkB,EAAE,cAGhC,CAAA;AAOD,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,CAAC,cAAc,CAAyB,CAAA;AAEzF,eAAO,MAAM,kBAAkB,GAC5B,UAAU,cAAc,MACxB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CACA,CAAA"}

package/dist/observability/StreamRecorder.js

@@ -0,0 +1,10 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+export const noopStreamRecorder = {
+    rawLine: (_provider, _model, _line) => Effect.void,
+    streamError: (_provider, _model, _message) => Effect.void
+};
+const CurrentStreamRecorder = Context.Reference("@llm4ts/core/observability/CurrentStreamRecorder", { defaultValue: () => noopStreamRecorder });
+export const currentStreamRecorder = CurrentStreamRecorder;
+export const withStreamRecorder = (recorder) => (effect) => Effect.provideService(effect, CurrentStreamRecorder, recorder);
+//# sourceMappingURL=StreamRecorder.js.map

package/dist/observability/StreamRecorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamRecorder.js","sourceRoot":"","sources":["../../src/observability/StreamRecorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAevC,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI;IAClD,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI;CAC1D,CAAA;AAED,MAAM,qBAAqB,GAAG,OAAO,CAAC,SAAS,CAC7C,kDAAkD,EAClD,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,kBAAkB,EAAE,CAC3C,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAkC,qBAAqB,CAAA;AAEzF,MAAM,CAAC,MAAM,kBAAkB,GAC7B,CAAC,QAAwB,EAAE,EAAE,CAC7B,CAAU,MAA8B,EAA0B,EAAE,CAClE,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,qBAAqB,EAAE,QAAQ,CAAC,CAAA"}

package/dist/observability/StructuredLogger.d.ts

@@ -0,0 +1,31 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+import type { JsonValue } from "../providers/CliSupport.ts";
+import { type RedactionOptions } from "./Redaction.ts";
+import type { TracingServiceShape } from "./Tracing.ts";
+export declare const LogLevel: Schema.Literals<readonly ["Debug", "Info", "Warning", "Error"]>;
+export type LogLevel = typeof LogLevel.Type;
+declare const StructuredLogEvent_base: Schema.Class<StructuredLogEvent, Schema.Struct<{
+    readonly level: Schema.Literals<readonly ["Debug", "Info", "Warning", "Error"]>;
+    readonly message: Schema.String;
+    readonly correlationId: Schema.String;
+    readonly timestamp: Schema.Number;
+    readonly fields: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+}>, {}>;
+export declare class StructuredLogEvent extends StructuredLogEvent_base {
+}
+export interface StructuredLoggerShape {
+    readonly log: (level: LogLevel, message: string, fields?: Readonly<Record<string, JsonValue>>) => Effect.Effect<void>;
+}
+declare const StructuredLogger_base: Context.ServiceClass<StructuredLogger, "@llm4ts/core/observability/StructuredLogger", StructuredLoggerShape>;
+export declare class StructuredLogger extends StructuredLogger_base {
+}
+export interface StructuredLoggerOptions extends RedactionOptions {
+    readonly sink: (event: StructuredLogEvent) => Effect.Effect<void>;
+}
+export declare const makeStructuredLogger: (tracing: TracingServiceShape, options: StructuredLoggerOptions) => StructuredLoggerShape;
+export declare const StructuredLoggerNoop: Layer.Layer<StructuredLogger, never, never>;
+export {};
+//# sourceMappingURL=StructuredLogger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StructuredLogger.d.ts","sourceRoot":"","sources":["../../src/observability/StructuredLogger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAA8B,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAClF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAEvD,eAAO,MAAM,QAAQ,iEAAyD,CAAA;AAC9E,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,CAAA;;;;;;;;AAE3C,qBAAa,kBAAmB,SAAQ,uBAMtC;CAAG;AAEL,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,GAAG,EAAE,CACZ,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,KACzC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CACzB;;AAED,qBAAa,gBAAiB,SAAQ,qBAErC;CAAG;AAEJ,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;IAC/D,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CAClE;AAED,eAAO,MAAM,oBAAoB,GAC/B,SAAS,mBAAmB,EAC5B,SAAS,uBAAuB,KAC/B,qBAkBD,CAAA;AAEF,eAAO,MAAM,oBAAoB,6CAE/B,CAAA"}

package/dist/observability/StructuredLogger.js

@@ -0,0 +1,34 @@
+import * as Clock from "effect/Clock";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+import { redactText, sanitizeFields } from "./Redaction.js";
+export const LogLevel = Schema.Literals(["Debug", "Info", "Warning", "Error"]);
+export class StructuredLogEvent extends Schema.Class("StructuredLogEvent")({
+    level: LogLevel,
+    message: Schema.String,
+    correlationId: Schema.String,
+    timestamp: Schema.Number,
+    fields: Schema.Record(Schema.String, Schema.Json)
+}) {
+}
+export class StructuredLogger extends Context.Service()("@llm4ts/core/observability/StructuredLogger") {
+}
+export const makeStructuredLogger = (tracing, options) => ({
+    log: Effect.fn("@llm4ts/core/observability/StructuredLogger.log")(function* (level, message, fields = {}) {
+        const correlationId = yield* tracing.correlationId;
+        const timestamp = yield* Clock.currentTimeMillis;
+        yield* options.sink(StructuredLogEvent.make({
+            level,
+            message: redactText(message, options),
+            correlationId,
+            timestamp,
+            fields: sanitizeFields(fields, options)
+        }));
+    })
+});
+export const StructuredLoggerNoop = Layer.succeed(StructuredLogger)({
+    log: (_level, _message, _fields) => Effect.void
+});
+//# sourceMappingURL=StructuredLogger.js.map

package/dist/observability/StructuredLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StructuredLogger.js","sourceRoot":"","sources":["../../src/observability/StructuredLogger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAyB,MAAM,gBAAgB,CAAA;AAGlF,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAA;AAG9E,MAAM,OAAO,kBAAmB,SAAQ,MAAM,CAAC,KAAK,CAAqB,oBAAoB,CAAC,CAAC;IAC7F,KAAK,EAAE,QAAQ;IACf,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,aAAa,EAAE,MAAM,CAAC,MAAM;IAC5B,SAAS,EAAE,MAAM,CAAC,MAAM;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC;CAClD,CAAC;CAAG;AAUL,MAAM,OAAO,gBAAiB,SAAQ,OAAO,CAAC,OAAO,EAA2C,CAC9F,6CAA6C,CAC9C;CAAG;AAMJ,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,OAA4B,EAC5B,OAAgC,EACT,EAAE,CAAC,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC,iDAAiD,CAAC,CAAC,QAAQ,CAAC,EACzE,KAAe,EACf,OAAe,EACf,SAA8C,EAAE;QAEhD,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,aAAa,CAAA;QAClD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAA;QAChD,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CACjB,kBAAkB,CAAC,IAAI,CAAC;YACtB,KAAK;YACL,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC;YACrC,aAAa;YACb,SAAS;YACT,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC;SACxC,CAAC,CACH,CAAA;IACH,CAAC,CAAC;CACH,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAClE,GAAG,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI;CAChD,CAAC,CAAA"}

package/dist/observability/Tracing.d.ts

@@ -0,0 +1,38 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+import type { JsonValue } from "../providers/CliSupport.ts";
+import { type RedactionOptions } from "./Redaction.ts";
+export declare const TraceStatus: Schema.Literals<readonly ["Ok", "Error"]>;
+export type TraceStatus = typeof TraceStatus.Type;
+declare const TraceSpan_base: Schema.Class<TraceSpan, Schema.Struct<{
+    readonly traceId: Schema.String;
+    readonly spanId: Schema.String;
+    readonly parentSpanId: Schema.optionalKey<Schema.String>;
+    readonly correlationId: Schema.String;
+    readonly name: Schema.String;
+    readonly status: Schema.Literals<readonly ["Ok", "Error"]>;
+    readonly startedAt: Schema.Number;
+    readonly endedAt: Schema.Number;
+    readonly attributes: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    readonly errorMessage: Schema.optionalKey<Schema.String>;
+}>, {}>;
+export declare class TraceSpan extends TraceSpan_base {
+}
+export interface TracingServiceShape {
+    readonly withCorrelationId: <A, E, R>(id: string, effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+    readonly correlationId: Effect.Effect<string>;
+    readonly inSpan: <A, E, R>(name: string, attributes: Readonly<Record<string, JsonValue>>, effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+    readonly recordedSpans: Effect.Effect<ReadonlyArray<TraceSpan>>;
+}
+declare const TracingService_base: Context.ServiceClass<TracingService, "@llm4ts/core/observability/TracingService", TracingServiceShape>;
+export declare class TracingService extends TracingService_base {
+}
+export interface TracingOptions extends RedactionOptions {
+    readonly makeId?: Effect.Effect<string>;
+}
+export declare const makeTracingService: (options?: TracingOptions | undefined) => Effect.Effect<TracingServiceShape, never, never>;
+export declare const TracingServiceLive: Layer.Layer<TracingService, never, never>;
+export {};
+//# sourceMappingURL=Tracing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Tracing.d.ts","sourceRoot":"","sources":["../../src/observability/Tracing.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAA8B,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAElF,eAAO,MAAM,WAAW,2CAAmC,CAAA;AAC3D,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAA;;;;;;;;;;;;;AAEjD,qBAAa,SAAU,SAAQ,cAW7B;CAAG;AAaL,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAClC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAC7C,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACvB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,EAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAA;CAChE;;AAED,qBAAa,cAAe,SAAQ,mBAEnC;CAAG;AAEJ,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;CACxC;AAID,eAAO,MAAM,kBAAkB,4FA6E9B,CAAA;AAED,eAAO,MAAM,kBAAkB,2CAAqD,CAAA"}

package/dist/observability/Tracing.js

@@ -0,0 +1,75 @@
+import * as Clock from "effect/Clock";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Layer from "effect/Layer";
+import * as Ref from "effect/Ref";
+import * as Schema from "effect/Schema";
+import { redactText, sanitizeFields } from "./Redaction.js";
+export const TraceStatus = Schema.Literals(["Ok", "Error"]);
+export class TraceSpan extends Schema.Class("TraceSpan")({
+    traceId: Schema.String,
+    spanId: Schema.String,
+    parentSpanId: Schema.optionalKey(Schema.String),
+    correlationId: Schema.String,
+    name: Schema.String,
+    status: TraceStatus,
+    startedAt: Schema.Number,
+    endedAt: Schema.Number,
+    attributes: Schema.Record(Schema.String, Schema.Json),
+    errorMessage: Schema.optionalKey(Schema.String)
+}) {
+}
+const CurrentTraceContext = Context.Reference("@llm4ts/core/observability/CurrentTraceContext", { defaultValue: () => undefined });
+export class TracingService extends Context.Service()("@llm4ts/core/observability/TracingService") {
+}
+const defaultId = Effect.sync(() => globalThis.crypto.randomUUID());
+export const makeTracingService = Effect.fn("@llm4ts/core/observability/TracingService.make")(function* (options = {}) {
+    const spans = yield* Ref.make([]);
+    const makeId = options.makeId ?? defaultId;
+    const correlationId = Effect.flatMap(CurrentTraceContext, (current) => current === undefined ? makeId : Effect.succeed(current.correlationId));
+    const withCorrelationId = (id, effect) => Effect.flatMap(CurrentTraceContext, (current) => Effect.provideService(effect, CurrentTraceContext, {
+        traceId: current?.traceId ?? id,
+        spanId: current?.spanId ?? id,
+        correlationId: id
+    }));
+    const inSpan = (name, attributes, effect) => Effect.gen(function* () {
+        const parent = yield* CurrentTraceContext;
+        const correlation = yield* correlationId;
+        const traceId = parent?.traceId ?? (yield* makeId);
+        const spanId = yield* makeId;
+        const startedAt = yield* Clock.currentTimeMillis;
+        const next = {
+            traceId,
+            spanId,
+            correlationId: correlation
+        };
+        return yield* Effect.provideService(effect.pipe(Effect.onExit((exit) => Clock.currentTimeMillis.pipe(Effect.flatMap((endedAt) => Ref.update(spans, (current) => [
+            ...current,
+            TraceSpan.make({
+                traceId,
+                spanId,
+                ...(parent === undefined ? {} : { parentSpanId: parent.spanId }),
+                correlationId: correlation,
+                name,
+                status: Exit.isSuccess(exit) ? "Ok" : "Error",
+                startedAt,
+                endedAt,
+                attributes: sanitizeFields(attributes, options),
+                ...(Exit.isFailure(exit)
+                    ? {
+                        errorMessage: redactText(String(exit.cause), options)
+                    }
+                    : {})
+            })
+        ]))))), CurrentTraceContext, next);
+    });
+    return {
+        withCorrelationId,
+        correlationId,
+        inSpan,
+        recordedSpans: Ref.get(spans)
+    };
+});
+export const TracingServiceLive = Layer.effect(TracingService, makeTracingService());
+//# sourceMappingURL=Tracing.js.map

package/dist/observability/Tracing.js.map

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

package/dist/providers/AnthropicModels.d.ts

@@ -0,0 +1,95 @@
+import * as Schema from "effect/Schema";
+declare const AnthropicMessage_base: Schema.Class<AnthropicMessage, Schema.Struct<{
+    readonly role: Schema.String;
+    readonly content: Schema.String;
+}>, {}>;
+export declare class AnthropicMessage extends AnthropicMessage_base {
+}
+declare const AnthropicRequest_base: Schema.Class<AnthropicRequest, Schema.Struct<{
+    readonly model: Schema.String;
+    readonly max_tokens: Schema.Int;
+    readonly messages: Schema.$Array<typeof AnthropicMessage>;
+    readonly temperature: Schema.optionalKey<Schema.Number>;
+    readonly system: Schema.optionalKey<Schema.String>;
+    readonly stream: Schema.optionalKey<Schema.Boolean>;
+}>, {}>;
+export declare class AnthropicRequest extends AnthropicRequest_base {
+}
+declare const AnthropicContentBlock_base: Schema.Class<AnthropicContentBlock, Schema.Struct<{
+    readonly type: Schema.String;
+    readonly text: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+}>, {}>;
+export declare class AnthropicContentBlock extends AnthropicContentBlock_base {
+}
+declare const AnthropicUsage_base: Schema.Class<AnthropicUsage, Schema.Struct<{
+    readonly input_tokens: Schema.optionalKey<Schema.Int>;
+    readonly output_tokens: Schema.optionalKey<Schema.Int>;
+}>, {}>;
+export declare class AnthropicUsage extends AnthropicUsage_base {
+}
+declare const AnthropicResponse_base: Schema.Class<AnthropicResponse, Schema.Struct<{
+    readonly id: Schema.optionalKey<Schema.String>;
+    readonly content: Schema.$Array<typeof AnthropicContentBlock>;
+    readonly model: Schema.optionalKey<Schema.String>;
+    readonly usage: Schema.optionalKey<typeof AnthropicUsage>;
+    readonly stop_reason: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+}>, {}>;
+export declare class AnthropicResponse extends AnthropicResponse_base {
+}
+declare const AnthropicToolInputSchema_base: Schema.Class<AnthropicToolInputSchema, Schema.Struct<{
+    readonly type: Schema.String;
+    readonly properties: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    readonly required: Schema.optionalKey<Schema.$Array<Schema.String>>;
+}>, {}>;
+export declare class AnthropicToolInputSchema extends AnthropicToolInputSchema_base {
+}
+declare const AnthropicTool_base: Schema.Class<AnthropicTool, Schema.Struct<{
+    readonly name: Schema.String;
+    readonly description: Schema.String;
+    readonly input_schema: typeof AnthropicToolInputSchema;
+}>, {}>;
+export declare class AnthropicTool extends AnthropicTool_base {
+}
+declare const AnthropicContentBlockFull_base: Schema.Class<AnthropicContentBlockFull, Schema.Struct<{
+    readonly type: Schema.String;
+    readonly text: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+    readonly id: Schema.optionalKey<Schema.String>;
+    readonly name: Schema.optionalKey<Schema.String>;
+    readonly input: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+}>, {}>;
+export declare class AnthropicContentBlockFull extends AnthropicContentBlockFull_base {
+}
+declare const AnthropicRequestWithTools_base: Schema.Class<AnthropicRequestWithTools, Schema.Struct<{
+    readonly model: Schema.String;
+    readonly max_tokens: Schema.Int;
+    readonly messages: Schema.$Array<typeof AnthropicMessage>;
+    readonly tools: Schema.$Array<typeof AnthropicTool>;
+    readonly temperature: Schema.optionalKey<Schema.Number>;
+    readonly system: Schema.optionalKey<Schema.String>;
+}>, {}>;
+export declare class AnthropicRequestWithTools extends AnthropicRequestWithTools_base {
+}
+declare const AnthropicResponseWithTools_base: Schema.Class<AnthropicResponseWithTools, Schema.Struct<{
+    readonly id: Schema.optionalKey<Schema.String>;
+    readonly content: Schema.$Array<typeof AnthropicContentBlockFull>;
+    readonly model: Schema.optionalKey<Schema.String>;
+    readonly usage: Schema.optionalKey<typeof AnthropicUsage>;
+    readonly stop_reason: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+}>, {}>;
+export declare class AnthropicResponseWithTools extends AnthropicResponseWithTools_base {
+}
+declare const AnthropicStreamChunkDelta_base: Schema.Class<AnthropicStreamChunkDelta, Schema.Struct<{
+    readonly type: Schema.optionalKey<Schema.String>;
+    readonly text: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+    readonly stop_reason: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+}>, {}>;
+export declare class AnthropicStreamChunkDelta extends AnthropicStreamChunkDelta_base {
+}
+declare const AnthropicStreamChunk_base: Schema.Class<AnthropicStreamChunk, Schema.Struct<{
+    readonly type: Schema.String;
+    readonly delta: Schema.optionalKey<typeof AnthropicStreamChunkDelta>;
+}>, {}>;
+export declare class AnthropicStreamChunk extends AnthropicStreamChunk_base {
+}
+export {};
+//# sourceMappingURL=AnthropicModels.d.ts.map

package/dist/providers/AnthropicModels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnthropicModels.d.ts","sourceRoot":"","sources":["../../src/providers/AnthropicModels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;;;;;AAGvC,qBAAa,gBAAiB,SAAQ,qBAGpC;CAAG;;;;;;;;;AAEL,qBAAa,gBAAiB,SAAQ,qBAOpC;CAAG;;;;;AAEL,qBAAa,qBAAsB,SAAQ,0BAKzC;CAAG;;;;;AAEL,qBAAa,cAAe,SAAQ,mBAGlC;CAAG;;;;;;;;AAEL,qBAAa,iBAAkB,SAAQ,sBAMrC;CAAG;;;;;;AAEL,qBAAa,wBAAyB,SAAQ,6BAM5C;CAAG;;;;;;AAEL,qBAAa,aAAc,SAAQ,kBAIjC;CAAG;;;;;;;;AAEL,qBAAa,yBAA0B,SAAQ,8BAQ7C;CAAG;;;;;;;;;AAEL,qBAAa,yBAA0B,SAAQ,8BAS7C;CAAG;;;;;;;;AAEL,qBAAa,0BAA2B,SAAQ,+BAQ9C;CAAG;;;;;;AAEL,qBAAa,yBAA0B,SAAQ,8BAM7C;CAAG;;;;;AAEL,qBAAa,oBAAqB,SAAQ,yBAKxC;CAAG"}

package/dist/providers/AnthropicModels.js

@@ -0,0 +1,83 @@
+import * as Schema from "effect/Schema";
+import { JsonSchema } from "../Models.js";
+export class AnthropicMessage extends Schema.Class("AnthropicMessage")({
+    role: Schema.String,
+    content: Schema.String
+}) {
+}
+export class AnthropicRequest extends Schema.Class("AnthropicRequest")({
+    model: Schema.String,
+    max_tokens: Schema.Int,
+    messages: Schema.Array(AnthropicMessage),
+    temperature: Schema.optionalKey(Schema.Number),
+    system: Schema.optionalKey(Schema.String),
+    stream: Schema.optionalKey(Schema.Boolean)
+}) {
+}
+export class AnthropicContentBlock extends Schema.Class("AnthropicContentBlock")({
+    type: Schema.String,
+    text: Schema.optionalKey(Schema.NullOr(Schema.String))
+}) {
+}
+export class AnthropicUsage extends Schema.Class("AnthropicUsage")({
+    input_tokens: Schema.optionalKey(Schema.Int),
+    output_tokens: Schema.optionalKey(Schema.Int)
+}) {
+}
+export class AnthropicResponse extends Schema.Class("AnthropicResponse")({
+    id: Schema.optionalKey(Schema.String),
+    content: Schema.Array(AnthropicContentBlock),
+    model: Schema.optionalKey(Schema.String),
+    usage: Schema.optionalKey(AnthropicUsage),
+    stop_reason: Schema.optionalKey(Schema.NullOr(Schema.String))
+}) {
+}
+export class AnthropicToolInputSchema extends Schema.Class("AnthropicToolInputSchema")({
+    type: Schema.String,
+    properties: JsonSchema,
+    required: Schema.optionalKey(Schema.Array(Schema.String))
+}) {
+}
+export class AnthropicTool extends Schema.Class("AnthropicTool")({
+    name: Schema.String,
+    description: Schema.String,
+    input_schema: AnthropicToolInputSchema
+}) {
+}
+export class AnthropicContentBlockFull extends Schema.Class("AnthropicContentBlockFull")({
+    type: Schema.String,
+    text: Schema.optionalKey(Schema.NullOr(Schema.String)),
+    id: Schema.optionalKey(Schema.String),
+    name: Schema.optionalKey(Schema.String),
+    input: Schema.optionalKey(Schema.Json)
+}) {
+}
+export class AnthropicRequestWithTools extends Schema.Class("AnthropicRequestWithTools")({
+    model: Schema.String,
+    max_tokens: Schema.Int,
+    messages: Schema.Array(AnthropicMessage),
+    tools: Schema.Array(AnthropicTool),
+    temperature: Schema.optionalKey(Schema.Number),
+    system: Schema.optionalKey(Schema.String)
+}) {
+}
+export class AnthropicResponseWithTools extends Schema.Class("AnthropicResponseWithTools")({
+    id: Schema.optionalKey(Schema.String),
+    content: Schema.Array(AnthropicContentBlockFull),
+    model: Schema.optionalKey(Schema.String),
+    usage: Schema.optionalKey(AnthropicUsage),
+    stop_reason: Schema.optionalKey(Schema.NullOr(Schema.String))
+}) {
+}
+export class AnthropicStreamChunkDelta extends Schema.Class("AnthropicStreamChunkDelta")({
+    type: Schema.optionalKey(Schema.String),
+    text: Schema.optionalKey(Schema.NullOr(Schema.String)),
+    stop_reason: Schema.optionalKey(Schema.NullOr(Schema.String))
+}) {
+}
+export class AnthropicStreamChunk extends Schema.Class("AnthropicStreamChunk")({
+    type: Schema.String,
+    delta: Schema.optionalKey(AnthropicStreamChunkDelta)
+}) {
+}
+//# sourceMappingURL=AnthropicModels.js.map