@cotal-ai/connector-core 0.133.13 → 0.135.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 (45) hide show
  1. package/dist/agent.d.ts +71 -4
  2. package/dist/agent.d.ts.map +1 -1
  3. package/dist/agent.js +228 -33
  4. package/dist/agent.js.map +1 -1
  5. package/dist/briefing.d.ts +27 -0
  6. package/dist/briefing.d.ts.map +1 -0
  7. package/dist/briefing.js +58 -0
  8. package/dist/briefing.js.map +1 -0
  9. package/dist/config.d.ts +1 -1
  10. package/dist/config.d.ts.map +1 -1
  11. package/dist/config.js.map +1 -1
  12. package/dist/control.d.ts +3 -2
  13. package/dist/control.d.ts.map +1 -1
  14. package/dist/control.js +1 -1
  15. package/dist/control.js.map +1 -1
  16. package/dist/docs-bundle.bin +0 -0
  17. package/dist/docs-bundle.generated.d.ts +1 -1
  18. package/dist/docs-bundle.generated.d.ts.map +1 -1
  19. package/dist/docs-bundle.generated.js +13 -6
  20. package/dist/docs-bundle.generated.js.map +1 -1
  21. package/dist/docs-index.bin +0 -0
  22. package/dist/gateway.d.ts.map +1 -1
  23. package/dist/gateway.js +6 -2
  24. package/dist/gateway.js.map +1 -1
  25. package/dist/index.d.ts +2 -0
  26. package/dist/index.d.ts.map +1 -1
  27. package/dist/index.js +2 -0
  28. package/dist/index.js.map +1 -1
  29. package/dist/manager-call.d.ts +7 -1
  30. package/dist/manager-call.d.ts.map +1 -1
  31. package/dist/manager-call.js +39 -1
  32. package/dist/manager-call.js.map +1 -1
  33. package/dist/once.d.ts +53 -0
  34. package/dist/once.d.ts.map +1 -0
  35. package/dist/once.js +126 -0
  36. package/dist/once.js.map +1 -0
  37. package/dist/orientation.d.ts +11 -3
  38. package/dist/orientation.d.ts.map +1 -1
  39. package/dist/orientation.js +29 -8
  40. package/dist/orientation.js.map +1 -1
  41. package/dist/tool-specs.d.ts +14 -1
  42. package/dist/tool-specs.d.ts.map +1 -1
  43. package/dist/tool-specs.js +197 -50
  44. package/dist/tool-specs.js.map +1 -1
  45. package/package.json +3 -3
@@ -1,4 +1,4 @@
1
- import { BASELINE_LIFECYCLE_ENDPOINT, EpEnvelopeError, dialerFor, goalFollowRefusal, invokeCommand, isPermissionDenied, issuedUserCaller, managerCallerBinding, replyRefusedBeforeEffect, resolveService, standaloneConnectOpts, } from "@cotal-ai/core";
1
+ import { BASELINE_LIFECYCLE_ENDPOINT, EpEnvelopeError, dialerFor, goalFollowRefusal, invokeCommand, isPermissionDenied, issuedUserCaller, managerCallerBinding, registryListingCaller, replyRefusedBeforeEffect, resolveService, standaloneConnectOpts, } from "@cotal-ai/core";
2
2
  /** Credentials whose manager-call view the broker refused an accepted row for. Successful legacy
3
3
  * calls skip that read until {@link LEGACY_RAIL_RECHECK_MS}; a permission-failed resolve rechecks
4
4
  * its own connection, whose issued view may have changed with the direct parent's grant.
@@ -22,6 +22,44 @@ function rememberLegacyRail(key) {
22
22
  }
23
23
  /** Forget every remembered legacy-rail verdict. For tests that reuse a process across stacks. */
24
24
  export function forgetLegacyRail() { legacyRail.clear(); }
25
+ /** Open a manager-call connection on `token` as a manager call opens it, find the caller a registry
26
+ * listing rides on it (SPEC 13.15), run `ask` over it, and close it. `exp` is the bearer's expiry,
27
+ * the listing's horizon at the callout. The issued read shares the manager calls' legacy-rail
28
+ * memory, so a legacy credential is refused that read once, not once per listing. */
29
+ export async function withUserManagerListing(config, token, exp, ask) {
30
+ const user = config.userAuth;
31
+ const binding = managerCallerBinding(token, {
32
+ space: config.space, owner: user.owner, actor: user.actor, lifecycleUid: config.lifecycleUid, instanceId: config.managerInstanceId,
33
+ });
34
+ const railKey = binding.credentialId ?? token;
35
+ const connectOpts = standaloneConnectOpts({ bearer: token, sentinelCreds: user.sentinelCreds, tls: config.tls });
36
+ const connId = String(connectOpts.name);
37
+ const nc = await dialerFor(config.servers)({ servers: config.servers, ...connectOpts, maxReconnectAttempts: 0, timeout: 10_000 });
38
+ // An issued view lists as itself; any other under the listing generation its credential carries.
39
+ const issued = async () => {
40
+ try {
41
+ const caller = await issuedUserCaller(nc, config.space, connId, binding.caller);
42
+ legacyRail.delete(railKey);
43
+ return caller;
44
+ }
45
+ catch (e) {
46
+ if (!isPermissionDenied(e))
47
+ throw e;
48
+ rememberLegacyRail(railKey);
49
+ return undefined;
50
+ }
51
+ };
52
+ try {
53
+ const skipped = onLegacyRail(railKey);
54
+ const caller = skipped ? undefined : await issued();
55
+ const listing = caller ?? await registryListingCaller(nc, config.space, binding.caller, { connId, ...(exp !== undefined ? { exp } : {}) });
56
+ // A remembered legacy verdict may be stale: with no listing binding, check the issued read once.
57
+ return await ask(nc, listing ?? (skipped ? await issued() : undefined));
58
+ }
59
+ finally {
60
+ await nc.drain().catch(() => nc.close());
61
+ }
62
+ }
25
63
  /** A control connection never replaces the seat's presence, messages or standing bearer source. */
