@xeonr/pipelines-sdk 0.1.0 → 0.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 (106) hide show
  1. package/README.md +247 -24
  2. package/dist/client.d.ts +73 -3
  3. package/dist/client.d.ts.map +1 -1
  4. package/dist/client.js +48 -1
  5. package/dist/client.js.map +1 -1
  6. package/dist/errors.d.ts +42 -6
  7. package/dist/errors.d.ts.map +1 -1
  8. package/dist/errors.js +45 -2
  9. package/dist/errors.js.map +1 -1
  10. package/dist/gen/xeonr/pipelines/private/v1/attempt_pb.d.ts +173 -12
  11. package/dist/gen/xeonr/pipelines/private/v1/attempt_pb.d.ts.map +1 -1
  12. package/dist/gen/xeonr/pipelines/private/v1/attempt_pb.js +45 -28
  13. package/dist/gen/xeonr/pipelines/private/v1/attempt_pb.js.map +1 -1
  14. package/dist/gen/xeonr/pipelines/private/v1/step_local_pb.d.ts +136 -17
  15. package/dist/gen/xeonr/pipelines/private/v1/step_local_pb.d.ts.map +1 -1
  16. package/dist/gen/xeonr/pipelines/private/v1/step_local_pb.js +42 -35
  17. package/dist/gen/xeonr/pipelines/private/v1/step_local_pb.js.map +1 -1
  18. package/dist/gen/xeonr/pipelines/private/v1/worker_pb.d.ts +346 -15
  19. package/dist/gen/xeonr/pipelines/private/v1/worker_pb.d.ts.map +1 -1
  20. package/dist/gen/xeonr/pipelines/private/v1/worker_pb.js +105 -10
  21. package/dist/gen/xeonr/pipelines/private/v1/worker_pb.js.map +1 -1
  22. package/dist/gen/xeonr/pipelines/v1/common_pb.d.ts +38 -6
  23. package/dist/gen/xeonr/pipelines/v1/common_pb.d.ts.map +1 -1
  24. package/dist/gen/xeonr/pipelines/v1/common_pb.js +37 -5
  25. package/dist/gen/xeonr/pipelines/v1/common_pb.js.map +1 -1
  26. package/dist/gen/xeonr/pipelines/v1/definition_pb.d.ts +280 -5
  27. package/dist/gen/xeonr/pipelines/v1/definition_pb.d.ts.map +1 -1
  28. package/dist/gen/xeonr/pipelines/v1/definition_pb.js +100 -7
  29. package/dist/gen/xeonr/pipelines/v1/definition_pb.js.map +1 -1
  30. package/dist/gen/xeonr/pipelines/v1/pipelines_pb.d.ts +1100 -0
  31. package/dist/gen/xeonr/pipelines/v1/pipelines_pb.d.ts.map +1 -0
  32. package/dist/gen/xeonr/pipelines/v1/pipelines_pb.js +298 -0
  33. package/dist/gen/xeonr/pipelines/v1/pipelines_pb.js.map +1 -0
  34. package/dist/gen/xeonr/pipelines/v1/pools_pb.d.ts +120 -1
  35. package/dist/gen/xeonr/pipelines/v1/pools_pb.d.ts.map +1 -1
  36. package/dist/gen/xeonr/pipelines/v1/pools_pb.js +36 -11
  37. package/dist/gen/xeonr/pipelines/v1/pools_pb.js.map +1 -1
  38. package/dist/gen/xeonr/pipelines/v1/queues_pb.d.ts +769 -0
  39. package/dist/gen/xeonr/pipelines/v1/queues_pb.d.ts.map +1 -0
  40. package/dist/gen/xeonr/pipelines/v1/queues_pb.js +190 -0
  41. package/dist/gen/xeonr/pipelines/v1/queues_pb.js.map +1 -0
  42. package/dist/gen/xeonr/pipelines/v1/registry_pb.d.ts +60 -0
  43. package/dist/gen/xeonr/pipelines/v1/registry_pb.d.ts.map +1 -1
  44. package/dist/gen/xeonr/pipelines/v1/registry_pb.js +21 -16
  45. package/dist/gen/xeonr/pipelines/v1/registry_pb.js.map +1 -1
  46. package/dist/gen/xeonr/pipelines/v1/runs_pb.d.ts +867 -4
  47. package/dist/gen/xeonr/pipelines/v1/runs_pb.d.ts.map +1 -1
  48. package/dist/gen/xeonr/pipelines/v1/runs_pb.js +243 -27
  49. package/dist/gen/xeonr/pipelines/v1/runs_pb.js.map +1 -1
  50. package/dist/gen/xeonr/pipelines/v1/schedules_pb.d.ts +1110 -0
  51. package/dist/gen/xeonr/pipelines/v1/schedules_pb.d.ts.map +1 -0
  52. package/dist/gen/xeonr/pipelines/v1/schedules_pb.js +295 -0
  53. package/dist/gen/xeonr/pipelines/v1/schedules_pb.js.map +1 -0
  54. package/dist/gen/xeonr/pipelines/v1/secrets_pb.d.ts +8 -3
  55. package/dist/gen/xeonr/pipelines/v1/secrets_pb.d.ts.map +1 -1
  56. package/dist/gen/xeonr/pipelines/v1/secrets_pb.js +1 -1
  57. package/dist/gen/xeonr/pipelines/v1/secrets_pb.js.map +1 -1
  58. package/dist/gen/xeonr/platform/v1/options_pb.d.ts +123 -1
  59. package/dist/gen/xeonr/platform/v1/options_pb.d.ts.map +1 -1
  60. package/dist/gen/xeonr/platform/v1/options_pb.js +90 -1
  61. package/dist/gen/xeonr/platform/v1/options_pb.js.map +1 -1
  62. package/dist/handler.d.ts +50 -0
  63. package/dist/handler.d.ts.map +1 -1
  64. package/dist/handler.js +27 -0
  65. package/dist/handler.js.map +1 -1
  66. package/dist/index.d.ts +13 -1
  67. package/dist/index.d.ts.map +1 -1
  68. package/dist/index.js +7 -1
  69. package/dist/index.js.map +1 -1
  70. package/dist/logship.d.ts +60 -10
  71. package/dist/logship.d.ts.map +1 -1
  72. package/dist/logship.js +171 -28
  73. package/dist/logship.js.map +1 -1
  74. package/dist/queues.d.ts +171 -0
  75. package/dist/queues.d.ts.map +1 -0
  76. package/dist/queues.js +135 -0
  77. package/dist/queues.js.map +1 -0
  78. package/dist/reporter.d.ts +120 -0
  79. package/dist/reporter.d.ts.map +1 -0
  80. package/dist/reporter.js +323 -0
  81. package/dist/reporter.js.map +1 -0
  82. package/dist/schedules.d.ts +201 -0
  83. package/dist/schedules.d.ts.map +1 -0
  84. package/dist/schedules.js +127 -0
  85. package/dist/schedules.js.map +1 -0
  86. package/dist/testing/cron.d.ts +33 -0
  87. package/dist/testing/cron.d.ts.map +1 -0
  88. package/dist/testing/cron.js +177 -0
  89. package/dist/testing/cron.js.map +1 -0
  90. package/dist/testing/index.d.ts +142 -4
  91. package/dist/testing/index.d.ts.map +1 -1
  92. package/dist/testing/index.js +843 -44
  93. package/dist/testing/index.js.map +1 -1
  94. package/dist/testing/queues.d.ts +46 -0
  95. package/dist/testing/queues.d.ts.map +1 -0
  96. package/dist/testing/queues.js +70 -0
  97. package/dist/testing/queues.js.map +1 -0
  98. package/dist/testing/schedules.d.ts +113 -0
  99. package/dist/testing/schedules.d.ts.map +1 -0
  100. package/dist/testing/schedules.js +419 -0
  101. package/dist/testing/schedules.js.map +1 -0
  102. package/dist/worker.d.ts +78 -8
  103. package/dist/worker.d.ts.map +1 -1
  104. package/dist/worker.js +163 -33
  105. package/dist/worker.js.map +1 -1
  106. package/package.json +1 -1
