@cogitator-ai/bridge 0.2.0 → 0.4.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 (116) hide show
  1. package/README.md +242 -8
  2. package/dist/adapter.d.ts +130 -0
  3. package/dist/adapter.d.ts.map +1 -0
  4. package/dist/adapter.js +2 -0
  5. package/dist/adapter.js.map +1 -0
  6. package/dist/adapters/claude.d.ts +145 -0
  7. package/dist/adapters/claude.d.ts.map +1 -0
  8. package/dist/adapters/claude.js +537 -0
  9. package/dist/adapters/claude.js.map +1 -0
  10. package/dist/adapters/codex.d.ts +71 -0
  11. package/dist/adapters/codex.d.ts.map +1 -0
  12. package/dist/adapters/codex.js +379 -0
  13. package/dist/adapters/codex.js.map +1 -0
  14. package/dist/adapters/exec.d.ts +70 -0
  15. package/dist/adapters/exec.d.ts.map +1 -0
  16. package/dist/adapters/exec.js +161 -0
  17. package/dist/adapters/exec.js.map +1 -0
  18. package/dist/adapters/hosted.d.ts +168 -0
  19. package/dist/adapters/hosted.d.ts.map +1 -0
  20. package/dist/adapters/hosted.js +361 -0
  21. package/dist/adapters/hosted.js.map +1 -0
  22. package/dist/adapters/tools-server.d.ts +21 -0
  23. package/dist/adapters/tools-server.d.ts.map +1 -0
  24. package/dist/adapters/tools-server.js +19 -0
  25. package/dist/adapters/tools-server.js.map +1 -0
  26. package/dist/client.d.ts +9 -2
  27. package/dist/client.d.ts.map +1 -1
  28. package/dist/client.js +17 -3
  29. package/dist/client.js.map +1 -1
  30. package/dist/dispatcher.d.ts +69 -17
  31. package/dist/dispatcher.d.ts.map +1 -1
  32. package/dist/dispatcher.js +243 -17
  33. package/dist/dispatcher.js.map +1 -1
  34. package/dist/host.d.ts +1 -1
  35. package/dist/host.d.ts.map +1 -1
  36. package/dist/index.d.ts +18 -3
  37. package/dist/index.d.ts.map +1 -1
  38. package/dist/index.js +9 -1
  39. package/dist/index.js.map +1 -1
  40. package/dist/inputs.d.ts +40 -1
  41. package/dist/inputs.d.ts.map +1 -1
  42. package/dist/inputs.js +25 -2
  43. package/dist/inputs.js.map +1 -1
  44. package/dist/paths.d.ts +6 -0
  45. package/dist/paths.d.ts.map +1 -1
  46. package/dist/paths.js +19 -0
  47. package/dist/paths.js.map +1 -1
  48. package/dist/protocol.d.ts +5 -0
  49. package/dist/protocol.d.ts.map +1 -1
  50. package/dist/protocol.js +5 -0
  51. package/dist/protocol.js.map +1 -1
  52. package/dist/server.d.ts.map +1 -1
  53. package/dist/server.js +6 -1
  54. package/dist/server.js.map +1 -1
  55. package/dist/setup/claude.d.ts +53 -0
  56. package/dist/setup/claude.d.ts.map +1 -0
  57. package/dist/setup/claude.js +261 -0
  58. package/dist/setup/claude.js.map +1 -0
  59. package/dist/setup/codex.d.ts +22 -0
  60. package/dist/setup/codex.d.ts.map +1 -0
  61. package/dist/setup/codex.js +95 -0
  62. package/dist/setup/codex.js.map +1 -0
  63. package/dist/setup/files.d.ts +22 -0
  64. package/dist/setup/files.d.ts.map +1 -0
  65. package/dist/setup/files.js +86 -0
  66. package/dist/setup/files.js.map +1 -0
  67. package/dist/setup/index.d.ts +6 -0
  68. package/dist/setup/index.d.ts.map +1 -0
  69. package/dist/setup/index.js +3 -0
  70. package/dist/setup/index.js.map +1 -0
  71. package/dist/setup/setup.d.ts +52 -0
  72. package/dist/setup/setup.d.ts.map +1 -0
  73. package/dist/setup/setup.js +2 -0
  74. package/dist/setup/setup.js.map +1 -0
  75. package/dist/testing/conformance.d.ts +65 -0
  76. package/dist/testing/conformance.d.ts.map +1 -0
  77. package/dist/testing/conformance.js +217 -0
  78. package/dist/testing/conformance.js.map +1 -0
  79. package/dist/testing/fake-harnesses.d.ts +121 -0
  80. package/dist/testing/fake-harnesses.d.ts.map +1 -0
  81. package/dist/testing/fake-harnesses.js +303 -0
  82. package/dist/testing/fake-harnesses.js.map +1 -0
  83. package/dist/testing/index.d.ts +5 -0
  84. package/dist/testing/index.d.ts.map +1 -0
  85. package/dist/testing/index.js +3 -0
  86. package/dist/testing/index.js.map +1 -0
  87. package/dist/tools/caller.d.ts +39 -0
  88. package/dist/tools/caller.d.ts.map +1 -0
  89. package/dist/tools/caller.js +92 -0
  90. package/dist/tools/caller.js.map +1 -0
  91. package/dist/tools/guidance.d.ts +33 -0
  92. package/dist/tools/guidance.d.ts.map +1 -0
  93. package/dist/tools/guidance.js +92 -0
  94. package/dist/tools/guidance.js.map +1 -0
  95. package/dist/tools/index.d.ts +27 -0
  96. package/dist/tools/index.d.ts.map +1 -0
  97. package/dist/tools/index.js +24 -0
  98. package/dist/tools/index.js.map +1 -0
  99. package/dist/tools/tools.d.ts +38 -0
  100. package/dist/tools/tools.d.ts.map +1 -0
  101. package/dist/tools/tools.js +354 -0
  102. package/dist/tools/tools.js.map +1 -0
  103. package/dist/types.d.ts +3 -39
  104. package/dist/types.d.ts.map +1 -1
  105. package/dist/types.js +2 -0
  106. package/dist/types.js.map +1 -1
  107. package/dist/waiter.d.ts +36 -0
  108. package/dist/waiter.d.ts.map +1 -0
  109. package/dist/waiter.js +92 -0
  110. package/dist/waiter.js.map +1 -0
  111. package/fakes/claude.mjs +715 -0
  112. package/fakes/codex.mjs +571 -0
  113. package/fakes/lib.mjs +585 -0
  114. package/fakes/mcp.mjs +151 -0
  115. package/fakes/sandbox.mjs +84 -0
  116. package/package.json +19 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"waiter.d.ts","sourceRoot":"","sources":["../src/waiter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,MAAM,EAAE,cAAc,CAAC;IACvB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;IACtD,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAiBD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAwDzF;AAED,gGAAgG;AAChG,wBAAgB,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAEnE"}
