@discomedia/utils 1.0.6 → 1.0.8

package/dist/types-frontend/alpaca-trading-api.d.ts

@@ -0,0 +1,315 @@
+import { AlpacaAccountDetails, AlpacaCredentials, AlpacaPosition, AssetClass, GetOptionContractsParams, GetOrdersParams, OptionAccountActivity, OptionContract, OptionContractsResponse, AlpacaOrder, OrderLeg, TradeUpdate } from './types/alpaca-types';
+/**
+Websocket example
+  const alpacaAPI = createAlpacaTradingAPI(credentials); // type AlpacaCredentials
+  alpacaAPI.onTradeUpdate((update: TradeUpdate) => {
+   this.log(`Received trade update: event ${update.event} for an order to ${update.order.side} ${update.order.qty} of ${update.order.symbol}`);
+  });
+  alpacaAPI.connectWebsocket(); // necessary to connect to the WebSocket
+*/
+export declare class AlpacaTradingAPI {
+    static new(credentials: AlpacaCredentials): AlpacaTradingAPI;
+    static getInstance(credentials: AlpacaCredentials): AlpacaTradingAPI;
+    private ws;
+    private headers;
+    private tradeUpdateCallback;
+    private credentials;
+    private apiBaseUrl;
+    private wsUrl;
+    private authenticated;
+    private connecting;
+    private reconnectDelay;
+    private reconnectTimeout;
+    private messageHandlers;
+    private debugLogging;
+    /**
+     * Constructor for AlpacaTradingAPI
+     * @param credentials - Alpaca credentials,
+     *   accountName: string; // The account identifier used inthis.logs and tracking
+     *   apiKey: string; // Alpaca API key
+     *   apiSecret: string; // Alpaca API secret
+     *   type: AlpacaAccountType;
+     *   orderType: AlpacaOrderType;
+     * @param options - Optional options
+     *   debugLogging: boolean; // Whether to log messages of type 'debug'
+     */
+    constructor(credentials: AlpacaCredentials, options?: {
+        debugLogging?: boolean;
+    });
+    private log;
+    /**
+     * Round a price to the nearest 2 decimal places for Alpaca, or 4 decimal places for prices less than $1
+     * @param price - The price to round
+     * @returns The rounded price
+     */
+    private roundPriceForAlpaca;
+    private handleAuthMessage;
+    private handleListenMessage;
+    private handleTradeUpdate;
+    private handleMessage;
+    connectWebsocket(): void;
+    private authenticate;
+    private subscribeToTradeUpdates;
+    private makeRequest;
+    getPositions(assetClass?: AssetClass): Promise<AlpacaPosition[]>;
+    /**
+     * Get all orders
+     * @param params (GetOrdersParams) - optional parameters to filter the orders
+     * - status: 'open' | 'closed' | 'all'
+     * - limit: number
+     * - after: string
+     * - until: string
+     * - direction: 'asc' | 'desc'
+     * - nested: boolean
+     * - symbols: string[], an array of all the symbols
+     * - side: 'buy' | 'sell'
+     * @returns all orders
+     */
+    getOrders(params?: GetOrdersParams): Promise<AlpacaOrder[]>;
+    getAccountDetails(): Promise<AlpacaAccountDetails>;
+    /**
+     * Create a trailing stop order
+     * @param symbol (string) - the symbol of the order
+     * @param qty (number) - the quantity of the order
+     * @param side (string) - the side of the order
+     * @param trailPercent100 (number) - the trail percent of the order (scale 100, i.e. 0.5 = 0.5%)
+     * @param position_intent (string) - the position intent of the order
+     */
+    createTrailingStop(symbol: string, qty: number, side: 'buy' | 'sell', trailPercent100: number, position_intent: 'buy_to_open' | 'buy_to_close' | 'sell_to_open' | 'sell_to_close'): Promise<void>;
+    /**
+     * Create a market order
+     * @param symbol (string) - the symbol of the order
+     * @param qty (number) - the quantity of the order
+     * @param side (string) - the side of the order
+     * @param position_intent (string) - the position intent of the order. Important for knowing if a position needs a trailing stop.
+     */
+    createMarketOrder(symbol: string, qty: number, side: 'buy' | 'sell', position_intent: 'buy_to_open' | 'buy_to_close' | 'sell_to_open' | 'sell_to_close', client_order_id?: string): Promise<AlpacaOrder>;
+    /**
+     * Get the current trail percent for a symbol, assuming that it has an open position and a trailing stop order to close it. Because this relies on an orders request for one symbol, you can't do it too often.
+     * @param symbol (string) - the symbol of the order
+     * @returns the current trail percent
+     */
+    getCurrentTrailPercent(symbol: string): Promise<number | null>;
+    /**
+     * Update the trail percent for a trailing stop order
+     * @param symbol (string) - the symbol of the order
+     * @param trailPercent100 (number) - the trail percent of the order (scale 100, i.e. 0.5 = 0.5%)
+     */
+    updateTrailingStop(symbol: string, trailPercent100: number): Promise<void>;
+    /**
+     * Cancel all open orders
+     */
+    cancelAllOrders(): Promise<void>;
+    /**
+     * Cancel a specific order by its ID
+     * @param orderId The id of the order to cancel
+     * @throws Error if the order is not cancelable (status 422) or if the order doesn't exist
+     * @returns Promise that resolves when the order is successfully canceled
+     */
+    cancelOrder(orderId: string): Promise<void>;
+    /**
+     * Create a limit order
+     * @param symbol (string) - the symbol of the order
+     * @param qty (number) - the quantity of the order
+     * @param side (string) - the side of the order
+     * @param limitPrice (number) - the limit price of the order
+     * @param position_intent (string) - the position intent of the order
+     * @param extended_hours (boolean) - whether the order is in extended hours
+     * @param client_order_id (string) - the client order id of the order
+     */
+    createLimitOrder(symbol: string, qty: number, side: 'buy' | 'sell', limitPrice: number, position_intent: 'buy_to_open' | 'buy_to_close' | 'sell_to_open' | 'sell_to_close', extended_hours?: boolean, client_order_id?: string): Promise<AlpacaOrder>;
+    /**
+     * Close all equities positions
+     * @param options (object) - the options for closing the positions
+     * - cancel_orders (boolean) - whether to cancel related orders
+     * - useLimitOrders (boolean) - whether to use limit orders to close the positions
+     */
+    closeAllPositions(options?: {
+        cancel_orders: boolean;
+        useLimitOrders: boolean;
+    }): Promise<void>;
+    /**
+     * Close all equities positions using limit orders during extended hours trading
+     * @param cancelOrders Whether to cancel related orders (default: true)
+     * @returns Promise that resolves when all positions are closed
+     */
+    closeAllPositionsAfterHours(): Promise<void>;
+    onTradeUpdate(callback: (update: TradeUpdate) => void): void;
+    /**
+     * Get portfolio history for the account
+     * @param params Parameters for the portfolio history request
+     * @returns Portfolio history data
+     */
+    getPortfolioHistory(params: {
+        timeframe?: '1Min' | '5Min' | '15Min' | '1H' | '1D';
+        period?: string;
+        extended_hours?: boolean;
+        date_end?: string;
+    }): Promise<{
+        timestamp: number[];
+        equity: number[];
+        profit_loss: number[];
+        profit_loss_pct: number[];
+        base_value: number;
+        timeframe: string;
+    }>;
+    /**
+     * Get option contracts based on specified parameters
+     * @param params Parameters to filter option contracts
+     * @returns Option contracts matching the criteria
+     */
+    getOptionContracts(params: GetOptionContractsParams): Promise<OptionContractsResponse>;
+    /**
+     * Get a specific option contract by symbol or ID
+     * @param symbolOrId The symbol or ID of the option contract
+     * @returns The option contract details
+     */
+    getOptionContract(symbolOrId: string): Promise<OptionContract>;
+    /**
+     * Create a simple option order (market or limit)
+     * @param symbol Option contract symbol
+     * @param qty Quantity of contracts (must be a whole number)
+     * @param side Buy or sell
+     * @param position_intent Position intent (buy_to_open, buy_to_close, sell_to_open, sell_to_close)
+     * @param type Order type (market or limit)
+     * @param limitPrice Limit price (required for limit orders)
+     * @returns The created order
+     */
+    createOptionOrder(symbol: string, qty: number, side: 'buy' | 'sell', position_intent: 'buy_to_open' | 'buy_to_close' | 'sell_to_open' | 'sell_to_close', type: 'market' | 'limit', limitPrice?: number): Promise<AlpacaOrder>;
+    /**
+     * Create a multi-leg option order
+     * @param legs Array of order legs
+     * @param qty Quantity of the multi-leg order (must be a whole number)
+     * @param type Order type (market or limit)
+     * @param limitPrice Limit price (required for limit orders)
+     * @returns The created multi-leg order
+     */
+    createMultiLegOptionOrder(legs: OrderLeg[], qty: number, type: 'market' | 'limit', limitPrice?: number): Promise<AlpacaOrder>;
+    /**
+     * Exercise an option contract
+     * @param symbolOrContractId The symbol or ID of the option contract to exercise
+     * @returns Response from the exercise request
+     */
+    exerciseOption(symbolOrContractId: string): Promise<any>;
+    /**
+     * Get option positions
+     * @returns Array of option positions
+     */
+    getOptionPositions(): Promise<AlpacaPosition[]>;
+    getOptionsOpenSpreadTrades(): Promise<void>;
+    /**
+     * Get option account activities (exercises, assignments, expirations)
+     * @param activityType Type of option activity to filter by
+     * @param date Date to filter activities (YYYY-MM-DD format)
+     * @returns Array of option account activities
+     */
+    getOptionActivities(activityType?: 'OPEXC' | 'OPASN' | 'OPEXP', date?: string): Promise<OptionAccountActivity[]>;
+    /**
+     * Create a long call spread (buy lower strike call, sell higher strike call)
+     * @param lowerStrikeCallSymbol Symbol of the lower strike call option
+     * @param higherStrikeCallSymbol Symbol of the higher strike call option
+     * @param qty Quantity of spreads to create (must be a whole number)
+     * @param limitPrice Limit price for the spread
+     * @returns The created multi-leg order
+     */
+    createLongCallSpread(lowerStrikeCallSymbol: string, higherStrikeCallSymbol: string, qty: number, limitPrice: number): Promise<AlpacaOrder>;
+    /**
+     * Create a long put spread (buy higher strike put, sell lower strike put)
+     * @param higherStrikePutSymbol Symbol of the higher strike put option
+     * @param lowerStrikePutSymbol Symbol of the lower strike put option
+     * @param qty Quantity of spreads to create (must be a whole number)
+     * @param limitPrice Limit price for the spread
+     * @returns The created multi-leg order
+     */
+    createLongPutSpread(higherStrikePutSymbol: string, lowerStrikePutSymbol: string, qty: number, limitPrice: number): Promise<AlpacaOrder>;
+    /**
+     * Create an iron condor (sell call spread and put spread)
+     * @param longPutSymbol Symbol of the lower strike put (long)
+     * @param shortPutSymbol Symbol of the higher strike put (short)
+     * @param shortCallSymbol Symbol of the lower strike call (short)
+     * @param longCallSymbol Symbol of the higher strike call (long)
+     * @param qty Quantity of iron condors to create (must be a whole number)
+     * @param limitPrice Limit price for the iron condor (credit)
+     * @returns The created multi-leg order
+     */
+    createIronCondor(longPutSymbol: string, shortPutSymbol: string, shortCallSymbol: string, longCallSymbol: string, qty: number, limitPrice: number): Promise<AlpacaOrder>;
+    /**
+     * Create a covered call (sell call option against owned stock)
+     * @param stockSymbol Symbol of the underlying stock
+     * @param callOptionSymbol Symbol of the call option to sell
+     * @param qty Quantity of covered calls to create (must be a whole number)
+     * @param limitPrice Limit price for the call option
+     * @returns The created order
+     */
+    createCoveredCall(stockSymbol: string, callOptionSymbol: string, qty: number, limitPrice: number): Promise<AlpacaOrder>;
+    /**
+     * Roll an option position to a new expiration or strike
+     * @param currentOptionSymbol Symbol of the current option position
+     * @param newOptionSymbol Symbol of the new option to roll to
+     * @param qty Quantity of options to roll (must be a whole number)
+     * @param currentPositionSide Side of the current position ('buy' or 'sell')
+     * @param limitPrice Net limit price for the roll
+     * @returns The created multi-leg order
+     */
+    rollOptionPosition(currentOptionSymbol: string, newOptionSymbol: string, qty: number, currentPositionSide: 'buy' | 'sell', limitPrice: number): Promise<AlpacaOrder>;
+    /**
+     * Get option chain for a specific underlying symbol and expiration date
+     * @param underlyingSymbol The underlying stock symbol
+     * @param expirationDate The expiration date (YYYY-MM-DD format)
+     * @returns Option contracts for the specified symbol and expiration date
+     */
+    getOptionChain(underlyingSymbol: string, expirationDate: string): Promise<OptionContract[]>;
+    /**
+     * Get all available expiration dates for a specific underlying symbol
+     * @param underlyingSymbol The underlying stock symbol
+     * @returns Array of available expiration dates
+     */
+    getOptionExpirationDates(underlyingSymbol: string): Promise<string[]>;
+    /**
+     * Get the current options trading level for the account
+     * @returns The options trading level (0-3)
+     */
+    getOptionsTradingLevel(): Promise<number>;
+    /**
+     * Check if the account has options trading enabled
+     * @returns Boolean indicating if options trading is enabled
+     */
+    isOptionsEnabled(): Promise<boolean>;
+    /**
+     * Close all option positions
+     * @param cancelOrders Whether to cancel related orders (default: true)
+     * @returns Response from the close positions request
+     */
+    closeAllOptionPositions(cancelOrders?: boolean): Promise<void>;
+    /**
+     * Close a specific option position
+     * @param symbol The option contract symbol
+     * @param qty Optional quantity to close (defaults to entire position)
+     * @returns The created order
+     */
+    closeOptionPosition(symbol: string, qty?: number): Promise<AlpacaOrder>;
+    /**
+     * Create a complete equities trade with optional stop loss and take profit
+     * @param params Trade parameters including symbol, qty, side, and optional referencePrice
+     * @param options Trade options including order type, extended hours, stop loss, and take profit settings
+     * @returns The created order
+     */
+    createEquitiesTrade(params: {
+        symbol: string;
+        qty: number;
+        side: 'buy' | 'sell';
+        referencePrice?: number;
+    }, options?: {
+        type?: 'market' | 'limit';
+        limitPrice?: number;
+        extendedHours?: boolean;
+        useStopLoss?: boolean;
+        stopPrice?: number;
+        stopPercent100?: number;
+        useTakeProfit?: boolean;
+        takeProfitPrice?: number;
+        takeProfitPercent100?: number;
+        clientOrderId?: string;
+    }): Promise<AlpacaOrder>;
+}
+//# sourceMappingURL=alpaca-trading-api.d.ts.map

