@open-mercato/core 0.5.1-develop.3036.f02c281f23 → 0.5.1-develop.3045.b4b3320cc2

package/dist/modules/catalog/ai-tools/authoring-pack.js

@@ -0,0 +1,391 @@
+import { z } from "zod";
+import { findWithDecryption } from "@open-mercato/shared/lib/encryption/find";
+import { Attachment } from "@open-mercato/core/modules/attachments/data/entities";
+import { assertTenantScope } from "./types.js";
+import {
+  buildProductBundle,
+  buildScope,
+  listPriceKindsCore,
+  resolveAttributeSchema,
+  resolveEm
+} from "./_shared.js";
+function toJsonSchema(schema, schemaName) {
+  const json = z.toJSONSchema(schema);
+  return { ...json, title: schemaName };
+}
+async function loadProductContext(ctx, tenantId, productId) {
+  const em = resolveEm(ctx);
+  const result = await buildProductBundle(em, ctx, tenantId, productId);
+  if (!result.found) {
+    return { found: false, productId };
+  }
+  return { found: true, productId, bundle: result };
+}
+function resolvePricingService(ctx) {
+  try {
+    return ctx.container.resolve("catalogPricingService");
+  } catch {
+    return null;
+  }
+}
+const draftDescriptionFromAttributesInput = z.object({
+  productId: z.string().uuid().describe("Catalog product id (UUID)."),
+  tonePreference: z.enum(["neutral", "marketing", "technical", "short"]).optional().describe("Preferred tone for the drafted description (default `neutral`).")
+});
+const draftDescriptionFromAttributesProposal = z.object({
+  description: z.string().describe("Drafted product description the model should author from the attribute bundle."),
+  rationale: z.string().describe("Why the model authored this description (which attributes drove it)."),
+  attributesUsed: z.array(z.string()).describe("Attribute keys the model actually referenced.")
+});
+const DRAFT_DESCRIPTION_FROM_ATTRIBUTES_SCHEMA = "DraftDescriptionFromAttributes";
+const draftDescriptionFromAttributesTool = {
+  name: "catalog.draft_description_from_attributes",
+  displayName: "Draft description from attributes",
+  description: "Structured-output helper for D18: returns the tenant-scoped product bundle (core fields + attributes + media metadata) alongside a JSON-Schema descriptor the surrounding agent turn uses via `runAiAgentObject` to draft a product description. The handler NEVER calls the model itself; it composes the context and the output shape.",
+  inputSchema: draftDescriptionFromAttributesInput,
+  requiredFeatures: ["catalog.products.view"],
+  tags: ["read", "catalog", "authoring", "merchandising"],
+  isMutation: false,
+  handler: async (rawInput, ctx) => {
+    const { tenantId } = assertTenantScope(ctx);
+    const input = draftDescriptionFromAttributesInput.parse(rawInput);
+    const hit = await loadProductContext(ctx, tenantId, input.productId);
+    if (!hit.found) {
+      return { found: false, productId: input.productId };
+    }
+    const tonePreference = input.tonePreference ?? "neutral";
+    return {
+      found: true,
+      proposal: {
+        description: "",
+        rationale: "",
+        attributesUsed: []
+      },
+      context: {
+        product: hit.bundle,
+        tonePreference
+      },
+      outputSchemaDescriptor: {
+        schemaName: DRAFT_DESCRIPTION_FROM_ATTRIBUTES_SCHEMA,
+        jsonSchema: toJsonSchema(draftDescriptionFromAttributesProposal, DRAFT_DESCRIPTION_FROM_ATTRIBUTES_SCHEMA)
+      }
+    };
+  }
+};
+const extractAttributesFromDescriptionInput = z.object({
+  productId: z.string().uuid().describe("Catalog product id (UUID)."),
+  descriptionOverride: z.string().min(1).optional().describe("Optional description text to analyze instead of the product's stored description.")
+});
+const extractAttributesFromDescriptionProposal = z.object({
+  attributes: z.record(z.string(), z.unknown()).describe("Attribute key \u2192 value pairs mapped from the description. Shape matches the resolved attribute schema; server re-validates before any write."),
+  confidence: z.number().min(0).max(1).describe("Model confidence (0..1) in the extracted attribute set as a whole."),
+  unmapped: z.array(z.string()).describe("Description phrases that could not be mapped to any schema attribute.")
+});
+const EXTRACT_ATTRIBUTES_FROM_DESCRIPTION_SCHEMA = "ExtractAttributesFromDescription";
+const extractAttributesFromDescriptionTool = {
+  name: "catalog.extract_attributes_from_description",
+  displayName: "Extract attributes from description",
+  description: "Structured-output helper for D18: returns the product bundle, the resolved attribute schema, and the description text the model should parse. The surrounding agent turn uses `runAiAgentObject` with the emitted JSON-Schema descriptor to produce the extracted attribute map. The `attributes` output shape intentionally uses `additionalProperties: true` because tenant attribute schemas are heterogeneous; any downstream write re-validates each value against the schema authoritatively.",
+  inputSchema: extractAttributesFromDescriptionInput,
+  requiredFeatures: ["catalog.products.view"],
+  tags: ["read", "catalog", "authoring", "merchandising"],
+  isMutation: false,
+  handler: async (rawInput, ctx) => {
+    const { tenantId } = assertTenantScope(ctx);
+    const input = extractAttributesFromDescriptionInput.parse(rawInput);
+    const hit = await loadProductContext(ctx, tenantId, input.productId);
+    if (!hit.found) {
+      return { found: false, productId: input.productId };
+    }
+    const attributeSchema = await resolveAttributeSchema(
+      ctx,
+      tenantId,
+      input.productId,
+      void 0
+    );
+    const description = input.descriptionOverride ?? hit.bundle.product.description ?? "";
+    return {
+      found: true,
+      proposal: {
+        attributes: {},
+        confidence: 0,
+        unmapped: []
+      },
+      context: {
+        product: hit.bundle,
+        attributeSchema,
+        description
+      },
+      outputSchemaDescriptor: {
+        schemaName: EXTRACT_ATTRIBUTES_FROM_DESCRIPTION_SCHEMA,
+        jsonSchema: toJsonSchema(
+          extractAttributesFromDescriptionProposal,
+          EXTRACT_ATTRIBUTES_FROM_DESCRIPTION_SCHEMA
+        )
+      }
+    };
+  }
+};
+const draftDescriptionFromMediaInput = z.object({
+  productId: z.string().uuid().describe("Catalog product id (UUID)."),
+  userUploadedAttachmentIds: z.array(z.string().uuid()).max(20).optional().describe("Additional attachment IDs the user just uploaded. Cross-tenant IDs are dropped with a warning (not surfaced).")
+});
+const draftDescriptionFromMediaProposal = z.object({
+  description: z.string().describe("Drafted description based on the media references."),
+  features: z.array(z.string()).describe("Salient product features the model surfaced from the media."),
+  mediaReferences: z.array(
+    z.object({
+      attachmentId: z.string(),
+      note: z.string().optional()
+    })
+  ).describe("Attachment IDs the model actually used, with an optional note per reference.")
+});
+const DRAFT_DESCRIPTION_FROM_MEDIA_SCHEMA = "DraftDescriptionFromMedia";
+async function loadUserMedia(em, ctx, tenantId, attachmentIds) {
+  if (!attachmentIds.length) return [];
+  const unique = Array.from(new Set(attachmentIds));
+  const where = {
+    tenantId,
+    id: { $in: unique }
+  };
+  if (ctx.organizationId) where.organizationId = ctx.organizationId;
+  const rows = await findWithDecryption(
+    em,
+    Attachment,
+    where,
+    { limit: unique.length },
+    buildScope(ctx, tenantId)
+  );
+  const tenantScoped = rows.filter((row) => (row.tenantId ?? null) === tenantId);
+  for (const dropped of unique) {
+    if (!tenantScoped.find((row) => row.id === dropped)) {
+      console.warn(`[catalog.draft_description_from_media] dropping attachment not in scope: ${dropped}`);
+    }
+  }
+  return tenantScoped.map((row) => ({
+    attachmentId: row.id,
+    fileName: row.fileName,
+    mediaType: row.mimeType ?? null,
+    size: row.fileSize ?? null
+  }));
+}
+const draftDescriptionFromMediaTool = {
+  name: "catalog.draft_description_from_media",
+  displayName: "Draft description from media",
+  description: "Structured-output helper for D18. Returns the product bundle, the product's media metadata, and any tenant-scoped user-uploaded attachment IDs (cross-tenant IDs are dropped with a warning). The handler does NOT fetch attachment bytes \u2014 the Step 3.7 attachment bridge resolves bytes when the surrounding agent turn dispatches this tool. Requires a vision-capable provider to use raw image bytes; OCR-text fallback for non-vision providers already flows through the Step 3.7 bridge.",
+  inputSchema: draftDescriptionFromMediaInput,
+  requiredFeatures: ["catalog.products.view"],
+  tags: ["read", "catalog", "authoring", "merchandising", "media"],
+  isMutation: false,
+  supportsAttachments: true,
+  handler: async (rawInput, ctx) => {
+    const { tenantId } = assertTenantScope(ctx);
+    const input = draftDescriptionFromMediaInput.parse(rawInput);
+    const hit = await loadProductContext(ctx, tenantId, input.productId);
+    if (!hit.found) {
+      return { found: false, productId: input.productId };
+    }
+    const em = resolveEm(ctx);
+    const userMedia = await loadUserMedia(em, ctx, tenantId, input.userUploadedAttachmentIds ?? []);
+    const productMedia = hit.bundle.media.map((entry) => ({
+      attachmentId: entry.attachmentId,
+      fileName: entry.fileName,
+      mediaType: entry.mediaType,
+      altText: entry.altText,
+      sortOrder: entry.sortOrder
+    }));
+    return {
+      found: true,
+      proposal: {
+        description: "",
+        features: [],
+        mediaReferences: []
+      },
+      context: {
+        product: hit.bundle,
+        productMedia,
+        userMedia
+      },
+      outputSchemaDescriptor: {
+        schemaName: DRAFT_DESCRIPTION_FROM_MEDIA_SCHEMA,
+        jsonSchema: toJsonSchema(draftDescriptionFromMediaProposal, DRAFT_DESCRIPTION_FROM_MEDIA_SCHEMA)
+      }
+    };
+  }
+};
+const suggestTitleVariantsInput = z.object({
+  productId: z.string().uuid().describe("Catalog product id (UUID)."),
+  targetStyle: z.enum(["short", "seo", "marketplace"]).describe("Voice/style for the variants (short, seo-optimized, or marketplace-friendly)."),
+  maxVariants: z.number().int().min(1).max(5).optional().describe("Max number of variants to return. Default 3, hard-capped at 5.")
+});
+const suggestTitleVariantsProposal = z.object({
+  variants: z.array(
+    z.object({
+      title: z.string(),
+      style: z.string(),
+      rationale: z.string().optional()
+    })
+  ).describe("Proposed title variants (respect the `maxVariants` bound).")
+});
+const SUGGEST_TITLE_VARIANTS_SCHEMA = "SuggestTitleVariants";
+const suggestTitleVariantsTool = {
+  name: "catalog.suggest_title_variants",
+  displayName: "Suggest title variants",
+  description: "Structured-output helper for D18: returns the product bundle and the target style. The surrounding agent turn uses `runAiAgentObject` to propose `maxVariants` (default 3, capped at 5) title variants matching the style.",
+  inputSchema: suggestTitleVariantsInput,
+  requiredFeatures: ["catalog.products.view"],
+  tags: ["read", "catalog", "authoring", "merchandising"],
+  isMutation: false,
+  handler: async (rawInput, ctx) => {
+    const { tenantId } = assertTenantScope(ctx);
+    const input = suggestTitleVariantsInput.parse(rawInput);
+    const hit = await loadProductContext(ctx, tenantId, input.productId);
+    if (!hit.found) {
+      return { found: false, productId: input.productId };
+    }
+    const maxVariants = Math.min(input.maxVariants ?? 3, 5);
+    return {
+      found: true,
+      proposal: {
+        variants: []
+      },
+      context: {
+        product: hit.bundle,
+        targetStyle: input.targetStyle,
+        maxVariants
+      },
+      outputSchemaDescriptor: {
+        schemaName: SUGGEST_TITLE_VARIANTS_SCHEMA,
+        jsonSchema: toJsonSchema(suggestTitleVariantsProposal, SUGGEST_TITLE_VARIANTS_SCHEMA)
+      }
+    };
+  }
+};
+const suggestPriceAdjustmentInput = z.object({
+  productId: z.string().uuid().describe("Catalog product id (UUID)."),
+  intent: z.string().trim().min(1).describe('Human-readable intent (e.g. "raise price by 10%", "match competitor at 29.99").'),
+  priceKindId: z.string().uuid().optional().describe("Optional price-kind id to target. When omitted, the model picks the most relevant kind from `context.availablePriceKinds`.")
+});
+const suggestPriceAdjustmentProposal = z.object({
+  currentPrice: z.union([
+    z.object({
+      amount: z.number(),
+      currency: z.string(),
+      priceKindId: z.string()
+    }),
+    z.null()
+  ]).describe("Current price on the targeted kind (null if none is defined)."),
+  proposedPrice: z.object({
+    amount: z.number(),
+    currency: z.string(),
+    priceKindId: z.string()
+  }),
+  rationale: z.string(),
+  constraints: z.object({
+    respectedPriceKindScope: z.boolean(),
+    respectedCurrency: z.boolean()
+  })
+});
+const SUGGEST_PRICE_ADJUSTMENT_SCHEMA = "SuggestPriceAdjustment";
+function currentPriceFromBundle(bundle, priceKindId) {
+  const priceRows = bundle.prices.all;
+  if (!priceRows.length) return null;
+  const candidates = priceKindId ? priceRows.filter((row) => row.priceKindId === priceKindId) : priceRows;
+  const pick = candidates[0] ?? null;
+  if (!pick) return null;
+  const rawAmount = pick.unitPriceGross ?? pick.unitPriceNet;
+  const amount = rawAmount === null || rawAmount === void 0 ? null : Number(rawAmount);
+  if (amount === null || !Number.isFinite(amount)) return null;
+  const currency = pick.currencyCode ?? null;
+  const resolvedKind = pick.priceKindId ?? null;
+  if (!currency || !resolvedKind) return null;
+  return { amount, currency, priceKindId: resolvedKind };
+}
+async function currentPriceFromService(ctx, bundle, priceKindId) {
+  const pricingService = resolvePricingService(ctx);
+  if (!pricingService) return "resolver_unavailable";
+  const priceRows = bundle.prices.all;
+  if (!priceRows.length) return null;
+  const candidates = priceKindId ? priceRows.filter((row) => row.priceKindId === priceKindId) : priceRows;
+  if (!candidates.length) return null;
+  try {
+    const pricingContext = { quantity: 1, date: /* @__PURE__ */ new Date() };
+    const resolved = await pricingService.resolvePrice(
+      candidates,
+      pricingContext
+    );
+    if (!resolved) return null;
+    const rawAmount = resolved.unitPriceGross ?? resolved.unitPriceNet;
+    const amount = rawAmount === null || rawAmount === void 0 ? null : Number(rawAmount);
+    if (amount === null || !Number.isFinite(amount)) return null;
+    const currency = resolved.currencyCode ?? null;
+    const resolvedKind = resolved.priceKindId ?? (resolved.priceKind && typeof resolved.priceKind === "object" ? resolved.priceKind.id : resolved.priceKind);
+    if (!currency || !resolvedKind) return null;
+    return { amount, currency, priceKindId: resolvedKind };
+  } catch {
+    return "resolver_unavailable";
+  }
+}
+const suggestPriceAdjustmentTool = {
+  name: "catalog.suggest_price_adjustment",
+  displayName: "Suggest price adjustment",
+  description: "Structured-output helper for D18. Returns the product bundle, the current tenant-resolved price (via `catalogPricingService.selectBestPrice` when available, otherwise a fallback projection from the bundle prices), and the list of available price kinds. The surrounding agent turn uses `runAiAgentObject` to propose a price adjustment. `isMutation: false` is explicit \u2014 this tool NEVER writes; `catalog.update_product` (Step 5.14) recalculates authoritatively on the server before any write.",
+  inputSchema: suggestPriceAdjustmentInput,
+  requiredFeatures: ["catalog.pricing.manage"],
+  tags: ["read", "catalog", "authoring", "merchandising", "pricing"],
+  isMutation: false,
+  handler: async (rawInput, ctx) => {
+    const { tenantId } = assertTenantScope(ctx);
+    const input = suggestPriceAdjustmentInput.parse(rawInput);
+    const hit = await loadProductContext(ctx, tenantId, input.productId);
+    if (!hit.found) {
+      return { found: false, productId: input.productId };
+    }
+    const serviceResult = await currentPriceFromService(ctx, hit.bundle, input.priceKindId);
+    const currentPrice = serviceResult === "resolver_unavailable" ? currentPriceFromBundle(hit.bundle, input.priceKindId) : serviceResult;
+    const priceKindsResult = await listPriceKindsCore(ctx, { limit: 100 }, tenantId);
+    const availablePriceKinds = priceKindsResult.items.map((row) => ({
+      id: row.id,
+      code: row.code,
+      scope: row.organizationId ? "organization" : "tenant"
+    }));
+    return {
+      found: true,
+      proposal: {
+        currentPrice,
+        proposedPrice: {
+          amount: currentPrice?.amount ?? 0,
+          currency: currentPrice?.currency ?? (hit.bundle.product.primaryCurrencyCode ?? "USD"),
+          priceKindId: currentPrice?.priceKindId ?? (input.priceKindId ?? "")
+        },
+        rationale: "",
+        constraints: {
+          respectedPriceKindScope: true,
+          respectedCurrency: true
+        }
+      },
+      context: {
+        product: hit.bundle,
+        intent: input.intent,
+        availablePriceKinds
+      },
+      outputSchemaDescriptor: {
+        schemaName: SUGGEST_PRICE_ADJUSTMENT_SCHEMA,
+        jsonSchema: toJsonSchema(suggestPriceAdjustmentProposal, SUGGEST_PRICE_ADJUSTMENT_SCHEMA)
+      }
+    };
+  }
+};
+const authoringAiTools = [
+  draftDescriptionFromAttributesTool,
+  extractAttributesFromDescriptionTool,
+  draftDescriptionFromMediaTool,
+  suggestTitleVariantsTool,
+  suggestPriceAdjustmentTool
+];
+var authoring_pack_default = authoringAiTools;
+export {
+  authoringAiTools,
+  authoring_pack_default as default
+};
+//# sourceMappingURL=authoring-pack.js.map

