@trading-boy/core 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export * from './types/enums.js';
+export * from './types/graph-nodes.js';
+export * from './types/graph-edges.js';
+export * from './types/context-package.js';
+export * from './types/decision-traces.js';
+export * from './types/daily-summary.js';
+export * from './constants/index.js';
+export * from './config/index.js';
+export * from './logging/index.js';
+export * from './errors/index.js';
+export { computeDecisionHash, verifyChain, type ChainVerificationResult, type VerifiableDecision } from './crypto.js';
+export * from './llm/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,KAAK,uBAAuB,EAAE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtH,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+export * from './types/enums.js';
+export * from './types/graph-nodes.js';
+export * from './types/graph-edges.js';
+export * from './types/context-package.js';
+export * from './types/decision-traces.js';
+export * from './types/daily-summary.js';
+export * from './constants/index.js';
+export * from './config/index.js';
+export * from './logging/index.js';
+export * from './errors/index.js';
+export { computeDecisionHash, verifyChain } from './crypto.js';
+export * from './llm/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAyD,MAAM,aAAa,CAAC;AACtH,cAAc,gBAAgB,CAAC"}

package/dist/llm/client.d.ts

@@ -0,0 +1,38 @@
+import { TradingBoyError } from '../errors/index.js';
+import type { LLMClientConfig, LLMCompletionOptions, LLMCompletionResult } from './types.js';
+export declare class LLMError extends TradingBoyError {
+    constructor(message: string);
+}
+export declare class LLMDisabledError extends TradingBoyError {
+    constructor();
+}
+export declare class LLMClient {
+    private readonly primary;
+    private readonly fallback;
+    private readonly config;
+    constructor(config: LLMClientConfig);
+    /**
+     * Send a chat completion request with automatic retry + failover.
+     */
+    complete(options: LLMCompletionOptions): Promise<LLMCompletionResult>;
+    /**
+     * Health check — verify API connectivity.
+     */
+    healthCheck(): Promise<{
+        primary: boolean;
+        fallback: boolean;
+    }>;
+    private sendRequest;
+    private isRetryable;
+}
+/**
+ * Get the singleton LLM client. Reads config from environment.
+ * If ENABLE_LLM is false, returns a stub that throws LLMDisabledError.
+ */
+export declare function getLLMClient(): LLMClient;
+/**
+ * Reset the singleton. Used in tests.
+ * @internal
+ */
+export declare function resetLLMClient(): void;
+//# sourceMappingURL=client.d.ts.map

package/dist/llm/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/llm/client.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAMpB,qBAAa,QAAS,SAAQ,eAAe;gBAC/B,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,gBAAiB,SAAQ,eAAe;;CAOpD;AAID,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAE7B,MAAM,EAAE,eAAe;IAyBnC;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA6C3E;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;YAwBvD,WAAW;IA4CzB,OAAO,CAAC,WAAW;CAYpB;AAOD;;;GAGG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAqBxC;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAGrC"}

package/dist/llm/client.js

