@apify/actors-mcp-server 0.10.5-beta.0 → 0.10.5-beta.10

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 (107) hide show
  1. package/dist/apify_client.d.ts.map +1 -1
  2. package/dist/apify_client.js +16 -1
  3. package/dist/apify_client.js.map +1 -1
  4. package/dist/const.d.ts +1 -1
  5. package/dist/const.d.ts.map +1 -1
  6. package/dist/const.js +1 -3
  7. package/dist/const.js.map +1 -1
  8. package/dist/dev_server.d.ts.map +1 -1
  9. package/dist/dev_server.js +24 -5
  10. package/dist/dev_server.js.map +1 -1
  11. package/dist/mcp/server.d.ts +3 -2
  12. package/dist/mcp/server.d.ts.map +1 -1
  13. package/dist/mcp/server.js +96 -51
  14. package/dist/mcp/server.js.map +1 -1
  15. package/dist/mcp/utils.d.ts +1 -1
  16. package/dist/mcp/utils.js +1 -1
  17. package/dist/tools/actor_executor.d.ts +10 -0
  18. package/dist/tools/actor_executor.d.ts.map +1 -0
  19. package/dist/tools/actor_executor.js +79 -0
  20. package/dist/tools/actor_executor.js.map +1 -0
  21. package/dist/tools/apps/call_actor.d.ts +0 -1
  22. package/dist/tools/apps/call_actor.d.ts.map +1 -1
  23. package/dist/tools/apps/call_actor.js +8 -54
  24. package/dist/tools/apps/call_actor.js.map +1 -1
  25. package/dist/tools/apps/call_actor_widget.d.ts.map +1 -1
  26. package/dist/tools/apps/call_actor_widget.js +8 -32
  27. package/dist/tools/apps/call_actor_widget.js.map +1 -1
  28. package/dist/tools/apps/get_actor_run_widget.d.ts.map +1 -1
  29. package/dist/tools/apps/get_actor_run_widget.js +15 -9
  30. package/dist/tools/apps/get_actor_run_widget.js.map +1 -1
  31. package/dist/tools/categories.d.ts +6 -0
  32. package/dist/tools/categories.d.ts.map +1 -1
  33. package/dist/tools/categories.js +7 -1
  34. package/dist/tools/categories.js.map +1 -1
  35. package/dist/tools/core/actor_run_response.d.ts +127 -0
  36. package/dist/tools/core/actor_run_response.d.ts.map +1 -0
  37. package/dist/tools/core/actor_run_response.js +551 -0
  38. package/dist/tools/core/actor_run_response.js.map +1 -0
  39. package/dist/tools/core/actor_tools_factory.d.ts +8 -3
  40. package/dist/tools/core/actor_tools_factory.d.ts.map +1 -1
  41. package/dist/tools/core/actor_tools_factory.js +39 -15
  42. package/dist/tools/core/actor_tools_factory.js.map +1 -1
  43. package/dist/tools/core/call_actor_common.d.ts +19 -39
  44. package/dist/tools/core/call_actor_common.d.ts.map +1 -1
  45. package/dist/tools/core/call_actor_common.js +196 -129
  46. package/dist/tools/core/call_actor_common.js.map +1 -1
  47. package/dist/tools/core/fetch_actor_details_common.d.ts.map +1 -1
  48. package/dist/tools/core/fetch_actor_details_common.js +1 -0
  49. package/dist/tools/core/fetch_actor_details_common.js.map +1 -1
  50. package/dist/tools/core/get_actor_run_common.d.ts +10 -49
  51. package/dist/tools/core/get_actor_run_common.d.ts.map +1 -1
  52. package/dist/tools/core/get_actor_run_common.js +51 -86
  53. package/dist/tools/core/get_actor_run_common.js.map +1 -1
  54. package/dist/tools/default/call_actor.d.ts +0 -2
  55. package/dist/tools/default/call_actor.d.ts.map +1 -1
  56. package/dist/tools/default/call_actor.js +5 -85
  57. package/dist/tools/default/call_actor.js.map +1 -1
  58. package/dist/tools/default/get_actor_run.d.ts +1 -2
  59. package/dist/tools/default/get_actor_run.d.ts.map +1 -1
  60. package/dist/tools/default/get_actor_run.js +12 -6
  61. package/dist/tools/default/get_actor_run.js.map +1 -1
  62. package/dist/tools/index.d.ts +1 -2
  63. package/dist/tools/index.d.ts.map +1 -1
  64. package/dist/tools/index.js +1 -2
  65. package/dist/tools/index.js.map +1 -1
  66. package/dist/tools/structured_output_schemas.d.ts +258 -51
  67. package/dist/tools/structured_output_schemas.d.ts.map +1 -1
  68. package/dist/tools/structured_output_schemas.js +128 -68
  69. package/dist/tools/structured_output_schemas.js.map +1 -1
  70. package/dist/tsconfig.tsbuildinfo +1 -1
  71. package/dist/types.d.ts +26 -1
  72. package/dist/types.d.ts.map +1 -1
  73. package/dist/types.js.map +1 -1
  74. package/dist/utils/mcp.d.ts +6 -0
  75. package/dist/utils/mcp.d.ts.map +1 -1
  76. package/dist/utils/mcp.js +30 -0
  77. package/dist/utils/mcp.js.map +1 -1
  78. package/dist/utils/progress.d.ts +1 -0
  79. package/dist/utils/progress.d.ts.map +1 -1
  80. package/dist/utils/progress.js +2 -2
  81. package/dist/utils/progress.js.map +1 -1
  82. package/dist/utils/server-instructions/index.d.ts.map +1 -1
  83. package/dist/utils/server-instructions/index.js +6 -7
  84. package/dist/utils/server-instructions/index.js.map +1 -1
  85. package/dist/utils/tools_loader.d.ts.map +1 -1
  86. package/dist/utils/tools_loader.js +9 -3
  87. package/dist/utils/tools_loader.js.map +1 -1
  88. package/dist/web/dist/actor-detail-widget.js +3 -0
  89. package/dist/web/dist/actor-run-widget.js +219 -216
  90. package/dist/web/dist/search-actors-widget.js +3 -0
  91. package/package.json +7 -7
  92. package/dist/tools/apps/actor_executor.d.ts +0 -8
  93. package/dist/tools/apps/actor_executor.d.ts.map +0 -1
  94. package/dist/tools/apps/actor_executor.js +0 -29
  95. package/dist/tools/apps/actor_executor.js.map +0 -1
  96. package/dist/tools/core/actor_execution.d.ts +0 -39
  97. package/dist/tools/core/actor_execution.d.ts.map +0 -1
  98. package/dist/tools/core/actor_execution.js +0 -135
  99. package/dist/tools/core/actor_execution.js.map +0 -1
  100. package/dist/tools/core/actor_response.d.ts +0 -37
  101. package/dist/tools/core/actor_response.d.ts.map +0 -1
  102. package/dist/tools/core/actor_response.js +0 -94
  103. package/dist/tools/core/actor_response.js.map +0 -1
  104. package/dist/tools/default/actor_executor.d.ts +0 -7
  105. package/dist/tools/default/actor_executor.d.ts.map +0 -1
  106. package/dist/tools/default/actor_executor.js +0 -31
  107. package/dist/tools/default/actor_executor.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"get_actor_run_widget.js","sourceRoot":"","sources":["../../../src/tools/apps/get_actor_run_widget.ts"],"names":[],"mappings":";AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EACH,qBAAqB,EACrB,+BAA+B,EAC/B,iBAAiB,GACpB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E;;;;GAIG;AACH,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;SACZ,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,0BAA0B,CAAC;CAC5C,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,gCAAgC,GAAG,MAAM,CAAA;;;;;;;MAOzC,WAAW,CAAC,cAAc;;;CAG/B,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAc,MAAM,CAAC,MAAM,CAAC;IAC1D,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,WAAW,CAAC,qBAAqB;IACvC,WAAW,EAAE,gCAAgC;IAC7C,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,2BAA2B,CAAoB;IAC3E,YAAY,EAAE,uBAAuB;IACrC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,2BAA2B,CAAC,CAAC;IACvE,eAAe,EAAE,IAAI;IACrB,KAAK,EAAE;QACH,GAAG,MAAA,eAAe,CAAC,WAAW,CAAC,SAAS,CAAC,0CAAE,IAAI;KAClD;IACD,WAAW,EAAE;QACT,KAAK,EAAE,wBAAwB;QAC/B,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB;IACD,IAAI,EAAE,KAAK,EAAE,QAA0B,EAAE,EAAE;QACvC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,QAAQ,CAAC;QAC7D,MAAM,MAAM,GAAG,2BAA2B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEvD,IAAI,CAAC;YACD,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC;gBACxC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,MAAM;gBACN,YAAY;aACf,CAAC,CAAC;YAEH,IAAI,OAAO,IAAI,WAAW,EAAE,CAAC;gBACzB,OAAO,WAAW,CAAC,KAAK,CAAC;YAC7B,CAAC;YAED,OAAO,+BAA+B,CAAC,EAAE,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACpF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,YAAY,CAAC,KAAK,EAAE,kCAAkC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YACjF,OAAO,qBAAqB,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACtD,CAAC;IACL,CAAC;CACK,CAAC,CAAC"}
