@kubun/plugin-p2p-api 0.17.0 → 0.18.0

package/lib/index.d.ts

@@ -13,8 +13,9 @@ export type WorkflowDiscoverReply = {
 };
 /**
  * The narrow typed P2P control-plane API. Each method takes `groupID` as the
- * PEER-SELECTION argument; the transport (multi-hub fan-out for discover, a
- * directed `.to(targetDID)` request for the rest) and reply dedup (by
+ * PEER-SELECTION argument; the transport (one gather through the group's
+ * designated commit hub for discover, a directed `.to(targetDID)` request for
+ * the rest) and reply dedup (by
  * authenticated `senderDID`) are the implementation's concern — no
  * group-peer-manager internal is exposed here.
  *
@@ -26,21 +27,19 @@ export type WorkflowDiscoverReply = {
  * refusal into a local throw.
  */
 /**
- * Bounds a discover fan-out, mirroring `peer/query`: `quorum` resolves a gather
- * as soon as that many distinct responders answer (set it to the known
- * live-member count to return promptly rather than waiting out the window),
- * `timeoutMs` caps the wait. Both optional; absent, the gather runs its default
- * window. `quorum` is applied per hub-peer gather, not across the deduplicated
- * multi-hub result, so with members split across hubs a hub may wait out its
- * window even once the combined result already holds `quorum` distinct
- * responders; the single-hub case (the common one) resolves exactly at quorum.
+ * Bounds the discover gather, mirroring `peer/query`: discover is one
+ * `workflow/discover` gather through the group's designated commit hub, so
+ * `quorum` resolves it as soon as that many distinct responders answer (set it
+ * to the known live-member count to return promptly rather than waiting out the
+ * window), and `timeoutMs` caps the wait. Both optional; absent, the gather runs
+ * its default window.
  */
 export type WorkflowDiscoverOptions = {
     quorum?: number;
     timeoutMs?: number;
 };
 export type WorkflowControlPlaneAPI = {
-    /** Fan out `workflow/discover` across the group's hubs; one entry per distinct responder. */
+    /** Gather `workflow/discover` through the designated hub; one entry per distinct responder. */
     discoverWorkflows(groupID: string, options?: WorkflowDiscoverOptions): Promise<Array<WorkflowDiscoverReply>>;
     /** Directed `workflow/list` to one peer: its remotely-observable instances. */
     listWorkflows(groupID: string, targetDID: string): Promise<Array<InstanceStatus>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubun/plugin-p2p-api",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "keywords": [],
   "license": "see LICENSE.md",
   "sideEffects": false,
@@ -15,7 +15,7 @@
     "LICENSE.md"
   ],
   "dependencies": {
-    "@kubun/plugin-workflow-api": "^0.17.0"
+    "@kubun/plugin-workflow-api": "^0.18.0"
   },
   "publishConfig": {
     "access": "public"