@@ -0,0 +1,194 @@
+// ─── LLM Client ───
+//
+// Model-agnostic LLM client with failover. Uses the `openai` npm package
+// as a universal client — works with Anthropic, OpenRouter, Ollama, and
+// any OpenAI-compatible endpoint via configurable baseURL.
+import OpenAI from 'openai';
+import { createLogger } from '../logging/index.js';
+import { TradingBoyError } from '../errors/index.js';
+import { resolveBaseURL, buildLLMConfig } from './config.js';
+const logger = createLogger('llm');
+// ─── Errors ───
+export class LLMError extends TradingBoyError {
+    constructor(message) {
+        super(message, 'LLM_ERROR');
+    }
+}
+export class LLMDisabledError extends TradingBoyError {
+    constructor() {
+        super('LLM features are disabled. Set ENABLE_LLM=true to enable.', 'LLM_DISABLED');
+    }
+}
+// ─── Client ───
+export class LLMClient {
+    primary;
+    fallback;
+    config;
+    constructor(config) {
+        this.config = config;
+        this.primary = new OpenAI({
+            apiKey: config.apiKey || 'ollama',
+            baseURL: resolveBaseURL(config.provider, config.baseURL),
+            timeout: config.timeoutMs ?? 30000,
+            maxRetries: 0, // We handle retries ourselves for failover control
+            defaultHeaders: config.provider === 'openrouter'
+                ? { 'HTTP-Referer': 'https://tradingboy.dev', 'X-Title': 'Trading Boy' }
+                : undefined,
+        });
+        if (config.fallback) {
+            this.fallback = new OpenAI({
+                apiKey: config.fallback.apiKey || config.apiKey || 'ollama',
+                baseURL: resolveBaseURL(config.fallback.provider, config.fallback.baseURL),
+                timeout: config.timeoutMs ?? 30000,
+                maxRetries: 0,
+            });
+        }
+        else {
+            this.fallback = null;
+        }
+    }
+    /**
+     * Send a chat completion request with automatic retry + failover.
+     */
+    async complete(options) {
+        const maxRetries = this.config.maxRetries ?? 2;
+        const model = options.model ?? this.config.model;
+        // Try primary with retries
+        let lastError = null;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            try {
+                const result = await this.sendRequest(this.primary, model, this.config.provider, options);
+                return { ...result, fromFallback: false };
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                if (attempt < maxRetries && this.isRetryable(error)) {
+                    const delayMs = Math.pow(2, attempt) * 1000;
+                    logger.warn({ attempt: attempt + 1, maxRetries, delayMs, error: lastError.message }, 'LLM request failed, retrying');
+                    await sleep(delayMs);
+                }
+            }
+        }
+        // Try fallback if configured
+        if (this.fallback && this.config.fallback) {
+            logger.info('Primary LLM failed, attempting fallback');
+            try {
+                const result = await this.sendRequest(this.fallback, this.config.fallback.model, this.config.fallback.provider, options);
+                return { ...result, fromFallback: true };
+            }
+            catch (fallbackError) {
+                const msg = fallbackError instanceof Error ? fallbackError.message : String(fallbackError);
+                throw new LLMError(`Both primary and fallback LLM failed. Primary: ${lastError?.message}. Fallback: ${msg}`);
+            }
+        }
+        throw new LLMError(`LLM request failed after ${maxRetries + 1} attempts: ${lastError?.message}`);
+    }
+    /**
+     * Health check — verify API connectivity.
+     */
+    async healthCheck() {
+        const checkClient = async (client, model) => {
+            try {
+                await client.chat.completions.create({
+                    model,
+                    messages: [{ role: 'user', content: 'ping' }],
+                    max_tokens: 1,
+                });
+                return true;
+            }
+            catch {
+                return false;
+            }
+        };
+        const primary = await checkClient(this.primary, this.config.model);
+        const fallback = this.fallback && this.config.fallback
+            ? await checkClient(this.fallback, this.config.fallback.model)
+            : false;
+        return { primary, fallback };
+    }
+    // ─── Private ───
+    async sendRequest(client, model, provider, options) {
+        const start = Date.now();
+        const response = await client.chat.completions.create({
+            model,
+            messages: options.messages,
+            temperature: options.temperature ?? 0,
+            max_tokens: options.maxTokens ?? 1024,
+            ...(options.jsonMode ? { response_format: { type: 'json_object' } } : {}),
+        });
+        const latencyMs = Date.now() - start;
+        const choice = response.choices[0];
+        const content = choice?.message?.content ?? '';
+        logger.debug({
+            model: response.model,
+            provider,
+            latencyMs,
+            inputTokens: response.usage?.prompt_tokens,
+            outputTokens: response.usage?.completion_tokens,
+        }, 'LLM request completed');
+        return {
+            content,
+            model: response.model,
+            provider,
+            usage: {
+                inputTokens: response.usage?.prompt_tokens ?? 0,
+                outputTokens: response.usage?.completion_tokens ?? 0,
+                totalTokens: response.usage?.total_tokens ?? 0,
+            },
+            latencyMs,
+        };
+    }
+    isRetryable(error) {
+        // Check for API errors with status codes (rate limit 429, server errors 5xx)
+        const status = error.status;
+        if (typeof status === 'number') {
+            return status === 429 || status >= 500;
+        }
+        // Retry on network errors
+        if (error instanceof Error && (error.message.includes('ECONNREFUSED') || error.message.includes('timeout'))) {
+            return true;
+        }
+        return false;
+    }
+}
+// ─── Singleton ───
+let _client = null;
+let _stubClient = null;
+/**
+ * Get the singleton LLM client. Reads config from environment.
+ * If ENABLE_LLM is false, returns a stub that throws LLMDisabledError.
+ */
+export function getLLMClient() {
+    const enableLLM = process.env.ENABLE_LLM === 'true';
+    if (!enableLLM) {
+        if (!_stubClient) {
+            _stubClient = new Proxy({}, {
+                get(_, prop) {
+                    if (prop === 'complete' || prop === 'healthCheck') {
+                        return () => { throw new LLMDisabledError(); };
+                    }
+                    return undefined;
+                },
+            });
+        }
+        return _stubClient;
+    }
+    if (!_client) {
+        const config = buildLLMConfig(process.env);
+        _client = new LLMClient(config);
+    }
+    return _client;
+}
+/**
+ * Reset the singleton. Used in tests.
+ * @internal
+ */
+export function resetLLMClient() {
+    _client = null;
+    _stubClient = null;
+}
+// ─── Helpers ───
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=client.js.map

