@forgecharts/sdk 1.3.9 → 1.3.10

package/dist/server/index.js

@@ -0,0 +1,1051 @@
+// src/server/tools.ts
+function getAgentTools() {
+  return [
+    // ─── Chart Navigation ──────────────────────────────────────────────
+    {
+      name: "chart_get_state",
+      description: "Get the current state of the chart including symbol, timeframe, type, and visible range.",
+      input_schema: {
+        type: "object",
+        properties: {},
+        required: []
+      }
+    },
+    {
+      name: "chart_set_symbol",
+      description: 'Change the currently displayed symbol (ticker). For futures, use continuous notation (e.g., "CME:ES1!") or specific contracts (e.g., "CME:ESM2026"). Always include the exchange prefix for futures.',
+      input_schema: {
+        type: "object",
+        properties: {
+          symbol: {
+            type: "string",
+            description: 'Symbol to display. Examples: "AAPL", "BTCUSD", "CME:ES1!" (continuous), "CME:ESM2026" (specific month)'
+          }
+        },
+        required: ["symbol"]
+      }
+    },
+    {
+      name: "contract_get_info",
+      description: "Get futures contract information for a symbol: whether it is continuous or specific, the current front-month contract, and a list of upcoming available contracts. Call this BEFORE switching futures symbols to help the user choose between continuous and specific contracts.",
+      input_schema: {
+        type: "object",
+        properties: {
+          symbol: {
+            type: "string",
+            description: 'Futures symbol to look up (e.g., "ES", "ES1!", "CME:ESM2026", "CL"). Defaults to the current chart symbol if omitted.'
+          }
+        },
+        required: []
+      }
+    },
+    {
+      name: "chart_set_timeframe",
+      description: 'Change the chart timeframe (e.g., "1m", "5m", "1h", "1d").',
+      input_schema: {
+        type: "object",
+        properties: {
+          timeframe: { type: "string", description: "Timeframe identifier (1m, 5m, 15m, 1h, 4h, 1d, 1w, etc.)" }
+        },
+        required: ["timeframe"]
+      }
+    },
+    {
+      name: "chart_set_type",
+      description: "Change the chart type (candlestick, line, area, bar, etc.).",
+      input_schema: {
+        type: "object",
+        properties: {
+          type: { type: "string", description: "Chart type (candlestick, line, area, bar, renko, etc.)" }
+        },
+        required: ["type"]
+      }
+    },
+    {
+      name: "chart_scroll_to_date",
+      description: "Scroll the chart to a specific date/timestamp.",
+      input_schema: {
+        type: "object",
+        properties: {
+          timestamp: { type: "number", description: "Unix timestamp (seconds) to scroll to" }
+        },
+        required: ["timestamp"]
+      }
+    },
+    {
+      name: "chart_set_visible_range",
+      description: "Set the visible price range (Y-axis) on the chart.",
+      input_schema: {
+        type: "object",
+        properties: {
+          minPrice: { type: "number", description: "Minimum price to display" },
+          maxPrice: { type: "number", description: "Maximum price to display" }
+        },
+        required: ["minPrice", "maxPrice"]
+      }
+    },
+    // ─── Market Data ──────────────────────────────────────────────────
+    {
+      name: "data_get_bars",
+      description: "Fetch OHLCV bars for analysis. CRITICAL: Always call this BEFORE placing drawings to find exact price levels.",
+      input_schema: {
+        type: "object",
+        properties: {
+          symbol: { type: "string", description: "Symbol to fetch bars for" },
+          timeframe: { type: "string", description: "Timeframe (1m, 5m, 1h, 1d, etc.)" },
+          limit: {
+            type: "number",
+            description: "Number of bars to fetch (default 100)"
+          },
+          from: {
+            type: "number",
+            description: "Unix timestamp (seconds) to start from (optional)"
+          },
+          to: {
+            type: "number",
+            description: "Unix timestamp (seconds) to end at (optional)"
+          }
+        },
+        required: ["symbol", "timeframe"]
+      }
+    },
+    {
+      name: "data_get_realtime_quote",
+      description: "Get the current bid/ask/last price for a symbol.",
+      input_schema: {
+        type: "object",
+        properties: {
+          symbol: { type: "string", description: "Symbol to fetch quote for" }
+        },
+        required: ["symbol"]
+      }
+    },
+    {
+      name: "data_get_session_ohlc",
+      description: "Get current session OHLC stats (open, high, low, last, settlement) for a symbol.",
+      input_schema: {
+        type: "object",
+        properties: {
+          symbol: { type: "string", description: "Symbol to fetch session OHLC for (optional, uses current chart symbol if not provided)" }
+        },
+        required: []
+      }
+    },
+    // ─── Indicators ───────────────────────────────────────────────────
+    {
+      name: "indicator_list",
+      description: "List all indicators currently applied to the chart.",
+      input_schema: {
+        type: "object",
+        properties: {},
+        required: []
+      }
+    },
+    {
+      name: "indicator_add",
+      description: 'Add a built-in technical indicator to the chart. ALWAYS prefer this over ForgeScript for standard indicators. Built-in types: "sma", "ema", "wma", "rsi", "macd", "bbands" (Bollinger Bands), "stochastic", "atr", "obv", "volume". Overlay indicators (sma, ema, wma, bbands) render on the price chart; non-overlay indicators (rsi, macd, stochastic, atr, obv, volume) get their own sub-pane. Built-in indicators include a full settings dialog (gear icon) for users to adjust parameters.',
+      input_schema: {
+        type: "object",
+        properties: {
+          type: { type: "string", description: "Indicator type in lowercase: ema, sma, wma, rsi, macd, bbands, stochastic, atr, obv, volume" },
+          params: {
+            type: "object",
+            description: 'Indicator parameters. Examples: {"period": 50} for EMA/SMA, {"period":20,"maType":"sma","source":"close","multiplier":2,"offset":0} for bbands (maType: "sma"|"ema"|"wma"; source: "close"|"open"|"high"|"low"|"hl2"|"hlc3"|"ohlc4"), {"fast":12,"slow":26,"signal":9} for MACD'
+          },
+          overlay: {
+            type: "boolean",
+            description: "Whether to render on the price chart (true) or in a separate sub-pane (false). Defaults are automatic per type \u2014 only set this to override the default placement."
+          },
+          visible: {
+            type: "boolean",
+            description: "Whether the indicator should be visible (default true)"
+          },
+          style: {
+            type: "object",
+            description: 'Optional visual style overrides. Keys: line1, line2, line3 (each with color, width, lineStyle: "solid"|"dashed"|"dotted", visible), fill1 (color, opacity 0-1, visible). Example for bbands: {"line1":{"color":"#ff0000"},"line2":{"color":"#00ff00","width":2},"fill1":{"opacity":0.15}}'
+          }
+        },
+        required: ["type"]
+      }
+    },
+    {
+      name: "indicator_remove",
+      description: "Remove an indicator from the chart.",
+      input_schema: {
+        type: "object",
+        properties: {
+          indicatorId: { type: "string", description: "ID of the indicator to remove" }
+        },
+        required: ["indicatorId"]
+      }
+    },
+    {
+      name: "indicator_update_params",
+      description: "Update parameters of an existing indicator.",
+      input_schema: {
+        type: "object",
+        properties: {
+          indicatorId: { type: "string", description: "ID of the indicator" },
+          params: {
+            type: "object",
+            description: "New parameters to apply"
+          }
+        },
+        required: ["indicatorId", "params"]
+      }
+    },
+    {
+      name: "indicator_set_visible",
+      description: "Show or hide an indicator.",
+      input_schema: {
+        type: "object",
+        properties: {
+          indicatorId: { type: "string", description: "ID of the indicator" },
+          visible: { type: "boolean", description: "Whether to show (true) or hide (false)" }
+        },
+        required: ["indicatorId", "visible"]
+      }
+    },
+    {
+      name: "indicator_list_available",
+      description: "Return full registry of available indicator names and their parameter schemas.",
+      input_schema: {
+        type: "object",
+        properties: {},
+        required: []
+      }
+    },
+    {
+      name: "indicator_get_values",
+      description: "Return computed output series values for a running indicator.",
+      input_schema: {
+        type: "object",
+        properties: {
+          indicatorId: { type: "string", description: "ID of the indicator" },
+          limit: { type: "number", description: "Maximum number of values to return (default 100)" }
+        },
+        required: ["indicatorId"]
+      }
+    },
+    // ─── Drawings ─────────────────────────────────────────────────────
+    {
+      name: "drawing_list",
+      description: "List all drawings on the chart (trend lines, support/resistance, annotations).",
+      input_schema: {
+        type: "object",
+        properties: {},
+        required: []
+      }
+    },
+    {
+      name: "drawing_add",
+      description: "Draw on the chart (trend line, horizontal line, rectangle, text annotation, fibonacci tools, etc.). Always fetch bars first with data_get_bars to find exact price levels.",
+      input_schema: {
+        type: "object",
+        properties: {
+          type: {
+            type: "string",
+            description: 'Drawing type: "trendline", "extended_line", "ray", "horizontal_ray", "horizontal_line", "vertical_line", "fibonacci_retracement", "fibonacci_extension", "fibonacci_fan", "pitchfork", "rectangle", "channel", "text_label", "arrow_up", "arrow_down", "price_label", "gann_fan", "regression_trend"'
+          },
+          p1: {
+            type: "object",
+            description: "First anchor point {time: unix_seconds, price: number}",
+            properties: {
+              time: { type: "number", description: "Unix timestamp (seconds)" },
+              price: { type: "number", description: "Price level" }
+            }
+          },
+          p2: {
+            type: "object",
+            description: "Second anchor point (optional for single-point types) {time: unix_seconds, price: number}",
+            properties: {
+              time: { type: "number", description: "Unix timestamp (seconds)" },
+              price: { type: "number", description: "Price level" }
+            }
+          },
+          p3: {
+            type: "object",
+            description: "Third anchor point (for pitchfork, fibonacci_extension, channel) {time: unix_seconds, price: number}",
+            properties: {
+              time: { type: "number", description: "Unix timestamp (seconds)" },
+              price: { type: "number", description: "Price level" }
+            }
+          },
+          text: {
+            type: "string",
+            description: "Text content for text_label and price_label types"
+          },
+          style: {
+            type: "object",
+            description: "Drawing style properties",
+            properties: {
+              color: { type: "string", description: 'Color in hex format (e.g., "#FF0000")' },
+              lineWidth: { type: "number", description: "Line width in pixels" },
+              lineStyle: { type: "string", description: 'Line style: "solid", "dashed", or "dotted"' },
+              fillColor: { type: "string", description: "Fill color in hex format (optional)" },
+              fillOpacity: { type: "number", description: "Fill opacity from 0 to 1 (optional)" },
+              showLabel: { type: "boolean", description: "Whether to show the label (optional)" }
+            }
+          }
+        },
+        required: ["type", "p1"]
+      }
+    },
+    {
+      name: "drawing_remove",
+      description: "Remove a drawing from the chart.",
+      input_schema: {
+        type: "object",
+        properties: {
+          drawingId: { type: "string", description: "ID of the drawing to remove" }
+        },
+        required: ["drawingId"]
+      }
+    },
+    {
+      name: "drawing_update",
+      description: "Update properties of an existing drawing (move it, change color, etc.).",
+      input_schema: {
+        type: "object",
+        properties: {
+          drawingId: { type: "string", description: "ID of the drawing" },
+          points: {
+            type: "array",
+            description: "New points (optional)",
+            items: { type: "object" }
+          },
+          color: {
+            type: "string",
+            description: "New color in hex format (optional)"
+          },
+          label: {
+            type: "string",
+            description: "New label/text (optional)"
+          }
+        },
+        required: ["drawingId"]
+      }
+    },
+    {
+      name: "drawing_clear_all",
+      description: "DESTRUCTIVE: Remove all drawings from the chart.",
+      input_schema: {
+        type: "object",
+        properties: {},
+        required: []
+      }
+    },
+    {
+      name: "drawing_list_types",
+      description: "Return all supported drawing type identifiers.",
+      input_schema: {
+        type: "object",
+        properties: {},
+        required: []
+      }
+    },
+    // ─── ForgeScript ───────────────────────────────────────────────────
+    {
+      name: "script_list",
+      description: "List all ForgeScript custom indicators saved in the workspace. Returns an array of scripts with id, name, and created_at. Use the id field when calling script_delete or script_get_source.",
+      input_schema: {
+        type: "object",
+        properties: {},
+        required: []
+      }
+    },
+    {
+      name: "script_delete",
+      description: "Delete a ForgeScript indicator permanently. Always call script_list first to get the script id, then confirm with the user before deleting.",
+      input_schema: {
+        type: "object",
+        properties: {
+          scriptId: { type: "string", description: "UUID id of the script to delete (from script_list)" }
+        },
+        required: ["scriptId"]
+      }
+    },
+    {
+      name: "script_get_source",
+      description: "Get the source code of a ForgeScript indicator.",
+      input_schema: {
+        type: "object",
+        properties: {
+          scriptId: { type: "string", description: "ID of the script" }
+        },
+        required: ["scriptId"]
+      }
+    },
+    {
+      name: "script_create",
+      description: "Create a new ForgeScript indicator. Always validate before compiling. IMPORTANT: Every tuneable value (periods, thresholds, multipliers) MUST use input()/input.int()/input.float() with a descriptive title. Every plot colour MUST use input.color() so the user can customise it from the settings dialog. Never hard-code magic numbers or colours.",
+      input_schema: {
+        type: "object",
+        properties: {
+          name: { type: "string", description: "Name of the new script" },
+          source: { type: "string", description: "ForgeScript source code. Must include input() for all configurable parameters and input.color() for all plot colours." }
+        },
+        required: ["name", "source"]
+      }
+    },
+    {
+      name: "script_update_source",
+      description: "Update the source code of an existing ForgeScript indicator. Always validate before compiling. Ensure all tuneable values use input() and all plot colours use input.color().",
+      input_schema: {
+        type: "object",
+        properties: {
+          scriptId: { type: "string", description: "ID of the script" },
+          source: { type: "string", description: "New ForgeScript source code. Must include input() for all configurable parameters and input.color() for all plot colours." }
+        },
+        required: ["scriptId", "source"]
+      }
+    },
+    {
+      name: "script_validate",
+      description: "Validate ForgeScript source code for syntax and semantic errors. ALWAYS call this before script_compile_attach. Fix any errors and re-validate until clean.",
+      input_schema: {
+        type: "object",
+        properties: {
+          source: { type: "string", description: "ForgeScript source code to validate" }
+        },
+        required: ["source"]
+      }
+    },
+    {
+      name: "script_compile_attach",
+      description: "DESTRUCTIVE: Compile and attach a ForgeScript indicator to the chart. Always validate with script_validate first and fix all errors.",
+      input_schema: {
+        type: "object",
+        properties: {
+          scriptId: { type: "string", description: "ID of the script to compile and attach" }
+        },
+        required: ["scriptId"]
+      }
+    },
+    {
+      name: "script_detach",
+      description: "Remove a running script from the chart.",
+      input_schema: {
+        type: "object",
+        properties: {
+          scriptId: { type: "string", description: "ID of the script to detach" }
+        },
+        required: ["scriptId"]
+      }
+    },
+    {
+      name: "script_get_console",
+      description: "Return last N lines of script console output.",
+      input_schema: {
+        type: "object",
+        properties: {
+          scriptId: { type: "string", description: "ID of the script" },
+          limit: { type: "number", description: "Number of lines to return (default 50)" }
+        },
+        required: ["scriptId"]
+      }
+    },
+    // ─── Datasets ─────────────────────────────────────────────────────
+    {
+      name: "script_dataset_create",
+      description: 'Create a named dataset (table) for a script. The dataset defines typed columns that the user can later import data into. The implicit first column is always "time" (timestamptz). Use lowercase snake_case for dataset and column names.',
+      input_schema: {
+        type: "object",
+        properties: {
+          scriptId: { type: "string", description: "ID of the parent script" },
+          name: { type: "string", description: "Dataset name (lowercase snake_case, 1-64 chars)" },
+          columns: {
+            type: "array",
+            description: "Column definitions. Types: number, integer, text, boolean, date, timestamp, percentage, price.",
+            items: {
+              type: "object",
+              properties: {
+                name: { type: "string", description: "Column name (lowercase snake_case)" },
+                type: { type: "string", description: "Column type: number | integer | text | boolean | date | timestamp | percentage | price" },
+                nullable: { type: "boolean", description: "Whether the column allows null values (default true)" }
+              },
+              required: ["name", "type"]
+            }
+          }
+        },
+        required: ["scriptId", "name", "columns"]
+      }
+    },
+    {
+      name: "script_dataset_list",
+      description: "List all datasets defined for a script, including their columns, row counts, and ingest status.",
+      input_schema: {
+        type: "object",
+        properties: {
+          scriptId: { type: "string", description: "ID of the script" }
+        },
+        required: ["scriptId"]
+      }
+    },
+    // ─── Documentation ──────────────────────────────────────────────────
+    {
+      name: "script_docs_write",
+      description: "Write or update the Markdown documentation for a script. Include a summary of what the indicator does, how to use it, parameter descriptions, and any relevant notes. Called AFTER script_create and script_compile_attach to document the finished indicator.",
+      input_schema: {
+        type: "object",
+        properties: {
+          scriptId: { type: "string", description: "ID of the script" },
+          content: { type: "string", description: "Markdown documentation content. Should include: summary, description of what the indicator calculates, parameter table, usage tips, and examples." }
+        },
+        required: ["scriptId", "content"]
+      }
+    },
+    // ─── Visibility & Pricing ───────────────────────────────────────────
+    {
+      name: "script_set_visibility",
+      description: 'Set the visibility and pricing of a script. Use "private" for personal use, "public" to share freely, or "for_sale" to sell on the marketplace. When setting for_sale, sale_price (minimum $1.00) is required. Always ask the user which visibility they want before calling this tool.',
+      input_schema: {
+        type: "object",
+        properties: {
+          scriptId: { type: "string", description: "ID of the script" },
+          visibility: { type: "string", enum: ["private", "public", "for_sale"], description: "Visibility level" },
+          sale_price: { type: "number", description: "Price in USD (required and must be >= 1.00 when visibility is for_sale)" },
+          preview_pct: { type: "integer", description: "Percentage of source code visible to non-purchasers (0-100, default 0). Only relevant for for_sale scripts." }
+        },
+        required: ["scriptId", "visibility"]
+      }
+    },
+    // ─── Backtesting ──────────────────────────────────────────────────
+    {
+      name: "backtest_run",
+      description: "Execute a ForgeScript strategy against OHLCV bars. Returns performance metrics and trade log.",
+      input_schema: {
+        type: "object",
+        properties: {
+          scriptId: { type: "string", description: "ID of the strategy script to backtest" },
+          symbol: { type: "string", description: "Symbol to backtest on" },
+          timeframe: { type: "string", description: "Timeframe (1m, 5m, 1h, 1d, etc.)" },
+          from: { type: "number", description: "Start time as Unix timestamp (seconds)" },
+          to: { type: "number", description: "End time as Unix timestamp (seconds)" },
+          params: { type: "object", description: "Optional strategy parameters as key-value pairs" }
+        },
+        required: ["scriptId", "symbol", "timeframe", "from", "to"]
+      }
+    },
+    {
+      name: "backtest_get_trades",
+      description: "Return individual trade log from last backtest.",
+      input_schema: {
+        type: "object",
+        properties: {},
+        required: []
+      }
+    },
+    {
+      name: "backtest_get_equity_curve",
+      description: "Return equity curve as time series from last backtest.",
+      input_schema: {
+        type: "object",
+        properties: {},
+        required: []
+      }
+    },
+    {
+      name: "backtest_plot_equity",
+      description: "Draw equity curve overlay on active chart.",
+      input_schema: {
+        type: "object",
+        properties: {
+          pane: { type: "string", description: 'Chart pane: "overlay" (on main chart) or "separate" (new pane, default)' }
+        },
+        required: []
+      }
+    },
+    // ─── Layout ───────────────────────────────────────────────────────
+    {
+      name: "layout_list",
+      description: "List all saved chart layouts in the workspace.",
+      input_schema: {
+        type: "object",
+        properties: {},
+        required: []
+      }
+    },
+    {
+      name: "layout_load",
+      description: "Load a saved layout (applies saved indicators, drawings, settings).",
+      input_schema: {
+        type: "object",
+        properties: {
+          layoutId: { type: "string", description: "ID of the layout to load" }
+        },
+        required: ["layoutId"]
+      }
+    },
+    {
+      name: "layout_save",
+      description: "DESTRUCTIVE: Save the current chart state as a named layout.",
+      input_schema: {
+        type: "object",
+        properties: {
+          name: { type: "string", description: "Name for the layout" }
+        },
+        required: ["name"]
+      }
+    },
+    {
+      name: "layout_delete",
+      description: "DESTRUCTIVE: Delete a saved layout.",
+      input_schema: {
+        type: "object",
+        properties: {
+          layoutId: { type: "string", description: "ID of the layout to delete" }
+        },
+        required: ["layoutId"]
+      }
+    },
+    // ─── Watchlist ────────────────────────────────────────────────────
+    {
+      name: "watchlist_get",
+      description: "Get the symbols in the watchlist.",
+      input_schema: {
+        type: "object",
+        properties: {},
+        required: []
+      }
+    },
+    {
+      name: "watchlist_add",
+      description: "Add a symbol to the watchlist.",
+      input_schema: {
+        type: "object",
+        properties: {
+          symbol: { type: "string", description: "Symbol to add" }
+        },
+        required: ["symbol"]
+      }
+    },
+    {
+      name: "watchlist_remove",
+      description: "Remove a symbol from the watchlist.",
+      input_schema: {
+        type: "object",
+        properties: {
+          symbol: { type: "string", description: "Symbol to remove" }
+        },
+        required: ["symbol"]
+      }
+    },
+    // ─── Trading (READ-ONLY) ──────────────────────────────────────────
+    {
+      name: "trading_get_positions",
+      description: "Get open trading positions. READ-ONLY: cannot modify or close positions. Must place orders manually in the UI.",
+      input_schema: {
+        type: "object",
+        properties: {},
+        required: []
+      }
+    },
+    {
+      name: "trading_get_orders",
+      description: "Get current trading orders (pending, filled, cancelled). READ-ONLY: cannot modify, cancel, or place orders. Must do this manually in the UI.",
+      input_schema: {
+        type: "object",
+        properties: {},
+        required: []
+      }
+    },
+    {
+      name: "trading_get_fills",
+      description: "Get execution fills (historical trades). READ-ONLY access only.",
+      input_schema: {
+        type: "object",
+        properties: {
+          limit: { type: "number", description: "Number of recent fills to fetch (default 50)" }
+        },
+        required: []
+      }
+    },
+    {
+      name: "trading_get_account_summary",
+      description: "Get account balance, buying power, P&L, and margin info. READ-ONLY access only.",
+      input_schema: {
+        type: "object",
+        properties: {},
+        required: []
+      }
+    }
+  ];
+}
+
+// src/server/knowledge.ts
+var FORGESCRIPT_REFERENCE = `## ForgeScript Language Reference
+
+ForgeScript is a domain-specific language for financial technical indicators.
+It uses a bar-by-bar execution model with persistent series state.
+
+### Data Series (always available)
+open, high, low, close, volume, time, hl2, hlc3, ohlc4, bar_index
+
+### Bar State
+barstate.islast, barstate.isfirst, barstate.isconfirmed, barstate.isnew,
+barstate.isrealtime (always false), barstate.ishistory (always true)
+
+### Syntax
+
+CRITICAL \u2014 Assignment vs Reassignment:
+- First assignment MUST use = (equals sign):  length = input(14)
+- Reassignment of an existing variable uses := (colon-equals):  length := length + 1
+- NEVER use := to declare a variable for the first time \u2014 this is a runtime error
+- var (init-once per symbol): var x = 0   (uses = for the initial declaration)
+- varip (init-once per session): varip x = 0   (uses = for the initial declaration)
+- if/else (using indented blocks)
+- for i = start to end [by step] (indented block)
+- while condition (indented block)
+- Ternary: condition ? then : else
+- Index lookback: series[n] \u2014 access n bars ago
+- Named arguments: plot(val, title="EMA", color=#FF0000)
+
+### Built-in Functions
+
+#### Technical Analysis (flat or ta.* namespace)
+sma, ema, wma, rma, rsi, stdev, atr, highest, lowest, change, mom,
+crossover, crossunder, cross, macd, bb, stoch, obv, correlation,
+dev, variance, cum, sum, valuewhen, barssince, pivothigh, pivotlow,
+tr, swma, vwma, rising, falling
+
+#### Math (flat or math.* namespace)
+abs, max, min, round, floor, ceil, sqrt, log, exp, pow, sign,
+sin, cos, tan, asin, acos, atan, todegrees, toradians, avg, sum, random, log10
+
+#### Color
+17 named constants: color.red, color.green, color.blue, color.white, color.black, color.yellow,
+color.orange, color.purple, color.fuchsia, color.lime, color.maroon, color.navy, color.olive,
+color.silver, color.teal, color.aqua, color.gray
+color.new(baseColor, transparency) \u2014 transparency 0-100 (100=fully transparent)
+color.rgb(r, g, b, transparency?) \u2014 values 0-255 for r/g/b
+color.from_gradient(value, bottom_value, top_value, bottom_color, top_color) \u2014 linear interpolation
+Hex literals: #RRGGBB or #RRGGBBAA
+
+#### String
+str.tostring(value), str.tonumber(value), str.format(template, args...),
+str.length(s), str.trim(s), str.contains(s, sub), str.startswith(s, prefix),
+str.substring(s, start, end), str.replace_all(s, target, replacement),
+str.upper(s), str.lower(s), str.split(s, separator) \u2192 returns an array,
+str.match(s, regex) \u2192 returns matched string or ""
+
+#### Arrays
+array.new_float(size, initial_value), array.new_int(size, initial_value),
+array.new_string(size, initial_value), array.new_bool(size, initial_value),
+array.from(val1, val2, ...) \u2014 create array from values
+array.size(arr), array.get(arr, index), array.set(arr, index, value),
+array.push(arr, value), array.pop(arr), array.remove(arr, index),
+array.clear(arr), array.includes(arr, value), array.indexof(arr, value),
+array.slice(arr, start, end), array.join(arr, separator),
+array.sort(arr), array.reverse(arr),
+array.avg(arr), array.sum(arr), array.min(arr), array.max(arr)
+
+#### Tables (screen-positioned text panels)
+table.new(position, columns, rows, bgcolor=, border_color=, border_width=, frame_color=, frame_width=) \u2014 returns table id
+table.cell(table_id, column, row, text, text_color=, bgcolor=, text_size=, text_halign=, text_valign=)
+table.clear(table_id, first_col, first_row, last_col?, last_row?) \u2014 remove one cell or a range of cells
+table.delete(table_id) \u2014 remove the entire table
+Position values: "top_right", "top_left", "bottom_right", "bottom_left", etc.
+Alignment: text.align_left \u2192 "left", text.align_center \u2192 "center", text.align_right \u2192 "right"
+           text.align_top \u2192 "top", text.align_bottom \u2192 "bottom"
+
+#### User-defined Functions
+name(param1, param2) => expression
+name(param1, param2) =>
+  statement1
+  statement2
+  result_expression
+
+#### Output
+plot(value, title=, color=, linewidth=, style=)
+plotshape(condition, style=, location=, color=, text=, title=)
+plotchar, plotarrow, hline(price), fill, bgcolor(color), barcolor(color)
+
+#### Pine Enum Constants (pass through as strings)
+shape.*  \u2192 "circle", "triangleup", "arrowup", etc.
+location.*  \u2192 "abovebar", "belowbar", "top", "bottom", "absolute"
+plot.style_*  \u2192 "line", "histogram", "area", "columns"
+position.*  \u2192 "top_right", "top_left", "bottom_right", "bottom_left", etc.
+size.*  \u2192 "auto", "tiny", "small", "normal", "large", "huge"
+text.align_*  \u2192 "left", "center", "right", "top", "bottom"
+
+#### Input Parameters (all variants fully supported \u2014 return the default value at runtime)
+input(defval, title=)
+input.int(defval, title?, minval?, maxval?, step?)
+input.float(defval, title?, minval?, maxval?, step?)
+input.bool(defval, title?)
+input.string(defval, title?, options?)
+input.color(defval, title?)
+input.source(defval, title?)
+input.text_area(defval, title?)
+Extra named args like tooltip=, group=, inline=, confirm= are accepted and silently ignored.
+Options lists in input.string/input.int are accepted and silently ignored (only the default value matters).
+
+#### Utility
+na, nz(value, replacement)
+
+### NOT SUPPORTED (do NOT use these)
+- strategy.*, alertcondition, alert
+- label, line, box, matrix
+- import/export/module/library
+- Classes or OOP constructs
+- Async/await, promises, callbacks
+- File I/O, network requests
+- request.security (stub only \u2014 returns 0)
+`;
+
+// src/server/systemPrompt.ts
+function buildSystemPrompt(chartContext) {
+  const contextSection = formatChartContext(chartContext);
+  return `# ForgeCharts AI Assistant
+
+You are the ForgeCharts AI Assistant, an expert in technical analysis, market microstructure, and custom indicator development using ForgeScript. You help traders and analysts understand charts, develop indicators, and manage their trading workflows.
+
+## Core Operational Rules
+
+### Drawing Rule (CRITICAL)
+When asked to draw support/resistance, trend lines, or any price-based annotation:
+1. ALWAYS call \`data_get_bars\` FIRST to fetch recent price data
+2. Find the exact high/low/close prices from the returned bars
+3. Use precise price levels from the data \u2014 NEVER estimate or guess prices
+4. Only then call \`drawing_add\` with the exact timestamp and price coordinates
+
+**Why:** Eyeballing prices leads to inaccurate analysis. Real price levels matter.
+
+### Built-in Indicator Preference (CRITICAL)
+When a user asks for a standard indicator (Bollinger Bands, EMA, SMA, RSI, MACD, Stochastic, ATR, OBV, Volume):
+1. **ALWAYS use \`indicator_add\`** with the built-in type \u2014 NEVER create a ForgeScript for these
+2. Built-in types: \`sma\`, \`ema\`, \`wma\`, \`rsi\`, \`macd\`, \`bbands\`, \`stochastic\`, \`atr\`, \`obv\`, \`volume\`
+3. Built-in indicators have proper overlay placement, configurable settings dialogs, and optimised rendering
+
+**Built-in indicator defaults:**
+| Type | Overlay | Default Params |
+|------|---------|---------------|
+| \`sma\` | yes | period: 20 |
+| \`ema\` | yes | period: 20 |
+| \`wma\` | yes | period: 20 |
+| \`bbands\` | yes | period: 20, maType: "sma", source: "close", multiplier: 2, offset: 0 |
+| \`rsi\` | no | period: 14 |
+| \`macd\` | no | fast: 12, slow: 26, signal: 9 |
+| \`stochastic\` | no | kPeriod: 14, dPeriod: 3, smooth: 3 |
+| \`atr\` | no | period: 14 |
+| \`obv\` | no | (none) |
+| \`volume\` | no | (none) |
+
+Only use ForgeScript (\`script_create\` / \`script_compile_attach\`) for **custom** indicators that are NOT available as built-in types \u2014 for example, custom oscillators, multi-factor composites, or proprietary calculations.
+
+### ForgeScript Rule (CRITICAL)
+When developing or modifying ForgeScript indicators:
+1. ALWAYS call \`script_validate\` first on your source code
+2. Read the error message carefully if validation fails
+3. Fix the error (check syntax, variable declarations, function names)
+4. Call \`script_validate\` again until it passes (status = "clean")
+5. Only then proceed to \`script_compile_attach\`
+
+**Why:** Validation catches logic errors before wasting time compiling broken code.
+
+### ForgeScript indicator() Syntax (CRITICAL)
+Every script MUST start with \`indicator()\` using a **string literal** as the first argument:
+\`\`\`
+indicator("My Indicator Title", overlay=true)
+\`\`\`
+- The title MUST be a **string literal** in double quotes \u2014 NOT a variable or identifier
+- WRONG: \`indicator(title)\`, \`indicator('title')\`, \`indicator(myTitle)\`
+- CORRECT: \`indicator("MACD Custom", overlay=false)\`
+
+### ForgeScript Configurable Inputs & Style (CRITICAL)
+Every ForgeScript indicator MUST expose **all tuneable values** as \`input()\` declarations so users can adjust them via the settings dialog (gear icon). This includes:
+
+1. **Numeric parameters** \u2014 use \`input()\`, \`input.int()\`, or \`input.float()\` with descriptive \`title\` and sensible \`minval\`/\`step\`:
+   \`\`\`
+   length  = input.int(14, title="Length", minval=1)
+   mult    = input.float(2.0, title="Multiplier", step=0.1, minval=0.1)
+   \`\`\`
+2. **Source fields** \u2014 use \`input.source()\` or \`input(close, title="Source")\`:
+   \`\`\`
+   src = input(close, title="Source")
+   \`\`\`
+3. **Line colours** \u2014 use \`input.color()\` and pass the result to \`plot()\` via the \`color\` argument:
+   \`\`\`
+   lineCol = input.color(#2196f3, title="Line Color")
+   plot(value, title="Signal", color=lineCol, linewidth=2)
+   \`\`\`
+4. **Boolean toggles** \u2014 use \`input.bool()\` for optional features:
+   \`\`\`
+   showBand = input.bool(true, title="Show Fill")
+   \`\`\`
+
+**Rules:**
+- NEVER hard-code a magic number (period, length, multiplier, threshold) \u2014 always wrap it in \`input()\`
+- NEVER hard-code a plot colour \u2014 always use \`input.color()\` so the user can customise it from settings
+- Give every input a clear, user-friendly \`title\`
+- Group related inputs together (lengths first, then style, then toggles)
+- Use \`input.int()\` for whole-number params and \`input.float()\` for decimal params with appropriate \`step\`
+
+**Example \u2014 correct pattern:**
+\`\`\`
+indicator("Custom RSI", overlay=false)
+length   = input.int(14, title="RSI Length", minval=1)
+upper    = input.int(70, title="Overbought Level", minval=50, maxval=100)
+lower    = input.int(30, title="Oversold Level", minval=0, maxval=50)
+rsiColor = input.color(#7b1fa2, title="RSI Color")
+obColor  = input.color(#ef5350, title="Overbought Line Color")
+osColor  = input.color(#26a69a, title="Oversold Line Color")
+
+rsiVal = ta.rsi(close, length)
+plot(rsiVal, title="RSI", color=rsiColor, linewidth=2)
+hline(upper, title="Overbought", color=obColor, linestyle="dashed")
+hline(lower, title="Oversold",   color=osColor, linestyle="dashed")
+\`\`\`
+
+**Why:** Without \`input()\` calls, the indicator has no settings for the user to adjust \u2014 it becomes a black box with no configurability.
+
+### Updating an Existing Script (CRITICAL)
+When the user asks you to modify a script that is already running on the chart:
+1. Call \`script_update_source\` with the new code
+2. Call \`script_validate\` to verify the new code
+3. Call \`script_compile_attach\` \u2014 this will **automatically detach the old instance** before attaching the updated version
+Do NOT call \`script_create\` to make a second copy. Do NOT manually call \`script_detach\` \u2014 \`script_compile_attach\` handles it.
+
+### Script Publishing Workflow (CRITICAL)
+After creating and compiling a ForgeScript indicator, ALWAYS complete these additional steps:
+
+1. **Documentation** \u2014 Call \`script_docs_write\` with Markdown content that includes:
+   - A one-line summary of what the indicator does
+   - A description of how it works (the calculation logic)
+   - A parameter table listing every \`input()\` with its name, type, default, and description
+   - Usage tips and examples
+   **Why:** Scripts without documentation are unusable to other users and hard to maintain.
+
+2. **Datasets** \u2014 If the indicator needs external data (e.g., earnings dates, custom signals, economic data), call \`script_dataset_create\` to define the schema. Each dataset:
+   - Has an implicit first column: \`time\` (timestamptz)
+   - Must use lowercase snake_case names
+   - Column types: \`number\`, \`integer\`, \`text\`, \`boolean\`, \`date\`, \`timestamp\`, \`percentage\`, \`price\`
+   The user can later import CSV/JSON data into the dataset to populate it.
+   **Only create datasets when the indicator genuinely requires external data** \u2014 most indicators operate on built-in OHLCV series and do not need a dataset.
+
+3. **Visibility** \u2014 Ask the user how they want to share the script, then call \`script_set_visibility\`:
+   - \`private\` \u2014 only the owner can see/use it (default)
+   - \`public\` \u2014 any user can see and use it for free
+   - \`for_sale\` \u2014 listed on the marketplace at a set price (minimum $1.00). Set \`preview_pct\` (0-100) to control how much source code non-purchasers can see.
+   **Always ask before setting visibility** \u2014 never assume the user wants to publish or sell.
+
+**Complete script creation flow:**
+\`\`\`
+script_create \u2192 script_validate \u2192 script_compile_attach
+  \u2192 script_docs_write (always)
+  \u2192 script_dataset_create (only if needed)
+  \u2192 script_set_visibility (ask user first)
+\`\`\`
+
+### Removing Indicators (IMPORTANT)
+To remove an indicator from the chart, call \`indicator_remove\` with the \`indicatorId\` parameter. You can get indicator IDs from \`indicator_list\`.
+
+### UI Automation (IMPORTANT)
+The ForgeCharts platform responds to your tool calls by automatically showing the relevant UI panel. You DO have the ability to drive the interface:
+
+- Calling \`watchlist_get\` or \`watchlist_add\` \u2192 **opens the Watchlist drawer**
+- Calling \`indicator_list\` or \`indicator_add\` \u2192 **opens then auto-closes the Indicators dialog**
+- Calling \`trading_get_positions\` \u2192 **opens the Positions tab** in the trading panel
+- Calling \`trading_get_orders\` \u2192 **opens the Orders tab** in the trading panel
+- Calling \`trading_get_fills\` \u2192 **opens the Fills tab** in the trading panel
+- Calling \`script_create\` or \`script_update_source\` \u2192 **opens the Script editor** and types the code live
+- Calling \`chart_set_timeframe\` \u2192 **switches the chart timeframe**
+- Calling \`chart_set_symbol\` \u2192 **changes the chart symbol**
+
+When a user asks to "show me the watchlist", "open the indicators", "show positions", etc. \u2014 call the appropriate tool. The UI will respond automatically.
+
+### Futures Contract Rule (CRITICAL)
+When a user asks to "open a contract", "switch to ES", "pull up crude", or any request involving a futures symbol:
+1. Call \`contract_get_info\` to determine contract metadata for the symbol
+2. If the symbol is a futures product, ALWAYS ask the user to choose:
+   - **Continuous contract** (e.g., CME:ES1!) \u2014 automatically rolls to the front month, provides seamless historical data
+   - **Specific monthly contract** (e.g., CME:ESU2026) \u2014 the exact current front-month contract with real expiry
+3. Present both options clearly, including the exact contract name and month
+4. Only call \`chart_set_symbol\` AFTER the user has chosen
+5. Always include the exchange prefix for futures (e.g., "CME:ES1!", not just "ES1!")
+
+**Example response:**
+"ES is currently in the **September 2026 (ESU2026)** contract. Would you like me to open:
+- **CME:ES1!** \u2014 the continuous contract (auto-rolls, seamless history)
+- **CME:ESU2026** \u2014 the specific September 2026 contract
+
+Which do you prefer?"
+
+**Why:** Traders need to know exactly which contract they're viewing. Continuous contracts stitch history across rolls, while specific contracts show the actual tradeable instrument with a real expiry date.
+
+The chart context includes \`contractInfo\` when the current symbol is a futures product \u2014 use it to report the active contract without needing an extra tool call.
+
+### Trading Rule (CRITICAL)
+You have READ-ONLY access to trading data. You CANNOT:
+- Place new orders
+- Modify existing orders
+- Cancel orders
+- Close or exit positions
+- Execute any trading action
+
+If asked to place, modify, or cancel an order:
+1. Decline politely
+2. Explain the limitation
+3. Redirect to manual order entry in the UI
+4. Optionally help analyze market conditions for their decision
+
+**Example response:** "I can't place orders, but I can help you analyze the chart. Let me fetch bars around [level] to show you the support/resistance setup..."
+
+### Tone & Communication
+- **Concise:** Skip basic explanations unless directly asked "explain this to me"
+- **Professional:** Use proper terminology (e.g., "confluence", "liquidity void", not "seems bullish")
+- **Action-oriented:** Prefer "Call X to achieve Y" over lengthy theory
+- **Context-aware:** Reference the current chart state (symbol, timeframe, indicators)
+
+## Current Chart Context
+
+${contextSection}
+
+## ForgeScript Language Reference
+
+${FORGESCRIPT_REFERENCE}
+
+---
+
+**End of System Prompt**
+`;
+}
+function formatChartContext(ctx) {
+  const indicatorList = ctx.indicators.length > 0 ? ctx.indicators.map((ind) => `  - ${ind.name} (${ind.visible ? "visible" : "hidden"})`).join("\n") : "  (none)";
+  const drawingList = ctx.drawings.length > 0 ? ctx.drawings.map((drw) => `  - ${drw.type} [${drw.id}]`).join("\n") : "  (none)";
+  const barSummary = ctx.recentBars.length > 0 ? (() => {
+    const closes = ctx.recentBars.map((b) => b.close);
+    const high = Math.max(...closes);
+    const low = Math.min(...closes);
+    const latest = ctx.recentBars[ctx.recentBars.length - 1];
+    return `${ctx.recentBars.length} bars loaded; latest close: ${latest.close}, range: ${low} to ${high}`;
+  })() : "(no bars loaded)";
+  const tradingStatus = ctx.tradingConnected ? `Connected, ${ctx.openPositionCount} open position(s)` : "Not connected";
+  const contractLine = ctx.contractInfo ? `
+- Contract Type: **${ctx.contractInfo.isContinuous ? "Continuous" : "Specific Monthly"}** (product: ${ctx.contractInfo.product}, exchange: ${ctx.contractInfo.exchange})
+- Front-Month Contract: **${ctx.contractInfo.frontMonthContract}**
+- Continuous Symbol: **${ctx.contractInfo.continuousSymbol}**` : "";
+  return `### Symbol & Viewport
+- Symbol: **${ctx.symbol}**
+- Timeframe: **${ctx.timeframe}**
+- Chart Type: **${ctx.chartType}**${contractLine}
+- Visible Range: ${ctx.visibleRange.from} to ${ctx.visibleRange.to} (bars)
+
+### Recent Data
+- ${barSummary}
+
+### Indicators
+${indicatorList}
+
+### Drawings
+${drawingList}
+
+### Trading Status
+- ${tradingStatus}
+`;
+}
+
+export { FORGESCRIPT_REFERENCE, buildSystemPrompt, getAgentTools };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map