package/dist/waiter.js ADDED
@@ -0,0 +1,92 @@
1
+ import { BridgeClient } from './client.js';
2
+ import { isBridgeError } from './errors.js';
3
+ import { MAX_WAIT_MS } from './inputs.js';
4
+ const DEFAULT_RETRY_MS = 2_000;
5
+ function pause(ms, signal) {
6
+ if (signal?.aborted)
7
+ return Promise.resolve();
8
+ return new Promise((resolve) => {
9
+ const done = () => {
10
+ clearTimeout(timer);
11
+ signal?.removeEventListener('abort', done);
12
+ resolve();
13
+ };
14
+ const timer = setTimeout(done, ms);
15
+ signal?.addEventListener('abort', done, { once: true });
16
+ });
17
+ }
18
+ /**
19
+ * Waits at the dispatcher for a session's mail, as the process a hook of the session runs. A
20
+ * dispatcher that does not run, or stops while the waiter waits, is waited for too: the session
21
+ * stays reachable across a restart of the dispatcher.
22
+ *
23
+ * @throws BridgeError what the dispatcher refuses the session for, other than not running
24
+ */
25
+ export async function waitForMail(options) {
26
+ const { signal } = options;
27
+ const deadline = Date.now() + Math.min(options.timeoutMs, MAX_WAIT_MS);
28
+ const retryMs = options.retryMs ?? DEFAULT_RETRY_MS;
29
+ const none = async () => undefined;
30
+ for (;;) {
31
+ const left = deadline - Date.now();
32
+ if (signal?.aborted)
33
+ return { reason: 'closed', letters: [], confirm: none };
34
+ if (left <= 0)
35
+ return { reason: 'timeout', letters: [], confirm: none };
36
+ let client;
37
+ try {
38
+ client = await BridgeClient.connect({
39
+ socketPath: options.socketPath,
40
+ caller: options.caller,
41
+ });
42
+ }
43
+ catch (error) {
44
+ if (!isBridgeError(error) || error.code !== 'not_running')
45
+ throw error;
46
+ await pause(Math.min(retryMs, left), signal);
47
+ continue;
48
+ }
49
+ if (signal?.aborted) {
50
+ await client.close();
51
+ return { reason: 'closed', letters: [], confirm: none };
52
+ }
53
+ const onAbort = () => void client.close();
54
+ signal?.addEventListener('abort', onAbort, { once: true });
55
+ try {
56
+ const waited = await client.wait({ timeoutMs: left });
57
+ if (waited.reason === 'letters') {
58
+ const ids = waited.letters.map((letter) => letter.id);
59
+ const connection = client;
60
+ return {
61
+ reason: 'letters',
62
+ letters: waited.letters,
63
+ confirm: async () => {
64
+ try {
65
+ await connection.delivered(ids);
66
+ }
67
+ finally {
68
+ await connection.close();
69
+ }
70
+ },
71
+ };
72
+ }
73
+ await client.close();
74
+ if (waited.reason !== 'closed')
75
+ return { reason: waited.reason, letters: [], confirm: none };
76
+ }
77
+ catch (error) {
78
+ await client.close().catch(() => undefined);
79
+ if (!isBridgeError(error) || error.code !== 'not_running')
80
+ throw error;
81
+ }
82
+ finally {
83
+ signal?.removeEventListener('abort', onAbort);
84
+ }
85
+ await pause(Math.min(retryMs, Math.max(0, deadline - Date.now())), signal);
86
+ }
87
+ }
88
+ /** The text a waiter hands its session: the letters, oldest first, each under its signature. */
89
+ export function mailText(letters) {
90
+ return letters.map((letter) => letter.text.trimEnd()).join('\n\n');
91
+ }
92
+ //# sourceMappingURL=waiter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"waiter.js","sourceRoot":"","sources":["../src/waiter.ts"],"names":[],"mappings":"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"}