@cesteral/msads-mcp 1.1.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (72) hide show
  1. package/dist/cesteral-manifest.json +87 -3
  2. package/dist/mcp-server/server.d.ts.map +1 -1
  3. package/dist/mcp-server/server.js +2 -1
  4. package/dist/mcp-server/server.js.map +1 -1
  5. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +42 -1
  6. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -1
  7. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +89 -1
  8. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -1
  9. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +42 -1
  10. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -1
  11. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +85 -0
  12. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -1
  13. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +42 -1
  14. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -1
  15. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +96 -1
  16. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -1
  17. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +42 -1
  18. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -1
  19. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +101 -1
  20. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -1
  21. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +4 -4
  22. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +46 -1
  23. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -1
  24. package/dist/mcp-server/tools/definitions/create-entity.tool.js +82 -1
  25. package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -1
  26. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts +54 -13
  27. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts.map +1 -1
  28. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js +109 -2
  29. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js.map +1 -1
  30. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +48 -1
  31. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -1
  32. package/dist/mcp-server/tools/definitions/delete-entity.tool.js +123 -4
  33. package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -1
  34. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts +48 -7
  35. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts.map +1 -1
  36. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js +75 -4
  37. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js.map +1 -1
  38. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +8 -8
  39. package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts +48 -7
  40. package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts.map +1 -1
  41. package/dist/mcp-server/tools/definitions/import-from-google.tool.js +63 -2
  42. package/dist/mcp-server/tools/definitions/import-from-google.tool.js.map +1 -1
  43. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts +48 -7
  44. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts.map +1 -1
  45. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js +63 -2
  46. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js.map +1 -1
  47. package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts +52 -11
  48. package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts.map +1 -1
  49. package/dist/mcp-server/tools/definitions/manage-criterions.tool.js +64 -2
  50. package/dist/mcp-server/tools/definitions/manage-criterions.tool.js.map +1 -1
  51. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +52 -7
  52. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -1
  53. package/dist/mcp-server/tools/definitions/submit-report.tool.js +96 -2
  54. package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -1
  55. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +26 -1608
  56. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -1
  57. package/dist/mcp-server/tools/definitions/update-entity.tool.js +2 -0
  58. package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -1
  59. package/dist/mcp-server/tools/utils/dry-run.d.ts +6 -0
  60. package/dist/mcp-server/tools/utils/dry-run.d.ts.map +1 -1
  61. package/dist/mcp-server/tools/utils/dry-run.js +27 -0
  62. package/dist/mcp-server/tools/utils/dry-run.js.map +1 -1
  63. package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -1
  64. package/dist/mcp-server/transports/streamable-http-transport.js +1 -0
  65. package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -1
  66. package/dist/testkit/fixtures/index.d.ts +4 -0
  67. package/dist/testkit/fixtures/index.d.ts.map +1 -1
  68. package/dist/testkit/fixtures/index.js +110 -0
  69. package/dist/testkit/fixtures/index.js.map +1 -1
  70. package/dist/testkit/types.d.ts +2 -1
  71. package/dist/testkit/types.d.ts.map +1 -1
  72. package/package.json +2 -2