package/dist/llm/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/llm/client.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,EAAE;AACF,yEAAyE;AACzE,wEAAwE;AACxE,2DAA2D;AAE3D,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAO7D,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;AAEnC,iBAAiB;AAEjB,MAAM,OAAO,QAAS,SAAQ,eAAe;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,eAAe;IACnD;QACE,KAAK,CACH,2DAA2D,EAC3D,cAAc,CACf,CAAC;IACJ,CAAC;CACF;AAED,iBAAiB;AAEjB,MAAM,OAAO,SAAS;IACH,OAAO,CAAS;IAChB,QAAQ,CAAgB;IACxB,MAAM,CAAkB;IAEzC,YAAY,MAAuB;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,IAAI,CAAC,OAAO,GAAG,IAAI,MAAM,CAAC;YACxB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,QAAQ;YACjC,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC;YACxD,OAAO,EAAE,MAAM,CAAC,SAAS,IAAI,KAAK;YAClC,UAAU,EAAE,CAAC,EAAE,mDAAmD;YAClE,cAAc,EAAE,MAAM,CAAC,QAAQ,KAAK,YAAY;gBAC9C,CAAC,CAAC,EAAE,cAAc,EAAE,wBAAwB,EAAE,SAAS,EAAE,aAAa,EAAE;gBACxE,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,IAAI,CAAC,QAAQ,GAAG,IAAI,MAAM,CAAC;gBACzB,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,QAAQ;gBAC3D,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAC1E,OAAO,EAAE,MAAM,CAAC,SAAS,IAAI,KAAK;gBAClC,UAAU,EAAE,CAAC;aACd,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACvB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,OAA6B;QAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAEjD,2BAA2B;QAC3B,IAAI,SAAS,GAAiB,IAAI,CAAC;QACnC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YACvD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAC1F,OAAO,EAAE,GAAG,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;YAC5C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBACtE,IAAI,OAAO,GAAG,UAAU,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;oBACpD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;oBAC5C,MAAM,CAAC,IAAI,CACT,EAAE,OAAO,EAAE,OAAO,GAAG,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,EACvE,8BAA8B,CAC/B,CAAC;oBACF,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;QAED,6BAA6B;QAC7B,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;YACvD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CACnC,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAC7B,OAAO,CACR,CAAC;gBACF,OAAO,EAAE,GAAG,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;YAC3C,CAAC;YAAC,OAAO,aAAa,EAAE,CAAC;gBACvB,MAAM,GAAG,GAAG,aAAa,YAAY,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;gBAC3F,MAAM,IAAI,QAAQ,CAChB,kDAAkD,SAAS,EAAE,OAAO,eAAe,GAAG,EAAE,CACzF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,IAAI,QAAQ,CAAC,4BAA4B,UAAU,GAAG,CAAC,cAAc,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IACnG,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,MAAM,WAAW,GAAG,KAAK,EAAE,MAAc,EAAE,KAAa,EAAoB,EAAE;YAC5E,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;oBACnC,KAAK;oBACL,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;oBAC7C,UAAU,EAAE,CAAC;iBACd,CAAC,CAAC;gBACH,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ;YACpD,CAAC,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAC9D,CAAC,CAAC,KAAK,CAAC;QAEV,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAC/B,CAAC;IAED,kBAAkB;IAEV,KAAK,CAAC,WAAW,CACvB,MAAc,EACd,KAAa,EACb,QAAgB,EAChB,OAA6B;QAE7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEzB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;YACpD,KAAK;YACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,CAAC;YACrC,UAAU,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;YACrC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,aAAsB,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnF,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACrC,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;QAE/C,MAAM,CAAC,KAAK,CACV;YACE,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,QAAQ;YACR,SAAS;YACT,WAAW,EAAE,QAAQ,CAAC,KAAK,EAAE,aAAa;YAC1C,YAAY,EAAE,QAAQ,CAAC,KAAK,EAAE,iBAAiB;SAChD,EACD,uBAAuB,CACxB,CAAC;QAEF,OAAO;YACL,OAAO;YACP,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,QAAQ;YACR,KAAK,EAAE;gBACL,WAAW,EAAE,QAAQ,CAAC,KAAK,EAAE,aAAa,IAAI,CAAC;gBAC/C,YAAY,EAAE,QAAQ,CAAC,KAAK,EAAE,iBAAiB,IAAI,CAAC;gBACpD,WAAW,EAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC;aAC/C;YACD,SAAS;SACV,CAAC;IACJ,CAAC;IAEO,WAAW,CAAC,KAAc;QAChC,6EAA6E;QAC7E,MAAM,MAAM,GAAI,KAA6B,CAAC,MAAM,CAAC;QACrD,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,OAAO,MAAM,KAAK,GAAG,IAAI,MAAM,IAAI,GAAG,CAAC;QACzC,CAAC;QACD,0BAA0B;QAC1B,IAAI,KAAK,YAAY,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;YAC5G,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,oBAAoB;AAEpB,IAAI,OAAO,GAAqB,IAAI,CAAC;AACrC,IAAI,WAAW,GAAqB,IAAI,CAAC;AAEzC;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,MAAM,CAAC;IACpD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,WAAW,GAAG,IAAI,KAAK,CAAC,EAAe,EAAE;gBACvC,GAAG,CAAC,CAAC,EAAE,IAAI;oBACT,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;wBAClD,OAAO,GAAG,EAAE,GAAG,MAAM,IAAI,gBAAgB,EAAE,CAAC,CAAC,CAAC,CAAC;oBACjD,CAAC;oBACD,OAAO,SAAS,CAAC;gBACnB,CAAC;aACF,CAAC,CAAC;QACL,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,GAAyC,CAAC,CAAC;QACjF,OAAO,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,GAAG,IAAI,CAAC;IACf,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC;AAED,kBAAkB;AAElB,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/llm/config.d.ts

