@flowrunner/cli 0.1.19-dev.1 → 0.1.19-dev.3

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 (334) hide show
  1. package/ai-docs/instructions/service-code-format/01-service-structure.md +1 -1
  2. package/ai-docs/instructions/service-code-format/02-zod-types.md +6 -5
  3. package/ai-docs/instructions/service-code-format/05-dictionaries.md +1 -1
  4. package/ai-docs/instructions/service-code-format/11-output-model.md +2 -5
  5. package/ai-docs/instructions/service-code-format/13-runtime-contracts.md +2 -3
  6. package/ai-docs/instructions/service-code-format/17-client-certificates.md +4 -5
  7. package/ai-docs/instructions/service-code-format/README.md +2 -2
  8. package/dist/cli.js +322 -896
  9. package/dist/cli.js.map +4 -4
  10. package/dist/index.js +340 -908
  11. package/dist/index.js.map +4 -4
  12. package/{runtime/types/flow-extension-runner/src/v2 → dist/types/flow-extension-runner/src}/context/execution-context.d.ts +2 -2
  13. package/{runtime/types/flow-extension-runner/src/v2 → dist/types/flow-extension-runner/src}/extension.d.ts +3 -3
  14. package/dist/types/flow-extension-runner/src/global.d.ts +6 -18
  15. package/dist/types/flow-extension-runner/src/index.d.ts +39 -13
  16. package/dist/types/flow-extension-runner/src/{v2/model → model}/field-mapper.d.ts +1 -1
  17. package/dist/types/flow-extension-runner/src/{v2/model → model}/model-types.d.ts +11 -1
  18. package/dist/types/flow-extension-runner/src/{v2/model → model}/params-model.d.ts +1 -1
  19. package/dist/types/flow-extension-runner/src/{v2/params → params}/config-params.d.ts +1 -1
  20. package/{runtime/types/flow-extension-runner/src/v2 → dist/types/flow-extension-runner/src}/params/schema/messages.d.ts +1 -1
  21. package/{runtime/types/flow-extension-runner/src/v2 → dist/types/flow-extension-runner/src}/params/schema/normalize.d.ts +1 -1
  22. package/dist/types/flow-extension-runner/src/{v2/params → params}/schema/parse.d.ts +1 -1
  23. package/dist/types/flow-extension-runner/src/{v2/params → params}/types.d.ts +1 -1
  24. package/{runtime/types/flow-extension-runner/src/v2 → dist/types/flow-extension-runner/src}/registry.d.ts +2 -0
  25. package/dist/types/flow-extension-runner/src/{v2/types.d.ts → types.d.ts} +1 -1
  26. package/dist/types/packages/cli/src/constants/testing.d.ts +13 -6
  27. package/dist/types/packages/cli/src/operations/deploy/discover-services.d.ts +2 -4
  28. package/dist/types/shared/src/constants/activity-log.d.ts +248 -2
  29. package/dist/types/shared/src/constants/error-codes.d.ts +20 -0
  30. package/dist/types/shared/src/constants/flow-catalog.d.ts +54 -0
  31. package/dist/types/shared/src/constants/index.d.ts +2 -0
  32. package/dist/types/shared/src/constants/notification-types.d.ts +309 -0
  33. package/dist/types/shared/src/constants/panic-mode.d.ts +17 -0
  34. package/dist/types/shared/src/constants/shared-extensions.d.ts +10 -0
  35. package/dist/types/shared/src/errors/flow-catalog.d.ts +37 -0
  36. package/dist/types/shared/src/errors/index.d.ts +2 -0
  37. package/dist/types/shared/src/errors/secrets.d.ts +16 -0
  38. package/dist/types/shared/src/scheme/access-keys/dto.d.ts +35 -13
  39. package/dist/types/shared/src/scheme/api-keys/dto.d.ts +29 -4
  40. package/dist/types/shared/src/scheme/flow-catalog/analysis.d.ts +190 -0
  41. package/dist/types/shared/src/scheme/flow-catalog/index.d.ts +6 -0
  42. package/dist/types/shared/src/scheme/flow-catalog/pack.d.ts +144 -0
  43. package/dist/types/shared/src/scheme/flow-catalog/requests.d.ts +664 -0
  44. package/dist/types/shared/src/scheme/flow-catalog/summary.d.ts +69 -0
  45. package/dist/types/shared/src/scheme/flow-catalog/version.d.ts +132 -0
  46. package/dist/types/shared/src/scheme/flowrunner/custom-elements.d.ts +0 -16
  47. package/dist/types/shared/src/scheme/flowrunner/index.d.ts +1 -0
  48. package/dist/types/shared/src/scheme/flowrunner/java.dto.d.ts +102 -0
  49. package/dist/types/shared/src/scheme/flowrunner/workspace-dashboard.dto.d.ts +207 -0
  50. package/dist/types/shared/src/scheme/index.d.ts +1 -0
  51. package/dist/types/shared/src/scheme/integration-connection/dto.d.ts +22 -0
  52. package/dist/types/shared/src/scheme/knowledge-base/dto.d.ts +12 -12
  53. package/dist/types/shared/src/scheme/notifications/dto.d.ts +10 -0
  54. package/dist/types/shared/src/scheme/notifications/rest.d.ts +20 -0
  55. package/dist/types/shared/src/scheme/properties/index.d.ts +1 -0
  56. package/dist/types/shared/src/scheme/properties/secret.d.ts +12 -0
  57. package/dist/types/shared/src/scheme/remote-mcp-server/dto.d.ts +142 -29
  58. package/dist/types/shared/src/scheme/shared-extensions/base.d.ts +0 -4
  59. package/dist/types/shared/src/scheme/shared-extensions/config.d.ts +20 -2
  60. package/dist/types/shared/src/scheme/shared-extensions/custom-extensions.d.ts +0 -24
  61. package/dist/types/shared/src/scheme/shared-extensions/extension.d.ts +0 -18
  62. package/dist/types/shared/src/scheme/shared-extensions/flow-extensions.d.ts +0 -3
  63. package/dist/types/shared/src/scheme/shared-extensions/index.d.ts +1 -0
  64. package/dist/types/shared/src/scheme/shared-extensions/list.d.ts +0 -28
  65. package/dist/types/shared/src/scheme/shared-extensions/methods.d.ts +0 -1
  66. package/dist/types/shared/src/scheme/shared-extensions/resolve.d.ts +0 -12
  67. package/dist/types/shared/src/scheme/shared-extensions/rest.d.ts +1 -0
  68. package/dist/types/shared/src/scheme/shared-extensions/search.d.ts +0 -8
  69. package/dist/types/shared/src/scheme/shared-extensions/usage-stats.d.ts +189 -0
  70. package/package.json +1 -7
  71. package/project-files/sandbox/files-mock.js +3 -5
  72. package/project-files/sandbox/nock-mock.js +61 -5
  73. package/project-files/sandbox/service.js +10 -11
  74. package/runtime/index.js +178 -863
  75. package/runtime/index.js.map +4 -4
  76. package/{dist/types/flow-extension-runner/src/v2 → runtime/types/flow-extension-runner/src}/context/execution-context.d.ts +2 -2
  77. package/{dist/types/flow-extension-runner/src/v2 → runtime/types/flow-extension-runner/src}/extension.d.ts +3 -3
  78. package/runtime/types/flow-extension-runner/src/global.d.ts +6 -18
  79. package/runtime/types/flow-extension-runner/src/index.d.ts +39 -13
  80. package/runtime/types/flow-extension-runner/src/{v2/model → model}/field-mapper.d.ts +1 -1
  81. package/runtime/types/flow-extension-runner/src/{v2/model → model}/model-types.d.ts +11 -1
  82. package/runtime/types/flow-extension-runner/src/{v2/model → model}/params-model.d.ts +1 -1
  83. package/runtime/types/flow-extension-runner/src/{v2/params → params}/config-params.d.ts +1 -1
  84. package/{dist/types/flow-extension-runner/src/v2 → runtime/types/flow-extension-runner/src}/params/schema/messages.d.ts +1 -1
  85. package/{dist/types/flow-extension-runner/src/v2 → runtime/types/flow-extension-runner/src}/params/schema/normalize.d.ts +1 -1
  86. package/runtime/types/flow-extension-runner/src/{v2/params → params}/schema/parse.d.ts +1 -1
  87. package/runtime/types/flow-extension-runner/src/{v2/params → params}/types.d.ts +1 -1
  88. package/{dist/types/flow-extension-runner/src/v2 → runtime/types/flow-extension-runner/src}/registry.d.ts +2 -0
  89. package/runtime/types/flow-extension-runner/src/{v2/types.d.ts → types.d.ts} +1 -1
  90. package/runtime/types/packages/cli/src/runtime/index.d.ts +6 -5
  91. package/dist/types/flow-extension-runner/src/common/config.d.ts +0 -12
  92. package/dist/types/flow-extension-runner/src/common/context.d.ts +0 -6
  93. package/dist/types/flow-extension-runner/src/common/types.d.ts +0 -11
  94. package/dist/types/flow-extension-runner/src/v1/config.d.ts +0 -3
  95. package/dist/types/flow-extension-runner/src/v1/constants.d.ts +0 -4
  96. package/dist/types/flow-extension-runner/src/v1/index.d.ts +0 -11
  97. package/dist/types/flow-extension-runner/src/v1/namespace.d.ts +0 -9
  98. package/dist/types/flow-extension-runner/src/v1/service.d.ts +0 -29
  99. package/dist/types/flow-extension-runner/src/v1/types.d.ts +0 -13
  100. package/dist/types/flow-extension-runner/src/v2/index.d.ts +0 -39
  101. package/dist/types/jsdoc-parser/src/custom-type-defs/files.d.ts +0 -2
  102. package/dist/types/jsdoc-parser/src/index.d.ts +0 -2
  103. package/dist/types/jsdoc-parser/src/lib.d.ts +0 -42
  104. package/dist/types/jsdoc-parser/src/types.d.ts +0 -2
  105. package/runtime/types/flow-extension-runner/src/common/config.d.ts +0 -12
  106. package/runtime/types/flow-extension-runner/src/common/context.d.ts +0 -6
  107. package/runtime/types/flow-extension-runner/src/common/types.d.ts +0 -11
  108. package/runtime/types/flow-extension-runner/src/v1/config.d.ts +0 -3
  109. package/runtime/types/flow-extension-runner/src/v1/constants.d.ts +0 -4
  110. package/runtime/types/flow-extension-runner/src/v1/index.d.ts +0 -11
  111. package/runtime/types/flow-extension-runner/src/v1/namespace.d.ts +0 -9
  112. package/runtime/types/flow-extension-runner/src/v1/service.d.ts +0 -29
  113. package/runtime/types/flow-extension-runner/src/v1/types.d.ts +0 -13
  114. package/runtime/types/flow-extension-runner/src/v2/index.d.ts +0 -39
  115. package/runtime/types/jsdoc-parser/src/custom-type-defs/files.d.ts +0 -2
  116. package/runtime/types/jsdoc-parser/src/index.d.ts +0 -2
  117. package/runtime/types/jsdoc-parser/src/lib.d.ts +0 -42
  118. package/runtime/types/jsdoc-parser/src/types.d.ts +0 -2
  119. package/runtime/types/shared/src/constants/activity-log.d.ts +0 -1573
  120. package/runtime/types/shared/src/constants/ai-agent-tools.d.ts +0 -20
  121. package/runtime/types/shared/src/constants/ai.d.ts +0 -11
  122. package/runtime/types/shared/src/constants/api-keys.d.ts +0 -1
  123. package/runtime/types/shared/src/constants/app.d.ts +0 -57
  124. package/runtime/types/shared/src/constants/billing.d.ts +0 -16
  125. package/runtime/types/shared/src/constants/compliances.d.ts +0 -3
  126. package/runtime/types/shared/src/constants/data-types.d.ts +0 -26
  127. package/runtime/types/shared/src/constants/docs.d.ts +0 -6
  128. package/runtime/types/shared/src/constants/error-codes.d.ts +0 -20
  129. package/runtime/types/shared/src/constants/flow.d.ts +0 -12
  130. package/runtime/types/shared/src/constants/index.d.ts +0 -18
  131. package/runtime/types/shared/src/constants/knowledge-base.d.ts +0 -15
  132. package/runtime/types/shared/src/constants/notification-types.d.ts +0 -1234
  133. package/runtime/types/shared/src/constants/notifications.d.ts +0 -10
  134. package/runtime/types/shared/src/constants/oauth-connection-error.d.ts +0 -3
  135. package/runtime/types/shared/src/constants/patterns.d.ts +0 -28
  136. package/runtime/types/shared/src/constants/retry-policy.d.ts +0 -30
  137. package/runtime/types/shared/src/constants/severity.d.ts +0 -9
  138. package/runtime/types/shared/src/constants/shared-extensions-search.d.ts +0 -6
  139. package/runtime/types/shared/src/constants/shared-extensions.d.ts +0 -56
  140. package/runtime/types/shared/src/constants/zod.d.ts +0 -2
  141. package/runtime/types/shared/src/errors/api.d.ts +0 -15
  142. package/runtime/types/shared/src/errors/base.d.ts +0 -38
  143. package/runtime/types/shared/src/errors/common.d.ts +0 -39
  144. package/runtime/types/shared/src/errors/index.d.ts +0 -14
  145. package/runtime/types/shared/src/errors/k8s.d.ts +0 -14
  146. package/runtime/types/shared/src/errors/message.d.ts +0 -48
  147. package/runtime/types/shared/src/errors/oauth-connection.d.ts +0 -4
  148. package/runtime/types/shared/src/errors/open-search.d.ts +0 -4
  149. package/runtime/types/shared/src/errors/s3.d.ts +0 -11
  150. package/runtime/types/shared/src/extensions/zod.d.ts +0 -25
  151. package/runtime/types/shared/src/scheme/access-keys/dto.d.ts +0 -101
  152. package/runtime/types/shared/src/scheme/access-keys/index.d.ts +0 -2
  153. package/runtime/types/shared/src/scheme/account/dto.d.ts +0 -63
  154. package/runtime/types/shared/src/scheme/account/index.d.ts +0 -1
  155. package/runtime/types/shared/src/scheme/activity-log-base.d.ts +0 -35
  156. package/runtime/types/shared/src/scheme/ai-agent-tools/dto.d.ts +0 -69
  157. package/runtime/types/shared/src/scheme/ai-agent-tools/index.d.ts +0 -2
  158. package/runtime/types/shared/src/scheme/ai-agent-tools/parameters.d.ts +0 -7
  159. package/runtime/types/shared/src/scheme/ai-router/dto.d.ts +0 -23
  160. package/runtime/types/shared/src/scheme/ai-router/index.d.ts +0 -2
  161. package/runtime/types/shared/src/scheme/api-keys/dto.d.ts +0 -28
  162. package/runtime/types/shared/src/scheme/api-keys/index.d.ts +0 -2
  163. package/runtime/types/shared/src/scheme/app/index.d.ts +0 -1
  164. package/runtime/types/shared/src/scheme/app/java.dto.d.ts +0 -6
  165. package/runtime/types/shared/src/scheme/billing/index.d.ts +0 -1
  166. package/runtime/types/shared/src/scheme/billing/java.dto.d.ts +0 -181
  167. package/runtime/types/shared/src/scheme/crm/billing.d.ts +0 -149
  168. package/runtime/types/shared/src/scheme/crm/dto.d.ts +0 -218
  169. package/runtime/types/shared/src/scheme/crm/index.d.ts +0 -3
  170. package/runtime/types/shared/src/scheme/data-types/index.d.ts +0 -1
  171. package/runtime/types/shared/src/scheme/data-types/java.dto.d.ts +0 -22
  172. package/runtime/types/shared/src/scheme/dynamic-forms/dto.d.ts +0 -30
  173. package/runtime/types/shared/src/scheme/dynamic-forms/index.d.ts +0 -2
  174. package/runtime/types/shared/src/scheme/extensions/index.d.ts +0 -1
  175. package/runtime/types/shared/src/scheme/extensions/params-to-zod.d.ts +0 -14
  176. package/runtime/types/shared/src/scheme/flowrunner/custom-elements.d.ts +0 -383
  177. package/runtime/types/shared/src/scheme/flowrunner/index.d.ts +0 -3
  178. package/runtime/types/shared/src/scheme/flowrunner/java.dto.d.ts +0 -655
  179. package/runtime/types/shared/src/scheme/index.d.ts +0 -21
  180. package/runtime/types/shared/src/scheme/integration-connection/dto.d.ts +0 -135
  181. package/runtime/types/shared/src/scheme/integration-connection/index.d.ts +0 -2
  182. package/runtime/types/shared/src/scheme/knowledge-base/dto.d.ts +0 -776
  183. package/runtime/types/shared/src/scheme/knowledge-base/index.d.ts +0 -2
  184. package/runtime/types/shared/src/scheme/mcp-oauth/dto.d.ts +0 -9
  185. package/runtime/types/shared/src/scheme/mcp-oauth/index.d.ts +0 -2
  186. package/runtime/types/shared/src/scheme/notifications/dto.d.ts +0 -118
  187. package/runtime/types/shared/src/scheme/notifications/index.d.ts +0 -3
  188. package/runtime/types/shared/src/scheme/notifications/rest.d.ts +0 -162
  189. package/runtime/types/shared/src/scheme/onboarding/dto.d.ts +0 -29
  190. package/runtime/types/shared/src/scheme/onboarding/index.d.ts +0 -1
  191. package/runtime/types/shared/src/scheme/properties/account.d.ts +0 -3
  192. package/runtime/types/shared/src/scheme/properties/app.d.ts +0 -5
  193. package/runtime/types/shared/src/scheme/properties/billing.d.ts +0 -12
  194. package/runtime/types/shared/src/scheme/properties/common.d.ts +0 -2
  195. package/runtime/types/shared/src/scheme/properties/db.d.ts +0 -8
  196. package/runtime/types/shared/src/scheme/properties/flow-extensions.d.ts +0 -7
  197. package/runtime/types/shared/src/scheme/properties/index.d.ts +0 -7
  198. package/runtime/types/shared/src/scheme/remote-mcp-server/dto.d.ts +0 -278
  199. package/runtime/types/shared/src/scheme/remote-mcp-server/index.d.ts +0 -2
  200. package/runtime/types/shared/src/scheme/shared-extensions/base.d.ts +0 -62
  201. package/runtime/types/shared/src/scheme/shared-extensions/config.d.ts +0 -96
  202. package/runtime/types/shared/src/scheme/shared-extensions/custom-extensions.d.ts +0 -631
  203. package/runtime/types/shared/src/scheme/shared-extensions/extension.d.ts +0 -411
  204. package/runtime/types/shared/src/scheme/shared-extensions/flow-extensions.d.ts +0 -64
  205. package/runtime/types/shared/src/scheme/shared-extensions/index.d.ts +0 -17
  206. package/runtime/types/shared/src/scheme/shared-extensions/light.d.ts +0 -38
  207. package/runtime/types/shared/src/scheme/shared-extensions/list.d.ts +0 -250
  208. package/runtime/types/shared/src/scheme/shared-extensions/logs.d.ts +0 -21
  209. package/runtime/types/shared/src/scheme/shared-extensions/methods.d.ts +0 -112
  210. package/runtime/types/shared/src/scheme/shared-extensions/params-schema.d.ts +0 -48
  211. package/runtime/types/shared/src/scheme/shared-extensions/popular-pool.d.ts +0 -11
  212. package/runtime/types/shared/src/scheme/shared-extensions/resolve.d.ts +0 -373
  213. package/runtime/types/shared/src/scheme/shared-extensions/rest.d.ts +0 -9
  214. package/runtime/types/shared/src/scheme/shared-extensions/search.d.ts +0 -189
  215. package/runtime/types/shared/src/scheme/shared-extensions/service-identity.d.ts +0 -10
  216. package/runtime/types/shared/src/scheme/shared-extensions/service-info.d.ts +0 -16
  217. package/runtime/types/shared/src/scheme/shared-extensions/workspace-stack.d.ts +0 -44
  218. package/runtime/types/shared/src/scheme/workspace/dto.d.ts +0 -40
  219. package/runtime/types/shared/src/scheme/workspace/index.d.ts +0 -1
  220. package/runtime/types/shared/src/utils/object.d.ts +0 -8
  221. package/runtime/types/shared/src/utils/uuid.d.ts +0 -5
  222. package/runtime/types/shared/src/utils/versions.d.ts +0 -4
  223. package/dist/types/flow-extension-runner/src/{v2/actions → actions}/action-method.d.ts +0 -0
  224. package/dist/types/flow-extension-runner/src/{common/context-files.d.ts → context/files.d.ts} +0 -0
  225. package/dist/types/flow-extension-runner/src/{v2/context → context}/logger.d.ts +0 -0
  226. package/dist/types/flow-extension-runner/src/{v2/context → context}/method-input.d.ts +0 -0
  227. package/dist/types/flow-extension-runner/src/{v2/context → context}/proxies.d.ts +0 -0
  228. package/dist/types/flow-extension-runner/src/{v2/create-extension.d.ts → create-extension.d.ts} +0 -0
  229. package/dist/types/flow-extension-runner/src/{v2/crypto.d.ts → crypto.d.ts} +0 -0
  230. package/dist/types/flow-extension-runner/src/{v2/dictionaries → dictionaries}/dictionary-method.d.ts +0 -0
  231. package/dist/types/flow-extension-runner/src/{v2/dictionaries → dictionaries}/payload-schema.d.ts +0 -0
  232. package/dist/types/flow-extension-runner/src/{v2/loaders → loaders}/loader-method.d.ts +0 -0
  233. package/dist/types/flow-extension-runner/src/{v2/loaders → loaders}/loader-owner.d.ts +0 -0
  234. package/dist/types/flow-extension-runner/src/{v2/loaders → loaders}/payload-schema.d.ts +0 -0
  235. package/dist/types/flow-extension-runner/src/{v2/method.d.ts → method.d.ts} +0 -0
  236. package/dist/types/flow-extension-runner/src/{v2/model → model}/method-model.d.ts +0 -0
  237. package/dist/types/flow-extension-runner/src/{v2/oauth → oauth}/method-names.d.ts +0 -0
  238. package/dist/types/flow-extension-runner/src/{v2/oauth → oauth}/oauth2.d.ts +0 -0
  239. package/dist/types/flow-extension-runner/src/{v2/oauth → oauth}/system-params.d.ts +0 -0
  240. package/dist/types/flow-extension-runner/src/{v2/oauth → oauth}/types.d.ts +0 -0
  241. package/dist/types/flow-extension-runner/src/{common/constants.d.ts → params/config-types.d.ts} +0 -0
  242. package/{runtime/types/flow-extension-runner/src/v2 → dist/types/flow-extension-runner/src}/params/files-options.d.ts +4 -4
  243. /package/dist/types/flow-extension-runner/src/{v2/params → params}/index.d.ts +0 -0
  244. /package/dist/types/flow-extension-runner/src/{v2/params → params}/json/checks.d.ts +0 -0
  245. /package/dist/types/flow-extension-runner/src/{v2/params → params}/json/decode.d.ts +0 -0
  246. /package/dist/types/flow-extension-runner/src/{v2/params → params}/json/encode.d.ts +0 -0
  247. /package/dist/types/flow-extension-runner/src/{v2/params → params}/json/types.d.ts +0 -0
  248. /package/dist/types/flow-extension-runner/src/{v2/params → params}/json/values.d.ts +0 -0
  249. /package/dist/types/flow-extension-runner/src/{v2/params → params}/method-params.d.ts +0 -0
  250. /package/dist/types/flow-extension-runner/src/{v2/params → params}/params.d.ts +0 -0
  251. /package/dist/types/flow-extension-runner/src/{v2/params → params}/schema/assert-object-schema.d.ts +0 -0
  252. /package/dist/types/flow-extension-runner/src/{v2/params → params}/schema/assert-supported-schema.d.ts +0 -0
  253. /package/dist/types/flow-extension-runner/src/{v2/params → params}/schema/coerce.d.ts +0 -0
  254. /package/dist/types/flow-extension-runner/src/{v2/params → params}/schema/date-format.d.ts +0 -0
  255. /package/dist/types/flow-extension-runner/src/{v2/params → params}/schema/dates.d.ts +0 -0
  256. /package/dist/types/flow-extension-runner/src/{v2/params → params}/schema/defaults.d.ts +0 -0
  257. /package/dist/types/flow-extension-runner/src/{v2/params → params}/schema/dictionary-binding.d.ts +0 -0
  258. /package/dist/types/flow-extension-runner/src/{v2/params → params}/schema/field-plan.d.ts +0 -0
  259. /package/dist/types/flow-extension-runner/src/{v2/params → params}/schema/introspect.d.ts +0 -0
  260. /package/dist/types/flow-extension-runner/src/{v2/params → params}/schema/labels.d.ts +0 -0
  261. /package/dist/types/flow-extension-runner/src/{v2/params → params}/schema/notices.d.ts +0 -0
  262. /package/dist/types/flow-extension-runner/src/{v2/params → params}/widget-types.d.ts +0 -0
  263. /package/dist/types/flow-extension-runner/src/{v2/params → params}/zod.d.ts +0 -0
  264. /package/dist/types/flow-extension-runner/src/{v2/path.d.ts → path.d.ts} +0 -0
  265. /package/dist/types/flow-extension-runner/src/{v2/polling-triggers → polling-triggers}/mechanisms.d.ts +0 -0
  266. /package/dist/types/flow-extension-runner/src/{v2/polling-triggers → polling-triggers}/method-names.d.ts +0 -0
  267. /package/dist/types/flow-extension-runner/src/{v2/polling-triggers → polling-triggers}/polling-triggers.d.ts +0 -0
  268. /package/dist/types/flow-extension-runner/src/{v2/polling-triggers → polling-triggers}/system-params.d.ts +0 -0
  269. /package/dist/types/flow-extension-runner/src/{v2/polling-triggers → polling-triggers}/trigger-method.d.ts +0 -0
  270. /package/dist/types/flow-extension-runner/src/{v2/polling-triggers → polling-triggers}/types.d.ts +0 -0
  271. /package/dist/types/flow-extension-runner/src/{v2/realtime-triggers → realtime-triggers}/method-names.d.ts +0 -0
  272. /package/dist/types/flow-extension-runner/src/{v2/realtime-triggers → realtime-triggers}/realtime-setup.d.ts +0 -0
  273. /package/dist/types/flow-extension-runner/src/{v2/realtime-triggers → realtime-triggers}/system-params.d.ts +0 -0
  274. /package/dist/types/flow-extension-runner/src/{v2/realtime-triggers → realtime-triggers}/trigger-method.d.ts +0 -0
  275. /package/dist/types/flow-extension-runner/src/{v2/realtime-triggers → realtime-triggers}/types.d.ts +0 -0
  276. /package/dist/types/flow-extension-runner/src/{v2/realtime-triggers → realtime-triggers}/verify.d.ts +0 -0
  277. /package/dist/types/flow-extension-runner/src/{v2/result.d.ts → result.d.ts} +0 -0
  278. /package/dist/types/flow-extension-runner/src/{v2/system-method.d.ts → system-method.d.ts} +0 -0
  279. /package/runtime/types/flow-extension-runner/src/{v2/actions → actions}/action-method.d.ts +0 -0
  280. /package/runtime/types/flow-extension-runner/src/{common/context-files.d.ts → context/files.d.ts} +0 -0
  281. /package/runtime/types/flow-extension-runner/src/{v2/context → context}/logger.d.ts +0 -0
  282. /package/runtime/types/flow-extension-runner/src/{v2/context → context}/method-input.d.ts +0 -0
  283. /package/runtime/types/flow-extension-runner/src/{v2/context → context}/proxies.d.ts +0 -0
  284. /package/runtime/types/flow-extension-runner/src/{v2/create-extension.d.ts → create-extension.d.ts} +0 -0
  285. /package/runtime/types/flow-extension-runner/src/{v2/crypto.d.ts → crypto.d.ts} +0 -0
  286. /package/runtime/types/flow-extension-runner/src/{v2/dictionaries → dictionaries}/dictionary-method.d.ts +0 -0
  287. /package/runtime/types/flow-extension-runner/src/{v2/dictionaries → dictionaries}/payload-schema.d.ts +0 -0
  288. /package/runtime/types/flow-extension-runner/src/{v2/loaders → loaders}/loader-method.d.ts +0 -0
  289. /package/runtime/types/flow-extension-runner/src/{v2/loaders → loaders}/loader-owner.d.ts +0 -0
  290. /package/runtime/types/flow-extension-runner/src/{v2/loaders → loaders}/payload-schema.d.ts +0 -0
  291. /package/runtime/types/flow-extension-runner/src/{v2/method.d.ts → method.d.ts} +0 -0
  292. /package/runtime/types/flow-extension-runner/src/{v2/model → model}/method-model.d.ts +0 -0
  293. /package/runtime/types/flow-extension-runner/src/{v2/oauth → oauth}/method-names.d.ts +0 -0
  294. /package/runtime/types/flow-extension-runner/src/{v2/oauth → oauth}/oauth2.d.ts +0 -0
  295. /package/runtime/types/flow-extension-runner/src/{v2/oauth → oauth}/system-params.d.ts +0 -0
  296. /package/runtime/types/flow-extension-runner/src/{v2/oauth → oauth}/types.d.ts +0 -0
  297. /package/runtime/types/flow-extension-runner/src/{common/constants.d.ts → params/config-types.d.ts} +0 -0
  298. /package/{dist/types/flow-extension-runner/src/v2 → runtime/types/flow-extension-runner/src}/params/files-options.d.ts +0 -0
  299. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/index.d.ts +0 -0
  300. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/json/checks.d.ts +0 -0
  301. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/json/decode.d.ts +0 -0
  302. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/json/encode.d.ts +0 -0
  303. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/json/types.d.ts +0 -0
  304. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/json/values.d.ts +0 -0
  305. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/method-params.d.ts +0 -0
  306. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/params.d.ts +0 -0
  307. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/schema/assert-object-schema.d.ts +0 -0
  308. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/schema/assert-supported-schema.d.ts +0 -0
  309. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/schema/coerce.d.ts +0 -0
  310. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/schema/date-format.d.ts +0 -0
  311. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/schema/dates.d.ts +0 -0
  312. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/schema/defaults.d.ts +0 -0
  313. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/schema/dictionary-binding.d.ts +0 -0
  314. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/schema/field-plan.d.ts +0 -0
  315. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/schema/introspect.d.ts +0 -0
  316. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/schema/labels.d.ts +0 -0
  317. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/schema/notices.d.ts +0 -0
  318. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/widget-types.d.ts +0 -0
  319. /package/runtime/types/flow-extension-runner/src/{v2/params → params}/zod.d.ts +0 -0
  320. /package/runtime/types/flow-extension-runner/src/{v2/path.d.ts → path.d.ts} +0 -0
  321. /package/runtime/types/flow-extension-runner/src/{v2/polling-triggers → polling-triggers}/mechanisms.d.ts +0 -0
  322. /package/runtime/types/flow-extension-runner/src/{v2/polling-triggers → polling-triggers}/method-names.d.ts +0 -0
  323. /package/runtime/types/flow-extension-runner/src/{v2/polling-triggers → polling-triggers}/polling-triggers.d.ts +0 -0
  324. /package/runtime/types/flow-extension-runner/src/{v2/polling-triggers → polling-triggers}/system-params.d.ts +0 -0
  325. /package/runtime/types/flow-extension-runner/src/{v2/polling-triggers → polling-triggers}/trigger-method.d.ts +0 -0
  326. /package/runtime/types/flow-extension-runner/src/{v2/polling-triggers → polling-triggers}/types.d.ts +0 -0
  327. /package/runtime/types/flow-extension-runner/src/{v2/realtime-triggers → realtime-triggers}/method-names.d.ts +0 -0
  328. /package/runtime/types/flow-extension-runner/src/{v2/realtime-triggers → realtime-triggers}/realtime-setup.d.ts +0 -0
  329. /package/runtime/types/flow-extension-runner/src/{v2/realtime-triggers → realtime-triggers}/system-params.d.ts +0 -0
  330. /package/runtime/types/flow-extension-runner/src/{v2/realtime-triggers → realtime-triggers}/trigger-method.d.ts +0 -0
  331. /package/runtime/types/flow-extension-runner/src/{v2/realtime-triggers → realtime-triggers}/types.d.ts +0 -0
  332. /package/runtime/types/flow-extension-runner/src/{v2/realtime-triggers → realtime-triggers}/verify.d.ts +0 -0
  333. /package/runtime/types/flow-extension-runner/src/{v2/result.d.ts → result.d.ts} +0 -0
  334. /package/runtime/types/flow-extension-runner/src/{v2/system-method.d.ts → system-method.d.ts} +0 -0