package/dist/types-frontend/alpaca-trading-api.d.ts.map

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

package/dist/types-frontend/format-tools.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Capitalizes the first letter of a string
+ * @param {string} str - The string to capitalize
+ * @returns {string} The capitalized string, or original value if not a string
+ * @example
+ * capitalize('hello') // 'Hello'
+ * capitalize(123) // 123
+ */
+export declare function capFirstLetter(str: string): string;
+/**
+ * Formats a number as US currency
+ * @param {number} value - The number to format
+ * @returns {string} The formatted currency string (e.g. '$1,234.56')
+ * @example
+ * formatCurrency(1234.56) // '$1,234.56'
+ * formatCurrency(NaN) // '$0.00'
+ */
+export declare function formatCurrency(value: number): string;
+/**
+ * Formats a number with commas
+ * @param {number} value - The number to format
+ * @returns {string} The formatted number string (e.g. '1,234.56')
+ * @example
+ * formatNumber(1234.56) // '1,234.56'
+ * formatNumber(NaN) // '0'
+ */
+export declare function formatNumber(value: number): string;
+/**
+ * Formats a number as a percentage
+ * @param {number} value - The number to format (e.g. 0.75 for 75%)
+ * @param {number} [decimalPlaces=2] - Number of decimal places to show
+ * @returns {string} The formatted percentage string (e.g. '75.00%')
+ * @example
+ * formatPercentage(0.75) // '75.00%'
+ * formatPercentage(0.753, 1) // '75.3%'
+ */
+export declare function formatPercentage(value: number, decimalPlaces?: number): string;
+/**
+ * Formats a Date object to Australian datetime format for Google Sheets
+ * @param {Date} date - The date to format
+ * @returns {string} The formatted datetime string in 'DD/MM/YYYY HH:MM:SS' format
+ * @example
+ * dateTimeForGS(new Date('2025-01-01T12:34:56')) // '01/01/2025 12:34:56'
+ */
+export declare function dateTimeForGS(date: Date): string;
+//# sourceMappingURL=format-tools.d.ts.map