@@ -0,0 +1,12 @@
+import type { LLMClientConfig } from './types.js';
+/**
+ * Resolve the base URL for a provider.
+ * User-provided override takes precedence over preset.
+ */
+export declare function resolveBaseURL(provider: string, override?: string): string;
+/**
+ * Build LLMClientConfig from environment variables.
+ * Called by getLLMClient() singleton.
+ */
+export declare function buildLLMConfig(env: Record<string, string | undefined>): LLMClientConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/llm/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/llm/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,YAAY,CAAC;AAU/D;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAG1E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,eAAe,CA0BvF"}

package/dist/llm/config.js

@@ -0,0 +1,47 @@
+// ─── LLM Config ───
+//
+// Resolves provider-specific base URLs and builds LLMClientConfig from env.
+// ─── Provider Base URLs ───
+const PROVIDER_BASE_URLS = {
+    anthropic: 'https://api.anthropic.com/v1/',
+    openrouter: 'https://openrouter.ai/api/v1',
+    ollama: 'http://localhost:11434/v1',
+};
+/**
+ * Resolve the base URL for a provider.
+ * User-provided override takes precedence over preset.
+ */
+export function resolveBaseURL(provider, override) {
+    if (override)
+        return override;
+    return PROVIDER_BASE_URLS[provider] ?? '';
+}
+/**
+ * Build LLMClientConfig from environment variables.
+ * Called by getLLMClient() singleton.
+ */
+export function buildLLMConfig(env) {
+    const provider = (env.LLM_PROVIDER ?? 'anthropic');
+    const apiKey = env.LLM_API_KEY ?? env.ANTHROPIC_API_KEY ?? '';
+    const model = env.LLM_MODEL ?? 'claude-sonnet-4-6';
+    const config = {
+        provider,
+        apiKey,
+        baseURL: env.LLM_BASE_URL || undefined,
+        model,
+        maxRetries: env.LLM_MAX_RETRIES ? parseInt(env.LLM_MAX_RETRIES, 10) : 2,
+        timeoutMs: env.LLM_TIMEOUT_MS ? parseInt(env.LLM_TIMEOUT_MS, 10) : 30000,
+    };
+    // Configure fallback if specified
+    const fallbackProvider = env.LLM_FALLBACK_PROVIDER;
+    const fallbackModel = env.LLM_FALLBACK_MODEL;
+    if (fallbackProvider && fallbackModel) {
+        config.fallback = {
+            provider: fallbackProvider,
+            apiKey: env.LLM_FALLBACK_API_KEY,
+            model: fallbackModel,
+        };
+    }
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/llm/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/llm/config.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,EAAE;AACF,4EAA4E;AAI5E,6BAA6B;AAE7B,MAAM,kBAAkB,GAA2B;IACjD,SAAS,EAAE,+BAA+B;IAC1C,UAAU,EAAE,8BAA8B;IAC1C,MAAM,EAAE,2BAA2B;CACpC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,QAAiB;IAChE,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,OAAO,kBAAkB,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAuC;IACpE,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,YAAY,IAAI,WAAW,CAAgB,CAAC;IAClE,MAAM,MAAM,GAAG,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC;IAC9D,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,IAAI,mBAAmB,CAAC;IAEnD,MAAM,MAAM,GAAoB;QAC9B,QAAQ;QACR,MAAM;QACN,OAAO,EAAE,GAAG,CAAC,YAAY,IAAI,SAAS;QACtC,KAAK;QACL,UAAU,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACvE,SAAS,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK;KACzE,CAAC;IAEF,kCAAkC;IAClC,MAAM,gBAAgB,GAAG,GAAG,CAAC,qBAAqB,CAAC;IACnD,MAAM,aAAa,GAAG,GAAG,CAAC,kBAAkB,CAAC;IAC7C,IAAI,gBAAgB,IAAI,aAAa,EAAE,CAAC;QACtC,MAAM,CAAC,QAAQ,GAAG;YAChB,QAAQ,EAAE,gBAA+B;YACzC,MAAM,EAAE,GAAG,CAAC,oBAAoB;YAChC,KAAK,EAAE,aAAa;SACrB,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/llm/index.d.ts

@@ -0,0 +1,5 @@
+export type { LLMProvider, LLMClientConfig, LLMMessage, LLMCompletionOptions, LLMCompletionResult, } from './types.js';
+export { LLMClient, LLMError, LLMDisabledError, getLLMClient, resetLLMClient, } from './client.js';
+export { extractStructured, StructuredOutputError, type ExtractOptions, type ExtractResult, } from './structured-output.js';
+export { resolveBaseURL, buildLLMConfig } from './config.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,eAAe,EACf,UAAU,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,YAAY,EACZ,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/llm/index.js

@@ -0,0 +1,4 @@
+export { LLMClient, LLMError, LLMDisabledError, getLLMClient, resetLLMClient, } from './client.js';
+export { extractStructured, StructuredOutputError, } from './structured-output.js';
+export { resolveBaseURL, buildLLMConfig } from './config.js';
+//# sourceMappingURL=index.js.map

package/dist/llm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,YAAY,EACZ,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,iBAAiB,EACjB,qBAAqB,GAGtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/llm/structured-output.d.ts

@@ -0,0 +1,31 @@
+import type { z } from 'zod';
+import { TradingBoyError } from '../errors/index.js';
+import type { LLMClient } from './client.js';
+import type { LLMCompletionResult, LLMMessage } from './types.js';
+export declare class StructuredOutputError extends TradingBoyError {
+    constructor(message: string);
+}
+export interface ExtractOptions {
+    messages: LLMMessage[];
+    schemaDescription?: string;
+    temperature?: number;
+    maxTokens?: number;
+    maxRetries?: number;
+}
+export interface ExtractResult<T> {
+    data: T;
+    raw: string;
+    meta: LLMCompletionResult;
+    retried: boolean;
+}
+/**
+ * Extract structured data from an LLM response using Zod validation.
+ *
+ * 1. Appends schema description to messages (if provided)
+ * 2. Sends request with jsonMode=true
+ * 3. Parses response with schema
+ * 4. If validation fails, retries once with error feedback
+ * 5. If second attempt fails, throws StructuredOutputError
+ */
+export declare function extractStructured<T>(client: LLMClient, schema: z.ZodSchema<T>, options: ExtractOptions): Promise<ExtractResult<T>>;
+//# sourceMappingURL=structured-output.d.ts.map

package/dist/llm/structured-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-output.d.ts","sourceRoot":"","sources":["../../src/llm/structured-output.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAMlE,qBAAa,qBAAsB,SAAQ,eAAe;gBAC5C,OAAO,EAAE,MAAM;CAG5B;AAID,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC;IACR,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;CAClB;AAID;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAwD3B"}

package/dist/llm/structured-output.js

@@ -0,0 +1,69 @@
+// ─── Structured Output Helper ───
+//
+// Zod-validated JSON extraction from LLM responses. Sends a completion
+// request with jsonMode, parses the response with the provided schema,
+// and retries once with error feedback if validation fails.
+import { createLogger } from '../logging/index.js';
+import { TradingBoyError } from '../errors/index.js';
+const logger = createLogger('llm-structured');
+// ─── Errors ───
+export class StructuredOutputError extends TradingBoyError {
+    constructor(message) {
+        super(message, 'STRUCTURED_OUTPUT_ERROR');
+    }
+}
+// ─── Extract ───
+/**
+ * Extract structured data from an LLM response using Zod validation.
+ *
+ * 1. Appends schema description to messages (if provided)
+ * 2. Sends request with jsonMode=true
+ * 3. Parses response with schema
+ * 4. If validation fails, retries once with error feedback
+ * 5. If second attempt fails, throws StructuredOutputError
+ */
+export async function extractStructured(client, schema, options) {
+    const maxRetries = options.maxRetries ?? 1;
+    const messages = [...options.messages];
+    // Add schema description hint to system message if provided
+    if (options.schemaDescription) {
+        messages.push({
+            role: 'user',
+            content: `Respond with a JSON object matching this schema: ${options.schemaDescription}. Output ONLY valid JSON, no markdown or explanation.`,
+        });
+    }
+    let lastRaw = '';
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        const result = await client.complete({
+            messages,
+            temperature: options.temperature ?? 0,
+            maxTokens: options.maxTokens ?? 1024,
+            jsonMode: true,
+        });
+        lastRaw = result.content;
+        try {
+            const parsed = JSON.parse(result.content);
+            const validated = schema.parse(parsed);
+            return {
+                data: validated,
+                raw: result.content,
+                meta: result,
+                retried: attempt > 0,
+            };
+        }
+        catch (parseError) {
+            const errorMsg = parseError instanceof Error ? parseError.message : String(parseError);
+            if (attempt < maxRetries) {
+                logger.warn({ attempt: attempt + 1, error: errorMsg }, 'Structured output validation failed, retrying with error feedback');
+                // Add error feedback for retry
+                messages.push({ role: 'assistant', content: result.content });
+                messages.push({
+                    role: 'user',
+                    content: `Your JSON response was invalid: ${errorMsg}. Fix the errors and respond with valid JSON only.`,
+                });
+            }
+        }
+    }
+    throw new StructuredOutputError(`Failed to extract valid structured output after ${maxRetries + 1} attempts. Last response: ${lastRaw.slice(0, 200)}`);
+}
+//# sourceMappingURL=structured-output.js.map

