drizzle-cube 0.8.2 → 0.9.0

package/dist/adapters/{handler-DESp4wPg.js → handler-Cppe-aqH.js}

@@ -1,8 +1,30 @@
-import { A as e, _ as t, g as n, h as r, k as i, m as a, p as o, v as s, x as c } from "./utils-BhlkVCzZ.js";
-import { E as l, T as u } from "./mcp-transport-BqdBHmXL.js";
-import { a as d, c as f, d as p, i as m, l as h, n as g, o as _, r as v, s as y, t as b, u as x } from "./chartConfigHelpers-BsnbxA2c.js";
+import { O as e, _ as t, b as n, g as r, h as i, k as a, m as o, p as s } from "./utils-C_RKaP0n.js";
+import { D as c, E as l, O as u, T as d } from "./mcp-transport-CpF7usmR.js";
+import { a as f, c as p, d as m, i as h, l as g, n as _, o as v, r as y, s as b, t as x, u as S } from "./chartConfigHelpers-BsnbxA2c.js";
+//#region src/server/agent/agent-prompts.ts
+var ee = [
+	"You are an analyst agent working in a notebook backed by a drizzle-cube semantic layer.",
+	"",
+	"Your tools, in the order you normally use them:",
+	"1) `discover_cubes` {topic|intent} — find cubes and understand the schema. Call this first.",
+	"2) `get_cube_metadata` — full measure/dimension detail for every cube, when discover is not enough.",
+	"3) `execute_query` — run a query and get results back, along with a `dataShape` summary.",
+	"4) `add_markdown` — write the finding into the notebook.",
+	"5) `add_portlet` — add the chart that shows it.",
+	"6) `update_portlet` — amend a chart you already added, instead of adding a second one.",
+	"7) `save_as_dashboard` — only when the user explicitly asks for a dashboard.",
+	"",
+	"CROSS-CUBE JOINS:",
+	"The \"joins\" property in discover results shows relationships between cubes.",
+	"You can include dimensions from ANY related cube in your query — the system auto-joins.",
+	"Example: If Productivity joins to Employees, query:",
+	"{ \"measures\": [\"Productivity.totalPullRequests\"], \"dimensions\": [\"Employees.name\"] }",
+	"",
+	"Do NOT hallucinate cube/field names — always use discover_cubes first."
+].join("\n");
+//#endregion
 //#region src/server/agent/system-prompt.ts