@@ -1,9 +1,65 @@
1
1
  {
2
2
  "manifestVersion": 1,
3
3
  "packageName": "@cesteral/msads-mcp",
4
- "packageVersion": "1.1.0",
5
- "generatedAt": "2026-05-21T08:42:55.945Z",
4
+ "packageVersion": "1.3.0",
5
+ "generatedAt": "2026-06-10T15:08:45.537Z",
6
6
  "tools": [
7
+ {
8
+ "toolName": "msads_adjust_bids",
9
+ "contractPlatformSlug": "msads",
10
+ "contractToolSlug": "adjust_bids",
11
+ "schemaVersion": "1",
12
+ "definitionHash": "3ba3db804917ec12b5e8ec8d6a38ba5c17c28b3541427d09e3aaed6a402ca1c9"
13
+ },
14
+ {
15
+ "toolName": "msads_bulk_create_entities",
16
+ "contractPlatformSlug": "msads",
17
+ "contractToolSlug": "bulk_create_entities",
18
+ "schemaVersion": "1",
19
+ "definitionHash": "6c25e75303302b9eb2eeabac36718df1115e25684f17fe33897d84acf6e48fd5"
20
+ },
21
+ {
22
+ "toolName": "msads_bulk_update_entities",
23
+ "contractPlatformSlug": "msads",
24
+ "contractToolSlug": "bulk_update_entities",
25
+ "schemaVersion": "1",
26
+ "definitionHash": "fbc75cd7c54e6527a23552b5c3dda264547d9913c633aca7441a749807e06d3f"
27
+ },
28
+ {
29
+ "toolName": "msads_bulk_update_status",
30
+ "contractPlatformSlug": "msads",
31
+ "contractToolSlug": "bulk_update_status",
32
+ "schemaVersion": "1",
33
+ "definitionHash": "cc7ce7eff6bee55114f089a1218a657e9f419e5fb4f94df97158dc4ed85ba424"
34
+ },
35
+ {
36
+ "toolName": "msads_create_entity",
37
+ "contractPlatformSlug": "msads",
38
+ "contractToolSlug": "create_entity",
39
+ "schemaVersion": "1",
40
+ "definitionHash": "897fc5c2ae990d130f448c7b4943630292e40f19f42af8584809e9d40920f276"
41
+ },
42
+ {
43
+ "toolName": "msads_create_report_schedule",
44
+ "contractPlatformSlug": "msads",
45
+ "contractToolSlug": "create_report_schedule",
46
+ "schemaVersion": "1",
47
+ "definitionHash": "c6718a7bc11ae487e3cae66f109083cf40d62110092a7d932d2f566a057ede37"
48
+ },
49
+ {
50
+ "toolName": "msads_delete_entity",
51
+ "contractPlatformSlug": "msads",
52
+ "contractToolSlug": "delete_entity",
53
+ "schemaVersion": "1",
54
+ "definitionHash": "a6837fe5c61a9668faa34b0c9486ac50160923aecc6ce790531d980cfeb901df"
55
+ },
56
+ {
57
+ "toolName": "msads_delete_report_schedule",
58
+ "contractPlatformSlug": "msads",
59
+ "contractToolSlug": "delete_report_schedule",
60
+ "schemaVersion": "1",
61
+ "definitionHash": "86f6cb79e6c879eb4f8db7d6424e536955235a2d22ce2d5fdaaece04d0602733"
62
+ },
7
63
  {
8
64
  "toolName": "msads_get_entity",
9
65
  "contractPlatformSlug": "msads",
@@ -11,12 +67,40 @@
11
67
  "schemaVersion": "1",
12
68
  "definitionHash": "d33960e312ffd4b7074c60ebf22ab650580fbc53c8e974620aa451a4ba5832f0"
13
69
  },
70
+ {
71
+ "toolName": "msads_import_from_google",
72
+ "contractPlatformSlug": "msads",
73
+ "contractToolSlug": "import_from_google",
74
+ "schemaVersion": "1",
75
+ "definitionHash": "329db18cd254ae572ebdf490e2c10018312be87981b480dc4b29fb2280b4338c"
76
+ },
77
+ {
78
+ "toolName": "msads_manage_ad_extensions",
79
+ "contractPlatformSlug": "msads",
80
+ "contractToolSlug": "manage_ad_extensions",
81
+ "schemaVersion": "1",
82
+ "definitionHash": "801b382e25185dfbd49da012382b794055caab138bd0137a8b725b65888143fd"
83
+ },
84
+ {
85
+ "toolName": "msads_manage_criterions",
86
+ "contractPlatformSlug": "msads",
87
+ "contractToolSlug": "manage_criterions",
88
+ "schemaVersion": "1",
89
+ "definitionHash": "80ea41287556649e14f26c883b544e024b1010b6682f1c608b134ee441b75545"
90
+ },
91
+ {
92
+ "toolName": "msads_submit_report",
93
+ "contractPlatformSlug": "msads",
94
+ "contractToolSlug": "submit_report",
95
+ "schemaVersion": "1",
96
+ "definitionHash": "0ef4691d3bedcd32940a75614ae42976f43d1edfda9654249e1e0670cbb8887d"
97
+ },
14
98
  {
15
99
  "toolName": "msads_update_entity",
16
100
  "contractPlatformSlug": "msads",
17
101
  "contractToolSlug": "update_entity",
18
102
  "schemaVersion": "1",
19
- "definitionHash": "a200b66a469abbdcd3fe76bb08d629e12bb6a6b2aa245d3853fb03bbcecf64be"
103
+ "definitionHash": "1e40f7e4bed9eb37011d5651b93dc6a49c9a7c25c8142f00f4002a2b27f3db42"
20
104
  }
21
105
  ]
22
106
  }
