robotrock 1.3.4 → 1.5.0

package/dist/index-amkHKVGs.d.ts

@@ -0,0 +1,1054 @@
+import { S as SendToHumanActionInput } from './client-BxbxttFH.js';
+import { UiSchema } from '@robotrock/core/schemas';
+import { b as ToolResultUiEntity, T as ToolResultUiMeta, a as ToolUiHint } from './tool-result-ui-meta-KT0VafEO.js';
+import { z } from 'zod';
+import './tool-reply-guidance-CJko9liH.js';
+
+/** One selectable option in an Eve HITL input request. */
+type EveInputOption = {
+    readonly id: string;
+    readonly label: string;
+    readonly description?: string;
+    readonly style?: "danger" | "default" | "primary";
+};
+/** Eve HITL display mode — mirrors `InputRequest.display` from the eve runtime. */
+type EveInputRequestDisplay = "confirmation" | "select" | "text";
+/**
+ * Minimal Eve `InputRequest` shape for RobotRock bridging. Intentionally
+ * self-contained so the SDK does not depend on the `eve` package.
+ */
+type EveInputRequest = {
+    readonly requestId: string;
+    readonly prompt: string;
+    readonly display?: EveInputRequestDisplay;
+    readonly allowFreeform?: boolean;
+    readonly options?: readonly EveInputOption[];
+};
+/** Eve `InputResponse` shape returned when resuming a parked session. */
+type EveInputResponse = {
+    readonly requestId: string;
+    readonly optionId?: string;
+    readonly text?: string;
+};
+declare const EVE_INPUT_SUBMIT_ACTION_ID: "submit";
+declare const EVE_INPUT_OTHER_CHOICE_ID: "__other__";
+declare const EVE_INPUT_OTHER_CHOICE_LABEL: "Type your own answer";
+/** Resolve the effective display mode when Eve omits `display`. */
+declare function resolveEveInputDisplay(request: EveInputRequest, toolName?: string): EveInputRequestDisplay;
+/** Keep select-form submissions mutually exclusive between preset choice and freeform other. */
+declare function normalizeEveSelectFormData(data: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Map an Eve `InputRequest` to RobotRock inbox actions.
+ */
+declare function eveInputRequestToActions(request: EveInputRequest, options?: {
+    toolName?: string;
+}): readonly SendToHumanActionInput[];
+/** Task type slug for an Eve input request. */
+declare function eveInputRequestTaskType(request: EveInputRequest, options?: {
+    toolName?: string;
+}): string;
+/**
+ * Map a handled RobotRock task action back to an Eve `InputResponse`.
+ */
+declare function taskHandledToEveInputResponse(request: EveInputRequest, actionId: string, actionData: unknown, options?: {
+    toolName?: string;
+}): EveInputResponse;
+
+type EveInputAuditContext = {
+    toolCallId: string;
+    toolName?: string;
+    requestId?: string;
+    display?: EveInputRequestDisplay;
+    toolInput?: unknown;
+};
+/**
+ * Map freeform composer text to an Eve `InputResponse`, mirroring Eve's
+ * `resolveTextToResponse` rules (option id/label, numeric index, freeform text).
+ */
+declare function resolveEveFreeformTextToInputResponse(request: EveInputRequest, text: string): EveInputResponse | undefined;
+/** Returns true for Eve's default approval gate (approve / deny options). */
+declare function isEveApprovalInputRequest(request: EveInputRequest): boolean;
+type EveInputActionSubmission = {
+    actionId: string;
+    actionTitle: string;
+    formData: Record<string, unknown>;
+};
+/**
+ * Map a resolved Eve `InputResponse` to RobotRock audit fields (action id/title).
+ */
+declare function eveInputResponseToActionSubmission(request: EveInputRequest, response: EveInputResponse, options?: {
+    toolName?: string;
+}): EveInputActionSubmission;
+/** Audit payload for `chat_action_input_submitted`. */
+declare function buildEveInputAuditSubmissionData(context: EveInputAuditContext, formData: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Parse an `ask_question` tool result output into an Eve input response shape.
+ */
+declare function parseEveAskQuestionToolOutput(output: unknown): Pick<EveInputResponse, "optionId" | "text"> | null;
+
+type ChatToolAuditInput = Record<string, unknown>;
+type ChatToolAuditPayload = {
+    toolCallId: string;
+    toolName: string;
+    input: ChatToolAuditInput;
+    success: boolean;
+    status: "completed" | "failed" | "rejected";
+    error?: string;
+};
+/**
+ * Whether a completed tool call should appear on the RobotRock audit trail.
+ * Admin mutations are logged via chat-correlated API audit instead.
+ */
+declare function shouldAuditToolExecution(toolName: string, _input: ChatToolAuditInput): boolean;
+/** Keep only fields useful for audit display (no secrets or large blobs). */
+declare function sanitizeToolAuditInput(input: ChatToolAuditInput): ChatToolAuditInput;
+declare function buildChatToolAuditPayload(input: {
+    toolCallId: string;
+    toolName: string;
+    toolInput: ChatToolAuditInput;
+    status: "completed" | "failed" | "rejected";
+    error?: string;
+    isError?: boolean;
+}): ChatToolAuditPayload | null;
+
+/** Default per-tool labels for common Eve demo/integration tools. */
+declare const DEFAULT_TOOL_DISPLAY_LABELS: Readonly<Record<string, string>>;
+/** Register additional or overriding tool display labels at runtime. */
+declare function setToolDisplayLabelOverrides(overrides: Readonly<Record<string, string>>): void;
+/** Resolve a user-facing label for a tool slug. */
+declare function getToolDisplayLabel(toolName: string): string;
+/** Format an Eve input request prompt for human-facing approval UIs. */
+declare function formatEveApprovalTitle(request: EveInputRequest, toolName?: string): string;
+
+type ToolDisplayResultOptions = {
+    widget?: string;
+    title?: string;
+    description?: string;
+    ui?: Record<string, UiSchema>;
+};
+/**
+ * @deprecated Tool results should return plain JSON. Display envelopes are ignored
+ * by the dashboard TRL renderer. Kept for backwards-compatible call sites.
+ */
+declare function toolDisplayResult<T extends Record<string, unknown>>(data: T, _options?: ToolDisplayResultOptions): T;
+
+type FormatToolObjectResultOptions = {
+    replyGuidance: string;
+    /** @deprecated Prefer `ui.layout`. Mapped for backward compatibility. */
+    uiHint?: ToolUiHint;
+    ui?: ToolResultUiMeta;
+};
+type FormatToolListResultOptions = {
+    replyGuidance: string;
+    entity?: ToolResultUiEntity;
+    present?: boolean;
+    ui?: Omit<ToolResultUiMeta, "rowsPath" | "layout">;
+};
+type FormatToolQueryResultOptions = {
+    replyGuidance: string;
+    entity?: ToolResultUiEntity;
+    present?: boolean;
+    rowsPath?: string;
+    ui?: ToolResultUiMeta;
+};
+type WithReplyGuidance$1<T> = T & {
+    replyGuidance: string;
+};
+type WithUiMeta$1<T> = T & {
+    ui: ToolResultUiMeta;
+};
+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$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
+ * renders clickable Item rows. Use `attachments` / `files` / `documents` keys
+ * 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$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$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;
+    type?: string | null;
+    app?: string | null;
+}): string;
+/** Tenant-relative group detail path (matches tenantGroup widget). */
+declare function buildTenantGroupUrl(tenantSlug: string, slug: string): string;
+declare const toolResultUiMetaSchema: 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>;
+/** Demo catalog product row (`search_products`). */
+declare const productEntityRowSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    price: z.ZodNumber;
+    currency: z.ZodString;
+    inStock: z.ZodBoolean;
+    url: z.ZodString;
+}, z.core.$strip>;
+/**
+ * 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;
+    role: z.ZodString;
+    membershipKind: z.ZodString;
+    profilePictureUrl: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+declare const taskEntityRowSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    status: z.ZodString;
+    type: z.ZodNullable<z.ZodString>;
+    description: z.ZodNullable<z.ZodString>;
+    validUntil: z.ZodNumber;
+    createdAt: z.ZodNumber;
+    url: z.ZodString;
+    threadPriority: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+declare const groupEntityRowSchema: z.ZodObject<{
+    name: z.ZodString;
+    slug: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    memberCount: z.ZodNullable<z.ZodNumber>;
+    url: z.ZodString;
+}, z.core.$strip>;
+declare const groupDetailEntitySchema: z.ZodObject<{
+    name: z.ZodString;
+    slug: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    url: z.ZodString;
+    members: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodString;
+        profilePictureUrl: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Assign-task / status list row — always includes task inbox url. */
+declare const statusEntityRowSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    status: z.ZodString;
+    url: z.ZodString;
+    type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+declare const agentAdminErrorResultSchema: z.ZodObject<{
+    ok: z.ZodLiteral<false>;
+    status: z.ZodOptional<z.ZodNumber>;
+    message: z.ZodString;
+    response: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+declare const agentAdminMutationResultSchema: z.ZodObject<{
+    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.$loose>;
+declare const searchProductsOutputSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        price: z.ZodNumber;
+        currency: z.ZodString;
+        inStock: z.ZodBoolean;
+        url: z.ZodString;
+    }, z.core.$strip>>;
+    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 generateRandomChartOutputSchema: z.ZodObject<{
+    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";
+    }>>;
+    title: z.ZodString;
+}, z.core.$strip>;
+/** Demo generated image (`generate_image`) — bytes live in Convex `_storage`. */
+declare const generateImageOutputSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    mediaType: z.ZodString;
+    model: z.ZodString;
+    storageId: z.ZodString;
+    url: z.ZodString;
+    base64: z.ZodOptional<z.ZodString>;
+    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 manageTeamMembersListOutputSchema: z.ZodObject<{
+    members: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodString;
+        role: z.ZodString;
+        membershipKind: z.ZodString;
+        profilePictureUrl: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    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 manageTeamMembersDetailOutputSchema: z.ZodObject<{
+    name: z.ZodString;
+    email: z.ZodString;
+    role: z.ZodString;
+    membershipKind: z.ZodString;
+    profilePictureUrl: z.ZodNullable<z.ZodString>;
+    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 manageTeamMembersOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
+    members: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodString;
+        role: z.ZodString;
+        membershipKind: z.ZodString;
+        profilePictureUrl: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    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>, z.ZodObject<{
+    name: z.ZodString;
+    email: z.ZodString;
+    role: z.ZodString;
+    membershipKind: z.ZodString;
+    profilePictureUrl: z.ZodNullable<z.ZodString>;
+    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>, z.ZodObject<{
+    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.$loose>, z.ZodObject<{
+    ok: z.ZodLiteral<false>;
+    status: z.ZodOptional<z.ZodNumber>;
+    message: z.ZodString;
+    response: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>]>;
+declare const manageGroupsListOutputSchema: z.ZodObject<{
+    groups: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        slug: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        memberCount: z.ZodNullable<z.ZodNumber>;
+        url: z.ZodString;
+    }, z.core.$strip>>;
+    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 manageGroupsDetailOutputSchema: z.ZodObject<{
+    name: z.ZodString;
+    slug: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    url: z.ZodString;
+    members: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodString;
+        profilePictureUrl: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    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 manageGroupsSummaryOutputSchema: z.ZodObject<{
+    name: z.ZodString;
+    slug: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    memberCount: z.ZodNullable<z.ZodNumber>;
+    url: z.ZodString;
+    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 manageGroupsOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
+    groups: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        slug: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        memberCount: z.ZodNullable<z.ZodNumber>;
+        url: z.ZodString;
+    }, z.core.$strip>>;
+    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>, z.ZodObject<{
+    name: z.ZodString;
+    slug: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    url: z.ZodString;
+    members: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodString;
+        profilePictureUrl: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    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>, z.ZodObject<{
+    name: z.ZodString;
+    slug: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    memberCount: z.ZodNullable<z.ZodNumber>;
+    url: z.ZodString;
+    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>, z.ZodObject<{
+    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.$loose>, z.ZodObject<{
+    ok: z.ZodLiteral<false>;
+    status: z.ZodOptional<z.ZodNumber>;
+    message: z.ZodString;
+    response: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>]>;
+declare const queryTasksListOutputSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        status: z.ZodString;
+        type: z.ZodNullable<z.ZodString>;
+        description: z.ZodNullable<z.ZodString>;
+        validUntil: z.ZodNumber;
+        createdAt: z.ZodNumber;
+        url: z.ZodString;
+        threadPriority: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    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 queryTasksDetailOutputSchema: z.ZodObject<{
+    id: z.ZodNullable<z.ZodString>;
+    status: z.ZodNullable<z.ZodString>;
+    type: z.ZodNullable<z.ZodString>;
+    name: z.ZodNullable<z.ZodString>;
+    description: z.ZodNullable<z.ZodString>;
+    validUntil: z.ZodNullable<z.ZodNumber>;
+    createdAt: z.ZodNullable<z.ZodNumber>;
+    url: z.ZodNullable<z.ZodString>;
+    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 queryTasksOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        status: z.ZodString;
+        type: z.ZodNullable<z.ZodString>;
+        description: z.ZodNullable<z.ZodString>;
+        validUntil: z.ZodNumber;
+        createdAt: z.ZodNumber;
+        url: z.ZodString;
+        threadPriority: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    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>, z.ZodObject<{
+    id: z.ZodNullable<z.ZodString>;
+    status: z.ZodNullable<z.ZodString>;
+    type: z.ZodNullable<z.ZodString>;
+    name: z.ZodNullable<z.ZodString>;
+    description: z.ZodNullable<z.ZodString>;
+    validUntil: z.ZodNullable<z.ZodNumber>;
+    createdAt: z.ZodNullable<z.ZodNumber>;
+    url: z.ZodNullable<z.ZodString>;
+    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>, z.ZodObject<{
+    ok: z.ZodLiteral<false>;
+    status: z.ZodOptional<z.ZodNumber>;
+    message: z.ZodString;
+    response: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>]>;
+declare const assignTasksOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        status: z.ZodString;
+        url: z.ZodString;
+        type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    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>, z.ZodObject<{
+    ok: z.ZodLiteral<false>;
+    status: z.ZodOptional<z.ZodNumber>;
+    message: z.ZodString;
+    response: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>]>;
+declare const workspaceUsageEntitySchema: z.ZodObject<{
+    workspace: z.ZodString;
+    plan: z.ZodString;
+    planType: z.ZodString;
+    trialState: z.ZodString;
+    daysRemaining: z.ZodNullable<z.ZodNumber>;
+    isPaidPro: z.ZodBoolean;
+    subscriptionStatus: z.ZodString;
+    tasksToday: z.ZodString;
+    tasksResetAt: z.ZodString;
+    openTasks: z.ZodNumber;
+    totalTasks: z.ZodNumber;
+    seats: z.ZodString;
+    groups: z.ZodString;
+    apiKeys: z.ZodString;
+    rateLimitPerSecond: z.ZodNumber;
+}, z.core.$strip>;
+declare const getWorkspaceUsageOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
+    usage: z.ZodObject<{
+        workspace: z.ZodString;
+        plan: z.ZodString;
+        planType: z.ZodString;
+        trialState: z.ZodString;
+        daysRemaining: z.ZodNullable<z.ZodNumber>;
+        isPaidPro: z.ZodBoolean;
+        subscriptionStatus: z.ZodString;
+        tasksToday: z.ZodString;
+        tasksResetAt: z.ZodString;
+        openTasks: z.ZodNumber;
+        totalTasks: z.ZodNumber;
+        seats: z.ZodString;
+        groups: z.ZodString;
+        apiKeys: z.ZodString;
+        rateLimitPerSecond: z.ZodNumber;
+    }, z.core.$strip>;
+    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>, z.ZodObject<{
+    ok: z.ZodLiteral<false>;
+    status: z.ZodOptional<z.ZodNumber>;
+    message: z.ZodString;
+    response: z.ZodOptional<z.ZodUnknown>;
+}, 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>;
+type StatusEntityRow = z.infer<typeof statusEntityRowSchema>;
+
+declare const robotRockWebhookPayloadBodySchema: z.ZodObject<{
+    taskId: z.ZodString;
+    action: z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        data: z.ZodUnknown;
+    }, z.core.$strip>;
+    handledBy: z.ZodOptional<z.ZodString>;
+    handledAt: z.ZodString;
+    handlerType: z.ZodString;
+}, z.core.$strip>;
+type RobotRockWebhookPayload = z.infer<typeof robotRockWebhookPayloadBodySchema> & {
+    headers: Record<string, string>;
+};
+type RobotRockWebhookErrorCode = "MISSING_WEBHOOK_SECRET" | "MISSING_SIGNATURE" | "INVALID_SIGNATURE" | "INVALID_JSON" | "INVALID_PAYLOAD";
+declare class RobotRockWebhookError extends Error {
+    readonly code: RobotRockWebhookErrorCode;
+    readonly details?: unknown | undefined;
+    constructor(message: string, code: RobotRockWebhookErrorCode, details?: unknown | undefined);
+}
+interface VerifyRobotRockWebhookOptions {
+    /**
+     * Override shared secret (defaults to ROBOTROCK_WEBHOOK_SECRET).
+     * Keep undefined in production to enforce the canonical env var.
+     */
+    secret?: string;
+    /**
+     * Resolve the tenant signing secret by public task id (hosted MCP uses Convex).
+     * Used when secret is not passed explicitly.
+     */
+    resolveSecret?: (taskId: string) => Promise<string | undefined>;
+    /** Signature header to read. @default "x-robotrock-signature" */
+    signatureHeader?: string;
+}
+/**
+ * Verify a RobotRock webhook request and return a validated payload.
+ * Throws RobotRockWebhookError with machine-readable `code` for audit logging.
+ */
+declare function verifyRobotRockWebhook(request: Request, options?: VerifyRobotRockWebhookOptions): Promise<RobotRockWebhookPayload>;
+
+/** Build the assistant resume prompt when an inbox task linked to a chat is handled. */
+declare function buildTaskHandledResumeMessage(payload: RobotRockWebhookPayload): string;
+
+/** Hook slug advertised in GET /eve/v1/info for RobotRock-ready auto-detection. */
+declare const ROBOTROCK_READY_HOOK_SLUG = "robotrock-ready";
+
+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 };