package/dist/llm/structured-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-output.js","sourceRoot":"","sources":["../../src/llm/structured-output.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,EAAE;AACF,uEAAuE;AACvE,uEAAuE;AACvE,4DAA4D;AAG5D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAIrD,MAAM,MAAM,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;AAE9C,iBAAiB;AAEjB,MAAM,OAAO,qBAAsB,SAAQ,eAAe;IACxD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,yBAAyB,CAAC,CAAC;IAC5C,CAAC;CACF;AAmBD,kBAAkB;AAElB;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAiB,EACjB,MAAsB,EACtB,OAAuB;IAEvB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEvC,4DAA4D;IAC5D,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,oDAAoD,OAAO,CAAC,iBAAiB,uDAAuD;SAC9I,CAAC,CAAC;IACL,CAAC;IAED,IAAI,OAAO,GAAG,EAAE,CAAC;IAEjB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC;YACnC,QAAQ;YACR,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,CAAC;YACrC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;YACpC,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QAEH,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAEzB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAEvC,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,GAAG,EAAE,MAAM,CAAC,OAAO;gBACnB,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,OAAO,GAAG,CAAC;aACrB,CAAC;QACJ,CAAC;QAAC,OAAO,UAAU,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,UAAU,YAAY,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAEvF,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;gBACzB,MAAM,CAAC,IAAI,CACT,EAAE,OAAO,EAAE,OAAO,GAAG,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EACzC,mEAAmE,CACpE,CAAC;gBAEF,+BAA+B;gBAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC9D,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,mCAAmC,QAAQ,oDAAoD;iBACzG,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,qBAAqB,CAC7B,mDAAmD,UAAU,GAAG,CAAC,6BAA6B,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CACtH,CAAC;AACJ,CAAC"}

