@open-mercato/core 0.6.8-develop.7099.1.7ba2771d06 → 0.7.0

package/dist/modules/customers/ai-tools/deals-pack.js

@@ -8,11 +8,6 @@ import {
   CustomerDeal,
   CustomerPipelineStage
 } from "../data/entities.js";
-import {
-  dealClosureOutcomeFromStatus,
-  loadClosurePipelineStageSnapshot
-} from "../lib/closureStage.js";
-import { canonicalDealStatus, isClosedDealStatus } from "../lib/dealStatus.js";
 import {
   assertTenantScope
 } from "./types.js";
@@ -34,7 +29,7 @@ const listDealsInput = z.object({
 const listDealsTool = defineApiBackedAiTool({
   name: "customers.list_deals",
   displayName: "List deals",
-  description: 'Search / list deals for the caller tenant + organization. Optional filters include linked person / company / pipeline stage. Returns { items, total, totalIsCapped, limit, offset }. When totalIsCapped is true, total is a floor ("at least N", render it as "N+"), and pagination is exhausted only when a page returns fewer than limit items \u2014 never when offset reaches total.',
+  description: "Search / list deals for the caller tenant + organization. Optional filters include linked person / company / pipeline stage.",
   inputSchema: listDealsInput,
   requiredFeatures: ["customers.deals.view"],
   toOperation: (input, ctx) => {
@@ -88,9 +83,6 @@ const listDealsTool = defineApiBackedAiTool({
         };
       }),
       total: typeof data.total === "number" ? data.total : 0,
-      // A capped count reports a floor: phrase the total as "at least N" and
-      // never treat it as proof that pagination is exhausted.
-      totalIsCapped: data.totalIsCapped === true,
       limit,
       offset
     };
@@ -306,72 +298,34 @@ const updateDealStageTool = {
       afterPipelineStageLabel = stage?.label ?? input.toPipelineStageId;
     } else if (input.toStage) {
       afterStatus = input.toStage;
-      const organizationId = deal.organizationId ?? ctx.organizationId ?? null;
-      const outcome = dealClosureOutcomeFromStatus(input.toStage);
-      if (outcome && organizationId) {
-        const terminalStage = await loadClosurePipelineStageSnapshot(em, {
-          pipelineId: deal.pipelineId ?? null,
-          closureOutcome: outcome,
-          tenantId,
-          organizationId
-        });
-        if (terminalStage) {
-          afterPipelineStageId = terminalStage.id;
-          afterPipelineStageLabel = terminalStage.label;
-        }
-      }
     }
     const beforeStatus = deal.status ?? null;
     const beforePipelineStageId = deal.pipelineStageId ?? null;
     const beforePipelineStageLabel = deal.pipelineStage ?? beforePipelineStageId;
-    const beforeClosureOutcome = deal.closureOutcome ?? null;
-    const beforeLossReasonId = deal.lossReasonId ?? null;
-    const beforeLossNotes = deal.lossNotes ?? null;
-    const requestedOutcome = dealClosureOutcomeFromStatus(input.toStage);
-    const clearsClosure = input.toPipelineStageId === void 0 && input.toStage !== void 0 && !requestedOutcome && !isClosedDealStatus(canonicalDealStatus(input.toStage));
-    const afterClosureOutcome = clearsClosure ? null : requestedOutcome ?? beforeClosureOutcome;
-    const closureOutcomeCleared = beforeClosureOutcome !== null && afterClosureOutcome === null;
-    const afterLossReasonId = closureOutcomeCleared ? null : beforeLossReasonId;
-    const afterLossNotes = closureOutcomeCleared ? null : beforeLossNotes;
     return {
       recordId: deal.id,
       entityType: "customers.deal",
       recordVersion: recordVersionFromUpdatedAt(deal.updatedAt),
       before: {
         status: beforeStatus,
-        pipelineStageId: beforePipelineStageId,
-        closureOutcome: beforeClosureOutcome,
-        lossReasonId: beforeLossReasonId,
-        lossNotes: beforeLossNotes
+        pipelineStageId: beforePipelineStageId
       },
       after: {
         status: afterStatus,
-        pipelineStageId: afterPipelineStageId,
-        closureOutcome: afterClosureOutcome,
-        lossReasonId: afterLossReasonId,
-        lossNotes: afterLossNotes
+        pipelineStageId: afterPipelineStageId
       },
       display: {
         fieldLabels: {
           status: "Status",
-          pipelineStageId: "Pipeline stage",
-          closureOutcome: "Closure outcome",
-          lossReasonId: "Loss reason",
-          lossNotes: "Loss notes"
+          pipelineStageId: "Pipeline stage"
         },
         before: {
           ...beforeStatus ? { status: titleStatus(beforeStatus) } : {},
-          ...beforePipelineStageLabel ? { pipelineStageId: beforePipelineStageLabel } : {},
-          ...beforeClosureOutcome ? { closureOutcome: titleStatus(beforeClosureOutcome) } : {},
-          ...beforeLossReasonId ? { lossReasonId: beforeLossReasonId } : {},
-          ...beforeLossNotes ? { lossNotes: beforeLossNotes } : {}
+          ...beforePipelineStageLabel ? { pipelineStageId: beforePipelineStageLabel } : {}
         },
         after: {
           ...afterStatus ? { status: titleStatus(afterStatus) } : {},
-          ...afterPipelineStageLabel ? { pipelineStageId: afterPipelineStageLabel } : {},
-          ...afterClosureOutcome ? { closureOutcome: titleStatus(afterClosureOutcome) } : closureOutcomeCleared ? { closureOutcome: "\u2014" } : {},
-          ...afterLossReasonId ? { lossReasonId: afterLossReasonId } : {},
-          ...afterLossNotes ? { lossNotes: afterLossNotes } : {}
+          ...afterPipelineStageLabel ? { pipelineStageId: afterPipelineStageLabel } : {}
         }
       }
     };

package/dist/modules/customers/ai-tools/deals-pack.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/customers/ai-tools/deals-pack.ts"],
-  "sourcesContent": ["/**\n * `customers.list_deals` + `customers.get_deal` (Phase 1 WS-C, Step 3.9).\n * `customers.update_deal_stage` mutation tool (Phase 3 WS-C, Step 5.13).\n *\n * Phase 3a of `.ai/specs/implemented/2026-04-27-ai-tools-api-backed-dry-refactor.md`:\n * `customers.list_deals` is now an API-backed wrapper over\n * `GET /api/customers/deals`. Tool name, schema, requiredFeatures, and output\n * shape are unchanged.\n *\n * Phase 3c of the same spec migrates `customers.get_deal` to the documented\n * aggregate detail route. The handler issues 1 call without `includeRelated`\n * (`GET /customers/deals/<id>`) and 3 bounded calls with `includeRelated`\n * (deal detail + activities + comments by `dealId`). The 3-call cap matches\n * the spec's residual N+1 budget; deeper aggregation can earn a first-class\n * API later without touching the AI surface.\n */\nimport type { EntityManager, FilterQuery } from '@mikro-orm/postgresql'\nimport { z } from 'zod'\nimport { defineApiBackedAiTool } from '@open-mercato/ai-assistant/modules/ai_assistant/lib/api-backed-tool'\nimport {\n  createAiApiOperationRunner,\n  type AiApiOperationRequest,\n  type AiToolExecutionContext,\n} from '@open-mercato/ai-assistant/modules/ai_assistant/lib/ai-api-operation-runner'\nimport { findOneWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport {\n  CustomerDeal,\n  CustomerPipelineStage,\n} from '../data/entities'\nimport {\n  dealClosureOutcomeFromStatus,\n  loadClosurePipelineStageSnapshot,\n} from '../lib/closureStage'\nimport { canonicalDealStatus, isClosedDealStatus } from '../lib/dealStatus'\nimport {\n  assertTenantScope,\n  type CustomersAiToolDefinition,\n  type CustomersToolContext,\n  type CustomersToolLoadBeforeSingleRecord,\n} from './types'\n\nfunction resolveEm(ctx: CustomersToolContext | AiToolExecutionContext): EntityManager {\n  return ctx.container.resolve<EntityManager>('em')\n}\n\nfunction buildScope(ctx: CustomersToolContext | AiToolExecutionContext, tenantId: string) {\n  return { tenantId, organizationId: ctx.organizationId }\n}\n\nconst listDealsInput = z\n  .object({\n    q: z.string().trim().optional().describe('Search text matched against deal title / description. Omit or leave empty to list all.'),\n    limit: z.number().int().min(1).max(100).optional().describe('Maximum rows to return (default 50, max 100).'),\n    offset: z.number().int().min(0).optional().describe('Number of rows to skip (default 0).'),\n    personId: z.string().uuid().optional().describe('Return only deals linked to this person entity id.'),\n    companyId: z.string().uuid().optional().describe('Return only deals linked to this company entity id.'),\n    pipelineStageId: z.string().uuid().optional().describe('Return only deals at this pipeline stage.'),\n    status: z.string().optional().describe('Filter by deal status (e.g. \"open\", \"won\", \"lost\").'),\n  })\n  .passthrough()\n\ntype ListDealsInput = z.infer<typeof listDealsInput>\n\ntype ListDealsApiItem = {\n  id?: string\n  title?: string | null\n  description?: string | null\n  status?: string | null\n  pipeline_id?: string | null\n  pipelineId?: string | null\n  pipeline_stage_id?: string | null\n  pipelineStageId?: string | null\n  value_amount?: string | number | null\n  valueAmount?: string | number | null\n  value_currency?: string | null\n  valueCurrency?: string | null\n  probability?: number | null\n  owner_user_id?: string | null\n  ownerUserId?: string | null\n  expected_close_at?: string | null\n  expectedCloseAt?: string | null\n  source?: string | null\n  organization_id?: string | null\n  organizationId?: string | null\n  tenant_id?: string | null\n  tenantId?: string | null\n  created_at?: string | null\n  createdAt?: string | null\n}\n\ntype ListDealsApiResponse = {\n  items?: ListDealsApiItem[]\n  total?: number\n}\n\ntype ListDealsOutput = {\n  items: Array<Record<string, unknown>>\n  total: number\n  limit: number\n  offset: number\n}\n\nconst listDealsTool = defineApiBackedAiTool<ListDealsInput, ListDealsApiResponse, ListDealsOutput>({\n  name: 'customers.list_deals',\n  displayName: 'List deals',\n  description:\n    'Search / list deals for the caller tenant + organization. Optional filters include linked person / company / pipeline stage. Returns { items, total, totalIsCapped, limit, offset }. When totalIsCapped is true, total is a floor (\"at least N\", render it as \"N+\"), and pagination is exhausted only when a page returns fewer than limit items \u2014 never when offset reaches total.',\n  inputSchema: listDealsInput,\n  requiredFeatures: ['customers.deals.view'],\n  toOperation: (input, ctx) => {\n    assertTenantScope(ctx as unknown as CustomersToolContext)\n    const limit = input.limit ?? 50\n    const offset = input.offset ?? 0\n    const page = Math.floor(offset / limit) + 1\n\n    const query: Record<string, string | number | boolean | null | undefined> = {\n      page,\n      pageSize: limit,\n    }\n    if (input.q?.trim()) query.search = input.q.trim()\n    if (input.personId) query.personId = input.personId\n    if (input.companyId) query.companyId = input.companyId\n    if (input.pipelineStageId) query.pipelineStageId = input.pipelineStageId\n    if (input.status) query.status = input.status\n\n    const operation: AiApiOperationRequest = {\n      method: 'GET',\n      path: '/customers/deals',\n      query,\n    }\n    return operation\n  },\n  mapResponse: (response, input) => {\n    const limit = input.limit ?? 50\n    const offset = input.offset ?? 0\n    const data = (response.data ?? {}) as ListDealsApiResponse\n    const rawItems: ListDealsApiItem[] = Array.isArray(data.items) ? data.items : []\n    return {\n      items: rawItems.map((row) => {\n        const expectedCloseRaw = row.expected_close_at ?? row.expectedCloseAt ?? null\n        const expectedCloseAt = expectedCloseRaw ? new Date(String(expectedCloseRaw)).toISOString() : null\n        const createdAtRaw = row.created_at ?? row.createdAt ?? null\n        const createdAt = createdAtRaw ? new Date(String(createdAtRaw)).toISOString() : null\n        return {\n          id: row.id,\n          title: row.title ?? null,\n          description: row.description ?? null,\n          status: row.status ?? null,\n          pipelineId: row.pipeline_id ?? row.pipelineId ?? null,\n          pipelineStageId: row.pipeline_stage_id ?? row.pipelineStageId ?? null,\n          valueAmount: row.value_amount ?? row.valueAmount ?? null,\n          valueCurrency: row.value_currency ?? row.valueCurrency ?? null,\n          probability: row.probability ?? null,\n          ownerUserId: row.owner_user_id ?? row.ownerUserId ?? null,\n          expectedCloseAt,\n          source: row.source ?? null,\n          organizationId: row.organization_id ?? row.organizationId ?? null,\n          tenantId: row.tenant_id ?? row.tenantId ?? null,\n          createdAt,\n        }\n      }),\n      total: typeof data.total === 'number' ? data.total : 0,\n      // A capped count reports a floor: phrase the total as \"at least N\" and\n      // never treat it as proof that pagination is exhausted.\n      totalIsCapped: (data as { totalIsCapped?: boolean }).totalIsCapped === true,\n      limit,\n      offset,\n    }\n  },\n}) as unknown as CustomersAiToolDefinition\n\nconst getDealInput = z.object({\n  dealId: z.string().uuid().describe('Deal id (UUID).'),\n  includeRelated: z\n    .boolean()\n    .optional()\n    .describe('When true, include notes, activities, linked people and companies (each capped at 100).'),\n})\n\ntype GetDealInput = z.infer<typeof getDealInput>\n\nfunction toIsoDeal(value: unknown): string | null {\n  if (!value) return null\n  const dt = value instanceof Date ? value : new Date(String(value))\n  if (Number.isNaN(dt.getTime())) return null\n  return dt.toISOString()\n}\n\nconst getDealTool: CustomersAiToolDefinition = {\n  name: 'customers.get_deal',\n  displayName: 'Get deal',\n  description:\n    'Fetch a deal by id with fields and (optionally) notes, activities, linked people, and linked companies. Returns { found: false } when outside tenant/org scope.',\n  inputSchema: getDealInput,\n  requiredFeatures: ['customers.deals.view'],\n  tags: ['read', 'customers'],\n  handler: async (rawInput, ctx) => {\n    const { tenantId: _tenantId } = assertTenantScope(ctx)\n    void _tenantId\n    const input: GetDealInput = getDealInput.parse(rawInput)\n    const includeRelated = !!input.includeRelated\n    const runner = createAiApiOperationRunner(ctx as unknown as AiToolExecutionContext)\n\n    const detailResponse = await runner.run<Record<string, unknown>>({\n      method: 'GET',\n      path: `/customers/deals/${input.dealId}`,\n    })\n    if (!detailResponse.success) {\n      if (detailResponse.statusCode === 404 || detailResponse.statusCode === 403) {\n        return { found: false as const, dealId: input.dealId }\n      }\n      throw new Error(detailResponse.error ?? `Failed to fetch deal ${input.dealId}`)\n    }\n    const detail = (detailResponse.data ?? {}) as Record<string, unknown>\n    const dealRow = (detail.deal ?? null) as Record<string, unknown> | null\n    if (!dealRow) {\n      return { found: false as const, dealId: input.dealId }\n    }\n    const customFields = (detail.customFields ?? {}) as Record<string, unknown>\n    const peopleRows = Array.isArray(detail.people) ? (detail.people as Array<Record<string, unknown>>) : []\n    const companiesRows = Array.isArray(detail.companies)\n      ? (detail.companies as Array<Record<string, unknown>>)\n      : []\n\n    let related: Record<string, unknown> | null = null\n    if (includeRelated) {\n      const [activitiesResponse, commentsResponse] = await Promise.all([\n        runner.run<{ items?: Array<Record<string, unknown>>; total?: number }>({\n          method: 'GET',\n          path: '/customers/activities',\n          query: { dealId: input.dealId, page: 1, pageSize: 100, sortField: 'occurredAt', sortDir: 'desc' },\n        }),\n        runner.run<{ items?: Array<Record<string, unknown>>; total?: number }>({\n          method: 'GET',\n          path: '/customers/comments',\n          query: { dealId: input.dealId, page: 1, pageSize: 100 },\n        }),\n      ])\n      const activities =\n        activitiesResponse.success && Array.isArray(activitiesResponse.data?.items)\n          ? (activitiesResponse.data!.items as Array<Record<string, unknown>>)\n          : []\n      const comments =\n        commentsResponse.success && Array.isArray(commentsResponse.data?.items)\n          ? (commentsResponse.data!.items as Array<Record<string, unknown>>)\n          : []\n\n      related = {\n        activities: activities.map((activity) => ({\n          id: activity.id,\n          activityType: activity.activityType ?? activity.activity_type ?? null,\n          subject: activity.subject ?? null,\n          body: activity.body ?? null,\n          occurredAt: toIsoDeal(activity.occurredAt ?? activity.occurred_at),\n          createdAt: toIsoDeal(activity.createdAt ?? activity.created_at),\n        })),\n        notes: comments.map((comment) => ({\n          id: comment.id,\n          body: comment.body,\n          authorUserId: comment.authorUserId ?? comment.author_user_id ?? null,\n          createdAt: toIsoDeal(comment.createdAt ?? comment.created_at),\n        })),\n        people: peopleRows\n          .map((person) => {\n            if (!person || typeof person !== 'object') return null\n            const id = typeof person.id === 'string' ? person.id : null\n            if (!id) return null\n            const subtitle = typeof person.subtitle === 'string' ? person.subtitle : null\n            const label = typeof person.label === 'string' ? person.label : ''\n            const entry: {\n              id: string\n              displayName: string\n              primaryEmail: string | null\n              primaryPhone: string | null\n              participantRole: string | null\n            } = {\n              id,\n              displayName: label,\n              primaryEmail: subtitle && subtitle.includes('@') ? subtitle : null,\n              primaryPhone: subtitle && !subtitle.includes('@') ? subtitle : null,\n              participantRole: null as string | null,\n            }\n            return entry\n          })\n          .filter(\n            (value): value is {\n              id: string\n              displayName: string\n              primaryEmail: string | null\n              primaryPhone: string | null\n              participantRole: string | null\n            } => value !== null,\n          ),\n        companies: companiesRows\n          .map((company) => {\n            if (!company || typeof company !== 'object') return null\n            const id = typeof company.id === 'string' ? company.id : null\n            if (!id) return null\n            const label = typeof company.label === 'string' ? company.label : ''\n            const entry: {\n              id: string\n              displayName: string\n              primaryEmail: string | null\n              primaryPhone: string | null\n            } = {\n              id,\n              displayName: label,\n              primaryEmail: null as string | null,\n              primaryPhone: null as string | null,\n            }\n            return entry\n          })\n          .filter(\n            (value): value is {\n              id: string\n              displayName: string\n              primaryEmail: string | null\n              primaryPhone: string | null\n            } => value !== null,\n          ),\n      }\n    }\n\n    return {\n      found: true as const,\n      deal: {\n        id: dealRow.id,\n        title: typeof dealRow.title === 'string' ? dealRow.title : '',\n        description: dealRow.description ?? null,\n        status: dealRow.status ?? null,\n        pipelineId: dealRow.pipelineId ?? null,\n        pipelineStageId: dealRow.pipelineStageId ?? null,\n        valueAmount: dealRow.valueAmount ?? null,\n        valueCurrency: dealRow.valueCurrency ?? null,\n        probability: dealRow.probability ?? null,\n        ownerUserId: dealRow.ownerUserId ?? null,\n        expectedCloseAt: toIsoDeal(dealRow.expectedCloseAt),\n        source: dealRow.source ?? null,\n        organizationId: dealRow.organizationId ?? null,\n        tenantId: dealRow.tenantId ?? null,\n        createdAt: toIsoDeal(dealRow.createdAt),\n        updatedAt: toIsoDeal(dealRow.updatedAt),\n      },\n      customFields,\n      related,\n    }\n  },\n}\n\n/**\n * Mutation tool: move a deal to a different pipeline stage. Step 5.13 \u2014 first\n * mutation-capable flow on the pending-action contract.\n *\n * Accepts either `toPipelineStageId` (UUID \u2014 preferred, tenant-scoped stage\n * record) or `toStage` (free-form string that maps to `CustomerDeal.status`\n * for pipeline roots like `open`/`won`/`lost`). Exactly one must be provided.\n *\n * The handler delegates to the existing `customers.deals.update` command so\n * all side effects (audit log, `customers.deal.updated` event, query index\n * refresh, notifications) stay identical to a direct API write.\n */\n// LLMs frequently emit `\"\"` for \"not provided\" \u2014 coerce blanks (and surrounding\n// whitespace) to `undefined` BEFORE the per-field validators run so the\n// `.uuid()` check on `toPipelineStageId` does not blow up on an empty string\n// the caller actually meant as \"skip this field\".\nconst blankToUndefined = (value: unknown): unknown => {\n  if (typeof value !== 'string') return value\n  const trimmed = value.trim()\n  return trimmed.length === 0 ? undefined : trimmed\n}\n\nconst updateDealStageInput = z\n  .object({\n    dealId: z.string().uuid().describe('Deal id (UUID) to update.'),\n    toPipelineStageId: z\n      .preprocess(blankToUndefined, z.string().uuid().optional())\n      .describe('Target pipeline stage id (UUID). Preferred \u2014 tenant-scoped stage record.'),\n    toStage: z\n      .preprocess(blankToUndefined, z.string().min(1).max(50).optional())\n      .describe(\n        'Target status slug (e.g. \"open\", \"won\", \"lost\"). Used when the deal does not belong to a managed pipeline.',\n      ),\n  })\n  .refine(\n    (value) => Boolean(value.toPipelineStageId) !== Boolean(value.toStage),\n    {\n      message: 'Provide exactly one of toPipelineStageId or toStage.',\n      path: ['toPipelineStageId'],\n    },\n  )\n\ntype UpdateDealStageInput = z.infer<typeof updateDealStageInput>\n\nfunction recordVersionFromUpdatedAt(updatedAt: Date | null | undefined): string | null {\n  if (!updatedAt) return null\n  const value = updatedAt instanceof Date ? updatedAt : new Date(updatedAt)\n  if (Number.isNaN(value.getTime())) return null\n  return value.toISOString()\n}\n\nfunction titleStatus(value: string | null | undefined): string | undefined {\n  if (!value) return undefined\n  return value\n    .split(/[_\\s-]+/)\n    .filter(Boolean)\n    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))\n    .join(' ')\n}\n\nasync function loadDealWithStage(\n  em: EntityManager,\n  ctx: CustomersToolContext,\n  tenantId: string,\n  dealId: string,\n): Promise<CustomerDeal | null> {\n  const where: Record<string, unknown> = { id: dealId, tenantId, deletedAt: null }\n  if (ctx.organizationId) where.organizationId = ctx.organizationId\n  const deal = await findOneWithDecryption<CustomerDeal>(\n    em,\n    CustomerDeal,\n    where as FilterQuery<CustomerDeal>,\n    undefined,\n    buildScope(ctx, tenantId),\n  )\n  if (!deal || deal.tenantId !== tenantId) return null\n  if (ctx.organizationId && deal.organizationId !== ctx.organizationId) return null\n  return deal\n}\n\nasync function loadPipelineStage(\n  em: EntityManager,\n  ctx: CustomersToolContext,\n  tenantId: string,\n  stageId: string,\n  organizationId: string,\n): Promise<CustomerPipelineStage | null> {\n  return findOneWithDecryption<CustomerPipelineStage>(\n    em,\n    CustomerPipelineStage,\n    {\n      id: stageId,\n      tenantId,\n      organizationId,\n    },\n    undefined,\n    buildScope(ctx, tenantId),\n  )\n}\n\nconst updateDealStageTool: CustomersAiToolDefinition = {\n  name: 'customers.update_deal_stage',\n  displayName: 'Update deal stage',\n  description:\n    'Move a deal to a different pipeline stage (by stage id) or change its top-level status (e.g. \"open\", \"won\", \"lost\"). Mutation tool \u2014 flows through the AI pending-action approval gate.',\n  inputSchema: updateDealStageInput as z.ZodType<unknown>,\n  requiredFeatures: ['customers.deals.manage'],\n  tags: ['write', 'customers'],\n  isMutation: true,\n  loadBeforeRecord: async (rawInput, ctx): Promise<CustomersToolLoadBeforeSingleRecord | null> => {\n    const { tenantId } = assertTenantScope(ctx)\n    const input: UpdateDealStageInput = updateDealStageInput.parse(rawInput)\n    const em = resolveEm(ctx)\n    const deal = await loadDealWithStage(em, ctx, tenantId, input.dealId)\n    if (!deal) return null\n    let afterStatus = deal.status ?? null\n    let afterPipelineStageId = deal.pipelineStageId ?? null\n    let afterPipelineStageLabel = deal.pipelineStage ?? null\n    if (input.toPipelineStageId) {\n      const organizationId = deal.organizationId ?? ctx.organizationId ?? null\n      const stage = organizationId\n        ? await loadPipelineStage(em, ctx, tenantId, input.toPipelineStageId, organizationId)\n        : null\n      afterPipelineStageId = input.toPipelineStageId\n      afterPipelineStageLabel = stage?.label ?? input.toPipelineStageId\n    } else if (input.toStage) {\n      afterStatus = input.toStage\n      // The update command derives a closure outcome from terminal status spellings and\n      // relocates the deal to the pipeline's terminal stage (#5107) \u2014 preview that same\n      // projection so the approval card states the full blast radius.\n      const organizationId = deal.organizationId ?? ctx.organizationId ?? null\n      const outcome = dealClosureOutcomeFromStatus(input.toStage)\n      if (outcome && organizationId) {\n        const terminalStage = await loadClosurePipelineStageSnapshot(em, {\n          pipelineId: deal.pipelineId ?? null,\n          closureOutcome: outcome,\n          tenantId,\n          organizationId,\n        })\n        if (terminalStage) {\n          afterPipelineStageId = terminalStage.id\n          afterPipelineStageLabel = terminalStage.label\n        }\n      }\n    }\n    const beforeStatus = deal.status ?? null\n    const beforePipelineStageId = deal.pipelineStageId ?? null\n    const beforePipelineStageLabel = deal.pipelineStage ?? beforePipelineStageId\n    const beforeClosureOutcome = deal.closureOutcome ?? null\n    const beforeLossReasonId = deal.lossReasonId ?? null\n    const beforeLossNotes = deal.lossNotes ?? null\n    // Mirror the update command exactly (#5107): a status-only write derives the closure\n    // outcome for terminal spellings, clears outcome plus loss columns for non-closed\n    // non-terminal ones (reopen), and leaves `closed` and stage-only writes untouched.\n    // `toStage` is free-form model text, so canonicalize before the `closed` check \u2014 the\n    // command does the same, and the two must stay in lockstep or the approval card would\n    // preview a different write than the one that lands.\n    const requestedOutcome = dealClosureOutcomeFromStatus(input.toStage)\n    const clearsClosure =\n      input.toPipelineStageId === undefined &&\n      input.toStage !== undefined &&\n      !requestedOutcome &&\n      !isClosedDealStatus(canonicalDealStatus(input.toStage))\n    const afterClosureOutcome = clearsClosure\n      ? null\n      : requestedOutcome ?? beforeClosureOutcome\n    const closureOutcomeCleared = beforeClosureOutcome !== null && afterClosureOutcome === null\n    const afterLossReasonId = closureOutcomeCleared ? null : beforeLossReasonId\n    const afterLossNotes = closureOutcomeCleared ? null : beforeLossNotes\n    return {\n      recordId: deal.id,\n      entityType: 'customers.deal',\n      recordVersion: recordVersionFromUpdatedAt(deal.updatedAt),\n      before: {\n        status: beforeStatus,\n        pipelineStageId: beforePipelineStageId,\n        closureOutcome: beforeClosureOutcome,\n        lossReasonId: beforeLossReasonId,\n        lossNotes: beforeLossNotes,\n      },\n      after: {\n        status: afterStatus,\n        pipelineStageId: afterPipelineStageId,\n        closureOutcome: afterClosureOutcome,\n        lossReasonId: afterLossReasonId,\n        lossNotes: afterLossNotes,\n      },\n      display: {\n        fieldLabels: {\n          status: 'Status',\n          pipelineStageId: 'Pipeline stage',\n          closureOutcome: 'Closure outcome',\n          lossReasonId: 'Loss reason',\n          lossNotes: 'Loss notes',\n        },\n        before: {\n          ...(beforeStatus ? { status: titleStatus(beforeStatus) } : {}),\n          ...(beforePipelineStageLabel ? { pipelineStageId: beforePipelineStageLabel } : {}),\n          ...(beforeClosureOutcome ? { closureOutcome: titleStatus(beforeClosureOutcome) } : {}),\n          ...(beforeLossReasonId ? { lossReasonId: beforeLossReasonId } : {}),\n          ...(beforeLossNotes ? { lossNotes: beforeLossNotes } : {}),\n        },\n        after: {\n          ...(afterStatus ? { status: titleStatus(afterStatus) } : {}),\n          ...(afterPipelineStageLabel ? { pipelineStageId: afterPipelineStageLabel } : {}),\n          ...(afterClosureOutcome\n            ? { closureOutcome: titleStatus(afterClosureOutcome) }\n            : closureOutcomeCleared\n              ? { closureOutcome: '\u2014' }\n              : {}),\n          ...(afterLossReasonId ? { lossReasonId: afterLossReasonId } : {}),\n          ...(afterLossNotes ? { lossNotes: afterLossNotes } : {}),\n        },\n      },\n    }\n  },\n  handler: async (rawInput, ctx) => {\n    const { tenantId } = assertTenantScope(ctx)\n    const input: UpdateDealStageInput = updateDealStageInput.parse(rawInput)\n    const em = resolveEm(ctx)\n    const deal = await loadDealWithStage(em, ctx, tenantId, input.dealId)\n    if (!deal) {\n      throw new Error(`Deal \"${input.dealId}\" is not accessible to the caller.`)\n    }\n    const organizationId = deal.organizationId\n    if (!organizationId) {\n      throw new Error(`Deal \"${input.dealId}\" has no organization scope.`)\n    }\n\n    const before = {\n      status: deal.status ?? null,\n      pipelineStage: deal.pipelineStage ?? null,\n      pipelineStageId: deal.pipelineStageId ?? null,\n    }\n\n    const body: Record<string, unknown> = {\n      id: deal.id,\n      tenantId,\n      organizationId,\n    }\n    if (input.toPipelineStageId) {\n      const stage = await loadPipelineStage(em, ctx, tenantId, input.toPipelineStageId, organizationId)\n      if (!stage) {\n        throw new Error('Pipeline stage not found.')\n      }\n      body.pipelineStageId = input.toPipelineStageId\n    } else if (input.toStage) {\n      body.status = input.toStage\n    }\n\n    const runner = createAiApiOperationRunner(ctx as unknown as AiToolExecutionContext)\n    const response = await runner.run({\n      method: 'PUT',\n      path: '/customers/deals',\n      body,\n    })\n    if (!response.success) {\n      throw new Error(response.error ?? `Failed to update deal \"${deal.id}\"`)\n    }\n\n    const after = await loadDealWithStage(em, ctx, tenantId, deal.id)\n    return {\n      recordId: deal.id,\n      commandName: 'customers.deals.update',\n      before,\n      after: after\n        ? {\n            status: after.status ?? null,\n            pipelineStage: after.pipelineStage ?? null,\n            pipelineStageId: after.pipelineStageId ?? null,\n          }\n        : null,\n    }\n  },\n}\n\nexport const dealsAiTools: CustomersAiToolDefinition[] = [listDealsTool, getDealTool, updateDealStageTool]\n\nexport default dealsAiTools\n"],
-  "mappings": "AAiBA,SAAS,SAAS;AAClB,SAAS,6BAA6B;AACtC;AAAA,EACE;AAAA,OAGK;AACP,SAAS,6BAA6B;AACtC;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,qBAAqB,0BAA0B;AACxD;AAAA,EACE;AAAA,OAIK;AAEP,SAAS,UAAU,KAAmE;AACpF,SAAO,IAAI,UAAU,QAAuB,IAAI;AAClD;AAEA,SAAS,WAAW,KAAoD,UAAkB;AACxF,SAAO,EAAE,UAAU,gBAAgB,IAAI,eAAe;AACxD;AAEA,MAAM,iBAAiB,EACpB,OAAO;AAAA,EACN,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,wFAAwF;AAAA,EACjI,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,EAAE,SAAS,+CAA+C;AAAA,EAC3G,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,qCAAqC;AAAA,EACzF,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,oDAAoD;AAAA,EACpG,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,qDAAqD;AAAA,EACtG,iBAAiB,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,2CAA2C;AAAA,EAClG,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,qDAAqD;AAC9F,CAAC,EACA,YAAY;AA2Cf,MAAM,gBAAgB,sBAA6E;AAAA,EACjG,MAAM;AAAA,EACN,aAAa;AAAA,EACb,aACE;AAAA,EACF,aAAa;AAAA,EACb,kBAAkB,CAAC,sBAAsB;AAAA,EACzC,aAAa,CAAC,OAAO,QAAQ;AAC3B,sBAAkB,GAAsC;AACxD,UAAM,QAAQ,MAAM,SAAS;AAC7B,UAAM,SAAS,MAAM,UAAU;AAC/B,UAAM,OAAO,KAAK,MAAM,SAAS,KAAK,IAAI;AAE1C,UAAM,QAAsE;AAAA,MAC1E;AAAA,MACA,UAAU;AAAA,IACZ;AACA,QAAI,MAAM,GAAG,KAAK,EAAG,OAAM,SAAS,MAAM,EAAE,KAAK;AACjD,QAAI,MAAM,SAAU,OAAM,WAAW,MAAM;AAC3C,QAAI,MAAM,UAAW,OAAM,YAAY,MAAM;AAC7C,QAAI,MAAM,gBAAiB,OAAM,kBAAkB,MAAM;AACzD,QAAI,MAAM,OAAQ,OAAM,SAAS,MAAM;AAEvC,UAAM,YAAmC;AAAA,MACvC,QAAQ;AAAA,MACR,MAAM;AAAA,MACN;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA,EACA,aAAa,CAAC,UAAU,UAAU;AAChC,UAAM,QAAQ,MAAM,SAAS;AAC7B,UAAM,SAAS,MAAM,UAAU;AAC/B,UAAM,OAAQ,SAAS,QAAQ,CAAC;AAChC,UAAM,WAA+B,MAAM,QAAQ,KAAK,KAAK,IAAI,KAAK,QAAQ,CAAC;AAC/E,WAAO;AAAA,MACL,OAAO,SAAS,IAAI,CAAC,QAAQ;AAC3B,cAAM,mBAAmB,IAAI,qBAAqB,IAAI,mBAAmB;AACzE,cAAM,kBAAkB,mBAAmB,IAAI,KAAK,OAAO,gBAAgB,CAAC,EAAE,YAAY,IAAI;AAC9F,cAAM,eAAe,IAAI,cAAc,IAAI,aAAa;AACxD,cAAM,YAAY,eAAe,IAAI,KAAK,OAAO,YAAY,CAAC,EAAE,YAAY,IAAI;AAChF,eAAO;AAAA,UACL,IAAI,IAAI;AAAA,UACR,OAAO,IAAI,SAAS;AAAA,UACpB,aAAa,IAAI,eAAe;AAAA,UAChC,QAAQ,IAAI,UAAU;AAAA,UACtB,YAAY,IAAI,eAAe,IAAI,cAAc;AAAA,UACjD,iBAAiB,IAAI,qBAAqB,IAAI,mBAAmB;AAAA,UACjE,aAAa,IAAI,gBAAgB,IAAI,eAAe;AAAA,UACpD,eAAe,IAAI,kBAAkB,IAAI,iBAAiB;AAAA,UAC1D,aAAa,IAAI,eAAe;AAAA,UAChC,aAAa,IAAI,iBAAiB,IAAI,eAAe;AAAA,UACrD;AAAA,UACA,QAAQ,IAAI,UAAU;AAAA,UACtB,gBAAgB,IAAI,mBAAmB,IAAI,kBAAkB;AAAA,UAC7D,UAAU,IAAI,aAAa,IAAI,YAAY;AAAA,UAC3C;AAAA,QACF;AAAA,MACF,CAAC;AAAA,MACD,OAAO,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ;AAAA;AAAA;AAAA,MAGrD,eAAgB,KAAqC,kBAAkB;AAAA,MACvE;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF,CAAC;AAED,MAAM,eAAe,EAAE,OAAO;AAAA,EAC5B,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,iBAAiB;AAAA,EACpD,gBAAgB,EACb,QAAQ,EACR,SAAS,EACT,SAAS,yFAAyF;AACvG,CAAC;AAID,SAAS,UAAU,OAA+B;AAChD,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,KAAK,iBAAiB,OAAO,QAAQ,IAAI,KAAK,OAAO,KAAK,CAAC;AACjE,MAAI,OAAO,MAAM,GAAG,QAAQ,CAAC,EAAG,QAAO;AACvC,SAAO,GAAG,YAAY;AACxB;AAEA,MAAM,cAAyC;AAAA,EAC7C,MAAM;AAAA,EACN,aAAa;AAAA,EACb,aACE;AAAA,EACF,aAAa;AAAA,EACb,kBAAkB,CAAC,sBAAsB;AAAA,EACzC,MAAM,CAAC,QAAQ,WAAW;AAAA,EAC1B,SAAS,OAAO,UAAU,QAAQ;AAChC,UAAM,EAAE,UAAU,UAAU,IAAI,kBAAkB,GAAG;AACrD,SAAK;AACL,UAAM,QAAsB,aAAa,MAAM,QAAQ;AACvD,UAAM,iBAAiB,CAAC,CAAC,MAAM;AAC/B,UAAM,SAAS,2BAA2B,GAAwC;AAElF,UAAM,iBAAiB,MAAM,OAAO,IAA6B;AAAA,MAC/D,QAAQ;AAAA,MACR,MAAM,oBAAoB,MAAM,MAAM;AAAA,IACxC,CAAC;AACD,QAAI,CAAC,eAAe,SAAS;AAC3B,UAAI,eAAe,eAAe,OAAO,eAAe,eAAe,KAAK;AAC1E,eAAO,EAAE,OAAO,OAAgB,QAAQ,MAAM,OAAO;AAAA,MACvD;AACA,YAAM,IAAI,MAAM,eAAe,SAAS,wBAAwB,MAAM,MAAM,EAAE;AAAA,IAChF;AACA,UAAM,SAAU,eAAe,QAAQ,CAAC;AACxC,UAAM,UAAW,OAAO,QAAQ;AAChC,QAAI,CAAC,SAAS;AACZ,aAAO,EAAE,OAAO,OAAgB,QAAQ,MAAM,OAAO;AAAA,IACvD;AACA,UAAM,eAAgB,OAAO,gBAAgB,CAAC;AAC9C,UAAM,aAAa,MAAM,QAAQ,OAAO,MAAM,IAAK,OAAO,SAA4C,CAAC;AACvG,UAAM,gBAAgB,MAAM,QAAQ,OAAO,SAAS,IAC/C,OAAO,YACR,CAAC;AAEL,QAAI,UAA0C;AAC9C,QAAI,gBAAgB;AAClB,YAAM,CAAC,oBAAoB,gBAAgB,IAAI,MAAM,QAAQ,IAAI;AAAA,QAC/D,OAAO,IAAgE;AAAA,UACrE,QAAQ;AAAA,UACR,MAAM;AAAA,UACN,OAAO,EAAE,QAAQ,MAAM,QAAQ,MAAM,GAAG,UAAU,KAAK,WAAW,cAAc,SAAS,OAAO;AAAA,QAClG,CAAC;AAAA,QACD,OAAO,IAAgE;AAAA,UACrE,QAAQ;AAAA,UACR,MAAM;AAAA,UACN,OAAO,EAAE,QAAQ,MAAM,QAAQ,MAAM,GAAG,UAAU,IAAI;AAAA,QACxD,CAAC;AAAA,MACH,CAAC;AACD,YAAM,aACJ,mBAAmB,WAAW,MAAM,QAAQ,mBAAmB,MAAM,KAAK,IACrE,mBAAmB,KAAM,QAC1B,CAAC;AACP,YAAM,WACJ,iBAAiB,WAAW,MAAM,QAAQ,iBAAiB,MAAM,KAAK,IACjE,iBAAiB,KAAM,QACxB,CAAC;AAEP,gBAAU;AAAA,QACR,YAAY,WAAW,IAAI,CAAC,cAAc;AAAA,UACxC,IAAI,SAAS;AAAA,UACb,cAAc,SAAS,gBAAgB,SAAS,iBAAiB;AAAA,UACjE,SAAS,SAAS,WAAW;AAAA,UAC7B,MAAM,SAAS,QAAQ;AAAA,UACvB,YAAY,UAAU,SAAS,cAAc,SAAS,WAAW;AAAA,UACjE,WAAW,UAAU,SAAS,aAAa,SAAS,UAAU;AAAA,QAChE,EAAE;AAAA,QACF,OAAO,SAAS,IAAI,CAAC,aAAa;AAAA,UAChC,IAAI,QAAQ;AAAA,UACZ,MAAM,QAAQ;AAAA,UACd,cAAc,QAAQ,gBAAgB,QAAQ,kBAAkB;AAAA,UAChE,WAAW,UAAU,QAAQ,aAAa,QAAQ,UAAU;AAAA,QAC9D,EAAE;AAAA,QACF,QAAQ,WACL,IAAI,CAAC,WAAW;AACf,cAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,gBAAM,KAAK,OAAO,OAAO,OAAO,WAAW,OAAO,KAAK;AACvD,cAAI,CAAC,GAAI,QAAO;AAChB,gBAAM,WAAW,OAAO,OAAO,aAAa,WAAW,OAAO,WAAW;AACzE,gBAAM,QAAQ,OAAO,OAAO,UAAU,WAAW,OAAO,QAAQ;AAChE,gBAAM,QAMF;AAAA,YACF;AAAA,YACA,aAAa;AAAA,YACb,cAAc,YAAY,SAAS,SAAS,GAAG,IAAI,WAAW;AAAA,YAC9D,cAAc,YAAY,CAAC,SAAS,SAAS,GAAG,IAAI,WAAW;AAAA,YAC/D,iBAAiB;AAAA,UACnB;AACA,iBAAO;AAAA,QACT,CAAC,EACA;AAAA,UACC,CAAC,UAMI,UAAU;AAAA,QACjB;AAAA,QACF,WAAW,cACR,IAAI,CAAC,YAAY;AAChB,cAAI,CAAC,WAAW,OAAO,YAAY,SAAU,QAAO;AACpD,gBAAM,KAAK,OAAO,QAAQ,OAAO,WAAW,QAAQ,KAAK;AACzD,cAAI,CAAC,GAAI,QAAO;AAChB,gBAAM,QAAQ,OAAO,QAAQ,UAAU,WAAW,QAAQ,QAAQ;AAClE,gBAAM,QAKF;AAAA,YACF;AAAA,YACA,aAAa;AAAA,YACb,cAAc;AAAA,YACd,cAAc;AAAA,UAChB;AACA,iBAAO;AAAA,QACT,CAAC,EACA;AAAA,UACC,CAAC,UAKI,UAAU;AAAA,QACjB;AAAA,MACJ;AAAA,IACF;AAEA,WAAO;AAAA,MACL,OAAO;AAAA,MACP,MAAM;AAAA,QACJ,IAAI,QAAQ;AAAA,QACZ,OAAO,OAAO,QAAQ,UAAU,WAAW,QAAQ,QAAQ;AAAA,QAC3D,aAAa,QAAQ,eAAe;AAAA,QACpC,QAAQ,QAAQ,UAAU;AAAA,QAC1B,YAAY,QAAQ,cAAc;AAAA,QAClC,iBAAiB,QAAQ,mBAAmB;AAAA,QAC5C,aAAa,QAAQ,eAAe;AAAA,QACpC,eAAe,QAAQ,iBAAiB;AAAA,QACxC,aAAa,QAAQ,eAAe;AAAA,QACpC,aAAa,QAAQ,eAAe;AAAA,QACpC,iBAAiB,UAAU,QAAQ,eAAe;AAAA,QAClD,QAAQ,QAAQ,UAAU;AAAA,QAC1B,gBAAgB,QAAQ,kBAAkB;AAAA,QAC1C,UAAU,QAAQ,YAAY;AAAA,QAC9B,WAAW,UAAU,QAAQ,SAAS;AAAA,QACtC,WAAW,UAAU,QAAQ,SAAS;AAAA,MACxC;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;AAkBA,MAAM,mBAAmB,CAAC,UAA4B;AACpD,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAM,UAAU,MAAM,KAAK;AAC3B,SAAO,QAAQ,WAAW,IAAI,SAAY;AAC5C;AAEA,MAAM,uBAAuB,EAC1B,OAAO;AAAA,EACN,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,2BAA2B;AAAA,EAC9D,mBAAmB,EAChB,WAAW,kBAAkB,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,EACzD,SAAS,+EAA0E;AAAA,EACtF,SAAS,EACN,WAAW,kBAAkB,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,CAAC,EACjE;AAAA,IACC;AAAA,EACF;AACJ,CAAC,EACA;AAAA,EACC,CAAC,UAAU,QAAQ,MAAM,iBAAiB,MAAM,QAAQ,MAAM,OAAO;AAAA,EACrE;AAAA,IACE,SAAS;AAAA,IACT,MAAM,CAAC,mBAAmB;AAAA,EAC5B;AACF;AAIF,SAAS,2BAA2B,WAAmD;AACrF,MAAI,CAAC,UAAW,QAAO;AACvB,QAAM,QAAQ,qBAAqB,OAAO,YAAY,IAAI,KAAK,SAAS;AACxE,MAAI,OAAO,MAAM,MAAM,QAAQ,CAAC,EAAG,QAAO;AAC1C,SAAO,MAAM,YAAY;AAC3B;AAEA,SAAS,YAAY,OAAsD;AACzE,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,MACJ,MAAM,SAAS,EACf,OAAO,OAAO,EACd,IAAI,CAAC,SAAS,KAAK,OAAO,CAAC,EAAE,YAAY,IAAI,KAAK,MAAM,CAAC,CAAC,EAC1D,KAAK,GAAG;AACb;AAEA,eAAe,kBACb,IACA,KACA,UACA,QAC8B;AAC9B,QAAM,QAAiC,EAAE,IAAI,QAAQ,UAAU,WAAW,KAAK;AAC/E,MAAI,IAAI,eAAgB,OAAM,iBAAiB,IAAI;AACnD,QAAM,OAAO,MAAM;AAAA,IACjB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,WAAW,KAAK,QAAQ;AAAA,EAC1B;AACA,MAAI,CAAC,QAAQ,KAAK,aAAa,SAAU,QAAO;AAChD,MAAI,IAAI,kBAAkB,KAAK,mBAAmB,IAAI,eAAgB,QAAO;AAC7E,SAAO;AACT;AAEA,eAAe,kBACb,IACA,KACA,UACA,SACA,gBACuC;AACvC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,MACE,IAAI;AAAA,MACJ;AAAA,MACA;AAAA,IACF;AAAA,IACA;AAAA,IACA,WAAW,KAAK,QAAQ;AAAA,EAC1B;AACF;AAEA,MAAM,sBAAiD;AAAA,EACrD,MAAM;AAAA,EACN,aAAa;AAAA,EACb,aACE;AAAA,EACF,aAAa;AAAA,EACb,kBAAkB,CAAC,wBAAwB;AAAA,EAC3C,MAAM,CAAC,SAAS,WAAW;AAAA,EAC3B,YAAY;AAAA,EACZ,kBAAkB,OAAO,UAAU,QAA6D;AAC9F,UAAM,EAAE,SAAS,IAAI,kBAAkB,GAAG;AAC1C,UAAM,QAA8B,qBAAqB,MAAM,QAAQ;AACvE,UAAM,KAAK,UAAU,GAAG;AACxB,UAAM,OAAO,MAAM,kBAAkB,IAAI,KAAK,UAAU,MAAM,MAAM;AACpE,QAAI,CAAC,KAAM,QAAO;AAClB,QAAI,cAAc,KAAK,UAAU;AACjC,QAAI,uBAAuB,KAAK,mBAAmB;AACnD,QAAI,0BAA0B,KAAK,iBAAiB;AACpD,QAAI,MAAM,mBAAmB;AAC3B,YAAM,iBAAiB,KAAK,kBAAkB,IAAI,kBAAkB;AACpE,YAAM,QAAQ,iBACV,MAAM,kBAAkB,IAAI,KAAK,UAAU,MAAM,mBAAmB,cAAc,IAClF;AACJ,6BAAuB,MAAM;AAC7B,gCAA0B,OAAO,SAAS,MAAM;AAAA,IAClD,WAAW,MAAM,SAAS;AACxB,oBAAc,MAAM;AAIpB,YAAM,iBAAiB,KAAK,kBAAkB,IAAI,kBAAkB;AACpE,YAAM,UAAU,6BAA6B,MAAM,OAAO;AAC1D,UAAI,WAAW,gBAAgB;AAC7B,cAAM,gBAAgB,MAAM,iCAAiC,IAAI;AAAA,UAC/D,YAAY,KAAK,cAAc;AAAA,UAC/B,gBAAgB;AAAA,UAChB;AAAA,UACA;AAAA,QACF,CAAC;AACD,YAAI,eAAe;AACjB,iCAAuB,cAAc;AACrC,oCAA0B,cAAc;AAAA,QAC1C;AAAA,MACF;AAAA,IACF;AACA,UAAM,eAAe,KAAK,UAAU;AACpC,UAAM,wBAAwB,KAAK,mBAAmB;AACtD,UAAM,2BAA2B,KAAK,iBAAiB;AACvD,UAAM,uBAAuB,KAAK,kBAAkB;AACpD,UAAM,qBAAqB,KAAK,gBAAgB;AAChD,UAAM,kBAAkB,KAAK,aAAa;AAO1C,UAAM,mBAAmB,6BAA6B,MAAM,OAAO;AACnE,UAAM,gBACJ,MAAM,sBAAsB,UAC5B,MAAM,YAAY,UAClB,CAAC,oBACD,CAAC,mBAAmB,oBAAoB,MAAM,OAAO,CAAC;AACxD,UAAM,sBAAsB,gBACxB,OACA,oBAAoB;AACxB,UAAM,wBAAwB,yBAAyB,QAAQ,wBAAwB;AACvF,UAAM,oBAAoB,wBAAwB,OAAO;AACzD,UAAM,iBAAiB,wBAAwB,OAAO;AACtD,WAAO;AAAA,MACL,UAAU,KAAK;AAAA,MACf,YAAY;AAAA,MACZ,eAAe,2BAA2B,KAAK,SAAS;AAAA,MACxD,QAAQ;AAAA,QACN,QAAQ;AAAA,QACR,iBAAiB;AAAA,QACjB,gBAAgB;AAAA,QAChB,cAAc;AAAA,QACd,WAAW;AAAA,MACb;AAAA,MACA,OAAO;AAAA,QACL,QAAQ;AAAA,QACR,iBAAiB;AAAA,QACjB,gBAAgB;AAAA,QAChB,cAAc;AAAA,QACd,WAAW;AAAA,MACb;AAAA,MACA,SAAS;AAAA,QACP,aAAa;AAAA,UACX,QAAQ;AAAA,UACR,iBAAiB;AAAA,UACjB,gBAAgB;AAAA,UAChB,cAAc;AAAA,UACd,WAAW;AAAA,QACb;AAAA,QACA,QAAQ;AAAA,UACN,GAAI,eAAe,EAAE,QAAQ,YAAY,YAAY,EAAE,IAAI,CAAC;AAAA,UAC5D,GAAI,2BAA2B,EAAE,iBAAiB,yBAAyB,IAAI,CAAC;AAAA,UAChF,GAAI,uBAAuB,EAAE,gBAAgB,YAAY,oBAAoB,EAAE,IAAI,CAAC;AAAA,UACpF,GAAI,qBAAqB,EAAE,cAAc,mBAAmB,IAAI,CAAC;AAAA,UACjE,GAAI,kBAAkB,EAAE,WAAW,gBAAgB,IAAI,CAAC;AAAA,QAC1D;AAAA,QACA,OAAO;AAAA,UACL,GAAI,cAAc,EAAE,QAAQ,YAAY,WAAW,EAAE,IAAI,CAAC;AAAA,UAC1D,GAAI,0BAA0B,EAAE,iBAAiB,wBAAwB,IAAI,CAAC;AAAA,UAC9E,GAAI,sBACA,EAAE,gBAAgB,YAAY,mBAAmB,EAAE,IACnD,wBACE,EAAE,gBAAgB,SAAI,IACtB,CAAC;AAAA,UACP,GAAI,oBAAoB,EAAE,cAAc,kBAAkB,IAAI,CAAC;AAAA,UAC/D,GAAI,iBAAiB,EAAE,WAAW,eAAe,IAAI,CAAC;AAAA,QACxD;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EACA,SAAS,OAAO,UAAU,QAAQ;AAChC,UAAM,EAAE,SAAS,IAAI,kBAAkB,GAAG;AAC1C,UAAM,QAA8B,qBAAqB,MAAM,QAAQ;AACvE,UAAM,KAAK,UAAU,GAAG;AACxB,UAAM,OAAO,MAAM,kBAAkB,IAAI,KAAK,UAAU,MAAM,MAAM;AACpE,QAAI,CAAC,MAAM;AACT,YAAM,IAAI,MAAM,SAAS,MAAM,MAAM,oCAAoC;AAAA,IAC3E;AACA,UAAM,iBAAiB,KAAK;AAC5B,QAAI,CAAC,gBAAgB;AACnB,YAAM,IAAI,MAAM,SAAS,MAAM,MAAM,8BAA8B;AAAA,IACrE;AAEA,UAAM,SAAS;AAAA,MACb,QAAQ,KAAK,UAAU;AAAA,MACvB,eAAe,KAAK,iBAAiB;AAAA,MACrC,iBAAiB,KAAK,mBAAmB;AAAA,IAC3C;AAEA,UAAM,OAAgC;AAAA,MACpC,IAAI,KAAK;AAAA,MACT;AAAA,MACA;AAAA,IACF;AACA,QAAI,MAAM,mBAAmB;AAC3B,YAAM,QAAQ,MAAM,kBAAkB,IAAI,KAAK,UAAU,MAAM,mBAAmB,cAAc;AAChG,UAAI,CAAC,OAAO;AACV,cAAM,IAAI,MAAM,2BAA2B;AAAA,MAC7C;AACA,WAAK,kBAAkB,MAAM;AAAA,IAC/B,WAAW,MAAM,SAAS;AACxB,WAAK,SAAS,MAAM;AAAA,IACtB;AAEA,UAAM,SAAS,2BAA2B,GAAwC;AAClF,UAAM,WAAW,MAAM,OAAO,IAAI;AAAA,MAChC,QAAQ;AAAA,MACR,MAAM;AAAA,MACN;AAAA,IACF,CAAC;AACD,QAAI,CAAC,SAAS,SAAS;AACrB,YAAM,IAAI,MAAM,SAAS,SAAS,0BAA0B,KAAK,EAAE,GAAG;AAAA,IACxE;AAEA,UAAM,QAAQ,MAAM,kBAAkB,IAAI,KAAK,UAAU,KAAK,EAAE;AAChE,WAAO;AAAA,MACL,UAAU,KAAK;AAAA,MACf,aAAa;AAAA,MACb;AAAA,MACA,OAAO,QACH;AAAA,QACE,QAAQ,MAAM,UAAU;AAAA,QACxB,eAAe,MAAM,iBAAiB;AAAA,QACtC,iBAAiB,MAAM,mBAAmB;AAAA,MAC5C,IACA;AAAA,IACN;AAAA,EACF;AACF;AAEO,MAAM,eAA4C,CAAC,eAAe,aAAa,mBAAmB;AAEzG,IAAO,qBAAQ;",
+  "sourcesContent": ["/**\n * `customers.list_deals` + `customers.get_deal` (Phase 1 WS-C, Step 3.9).\n * `customers.update_deal_stage` mutation tool (Phase 3 WS-C, Step 5.13).\n *\n * Phase 3a of `.ai/specs/implemented/2026-04-27-ai-tools-api-backed-dry-refactor.md`:\n * `customers.list_deals` is now an API-backed wrapper over\n * `GET /api/customers/deals`. Tool name, schema, requiredFeatures, and output\n * shape are unchanged.\n *\n * Phase 3c of the same spec migrates `customers.get_deal` to the documented\n * aggregate detail route. The handler issues 1 call without `includeRelated`\n * (`GET /customers/deals/<id>`) and 3 bounded calls with `includeRelated`\n * (deal detail + activities + comments by `dealId`). The 3-call cap matches\n * the spec's residual N+1 budget; deeper aggregation can earn a first-class\n * API later without touching the AI surface.\n */\nimport type { EntityManager, FilterQuery } from '@mikro-orm/postgresql'\nimport { z } from 'zod'\nimport { defineApiBackedAiTool } from '@open-mercato/ai-assistant/modules/ai_assistant/lib/api-backed-tool'\nimport {\n  createAiApiOperationRunner,\n  type AiApiOperationRequest,\n  type AiToolExecutionContext,\n} from '@open-mercato/ai-assistant/modules/ai_assistant/lib/ai-api-operation-runner'\nimport { findOneWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport {\n  CustomerDeal,\n  CustomerPipelineStage,\n} from '../data/entities'\nimport {\n  assertTenantScope,\n  type CustomersAiToolDefinition,\n  type CustomersToolContext,\n  type CustomersToolLoadBeforeSingleRecord,\n} from './types'\n\nfunction resolveEm(ctx: CustomersToolContext | AiToolExecutionContext): EntityManager {\n  return ctx.container.resolve<EntityManager>('em')\n}\n\nfunction buildScope(ctx: CustomersToolContext | AiToolExecutionContext, tenantId: string) {\n  return { tenantId, organizationId: ctx.organizationId }\n}\n\nconst listDealsInput = z\n  .object({\n    q: z.string().trim().optional().describe('Search text matched against deal title / description. Omit or leave empty to list all.'),\n    limit: z.number().int().min(1).max(100).optional().describe('Maximum rows to return (default 50, max 100).'),\n    offset: z.number().int().min(0).optional().describe('Number of rows to skip (default 0).'),\n    personId: z.string().uuid().optional().describe('Return only deals linked to this person entity id.'),\n    companyId: z.string().uuid().optional().describe('Return only deals linked to this company entity id.'),\n    pipelineStageId: z.string().uuid().optional().describe('Return only deals at this pipeline stage.'),\n    status: z.string().optional().describe('Filter by deal status (e.g. \"open\", \"won\", \"lost\").'),\n  })\n  .passthrough()\n\ntype ListDealsInput = z.infer<typeof listDealsInput>\n\ntype ListDealsApiItem = {\n  id?: string\n  title?: string | null\n  description?: string | null\n  status?: string | null\n  pipeline_id?: string | null\n  pipelineId?: string | null\n  pipeline_stage_id?: string | null\n  pipelineStageId?: string | null\n  value_amount?: string | number | null\n  valueAmount?: string | number | null\n  value_currency?: string | null\n  valueCurrency?: string | null\n  probability?: number | null\n  owner_user_id?: string | null\n  ownerUserId?: string | null\n  expected_close_at?: string | null\n  expectedCloseAt?: string | null\n  source?: string | null\n  organization_id?: string | null\n  organizationId?: string | null\n  tenant_id?: string | null\n  tenantId?: string | null\n  created_at?: string | null\n  createdAt?: string | null\n}\n\ntype ListDealsApiResponse = {\n  items?: ListDealsApiItem[]\n  total?: number\n}\n\ntype ListDealsOutput = {\n  items: Array<Record<string, unknown>>\n  total: number\n  limit: number\n  offset: number\n}\n\nconst listDealsTool = defineApiBackedAiTool<ListDealsInput, ListDealsApiResponse, ListDealsOutput>({\n  name: 'customers.list_deals',\n  displayName: 'List deals',\n  description:\n    'Search / list deals for the caller tenant + organization. Optional filters include linked person / company / pipeline stage.',\n  inputSchema: listDealsInput,\n  requiredFeatures: ['customers.deals.view'],\n  toOperation: (input, ctx) => {\n    assertTenantScope(ctx as unknown as CustomersToolContext)\n    const limit = input.limit ?? 50\n    const offset = input.offset ?? 0\n    const page = Math.floor(offset / limit) + 1\n\n    const query: Record<string, string | number | boolean | null | undefined> = {\n      page,\n      pageSize: limit,\n    }\n    if (input.q?.trim()) query.search = input.q.trim()\n    if (input.personId) query.personId = input.personId\n    if (input.companyId) query.companyId = input.companyId\n    if (input.pipelineStageId) query.pipelineStageId = input.pipelineStageId\n    if (input.status) query.status = input.status\n\n    const operation: AiApiOperationRequest = {\n      method: 'GET',\n      path: '/customers/deals',\n      query,\n    }\n    return operation\n  },\n  mapResponse: (response, input) => {\n    const limit = input.limit ?? 50\n    const offset = input.offset ?? 0\n    const data = (response.data ?? {}) as ListDealsApiResponse\n    const rawItems: ListDealsApiItem[] = Array.isArray(data.items) ? data.items : []\n    return {\n      items: rawItems.map((row) => {\n        const expectedCloseRaw = row.expected_close_at ?? row.expectedCloseAt ?? null\n        const expectedCloseAt = expectedCloseRaw ? new Date(String(expectedCloseRaw)).toISOString() : null\n        const createdAtRaw = row.created_at ?? row.createdAt ?? null\n        const createdAt = createdAtRaw ? new Date(String(createdAtRaw)).toISOString() : null\n        return {\n          id: row.id,\n          title: row.title ?? null,\n          description: row.description ?? null,\n          status: row.status ?? null,\n          pipelineId: row.pipeline_id ?? row.pipelineId ?? null,\n          pipelineStageId: row.pipeline_stage_id ?? row.pipelineStageId ?? null,\n          valueAmount: row.value_amount ?? row.valueAmount ?? null,\n          valueCurrency: row.value_currency ?? row.valueCurrency ?? null,\n          probability: row.probability ?? null,\n          ownerUserId: row.owner_user_id ?? row.ownerUserId ?? null,\n          expectedCloseAt,\n          source: row.source ?? null,\n          organizationId: row.organization_id ?? row.organizationId ?? null,\n          tenantId: row.tenant_id ?? row.tenantId ?? null,\n          createdAt,\n        }\n      }),\n      total: typeof data.total === 'number' ? data.total : 0,\n      limit,\n      offset,\n    }\n  },\n}) as unknown as CustomersAiToolDefinition\n\nconst getDealInput = z.object({\n  dealId: z.string().uuid().describe('Deal id (UUID).'),\n  includeRelated: z\n    .boolean()\n    .optional()\n    .describe('When true, include notes, activities, linked people and companies (each capped at 100).'),\n})\n\ntype GetDealInput = z.infer<typeof getDealInput>\n\nfunction toIsoDeal(value: unknown): string | null {\n  if (!value) return null\n  const dt = value instanceof Date ? value : new Date(String(value))\n  if (Number.isNaN(dt.getTime())) return null\n  return dt.toISOString()\n}\n\nconst getDealTool: CustomersAiToolDefinition = {\n  name: 'customers.get_deal',\n  displayName: 'Get deal',\n  description:\n    'Fetch a deal by id with fields and (optionally) notes, activities, linked people, and linked companies. Returns { found: false } when outside tenant/org scope.',\n  inputSchema: getDealInput,\n  requiredFeatures: ['customers.deals.view'],\n  tags: ['read', 'customers'],\n  handler: async (rawInput, ctx) => {\n    const { tenantId: _tenantId } = assertTenantScope(ctx)\n    void _tenantId\n    const input: GetDealInput = getDealInput.parse(rawInput)\n    const includeRelated = !!input.includeRelated\n    const runner = createAiApiOperationRunner(ctx as unknown as AiToolExecutionContext)\n\n    const detailResponse = await runner.run<Record<string, unknown>>({\n      method: 'GET',\n      path: `/customers/deals/${input.dealId}`,\n    })\n    if (!detailResponse.success) {\n      if (detailResponse.statusCode === 404 || detailResponse.statusCode === 403) {\n        return { found: false as const, dealId: input.dealId }\n      }\n      throw new Error(detailResponse.error ?? `Failed to fetch deal ${input.dealId}`)\n    }\n    const detail = (detailResponse.data ?? {}) as Record<string, unknown>\n    const dealRow = (detail.deal ?? null) as Record<string, unknown> | null\n    if (!dealRow) {\n      return { found: false as const, dealId: input.dealId }\n    }\n    const customFields = (detail.customFields ?? {}) as Record<string, unknown>\n    const peopleRows = Array.isArray(detail.people) ? (detail.people as Array<Record<string, unknown>>) : []\n    const companiesRows = Array.isArray(detail.companies)\n      ? (detail.companies as Array<Record<string, unknown>>)\n      : []\n\n    let related: Record<string, unknown> | null = null\n    if (includeRelated) {\n      const [activitiesResponse, commentsResponse] = await Promise.all([\n        runner.run<{ items?: Array<Record<string, unknown>>; total?: number }>({\n          method: 'GET',\n          path: '/customers/activities',\n          query: { dealId: input.dealId, page: 1, pageSize: 100, sortField: 'occurredAt', sortDir: 'desc' },\n        }),\n        runner.run<{ items?: Array<Record<string, unknown>>; total?: number }>({\n          method: 'GET',\n          path: '/customers/comments',\n          query: { dealId: input.dealId, page: 1, pageSize: 100 },\n        }),\n      ])\n      const activities =\n        activitiesResponse.success && Array.isArray(activitiesResponse.data?.items)\n          ? (activitiesResponse.data!.items as Array<Record<string, unknown>>)\n          : []\n      const comments =\n        commentsResponse.success && Array.isArray(commentsResponse.data?.items)\n          ? (commentsResponse.data!.items as Array<Record<string, unknown>>)\n          : []\n\n      related = {\n        activities: activities.map((activity) => ({\n          id: activity.id,\n          activityType: activity.activityType ?? activity.activity_type ?? null,\n          subject: activity.subject ?? null,\n          body: activity.body ?? null,\n          occurredAt: toIsoDeal(activity.occurredAt ?? activity.occurred_at),\n          createdAt: toIsoDeal(activity.createdAt ?? activity.created_at),\n        })),\n        notes: comments.map((comment) => ({\n          id: comment.id,\n          body: comment.body,\n          authorUserId: comment.authorUserId ?? comment.author_user_id ?? null,\n          createdAt: toIsoDeal(comment.createdAt ?? comment.created_at),\n        })),\n        people: peopleRows\n          .map((person) => {\n            if (!person || typeof person !== 'object') return null\n            const id = typeof person.id === 'string' ? person.id : null\n            if (!id) return null\n            const subtitle = typeof person.subtitle === 'string' ? person.subtitle : null\n            const label = typeof person.label === 'string' ? person.label : ''\n            const entry: {\n              id: string\n              displayName: string\n              primaryEmail: string | null\n              primaryPhone: string | null\n              participantRole: string | null\n            } = {\n              id,\n              displayName: label,\n              primaryEmail: subtitle && subtitle.includes('@') ? subtitle : null,\n              primaryPhone: subtitle && !subtitle.includes('@') ? subtitle : null,\n              participantRole: null as string | null,\n            }\n            return entry\n          })\n          .filter(\n            (value): value is {\n              id: string\n              displayName: string\n              primaryEmail: string | null\n              primaryPhone: string | null\n              participantRole: string | null\n            } => value !== null,\n          ),\n        companies: companiesRows\n          .map((company) => {\n            if (!company || typeof company !== 'object') return null\n            const id = typeof company.id === 'string' ? company.id : null\n            if (!id) return null\n            const label = typeof company.label === 'string' ? company.label : ''\n            const entry: {\n              id: string\n              displayName: string\n              primaryEmail: string | null\n              primaryPhone: string | null\n            } = {\n              id,\n              displayName: label,\n              primaryEmail: null as string | null,\n              primaryPhone: null as string | null,\n            }\n            return entry\n          })\n          .filter(\n            (value): value is {\n              id: string\n              displayName: string\n              primaryEmail: string | null\n              primaryPhone: string | null\n            } => value !== null,\n          ),\n      }\n    }\n\n    return {\n      found: true as const,\n      deal: {\n        id: dealRow.id,\n        title: typeof dealRow.title === 'string' ? dealRow.title : '',\n        description: dealRow.description ?? null,\n        status: dealRow.status ?? null,\n        pipelineId: dealRow.pipelineId ?? null,\n        pipelineStageId: dealRow.pipelineStageId ?? null,\n        valueAmount: dealRow.valueAmount ?? null,\n        valueCurrency: dealRow.valueCurrency ?? null,\n        probability: dealRow.probability ?? null,\n        ownerUserId: dealRow.ownerUserId ?? null,\n        expectedCloseAt: toIsoDeal(dealRow.expectedCloseAt),\n        source: dealRow.source ?? null,\n        organizationId: dealRow.organizationId ?? null,\n        tenantId: dealRow.tenantId ?? null,\n        createdAt: toIsoDeal(dealRow.createdAt),\n        updatedAt: toIsoDeal(dealRow.updatedAt),\n      },\n      customFields,\n      related,\n    }\n  },\n}\n\n/**\n * Mutation tool: move a deal to a different pipeline stage. Step 5.13 \u2014 first\n * mutation-capable flow on the pending-action contract.\n *\n * Accepts either `toPipelineStageId` (UUID \u2014 preferred, tenant-scoped stage\n * record) or `toStage` (free-form string that maps to `CustomerDeal.status`\n * for pipeline roots like `open`/`won`/`lost`). Exactly one must be provided.\n *\n * The handler delegates to the existing `customers.deals.update` command so\n * all side effects (audit log, `customers.deal.updated` event, query index\n * refresh, notifications) stay identical to a direct API write.\n */\n// LLMs frequently emit `\"\"` for \"not provided\" \u2014 coerce blanks (and surrounding\n// whitespace) to `undefined` BEFORE the per-field validators run so the\n// `.uuid()` check on `toPipelineStageId` does not blow up on an empty string\n// the caller actually meant as \"skip this field\".\nconst blankToUndefined = (value: unknown): unknown => {\n  if (typeof value !== 'string') return value\n  const trimmed = value.trim()\n  return trimmed.length === 0 ? undefined : trimmed\n}\n\nconst updateDealStageInput = z\n  .object({\n    dealId: z.string().uuid().describe('Deal id (UUID) to update.'),\n    toPipelineStageId: z\n      .preprocess(blankToUndefined, z.string().uuid().optional())\n      .describe('Target pipeline stage id (UUID). Preferred \u2014 tenant-scoped stage record.'),\n    toStage: z\n      .preprocess(blankToUndefined, z.string().min(1).max(50).optional())\n      .describe(\n        'Target status slug (e.g. \"open\", \"won\", \"lost\"). Used when the deal does not belong to a managed pipeline.',\n      ),\n  })\n  .refine(\n    (value) => Boolean(value.toPipelineStageId) !== Boolean(value.toStage),\n    {\n      message: 'Provide exactly one of toPipelineStageId or toStage.',\n      path: ['toPipelineStageId'],\n    },\n  )\n\ntype UpdateDealStageInput = z.infer<typeof updateDealStageInput>\n\nfunction recordVersionFromUpdatedAt(updatedAt: Date | null | undefined): string | null {\n  if (!updatedAt) return null\n  const value = updatedAt instanceof Date ? updatedAt : new Date(updatedAt)\n  if (Number.isNaN(value.getTime())) return null\n  return value.toISOString()\n}\n\nfunction titleStatus(value: string | null | undefined): string | undefined {\n  if (!value) return undefined\n  return value\n    .split(/[_\\s-]+/)\n    .filter(Boolean)\n    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))\n    .join(' ')\n}\n\nasync function loadDealWithStage(\n  em: EntityManager,\n  ctx: CustomersToolContext,\n  tenantId: string,\n  dealId: string,\n): Promise<CustomerDeal | null> {\n  const where: Record<string, unknown> = { id: dealId, tenantId, deletedAt: null }\n  if (ctx.organizationId) where.organizationId = ctx.organizationId\n  const deal = await findOneWithDecryption<CustomerDeal>(\n    em,\n    CustomerDeal,\n    where as FilterQuery<CustomerDeal>,\n    undefined,\n    buildScope(ctx, tenantId),\n  )\n  if (!deal || deal.tenantId !== tenantId) return null\n  if (ctx.organizationId && deal.organizationId !== ctx.organizationId) return null\n  return deal\n}\n\nasync function loadPipelineStage(\n  em: EntityManager,\n  ctx: CustomersToolContext,\n  tenantId: string,\n  stageId: string,\n  organizationId: string,\n): Promise<CustomerPipelineStage | null> {\n  return findOneWithDecryption<CustomerPipelineStage>(\n    em,\n    CustomerPipelineStage,\n    {\n      id: stageId,\n      tenantId,\n      organizationId,\n    },\n    undefined,\n    buildScope(ctx, tenantId),\n  )\n}\n\nconst updateDealStageTool: CustomersAiToolDefinition = {\n  name: 'customers.update_deal_stage',\n  displayName: 'Update deal stage',\n  description:\n    'Move a deal to a different pipeline stage (by stage id) or change its top-level status (e.g. \"open\", \"won\", \"lost\"). Mutation tool \u2014 flows through the AI pending-action approval gate.',\n  inputSchema: updateDealStageInput as z.ZodType<unknown>,\n  requiredFeatures: ['customers.deals.manage'],\n  tags: ['write', 'customers'],\n  isMutation: true,\n  loadBeforeRecord: async (rawInput, ctx): Promise<CustomersToolLoadBeforeSingleRecord | null> => {\n    const { tenantId } = assertTenantScope(ctx)\n    const input: UpdateDealStageInput = updateDealStageInput.parse(rawInput)\n    const em = resolveEm(ctx)\n    const deal = await loadDealWithStage(em, ctx, tenantId, input.dealId)\n    if (!deal) return null\n    let afterStatus = deal.status ?? null\n    let afterPipelineStageId = deal.pipelineStageId ?? null\n    let afterPipelineStageLabel = deal.pipelineStage ?? null\n    if (input.toPipelineStageId) {\n      const organizationId = deal.organizationId ?? ctx.organizationId ?? null\n      const stage = organizationId\n        ? await loadPipelineStage(em, ctx, tenantId, input.toPipelineStageId, organizationId)\n        : null\n      afterPipelineStageId = input.toPipelineStageId\n      afterPipelineStageLabel = stage?.label ?? input.toPipelineStageId\n    } else if (input.toStage) {\n      afterStatus = input.toStage\n    }\n    const beforeStatus = deal.status ?? null\n    const beforePipelineStageId = deal.pipelineStageId ?? null\n    const beforePipelineStageLabel = deal.pipelineStage ?? beforePipelineStageId\n    return {\n      recordId: deal.id,\n      entityType: 'customers.deal',\n      recordVersion: recordVersionFromUpdatedAt(deal.updatedAt),\n      before: {\n        status: beforeStatus,\n        pipelineStageId: beforePipelineStageId,\n      },\n      after: {\n        status: afterStatus,\n        pipelineStageId: afterPipelineStageId,\n      },\n      display: {\n        fieldLabels: {\n          status: 'Status',\n          pipelineStageId: 'Pipeline stage',\n        },\n        before: {\n          ...(beforeStatus ? { status: titleStatus(beforeStatus) } : {}),\n          ...(beforePipelineStageLabel ? { pipelineStageId: beforePipelineStageLabel } : {}),\n        },\n        after: {\n          ...(afterStatus ? { status: titleStatus(afterStatus) } : {}),\n          ...(afterPipelineStageLabel ? { pipelineStageId: afterPipelineStageLabel } : {}),\n        },\n      },\n    }\n  },\n  handler: async (rawInput, ctx) => {\n    const { tenantId } = assertTenantScope(ctx)\n    const input: UpdateDealStageInput = updateDealStageInput.parse(rawInput)\n    const em = resolveEm(ctx)\n    const deal = await loadDealWithStage(em, ctx, tenantId, input.dealId)\n    if (!deal) {\n      throw new Error(`Deal \"${input.dealId}\" is not accessible to the caller.`)\n    }\n    const organizationId = deal.organizationId\n    if (!organizationId) {\n      throw new Error(`Deal \"${input.dealId}\" has no organization scope.`)\n    }\n\n    const before = {\n      status: deal.status ?? null,\n      pipelineStage: deal.pipelineStage ?? null,\n      pipelineStageId: deal.pipelineStageId ?? null,\n    }\n\n    const body: Record<string, unknown> = {\n      id: deal.id,\n      tenantId,\n      organizationId,\n    }\n    if (input.toPipelineStageId) {\n      const stage = await loadPipelineStage(em, ctx, tenantId, input.toPipelineStageId, organizationId)\n      if (!stage) {\n        throw new Error('Pipeline stage not found.')\n      }\n      body.pipelineStageId = input.toPipelineStageId\n    } else if (input.toStage) {\n      body.status = input.toStage\n    }\n\n    const runner = createAiApiOperationRunner(ctx as unknown as AiToolExecutionContext)\n    const response = await runner.run({\n      method: 'PUT',\n      path: '/customers/deals',\n      body,\n    })\n    if (!response.success) {\n      throw new Error(response.error ?? `Failed to update deal \"${deal.id}\"`)\n    }\n\n    const after = await loadDealWithStage(em, ctx, tenantId, deal.id)\n    return {\n      recordId: deal.id,\n      commandName: 'customers.deals.update',\n      before,\n      after: after\n        ? {\n            status: after.status ?? null,\n            pipelineStage: after.pipelineStage ?? null,\n            pipelineStageId: after.pipelineStageId ?? null,\n          }\n        : null,\n    }\n  },\n}\n\nexport const dealsAiTools: CustomersAiToolDefinition[] = [listDealsTool, getDealTool, updateDealStageTool]\n\nexport default dealsAiTools\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/customers/ai-tools/people-pack.js

@@ -26,7 +26,7 @@ const listPeopleInput = z.object({
 const listPeopleTool = defineApiBackedAiTool({
   name: "customers.list_people",
   displayName: "List people",
-  description: 'Search / list people (CRM persons) for the caller tenant + organization. Returns { items, total, totalIsCapped, limit, offset }. When totalIsCapped is true, total is a floor ("at least N", render it as "N+"), and pagination is exhausted only when a page returns fewer than limit items \u2014 never when offset reaches total.',
+  description: "Search / list people (CRM persons) for the caller tenant + organization. Returns { items, total, limit, offset }.",
   inputSchema: listPeopleInput,
   requiredFeatures: ["customers.people.view"],
   toOperation: async (input, ctx) => {
@@ -73,9 +73,6 @@ const listPeopleTool = defineApiBackedAiTool({
     return {
       items: rawItems.map((row) => toCustomerListSummary(row)),
       total: typeof data.total === "number" ? data.total : 0,
-      // A capped count reports a floor: phrase the total as "at least N" and
-      // never treat it as proof that pagination is exhausted.
-      totalIsCapped: data.totalIsCapped === true,
       limit,
       offset
     };

package/dist/modules/customers/ai-tools/people-pack.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/customers/ai-tools/people-pack.ts"],
-  "sourcesContent": ["/**\n * `customers.list_people` + `customers.get_person` (Phase 1 WS-C, Step 3.9).\n *\n * Read-only tools scoped to `ctx.tenantId` / `ctx.organizationId` that wrap\n * the existing customers query engine + encryption helpers. Mutation tools\n * are deferred to Step 5.13+ under the pending-action contract.\n *\n * Phase 3a of `.ai/specs/implemented/2026-04-27-ai-tools-api-backed-dry-refactor.md`:\n * `customers.list_people` is now an API-backed wrapper over\n * `GET /api/customers/people`. The `companyId` AI input has no inclusion\n * equivalent on the route (the route exposes `excludeLinkedCompanyId` only)\n * so it is pre-resolved against `CustomerPersonProfile.company` and threaded\n * through the route's `ids` filter.\n *\n * Phase 3c of the same spec migrates `customers.get_person` to a single\n * in-process call to `GET /api/customers/people/<id>?include=...` (the\n * documented aggregate detail route). Tool name, schema, requiredFeatures,\n * and output shape are unchanged.\n */\nimport { z } from 'zod'\nimport { defineApiBackedAiTool } from '@open-mercato/ai-assistant/modules/ai_assistant/lib/api-backed-tool'\nimport {\n  createAiApiOperationRunner,\n  type AiApiOperationRequest,\n  type AiToolExecutionContext,\n} from '@open-mercato/ai-assistant/modules/ai_assistant/lib/ai-api-operation-runner'\nimport { findWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport {\n  CustomerPersonProfile,\n} from '../data/entities'\nimport { assertTenantScope, type CustomersAiToolDefinition, type CustomersToolContext } from './types'\nimport {\n  buildRelatedRecords,\n  buildScope,\n  resolveEm,\n  toCustomerListSummary,\n  toIso,\n  type CustomerRelatedRecords,\n} from './_shared'\n\nconst NIL_UUID = '00000000-0000-0000-0000-000000000000'\n\nconst listPeopleInput = z\n  .object({\n    q: z.string().trim().optional().describe('Optional search text matched against display name / email / phone. Omit or leave empty to list all.'),\n    limit: z.number().int().min(1).max(100).optional().describe('Maximum rows to return (default 50, max 100).'),\n    offset: z.number().int().min(0).optional().describe('Number of rows to skip (default 0).'),\n    tags: z.array(z.string().uuid()).optional().describe('Restrict to persons carrying at least one of these tag ids.'),\n    companyId: z.string().uuid().optional().describe('Restrict to persons linked to the given company entity.'),\n  })\n  .passthrough()\n\ntype ListPeopleInput = z.infer<typeof listPeopleInput>\n\ntype ListPeopleApiItem = {\n  id?: string\n  display_name?: string | null\n  displayName?: string | null\n  primary_email?: string | null\n  primaryEmail?: string | null\n  primary_phone?: string | null\n  primaryPhone?: string | null\n  status?: string | null\n  lifecycle_stage?: string | null\n  lifecycleStage?: string | null\n  source?: string | null\n  owner_user_id?: string | null\n  ownerUserId?: string | null\n  organization_id?: string | null\n  organizationId?: string | null\n  tenant_id?: string | null\n  tenantId?: string | null\n  created_at?: string | null\n  createdAt?: string | null\n}\n\ntype ListPeopleApiResponse = {\n  items?: ListPeopleApiItem[]\n  total?: number\n}\n\ntype ListPeopleOutput = {\n  items: Array<Record<string, unknown>>\n  total: number\n  limit: number\n  offset: number\n}\n\nconst listPeopleTool = defineApiBackedAiTool<ListPeopleInput, ListPeopleApiResponse, ListPeopleOutput>({\n  name: 'customers.list_people',\n  displayName: 'List people',\n  description:\n    'Search / list people (CRM persons) for the caller tenant + organization. Returns { items, total, totalIsCapped, limit, offset }. When totalIsCapped is true, total is a floor (\"at least N\", render it as \"N+\"), and pagination is exhausted only when a page returns fewer than limit items \u2014 never when offset reaches total.',\n  inputSchema: listPeopleInput,\n  requiredFeatures: ['customers.people.view'],\n  toOperation: async (input, ctx) => {\n    const { tenantId } = assertTenantScope(ctx as unknown as CustomersToolContext)\n    const limit = input.limit ?? 50\n    const offset = input.offset ?? 0\n    const page = Math.floor(offset / limit) + 1\n\n    const query: Record<string, string | number | boolean | null | undefined> = {\n      page,\n      pageSize: limit,\n    }\n    if (input.q?.trim()) query.search = input.q.trim()\n    if (input.tags && input.tags.length > 0) query.tagIds = input.tags.join(',')\n\n    if (input.companyId) {\n      const em = resolveEm(ctx)\n      const profiles = await findWithDecryption<CustomerPersonProfile>(\n        em,\n        CustomerPersonProfile,\n        { tenantId, company: input.companyId } as never,\n        undefined,\n        buildScope(ctx, tenantId),\n      )\n      const ids = profiles\n        .map((profile) => {\n          const entity = (profile as { entity?: unknown }).entity\n          if (!entity) return null\n          if (typeof entity === 'string') return entity\n          const candidate = (entity as { id?: unknown }).id\n          return typeof candidate === 'string' ? candidate : null\n        })\n        .filter((value): value is string => typeof value === 'string' && value.length > 0)\n      // Empty match \u2014 feed a non-existent uuid so the route returns\n      // { items: [], total: 0 } without us bypassing the API.\n      query.ids = ids.length ? ids.join(',') : NIL_UUID\n    }\n\n    const operation: AiApiOperationRequest = {\n      method: 'GET',\n      path: '/customers/people',\n      query,\n    }\n    return operation\n  },\n  mapResponse: (response, input) => {\n    const limit = input.limit ?? 50\n    const offset = input.offset ?? 0\n    const data = (response.data ?? {}) as ListPeopleApiResponse\n    const rawItems: ListPeopleApiItem[] = Array.isArray(data.items) ? data.items : []\n    return {\n      items: rawItems.map((row) => toCustomerListSummary(row)),\n      total: typeof data.total === 'number' ? data.total : 0,\n      // A capped count reports a floor: phrase the total as \"at least N\" and\n      // never treat it as proof that pagination is exhausted.\n      totalIsCapped: (data as { totalIsCapped?: boolean }).totalIsCapped === true,\n      limit,\n      offset,\n    }\n  },\n}) as unknown as CustomersAiToolDefinition\n\nconst getPersonInput = z.object({\n  personId: z.string().uuid().describe('Person entity id (UUID).'),\n  includeRelated: z\n    .boolean()\n    .optional()\n    .describe('When true, include notes, activities, deals, addresses, tasks, and tags (each capped at 100).'),\n})\n\ntype GetPersonInput = z.infer<typeof getPersonInput>\n\ntype ApiPersonDetailRow = Record<string, unknown> | null | undefined\n\nconst getPersonTool: CustomersAiToolDefinition = {\n  name: 'customers.get_person',\n  displayName: 'Get person',\n  description:\n    'Fetch a person customer record by id with profile fields and (optionally) notes, activities, deals, addresses, tasks, tags, and custom fields. Returns { found: false } when the record is outside tenant/org scope or missing.',\n  inputSchema: getPersonInput,\n  requiredFeatures: ['customers.people.view'],\n  tags: ['read', 'customers'],\n  handler: async (rawInput, ctx) => {\n    const { tenantId } = assertTenantScope(ctx)\n    const input: GetPersonInput = getPersonInput.parse(rawInput)\n    const includeRelated = !!input.includeRelated\n\n    const operation: AiApiOperationRequest = {\n      method: 'GET',\n      path: `/customers/people/${input.personId}`,\n    }\n    if (includeRelated) {\n      operation.query = { include: 'addresses,comments,activities,interactions,deals,todos' }\n    }\n\n    const runner = createAiApiOperationRunner(ctx as unknown as AiToolExecutionContext)\n    const response = await runner.run<Record<string, unknown>>(operation)\n    if (!response.success) {\n      if (response.statusCode === 404 || response.statusCode === 403) {\n        return { found: false as const, personId: input.personId }\n      }\n      throw new Error(response.error ?? `Failed to fetch person ${input.personId}`)\n    }\n    const data = (response.data ?? {}) as Record<string, unknown>\n    const personRow = (data.person ?? null) as ApiPersonDetailRow\n    if (!personRow) {\n      return { found: false as const, personId: input.personId }\n    }\n    const profileRow = (data.profile ?? null) as ApiPersonDetailRow\n    const customFields = (data.customFields ?? {}) as Record<string, unknown>\n\n    let related: CustomerRelatedRecords | null = null\n    if (includeRelated) {\n      related = buildRelatedRecords(data)\n    }\n\n    return {\n      found: true as const,\n      person: {\n        id: personRow.id,\n        displayName: personRow.displayName ?? null,\n        description: personRow.description ?? null,\n        primaryEmail: personRow.primaryEmail ?? null,\n        primaryPhone: personRow.primaryPhone ?? null,\n        status: personRow.status ?? null,\n        lifecycleStage: personRow.lifecycleStage ?? null,\n        source: personRow.source ?? null,\n        ownerUserId: personRow.ownerUserId ?? null,\n        organizationId: personRow.organizationId ?? null,\n        tenantId: personRow.tenantId ?? null,\n        createdAt: toIso(personRow.createdAt),\n        updatedAt: toIso(personRow.updatedAt),\n      },\n      profile: profileRow\n        ? {\n            id: profileRow.id,\n            firstName: profileRow.firstName ?? null,\n            lastName: profileRow.lastName ?? null,\n            preferredName: profileRow.preferredName ?? null,\n            jobTitle: profileRow.jobTitle ?? null,\n            department: profileRow.department ?? null,\n            seniority: profileRow.seniority ?? null,\n            timezone: profileRow.timezone ?? null,\n            linkedInUrl: profileRow.linkedInUrl ?? null,\n            twitterUrl: profileRow.twitterUrl ?? null,\n            companyEntityId: profileRow.companyEntityId ?? null,\n          }\n        : null,\n      customFields,\n      related,\n    }\n  },\n}\n\nexport const peopleAiTools: CustomersAiToolDefinition[] = [listPeopleTool, getPersonTool]\n\nexport default peopleAiTools\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * `customers.list_people` + `customers.get_person` (Phase 1 WS-C, Step 3.9).\n *\n * Read-only tools scoped to `ctx.tenantId` / `ctx.organizationId` that wrap\n * the existing customers query engine + encryption helpers. Mutation tools\n * are deferred to Step 5.13+ under the pending-action contract.\n *\n * Phase 3a of `.ai/specs/implemented/2026-04-27-ai-tools-api-backed-dry-refactor.md`:\n * `customers.list_people` is now an API-backed wrapper over\n * `GET /api/customers/people`. The `companyId` AI input has no inclusion\n * equivalent on the route (the route exposes `excludeLinkedCompanyId` only)\n * so it is pre-resolved against `CustomerPersonProfile.company` and threaded\n * through the route's `ids` filter.\n *\n * Phase 3c of the same spec migrates `customers.get_person` to a single\n * in-process call to `GET /api/customers/people/<id>?include=...` (the\n * documented aggregate detail route). Tool name, schema, requiredFeatures,\n * and output shape are unchanged.\n */\nimport { z } from 'zod'\nimport { defineApiBackedAiTool } from '@open-mercato/ai-assistant/modules/ai_assistant/lib/api-backed-tool'\nimport {\n  createAiApiOperationRunner,\n  type AiApiOperationRequest,\n  type AiToolExecutionContext,\n} from '@open-mercato/ai-assistant/modules/ai_assistant/lib/ai-api-operation-runner'\nimport { findWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport {\n  CustomerPersonProfile,\n} from '../data/entities'\nimport { assertTenantScope, type CustomersAiToolDefinition, type CustomersToolContext } from './types'\nimport {\n  buildRelatedRecords,\n  buildScope,\n  resolveEm,\n  toCustomerListSummary,\n  toIso,\n  type CustomerRelatedRecords,\n} from './_shared'\n\nconst NIL_UUID = '00000000-0000-0000-0000-000000000000'\n\nconst listPeopleInput = z\n  .object({\n    q: z.string().trim().optional().describe('Optional search text matched against display name / email / phone. Omit or leave empty to list all.'),\n    limit: z.number().int().min(1).max(100).optional().describe('Maximum rows to return (default 50, max 100).'),\n    offset: z.number().int().min(0).optional().describe('Number of rows to skip (default 0).'),\n    tags: z.array(z.string().uuid()).optional().describe('Restrict to persons carrying at least one of these tag ids.'),\n    companyId: z.string().uuid().optional().describe('Restrict to persons linked to the given company entity.'),\n  })\n  .passthrough()\n\ntype ListPeopleInput = z.infer<typeof listPeopleInput>\n\ntype ListPeopleApiItem = {\n  id?: string\n  display_name?: string | null\n  displayName?: string | null\n  primary_email?: string | null\n  primaryEmail?: string | null\n  primary_phone?: string | null\n  primaryPhone?: string | null\n  status?: string | null\n  lifecycle_stage?: string | null\n  lifecycleStage?: string | null\n  source?: string | null\n  owner_user_id?: string | null\n  ownerUserId?: string | null\n  organization_id?: string | null\n  organizationId?: string | null\n  tenant_id?: string | null\n  tenantId?: string | null\n  created_at?: string | null\n  createdAt?: string | null\n}\n\ntype ListPeopleApiResponse = {\n  items?: ListPeopleApiItem[]\n  total?: number\n}\n\ntype ListPeopleOutput = {\n  items: Array<Record<string, unknown>>\n  total: number\n  limit: number\n  offset: number\n}\n\nconst listPeopleTool = defineApiBackedAiTool<ListPeopleInput, ListPeopleApiResponse, ListPeopleOutput>({\n  name: 'customers.list_people',\n  displayName: 'List people',\n  description:\n    'Search / list people (CRM persons) for the caller tenant + organization. Returns { items, total, limit, offset }.',\n  inputSchema: listPeopleInput,\n  requiredFeatures: ['customers.people.view'],\n  toOperation: async (input, ctx) => {\n    const { tenantId } = assertTenantScope(ctx as unknown as CustomersToolContext)\n    const limit = input.limit ?? 50\n    const offset = input.offset ?? 0\n    const page = Math.floor(offset / limit) + 1\n\n    const query: Record<string, string | number | boolean | null | undefined> = {\n      page,\n      pageSize: limit,\n    }\n    if (input.q?.trim()) query.search = input.q.trim()\n    if (input.tags && input.tags.length > 0) query.tagIds = input.tags.join(',')\n\n    if (input.companyId) {\n      const em = resolveEm(ctx)\n      const profiles = await findWithDecryption<CustomerPersonProfile>(\n        em,\n        CustomerPersonProfile,\n        { tenantId, company: input.companyId } as never,\n        undefined,\n        buildScope(ctx, tenantId),\n      )\n      const ids = profiles\n        .map((profile) => {\n          const entity = (profile as { entity?: unknown }).entity\n          if (!entity) return null\n          if (typeof entity === 'string') return entity\n          const candidate = (entity as { id?: unknown }).id\n          return typeof candidate === 'string' ? candidate : null\n        })\n        .filter((value): value is string => typeof value === 'string' && value.length > 0)\n      // Empty match \u2014 feed a non-existent uuid so the route returns\n      // { items: [], total: 0 } without us bypassing the API.\n      query.ids = ids.length ? ids.join(',') : NIL_UUID\n    }\n\n    const operation: AiApiOperationRequest = {\n      method: 'GET',\n      path: '/customers/people',\n      query,\n    }\n    return operation\n  },\n  mapResponse: (response, input) => {\n    const limit = input.limit ?? 50\n    const offset = input.offset ?? 0\n    const data = (response.data ?? {}) as ListPeopleApiResponse\n    const rawItems: ListPeopleApiItem[] = Array.isArray(data.items) ? data.items : []\n    return {\n      items: rawItems.map((row) => toCustomerListSummary(row)),\n      total: typeof data.total === 'number' ? data.total : 0,\n      limit,\n      offset,\n    }\n  },\n}) as unknown as CustomersAiToolDefinition\n\nconst getPersonInput = z.object({\n  personId: z.string().uuid().describe('Person entity id (UUID).'),\n  includeRelated: z\n    .boolean()\n    .optional()\n    .describe('When true, include notes, activities, deals, addresses, tasks, and tags (each capped at 100).'),\n})\n\ntype GetPersonInput = z.infer<typeof getPersonInput>\n\ntype ApiPersonDetailRow = Record<string, unknown> | null | undefined\n\nconst getPersonTool: CustomersAiToolDefinition = {\n  name: 'customers.get_person',\n  displayName: 'Get person',\n  description:\n    'Fetch a person customer record by id with profile fields and (optionally) notes, activities, deals, addresses, tasks, tags, and custom fields. Returns { found: false } when the record is outside tenant/org scope or missing.',\n  inputSchema: getPersonInput,\n  requiredFeatures: ['customers.people.view'],\n  tags: ['read', 'customers'],\n  handler: async (rawInput, ctx) => {\n    const { tenantId } = assertTenantScope(ctx)\n    const input: GetPersonInput = getPersonInput.parse(rawInput)\n    const includeRelated = !!input.includeRelated\n\n    const operation: AiApiOperationRequest = {\n      method: 'GET',\n      path: `/customers/people/${input.personId}`,\n    }\n    if (includeRelated) {\n      operation.query = { include: 'addresses,comments,activities,interactions,deals,todos' }\n    }\n\n    const runner = createAiApiOperationRunner(ctx as unknown as AiToolExecutionContext)\n    const response = await runner.run<Record<string, unknown>>(operation)\n    if (!response.success) {\n      if (response.statusCode === 404 || response.statusCode === 403) {\n        return { found: false as const, personId: input.personId }\n      }\n      throw new Error(response.error ?? `Failed to fetch person ${input.personId}`)\n    }\n    const data = (response.data ?? {}) as Record<string, unknown>\n    const personRow = (data.person ?? null) as ApiPersonDetailRow\n    if (!personRow) {\n      return { found: false as const, personId: input.personId }\n    }\n    const profileRow = (data.profile ?? null) as ApiPersonDetailRow\n    const customFields = (data.customFields ?? {}) as Record<string, unknown>\n\n    let related: CustomerRelatedRecords | null = null\n    if (includeRelated) {\n      related = buildRelatedRecords(data)\n    }\n\n    return {\n      found: true as const,\n      person: {\n        id: personRow.id,\n        displayName: personRow.displayName ?? null,\n        description: personRow.description ?? null,\n        primaryEmail: personRow.primaryEmail ?? null,\n        primaryPhone: personRow.primaryPhone ?? null,\n        status: personRow.status ?? null,\n        lifecycleStage: personRow.lifecycleStage ?? null,\n        source: personRow.source ?? null,\n        ownerUserId: personRow.ownerUserId ?? null,\n        organizationId: personRow.organizationId ?? null,\n        tenantId: personRow.tenantId ?? null,\n        createdAt: toIso(personRow.createdAt),\n        updatedAt: toIso(personRow.updatedAt),\n      },\n      profile: profileRow\n        ? {\n            id: profileRow.id,\n            firstName: profileRow.firstName ?? null,\n            lastName: profileRow.lastName ?? null,\n            preferredName: profileRow.preferredName ?? null,\n            jobTitle: profileRow.jobTitle ?? null,\n            department: profileRow.department ?? null,\n            seniority: profileRow.seniority ?? null,\n            timezone: profileRow.timezone ?? null,\n            linkedInUrl: profileRow.linkedInUrl ?? null,\n            twitterUrl: profileRow.twitterUrl ?? null,\n            companyEntityId: profileRow.companyEntityId ?? null,\n          }\n        : null,\n      customFields,\n      related,\n    }\n  },\n}\n\nexport const peopleAiTools: CustomersAiToolDefinition[] = [listPeopleTool, getPersonTool]\n\nexport default peopleAiTools\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/customers/api/activities/route.js

@@ -180,21 +180,7 @@ function mapLegacyActivity(activity) {
     customValues: null
   };
 }
-async function listCanonicalActivities(em, container, auth, selectedOrganizationId, tenantId, organizationIds, query, options, isUnrestricted) {
-  if (organizationIds && organizationIds.length === 0 && !isUnrestricted) {
-    return {
-      items: [],
-      total: 0,
-      bridgeIds: /* @__PURE__ */ new Set()
-    };
-  }
-  if (organizationIds === null && !isUnrestricted) {
-    return {
-      items: [],
-      total: 0,
-      bridgeIds: /* @__PURE__ */ new Set()
-    };
-  }
+async function listCanonicalActivities(em, container, auth, selectedOrganizationId, tenantId, organizationIds, query, options) {
   const where = {
     tenantId,
     interactionType: { $ne: "task" }
@@ -247,13 +233,7 @@ async function listCanonicalActivities(em, container, auth, selectedOrganization
     bridgeIds: new Set(rows.map((row) => row.id))
   };
 }
-async function listLegacyActivities(em, tenantId, organizationIds, query, options, selectedOrganizationId, isUnrestricted) {
-  if (organizationIds && organizationIds.length === 0 && !isUnrestricted) {
-    return { items: [], total: 0 };
-  }
-  if (organizationIds === null && !isUnrestricted) {
-    return { items: [], total: 0 };
-  }
+async function listLegacyActivities(em, tenantId, organizationIds, query, options, selectedOrganizationId) {
   const where = { tenantId };
   if (organizationIds && organizationIds.length > 0) {
     where.organizationId = { $in: organizationIds };
@@ -289,30 +269,12 @@ async function GET(request) {
       em,
       organizationIds,
       container,
-      selectedOrganizationId,
-      scope
+      selectedOrganizationId
     } = await resolveCustomersRequestContext(request);
     const flags = await resolveCustomerInteractionFeatureFlags(container, auth.tenantId);
     if (!flags.legacyAdapters) {
       return await legacyAdaptersDisabledResponse();
     }
-    const isUnrestricted = auth.isSuperAdmin === true || scope?.allowedIds === null;
-    if (!isUnrestricted && (!organizationIds || organizationIds.length === 0)) {
-      logger.warn("activities.list collapsed organization scope \u2014 returning empty page", {
-        tenantId: auth.tenantId,
-        organizationIds,
-        scope
-      });
-      return withAdapterHeaders(
-        NextResponse.json({
-          items: [],
-          total: 0,
-          page: query.page,
-          pageSize: query.pageSize,
-          totalPages: 1
-        })
-      );
-    }
     const sortDir = query.sortDir ?? "desc";
     const result = flags.unified ? await listCanonicalActivities(
       em,
@@ -321,9 +283,7 @@ async function GET(request) {
       selectedOrganizationId,
       auth.tenantId,
       organizationIds,
-      query,
-      void 0,
-      isUnrestricted
+      query
     ) : await (async () => {
       const windowSize = Math.min(
         MERGED_ACTIVITY_FETCH_CAP,
@@ -337,8 +297,7 @@ async function GET(request) {
           organizationIds,
           windowedQuery,
           { paginate: true },
-          selectedOrganizationId,
-          isUnrestricted
+          selectedOrganizationId
         ),
         listCanonicalActivities(
           em,
@@ -352,8 +311,7 @@ async function GET(request) {
             includeDeleted: true,
             paginate: true,
             source: CUSTOMER_INTERACTION_ACTIVITY_ADAPTER_SOURCE
-          },
-          isUnrestricted
+          }
         )
       ]);
       const merged = sortActivityItems(