@@ -1 +1 @@
1
- {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp-server/server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAqBtF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAkCnC,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,SAAS,CAAC,CAqIpB;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKrF"}
1
+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp-server/server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAsBtF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAkCnC,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,SAAS,CAAC,CAwIpB;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKrF"}
@@ -6,7 +6,7 @@ import { fieldRulesResource } from "./resources/definitions/field-rules.resource
6
6
  import { promptRegistry } from "./prompts/index.js";
7
7
  import { createOperationContext } from "@cesteral/shared";
8
8
  import { reportCsvStore, sessionServiceStore } from "../services/session-services.js";
9
- import { extractZodShape, registerReportCsvResource, registerToolsFromDefinitions, registerPromptsFromDefinitions, registerStaticResourcesFromDefinitions, registerTemplatedResourcesFromDefinitions, InteractionLogger, isConformanceFixturesEnabled, } from "@cesteral/shared";
9
+ import { extractZodShape, registerReportCsvResource, registerToolsFromDefinitions, createDefinitionHashResolver, registerPromptsFromDefinitions, registerStaticResourcesFromDefinitions, registerTemplatedResourcesFromDefinitions, InteractionLogger, isConformanceFixturesEnabled, } from "@cesteral/shared";
10
10
  import packageJson from "../../package.json" with { type: "json" };
11
11
  const MSADS_PACKAGE_NAME = "msads-mcp";
12
12
  const MSADS_PLATFORM = "msads";
@@ -55,6 +55,7 @@ export async function createMcpServer(logger, sessionId, gcsBucket) {
55
55
  logger,
56
56
  sessionId,
57
57
  transformSchema: (schema) => extractZodShape(schema),
58
+ resolveDefinitionHash: createDefinitionHashResolver(new URL("../cesteral-manifest.json", import.meta.url)),
58
59
  createRequestContext: (params) => createOperationContext({
59
60
  operation: params.operation,
60
61
  additionalContext: params.additionalContext,
@@ -1 +1 @@
1
- {"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp-server/server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,4BAA4B,EAC5B,8BAA8B,EAC9B,sCAAsC,EACtC,yCAAyC,EACzC,iBAAiB,EACjB,4BAA4B,GAI7B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,WAAW,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAEnE,MAAM,kBAAkB,GAAG,WAAW,CAAC;AACvC,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B,MAAM,yBAAyB,GAA2B;IAExD,mBAAmB,EAAE,+BAA+B;IACpD,gBAAgB,EAAE,+BAA+B;IACjD,mBAAmB,EAAE,+BAA+B;IAEpD,mBAAmB,EAAE,iCAAiC;IACtD,mBAAmB,EAAE,iCAAiC;IACtD,mBAAmB,EAAE,iCAAiC;IAEtD,gBAAgB,EAAE,6BAA6B;IAC/C,mBAAmB,EAAE,6BAA6B;IAClD,yBAAyB,EAAE,6BAA6B;IACxD,qBAAqB,EAAE,6BAA6B;IAEpD,0BAA0B,EAAE,mCAAmC;IAC/D,0BAA0B,EAAE,mCAAmC;IAC/D,wBAAwB,EAAE,mCAAmC;IAC7D,iBAAiB,EAAE,mCAAmC;IAEtD,0BAA0B,EAAE,iCAAiC;IAC7D,uBAAuB,EAAE,iCAAiC;IAE1D,oBAAoB,EAAE,+BAA+B;IACrD,qBAAqB,EAAE,+BAA+B;IACtD,wBAAwB,EAAE,iCAAiC;CAC5D,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAc,EACd,SAAkB,EAClB,SAAkB;IAElB,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,WAAW,EACT,sOAAsO;KACzO,EACD;QACE,YAAY,EAAE;YACZ,OAAO,EAAE,EAAE;SACZ;QACD,YAAY,EACV,yRAAyR;YACzR,wFAAwF;YACxF,6EAA6E;KAChF,CACF,CAAC;IAEF,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,CAAC;QAC9C,UAAU,EAAE,kBAAkB;QAC9B,MAAM;QACN,SAAS;KACV,CAAC,CAAC;IAEH,4BAA4B,CAAC;QAC3B,MAAM;QACN,KAAK,EAAE,QAAQ;QACf,MAAM;QACN,SAAS;QACT,eAAe,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC;QACpD,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE,CAC/B,sBAAsB,CAAC;YACrB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;SAC5C,CAAC;QACJ,iBAAiB,EAAE,SAAS;QAC5B,WAAW,EAAE,kBAAkB;QAC/B,QAAQ,EAAE,cAAc;QACxB,oBAAoB,EAAE,yBAAyB;QAC/C,iBAAiB;QACjB,mBAAmB,EAAE,SAAS;YAC5B,CAAC,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,cAAc,CAAC,SAAS,CAAC;YACrD,CAAC,CAAC,SAAS;KACd,CAAC,CAAC;IAEH,sCAAsC,CAAC;QACrC,MAAM;QACN,SAAS,EAAE,YAAY;QACvB,MAAM;KACP,CAAC,CAAC;IAIH,yCAAyC,CAAC;QACxC,MAAM;QACN,eAAe,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,gBAAgB,CAAC,WAAW,EAAE,OAAO,CAAC;QACrF,SAAS,EAAE,CAAC,kBAAkB,CAAC;QAC/B,MAAM;KACP,CAAC,CAAC;IAIH,yBAAyB,CAAC;QACxB,MAAM;QACN,gBAAgB;QAChB,KAAK,EAAE,cAAc;QACrB,QAAQ,EAAE,eAAe;QACzB,gBAAgB,EAAE,uBAAuB;QACzC,MAAM;KACP,CAAC,CAAC;IAEH,IAAI,4BAA4B,EAAE,EAAE,CAAC;QACnC,MAAM,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAC5F,kBAAkB,CACnB,CAAC;QACF,MAAM,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAC5D,yCAAyC,CAC1C,CAAC;QAEF,sCAAsC,CAAC;YACrC,MAAM;YACN,SAAS,EAAE,oBAAoB;YAC/B,MAAM;SACP,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,IAAI,mBAAmB,CAAC,2BAA2B,CAAC,WAAW,EAAE;YAChF,IAAI,EAAE,SAAS;SAChB,CAAC,CAAC;QACH,MAAM,CAAC,gBAAgB,CACrB,sBAAsB,EACtB,QAAQ,EACR;YACE,WAAW,EAAE,2BAA2B,CAAC,WAAW;YACpD,QAAQ,EAAE,2BAA2B,CAAC,QAAQ;SAC/C,EACD,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;YACvB,MAAM,EAAE,GAAI,SAAS,CAAC,EAAa,IAAI,SAAS,CAAC;YACjD,MAAM,OAAO,GAAG,2BAA2B,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YAC3D,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,2BAA2B,CAAC,QAAQ;wBAC9C,IAAI,EAAE,OAAO;qBACd;iBACF;aACF,CAAC;QACJ,CAAC,CACF,CAAC;QAEF,8BAA8B,CAAC;YAC7B,MAAM,EAAE,MAAwC;YAChD,OAAO,EAAE,kBAAkB;YAC3B,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED,MAAM,UAAU,GAAiC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CACtF,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACR,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI;QACrB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE;QACzC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,SAAmD;QACzE,eAAe,EAAE,GAAG,CAAC,eAAe;KACrC,CAAC,CACH,CAAC;IACF,8BAA8B,CAAC;QAC7B,MAAM,EAAE,MAAwC;QAChD,OAAO,EAAE,UAAU;QACnB,MAAM;KACP,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAiB,EAAE,MAAc;IACpE,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;AAChD,CAAC"}
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp-server/server.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,5 @@
1
1
  import { z } from "zod";
2
- import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
2
+ import type { RequestContext, McpTextContent, SdkContext, EffectResult, EffectDryRunResult, DispatchedCapability } from "@cesteral/shared";
3
3
  export declare const AdjustBidsInputSchema: z.ZodObject<{
4
4
  entityType: z.ZodEnum<[string, ...string[]]>;
5
5
  scope: z.ZodOptional<z.ZodObject<{
@@ -25,8 +25,10 @@ export declare const AdjustBidsInputSchema: z.ZodObject<{
25
25
  bidField: string;
26
26
  newBid: number;
27
27
  }>, "many">;
28
+ dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
28
29
  }, "strip", z.ZodTypeAny, {
29
30
  entityType: string;
31
+ dry_run: boolean;
30
32
  adjustments: {
31
33
  entityId: string;
32
34
  bidField: string;
@@ -43,6 +45,7 @@ export declare const AdjustBidsInputSchema: z.ZodObject<{
43
45
  bidField: string;
44
46
  newBid: number;
45
47
  }[];
48
+ dry_run?: boolean | undefined;
46
49
  scope?: {
47
50
  campaignId?: string | undefined;
48
51
  adGroupId?: string | undefined;
@@ -55,19 +58,28 @@ export declare const AdjustBidsOutputSchema: z.ZodObject<{
55
58
  entityType: z.ZodString;
56
59
  adjustmentCount: z.ZodNumber;
57
60
  timestamp: z.ZodString;
61
+ dryRun: z.ZodOptional<z.ZodType<EffectDryRunResult, z.ZodTypeDef, EffectDryRunResult>>;
62
+ effect: z.ZodOptional<z.ZodType<EffectResult, z.ZodTypeDef, EffectResult>>;
63
+ dispatchedCapability: z.ZodType<DispatchedCapability, z.ZodTypeDef, DispatchedCapability>;
58
64
  }, "strip", z.ZodTypeAny, {
59
65
  entityType: string;
60
66
  timestamp: string;
61
67
  result: Record<string, any>;
68
+ dispatchedCapability: DispatchedCapability;
62
69
  confirmed: boolean;
63
70
  adjustmentCount: number;
71
+ dryRun?: EffectDryRunResult | undefined;
72
+ effect?: EffectResult | undefined;
64
73
  declineReason?: string | undefined;
65
74
  }, {
66
75
  entityType: string;
67
76
  timestamp: string;
68
77
  result: Record<string, any>;
78
+ dispatchedCapability: DispatchedCapability;
69
79
  confirmed: boolean;
70
80
  adjustmentCount: number;
81
+ dryRun?: EffectDryRunResult | undefined;
82
+ effect?: EffectResult | undefined;
71
83
  declineReason?: string | undefined;
72
84
  }>;
73
85
  type AdjustBidsInput = z.infer<typeof AdjustBidsInputSchema>;
@@ -103,8 +115,10 @@ export declare const adjustBidsTool: {
103
115
  bidField: string;
104
116
  newBid: number;
105
117
  }>, "many">;
118
+ dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
106
119
  }, "strip", z.ZodTypeAny, {
107
120
  entityType: string;
121
+ dry_run: boolean;
108
122
  adjustments: {
109
123
  entityId: string;
110
124
  bidField: string;
@@ -121,6 +135,7 @@ export declare const adjustBidsTool: {
121
135
  bidField: string;
122
136
  newBid: number;
123
137
  }[];
138
+ dry_run?: boolean | undefined;
124
139
  scope?: {
125
140
  campaignId?: string | undefined;
126
141
  adGroupId?: string | undefined;
@@ -133,19 +148,28 @@ export declare const adjustBidsTool: {
133
148
  entityType: z.ZodString;
134
149
  adjustmentCount: z.ZodNumber;
135
150
  timestamp: z.ZodString;
151
+ dryRun: z.ZodOptional<z.ZodType<EffectDryRunResult, z.ZodTypeDef, EffectDryRunResult>>;
152
+ effect: z.ZodOptional<z.ZodType<EffectResult, z.ZodTypeDef, EffectResult>>;
153
+ dispatchedCapability: z.ZodType<DispatchedCapability, z.ZodTypeDef, DispatchedCapability>;
136
154
  }, "strip", z.ZodTypeAny, {
137
155
  entityType: string;
138
156
  timestamp: string;
139
157
  result: Record<string, any>;
158
+ dispatchedCapability: DispatchedCapability;
140
159
  confirmed: boolean;
141
160
  adjustmentCount: number;
161
+ dryRun?: EffectDryRunResult | undefined;
162
+ effect?: EffectResult | undefined;
142
163
  declineReason?: string | undefined;
143
164
  }, {
144
165
  entityType: string;
145
166
  timestamp: string;
146
167
  result: Record<string, any>;
168
+ dispatchedCapability: DispatchedCapability;
147
169
  confirmed: boolean;
148
170
  adjustmentCount: number;
171
+ dryRun?: EffectDryRunResult | undefined;
172
+ effect?: EffectResult | undefined;
149
173
  declineReason?: string | undefined;
150
174
  }>;
151
175
  annotations: {
@@ -153,6 +177,23 @@ export declare const adjustBidsTool: {
153
177
  openWorldHint: boolean;
154
178
  idempotentHint: boolean;
155
179
  destructiveHint: boolean;
180
+ cesteral: {
181
+ kind: "write";
182
+ writeClass: "effect";
183
+ executableArgsExclude: string[];
184
+ platform: string;
185
+ contractPlatformSlug: string;
186
+ contractToolSlug: string;
187
+ operation: "adjust_bids"[];
188
+ entityKinds: never[];
189
+ entityIdArgs: never[];
190
+ schemaVersion: number;
191
+ contractId: string;
192
+ supportsDryRun: true;
193
+ supportsBeforeAfterSnapshot: false;
194
+ requiresValidation: true;
195
+ requiresSimulation: true;
196
+ };
156
197
  };
157
198
  inputExamples: {
158
199
  label: string;
@@ -1 +1 @@
1
- {"version":3,"file":"adjust-bids.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/adjust-bids.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQnF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BU,CAAC;AAE7C,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;EASC,CAAC;AAErC,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC7D,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE/D,wBAAsB,eAAe,CACnC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,gBAAgB,CAAC,CA2C3B;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,EAAE,CAetF;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2B1B,CAAC"}
1
+ {"version":3,"file":"adjust-bids.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/adjust-bids.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EAGrB,MAAM,kBAAkB,CAAC;AAQ1B,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmCU,CAAC;AAE7C,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBC,CAAC;AAErC,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC7D,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE/D,wBAAsB,eAAe,CACnC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,gBAAgB,CAAC,CA0E3B;AAyCD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,EAAE,CA+BtF;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4C1B,CAAC"}
@@ -1,7 +1,7 @@
1
1
  import { z } from "zod";
2
2
  import { resolveSessionServices } from "../utils/resolve-session.js";
3
3
  import { getEntityTypeEnum } from "../utils/entity-mapping.js";
4
- import { elicitBidChangeConfirmation } from "@cesteral/shared";
4
+ import { elicitBidChangeConfirmation, assertGovernedEffectDryRun, EffectResultSchema, EffectDryRunResultSchema, DispatchedCapabilitySchema, } from "@cesteral/shared";
5
5
  const TOOL_NAME = "msads_adjust_bids";
6
6
  const TOOL_TITLE = "Adjust Microsoft Ads Bids";
7
7
  const TOOL_DESCRIPTION = `Batch adjust bids for Microsoft Advertising keywords or ad groups using a safe read-modify-write pattern.
@@ -30,6 +30,11 @@ export const AdjustBidsInputSchema = z
30
30
  }))
31
31
  .min(1)
32
32
  .describe("Array of bid adjustments"),
33
+ dry_run: z
34
+ .boolean()
35
+ .optional()
36
+ .default(false)
37
+ .describe("When true, validates the bid adjustments and returns an EffectDryRunResult under `dryRun` (expected effect = the would-be bid-adjustment batch) without calling the Microsoft Advertising API or prompting for confirmation. No bids are changed."),
33
38
  })
34
39
  .describe("Parameters for adjusting bids");
35
40
  export const AdjustBidsOutputSchema = z
@@ -40,9 +45,28 @@ export const AdjustBidsOutputSchema = z
40
45
  entityType: z.string(),
41
46
  adjustmentCount: z.number(),
42
47
  timestamp: z.string().datetime(),
48
+ dryRun: EffectDryRunResultSchema.optional().describe("Present only when the request was made with `dry_run: true`. No bids were changed."),
49
+ effect: EffectResultSchema.optional().describe("Effect-class result identity (effectKind `bids_adjusted` + scalar audit summary). Present on a confirmed execute."),
50
+ dispatchedCapability: DispatchedCapabilitySchema.describe("The concrete (operation, entityKind) this call resolved to — `adjust_bids` with `canonicalEntityKind: null` (effect class). Present on every response."),
43
51
  })
44
52
  .describe("Bid adjustment result");
45
53
  export async function adjustBidsLogic(input, context, sdkContext) {
54
+ const dispatchedCapability = {
55
+ operation: "adjust_bids",
56
+ canonicalEntityKind: null,
57
+ };
58
+ if (input.dry_run === true) {
59
+ const dryRun = buildAdjustBidsEffectDryRun(input.adjustments, input.entityType);
60
+ return {
61
+ confirmed: true,
62
+ result: {},
63
+ entityType: input.entityType,
64
+ adjustmentCount: input.adjustments.length,
65
+ timestamp: new Date().toISOString(),
66
+ dryRun,
67
+ dispatchedCapability,
68
+ };
69
+ }
46
70
  const confirmed = await elicitBidChangeConfirmation({
47
71
  count: input.adjustments.length,
48
72
  entityLabel: input.entityType,
@@ -58,6 +82,7 @@ export async function adjustBidsLogic(input, context, sdkContext) {
58
82
  entityType: input.entityType,
59
83
  adjustmentCount: 0,
60
84
  timestamp: new Date().toISOString(),
85
+ dispatchedCapability,
61
86
  };
62
87
  }
63
88
  const { msadsService } = resolveSessionServices(sdkContext);
@@ -69,15 +94,61 @@ export async function adjustBidsLogic(input, context, sdkContext) {
69
94
  queryParams.AdGroupId = Number(input.scope.adGroupId);
70
95
  }
71
96
  const result = (await msadsService.adjustBids(input.entityType, input.adjustments, queryParams, context));
97
+ const effect = {
98
+ effectKind: "bids_adjusted",
99
+ summary: {
100
+ entity_label: input.entityType,
101
+ requested: input.adjustments.length,
102
+ },
103
+ };
72
104
  return {
73
105
  confirmed: true,
74
106
  result,
75
107
  entityType: input.entityType,
76
108
  adjustmentCount: input.adjustments.length,
77
109
  timestamp: new Date().toISOString(),
110
+ effect,
111
+ dispatchedCapability,
78
112
  };
79
113
  }
114
+ function buildAdjustBidsEffectDryRun(adjustments, entityType) {
115
+ const validationErrors = [];
116
+ adjustments.forEach((a, i) => {
117
+ if (!Number.isFinite(a.newBid) || a.newBid <= 0) {
118
+ validationErrors.push({
119
+ code: "INVALID_BID_AMOUNT",
120
+ message: `newBid must be a positive number — got ${String(a.newBid)}`,
121
+ field: `adjustments.${i}.newBid`,
122
+ });
123
+ }
124
+ });
125
+ const expectedEffect = {
126
+ effectKind: "bids_adjusted",
127
+ summary: { entity_label: entityType, requested: adjustments.length },
128
+ };
129
+ return assertGovernedEffectDryRun({
130
+ wouldSucceed: validationErrors.length === 0,
131
+ validationErrors,
132
+ validationSource: "symbolic",
133
+ expectedEffectSource: "symbolic",
134
+ expectedEffect,
135
+ }, "msads_adjust_bids", { requiresValidation: true, requiresSimulation: true });
136
+ }
80
137
  export function adjustBidsResponseFormatter(result) {
138
+ if (result.dryRun) {
139
+ const { wouldSucceed, validationErrors, validationSource, expectedEffectSource } = result.dryRun;
140
+ const verdict = wouldSucceed ? "would succeed" : "would FAIL";
141
+ const errs = validationErrors.map((e) => ` - [${e.code}] ${e.message}`).join("\n");
142
+ const n = result.dryRun.expectedEffect?.summary.requested ?? result.adjustmentCount;
143
+ return [
144
+ {
145
+ type: "text",
146
+ text: `Dry run: adjusting bids on ${n} ${result.entityType}(s) ${verdict} (validation: ${validationSource}, expected-effect: ${expectedEffectSource}). No bids were changed.` +
147
+ (errs ? `\n${errs}` : "") +
148
+ `\n\nTimestamp: ${result.timestamp}`,
149
+ },
150
+ ];
151
+ }
81
152
  if (!result.confirmed) {
82
153
  return [
83
154
  {
@@ -104,6 +175,23 @@ export const adjustBidsTool = {
104
175
  openWorldHint: false,
105
176
  idempotentHint: true,
106
177
  destructiveHint: false,
178
+ cesteral: {
179
+ kind: "write",
180
+ writeClass: "effect",
181
+ executableArgsExclude: ["dry_run"],
182
+ platform: "msads",
183
+ contractPlatformSlug: "msads",
184
+ contractToolSlug: "adjust_bids",
185
+ operation: ["adjust_bids"],
186
+ entityKinds: [],
187
+ entityIdArgs: [],
188
+ schemaVersion: 1,
189
+ contractId: "msads.adjust_bids.v1",
190
+ supportsDryRun: true,
191
+ supportsBeforeAfterSnapshot: false,
192
+ requiresValidation: true,
193
+ requiresSimulation: true,
194
+ },
107
195
  },
108
196
  inputExamples: [
109
197
  {
@@ -1 +1 @@
1
- {"version":3,"file":"adjust-bids.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/adjust-bids.tool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"adjust-bids.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/adjust-bids.tool.ts"],"names":[],"mappings":"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"}
@@ -1,30 +1,42 @@
1
1
  import { z } from "zod";
2
- import type { RequestContext, McpTextContent, SdkContext } from "@cesteral/shared";
2
+ import type { RequestContext, McpTextContent, SdkContext, EffectResult, EffectDryRunResult, DispatchedCapability } from "@cesteral/shared";
3
3
  export declare const BulkCreateEntitiesInputSchema: z.ZodObject<{
4
4
  entityType: z.ZodEnum<[string, ...string[]]>;
5
5
  items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
6
+ dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
6
7
  }, "strip", z.ZodTypeAny, {
7
8
  entityType: string;
9
+ dry_run: boolean;
8
10
  items: Record<string, unknown>[];
9
11
  }, {
10
12
  entityType: string;
11
13
  items: Record<string, unknown>[];
14
+ dry_run?: boolean | undefined;
12
15
  }>;
13
16
  export declare const BulkCreateEntitiesOutputSchema: z.ZodObject<{
14
17
  results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
15
18
  entityType: z.ZodString;
16
19
  totalItems: z.ZodNumber;
17
20
  timestamp: z.ZodString;
21
+ dryRun: z.ZodOptional<z.ZodType<EffectDryRunResult, z.ZodTypeDef, EffectDryRunResult>>;
22
+ effect: z.ZodOptional<z.ZodType<EffectResult, z.ZodTypeDef, EffectResult>>;
23
+ dispatchedCapability: z.ZodType<DispatchedCapability, z.ZodTypeDef, DispatchedCapability>;
18
24
  }, "strip", z.ZodTypeAny, {
19
25
  entityType: string;
20
26
  results: Record<string, any>[];
21
27
  timestamp: string;
28
+ dispatchedCapability: DispatchedCapability;
22
29
  totalItems: number;
30
+ dryRun?: EffectDryRunResult | undefined;
31
+ effect?: EffectResult | undefined;
23
32
  }, {
24
33
  entityType: string;
25
34
  results: Record<string, any>[];
26
35
  timestamp: string;
36
+ dispatchedCapability: DispatchedCapability;
27
37
  totalItems: number;
38
+ dryRun?: EffectDryRunResult | undefined;
39
+ effect?: EffectResult | undefined;
28
40
  }>;
29
41
  type BulkCreateEntitiesInput = z.infer<typeof BulkCreateEntitiesInputSchema>;
30
42
  type BulkCreateEntitiesOutput = z.infer<typeof BulkCreateEntitiesOutputSchema>;
@@ -37,34 +49,63 @@ export declare const bulkCreateEntitiesTool: {
37
49
  inputSchema: z.ZodObject<{
38
50
  entityType: z.ZodEnum<[string, ...string[]]>;
39
51
  items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
52
+ dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
40
53
  }, "strip", z.ZodTypeAny, {
41
54
  entityType: string;
55
+ dry_run: boolean;
42
56
  items: Record<string, unknown>[];
43
57
  }, {
44
58
  entityType: string;
45
59
  items: Record<string, unknown>[];
60
+ dry_run?: boolean | undefined;
46
61
  }>;
47
62
  outputSchema: z.ZodObject<{
48
63
  results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
49
64
  entityType: z.ZodString;
50
65
  totalItems: z.ZodNumber;
51
66
  timestamp: z.ZodString;
67
+ dryRun: z.ZodOptional<z.ZodType<EffectDryRunResult, z.ZodTypeDef, EffectDryRunResult>>;
68
+ effect: z.ZodOptional<z.ZodType<EffectResult, z.ZodTypeDef, EffectResult>>;
69
+ dispatchedCapability: z.ZodType<DispatchedCapability, z.ZodTypeDef, DispatchedCapability>;
52
70
  }, "strip", z.ZodTypeAny, {
53
71
  entityType: string;
54
72
  results: Record<string, any>[];
55
73
  timestamp: string;
74
+ dispatchedCapability: DispatchedCapability;
56
75
  totalItems: number;
76
+ dryRun?: EffectDryRunResult | undefined;
77
+ effect?: EffectResult | undefined;
57
78
  }, {
58
79
  entityType: string;
59
80
  results: Record<string, any>[];
60
81
  timestamp: string;
82
+ dispatchedCapability: DispatchedCapability;
61
83
  totalItems: number;
84
+ dryRun?: EffectDryRunResult | undefined;
85
+ effect?: EffectResult | undefined;
62
86
  }>;
63
87
  annotations: {
64
88
  readOnlyHint: boolean;
65
89
  openWorldHint: boolean;
66
90
  idempotentHint: boolean;
67
91
  destructiveHint: boolean;
92
+ cesteral: {
93
+ kind: "write";
94
+ writeClass: "effect";
95
+ executableArgsExclude: string[];
96
+ platform: string;
97
+ contractPlatformSlug: string;
98
+ contractToolSlug: string;
99
+ operation: "bulk_job"[];
100
+ entityKinds: never[];
101
+ entityIdArgs: never[];
102
+ schemaVersion: number;
103
+ contractId: string;
104
+ supportsDryRun: true;
105
+ supportsBeforeAfterSnapshot: false;
106
+ requiresValidation: true;
107
+ requiresSimulation: true;
108
+ };
68
109
  };
69
110
  inputExamples: {
70
111
  label: string;
@@ -1 +1 @@
1
- {"version":3,"file":"bulk-create-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-create-entities.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQnF,eAAO,MAAM,6BAA6B;;;;;;;;;EAKwB,CAAC;AAEnE,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;EAOR,CAAC;AAEpC,KAAK,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAC7E,KAAK,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAE/E,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,uBAAuB,EAC9B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,wBAAwB,CAAC,CAenC;AAED,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,wBAAwB,GAC/B,cAAc,EAAE,CAOlB;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BlC,CAAC"}
1
+ {"version":3,"file":"bulk-create-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bulk-create-entities.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EAGrB,MAAM,kBAAkB,CAAC;AAU1B,eAAO,MAAM,6BAA6B;;;;;;;;;;;;EAYwB,CAAC;AAEnE,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;EAgBR,CAAC;AAEpC,KAAK,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAC7E,KAAK,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAE/E,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,uBAAuB,EAC9B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,wBAAwB,CAAC,CA6CnC;AAuCD,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,wBAAwB,GAC/B,cAAc,EAAE,CAuBlB;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6ClC,CAAC"}