package/dist/llm/types.d.ts

@@ -0,0 +1,39 @@
+export type LLMProvider = 'anthropic' | 'openrouter' | 'ollama' | 'custom';
+export interface LLMClientConfig {
+    provider: LLMProvider;
+    apiKey: string;
+    baseURL?: string;
+    model: string;
+    maxRetries?: number;
+    timeoutMs?: number;
+    fallback?: {
+        provider: LLMProvider;
+        apiKey?: string;
+        baseURL?: string;
+        model: string;
+    };
+}
+export interface LLMMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface LLMCompletionOptions {
+    messages: LLMMessage[];
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    jsonMode?: boolean;
+}
+export interface LLMCompletionResult {
+    content: string;
+    model: string;
+    provider: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+    };
+    latencyMs: number;
+    fromFallback: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3E,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,WAAW,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE;QACT,QAAQ,EAAE,WAAW,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;CACvB"}

package/dist/llm/types.js

@@ -0,0 +1,6 @@
+// ─── LLM Types ───
+//
+// Shared types for the model-agnostic LLM client.
+// Uses OpenAI-compatible message format (works with Anthropic, OpenRouter, Ollama).
+export {};
+//# sourceMappingURL=types.js.map

package/dist/llm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,EAAE;AACF,kDAAkD;AAClD,oFAAoF"}

