@zackbart/connecta 0.38.0 → 0.39.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 (177) hide show
  1. package/CHANGELOG.md +63 -0
  2. package/README.md +3 -2
  3. package/bin/version.mjs +1 -1
  4. package/dist/agent-routes.js +231 -0
  5. package/dist/auth/downstream-oauth/consent.js +519 -0
  6. package/dist/auth/downstream-oauth/grant-store.js +439 -0
  7. package/dist/auth/downstream-oauth/refresh-coordinator.js +562 -0
  8. package/dist/auth/downstream-oauth/refresh-records.js +447 -0
  9. package/dist/auth/downstream-oauth/sdk-hooks.js +242 -0
  10. package/dist/auth/downstream-oauth.js +66 -2382
  11. package/dist/auth/native.js +27 -0
  12. package/dist/auth/oauth-grant.js +13 -0
  13. package/dist/auth/static-oauth.js +153 -131
  14. package/dist/auth-elicitation.js +7 -1
  15. package/dist/authorization-handoff.js +11 -5
  16. package/dist/catalog-cache.js +130 -43
  17. package/dist/catalog-policy.js +18 -0
  18. package/dist/catalog-service.js +284 -47
  19. package/dist/catalog.js +18 -2
  20. package/dist/config.d.ts +16 -11
  21. package/dist/config.js +9 -6
  22. package/dist/connector-caller.d.ts +1 -1
  23. package/dist/connector-health.js +59 -0
  24. package/dist/connector-status.js +117 -0
  25. package/dist/connectors/api-connector.d.ts +7 -2
  26. package/dist/connectors/api-connector.js +7 -4
  27. package/dist/connectors/negotiation-cache.js +22 -4
  28. package/dist/connectors/remote-mcp/call.js +164 -0
  29. package/dist/connectors/remote-mcp/catalog.js +278 -0
  30. package/dist/connectors/remote-mcp/config.js +263 -0
  31. package/dist/connectors/remote-mcp/connection.js +671 -0
  32. package/dist/connectors/remote-mcp/errors.js +488 -0
  33. package/dist/connectors/remote-mcp/oauth.js +469 -0
  34. package/dist/connectors/remote-mcp/resources.js +473 -0
  35. package/dist/connectors/remote-mcp/runtime.js +1 -0
  36. package/dist/connectors/remote-mcp/transport.js +544 -0
  37. package/dist/connectors/remote-mcp.js +59 -2863
  38. package/dist/credential-contract.d.ts +23 -0
  39. package/dist/credential-reads.js +17 -0
  40. package/dist/credential-verification.js +53 -0
  41. package/dist/credentials.d.ts +7 -0
  42. package/dist/credentials.js +60 -25
  43. package/dist/describe-config.d.ts +12 -2
  44. package/dist/describe-config.js +2 -0
  45. package/dist/discovery-health.js +199 -0
  46. package/dist/downstream-input.js +2 -0
  47. package/dist/errors.d.ts +55 -17
  48. package/dist/errors.js +95 -41
  49. package/dist/execute.js +152 -114
  50. package/dist/executor-result.js +3 -1
  51. package/dist/guest-functions.js +83 -0
  52. package/dist/guest-runtime.js +60 -19
  53. package/dist/guest-types.d.ts +19 -5
  54. package/dist/http/argument-problems.js +35 -0
  55. package/dist/http/errors.js +5 -4
  56. package/dist/http/fields.js +192 -13
  57. package/dist/http/hatch-response.js +73 -0
  58. package/dist/http/hatch.js +88 -23
  59. package/dist/http/oauth.js +3 -2
  60. package/dist/http/provider.js +32 -4
  61. package/dist/http/safety.js +8 -0
  62. package/dist/http/tools.js +44 -23
  63. package/dist/index.d.ts +1 -1
  64. package/dist/index.js +9 -2
  65. package/dist/invocation.js +21 -6
  66. package/dist/membership.d.ts +13 -5
  67. package/dist/membership.js +34 -2
  68. package/dist/meta-tools.js +23 -8
  69. package/dist/native-recovery.js +4 -16
  70. package/dist/native-tools.js +4 -1
  71. package/dist/oauth-sealing.js +10 -0
  72. package/dist/operation-vocabulary.js +135 -13
  73. package/dist/operator-record.d.ts +2 -2
  74. package/dist/operator-record.js +1 -0
  75. package/dist/operator-ui/contract.d.ts +10 -0
  76. package/dist/operator-ui/generated.js +2 -2
  77. package/dist/operator-ui/model.d.ts +22 -1
  78. package/dist/providers/_shared/rest/operation-index.js +48 -50
  79. package/dist/providers/_shared/rest/value-safety.js +80 -0
  80. package/dist/providers/breeze/api.js +7 -1
  81. package/dist/providers/breeze/skill.generated.js +1 -1
  82. package/dist/providers/breeze/tools.js +4 -3
  83. package/dist/providers/ccb/api.js +2 -1
  84. package/dist/providers/ccb/index.js +5 -0
  85. package/dist/providers/ccb/skill.generated.js +1 -1
  86. package/dist/providers/cloudflare/api.js +8 -1
  87. package/dist/providers/cloudflare/skill.generated.js +1 -1
  88. package/dist/providers/docs/lib/schemas.js +24 -22
  89. package/dist/providers/docs/safety.js +2 -0
  90. package/dist/providers/docs/skill.generated.js +1 -1
  91. package/dist/providers/docs/tools.js +2 -4
  92. package/dist/providers/drive/api.js +1 -0
  93. package/dist/providers/drive/lib/contracts.js +8 -5
  94. package/dist/providers/drive/skill.generated.js +1 -1
  95. package/dist/providers/drive/tools.js +11 -16
  96. package/dist/providers/forms/api.js +1 -0
  97. package/dist/providers/forms/skill.generated.js +1 -1
  98. package/dist/providers/forms/tools.js +10 -7
  99. package/dist/providers/github/api.js +1 -0
  100. package/dist/providers/github/lib/discovery.js +1 -1
  101. package/dist/providers/github/skill.generated.js +1 -1
  102. package/dist/providers/github/tools.js +61 -17
  103. package/dist/providers/gmail/lib/schemas.js +60 -50
  104. package/dist/providers/gmail/skill.generated.js +1 -1
  105. package/dist/providers/gmail/tools.js +7 -5
  106. package/dist/providers/granola/index.js +2 -0
  107. package/dist/providers/granola/skill.generated.js +1 -1
  108. package/dist/providers/overflow/api.js +7 -1
  109. package/dist/providers/overflow/skill.generated.js +1 -1
  110. package/dist/providers/planning-center/api.js +3 -1
  111. package/dist/providers/planning-center/lib/constants.d.ts +1 -1
  112. package/dist/providers/planning-center/skill.generated.js +1 -1
  113. package/dist/providers/quickbooks/safety.js +80 -39
  114. package/dist/providers/quickbooks/skill.generated.js +1 -1
  115. package/dist/providers/sheets/api.js +1 -0
  116. package/dist/providers/sheets/skill.generated.js +1 -1
  117. package/dist/providers/sheets/tools.js +13 -14
  118. package/dist/providers/slides/skill.generated.js +1 -1
  119. package/dist/providers/slides/tools.js +15 -13
  120. package/dist/providers/stripe/skill.generated.js +1 -1
  121. package/dist/providers/tithely/api.js +3 -1
  122. package/dist/providers/tithely/skill.generated.js +1 -1
  123. package/dist/providers/vercel/api.js +1 -1
  124. package/dist/providers/vercel/skill.generated.js +1 -1
  125. package/dist/providers/vercel/tools.js +4 -3
  126. package/dist/registry.d.ts +10 -4
  127. package/dist/registry.js +41 -13
  128. package/dist/routes/credentials.js +129 -60
  129. package/dist/routes/dispatch.js +5 -1
  130. package/dist/routes/mcp.js +30 -14
  131. package/dist/routes/operator.js +2 -2
  132. package/dist/routes/shared.d.ts +6 -1
  133. package/dist/routes/shared.js +7 -1
  134. package/dist/routes/ui-config.js +2 -2
  135. package/dist/routes/ui-data.js +126 -20
  136. package/dist/routes/ui.js +16 -0
  137. package/dist/runtime/call.js +7 -2
  138. package/dist/runtime/native-storage.js +9 -0
  139. package/dist/runtime/request-reads.js +182 -0
  140. package/dist/runtime/request-scope.js +16 -0
  141. package/dist/runtime/storage.js +12 -0
  142. package/dist/skills.js +37 -20
  143. package/dist/storage/keys.js +53 -3
  144. package/dist/storage/memory.js +8 -2
  145. package/dist/storage/sql-native.js +27 -0
  146. package/dist/storage/sql.js +12 -2
  147. package/dist/storage-digest.js +32 -0
  148. package/dist/timeout.js +8 -0
  149. package/dist/types.d.ts +33 -0
  150. package/dist/usage-guide.js +16 -35
  151. package/dist/validate.d.ts +3 -0
  152. package/dist/validate.js +220 -158
  153. package/dist/version.d.ts +1 -1
  154. package/dist/version.js +1 -1
  155. package/dist/write-outcome.js +0 -3
  156. package/documentation/README.md +13 -13
  157. package/documentation/architecture.md +350 -19
  158. package/documentation/auth.md +217 -63
  159. package/documentation/code-mode.md +122 -39
  160. package/documentation/deploying.md +6 -3
  161. package/documentation/integrating.md +15 -1
  162. package/documentation/meta-tools.md +220 -46
  163. package/documentation/migration-0.33.md +5 -1
  164. package/documentation/migration-0.34.md +3 -1
  165. package/documentation/operator-tests.md +1 -1
  166. package/documentation/operator-ui.md +105 -12
  167. package/documentation/pool-membership-upgrade.md +44 -0
  168. package/documentation/providers.md +105 -0
  169. package/examples/worker/AGENTS.md +10 -10
  170. package/examples/worker/README.md +4 -3
  171. package/examples/worker/src/connecta.config.ts +1 -0
  172. package/guides/connecting-agents.md +2 -1
  173. package/guides/how-it-works.md +4 -2
  174. package/package.json +1 -1
  175. package/templates/node/AGENTS.md +13 -12
  176. package/templates/node/package.json +1 -1
  177. package/templates/node/src/connecta.config.ts +1 -0
package/dist/operator-ui/contract.d.ts CHANGED
@@ -25,6 +25,16 @@ export interface OperatorConnectorOverlay {
25
25
  catalogAgeMs: number | null;
26
26
  /** Latest visible call in the bounded activity window, or null when unknown. */
27
27
  lastCall: OperatorLastCall | null;
28
+ /**
29
+ * Age of the stored status observation this row shows, when it came from
30
+ * storage rather than a live read. Its tools may be empty until a live read.
31
+ */
32
+ observedAgeMs?: number;
33
+ /**
34
+ * Browser-only: when that stored observation was made, in epoch
35
+ * milliseconds, fixed once as the row lands so its age keeps counting.
36
+ */
37
+ observedAt?: number;
28
38
  }
29
39
  /** Whole connector access, or exact tool grants. `requireReadOnly` is always false since guarded grants were removed. */
30
40
  export interface OperatorGrant {