tellegen

Ask an agent to

• Solve power flow for the displayed test case
• Show the bus with the highest marginal price
• Preview the price impact of raising demand at bus 5

20 tools

• analyze_sensitivityread-onlyuntrusted content

  Compute the displayed formulation's LMP sensitivity for one bus demand or branch rating and return the largest responses. Leaves the visible selection unchanged.

  case_id: string, target: object, limit: integer?

• branch_studyuntrusted content

  Inspect a saved state and continue exploration from it. This changes the inspected pointer, not the applied state.

  study_id: string, expected_revision: integer, operation: object

• compare_study_statesuntrusted content

  Compare two saved network states, optionally under a selected goal revision. Results include operating-point changes and goal progress when a goal is selected.

  study_id: string, expected_revision: integer, operation: object

• create_studyuntrusted content

  Save the current case and its results as a Study. A planning goal is optional; add or revise it later. Creating a Study does not change the network or apply a proposal.

  case_id: string, expected_case_revision: string, study: object?, goal: object?

• edit_demanduntrusted content

  Add signed MW increments at permitted buses to the selected saved state. Edits accumulate across calls and persist after reload. Individual bounds and the total change budget apply to every step; incomplete demand…

  study_id: string, expected_revision: integer, operation: object

• focus_networkuntrusted content

  Focus a bus or branch in the tellegen interface and load its computed sensitivity view. The returned result reflects the interface after the selection has settled.

  case_id: string, target: object

• inspect_caseread-onlyuntrusted content

  Inspect the displayed network, including a saved Study state when one is shown. Returns case, state, formulation, units, and revision. Saved states are read-only; select_case returns to the editable case.

• inspect_studyread-onlyuntrusted content

  Inspect the open Study, read a bounded page of goals, states or evidence, or open a saved Study. Saved candidates remain unapplied.

  study_id: string?, section?, record_id: string?, offset: integer?, expected_revision: integer?

• list_casesread-onlyuntrusted content

  List configured and imported cases, including unavailable cases and their reported reasons. Returns stable case IDs, the displayed revision, and a pagination offset for select_case.

  offset: integer?, limit: integer?

• preview_case_updateread-onlyuntrusted content

  Predict objective and locational marginal price (LMP) changes for bounded demand or branch rating edits at the current formulation. Leaves the case and visible interface unchanged and requires the current revision.

  case_id: string, expected_revision: string, mode: string?, demand: array?, ratings: array?, limit: integer?

• propose_capacity_planuntrusted content

  Use implicit derivatives to choose bounded branch capacity increase trials. Exact solves verify the staged proposal. The electrical case stays unchanged.

  case_id: string, expected_revision: string, objective: object, candidates: array, max_increase_per_branch_mw: number, budget_mw: number, increment_mw: number, max_changed_lines: integer, exact_solve_budget: integer

• propose_studyuntrusted content

  Explore feasible capacity or demand interventions using implicit gradients and exact solves. Every trial counts against the solve budget. Save the best verified recommendation without applying it. The user applies it…

  study_id: string, expected_revision: integer, operation: object

• query_networkread-onlyuntrusted content

  Query buses or branches in the displayed network by stable ID or metric. For the highest LMP use element_kind bus, sort_by price, direction desc, limit 1. Returns saved-state values when a Study state is shown.

  case_id: string, element_kind: string, element_ids: array?, sort_by: string?, direction: string?, limit: integer?

• record_study_evidenceuntrusted content

  Attach a stated rationale and evidence to a saved state without creating an electrical state. Do not record private agent reasoning.

  study_id: string, expected_revision: integer, operation: object

• reset_caseuntrusted content

  Clear all committed demand and branch-rating edits in the active case, keep its formulation, solve, and update the visible interface. Requires the current revision.

  case_id: string, expected_revision: string

• restore_base_caseuntrusted content

  Exactly solve the retained original network data and save a reset candidate without applying it or deleting history. The user can apply the reset in the Study panel. Reports when the original input is unavailable.

  study_id: string, expected_revision: integer, operation: object

• revise_study_goaluntrusted content

  Save a new goal revision without changing historical goals. The revision invalidates the current recommendation and approvals.

  study_id: string, expected_revision: integer, operation: object

• select_caseuntrusted content

  Show a case from list_cases using the same controls as the case tabs. Leaves saved Studies intact and exits historical inspection. Changes the view only; no proposal approval is required.

  case_id: string, expected_revision: string?

• solve_multiconductor_pfuntrusted content

  Calculate terminal voltages, currents, and powers for the displayed multiconductor case. Uses prescribed demand and source voltages. Rejects unsupported equipment physics. Does not optimize dispatch or change…

  case_id: string, expected_revision: string, max_iterations: integer?

• update_caseuntrusted content

  Atomically set or increment demand and branch-rating deltas, optionally choose a formulation, then solve and update the visible interface. Requires the current revision.

  case_id: string, expected_revision: string, mode: string?, demand: array?, ratings: array?, formulation: string?