package/dist/logging/index.d.ts

@@ -0,0 +1,2 @@
+export { logger, createLogger, REDACT_PATHS, type Logger } from './logger.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/logging/index.js

@@ -0,0 +1,2 @@
+export { logger, createLogger, REDACT_PATHS } from './logger.js';
+//# sourceMappingURL=index.js.map

package/dist/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAe,MAAM,aAAa,CAAC"}

package/dist/logging/logger.d.ts

@@ -0,0 +1,7 @@
+import { type Logger } from 'pino';
+export declare const REDACT_PATHS: string[];
+declare const baseLogger: Logger;
+export declare function createLogger(name: string): Logger;
+export { baseLogger as logger };
+export type { Logger };
+//# sourceMappingURL=logger.d.ts.map

package/dist/logging/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logging/logger.ts"],"names":[],"mappings":"AAAA,OAAa,EAAE,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AAmDzC,eAAO,MAAM,YAAY,UAAuD,CAAC;AAEjF,QAAA,MAAM,UAAU,EAAE,MAahB,CAAC;AAEH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,OAAO,EAAE,UAAU,IAAI,MAAM,EAAE,CAAC;AAChC,YAAY,EAAE,MAAM,EAAE,CAAC"}

package/dist/logging/logger.js

@@ -0,0 +1,66 @@
+import pino from 'pino';
+const isDev = process.env.NODE_ENV !== 'production';
+/**
+ * Sensitive field names that must be redacted from all log output.
+ * Auth-related `token` is intentionally included; crypto token fields
+ * use different names (`tokenSymbol`, `tokenAddress`, etc.) and are
+ * not affected.
+ */
+const SENSITIVE_FIELDS = [
+    'password',
+    'apiKey',
+    'api_key',
+    'authorization',
+    'secret',
+    'token',
+    'privateKey',
+    'email',
+    'customer_email',
+    'x-api-key',
+    'stripe_signature',
+];
+/** Maximum object nesting depth to apply redaction. */
+const MAX_REDACT_DEPTH = 5;
+/**
+ * Build redaction paths for a field name at every nesting depth from 0
+ * up to MAX_REDACT_DEPTH.
+ *
+ * Pino uses `@pinojs/redact` which supports single `*` wildcards (one
+ * level) but not `**` recursive globs. We therefore generate explicit
+ * paths for each depth:
+ *   depth 0  → `password`
+ *   depth 1  → `*.password`
+ *   depth 2  → `*.*.password`
+ *   ...
+ */
+function buildRedactPaths(fields, maxDepth) {
+    const paths = [];
+    for (const field of fields) {
+        for (let depth = 0; depth <= maxDepth; depth++) {
+            const prefix = '*.'
+                .repeat(depth);
+            paths.push(`${prefix}${field}`);
+        }
+    }
+    return paths;
+}
+export const REDACT_PATHS = buildRedactPaths(SENSITIVE_FIELDS, MAX_REDACT_DEPTH);
+const baseLogger = pino({
+    name: 'trading-boy',
+    level: process.env.LOG_LEVEL ?? 'info',
+    redact: {
+        paths: REDACT_PATHS,
+        censor: '[REDACTED]',
+    },
+    ...(isDev && {
+        transport: {
+            target: 'pino-pretty',
+            options: { destination: 2 },
+        },
+    }),
+});
+export function createLogger(name) {
+    return baseLogger.child({ component: name });
+}
+export { baseLogger as logger };
+//# sourceMappingURL=logger.js.map

package/dist/logging/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logging/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAqB,MAAM,MAAM,CAAC;AAEzC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,gBAAgB,GAAG;IACvB,UAAU;IACV,QAAQ;IACR,SAAS;IACT,eAAe;IACf,QAAQ;IACR,OAAO;IACP,YAAY;IACZ,OAAO;IACP,gBAAgB;IAChB,WAAW;IACX,kBAAkB;CACV,CAAC;AAEX,uDAAuD;AACvD,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAE3B;;;;;;;;;;;GAWG;AACH,SAAS,gBAAgB,CAAC,MAAyB,EAAE,QAAgB;IACnE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC;YAC/C,MAAM,MAAM,GAAG,IAAI;iBAChB,MAAM,CAAC,KAAK,CAAC,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,KAAK,EAAE,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,gBAAgB,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;AAEjF,MAAM,UAAU,GAAW,IAAI,CAAC;IAC9B,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;IACtC,MAAM,EAAE;QACN,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,YAAY;KACrB;IACD,GAAG,CAAC,KAAK,IAAI;QACX,SAAS,EAAE;YACT,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE;SAC5B;KACF,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,UAAU,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,OAAO,EAAE,UAAU,IAAI,MAAM,EAAE,CAAC"}