robotrock 1.4.0 → 1.5.0

package/dist/{index-Drj0Rzf_.d.ts → index-amkHKVGs.d.ts}

@@ -151,17 +151,17 @@ type FormatToolQueryResultOptions = {
     rowsPath?: string;
     ui?: ToolResultUiMeta;
 };
-type WithReplyGuidance<T> = T & {
+type WithReplyGuidance$1<T> = T & {
     replyGuidance: string;
 };
-type WithUiMeta<T> = T & {
+type WithUiMeta$1<T> = T & {
     ui: ToolResultUiMeta;
 };
-type WithUiHintField<T> = T & {
+type WithUiHintField$1<T> = T & {
     uiHint: ToolUiHint;
 };
 /** Attach agent narration hints to plain tool JSON. No display/ui envelope. */
-declare function formatToolObjectResult<T extends Record<string, unknown>>(data: T, options: FormatToolObjectResultOptions): WithReplyGuidance<T> & Partial<WithUiMeta<T>> & Partial<WithUiHintField<T>>;
+declare function formatToolObjectResult<T extends Record<string, unknown>>(data: T, options: FormatToolObjectResultOptions): WithReplyGuidance$1<T> & Partial<WithUiMeta$1<T>> & Partial<WithUiHintField$1<T>>;
 /** Wrap an array field as plain tool JSON with reply guidance and list layout hint.
  *
  * Include `url` on each item when you know a navigable link — the dashboard
@@ -169,14 +169,113 @@ declare function formatToolObjectResult<T extends Record<string, unknown>>(data:
  * for file downloads (Attachment layout). Set `entity` so the dashboard caches
  * a reusable row layout under that name.
  */
-declare function formatToolListResult<const K extends string, T extends Record<string, unknown>>(listKey: K, items: T[], options: FormatToolListResultOptions): WithReplyGuidance<Record<K, T[]>> & WithUiMeta<Record<K, T[]>> & WithUiHintField<Record<K, T[]>>;
+declare function formatToolListResult<const K extends string, T extends Record<string, unknown>>(listKey: K, items: T[], options: FormatToolListResultOptions): WithReplyGuidance$1<Record<K, T[]>> & WithUiMeta$1<Record<K, T[]>> & WithUiHintField$1<Record<K, T[]>>;
 /** Format a query-style result: shared meta fields + typed row array. */
-declare function formatToolQueryResult<M extends Record<string, unknown>, T extends Record<string, unknown>>(meta: M, rows: T[], options: FormatToolQueryResultOptions): WithReplyGuidance<M & Record<string, T[]>> & WithUiMeta<M & Record<string, T[]>>;
+declare function formatToolQueryResult<M extends Record<string, unknown>, T extends Record<string, unknown>>(meta: M, rows: T[], options: FormatToolQueryResultOptions): WithReplyGuidance$1<M & Record<string, T[]>> & WithUiMeta$1<M & Record<string, T[]>>;
 declare function isAgentAdminErrorResult(result: unknown): result is {
     ok: false;
     message: string;
 };
 
+/** Matches TRL `<Chart type="…">` / shadcn chart variants. */
+type ToolChartType = "line" | "bar" | "area";
+/**
+ * Wide-format chart payload for dashboard TRL Chart.
+ *
+ * Each `series` row is one x-axis point. Numeric series are **columns**
+ * (not a long-format dimension column):
+ *
+ * ```ts
+ * {
+ *   type: "line",
+ *   xKey: "date",
+ *   yKeys: ["NL", "BE"],
+ *   series: [
+ *     { date: "2025-07-21", NL: 100, BE: 40 },
+ *     { date: "2025-07-22", NL: 120, BE: 50 },
+ *   ],
+ * }
+ * ```
+ *
+ * Do **not** return long-format rows like
+ * `{ date, country: "NL", visitors: 100 }` — use
+ * {@link pivotLongFormatToWideChartSeries} first, or
+ * {@link formatToolChartResultFromLong}.
+ */
+type ToolChartResultData = {
+    title?: string;
+    description?: string;
+    type: ToolChartType;
+    xKey: string;
+    yKeys: string[];
+    series: Array<Record<string, string | number>>;
+};
+type FormatToolChartResultOptions = {
+    replyGuidance: string;
+    /** Defaults to `metric_point`. */
+    entity?: ToolResultUiEntity;
+    /** Defaults to `true` so the chart card always presents. */
+    present?: boolean;
+    ui?: Omit<ToolResultUiMeta, "rowsPath" | "layout">;
+};
+type PivotLongFormatToWideChartSeriesArgs = {
+    rows: ReadonlyArray<Record<string, unknown>>;
+    xKey: string;
+    /** Dimension column to spread into series columns (e.g. `country`). */
+    seriesKey: string;
+    /** Numeric metric column (e.g. `visitors`). */
+    valueKey: string;
+    /** Cap number of series columns (default 20). */
+    maxSeries?: number;
+};
+type WithReplyGuidance<T> = T & {
+    replyGuidance: string;
+};
+type WithUiMeta<T> = T & {
+    ui: ToolResultUiMeta;
+};
+type WithUiHintField<T> = T & {
+    uiHint: ToolUiHint;
+};
+declare function inferToolChartType(xKey: string): ToolChartType;
+/**
+ * Pivot long-format rows into wide chart series columns.
+ *
+ * Input:  `{ date: "d1", country: "NL", visitors: 100 }`
+ * Output: `{ yKeys: ["NL","BE"], series: [{ date: "d1", NL: 100, BE: 40 }] }`
+ */
+declare function pivotLongFormatToWideChartSeries(args: PivotLongFormatToWideChartSeriesArgs): {
+    yKeys: string[];
+    series: Array<Record<string, string | number>>;
+};
+/**
+ * Format a tool result for dashboard Chart rendering (shadcn / TRL `<Chart>`).
+ *
+ * Requires **wide** series rows. Sets `ui.layout: "chart"`, `rowsPath: "series"`,
+ * and top-level `type` / `xKey` / `yKeys` so the UI does not guess series columns.
+ */
+declare function formatToolChartResult(chart: {
+    title?: string;
+    description?: string;
+    type?: ToolChartType;
+    xKey: string;
+    yKeys: readonly string[];
+    series: ReadonlyArray<Record<string, string | number>>;
+}, options: FormatToolChartResultOptions): WithReplyGuidance<ToolChartResultData> & WithUiMeta<ToolChartResultData> & WithUiHintField<ToolChartResultData>;
+/**
+ * Convenience: pivot long-format rows, then {@link formatToolChartResult}.
+ */
+declare function formatToolChartResultFromLong(input: {
+    title?: string;
+    description?: string;
+    type?: ToolChartType;
+    xKey: string;
+    seriesKey: string;
+    valueKey: string;
+    rows: ReadonlyArray<Record<string, unknown>>;
+    maxSeries?: number;
+}, options: FormatToolChartResultOptions): WithReplyGuidance<ToolChartResultData> & WithUiMeta<ToolChartResultData> & WithUiHintField<ToolChartResultData>;
+
 /** Tenant-relative inbox deep link for a task (matches dashboard inbox hrefs). */
 declare function buildTenantTaskUrl(tenantSlug: string, task: {
     id: string;
@@ -204,12 +303,57 @@ declare const productEntityRowSchema: z.ZodObject<{
     inStock: z.ZodBoolean;
     url: z.ZodString;
 }, z.core.$strip>;
-/** Demo chart series point (`generate_random_chart`). */
+/**
+ * One wide-format chart point for TRL/shadcn Chart.
+ * Include the x-axis field (`date` / `category` / `label`) plus one numeric
+ * field per series key listed in `yKeys` (e.g. `{ date, NL: 100, BE: 40 }`).
+ * Never use long-format rows like `{ date, country: "NL", visitors: 100 }`.
+ */
 declare const metricPointEntityRowSchema: z.ZodObject<{
     date: z.ZodOptional<z.ZodString>;
     category: z.ZodOptional<z.ZodString>;
     label: z.ZodOptional<z.ZodString>;
 }, z.core.$catchall<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+/**
+ * Canonical chart tool `outputSchema` — matches dashboard TRL `<Chart>`.
+ *
+ * Attach on chart tools: `outputSchema: toolChartResultSchema`.
+ * Build values with `formatToolChartResult` / `formatToolChartResultFromLong`.
+ *
+ * Multi-series = multiple numeric columns on the same row, not a dimension column.
+ */
+declare const toolChartResultSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    type: z.ZodEnum<{
+        line: "line";
+        bar: "bar";
+        area: "area";
+    }>;
+    xKey: z.ZodString;
+    yKeys: z.ZodArray<z.ZodString>;
+    series: z.ZodArray<z.ZodObject<{
+        date: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$catchall<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>>;
+    replyGuidance: z.ZodOptional<z.ZodString>;
+    ui: z.ZodOptional<z.ZodObject<{
+        present: z.ZodOptional<z.ZodBoolean>;
+        entity: z.ZodOptional<z.ZodString>;
+        rowsPath: z.ZodOptional<z.ZodString>;
+        layout: z.ZodOptional<z.ZodEnum<{
+            list: "list";
+            chart: "chart";
+            table: "table";
+        }>>;
+    }, z.core.$strict>>;
+    uiHint: z.ZodOptional<z.ZodEnum<{
+        list: "list";
+        chart: "chart";
+        table: "table";
+    }>>;
+}, z.core.$strip>;
 declare const memberEntityRowSchema: z.ZodObject<{
     name: z.ZodString;
     email: z.ZodString;
@@ -306,11 +450,14 @@ declare const searchProductsOutputSchema: z.ZodObject<{
     }>>;
 }, z.core.$strip>;
 declare const generateRandomChartOutputSchema: z.ZodObject<{
-    title: z.ZodString;
-    axis: z.ZodEnum<{
-        time: "time";
-        category: "category";
+    description: z.ZodOptional<z.ZodString>;
+    type: z.ZodEnum<{
+        line: "line";
+        bar: "bar";
+        area: "area";
     }>;
+    xKey: z.ZodString;
+    yKeys: z.ZodArray<z.ZodString>;
     series: z.ZodArray<z.ZodObject<{
         date: z.ZodOptional<z.ZodString>;
         category: z.ZodOptional<z.ZodString>;
@@ -332,6 +479,7 @@ declare const generateRandomChartOutputSchema: z.ZodObject<{
         chart: "chart";
         table: "table";
     }>>;
+    title: z.ZodString;
 }, z.core.$strip>;
 /** Demo generated image (`generate_image`) — bytes live in Convex `_storage`. */
 declare const generateImageOutputSchema: z.ZodObject<{
@@ -851,6 +999,7 @@ declare const getWorkspaceUsageOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
 }, z.core.$strip>]>;
 type ProductEntityRow = z.infer<typeof productEntityRowSchema>;
 type MetricPointEntityRow = z.infer<typeof metricPointEntityRowSchema>;
+type ToolChartResult = z.infer<typeof toolChartResultSchema>;
 type MemberEntityRow = z.infer<typeof memberEntityRowSchema>;
 type TaskEntityRow = z.infer<typeof taskEntityRowSchema>;
 type GroupEntityRow = z.infer<typeof groupEntityRowSchema>;
@@ -902,4 +1051,4 @@ declare function buildTaskHandledResumeMessage(payload: RobotRockWebhookPayload)
 /** Hook slug advertised in GET /eve/v1/info for RobotRock-ready auto-detection. */
 declare const ROBOTROCK_READY_HOOK_SLUG = "robotrock-ready";
 
-export { isAgentAdminErrorResult as $, agentAdminErrorResultSchema as A, agentAdminMutationResultSchema as B, type ChatToolAuditInput as C, DEFAULT_TOOL_DISPLAY_LABELS as D, EVE_INPUT_OTHER_CHOICE_ID as E, type FormatToolListResultOptions as F, type GroupEntityRow as G, assignTasksOutputSchema as H, buildChatToolAuditPayload as I, buildEveInputAuditSubmissionData as J, buildTenantGroupUrl as K, buildTenantTaskUrl as L, type MemberEntityRow as M, eveInputResponseToActionSubmission as N, formatToolListResult as O, type ProductEntityRow as P, formatToolObjectResult as Q, ROBOTROCK_READY_HOOK_SLUG as R, type StatusEntityRow as S, type TaskEntityRow as T, formatToolQueryResult as U, type VerifyRobotRockWebhookOptions as V, generateImageOutputSchema as W, generateRandomChartOutputSchema as X, getWorkspaceUsageOutputSchema as Y, groupDetailEntitySchema as Z, groupEntityRowSchema as _, EVE_INPUT_OTHER_CHOICE_LABEL as a, isEveApprovalInputRequest as a0, manageGroupsDetailOutputSchema as a1, manageGroupsListOutputSchema as a2, manageGroupsOutputSchema as a3, manageGroupsSummaryOutputSchema as a4, manageTeamMembersDetailOutputSchema as a5, manageTeamMembersListOutputSchema as a6, manageTeamMembersOutputSchema as a7, memberEntityRowSchema as a8, metricPointEntityRowSchema as a9, parseEveAskQuestionToolOutput as aa, productEntityRowSchema as ab, queryTasksDetailOutputSchema as ac, queryTasksListOutputSchema as ad, queryTasksOutputSchema as ae, resolveEveFreeformTextToInputResponse as af, sanitizeToolAuditInput as ag, searchProductsOutputSchema as ah, shouldAuditToolExecution as ai, statusEntityRowSchema as aj, taskEntityRowSchema as ak, toolDisplayResult as al, toolResultUiMetaSchema as am, workspaceUsageEntitySchema as an, EVE_INPUT_SUBMIT_ACTION_ID as b, type EveInputOption as c, type EveInputRequest as d, type EveInputRequestDisplay as e, type EveInputResponse as f, RobotRockWebhookError as g, type RobotRockWebhookErrorCode as h, type RobotRockWebhookPayload as i, buildTaskHandledResumeMessage as j, eveInputRequestTaskType as k, eveInputRequestToActions as l, formatEveApprovalTitle as m, getToolDisplayLabel as n, normalizeEveSelectFormData as o, type ChatToolAuditPayload as p, type EveInputActionSubmission as q, resolveEveInputDisplay as r, setToolDisplayLabelOverrides as s, taskHandledToEveInputResponse as t, type EveInputAuditContext as u, verifyRobotRockWebhook as v, type FormatToolObjectResultOptions as w, type FormatToolQueryResultOptions as x, type MetricPointEntityRow as y, type ToolDisplayResultOptions as z };
+export { formatToolObjectResult as $, type ProductEntityRow as A, type ToolChartResult as B, type ChatToolAuditInput as C, DEFAULT_TOOL_DISPLAY_LABELS as D, EVE_INPUT_OTHER_CHOICE_ID as E, type FormatToolChartResultOptions as F, type GroupEntityRow as G, type ToolChartResultData as H, type ToolChartType as I, type ToolDisplayResultOptions as J, agentAdminErrorResultSchema as K, agentAdminMutationResultSchema as L, type MemberEntityRow as M, assignTasksOutputSchema as N, buildChatToolAuditPayload as O, type PivotLongFormatToWideChartSeriesArgs as P, buildEveInputAuditSubmissionData as Q, ROBOTROCK_READY_HOOK_SLUG as R, type StatusEntityRow as S, type TaskEntityRow as T, buildTenantGroupUrl as U, type VerifyRobotRockWebhookOptions as V, buildTenantTaskUrl as W, eveInputResponseToActionSubmission as X, formatToolChartResult as Y, formatToolChartResultFromLong as Z, formatToolListResult as _, EVE_INPUT_OTHER_CHOICE_LABEL as a, formatToolQueryResult as a0, generateImageOutputSchema as a1, generateRandomChartOutputSchema as a2, getWorkspaceUsageOutputSchema as a3, groupDetailEntitySchema as a4, groupEntityRowSchema as a5, inferToolChartType as a6, isAgentAdminErrorResult as a7, isEveApprovalInputRequest as a8, manageGroupsDetailOutputSchema as a9, manageGroupsListOutputSchema as aa, manageGroupsOutputSchema as ab, manageGroupsSummaryOutputSchema as ac, manageTeamMembersDetailOutputSchema as ad, manageTeamMembersListOutputSchema as ae, manageTeamMembersOutputSchema as af, memberEntityRowSchema as ag, metricPointEntityRowSchema as ah, parseEveAskQuestionToolOutput as ai, pivotLongFormatToWideChartSeries as aj, productEntityRowSchema as ak, queryTasksDetailOutputSchema as al, queryTasksListOutputSchema as am, queryTasksOutputSchema as an, resolveEveFreeformTextToInputResponse as ao, sanitizeToolAuditInput as ap, searchProductsOutputSchema as aq, shouldAuditToolExecution as ar, statusEntityRowSchema as as, taskEntityRowSchema as at, toolChartResultSchema as au, toolDisplayResult as av, toolResultUiMetaSchema as aw, workspaceUsageEntitySchema as ax, EVE_INPUT_SUBMIT_ACTION_ID as b, type EveInputOption as c, type EveInputRequest as d, type EveInputRequestDisplay as e, type EveInputResponse as f, RobotRockWebhookError as g, type RobotRockWebhookErrorCode as h, type RobotRockWebhookPayload as i, buildTaskHandledResumeMessage as j, eveInputRequestTaskType as k, eveInputRequestToActions as l, formatEveApprovalTitle as m, getToolDisplayLabel as n, normalizeEveSelectFormData as o, type ChatToolAuditPayload as p, type EveInputActionSubmission as q, resolveEveInputDisplay as r, setToolDisplayLabelOverrides as s, taskHandledToEveInputResponse as t, type EveInputAuditContext as u, verifyRobotRockWebhook as v, type FormatToolListResultOptions as w, type FormatToolObjectResultOptions as x, type FormatToolQueryResultOptions as y, type MetricPointEntityRow as z };

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { C as ChatsApi, c as CloseChatOptions, d as CreateChatInput, e as Create
 export { AgentChatSeedMessage, CreateAgentChatBody, CreateAgentChatBodyInput, agentChatSeedMessageSchema, createAgentChatBodySchema } from '@robotrock/core';
 import { Task, DiscriminatedApprovalResult } from './schemas/index.js';
 export { AgentTelemetry, AgentTelemetryInput, ApprovalResult, AssignToInput, CreateTaskBody, CreateTaskBodyInput, DEFAULT_TASK_PRIORITY, DEFAULT_THREAD_UPDATE_STATUS, Handler, InferActionData, LOWEST_TASK_PRIORITY, TASK_CONTEXT_FORMAT_VERSION, TASK_PRIORITY_RANK, TaskAction, TaskContext, TaskContextFormatVersion, TaskContextInput, TaskPriority, TaskResponse, TaskResult, TaskStatus, ThreadUpdate, ThreadUpdateBody, ThreadUpdateBodyInput, ThreadUpdateInput, ThreadUpdateResponse, ThreadUpdateSource, ThreadUpdateStatus, TriggerHandler, TupleElementIndices, WebhookHandler, agentTelemetrySchema, assignToSchema, createTaskBodySchema, taskContextSchema, taskPriorities, taskPrioritySchema, threadUpdateBodySchema, threadUpdateInputSchema, threadUpdateStatusSchema, threadUpdateStatuses } from './schemas/index.js';
-export { D as DEFAULT_TOOL_DISPLAY_LABELS, E as EVE_INPUT_OTHER_CHOICE_ID, a as EVE_INPUT_OTHER_CHOICE_LABEL, b as EVE_INPUT_SUBMIT_ACTION_ID, c as EveInputOption, d as EveInputRequest, e as EveInputRequestDisplay, f as EveInputResponse, R as ROBOTROCK_READY_HOOK_SLUG, g as RobotRockWebhookError, h as RobotRockWebhookErrorCode, i as RobotRockWebhookPayload, V as VerifyRobotRockWebhookOptions, j as buildTaskHandledResumeMessage, k as eveInputRequestTaskType, l as eveInputRequestToActions, m as formatEveApprovalTitle, n as getToolDisplayLabel, o as normalizeEveSelectFormData, r as resolveEveInputDisplay, s as setToolDisplayLabelOverrides, t as taskHandledToEveInputResponse, v as verifyRobotRockWebhook } from './index-Drj0Rzf_.js';
+export { D as DEFAULT_TOOL_DISPLAY_LABELS, E as EVE_INPUT_OTHER_CHOICE_ID, a as EVE_INPUT_OTHER_CHOICE_LABEL, b as EVE_INPUT_SUBMIT_ACTION_ID, c as EveInputOption, d as EveInputRequest, e as EveInputRequestDisplay, f as EveInputResponse, R as ROBOTROCK_READY_HOOK_SLUG, g as RobotRockWebhookError, h as RobotRockWebhookErrorCode, i as RobotRockWebhookPayload, V as VerifyRobotRockWebhookOptions, j as buildTaskHandledResumeMessage, k as eveInputRequestTaskType, l as eveInputRequestToActions, m as formatEveApprovalTitle, n as getToolDisplayLabel, o as normalizeEveSelectFormData, r as resolveEveInputDisplay, s as setToolDisplayLabelOverrides, t as taskHandledToEveInputResponse, v as verifyRobotRockWebhook } from './index-amkHKVGs.js';
 export { E as EndRobotRockHumanWaitSpanOptions, b as RobotRockCreatedTask, c as RobotRockHandledOtelInput, a as RobotRockHandlerWebhookPayload, d as RobotRockHumanWaitOtelSession, e as RobotRockOtelHandle, f as RobotRockOtelRecordOptions, R as RobotRockPlatformOtelFields, g as beginRobotRockHumanWaitOtel, h as captureRobotRockOtelHandle, i as endRobotRockHumanWaitSpan, j as finishRobotRockHumanWaitOtel, r as recordRobotRockHandledToOtel, s as shouldRecordRobotRockOtel, k as startRobotRockHumanWaitSpan, l as stripPlatformOtelFields, t as toRobotRockHandledOtelInput } from './otel-platform-DzHyHkGk.js';
 import 'zod';
 import './chat-correlation-BsHD-tOQ.js';

package/dist/index.js

@@ -1978,10 +1978,24 @@ var productEntityRowSchema = z6.object({
   url: z6.string().min(1)
 });
 var metricPointEntityRowSchema = z6.object({
-  date: z6.string().optional(),
-  category: z6.string().optional(),
-  label: z6.string().optional()
-}).catchall(z6.union([z6.string(), z6.number()]));
+  date: z6.string().optional().describe("X-axis value when xKey is date/time"),
+  category: z6.string().optional().describe("X-axis value when xKey is category"),
+  label: z6.string().optional().describe("X-axis value when xKey is label")
+}).catchall(z6.union([z6.string(), z6.number()])).describe(
+  "Wide chart point: x-axis field + numeric columns named by yKeys (one series per column)"
+);
+var toolChartResultSchema = withAgentOnlyFields({
+  title: z6.string().min(1).optional().describe("Chart title shown above the plot"),
+  description: z6.string().min(1).optional().describe("Optional short subtitle"),
+  type: z6.enum(["line", "bar", "area"]).describe("TRL/shadcn chart variant (time series \u2192 line, categories \u2192 bar)"),
+  xKey: z6.string().min(1).describe('Field on each series row for the x-axis, e.g. "date" or "category"'),
+  yKeys: z6.array(z6.string().min(1)).min(1).describe(
+    'Numeric series column names on each row, e.g. ["NL","BE"] or ["created","handled"]'
+  ),
+  series: z6.array(metricPointEntityRowSchema).describe(
+    "Wide-format points only \u2014 one object per x value with yKeys as numeric fields"
+  )
+});
 var memberEntityRowSchema = z6.object({
   name: z6.string(),
   email: z6.string(),
@@ -2040,10 +2054,8 @@ var agentAdminMutationResultSchema = z6.object({
 var searchProductsOutputSchema = withAgentOnlyFields({
   items: z6.array(productEntityRowSchema)
 });
-var generateRandomChartOutputSchema = withAgentOnlyFields({
-  title: z6.string().min(1),
-  axis: z6.enum(["time", "category"]),
-  series: z6.array(metricPointEntityRowSchema)
+var generateRandomChartOutputSchema = toolChartResultSchema.extend({
+  title: z6.string().min(1)
 });
 var generateImageOutputSchema = withAgentOnlyFields({
   prompt: z6.string().min(1),