26
64
  export async function invokeUserManager(config, bearer, command, args, opts = {}) {
27
65
  opts.signal?.throwIfAborted();
@@ -1 +1 @@
1
- {"version":3,"file":"manager-call.js","sourceRoot":"","sources":["../src/manager-call.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,cAAc,EACd,qBAAqB,GAKtB,MAAM,gBAAgB,CAAC;AAMxB;;;qGAGqG;AACrG,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;AAC7C,MAAM,sBAAsB,GAAG,EAAE,GAAG,MAAM,CAAC;AAC3C,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,SAAS,YAAY,CAAC,GAAW;IAC/B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;QAAE,OAAO,IAAI,CAAC;IACpC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACvB,OAAO,KAAK,CAAC;AACf,CAAC;AACD,SAAS,kBAAkB,CAAC,GAAW;IACrC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,sBAAsB,CAAC,CAAC;IACzD,IAAI,UAAU,CAAC,IAAI,GAAG,eAAe;QAAE,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAM,CAAC,CAAC;AAC5F,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,gBAAgB,KAAW,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;AAWhE,mGAAmG;AACnG,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAqB,EACrB,MAAiD,EACjD,OAAe,EACf,IAAyC,EACzC,OAAyG,EAAE;IAE3G,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAS,CAAC;IAC9B,MAAM,QAAQ,GAAG,2BAA2B,CAAC;IAC7C,IAAI,EAA8B,CAAC;IACnC,IAAI,MAAgB,CAAC;IACrB,IAAI,UAAkB,CAAC;IACvB,IAAI,OAAwB,CAAC;IAC7B,IAAI,mBAAgE,CAAC;IACrE,MAAM,OAAO,GAAG,GAAG,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,MAAM,EAAE,EAAE,CAAC,cAAc,CAAC,EAAG,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE;QACpI,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QAC5F,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3F,CAAC,CAAC;IACH,MAAM,eAAe,GAAG,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,EAAE,EAAE;QAC1G,MAAM,SAAS,GAAG,GAAG,EAAE;YACrB,MAAM,EAAE,cAAc,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACnC,IAAI,IAAI,IAAI,CAAC;gBAAE,MAAM,IAAI,eAAe,CAAC,mBAAmB,EAC1D,sFAAsF,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;YACrH,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;QACF,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,mBAAmB,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAC;YACpE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAAC;YAC5C,mBAAmB,GAAG,SAAS,CAAC;YAChC,SAAS,EAAE,CAAC;YACZ,wFAAwF;YACxF,yFAAyF;YACzF,MAAM,GAAG,MAAM,gBAAgB,CAAC,EAAG,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YACnE,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,EAAE,EAAE;QAClG,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,YAAgC,CAAC;QACrC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,oBAAoB,CAAC,KAAK,EAAE;YAClE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,YAAa,EAAE,UAAU,EAAE,MAAM,CAAC,iBAAiB;SACpI,CAAC,CAAC,CAAC;QACJ,MAAM,WAAW,GAAG,qBAAqB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;QACjH,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACnC,IAAI,IAAI,IAAI,CAAC;YAAE,MAAM,IAAI,eAAe,CAAC,mBAAmB,EAC1D,uFAAuF,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;QACtH,EAAE,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACnC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,GAAG,WAAW;YACd,oBAAoB,EAAE,CAAC;YACvB,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QACH,8FAA8F;QAC9F,gGAAgG;QAChG,IAAI,MAAM,EAAE,OAAO;YAAE,OAAO,EAAE,CAAC;QAC/B,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,4FAA4F;QAC5F,0FAA0F;QAC1F,4FAA4F;QAC5F,MAAM,OAAO,GAAG,YAAY,IAAI,KAAK,CAAC;QACtC,IAAI,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1B,mBAAmB,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3E,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,gBAAgB,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;YACtF,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC;oBAAE,MAAM,CAAC,CAAC;gBACpC,kBAAkB,CAAC,OAAO,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,iGAAiG;IACjG,yEAAyE;IACzE,MAAM,OAAO,GAAG,KAAK,EAAE,MAAmB,EAAE,QAAgB,EAAE,EAAE;QAC9D,MAAM,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAChC,OAAO,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpD,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE;QAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1E,IAAI,YAAY;YAAE,OAAO,YAAY,CAAC;QACtC,MAAM,UAAU,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;QAChF,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,EAAG,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QAC1F,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,wBAAwB,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9E,IAAI,CAAC;gBACH,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;gBAChC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC1E,IAAI,YAAY;oBAAE,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,KAAM,CAAC,OAAO,CAAC,CAAC;YACvE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE;4BACnD,GAAG,MAAM,CAAC,KAAK,CAAC,KAAM;4BACtB,OAAO,EAAE,GAAG,OAAO,kCAAkC,UAAU,sDAAsD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;yBAC9K,EAAE,EAAE,CAAC;YACR,CAAC;YACD,sFAAsF;YACtF,gEAAgE;YAChE,OAAO,aAAa,CAAC,EAAG,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IACF,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC3D,MAAM,OAAO,EAAE,CAAC;QAChB,OAAO,GAAG,MAAM,eAAe,EAAE,CAAC;QAClC,OAAO,MAAM,MAAM,EAAE,CAAC;IACxB,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,EAAE,CAAC;QACnB,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,KAAgD,CAAC;YACrD,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,IAAI,CAAC;oBACjB,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;oBAC5C,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,GAAG,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;iBACvF,CAAC,CAAC;YACL,CAAC;oBAAS,CAAC;gBACT,IAAI,KAAK,KAAK,SAAS;oBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;gBAC7C,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACxB,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}
1
+ {"version":3,"file":"manager-call.js","sourceRoot":"","sources":["../src/manager-call.ts"],"names":[],"mappings":"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"}
package/dist/once.d.ts ADDED
@@ -0,0 +1,53 @@
1
+ /**
2
+ * The seat side of a `once` task's handoff. A once task is handed to the harness at most once per
3
+ * seat process: a second run of it is one the spawner could not see, so an ambiguous handoff ends
4
+ * the task instead of offering it again.
5
+ *
6
+ * A task moves pending → claimed → confirmed, or claimed → sealed. Claimed is a permit an adapter
7
+ * takes at its dispatch site, right before the native send; confirmed is its native acceptance
8
+ * ({@link MeshAgent.commitSurfacedTurns}); sealed is a dispatch it gave up on, or a claim that
9
+ * outlived {@link ONCE_HANDOFF_MS}. The first of confirmed and sealed wins, and neither is undone.
10
+ * A dispatch whose send is its acceptance, such as a prompt hook that edits the prompt in place in
11
+ * the same synchronous step as its peek, confirms without a claim.
12
+ *
13
+ * The state lives in one registry per process, reached through a `Symbol.for` key, so every copy
14
+ * of this module loaded in the process and every `MeshAgent` built again for the same seat read
15
+ * the same entries. A once seat is never restarted, so no second process runs under its uid.
16
+ */
17
+ /** The bound on one dispatch attempt, from the claim to the harness's acceptance. It is above every
18
+ * adapter's own dispatch timeout and never measures the model's response. */
19
+ export declare const ONCE_HANDOFF_MS = 60000;
20
+ /** How long a seat that must end itself waits for its own graceful shutdown before it exits. */
21
+ export declare const ONCE_EXIT_GRACE_MS = 10000;
22
+ export type OnceHandoffState = "pending" | "claimed" | "confirmed" | "sealed";
23
+ export declare function onceHandoffState(uid: string, goalId: string): OnceHandoffState;
24
+ /** Take the permit for every once task in `goalIds`, or for none: succeeds only when each is still
25
+ * pending, and starts each one's handoff timer. */
26
+ export declare function claimOnceHandoff(uid: string, goalIds: readonly string[]): boolean;
27
+ /** The harness accepted the task. False when the handoff was already sealed: that task is not
28
+ * marked surfaced, so no automatic yield follows for it. */
29
+ export declare function confirmOnceHandoff(uid: string, goalId: string): boolean;
30
+ /** Seal a claimed task as not confirmed. True only for the call that sealed it. */
31
+ export declare function sealOnceHandoff(uid: string, goalId: string): boolean;
32
+ /** End the handoff of a task its manager settled without this seat (its deadline, a stop), whether
33
+ * or not a dispatch had claimed it, so no later claim can send it. A confirmed task stays confirmed.
34
+ * Nothing is reported: the manager already holds the task's terminal. */
35
+ export declare function endOnceHandoff(uid: string, goalId: string): void;
36
+ /** The dispatch left the seat; the acceptance arrives with the model's response, which the
37
+ * handoff timer must not measure. */
38
+ export declare function stopOnceHandoffTimer(uid: string, goalId: string): void;
39
+ export declare function onOnceHandoffTimeout(fn: (uid: string, goalId: string) => void): void;
40
+ /** An adapter's graceful shutdown for a once seat that must end itself. It starts the shutdown and
41
+ * returns nothing, or answers whether the seat is ending: an adapter whose own process is not the
42
+ * seat (Claude's MCP server is a child of `claude`) answers false when it cannot end the seat. A
43
+ * promise must settle, since no forced exit is armed until it does. */
44
+ export type OnceExit = () => void | boolean | Promise<boolean>;
45
+ /** Register the adapter's graceful shutdown for a once seat that must end itself. */
46
+ export declare function registerOnceExit(fn: OnceExit): void;
47
+ /** End this seat: start the adapter's graceful shutdown, then exit this process after
48
+ * {@link ONCE_EXIT_GRACE_MS} whatever that shutdown is doing. Its manager proves the exit, and the
49
+ * exit settles the task. A shutdown that answers false declines: no forced exit is armed, this
50
+ * process keeps running, and the caller keeps reporting. Resolves whether the seat is ending; a
51
+ * call while an exit is in flight gets that exit's answer. */
52
+ export declare function exitOnceSeat(): Promise<boolean>;
53
+ //# sourceMappingURL=once.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"once.d.ts","sourceRoot":"","sources":["../src/once.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;8EAC8E;AAC9E,eAAO,MAAM,eAAe,QAAS,CAAC;AACtC,gGAAgG;AAChG,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAqB9E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAE9E;AAED;oDACoD;AACpD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CASjF;AAED;6DAC6D;AAC7D,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAMvE;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAMpE;AAED;;0EAE0E;AAC1E,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAKhE;AAED;sCACsC;AACtC,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAKtE;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAEpF;AAED;;;wEAGwE;AACxE,MAAM,MAAM,QAAQ,GAAG,MAAM,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAE/D,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAEnD;AAED;;;;+DAI+D;AAC/D,wBAAgB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAU/C"}
package/dist/once.js ADDED
@@ -0,0 +1,126 @@
1
+ /**
2
+ * The seat side of a `once` task's handoff. A once task is handed to the harness at most once per
3
+ * seat process: a second run of it is one the spawner could not see, so an ambiguous handoff ends
4
+ * the task instead of offering it again.
5
+ *
6
+ * A task moves pending → claimed → confirmed, or claimed → sealed. Claimed is a permit an adapter
7
+ * takes at its dispatch site, right before the native send; confirmed is its native acceptance
8
+ * ({@link MeshAgent.commitSurfacedTurns}); sealed is a dispatch it gave up on, or a claim that
9
+ * outlived {@link ONCE_HANDOFF_MS}. The first of confirmed and sealed wins, and neither is undone.
10
+ * A dispatch whose send is its acceptance, such as a prompt hook that edits the prompt in place in
11
+ * the same synchronous step as its peek, confirms without a claim.
12
+ *
13
+ * The state lives in one registry per process, reached through a `Symbol.for` key, so every copy
14
+ * of this module loaded in the process and every `MeshAgent` built again for the same seat read
15
+ * the same entries. A once seat is never restarted, so no second process runs under its uid.
16
+ */
17
+ /** The bound on one dispatch attempt, from the claim to the harness's acceptance. It is above every
18
+ * adapter's own dispatch timeout and never measures the model's response. */
19
+ export const ONCE_HANDOFF_MS = 60_000;
20
+ /** How long a seat that must end itself waits for its own graceful shutdown before it exits. */
21
+ export const ONCE_EXIT_GRACE_MS = 10_000;
22
+ const KEY = Symbol.for("cotal.once-handoff");
23
+ function proc() {
24
+ const g = globalThis;
25
+ return (g[KEY] ??= { handoffs: new Map() });
26
+ }
27
+ const keyOf = (uid, goalId) => `${uid}:${goalId}`;
28
+ export function onceHandoffState(uid, goalId) {
29
+ return proc().handoffs.get(keyOf(uid, goalId))?.state ?? "pending";
30
+ }
31
+ /** Take the permit for every once task in `goalIds`, or for none: succeeds only when each is still
32
+ * pending, and starts each one's handoff timer. */
33
+ export function claimOnceHandoff(uid, goalIds) {
34
+ const p = proc();
35
+ if (goalIds.some((id) => onceHandoffState(uid, id) !== "pending"))
36
+ return false;
37
+ for (const id of goalIds) {
38
+ const timer = setTimeout(() => p.timedOut?.(uid, id), ONCE_HANDOFF_MS);
39
+ timer.unref?.();
40
+ p.handoffs.set(keyOf(uid, id), { state: "claimed", timer });
41
+ }
42
+ return true;
43
+ }
44
+ /** The harness accepted the task. False when the handoff was already sealed: that task is not
45
+ * marked surfaced, so no automatic yield follows for it. */
46
+ export function confirmOnceHandoff(uid, goalId) {
47
+ const h = proc().handoffs.get(keyOf(uid, goalId));
48
+ if (h?.state === "sealed")
49
+ return false;
50
+ if (h?.timer !== undefined)
51
+ clearTimeout(h.timer);
52
+ proc().handoffs.set(keyOf(uid, goalId), { state: "confirmed" });
53
+ return true;
54
+ }
55
+ /** Seal a claimed task as not confirmed. True only for the call that sealed it. */
56
+ export function sealOnceHandoff(uid, goalId) {
57
+ const h = proc().handoffs.get(keyOf(uid, goalId));
58
+ if (h?.state !== "claimed")
59
+ return false;
60
+ if (h.timer !== undefined)
61
+ clearTimeout(h.timer);
62
+ proc().handoffs.set(keyOf(uid, goalId), { state: "sealed" });
63
+ return true;
64
+ }
65
+ /** End the handoff of a task its manager settled without this seat (its deadline, a stop), whether
66
+ * or not a dispatch had claimed it, so no later claim can send it. A confirmed task stays confirmed.
67
+ * Nothing is reported: the manager already holds the task's terminal. */
68
+ export function endOnceHandoff(uid, goalId) {
69
+ const h = proc().handoffs.get(keyOf(uid, goalId));
70
+ if (h?.state === "confirmed" || h?.state === "sealed")
71
+ return;
72
+ if (h?.timer !== undefined)
73
+ clearTimeout(h.timer);
74
+ proc().handoffs.set(keyOf(uid, goalId), { state: "sealed" });
75
+ }
76
+ /** The dispatch left the seat; the acceptance arrives with the model's response, which the
77
+ * handoff timer must not measure. */
78
+ export function stopOnceHandoffTimer(uid, goalId) {
79
+ const h = proc().handoffs.get(keyOf(uid, goalId));
80
+ if (h?.state !== "claimed" || h.timer === undefined)
81
+ return;
82
+ clearTimeout(h.timer);
83
+ h.timer = undefined;
84
+ }
85
+ export function onOnceHandoffTimeout(fn) {
86
+ proc().timedOut = fn;
87
+ }
88
+ /** Register the adapter's graceful shutdown for a once seat that must end itself. */
89
+ export function registerOnceExit(fn) {
90
+ proc().exit = fn;
91
+ }
92
+ /** End this seat: start the adapter's graceful shutdown, then exit this process after
93
+ * {@link ONCE_EXIT_GRACE_MS} whatever that shutdown is doing. Its manager proves the exit, and the
94
+ * exit settles the task. A shutdown that answers false declines: no forced exit is armed, this
95
+ * process keeps running, and the caller keeps reporting. Resolves whether the seat is ending; a
96
+ * call while an exit is in flight gets that exit's answer. */
97
+ export function exitOnceSeat() {
98
+ const p = proc();
99
+ if (p.exiting)
100
+ return p.exiting;
101
+ const exiting = askOnceExit(p.exit).then((ending) => {
102
+ if (!ending) {
103
+ p.exiting = undefined;
104
+ return false;
105
+ }
106
+ setTimeout(() => process.exit(1), ONCE_EXIT_GRACE_MS);
107
+ return true;
108
+ });
109
+ p.exiting = exiting;
110
+ return exiting;
111
+ }
112
+ /** Whether the adapter's shutdown says the seat is ending: anything but false does, a throw included,
113
+ * and a promise does unless it answers false or rejects. */
114
+ async function askOnceExit(exit) {
115
+ let ending;
116
+ try {
117
+ ending = exit?.();
118
+ }
119
+ catch {
120
+ return true;
121
+ }
122
+ if (ending instanceof Promise)
123
+ ending = await ending.catch(() => false);
124
+ return ending !== false;
125
+ }
126
+ //# sourceMappingURL=once.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"once.js","sourceRoot":"","sources":["../src/once.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;8EAC8E;AAC9E,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AACtC,gGAAgG;AAChG,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAczC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAE7C,SAAS,IAAI;IACX,MAAM,CAAC,GAAG,UAAqC,CAAC;IAChD,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,KAAK,GAAG,CAAC,GAAW,EAAE,MAAc,EAAU,EAAE,CAAC,GAAG,GAAG,IAAI,MAAM,EAAE,CAAC;AAE1E,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,MAAc;IAC1D,OAAO,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,EAAE,KAAK,IAAI,SAAS,CAAC;AACrE,CAAC;AAED;oDACoD;AACpD,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,OAA0B;IACtE,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IACjB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IAChF,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,eAAe,CAAC,CAAC;QACtE,KAAgC,CAAC,KAAK,EAAE,EAAE,CAAC;QAC5C,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;6DAC6D;AAC7D,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,MAAc;IAC5D,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,IAAI,CAAC,EAAE,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,CAAC,EAAE,KAAK,KAAK,SAAS;QAAE,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;IAChE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,MAAc;IACzD,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,IAAI,CAAC,EAAE,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACzC,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS;QAAE,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC7D,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;0EAE0E;AAC1E,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,MAAc;IACxD,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,IAAI,CAAC,EAAE,KAAK,KAAK,WAAW,IAAI,CAAC,EAAE,KAAK,KAAK,QAAQ;QAAE,OAAO;IAC9D,IAAI,CAAC,EAAE,KAAK,KAAK,SAAS;QAAE,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED;sCACsC;AACtC,MAAM,UAAU,oBAAoB,CAAC,GAAW,EAAE,MAAc;IAC9D,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,IAAI,CAAC,EAAE,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO;IAC5D,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC,CAAC,KAAK,GAAG,SAAS,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,EAAyC;IAC5E,IAAI,EAAE,CAAC,QAAQ,GAAG,EAAE,CAAC;AACvB,CAAC;AAQD,qFAAqF;AACrF,MAAM,UAAU,gBAAgB,CAAC,EAAY;IAC3C,IAAI,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC;AACnB,CAAC;AAED;;;;+DAI+D;AAC/D,MAAM,UAAU,YAAY;IAC1B,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IACjB,IAAI,CAAC,CAAC,OAAO;QAAE,OAAO,CAAC,CAAC,OAAO,CAAC;IAChC,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QAClD,IAAI,CAAC,MAAM,EAAE,CAAC;YAAC,CAAC,CAAC,OAAO,GAAG,SAAS,CAAC;YAAC,OAAO,KAAK,CAAC;QAAC,CAAC;QACrD,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IACH,CAAC,CAAC,OAAO,GAAG,OAAO,CAAC;IACpB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;6DAC6D;AAC7D,KAAK,UAAU,WAAW,CAAC,IAA0B;IACnD,IAAI,MAAqD,CAAC;IAC1D,IAAI,CAAC;QAAC,MAAM,GAAG,IAAI,EAAE,EAAE,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;IACjD,IAAI,MAAM,YAAY,OAAO;QAAE,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;IACxE,OAAO,MAAM,KAAK,KAAK,CAAC;AAC1B,CAAC"}
@@ -25,9 +25,11 @@ export declare const MESH_FIRST_STEER: string;
25
25
  * at durable cotal-lang runs for coordination that must outlive their own session, so the reflex is
26
26
  * a journalled `cotal run` rather than an improvised loop held in one agent's context. */
27
27
  export declare const WORKFLOW_STEER: string;
28
- /** Where to talk, folded in beside {@link ORIENTATION_BOOTSTRAP} for every connector. A fresh seat
29
- * may start on no channel, so it is told how to find its team's channel and which surface fits
30
- * which kind of message. Guidance only: it grants nothing and changes no subscription. */
28
+ /** Where to talk, folded in beside {@link ORIENTATION_BOOTSTRAP} for every connector. Leads with
29
+ * the model (information moves through channels), then the rule (channel for work, a mention to
30
+ * make one peer act, a DM for what one peer alone needs), then the mechanics. A fresh seat may
31
+ * start on no channel, so it is told how to find and join one, and how a helper it spawns gets
32
+ * one. Guidance only: it grants nothing and changes no subscription. */
31
33
  export declare const CHANNEL_GUIDANCE: string;
32
34
  /** A tool the agent can actually call (already gated), as it appears in the card. */
33
35
  export interface OrientationTool {
@@ -77,6 +79,12 @@ export interface Orientation {
77
79
  readAcl: string[];
78
80
  /** Post ACL — channels you may broadcast to. Empty ⇒ read-only (default-deny). */
79
81
  post: string[];
82
+ /** Concrete channels in the read ACL you are NOT on yet, each with its registry note when the
83
+ * registry has one: where to look before the first send, without a second call. */
84
+ joinable: {
85
+ channel: string;
86
+ note?: string;
87
+ }[];
80
88
  };
81
89
  /** Control-plane capabilities (e.g. `spawn`). Empty ⇒ none beyond the defaults granted to all. */
82
90
  capabilities: string[];
@@ -1 +1 @@
1
- {"version":3,"file":"orientation.d.ts","sourceRoot":"","sources":["../src/orientation.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"orientation.d.ts","sourceRoot":"","sources":["../src/orientation.ts"],"names":[],"mappings":"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"}
@@ -9,7 +9,7 @@
9
9
  * The typed {@link Orientation} object is the source of truth; {@link renderOrientation} is one view of
10
10
  * it (the text the model reads). A future MCP resource can JSON-stringify the object directly.
11
11
  */
12
- import { parsePrincipalKey, peerLabel } from "@cotal-ai/core";
12
+ import { isConcreteChannel, parsePrincipalKey, peerLabel } from "@cotal-ai/core";
13
13
  import { presenceReadCondition } from "./agent.js";
14
14
  import { isAuthed } from "./config.js";
15
15
  import { DOCS_VERSION } from "./docs.js";
@@ -25,7 +25,8 @@ export const ORIENTATION_BOOTSTRAP = "Start with cotal_orientation — it shows
25
25
  export const MESH_FIRST_STEER = "Keep multi-agent work on the mesh. Before reaching for your harness's own subagents, Task tool, or " +
26
26
  "any built-in parallel-agent feature, do it through Cotal instead: spawn or delegate to a real peer " +
27
27
  "(cotal_spawn if you have it, otherwise cotal_dm or cotal_anycast to reach one) so the work stays " +
28
- "visible to the user and addressable by peers rather than hidden inside a private subagent.";
28
+ "visible to the user and addressable by peers rather than hidden inside a private subagent. For a " +
29
+ "single task, cotal_spawn with once: true starts a helper that is stopped when the task ends.";
29
30
  /** Workflow-run steer, folded in beside {@link MESH_FIRST_STEER} for every connector. Points agents
30
31
  * at durable cotal-lang runs for coordination that must outlive their own session, so the reflex is
31
32
  * a journalled `cotal run` rather than an improvised loop held in one agent's context. */
@@ -33,12 +34,24 @@ export const WORKFLOW_STEER = "Coordination that must survive restarts (multi-st
33
34
  "fan-out over agents) belongs in a durable workflow run: a cotal-lang program driven with " +
34
35
  "`cotal run start`, resumable on any host from its step journal. Read the `workflows` page via " +
35
36
  "cotal_docs before improvising such a loop in your own context.";
36
- /** Where to talk, folded in beside {@link ORIENTATION_BOOTSTRAP} for every connector. A fresh seat
37
- * may start on no channel, so it is told how to find its team's channel and which surface fits
38
- * which kind of message. Guidance only: it grants nothing and changes no subscription. */
39
- export const CHANNEL_GUIDANCE = "To work with your team, find its channel with cotal_channels and join it with cotal_join, then " +
40
- "post team work there with cotal_send. Use cotal_dm for one specific peer and cotal_anycast to ask " +
41
- "whoever holds a role. Post on #announce only for a deliberate notice to the whole space.";
37
+ /** Where to talk, folded in beside {@link ORIENTATION_BOOTSTRAP} for every connector. Leads with
38
+ * the model (information moves through channels), then the rule (channel for work, a mention to
39
+ * make one peer act, a DM for what one peer alone needs), then the mechanics. A fresh seat may
40
+ * start on no channel, so it is told how to find and join one, and how a helper it spawns gets
41
+ * one. Guidance only: it grants nothing and changes no subscription. */
42
+ export const CHANNEL_GUIDANCE = "Information moves through channels. Subscribe to the channel where what you need is published, " +
43
+ "and publish what others may need on the channel where they will look for it. The channel you work " +
44
+ "on is where your work happens: post plans, status, results and decisions there with cotal_send, so every peer on it, " +
45
+ "and anyone who joins later, reads them without being asked. A plain post wakes nobody; @mention a " +
46
+ "peer only when that peer must act now, since a mention wakes them, and a mention in an " +
47
+ "acknowledgement or sign-off starts a wake-up loop. Use cotal_dm only for something one peer alone " +
48
+ "needs, because a DM is invisible to everyone else, and cotal_anycast to ask whoever holds a role. " +
49
+ "A channel's purpose is its registry note (cotal_channel_info); cotal_channels lists them and " +
50
+ "cotal_join adds one within your read allowance. To follow every channel under a prefix, join a " +
51
+ "family such as team.>: posts on its durable channels are kept for you while you are away, from the " +
52
+ "join on. A helper you spawn starts on no channel unless you " +
53
+ "pass join, so pass the channel you are working on. Post on #announce only for a deliberate notice " +
54
+ "to the whole space.";
42
55
  /** The everyday loop (the `core` group); every other tool falls into `more`. Keep in sync with the
43
56
  * reply/loop tools an agent reaches for each turn. An unknown/new tool defaults to `more`. */
44
57
  const CORE_TOOLS = new Set([
@@ -115,6 +128,12 @@ export function buildOrientation(agent, config, visibleTools, generatedAt, read)
115
128
  read: config.subscribe,
116
129
  readAcl: config.allowSubscribe,
117
130
  post: config.allowPublish,
131
+ joinable: config.allowSubscribe
132
+ .filter((c) => isConcreteChannel(c) && !config.subscribe.includes(c))
133
+ .map((channel) => {
134
+ const note = agent.channelInfo(channel).description?.trim();
135
+ return note ? { channel, note } : { channel };
136
+ }),
118
137
  },
119
138
  capabilities: config.capabilities ?? [],
120
139
  tools: { core, more },
@@ -155,6 +174,8 @@ export function renderOrientation(o) {
155
174
  ];
156
175
  if (aclDiffers)
157
176
  lines.push(` • may join (read ACL): ${fmt(o.access.readAcl)}`);
177
+ if (o.access.joinable.length)
178
+ lines.push(` • not on yet: ${o.access.joinable.map((j) => `#${j.channel}${j.note ? ` (${j.note})` : ""}`).join(", ")} · join one with cotal_join`);
158
179
  lines.push(` • post: ${o.access.post.length ? fmt(o.access.post) : "— (read-only; no post channels)"}`, ` • capabilities: ${o.capabilities.length ? o.capabilities.join(", ") : "none beyond defaults"}`, "", `Tools — core loop: ${o.tools.core.map((t) => t.name).join(", ") || "—"}`, `Tools — more: ${o.tools.more.map((t) => t.name).join(", ") || "—"}`, "", `Right now (snapshot @ ${new Date(o.generatedAt).toISOString()}):`, ` • status: ${honestStatus(o.status)} · attention: ${o.attention}`, ` • peers present: ${o.peers.present} — ${o.peers.summary}`, ` • presence view: ${o.presence.live ? "live" : `NOT LIVE — ${o.presence.detail}`}`, ` • unread: ${o.unread.total}`, "", `Act → read: ${o.actions.read} · reply on a channel: ${o.actions.replyChannel} · ` +
159
180
  `private: ${o.actions.replyPrivate} · ask a role: ${o.actions.askRole}`);
160
181
  return lines.join("\n");
@@ -1 +1 @@
1
- {"version":3,"file":"orientation.js","sourceRoot":"","sources":["../src/orientation.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"orientation.js","sourceRoot":"","sources":["../src/orientation.ts"],"names":[],"mappings":"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"}
@@ -134,9 +134,22 @@ export declare function channelMeta(i: InboxItem): Record<string, string>;
134
134
  * no channel qualifies; a send without a channel is then refused.
135
135
  */
136
136
  export declare function defaultSendChannel(config: Pick<AgentConfig, "allowPublish" | "creds" | "userAuth">, reading: readonly string[]): string | undefined;
137
+ /**
138
+ * Why a send with no channel has nowhere to go, and the exact next call. Built from the channels
139
+ * the agent reads now and the channels its ACL lets it post to, so the refusal names a channel the
140
+ * agent can use rather than pointing at another tool. Two shapes: on no channel at all, or on
141
+ * channels it may post to none of. `postable` is empty where the ACL grants no concrete post
142
+ * channel the agent could name (an operator widens that; nothing here can).
143
+ */
144
+ export declare function sendNoDefaultRemedy(config: Pick<AgentConfig, "allowSubscribe" | "allowPublish" | "creds" | "userAuth">, reading: readonly string[]): string;
145
+ /** The orientation card as the model reads it, over the SAME gated tool list the connector exposes
146
+ * (cotalToolSpecs already filters spawn/persona by capability), so the card can't claim a tool the
147
+ * agent can't call. The `cotal_orientation` tool, a connect result and a session-start hook all
148
+ * hand over this one rendering. */
149
+ export declare function orientationCard(agent: MeshAgent, config: AgentConfig, source?: string, env?: NodeJS.ProcessEnv, offered?: ReadonlySet<string>): Promise<string>;
137
150
  /** How to reach a channel family, since every publish names one concrete channel (SPEC §3). The
138
151
  * advertised `channel` text of `cotal_send`, here and in the gateway. */
139
- export declare const PATTERN_SEND_HELP = "A pattern such as team.> is refused. To reach the agents connected and following team.> now, post once to one channel it matches, such as team.announce; to reach several channels, post to each by name (cotal_channels lists the existing ones).";
152
+ export declare const PATTERN_SEND_HELP = "A pattern such as team.> is refused. To reach the agents following team.>, post once to one channel it matches, such as team.announce: those connected then get it, and one that is away gets a stored copy if that channel is durable. To reach several channels, post to each by name (cotal_channels lists the existing ones).";
140
153
  /** The full Cotal tool set for a given config. Renderers iterate this; `source` names the
141
154
  * hosting connector and is stamped onto outgoing feedback. An explicit env restricts feedback's
142
155
  * Git lookup to its global config; omitted preserves process inheritance and repository lookup.
@@ -1 +1 @@
1
- {"version":3,"file":"tool-specs.d.ts","sourceRoot":"","sources":["../src/tool-specs.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAmB,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAI7E,OAAO,EAAY,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAKzD;;gGAEgG;AAChG,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAiFD;;;;;;;sGAOsG;AACtG,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;AAExD,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB;;;;8FAI0F;IAC1F,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC;CAC1G;AAED,8DAA8D;AAC9D,MAAM,WAAW,QAAQ;IACvB;2DACuD;IACvD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAUD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBzF;AAED;mGACmG;AACnG,eAAO,MAAM,YAAY,EAAE,cAAmC,CAAC;AAE/D;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAG7E;AA0BD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC,2FAA2F;AAC3F,MAAM,WAAW,aAAa;IAC5B,iGAAiG;IACjG,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,oCAAoC;IACpC,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB;gEAC4D;IAC5D,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IAC5B,uEAAuE;IACvE,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,KAAK,MAAM,CAAC;IAC9C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACjC,GAAG,aAAa,CA4FhB;AA4RD,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQhE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,GAAG,OAAO,GAAG,UAAU,CAAC,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAGnJ;AAKD;0EAC0E;AAC1E,eAAO,MAAM,iBAAiB,uPACwN,CAAC;AAqBvP;;;;;;qEAMqE;AACrE,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EACnB,MAAM,SAAc,EACpB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,EACvB,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,EAC7B,cAAc,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,GACxC,aAAa,EAAE,CAwuCjB"}
1
+ {"version":3,"file":"tool-specs.d.ts","sourceRoot":"","sources":["../src/tool-specs.ts"],"names":[],"mappings":"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"}