1
+ {"version":3,"file":"get_actor_run_widget.js","sourceRoot":"","sources":["../../../src/tools/apps/get_actor_run_widget.ts"],"names":[],"mappings":";AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EACH,qBAAqB,EACrB,+BAA+B,GAClC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E;;;;GAIG;AACH,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;SACZ,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,0BAA0B,CAAC;CAC5C,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,gCAAgC,GAAG,MAAM,CAAA;;;;;;;;;;MAUzC,WAAW,CAAC,cAAc;CAC/B,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAc,MAAM,CAAC,MAAM,CAAC;IAC1D,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,WAAW,CAAC,qBAAqB;IACvC,WAAW,EAAE,gCAAgC;IAC7C,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,2BAA2B,CAAoB;IAC3E,YAAY,EAAE,uBAAuB;IACrC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,2BAA2B,CAAC,CAAC;IACvE,eAAe,EAAE,IAAI;IACrB,KAAK,EAAE;QACH,GAAG,MAAA,eAAe,CAAC,WAAW,CAAC,SAAS,CAAC,0CAAE,IAAI;KAClD;IACD,WAAW,EAAE;QACT,KAAK,EAAE,wBAAwB;QAC/B,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB;IACD,IAAI,EAAE,KAAK,EAAE,QAA0B,EAAE,EAAE;QACvC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,QAAQ,CAAC;QAC7D,MAAM,MAAM,GAAG,2BAA2B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEvD,IAAI,CAAC;YACD,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC;gBACxC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,QAAQ,EAAE,CAAC;gBACX,MAAM;gBACN,YAAY;aACf,CAAC,CAAC;YAEH,oFAAoF;YACpF,8DAA8D;YAC9D,IAAI,SAAS,IAAI,WAAW;gBAAE,OAAO,EAAE,CAAC;YACxC,IAAI,OAAO,IAAI,WAAW;gBAAE,OAAO,WAAW,CAAC,KAAK,CAAC;YAErD,OAAO,+BAA+B,CAAC,EAAE,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACpF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,YAAY,CAAC,KAAK,EAAE,kCAAkC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YACjF,OAAO,qBAAqB,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACtD,CAAC;IACL,CAAC;CACK,CAAC,CAAC"}
@@ -12,6 +12,12 @@
12
12
  * - A plain ToolEntry — mode-independent, always included
