robotrock 1.3.3 → 1.4.0

package/dist/eve/tools/admin/query-tasks.d.ts

@@ -1,6 +1,4 @@
 import * as eve_tools from 'eve/tools';
-import { T as ToolResultWithReplyGuidance } from '../../../tool-reply-guidance-C3qrT1In.js';
-import * as _robotrock_core from '@robotrock/core';
 import { z } from 'zod';
 
 declare const QUERY_TASKS_TOOL_NAME = "query_tasks";
@@ -44,11 +42,49 @@ declare function defineQueryTasksTool(): eve_tools.ToolDefinition<{
     cursor?: string | undefined;
     taskId?: string | undefined;
     query?: string | undefined;
-}, ToolResultWithReplyGuidance<_robotrock_core.ToolDisplayEnvelope<Record<string, unknown>>> | {
+}, {
     ok: false;
-    status: number;
     message: string;
-    response: unknown;
+    status?: number | undefined;
+    response?: unknown;
+} | {
+    items: {
+        id: string;
+        name: string;
+        status: string;
+        type: string | null;
+        description: string | null;
+        validUntil: number;
+        createdAt: number;
+        url: string;
+        threadPriority?: string | null | undefined;
+    }[];
+    nextCursor?: string | null | undefined;
+    replyGuidance?: string | undefined;
+    ui?: {
+        present?: boolean | undefined;
+        entity?: string | undefined;
+        rowsPath?: string | undefined;
+        layout?: "list" | "chart" | "table" | undefined;
+    } | undefined;
+    uiHint?: "list" | "chart" | "table" | undefined;
+} | {
+    id: string | null;
+    status: string | null;
+    type: string | null;
+    name: string | null;
+    description: string | null;
+    validUntil: number | null;
+    createdAt: number | null;
+    url: string | null;
+    replyGuidance?: string | undefined;
+    ui?: {
+        present?: boolean | undefined;
+        entity?: string | undefined;
+        rowsPath?: string | undefined;
+        layout?: "list" | "chart" | "table" | undefined;
+    } | undefined;
+    uiHint?: "list" | "chart" | "table" | undefined;
 }>;
 declare const queryTasksTool: eve_tools.ToolDefinition<{
     action: "search" | "list" | "get";
@@ -61,11 +97,49 @@ declare const queryTasksTool: eve_tools.ToolDefinition<{
     cursor?: string | undefined;
     taskId?: string | undefined;
     query?: string | undefined;
-}, ToolResultWithReplyGuidance<_robotrock_core.ToolDisplayEnvelope<Record<string, unknown>>> | {
+}, {
     ok: false;
-    status: number;
     message: string;
-    response: unknown;
+    status?: number | undefined;
+    response?: unknown;
+} | {
+    items: {
+        id: string;
+        name: string;
+        status: string;
+        type: string | null;
+        description: string | null;
+        validUntil: number;
+        createdAt: number;
+        url: string;
+        threadPriority?: string | null | undefined;
+    }[];
+    nextCursor?: string | null | undefined;
+    replyGuidance?: string | undefined;
+    ui?: {
+        present?: boolean | undefined;
+        entity?: string | undefined;
+        rowsPath?: string | undefined;
+        layout?: "list" | "chart" | "table" | undefined;
+    } | undefined;
+    uiHint?: "list" | "chart" | "table" | undefined;
+} | {
+    id: string | null;
+    status: string | null;
+    type: string | null;
+    name: string | null;
+    description: string | null;
+    validUntil: number | null;
+    createdAt: number | null;
+    url: string | null;
+    replyGuidance?: string | undefined;
+    ui?: {
+        present?: boolean | undefined;
+        entity?: string | undefined;
+        rowsPath?: string | undefined;
+        layout?: "list" | "chart" | "table" | undefined;
+    } | undefined;
+    uiHint?: "list" | "chart" | "table" | undefined;
 }>;
 
 export { QUERY_TASKS_TOOL_NAME, defineQueryTasksTool, queryTasksInputSchema, queryTasksTool };

package/dist/eve/tools/admin/query-tasks.js

@@ -1,6 +1,6 @@
 // src/eve/tools/admin/query-tasks.ts
 import { defineTool } from "eve/tools";
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 
 // src/http.ts
 var RobotRockError = class extends Error {
@@ -493,6 +493,40 @@ var agentChatLinkTaskBodySchema = z.object({
   publicTaskId: z.string().min(1),
   toolCallId: z.string().min(1)
 });
+var AGENT_FILE_TAGS_MAX = 20;
+var AGENT_FILE_TAG_MAX_LENGTH = 64;
+function normalizeAgentFileTags(tags) {
+  if (!tags?.length) return void 0;
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const raw of tags) {
+    const tag = raw.trim().toLowerCase().slice(0, AGENT_FILE_TAG_MAX_LENGTH);
+    if (!tag || seen.has(tag)) continue;
+    seen.add(tag);
+    out.push(tag);
+    if (out.length >= AGENT_FILE_TAGS_MAX) break;
+  }
+  return out.length > 0 ? out : void 0;
+}
+var agentChatUploadImageBodySchema = z.object({
+  mediaType: z.string().min(1),
+  /** Raw base64 (no data: URL prefix). */
+  base64: z.string().min(1),
+  chatId: z.string().min(1).optional(),
+  publicTaskId: z.string().min(1).optional(),
+  source: z.string().min(1).optional(),
+  /** Display / search name (e.g. `sunset-robot.png`). */
+  filename: z.string().min(1).max(255).optional(),
+  /** Human-readable description (e.g. generation prompt). */
+  description: z.string().min(1).max(2e3).optional(),
+  /**
+   * Optional labels for later grouping/filtering.
+   * Normalized to lowercase trimmed unique strings (max 20, 64 chars each).
+   */
+  tags: z.array(z.string().min(1).max(AGENT_FILE_TAG_MAX_LENGTH)).max(AGENT_FILE_TAGS_MAX).optional().transform((tags) => normalizeAgentFileTags(tags))
+}).refine((data) => Boolean(data.chatId || data.publicTaskId), {
+  message: "Provide chatId and/or publicTaskId"
+});
 
 // ../core/src/schemas/tool-result-display.ts
 import { z as z2 } from "zod";
@@ -521,7 +555,8 @@ var tenantRoleSchema = z3.enum(["admin", "member"]);
 var agentAdminUserSchema = z3.object({
   id: z3.string(),
   email: z3.string().email(),
-  name: z3.string()
+  name: z3.string(),
+  profilePictureUrl: z3.string().nullable().optional()
 });
 var agentAdminMemberSchema = z3.object({
   userId: z3.string(),
@@ -606,6 +641,37 @@ var assignTasksBodySchema = z3.object({
     { message: "assignTo needs at least one user email or group slug." }
   )
 });
+var agentAdminPlanLimitsSchema = z3.object({
+  tasksPerDay: z3.number(),
+  members: z3.number(),
+  apiKeys: z3.number(),
+  groups: z3.number(),
+  auditLogRetention: z3.number(),
+  rateLimitPerSecond: z3.number(),
+  taskRetentionDays: z3.number()
+});
+var agentAdminUsageSchema = z3.object({
+  workspace: z3.string(),
+  planName: z3.string(),
+  planType: z3.string(),
+  trialState: z3.enum(["none", "active", "expired"]),
+  daysRemaining: z3.number().nullable(),
+  isPaidPro: z3.boolean(),
+  subscriptionStatus: z3.string().nullable(),
+  tasksToday: z3.number(),
+  maxTasksPerDay: z3.number().nullable(),
+  tasksResetAt: z3.number(),
+  openTasks: z3.number(),
+  totalTasks: z3.number(),
+  seatsCurrent: z3.number(),
+  seatsMax: z3.number().nullable(),
+  groupsCurrent: z3.number(),
+  groupsMax: z3.number().nullable(),
+  apiKeysCurrent: z3.number(),
+  apiKeysMax: z3.number().nullable(),
+  rateLimitPerSecond: z3.number(),
+  limits: agentAdminPlanLimitsSchema
+});
 
 // ../core/src/handler-retry.ts
 var HANDLER_RETRY_DELAYS_MS = [
@@ -701,7 +767,11 @@ function resolveRobotRockAuthConfig(overrides) {
       "RobotRock auth is required. Set ROBOTROCK_API_KEY, ROBOTROCK_AGENT_SERVICE_TOKEN with tenant context, or pass auth when creating the client."
     );
   }
-  return { kind: "apiKey", apiKey };
+  return {
+    kind: "apiKey",
+    apiKey,
+    ...overrides?.actingUserId?.trim() ? { actingUserId: overrides.actingUserId.trim() } : {}
+  };
 }
 
 // src/eve/agent/attributes.ts
@@ -837,6 +907,9 @@ async function agentAdminFetch(config, path, init) {
 }
 function createAgentAdminApi(config) {
   return {
+    usage: {
+      get: () => agentAdminFetch(config, "/usage")
+    },
     members: {
       list: () => agentAdminFetch(config, "/members"),
       get: (memberRef) => agentAdminFetch(config, `/members/${encodeURIComponent(memberRef)}`),
@@ -979,20 +1052,223 @@ function requireBoundAgentAdminClient(ctx) {
   return createBoundAgentAdminClient(ctx);
 }
 
-// src/eve/tool-result-display.ts
-function toolDisplayResult(data, options) {
-  const display = options?.widget || options?.title || options?.description ? {
-    ...options.widget ? { widget: options.widget } : {},
-    ...options.title ? { title: options.title } : {},
-    ...options.description ? { description: options.description } : {}
-  } : void 0;
+// src/eve/entity-schemas.ts
+import { z as z5 } from "zod";
+
+// src/eve/tool-ui-hint.ts
+var TOOL_UI_HINT_FIELD = "uiHint";
+function withUiHint(result, hint) {
   return {
-    ...display ? { display } : {},
-    data,
-    ...options?.ui ? { ui: options.ui } : {}
+    ...result,
+    [TOOL_UI_HINT_FIELD]: hint
+  };
+}
+
+// src/eve/tool-result-ui-meta.ts
+var TOOL_UI_FIELD = "ui";
+var TOOL_RESULT_UI_ENTITY_ID_RE = /^[a-z][a-z0-9_]{0,63}$/;
+function withToolUi(result, ui) {
+  const existing = typeof result[TOOL_UI_FIELD] === "object" && result[TOOL_UI_FIELD] !== null && !Array.isArray(result[TOOL_UI_FIELD]) ? result[TOOL_UI_FIELD] : {};
+  return {
+    ...result,
+    [TOOL_UI_FIELD]: {
+      ...existing,
+      ...ui
+    }
   };
 }
 
+// src/eve/entity-schemas.ts
+function buildTenantTaskUrl(tenantSlug, task) {
+  const q = new URLSearchParams();
+  if (task.app && task.app !== "default") {
+    q.set("app", task.app);
+  }
+  if (task.type?.trim()) {
+    q.set("type", task.type.trim());
+  }
+  q.set("selected", task.id);
+  return `/${tenantSlug}/inbox?${q.toString()}`;
+}
+var toolResultUiMetaSchema = z5.object({
+  present: z5.boolean().optional(),
+  entity: z5.string().regex(TOOL_RESULT_UI_ENTITY_ID_RE).optional(),
+  rowsPath: z5.string().min(1).optional(),
+  layout: z5.enum(["list", "chart", "table"]).optional()
+}).strict();
+var agentOnlyFields = {
+  replyGuidance: z5.string().optional(),
+  ui: toolResultUiMetaSchema.optional(),
+  uiHint: z5.enum(["list", "chart", "table"]).optional()
+};
+function withAgentOnlyFields(shape) {
+  return z5.object({
+    ...shape,
+    ...agentOnlyFields
+  });
+}
+var productEntityRowSchema = z5.object({
+  id: z5.string().min(1),
+  name: z5.string().min(1),
+  price: z5.number(),
+  currency: z5.string().min(1),
+  inStock: z5.boolean(),
+  url: z5.string().min(1)
+});
+var metricPointEntityRowSchema = z5.object({
+  date: z5.string().optional(),
+  category: z5.string().optional(),
+  label: z5.string().optional()
+}).catchall(z5.union([z5.string(), z5.number()]));
+var memberEntityRowSchema = z5.object({
+  name: z5.string(),
+  email: z5.string(),
+  role: z5.string(),
+  membershipKind: z5.string(),
+  profilePictureUrl: z5.string().nullable()
+});
+var taskEntityRowSchema = z5.object({
+  id: z5.string().min(1),
+  name: z5.string().min(1),
+  status: z5.string().min(1),
+  type: z5.string().nullable(),
+  description: z5.string().nullable(),
+  validUntil: z5.number(),
+  createdAt: z5.number(),
+  url: z5.string().min(1),
+  threadPriority: z5.string().nullable().optional()
+});
+var groupEntityRowSchema = z5.object({
+  name: z5.string().min(1),
+  slug: z5.string().min(1),
+  description: z5.string().nullable(),
+  memberCount: z5.number().nullable(),
+  url: z5.string().min(1)
+});
+var groupDetailEntitySchema = z5.object({
+  name: z5.string().min(1),
+  slug: z5.string().min(1),
+  description: z5.string().nullable(),
+  url: z5.string().min(1),
+  members: z5.array(
+    z5.object({
+      name: z5.string(),
+      email: z5.string(),
+      profilePictureUrl: z5.string().nullable()
+    })
+  )
+});
+var statusEntityRowSchema = z5.object({
+  id: z5.string().min(1),
+  name: z5.string().min(1),
+  status: z5.string().min(1),
+  url: z5.string().min(1),
+  type: z5.string().nullable().optional(),
+  description: z5.string().nullable().optional()
+});
+var agentAdminErrorResultSchema = z5.object({
+  ok: z5.literal(false),
+  status: z5.number().optional(),
+  message: z5.string(),
+  response: z5.unknown().optional()
+});
+var agentAdminMutationResultSchema = z5.object({
+  ...agentOnlyFields
+}).passthrough();
+var searchProductsOutputSchema = withAgentOnlyFields({
+  items: z5.array(productEntityRowSchema)
+});
+var generateRandomChartOutputSchema = withAgentOnlyFields({
+  title: z5.string().min(1),
+  axis: z5.enum(["time", "category"]),
+  series: z5.array(metricPointEntityRowSchema)
+});
+var generateImageOutputSchema = withAgentOnlyFields({
+  prompt: z5.string().min(1),
+  mediaType: z5.string().min(1),
+  model: z5.string().min(1),
+  storageId: z5.string().min(1),
+  url: z5.string().min(1),
+  /** @deprecated Legacy sessions only — prefer storageId/url. */
+  base64: z5.string().min(1).optional()
+});
+var manageTeamMembersListOutputSchema = withAgentOnlyFields({
+  members: z5.array(memberEntityRowSchema)
+});
+var manageTeamMembersDetailOutputSchema = withAgentOnlyFields(
+  memberEntityRowSchema.shape
+);
+var manageTeamMembersOutputSchema = z5.union([
+  manageTeamMembersListOutputSchema,
+  manageTeamMembersDetailOutputSchema,
+  agentAdminMutationResultSchema,
+  agentAdminErrorResultSchema
+]);
+var manageGroupsListOutputSchema = withAgentOnlyFields({
+  groups: z5.array(groupEntityRowSchema)
+});
+var manageGroupsDetailOutputSchema = withAgentOnlyFields(
+  groupDetailEntitySchema.shape
+);
+var manageGroupsSummaryOutputSchema = withAgentOnlyFields(
+  groupEntityRowSchema.shape
+);
+var manageGroupsOutputSchema = z5.union([
+  manageGroupsListOutputSchema,
+  manageGroupsDetailOutputSchema,
+  manageGroupsSummaryOutputSchema,
+  agentAdminMutationResultSchema,
+  agentAdminErrorResultSchema
+]);
+var queryTasksListOutputSchema = withAgentOnlyFields({
+  items: z5.array(taskEntityRowSchema),
+  nextCursor: z5.string().nullable().optional()
+});
+var queryTasksDetailOutputSchema = withAgentOnlyFields({
+  id: z5.string().nullable(),
+  status: z5.string().nullable(),
+  type: z5.string().nullable(),
+  name: z5.string().nullable(),
+  description: z5.string().nullable(),
+  validUntil: z5.number().nullable(),
+  createdAt: z5.number().nullable(),
+  url: z5.string().min(1).nullable()
+});
+var queryTasksOutputSchema = z5.union([
+  queryTasksListOutputSchema,
+  queryTasksDetailOutputSchema,
+  agentAdminErrorResultSchema
+]);
+var assignTasksOutputSchema = z5.union([
+  withAgentOnlyFields({
+    results: z5.array(statusEntityRowSchema)
+  }),
+  agentAdminErrorResultSchema
+]);
+var workspaceUsageEntitySchema = z5.object({
+  workspace: z5.string(),
+  plan: z5.string(),
+  planType: z5.string(),
+  trialState: z5.string(),
+  daysRemaining: z5.number().nullable(),
+  isPaidPro: z5.boolean(),
+  subscriptionStatus: z5.string(),
+  tasksToday: z5.string(),
+  tasksResetAt: z5.string(),
+  openTasks: z5.number(),
+  totalTasks: z5.number(),
+  seats: z5.string(),
+  groups: z5.string(),
+  apiKeys: z5.string(),
+  rateLimitPerSecond: z5.number()
+});
+var getWorkspaceUsageOutputSchema = z5.union([
+  withAgentOnlyFields({
+    usage: workspaceUsageEntitySchema
+  }),
+  agentAdminErrorResultSchema
+]);
+
 // src/eve/tool-reply-guidance.ts
 var TOOL_REPLY_GUIDANCE_FIELD = "replyGuidance";
 var QUERY_TASKS_LIST_REPLY_GUIDANCE = "Tasks render as a list card in chat. Do not restate task names, ids, or statuses from the list. Only add context not shown (e.g. filters applied, recommended next action).";
@@ -1006,125 +1282,89 @@ function withReplyGuidance(result, guidance) {
 
 // src/eve/tool-display-format.ts
 function formatToolObjectResult(data, options) {
-  return withReplyGuidance(
-    toolDisplayResult(data, {
-      title: options.title,
-      description: options.description,
-      ui: options.ui
-    }),
+  let result = withReplyGuidance(
+    data,
     options.replyGuidance
   );
-}
-function formatToolListResult(listKey, items, options) {
-  const listFieldUi = options.itemWidget ? {
-    "ui:widget": "list",
-    items: {
-      "ui:widget": options.itemWidget,
-      ...options.itemUi ?? {}
-    }
-  } : {
-    "ui:widget": "table",
-    ...options.itemUi ? { items: options.itemUi } : {}
-  };
-  return formatToolObjectResult(
-    { [listKey]: items },
-    {
-      title: options.title,
-      ui: {
-        [listKey]: listFieldUi
-      },
-      replyGuidance: options.replyGuidance
-    }
-  );
+  if (options.ui) {
+    result = withToolUi(result, options.ui);
+  }
+  if (options.uiHint) {
+    result = withUiHint(result, options.uiHint);
+  }
+  return result;
 }
 
 // src/eve/tools/admin/format-tasks-list.ts
 function resolveTaskCardLabel(task) {
   return task.name?.trim() || task.description?.trim() || task.type?.trim() || task.id?.trim() || "Untitled task";
 }
-function formatTasksListResult(items, options) {
-  const title = options?.title ?? (items.length === 1 ? "1 task" : `${items.length} tasks`);
-  const result = formatToolListResult(
-    "items",
-    items.map((task) => ({
+function serializeTaskRow(task, tenantSlug) {
+  return {
+    id: task.id,
+    name: resolveTaskCardLabel(task),
+    status: task.status,
+    type: task.type,
+    description: task.description,
+    validUntil: task.validUntil,
+    createdAt: task.createdAt,
+    threadPriority: task.threadPriority,
+    url: buildTenantTaskUrl(tenantSlug, {
       id: task.id,
-      name: resolveTaskCardLabel(task),
-      status: task.status,
-      type: task.type,
-      description: task.description
-    })),
-    {
-      title,
-      itemWidget: "tenantTask",
-      replyGuidance: QUERY_TASKS_LIST_REPLY_GUIDANCE
-    }
-  );
-  if (options?.nextCursor) {
-    return {
-      ...result,
-      data: {
-        ...result.data,
-        nextCursor: options.nextCursor
-      },
-      display: {
-        ...result.display,
-        description: "More tasks available \u2014 pass nextCursor to list again."
-      }
-    };
-  }
-  return result;
+      type: task.type
+    })
+  };
 }
-function formatTaskSearchResult(items, total) {
-  return formatTasksListResult(items, {
-    title: total === 1 ? "1 matching task" : `${total} matching tasks`
+function formatTasksListResult(items, options) {
+  const payload = {
+    items: items.map((task) => serializeTaskRow(task, options.tenantSlug))
+  };
+  if (options.nextCursor) {
+    payload.nextCursor = options.nextCursor;
+  }
+  return formatToolObjectResult(payload, {
+    replyGuidance: QUERY_TASKS_LIST_REPLY_GUIDANCE,
+    ui: { layout: "list", entity: "task", rowsPath: "items" }
   });
 }
-function formatTaskDetailResult(task) {
-  const title = resolveTaskCardLabel({
-    name: typeof task.name === "string" ? task.name : null,
-    description: typeof task.description === "string" ? task.description : null,
-    type: typeof task.type === "string" ? task.type : null,
-    id: typeof task.id === "string" ? task.id : null
-  });
+function formatTaskSearchResult(items, options) {
+  return formatTasksListResult(items, options);
+}
+function formatTaskDetailResult(task, options) {
+  const id = typeof task.id === "string" ? task.id : null;
+  const type = typeof task.type === "string" ? task.type : null;
+  const url = id !== null ? buildTenantTaskUrl(options.tenantSlug, { id, type }) : null;
   return formatToolObjectResult(
     {
-      id: task.id ?? null,
-      status: task.status ?? null,
-      type: task.type ?? null,
-      name: task.name ?? null,
-      description: task.description ?? null,
-      validUntil: task.validUntil ?? null,
-      createdAt: task.createdAt ?? null
+      id,
+      status: typeof task.status === "string" ? task.status : null,
+      type,
+      name: typeof task.name === "string" ? task.name : null,
+      description: typeof task.description === "string" ? task.description : null,
+      validUntil: typeof task.validUntil === "number" ? task.validUntil : null,
+      createdAt: typeof task.createdAt === "number" ? task.createdAt : null,
+      url
     },
     {
-      title,
-      ui: {
-        id: { "ui:title": "Task ID" },
-        status: { "ui:title": "Status" },
-        type: { "ui:title": "Type" },
-        name: { "ui:title": "Name" },
-        description: { "ui:title": "Description" },
-        validUntil: { "ui:title": "Valid until", "ui:widget": "date" },
-        createdAt: { "ui:title": "Created", "ui:widget": "date" }
-      },
-      replyGuidance: QUERY_TASKS_DETAIL_REPLY_GUIDANCE
+      replyGuidance: QUERY_TASKS_DETAIL_REPLY_GUIDANCE,
+      ui: { entity: "task" }
     }
   );
 }
 
 // src/eve/tools/admin/query-tasks.ts
 var QUERY_TASKS_TOOL_NAME = "query_tasks";
-var queryTasksInputSchema = z5.object({
-  action: z5.enum(["list", "get", "search"]),
-  statusFilter: z5.enum(["all", "open", "handled", "expired"]).optional().describe("Filter by task status for list."),
-  typeFilter: z5.string().optional(),
-  appFilter: z5.string().optional(),
-  sortField: z5.enum(["type", "date", "status", "validUntil"]).optional(),
-  sortDirection: z5.enum(["asc", "desc"]).optional(),
-  limit: z5.number().int().positive().max(100).optional(),
-  cursor: z5.string().optional(),
-  taskId: z5.string().min(1).optional().describe("Public task id or Convex tasks table id for get."),
-  query: z5.string().min(1).optional().describe("Search type, name, description, or id for search.")
+var queryTasksInputSchema = z6.object({
+  action: z6.enum(["list", "get", "search"]),
+  statusFilter: z6.enum(["all", "open", "handled", "expired"]).optional().describe("Filter by task status for list."),
+  typeFilter: z6.string().optional(),
+  appFilter: z6.string().optional(),
+  sortField: z6.enum(["type", "date", "status", "validUntil"]).optional(),
+  sortDirection: z6.enum(["asc", "desc"]).optional(),
+  limit: z6.number().int().positive().max(100).optional(),
+  cursor: z6.string().optional(),
+  taskId: z6.string().min(1).optional().describe("Public task id or Convex tasks table id for get."),
+  query: z6.string().min(1).optional().describe("Search type, name, description, or id for search.")
 }).superRefine((input, ctx) => {
   switch (input.action) {
     case "get":
@@ -1149,10 +1389,13 @@ var queryTasksInputSchema = z5.object({
 });
 function defineQueryTasksTool() {
   return defineTool({
-    description: "Tenant-admin tool to list, fetch detail, or search inbox tasks in the workspace. Requires tenant admin access. Results render as chat UI cards \u2014 do not restate task names, ids, or statuses in your reply.",
+    description: "Tenant-admin tool to list, fetch detail, or search inbox tasks in the workspace. Requires tenant admin access. Call get_my_access in the same turn before this tool to verify admin access (the check stays a compact success marker unless it is the only presentable result). Results render as chat UI cards \u2014 do not restate task names, ids, or statuses in your reply.",
     inputSchema: queryTasksInputSchema,
+    outputSchema: queryTasksOutputSchema,
     async execute(input, ctx) {
+      const caller = requireAdminCaller(ctx);
       const api = requireBoundAgentAdminClient(ctx);
+      const tenantSlug = caller.tenantSlug;
       try {
         switch (input.action) {
           case "list": {
@@ -1166,18 +1409,22 @@ function defineQueryTasksTool() {
               cursor: input.cursor
             });
             return formatTasksListResult(result.items, {
+              tenantSlug,
               nextCursor: result.nextCursor
             });
           }
           case "get": {
             const result = await api.tasks.get(input.taskId);
-            return formatTaskDetailResult(result.task);
+            return formatTaskDetailResult(
+              result.task,
+              { tenantSlug }
+            );
           }
           case "search": {
             const result = await api.tasks.search(input.query, input.limit);
             return formatTaskSearchResult(
               result.items,
-              result.total
+              { tenantSlug }
             );
           }
         }