package/dist/types-frontend/format-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-tools.d.ts","sourceRoot":"","sources":["../../src/format-tools.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASpD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,GAAE,MAAU,GAAG,MAAM,CAQjF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAYhD"}

package/dist/types-frontend/index-frontend.d.ts

@@ -0,0 +1,15 @@
+import * as Types from './types';
+import * as llm from './llm-openai';
+import * as llmImages from './llm-images';
+export * from './types';
+export { AlpacaTradingAPI } from './alpaca-trading-api';
+export { AlpacaMarketDataAPI } from './alpaca-market-data-api';
+export declare const disco: {
+    types: typeof Types;
+    llm: {
+        call: typeof llm.makeLLMCall;
+        seek: <T = any>(content: string | import("openai/resources/index").ChatCompletionContentPart[], responseFormat?: Types.OpenAIResponseFormat, options?: Types.LLMOptions) => Promise<Types.LLMResponse<T>>;
+        images: typeof llmImages.makeImagesCall;
+    };
+};
+//# sourceMappingURL=index-frontend.d.ts.map

package/dist/types-frontend/index-frontend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-frontend.d.ts","sourceRoot":"","sources":["../../src/index-frontend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,SAAS,MAAM,cAAc,CAAC;AAI1C,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,eAAO,MAAM,KAAK;;;;;;;CAOjB,CAAC"}