13
13
  * - A mode map (e.g. { default: ToolEntry, apps: ToolEntry }) — resolver picks entry[mode]
14
14
  * - A partial mode map (e.g. { apps: ToolEntry }) — included only for listed modes
15
+ *
16
+ * Apps vs default mode invariant:
17
+ * Only `*-widget` tools differ between modes — they live in `tools/apps/` and render an
18
+ * interactive UI element. All non-widget tools (`call-actor`, `get-actor-run`, direct actor
19
+ * tools, `search-actors`, `fetch-actor-details`) share a single implementation across modes.
20
+ * Do NOT add per-mode runtime variants for non-widget tools.
15
21
  */
16
22
  import { HelperTools } from '../const.js';
17
23
  import type { ToolEntry } from '../types.js';
@@ -1 +1 @@
1
- {"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../src/tools/categories.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAyCzC;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;CAiCoB,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAkC,CAAC,MAAM,OAAO,cAAc,CAAC,EAAE,CAAC;AAE7F,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAmC,CAAC;AAEtF,mEAAmE;AACnE,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;AAwBnF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,UAA+B,GAAG,eAAe,CAIvF;AAED,eAAO,MAAM,8BAA8B,EAAE,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,EAG3E,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,WAAW,EAAE,SAAS,CAKlE,CAAC"}
1
+ {"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../src/tools/categories.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAyCzC;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;CAiCoB,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAkC,CAAC,MAAM,OAAO,cAAc,CAAC,EAAE,CAAC;AAE7F,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAmC,CAAC;AAEtF,mEAAmE;AACnE,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;AAwBnF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,UAA+B,GAAG,eAAe,CAIvF;AAED,eAAO,MAAM,8BAA8B,EAAE,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,EAG3E,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,WAAW,EAAE,SAAS,CAKlE,CAAC"}
@@ -12,6 +12,12 @@
12
12
  * - A plain ToolEntry — mode-independent, always included
13
13
  * - A mode map (e.g. { default: ToolEntry, apps: ToolEntry }) — resolver picks entry[mode]
14
14
  * - A partial mode map (e.g. { apps: ToolEntry }) — included only for listed modes