-function S(e, t) {
+function te(e, t) {
 	if (!(!t.measures || t.measures.length === 0)) {
 		e.push(""), e.push("**Measures:**");
 		for (let n of t.measures) {
@@ -11,7 +33,7 @@ function S(e, t) {
 		}
 	}
 }
-function ee(e, t) {
+function ne(e, t) {
 	if (!(!t.dimensions || t.dimensions.length === 0)) {
 		e.push(""), e.push("**Dimensions:**");
 		for (let n of t.dimensions) {
@@ -20,25 +42,25 @@ function ee(e, t) {
 		}
 	}
 }
-function te(e, t) {
+function re(e, t) {
 	if (!(!t.relationships || t.relationships.length === 0)) {
 		e.push(""), e.push("**Joins:**");
 		for (let n of t.relationships) e.push(`- → \`${n.targetCube}\` (${n.relationship})`);
 	}
 }
-function ne(e, t) {
+function ie(e, t) {
 	t.meta?.eventStream && (e.push(""), e.push("**Event Stream:** Yes (supports funnel, flow, retention queries)"), t.meta.eventStream.bindingKey && e.push(`- Binding key: \`${t.name}.${t.meta.eventStream.bindingKey}\``), t.meta.eventStream.timeDimension && e.push(`- Time dimension: \`${t.name}.${t.meta.eventStream.timeDimension}\``));
 }
-function re(e) {
+function ae(e) {
 	if (e.length === 0) return "No cubes are currently available.";
 	let t = ["## Available Cubes", ""];
-	for (let n of e) t.push(`### ${n.name}`), n.description && t.push(n.description), S(t, n), ee(t, n), te(t, n), ne(t, n), t.push("");
+	for (let n of e) t.push(`### ${n.name}`), n.description && t.push(n.description), te(t, n), ne(t, n), re(t, n), ie(t, n), t.push("");
 	return t.join("\n");
 }
 function C(e) {
 	return e.messages.map((e) => e.content.text).join("\n\n");
 }
-function ie(e) {
+function oe(e) {
 	return [
 		"# Drizzle Cube Analytics Agent",
 		"",
@@ -65,7 +87,7 @@ function ie(e) {
 		"  WRONG patterns that WILL FAIL: `Teams.Teams.name` (double-prefixed), `PullRequests.PullRequests.count` (double-prefixed), `PullRequests` (bare cube), `Teams_count` (underscore). Use the EXACT field names from discover results — copy them verbatim, do not prefix them again.",
 		"- Order keys MUST be one of the measures or dimensions already listed in that query. You CANNOT order by a field that is not in measures or dimensions — add it to measures first, or remove it from order.",
 		"- After EVERY `execute_query`, IMMEDIATELY call `add_markdown` and `add_portlet` in the SAME turn — never defer visualizations to a later turn",
-		"- Choose appropriate chart types: bar for categories, line for trends, table for detailed data",
+		"- Choose the chart type from the Chart Selection Guide below — match the chart to the question being asked, and vary chart types across the notebook",
 		"- If a query fails, explain the error and try an alternative approach",
 		"",
 		"## Output Format Rules",
@@ -92,27 +114,51 @@ function ie(e) {
 		"- Before each `add_portlet`, ALWAYS call `add_markdown` first to explain WHY you are adding this visualization and what it shows",
 		"- Before calling `add_portlet`, verify the query is valid: all fields in `order` must also appear in `measures` or `dimensions`",
 		"- Never put data tables in markdown blocks — use `add_portlet` with chartType \"table\" instead",
+		"- If a chart you already added is wrong, or the user asks to change one, call `update_portlet` with its id — do NOT add a second chart of the same data",
 		"- Think out loud in the notebook: use `add_markdown` to share your reasoning at each step so users can follow along",
 		"- NEVER use emojis in text responses or markdown content — no 📊, 📈, ✅, 🔍, etc. Write in plain, professional language.",
 		"",
+		"### Analysis Depth and Layout",
+		"",
+		"- A good notebook answers the question and then earns its keep: aim for 4-6 distinct insights unless the user asked something narrow.",
+		"- Vary the angle, not just the chart: overall level → breakdown by a dimension → trend over time → outliers or concentration → a caveat about the data.",
+		"- Actively look for the surprising thing: the biggest mover, the outlier, the category carrying most of the total, the segment moving against the trend. Say so in the markdown, plainly.",
+		"- Never add a chart that restates the previous chart with a different chart type.",
+		"- Structure the notebook like a short report: a scene-setting markdown block, then alternating markdown/chart pairs, then a closing block with the takeaways and what you could NOT determine from the available data.",
+		"- If a result is boring — flat, evenly distributed, or too few rows to mean anything — say that in the markdown and move to a different angle rather than charting it.",
+		"",
 		"## Chart Selection Guide",
 		"",
-		"Choose the chart type that best communicates the answer to the user's question. Think about what the data represents and what insight the user needs — do NOT default to the first option in this table. Consider the number of data points, whether values are categorical or temporal, and whether the user is comparing, trending, or summarizing.",
+		"Pick the chart that answers the question, not the one that is easiest. Consider how many rows came back, whether the values are categorical or temporal, and whether the user is comparing, trending, or summarising. Do NOT default to the first option in this table.",
+		"",
+		"`execute_query` returns a `dataShape` summary alongside the rows — use it. `distinctCount` on the dimension you are charting is the single most useful signal: 2-7 favours a part-of-whole treatment, 8-25 a ranking, and above that take a top-N with `order` + `limit` or show a table instead. Widely different `min`/`max` across measures means you need `yAxisAssignment`.",
+		"",
+		"Only the first rows are returned to you. When `truncated` is true the chart is still correct — the portlet re-runs the query itself — but do NOT state totals, counts or extremes you cannot see; use `rowCount` and `dataShape`, or run a narrower query.",
 		"",
-		"| Intent / Data Shape | Chart Type |",
+		"| Question the user is asking | Chart |",
 		"|---|---|",
 		"| Compare discrete categories or rankings | `bar` |",
 		"| Trend over time (one or few series) | `line` |",
 		"| Trend over time showing volume/magnitude | `area` |",
-		"| Part-of-whole breakdown | `pie` (≤7 slices) |",
+		"| Part-of-whole breakdown | `pie` (2-7 slices) or `proportionBar` (one stacked bar, easier to read) |",
+		"| Contributions summing to a total, with signed ups and downs | `waterfall` (deltas only, never raw totals) |",
+		"| Long tail or nested breakdown, many categories | `treemap` |",
+		"| Categories as compact circular progress | `radialBar` |",
 		"| Correlation between two measures | `scatter` |",
-		"| Correlation with size/color third dimension | `bubble` |",
-		"| Intensity across two categorical dimensions | `heatmap` |",
+		"| Correlation with size/colour third dimension | `bubble` |",
+		"| Intensity across two categorical dimensions | `heatmap` (set `valueField`) |",
+		"| Activity per day across weeks or months | `activityGrid` (needs a `day`-granularity time dimension; set `dateField` and `valueField`) |",
 		"| Multi-variable comparison across categories | `radar` |",
-		"| Distribution/spread of values | `boxPlot` |",
-		"| Detailed row-level data or many columns | `table` |",
+		"| Distribution/spread, summarised | `boxPlot` |",
+		"| Distribution/spread, every individual value | `dotStrip` |",
+		"| A shape across ordered measures (e.g. -2m, at event, +2h) | `measureProfile` (2+ measures on a comparable scale) |",
+		"| Detailed row-level data or many columns | `table` (aggregates) or `recordsTable` (one row per record) |",
+		"| Progress toward a known target or limit | `gauge` (ALWAYS set `maxValue`, or it scales to the data and reads as 100%) |",
+		"| Open/high/low/close price or range data | `candlestick` (put the measures in `yAxis` in OHLC order) |",
+		"| Narrative, caveats, methodology | `markdown` |",
 		"| Single headline number — ONLY when user explicitly asks for a KPI card or single number | `kpiNumber` |",
 		"| Headline metric with period-over-period change — ONLY when user asks about change in a single metric | `kpiDelta` |",
+		"| Headline number inside a sentence — same restraint as kpiNumber | `kpiText` |",
 		"",
 		"Analysis-mode-specific chart types (require the corresponding analysis mode):",
 		"",
@@ -124,11 +170,13 @@ function ie(e) {
 		"| Retention | `retentionHeatmap` | Cohort × period retention matrix |",
 		"| Retention | `retentionCombined` | Retention with line chart, heatmap, or combined modes |",
 		"",
-		"**Chart selection priorities:** Default to `bar` for categories, `line` for time series, `table` for exploratory data. Use `kpiNumber`/`kpiDelta` only as a last resort — they are appropriate only when the user explicitly asks for a single headline number or KPI card. If the query returns multiple rows or the user asks a general question like \"show me revenue\", prefer `bar` or `table` over `kpiNumber`.",
+		"**Vary the chart types across a notebook.** A notebook of nothing but bars and tables is a failure even when every chart is individually valid. `kpiNumber`/`kpiDelta`/`kpiText` are a last resort — use them only when the user explicitly asks for a single headline number, never for a multi-row result.",
+		"",
+		"`recordsTable` lists one row per record, so its query MUST set `\"ungrouped\": true` — which also means one cube plus its to-one joins, since an ungrouped query cannot span a hasMany relationship.",
 		"",
 		"## Chart Axis Configuration Rules",
 		"",
-		"**Bar charts MUST have an xAxis.** Put a dimension in `chartConfig.xAxis` so bars have category labels. If your query has no dimensions, add one or use `table` instead.",
+		"**Bar charts need an xAxis dimension.** A bar chart over a measures-only query has no category axis to label its bars; if you send one it is converted to a `table` (or `kpiNumber` for a single measure) and you are told so. To get a real bar chart, put the category in the query's `dimensions` and use a single measure. To compare several measures as an ordered shape, use `measureProfile`.",
 		"",
 		"**Never duplicate xAxis in series.** Putting the same dimension in both `xAxis` and `series` creates a sparse, broken-looking chart. The `series` field is ONLY for splitting bars into grouped/stacked sub-series by a SECOND dimension.",
 		"",
@@ -179,15 +227,15 @@ function ie(e) {
 		"",
 		"---",
 		"",
-		C(t),
+		ee,
 		"",
 		"---",
 		"",
-		C(s),
+		C(t),
 		"",
 		"---",
 		"",
-		C(n),
+		C(r),
 		"",
 		"---",
 		"",
@@ -242,12 +290,12 @@ function ie(e) {
 		"",
 		"---",
 		"",
-		re(e)
+		ae(e)
 	].join("\n");
 }
 //#endregion
 //#region src/client/components/charts/BarChart.config.ts
-var ae = {
+var w = {
 	clickableElements: { bar: !0 },
 	dropZones: [
 		{
@@ -284,12 +332,12 @@ var ae = {
 		"hideHeader"
 	],
 	displayOptionsConfig: [
-		h("chart.configText.how_to_stack_multiple_bar_series"),
-		x,
-		v,
-		_
+		g("chart.configText.how_to_stack_multiple_bar_series"),
+		S,
+		y,
+		v
 	]
-}, oe = {
+}, T = {
 	clickableElements: { point: !0 },
 	dropZones: [
 		{
@@ -326,10 +374,10 @@ var ae = {
 		"hideHeader"
 	],
 	displayOptionsConfig: [
-		f,
-		y(),
-		b,
+		p,
+		b(),
 		x,
+		S,
 		{
 			key: "priorPeriodStyle",
 			label: "chart.option.priorPeriodStyle.label",
@@ -361,10 +409,10 @@ var ae = {
 			step: .1,
 			description: "chart.option.priorPeriodOpacity.description"
 		},
-		v,
-		_
+		y,
+		v
 	]
-}, w = {
+}, se = {
 	dropZones: [
 		{
 			key: "xAxis",
@@ -400,15 +448,15 @@ var ae = {
 		"hideHeader"
 	],
 	displayOptionsConfig: [
-		f,
-		y(!1),
-		h("chart.configText.how_to_stack_multiple_area_series"),
-		b,
+		p,
+		b(!1),
+		g("chart.configText.how_to_stack_multiple_area_series"),
 		x,
-		v,
-		_
+		S,
+		y,
+		v
 	]
-}, T = {
+}, E = {
 	clickableElements: { slice: !0 },
 	dropZones: [{
 		key: "xAxis",
@@ -460,8 +508,8 @@ var ae = {
 				label: "chart.configText.80_percent"
 			}
 		]
-	}, p()]
-}, E = {
+	}, m()]
+}, D = {
 	dropZones: [
 		{
 			key: "xAxis",
@@ -512,7 +560,7 @@ var ae = {
 		type: "axisFormat",
 		description: "chart.option.yAxisFormat.description"
 	}]
-}, D = {
+}, O = {
 	dropZones: [
 		{
 			key: "xAxis",
@@ -584,7 +632,7 @@ var ae = {
 		type: "axisFormat",
 		description: "chart.configText.number_formatting_for_y_axis_and_values"
 	}]
-}, O = {
+}, k = {
 	dropZones: [
 		{
 			key: "xAxis",
@@ -617,8 +665,8 @@ var ae = {
 		"showTooltip",
 		"hideHeader"
 	],
-	displayOptionsConfig: [p()]
-}, k = {
+	displayOptionsConfig: [m()]
+}, A = {
 	dropZones: [{
 		key: "xAxis",
 		label: "chart.configText.categories",
@@ -640,8 +688,8 @@ var ae = {
 		"showTooltip",
 		"hideHeader"
 	],
-	displayOptionsConfig: [p()]
-}, A = {
+	displayOptionsConfig: [m()]
+}, j = {
 	dropZones: [
 		{
 			key: "xAxis",
@@ -675,9 +723,9 @@ var ae = {
 		"showTooltip",
 		"hideHeader"
 	],
-	displayOptionsConfig: [p("chart.configText.number_formatting_for_size_values")],
+	displayOptionsConfig: [m("chart.configText.number_formatting_for_size_values")],
 	clickableElements: { cell: !0 }
-}, j = {
+}, M = {
 	dropZones: [{
 		key: "xAxis",
 		label: "chart.configText.columns",
@@ -697,7 +745,7 @@ var ae = {
 		type: "axisFormat",
 		description: "chart.configText.number_formatting_for_numeric_values"
 	}]
-}, M = {
+}, N = {
 	dropZones: [{
 		key: "columns",
 		label: "chart.recordsTable.dropZone.columns.label",
@@ -760,7 +808,7 @@ var ae = {
 	],
 	clickableElements: { row: !0 },
 	recordGrain: !0
-}, N = {
+}, P = {
 	dropZones: [{
 		key: "dateField",
 		label: "chart.configText.time_dimension",
@@ -801,7 +849,7 @@ var ae = {
 		} : { isValid: !0 };
 	},
 	clickableElements: { cell: !0 }
-}, P = {
+}, F = {
 	dropZones: [{
 		key: "yAxis",
 		label: "chart.configText.value",
@@ -812,7 +860,7 @@ var ae = {
 		emptyText: "chart.kpiNumber.dropZone.yAxis.empty"
 	}],
 	displayOptionsConfig: [
-		g,
+		_,
 		{
 			key: "target",
 			label: "chart.runtime.tooltip.targetValue",
@@ -867,7 +915,7 @@ var ae = {
 		}
 	],
 	displayOptions: ["hideHeader"]
-}, F = {
+}, I = {
 	dropZones: [{
 		key: "yAxis",
 		label: "chart.configText.value",
@@ -886,7 +934,7 @@ var ae = {
 		emptyText: "chart.kpiDelta.dropZone.xAxis.empty"
 	}],
 	displayOptionsConfig: [
-		g,
+		_,
 		{
 			key: "showBaseline",
 			label: "chart.option.showBaseline.label",
@@ -959,7 +1007,7 @@ var ae = {
 		isValid: !1,
 		message: "chart.kpiDelta.validation.measureRequired"
 	} : { isValid: !0 }
-}, I = {
+}, L = {
 	dropZones: [{
 		key: "yAxis",
 		label: "chart.configText.value",
@@ -996,7 +1044,7 @@ var ae = {
 		}
 	],
 	displayOptions: ["hideHeader"]
-}, L = {
+}, R = {
 	skipQuery: !0,
 	dropZones: [],
 	displayOptionsConfig: [
@@ -1103,7 +1151,7 @@ var ae = {
 			description: "chart.configText.add_an_accent_colored_border_on_one_side_of_the_content"
 		}
 	]
-}, R = {
+}, z = {
 	dropZones: [{
 		key: "xAxis",
 		label: "chart.configText.step_name",
@@ -1186,7 +1234,7 @@ var ae = {
 			description: "chart.option.showP90Time.description"
 		}
 	]
-}, z = {
+}, B = {
 	dropZones: [{
 		key: "xAxis",
 		label: "chart.configText.event_type",
@@ -1242,7 +1290,7 @@ var ae = {
 			description: "chart.configText.hide_the_statistics_footer_below_the_chart"
 		}
 	]
-}, se = {
+}, V = {
 	dropZones: [{
 		key: "xAxis",
 		label: "chart.configText.event_type",
@@ -1277,7 +1325,7 @@ var ae = {
 		defaultValue: !0,
 		description: "chart.configText.hide_the_statistics_footer_below_the_chart"
 	}]
-}, B = {
+}, H = {
 	dropZones: [
 		{
 			key: "xAxis",
@@ -1358,7 +1406,7 @@ var ae = {
 		isValid: !1,
 		message: "chart.heatmap.validation.xAxisRequired"
 	}
-}, V = {
+}, U = {
 	dropZones: [],
 	displayOptionsConfig: [{
 		key: "showLegend",
@@ -1373,7 +1421,7 @@ var ae = {
 		defaultValue: !0,
 		description: "chart.option.showTooltip.description"
 	}]
-}, H = {
+}, W = {
 	dropZones: [],
 	displayOptionsConfig: [
 		{
@@ -1419,7 +1467,7 @@ var ae = {
 			description: "chart.option.showTooltip.description"
 		}
 	]
-}, U = {
+}, G = {
 	displayOptions: ["hideHeader"],
 	dropZones: [{
 		key: "xAxis",
@@ -1444,7 +1492,7 @@ var ae = {
 		type: "axisFormat",
 		description: "chart.configText.number_formatting_for_the_value_axis"
 	}]
-}, W = {
+}, K = {
 	displayOptions: [
 		"showGrid",
 		"showTooltip",
@@ -1555,7 +1603,7 @@ var ae = {
 			description: "chart.option.xAxisFormat.description"
 		}
 	]
-}, G = {
+}, q = {
 	clickableElements: { bar: !0 },
 	displayOptions: ["showTooltip", "hideHeader"],
 	dropZones: [{
@@ -1604,7 +1652,7 @@ var ae = {
 			description: "chart.configText.number_formatting_for_the_y_axis"
 		}
 	]
-}, K = {
+}, ce = {
 	clickableElements: { bar: !0 },
 	displayOptions: ["hideHeader"],
 	dropZones: [{
@@ -1666,7 +1714,7 @@ var ae = {
 			description: "chart.configText.number_formatting_for_the_price_axis"
 		}
 	]
-}, q = {
+}, le = {
 	displayOptions: [
 		"showLegend",
 		"showTooltip",
@@ -1738,7 +1786,7 @@ var ae = {
 			description: "chart.configText.number_formatting_for_the_y_axis"
 		}
 	]
-}, J = {
+}, ue = {
 	dropZones: [{
 		key: "xAxis",
 		label: "chart.configText.category",
@@ -1796,7 +1844,7 @@ var ae = {
 		isValid: !1,
 		message: "chart.proportionBar.validation.measureRequired"
 	} : { isValid: !0 }
-}, ce = {
+}, de = {
 	clickableElements: {},
 	displayOptions: ["hideHeader"],
 	dropZones: [{
@@ -1849,45 +1897,45 @@ var ae = {
 			description: "chart.configText.number_formatting_for_the_displayed_value_and_axis_labels"
 		}
 	]
-}, Y = {
+}, J = {
 	packageName: "recharts",
 	installCommand: "npm install recharts"
-}, le = {
+}, fe = {
 	bar: {
 		label: "chart.bar.label",
 		icon: "chartBar",
 		description: "chart.bar.description",
 		useCase: "chart.bar.useCase",
-		isAvailable: d,
-		dependencies: Y,
-		config: async () => (await import("./BarChart.config-Cq_qcxBA.js")).barChartConfig
+		isAvailable: f,
+		dependencies: J,
+		config: async () => (await import("./BarChart.config-CBACR7Z-.js")).barChartConfig
 	},
 	line: {
 		label: "chart.line.label",
 		icon: "chartLine",
 		description: "chart.line.description",
 		useCase: "chart.line.useCase",
-		isAvailable: d,
-		dependencies: Y,
-		config: async () => (await import("./LineChart.config-CJmTSmZ1.js")).lineChartConfig
+		isAvailable: f,
+		dependencies: J,
+		config: async () => (await import("./LineChart.config-CdONxSLL.js")).lineChartConfig
 	},
 	area: {
 		label: "chart.area.label",
 		icon: "chartArea",
 		description: "chart.area.description",
 		useCase: "chart.area.useCase",
-		isAvailable: d,
-		dependencies: Y,
-		config: async () => (await import("./AreaChart.config-BqNusnpg.js")).areaChartConfig
+		isAvailable: f,
+		dependencies: J,
+		config: async () => (await import("./AreaChart.config-BL_ZpMsg.js")).areaChartConfig
 	},
 	pie: {
 		label: "chart.pie.label",
 		icon: "chartPie",
 		description: "chart.pie.description",
 		useCase: "chart.pie.useCase",
-		isAvailable: d,
-		dependencies: Y,
-		config: async () => (await import("./PieChart.config-HZofeody.js")).pieChartConfig
+		isAvailable: f,
+		dependencies: J,
+		config: async () => (await import("./PieChart.config-Csx1ctk4.js")).pieChartConfig
 	},
 	scatter: {
 		label: "chart.scatter.label",
@@ -1901,8 +1949,8 @@ var ae = {
 			available: !1,
 			reason: "chart.availability.scatter"
 		} : { available: !0 },
-		dependencies: Y,
-		config: async () => (await import("./ScatterChart.config-BD2vfOZ6.js")).scatterChartConfig
+		dependencies: J,
+		config: async () => (await import("./ScatterChart.config-oOd1Jplx.js")).scatterChartConfig
 	},
 	bubble: {
 		label: "chart.bubble.label",
@@ -1916,49 +1964,49 @@ var ae = {
 			available: !1,
 			reason: "chart.availability.bubble"
 		} : { available: !0 },
-		dependencies: Y,
-		config: async () => (await import("./BubbleChart.config-CU_18uxb.js")).bubbleChartConfig
+		dependencies: J,
+		config: async () => (await import("./BubbleChart.config-22qXNskY.js")).bubbleChartConfig
 	},
 	radar: {
 		label: "chart.radar.label",
 		icon: "chartRadar",
 		description: "chart.radar.description",
 		useCase: "chart.radar.useCase",
-		isAvailable: d,
-		dependencies: Y,
-		config: async () => (await import("./RadarChart.config-B9OdMEib.js")).radarChartConfig
+		isAvailable: f,
+		dependencies: J,
+		config: async () => (await import("./RadarChart.config-AxQh97rB.js")).radarChartConfig
 	},
 	radialBar: {
 		label: "chart.radialBar.label",
 		icon: "chartRadialBar",
 		description: "chart.radialBar.description",
 		useCase: "chart.radialBar.useCase",
-		isAvailable: d,
-		dependencies: Y,
-		config: async () => (await import("./RadialBarChart.config-CeP7jEbq.js")).radialBarChartConfig
+		isAvailable: f,
+		dependencies: J,
+		config: async () => (await import("./RadialBarChart.config-DMaEJYM_.js")).radialBarChartConfig
 	},
 	treemap: {
 		label: "chart.treemap.label",
 		icon: "chartTreemap",
 		description: "chart.treemap.description",
 		useCase: "chart.treemap.useCase",
-		isAvailable: d,
-		dependencies: Y,
-		config: async () => (await import("./TreeMapChart.config-DBrqwtqT.js")).treemapChartConfig
+		isAvailable: f,
+		dependencies: J,
+		config: async () => (await import("./TreeMapChart.config--EB8bQTo.js")).treemapChartConfig
 	},
 	table: {
 		label: "chart.table.label",
 		icon: "chartTable",
 		description: "chart.table.description",
 		useCase: "chart.table.useCase",
-		config: async () => (await import("./DataTable.config-7JNSj6qQ.js")).dataTableConfig
+		config: async () => (await import("./DataTable.config-BXkpzOC2.js")).dataTableConfig
 	},
 	recordsTable: {
 		label: "chart.recordsTable.label",
 		icon: "chartRecordsTable",
 		description: "chart.recordsTable.description",
 		useCase: "chart.recordsTable.useCase",
-		config: async () => (await import("./RecordsTable.config-BInSgo-G.js")).recordsTableConfig
+		config: async () => (await import("./RecordsTable.config-BdN0kZ8b.js")).recordsTableConfig
 	},
 	activityGrid: {
 		label: "chart.activityGrid.label",
@@ -1972,62 +2020,62 @@ var ae = {
 			available: !1,
 			reason: "chart.availability.requiresTimeDimension"
 		} : { available: !0 },
-		config: async () => (await import("./ActivityGridChart.config-Dd2YDeaM.js")).activityGridChartConfig
+		config: async () => (await import("./ActivityGridChart.config-DfyZh3He.js")).activityGridChartConfig
 	},
 	kpiNumber: {
 		label: "chart.kpiNumber.label",
 		icon: "chartKpiNumber",
 		description: "chart.kpiNumber.description",
 		useCase: "chart.kpiNumber.useCase",
-		isAvailable: m,
-		config: async () => (await import("./KpiNumber.config-CkPWpcSz.js")).kpiNumberConfig
+		isAvailable: h,
+		config: async () => (await import("./KpiNumber.config-D3CogH8j.js")).kpiNumberConfig
 	},
 	kpiDelta: {
 		label: "chart.kpiDelta.label",
 		icon: "chartKpiDelta",
 		description: "chart.kpiDelta.description",
 		useCase: "chart.kpiDelta.useCase",
-		isAvailable: d,
-		config: async () => (await import("./KpiDelta.config-BGdqsHcc.js")).kpiDeltaConfig
+		isAvailable: f,
+		config: async () => (await import("./KpiDelta.config-C00mTZYy.js")).kpiDeltaConfig
 	},
 	kpiText: {
 		label: "chart.kpiText.label",
 		icon: "chartKpiText",
 		description: "chart.kpiText.description",
 		useCase: "chart.kpiText.useCase",
-		isAvailable: m,
-		config: async () => (await import("./KpiText.config-Bvtuv8vE.js")).kpiTextConfig
+		isAvailable: h,
+		config: async () => (await import("./KpiText.config-B0LbKRCf.js")).kpiTextConfig
 	},
 	markdown: {
 		label: "chart.markdown.label",
 		icon: "chartMarkdown",
 		description: "chart.markdown.description",
 		useCase: "chart.markdown.useCase",
-		config: async () => (await import("./MarkdownChart.config-Cm6G4Yuh.js")).markdownConfig
+		config: async () => (await import("./MarkdownChart.config-CngxD_Lc.js")).markdownConfig
 	},
 	funnel: {
 		label: "chart.funnel.label",
 		icon: "chartFunnel",
 		description: "chart.funnel.description",
 		useCase: "chart.funnel.useCase",
-		dependencies: Y,
-		config: async () => (await import("./FunnelChart.config-vuZScOHQ.js")).funnelChartConfig
+		dependencies: J,
+		config: async () => (await import("./FunnelChart.config-Cw9qrC2C.js")).funnelChartConfig
 	},
 	sankey: {
 		label: "chart.sankey.label",
 		icon: "chartSankey",
 		description: "chart.sankey.description",
 		useCase: "chart.sankey.useCase",
-		dependencies: Y,
-		config: async () => (await import("./SankeyChart.config-hfM0ACm1.js")).sankeyChartConfig
+		dependencies: J,
+		config: async () => (await import("./SankeyChart.config-Dlgi5_DA.js")).sankeyChartConfig
 	},
 	sunburst: {
 		label: "chart.sunburst.label",
 		icon: "chartSunburst",
 		description: "chart.sunburst.description",
 		useCase: "chart.sunburst.useCase",
-		dependencies: Y,
-		config: async () => (await import("./SunburstChart.config-BvrofzMv.js")).sunburstChartConfig
+		dependencies: J,
+		config: async () => (await import("./SunburstChart.config-Cllhyjy4.js")).sunburstChartConfig
 	},
 	heatmap: {
 		label: "chart.heatmap.label",
@@ -2045,46 +2093,46 @@ var ae = {
 			packageName: "@nivo/heatmap",
 			installCommand: "npm install @nivo/heatmap"
 		},
-		config: async () => (await import("./HeatMapChart.config-4XMab1zq.js")).heatmapChartConfig
+		config: async () => (await import("./HeatMapChart.config-DrvQrPHT.js")).heatmapChartConfig
 	},
 	retentionHeatmap: {
 		label: "chart.retentionHeatmap.label",
 		icon: "chartRetention",
 		description: "chart.retentionHeatmap.description",
 		useCase: "chart.retentionHeatmap.useCase",
-		config: async () => (await import("./RetentionHeatmap.config-DCtOD8dO.js")).retentionHeatmapConfig
+		config: async () => (await import("./RetentionHeatmap.config-YMZt-u-T.js")).retentionHeatmapConfig
 	},
 	retentionCombined: {
 		label: "chart.retentionCombined.label",
 		icon: "chartRetention",
 		description: "chart.retentionCombined.description",
 		useCase: "chart.retentionCombined.useCase",
-		config: async () => (await import("./RetentionCombinedChart.config-Bxtxnlcf.js")).retentionCombinedConfig
+		config: async () => (await import("./RetentionCombinedChart.config-CY8TDzuy.js")).retentionCombinedConfig
 	},
 	boxPlot: {
 		label: "chart.boxPlot.label",
 		icon: "chartBoxPlot",
 		description: "chart.boxPlot.description",
 		useCase: "chart.boxPlot.useCase",
-		isAvailable: d,
-		config: async () => (await import("./BoxPlotChart.config-Zc-JGV-W.js")).boxPlotChartConfig
+		isAvailable: f,
+		config: async () => (await import("./BoxPlotChart.config-Bvg6yFn2.js")).boxPlotChartConfig
 	},
 	dotStrip: {
 		label: "chart.dotStrip.label",
 		icon: "chartDotStrip",
 		description: "chart.dotStrip.description",
 		useCase: "chart.dotStrip.useCase",
-		isAvailable: d,
-		config: async () => (await import("./DotStripChart.config-B7Dl-T1h.js")).dotStripChartConfig
+		isAvailable: f,
+		config: async () => (await import("./DotStripChart.config-D5sbLAqA.js")).dotStripChartConfig
 	},
 	waterfall: {
 		label: "chart.waterfall.label",
 		icon: "chartWaterfall",
 		description: "chart.waterfall.description",
 		useCase: "chart.waterfall.useCase",
-		isAvailable: d,
-		dependencies: Y,
-		config: async () => (await import("./WaterfallChart.config-DZ8H0V2L.js")).waterfallChartConfig
+		isAvailable: f,
+		dependencies: J,
+		config: async () => (await import("./WaterfallChart.config-xz3DaoMQ.js")).waterfallChartConfig
 	},
 	candlestick: {
 		label: "chart.candlestick.label",
@@ -2098,7 +2146,7 @@ var ae = {
 			available: !1,
 			reason: "chart.availability.requiresDimension"
 		} : { available: !0 },
-		config: async () => (await import("./CandlestickChart.config-Bwo3uaa-.js")).candlestickChartConfig
+		config: async () => (await import("./CandlestickChart.config-G78UbuwS.js")).candlestickChartConfig
 	},
 	measureProfile: {
 		label: "chart.measureProfile.label",
@@ -2109,31 +2157,31 @@ var ae = {
 			available: !1,
 			reason: "chart.availability.requiresTwoMeasures"
 		} : { available: !0 },
-		dependencies: Y,
-		config: async () => (await import("./MeasureProfileChart.config-Dt7npubZ.js")).measureProfileChartConfig
+		dependencies: J,
+		config: async () => (await import("./MeasureProfileChart.config-ByW5F1Ey.js")).measureProfileChartConfig
 	},
 	proportionBar: {
 		label: "chart.proportionBar.label",
 		icon: "chartProportionBar",
 		description: "chart.proportionBar.description",
 		useCase: "chart.proportionBar.useCase",
-		isAvailable: d,
-		config: async () => (await import("./ProportionBarChart.config-ChCSoM0L.js")).proportionBarChartConfig
+		isAvailable: f,
+		config: async () => (await import("./ProportionBarChart.config-DCOizSVs.js")).proportionBarChartConfig
 	},
 	gauge: {
 		label: "chart.gauge.label",
 		icon: "chartGauge",
 		description: "chart.gauge.description",
 		useCase: "chart.gauge.useCase",
-		isAvailable: m,
+		isAvailable: h,
 		dependencies: {
 			packageName: "d3-shape",
 			installCommand: "npm install d3-shape"
 		},
-		config: async () => (await import("./GaugeChart.config-zdpFydo6.js")).gaugeChartConfig
+		config: async () => (await import("./GaugeChart.config-F5SA5Oi3.js")).gaugeChartConfig
 	}
 };
-function ue(e, t) {
+function pe(e, t) {
 	return {
 		...t,
 		label: e.label,
@@ -2144,86 +2192,96 @@ function ue(e, t) {
 }
 //#endregion
 //#region src/client/charts/chartConfigRegistry.ts
-var de = {
-	bar: ae,
-	line: oe,
-	area: w,
-	pie: T,
-	scatter: E,
-	bubble: D,
-	radar: O,
-	radialBar: k,
-	treemap: A,
-	table: j,
-	recordsTable: M,
-	activityGrid: N,
-	kpiNumber: P,
-	kpiDelta: F,
-	kpiText: I,
-	markdown: L,
-	funnel: R,
-	sankey: z,
-	sunburst: se,
-	heatmap: B,
-	retentionHeatmap: V,
-	retentionCombined: H,
-	boxPlot: U,
-	dotStrip: W,
-	waterfall: G,
-	candlestick: K,
-	measureProfile: q,
-	proportionBar: J,
-	gauge: ce
-}, X = Object.fromEntries(Object.keys(le).map((e) => [e, ue(le[e], de[e])]));
-function fe(e) {
-	return X[e]?.recordGrain === !0;
+var me = {
+	bar: w,
+	line: T,
+	area: se,
+	pie: E,
+	scatter: D,
+	bubble: O,
+	radar: k,
+	radialBar: A,
+	treemap: j,
+	table: M,
+	recordsTable: N,
+	activityGrid: P,
+	kpiNumber: F,
+	kpiDelta: I,
+	kpiText: L,
+	markdown: R,
+	funnel: z,
+	sankey: B,
+	sunburst: V,
+	heatmap: H,
+	retentionHeatmap: U,
+	retentionCombined: W,
+	boxPlot: G,
+	dotStrip: K,
+	waterfall: q,
+	candlestick: ce,
+	measureProfile: le,
+	proportionBar: ue,
+	gauge: de
+}, Y = Object.fromEntries(Object.keys(fe).map((e) => [e, pe(fe[e], me[e])]));
+function he(e) {
+	return Y[e]?.recordGrain === !0;
 }
 //#endregion
 //#region src/server/agent/chart-validation.ts
-function Z(e) {
+function X(e) {
 	return Array.isArray(e) ? e.length > 0 : !!e;
 }
-function pe(t, n, r, i) {
-	for (let a of t.dropZones) {
-		if (!a.mandatory || Z(r?.[a.key])) continue;
-		let t = a.acceptTypes?.join("/") ?? "fields";
-		i.push(e("server.validation.chart.dropZoneRequired", {
-			key: a.key,
-			chartType: n,
-			label: a.label,
-			acceptDesc: t
+function ge(e, t, n, r) {
+	for (let i of e.dropZones) {
+		if (!i.mandatory || X(n?.[i.key])) continue;
+		let e = i.acceptTypes?.join("/") ?? "fields";
+		r.push(a("server.validation.chart.dropZoneRequired", {
+			key: i.key,
+			chartType: t,
+			label: i.label,
+			acceptDesc: e
 		}));
 	}
 }
-function me(t, n, r) {
-	if (Z(t?.xAxis)) return;
-	let i = n.dimensions ?? [], a = n.timeDimensions ?? [], o = i.length > 0 || a.length > 0;
-	r.push(e(o ? "server.validation.chart.barXAxisRequired" : "server.validation.chart.barNeedsDimension"));
+function _e(e, t, n) {
+	if (X(e?.xAxis)) return;
+	let r = t.dimensions ?? [], i = t.timeDimensions ?? [], o = r.length > 0 || i.length > 0;
+	n.push(a(o ? "server.validation.chart.barXAxisRequired" : "server.validation.chart.barNeedsDimension"));
 }
-function he(e) {
+function ve(e) {
 	return Array.isArray(e) ? e : [e];
 }
-function ge(t, n) {
-	if (!t?.xAxis || !t?.series) return;
-	let r = new Set(he(t.xAxis)), i = he(t.series).filter((e) => r.has(e));
-	i.length > 0 && n.push(e("server.validation.chart.seriesDuplicatesXAxis", { duplicates: i.join(", ") }));
+function ye(e, t) {
+	if (!e?.xAxis || !e?.series) return;
+	let n = new Set(ve(e.xAxis)), r = ve(e.series).filter((e) => n.has(e));
+	r.length > 0 && t.push(a("server.validation.chart.seriesDuplicatesXAxis", { duplicates: r.join(", ") }));
 }
-function _e(t, n, r) {
-	fe(t) && n.ungrouped !== !0 && r.push(e("server.validation.chart.recordGrainNeedsUngrouped", { chartType: t }));
+function be(e, t, n) {
+	he(e) && t.ungrouped !== !0 && n.push(a("server.validation.chart.recordGrainNeedsUngrouped", { chartType: e }));
 }
-function ve(e, t, n) {
-	let r = X[e];
+function xe(e, t, n) {
+	let r = Y[e];
 	if (!r || r.skipQuery) return {
 		isValid: !0,
 		errors: []
 	};
 	let i = [];
-	return pe(r, e, t, i), _e(e, n, i), e === "bar" && me(t, n, i), ge(t, i), {
+	return ge(r, e, t, i), be(e, n, i), e === "bar" && _e(t, n, i), ye(t, i), {
 		isValid: i.length === 0,
 		errors: i
 	};
 }
-function ye(e, t, n, r) {
+function Se(e, t, n) {
+	if (e !== "bar" || X(t?.xAxis)) return { chartType: e };
+	let r = n.dimensions ?? [], i = n.timeDimensions ?? [];
+	if (r.length > 0 || i.length > 0) return { chartType: e };
+	let a = (n.measures ?? []).length === 1 ? "kpiNumber" : "table";
+	return {
+		chartType: a,
+		note: `Note: chartType was changed from "bar" to "${a}" because the query has no dimension, so a bar chart would have no category axis to label its bars. For a real bar chart, put the category in the query's dimensions and use a single measure. To plot several measures as an ordered profile instead, use "measureProfile".`
+	};
+}
+function Ce(e, t, n, r) {
 	if (!(e.acceptTypes ?? []).includes("measure")) return;
 	let i = /* @__PURE__ */ new Set();
 	for (let r of t.dropZones) {
@@ -2234,37 +2292,42 @@ function ye(e, t, n, r) {
 	let a = r.filter((e) => !i.has(e));
 	a.length > 0 && (n[e.key] = a[0]);
 }
-function be(e, t, n) {
+function we(e, t) {
+	let n = /* @__PURE__ */ new Set();
+	for (let [r, i] of Object.entries(e)) if (r !== t) {
+		if (Array.isArray(i)) for (let e of i) typeof e == "string" && n.add(e);
+		else typeof i == "string" && n.add(i);
+	}
+	return n;
+}
+function Te(e, t, n) {
 	let r = e.acceptTypes ?? [], i = [];
 	if (r.includes("dimension") && i.push(...n.dimensions), r.includes("timeDimension") && i.push(...n.timeDimFields), r.includes("measure") && i.push(...n.measures), i.length === 0) return;
-	let a = i;
-	if (e.key === "series") {
-		let e = new Set(Array.isArray(t.xAxis) ? t.xAxis : t.xAxis ? [t.xAxis] : []);
-		if (a = i.filter((t) => !e.has(t)), a.length === 0) return;
-	}
-	let o = e.maxItems ?? Infinity, s = a.slice(0, o);
-	s.length > 0 && (t[e.key] = s);
+	let a = we(t, e.key), o = i.filter((e) => !a.has(e));
+	if (o.length === 0) return;
+	let s = e.maxItems ?? Infinity, c = o.slice(0, s);
+	c.length > 0 && (t[e.key] = c);
 }
-function xe(e, t, n) {
-	let r = X[e];
+function Ee(e, t, n) {
+	let r = Y[e];
 	if (!r) return t ?? {};
 	let i = { ...t }, a = n.timeDimensions ?? [], o = {
 		measures: n.measures ?? [],
 		dimensions: n.dimensions ?? [],
 		timeDimFields: a.map((e) => e.dimension)
 	};
-	for (let e of r.dropZones) e.excludeFromInference || Z(i[e.key]) || (e.key === "sizeField" || e.key === "colorField" ? ye(e, r, i, o.measures) : be(e, i, o));
+	for (let e of r.dropZones) e.excludeFromInference || X(i[e.key]) || (e.key === "sizeField" || e.key === "colorField" ? Ce(e, r, i, o.measures) : Te(e, i, o));
 	return i;
 }
-function Se(t) {
-	return t ? i(t) ? e(t) : t : "";
+function De(t) {
+	return t ? e(t) ? a(t) : t : "";
 }
-function Ce(e) {
+function Oe(e) {
 	let t = ["\nChart config requirements by type:"];
 	for (let n of e) {
-		let e = X[n];
+		let e = Y[n];
 		if (!e) continue;
-		let r = [Se(e.description), Se(e.useCase)].filter(Boolean).join(". "), i = r ? ` — ${r}.` : "", a = fe(n) ? " Query MUST set \"ungrouped\": true, which also means one cube plus its to-one joins — an ungrouped query cannot span a hasMany relationship." : "", o = e.dropZones.filter((e) => e.mandatory);
+		let r = [De(e.description), De(e.useCase)].filter(Boolean).join(". "), i = r ? ` — ${r}.` : "", a = he(n) ? " Query MUST set \"ungrouped\": true, which also means one cube plus its to-one joins — an ungrouped query cannot span a hasMany relationship." : "", o = e.dropZones.filter((e) => e.mandatory);
 		if (o.length === 0 && !e.skipQuery) {
 			t.push(`  ${n}${i}${a} chartConfig auto-inferred from query.`);
 			continue;
@@ -2282,29 +2345,46 @@ function Ce(e) {
 	return t.join("\n");
 }
 //#endregion
+//#region src/server/agent/data-shape.ts
+function ke(e, t, n, r) {
+	let i = /* @__PURE__ */ new Set(), a = 0, o, s, c = !0;
+	for (let n of e) {
+		let e = n[t];
+		if (e == null) {
+			a++;
+			continue;
+		}
+		i.add(e);
+		let r = typeof e == "number" ? e : Number(e);
+		typeof e == "boolean" || Number.isNaN(r) ? c = !1 : (o = o === void 0 || r < o ? r : o, s = s === void 0 || r > s ? r : s);
+	}
+	return {
+		field: t,
+		kind: n,
+		...r ? { type: r } : {},
+		distinctCount: i.size,
+		nullCount: a,
+		...c && o !== void 0 ? {
+			min: o,
+			max: s
+		} : {}
+	};
+}
+function Ae(e, t) {
+	if (e.length === 0) return [];
+	let n = [], r = /* @__PURE__ */ new Set(), i = [
+		["dimension", t?.dimensions],
+		["timeDimension", t?.timeDimensions],
+		["measure", t?.measures]
+	];
+	for (let [t, a] of i) for (let [i, o] of Object.entries(a ?? {})) r.add(i), n.push(ke(e, i, t, o?.type));
+	for (let t of Object.keys(e[0])) r.has(t) || n.push(ke(e, t, "dimension", void 0));
+	return n;
+}
+//#endregion
 //#region src/server/agent/tools.ts
-var Q = [
-	"bar",
-	"line",
-	"area",
-	"pie",
-	"scatter",
-	"radar",
-	"bubble",
-	"table",
-	"kpiNumber",
-	"kpiDelta",
-	"funnel",
-	"heatmap",
-	"sankey",
-	"sunburst",
-	"retentionHeatmap",
-	"retentionCombined",
-	"boxPlot",
-	"markdown",
-	"recordsTable"
-];
-function we() {
+var Z = /* @__PURE__ */ "bar.line.area.pie.scatter.radar.bubble.table.kpiNumber.kpiDelta.kpiText.funnel.heatmap.sankey.sunburst.retentionHeatmap.retentionCombined.boxPlot.markdown.recordsTable.treemap.radialBar.proportionBar.dotStrip.waterfall.measureProfile.activityGrid.gauge.candlestick".split(".");
+function je() {
 	return [
 		{
 			name: "discover_cubes",
@@ -2344,12 +2424,12 @@ function we() {
 			description: "Execute a semantic query and return data results. Supports standard queries (measures/dimensions) and analysis modes (funnel/flow/retention). Only provide ONE mode per call.",
 			parameters: {
 				type: "object",
-				properties: c
+				properties: n
 			}
 		},
 		{
 			name: "add_portlet",
-			description: "Add a chart visualization to the notebook.\n" + Ce(Q) + "\nThe query is validated before adding. The portlet fetches its own data.",
+			description: "Add a chart visualization to the notebook.\n" + Oe(Z) + "\nThe query is validated before adding. The portlet fetches its own data.",
 			parameters: {
 				type: "object",
 				properties: {
@@ -2363,7 +2443,7 @@ function we() {
 					},
 					chartType: {
 						type: "string",
-						enum: Q,
+						enum: Z,
 						description: "Chart type to render"
 					},
 					chartConfig: {
@@ -2387,7 +2467,8 @@ function we() {
 								type: "object",
 								description: "Dual Y-axis: map measure fields to \"left\" or \"right\" axis. Only for bar, line, area charts with 2+ measures of different scales. Example: {\"Sales.revenue\": \"left\", \"Sales.conversionRate\": \"right\"}"
 							},
-							...u
+							...l,
+							...d
 						},
 						description: "Chart axis configuration"
 					},
@@ -2402,7 +2483,8 @@ function we() {
 								type: "string",
 								enum: ["horizontal", "vertical"]
 							},
-							...l
+							...c,
+							...u
 						},
 						description: "Chart display configuration"
 					}
@@ -2414,6 +2496,41 @@ function we() {
 				]
 			}
 		},
+		{
+			name: "update_portlet",
+			description: "Amend a visualization you already added in this conversation, in place. Use this instead of add_portlet when a chart came back wrong or the user asks to change one — adding a second chart of the same data clutters the notebook. Only the fields you pass are changed; the rest are kept. The same validation as add_portlet applies. For a portlet added earlier in the conversation rather than this turn, pass the full `query` and `chartType` as well as the fields you are changing.",
+			parameters: {
+				type: "object",
+				properties: {
+					portletId: {
+						type: "string",
+						description: "The id returned by add_portlet"
+					},
+					title: {
+						type: "string",
+						description: "New title"
+					},
+					query: {
+						type: "string",
+						description: "Replacement query, as a JSON string (same shape as add_portlet)"
+					},
+					chartType: {
+						type: "string",
+						enum: Z,
+						description: "Replacement chart type"
+					},
+					chartConfig: {
+						type: "object",
+						description: "Replacement chart axis configuration (replaces, does not merge)"
+					},
+					displayConfig: {
+						type: "object",
+						description: "Replacement chart display configuration (replaces, does not merge)"
+					}
+				},
+				required: ["portletId"]
+			}
+		},
 		{
 			name: "add_markdown",
 			description: "Add an explanation or analysis text block to the notebook. Use markdown formatting. Use this to explain findings, methodology, and insights alongside visualizations.",
@@ -2461,7 +2578,7 @@ function we() {
 								},
 								chartType: {
 									type: "string",
-									enum: Q,
+									enum: Z,
 									description: "Chart type. Use \"markdown\" for section headers."
 								},
 								query: {
@@ -2485,14 +2602,18 @@ function we() {
 										},
 										sizeField: { type: "string" },
 										colorField: { type: "string" },
-										...u
+										...l,
+										...d
 									},
 									description: "Chart axis configuration"
 								},
 								displayConfig: {
 									type: "object",
 									description: "Chart display configuration (for markdown: { content, hideHeader, transparentBackground, autoHeight })",
-									properties: l
+									properties: {
+										...c,
+										...u
+									}
 								},
 								dashboardFilterMapping: {
 									type: "array",
@@ -2600,10 +2721,10 @@ function we() {
 		}
 	];
 }
-function Te(e) {
-	let { semanticLayer: t, securityContext: n } = e, i = /* @__PURE__ */ new Map();
-	i.set("discover_cubes", async (e) => {
-		let r = { cubes: (await o(t, n, {
+function Me(e) {
+	let { semanticLayer: t, securityContext: n } = e, r = /* @__PURE__ */ new Map(), a = /* @__PURE__ */ new Map();
+	r.set("discover_cubes", async (e) => {
+		let r = { cubes: (await s(t, n, {
 			topic: e.topic,
 			intent: e.intent,
 			limit: e.limit,
@@ -2624,20 +2745,20 @@ function Te(e) {
 			} } : {}
 		})) };
 		return { result: JSON.stringify(r) + "\n[IMPORTANT: Your next response MUST start with a brief text message BEFORE any tool calls.]" };
-	}), i.set("get_cube_metadata", async () => {
+	}), r.set("get_cube_metadata", async () => {
 		let e = t.getMetadata(n);
 		return { result: JSON.stringify(e) };
 	});
-	let s = /* @__PURE__ */ new Map();
-	for (let e of t.getMetadata(n)) s.set(e.name, {
+	let c = /* @__PURE__ */ new Map();
+	for (let e of t.getMetadata(n)) c.set(e.name, {
 		measures: (e.measures || []).map((e) => e.name),
 		dimensions: (e.dimensions || []).map((e) => e.name)
 	});
-	let c = (e, t) => {
-		let n = s.get(e), r = t === "measures" ? n?.measures : n?.dimensions;
+	let l = (e, t) => {
+		let n = c.get(e), r = t === "measures" ? n?.measures : n?.dimensions;
 		return !r || r.length === 0 ? "" : ` Available ${t}: ${r.slice(0, 5).map((e) => `"${e}"`).join(", ")}`;
 	};
-	return i.set("execute_query", async (e) => {
+	r.set("execute_query", async (e) => {
 		try {
 			let r = (e, t) => {
 				if (!Array.isArray(e)) return;
@@ -2645,7 +2766,7 @@ function Te(e) {
 				for (let r of e) {
 					if (typeof r != "string") continue;
 					let e = r.split(".");
-					e.length === 1 ? n.push(`"${r}" is not valid — must be "CubeName.fieldName".${c(r, t)}`) : e.length === 2 && e[0] === e[1] && n.push(`"${r}" is WRONG — "${e[0]}" is the cube name, not a ${t.replace(/s$/, "")}.${c(e[0], t)}`);
+					e.length === 1 ? n.push(`"${r}" is not valid — must be "CubeName.fieldName".${l(r, t)}`) : e.length === 2 && e[0] === e[1] && n.push(`"${r}" is WRONG — "${e[0]}" is the cube name, not a ${t.replace(/s$/, "")}.${l(e[0], t)}`);
 				}
 				if (n.length > 0) throw Error(`Invalid ${t}:\n${n.join("\n")}`);
 			};
@@ -2661,11 +2782,13 @@ function Te(e) {
 				offset: e.offset,
 				ungrouped: e.ungrouped
 			};
-			let o = await a(t, n, { query: i });
+			let a = await o(t, n, { query: i }), s = a.data.slice(0, 25);
 			return { result: JSON.stringify({
-				rowCount: o.data.length,
-				data: o.data,
-				annotation: o.annotation
+				rowCount: a.data.length,
+				data: s,
+				truncated: a.data.length > s.length,
+				dataShape: Ae(s, a.annotation),
+				annotation: a.annotation
 			}) + "\n[IMPORTANT: Your next response MUST start with a brief text message BEFORE any tool calls. Now call add_markdown and add_portlet to visualize these results.]" };
 		} catch (t) {
 			let n = {
@@ -2684,112 +2807,157 @@ function Te(e) {
 				isError: !0
 			};
 		}
-	}), i.set("add_portlet", async (e) => {
-		let i = {
+	});
+	function u(e) {
+		let r = {
 			number: "kpiNumber",
 			retention: "retentionHeatmap"
 		}[e.chartType] ?? e.chartType, a;
 		try {
 			a = JSON.parse(e.query);
 		} catch {
-			return {
-				result: "Invalid query: could not parse JSON string. Ensure `query` is a valid JSON string.",
-				isError: !0
-			};
+			return { error: "Invalid query: could not parse JSON string. Ensure `query` is a valid JSON string." };
 		}
-		a = r(a);
+		a = i(a);
 		let o = t.validateQuery(a, n);
-		if (!o.isValid) return {
-			result: `Invalid query — fix these errors and retry:\n${o.errors.join("\n")}\n\nAttempted query:\n${JSON.stringify(a, null, 2)}`,
-			isError: !0
-		};
-		let s = !!(a.funnel || a.flow || a.retention), c;
+		if (!o.isValid) return { error: `Invalid query — fix these errors and retry:\n${o.errors.join("\n")}\n\nAttempted query:\n${JSON.stringify(a, null, 2)}` };
+		let s = !!(a.funnel || a.flow || a.retention), c, l = r, u;
 		if (s) c = e.chartConfig ?? {};
 		else {
-			let t = xe(i, e.chartConfig, a), n = ve(i, t, a);
-			if (!n.isValid) return {
-				result: `Chart config invalid — fix these errors and retry:\n${n.errors.join("\n")}`,
-				isError: !0
-			};
-			c = t;
+			let t = Se(r, e.chartConfig, a);
+			l = t.chartType, u = t.note;
+			let n = Ee(l, e.chartConfig, a), i = xe(l, n, a);
+			if (!i.isValid) return { error: `Chart config invalid — fix these errors and retry:\n${i.errors.join("\n")}\n\nchartType: ${l}\nAttempted chartConfig:\n${JSON.stringify(n, null, 2)}\n\nQuery:\n${JSON.stringify(a, null, 2)}` };
+			c = n;
 		}
-		let l = `portlet-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`, u = {
-			id: l,
-			title: e.title,
-			query: JSON.stringify(a),
-			chartType: i,
-			chartConfig: c,
+		return {
+			portlet: {
+				query: JSON.stringify(a),
+				chartType: l,
+				chartConfig: c,
+				displayConfig: e.displayConfig
+			},
+			...u ? { note: u } : {}
+		};
+	}
+	return r.set("add_portlet", async (e) => {
+		let t = u({
+			query: e.query,
+			chartType: e.chartType,
+			chartConfig: e.chartConfig,
 			displayConfig: e.displayConfig
+		});
+		if ("error" in t) return {
+			result: t.error,
+			isError: !0
 		};
-		return {
-			result: `Portlet "${e.title}" added to notebook (id: ${l}, chart: ${i}). [Reminder: in your next response, start with a brief sentence about what you will do next BEFORE making any tool calls.]`,
+		let n = `portlet-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`, r = {
+			id: n,
+			title: e.title,
+			...t.portlet
+		};
+		return a.set(n, r), {
+			result: `Portlet "${e.title}" added to notebook (id: ${n}, chart: ${r.chartType}).` + (t.note ? `\n${t.note}` : "") + " [Reminder: in your next response, start with a brief sentence about what you will do next BEFORE making any tool calls.]",
 			sideEffect: {
 				type: "add_portlet",
-				data: u
+				data: r
 			}
 		};
-	}), i.set("add_markdown", async (e) => {
-		let t = `markdown-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`, n = e.content || e.text || e.markdown || "", r = {
+	}), r.set("update_portlet", async (e) => {
+		let t = e.portletId, n = t ? a.get(t) : void 0, r = e.query ?? n?.query, i = e.chartType ?? n?.chartType;
+		if (!t || !r || !i) return {
+			result: `Cannot update portlet "${t ?? ""}": it was not added in this conversation, so there is nothing to merge your change into. Call update_portlet again with the same portletId plus the full \`query\` and \`chartType\` for the chart you want.`,
+			isError: !0
+		};
+		let o = u({
+			query: r,
+			chartType: i,
+			chartConfig: e.chartConfig ?? n?.chartConfig,
+			displayConfig: e.displayConfig ?? n?.displayConfig
+		});
+		if ("error" in o) return {
+			result: o.error,
+			isError: !0
+		};
+		let s = e.title ?? n?.title ?? "Untitled", c = {
 			id: t,
+			title: s,
+			...o.portlet
+		};
+		return a.set(t, c), {
+			result: `Portlet "${s}" updated (id: ${t}, chart: ${c.chartType}).` + (o.note ? `\n${o.note}` : "") + " [Reminder: in your next response, start with a brief sentence about what you will do next BEFORE making any tool calls.]",
+			sideEffect: {
+				type: "update_portlet",
+				data: c
+			}
+		};
+	}), r.set("add_markdown", async (e) => {
+		let t = e.content || e.text || e.markdown || "";
+		if (typeof t != "string" || t.trim() === "") return {
+			result: "add_markdown was called with no content, so no block was added. Call add_markdown again with the explanation text in the `content` field.",
+			isError: !0
+		};
+		let n = `markdown-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`, r = {
+			id: n,
 			title: e.title,
-			content: n
+			content: t
 		};
 		return {
-			result: `Markdown block added to notebook (id: ${t}). [Reminder: in your next response, start with a brief sentence about what you will do next BEFORE making any tool calls.]`,
+			result: `Markdown block added to notebook (id: ${n}). [Reminder: in your next response, start with a brief sentence about what you will do next BEFORE making any tool calls.]`,
 			sideEffect: {
 				type: "add_markdown",
 				data: r
 			}
 		};
-	}), i.set("save_as_dashboard", async (e) => {
+	}), r.set("save_as_dashboard", async (e) => {
 		try {
-			let i = e.portlets;
-			if (!i || i.length === 0) return {
+			let r = e.portlets;
+			if (!r || r.length === 0) return {
 				result: "Dashboard must contain at least one portlet.",
 				isError: !0
 			};
-			let a = [], o = /* @__PURE__ */ new Map();
-			for (let e of i) {
-				let i = e.chartType;
-				if (i === "markdown") continue;
-				let s = e.query;
-				if (!s) {
+			let a = [], o = /* @__PURE__ */ new Map(), s = /* @__PURE__ */ new Map();
+			for (let e of r) {
+				let r = e.chartType;
+				if (r === "markdown") continue;
+				let c = e.query;
+				if (!c) {
 					a.push(`Portlet "${e.title}": missing query`);
 					continue;
 				}
-				let c;
+				let l;
 				try {
-					c = JSON.parse(s);
+					l = JSON.parse(c);
 				} catch {
 					a.push(`Portlet "${e.title}": invalid JSON query`);
 					continue;
 				}
-				c = r(c);
-				let l = t.validateQuery(c, n);
-				if (!l.isValid) {
-					a.push(`Portlet "${e.title}": ${l.errors.join(", ")}`);
+				l = i(l);
+				let u = t.validateQuery(l, n);
+				if (!u.isValid) {
+					a.push(`Portlet "${e.title}": ${u.errors.join(", ")}`);
 					continue;
 				}
-				let u = xe(i, e.chartConfig, c), d = ve(i, u, c);
-				if (!d.isValid) {
-					a.push(`Portlet "${e.title}": ${d.errors.join(", ")}`);
+				let d = Se(r, e.chartConfig, l).chartType, f = Ee(d, e.chartConfig, l), p = xe(d, f, l);
+				if (!p.isValid) {
+					a.push(`Portlet "${e.title}": ${p.errors.join(", ")}`);
 					continue;
 				}
-				o.set(e, u);
+				o.set(e, f), s.set(e, d);
 			}
 			if (a.length > 0) return {
 				result: `Dashboard has invalid portlets — fix these errors and retry:\n${a.join("\n")}`,
 				isError: !0
 			};
-			let s = {
-				portlets: i.map((e) => {
-					let t = e.chartType, n = t === "markdown", r = n ? "query" : e.analysisType || "query", i = r === "funnel" ? "funnel" : r === "flow" ? "flow" : r === "retention" ? "retention" : "query", a = e.query || "{}", s;
+			let c = {
+				portlets: r.map((e) => {
+					let t = s.get(e) ?? e.chartType, n = t === "markdown", r = n ? "query" : e.analysisType || "query", i = r === "funnel" ? "funnel" : r === "flow" ? "flow" : r === "retention" ? "retention" : "query", a = e.query || "{}", c;
 					try {
-						s = JSON.parse(a);
+						c = JSON.parse(a);
 					} catch {
-						s = {};
+						c = {};
 					}
-					let c = {
+					let l = {
 						version: 1,
 						analysisType: i,
 						activeView: "chart",
@@ -2798,12 +2966,12 @@ function Te(e) {
 							chartConfig: o.get(e) ?? e.chartConfig ?? {},
 							displayConfig: e.displayConfig || {}
 						} },
-						query: n ? {} : s
+						query: n ? {} : c
 					};
 					return {
 						id: e.id,
 						title: e.title,
-						analysisConfig: c,
+						analysisConfig: l,
 						dashboardFilterMapping: e.dashboardFilterMapping,
 						w: e.w,
 						h: e.h,
@@ -2813,15 +2981,15 @@ function Te(e) {
 				}),
 				filters: e.filters,
 				colorPalette: e.colorPalette
-			}, c = e.title;
+			}, l = e.title;
 			return {
-				result: `Dashboard "${c}" created with ${s.portlets.length} portlets and ${s.filters?.length || 0} filters.`,
+				result: `Dashboard "${l}" created with ${c.portlets.length} portlets and ${c.filters?.length || 0} filters.`,
 				sideEffect: {
 					type: "dashboard_saved",
 					data: {
-						title: c,
+						title: l,
 						description: e.description,
-						dashboardConfig: s
+						dashboardConfig: c
 					}
 				}
 			};
@@ -2831,22 +2999,22 @@ function Te(e) {
 				isError: !0
 			};
 		}
-	}), i;
+	}), r;
 }
 //#endregion
 //#region src/server/agent/providers/factory.ts
-async function Ee(e, t, n) {
+async function Ne(e, t, n) {
 	switch (e) {
 		case "anthropic": {
-			let { AnthropicProvider: e } = await import("./anthropic-CZh4hB-m.js");
+			let { AnthropicProvider: e } = await import("./anthropic-MQlafOZv.js");
 			return new e(t);
 		}
 		case "openai": {
-			let { OpenAIProvider: e } = await import("./openai-DK_KWiI7.js");
+			let { OpenAIProvider: e } = await import("./openai-62sEF0Ev.js");
 			return new e(t, n);
 		}
 		case "google": {
-			let { GoogleProvider: e } = await import("./google-DRY7jnOh.js");
+			let { GoogleProvider: e } = await import("./google-BBBP1Dhs.js");
 			return new e(t);
 		}
 		default: throw Error(`Unknown LLM provider: "${e}". Supported providers: anthropic, openai, google`);
@@ -2854,16 +3022,16 @@ async function Ee(e, t, n) {
 }
 //#endregion
 //#region src/server/agent/handler-steps.ts
-function De(e, t) {
+function Pe(e, t) {
 	if (Array.isArray(t)) for (let n of t) e.push(n);
 	else e.push(t);
 }
-function $(e) {
+function Q(e) {
 	if (e) try {
 		e();
 	} catch {}
 }
-function Oe(e, t) {
+function Fe(e, t) {
 	let n = [];
 	if (!e || e.length === 0) return n;
 	for (let r of e) {
@@ -2896,7 +3064,7 @@ function Oe(e, t) {
 				content: typeof e.result == "string" ? e.result : JSON.stringify(e.result ?? ""),
 				isError: e.status === "error"
 			}));
-			De(n, t.formatToolResults(i));
+			Pe(n, t.formatToolResults(i));
 		} else e.length > 0 && n.push({
 			role: "assistant",
 			content: r.content
@@ -2904,28 +3072,22 @@ function Oe(e, t) {
 	}
 	return n;
 }
-function ke(e, t) {
+function $(e, t) {
 	if (!(e?.type !== "tool_use" || !t)) try {
 		e.input = JSON.parse(t);
 	} catch {
-		e.input = {};
+		e.input = {}, e.inputParseError = !0;
 	}
 }
-function Ae(e, t) {
+function Ie(e, t) {
 	let n = e.contentBlocks[e.contentBlocks.length - 1];
 	n && n.type === "text" ? n.text = (n.text || "") + t : e.contentBlocks.push({
 		type: "text",
 		text: t
 	});
 }
-function je(e, t) {
-	if (e.currentBlockIsToolUse && e.currentToolInputJson) {
-		let t = e.contentBlocks[e.contentBlocks.length - 1];
-		if (t?.type === "tool_use") try {
-			t.input = JSON.parse(e.currentToolInputJson);
-		} catch {}
-	}
-	e.contentBlocks.push({
+function Le(e, t) {
+	e.currentBlockIsToolUse && e.currentToolInputJson && $(e.contentBlocks[e.contentBlocks.length - 1], e.currentToolInputJson), e.contentBlocks.push({
 		type: "tool_use",
 		id: t.id,
 		name: t.name,
@@ -2933,16 +3095,16 @@ function je(e, t) {
 		...t.metadata ? { metadata: t.metadata } : {}
 	}), e.currentToolInputJson = "", e.currentBlockIsToolUse = !0;
 }
-function Me(e, t) {
+function Re(e, t) {
 	if (t.id && t.input) {
 		let n = e.contentBlocks.find((e) => e.type === "tool_use" && e.id === t.id);
-		n && (n.input = t.input);
+		n && (n.input = t.input, t.parseError && (n.inputParseError = !0));
 	} else if (e.currentBlockIsToolUse) {
 		let t = e.contentBlocks[e.contentBlocks.length - 1];
-		t?.type === "tool_use" && e.currentToolInputJson && (ke(t, e.currentToolInputJson), e.currentToolInputJson = ""), e.currentBlockIsToolUse = !1;
+		t?.type === "tool_use" && e.currentToolInputJson && ($(t, e.currentToolInputJson), e.currentToolInputJson = ""), e.currentBlockIsToolUse = !1;
 	}
 }
-async function* Ne(e, t) {
+async function* ze(e, t) {
 	let n = {
 		contentBlocks: [],
 		currentToolInputJson: "",
@@ -2953,13 +3115,13 @@ async function* Ne(e, t) {
 		let e = r;
 		switch (e.type) {
 			case "text_delta":
-				Ae(n, e.text), yield {
+				Ie(n, e.text), yield {
 					type: "text_delta",
 					data: e.text
 				};
 				break;
 			case "tool_use_start":
-				je(n, e), yield {
+				Le(n, e), yield {
 					type: "tool_use_start",
 					data: {
 						id: e.id,
@@ -2972,7 +3134,7 @@ async function* Ne(e, t) {
 				n.currentToolInputJson += e.json;
 				break;
 			case "tool_use_end":
-				Me(n, e);
+				Re(n, e);
 				break;
 			case "message_meta": e.inputTokens != null && (n.inputTokens = e.inputTokens), e.outputTokens != null && (n.outputTokens = e.outputTokens), e.stopReason && (n.stopReason = e.stopReason);
 		}
@@ -2984,8 +3146,33 @@ async function* Ne(e, t) {
 		outputTokens: n.outputTokens
 	};
 }
-async function* Pe(e, t) {
-	let { executor: n, observability: r, traceId: i, turn: a } = t, o = e.name, s = e.input || {}, c = e.id, l = n.get(o);
+async function* Be(e, t) {
+	let { executor: n, observability: r, traceId: i, turn: a } = t, o = e.name, s = e.input || {}, c = e.id;
+	if (e.inputParseError) {
+		let e = `Could not parse the arguments you sent for ${o} — they were not valid JSON, so the tool was not run. Call it again with well-formed JSON arguments.`;
+		return yield {
+			type: "tool_use_result",
+			data: {
+				id: c,
+				name: o,
+				result: e,
+				isError: !0
+			}
+		}, Q(() => r?.onToolEnd?.({
+			traceId: i,
+			turn: a,
+			toolName: o,
+			toolUseId: c,
+			isError: !0,
+			durationMs: 0
+		})), {
+			toolUseId: c,
+			toolName: o,
+			content: e,
+			isError: !0
+		};
+	}
+	let l = n.get(o);
 	if (!l) return yield {
 		type: "tool_use_result",
 		data: {
@@ -3008,10 +3195,11 @@ async function* Pe(e, t) {
 			data: {
 				id: c,
 				name: o,
+				input: s,
 				result: e.result,
 				...e.isError ? { isError: !0 } : {}
 			}
-		}, $(() => r?.onToolEnd?.({
+		}, Q(() => r?.onToolEnd?.({
 			traceId: i,
 			turn: a,
 			toolName: o,
@@ -3034,7 +3222,7 @@ async function* Pe(e, t) {
 				result: t,
 				isError: !0
 			}
-		}, $(() => r?.onToolEnd?.({
+		}, Q(() => r?.onToolEnd?.({
 			traceId: i,
 			turn: a,
 			toolName: o,
@@ -3049,48 +3237,48 @@ async function* Pe(e, t) {
 		};
 	}
 }
-async function* Fe(e, t) {
+async function* Ve(e, t) {
 	let n = [];
 	for (let r of e) {
 		if (r.type !== "tool_use") continue;
-		let e = yield* Pe(r, t);
+		let e = yield* Be(r, t);
 		n.push(e);
 	}
 	return n;
 }
 //#endregion
 //#region src/server/agent/handler.ts
-var Ie = {
+var He = {
 	anthropic: "claude-sonnet-4-6",
 	openai: "gpt-4.1-mini",
 	google: "gemini-3-flash-preview"
 };
-async function* Le(t) {
-	let { message: n, history: r, semanticLayer: i, securityContext: a, agentConfig: o, apiKey: s } = t, c = t.sessionId || crypto.randomUUID(), l = o.observability, u = crypto.randomUUID(), d = Date.now(), f = t.providerOverride || o.provider || "anthropic", p = t.modelOverride || o.model || Ie[f] || "claude-sonnet-4-6", m = t.baseURLOverride || o.baseURL, h = o.maxTurns || 25, g = o.maxTokens || 4096, _;
+async function* Ue(e) {
+	let { message: t, history: n, semanticLayer: r, securityContext: i, agentConfig: o, apiKey: s } = e, c = e.sessionId || crypto.randomUUID(), l = o.observability, u = crypto.randomUUID(), d = Date.now(), f = e.providerOverride || o.provider || "anthropic", p = e.modelOverride || o.model || He[f] || "claude-sonnet-4-6", m = e.baseURLOverride || o.baseURL, h = o.maxTurns || 25, g = o.maxTokens || 8192, _;
 	try {
-		_ = await Ee(f, s, { baseURL: m });
-	} catch (t) {
-		console.error("[agent] Failed to create %s provider: %s", String(f).replace(/\n|\r/g, ""), String(t instanceof Error ? t.message : t).replace(/\n|\r/g, "")), yield {
+		_ = await Ne(f, s, { baseURL: m });
+	} catch (e) {
+		console.error("[agent] Failed to create %s provider: %s", String(f).replace(/\n|\r/g, ""), String(e instanceof Error ? e.message : e).replace(/\n|\r/g, "")), yield {
 			type: "error",
-			data: { message: t instanceof Error ? t.message : e("server.errors.llmInitFailed") }
+			data: { message: e instanceof Error ? e.message : a("server.errors.llmInitFailed") }
 		};
 		return;
 	}
-	let v = we(), y = Te({
-		semanticLayer: i,
-		securityContext: a
-	}), b = ie(i.getMetadata(a));
-	t.systemContext && (b += `\n\n## User Context\n\n${t.systemContext}`), $(() => l?.onChatStart?.({
+	let v = je(), y = Me({
+		semanticLayer: r,
+		securityContext: i
+	}), b = oe(r.getMetadata(i));
+	e.systemContext && (b += `\n\n## User Context\n\n${e.systemContext}`), Q(() => l?.onChatStart?.({
 		traceId: u,
 		sessionId: c,
-		message: n,
+		message: t,
 		model: p,
-		historyLength: r?.length ?? 0
+		historyLength: n?.length ?? 0
 	}));
-	let x = Oe(r, _);
+	let x = Fe(n, _);
 	x.push({
 		role: "user",
-		content: n
+		content: t
 	});
 	let S = 0;
 	try {
@@ -3102,22 +3290,29 @@ async function* Le(t) {
 				system: b,
 				tools: v,
 				messages: x
-			}), n = Date.now(), { contentBlocks: r, stopReason: i, inputTokens: a, outputTokens: o } = yield* Ne(_, t);
-			if ($(() => l?.onGenerationEnd?.({
+			}), n = Date.now(), { contentBlocks: r, stopReason: i, inputTokens: o, outputTokens: s } = yield* ze(_, t);
+			if (Q(() => l?.onGenerationEnd?.({
 				traceId: u,
 				turn: e,
 				model: p,
 				stopReason: i,
-				inputTokens: a,
-				outputTokens: o,
+				inputTokens: o,
+				outputTokens: s,
 				durationMs: Date.now() - n,
 				input: x,
 				output: r
 			})), x.push({
 				role: "assistant",
 				content: r
-			}), !_.shouldContinue(i)) break;
-			let s = yield* Fe(r, {
+			}), _.isTruncated(i)) {
+				yield {
+					type: "error",
+					data: { message: a("server.errors.agentResponseTruncated") }
+				};
+				break;
+			}
+			if (!_.shouldContinue(i)) break;
+			let c = yield* Ve(r, {
 				executor: y,
 				observability: l,
 				traceId: u,
@@ -3126,9 +3321,9 @@ async function* Le(t) {
 			yield {
 				type: "turn_complete",
 				data: {}
-			}, De(x, _.formatToolResults(s));
+			}, Pe(x, _.formatToolResults(c));
 		}
-		$(() => l?.onChatEnd?.({
+		Q(() => l?.onChatEnd?.({
 			traceId: u,
 			sessionId: c,
 			totalTurns: S,
@@ -3157,4 +3352,4 @@ async function* Le(t) {
 	}
 }
 //#endregion
-export { O as C, w as D, T as E, oe as O, k as S, E as T, P as _, G as a, j as b, H as c, se as d, z as f, F as g, I as h, Le as handleAgentChat, K as i, ae as k, V as l, L as m, J as n, W as o, R as p, q as r, U as s, ce as t, B as u, N as v, D as w, A as x, M as y };
+export { k as C, se as D, E, T as O, A as S, D as T, F as _, q as a, M as b, W as c, V as d, B as f, I as g, L as h, Ue as handleAgentChat, ce as i, w as k, U as l, R as m, ue as n, K as o, z as p, le as r, G as s, de as t, H as u, P as v, O as w, j as x, N as y };