package/dist/types-frontend/index.d.ts

@@ -0,0 +1,126 @@
+import * as mt from './market-time';
+import * as ft from './format-tools';
+import * as Types from './types';
+import * as misc from './misc-utils';
+import * as polygon from './polygon';
+import * as llm from './llm-openai';
+import * as llmImages from './llm-images';
+import * as ta from './technical-analysis';
+export * from './types';
+export { AlpacaTradingAPI } from './alpaca-trading-api';
+export { AlpacaMarketDataAPI } from './alpaca-market-data-api';
+export declare const disco: {
+    types: typeof Types;
+    alpaca: {
+        TradingAPI: typeof Types.AlpacaTradingAPI;
+        MarketDataAPI: typeof Types.AlpacaMarketDataAPI;
+    };
+    format: {
+        capFirstLetter: typeof ft.capFirstLetter;
+        currency: typeof ft.formatCurrency;
+        number: typeof ft.formatNumber;
+        pct: typeof ft.formatPercentage;
+        dateTimeForGS: typeof ft.dateTimeForGS;
+    };
+    indices: {
+        fetchAggregates: (params: Types.PolygonIndicesAggregatesParams, options?: {
+            apiKey?: string;
+        }) => Promise<Types.PolygonIndicesAggregatesResponse>;
+        fetchPreviousClose: (indicesTicker: string, options?: {
+            apiKey?: string;
+        }) => Promise<Types.PolygonIndicesPrevCloseResponse>;
+        fetchDailyOpenClose: (indicesTicker: string, date: string, options?: {
+            apiKey?: string;
+        }) => Promise<Types.PolygonIndicesDailyOpenCloseResponse>;
+        fetchSnapshot: (params?: Types.PolygonIndicesSnapshotParams, options?: {
+            apiKey?: string;
+        }) => Promise<Types.PolygonIndicesSnapshotResponse>;
+        fetchUniversalSnapshot: (tickers: string[], options?: {
+            apiKey?: string;
+            type?: string;
+            order?: string;
+            limit?: number;
+            sort?: string;
+        }) => Promise<any>;
+        formatBarData: (data: Types.PolygonIndicesAggregatesResponse) => Array<{
+            date: string;
+            open: number;
+            high: number;
+            low: number;
+            close: number;
+            timestamp: number;
+        }>;
+    };
+    llm: {
+        call: typeof llm.makeLLMCall;
+        seek: <T = any>(content: string | import("openai/resources/index").ChatCompletionContentPart[], responseFormat?: Types.OpenAIResponseFormat, options?: Types.LLMOptions) => Promise<Types.LLMResponse<T>>;
+        images: typeof llmImages.makeImagesCall;
+    };
+    polygon: {
+        fetchTickerInfo: (symbol: string, options?: {
+            apiKey?: string;
+        }) => Promise<Types.PolygonTickerInfo | null>;
+        fetchGroupedDaily: (date: string, options?: {
+            apiKey?: string;
+            adjusted?: boolean;
+            includeOTC?: boolean;
+        }) => Promise<Types.PolygonGroupedDailyResponse>;
+        fetchLastTrade: (symbol: string, options?: {
+            apiKey?: string;
+        }) => Promise<Types.PolygonQuote>;
+        fetchTrades: (symbol: string, options?: {
+            apiKey?: string;
+            timestamp?: string | number;
+            timestampgt?: string | number;
+            timestampgte?: string | number;
+            timestamplt?: string | number;
+            timestamplte?: string | number;
+            order?: "asc" | "desc";
+            limit?: number;
+            sort?: string;
+        }) => Promise<Types.PolygonTradesResponse>;
+        fetchPrices: (params: {
+            ticker: string;
+            start: number;
+            end?: number;
+            multiplier: number;
+            timespan: string;
+            limit?: number;
+        }, options?: {
+            apiKey?: string;
+        }) => Promise<Types.PolygonPriceData[]>;
+        analysePolygonPriceData: typeof polygon.analysePolygonPriceData;
+        formatPriceData: typeof polygon.formatPriceData;
+        fetchDailyOpenClose: (symbol: string, date?: Date, options?: {
+            apiKey?: string;
+            adjusted?: boolean;
+        }) => Promise<Types.PolygonDailyOpenClose>;
+        getPreviousClose: typeof polygon.getPreviousClose;
+    };
+    ta: {
+        calculateEMA: typeof ta.calculateEMA;
+        calculateMACD: typeof ta.calculateMACD;
+        calculateRSI: typeof ta.calculateRSI;
+        calculateStochasticOscillator: typeof ta.calculateStochasticOscillator;
+        calculateBollingerBands: typeof ta.calculateBollingerBands;
+        calculateSupportAndResistance: typeof ta.calculateSupportAndResistance;
+        calculateFibonacciLevels: typeof ta.calculateFibonacciLevels;
+    };
+    time: {
+        getStartAndEndDates: typeof mt.getStartAndEndDates;
+        getMarketOpenClose: typeof mt.getMarketOpenClose;
+        getLastFullTradingDate: typeof mt.getLastFullTradingDate;
+        getNextMarketDay: typeof mt.getNextMarketDay;
+        getMarketStatus: typeof mt.getMarketStatus;
+        getNYTimeZone: typeof mt.getNYTimeZone;
+        getTradingDate: typeof mt.getTradingDate;
+        getTradingStartAndEndDates: typeof mt.getTradingStartAndEndDates;
+        MARKET_TIMES: Types.MarketTimesConfig;
+    };
+    utils: {
+        logIfDebug: (message: string, data?: unknown, type?: "info" | "warn" | "error" | "debug" | "trace") => void;
+        fetchWithRetry: typeof misc.fetchWithRetry;
+        validatePolygonApiKey: typeof misc.validatePolygonApiKey;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/types-frontend/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,IAAI,MAAM,cAAc,CAAC;AACrC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAErC,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,SAAS,MAAM,cAAc,CAAC;AAG1C,OAAO,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAK3C,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;kBA6BX,CAAC;;;kBAkCkQ,CAAC;;;kBAA4zC,CAAC;;;kBAAkwC,CAAC;;;kBAAisD,CAAC;gBAAkB,CAAC;iBAAmB,CAAC;iBAAmB,CAAC;gBAAkB,CAAC;;;;;;;;;;;;;;;;;;kBA/CjlJ,CAAC;;;kBA+C2xS,CAAC;oBAAsB,CAAC;sBAAyB,CAAC;;;kBAAhxP,CAAC;;;kBAA6jc,CAAC;qBAAuB,CAAC;uBAAkC,CAAC;wBAAmC,CAAC;uBAAkC,CAAC;wBAAmC,CAAC;iBAA4B,CAAC;iBAA2B,CAAC;gBAAkB,CAAC;;;;;eAAjgX,CAAC;;;iBAAiE,CAAC;;kBAAmC,CAAC;;;;;kBAA65Q,CAAC;oBAAsB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CADn5Z,CAAC"}

package/dist/types-frontend/json-tools.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Fix a broken JSON string by attempting to extract and parse valid JSON content. This function is very lenient and will attempt to fix many types of JSON errors, including unbalanced brackets, missing or extra commas, improperly escaped $ signs, unquoted strings, trailing commas, missing closing brackets or braces, etc.
+ * @param {string} jsonStr - The broken JSON string to fix
+ * @returns {JsonValue} - The parsed JSON value
+ */
+export declare function fixBrokenJson(jsonStr: string): JsonValue;
+/**
+ * Returns true if the given JSON string is valid, false otherwise.
+ *
+ * This function simply attempts to parse the given string as JSON and returns true if successful, or false if an error is thrown.
+ *
+ * @param {string} jsonString The JSON string to validate.
+ * @returns {boolean} True if the JSON string is valid, false otherwise.
+ */
+export declare function isValidJson(jsonString: string): boolean;
+interface JsonObject {
+    [key: string]: JsonValue;
+}
+type JsonArray = JsonValue[];
+type JsonValue = string | number | boolean | null | JsonObject | JsonArray;
+/**
+ * Fixes broken JSON by sending it to the OpenAI GPT-4.1-mini model as a chat completion.
+ * The GPT-4.1-mini model is a large language model that can understand and generate code,
+ * including JSON. The returned JSON is the fixed version of the input JSON.
+ * If the model fails to return valid JSON, an error is thrown.
+ * @param jsonStr - the broken JSON to fix
+ * @param apiKey - the OpenAI API key to use, or undefined to use the value of the OPENAI_API_KEY environment variable
+ * @returns the fixed JSON
+ * @throws an error if the model fails to return valid JSON
+ */
+export declare function fixJsonWithAI(jsonStr: string, apiKey?: string): Promise<JsonValue>;
+export {};
+//# sourceMappingURL=json-tools.d.ts.map

package/dist/types-frontend/json-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-tools.d.ts","sourceRoot":"","sources":["../../src/json-tools.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAmMxD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAOvD;AAGD,UAAU,UAAU;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AACD,KAAK,SAAS,GAAG,SAAS,EAAE,CAAC;AAC7B,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,UAAU,GAAG,SAAS,CAAC;AAqB3E;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CA+BxF"}

package/dist/types-frontend/llm-config.d.ts

@@ -0,0 +1,36 @@
+export declare const DEFAULT_MODEL = "gpt-4.1-mini";
+export declare const DEFAULT_DEVELOPER_PROMPT = "\n    You are a highly experienced coding, business analyst, and financial analyst associate.\n    Help with coding, business process design and analysis, data generation and refinement, content creation, financial analysis, and more.\n    When presented with a coding problem, logic problem, or other problem benefiting from systematic thinking, think through it step by step before giving your final answer.\n    Present complete, high-confidence, final answers only. Do not rephrase to be more brief or omit parts of answers.\n    Respond only with final content (e.g. code, a json or yaml object, a formatted string, or a markdown document) and nothing else. Do not reply with a preamble, introduction, or conclusion.\n";
+interface AIModelCosts {
+    [modelName: string]: {
+        inputCost: number;
+        outputCost: number;
+        cacheHitCost?: number;
+    };
+}
+/** Token costs in USD per 1M tokens. Last updated Feb 2025. */
+export declare const openAiModelCosts: AIModelCosts;
+export declare const deepseekModelCosts: AIModelCosts;
+/** Image generation costs in USD per image. Based on OpenAI pricing as of Feb 2025. */
+export declare const openAiImageCosts: Record<string, number>;
+/**
+ * Calculates the cost of generating images using OpenAI's Images API.
+ *
+ * @param model The image generation model name.
+ * @param imageCount The number of images generated.
+ * @returns The cost of generating the images in USD.
+ */
+export declare function calculateImageCost(model: string, imageCount: number): number;
+/**
+ * Calculates the cost of calling a language model in USD based on the provider and model, tokens, and given costs per 1M tokens.
+ *
+ * @param provider The provider of the language model. Supported providers are 'openai' and 'deepseek'.
+ * @param model The name of the language model. Supported models are listed in the `openAiModelCosts` and `deepseekModelCosts` objects.
+ * @param inputTokens The number of input tokens passed to the language model.
+ * @param outputTokens The number of output tokens generated by the language model.
+ * @param reasoningTokens The number of output tokens generated by the language model for reasoning. This is only used for Deepseek models.
+ * @param cacheHitTokens The number of input tokens that were cache hits for Deepseek models.
+ * @returns The cost of calling the language model in USD.
+ */
+export declare function calculateCost(provider: string, model: string, inputTokens: number, outputTokens: number, reasoningTokens?: number, cacheHitTokens?: number): number;
+export {};
+//# sourceMappingURL=llm-config.d.ts.map

package/dist/types-frontend/llm-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-config.d.ts","sourceRoot":"","sources":["../../src/llm-config.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,iBAAiB,CAAC;AAE5C,eAAO,MAAM,wBAAwB,wtBAMpC,CAAC;AAEF,UAAU,YAAY;IACpB,CAAC,SAAS,EAAE,MAAM,GAAG;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,+DAA+D;AAC/D,eAAO,MAAM,gBAAgB,EAAE,YAyC9B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,YAWhC,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAEnD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAS5E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,eAAe,CAAC,EAAE,MAAM,EACxB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CA0BR"}

package/dist/types-frontend/llm-deepseek.d.ts

@@ -0,0 +1,12 @@
+import { ChatCompletionContentPart } from 'openai/resources/chat';
+import { LLMResponse, LLMOptions, OpenAIResponseFormat } from './types';
+/**
+ * Makes a call to the Deepseek AI API.
+ *
+ * @param content The content to pass to the LLM. Can be a string or an array of content parts.
+ * @param responseFormat The format of the response. Defaults to 'json'.
+ * @param options Configuration options including model ('deepseek-chat' or 'deepseek-reasoner'), tools, and apiKey.
+ * @return A promise that resolves to the response from the Deepseek API.
+ */
+export declare const makeDeepseekCall: <T = any>(content: string | ChatCompletionContentPart[], responseFormat?: OpenAIResponseFormat, options?: LLMOptions) => Promise<LLMResponse<T>>;
+//# sourceMappingURL=llm-deepseek.d.ts.map

package/dist/types-frontend/llm-deepseek.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-deepseek.d.ts","sourceRoot":"","sources":["../../src/llm-deepseek.ts"],"names":[],"mappings":"AACA,OAAO,EACL,yBAAyB,EAG1B,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAAE,WAAW,EAAE,UAAU,EAAe,oBAAoB,EAA2B,MAAM,SAAS,CAAC;AAyL9G;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,GAAU,CAAC,GAAG,GAAG,EAC5C,SAAS,MAAM,GAAG,yBAAyB,EAAE,EAC7C,iBAAgB,oBAA6B,EAC7C,UAAS,UAAe,KACvB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAkIxB,CAAC"}