15
+ *
16
+ * Apps vs default mode invariant:
17
+ * Only `*-widget` tools differ between modes — they live in `tools/apps/` and render an
18
+ * interactive UI element. All non-widget tools (`call-actor`, `get-actor-run`, direct actor
19
+ * tools, `search-actors`, `fetch-actor-details`) share a single implementation across modes.
20
+ * Do NOT add per-mode runtime variants for non-widget tools.
15
21
  */
16
22
  import { HelperTools } from '../const.js';
17
23
  import { ServerMode } from '../types.js';
@@ -58,7 +64,7 @@ export const toolCategories = {
58
64
  actors: [
59
65
  defaultSearchActors,
60
66
  defaultFetchActorDetails,
61
- // call-actor is different for default and apps mode (sync vs async call)
67
+ // call-actor is identical between modes; apps mode appends a widget addendum to the description.
62
68
  { default: defaultCallActor, apps: appsCallActor },
63
69
  ],
64
70
  docs: [
@@ -1 +1 @@
1
- {"version":3,"file":"categories.js","sourceRoot":"","sources":["../../src/tools/categories.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"categories.js","sourceRoot":"","sources":["../../src/tools/categories.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAYjE,0EAA0E;AAC1E,SAAS,SAAS,CAAC,KAAwB;IACvC,OAAO,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,YAAY,EAAE;QACV,OAAO;KACV;IACD,MAAM,EAAE;QACJ,mBAAmB;QACnB,wBAAwB;QACxB,iGAAiG;QACjG,EAAE,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,aAAa,EAAE;KACrD;IACD,IAAI,EAAE;QACF,mBAAmB;QACnB,kBAAkB;KACrB;IACD,IAAI,EAAE;QACF,kBAAkB;QAClB,eAAe;QACf,cAAc;QACd,aAAa;KAChB;IACD,OAAO,EAAE;QACL,UAAU;QACV,eAAe;QACf,gBAAgB;QAChB,cAAc;QACd,gBAAgB;QAChB,oBAAoB;QACpB,sBAAsB;QACtB,mBAAmB;QACnB,yBAAyB;KAC5B;IACD,GAAG,EAAE,EACJ;CAC0C,CAAC;AAEhD;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAoC,CAAC;AAE7F,8DAA8D;AAC9D,MAAM,CAAC,MAAM,iBAAiB,GAAwB,IAAI,GAAG,CAAS,cAAc,CAAC,CAAC;AAKtF;;;;;;GAMG;AACH,SAAS,sBAAsB,CAAC,OAAqC,EAAE,IAAgB;IACnF,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,IAAI,EAAE,CAAC;gBACP,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAmB,UAAU,CAAC,OAAO;IAClE,OAAO,MAAM,CAAC,WAAW,CACrB,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,sBAAsB,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CACxE,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,MAAM,8BAA8B,GAAsC;IAC7E,QAAQ;IACR,MAAM;CACT,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAwC,IAAI,GAAG,CAAC;IAC5E,CAAC,WAAW,CAAC,YAAY,EAAE,sBAAsB,CAAC;IAClD,CAAC,WAAW,CAAC,iBAAiB,EAAE,2BAA2B,CAAC;IAC5D,CAAC,WAAW,CAAC,UAAU,EAAE,mBAAmB,CAAC;IAC7C,CAAC,WAAW,CAAC,cAAc,EAAE,qBAAqB,CAAC;CACtD,CAAC,CAAC"}
@@ -0,0 +1,127 @@
1
+ import type { ActorRun } from 'apify-client';
2
+ import type { ApifyClient } from '../../apify_client.js';
3
+ import { buildMCPResponse } from '../../utils/mcp.js';
4
+ import { type ProgressTracker } from '../../utils/progress.js';
5
+ /** nextStep text for widget-rendered responses: suppresses LLM polling. */
6
+ export declare const WIDGET_NO_POLL_NEXT_STEP = "Widget is rendering live progress. Do NOT poll \u2014 the widget self-updates until completion.";
7
+ /** Maximum value for `waitSecs`. Stays under the 60s tool-call ceiling several MCP clients impose. */
8
+ export declare const WAIT_SECS_MAX = 45;
9
+ /** Default seconds to wait for completion on `call-actor` and direct actor tools. `get-actor-run` also defaults to 30. */
10
+ export declare const CALL_ACTOR_WAIT_SECS_DEFAULT = 30;
11
+ export type RunDataset = {
12
+ id: string;
13
+ name?: string;
14
+ title?: string;
15
+ itemCount?: number;
16
+ cleanItemCount?: number;
17
+ fields?: string[];
18
+ /**
19
+ * JSON Schema fragment for each dataset row. Populated only by direct actor tools (where
20
+ * the target Actor is known at tools/list time, so historical row shape can be looked up
21
+ * via `actorStore`). Absent for `call-actor` / `get-actor-run` (dynamic target).
22
+ */
23
+ itemsSchema?: {
24
+ type: 'object';
25
+ properties: Record<string, unknown>;
26
+ };
27
+ };
28
+ export type RunKeyValueStore = {
29
+ id: string;
30
+ name?: string;
31
+ title?: string;
32
+ keyCount?: number;
33
+ keys?: string[];
34
+ };
35
+ /**
36
+ * Storage shape mirrors `ActorRunStorageIds` from the Apify client — a map of alias → storage
37
+ * object where `default` is always the primary entry. Using the same plural alias-map structure
38
+ * means named Actor storages (e.g. `storages.datasets.results`) can be added without introducing
39
+ * new field names. Each value extends the bare Apify ID string with fetched metadata.
40
+ */
41
+ export type RunStorages = {
42
+ datasets?: {
43
+ default: RunDataset;
44
+ [alias: string]: RunDataset;
45
+ };
46
+ keyValueStores?: {
47
+ default: RunKeyValueStore;
48
+ [alias: string]: RunKeyValueStore;
49
+ };
50
+ };
51
+ /**
52
+ * Canonical run response shape returned by `call-actor` and `get-actor-run`.
53
+ * content[0] mirrors structuredContent as JSON (spec compat); content[1] is the
54
+ * LLM-readable summary + nextStep narrative.
55
+ */
56
+ export type RunResponse = {
57
+ runId: string;
58
+ actorId: string;
59
+ actorName?: string;
60
+ status: string;
61
+ statusMessage?: string;
62
+ exitCode?: number;
63
+ startedAt?: string;
64
+ finishedAt?: string;
65
+ stats?: {
66
+ runTimeSecs?: number;
67
+ computeUnits?: number;
68
+ memMaxBytes?: number;
69
+ };
70
+ storages: RunStorages;
71
+ summary: string;
72
+ nextStep: string;
73
+ };
74
+ export type FetchActorRunResult = {
75
+ run: ActorRun;
76
+ structuredContent: RunResponse;
77
+ };
78
+ /**
79
+ * Build {summary, nextStep} per status. Returns one primary action — never two.
80
+ */
81
+ export declare function buildStatusSummaryNextStep(params: {
82
+ run: ActorRun;
83
+ dataset?: RunDataset;
84
+ keyValueStore?: RunKeyValueStore;
85
+ }): {
86
+ summary: string;
87
+ nextStep: string;
88
+ };
89
+ /**
90
+ * Build a RunResponse from an already-started ActorRun without waiting.
91
+ * Used when waitSecs=0 (default and apps modes) and by widget variants that return immediately.
92
+ * Storage metadata contains IDs only; pollers/widgets fetch updates via get-actor-run.
93
+ *
94
+ * Pass `widget: true` for widget-rendered responses: nextStep is replaced with a no-poll
95
+ * message and widget _meta is included so the UI renders automatically.
96
+ *
97
+ * Invariant: `widget: true` is only valid from `*-widget` tools. Non-widget tools (call-actor,
98
+ * direct actor tools) must omit it or pass `false`.
99
+ */
100
+ export declare function buildStartRunResponse(params: {
101
+ actorName: string;
102
+ actorRun: ActorRun;
103
+ widget?: boolean;
104
+ }): ReturnType<typeof buildMCPResponse>;
105
+ /**
106
+ * Default `onAbort` for callers that want the run cancelled when the MCP request is cancelled.
107
+ * Logs and swallows abort failures so a transient API error doesn't override the original
108
+ * cancellation result.
109
+ */
110
+ export declare const abortRunOnSignal: (runId: string, client: ApifyClient) => Promise<void>;
111
+ export declare function fetchActorRunData(params: {
112
+ runId: string;
113
+ waitSecs?: number;
114
+ actorName?: string;
115
+ client: ApifyClient;
116
+ progressTracker?: ProgressTracker | null;
117
+ abortSignal?: AbortSignal;
118
+ mcpSessionId?: string;
119
+ onAbort?: (runId: string, client: ApifyClient) => Promise<void>;
120
+ }): Promise<{
121
+ error: object;
122
+ } | {
123
+ aborted: true;
124
+ } | {
125
+ result: FetchActorRunResult;
126
+ }>;
127
+ //# sourceMappingURL=actor_run_response.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"actor_run_response.d.ts","sourceRoot":"","sources":["../../../src/tools/core/actor_run_response.ts"],"names":[],"mappings":"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"}