package/dist/modules/catalog/ai-tools/authoring-pack.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/catalog/ai-tools/authoring-pack.ts"],
+  "sourcesContent": ["/**\n * D18 catalog AI-authoring tools (Phase 1 WS-C, Step 3.12).\n *\n * Five structured-output helpers the `catalog.merchandising_assistant`\n * agent (Step 4.9) whitelists verbatim. These tools never write to the\n * database and never open a fresh model call from inside their handlers.\n * Instead, each handler assembles the tenant-scoped context the model will\n * need (product bundle, attribute schema, media references) and returns\n * an `{ proposal, context, outputSchemaDescriptor }` contract:\n *\n * - `context`                \u2014 tenant-validated input for the model's\n *                              structured-output step.\n * - `outputSchemaDescriptor` \u2014 a `{ schemaName, jsonSchema }` descriptor\n *                              the agent runtime passes into\n *                              `runAiAgentObject` (Step 3.5) so the SAME\n *                              agent turn that invoked the tool fills the\n *                              `proposal` via structured output.\n * - `proposal`               \u2014 a zod-typed placeholder with the fields the\n *                              model is expected to populate. Handlers\n *                              return empty defaults; the model fills them.\n *\n * This preserves the \"no database writes + no extra model round trip from\n * a tool\" contract from the brief. Any downstream mutation (e.g.\n * `catalog.update_product` in Step 5.14) re-validates the proposal\n * authoritatively on the server before writing.\n *\n * Five tools:\n * - `catalog.draft_description_from_attributes`\n * - `catalog.extract_attributes_from_description`\n * - `catalog.draft_description_from_media`\n * - `catalog.suggest_title_variants`\n * - `catalog.suggest_price_adjustment`\n *\n * Every tool sets `isMutation: false` explicitly (spec \u00A77 line 536 calls\n * this out specifically for `suggest_price_adjustment`; the whole authoring\n * pack mirrors the flag for consistency).\n *\n * Tenant scoping: all lookups route through the shared `_shared.ts`\n * helpers (`buildProductBundle`, `resolveAttributeSchema`,\n * `listPriceKindsCore`) and the shared attachment + product-price readers.\n * Never touches raw `em.find` / `em.findOne`.\n */\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport { z } from 'zod'\nimport { findWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport { Attachment } from '@open-mercato/core/modules/attachments/data/entities'\nimport { E } from '#generated/entities.ids.generated'\nimport { assertTenantScope, type CatalogAiToolDefinition, type CatalogToolContext } from './types'\nimport {\n  buildProductBundle,\n  buildScope,\n  listPriceKindsCore,\n  resolveAttributeSchema,\n  resolveEm,\n  type AttributeSchemaResult,\n  type ProductBundle,\n  type ProductBundleResult,\n} from './_shared'\nimport type { CatalogPricingService } from '../services/catalogPricingService'\nimport type { PriceRow, PricingContext } from '../lib/pricing'\n\n/* -------------------------------------------------------------------------- */\n/*  Shared helpers                                                             */\n/* -------------------------------------------------------------------------- */\n\nfunction toJsonSchema<T>(schema: z.ZodType<T>, schemaName: string): Record<string, unknown> {\n  const json = z.toJSONSchema(schema) as Record<string, unknown>\n  return { ...json, title: schemaName }\n}\n\ntype ProductContextHit = {\n  found: true\n  productId: string\n  bundle: ProductBundle\n}\n\ntype ProductContextMiss = {\n  found: false\n  productId: string\n}\n\nasync function loadProductContext(\n  ctx: CatalogToolContext,\n  tenantId: string,\n  productId: string,\n): Promise<ProductContextHit | ProductContextMiss> {\n  const em = resolveEm(ctx)\n  const result: ProductBundleResult = await buildProductBundle(em, ctx, tenantId, productId)\n  if (!result.found) {\n    return { found: false as const, productId }\n  }\n  return { found: true as const, productId, bundle: result }\n}\n\nfunction resolvePricingService(ctx: CatalogToolContext): CatalogPricingService | null {\n  try {\n    return ctx.container.resolve<CatalogPricingService>('catalogPricingService')\n  } catch {\n    return null\n  }\n}\n\n/* -------------------------------------------------------------------------- */\n/*  catalog.draft_description_from_attributes                                  */\n/* -------------------------------------------------------------------------- */\n\nconst draftDescriptionFromAttributesInput = z.object({\n  productId: z.string().uuid().describe('Catalog product id (UUID).'),\n  tonePreference: z\n    .enum(['neutral', 'marketing', 'technical', 'short'])\n    .optional()\n    .describe('Preferred tone for the drafted description (default `neutral`).'),\n})\n\nconst draftDescriptionFromAttributesProposal = z.object({\n  description: z.string().describe('Drafted product description the model should author from the attribute bundle.'),\n  rationale: z.string().describe('Why the model authored this description (which attributes drove it).'),\n  attributesUsed: z.array(z.string()).describe('Attribute keys the model actually referenced.'),\n})\n\nconst DRAFT_DESCRIPTION_FROM_ATTRIBUTES_SCHEMA = 'DraftDescriptionFromAttributes'\n\nconst draftDescriptionFromAttributesTool: CatalogAiToolDefinition = {\n  name: 'catalog.draft_description_from_attributes',\n  displayName: 'Draft description from attributes',\n  description:\n    'Structured-output helper for D18: returns the tenant-scoped product bundle (core fields + attributes + media metadata) alongside a JSON-Schema descriptor the surrounding agent turn uses via `runAiAgentObject` to draft a product description. The handler NEVER calls the model itself; it composes the context and the output shape.',\n  inputSchema: draftDescriptionFromAttributesInput,\n  requiredFeatures: ['catalog.products.view'],\n  tags: ['read', 'catalog', 'authoring', 'merchandising'],\n  isMutation: false,\n  handler: async (rawInput, ctx) => {\n    const { tenantId } = assertTenantScope(ctx)\n    const input = draftDescriptionFromAttributesInput.parse(rawInput)\n    const hit = await loadProductContext(ctx, tenantId, input.productId)\n    if (!hit.found) {\n      return { found: false as const, productId: input.productId }\n    }\n    const tonePreference = input.tonePreference ?? 'neutral'\n    return {\n      found: true as const,\n      proposal: {\n        description: '',\n        rationale: '',\n        attributesUsed: [] as string[],\n      },\n      context: {\n        product: hit.bundle,\n        tonePreference,\n      },\n      outputSchemaDescriptor: {\n        schemaName: DRAFT_DESCRIPTION_FROM_ATTRIBUTES_SCHEMA,\n        jsonSchema: toJsonSchema(draftDescriptionFromAttributesProposal, DRAFT_DESCRIPTION_FROM_ATTRIBUTES_SCHEMA),\n      },\n    }\n  },\n}\n\n/* -------------------------------------------------------------------------- */\n/*  catalog.extract_attributes_from_description                                */\n/* -------------------------------------------------------------------------- */\n\nconst extractAttributesFromDescriptionInput = z.object({\n  productId: z.string().uuid().describe('Catalog product id (UUID).'),\n  descriptionOverride: z\n    .string()\n    .min(1)\n    .optional()\n    .describe('Optional description text to analyze instead of the product\\'s stored description.'),\n})\n\n// `attributes` is modeled as a free-form `Record<string, unknown>` because\n// the attribute schema is tenant-defined and heterogeneous (enum / numeric /\n// boolean / string-with-unit). `z.record` emits JSON Schema\n// `additionalProperties: {}` which is the intended open-object surface for\n// the model; downstream validation (Step 5.14 `apply_attribute_extraction`)\n// re-checks each value against the resolved schema authoritatively.\nconst extractAttributesFromDescriptionProposal = z.object({\n  attributes: z\n    .record(z.string(), z.unknown())\n    .describe('Attribute key \u2192 value pairs mapped from the description. Shape matches the resolved attribute schema; server re-validates before any write.'),\n  confidence: z\n    .number()\n    .min(0)\n    .max(1)\n    .describe('Model confidence (0..1) in the extracted attribute set as a whole.'),\n  unmapped: z\n    .array(z.string())\n    .describe('Description phrases that could not be mapped to any schema attribute.'),\n})\n\nconst EXTRACT_ATTRIBUTES_FROM_DESCRIPTION_SCHEMA = 'ExtractAttributesFromDescription'\n\nconst extractAttributesFromDescriptionTool: CatalogAiToolDefinition = {\n  name: 'catalog.extract_attributes_from_description',\n  displayName: 'Extract attributes from description',\n  description:\n    'Structured-output helper for D18: returns the product bundle, the resolved attribute schema, and the description text the model should parse. The surrounding agent turn uses `runAiAgentObject` with the emitted JSON-Schema descriptor to produce the extracted attribute map. The `attributes` output shape intentionally uses `additionalProperties: true` because tenant attribute schemas are heterogeneous; any downstream write re-validates each value against the schema authoritatively.',\n  inputSchema: extractAttributesFromDescriptionInput,\n  requiredFeatures: ['catalog.products.view'],\n  tags: ['read', 'catalog', 'authoring', 'merchandising'],\n  isMutation: false,\n  handler: async (rawInput, ctx) => {\n    const { tenantId } = assertTenantScope(ctx)\n    const input = extractAttributesFromDescriptionInput.parse(rawInput)\n    const hit = await loadProductContext(ctx, tenantId, input.productId)\n    if (!hit.found) {\n      return { found: false as const, productId: input.productId }\n    }\n    const attributeSchema: AttributeSchemaResult = await resolveAttributeSchema(\n      ctx,\n      tenantId,\n      input.productId,\n      undefined,\n    )\n    const description = input.descriptionOverride ?? hit.bundle.product.description ?? ''\n    return {\n      found: true as const,\n      proposal: {\n        attributes: {} as Record<string, unknown>,\n        confidence: 0,\n        unmapped: [] as string[],\n      },\n      context: {\n        product: hit.bundle,\n        attributeSchema,\n        description,\n      },\n      outputSchemaDescriptor: {\n        schemaName: EXTRACT_ATTRIBUTES_FROM_DESCRIPTION_SCHEMA,\n        jsonSchema: toJsonSchema(\n          extractAttributesFromDescriptionProposal,\n          EXTRACT_ATTRIBUTES_FROM_DESCRIPTION_SCHEMA,\n        ),\n      },\n    }\n  },\n}\n\n/* -------------------------------------------------------------------------- */\n/*  catalog.draft_description_from_media                                       */\n/* -------------------------------------------------------------------------- */\n\nconst draftDescriptionFromMediaInput = z.object({\n  productId: z.string().uuid().describe('Catalog product id (UUID).'),\n  userUploadedAttachmentIds: z\n    .array(z.string().uuid())\n    .max(20)\n    .optional()\n    .describe('Additional attachment IDs the user just uploaded. Cross-tenant IDs are dropped with a warning (not surfaced).'),\n})\n\nconst draftDescriptionFromMediaProposal = z.object({\n  description: z.string().describe('Drafted description based on the media references.'),\n  features: z.array(z.string()).describe('Salient product features the model surfaced from the media.'),\n  mediaReferences: z\n    .array(\n      z.object({\n        attachmentId: z.string(),\n        note: z.string().optional(),\n      }),\n    )\n    .describe('Attachment IDs the model actually used, with an optional note per reference.'),\n})\n\nconst DRAFT_DESCRIPTION_FROM_MEDIA_SCHEMA = 'DraftDescriptionFromMedia'\n\ntype UserMediaEntry = {\n  attachmentId: string\n  fileName: string\n  mediaType: string | null\n  size: number | null\n}\n\nasync function loadUserMedia(\n  em: EntityManager,\n  ctx: CatalogToolContext,\n  tenantId: string,\n  attachmentIds: string[],\n): Promise<UserMediaEntry[]> {\n  if (!attachmentIds.length) return []\n  const unique = Array.from(new Set(attachmentIds))\n  const where: Record<string, unknown> = {\n    tenantId,\n    id: { $in: unique },\n  }\n  if (ctx.organizationId) where.organizationId = ctx.organizationId\n  const rows = await findWithDecryption<Attachment>(\n    em,\n    Attachment,\n    where as any,\n    { limit: unique.length } as any,\n    buildScope(ctx, tenantId),\n  )\n  const tenantScoped = rows.filter((row) => (row.tenantId ?? null) === tenantId)\n  for (const dropped of unique) {\n    if (!tenantScoped.find((row) => row.id === dropped)) {\n      console.warn(`[catalog.draft_description_from_media] dropping attachment not in scope: ${dropped}`)\n    }\n  }\n  return tenantScoped.map((row) => ({\n    attachmentId: row.id,\n    fileName: row.fileName,\n    mediaType: row.mimeType ?? null,\n    size: row.fileSize ?? null,\n  }))\n}\n\nconst draftDescriptionFromMediaTool: CatalogAiToolDefinition = {\n  name: 'catalog.draft_description_from_media',\n  displayName: 'Draft description from media',\n  description:\n    'Structured-output helper for D18. Returns the product bundle, the product\\'s media metadata, and any tenant-scoped user-uploaded attachment IDs (cross-tenant IDs are dropped with a warning). The handler does NOT fetch attachment bytes \u2014 the Step 3.7 attachment bridge resolves bytes when the surrounding agent turn dispatches this tool. Requires a vision-capable provider to use raw image bytes; OCR-text fallback for non-vision providers already flows through the Step 3.7 bridge.',\n  inputSchema: draftDescriptionFromMediaInput,\n  requiredFeatures: ['catalog.products.view'],\n  tags: ['read', 'catalog', 'authoring', 'merchandising', 'media'],\n  isMutation: false,\n  supportsAttachments: true,\n  handler: async (rawInput, ctx) => {\n    const { tenantId } = assertTenantScope(ctx)\n    const input = draftDescriptionFromMediaInput.parse(rawInput)\n    const hit = await loadProductContext(ctx, tenantId, input.productId)\n    if (!hit.found) {\n      return { found: false as const, productId: input.productId }\n    }\n    const em = resolveEm(ctx)\n    const userMedia = await loadUserMedia(em, ctx, tenantId, input.userUploadedAttachmentIds ?? [])\n    const productMedia = hit.bundle.media.map((entry) => ({\n      attachmentId: entry.attachmentId,\n      fileName: entry.fileName,\n      mediaType: entry.mediaType,\n      altText: entry.altText,\n      sortOrder: entry.sortOrder,\n    }))\n    return {\n      found: true as const,\n      proposal: {\n        description: '',\n        features: [] as string[],\n        mediaReferences: [] as Array<{ attachmentId: string; note?: string }>,\n      },\n      context: {\n        product: hit.bundle,\n        productMedia,\n        userMedia,\n      },\n      outputSchemaDescriptor: {\n        schemaName: DRAFT_DESCRIPTION_FROM_MEDIA_SCHEMA,\n        jsonSchema: toJsonSchema(draftDescriptionFromMediaProposal, DRAFT_DESCRIPTION_FROM_MEDIA_SCHEMA),\n      },\n    }\n  },\n}\n\n/* -------------------------------------------------------------------------- */\n/*  catalog.suggest_title_variants                                             */\n/* -------------------------------------------------------------------------- */\n\nconst suggestTitleVariantsInput = z.object({\n  productId: z.string().uuid().describe('Catalog product id (UUID).'),\n  targetStyle: z\n    .enum(['short', 'seo', 'marketplace'])\n    .describe('Voice/style for the variants (short, seo-optimized, or marketplace-friendly).'),\n  maxVariants: z\n    .number()\n    .int()\n    .min(1)\n    .max(5)\n    .optional()\n    .describe('Max number of variants to return. Default 3, hard-capped at 5.'),\n})\n\nconst suggestTitleVariantsProposal = z.object({\n  variants: z\n    .array(\n      z.object({\n        title: z.string(),\n        style: z.string(),\n        rationale: z.string().optional(),\n      }),\n    )\n    .describe('Proposed title variants (respect the `maxVariants` bound).'),\n})\n\nconst SUGGEST_TITLE_VARIANTS_SCHEMA = 'SuggestTitleVariants'\n\nconst suggestTitleVariantsTool: CatalogAiToolDefinition = {\n  name: 'catalog.suggest_title_variants',\n  displayName: 'Suggest title variants',\n  description:\n    'Structured-output helper for D18: returns the product bundle and the target style. The surrounding agent turn uses `runAiAgentObject` to propose `maxVariants` (default 3, capped at 5) title variants matching the style.',\n  inputSchema: suggestTitleVariantsInput,\n  requiredFeatures: ['catalog.products.view'],\n  tags: ['read', 'catalog', 'authoring', 'merchandising'],\n  isMutation: false,\n  handler: async (rawInput, ctx) => {\n    const { tenantId } = assertTenantScope(ctx)\n    const input = suggestTitleVariantsInput.parse(rawInput)\n    const hit = await loadProductContext(ctx, tenantId, input.productId)\n    if (!hit.found) {\n      return { found: false as const, productId: input.productId }\n    }\n    const maxVariants = Math.min(input.maxVariants ?? 3, 5)\n    return {\n      found: true as const,\n      proposal: {\n        variants: [] as Array<{ title: string; style: string; rationale?: string }>,\n      },\n      context: {\n        product: hit.bundle,\n        targetStyle: input.targetStyle,\n        maxVariants,\n      },\n      outputSchemaDescriptor: {\n        schemaName: SUGGEST_TITLE_VARIANTS_SCHEMA,\n        jsonSchema: toJsonSchema(suggestTitleVariantsProposal, SUGGEST_TITLE_VARIANTS_SCHEMA),\n      },\n    }\n  },\n}\n\n/* -------------------------------------------------------------------------- */\n/*  catalog.suggest_price_adjustment                                           */\n/* -------------------------------------------------------------------------- */\n\nconst suggestPriceAdjustmentInput = z.object({\n  productId: z.string().uuid().describe('Catalog product id (UUID).'),\n  intent: z\n    .string()\n    .trim()\n    .min(1)\n    .describe('Human-readable intent (e.g. \"raise price by 10%\", \"match competitor at 29.99\").'),\n  priceKindId: z\n    .string()\n    .uuid()\n    .optional()\n    .describe('Optional price-kind id to target. When omitted, the model picks the most relevant kind from `context.availablePriceKinds`.'),\n})\n\nconst suggestPriceAdjustmentProposal = z.object({\n  currentPrice: z\n    .union([\n      z.object({\n        amount: z.number(),\n        currency: z.string(),\n        priceKindId: z.string(),\n      }),\n      z.null(),\n    ])\n    .describe('Current price on the targeted kind (null if none is defined).'),\n  proposedPrice: z.object({\n    amount: z.number(),\n    currency: z.string(),\n    priceKindId: z.string(),\n  }),\n  rationale: z.string(),\n  constraints: z.object({\n    respectedPriceKindScope: z.boolean(),\n    respectedCurrency: z.boolean(),\n  }),\n})\n\nconst SUGGEST_PRICE_ADJUSTMENT_SCHEMA = 'SuggestPriceAdjustment'\n\ntype ResolvedCurrentPrice = {\n  amount: number\n  currency: string\n  priceKindId: string\n} | null\n\nfunction currentPriceFromBundle(\n  bundle: ProductBundle,\n  priceKindId?: string,\n): ResolvedCurrentPrice {\n  const priceRows = bundle.prices.all as Array<Record<string, unknown>>\n  if (!priceRows.length) return null\n  const candidates = priceKindId\n    ? priceRows.filter((row) => row.priceKindId === priceKindId)\n    : priceRows\n  const pick = candidates[0] ?? null\n  if (!pick) return null\n  const rawAmount = (pick.unitPriceGross ?? pick.unitPriceNet) as string | null | undefined\n  const amount = rawAmount === null || rawAmount === undefined ? null : Number(rawAmount)\n  if (amount === null || !Number.isFinite(amount)) return null\n  const currency = (pick.currencyCode as string | null) ?? null\n  const resolvedKind = (pick.priceKindId as string | null) ?? null\n  if (!currency || !resolvedKind) return null\n  return { amount, currency, priceKindId: resolvedKind }\n}\n\nasync function currentPriceFromService(\n  ctx: CatalogToolContext,\n  bundle: ProductBundle,\n  priceKindId?: string,\n): Promise<ResolvedCurrentPrice | 'resolver_unavailable'> {\n  const pricingService = resolvePricingService(ctx)\n  if (!pricingService) return 'resolver_unavailable'\n  const priceRows = bundle.prices.all as Array<Record<string, unknown>>\n  if (!priceRows.length) return null\n  const candidates = priceKindId\n    ? priceRows.filter((row) => row.priceKindId === priceKindId)\n    : priceRows\n  if (!candidates.length) return null\n  try {\n    const pricingContext: PricingContext = { quantity: 1, date: new Date() }\n    const resolved = await pricingService.resolvePrice(\n      candidates as unknown as PriceRow[],\n      pricingContext,\n    )\n    if (!resolved) return null\n    const rawAmount = ((resolved as any).unitPriceGross ?? (resolved as any).unitPriceNet) as\n      | string\n      | number\n      | null\n      | undefined\n    const amount = rawAmount === null || rawAmount === undefined ? null : Number(rawAmount)\n    if (amount === null || !Number.isFinite(amount)) return null\n    const currency = ((resolved as any).currencyCode as string | null) ?? null\n    const resolvedKind = ((resolved as any).priceKindId\n      ?? ((resolved as any).priceKind && typeof (resolved as any).priceKind === 'object'\n        ? (resolved as any).priceKind.id\n        : (resolved as any).priceKind)) as string | null | undefined\n    if (!currency || !resolvedKind) return null\n    return { amount, currency, priceKindId: resolvedKind }\n  } catch {\n    // The pricing service may throw for reasons beyond our control (config,\n    // resolver chain error). We fall back to the bundle view rather than\n    // bubbling the error out of a read-only tool.\n    return 'resolver_unavailable'\n  }\n}\n\nconst suggestPriceAdjustmentTool: CatalogAiToolDefinition = {\n  name: 'catalog.suggest_price_adjustment',\n  displayName: 'Suggest price adjustment',\n  description:\n    'Structured-output helper for D18. Returns the product bundle, the current tenant-resolved price (via `catalogPricingService.selectBestPrice` when available, otherwise a fallback projection from the bundle prices), and the list of available price kinds. The surrounding agent turn uses `runAiAgentObject` to propose a price adjustment. `isMutation: false` is explicit \u2014 this tool NEVER writes; `catalog.update_product` (Step 5.14) recalculates authoritatively on the server before any write.',\n  inputSchema: suggestPriceAdjustmentInput,\n  requiredFeatures: ['catalog.pricing.manage'],\n  tags: ['read', 'catalog', 'authoring', 'merchandising', 'pricing'],\n  isMutation: false,\n  handler: async (rawInput, ctx) => {\n    const { tenantId } = assertTenantScope(ctx)\n    const input = suggestPriceAdjustmentInput.parse(rawInput)\n    const hit = await loadProductContext(ctx, tenantId, input.productId)\n    if (!hit.found) {\n      return { found: false as const, productId: input.productId }\n    }\n    const serviceResult = await currentPriceFromService(ctx, hit.bundle, input.priceKindId)\n    const currentPrice: ResolvedCurrentPrice =\n      serviceResult === 'resolver_unavailable'\n        ? currentPriceFromBundle(hit.bundle, input.priceKindId)\n        : serviceResult\n    const priceKindsResult = await listPriceKindsCore(ctx, { limit: 100 }, tenantId)\n    const availablePriceKinds = priceKindsResult.items.map((row) => ({\n      id: row.id,\n      code: row.code,\n      scope: row.organizationId ? ('organization' as const) : ('tenant' as const),\n    }))\n    return {\n      found: true as const,\n      proposal: {\n        currentPrice,\n        proposedPrice: {\n          amount: currentPrice?.amount ?? 0,\n          currency: currentPrice?.currency ?? (hit.bundle.product.primaryCurrencyCode ?? 'USD'),\n          priceKindId: currentPrice?.priceKindId ?? (input.priceKindId ?? ''),\n        },\n        rationale: '',\n        constraints: {\n          respectedPriceKindScope: true,\n          respectedCurrency: true,\n        },\n      },\n      context: {\n        product: hit.bundle,\n        intent: input.intent,\n        availablePriceKinds,\n      },\n      outputSchemaDescriptor: {\n        schemaName: SUGGEST_PRICE_ADJUSTMENT_SCHEMA,\n        jsonSchema: toJsonSchema(suggestPriceAdjustmentProposal, SUGGEST_PRICE_ADJUSTMENT_SCHEMA),\n      },\n    }\n  },\n}\n\n/* -------------------------------------------------------------------------- */\n/*  Export                                                                     */\n/* -------------------------------------------------------------------------- */\n\nexport const authoringAiTools: CatalogAiToolDefinition[] = [\n  draftDescriptionFromAttributesTool,\n  extractAttributesFromDescriptionTool,\n  draftDescriptionFromMediaTool,\n  suggestTitleVariantsTool,\n  suggestPriceAdjustmentTool,\n]\n\nexport default authoringAiTools\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/catalog/ai-tools/categories-pack.js

@@ -0,0 +1,167 @@
+import { z } from "zod";
+import { findOneWithDecryption, findWithDecryption } from "@open-mercato/shared/lib/encryption/find";
+import { loadCustomFieldValues } from "@open-mercato/shared/lib/crud/custom-fields";
+import { E } from "../../../generated/entities.ids.generated.js";
+import { CatalogProductCategory } from "../data/entities.js";
+import { assertTenantScope } from "./types.js";
+function resolveEm(ctx) {
+  return ctx.container.resolve("em");
+}
+function buildScope(ctx, tenantId) {
+  return { tenantId, organizationId: ctx.organizationId };
+}
+const listCategoriesInput = z.object({
+  parentId: z.union([z.string().uuid(), z.null()]).optional().describe("Parent category id; pass `null` to list root nodes. Omit to list every category in scope."),
+  limit: z.number().int().min(1).max(100).optional().describe("Max rows (default 50, max 100)."),
+  offset: z.number().int().min(0).optional().describe("Rows to skip (default 0)."),
+  includeArchived: z.boolean().optional().describe("When true, include soft-deleted categories. Defaults to active-only.")
+}).passthrough();
+const listCategoriesTool = {
+  name: "catalog.list_categories",
+  displayName: "List categories",
+  description: "List catalog categories scoped to tenant + organization. Use `parentId: null` to list roots or a specific uuid to fetch direct children.",
+  inputSchema: listCategoriesInput,
+  requiredFeatures: ["catalog.categories.view"],
+  tags: ["read", "catalog"],
+  handler: async (rawInput, ctx) => {
+    const { tenantId } = assertTenantScope(ctx);
+    const input = listCategoriesInput.parse(rawInput);
+    const em = resolveEm(ctx);
+    const limit = input.limit ?? 50;
+    const offset = input.offset ?? 0;
+    const where = { tenantId };
+    if (ctx.organizationId) where.organizationId = ctx.organizationId;
+    if (!input.includeArchived) where.deletedAt = null;
+    if ("parentId" in input) {
+      where.parentId = input.parentId ?? null;
+    }
+    const [rows, total] = await Promise.all([
+      findWithDecryption(
+        em,
+        CatalogProductCategory,
+        where,
+        { limit, offset, orderBy: { depth: "asc", name: "asc" } },
+        buildScope(ctx, tenantId)
+      ),
+      em.count(CatalogProductCategory, where)
+    ]);
+    const filtered = rows.filter((row) => row.tenantId === tenantId);
+    return {
+      items: filtered.map((row) => ({
+        id: row.id,
+        name: row.name,
+        slug: row.slug ?? null,
+        description: row.description ?? null,
+        parentId: row.parentId ?? null,
+        rootId: row.rootId ?? null,
+        treePath: row.treePath ?? null,
+        depth: row.depth,
+        childIds: Array.isArray(row.childIds) ? row.childIds : [],
+        isActive: !!row.isActive,
+        organizationId: row.organizationId ?? null,
+        tenantId: row.tenantId ?? null,
+        createdAt: row.createdAt ? new Date(row.createdAt).toISOString() : null
+      })),
+      total,
+      limit,
+      offset
+    };
+  }
+};
+const getCategoryInput = z.object({
+  categoryId: z.string().uuid().describe("Category id (UUID)."),
+  includeRelated: z.boolean().optional().describe(
+    "When true, include direct children (capped at 100) and inherited ancestor refs. Custom fields are always included."
+  )
+});
+const getCategoryTool = {
+  name: "catalog.get_category",
+  displayName: "Get category",
+  description: "Fetch a catalog category by id with core fields and (optionally) children + ancestor inheritance + custom fields. Returns { found: false } when missing or cross-tenant.",
+  inputSchema: getCategoryInput,
+  requiredFeatures: ["catalog.categories.view"],
+  tags: ["read", "catalog"],
+  handler: async (rawInput, ctx) => {
+    const { tenantId } = assertTenantScope(ctx);
+    const input = getCategoryInput.parse(rawInput);
+    const em = resolveEm(ctx);
+    const where = {
+      id: input.categoryId,
+      tenantId,
+      deletedAt: null
+    };
+    if (ctx.organizationId) where.organizationId = ctx.organizationId;
+    const category = await findOneWithDecryption(
+      em,
+      CatalogProductCategory,
+      where,
+      void 0,
+      buildScope(ctx, tenantId)
+    );
+    if (!category || category.tenantId !== tenantId) {
+      return { found: false, categoryId: input.categoryId };
+    }
+    const customFieldValues = await loadCustomFieldValues({
+      em,
+      entityId: E.catalog.catalog_product_category,
+      recordIds: [category.id],
+      tenantIdByRecord: { [category.id]: category.tenantId ?? null },
+      organizationIdByRecord: { [category.id]: category.organizationId ?? null },
+      tenantFallbacks: [category.tenantId ?? tenantId].filter((value) => !!value)
+    });
+    const customFields = customFieldValues[category.id] ?? {};
+    let related = null;
+    if (input.includeRelated) {
+      const scope = buildScope(ctx, tenantId);
+      const children = await findWithDecryption(
+        em,
+        CatalogProductCategory,
+        { tenantId, parentId: category.id, deletedAt: null },
+        { limit: 100, orderBy: { name: "asc" } },
+        scope
+      );
+      related = {
+        children: children.filter((row) => row.tenantId === tenantId).map((row) => ({
+          id: row.id,
+          name: row.name,
+          slug: row.slug ?? null,
+          depth: row.depth,
+          isActive: !!row.isActive
+        })),
+        ancestorIds: Array.isArray(category.ancestorIds) ? [...category.ancestorIds] : [],
+        descendantIds: Array.isArray(category.descendantIds) ? [...category.descendantIds] : []
+      };
+    }
+    return {
+      found: true,
+      category: {
+        id: category.id,
+        name: category.name,
+        slug: category.slug ?? null,
+        description: category.description ?? null,
+        parentId: category.parentId ?? null,
+        rootId: category.rootId ?? null,
+        treePath: category.treePath ?? null,
+        depth: category.depth,
+        childIds: Array.isArray(category.childIds) ? [...category.childIds] : [],
+        ancestorIds: Array.isArray(category.ancestorIds) ? [...category.ancestorIds] : [],
+        descendantIds: Array.isArray(category.descendantIds) ? [...category.descendantIds] : [],
+        metadata: category.metadata ?? null,
+        isActive: !!category.isActive,
+        organizationId: category.organizationId ?? null,
+        tenantId: category.tenantId ?? null,
+        createdAt: category.createdAt ? new Date(category.createdAt).toISOString() : null,
+        updatedAt: category.updatedAt ? new Date(category.updatedAt).toISOString() : null
+      },
+      customFields,
+      related
+    };
+  }
+};
+const categoriesAiTools = [listCategoriesTool, getCategoryTool];
+var categories_pack_default = categoriesAiTools;
+export {
+  categoriesAiTools,
+  categories_pack_default as default
+};
+//# sourceMappingURL=categories-pack.js.map