@@ -1 +1 @@
1
- {"version":3,"file":"options_pb.d.ts","sourceRoot":"","sources":["../../../../../src/gen/xeonr/platform/v1/options_pb.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"options_pb.d.ts","sourceRoot":"","sources":["../../../../../src/gen/xeonr/platform/v1/options_pb.ts"],"names":[],"mappings":"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"}
@@ -24,7 +24,7 @@ import { file_google_protobuf_descriptor } from "@bufbuild/protobuf/wkt";
24
24
  /**
25
25
  * Describes the file xeonr/platform/v1/options.proto.
26
26
  */
27
- export const file_xeonr_platform_v1_options = /*@__PURE__*/ fileDesc("Ch94ZW9uci9wbGF0Zm9ybS92MS9vcHRpb25zLnByb3RvEhF4ZW9uci5wbGF0Zm9ybS52MSK4AQoHTWNwVG9vbBIMCgRuYW1lGAEgASgJEg8KB3Rvb2xzZXQYAiABKAkSKAoEdGllchgDIAEoDjIaLnhlb25yLnBsYXRmb3JtLnYxLk1jcFRpZXISLAoGZWZmZWN0GAQgASgOMhwueGVvbnIucGxhdGZvcm0udjEuTWNwRWZmZWN0EhMKC2Rlc2NyaXB0aW9uGAUgASgJEg0KBXRpdGxlGAYgASgJEhIKCmlkZW1wb3RlbnQYByABKAgiWgoKTWNwVG9vbHNldBIMCgRuYW1lGAEgASgJEhMKC2Rlc2NyaXB0aW9uGAIgASgJEg4KBnNjb3BlcxgDIAMoCRIZChFyZXF1aXJlc19hcHByb3ZhbBgEIAEoCCJbCgpNY3BQcm9kdWN0EgsKA2tleRgBIAEoCRIPCgdzdW1tYXJ5GAIgASgJEi8KCHRvb2xzZXRzGAMgAygLMh0ueGVvbnIucGxhdGZvcm0udjEuTWNwVG9vbHNldCpNCgdNY3BUaWVyEhgKFE1DUF9USUVSX1VOU1BFQ0lGSUVEEAASEQoNTUNQX1RJRVJfQ09SRRABEhUKEU1DUF9USUVSX0VYVEVOREVEEAIqcwoJTWNwRWZmZWN0EhoKFk1DUF9FRkZFQ1RfVU5TUEVDSUZJRUQQABIYChRNQ1BfRUZGRUNUX1JFQURfT05MWRABEhQKEE1DUF9FRkZFQ1RfV1JJVEUQAhIaChZNQ1BfRUZGRUNUX0RFU1RSVUNUSVZFEAM6TAoRbm9fYXV0aGVudGljYXRpb24SHi5nb29nbGUucHJvdG9idWYuTWV0aG9kT3B0aW9ucxisTSABKAhSEG5vQXV0aGVudGljYXRpb246RAoNcmVxdWlyZV9zY29wZRIeLmdvb2dsZS5wcm90b2J1Zi5NZXRob2RPcHRpb25zGK1NIAMoCVIMcmVxdWlyZVNjb3BlOkMKDW9uZV9vZl9zY29wZXMSHi5nb29nbGUucHJvdG9idWYuTWV0aG9kT3B0aW9ucxiuTSABKAhSC29uZU9mU2NvcGVzOkQKDXJlcXVpcmVfYWRtaW4SHi5nb29nbGUucHJvdG9idWYuTWV0aG9kT3B0aW9ucxivTSABKAhSDHJlcXVpcmVBZG1pbjpVChZhbGxvd19zZXJ2aWNlX2FjY291bnRzEh4uZ29vZ2xlLnByb3RvYnVmLk1ldGhvZE9wdGlvbnMYsE0gASgIUhRhbGxvd1NlcnZpY2VBY2NvdW50czpTChVhbGxvd19hdXRvbWF0aW9uX2tleXMSHi5nb29nbGUucHJvdG9idWYuTWV0aG9kT3B0aW9ucxixTSABKAhSE2FsbG93QXV0b21hdGlvbktleXM6QAoLYXVkaXRfZXZlbnQSHi5nb29nbGUucHJvdG9idWYuTWV0aG9kT3B0aW9ucxiyTSABKAlSCmF1ZGl0RXZlbnQ6TwoTYXVkaXRfZmFpbHVyZV9ldmVudBIeLmdvb2dsZS5wcm90b2J1Zi5NZXRob2RPcHRpb25zGLNNIAEoCVIRYXVkaXRGYWlsdXJlRXZlbnQ6TQoSYXVkaXRfc2tpcF9zdWNjZXNzEh4uZ29vZ2xlLnByb3RvYnVmLk1ldGhvZE9wdGlvbnMYtE0gASgIUhBhdWRpdFNraXBTdWNjZXNzOkUKDmFsbG93X2FwaV9rZXlzEh4uZ29vZ2xlLnByb3RvYnVmLk1ldGhvZE9wdGlvbnMYtU0gASgIUgxhbGxvd0FwaUtleXM6VgoIbWNwX3Rvb2wSHi5nb29nbGUucHJvdG9idWYuTWV0aG9kT3B0aW9ucxi2TSABKAsyGi54ZW9uci5wbGF0Zm9ybS52MS5NY3BUb29sUgdtY3BUb29sOjkKCG1jcF90ZWFtEh0uZ29vZ2xlLnByb3RvYnVmLkZpZWxkT3B0aW9ucxisTSABKAhSB21jcFRlYW06PQoKbWNwX2hpZGRlbhIdLmdvb2dsZS5wcm90b2J1Zi5GaWVsZE9wdGlvbnMYrU0gASgIUgltY3BIaWRkZW46RwoPbWNwX2Rlc2NyaXB0aW9uEh0uZ29vZ2xlLnByb3RvYnVmLkZpZWxkT3B0aW9ucxiuTSABKAlSDm1jcERlc2NyaXB0aW9uQlZaVHByb3RvLnByb2Qud3RmL2dlbi9nby94ZW9uci9wbGF0Zm9ybS9wcm90b2NvbGJ1ZmZlcnMvZ28veGVvbnIvcGxhdGZvcm0vdjE7cGxhdGZvcm12MWIGcHJvdG8z", [file_google_protobuf_descriptor]);
27
+ export const file_xeonr_platform_v1_options = /*@__PURE__*/ fileDesc("Ch94ZW9uci9wbGF0Zm9ybS92MS9vcHRpb25zLnByb3RvEhF4ZW9uci5wbGF0Zm9ybS52MSK4AQoHTWNwVG9vbBIMCgRuYW1lGAEgASgJEg8KB3Rvb2xzZXQYAiABKAkSKAoEdGllchgDIAEoDjIaLnhlb25yLnBsYXRmb3JtLnYxLk1jcFRpZXISLAoGZWZmZWN0GAQgASgOMhwueGVvbnIucGxhdGZvcm0udjEuTWNwRWZmZWN0EhMKC2Rlc2NyaXB0aW9uGAUgASgJEg0KBXRpdGxlGAYgASgJEhIKCmlkZW1wb3RlbnQYByABKAgiWgoKTWNwVG9vbHNldBIMCgRuYW1lGAEgASgJEhMKC2Rlc2NyaXB0aW9uGAIgASgJEg4KBnNjb3BlcxgDIAMoCRIZChFyZXF1aXJlc19hcHByb3ZhbBgEIAEoCCJbCgpNY3BQcm9kdWN0EgsKA2tleRgBIAEoCRIPCgdzdW1tYXJ5GAIgASgJEi8KCHRvb2xzZXRzGAMgAygLMh0ueGVvbnIucGxhdGZvcm0udjEuTWNwVG9vbHNldCJ1CgxNY3BFeGNsdXNpb24SLgoGcmVhc29uGAEgASgOMh4ueGVvbnIucGxhdGZvcm0udjEuTWNwRXhjbHVkZWQSDgoGZGV0YWlsGAIgASgJEg4KBnRpY2tldBgDIAEoCRIVCg1zdXBlcnNlZGVkX2J5GAQgASgJKk0KB01jcFRpZXISGAoUTUNQX1RJRVJfVU5TUEVDSUZJRUQQABIRCg1NQ1BfVElFUl9DT1JFEAESFQoRTUNQX1RJRVJfRVhURU5ERUQQAipzCglNY3BFZmZlY3QSGgoWTUNQX0VGRkVDVF9VTlNQRUNJRklFRBAAEhgKFE1DUF9FRkZFQ1RfUkVBRF9PTkxZEAESFAoQTUNQX0VGRkVDVF9XUklURRACEhoKFk1DUF9FRkZFQ1RfREVTVFJVQ1RJVkUQAyqNAgoLTWNwRXhjbHVkZWQSHAoYTUNQX0VYQ0xVREVEX1VOU1BFQ0lGSUVEEAASIQodTUNQX0VYQ0xVREVEX0lOVEVSQUNUSVZFX0FVVEgQARIhCh1NQ1BfRVhDTFVERURfTUFDSElORV9QUk9UT0NPTBACEh4KGk1DUF9FWENMVURFRF9CWVRFX1RSQU5TRkVSEAMSJAogTUNQX0VYQ0xVREVEX05PVF9QRVJTT05fQ0FMTEFCTEUQBBIbChdNQ1BfRVhDTFVERURfU1VQRVJTRURFRBAFEh8KG01DUF9FWENMVURFRF9QTEFURk9STV9BRE1JThAGEhYKEk1DUF9FWENMVURFRF9PVEhFUhAHOkwKEW5vX2F1dGhlbnRpY2F0aW9uEh4uZ29vZ2xlLnByb3RvYnVmLk1ldGhvZE9wdGlvbnMYrE0gASgIUhBub0F1dGhlbnRpY2F0aW9uOkQKDXJlcXVpcmVfc2NvcGUSHi5nb29nbGUucHJvdG9idWYuTWV0aG9kT3B0aW9ucxitTSADKAlSDHJlcXVpcmVTY29wZTpDCg1vbmVfb2Zfc2NvcGVzEh4uZ29vZ2xlLnByb3RvYnVmLk1ldGhvZE9wdGlvbnMYrk0gASgIUgtvbmVPZlNjb3BlczpECg1yZXF1aXJlX2FkbWluEh4uZ29vZ2xlLnByb3RvYnVmLk1ldGhvZE9wdGlvbnMYr00gASgIUgxyZXF1aXJlQWRtaW46VQoWYWxsb3dfc2VydmljZV9hY2NvdW50cxIeLmdvb2dsZS5wcm90b2J1Zi5NZXRob2RPcHRpb25zGLBNIAEoCFIUYWxsb3dTZXJ2aWNlQWNjb3VudHM6UwoVYWxsb3dfYXV0b21hdGlvbl9rZXlzEh4uZ29vZ2xlLnByb3RvYnVmLk1ldGhvZE9wdGlvbnMYsU0gASgIUhNhbGxvd0F1dG9tYXRpb25LZXlzOkAKC2F1ZGl0X2V2ZW50Eh4uZ29vZ2xlLnByb3RvYnVmLk1ldGhvZE9wdGlvbnMYsk0gASgJUgphdWRpdEV2ZW50Ok8KE2F1ZGl0X2ZhaWx1cmVfZXZlbnQSHi5nb29nbGUucHJvdG9idWYuTWV0aG9kT3B0aW9ucxizTSABKAlSEWF1ZGl0RmFpbHVyZUV2ZW50Ok0KEmF1ZGl0X3NraXBfc3VjY2VzcxIeLmdvb2dsZS5wcm90b2J1Zi5NZXRob2RPcHRpb25zGLRNIAEoCFIQYXVkaXRTa2lwU3VjY2VzczpFCg5hbGxvd19hcGlfa2V5cxIeLmdvb2dsZS5wcm90b2J1Zi5NZXRob2RPcHRpb25zGLVNIAEoCFIMYWxsb3dBcGlLZXlzOlYKCG1jcF90b29sEh4uZ29vZ2xlLnByb3RvYnVmLk1ldGhvZE9wdGlvbnMYtk0gASgLMhoueGVvbnIucGxhdGZvcm0udjEuTWNwVG9vbFIHbWNwVG9vbDo5CghtY3BfdGVhbRIdLmdvb2dsZS5wcm90b2J1Zi5GaWVsZE9wdGlvbnMYrE0gASgIUgdtY3BUZWFtOj0KCm1jcF9oaWRkZW4SHS5nb29nbGUucHJvdG9idWYuRmllbGRPcHRpb25zGK1NIAEoCFIJbWNwSGlkZGVuOkcKD21jcF9kZXNjcmlwdGlvbhIdLmdvb2dsZS5wcm90b2J1Zi5GaWVsZE9wdGlvbnMYrk0gASgJUg5tY3BEZXNjcmlwdGlvbjphCgttY3BfZXhjbHVkZRIeLmdvb2dsZS5wcm90b2J1Zi5NZXRob2RPcHRpb25zGLdNIAEoCzIfLnhlb25yLnBsYXRmb3JtLnYxLk1jcEV4Y2x1c2lvblIKbWNwRXhjbHVkZTpxChNtY3BfZXhjbHVkZV9zZXJ2aWNlEh8uZ29vZ2xlLnByb3RvYnVmLlNlcnZpY2VPcHRpb25zGKxNIAEoCzIfLnhlb25yLnBsYXRmb3JtLnYxLk1jcEV4Y2x1c2lvblIRbWNwRXhjbHVkZVNlcnZpY2U6aAoQbWNwX2V4Y2x1ZGVfZmlsZRIcLmdvb2dsZS5wcm90b2J1Zi5GaWxlT3B0aW9ucxisTSABKAsyHy54ZW9uci5wbGF0Zm9ybS52MS5NY3BFeGNsdXNpb25SDm1jcEV4Y2x1ZGVGaWxlQlZaVHByb3RvLnByb2Qud3RmL2dlbi9nby94ZW9uci9wbGF0Zm9ybS9wcm90b2NvbGJ1ZmZlcnMvZ28veGVvbnIvcGxhdGZvcm0vdjE7cGxhdGZvcm12MWIGcHJvdG8z", [file_google_protobuf_descriptor]);
28
28
  /**
29
29
  * Describes the message xeonr.platform.v1.McpTool.
30
30
  * Use `create(McpToolSchema)` to create a new message.
@@ -40,6 +40,11 @@ export const McpToolsetSchema = /*@__PURE__*/ messageDesc(file_xeonr_platform_v1
40
40
  * Use `create(McpProductSchema)` to create a new message.
41
41
  */
42
42
  export const McpProductSchema = /*@__PURE__*/ messageDesc(file_xeonr_platform_v1_options, 2);
43
+ /**
44
+ * Describes the message xeonr.platform.v1.McpExclusion.
45
+ * Use `create(McpExclusionSchema)` to create a new message.
46
+ */
47
+ export const McpExclusionSchema = /*@__PURE__*/ messageDesc(file_xeonr_platform_v1_options, 3);
43
48
  /**
44
49
  * McpTier says whether the gateway lists a tool or only finds it on request.
45
50
  *
@@ -96,6 +101,70 @@ export var McpEffect;
96
101
  * Describes the enum xeonr.platform.v1.McpEffect.
97
102
  */
98
103
  export const McpEffectSchema = /*@__PURE__*/ enumDesc(file_xeonr_platform_v1_options, 1);
104
+ /**
105
+ * McpExcluded is why an RPC is deliberately not an MCP tool.
106
+ *
107
+ * @generated from enum xeonr.platform.v1.McpExcluded
108
+ */
109
+ export var McpExcluded;
110
+ (function (McpExcluded) {
111
+ /**
112
+ * @generated from enum value: MCP_EXCLUDED_UNSPECIFIED = 0;
113
+ */
114
+ McpExcluded[McpExcluded["UNSPECIFIED"] = 0] = "UNSPECIFIED";
115
+ /**
116
+ * Sign-in, passkey, consent, OAuth and session flows a browser drives.
117
+ *
118
+ * @generated from enum value: MCP_EXCLUDED_INTERACTIVE_AUTH = 1;
119
+ */
120
+ McpExcluded[McpExcluded["INTERACTIVE_AUTH"] = 1] = "INTERACTIVE_AUTH";
121
+ /**
122
+ * Called by a machine, not a person: runner, agent, webhook,
123
+ * service-to-service, controller callbacks.
124
+ *
125
+ * @generated from enum value: MCP_EXCLUDED_MACHINE_PROTOCOL = 2;
126
+ */
127
+ McpExcluded[McpExcluded["MACHINE_PROTOCOL"] = 2] = "MACHINE_PROTOCOL";
128
+ /**
129
+ * Moves bytes (uploads, downloads, chunked transfers) a model cannot carry
130
+ * as JSON arguments or results.
131
+ *
132
+ * @generated from enum value: MCP_EXCLUDED_BYTE_TRANSFER = 3;
133
+ */
134
+ McpExcluded[McpExcluded["BYTE_TRANSFER"] = 3] = "BYTE_TRANSFER";
135
+ /**
136
+ * Needs a principal the gateway cannot carry (an API key, an automation
137
+ * key, a service account, a device). McpExclusion.ticket names the ticket
138
+ * that would lift it.
139
+ *
140
+ * @generated from enum value: MCP_EXCLUDED_NOT_PERSON_CALLABLE = 4;
141
+ */
142
+ McpExcluded[McpExcluded["NOT_PERSON_CALLABLE"] = 4] = "NOT_PERSON_CALLABLE";
143
+ /**
144
+ * Another tool of the same product covers it. McpExclusion.superseded_by
145
+ * names that tool.
146
+ *
147
+ * @generated from enum value: MCP_EXCLUDED_SUPERSEDED = 5;
148
+ */
149
+ McpExcluded[McpExcluded["SUPERSEDED"] = 5] = "SUPERSEDED";
150
+ /**
151
+ * Platform staff operations (require_admin and the like) that a person's
152
+ * gateway connection should not reach.
153
+ *
154
+ * @generated from enum value: MCP_EXCLUDED_PLATFORM_ADMIN = 6;
155
+ */
156
+ McpExcluded[McpExcluded["PLATFORM_ADMIN"] = 6] = "PLATFORM_ADMIN";
157
+ /**
158
+ * None of the above. McpExclusion.detail says why.
159
+ *
160
+ * @generated from enum value: MCP_EXCLUDED_OTHER = 7;
161
+ */
162
+ McpExcluded[McpExcluded["OTHER"] = 7] = "OTHER";
163
+ })(McpExcluded || (McpExcluded = {}));
164
+ /**
165
+ * Describes the enum xeonr.platform.v1.McpExcluded.
166
+ */
167
+ export const McpExcludedSchema = /*@__PURE__*/ enumDesc(file_xeonr_platform_v1_options, 2);
99
168
  /**
100
169
  * no_authentication marks a method callable without a bearer token. A
101
170
  * bearer that IS presented is still verified and, when valid, placed on the
@@ -232,4 +301,24 @@ export const mcp_hidden = /*@__PURE__*/ extDesc(file_xeonr_platform_v1_options,
232
301
  * @generated from extension: string mcp_description = 9902;
233
302
  */
234
303
  export const mcp_description = /*@__PURE__*/ extDesc(file_xeonr_platform_v1_options, 13);
304
+ /**
305
+ * mcp_exclude marks a unary RPC as deliberately not an MCP tool.
306
+ *
307
+ * @generated from extension: xeonr.platform.v1.McpExclusion mcp_exclude = 9911;
308
+ */
309
+ export const mcp_exclude = /*@__PURE__*/ extDesc(file_xeonr_platform_v1_options, 14);
310
+ /**
311
+ * mcp_exclude_service excludes every method of the service that does not
312
+ * carry mcp_tool or its own mcp_exclude.
313
+ *
314
+ * @generated from extension: xeonr.platform.v1.McpExclusion mcp_exclude_service = 9900;
315
+ */
316
+ export const mcp_exclude_service = /*@__PURE__*/ extDesc(file_xeonr_platform_v1_options, 15);
317
+ /**
318
+ * mcp_exclude_file excludes every method of every service in the file
319
+ * that does not carry mcp_tool or its own exclusion.
320
+ *
321
+ * @generated from extension: xeonr.platform.v1.McpExclusion mcp_exclude_file = 9900;
322
+ */
323
+ export const mcp_exclude_file = /*@__PURE__*/ extDesc(file_xeonr_platform_v1_options, 16);
235
324
  //# sourceMappingURL=options_pb.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"options_pb.js","sourceRoot":"","sources":["../../../../../src/gen/xeonr/platform/v1/options_pb.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"options_pb.js","sourceRoot":"","sources":["../../../../../src/gen/xeonr/platform/v1/options_pb.ts"],"names":[],"mappings":"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"}
package/dist/handler.d.ts CHANGED
@@ -1,5 +1,7 @@
1
1
  import type { JsonObject, JsonValue, MessageInitShape } from "@bufbuild/protobuf";
2
2
  import type { InputSlotSchema, OutputSlotSchema } from "./gen/xeonr/pipelines/v1/registry_pb.js";
3
+ import type { IssueInput, ProgressUpdate, SpanHandle, StageDef } from "./reporter.js";
4
+ import type { ScheduleTargetJson } from "./schedules.js";
3
5
  /** The `<namespace>/<name>` pattern the contract holds handler names to. */
4
6
  export declare const HANDLER_NAME: RegExp;
5
7
  /** One attempt of a node, as the handler running it sees it. */
@@ -48,6 +50,34 @@ export interface HandlerContext<I> {
48
50
  readonly attempt: AttemptInfo;
49
51
  /** The attempt's log in pipelines. */
50
52
  readonly log: AttemptLogger;
53
+ /**
54
+ * Enters a stage: one the handler declares in `stages`, or a new one,
55
+ * added with weight 0. Entering a stage finishes the one before it; the
56
+ * last one is finished when the handler returns (or fails). Pass `state`
57
+ * to finish or skip the current stage explicitly.
58
+ */
59
+ stage(key: string, opts?: {
60
+ name?: string;
61
+ state?: "running" | "succeeded" | "failed" | "skipped";
62
+ message?: string;
63
+ }): void;
64
+ /**
65
+ * Reports progress within the current stage (or the attempt as a whole):
66
+ * items processed, total and failed, a fraction, a message. Sent about
67
+ * once a second at most, and once more before the attempt completes.
68
+ */
69
+ progress(update: ProgressUpdate): void;
70
+ /**
71
+ * Reports a structured, non-fatal problem with one item of the work. The
72
+ * run can still succeed; it carries the issues. Batched, never fails the
73
+ * handler.
74
+ */
75
+ issue(issue: IssueInput): void;
76
+ /**
77
+ * Runs `fn` inside a span of the attempt's trace, recorded with
78
+ * `ReportSpans` (status `error` when `fn` throws, which is rethrown).
79
+ */
80
+ span<T>(name: string, fn: (span: SpanHandle) => Promise<T> | T, attributes?: JsonObject): Promise<T>;
51
81
  }
52
82
  /** kv outputs a handler returns, by output slot. */
53
83
  export type HandlerOutputs = Record<string, JsonValue>;
@@ -69,6 +99,14 @@ export interface HandlerDefinition<I = JsonObject, O extends HandlerOutputs | vo
69
99
  /** Resource kinds the handler accepts; empty accepts any. */
70
100
  readonly resourceKinds?: string[];
71
101
  readonly readmeMd?: string;
102
+ /** The handler's title for people ("Image convert"); empty shows the name. */
103
+ readonly title?: string;
104
+ /**
105
+ * The stages the handler's work goes through, in order, published in the
106
+ * manifest so a console can draw them before the attempt starts. Enter
107
+ * each with `ctx.stage(key)`.
108
+ */
109
+ readonly stages?: readonly StageDef[];
72
110
  /**
73
111
  * The most attempts of this handler one worker process runs at once.
74
112
  * Default: the worker's overall concurrency.
@@ -91,4 +129,16 @@ export interface HandlerDefinition<I = JsonObject, O extends HandlerOutputs | vo
91
129
  * register it with `worker.handle`.
92
130
  */
93
131
  export declare function defineHandler<I = JsonObject, O extends HandlerOutputs | void = HandlerOutputs | void>(def: HandlerDefinition<I, O>): HandlerDefinition<I, O>;
132
+ /**
133
+ * Defines a schedule's enumeration handler: at each occurrence it returns
134
+ * the targets the schedule fans out to, published as the kv output
135
+ * `targets` the platform reads.
136
+ */
137
+ export declare function defineEnumerator<I = JsonObject>(def: Omit<HandlerDefinition<I, {
138
+ targets: JsonValue;
139
+ }>, "run" | "outputs"> & {
140
+ run: (ctx: HandlerContext<I>) => Promise<readonly ScheduleTargetJson[]> | readonly ScheduleTargetJson[];
141
+ }): HandlerDefinition<I, {
142
+ targets: JsonValue;
143
+ }>;
94
144
  //# sourceMappingURL=handler.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"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"}
package/dist/handler.js CHANGED
@@ -10,9 +10,36 @@ export function defineHandler(def) {
10
10
  throw new TypeError(`defineHandler: ${JSON.stringify(def.name)} is not <namespace>/<name>`);
11
11
  if (!VERSION.test(def.version))
12
12
  throw new TypeError(`defineHandler: ${JSON.stringify(def.version)} is not a semantic version`);
13
+ const keys = new Set();
14
+ for (const st of def.stages ?? []) {
15
+ if (!/^[a-z][a-z0-9_.-]{0,63}$/.test(st.key))
16
+ throw new TypeError(`defineHandler: stage key ${JSON.stringify(st.key)} is not valid`);
17
+ if (keys.has(st.key))
18
+ throw new TypeError(`defineHandler: stage ${st.key} is declared twice`);
19
+ if (!st.name || st.name.length > 128)
20
+ throw new TypeError(`defineHandler: stage ${st.key} needs a name of at most 128 characters`);
21
+ if (st.weight !== undefined && (!Number.isInteger(st.weight) || st.weight < 0 || st.weight > 1000)) {
22
+ throw new TypeError(`defineHandler: stage ${st.key}'s weight must be an integer from 0 to 1000`);
23
+ }
24
+ keys.add(st.key);
25
+ }
26
+ if ((def.stages?.length ?? 0) > 32)
27
+ throw new TypeError("defineHandler: at most 32 stages");
13
28
  if (def.concurrency !== undefined && (!Number.isInteger(def.concurrency) || def.concurrency < 1)) {
14
29
  throw new TypeError("defineHandler: concurrency must be a positive integer");
15
30
  }
16
31
  return def;
17
32
  }
33
+ /**
34
+ * Defines a schedule's enumeration handler: at each occurrence it returns
35
+ * the targets the schedule fans out to, published as the kv output
36
+ * `targets` the platform reads.
37
+ */
38
+ export function defineEnumerator(def) {
39
+ return defineHandler({
40
+ ...def,
41
+ outputs: [{ name: "targets", type: 1, required: true }],
42
+ run: async (ctx) => ({ targets: (await def.run(ctx)) }),
43
+ });
44
+ }
18
45
  //# sourceMappingURL=handler.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"handler.js","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAGA,4EAA4E;AAC5E,MAAM,CAAC,MAAM,YAAY,GAAG,oDAAoD,CAAC;AACjF,MAAM,OAAO,GAAG,4CAA4C,CAAC;AAuF7D;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,GAA4B;IAE5B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC9H,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAC/H,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC,EAAE,CAAC;QACjG,MAAM,IAAI,SAAS,CAAC,uDAAuD,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}
1
+ {"version":3,"file":"handler.js","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAKA,4EAA4E;AAC5E,MAAM,CAAC,MAAM,YAAY,GAAG,oDAAoD,CAAC;AACjF,MAAM,OAAO,GAAG,4CAA4C,CAAC;AAuH7D;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,GAA4B;IAE5B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC9H,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAC/H,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,4BAA4B,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACrI,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,wBAAwB,EAAE,CAAC,GAAG,oBAAoB,CAAC,CAAC;QAC9F,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG;YAAE,MAAM,IAAI,SAAS,CAAC,wBAAwB,EAAE,CAAC,GAAG,yCAAyC,CAAC,CAAC;QACnI,IAAI,EAAE,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;YACnG,MAAM,IAAI,SAAS,CAAC,wBAAwB,EAAE,CAAC,GAAG,6CAA6C,CAAC,CAAC;QACnG,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,EAAE;QAAE,MAAM,IAAI,SAAS,CAAC,kCAAkC,CAAC,CAAC;IAC5F,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC,EAAE,CAAC;QACjG,MAAM,IAAI,SAAS,CAAC,uDAAuD,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAiB,GAEhD;IACC,OAAO,aAAa,CAA4B;QAC9C,GAAG,GAAG;QACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACvD,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAyB,EAAE,CAAC;KAChF,CAAC,CAAC;AACL,CAAC"}
package/dist/index.d.ts CHANGED
@@ -15,7 +15,7 @@ export { jwtBearer, tokenSource } from "./auth.js";
15
15
  export type { JwtBearerOptions, JwtBearerTokenProvider, TokenProvider, TokenSource } from "./auth.js";
16
16
  export { PipelinesClient } from "./client.js";
17
17
  export type { CreateJobInput, CreatedRun, CreateRunInput, ListRunsInput, PipelinesClientOptions } from "./client.js";
18
- export { AttemptAbortedError, errorKind, PipelinesAuthError, WorkerStartError } from "./errors.js";
18
+ export { AttemptAbortedError, errorKind, handlerFailureKind, PermanentError, PipelinesAuthError, TransientError, WorkerStartError } from "./errors.js";
19
19
  export type { ErrorKind } from "./errors.js";
20
20
  export { defineHandler, HANDLER_NAME } from "./handler.js";
21
21
  export type { AttemptInfo, AttemptLogger, HandlerContext, HandlerDefinition, HandlerOutputs } from "./handler.js";
@@ -25,5 +25,17 @@ export { consoleLogger, Worker } from "./worker.js";
25
25
  export type { StopOptions, WorkerLogger, WorkerOptions, WorkerState, WorkerStats } from "./worker.js";
26
26
  export { AttemptState, FailureClass, NodeState, RunState, Termination } from "./gen/xeonr/pipelines/v1/common_pb.js";
27
27
  export { Visibility, SlotType } from "./gen/xeonr/pipelines/v1/registry_pb.js";
28
+ export { HandlerFailureKind } from "./gen/xeonr/pipelines/private/v1/worker_pb.js";
28
29
  export type { Run, NodeRun, Attempt } from "./gen/xeonr/pipelines/v1/runs_pb.js";
30
+ export { declareQueues, productFromToken, QueuesClient } from "./queues.js";
31
+ export type { QueueDecl, QueueRef, QueuesClientOptions } from "./queues.js";
32
+ export { declareSchedules, SchedulesClient } from "./schedules.js";
33
+ export type { ScheduleDecl, ScheduleJobDecl, SchedulesClientOptions, ScheduleTargetJson } from "./schedules.js";
34
+ export { defineEnumerator } from "./handler.js";
35
+ export type { IssueInput, ProgressUpdate, SpanHandle, StageDef } from "./reporter.js";
36
+ export { IssueSeverity, RunOrigin, RunTrigger, StageState } from "./gen/xeonr/pipelines/v1/runs_pb.js";
37
+ export type { RunIssue, TraceSpan, AttemptProgress } from "./gen/xeonr/pipelines/v1/runs_pb.js";
38
+ export type { Queue } from "./gen/xeonr/pipelines/v1/queues_pb.js";
39
+ export { MisfirePolicy, OccurrenceOutcome } from "./gen/xeonr/pipelines/v1/schedules_pb.js";
40
+ export type { Schedule } from "./gen/xeonr/pipelines/v1/schedules_pb.js";
29
41
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACtG,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrH,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACnG,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAClH,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC3E,YAAY,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEtG,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACrH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAC;AAC/E,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACtG,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrH,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,kBAAkB,EAAE,cAAc,EAAE,kBAAkB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACvJ,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAClH,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC3E,YAAY,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEtG,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACrH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AACnF,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC5E,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACnE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAChH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACvG,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAChG,YAAY,EAAE,KAAK,EAAE,MAAM,uCAAuC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC5F,YAAY,EAAE,QAAQ,EAAE,MAAM,0CAA0C,CAAC"}
package/dist/index.js CHANGED
@@ -13,11 +13,17 @@
13
13
  */
14
14
  export { jwtBearer, tokenSource } from "./auth.js";
15
15
  export { PipelinesClient } from "./client.js";
16
- export { AttemptAbortedError, errorKind, PipelinesAuthError, WorkerStartError } from "./errors.js";
16
+ export { AttemptAbortedError, errorKind, handlerFailureKind, PermanentError, PipelinesAuthError, TransientError, WorkerStartError } from "./errors.js";
17
17
  export { defineHandler, HANDLER_NAME } from "./handler.js";
18
18
  export { authInterceptor, createPipelinesTransport } from "./transport.js";
19
19
  export { consoleLogger, Worker } from "./worker.js";
20
20
  // The contract's vocabulary, re-exported for convenience.
21
21
  export { AttemptState, FailureClass, NodeState, RunState, Termination } from "./gen/xeonr/pipelines/v1/common_pb.js";
22
22
  export { Visibility, SlotType } from "./gen/xeonr/pipelines/v1/registry_pb.js";
23
+ export { HandlerFailureKind } from "./gen/xeonr/pipelines/private/v1/worker_pb.js";
24
+ export { declareQueues, productFromToken, QueuesClient } from "./queues.js";
25
+ export { declareSchedules, SchedulesClient } from "./schedules.js";
26
+ export { defineEnumerator } from "./handler.js";
27
+ export { IssueSeverity, RunOrigin, RunTrigger, StageState } from "./gen/xeonr/pipelines/v1/runs_pb.js";
28
+ export { MisfirePolicy, OccurrenceOutcome } from "./gen/xeonr/pipelines/v1/schedules_pb.js";
23
29
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEnG,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE3E,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEpD,0DAA0D;AAC1D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACrH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,kBAAkB,EAAE,cAAc,EAAE,kBAAkB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEvJ,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE3E,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEpD,0DAA0D;AAC1D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACrH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AAEnF,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE5E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAGvG,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC"}
package/dist/logship.d.ts CHANGED
@@ -10,8 +10,9 @@ export interface LogShipperOptions {
10
10
  /** How long output waits before a part-full chunk is sent. Default 500 ms. */
11
11
  flushIntervalMs?: number;
12
12
  /**
13
- * Most bytes held while the API is slow or down. A handler's log calls
14
- * cannot block, so past this, output is dropped and a marker says how
13
+ * Most bytes held while the API is slow or down, and most acknowledged
14
+ * bytes kept to resend to a server that lost them. A handler's log calls
15
+ * cannot block, so past this, new output is dropped and a marker says how
15
16
  * much. Default 8 MiB.
16
17
  */
17
18
  maxBuffered?: number;
@@ -21,18 +22,37 @@ export interface LogShipperOptions {
21
22
  onLost?: () => void;
22
23
  /** Told of each failed send. */
23
24
  onRetry?: (err: unknown) => void;
25
+ /**
26
+ * Told when the server expected an earlier seq than this shipper had
27
+ * reached and the chunks in between were no longer held: the log carries
28
+ * on at `to` after a marker saying `lost` bytes are gone.
29
+ */
30
+ onRenumber?: (from: bigint, to: bigint, lost: number) => void;
24
31
  }
32
+ /** The line a renumbered log carries where output was lost. */
33
+ export declare function lostMarker(lost: number): string;
34
+ /**
35
+ * The seq an `out_of_range` answer names as expected: the last number in its
36
+ * message (the api says "seq: the next expected seq is N"), as the Go
37
+ * runner's `workerclient.ExpectedSeq` reads it. Undefined when it names none.
38
+ */
39
+ export declare function expectedSeq(err: unknown): bigint | undefined;
25
40
  /**
26
- * Ships one attempt's log, in the runner's way (pkg/logship): chunks are
27
- * numbered from 0 without gaps, each sent until acknowledged before the next,
28
- * so a retry after a lost reply cannot duplicate or reorder anything; the
29
- * last chunk carries `final`.
41
+ * Ships one attempt's log, the runner's way (pkg/logship): chunks are
42
+ * numbered from 0, each is sent until acknowledged before the next, so a
43
+ * retry after a lost reply cannot duplicate or reorder anything; the last
44
+ * chunk carries `final`.
30
45
  *
31
- * - `failed_precondition`: the attempt is lost; shipping stops and `onLost`
46
+ * - `failed_precondition`: the attempt is lost. Shipping stops and `onLost`
32
47
  * is told.
33
- * - `out_of_range` (or any other final code): not fatal to the attempt;
34
- * shipping stops and the rest of the log is dropped.
48
+ * - `out_of_range` naming the expected seq: the server holds fewer chunks
49
+ * than it acknowledged. The held chunks from the expected one are sent
50
+ * again; if they are no longer held, the log is renumbered from the
51
+ * expected seq after one marker line saying how much output was lost.
52
+ * Never fatal to the attempt.
35
53
  * - The server's `truncated`: the log is at its cap; shipping stops.
54
+ * - Another final code (`invalid_argument`, `unimplemented`): the rest of
55
+ * the log is dropped; the attempt carries on.
36
56
  * - Anything else is retried with backoff.
37
57
  */
38
58
  export declare class LogShipper {
@@ -46,6 +66,11 @@ export declare class LogShipper {
46
66
  private stopped;
47
67
  private closing;
48
68
  private seq;
69
+ /** Acknowledged chunks, oldest first, kept to resend; bounded by maxBuffered. */
70
+ private sent;
71
+ private sentBytes;
72
+ /** offsets[i] is how many bytes the chunks before seq i held; its length is seq + 1. */
73
+ private offsets;
49
74
  private wake;
50
75
  private readonly done;
51
76
  private readonly abort;
@@ -61,7 +86,32 @@ export declare class LogShipper {
61
86
  stop(): void;
62
87
  private take;
63
88
  private run;
64
- /** Sends one chunk until acknowledged. False means shipping has stopped. */
89
+ /**
90
+ * Delivers one chunk at the current seq. A refusal as ahead of the server
91
+ * is answered by resending what it lost, or by renumbering, and then this
92
+ * chunk again; a server that refuses again is answered the same way, a
93
+ * bounded number of times.
94
+ */
65
95
  private send;
96
+ /**
97
+ * Sends one chunk at `seq` until it is acknowledged. Throws Stop when the
98
+ * attempt is lost, shipping stopped, or the server answered something
99
+ * final; and the error itself for an `out_of_range` naming a seq other
100
+ * than this one, which the caller answers.
101
+ */
102
+ private deliver;
103
+ /** Records chunk `seq` as stored and keeps it for a resend. */
104
+ private acknowledged;
105
+ /**
106
+ * Sends the held chunks from `expected` up to (not including) `upTo`
107
+ * again. False when they are not all held, or the server refused one.
108
+ */
109
+ private replay;
110
+ /**
111
+ * Continues the log at `expected` when the chunks from there to `upTo`
112
+ * are not all held: one marker with the size of what is gone, then the
113
+ * held chunks that ran without a gap up to `upTo`, under new seqs.
114
+ */
115
+ private renumber;
66
116
  }
67
117
  //# sourceMappingURL=logship.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"logship.d.ts","sourceRoot":"","sources":["../src/logship.ts"],"names":[],"mappings":"AAGA,8EAA8E;AAC9E,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAE/I,gCAAgC;AAChC,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,gCAAgC;IAChC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CAClC;AAID;;;;;;;;;;;;GAYG;AACH,qBAAa,UAAU;IAkBnB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAjBvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAGlB;IACF,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,IAAI,CAA2B;IACvC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;gBAG5B,IAAI,EAAE,OAAO,EAC9B,GAAG,GAAE,iBAAsB;IAa7B,iCAAiC;IACjC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAkBzB;;;OAGG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB9D,oDAAoD;IACpD,IAAI,IAAI,IAAI;IAMZ,OAAO,CAAC,IAAI;YAiBE,GAAG;IAyBjB,4EAA4E;YAC9D,IAAI;CAgCnB"}
1
+ {"version":3,"file":"logship.d.ts","sourceRoot":"","sources":["../src/logship.ts"],"names":[],"mappings":"AAIA,8EAA8E;AAC9E,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAE/I,gCAAgC;AAChC,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,gCAAgC;IAChC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/D;AAID,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAK5D;AAID;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,UAAU;IAwBnB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAvBvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAIlB;IACF,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,GAAG,CAAM;IACjB,iFAAiF;IACjF,OAAO,CAAC,IAAI,CAA2C;IACvD,OAAO,CAAC,SAAS,CAAK;IACtB,wFAAwF;IACxF,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,IAAI,CAA2B;IACvC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;gBAG5B,IAAI,EAAE,OAAO,EAC9B,GAAG,GAAE,iBAAsB;IAc7B,iCAAiC;IACjC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAkBzB;;;OAGG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB9D,oDAAoD;IACpD,IAAI,IAAI,IAAI;IAMZ,OAAO,CAAC,IAAI;YAiBE,GAAG;IA+BjB;;;;;OAKG;YACW,IAAI;IA0BlB;;;;;OAKG;YACW,OAAO;IA2BrB,+DAA+D;IAC/D,OAAO,CAAC,YAAY;IAcpB;;;OAGG;YACW,MAAM;IAcpB;;;;OAIG;YACW,QAAQ;CA4BvB"}