@@ -61,7 +61,7 @@ logo for that one item. Omit it and the item inherits the service's.
61
61
  | `logo` | string | ✓ | Icon path, resolved **inside the service's `public/` folder** — see [Folder layout](#folder-layout). |
62
62
  | `appearanceColors` | `[string, string]` | – | `[primary, secondary]`. |
63
63
  | `usesFileStorage` | boolean | – | `true` provisions `ctx.files`; when false, `ctx.files` is a proxy that throws. Default false. See [10-files-api.md](10-files-api.md). |
64
- | `serviceClassName` | string | – | **Deprecated — will be removed soon. Shared extensions only.** The class name of a shared extension rewritten from the legacy JSDoc class format (`'GeminiAIService'`). It is published as `serviceInfo.serviceClassName` (absent otherwise), so flows, configs and connections saved against the old service keep resolving to this one. Keep it unchanged once set. Never set it on a new service or a custom extension. |
64
+ | `serviceClassName` | string | – | **Deprecated — will be removed soon. Shared extensions only.** The class name of a shared extension that was previously published as a class-based service (`'GeminiAIService'`). It is published as `serviceInfo.serviceClassName` (absent otherwise), so flows, configs and connections saved against the old service keep resolving to this one. Keep it unchanged once set. Never set it on a new service or a custom extension. |
65
65
  | `configItems` | `z.object` | – | App + shared config (see [02-zod-types.md](02-zod-types.md)). → `appConfigDescriptions` / `sharedConfigDescriptions`. Omit when the service needs none — see [Services with no credentials](#services-with-no-credentials); a plain object of fields is **not** accepted (see [03-parameters.md](03-parameters.md)). |
66
66
  | `initContext` | fn | – | `({ config, oauth }) => context`; runs once per invocation. Runs for OAuth flows too (`oauth` may be empty). |
67
67
  | `apiRequest` | fn | – | Shared HTTP helper (envelope-unwrap, error-normalize, redacted logging). See [04-http-requests.md](04-http-requests.md). |
@@ -19,7 +19,7 @@ and behaviors.
19
19
  | `z.union([...])` | the **first** branch's widget — see below | | | | |
20
20
  | `z.filesUploadOptions([...])`, `z.filesListOptions([...])`, `z.filesGetOptions([...])`, `z.filesDeleteOptions([...])` | nested form — the platform's own file-storage options, one group per Files call (see [03-parameters.md](03-parameters.md)) | | | | |
21
21
  | | | | `.required()` | `z.unknown()` / `z.any()` field | required, any value — the open types are the only ones optional by default (see [Any value, but required](#any-value-but-required)) |
22
- | | | | `.secret()` | `z.string()` config field | Masks the input, with a reveal toggle. **Display only** — see below |
22
+ | | | | `.secret()` | `z.string()` config field | Masks the input, with a reveal toggle; once saved the value is write-only in the console — see below |
23
23
  | | | | `.dynamicProps({ dependsOn, execute })` | top-level **action** param: `z.looseObject()` or `z.array(z.looseObject())` | the object's inner fields are loaded at design time from other params (see [03-parameters.md](03-parameters.md)) |
24
24
 
25
25
  Notes:
@@ -37,10 +37,11 @@ Notes:
37
37
  installed as a *custom* extension has no shared tier at all — the customer fills in every item in one
38
38
  dialog. See `configItems` in [01-service-structure.md](01-service-structure.md) and the output mapping in
39
39
  [11-output-model.md](11-output-model.md).
40
- - `.secret()` marks a **`z.string()` config field** as sensitive: the console renders it masked, with a
41
- toggle to reveal it. It is **display only** — the value is stored, sent and validated exactly as it would
42
- be without it, so it hides a credential from someone looking over a shoulder rather than protecting it.
43
- It has no effect anywhere else: not on `z.text()`, which has no password mode, and not on an action or
40
+ - `.secret()` marks a **`z.string()` config field** as sensitive: the console renders it masked while it is
41
+ typed, with a toggle to reveal it. Once saved, the value is **write-only** in the console: it shows a hint
42
+ (the last characters) with **Replace** and **Clear** buttons and is never shown again, and the platform may
43
+ store it encrypted. Your handler still receives the plain value in `config`, validated exactly as it would
44
+ be without `.secret()`. It has no effect anywhere else: not on `z.text()`, which has no password mode, and not on an action or
44
45
  trigger param, whose value lives in the flow definition and is readable through the API — masking that
45
46
  input would suggest a protection that is not there. Put credentials in a `z.string()` config item.
46
47
  - `.dictionary(ref)` binds a param to a dictionary for dynamic options and auto-derives its `dependsOn` — the
@@ -8,7 +8,7 @@ via `.dictionary(ref)` on a param (see [02-zod-types.md](02-zod-types.md)). A di
8
8
  | Property | Type | Description |
9
9
  |---|---|---|
10
10
  | `id` | string | Dictionary id — **starts with `get`, ends with `Dictionary`** (`getChatsDictionary`). |
11
- | `category` | string | Optional grouping label. Defaults to `''` — unlike an action's `category`, which is required. The v1 convention was to leave dictionaries uncategorised, so set it only to match a v1 dictionary that declared one. |
11
+ | `category` | string | Optional grouping label. Defaults to `''` — unlike an action's `category`, which is required. |
12
12
  | `label` | string | **Human-readable name** → `operationName`. Dictionaries are shown in the UI and exposed to AI tools, so **always set a label**. Falls back to `id` when omitted. |
13
13
  | `description` | string | Description. |
14
14
  | `criteria` | `z.object` | Optional dependency inputs (become `dependsOn` on consumers). Omit when the dictionary depends on nothing; declared ⇒ must be a `z.object` (see [03-parameters.md](03-parameters.md)). |
@@ -31,7 +31,7 @@ The names change on the way out, which matters when you inspect a built model:
31
31
  | `appearanceColors` | per-method `colorStart` / `colorEnd` (every method inherits them) |
32
32
  | `label` | per-method `operationName` |
33
33
 
34
- `serviceInfo` also carries `requireOAuth`, and the definition root carries `runnerVersion` (`'v2'`). A
34
+ `serviceInfo` also carries `requireOAuth`. A
35
35
  service's `appearanceColors` are not published on `serviceInfo` itself.
36
36
 
37
37
  ## The schema travels too
@@ -156,8 +156,7 @@ function itself never ships; only its name does.
156
156
  | `field.dynamicProps({ dependsOn, execute })` | `metaInfo.args[field].schemaLoader` = the loader's name, `metaInfo.args[field].dependsOn` = `dependsOn` (`[]` when omitted); in `paramsSchema`, the field's `meta.frDynamicProps` = `{ id, dependsOn }` and the object carries `loose: true` | `<actionId>_<field>_DynamicProps` |
157
157
  | `dynamicParams: { dependsOn, execute }` | `metaInfo.dynamicParams` = `{ methodName, dependsOn }` | `<actionId>_DynamicParams` |
158
158
 
159
- - `schemaLoader` is the key a legacy (class-based) service uses for the same purpose, so a consumer reads both
160
- the same way. The field's own `bodyParams` entry and `paramsSchema` entry stay as declared.
159
+ - The field's own `bodyParams` entry and `paramsSchema` entry stay as declared.
161
160
  - `frDynamicProps` in `paramsSchema` is the plain ref `{ id, dependsOn }`, written next to the other `fr*`
162
161
  meta keys (`frDictionary`, `frLabels`, …).
163
162
  - `loose: true` marks an object that keeps the keys it does not declare (`z.looseObject()`); without it a
@@ -184,5 +183,3 @@ Both are built from the one schema `execute` returned, so they cannot disagree.
184
183
  field's own static keys come **first** in both. A loaded field that carries `.dictionary(ref)` publishes the
185
184
  dictionary on its `params` entry.
186
185
 
187
- A legacy loader differs: it answers with a plain list of param definitions, not this object. Consumers accept
188
- both.
@@ -15,8 +15,8 @@ Two different surfaces, easily confused:
15
15
 
16
16
  | Surface | How you get it | Contains |
17
17
  |---|---|---|
18
- | **`Flowrunner` global** | always present when the platform runs your service; a harness gets it as a side effect of importing `@flowrunner/cli/runtime` | `Request`, `z`, `crypto`, `createExtension`, `getExtension`, `ServerCode` |
19
- | **`require('@flowrunner/cli/runtime')`** | explicit import — **harness-side only** | `buildServiceDefinition`, `getServiceConfigs`, `runServiceMethod`, `detectVersion`, `resetRegistry`, `parseJsDocToServiceJson` |
18
+ | **`Flowrunner` global** | always present when the platform runs your service; a harness gets it as a side effect of importing `@flowrunner/cli/runtime` | `Request`, `z`, `crypto`, `createExtension`, `getExtension` |
19
+ | **`require('@flowrunner/cli/runtime')`** | explicit import — **harness-side only** | `buildServiceDefinition`, `getServiceConfigs`, `runServiceMethod`, `resetRegistry` |
20
20
 
21
21
  A service module uses only the global, and `require`s nothing. Note that importing the module is what
22
22
  installs the global — there is no separate namespace export to pull in.
@@ -31,7 +31,6 @@ than a syntax error. Check it directly:
31
31
  | `buildServiceDefinition` | `(serviceId, serviceEntryPointPath)` | `SharedExtensionDefinition` — `serviceInfo` + `methodsMap` (see [11-output-model.md](11-output-model.md)) |
32
32
  | `getServiceConfigs` | `(serviceId, serviceEntryPointPath)` | `ConfigItem[]` — the published config descriptions |
33
33
  | `runServiceMethod` | `(data: RunServiceMethodData)` | `Promise<unknown>` — invokes one method, SYSTEM methods included |
34
- | `detectVersion` | `(serviceId, serviceEntryPointPath)` | `'v1' \| 'v2'` |
35
34
  | `resetRegistry` | `()` | clears the extension registry — **not sufficient on its own**, see below |
36
35
 
37
36
  ```js
@@ -62,8 +62,8 @@ See [01-service-structure.md](01-service-structure.md) for `configItems` and `in
62
62
 
63
63
  **`z.text()`, because a PEM block is multi-line** — it draws a textarea, where `z.string()` would put a
64
64
  27-line certificate through a one-line box. The cost is that the key is on screen in clear text:
65
- `.secret()` masks a `z.string()` config field only and is a no-op on `z.text()`
66
- ([02-zod-types.md](02-zod-types.md)). If that matters more than the textarea, ship the key as a file in the
65
+ `.secret()` (masked input, write-only once saved) applies to a `z.string()` config field only and is a no-op on
66
+ `z.text()` ([02-zod-types.md](02-zod-types.md)). If that matters more than the textarea, ship the key as a file in the
67
67
  service folder instead — the whole folder is deployed, so `require('fs').readFileSync(path.join(__dirname,
68
68
  '../certs/client.key'))` reads it in the pod.
69
69
 
@@ -74,9 +74,8 @@ service folder instead — the whole folder is deployed, so `require('fs').readF
74
74
  - **`ca` replaces the default trust store** for that request, the way `curl --cacert` does. Pass the whole
75
75
  chain needed to verify the server, not just the leaf.
76
76
  - **The private key is credential material.** Never inline it in the source and never put it in a URL —
77
- declare it as a config field or read it from a file in the service folder. Whichever way, the value is
78
- stored and transmitted in clear text; masking a config field with `.secret()` hides it from a passer-by,
79
- it does not protect it. The client keeps the key out of verbose output and off the request's enumerable
77
+ declare it as a config field or read it from a file in the service folder. Whichever way, a value that is not a `.secret()` config field is
78
+ stored and transmitted in clear text, and a `z.text()` field cannot be `.secret()`. The client keeps the key out of verbose output and off the request's enumerable
80
79
  properties, so `console.log(request)` and `JSON.stringify(request)` will not leak it — but your own logging
81
80
  still can, so redact there too ([04-http-requests.md](04-http-requests.md)).
82
81
 
@@ -115,7 +115,7 @@ and testing one are separate jobs; do not read it while writing a service.
115
115
 
116
116
  That is also separate from **checking that a service builds**, which needs no suite at all and is part of
117
117
  writing one: `require('@flowrunner/cli/runtime')` exports `buildServiceDefinition`, `getServiceConfigs`,
118
- `runServiceMethod`, `detectVersion`, `resetRegistry` and `parseJsDocToServiceJson`, and importing it installs
119
- the `Flowrunner` global (`Request`, `z`, `crypto`, `createExtension`, `getExtension`, `ServerCode`).
118
+ `runServiceMethod` and `resetRegistry`, and importing it installs
119
+ the `Flowrunner` global (`Request`, `z`, `crypto`, `createExtension`, `getExtension`).
120
120
  Signatures, a copy-paste snippet, and the boundary between a throwaway check and a suite are in
121
121
  [13-runtime-contracts.md](13-runtime-contracts.md).